signalwire-sdk 3.7.1.dev129__tar.gz → 3.7.1.dev131__tar.gz

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/CHANGELOG.md

@@ -8,8 +8,9 @@
   wraps the platform's reserved `startup_hook` function. A handler receives
   the SWAIG request and may return a `FunctionResult`: its actions run at
   once, and its response text is added to the conversation as a system
-  message the model reads before it speaks. Handlers run in registration
-  order, and an exception is logged, not raised.
+  message the model reads before it speaks, except on an OpenAI Realtime
+  agent, which drops the text. Handlers run in registration order, and an
+  exception is logged, not raised.
 
 ### Documentation
 - How to reject a call from the per-call configuration callback
@@ -24,6 +25,14 @@
   nothing meanwhile, so tools should answer quickly and send late results into the call with
   `rest.calling.ai_message()`. See "Slow tools and the webhook timeout" in
   `docs/agent_guide.md`.
+### Fixed
+- The SDK loads on WebAssembly (Pyodide, as on Cloudflare Workers).
+  jsonschema-rs has no WebAssembly build, and `schema_utils` imported it
+  unconditionally. The dependency now skips WebAssembly
+  (`sys_platform != 'emscripten'`), and SWML validation falls back to
+  `jsonschema` when it's installed, or to checking verb names and required
+  fields when it isn't.
+
 ## [3.7.1] - 2026-10-13
 
 ### Added

{signalwire_sdk-3.7.1.dev129/signalwire/signalwire_sdk.egg-info → signalwire_sdk-3.7.1.dev131}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.7.1.dev129
+Version: 3.7.1.dev131
 Summary: SignalWire SDK for AI voice agents, live call control (RELAY) and REST. Run sw-pydocs for its documentation.
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -27,7 +27,7 @@ Requires-Dist: uvicorn>=0.34.2
 Requires-Dist: beautifulsoup4>=4.12.3
 Requires-Dist: pytz>=2023.3
 Requires-Dist: lxml>=4.9.0
-Requires-Dist: jsonschema-rs>=0.20.0
+Requires-Dist: jsonschema-rs>=0.20.0; sys_platform != "emscripten"
 Requires-Dist: websockets>=12.0
 Provides-Extra: search-queryonly
 Requires-Dist: numpy>=1.24.0; extra == "search-queryonly"

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/docs/agent_guide.md

@@ -2156,7 +2156,7 @@ def save_call(call_log, raw_data):
 An `on_call_start` handler receives the SWAIG request (`call_id`, `global_data`, `caller_id_num` and the rest) and may return a `FunctionResult` or `None`. The platform runs the hook once, after the call is answered and before the AI's first turn, and uses its reply:
 
 - The actions run at once, such as `update_global_data()` to give the call data before the conversation starts. Several handlers' actions run in registration order. `post_process` isn't used.
