jaxl-python 0.0.43__tar.gz → 0.0.45__tar.gz

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.43
+Version: 0.0.45
 Summary: Official Python SDK and CLI for interfacing with the Jaxl API. Manage calls, messages, IVRs, devices, teams, payments, campaigns, streaming transcriptions and AI Agents. Built on OpenAPI, it offers both generated API clients and Pythonic wrappers for ease of use.
 Home-page: https://github.com/jaxl-innovations-private-limited/jaxl-python
 Download-URL: https://github.com/jaxl-innovations-private-limited/jaxl-python/archive/main.zip

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/examples/streaming_audio_chunks.py

@@ -7,9 +7,12 @@ Redistribution and use in source and binary forms,
 with or without modification, is strictly prohibited.
 """
 
+from typing import Optional
+
 from jaxl.api.base import (
     HANDLER_RESPONSE,
     BaseJaxlApp,
+    JaxlStreamMeta,
     JaxlStreamRequest,
     JaxlWebhookRequest,
     JaxlWebhookResponse,
@@ -29,6 +32,7 @@ class JaxlAppStreamingAudioChunk(BaseJaxlApp):
         self,
         req: JaxlStreamRequest,
         slin16: bytes,
+        meta: Optional[JaxlStreamMeta] = None,
     ) -> None:
         print(f"Received {len(slin16)} bytes of raw audio")
         return None

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/jaxl/api/base.py

@@ -25,7 +25,7 @@ from typing import (
 import requests
 from fastapi import WebSocket
 from fastapi.responses import Response as FastApiResponse
-from pydantic import BaseModel, model_validator
+from pydantic import BaseModel, ConfigDict, model_validator
 
 from jaxl.api.client.models.call_tag_response import CallTagResponse
 from jaxl.api.client.types import Response
@@ -92,6 +92,24 @@ class JaxlWebhookResponse(BaseModel):
     mark: Optional[str] = None
 
 
+class JaxlStreamMeta(BaseModel):
+    """Optional per-packet metadata sent alongside a media chunk.
+
+    Carries upstream signal-processing hints (e.g. speaker attribution).
+    All fields optional; consumers must tolerate its absence and ignore
+    unknown keys.
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    # "customer" | "other" | "unknown"
+    speaker: Optional[str] = None
+    # 0.0..1.0 confidence in the speaker label
+    speaker_confidence: Optional[float] = None
+    # whether the frame contains speech (vs silence)
+    is_speech: Optional[bool] = None
+
+
 class JaxlStreamRequest(BaseModel):
     # IVR ID
     pk: int
@@ -213,6 +231,7 @@ class BaseJaxlApp:
         self,
         req: JaxlStreamRequest,
         slin16: bytes,
+        meta: Optional[JaxlStreamMeta] = None,
     ) -> None:
         return None
 

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/jaxl/api/client/_scm_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.43'
-__version_tuple__ = version_tuple = (0, 0, 43)
+__version__ = version = '0.0.45'
+__version_tuple__ = version_tuple = (0, 0, 45)

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/jaxl/api/resources/apps.py

@@ -28,6 +28,7 @@ from starlette.websockets import WebSocketDisconnect
 from jaxl.api.base import (
     HANDLER_RESPONSE,
     BaseJaxlApp,
+    JaxlStreamMeta,
     JaxlStreamRequest,
     JaxlWebhookEvent,
     JaxlWebhookRequest,
@@ -251,13 +252,26 @@ def _start_server(
         await app.on_stream_connect(state["call_id"])
         try:
             while True:
-                data = json.loads(await ws.receive_text())
+                try:
+                    raw = await ws.receive_text()
+                except (WebSocketDisconnect, RuntimeError):
+                    # The socket is already gone: a clean client disconnect,
+                    # or a RuntimeError ("WebSocket is not connected") when the
+                    # call was torn down from another task and that close raced
+                    # this receive loop. Either way there is nothing more to
+                    # read — exit cleanly. (Scoped to the receive so a genuine
+                    # error in a handler below still surfaces.)
+                    break
+                data = json.loads(raw)
                 ev = data["event"]
                 if ev == "media":
                     req = JaxlStreamRequest(pk=ivr_id, state=state)
                     slin16 = base64.b64decode(data[ev]["payload"])
+                    # Optional per-packet metadata (e.g. speaker attribution)
+                    _meta = data[ev].get("meta")
+                    meta = JaxlStreamMeta(**_meta) if _meta else None
                     # Invoke audio chunk handlers
-                    await app.handle_audio_chunk(req, slin16)
+                    await app.handle_audio_chunk(req, slin16, meta=meta)
                     # Detect start/end of speech
                     change = sdetector.process(slin16)
                     # Manage speech segments
@@ -323,7 +337,13 @@ def _start_server(
                 if state["call_id"] in wss:
                     del wss[state["call_id"]]
                 if ws.client_state != WebSocketState.DISCONNECTED:
-                    await ws.close()
+                    try:
+                        await ws.close()
+                    except RuntimeError:
+                        # Already closing / closed (e.g. teardown closed it
+                        # from another task) — "Cannot call send once a close
+                        # message has been sent." Nothing to do.
+                        pass
             finally:
                 await app.on_stream_disconnect(state["call_id"])
 

{jaxl_python-0.0.43 → jaxl_python-0.0.45}/jaxl_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.43
+Version: 0.0.45
 Summary: Official Python SDK and CLI for interfacing with the Jaxl API. Manage calls, messages, IVRs, devices, teams, payments, campaigns, streaming transcriptions and AI Agents. Built on OpenAPI, it offers both generated API clients and Pythonic wrappers for ease of use.
 Home-page: https://github.com/jaxl-innovations-private-limited/jaxl-python
 Download-URL: https://github.com/jaxl-innovations-private-limited/jaxl-python/archive/main.zip