Skip to content

Interface: FlowNode<TIn, THandle, TStepIds> ​

Defined in: ast/flow-node.ts:17

Passive AST node representing a declarative multi-step workflow (P.flow(id)).

Binds an input schema, a capability-tiered IsolationScopeASTNode, an optional TelemetryCollectorASTNode, an ordered sequence of FlowStepNode and FlowBranchNode items, and a terminal exitState label.

Type Parameters ​

Type ParameterDefault typeDescription
TInunknownValidated flow input payload type.
THandleunknownRuntime handle type of the flow's isolation scope.
TStepIds extends stringstringUnion of literal step and branch identifiers registered in nodes.

Properties ​

PropertyModifierTypeDescriptionDefined in
__stepIdsBrand?readonlyBivariantCallback<[stepId: TStepIds], void>Phantom bivariant brand preserving TStepIds across flow composition boundaries.ast/flow-node.ts:39
exitStatereadonlystringTerminal exit state label recorded when the flow completes its final node.ast/flow-node.ts:37
idreadonlystringUnique identifier of the flow.ast/flow-node.ts:25
inputSchemareadonlyZodType<TIn>Zod schema validating the work item input entering the flow.ast/flow-node.ts:27
nodesreadonlyreadonly ( | FlowStepNode<unknown, unknown, THandle, string> | FlowBranchNode<TIn, unknown, THandle, string>)[]Ordered sequence of step and branch AST nodes executed by the flow.ast/flow-node.ts:33
scopereadonlyIsolationScopeASTNode<THandle, Record<string, unknown>, Record<string, unknown>>Passive isolation scope AST node governing workspace lifecycle, checkpoints, and branching.ast/flow-node.ts:29
telemetry?readonlyFsTelemetryCollectorNodeOptional passive telemetry collector AST node folding observed ToolEffect lists into custom metrics.ast/flow-node.ts:31
typereadonly"harness:flow"Discriminant identifying a workflow AST node.ast/flow-node.ts:23

Released under the MIT License.