signalwire-agents 0.1.44__tar.gz → 0.1.46__tar.gz

{signalwire_agents-0.1.44/signalwire_agents.egg-info → signalwire_agents-0.1.46}/PKG-INFO

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

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire_agents"
-version = "0.1.44"
+version = "0.1.46"
 description = "SignalWire AI Agents SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/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__ = "0.1.44"
+__version__ = "0.1.46"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/signalwire_agents/core/agent/tools/registry.py

@@ -40,6 +40,8 @@ class ToolRegistry:
         handler: Callable,
         secure: bool = True,
         fillers: Optional[Dict[str, List[str]]] = None,
+        wait_file: Optional[str] = None,
+        wait_file_loops: Optional[int] = None,
         webhook_url: Optional[str] = None,
         required: Optional[List[str]] = None,
         **swaig_fields
@@ -53,7 +55,9 @@ class ToolRegistry:
             parameters: JSON Schema of parameters
             handler: Function to call when invoked
             secure: Whether to require token validation
-            fillers: Optional dict mapping language codes to arrays of filler phrases
+            fillers: Optional dict mapping language codes to arrays of filler phrases (deprecated)
+            wait_file: Optional URL to audio file to play while function executes
+            wait_file_loops: Optional number of times to loop the wait_file
             webhook_url: Optional external webhook URL to use instead of local handling
             required: Optional list of required parameter names
             **swaig_fields: Additional SWAIG fields to include in function definition
@@ -71,6 +75,8 @@ class ToolRegistry:
             handler=handler,
             secure=secure,
             fillers=fillers,
+            wait_file=wait_file,
+            wait_file_loops=wait_file_loops,
             webhook_url=webhook_url,
             required=required,
             **swaig_fields
@@ -132,6 +138,8 @@ class ToolRegistry:
                     parameters = tool_params_copy.pop("parameters", {})
                     secure = tool_params_copy.pop("secure", True)
                     fillers = tool_params_copy.pop("fillers", None)
+                    wait_file = tool_params_copy.pop("wait_file", None)
+                    wait_file_loops = tool_params_copy.pop("wait_file_loops", None)
                     webhook_url = tool_params_copy.pop("webhook_url", None)
                     required = tool_params_copy.pop("required", None)
                     
@@ -143,6 +151,8 @@ class ToolRegistry:
                         handler=attr.__get__(self.agent, cls),  # Bind the method to this instance
                         secure=secure,
                         fillers=fillers,
+                        wait_file=wait_file,
+                        wait_file_loops=wait_file_loops,
                         webhook_url=webhook_url,
                         required=required,
                         **tool_params_copy  # Pass through any additional swaig_fields

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/signalwire_agents/core/agent_base.py

@@ -562,6 +562,7 @@ class AgentBase(
             SWML document as a string
         """
         self.log.debug("_render_swml_called", 
+                      call_id=call_id,
                       has_modifications=bool(modifications),
                       use_ephemeral=bool(modifications and modifications.get("__use_ephemeral_agent")),
                       has_dynamic_callback=bool(self._dynamic_config_callback))
@@ -618,6 +619,9 @@ class AgentBase(
         # Generate a call ID if needed
         if call_id is None:
             call_id = agent_to_use._session_manager.create_session()
+            self.log.debug("generated_call_id", call_id=call_id)
+        else:
+            self.log.debug("using_provided_call_id", call_id=call_id)
             
         # Start with any SWAIG query params that were set
         query_params = agent_to_use._swaig_query_params.copy() if agent_to_use._swaig_query_params else {}
@@ -679,6 +683,7 @@ class AgentBase(
                 token = None
                 if func.secure and call_id:
                     token = agent_to_use._create_tool_token(tool_name=name, call_id=call_id)
+                    self.log.debug("created_token_for_function", function=name, call_id=call_id, token_prefix=token[:20] if token else None)
                     
                 # Prepare function entry
                 function_entry = {
@@ -687,9 +692,25 @@ class AgentBase(
                     "parameters": func._ensure_parameter_structure()
                 }
                 
-                # Add fillers if present
-                if func.fillers:
-                    function_entry["fillers"] = func.fillers
+                # Add wait_file if present (SignalWire SWML expects wait_file, not fillers)
+                if hasattr(func, 'wait_file') and func.wait_file:
+                    wait_file_url = func.wait_file
+                    # If wait_file is a relative URL, convert it to absolute using agent's base URL
+                    if wait_file_url and not wait_file_url.startswith(('http://', 'https://', '//')):
+                        # Build full URL using the agent's base URL
+                        base_url = agent_to_use._get_base_url(include_auth=False)
+                        # Handle relative paths appropriately
+                        if not wait_file_url.startswith('/'):
+                            wait_file_url = '/' + wait_file_url
+                        wait_file_url = f"{base_url}{wait_file_url}"
+                    function_entry["wait_file"] = wait_file_url
+                elif func.fillers:
+                    # Backward compatibility: use fillers as wait_file if wait_file not specified
+                    function_entry["wait_file"] = func.fillers
+                
+                # Add wait_file_loops if present
+                if hasattr(func, 'wait_file_loops') and func.wait_file_loops is not None:
+                    function_entry["wait_file_loops"] = func.wait_file_loops
                 
                 # Handle webhook URL
                 if hasattr(func, 'webhook_url') and func.webhook_url:

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/signalwire_agents/core/mixins/prompt_mixin.py

@@ -7,7 +7,13 @@ Licensed under the MIT License.
 See LICENSE file in the project root for full license information.
 """
 
-from typing import Optional, Union, List, Dict, Any
+from typing import Optional, Union, List, Dict, Any, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from signalwire_agents.core.agent_base import AgentBase
+    from signalwire_agents.core.contexts import ContextBuilder
+else:
+    from signalwire_agents.core.contexts import ContextBuilder
 
 
 class PromptMixin:
@@ -112,7 +118,7 @@ class PromptMixin:
                                             bullets=sub_bullets if sub_bullets else None
                                         )
     
