signalwire-agents 0.1.2__py3-none-any.whl → 0.1.6__py3-none-any.whl

signalwire_agents/__init__.py

@@ -14,7 +14,7 @@ SignalWire AI Agents SDK
 A package for building AI agents using SignalWire's AI and SWML capabilities.
 """
 
-__version__ = "0.1.2"
+__version__ = "0.1.6"
 
 # Import core classes for easier access
 from signalwire_agents.core.agent_base import AgentBase

signalwire_agents/core/agent_base.py

@@ -1172,6 +1172,22 @@ class AgentBase(SWMLService):
     
     async def _handle_root_request(self, request: Request):
         """Handle GET/POST requests to the root endpoint"""
+        # Auto-detect proxy on first request if not explicitly configured
+        if not getattr(self, '_proxy_detection_done', False) and not getattr(self, '_proxy_url_base', None):
+            # Check for proxy headers
+            forwarded_host = request.headers.get("X-Forwarded-Host")
+            forwarded_proto = request.headers.get("X-Forwarded-Proto", "http")
+            
+            if forwarded_host:
+                self._proxy_url_base = f"{forwarded_proto}://{forwarded_host}"
+                self.log.info("proxy_auto_detected", proxy_url_base=self._proxy_url_base, 
+                            source="X-Forwarded headers")
+                self._proxy_detection_done = True
+            # If no explicit proxy headers, try the parent class detection method if it exists
+            elif hasattr(super(), '_detect_proxy_from_request'):
+                super()._detect_proxy_from_request(request)
+                self._proxy_detection_done = True
+        
         # Check if this is a callback path request
         callback_path = getattr(request.state, "callback_path", None)
         

signalwire_agents/core/swml_service.py

@@ -126,6 +126,11 @@ class SWMLService:
         self.ssl_enabled = False
         self.domain = None
         
+        # Initialize proxy detection attributes
+        self._proxy_url_base = os.environ.get('SWML_PROXY_URL_BASE')
+        self._proxy_detection_done = False
+        self._proxy_debug = os.environ.get('SWML_PROXY_DEBUG', '').lower() in ('true', '1', 'yes')
+        
         # Initialize logger for this instance
         self.log = logger.bind(service=name)
         self.log.info("service_initializing", route=self.route, host=host, port=port)
@@ -691,6 +696,11 @@ class SWMLService:
         Returns:
             Response with SWML document or error
         """
+        # Auto-detect proxy on first request if not explicitly configured
+        if not self._proxy_detection_done and not self._proxy_url_base:
+            self._detect_proxy_from_request(request)
+            self._proxy_detection_done = True
+            
         # Check auth
         if not self._check_basic_auth(request):
             response.headers["WWW-Authenticate"] = "Basic"
@@ -1054,4 +1064,98 @@ class SWMLService:
                 params = "&".join([f"{k}={v}" for k, v in filtered_params.items()])
                 url = f"{url}?{params}"
             
