jaxl-python 0.0.44__tar.gz → 0.0.46__tar.gz

{jaxl_python-0.0.44 → jaxl_python-0.0.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.44
+Version: 0.0.46
 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.44 → jaxl_python-0.0.46}/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.44 → jaxl_python-0.0.46}/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
 
@@ -312,6 +331,14 @@ class BaseJaxlApp:
         """Clear any buffered audio."""
         return False
 
+    async def send_mark(self, call_id: int, mark: str) -> bool:
+        """Send a mark packet."""
+        return False
+
+    async def handle_stream_mark(self, call_id: int, mark: str) -> None:
+        """Invoked when upstream sends back mark response."""
+        return None
+
     async def hangup(self, call_id: int) -> Optional[Response[Any]]:
         """Hangup call by ID"""
         return None

{jaxl_python-0.0.44 → jaxl_python-0.0.46}/jaxl/api/client/_scm_version.py

@@ -17,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.0.44'
-__version_tuple__ = version_tuple = (0, 0, 44)
+__version__ = version = '0.0.46'
+__version_tuple__ = version_tuple = (0, 0, 46)

{jaxl_python-0.0.44 → jaxl_python-0.0.46}/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,
@@ -173,10 +174,29 @@ def _start_server(
             logger.warning(f"⚠️ send_audio failure: {exc}")
             return False
 
+    async def _send_mark(call_id: int, mark: str) -> bool:
+        try:
+            await wss[call_id].send_text(
+                json.dumps(
+                    {
+                        "event": "mark",
+                        "mark": {
+                            "name": mark,
+                        },
+                    }
+                )
+            )
+            return True
+        # pylint: disable=broad-exception-caught
+        except Exception as exc:
+            logger.warning(f"⚠️ send_mark failure: {exc}")
+            return False
+
     app.send_audio = _send_audio  # type: ignore[method-assign]
     app.clear_audio = _clear_audio  # type: ignore[method-assign]
     app.add_tag = _add_tag  # type: ignore[method-assign]
     app.hangup = _hangup  # type: ignore[method-assign]
+    app.send_mark = _send_mark  # type: ignore[method-assign]
 
     @server.api_route(
         "/webhook/",
@@ -266,8 +286,11 @@ def _start_server(
                 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
@@ -322,6 +345,11 @@ def _start_server(
                         int(data[ev]["call_id"]),
                         str(data[ev]["status"]),
                     )
+                elif ev == "mark":
+                    # Echo envelope is {"event": "mark", "mark": {"name": ...}}
+                    await app.handle_stream_mark(
+                        state["call_id"], str(data[ev]["name"])
+                    )
                 elif ev == "connected":
                     pass
                 else:

{jaxl_python-0.0.44 → jaxl_python-0.0.46}/jaxl/api/resources/campaigns.py

@@ -203,7 +203,16 @@ def _subparser(parser: argparse.ArgumentParser) -> None:
         "--ai-id",
         type=str,
         required=False,
-        choices=["custom", "cod", "ndr", "acart", "feedback"],
+        choices=[
+            "cod",
+            "acart",
+            "ndr",
+            "feedback",
+            "leadq",
+            "hiring",
+            "membership",
+            "custom",
+        ],
         help="AI Agent ID",
     )
     group.add_argument(

{jaxl_python-0.0.44 → jaxl_python-0.0.46}/jaxl_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaxl-python
-Version: 0.0.44
+Version: 0.0.46
 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