-    def define_contexts(self, contexts=None) -> Optional['ContextBuilder']:
+    def define_contexts(self, contexts=None) -> Union['AgentBase', 'ContextBuilder']:
         """
         Define contexts and steps for this agent (alternative to POM/prompt)
         
@@ -132,15 +138,22 @@ class PromptMixin:
             return self
         else:
             # Legacy behavior - return ContextBuilder
-            # Import here to avoid circular imports
-            from signalwire_agents.core.contexts import ContextBuilder
-            
             if self._contexts_builder is None:
                 self._contexts_builder = ContextBuilder(self)
                 self._contexts_defined = True
             
             return self._contexts_builder
     
+    @property
+    def contexts(self) -> 'ContextBuilder':
+        """
+        Get the ContextBuilder for this agent
+        
+        Returns:
+            ContextBuilder instance for defining contexts
+        """
+        return self.define_contexts()
+    
     def _validate_prompt_mode_exclusivity(self):
         """
         Validate that POM sections and raw text are not mixed in the main prompt

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/signalwire_agents/core/mixins/web_mixin.py

@@ -494,6 +494,10 @@ class WebMixin:
                     
                 # Get call_id from body if present
                 call_id = body.get("call_id")
+                if not call_id and "call" in body:
+                    # Sometimes it might be nested under 'call'
+                    call_id = body.get("call", {}).get("call_id")
+                req_log.debug("extracted_call_id_from_body", call_id=call_id, body_keys=list(body.keys()))
             else:
                 # Get call_id from query params for GET
                 call_id = request.query_params.get("call_id")

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46}/signalwire_agents/core/swaig_function.py

@@ -30,6 +30,8 @@ class SWAIGFunction:
         parameters: Dict[str, Dict] = None,
         secure: bool = False,
         fillers: Optional[Dict[str, List[str]]] = None,
+        wait_file: Optional[str] = None,
+        wait_file_loops: Optional[int] = None,
         webhook_url: Optional[str] = None,
         required: Optional[List[str]] = None,
         **extra_swaig_fields
@@ -43,7 +45,9 @@ class SWAIGFunction:
             description: Human-readable description of the function
             parameters: Dictionary of parameters, keys are parameter names, values are param definitions
             secure: Whether this function requires token validation
-            fillers: Optional dictionary of filler phrases by language code
+            fillers: Optional dictionary of filler phrases by language code (deprecated, use wait_file)
+            wait_file: Optional URL to audio file to play while function executes
+            wait_file_loops: Optional number of times to loop the wait_file
             webhook_url: Optional external webhook URL to use instead of local handling
             required: Optional list of required parameter names
             **extra_swaig_fields: Additional SWAIG fields to include in function definition
@@ -53,7 +57,9 @@ class SWAIGFunction:
         self.description = description
         self.parameters = parameters or {}
         self.secure = secure
-        self.fillers = fillers
+        self.fillers = fillers  # Keep for backward compatibility
+        self.wait_file = wait_file or fillers  # Use wait_file if provided, else fall back to fillers
+        self.wait_file_loops = wait_file_loops
         self.webhook_url = webhook_url
         self.required = required or []
         self.extra_swaig_fields = extra_swaig_fields

{signalwire_agents-0.1.44 → signalwire_agents-0.1.46/signalwire_agents.egg-info}/PKG-INFO

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