-- The response text is added to the conversation as a system message, so the model reads it before it speaks. Several handlers' texts are joined, one per line. Only a plain string response is used.
+- The response text is added to the conversation as a system message, so the model reads it before it speaks. Several handlers' texts are joined, one per line. Only a plain string response is used. An OpenAI Realtime agent runs the actions but drops the text, so put what its first greeting needs in the prompt from a per-call configuration callback instead.
 
 The platform waits for the hook before the AI starts, so a slow handler delays the greeting; keep it short (see [Slow tools and the webhook timeout](#slow-tools-and-the-webhook-timeout)).
 
@@ -2283,7 +2283,7 @@ def hangup_hook(self, args, raw_data):
 2. **Error Handling**: Always implement proper error handling in hooks - failures shouldn't crash the voice session
 3. **Timing**: `startup_hook` is called before the AI starts speaking to the caller
 4. **Session Data**: Any data you need to persist across the session should be stored in external storage (Redis, database, etc.)
-5. **Return Values**: Both hooks must return a `FunctionResult` object. The `startup_hook`'s actions run and its response text is added to the conversation as a system message; the `hangup_hook`'s response is unused, since the call is over
+5. **Return Values**: Both hooks must return a `FunctionResult` object. The `startup_hook`'s actions run and its response text is added to the conversation as a system message (except on an OpenAI Realtime agent, which drops the text); the `hangup_hook`'s response is unused, since the call is over
 
 ### SIP Routing
 

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/docs/api_reference.md

@@ -1389,7 +1389,7 @@ def on_call_start(
 
 The handler receives `raw_data`, the SWAIG request (`call_id`, `global_data`, `caller_id_num` and the rest), and may return a `FunctionResult` or `None`:
 - Its actions run at once, in registration order across handlers. `post_process` isn't used.
-- Its response text is added to the conversation as a system message the model reads before it speaks. Several handlers' texts are joined, one per line. Only a plain string response is used.
+- Its response text is added to the conversation as a system message the model reads before it speaks. Several handlers' texts are joined, one per line. Only a plain string response is used. An OpenAI Realtime agent runs the actions but drops the text, so put what its first greeting needs in the prompt from a per-call configuration callback instead.
 
 An exception is logged, not raised, and that handler's result is dropped. The platform waits for the hook before the AI starts, so keep the handler short.
 

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire-sdk"
-version = "3.7.1.dev129"
+version = "3.7.1.dev131"
 description = "SignalWire SDK for AI voice agents, live call control (RELAY) and REST. Run sw-pydocs for its documentation."
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -34,7 +34,9 @@ dependencies = [
     "beautifulsoup4>=4.12.3",
     "pytz>=2023.3",
     "lxml>=4.9.0",
-    "jsonschema-rs>=0.20.0",
+    # No WebAssembly build (Pyodide, as on Cloudflare Workers): there the SDK
+    # validates with jsonschema if it's installed, or checks verb names only
+    "jsonschema-rs>=0.20.0; sys_platform != 'emscripten'",
     "websockets>=12.0",
 ]
 

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/signalwire/signalwire/__init__.py

@@ -59,7 +59,7 @@ if TYPE_CHECKING:
     from signalwire.utils.schema_utils import SchemaValidationError
     from signalwire.web import WebService
 
-__version__ = "3.7.1.dev129"
+__version__ = "3.7.1.dev131"
 
 # §6.2-python (owner decision: NO packaging split — one package, all deps required;
 # IMPORT-TIME behavior only): the agent/web symbols are lazy-imported via module

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/signalwire/signalwire/agent_server.py

@@ -68,7 +68,7 @@ class AgentServer:
         self.app = FastAPI(
             title="SignalWire AI Agents",
             description="Hosted SignalWire AI Agents",
-            version="3.7.1.dev129",
+            version="3.7.1.dev131",
             redirect_slashes=False,
             docs_url=None,
             redoc_url=None,

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/signalwire/signalwire/core/agent_base.py

@@ -781,10 +781,13 @@ class AgentBase(  # type: ignore[misc]  # intentional diamond: WebMixin's serve/
           the conversation starts);
         - its response text is added to the conversation as a system message
           the model reads before its first turn. The texts of several handlers
-          are joined, one per line. Only a plain string response is used.
+          are joined, one per line. Only a plain string response is used. An
+          OpenAI Realtime agent runs the actions but drops the text, so put
+          what its first greeting needs in the prompt from a per-call
+          configuration callback instead.
         `post_process` is not used: the combined result runs its actions at
-        once. The platform adds every hook reply to the conversation, so a
-        hook whose handlers return no text still adds a short placeholder
+        once. The text pipeline adds every hook reply to the conversation, so
+        a hook whose handlers return no text still adds a short placeholder
         line, as any function with an empty reply does.
 
         Exceptions are caught and logged rather than raised, and that

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/signalwire/signalwire/utils/schema_utils.py

@@ -15,12 +15,36 @@ Uses jsonschema-rs for full JSON Schema validation with type checking.
 import os
 import json
 from pathlib import Path
-from typing import Any, cast
-
-import jsonschema_rs
+from typing import TYPE_CHECKING, Any, cast
 
 from signalwire.core.logging_config import get_logger
 
+# The validator: jsonschema-rs where it's installed, as on every platform but
+# WebAssembly (Pyodide, as on Cloudflare Workers), which it has no build for;
+# otherwise jsonschema, if installed; otherwise only the lightweight checks.
+if TYPE_CHECKING:
+    import jsonschema
+    import jsonschema_rs
+else:
+    try:
+        import jsonschema_rs
+    except ImportError:  # pragma: no cover - exercised by the fallback tests
+        jsonschema_rs = None
+    try:
+        import jsonschema
+    except ImportError:  # pragma: no cover - exercised by the fallback tests
+        jsonschema = None
+
+# The errors validate() raises, from whichever libraries are installed
+_VALIDATION_ERRORS: tuple[type[Exception], ...] = tuple(
+    error
+    for error in (
+        getattr(jsonschema_rs, "ValidationError", None),
+        getattr(jsonschema, "ValidationError", None),
+    )
+    if isinstance(error, type)
+)
+
 
 class SchemaValidationError(Exception):
     """Raised when SWML schema validation fails."""
@@ -78,18 +102,35 @@ class SchemaUtils:
             self.log.debug("first_verbs_extracted", verbs=list(self.verbs.keys())[:5])
 
         # Initialize full schema validator if validation is enabled
-        self._full_validator: jsonschema_rs.Draft202012Validator | None = None
+        self._full_validator: Any = None
         if self._validation_enabled and self.schema:
             self._init_full_validator()
         elif not self._validation_enabled:
             self.log.warning("schema_validation_disabled")
 
     def _init_full_validator(self) -> None:
-        """Initialize the jsonschema-rs validator for full schema validation."""
-        self._full_validator = jsonschema_rs.Draft202012Validator(self.schema)
+        """Initialize the validator for full schema validation.
+
+        jsonschema-rs when it's installed, else jsonschema. With neither, as
+        on WebAssembly without jsonschema, validation falls back to the
+        lightweight checks: verb names and required fields.
+        """
+        if jsonschema_rs is not None:
+            self._full_validator = jsonschema_rs.Draft202012Validator(self.schema)
+            validator = "jsonschema-rs"
+        elif jsonschema is not None:
+            self._full_validator = jsonschema.Draft202012Validator(self.schema)
+            validator = "jsonschema"
+        else:
+            self.log.warning(
+                "schema_validator_unavailable",
+                hint="install jsonschema-rs or jsonschema for full SWML validation; "
+                "only verb names and required fields are checked",
+            )
+            return
         self.log.info(
             "schema_validator_initialized",
-            validator="jsonschema-rs",
+            validator=validator,
             verbs=len(self.verbs),
         )
 
@@ -341,7 +382,7 @@ class SchemaUtils:
         self, verb_name: str, verb_config: dict[str, Any]
     ) -> tuple[bool, list[str]]:
         """
-        Perform full JSON Schema validation using jsonschema-rs.
+        Perform full JSON Schema validation with jsonschema-rs or jsonschema.
 
         Wraps the verb in a minimal SWML document structure for validation
         since the schema requires the full document context.
@@ -372,7 +413,7 @@ class SchemaUtils:
         try:
             self._full_validator.validate(minimal_doc)
             return True, []
-        except jsonschema_rs.ValidationError as e:
+        except _VALIDATION_ERRORS as e:
             error_msg = str(e)
             if len(error_msg) > 500:
                 error_msg = error_msg[:500] + "..."
@@ -384,7 +425,8 @@ class SchemaUtils:
         """
         Perform lightweight validation (verb existence + required fields only).
 
-        This is the fallback when jsonschema-rs is not available.
+        This is the fallback when neither jsonschema-rs nor jsonschema is
+        installed.
 
         Args:
             verb_name: The name of the verb
@@ -481,7 +523,7 @@ class SchemaUtils:
         try:
             self._full_validator.validate(document)
             return True, []
-        except jsonschema_rs.ValidationError as e:
+        except _VALIDATION_ERRORS as e:
             error_msg = str(e)
             if len(error_msg) > 500:
                 error_msg = error_msg[:500] + "..."

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131/signalwire/signalwire_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.7.1.dev129
+Version: 3.7.1.dev131
 Summary: SignalWire SDK for AI voice agents, live call control (RELAY) and REST. Run sw-pydocs for its documentation.
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -27,7 +27,7 @@ Requires-Dist: uvicorn>=0.34.2
 Requires-Dist: beautifulsoup4>=4.12.3
 Requires-Dist: pytz>=2023.3
 Requires-Dist: lxml>=4.9.0
-Requires-Dist: jsonschema-rs>=0.20.0
+Requires-Dist: jsonschema-rs>=0.20.0; sys_platform != "emscripten"
 Requires-Dist: websockets>=12.0
 Provides-Extra: search-queryonly
 Requires-Dist: numpy>=1.24.0; extra == "search-queryonly"

{signalwire_sdk-3.7.1.dev129 → signalwire_sdk-3.7.1.dev131}/signalwire/signalwire_sdk.egg-info/requires.txt

@@ -8,9 +8,11 @@ uvicorn>=0.34.2
 beautifulsoup4>=4.12.3
 pytz>=2023.3
 lxml>=4.9.0
-jsonschema-rs>=0.20.0
 websockets>=12.0
 
+[:sys_platform != "emscripten"]
+jsonschema-rs>=0.20.0
+
 [all]
 sentence-transformers>=2.2.0
 scikit-learn>=1.3.0