CAFF Overview

What is CAFF?

CAFF (Cavos Agents Flow Format) is a JSON format for defining portable agent flow definitions. Every agent’s behavior is described as a directed graph of nodes connected by edges.

CAFF flows are:

• Portable — Export and import between environments
• Validated — Schema-validated with Zod at build and runtime
• Visual — Rendered in the drag-and-drop flow builder
• Executable — Directly executed by the flow runtime engine

Schema

$schema: https://cavos.org/schemas/flow/v1.json
version: 1.0.0

Pipeline

flow-builder (visual editor)
    ↓
flow-schema (Zod validation)
    ↓
flow-runtime (execution engine)

Node Categories

Category	Types	Purpose
Core	start, agent, classify, end, note, agent_ref, agent_pool, map_reduce	Flow structure and LLM execution
Tools	file_search, http_api, code_executor, image_generator	External integrations
Logic	if_else, while, user_approval, set_state, parallel_fork, parallel_join	Flow control
Guardrails	guardrail (pii, jailbreak, content)	Safety checks
Triggers	trigger (MENTION, KEYWORD, SCHEDULE, WEBHOOK, MANUAL)	Flow activation