Interface: BaseToolASTNode<TType, TTracking, THandle>

Defined in: ast/base/base-tool-ast-node.ts:14

Domain-agnostic base AST node contract for agent-invocable tools (ToolASTNode).

Declares effectTracking ('declared' vs 'subprocess-post-flight') so P.flow can statically verify whether an active policy guard requires a CheckpointableScope for post-flight diffing.

Extended by

• FsEditToolNode
• FsGlobToolNode
• FsGrepToolNode
• FsReadToolNode
• FsWriteToolNode
• GitCandidateComparisonToolNode
• GitRefReaderToolNode
• LocalCommandToolNode
• LocalServiceToolNode
• LocalStreamCheckToolNode
• FsEditToolNode
• FsGlobToolNode
• FsGrepToolNode
• FsReadToolNode
• FsWriteToolNode
• GitCandidateComparisonToolNode
• GitRefReaderToolNode
• LocalCommandToolNode
• LocalServiceToolNode
• LocalStreamCheckToolNode

Type Parameters

Type Parameter	Default type	Description
TType extends string	string	String-literal discriminant of the tool node.
TTracking extends "declared" | "subprocess-post-flight"	"declared" | "subprocess-post-flight"	Effect tracking mode ('declared' | 'subprocess-post-flight').
THandle	unknown	Isolation scope handle type operated on by the tool.

Properties

Property	Modifier	Type	Description	Defined in
__handleBrand?	readonly	BivariantCallback<[handle: THandle], void>	Phantom type brand binding the tool to its compatible scope handle type.	ast/base/base-tool-ast-node.ts:30
description	readonly	string	Human- and LLM-readable description of the tool's behavior.	ast/base/base-tool-ast-node.ts:24
effectTracking	readonly	TTracking	Static indicator of whether effects are predicted pre-flight or diffed post-flight.	ast/base/base-tool-ast-node.ts:28
inputSchema	readonly	ZodTypeAny	Zod schema validating tool call arguments before execution.	ast/base/base-tool-ast-node.ts:26
name	readonly	string	Wire-level tool function name exposed to the LLM.	ast/base/base-tool-ast-node.ts:22
type	readonly	TType	Unique string-literal discriminant of the tool node.	ast/base/base-tool-ast-node.ts:20