spatialreal 0.1.0__py3-none-any.whl

spatialreal/__init__.py

@@ -0,0 +1,52 @@
+# Copyright 2026 SpatialReal.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""SpatialReal Python SDK — realtime avatar sessions.
+
+Successor to the retired ``avatarkit`` package: same wire protocol and session
+semantics, one import swap for existing callers, plus structured playback
+events (``on_playback``) and the WebSocket close-code contract (``CloseCode``,
+``AvatarSDKError.retryable``).
+"""
+
+from .config import (
+    AgoraEgressConfig,
+    AudioFormat,
+    LiveKitEgressConfig,
+    SessionConfig,
+)
+from .errors import AvatarSDKError, AvatarSDKErrorCode, CloseCode, SessionTokenError
+from .events import InterruptReason, PlaybackSignal, PlaybackState, PlaybackStateEvent
+from .logid import generate_log_id
+from .session import AvatarSession, new_avatar_session
+from .version import __version__
+
+__all__ = [
+    "AgoraEgressConfig",
+    "AudioFormat",
+    "AvatarSDKError",
+    "AvatarSDKErrorCode",
+    "AvatarSession",
+    "CloseCode",
+    "LiveKitEgressConfig",
+    "PlaybackSignal",
+    "PlaybackStateEvent",
+    "PlaybackState",
+    "InterruptReason",
+    "SessionConfig",
+    "SessionTokenError",
+    "__version__",
+    "generate_log_id",
+    "new_avatar_session",
+]

spatialreal/config.py

@@ -0,0 +1,101 @@
+"""Session configuration types."""
+
+from __future__ import annotations
+
+from collections.abc import Callable
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+
+from .events import PlaybackSignal, PlaybackStateEvent
+
+
+class AudioFormat(str, Enum):
+    """Audio input encoding negotiated for a session.
+
+    ``PCM_S16LE``: raw PCM16 mono at ``sample_rate``.
+    ``OGG_OPUS``: one continuous, pre-encoded Ogg Opus stream per request id
+    (this SDK does not encode client-side; send encoded bytes).
+    """
+
+    PCM_S16LE = "pcm_s16le"
+    OGG_OPUS = "ogg_opus"
+
+
+@dataclass
+class LiveKitEgressConfig:
+    """Stream the avatar's audio/video into a LiveKit room via the egress service.
+
+    When set on a session, animation is NOT returned over the WebSocket; the
+    egress worker joins the room and publishes synchronized tracks. The WebSocket
+    carries only control/lifecycle messages.
+    """
+
+    url: str = ""
+    api_token: str = field(default="", repr=False)
+    room_name: str = ""
+    publisher_id: str = ""
+    extra_attributes: dict[str, str] = field(default_factory=dict)
+    # 0 = server default. Server closes the egress connection when completely silent.
+    idle_timeout: int = 0
+    # Deprecated pair, kept for wire compatibility; prefer api_token.
+    api_key: str = field(default="", repr=False)
+    api_secret: str = field(default="", repr=False)
+
+
+@dataclass
+class AgoraEgressConfig:
+    """Stream the avatar's audio/video into an Agora channel via the egress service."""
+
+    channel_name: str = ""
+    token: str = field(default="", repr=False)
+    uid: int = 0
+    publisher_id: str = ""
+
+
+@dataclass
+class SessionConfig:
+    """Configuration for an :class:`~spatialreal.AvatarSession`.
+
+    Callback contract (all callbacks run on the session's event loop and must
+    not block):
+
+    - ``on_playback(signal)``: structured playback lifecycle parsed from
+      ``ServerResponseAnimation`` — preferred over ``transport_frames``.
+    - ``on_playback_state(event)``: structured ``ServerPlaybackState`` for
+      egress-mode playback control (pause/resume/interrupt position); only
+      arrives when the server declares the ``playback_state`` capability.
+    - ``transport_frames(frame_bytes, is_last)``: the raw serialized ``Message``
+      envelope, for callers that decode the protobuf themselves.
+    - ``on_error(error)``: transport/server errors outside a call site (read
+      loop). Errors raised by ``send_audio``/``interrupt`` are raised, not
+      routed here.
+    - ``on_close()``: fired exactly once when the session ends, whether by
+      ``close()`` or by the connection dropping.
+    """
+
+    avatar_id: str = ""
+    api_key: str = field(default="", repr=False)
+    app_id: str = ""
+    # v2 auth style: False = headers (mobile-style), True = URL query params (web-style).
+    use_query_auth: bool = False
+    expire_at: datetime | None = None
+    sample_rate: int = 16000
+    bitrate: int = 0
+    audio_format: AudioFormat = AudioFormat.PCM_S16LE
+    console_endpoint_url: str = ""
+    ingress_endpoint_url: str = ""
+    livekit_egress: LiveKitEgressConfig | None = None
+    agora_egress: AgoraEgressConfig | None = None
+
+    on_playback: Callable[[PlaybackSignal], None] | None = None
+    on_playback_state: Callable[[PlaybackStateEvent], None] | None = None
+    transport_frames: Callable[[bytes, bool], None] | None = None
+    on_error: Callable[[Exception], None] | None = None
+    on_close: Callable[[], None] | None = None
+
+    # Timeout for the console session-token HTTP call.
+    token_request_timeout: float = 30.0
+
+    def __post_init__(self) -> None:
+        self.audio_format = AudioFormat(self.audio_format)

