AfterToolCallEvent

Defined in: src/hooks/events.ts:256

Event triggered after a tool execution completes. Fired after tool execution finishes, whether successful or failed. Uses reverse callback ordering for proper cleanup semantics.

Extends

• HookableEvent

Constructors

Constructor

new AfterToolCallEvent(data): AfterToolCallEvent;

Defined in: src/hooks/events.ts:281

Parameters

Parameter	Type
data	{ agent: LocalAgent; toolUse: { name: string; toolUseId: string; input: JSONValue; }; tool: Tool; result: ToolResultBlock; invocationState: InvocationState; error?: Error; }
data.agent	LocalAgent
data.toolUse	{ name: string; toolUseId: string; input: JSONValue; }
data.toolUse.name	string
data.toolUse.toolUseId	string
data.toolUse.input	JSONValue
data.tool	Tool
data.result	ToolResultBlock
data.invocationState	InvocationState
data.error?	Error

Returns

AfterToolCallEvent

Overrides

HookableEvent.constructor

Properties

type

readonly type: "afterToolCallEvent";

Defined in: src/hooks/events.ts:257

---

agent

readonly agent: LocalAgent;

Defined in: src/hooks/events.ts:258

---

toolUse

readonly toolUse: {
  name: string;
  toolUseId: string;
  input: JSONValue;
};

Defined in: src/hooks/events.ts:259

name

name: string;

toolUseId

toolUseId: string;

input

input: JSONValue;

---

tool

readonly tool: Tool;

Defined in: src/hooks/events.ts:264

---

result

result: ToolResultBlock;

Defined in: src/hooks/events.ts:270

The tool result. Can be replaced by hook callbacks to transform the result before it enters the conversation history.

---

error?

readonly optional error?: Error;

Defined in: src/hooks/events.ts:272

---

invocationState

readonly invocationState: InvocationState;

Defined in: src/hooks/events.ts:273

---

retry?

optional retry?: boolean;

Defined in: src/hooks/events.ts:279

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

toJSON()

toJSON(): Pick<AfterToolCallEvent, "toolUse" | "type" | "result"> & {
  error?: {
     message?: string;
  };
};

Defined in: src/hooks/events.ts:309

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

Pick<AfterToolCallEvent, "toolUse" | "type" | "result"> & { error?: { message?: string; }; }