-        return url 
+        return url 
+
+    def _detect_proxy_from_request(self, request: Request) -> None:
+        """
+        Detect if we're behind a proxy by examining request headers
+        and auto-configure proxy_url_base if needed
+        
+        Args:
+            request: FastAPI Request object
+        """
+        # First check for standard X-Forwarded headers (used by most proxies including ngrok)
+        forwarded_host = request.headers.get("X-Forwarded-Host")
+        forwarded_proto = request.headers.get("X-Forwarded-Proto", "http")
+        
+        if forwarded_host:
+            # Direct X-Forwarded-* headers - most common case
+            self._proxy_url_base = f"{forwarded_proto}://{forwarded_host}"
+            self.log.info("proxy_auto_detected", proxy_url_base=self._proxy_url_base, 
+                        source="X-Forwarded headers")
+            return
+            
+        # If no standard headers, check other proxy detection methods
+        
+        # Check for Forwarded header (RFC 7239)
+        forwarded = request.headers.get("Forwarded")
+        if forwarded:
+            # Parse RFC 7239 Forwarded header
+            try:
+                # Extract host and proto from Forwarded: for=X;host=Y;proto=Z
+                parts = [p.strip() for p in forwarded.split(';')]
+                host_part = next((p for p in parts if p.startswith("host=")), None)
+                proto_part = next((p for p in parts if p.startswith("proto=")), None)
+                
+                if host_part:
+                    host = host_part.split('=', 1)[1].strip('"')
+                    proto = proto_part.split('=', 1)[1].strip('"') if proto_part else "http"
+                    self._proxy_url_base = f"{proto}://{host}"
+                    self.log.info("proxy_auto_detected", proxy_url_base=self._proxy_url_base,
+                                source="Forwarded header")
+                    return
+            except Exception as e:
+                self.log.warning("forwarded_header_parse_error", error=str(e))
+        
+        # Try to detect from the URL itself for transparent proxies
+        if str(request.url).startswith(("https://", "http://")) and not any(
+            str(request.url).startswith(f"http://{h}") for h in ["localhost", "127.0.0.1", self.host, "0.0.0.0"]
+        ):
+            # This is likely a transparent proxy - extract base URL
+            parsed = urlparse(str(request.url))
+            base_url = f"{parsed.scheme}://{parsed.netloc}"
+            self._proxy_url_base = base_url
+            self.log.info("proxy_auto_detected", proxy_url_base=base_url,
+                        source="request URL (transparent proxy)")
+            return
+        
+        # Check for other common proxy setups
+        original_host = request.headers.get("X-Original-Host") or request.headers.get("Host")
+        if original_host:
+            # Only use Host if it doesn't look like our local server
+            local_hosts = [self.host, "localhost", "127.0.0.1", "0.0.0.0"]
+            local_port = f":{self.port}"
+            
+            # If host doesn't look like local server or doesn't contain our port
+            if not any(h in original_host for h in local_hosts) and local_port not in original_host:
+                proto = "https" if request.url.scheme == "https" else "http"
+                self._proxy_url_base = f"{proto}://{original_host}"
+                self.log.info("proxy_auto_detected", proxy_url_base=self._proxy_url_base,
+                            source="Host header")
+                return
+        
+        # If forward_for header exists, we're likely behind a proxy but couldn't determine the URL
+        forwarded_for = request.headers.get("X-Forwarded-For")
+        if forwarded_for:
+            self.log.warning("proxy_detected_but_url_unknown", 
+                          client_ip=forwarded_for,
+                          message="Proxy detected via X-Forwarded-For header but could not determine public URL")
+            
+        # No proxy detected, or unable to determine the public URL
+        if self._proxy_debug:
+            self.log.info("proxy_detection_failed", 
+                        message="Could not auto-detect proxy. If you are behind a proxy, set SWML_PROXY_URL_BASE manually.")
+    
+    def manual_set_proxy_url(self, proxy_url: str) -> None:
+        """
+        Manually set the proxy URL base for webhook callbacks
+        
+        This can be called at runtime to set or update the proxy URL
+        
+        Args:
+            proxy_url: The base URL to use for webhooks (e.g., https://example.ngrok.io)
+        """
+        if proxy_url:
+            self._proxy_url_base = proxy_url.rstrip('/')
+            self.log.info("proxy_url_manually_set", proxy_url_base=self._proxy_url_base)
+            self._proxy_detection_done = True 

signalwire_agents/prefabs/receptionist.py

@@ -166,9 +166,7 @@ class ReceptionistAgent(AgentBase):
         self.add_language(
             name="English",
             code="en-US",
-            voice=voice,
-            speech_fillers=["Let me get that information for you...", "One moment please..."],
-            function_fillers=["I'm processing that...", "Let me check which department can help you best..."]
+            voice=voice
         )
     
     def _register_tools(self):
@@ -260,23 +258,26 @@ class ReceptionistAgent(AgentBase):
         # Get transfer number
         transfer_number = department.get("number", "")
         
-        # Create message for caller
-        message = f"I'll transfer you to our {department_name} department now. Thank you for calling, {name}!"
-        
         # Create result with transfer SWML
-        result = SwaigFunctionResult(message)
+        result = SwaigFunctionResult(f"I'll transfer you to our {department_name} department now. Thank you for calling, {name}!")
         
         # Add the SWML to execute the transfer
