Flow Spec v1

Blocchi Flow Spec v1 is the portable representation of a workflow.

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

The contract intentionally excludes tenant ID, workflow revision and lifecycle state. Those are platform-owned fields.

Limits in v1

• Name: 1–200 characters.
• Description: up to 2,000 characters.
• Nodes: 1–200.
• Edges: up to 500.
• Unknown top-level fields are rejected.

One schema

Visual authoring, Flow-as-code and agent-created flows should round-trip through this same contract. If a feature cannot be represented safely in Flow Spec, it should not create a second hidden workflow language.