Stream session events

The same log as a live tail, framed as server-sent events: one event per row, id the seq, event the wire type, and data the same SessionEventBody the paged read renders.

The stream stays open across idle stretches – a keep-alive comment holds the connection while nothing happens – so one connection spans a session’s whole life rather than a single run. With no position named it starts at the live head, fixed before the response begins; a client that wants history pages the events route newest-first and deduplicates on seq against what the tail delivers.

With deltas=true the stream also carries delta frames: a model’s output as it is produced, one SessionDeltaBody each, with no id. Deltas are never stored and may be lost; each previews one target until the event that ends it lands – for a model call, the message_assistant with the same model_call_id – or a discard frame says it never will. A reader joining mid-target first receives the frames that target sent so far.

curl -X GET "https://api.us.cloud.subako.ai/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/events/stream" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.us.cloud.subako.ai/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/events/stream", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.us.cloud.subako.ai/v1/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/events/stream",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

{
  "agent_id": "string",
  "agent_version_id": "string",
  "type": "session_created",
  "created_at": "2019-08-24T14:15:22Z",
  "seq": 0
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "string"
  }
}