smithers-orchestrator; the factory returns a
typed set bound to your output schemas.
Control flow
The structural primitives. They order, branch, repeat, and gate the work.| Component | Props type | Purpose | Reference |
|---|---|---|---|
Workflow | WorkflowProps | Root node; names the run and holds the graph. | Workflow |
Task | TaskProps | Executable node; runs an agent, a compute callback, or emits a static value. | Task |
Sequence | SequenceProps | Run children in order, each waiting for the last. | Sequence |
Parallel | ParallelProps | Run children concurrently and join. | Parallel |
Branch | BranchProps | Pick one child path from a predicate. | Branch |
Loop | LoopProps | Re-run children until a condition holds. | Loop |
Approval | ApprovalProps | Pause for a human decision before continuing. | Approval |
MergeQueue | MergeQueueProps | Serialize merges through an ordered queue. | MergeQueue |
Worktree | WorktreeProps | Run children in an isolated git worktree. | Worktree |
Composite
Higher-order patterns built from the primitives. Reach for these before hand-rolling the same shape.| Component | Props type | Purpose | Reference |
|---|---|---|---|
Kanban | KanbanProps | Pull work across columns with bounded concurrency. | Kanban |
ClassifyAndRoute | ClassifyAndRouteProps | Classify an input, then dispatch to the matching handler. | ClassifyAndRoute |
GatherAndSynthesize | GatherAndSynthesizeProps | Fan out gatherers, then fold their results into one. | GatherAndSynthesize |
Panel | PanelProps | Ask several agents, then aggregate their answers. | Panel |
CheckSuite | CheckSuiteProps | Run a set of pass/fail checks and gate on them. | CheckSuite |
Debate | DebateProps | Opposing agents argue across rounds toward a verdict. | Debate |
ReviewLoop | ReviewLoopProps | Produce, review, and revise until the review passes. | ReviewLoop |
Optimizer | OptimizerProps | Iterate a candidate against a scorer toward a target. | Optimizer |
ContentPipeline | ContentPipelineProps | Draft, edit, and finalize content in stages. | ContentPipeline |
ApprovalGate | ApprovalGateProps | Conditional human gate with auto-approve rules. | ApprovalGate |
EscalationChain | EscalationChainProps | Try handlers in order, escalating on failure. | EscalationChain |
DecisionTable | DecisionTableProps | Map matched conditions to actions, rule by rule. | DecisionTable |
DriftDetector | DriftDetectorProps | Compare current state to a baseline and act on drift. | DriftDetector |
ScanFixVerify | ScanFixVerifyProps | Scan for issues, apply fixes, then verify them. | ScanFixVerify |
Poller | PollerProps | Poll a source until a condition is met or it times out. | Poller |
Supervisor | SupervisorProps | Watch a child and restart it under a policy. | Supervisor |
Runbook | RunbookProps | Run an ordered set of operational steps. | Runbook |
Engine
Durability and external-world primitives: subflows, events, timers, sandboxes, and compensable transactions.| Component | Props type | Purpose | Reference |
|---|---|---|---|
Subflow | SubflowProps | Embed another workflow as a child node. | Subflow |
WaitForEvent | WaitForEventProps | Suspend until a named external event arrives. | WaitForEvent |
Signal | SignalProps | Emit a named signal other nodes can wait on. | Signal |
Timer | TimerProps | Durably wait for a delay or a deadline. | Timer |
HumanTask | HumanTaskProps | Assign work to a human and wait for the result. | HumanTask |
Sandbox | SandboxProps | Run children in an isolated execution sandbox. | Sandbox |
ContinueAsNew | ContinueAsNewProps | Restart the run with fresh history to bound state. | ContinueAsNew |
Saga | SagaProps | Run steps with compensation that rolls back on failure. | Saga |
TryCatchFinally | TryCatchFinallyProps | Structured error handling around a child subtree. | TryCatchFinally |
Cross-cutting
Concerns that wrap or augment the whole graph.| Component | Props type | Purpose | Reference |
|---|---|---|---|
Aspects | AspectsProps | Apply cross-cutting behavior to matched nodes. | Aspects |
SuperSmithers | SuperSmithersProps | Orchestrate child workflows as one super-run. | SuperSmithers |
Source components package · Tests packages/components/tests · See also JSX overview, Types