signalwire-agents 1.0.1__tar.gz → 1.0.3__tar.gz

{signalwire_agents-1.0.1/signalwire_agents.egg-info → signalwire_agents-1.0.3}/PKG-INFO

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

{signalwire_agents-1.0.1 → signalwire_agents-1.0.3}/pyproject.toml

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

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

{signalwire_agents-1.0.1 → signalwire_agents-1.0.3}/signalwire_agents/agent_server.py

@@ -549,11 +549,11 @@ class AgentServer:
                     # This is a request to an agent's sub-path
                     relative_path = full_path[len(route.lstrip("/")):]
                     relative_path = relative_path.lstrip("/")
-                    
+
                     # Route to appropriate handler based on path
                     if not relative_path or relative_path == "/":
                         return await agent._handle_root_request(request)
-                    
+
                     clean_path = relative_path.rstrip("/")
                     if clean_path == "debug":
                         return await agent._handle_debug_request(request)
@@ -564,7 +564,7 @@ class AgentServer:
                         return await agent._handle_post_prompt_request(request)
                     elif clean_path == "check_for_input":
                         return await agent._handle_check_for_input_request(request)
-                    
+
                     # Check for custom routing callbacks
                     if hasattr(agent, '_routing_callbacks'):
                         for callback_path, callback_fn in agent._routing_callbacks.items():
@@ -572,9 +572,26 @@ class AgentServer:
                             if clean_path == cb_path_clean:
                                 request.state.callback_path = callback_path
                                 return await agent._handle_root_request(request)
-            
-            # No matching agent found
-            return {"error": "Not Found"}
+
+            # No matching agent - check for static files
+            if hasattr(self, '_static_directories'):
+                # Check each static directory route
+                for static_route, static_dir in self._static_directories.items():
+                    # For root static route, serve any unmatched path
+                    if static_route == "" or static_route == "/":
+                        response = self._serve_static_file(full_path, "")
+                        if response:
+                            return response
+                    # For prefixed static routes, check if path matches
+                    elif full_path.startswith(static_route.lstrip("/") + "/") or full_path == static_route.lstrip("/"):
+                        relative_path = full_path[len(static_route.lstrip("/")):].lstrip("/")
+                        response = self._serve_static_file(relative_path, static_route)
+                        if response:
+                            return response
+
+            # No matching agent or static file found
+            from fastapi import HTTPException
+            raise HTTPException(status_code=404, detail="Not Found")
             
         # Set host and port
         host = host or self.host
@@ -634,13 +651,13 @@ class AgentServer:
                 log_level=self.log_level
             )
 
