Interface: AgentNode<TIn, TOut, THandle>

Defined in: ast/agent-node.ts:43

Passive AST node representing the universal LLM actor primitive (P.agent(id)).

Contains zero execution methods and is dispatched at runtime via executeStepNode (switch (node.type)).

Type Parameters

Type Parameter	Default type	Description
TIn	unknown	Validated actor input payload type.
TOut	unknown	Validated actor output payload type.
THandle	unknown	Runtime handle type of the active isolation scope.

Properties

Property	Modifier	Type	Description	Defined in
beforeStopChecks	readonly	readonly BuiltInCheckASTNode<THandle>[]	Deterministic beforeStop checks verified whenever the agent emits a completion turn.	ast/agent-node.ts:75
canRaiseInterrupts	readonly	readonly InterruptNode<unknown>[]	Voluntary interrupts the agent may raise via synthetic interrupt tool calls.	ast/agent-node.ts:83
capabilities?	readonly	AgentCapabilitiesNode<TIn, THandle>	Optional hierarchical capabilities (.fork(), .speculate(), .mutatePlan(), .escalate()).	ast/agent-node.ts:85
extractPartitions?	readonly	BivariantCallback<[input: TIn], readonly string[]>	Optional synchronous extractor mapping TIn to ResolutionContext.activePartitions.	ast/agent-node.ts:81
grounding	readonly	readonly SourceValue<string>[]	Grounding sources resolved and injected into the agent's context.	ast/agent-node.ts:69
id	readonly	string	Unique identifier of the base agent definition.	ast/agent-node.ts:47
inputSchema	readonly	ZodType<TIn>	Zod schema validating the agent's input payload.	ast/agent-node.ts:77
instructions	readonly	readonly SourceValue<string>[]	Role instruction sources resolved and injected into the agent's context.	ast/agent-node.ts:71
lessons?	readonly	AgentLessonsMount	Optional empirical lessons mount descriptor.	ast/agent-node.ts:59
model	readonly	| ModelASTNode | PoolNode<ModelASTNode>	Model or model pool powering this agent's turns.	ast/agent-node.ts:53
onChildInterruptHandlers	readonly	readonly ChildInterruptHandlerNode<unknown>[]	Upward child interrupt handlers (.onChildInterrupt(...)).	ast/agent-node.ts:87
onInterruptHandlers	readonly	readonly InterruptHandlerNode<TIn, unknown, THandle>[]	Actor-level default interrupt handlers (.onInterrupt(...)).	ast/agent-node.ts:89
outputSchema	readonly	ZodType<TOut>	Zod schema validating the agent's structured output payload.	ast/agent-node.ts:79
policy?	readonly	PolicyNode<THandle>	Optional capability and sandbox policy governing tool execution and quantitative limits.	ast/agent-node.ts:65
prefixGroup?	readonly	PrefixGroupNode	Optional shared PrefixGroupNode for byte-identical wire system prompts.	ast/agent-node.ts:51
roleKey	readonly	string	Canonical role key (id or "${id}+tools:${sortedExtraToolNames.join(',')}") indexing CompiledWirePrefix.wireToolSchemasByRoleKey.	ast/agent-node.ts:49
rules?	readonly	RulesNode	Optional rules registry mounted on this agent.	ast/agent-node.ts:57
skills	readonly	readonly ( | SkillNode<THandle> | SourceASTNode<readonly SkillNode<THandle>[]>)[]	Mounted inline skills or source-backed skill bundles.	ast/agent-node.ts:61
timeoutMinutes?	readonly	number	Optional wall-clock timeout in minutes for the agent step.	ast/agent-node.ts:73
tools	readonly	readonly BuiltInToolASTNode<THandle>[]	Always-unlocked tools mounted directly on this agent.	ast/agent-node.ts:67
topology?	readonly	TopologyNode<string>	Optional relational topology whose live partition contracts are injected into the Turn-0 context frame.	ast/agent-node.ts:55
type	readonly	"harness:agent"	Discriminant identifying an LLM agent step AST node.	ast/agent-node.ts:45