signalwire-agents 1.0.18__py3-none-any.whl → 1.0.18.dev8__py3-none-any.whl

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"
+__version__ = "1.0.18.dev8"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase

signalwire_agents/agent_server.py

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

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.dist-info → signalwire_agents-1.0.18.dev8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 1.0.18
+Version: 1.0.18.dev8
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT

{signalwire_agents-1.0.18.dist-info → signalwire_agents-1.0.18.dev8.dist-info}/RECORD

@@ -1,5 +1,5 @@
-signalwire_agents/__init__.py,sha256=6JkNGR6BIiyQa-unzJC74JaMsJfWHEF6SkRvHjNsX8A,5031
-signalwire_agents/agent_server.py,sha256=seNZqNy2XFx6lIaRfMhFz3xC-z8Y9OIRmc0H_BhrVHk,32346
+signalwire_agents/__init__.py,sha256=npeS4j80LTMW61xutzEwYole8zeZr7OLoIXHvWVwv6c,5036
+signalwire_agents/agent_server.py,sha256=5amS5HRy1L07pht8n0msLuYm9jw33sAe9Jt6OBnzeXY,32352
 signalwire_agents/schema.json,sha256=YQv4-KiegE00XvxoLMKAml6aCGitnt3kBq31ECxTHK8,385886
 signalwire_agents/agents/bedrock.py,sha256=J582gooNtxtep4xdVOfyDzRtHp_XrurPMS93xf2Xod0,10836
 signalwire_agents/cli/__init__.py,sha256=XbxAQFaCIdGXIXJiriVBWoFPOJsC401u21588nO4TG8,388
@@ -31,7 +31,7 @@ signalwire_agents/core/auth_handler.py,sha256=jXrof9WZ1W9qqlQT9WElcmSRafL2kG7207
 signalwire_agents/core/config_loader.py,sha256=rStVRRUaeMGrMc44ocr0diMQQARZhbKqwMqQ6kqUNos,8722
 signalwire_agents/core/contexts.py,sha256=g9FgOGMfGCUWlm57YZcv7CvOf-Ub9FdKZIOMu14ADfE,24428
 signalwire_agents/core/data_map.py,sha256=0qp3VcrRS0RtZPApoAaGgM-udLBb1ysnyMJuWd6sSew,17134
-signalwire_agents/core/function_result.py,sha256=SMgLJO1sCGgLk_w7D9MZnMFF7k91rlXiUGvQeNim7Nc,48213
+signalwire_agents/core/function_result.py,sha256=z3FqB9c9aOK95TElGOrT8rY-3Px9UqWenbRFG0Mc5jY,53440
 signalwire_agents/core/logging_config.py,sha256=x4d_RAjBjVpJOFA2vXnPP2dNr13BZHz091J5rGpC77Y,13142
 signalwire_agents/core/pom_builder.py,sha256=ywuiIfP8BeLBPo_G4X1teZlG6zTCMkW71CZnmyoDTAQ,6636
 signalwire_agents/core/security_config.py,sha256=iAnAzKEJQiXL6mMpDaYm3Sjkxwm4x2N9HD6DeWSI8yI,12536
@@ -136,12 +136,12 @@ signalwire_agents/utils/token_generators.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663
 signalwire_agents/utils/validators.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/web/__init__.py,sha256=XE_pSTY9Aalzr7J7wqFth1Zr3cccQHPPcF5HWNrOpz8,383
 signalwire_agents/web/web_service.py,sha256=a2PSHJgX1tlZr0Iz1A1UouZjXEePJAZL632evvLVM38,21071
-signalwire_agents-1.0.18.data/data/share/man/man1/sw-agent-init.1,sha256=J4k5Oi74BnWCPCvsaw00vuyyqDPuIECjJIPu5OynvJc,8381
-signalwire_agents-1.0.18.data/data/share/man/man1/sw-search.1,sha256=9jJ6V6t6DgmXByz8Lw9exjf683Cw3sJGro8-eB0M9EY,10413
-signalwire_agents-1.0.18.data/data/share/man/man1/swaig-test.1,sha256=Ri0EITo8YMFowkcYltwPSwU4VJdRzo7XTWloi5WddCg,7815
-signalwire_agents-1.0.18.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
-signalwire_agents-1.0.18.dist-info/METADATA,sha256=rgOjscbyerixFTEj-SFcOkDZFwS7poGDM-U73CHF8-w,41740
-signalwire_agents-1.0.18.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-signalwire_agents-1.0.18.dist-info/entry_points.txt,sha256=fMiBH-GLeXGaWWn58Mcj7KM_m3SdomQMUQu-1LTqscw,315
-signalwire_agents-1.0.18.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
-signalwire_agents-1.0.18.dist-info/RECORD,,
+signalwire_agents-1.0.18.dev8.data/data/share/man/man1/sw-agent-init.1,sha256=J4k5Oi74BnWCPCvsaw00vuyyqDPuIECjJIPu5OynvJc,8381
+signalwire_agents-1.0.18.dev8.data/data/share/man/man1/sw-search.1,sha256=9jJ6V6t6DgmXByz8Lw9exjf683Cw3sJGro8-eB0M9EY,10413
+signalwire_agents-1.0.18.dev8.data/data/share/man/man1/swaig-test.1,sha256=Ri0EITo8YMFowkcYltwPSwU4VJdRzo7XTWloi5WddCg,7815
+signalwire_agents-1.0.18.dev8.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
+signalwire_agents-1.0.18.dev8.dist-info/METADATA,sha256=38PNqIfDS1niAIzvHmPgP29UgLfufTJh1NDa-LxXd6s,41745
+signalwire_agents-1.0.18.dev8.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+signalwire_agents-1.0.18.dev8.dist-info/entry_points.txt,sha256=fMiBH-GLeXGaWWn58Mcj7KM_m3SdomQMUQu-1LTqscw,315
+signalwire_agents-1.0.18.dev8.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
+signalwire_agents-1.0.18.dev8.dist-info/RECORD,,