-    def register_global_routing_callback(self, callback_fn: Callable[[Request, Dict[str, Any]], Optional[str]], 
+    def register_global_routing_callback(self, callback_fn: Callable[[Request, Dict[str, Any]], Optional[str]],
                                         path: str) -> None:
         """
         Register a routing callback across all agents
-        
+
         This allows you to add unified routing logic to all agents at the same path.
-        
+
         Args:
             callback_fn: The callback function to register
             path: The path to register the callback at
@@ -648,11 +665,107 @@ class AgentServer:
         # Normalize the path
         if not path.startswith("/"):
             path = f"/{path}"
-        
+
         path = path.rstrip("/")
-        
+
         # Register with all existing agents
         for agent in self.agents.values():
             agent.register_routing_callback(callback_fn, path=path)
-        
+
         self.logger.info(f"Registered global routing callback at {path} on all agents")
+
+    def serve_static_files(self, directory: str, route: str = "/") -> None:
+        """
+        Serve static files from a directory.
+
+        This method properly integrates static file serving with agent routes,
+        ensuring that agent routes take priority over static files.
+
+        Unlike using StaticFiles.mount("/", ...) directly on self.app, this method
+        uses explicit route handlers that work correctly with agent routes.
+
+        Args:
+            directory: Path to the directory containing static files
+            route: URL path prefix for static files (default: "/" for root)
+
+        Example:
+            server = AgentServer()
+            server.register(SupportAgent(), "/support")
+            server.serve_static_files("./web")  # Serves at /
+            # /support -> SupportAgent
+            # /index.html -> ./web/index.html
+            # / -> ./web/index.html
+        """
+        from pathlib import Path
+        from fastapi.responses import FileResponse
+        from fastapi import HTTPException
+
+        # Normalize directory path
+        static_dir = Path(directory).resolve()
+
+        if not static_dir.exists():
+            raise ValueError(f"Directory does not exist: {directory}")
+
+        if not static_dir.is_dir():
+            raise ValueError(f"Path is not a directory: {directory}")
+
+        # Normalize route
+        if not route.startswith("/"):
+            route = f"/{route}"
+        route = route.rstrip("/")
+
+        # Store static directory config for use by catch-all handler
+        if not hasattr(self, '_static_directories'):
+            self._static_directories = {}
+
+        self._static_directories[route] = static_dir
+
+        self.logger.info(f"Serving static files from '{directory}' at route '{route or '/'}'")
+
+    def _serve_static_file(self, file_path: str, route: str = "/") -> Optional[Response]:
+        """
+        Internal method to serve a static file.
+
+        Args:
+            file_path: The requested file path
+            route: The route prefix
+
+        Returns:
+            FileResponse if file exists, None otherwise
+        """
+        from pathlib import Path
+        from fastapi.responses import FileResponse
+
+        if not hasattr(self, '_static_directories'):
+            return None
+
+        static_dir = self._static_directories.get(route)
+        if not static_dir:
+            return None
+
+        # Default to index.html for empty path
+        if not file_path:
+            file_path = "index.html"
+
+        full_path = static_dir / file_path
+
+        # Security: prevent path traversal
+        try:
+            full_path = full_path.resolve()
+            if not str(full_path).startswith(str(static_dir)):
+                return None
+        except Exception:
+            return None
+
+        # Handle directory requests
+        if full_path.is_dir():
+            index_path = full_path / "index.html"
+            if index_path.exists():
+                full_path = index_path
+            else:
+                return None
+
+        if not full_path.exists():
+            return None
+
+        return FileResponse(full_path)

{signalwire_agents-1.0.1 → signalwire_agents-1.0.3}/signalwire_agents/schema.json

@@ -60,6 +60,9 @@
                 {
                     "$ref": "#/$defs/Denoise"
                 },
+                {
+                    "$ref": "#/$defs/EnterQueue"
+                },
                 {
                     "$ref": "#/$defs/Execute"
                 },
@@ -303,6 +306,23 @@
             },
             "title": "Denoise object"
         },
+        "EnterQueue": {
+            "type": "object",
+            "properties": {
+                "enter_queue": {
+                    "$ref": "#/$defs/EnterQueueObject",
+                    "description": "Place the call in a queue.",
+                    "title": "enter_queue"
+                }
+            },
+            "required": [
+                "enter_queue"
+            ],
+            "unevaluatedProperties": {
+                "not": {}
+            },
+            "title": "EnterQueue object"
+        },
         "Execute": {
             "type": "object",
             "properties": {
@@ -311,7 +331,7 @@
                     "properties": {
                         "dest": {
                             "type": "string",
-                            "description": "Specifies what to execute. The value can be one of: \n<section_name> - section in the current document to execute.\nhttps://<URL>\" - URL pointing to the document to execute. Sends HTTP POST."
+                            "description": "Specifies what to execute. The value can be one of:\n- `<section_name>` - section in the current document to execute\n- A URL (http or https) that returns a SWML document - Sends HTTP POST\n- An inline SWML document (as a JSON string)"
                         },
                         "params": {
                             "type": "object",
@@ -1561,7 +1581,7 @@
                     "properties": {
                         "dest": {
                             "type": "string",
-                            "description": "Specifies where to transfer the call. The value can be one of:\n    - `<section_name>` - section in the SWML document to jump to.\n    - `https://<URL>` - URL pointing to the document to transfer to. Sends HTTP POST."
+                            "description": "Specifies where to transfer the call. The value can be one of:\n- `<section_name>` - section in the SWML document to jump to\n- A URL (http or https) that returns a SWML document - Sends HTTP POST\n- An inline SWML document (as a JSON string)"
                         },
                         "params": {
                             "type": "object",
@@ -1642,7 +1662,7 @@
                         "payment_connector_url": {
                             "type": "string",
                             "format": "uri",
-                            "description": "The URL to make POST requests with all the gathered payment details.\nThis URL is used to process the final payment transaction and return the results through the response.\n\nVisit https://developer.signalwire.com//swml/methods/pay/payment_connector_url for more important information."
+                            "description": "The URL to make POST requests with all the gathered payment details.\nThis URL is used to process the final payment transaction and return the results through the response.\n\nVisit https://developer.signalwire.com/swml/methods/pay/payment_connector_url for more important information."
                         },
                         "charge_amount": {
                             "type": "string",
@@ -2223,6 +2243,17 @@
                     "format": "uri",
                     "description": "http or https URL to deliver call status events"
                 },
+                "transfer_after_bridge": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "SWML to execute after the bridge completes. This defines what should happen after the call is connected and the bridge ends.\nCan be either:\n- A URL (http or https) that returns a SWML document\n- An inline SWML document (as a JSON string)\n\n**Note:** This parameter is REQUIRED when connecting to a queue (when `to` starts with \"queue:\")"
+                },
                 "call_state_events": {
                     "type": "array",
                     "items": {
@@ -2235,7 +2266,7 @@
                 },
                 "to": {
                     "type": "string",
-                    "description": "The SIP URI or phone number to dial."
+                    "description": "Destination to dial. Can be:\n- Phone number in E.164 format (e.g., \"+15552345678\")\n- SIP URI (e.g., \"sip:alice@example.com\")\n- Call Fabric Resource address (e.g., \"/public/test_room\")\n- Queue (e.g., \"queue:support\")"
                 }
             },
             "required": [
@@ -2398,6 +2429,17 @@
                     "format": "uri",
                     "description": "http or https URL to deliver call status events"
                 },
+                "transfer_after_bridge": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "SWML to execute after the bridge completes. This defines what should happen after the call is connected and the bridge ends.\nCan be either:\n- A URL (http or https) that returns a SWML document\n- An inline SWML document (as a JSON string)\n\n**Note:** This parameter is REQUIRED when connecting to a queue (when `to` starts with \"queue:\")"
+                },
                 "call_state_events": {
                     "type": "array",
                     "items": {
@@ -2575,6 +2617,17 @@
                     "format": "uri",
                     "description": "http or https URL to deliver call status events"
                 },
+                "transfer_after_bridge": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "SWML to execute after the bridge completes. This defines what should happen after the call is connected and the bridge ends.\nCan be either:\n- A URL (http or https) that returns a SWML document\n- An inline SWML document (as a JSON string)\n\n**Note:** This parameter is REQUIRED when connecting to a queue (when `to` starts with \"queue:\")"
+                },
                 "call_state_events": {
                     "type": "array",
                     "items": {
@@ -2753,6 +2806,17 @@
                     "format": "uri",
                     "description": "http or https URL to deliver call status events"
                 },
+                "transfer_after_bridge": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "SWML to execute after the bridge completes. This defines what should happen after the call is connected and the bridge ends.\nCan be either:\n- A URL (http or https) that returns a SWML document\n- An inline SWML document (as a JSON string)\n\n**Note:** This parameter is REQUIRED when connecting to a queue (when `to` starts with \"queue:\")"
+                },
                 "call_state_events": {
                     "type": "array",
                     "items": {
@@ -2782,6 +2846,63 @@
             },
             "title": "ConnectDeviceSerialParallel object"
         },
+        "EnterQueueObject": {
+            "type": "object",
+            "properties": {
+                "queue_name": {
+                    "type": "string",
+                    "description": "Name of the queue to enter."
+                },
+                "transfer_after_bridge": {
+                    "anyOf": [
+                        {
+                            "type": "string"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "SWML to execute after the bridge completes. This defines what should happen after the call is connected to an agent and the bridge ends.\nCan be either:\n- A URL (http or https) that returns a SWML document\n- An inline SWML document (as a JSON string)"
+                },
+                "status_url": {
+                    "type": "string",
+                    "format": "uri",
+                    "description": "HTTP or HTTPS URL to deliver queue status events. Default not set"
+                },
+                "wait_url": {
+                    "anyOf": [
+                        {
+                            "type": "string",
+                            "format": "uri"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "description": "URL for media to play while waiting in the queue. Default hold music will be played if not set"
+                },
+                "wait_time": {
+                    "anyOf": [
+                        {
+                            "type": "integer"
+                        },
+                        {
+                            "$ref": "#/$defs/SWMLVar"
+                        }
+                    ],
+                    "minimum": 1,
+                    "description": "Maximum time in seconds to wait in the queue before timeout. Default `3600`"
+                }
+            },
+            "required": [
+                "queue_name",
+                "transfer_after_bridge"
+            ],
+            "unevaluatedProperties": {
+                "not": {}
+            },
+            "title": "EnterQueueObject object"
+        },
         "ExecuteSwitch": {
             "type": "object",
             "properties": {
@@ -8665,6 +8786,12 @@
                 {
                     "$ref": "#/$defs/SWMLAction"
                 },
+                {
+                    "$ref": "#/$defs/ChangeContextAction"
+                },
+                {
+                    "$ref": "#/$defs/ChangeStepAction"
+                },
                 {
                     "$ref": "#/$defs/ContextSwitchAction"
                 },
@@ -8860,6 +8987,40 @@
             },
             "title": "SWMLAction object"
         },
+        "ChangeContextAction": {
+            "type": "object",
+            "properties": {
+                "change_context": {
+                    "type": "string",
+                    "description": "The name of the context to switch to. The context must be defined in the AI's prompt.contexts configuration.",
+                    "title": "change_context"
+                }
+            },
+            "required": [
+                "change_context"
+            ],
+            "unevaluatedProperties": {
+                "not": {}
+            },
+            "title": "ChangeContextAction object"
+        },
+        "ChangeStepAction": {
+            "type": "object",
+            "properties": {
+                "change_step": {
+                    "type": "string",
+                    "description": "The name of the step to switch to. The step must be defined in the current context's steps array.",
+                    "title": "change_step"
+                }
+            },
+            "required": [
+                "change_step"
+            ],
+            "unevaluatedProperties": {
+                "not": {}
+            },
+            "title": "ChangeStepAction object"
+        },
         "ContextSwitchAction": {
             "type": "object",
             "properties": {

{signalwire_agents-1.0.1 → signalwire_agents-1.0.3/signalwire_agents.egg-info}/PKG-INFO

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