Zero-dependency protocol package. Shared contract between the Python voice agent and all frontends.

Topics

See Topics reference for the full table.

Message types

TypeUsed on topic
ConfigPayloadconfig
ConfigAckPayloadconfig_ack
ConfigRequestPayloadconfig_request
ConversationMessagemessage:new
SessionEndPayloadsession:end
PublicTokenRequest / PublicTokenResponseHTTP /public/token
PublicSessionRequest / PublicSessionResponseHTTP /public/session
IdentityResponseClient identity
SessionOptionsSession options
RestoreStateConfig restore
FeatureDefinitionConfig features
ToolConfigConfig tools
CollectionConfig collections
See Message types for field details.

Collection

Content collections attached to the scenario, compiled server-side into the published version and delivered on the config topic:

RPC

RPC payload types

See RPC contracts.

Multi-language spec

The protocol package is the source of truth for cross-language SDKs. Future scenaro-protocol extraction (Python, Go) will align on these same definitions. Source: packages/sdk/src/protocol/ in the scenaro/projects monorepo.