signalwire-agents 0.1.44__py3-none-any.whl → 0.1.46__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__ = "0.1.44"
+__version__ = "0.1.46"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase

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

@@ -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.dist-info → signalwire_agents-0.1.46.dist-info}/RECORD

@@ -1,4 +1,4 @@
-signalwire_agents/__init__.py,sha256=CnXHre_0n--VeQ3Wt6aRA6nRhIXhpEYObD6l-wBDSHA,5031
+signalwire_agents/__init__.py,sha256=Hv5VQbfoIDYAidp17GYz_wbKRqSGKGQ87ZlHhhZ0DSM,5031
 signalwire_agents/agent_server.py,sha256=x9HyWia8D3r6KMqY-Q4DtNVivfJWLTx8B-KzUI8okuA,26880
 signalwire_agents/schema.json,sha256=6-7ccbt39iM1CO36dOfvupRPfd0gnQ0XoAdyo-EFyjo,238042
 signalwire_agents/agents/bedrock.py,sha256=J582gooNtxtep4xdVOfyDzRtHp_XrurPMS93xf2Xod0,10836
@@ -24,7 +24,7 @@ signalwire_agents/cli/simulation/data_generation.py,sha256=pxa9aJ6XkI0O8yAIGvBTU
 signalwire_agents/cli/simulation/data_overrides.py,sha256=3_3pT6j-q2gRufPX2bZ1BrmY7u1IdloLooKAJil33vI,6319
 signalwire_agents/cli/simulation/mock_env.py,sha256=fvaR_xdLMm8AbpNUbTJOFG9THcti3Zds-0QNDbKMaYk,10249
 signalwire_agents/core/__init__.py,sha256=xjPq8DmUnWYUG28sd17n430VWPmMH9oZ9W14gYwG96g,806
-signalwire_agents/core/agent_base.py,sha256=Wy1xAyJgquI4Cabss1lddoNonJzOYeo3VtY9suEFDFA,48634
+signalwire_agents/core/agent_base.py,sha256=vAx9sQ985juMi0lnfP7bw1fl_1iYRzXVIpPyE-xEFBE,50139
 signalwire_agents/core/auth_handler.py,sha256=jXrof9WZ1W9qqlQT9WElcmSRafL2kG7207x5SqWN9MU,8481
 signalwire_agents/core/config_loader.py,sha256=rStVRRUaeMGrMc44ocr0diMQQARZhbKqwMqQ6kqUNos,8722
 signalwire_agents/core/contexts.py,sha256=g9FgOGMfGCUWlm57YZcv7CvOf-Ub9FdKZIOMu14ADfE,24428
@@ -35,7 +35,7 @@ signalwire_agents/core/pom_builder.py,sha256=ywuiIfP8BeLBPo_G4X1teZlG6zTCMkW71CZ
 signalwire_agents/core/security_config.py,sha256=iAnAzKEJQiXL6mMpDaYm3Sjkxwm4x2N9HD6DeWSI8yI,12536
 signalwire_agents/core/skill_base.py,sha256=1b_4ht_T1BVnfzHYqoILb3idrrPYMs5-G-adHo2IVss,6903
 signalwire_agents/core/skill_manager.py,sha256=D4erpz0tmSYLqyfeteNNIY0VRWDtX0rDw3n7Z_f0W5U,10493
-signalwire_agents/core/swaig_function.py,sha256=VFIYQWltvYMrUfN_lfda-YzuQ2PqF2vhb-PegAliwCc,7076
+signalwire_agents/core/swaig_function.py,sha256=Zf1RQOadBgV4oxXJY7n4IfueYu0dKinfjB5RkBoHbrI,7534
 signalwire_agents/core/swml_builder.py,sha256=tJBFDAVTENEfjGLp2h9_AKOYt5O9FrSYLI-nZZVwM1E,15604
 signalwire_agents/core/swml_handler.py,sha256=hFDq41dQWL3EdFbq6h0hizE1dIqdVeiTeCrujbZsPzo,8397
 signalwire_agents/core/swml_renderer.py,sha256=-WAB_5ss836a8nBo5zlb6SaQKFNF4XIo1odWIXM4eE8,6860
