Skip to content

AfterToolsEvent

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

Event triggered after all tools complete execution. Fired after tool results are collected and ready to be added to conversation. Uses reverse callback ordering for proper cleanup semantics.

new AfterToolsEvent(data): AfterToolsEvent;

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

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

AfterToolsEvent

HookableEvent.constructor

readonly type: "afterToolsEvent";

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


readonly agent: LocalAgent;

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


readonly message: Message;

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


readonly invocationState: InvocationState;

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


endTurn: string | boolean = false;

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

When set to true, the agent loop halts after this tool batch completes without calling the model again and a default message ("Turn ended early by hook after tool execution") is appended as the final assistant message. When set to a string, that string is used instead of the default — the string becomes literal assistant content (a TextBlock), not a reason or label. Contrast with cancel fields on other events, where the string is a cancellation reason.

In both cases stopReason on the returned AgentResult is 'endTurn'.

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

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

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

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