AfterToolCallEvent
Defined in: src/hooks/events.ts:349
Event triggered after a tool execution completes. Fired after tool execution finishes, whether successful or failed. Uses reverse callback ordering for proper cleanup semantics.
Hook callbacks can mutate result to rewrite the tool result before it propagates to the model (e.g. to redact or truncate output).
Extends
Section titled “Extends”Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new AfterToolCallEvent(data): AfterToolCallEvent;Defined in: src/hooks/events.ts:370
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
data | { agent: LocalAgent; toolUse: ToolUseData; tool: Tool; result: ToolResultBlock; invocationState: InvocationState; error?: Error; } & HookableEventData |
Returns
Section titled “Returns”AfterToolCallEvent
Overrides
Section titled “Overrides”Properties
Section titled “Properties”invocationContext?
Section titled “invocationContext?”readonly invocationContext?: InvocationContext;Defined in: src/hooks/events.ts:100
The request this event belongs to (undefined outside one); pass it to InvokeOptions.invocationContext to join it.
Inherited from
Section titled “Inherited from”HookableEvent.invocationContext
readonly type: "afterToolCallEvent";Defined in: src/hooks/events.ts:350
readonly agent: LocalAgent;Defined in: src/hooks/events.ts:351
toolUse
Section titled “toolUse”readonly toolUse: ToolUseData;Defined in: src/hooks/events.ts:352
readonly tool: Tool;Defined in: src/hooks/events.ts:353
result
Section titled “result”result: ToolResultBlock;Defined in: src/hooks/events.ts:359
The tool result. Can be replaced by hook callbacks to transform the result before it enters the conversation history.
error?
Section titled “error?”readonly error?: Error;Defined in: src/hooks/events.ts:361
invocationState
Section titled “invocationState”readonly invocationState: InvocationState;Defined in: src/hooks/events.ts:362
retry?
Section titled “retry?”retry?: boolean;Defined in: src/hooks/events.ts:368
Optional flag that can be set by hook callbacks to request a retry of the tool call. When set to true, the agent will re-execute the tool.
Methods
Section titled “Methods”toJSON()
Section titled “toJSON()”toJSON(): Pick<AfterToolCallEvent, "toolUse" | "type" | "result"> & { error?: { message?: string; };};Defined in: src/hooks/events.ts:400
Serializes for wire transport, excluding the agent reference, tool instance, invocationState, and mutable retry flag. Converts Error to an extensible object for safe wire serialization. Called automatically by JSON.stringify().
Returns
Section titled “Returns”Pick<AfterToolCallEvent, "toolUse" | "type" | "result"> & {
error?: {
message?: string;
};
}