Realtime Sessions

Realtime sessions are the live-session equivalent of prompt and agent runs. They capture what happened during a voice or realtime conversation, including agent handoffs, tool calls, runtime events, and the graph snapshot that launched the session.

What sessions are

Each realtime session currently tracks:

• the root agent and root agent version
• provider and model
• external realtime session id
• transport type
• overall latency and completion state
• recorded handoffs and tool events

What gets recorded

Realtime session detail is built from a run plus the ordered steps/events captured during execution. The app exposes:

• a runtime timeline
• tool call summaries
• session metadata
• handoff history
• the resolved agent graph used when the session started

This is what makes voice agents inspectable rather than opaque.

Current app views

The list view focuses on:

• session counts
• average latency
• number of handoffs
• session entrypoints and model/provider combinations

The detail view is optimized for debugging live behavior after the fact.

API workflow

curl "$API_BASE/api/realtime-sessions?organizationId=org_123" \
  -H "Authorization: Bearer $TOKEN"

curl "$API_BASE/api/realtime-sessions/run_123?organizationId=org_123" \
  -H "Authorization: Bearer $TOKEN"