signalwire-sdk 3.2.0.dev95__tar.gz → 3.2.0.dev97__tar.gz

{signalwire_sdk-3.2.0.dev95/signalwire/signalwire_sdk.egg-info → signalwire_sdk-3.2.0.dev97}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.2.0.dev95
+Version: 3.2.0.dev97
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -142,6 +142,7 @@ Each agent is a self-contained microservice that generates [SWML](docs/swml_serv
 from signalwire import AgentBase
 from signalwire.core.function_result import FunctionResult
 
+
 class MyAgent(AgentBase):
     def __init__(self):
         super().__init__(name="my-agent", route="/agent")
@@ -153,8 +154,10 @@ class MyAgent(AgentBase):
     def get_time(self):
         """Get the current time"""
         from datetime import datetime
+
         return FunctionResult(f"The time is {datetime.now().strftime('%H:%M:%S')}")
 
+
 if __name__ == "__main__":
     agent = MyAgent()
     agent.run()
@@ -213,7 +216,10 @@ Real-time call control and messaging over WebSocket. The RELAY client connects t
 ```python
 from signalwire.relay import RelayClient
 
-client = RelayClient(project="...", token="...", host="example.signalwire.com", contexts=["default"])
+client = RelayClient(
+    project="...", token="...", host="example.signalwire.com", contexts=["default"]
+)
+
 
 @client.on_call
 async def handle(call):
@@ -222,6 +228,7 @@ async def handle(call):
     await action.wait()
     await call.hangup()
 
+
 client.run()
 ```
 

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/README.md

@@ -45,6 +45,7 @@ Each agent is a self-contained microservice that generates [SWML](docs/swml_serv
 from signalwire import AgentBase
 from signalwire.core.function_result import FunctionResult
 
+
 class MyAgent(AgentBase):
     def __init__(self):
         super().__init__(name="my-agent", route="/agent")
@@ -56,8 +57,10 @@ class MyAgent(AgentBase):
     def get_time(self):
         """Get the current time"""
         from datetime import datetime
+
         return FunctionResult(f"The time is {datetime.now().strftime('%H:%M:%S')}")
 
+
 if __name__ == "__main__":
     agent = MyAgent()
     agent.run()
@@ -116,7 +119,10 @@ Real-time call control and messaging over WebSocket. The RELAY client connects t
 ```python
 from signalwire.relay import RelayClient
 
-client = RelayClient(project="...", token="...", host="example.signalwire.com", contexts=["default"])
+client = RelayClient(
+    project="...", token="...", host="example.signalwire.com", contexts=["default"]
+)
+
 
 @client.on_call
 async def handle(call):
@@ -125,6 +131,7 @@ async def handle(call):
     await action.wait()
     await call.hangup()
 
+
 client.run()
 ```
 

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire-sdk"
-version = "3.2.0.dev95"
+version = "3.2.0.dev97"
 description = "SignalWire SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -201,6 +201,19 @@ select = ["E4", "E7", "E9", "F", "B", "S", "C4", "PERF", "SIM", "PTH", "RET", "R
 # subscript is a runtime NameError under TYPE_CHECKING). Exempt F401 here; mypy +
 # the SIGNATURES/DRIFT gate prove these imports are real and correct.
 "signalwire/signalwire/rest/namespaces/*.py" = ["F401"]
+# Runnable docs — examples/, rest/examples/, relay/examples/. These are teaching
+# programs, not shipped SDK surface, so a few production-lint rules are demo-idiomatic
+# noise here (and are the ONLY findings that survive after autofix):
+#   E402 — a leading module docstring / "set your creds here" preamble before imports
+#          is the natural example shape (imports-not-at-top).
+#   S104 — binding 0.0.0.0 is how a demo server example says "listen on all interfaces".
+#   S106 — literal "password"/"token" kwargs are obvious placeholder creds in a snippet.
+#   S311 — non-crypto random (sample data / demo ids), never used for security here.
+# Everything else (F401 unused imports, F541 empty f-strings, C4/B/RET/SIM/…) is a real
+# smell and stays enforced so `examples/**` is gate-cleanable to zero.
+"examples/**" = ["E402", "S104", "S106", "S311"]
+"rest/examples/**" = ["E402", "S104", "S106", "S311"]
+"relay/examples/**" = ["E402", "S104", "S106", "S311"]
 
 [tool.ruff.lint.flake8-bugbear]
 # FastAPI's dependency-injection idiom puts Depends()/Query()/etc. in argument

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire/__init__.py

@@ -52,7 +52,7 @@ if TYPE_CHECKING:
     from signalwire.utils.schema_utils import SchemaValidationError
     from signalwire.web import WebService
 
-__version__ = "3.2.0.dev95"
+__version__ = "3.2.0.dev97"
 
 # §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.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/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.2.0.dev95",
+            version="3.2.0.dev97",
             redirect_slashes=False,
             docs_url=None,
             redoc_url=None,

signalwire_sdk-3.2.0.dev97/signalwire/signalwire/agents/__init__.py

@@ -0,0 +1,16 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+
+Specialized agent implementations backed by specific inference providers.
+"""
+
+from signalwire.agents.bedrock import BedrockAgent
+
+__all__ = [
+    "BedrockAgent",
+]

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire/core/contexts.py

@@ -1493,6 +1493,38 @@ class ContextBuilder:
                         f"avoid the collision."
                     )
 
+            # Validate step set_functions([...]) whitelists against the known
+            # tool universe. A step that whitelists a function which is neither
+            # a registered SWAIG tool nor a reserved native tool is a DANGLING
+            # reference: it renders a step whose active-function set silently
+            # points at nothing (r5 F3 — get_datetime vs get_current_time).
+            # Only enforce when a real registry is present; a contexts builder
+            # with no agent (or a mock registry) cannot know the tool universe,
+            # so we must not red a valid document there.
+            if isinstance(registered, dict):
+                known_functions = set(registered.keys()) | RESERVED_NATIVE_TOOL_NAMES
+                for context_name, context in self._contexts.items():
+                    for step_name, step in context._steps.items():
+                        funcs = step._functions
+                        # "none" and [] are explicit disable-all — not lists of
+                        # references to resolve.
+                        if not isinstance(funcs, list):
+                            continue
+                        for fn in funcs:
+                            if fn not in known_functions:
+                                available = sorted(known_functions)
+                                raise ValueError(
+                                    f"Step '{step_name}' in context "
+                                    f"'{context_name}' whitelists function "
+                                    f"'{fn}' via set_functions(), but no such "
+                                    f"SWAIG tool is registered on the agent and "
+                                    f"it is not a reserved native tool. This "
+                                    f"would emit a dangling function reference. "
+                                    f"Register the tool (define_tool / a skill) "
+                                    f"or remove it from the step. Available: "
+                                    f"{available}"
+                                )
+
     def to_dict(self) -> dict[str, Any]:
         """Convert all contexts to dictionary for SWML generation"""
         self.validate()

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire/core/swml_renderer.py

@@ -168,9 +168,13 @@ class SwmlRenderer:
         # Use the service to build the document
         service.reset_document()
 
-        # Add a play block for the response if provided
+        # Add a play block for the response if provided. Text is played via the
+        # `say:` URL scheme — the SWML `play` verb has no `text` key (its config is
+        # PlayWithURL/PlayWithURLS, url matching `^...|say: ?.*|...$`). Emitting
+        # `{"text": ...}` produced a document the SWML schema rejects; the canonical
+        # form (mirrors SWMLBuilder.play) is `url: "say:<text>"`.
         if response_text:
-            service.add_verb("play", {"text": response_text})
+            service.add_verb("play", {"url": f"say:{response_text}"})
 
         # Add any actions that were provided
         if actions:

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire/core/swml_service.py

@@ -534,6 +534,22 @@ class SWMLService(ToolMixin):
             handler = self.verb_registry.get_handler(verb_name)
             assert handler is not None  # noqa: S101  # type-narrowing invariant (not input validation): guaranteed by has_handler() above
             is_valid, errors = handler.validate_config(config)
+            # A handler's validate_config carries verb-specific diagnostics
+            # (e.g. the ai verb's prompt/SWAIG shape checks) but does NOT reject
+            # unknown/misspelled TOP-LEVEL keys — so a typo'd key would slip
+            # through silently (r5 silent-drop family: ai temperatur/zzz). Add a
+            # shallow unknown-top-level-key check against the schema so a handler
+            # verb rejects stray keys like every other verb. We deliberately do
+            # NOT run the full deep schema here: the ai verb's DEEP shapes
+            # (an empty prompt.pom for a promptless agent, the SWAIG function
+            # shape) are the handler's remit and are legitimately emitted by the
+            # SDK in forms the JSON-schema's oneOf/pom rules don't all accept —
+            # full validation would false-reject valid documents. The shallow
+            # check is a no-op when validation is disabled.
+            if is_valid:
+                is_valid, errors = self.schema_utils._validate_verb_top_level_keys(
+                    verb_name, config
+                )
         else:
             # Use schema-based validation for standard verbs
             is_valid, errors = self.schema_utils.validate_verb(verb_name, config)
@@ -603,6 +619,14 @@ class SWMLService(ToolMixin):
             handler = self.verb_registry.get_handler(verb_name)
             assert handler is not None  # noqa: S101  # type-narrowing invariant (not input validation): guaranteed by has_handler() above
             is_valid, errors = handler.validate_config(config)
+            # See add_verb: also run the shallow unknown-top-level-key check so a
+            # handler verb rejects misspelled/unknown top-level keys (NOT the full
+            # deep schema, which would false-reject the ai verb's legitimate
+            # empty-pom / SWAIG emissions). No-op when validation is disabled.
+            if is_valid:
+                is_valid, errors = self.schema_utils._validate_verb_top_level_keys(
+                    verb_name, config
+                )
         else:
             # Use schema-based validation for standard verbs
             is_valid, errors = self.schema_utils.validate_verb(verb_name, config)

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire/utils/schema_utils.py

@@ -407,6 +407,64 @@ class SchemaUtils:
 
         return len(errors) == 0, errors
 
+    def _verb_top_level_property_names(self, verb_name: str) -> set[str] | None:
+        """Resolve the set of KNOWN top-level property names for a verb's config
+        object, following a single ``$ref`` (e.g. AI -> AIObject). Returns None
+        when the verb's config schema is not a closed object-with-properties
+        (i.e. we cannot enumerate a known-key set, so no shallow check applies)."""
+        if verb_name not in self.verbs:
+            return None
+        verb_def = self.verbs[verb_name]["definition"]
+        props = verb_def.get("properties", {})
+        body = props.get(verb_name)
+        if not isinstance(body, dict):
+            return None
+        # Follow a single $ref (AI -> AIObject) to the object that declares the
+        # verb config's own properties.
+        if "$ref" in body:
+            ref_name = body["$ref"].split("/")[-1]
+            body = self.schema.get("$defs", {}).get(ref_name, {})
+        if not isinstance(body, dict) or body.get("type") != "object":
+            return None
+        prop_map = body.get("properties")
+        if not isinstance(prop_map, dict):
+            return None
+        # Only meaningful as a closed-key check when the schema itself closes the
+        # object (additionalProperties:false or unevaluatedProperties disallowed).
+        closes = (
+            body.get("additionalProperties") is False
+            or body.get("unevaluatedProperties") is False
+            or body.get("unevaluatedProperties") == {"not": {}}
+        )
+        if not closes:
+            return None
+        return set(prop_map.keys())
+
+    def _validate_verb_top_level_keys(
+        self, verb_name: str, verb_config: dict[str, Any]
+    ) -> tuple[bool, list[str]]:
+        """Shallow strict-render check: reject unknown/misspelled TOP-LEVEL keys
+        in a verb config against the schema's known property set, WITHOUT running
+        the full deep schema (which would false-reject legitimate deep emissions
+        such as the ai verb's empty prompt.pom). Used for handler verbs (the ai
+        verb) whose deep shapes the handler owns. A no-op when validation is
+        disabled or when the verb has no enumerable closed key-set."""
+        if not self._validation_enabled:
+            return True, []
+        if verb_name not in self.verbs:
+            return False, [f"Unknown verb: {verb_name}"]
+        known = self._verb_top_level_property_names(verb_name)
+        if known is None:
+            # No enumerable closed key-set — nothing shallow to enforce.
+            return True, []
+        unknown = [k for k in verb_config if k not in known]
+        if unknown:
+            return False, [
+                f"Unknown/misspelled key(s) {sorted(unknown)} for verb "
+                f"'{verb_name}'. Known keys: {sorted(known)}"
+            ]
+        return True, []
+
     def validate_document(self, document: dict[str, Any]) -> tuple[bool, list[str]]:
         """
         Validate a complete SWML document against the schema.

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97/signalwire/signalwire_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.2.0.dev95
+Version: 3.2.0.dev97
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -142,6 +142,7 @@ Each agent is a self-contained microservice that generates [SWML](docs/swml_serv
 from signalwire import AgentBase
 from signalwire.core.function_result import FunctionResult
 
+
 class MyAgent(AgentBase):
     def __init__(self):
         super().__init__(name="my-agent", route="/agent")
@@ -153,8 +154,10 @@ class MyAgent(AgentBase):
     def get_time(self):
         """Get the current time"""
         from datetime import datetime
+
         return FunctionResult(f"The time is {datetime.now().strftime('%H:%M:%S')}")
 
+
 if __name__ == "__main__":
     agent = MyAgent()
     agent.run()
@@ -213,7 +216,10 @@ Real-time call control and messaging over WebSocket. The RELAY client connects t
 ```python
 from signalwire.relay import RelayClient
 
-client = RelayClient(project="...", token="...", host="example.signalwire.com", contexts=["default"])
+client = RelayClient(
+    project="...", token="...", host="example.signalwire.com", contexts=["default"]
+)
+
 
 @client.on_call
 async def handle(call):
@@ -222,6 +228,7 @@ async def handle(call):
     await action.wait()
     await call.hangup()
 
+
 client.run()
 ```
 

{signalwire_sdk-3.2.0.dev95 → signalwire_sdk-3.2.0.dev97}/signalwire/signalwire_sdk.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ signalwire/signalwire/__init__.py
 signalwire/signalwire/agent_server.py
 signalwire/signalwire/py.typed
 signalwire/signalwire/schema.json
+signalwire/signalwire/agents/__init__.py
 signalwire/signalwire/agents/bedrock.py
 signalwire/signalwire/cli/__init__.py
 signalwire/signalwire/cli/build_search.py