Interface: ForkCapabilityNode<TParentIn, TReq, TChildIn, TChildOut, THandle>

Defined in: ast/fork-capability-node.ts:39

Passive AST node representing a downward child fork capability tool ($cap.fork(toolName, childExecutable, $f => ...)).

Spawns an isolated child scope branch when invoked by the parent agent, executes childExecutable over mapInput(parentInput, req), and commits or reconciles the child scope upon completion.

Type Parameters

Type Parameter	Default type	Description
TParentIn	unknown	Parent actor input payload type.
TReq	unknown	Validated fork tool request payload type.
TChildIn	unknown	Child executable input payload type.
TChildOut	unknown	Child executable output payload type.
THandle	unknown	Runtime handle type of the active BranchableScope.

Properties

Property	Modifier	Type	Description	Defined in
childExecutable	readonly	| AgentNode<TChildIn, TChildOut, THandle> | LoopNode<TChildIn, TChildOut, THandle, string>	Child agent or loop executable invoked inside the forked child isolation scope.	ast/fork-capability-node.ts:51
historyMode	readonly	"shared-prefix-only" | "clone-transcript"	Transcript history sharing mode ('shared-prefix-only' default or 'clone-transcript').	ast/fork-capability-node.ts:55
mapInput	readonly	BivariantCallback<[parentInput: TParentIn, req: TReq], TChildIn>	Synchronous mapper projecting (parentInput, req) into the child executable's input TChildIn.	ast/fork-capability-node.ts:59
modelRouting?	readonly	ForkModelRoutingConfig<TParentIn, TReq>	Optional dynamic model routing configuration for child forks.	ast/fork-capability-node.ts:61
requestSchema	readonly	ZodType<TReq>	Zod schema validating the parent agent's fork tool call arguments.	ast/fork-capability-node.ts:57
toolName	readonly	string	Tool name exposed to the parent agent for invoking this downward fork.	ast/fork-capability-node.ts:49
type	readonly	"harness:fork-capability"	Discriminant identifying a downward fork capability AST node.	ast/fork-capability-node.ts:47