What is metered
The metrics that count toward your Cosmo Realtime usage.
What is metered
Cosmo Realtime meters two categories of activity: voice time and agent actions. Both are visible in the dashboard usage page.
Voice minutes
Voice minutes measure mic-active time — the duration from when the LiveKit mic track starts publishing to when it stops, aggregated across sessions.
A session that starts but where the user never speaks (or immediately mutes) contributes minimal mic-active time, not the full session wall-clock duration.
What counts
- Time while the local mic track is published and not muted.
- All sessions across all projects in the workspace.
What does not count
- Time spent muted (
RealtimeClientMute.muted = true). - Session-start latency (time between the REST call and
ready). - Time after
disconnect()orend().
Tool dispatches
A tool dispatch is counted each time the server-side handler for a tool call begins executing (the tool-dispatch-started event). This includes both successful and failed tool executions.
What counts
- Each
tool-dispatch-startedevent per session. - All tool names, including
cosmo_brain,find_workspace_files,start_analysis, and any other server-side tools enabled for the workspace.
What does not count
- The model deciding to call a tool (
tool-callevent) before the server begins execution. - Client-side logic that handles tool responses on the JavaScript/Python/Swift side.
Sessions
A session is counted each time a POST /session/start call succeeds and returns a LiveKit token — regardless of whether the client successfully joins the room or the agent speaks. Failed session-start calls (4xx, 5xx) do not count.
Reviewing usage
All three metrics are broken down by time range on the Developer platform → Usage page. See Usage dashboard for a walkthrough.
Pricing
Usage is billed according to your plan. See the dashboard for current rates and limits — this documentation intentionally omits dollar values to stay accurate across plan changes.