spatialreal/errors.py

@@ -0,0 +1,155 @@
+"""Error taxonomy for the SpatialReal SDK.
+
+Error codes keep the names the retired avatarkit SDK used, so migrating callers
+can keep their logging/branching. New in this SDK: ``CloseCode`` mirrors the
+server's WebSocket close-code contract (40xx = the request is at fault, retrying
+changes nothing; 45xx = the server is briefly unable, retry with backoff), and
+``AvatarSDKError.retryable`` answers "should I reconnect?" so callers don't have
+to memorize the ranges.
+"""
+
+from __future__ import annotations
+
+from enum import Enum, IntEnum
+
+
+class AvatarSDKErrorCode(str, Enum):
+    """Stable, log-friendly error codes surfaced by the SDK."""
+
+    sessionTokenExpired = "sessionTokenExpired"
+    sessionTokenInvalid = "sessionTokenInvalid"
+    appIDUnrecognized = "appIDUnrecognized"
+    appIDMismatch = "appIDMismatch"
+    avatarNotFound = "avatarNotFound"
+    billingRequired = "billingRequired"
+    creditsExhausted = "creditsExhausted"
+    sessionDurationExceeded = "sessionDurationExceeded"
+    concurrencyLimit = "concurrencyLimit"
+    unsupportedSampleRate = "unsupportedSampleRate"
+    invalidEgressConfig = "invalidEgressConfig"
+    egressUnavailable = "egressUnavailable"
+    idleTimeout = "idleTimeout"
+    upstreamError = "upstreamError"
+    invalidRequest = "invalidRequest"
+    connectionFailed = "connectionFailed"
+    connectionClosed = "connectionClosed"
+    protocolError = "protocolError"
+    serverError = "serverError"
+    unknown = "unknown"
+
+
+class CloseCode(IntEnum):
+    """WebSocket close codes the server sends when it ends a session.
+
+    A client contract, not diagnostics (mirrors driveningress/v2 proto):
+    40xx — the request itself is at fault; do not reconnect.
+    45xx — transient server-side trouble; reconnect with backoff.
+    """
+
+    CREDITS_EXHAUSTED = 4001
+    SESSION_TIMEOUT = 4002
+    CONCURRENCY_LIMIT = 4003
+    AUTH_FAILED = 4010
+    UPSTREAM_UNAVAILABLE = 4503
+
+
+# Close codes for which reconnecting is expected to work.
+_RETRYABLE_CLOSE_CODES = frozenset(
+    {
+        int(CloseCode.SESSION_TIMEOUT),  # proto: "Reconnect is allowed and expected"
+        int(CloseCode.UPSTREAM_UNAVAILABLE),
+    }
+)
+
+_CLOSE_CODE_TO_ERROR = {
+    int(CloseCode.CREDITS_EXHAUSTED): AvatarSDKErrorCode.creditsExhausted,
+    int(CloseCode.SESSION_TIMEOUT): AvatarSDKErrorCode.sessionDurationExceeded,
+    int(CloseCode.CONCURRENCY_LIMIT): AvatarSDKErrorCode.concurrencyLimit,
+    int(CloseCode.AUTH_FAILED): AvatarSDKErrorCode.sessionTokenInvalid,
+    int(CloseCode.UPSTREAM_UNAVAILABLE): AvatarSDKErrorCode.upstreamError,
+}
+
+
+class AvatarSDKError(Exception):
+    """SDK exception with a stable error code and structured context."""
+
+    def __init__(
+        self,
+        code: AvatarSDKErrorCode,
+        message: str,
+        *,
+        phase: str = "unknown",
+        http_status: int | None = None,
+        server_code: str | None = None,
+        server_detail: str | None = None,
+        connection_id: str | None = None,
+        req_id: str | None = None,
+        raw_body: str | None = None,
+        close_code: int | None = None,
+        close_reason: str | None = None,
+    ):
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.phase = phase
+        self.http_status = http_status
+        self.server_code = server_code
+        self.server_detail = server_detail
+        self.connection_id = connection_id
+        self.req_id = req_id
+        self.raw_body = raw_body
+        self.close_code = close_code
+        self.close_reason = close_reason
+
+    @property
+    def retryable(self) -> bool:
+        """Whether reconnecting can plausibly succeed, per the close-code contract.
+
+        Unknown/absent close codes count as retryable: transport-level failures
+        (network blips, process restarts) close without our 40xx codes, and for
+        those, giving up for good is the wrong default.
+        """
+        if self.close_code is None:
+            return self.code in (
+                AvatarSDKErrorCode.connectionFailed,
+                AvatarSDKErrorCode.connectionClosed,
+                AvatarSDKErrorCode.upstreamError,
+            )
+        if self.close_code in _RETRYABLE_CLOSE_CODES:
+            return True
+        if 4000 <= self.close_code < 4500:
+            return False
+        return True
+
+    def __str__(self) -> str:  # pragma: no cover
+        return f"{self.code.value}: {self.message}"
+
+
+class SessionTokenError(AvatarSDKError):
+    """Raised when the session-token exchange with the console API fails."""
+
+    def __init__(
+        self,
+        message: str,
+        *,
+        code: AvatarSDKErrorCode = AvatarSDKErrorCode.invalidRequest,
+        http_status: int | None = None,
+        server_code: str | None = None,
+        server_detail: str | None = None,
+        raw_body: str | None = None,
+    ):
+        super().__init__(
+            code=code,
+            message=message,
+            phase="session_token",
+            http_status=http_status,
+            server_code=server_code,
+            server_detail=server_detail,
+            raw_body=raw_body,
+        )
+
+
+def error_code_for_close_code(close_code: int | None) -> AvatarSDKErrorCode:
+    if close_code is None:
+        return AvatarSDKErrorCode.connectionClosed
+    return _CLOSE_CODE_TO_ERROR.get(close_code, AvatarSDKErrorCode.connectionClosed)

