signalwire-agents 1.0.18.dev7__tar.gz → 1.0.18.dev9__tar.gz

{signalwire_agents-1.0.18.dev7/signalwire_agents.egg-info → signalwire_agents-1.0.18.dev9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 1.0.18.dev7
+Version: 1.0.18.dev9
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -29,6 +29,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>=4.26.0
 Provides-Extra: search-queryonly
 Requires-Dist: numpy>=1.24.0; extra == "search-queryonly"
 Requires-Dist: scikit-learn>=1.3.0; extra == "search-queryonly"

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire_agents"
-version = "1.0.18.dev7"
+version = "1.0.18.dev9"
 description = "SignalWire AI Agents SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -36,6 +36,7 @@ dependencies = [
     "beautifulsoup4>=4.12.3",
     "pytz>=2023.3",
     "lxml>=4.9.0",
+    "jsonschema>=4.26.0",
 ]
 
 # Optional dependencies for search functionality

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/signalwire_agents/__init__.py

@@ -18,7 +18,7 @@ A package for building AI agents using SignalWire's AI and SWML capabilities.
 from .core.logging_config import configure_logging
 configure_logging()
 
-__version__ = "1.0.18.dev7"
+__version__ = "1.0.18.dev9"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/signalwire_agents/agent_server.py

@@ -61,7 +61,7 @@ class AgentServer:
         self.app = FastAPI(
             title="SignalWire AI Agents",
             description="Hosted SignalWire AI Agents",
-            version="1.0.18.dev7",
+            version="1.0.18.dev9",
             redirect_slashes=False
         )
         

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/signalwire_agents/core/function_result.py

@@ -1170,10 +1170,164 @@ class SwaigFunctionResult:
                 ]
             }
         }
-        
+
         # Use execute_swml to add the action
         return self.execute_swml(swml_doc)
 
