Flow Spec v1

Blocchi Flow Spec v1 é a representação portátil de um workflow.

{
  specVersion: "1";
  name: string;
  description?: string;
  nodes: WorkflowNode[];
  edges: WorkflowEdge[];
}

O contrato exclui intencionalmente tenant ID, revisão do workflow e estado de lifecycle. Esses campos pertencem à plataforma.

Limites no v1

• Nome: 1–200 caracteres.
• Descrição: até 2.000 caracteres.
• Nodes: 1–200.
• Edges: até 500.
• Campos top-level desconhecidos são rejeitados.

Um único schema

Autoria visual, Flow-as-code e flows criados por agentes devem fazer round-trip pelo mesmo contrato. Se uma capacidade não puder ser representada com segurança no Flow Spec, ela não deve criar uma segunda linguagem oculta de workflow.