Crate car_workflow 

Declarative multi-stage workflow orchestration for Common Agent Runtime.

Composes car-multi agent coordination patterns and car-engine action proposals into a named, conditional, compensable stage graph.

Key types

• Workflow — the top-level definition (stages + conditional edges)
• Stage / StageStep — what each step does (pattern, proposal, sub-workflow)
• Edge — conditional transition between stages (reuses car_ir::Precondition)
• CompensationHandler — saga-style rollback per stage
• WorkflowEngine — executes the workflow graph
• verify_workflow — static analysis before execution

Example (JSON definition)

{
  "id": "review-deploy",
  "name": "Review and Deploy",
  "start": "review",
  "stages": [
    { "id": "review", "name": "Code Review", "step": { "type": "pattern", ... } },
    { "id": "deploy", "name": "Deploy", "step": { "type": "proposal", ... } }
  ],
  "edges": [
    { "from": "review", "to": "deploy", "conditions": [{"key": "stage.review.succeeded", "operator": "eq", "value": true}] }
  ]
}

Re-exports

pub use engine::WorkflowEngine;

pub use error::WorkflowError;

pub use result::CompensationResult;

pub use result::StageOutput;

pub use result::StageResult;

pub use result::StageStatus;

pub use result::WorkflowResult;

pub use result::WorkflowStatus;

pub use types::CompensationHandler;

pub use types::Edge;

pub use types::PatternKind;

pub use types::PatternStep;

pub use types::ProposalStep;

pub use types::Stage;

pub use types::StageStep;

pub use types::SubWorkflowStep;

pub use types::Workflow;

pub use verify::verify_workflow;

pub use verify::WorkflowIssue;

pub use verify::WorkflowVerifyResult;

Modules

engine

Workflow execution engine — walks the stage graph, dispatches to car-multi patterns and car-engine proposals, manages state flow and saga compensation.

error

Workflow error types.

result

Workflow execution result types.

types

Workflow definition types — fully serializable for use through all bindings.

verify

Static workflow verification — validate structure before execution.