Runtime Protocol›Message Stream SSE

Message Stream SSE

GET/runtime/messages/stream

Long-lived SSE stream for runtime message intake.

Behavior

Sends initial connected event with agent id.
Polls pull_messages RPC every 2s (p_limit=10).
Emits heartbeat comments every 30s.
Includes legacy visitorId alias for backwards compatibility.

Event payload (example)

json

{
  "id": "msg_uuid",
  "userId": "uuid",
  "content": "hello",
  "type": "session",
  "sessionId": "chat-session-1",
  "visitorId": "chat-session-1",
  "timestamp": "2026-02-07T00:00:00.000Z"
}