spatialreal 0.2.2__tar.gz → 0.2.3__tar.gz

{spatialreal-0.2.2 → spatialreal-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: spatialreal
-Version: 0.2.2
+Version: 0.2.3
 Summary: SpatialReal Python SDK — realtime avatar sessions (audio in, animation/egress out)
 Project-URL: Documentation, https://docs.spatialreal.ai
 Project-URL: Website, https://www.spatialreal.ai/
@@ -22,10 +22,10 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Requires-Python: >=3.10.0
 Requires-Dist: aiohttp>=3.9
 Requires-Dist: nanoid>=2.0
-Requires-Dist: protobuf<8,>=6.31
+Requires-Dist: protobuf<8,>=5.29
 Requires-Dist: websockets>=12
 Provides-Extra: dev
-Requires-Dist: grpcio-tools==1.75.1; extra == 'dev'
+Requires-Dist: grpcio-tools==1.71.2; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: ruff; extra == 'dev'
@@ -46,8 +46,8 @@ from spatialreal import LiveKitEgressConfig, new_avatar_session
 
 session = new_avatar_session(
     api_key="...",
-    app_id="...",
     avatar_id="...",
+    # app_id is optional: the app is derived from the API key server-side
     expire_at=datetime.now(timezone.utc) + timedelta(hours=1),
     sample_rate=16000,
     livekit_egress=LiveKitEgressConfig(url=..., api_token=..., room_name=..., publisher_id=...),
@@ -102,6 +102,8 @@ implements the server's WebSocket close-code contract (40xx: don't retry,
 
 ## What's new
 
+- 0.2.3: `app_id` is optional (the API key identifies the app); protobuf floor lowered
+  to 5.29 so the SDK installs next to packages that pin protobuf 5.x (TEN Framework agents).
 - `on_playback(PlaybackSignal)` — structured playback lifecycle; no protobuf
   parsing in caller code (`transport_frames(raw, is_last)` still exists).
 - `CloseCode` + `AvatarSDKError.retryable` — the reconnect contract as API.

{spatialreal-0.2.2 → spatialreal-0.2.3}/README.md

@@ -13,8 +13,8 @@ from spatialreal import LiveKitEgressConfig, new_avatar_session
 
 session = new_avatar_session(
     api_key="...",
-    app_id="...",
     avatar_id="...",
+    # app_id is optional: the app is derived from the API key server-side
     expire_at=datetime.now(timezone.utc) + timedelta(hours=1),
     sample_rate=16000,
     livekit_egress=LiveKitEgressConfig(url=..., api_token=..., room_name=..., publisher_id=...),
@@ -69,6 +69,8 @@ implements the server's WebSocket close-code contract (40xx: don't retry,
 
 ## What's new
 
+- 0.2.3: `app_id` is optional (the API key identifies the app); protobuf floor lowered
+  to 5.29 so the SDK installs next to packages that pin protobuf 5.x (TEN Framework agents).
 - `on_playback(PlaybackSignal)` — structured playback lifecycle; no protobuf
   parsing in caller code (`transport_frames(raw, is_last)` still exists).
 - `CloseCode` + `AvatarSDKError.retryable` — the reconnect contract as API.

{spatialreal-0.2.2 → spatialreal-0.2.3}/pyproject.toml

@@ -26,12 +26,12 @@ classifiers = [
 dependencies = [
     "aiohttp>=3.9",
     "websockets>=12",
-    "protobuf>=6.31,<8",
+    "protobuf>=5.29,<8",
     "nanoid>=2.0",
 ]
 
 [project.optional-dependencies]
-dev = ["pytest", "pytest-asyncio", "grpcio-tools==1.75.1", "ruff"]
+dev = ["pytest", "pytest-asyncio", "grpcio-tools==1.71.2", "ruff"]
 
 [project.urls]
 Documentation = "https://docs.spatialreal.ai"

{spatialreal-0.2.2 → spatialreal-0.2.3}/spatialreal/proto/generated/message_pb2.py

@@ -2,7 +2,7 @@
 # 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
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -11,9 +11,9 @@ 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,
+    5,
+    29,
+    0,
     '',
     'driveningress/v2/driveningress.proto'
 )

{spatialreal-0.2.2 → spatialreal-0.2.3}/spatialreal/proto/generated/message_pb2.pyi

@@ -2,8 +2,7 @@ from google.protobuf.internal import containers as _containers
 from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import message as _message
-from collections.abc import Iterable as _Iterable, Mapping as _Mapping
-from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+from typing import ClassVar as _ClassVar, Iterable as _Iterable, Mapping as _Mapping, Optional as _Optional, Union as _Union
 
 DESCRIPTOR: _descriptor.FileDescriptor
 

{spatialreal-0.2.2 → spatialreal-0.2.3}/spatialreal/session.py

@@ -155,8 +155,6 @@ class AvatarSession:
             raise ValueError("Session not initialized (call init() first)")
         if not self._config.avatar_id:
             raise ValueError("Missing avatar ID")
-        if not self._config.app_id:
-            raise ValueError("Missing app ID")
         if self._config.livekit_egress is not None and self._config.agora_egress is not None:
             raise ValueError("Cannot configure both livekit_egress and agora_egress")
 
@@ -192,12 +190,17 @@ class AvatarSession:
 
         query = parse_qs(parsed.query)
         query["id"] = [self._config.avatar_id]
+        # The app is derived server-side from the API key; ``app_id`` is optional and only
+        # forwarded when set (the server ignores an absent X-App-ID / appId).
         headers: dict[str, str] = {}
         if self._config.use_query_auth:
-            query["appId"] = [self._config.app_id]
+            if self._config.app_id:
+                query["appId"] = [self._config.app_id]
             query["sessionKey"] = [self._session_token or ""]
         else:
-            headers = {"X-App-ID": self._config.app_id, "X-Session-Key": self._session_token or ""}
+            headers = {"X-Session-Key": self._session_token or ""}
+            if self._config.app_id:
+                headers["X-App-ID"] = self._config.app_id
 
         return (
             urlunparse((ws_scheme, parsed.netloc, parsed.path, parsed.params, urlencode(query, doseq=True), "")),

spatialreal-0.2.3/spatialreal/version.py

@@ -0,0 +1 @@
+__version__ = "0.2.3"

spatialreal-0.2.2/spatialreal/version.py

@@ -1 +0,0 @@
-__version__ = "0.2.2"