Common Workflows

1. hydrate_project(project_id)
   → See current state

2. create_flow(project_id, name="My Pipeline", slug="my-pipeline")
   → flow_id

3. add_block(flow_id, name="Step 1", processor_type="llm", prompt="...")
   → step-1

4. add_block(flow_id, name="Step 2", processor_type="llm", target_id="step-1", direction="right", prompt="...")
   → step-2

5. publish_version(flow_id, note="v1: initial")
   → version_id

6. set_production_version(flow_id, version_id)
   → Live at /seq/{org}/{project}/my-pipeline/execute

1. get_flow(flow_id)
   → See current blocks and their content versions

2. update_block_draft(flow_id, step_id, content="Improved prompt...")
   → Updated (content_version incremented)

3. create_checkpoint(flow_id, step_id, note="before v2 publish")
   → Snapshot saved

4. publish_version(flow_id, note="v2: improved prompt")
   → version_id

5. set_production_version(flow_id, version_id)
   → Live

1. get_flow_structure(flow_id)
   → See tree topology

2. add_block(flow_id, name="Process Item", processor_type="llm", prompt="Process: {item}")
   → step-3

3. wrap_in_loop(flow_id, node_ids=["step-3"], array_field="items")
   → Loop created

4. publish_version(flow_id, note="v3: added item loop")
   → version_id

1. create_object_model(project_id, name="SentimentResult", fields=[
     {"name": "sentiment", "type": "string", "description": "positive, negative, or neutral"},
     {"name": "confidence", "type": "number", "description": "0-1 confidence score"}
   ])
   → object_model_id

2. update_block_output_schema(flow_id, step_id, content={
     "type": "object",
     "properties": {
       "sentiment": {"type": "string"},
       "confidence": {"type": "number"}
     },
     "required": ["sentiment", "confidence"]
   })
   → Schema set

3. publish_version(flow_id, note="v4: structured output")
   → version_id

1. get_flow_structure(flow_id)
   → See current tree

2. wrap_in_container(flow_id, node_ids=["step-1", "step-2"], container_type="h")
   → container_id (sequential group)

3. move_block(flow_id, step_id="step-3", new_parent_id=container_id, new_position=2)
   → Block moved into container

4. reorder_children(flow_id, parent_id=container_id, child_order=["step-2", "step-1", "step-3"])
   → Reordered

1. create_test_case(project_id, flow_id, scope="flow", name="Happy path",
     input_data={"message": "I love your product!", "parameters": {}})
   → test_case_id

2. run_test_case(test_case_id)
   → { runId, status: "completed", durationMs, steps: [...] }

3. run_all_tests(flow_id)
   → { total: 1, passed: 1, failed: 0, results: [...] }

1. run_test_case(test_case_id)
   → { runId, status: "failed", errorAtStep: "step-2", error: "..." }

2. get_test_run_trace(flow_run_id=runId)
   → Full trace: per-step input/output snapshots, token counts, errors

3. get_step_trace(flow_run_id=runId, step_id="step-2")
   → Detailed trace for the failed step (input context, output, error context)

4. Fix the block prompt/config based on trace data

5. run_test_case(test_case_id)
   → Re-run to verify the fix