Skip to content

Interface: AgentChatEvent

One Responses-API-shaped event yielded by the agents plugin SSE stream.

The hook handles the two paths every chat UI needs — accumulating content from response.output_text.delta and capturing threadId from appkit.metadata — and surfaces everything else (tool calls, approval gates, status events, etc.) through UseAgentChatOptions.onEvent.

Fields beyond type are intentionally loose because the agents plugin forwards adapter-specific shapes verbatim. Treat unknown fields as opaque pass-through.

optional annotations?: Record<string, unknown>


optional approval_id?: string


optional args?: unknown


optional content?: string


optional data?: Record<string, unknown>


optional delta?: string


optional error?: string


optional item?: object

optional arguments?: string

optional call_id?: string

optional id?: string

optional name?: string

optional output?: string

optional status?: string

optional type?: string


optional item_id?: string


optional output_index?: number


optional sequence_number?: number


optional stream_id?: string


optional tool_name?: string


type: string