Skip to content

BeforeToolsEvent

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

Event triggered before executing tools. Fired when the model returns tool use blocks that need to be executed. Hook callbacks can set cancel to prevent all tools from executing.

new BeforeToolsEvent(data): BeforeToolsEvent;

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

ParameterType
data{ agent: LocalAgent; message: Message; invocationState: InvocationState; }
data.agentLocalAgent
data.messageMessage
data.invocationStateInvocationState

BeforeToolsEvent

HookableEvent.constructor

readonly type: "beforeToolsEvent";

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


readonly agent: LocalAgent;

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


readonly message: Message;

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


readonly invocationState: InvocationState;

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


cancel: string | boolean = false;

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

Set by hook callbacks to cancel all tool calls. When set to true, a default cancel message is used. When set to a string, that string is used as the tool result error message.

toJSON(): Pick<BeforeToolsEvent, "type" | "message">;

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

Serializes for wire transport, excluding the agent reference, invocationState, and mutable cancel flag. Called automatically by JSON.stringify().

Pick<BeforeToolsEvent, "type" | "message">