Interface: SpeculateCapabilityNode<TParentIn, TReq, TChildIn, TChildOut, THandle, TCrossReport, TVerdict>

Defined in: ast/speculate-capability-node.ts:102

Passive AST node representing a parallel speculative tournament capability ($cap.speculate(toolName, $s => ...)).

Forks $B$ isolated branch scopes in parallel, executes workerExecutable across mapBranches, runs crossVerifier, arbitrates or verifies the winner, and optionally refines the winning branch before committing.

Type Parameters

Type Parameter	Default type	Description
TParentIn	unknown	Parent actor input payload type.
TReq	unknown	Validated speculation tool request payload type.
TChildIn	unknown	Branch worker input payload type.
TChildOut	unknown	Branch worker output payload type.
THandle	unknown	Runtime handle type of the active BranchableScope.
TCrossReport	unknown	Cross-verifier report payload type.
TVerdict	unknown	Arbiter agent structured verdict payload type.

Properties

Property	Modifier	Type	Description	Defined in
arbiter	readonly	SpeculateArbiterConfig<THandle, TVerdict>	Arbiter agent and decision resolver invoked on contested or multi-survivor tournaments.	ast/speculate-capability-node.ts:130
branchCount	readonly	number	Number of parallel speculative branches $B \ge 2$.	ast/speculate-capability-node.ts:122
crossVerifier?	readonly	CrossVerifierASTNode<THandle, Record<string, unknown>, TCrossReport>	Optional cross-verifier AST node executed across surviving candidate branches before arbitration.	ast/speculate-capability-node.ts:126
mapBranches	readonly	BivariantCallback<[parentInput: TParentIn, req: TReq], readonly TChildIn[]>	Synchronous mapper producing $B$ branch inputs from (parentInput, req).	ast/speculate-capability-node.ts:124
refineWinnerWhen?	readonly	SpeculateRefineWinnerConfig<TParentIn, TChildIn, TChildOut, THandle, TVerdict, unknown>	Optional post-arbitration winner refinement configuration.	ast/speculate-capability-node.ts:132
requestSchema	readonly	ZodType<TReq>	Zod schema validating the parent agent's speculation tool call arguments.	ast/speculate-capability-node.ts:116
toolName	readonly	string	Tool name exposed to the parent agent for launching the tournament.	ast/speculate-capability-node.ts:114
type	readonly	"harness:speculate-capability"	Discriminant identifying a speculative tournament capability AST node.	ast/speculate-capability-node.ts:112
verifyWinnerWith?	readonly	SpeculateVerifyWinnerConfig<TChildIn, TChildOut, THandle, unknown, unknown>	Optional sole-survivor evaluator configuration when 1 branch completes uncontested.	ast/speculate-capability-node.ts:128
workerExecutable	readonly	| AgentNode<TChildIn, TChildOut, THandle> | LoopNode<TChildIn, TChildOut, THandle, string>	Worker agent or loop executed in parallel across all $B$ tournament branches.	ast/speculate-capability-node.ts:118