Agent

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.

get/v1/agent/stream

Request

  • Base URL: http://localhost:9998
  • URL: http://localhost:9998/v1/agent/stream
  • Auth: HTTP bearer

Query parameters

sessionstring required

The session id returned by POST /v1/agent/turn

lastEventIdinteger

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.