+    def execute_rpc(self, method: str, params: Optional[Dict[str, Any]] = None,
+                    call_id: Optional[str] = None, node_id: Optional[str] = None) -> 'SwaigFunctionResult':
+        """
+        Execute an RPC method on a call using SWML.
+
+        This is a generic helper for executing RPC commands. For common operations,
+        consider using the specific helpers: rpc_dial(), rpc_ai_message(), rpc_ai_unhold().
+
+        Args:
+            method: The RPC method to execute (e.g., "dial", "ai_message", "ai_unhold")
+            params: Parameters for the RPC method (optional)
+            call_id: Target call ID for the RPC (optional)
+            node_id: Target node ID for the RPC (optional)
+
+        Returns:
+            self for method chaining
+
+        Example:
+            result = (
+                SwaigFunctionResult("Executing RPC")
+                .execute_rpc(
+                    method="ai_message",
+                    call_id="some-call-id",
+                    params={"role": "system", "message_text": "Hello"}
+                )
+            )
+        """
+        # Build the execute_rpc parameters
+        rpc_params: Dict[str, Any] = {"method": method}
+
+        if call_id:
+            rpc_params["call_id"] = call_id
+        if node_id:
+            rpc_params["node_id"] = node_id
+        if params:
+            rpc_params["params"] = params
+
+        # Generate SWML document
+        swml_doc = {
+            "version": "1.0.0",
+            "sections": {
+                "main": [
+                    {"execute_rpc": rpc_params}
+                ]
+            }
+        }
+
+        # Use execute_swml to add the action
+        return self.execute_swml(swml_doc)
+
+    def rpc_dial(self, to_number: str, from_number: str, dest_swml: str,
+                 device_type: str = "phone") -> 'SwaigFunctionResult':
+        """
+        Dial out to a number with a destination SWML URL using execute_rpc.
+
+        This is commonly used in call screening scenarios where you place a caller
+        on hold and dial out to a human, with the dest_swml specifying what agent
+        handles the outbound leg.
+
+        Args:
+            to_number: Phone number to dial (E.164 format)
+            from_number: Caller ID to use (E.164 format)
+            dest_swml: URL to the SWML that handles the outbound call
+            device_type: Device type, typically "phone" (default: "phone")
+
+        Returns:
+            self for method chaining
+
+        Example:
+            result = (
+                SwaigFunctionResult("Please hold while I connect you.")
+                .hold(timeout=120)
+                .rpc_dial(
+                    to_number="+15551234567",
+                    from_number="+15559876543",
+                    dest_swml="https://example.com/call-agent?caller=John"
+                )
+            )
+        """
+        return self.execute_rpc(
+            method="dial",
+            params={
+                "devices": {
+                    "type": device_type,
+                    "params": {
+                        "to_number": to_number,
+                        "from_number": from_number
+                    }
+                },
+                "dest_swml": dest_swml
+            }
+        )
+
+    def rpc_ai_message(self, call_id: str, message_text: str,
+                       role: str = "system") -> 'SwaigFunctionResult':
+        """
+        Inject a message into an AI agent on another call using execute_rpc.
+
+        This is useful for cross-call communication, such as notifying a held
+        caller's AI agent about a status change or instructing it to relay
+        a message.
+
+        Args:
+            call_id: The call ID of the target call
+            message_text: The message text to inject into the AI conversation
+            role: The role for the message, typically "system" (default: "system")
+
+        Returns:
+            self for method chaining
+
+        Example:
+            result = (
+                SwaigFunctionResult("I'll let them know.")
+                .rpc_ai_message(
+                    call_id=original_call_id,
+                    message_text="The person you were trying to reach is unavailable. Please take a message."
+                )
+            )
+        """
+        return self.execute_rpc(
+            method="ai_message",
+            call_id=call_id,
+            params={
+                "role": role,
+                "message_text": message_text
+            }
+        )
+
+    def rpc_ai_unhold(self, call_id: str) -> 'SwaigFunctionResult':
+        """
+        Unhold another call using execute_rpc.
+
+        This releases a call from hold state, typically used after injecting
+        a message to the held caller's AI agent.
+
+        Args:
+            call_id: The call ID of the call to unhold
+
+        Returns:
+            self for method chaining
+
+        Example:
+            result = (
+                SwaigFunctionResult("Understood, I'll let them know.")
+                .rpc_ai_message(call_id, "No one is available. Please take a message.")
+                .rpc_ai_unhold(call_id)
+            )
+        """
+        return self.execute_rpc(
+            method="ai_unhold",
+            call_id=call_id,
+            params={}
+        )
+
     @staticmethod
     def create_payment_prompt(for_situation: str, actions: List[Dict[str, str]], 
                              card_type: Optional[str] = None, 

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/signalwire_agents/utils/schema_utils.py

@@ -18,6 +18,10 @@ import json
 import logging
 from typing import Dict, Any, List, Optional, Tuple
 
+# jsonschema is required for full JSON Schema Draft 2020-12 validation
+from jsonschema import Draft202012Validator, ValidationError
+from jsonschema.exceptions import best_match
+
 try:
     import structlog
     # Ensure structlog is configured
@@ -241,35 +245,84 @@ class SchemaUtils:
                 return verb_props.get("required", [])
         return []
     
+    def _get_verb_schema(self, verb_name: str) -> Optional[Dict[str, Any]]:
+        """
+        Get the JSON Schema for validating a verb config.
+
+        This constructs a schema that can be used with jsonschema.validate() by:
+        1. Getting the verb's property schema
+        2. Including all $defs from the main schema so $ref references resolve
+
+        Args:
+            verb_name: The name of the verb
+
+        Returns:
+            A schema dict suitable for jsonschema validation, or None if not found
+        """
+        verb_props = self.get_verb_properties(verb_name)
+        if not verb_props:
+            return None
+
+        # Create a schema with the $defs from the main schema so refs work
+        schema = verb_props.copy()
+        if "$defs" in self.schema:
+            schema["$defs"] = self.schema["$defs"]
+
+        return schema
+
     def validate_verb(self, verb_name: str, verb_config: Dict[str, Any]) -> Tuple[bool, List[str]]:
         """
-        Validate a verb configuration against the schema
-        
+        Validate a verb configuration against the JSON Schema.
+
+        Uses the jsonschema library for full JSON Schema Draft 2020-12 validation,
+        which checks all constraints including:
+        - Required properties
+        - Type checking (string, number, boolean, array, object)
+        - Pattern matching (regex constraints)
+        - Enum values
+        - Minimum/maximum values
+        - MinLength/maxLength for strings
+        - MinItems/maxItems for arrays
+        - anyOf/oneOf/allOf composition
+        - And all other JSON Schema keywords
+
         Args:
             verb_name: The name of the verb (e.g., "ai", "answer", etc.)
             verb_config: The configuration for the verb
-            
+
         Returns:
             (is_valid, error_messages) tuple
         """
-        # Simple validation for now - can be enhanced with more complete JSON Schema validation
         errors = []
-        
+
         # Check if the verb exists in the schema
         if verb_name not in self.verbs:
             errors.append(f"Unknown verb: {verb_name}")
             return False, errors
-            
-        # Get the required properties for this verb
-        required_props = self.get_verb_required_properties(verb_name)
-        
-        # Check if all required properties are present
-        for prop in required_props:
-            if prop not in verb_config:
-                errors.append(f"Missing required property '{prop}' for verb '{verb_name}'")
-                
-        # Return validation result
-        return len(errors) == 0, errors
+
+        # Get the verb schema for validation
+        verb_schema = self._get_verb_schema(verb_name)
+        if not verb_schema:
+            self.log.debug("verb_schema_not_found", verb=verb_name,
+                          message="Could not extract verb schema, allowing config")
+            return True, []
+
+        # Use jsonschema for full validation
+        validator = Draft202012Validator(verb_schema)
+        validation_errors = list(validator.iter_errors(verb_config))
+
+        if not validation_errors:
+            return True, []
+
+        # Collect all error messages with their paths
+        for error in validation_errors:
+            if error.path:
+                path_str = ".".join(str(p) for p in error.path)
+                errors.append(f"{path_str}: {error.message}")
+            else:
+                errors.append(error.message)
+
+        return False, errors
     
     def get_all_verb_names(self) -> List[str]:
         """

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9/signalwire_agents.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 1.0.18.dev7
+Version: 1.0.18.dev9
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -29,6 +29,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>=4.26.0
 Provides-Extra: search-queryonly
 Requires-Dist: numpy>=1.24.0; extra == "search-queryonly"
 Requires-Dist: scikit-learn>=1.3.0; extra == "search-queryonly"

{signalwire_agents-1.0.18.dev7 → signalwire_agents-1.0.18.dev9}/signalwire_agents.egg-info/requires.txt

@@ -9,6 +9,7 @@ uvicorn>=0.34.2
 beautifulsoup4>=4.12.3
 pytz>=2023.3
 lxml>=4.9.0
+jsonschema>=4.26.0
 
 [all]
 sentence-transformers>=2.2.0