spatialreal/events.py

@@ -0,0 +1,66 @@
+"""Structured events the SDK surfaces to callers."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+
+
+@dataclass(frozen=True)
+class PlaybackSignal:
+    """Playback lifecycle parsed from a ``ServerResponseAnimation`` message.
+
+    Semantics depend on the delivery mode:
+
+    - WebSocket direct return: frames carry animation data; ``end=True`` means
+      generation for the request is complete.
+    - LiveKit/Agora egress: frames are empty control signals; a non-end frame
+      marks playback progress/start and ``end=True`` means the egress playout
+      for the request has fully drained. Egress-path retransmission can deliver
+      ``end=True`` more than once per ``req_id`` — dedupe on the consumer side.
+    """
+
+    req_id: str
+    end: bool
+    connection_id: str = ""
+    avatar_id: str = ""
+    has_animation: bool = False
+
+
+class PlaybackState(str, Enum):
+    """State reported by a ``ServerPlaybackState`` message (egress mode)."""
+
+    UNSPECIFIED = "unspecified"
+    PLAYING = "playing"
+    PAUSED = "paused"
+    ENDED = "ended"
+    INTERRUPTED = "interrupted"
+
+
+class InterruptReason(str, Enum):
+    """``reason`` on an INTERRUPTED playback state."""
+
+    EXPLICIT = "explicit"  # an explicit interrupt() / client interrupt
+    PREEMPTED = "preempted"  # a newer request superseded this one
+    PAUSE_TIMEOUT = "pause_timeout"  # a held pause exceeded the server limit
+
+
+@dataclass(frozen=True)
+class PlaybackStateEvent:
+    """Structured ``ServerPlaybackState`` (egress-mode playback control, #51).
+
+    Emitted for every ``pause()``/``resume()`` (the state *after* the operation)
+    and spontaneously by the server on playback start/end/interrupt. Only sent
+    when the server declared the ``playback_state`` capability; older servers
+    never send it. ``played_ms`` is content playout position (excludes
+    transitions, does not advance while paused). ``reason`` is meaningful only
+    for ``INTERRUPTED`` — notably ``pause_timeout`` means a held pause hit the
+    server limit and the caller should treat the segment as interrupted (drop
+    retained audio, do not resume).
+    """
+
+    req_id: str
+    state: PlaybackState
+    played_ms: int = 0
+    reason: str = ""
+    connection_id: str = ""

spatialreal/logid.py

@@ -0,0 +1,19 @@
+"""Request/log id generation.
+
+Format is shared with the Go backend and the retired avatarkit SDK:
+"YYYYMMDDHHMMSS_<nanoid12>" (UTC). Every request gets a fresh id; ids are
+never reused within a connection — the plugin's interrupt bookkeeping and the
+backend's session mapping both rely on uniqueness.
+"""
+
+from datetime import datetime, timezone
+
+from nanoid import generate
+
+LOG_ID_TIME_FORMAT = "%Y%m%d%H%M%S"
+LOG_ID_NANOID_LENGTH = 12
+
+
+def generate_log_id() -> str:
+    timestamp = datetime.now(timezone.utc).strftime(LOG_ID_TIME_FORMAT)
+    return f"{timestamp}_{generate(size=LOG_ID_NANOID_LENGTH)}"

spatialreal/proto/generated/message_pb2.py

@@ -0,0 +1,96 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: driveningress/v2/driveningress.proto
+# Protobuf Python Version: 6.31.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    6,
+    31,
+    1,
+    '',
+    'driveningress/v2/driveningress.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$driveningress/v2/driveningress.proto\x12\x10\x64riveningress.v2\x1a\x1cgoogle/protobuf/struct.proto\"\xa7\x02\n\x13LiveKitEgressConfig\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x0f\n\x07\x61pi_key\x18\x02 \x01(\t\x12\x12\n\napi_secret\x18\x03 \x01(\t\x12\x11\n\troom_name\x18\x04 \x01(\t\x12\x14\n\x0cpublisher_id\x18\x05 \x01(\t\x12T\n\x10\x65xtra_attributes\x18\x06 \x03(\x0b\x32:.driveningress.v2.LiveKitEgressConfig.ExtraAttributesEntry\x12\x14\n\x0cidle_timeout\x18\x07 \x01(\x05\x12\x11\n\tapi_token\x18\x08 \x01(\t\x1a\x36\n\x14\x45xtraAttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"[\n\x11\x41goraEgressConfig\x12\x14\n\x0c\x63hannel_name\x18\x01 \x01(\t\x12\r\n\x05token\x18\x02 \x01(\t\x12\x0b\n\x03uid\x18\x03 \x01(\r\x12\x14\n\x0cpublisher_id\x18\x04 \x01(\t\"\xa4\x01\n\x13\x44rivenIngressConfig\x12\x11\n\tshape_npy\x18\x01 \x01(\x0c\x12\x11\n\tstyle_npy\x18\x02 \x01(\x0c\x12\x19\n\x11\x64riven_server_url\x18\x03 \x01(\t\x12/\n\x0emodel_settings\x18\x04 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x1b\n\x13\x65ncoder_start_frame\x18\x05 \x01(\x05\"\xe7\x02\n\x16\x43lientConfigureSession\x12\x13\n\x0bsample_rate\x18\x01 \x01(\x05\x12\x0f\n\x07\x62itrate\x18\x02 \x01(\x05\x12\x33\n\x0c\x61udio_format\x18\x03 \x01(\x0e\x32\x1d.driveningress.v2.AudioFormat\x12\x45\n\x15transport_compression\x18\x04 \x01(\x0e\x32&.driveningress.v2.TransportCompression\x12\x31\n\x0b\x65gress_type\x18\x05 \x01(\x0e\x32\x1c.driveningress.v2.EgressType\x12=\n\x0elivekit_egress\x18\x06 \x01(\x0b\x32%.driveningress.v2.LiveKitEgressConfig\x12\x39\n\x0c\x61gora_egress\x18\x07 \x01(\x0b\x32#.driveningress.v2.AgoraEgressConfig\"C\n\x14ServerConfirmSession\x12\x15\n\rconnection_id\x18\x01 \x01(\t\x12\x14\n\x0c\x63\x61pabilities\x18\x02 \x03(\t\">\n\x10\x43lientAudioInput\x12\x0e\n\x06req_id\x18\x01 \x01(\t\x12\x0b\n\x03\x65nd\x18\x02 \x01(\x08\x12\r\n\x05\x61udio\x18\x03 \x01(\x0c\"S\n\x0bServerError\x12\x15\n\rconnection_id\x18\x01 \x01(\t\x12\x0e\n\x06req_id\x18\x02 \x01(\t\x12\x0c\n\x04\x63ode\x18\x03 \x01(\x05\x12\x0f\n\x07message\x18\x04 \x01(\t\"\xa6\x01\n\x05\x46lame\x12\x17\n\x0btranslation\x18\x01 \x03(\x02\x42\x02\x10\x01\x12\x14\n\x08rotation\x18\x02 \x03(\x02\x42\x02\x10\x01\x12\x15\n\tneck_pose\x18\x03 \x03(\x02\x42\x02\x10\x01\x12\x14\n\x08jaw_pose\x18\x04 \x03(\x02\x42\x02\x10\x01\x12\x14\n\x08\x65ye_pose\x18\x05 \x03(\x02\x42\x02\x10\x01\x12\x13\n\x07\x65ye_lid\x18\x06 \x03(\x02\x42\x02\x10\x01\x12\x16\n\nexpression\x18\x07 \x03(\x02\x42\x02\x10\x01\"<\n\x0e\x46lameAnimation\x12*\n\tkeyframes\x18\x01 \x03(\x0b\x32\x17.driveningress.v2.Flame\"\x95\x01\n\x17ServerResponseAnimation\x12\x15\n\rconnection_id\x18\x01 \x01(\t\x12\x0e\n\x06req_id\x18\x02 \x01(\t\x12\x0b\n\x03\x65nd\x18\x03 \x01(\x08\x12\x33\n\tanimation\x18\x04 \x01(\x0b\x32 .driveningress.v2.FlameAnimation\x12\x11\n\tavatar_id\x18\x05 \x01(\t\"!\n\x0f\x43lientInterrupt\x12\x0e\n\x06req_id\x18\x01 \x01(\t\"\x1d\n\x0b\x43lientPause\x12\x0e\n\x06req_id\x18\x01 \x01(\t\"\x1e\n\x0c\x43lientResume\x12\x0e\n\x06req_id\x18\x01 \x01(\t\"\xf0\x01\n\x13ServerPlaybackState\x12\x15\n\rconnection_id\x18\x01 \x01(\t\x12\x0e\n\x06req_id\x18\x02 \x01(\t\x12:\n\x05state\x18\x03 \x01(\x0e\x32+.driveningress.v2.ServerPlaybackState.State\x12\x11\n\tplayed_ms\x18\x04 \x01(\x03\x12\x0e\n\x06reason\x18\x05 \x01(\t\"S\n\x05State\x12\x15\n\x11STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PLAYING\x10\x01\x12\n\n\x06PAUSED\x10\x02\x12\t\n\x05\x45NDED\x10\x03\x12\x0f\n\x0bINTERRUPTED\x10\x04\"\xd6\x05\n\x07Message\x12+\n\x04type\x18\x01 \x01(\x0e\x32\x1d.driveningress.v2.MessageType\x12L\n\x18\x63lient_configure_session\x18\x02 \x01(\x0b\x32(.driveningress.v2.ClientConfigureSessionH\x00\x12H\n\x16server_confirm_session\x18\x03 \x01(\x0b\x32&.driveningress.v2.ServerConfirmSessionH\x00\x12@\n\x12\x63lient_audio_input\x18\x04 \x01(\x0b\x32\".driveningress.v2.ClientAudioInputH\x00\x12\x35\n\x0cserver_error\x18\x05 \x01(\x0b\x32\x1d.driveningress.v2.ServerErrorH\x00\x12N\n\x19server_response_animation\x18\x06 \x01(\x0b\x32).driveningress.v2.ServerResponseAnimationH\x00\x12>\n\rdriven_config\x18\x07 \x01(\x0b\x32%.driveningress.v2.DrivenIngressConfigH\x00\x12=\n\x10\x63lient_interrupt\x18\x08 \x01(\x0b\x32!.driveningress.v2.ClientInterruptH\x00\x12\x35\n\x0c\x63lient_pause\x18\t \x01(\x0b\x32\x1d.driveningress.v2.ClientPauseH\x00\x12\x37\n\rclient_resume\x18\n \x01(\x0b\x32\x1e.driveningress.v2.ClientResumeH\x00\x12\x46\n\x15server_playback_state\x18\x0b \x01(\x0b\x32%.driveningress.v2.ServerPlaybackStateH\x00\x42\x06\n\x04\x64\x61ta*\xe9\x02\n\x0bMessageType\x12\x17\n\x13MESSAGE_UNSPECIFIED\x10\x00\x12$\n MESSAGE_CLIENT_CONFIGURE_SESSION\x10\x01\x12\"\n\x1eMESSAGE_SERVER_CONFIRM_SESSION\x10\x02\x12\x1e\n\x1aMESSAGE_CLIENT_AUDIO_INPUT\x10\x03\x12\x18\n\x14MESSAGE_SERVER_ERROR\x10\x04\x12%\n!MESSAGE_SERVER_RESPONSE_ANIMATION\x10\x05\x12 \n\x1cMESSAGE_CLIENT_DRIVEN_CONFIG\x10\x06\x12\x1c\n\x18MESSAGE_CLIENT_INTERRUPT\x10\x07\x12\x18\n\x14MESSAGE_CLIENT_PAUSE\x10\x08\x12\x19\n\x15MESSAGE_CLIENT_RESUME\x10\t\x12!\n\x1dMESSAGE_SERVER_PLAYBACK_STATE\x10\n*D\n\x0b\x41udioFormat\x12\x1a\n\x16\x41UDIO_FORMAT_PCM_S16LE\x10\x00\x12\x19\n\x15\x41UDIO_FORMAT_OGG_OPUS\x10\x01*6\n\x14TransportCompression\x12\x1e\n\x1aTRANSPORT_COMPRESSION_NONE\x10\x00*Y\n\nEgressType\x12\x1b\n\x17\x45GRESS_TYPE_UNSPECIFIED\x10\x00\x12\x17\n\x13\x45GRESS_TYPE_LIVEKIT\x10\x01\x12\x15\n\x11\x45GRESS_TYPE_AGORA\x10\x02*\xd1\x01\n\tCloseCode\x12\x1a\n\x16\x43LOSE_CODE_UNSPECIFIED\x10\x00\x12!\n\x1c\x43LOSE_CODE_CREDITS_EXHAUSTED\x10\xa1\x1f\x12\x1f\n\x1a\x43LOSE_CODE_SESSION_TIMEOUT\x10\xa2\x1f\x12!\n\x1c\x43LOSE_CODE_CONCURRENCY_LIMIT\x10\xa3\x1f\x12\x1b\n\x16\x43LOSE_CODE_AUTH_FAILED\x10\xaa\x1f\x12$\n\x1f\x43LOSE_CODE_UPSTREAM_UNAVAILABLE\x10\x97#BEZCgithub.com/SpatialReal-ai/backend-ng/api/generated/driveningress/v2b\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'driveningress.v2.driveningress_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'ZCgithub.com/SpatialReal-ai/backend-ng/api/generated/driveningress/v2'
+  _globals['_LIVEKITEGRESSCONFIG_EXTRAATTRIBUTESENTRY']._loaded_options = None
+  _globals['_LIVEKITEGRESSCONFIG_EXTRAATTRIBUTESENTRY']._serialized_options = b'8\001'
+  _globals['_FLAME'].fields_by_name['translation']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['translation']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['rotation']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['rotation']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['neck_pose']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['neck_pose']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['jaw_pose']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['jaw_pose']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['eye_pose']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['eye_pose']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['eye_lid']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['eye_lid']._serialized_options = b'\020\001'
+  _globals['_FLAME'].fields_by_name['expression']._loaded_options = None
+  _globals['_FLAME'].fields_by_name['expression']._serialized_options = b'\020\001'
+  _globals['_MESSAGETYPE']._serialized_start=2680
+  _globals['_MESSAGETYPE']._serialized_end=3041
+  _globals['_AUDIOFORMAT']._serialized_start=3043
+  _globals['_AUDIOFORMAT']._serialized_end=3111
+  _globals['_TRANSPORTCOMPRESSION']._serialized_start=3113
+  _globals['_TRANSPORTCOMPRESSION']._serialized_end=3167
+  _globals['_EGRESSTYPE']._serialized_start=3169
+  _globals['_EGRESSTYPE']._serialized_end=3258
+  _globals['_CLOSECODE']._serialized_start=3261
+  _globals['_CLOSECODE']._serialized_end=3470
+  _globals['_LIVEKITEGRESSCONFIG']._serialized_start=89
+  _globals['_LIVEKITEGRESSCONFIG']._serialized_end=384
+  _globals['_LIVEKITEGRESSCONFIG_EXTRAATTRIBUTESENTRY']._serialized_start=330
+  _globals['_LIVEKITEGRESSCONFIG_EXTRAATTRIBUTESENTRY']._serialized_end=384
+  _globals['_AGORAEGRESSCONFIG']._serialized_start=386
+  _globals['_AGORAEGRESSCONFIG']._serialized_end=477
+  _globals['_DRIVENINGRESSCONFIG']._serialized_start=480
+  _globals['_DRIVENINGRESSCONFIG']._serialized_end=644
+  _globals['_CLIENTCONFIGURESESSION']._serialized_start=647
+  _globals['_CLIENTCONFIGURESESSION']._serialized_end=1006
+  _globals['_SERVERCONFIRMSESSION']._serialized_start=1008
+  _globals['_SERVERCONFIRMSESSION']._serialized_end=1075
+  _globals['_CLIENTAUDIOINPUT']._serialized_start=1077
+  _globals['_CLIENTAUDIOINPUT']._serialized_end=1139
+  _globals['_SERVERERROR']._serialized_start=1141
+  _globals['_SERVERERROR']._serialized_end=1224
+  _globals['_FLAME']._serialized_start=1227
+  _globals['_FLAME']._serialized_end=1393
+  _globals['_FLAMEANIMATION']._serialized_start=1395
+  _globals['_FLAMEANIMATION']._serialized_end=1455
+  _globals['_SERVERRESPONSEANIMATION']._serialized_start=1458
+  _globals['_SERVERRESPONSEANIMATION']._serialized_end=1607
+  _globals['_CLIENTINTERRUPT']._serialized_start=1609
+  _globals['_CLIENTINTERRUPT']._serialized_end=1642
+  _globals['_CLIENTPAUSE']._serialized_start=1644
+  _globals['_CLIENTPAUSE']._serialized_end=1673
+  _globals['_CLIENTRESUME']._serialized_start=1675
+  _globals['_CLIENTRESUME']._serialized_end=1705
+  _globals['_SERVERPLAYBACKSTATE']._serialized_start=1708
+  _globals['_SERVERPLAYBACKSTATE']._serialized_end=1948
+  _globals['_SERVERPLAYBACKSTATE_STATE']._serialized_start=1865
+  _globals['_SERVERPLAYBACKSTATE_STATE']._serialized_end=1948
+  _globals['_MESSAGE']._serialized_start=1951
+  _globals['_MESSAGE']._serialized_end=2677
+# @@protoc_insertion_point(module_scope)