Per-session agent event stream (SSE)
Server-Sent Events stream of one agent session's frames — token deltas, tool-call proposals (approvalRequired is reserved for the server-side approval protocol; a proposal a firewall Ask rule asks for names that rule in approvalRule, one that asks because an update reset an earlier Allow carries updatedSinceAllowed: true, and one that asks lists the answers its prompt may offer in offeredAnswers), tool results (carrying the produced Asset structured payload, the result's by-reference resourceLinks [{uri, name, mimeType}], and fileMutation pre/post snapshots for file mutations), tool-progress frames (live 0…1 fraction of an awaited async-verb job while the kernel holds the call open), cost frames, and the terminal turn-ended marker. Between turns the stream also carries work-delivered frames — a conversation-scoped background job's terminal result injected by the server with no turn open ({workId, verb, jobId, outputAssetId, asset, isError, text}, mirroring job_result; text is the exact bracketed marker appended to the durable conversation transcript). A completion landing mid-turn queues and drains immediately after that turn's terminal frame, so turn-ended remains the last frame OF a turn while the subscription itself is worth holding open between turns. Each frame carries a monotonic per-session id:; reconnect with Last-Event-ID (or lastEventId= query param) to replay missed frames from the session's bounded ring buffer. Scoped: a subscriber sees only the named session's frames.
Request
- Base URL: http://localhost:9998
- URL: http://localhost:9998/v1/agent/stream
- Auth: HTTP bearer
Query parameters
The session id returned by POST /v1/agent/turn
Replay frames after this id (query-param form of Last-Event-ID)
Response
SSE stream of agent session frames
Changes
No recorded changes to this operation across all 1 revision of this API.