@@ -51,16 +51,16 @@ signalwire_agents/core/agent/security/__init__.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_
 signalwire_agents/core/agent/swml/__init__.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/core/agent/tools/__init__.py,sha256=eOcmyeGm6qogT3wsBx7QvdjmTbc1p5hnPR6uIlvTLxI,339
 signalwire_agents/core/agent/tools/decorator.py,sha256=pC6j1114GwVBd2U3h23I9gKLtu8AgeiuWV0lUzz682U,2961
-signalwire_agents/core/agent/tools/registry.py,sha256=CgsCUMWBV4Use1baNl2KLYS2ewKjjOwm28kC_T7R6mU,7459
+signalwire_agents/core/agent/tools/registry.py,sha256=HScbKKwpJqFZ_odmeFklSQ0p0EMasEyKSxNwX568OPo,8054
 signalwire_agents/core/mixins/__init__.py,sha256=NsFpfF7TDP_lNR0Riw4Nbvt4fDbv_A3OoVbBqRrtXQM,652
 signalwire_agents/core/mixins/ai_config_mixin.py,sha256=kT-xVVWMIE6RQe6qQFCRYxli345bxOs5uS1dCtMTeTc,18232
 signalwire_agents/core/mixins/auth_mixin.py,sha256=Y9kR423-76U_pKL7KXzseeXX2a-4WxNWyo3odS7TDQM,9879
-signalwire_agents/core/mixins/prompt_mixin.py,sha256=2cAJpp3Ka-fmgpAg201xeTy-xps99k0vlP7YyqZiCnw,13374
+signalwire_agents/core/mixins/prompt_mixin.py,sha256=bEsuw9J2F_upFYI02KyC7o2eGZjwOKQ352rmJBZirAM,13729
 signalwire_agents/core/mixins/serverless_mixin.py,sha256=QIIbl_-16XFJi5aqrWpNzORbyCJQmhaplWXnW6U9i68,16137
 signalwire_agents/core/mixins/skill_mixin.py,sha256=Qz3RKPmq_iMY4NecyxOHk3dW3W-O4iEm2ahhMjAcqRs,1861
 signalwire_agents/core/mixins/state_mixin.py,sha256=q3achpyUYZKuJaqKf12O22FXpSsNNsMEonSvlpSHCkA,6594
 signalwire_agents/core/mixins/tool_mixin.py,sha256=6CaNdaspHcfte0qSB_bSN8PTsqxRZzL_AXYk8QoWyXE,8660
-signalwire_agents/core/mixins/web_mixin.py,sha256=BUzmTkPIHGfitzbn1p94SDSqp-7x_IesjliypagB4oI,50324
+signalwire_agents/core/mixins/web_mixin.py,sha256=2Tj0mulcjiUBuqHnJ76UHc5C2L5xV91HKyxfG3lNj4k,50612
 signalwire_agents/core/security/__init__.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/core/security/session_manager.py,sha256=s5hXYcFnrsYFoyo-zcN7EJy-wInZQI_cWTBHX9MxHR4,9164
 signalwire_agents/prefabs/__init__.py,sha256=MW11J63XH7KxF2MWguRsMFM9iqMWexaEO9ynDPL_PDM,715
@@ -128,9 +128,9 @@ 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-0.1.44.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
-signalwire_agents-0.1.44.dist-info/METADATA,sha256=UTsROVybKE1fRykQxtCcPh7cWJLuS5ADqrjFU-SxDEo,41281
-signalwire_agents-0.1.44.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-signalwire_agents-0.1.44.dist-info/entry_points.txt,sha256=ZDT65zfTO_YyDzi_hwQbCxIhrUfu_t8RpNXMMXlUPWI,144
-signalwire_agents-0.1.44.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
-signalwire_agents-0.1.44.dist-info/RECORD,,
+signalwire_agents-0.1.46.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
+signalwire_agents-0.1.46.dist-info/METADATA,sha256=8Ek6hbt3XtY4I_7nZj4LKk8qJL0KZogp6tOzmd-ioro,41281
+signalwire_agents-0.1.46.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+signalwire_agents-0.1.46.dist-info/entry_points.txt,sha256=ZDT65zfTO_YyDzi_hwQbCxIhrUfu_t8RpNXMMXlUPWI,144
+signalwire_agents-0.1.46.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
+signalwire_agents-0.1.46.dist-info/RECORD,,