DefaultToolExecutor

Default tool executor extracted from Runtime.wrapToolsWithEnforcement().

Handles:

• Enforcement checks via ToolEnforcer
• Idempotency key generation
• Context enrichment (experimental_context)
• Error propagation via HookRunner

Implements

• ToolExecutor

Constructors

Constructor

new DefaultToolExecutor(config): DefaultToolExecutor;

Parameters

Parameter	Type
config	DefaultToolExecutorConfig

Returns

DefaultToolExecutor

Methods

buildIdempotencyKey()

buildIdempotencyKey(args): string;

Build a deterministic idempotency key for external side-effect deduplication.

Parameters

Parameter	Type
args	{ agentId: string; sessionId: string; step: number; toolCallId: string; toolName: string; }
args.agentId	string
args.sessionId	string
args.step	number
args.toolCallId	string
args.toolName	string

Returns

string

Implementation of

ToolExecutor.buildIdempotencyKey

---

execute()

execute(args): Promise<unknown>;

Execute a single tool call with enforcement checks and context enrichment. Returns the tool’s result or throws if blocked/failed.

Parameters

Parameter	Type
args	{ abortSignal?: AbortSignal; agentId: string; input: unknown; session: Session; step?: number; tool: ExecutableTool; toolCallHistory?: ToolCallRecord[]; toolCallId?: string; toolName: string; turn?: number; userId?: string; }
args.abortSignal?	AbortSignal
args.agentId	string
args.input	unknown
args.session	Session
args.step?	number
args.tool	ExecutableTool
args.toolCallHistory?	ToolCallRecord[]
args.toolCallId?	string
args.toolName	string
args.turn?	number
args.userId?	string

Returns

Promise<unknown>

Implementation of

ToolExecutor.execute