Cosmo Realtime SDK
Meta

Changelog

Per-SDK version history for the Cosmo Realtime SDKs.

Changelog

All notable changes across the three Cosmo Realtime SDKs. Dates are release dates.


TypeScript — cosmo-ai

v0.1.0 — 2026-05-01

Initial release.

  • RealtimeClient class with connect, disconnect, sendText, setMicMuted, waitUntilReady.
  • CosmoRealtimeProvider + useRealtimeClient, useTransportState, useAgentState, useMediaState, useTranscript, useToolCalls, useRealtimeError, useMicLevel, useOutputLevel hooks.
  • RealtimeAudio, MicToggle, BarVisualizer, StartAudio components.
  • Screen share: startScreenShare, stopScreenShare, isScreenSharing.
  • Video stream API: addVideoStream, removeVideoStream.
  • COSMO_BRAIN_TOOL and DEFAULT_SERVER_TOOLS constants.
  • Auto-reconnect with configurable maxAttempts and backoffMs.
  • Typed event system: transport_state, agent_state, media_state, transcript, model_text, tool_call, tool_result, volume, error, ready, conversation_link.
  • Envelope chunking for messages exceeding the 15 KiB data-channel limit.
  • Transport abstraction (RealtimeTransport interface) with LiveKitTransport default.

Python — cosmo-ai-sdk

v0.1.0 — 2026-05-01

Initial release.

  • CosmoRealtimeClient async class with connect, disconnect, send_text, send_mute, set_microphone_enabled, send_ping, end.
  • async with support via __aenter__ / __aexit__.
  • Typed subscriptions: on_transcript, on_tool_call, on_tool_result, on_ready, on_conversation_link, on_error, on_message (catch-all).
  • Generated AuthenticatedClient and Client from realtime-openapi.json.
  • Generated models: RealtimeClientInit, RealtimeSessionRequest, RealtimeSessionResponse, RealtimeTranscriptDelta, RealtimeToolCall, RealtimeToolResult, RealtimeReady, RealtimeConversationLink, RealtimeError, RealtimeErrorCode, RealtimeTranscriptRole, and supporting types.
  • Envelope reassembly for server-envelope-chunk messages.
  • Optional livekit extra for microphone publishing support.
  • structlog-based logging with structured fields.

Swift — CosmoRealtime

v0.1.0 — 2026-05-01

Initial release.

  • CosmoRealtimeClient actor with connect(init:), disconnect, send(text:audioResponse:), setMicrophoneMuted, sendPing, end.
  • Event subscriptions returning Cancellable: onTranscript, onToolCall, onReady, onConversationLink, onError.
  • CosmoRealtimeClient.Configuration with apiKey and baseURL.
  • RealtimeClientConfig typealias.
  • CosmoRealtimeError enum: sessionStartFailed, notConnected.
  • Generated Client and Components.Schemas.* types from realtime-openapi.json via Swift OpenAPI Generator plugin.
  • EnvelopeReassembler actor for transparent reassembly of server-envelope-chunk messages.
  • BearerAuthMiddleware for automatic Authorization: Bearer injection.
  • @_exported re-exports of OpenAPIRuntime and OpenAPIURLSession.

On this page