-        result.add_swml([
-            {
-                "play": {
-                    "url": f"say:{message}"
-                }
-            },
+                    # Add actions to update global data
+        result.add_actions([
             {
-                "connect": {
-                    "to": transfer_number
-                }
+                "SWML": {
+                    "sections": {
+                        "main": [
+                            {
+                                "connect": {
+                                    "to": transfer_number
+                                }
+                            }
+                        ]
+                    },
+                    "version": "1.0.0"
+                },
+                "transfer": "true"
             }
         ])
         

{signalwire_agents-0.1.2.dist-info → signalwire_agents-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 0.1.2
+Version: 0.1.6
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 Project-URL: Homepage, https://github.com/signalwire/signalwire-ai-agents

{signalwire_agents-0.1.2.dist-info → signalwire_agents-0.1.6.dist-info}/RECORD

@@ -1,15 +1,15 @@
-signalwire_agents/__init__.py,sha256=gZDtAkfd7KIm-6XEXIhNXI553-1Kxks035kcHQFmXjY,800
+signalwire_agents/__init__.py,sha256=q_3tXAaEKU5Yrua20bVq-dFYg0Q4burukwe_9KBujdw,800
 signalwire_agents/agent_server.py,sha256=se_YzOQE5UUoRUKCbTnOg9qr4G3qN7iVuQLutwXEwFU,12850
 signalwire_agents/schema.json,sha256=M8Mn6pQda2P9jhbmkALrLr1wt-fRuhYRqdmEi9Rbhqk,178075
 signalwire_agents/core/__init__.py,sha256=mVDLbpq1pg_WwiqsQR28NNZwJ6-VUXFIfg-vN7pk0ew,806
-signalwire_agents/core/agent_base.py,sha256=KIvueG5wIxveyALELISmPLWEkyhW5abU4hxq427ao_o,98466
+signalwire_agents/core/agent_base.py,sha256=Qd25AARkFl7zGj01o7XZogtk6f8PpXYsz7bfRcpwUuA,99436
 signalwire_agents/core/function_result.py,sha256=vD8eBDJBQNNnss1jShadfogCZw_prODB6eBkTuVgZKA,3538
 signalwire_agents/core/pom_builder.py,sha256=ywuiIfP8BeLBPo_G4X1teZlG6zTCMkW71CZnmyoDTAQ,6636
 signalwire_agents/core/swaig_function.py,sha256=WoHGQuCmU9L9k39pttRunmfRtIa_PnNRn9W0Xq3MfIk,6316
 signalwire_agents/core/swml_builder.py,sha256=Y_eHThVVso-_Hz4f73eEuu3HJstsM9PtBl-36GvAXhI,6594
 signalwire_agents/core/swml_handler.py,sha256=KvphI_YY47VWGVXaix_N3SuQSyygHEUr9We6xESQK44,7002
 signalwire_agents/core/swml_renderer.py,sha256=iobMWWoBR7dkHndI3Qlwf4C0fg2p7DmAU2Rb7ZmmLhA,13891
-signalwire_agents/core/swml_service.py,sha256=oZKM9pKPxtbsMp3nYnx5FXtW3igj2Sc2wZbQujNVNrg,42097
+signalwire_agents/core/swml_service.py,sha256=J3IHJxU172bQa0zd2xRtFwVWonui4f1v_ki1KYHl9lI,47414
 signalwire_agents/core/security/__init__.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/core/security/session_manager.py,sha256=5y0Mr3cI63cO34ctFgq-KX26mdG0Tpr7rTEsgoTS_44,5229
 signalwire_agents/core/state/__init__.py,sha256=qpYIfQBApet6VQsy6diS3yu0lMxCBC6REOUk5l1McUw,379
@@ -19,16 +19,16 @@ signalwire_agents/prefabs/__init__.py,sha256=MW11J63XH7KxF2MWguRsMFM9iqMWexaEO9y
 signalwire_agents/prefabs/concierge.py,sha256=--esvAV1lozQGYXHAqvSg8_TtlIoVfQK75APJ5zqX9I,9779
 signalwire_agents/prefabs/faq_bot.py,sha256=cUuHhnDB8S4aVg-DiQe4jBmCAPrYQrND_Mff9iaeEa0,10572
 signalwire_agents/prefabs/info_gatherer.py,sha256=y9gxjq1vF0-TrE6m734dCcAHqxt0I_DyCqxoM45QY8U,9940
-signalwire_agents/prefabs/receptionist.py,sha256=bYHbdvNepnMYgU6igcKY8AtCl2vBxUf_g6Z_2D1uD4g,10284
+signalwire_agents/prefabs/receptionist.py,sha256=Wb22igXTD8QK9lQVcJq88eIk7qQ2GSSIzSGuYyK-Dbk,10293
 signalwire_agents/prefabs/survey.py,sha256=1pyUeZ5heDqFAYqkYs5fHN_jQ7TKqJInnOOUQEajSsY,14358
 signalwire_agents/utils/__init__.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/utils/pom_utils.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/utils/schema_utils.py,sha256=LvFCFvJTQk_xYK0B-NXbkXKEF7Zmv-LqpV_vfpPnOb4,13473
 signalwire_agents/utils/token_generators.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
 signalwire_agents/utils/validators.py,sha256=4Mr7baQ_xR_hfJ72YxQRAT_GFa663YjFX_PumJ35Xds,191
-signalwire_agents-0.1.2.data/data/schema.json,sha256=M8Mn6pQda2P9jhbmkALrLr1wt-fRuhYRqdmEi9Rbhqk,178075
-signalwire_agents-0.1.2.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
-signalwire_agents-0.1.2.dist-info/METADATA,sha256=WzQzw2cTR_5Rs_Gd5ypKcOxej87H81FAfYte-ODskVg,7414
-signalwire_agents-0.1.2.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-signalwire_agents-0.1.2.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
-signalwire_agents-0.1.2.dist-info/RECORD,,
+signalwire_agents-0.1.6.data/data/schema.json,sha256=M8Mn6pQda2P9jhbmkALrLr1wt-fRuhYRqdmEi9Rbhqk,178075
+signalwire_agents-0.1.6.dist-info/licenses/LICENSE,sha256=NYvAsB-rTcSvG9cqHt9EUHAWLiA9YzM4Qfz-mPdvDR0,1067
+signalwire_agents-0.1.6.dist-info/METADATA,sha256=A4krRD2w2jb0ukbBI1kHZ6nYctSZodaaMC6Oyja13nI,7414
+signalwire_agents-0.1.6.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+signalwire_agents-0.1.6.dist-info/top_level.txt,sha256=kDGS6ZYv84K9P5Kyg9_S8P_pbUXoHkso0On_DB5bbWc,18
+signalwire_agents-0.1.6.dist-info/RECORD,,