Components API

Components are exported from smithers-orchestrator. createSmithers(...) also returns the same primitives bound to the workflow context and typed output schemas, which is the preferred form inside workflow modules.

const { Workflow, Task, Sequence, Parallel, Branch, Loop } = createSmithers(schemas);

Every row below links to that component’s guide page. Full prop tables live in the Types reference; for the model, see the JSX overview.

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
`Memory`	`MemoryProps`	Provide recall, primers, retention, and memory tools to descendant tasks.	Memory
`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
`DelegationChain`	`DelegationChainProps`	Hand a task down a chain of agents until one resolves it.	DelegationChain
`Trellis`	`TrellisProps`	Let trusted author agents compile bounded recursive delegation programs.	Trellis

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
`Sidecar`	`SidecarProps`	Attach a companion node that runs alongside a subtree.	Sidecar
`UI`	`UIProps`	Mount a live custom web UI for the run.	UI
`TUI`	`TUIProps`	Render a terminal UI for the run.	TUI

Source components package · Tests packages/components/tests · See also JSX overview, Types

Overview

Core API

Runtime

Types & errors

Gateway RPC

Control flow

Composite

Engine

Cross-cutting

​Control flow

​Composite

​Engine

​Cross-cutting

Control flow

Composite

Engine

Cross-cutting