Skip to content

EscalationRequest

The handoff package built when a conversation escalates to a human: everything the receiving agent needs to take over without re-asking.

agentId: string;

at: string;

ISO8601 timestamp.


optional category?: EscalationReason;

Typed category when the trigger provided one.


reason: string;

Free-form reason from the triggering control (tool call, validator, flow transition).


recentMessages: object[];

Recent conversation tail as a text projection, oldest first.

Name Type

content

string

role

string


sessionId: string;

state: Record<string, unknown>;

Collected flow state snapshot (internal __-prefixed keys excluded).


optional summary?: string;

LLM-generated handoff brief (when summarization is enabled and a model is available).


optional userId?: string;