signalwire-sdk 3.0.2.dev69__tar.gz → 3.0.2.dev71__tar.gz

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.0.2.dev69
+Version: 3.0.2.dev71
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire-sdk"
-version = "3.0.2.dev69"
+version = "3.0.2.dev71"
 description = "SignalWire SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/__init__.py

@@ -17,7 +17,7 @@ from .core.logging_config import configure_logging
 
 configure_logging()
 
-__version__ = "3.0.2.dev69"
+__version__ = "3.0.2.dev71"
 
 # Import core classes for easier access.
 # These imports are intentionally placed after configure_logging() so the SDK's

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/agent_server.py

@@ -67,7 +67,7 @@ class AgentServer:
         self.app = FastAPI(
             title="SignalWire AI Agents",
             description="Hosted SignalWire AI Agents",
-            version="3.0.2.dev69",
+            version="3.0.2.dev71",
             redirect_slashes=False,
             docs_url=None,
             redoc_url=None,

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/agents/bedrock.py

@@ -46,8 +46,8 @@ class BedrockAgent(AgentBase):
         temperature: float = 0.7,
         top_p: float = 0.9,
         max_tokens: int = 1024,
-        **kwargs,
-    ):
+        **kwargs: Any,
+    ) -> None:
         """
         Initialize BedrockAgent
 
@@ -77,7 +77,7 @@ class BedrockAgent(AgentBase):
         logger.info(f"BedrockAgent initialized: {name} on route {route}")
 
     def _render_swml(
-        self, call_id: str | None = None, modifications: dict | None = None
+        self, call_id: str | None = None, modifications: dict[str, Any] | None = None
     ) -> str:
         """
         Render SWML document with amazon_bedrock verb
@@ -264,7 +264,7 @@ class BedrockAgent(AgentBase):
         """
         self.set_inference_params(temperature=temperature)
 
-    def set_post_prompt_llm_params(self, **params) -> None:
+    def set_post_prompt_llm_params(self, **params: Any) -> None:
         """
         Set post-prompt LLM parameters - not applicable for Bedrock
 
@@ -278,7 +278,7 @@ class BedrockAgent(AgentBase):
             "set_post_prompt_llm_params() called but Bedrock post-prompt uses OpenAI configured in C code"
         )
 
-    def set_prompt_llm_params(self, **params) -> None:
+    def set_prompt_llm_params(self, **params: Any) -> None:
         """
         Set prompt LLM parameters - use set_inference_params instead
 

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/build_search.py

@@ -17,7 +17,7 @@ from urllib.parse import urlparse, urlunparse
 from signalwire.search.models import MODEL_ALIASES, DEFAULT_MODEL, resolve_model_alias
 
 
-def _mask_connection_string(conn_str):
+def _mask_connection_string(conn_str: str) -> str:
     """Mask password in connection string for safe logging."""
     try:
         parsed = urlparse(conn_str)
@@ -32,7 +32,7 @@ def _mask_connection_string(conn_str):
     return "****"
 
 
-def main():
+def main() -> None:
     """Main entry point for the build-search command"""
     parser = argparse.ArgumentParser(
         description="Build local search index from documents",
@@ -659,7 +659,7 @@ Examples:
         sys.exit(1)
 
 
-def validate_command():
+def validate_command() -> None:
     """Validate an existing search index"""
     parser = argparse.ArgumentParser(description="Validate a search index file")
     parser.add_argument("index_file", help="Path to .swsearch file to validate")
@@ -702,7 +702,7 @@ def validate_command():
         sys.exit(1)
 
 
-def search_command():
+def search_command() -> None:
     """Search within an existing search index"""
     parser = argparse.ArgumentParser(
         description="Search within a .swsearch index file or pgvector collection"
@@ -1091,7 +1091,7 @@ def search_command():
         sys.exit(1)
 
 
-def migrate_command():
+def migrate_command() -> None:
     """Migrate search indexes between backends"""
     parser = argparse.ArgumentParser(
         description="Migrate search indexes between SQLite and pgvector backends",
@@ -1242,7 +1242,7 @@ Examples:
         sys.exit(1)
 
 
-def remote_command():
+def remote_command() -> None:
     """Search via remote API endpoint"""
     parser = argparse.ArgumentParser(description="Search via remote API endpoint")
     parser.add_argument(
@@ -1413,7 +1413,7 @@ def remote_command():
         sys.exit(1)
 
 
-def console_entry_point():
+def console_entry_point() -> None:
     """Console script entry point for pip installation"""
     import sys
 

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/core/agent_loader.py

@@ -511,12 +511,12 @@ def _load_service_impl(
             captured_services = []
             patches_applied = []
 
-            def mock_serve(self, *args, **kwargs):
+            def mock_serve(self: Any, *args: Any, **kwargs: Any) -> Any:
                 captured_services.append(self)
                 print("  (Intercepted serve() call, service captured for testing)")
                 return self
 
-            def mock_run(self, *args, **kwargs):
+            def mock_run(self: Any, *args: Any, **kwargs: Any) -> Any:
                 captured_services.append(self)
                 print("  (Intercepted run() call, service captured for testing)")
                 return self

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/core/argparse_helpers.py

@@ -12,23 +12,23 @@ Custom argument parsing and function argument parsing
 
 import sys
 import argparse
-from typing import Any
+from typing import Any, NoReturn
 
 
 class CustomArgumentParser(argparse.ArgumentParser):
     """Custom ArgumentParser with better error handling"""
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
         super().__init__(*args, **kwargs)
         self._suppress_usage = False
 
-    def _print_message(self, message, file=None):
+    def _print_message(self, message: str, file: Any = None) -> None:
         """Override to suppress usage output for specific errors"""
         if self._suppress_usage:
             return
         super()._print_message(message, file)
 
-    def error(self, message):
+    def error(self, message: str) -> NoReturn:
         """Override error method to provide user-friendly error messages"""
         if "required" in message.lower() and "agent_path" in message:
             self._suppress_usage = True
@@ -49,13 +49,13 @@ class CustomArgumentParser(argparse.ArgumentParser):
             # For other errors, use the default behavior
             super().error(message)
 
-    def print_usage(self, file=None):
+    def print_usage(self, file: Any = None) -> None:
         """Override print_usage to suppress output when we want custom error handling"""
         if self._suppress_usage:
             return
         super().print_usage(file)
 
-    def parse_args(self, args=None, namespace=None):
+    def parse_args(self, args: Any = None, namespace: Any = None) -> Any:
         """Override parse_args to provide custom error handling for missing arguments"""
         # Check if no arguments provided (just the program name)
         if args is None:

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/core/service_loader.py

@@ -44,9 +44,9 @@ else:
 class ServiceCapture:
     """Captures SWMLService instances when they try to run/serve"""
 
-    def __init__(self):
+    def __init__(self) -> None:
         self.captured_services: list[SWMLService] = []
-        self.original_methods = {}
+        self.original_methods: dict[Any, Any] = {}
 
     def capture(
         self, service_path: str, suppress_output: bool = False
@@ -115,20 +115,20 @@ class ServiceCapture:
 
         return self.captured_services
 
-    def _apply_patches(self):
+    def _apply_patches(self) -> None:
         """Apply patches to capture services"""
 
         # Store reference to self for use in closures
         capture_self = self
 
-        def mock_run(service_instance, *args, **kwargs):
+        def mock_run(service_instance: Any, *args: Any, **kwargs: Any) -> Any:
             """Capture service when run() is called"""
             capture_self.captured_services.append(service_instance)
             # Don't print during stdout suppression
             # Don't actually run - we're just capturing
             return service_instance
 
-        def mock_serve(service_instance, *args, **kwargs):
+        def mock_serve(service_instance: Any, *args: Any, **kwargs: Any) -> Any:
             """Capture service when serve() is called"""
             capture_self.captured_services.append(service_instance)
             # Don't print during stdout suppression
@@ -146,7 +146,7 @@ class ServiceCapture:
                     self.original_methods[(base_class, "serve")] = base_class.serve
                     base_class.serve = mock_serve
 
-    def _restore_patches(self):
+    def _restore_patches(self) -> None:
         """Restore original methods"""
         for (base_class, method_name), original_method in self.original_methods.items():
             setattr(base_class, method_name, original_method)
@@ -156,10 +156,10 @@ class ServiceCapture:
 async def simulate_request_to_service(
     service: SWMLService,
     method: str = "POST",
-    body: dict | None = None,
-    query_params: dict | None = None,
-    headers: dict | None = None,
-) -> dict:
+    body: dict[str, Any] | None = None,
+    query_params: dict[str, str] | None = None,
+    headers: dict[str, str] | None = None,
+) -> dict[str, Any]:
     """
     Simulate a request to a SWMLService instance
 
@@ -195,7 +195,9 @@ async def simulate_request_to_service(
         # FastAPI Response
         import json
 
-        return json.loads(result.body.decode())
+        # json.loads() is typed -> Any; a FastAPI Response body is the rendered
+        # SWML JSON object, matching the declared dict return.
+        return cast(dict[str, Any], json.loads(result.body.decode()))
     if isinstance(result, dict):
         return result
     # Try to get content from response
@@ -206,11 +208,11 @@ def load_and_simulate_service(
     service_path: str,
     route: str | None = None,
     method: str = "POST",
-    body: dict | None = None,
-    query_params: dict | None = None,
-    headers: dict | None = None,
+    body: dict[str, Any] | None = None,
+    query_params: dict[str, str] | None = None,
+    headers: dict[str, str] | None = None,
     suppress_output: bool = False,
-) -> dict:
+) -> dict[str, Any]:
     """
     Load a service file and simulate a request to it
 

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/dokku.py

@@ -43,23 +43,23 @@ class Colors:
     NC = "\033[0m"
 
 
-def print_step(msg: str):
+def print_step(msg: str) -> None:
     print(f"{Colors.BLUE}==>{Colors.NC} {msg}")
 
 
-def print_success(msg: str):
+def print_success(msg: str) -> None:
     print(f"{Colors.GREEN}✓{Colors.NC} {msg}")
 
 
-def print_warning(msg: str):
+def print_warning(msg: str) -> None:
     print(f"{Colors.YELLOW}!{Colors.NC} {msg}")
 
 
-def print_error(msg: str):
+def print_error(msg: str) -> None:
     print(f"{Colors.RED}✗{Colors.NC} {msg}")
 
 
-def print_header(msg: str):
+def print_header(msg: str) -> None:
     print(f"\n{Colors.BOLD}{Colors.CYAN}{msg}{Colors.NC}")
 
 
@@ -1849,7 +1849,7 @@ class DokkuProjectGenerator:
             print_error(f"Failed to generate project: {e}")
             return False
 
-    def _write_core_files(self):
+    def _write_core_files(self) -> None:
         """Write files common to both modes."""
         # Procfile
         self._write_file("Procfile", PROCFILE_TEMPLATE)
@@ -1895,7 +1895,7 @@ class DokkuProjectGenerator:
                 ),
             )
 
-    def _write_web_files(self):
+    def _write_web_files(self) -> None:
         """Write web interface files."""
         # Create web directory
         web_dir = self.project_dir / "web"
@@ -1909,7 +1909,7 @@ class DokkuProjectGenerator:
             WEB_INDEX_TEMPLATE.format(agent_name=self.app_name, route=route),
         )
 
-    def _write_simple_files(self):
+    def _write_simple_files(self) -> None:
         """Write files for simple deployment mode."""
         dokku_host = self.options.get("dokku_host", "dokku.yourdomain.com")
         route = self.options.get("route", "swaig")
@@ -1929,7 +1929,7 @@ class DokkuProjectGenerator:
         )
         self._write_file("README.md", readme)
 
-    def _write_cicd_files(self):
+    def _write_cicd_files(self) -> None:
         """Write files for CI/CD deployment mode."""
         # Create .github/workflows directory
         workflows_dir = self.project_dir / ".github" / "workflows"
@@ -1957,7 +1957,7 @@ class DokkuProjectGenerator:
         readme = README_CICD_TEMPLATE.format(app_name=self.app_name)
         self._write_file("README.md", readme)
 
-    def _write_file(self, path: str, content: str, executable: bool = False):
+    def _write_file(self, path: str, content: str, executable: bool = False) -> None:
         """Write a file to the project directory."""
         file_path = self.project_dir / path
         file_path.parent.mkdir(parents=True, exist_ok=True)
@@ -1974,7 +1974,7 @@ class DokkuProjectGenerator:
 # =============================================================================
 
 
-def cmd_init(args):
+def cmd_init(args: argparse.Namespace) -> int:
     """Initialize a new Dokku project."""
     app_name = args.name
 
@@ -2031,7 +2031,9 @@ def cmd_init(args):
     return 1
 
 
-def _print_simple_instructions(app_name: str, dokku_host: str, project_dir: Path):
+def _print_simple_instructions(
+    app_name: str, dokku_host: str, project_dir: Path
+) -> None:
     """Print instructions for simple mode."""
     print(f"""To deploy your agent:
 
@@ -2046,7 +2048,7 @@ Or manually:
 """)
 
 
-def _print_cicd_instructions(app_name: str):
+def _print_cicd_instructions(app_name: str) -> None:
     """Print instructions for CI/CD mode."""
     print(f"""
 {Colors.BOLD}═══════════════════════════════════════════════════════════{Colors.NC}
@@ -2082,7 +2084,7 @@ def _print_cicd_instructions(app_name: str):
 """)
 
 
-def cmd_deploy(args):
+def cmd_deploy(args: argparse.Namespace) -> int:
     """Deploy to Dokku."""
     # Check if we're in a Dokku project
     if not Path("Procfile").exists():
@@ -2150,7 +2152,7 @@ def cmd_deploy(args):
     return 0
 
 
-def cmd_logs(args):
+def cmd_logs(args: argparse.Namespace) -> int:
     """Tail Dokku logs."""
     app_name = args.app
     dokku_host = args.host
@@ -2172,7 +2174,7 @@ def cmd_logs(args):
     return 0
 
 
-def cmd_config(args):
+def cmd_config(args: argparse.Namespace) -> int:
     """Manage Dokku config."""
     app_name = args.app
     dokku_host = args.host
@@ -2202,7 +2204,7 @@ def cmd_config(args):
     return 0
 
 
-def cmd_scale(args):
+def cmd_scale(args: argparse.Namespace) -> int:
     """Scale Dokku processes."""
     app_name = args.app
     dokku_host = args.host
@@ -2232,7 +2234,9 @@ def _get_app_name() -> str:
             with open(  # noqa: PTH123  # tests patch builtins.open while mocking Path; Path.open() would bypass the mock seam
                 "app.json"
             ) as f:
-                return json.load(f).get("name", "")
+                # json.load() is typed -> Any; the "name" field is a string
+                # (default "" when absent). Coerce to satisfy the str return.
+                return str(json.load(f).get("name", ""))
         except Exception:  # noqa: S110  # best-effort read of optional app.json; falls through to interactive prompt on failure
             pass
     return prompt("App name", Path.cwd().name)
@@ -2243,7 +2247,7 @@ def _get_app_name() -> str:
 # =============================================================================
 
 
-def main():
+def main() -> int:
     parser = argparse.ArgumentParser(
         description="SignalWire Agent Dokku Deployment Tool",
         formatter_class=argparse.RawDescriptionHelpFormatter,

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/execution/webhook_exec.py

@@ -12,7 +12,7 @@ Webhook function execution (including external)
 
 import json
 import requests
-from typing import Any, TYPE_CHECKING
+from typing import Any, TYPE_CHECKING, cast
 from ..config import HTTP_REQUEST_TIMEOUT
 
 if TYPE_CHECKING:
@@ -92,7 +92,9 @@ def execute_external_webhook_function(
 
         if response.status_code == 200:
             try:
-                result = response.json()
+                # requests' .json() is typed -> Any; a successful webhook returns
+                # a JSON object, matching the declared dict return.
+                result = cast(dict[str, Any], response.json())
                 if verbose:
                     print("✓ External webhook succeeded")
                     print(f"Response: {json.dumps(result, indent=2)}")

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/init_project.py

@@ -46,19 +46,19 @@ class Colors:
     NC = "\033[0m"  # No Color
 
 
-def print_step(msg: str):
+def print_step(msg: str) -> None:
     print(f"{Colors.BLUE}==>{Colors.NC} {msg}")
 
 
-def print_success(msg: str):
+def print_success(msg: str) -> None:
     print(f"{Colors.GREEN}✓{Colors.NC} {msg}")
 
 
-def print_warning(msg: str):
+def print_warning(msg: str) -> None:
     print(f"{Colors.YELLOW}!{Colors.NC} {msg}")
 
 
-def print_error(msg: str):
+def print_error(msg: str) -> None:
     print(f"{Colors.RED}✗{Colors.NC} {msg}")
 
 
@@ -2066,7 +2066,7 @@ class ProjectGenerator:
             "auth_password": auth_password,
         }
 
-    def _create_cloud_env_example(self, platform: str):
+    def _create_cloud_env_example(self, platform: str) -> None:
         """Create .env.example for cloud platforms."""
         env_content = """# Optional: Basic authentication credentials
 # If not set, the SDK will auto-generate secure credentials
@@ -2076,7 +2076,7 @@ SWML_BASIC_AUTH_PASSWORD=your-secure-password
         (self.project_dir / ".env.example").write_text(env_content)
         print_success("Created .env.example")
 
-    def _create_cloud_readme(self, platform: str):
+    def _create_cloud_readme(self, platform: str) -> None:
         """Create README.md for cloud platforms."""
         platform_names = {
             "aws": "AWS Lambda",
@@ -2272,7 +2272,7 @@ Set your phone number's SWML URL to the endpoint URL shown after deployment.
         (self.project_dir / "README.md").write_text(readme)
         print_success("Created README.md")
 
-    def _create_directories(self):
+    def _create_directories(self) -> None:
         """Create project directory structure."""
         dirs = ["agents", "skills"]
         if self.features.get("tests"):
@@ -2286,7 +2286,7 @@ Set your phone number's SWML URL to the endpoint URL shown after deployment.
         for d in dirs:
             (self.project_dir / d).mkdir(exist_ok=True)
 
-    def _create_agent_files(self):
+    def _create_agent_files(self) -> None:
         """Create agent module files."""
         agents_dir = self.project_dir / "agents"
 
@@ -2305,13 +2305,13 @@ Set your phone number's SWML URL to the endpoint URL shown after deployment.
         (self.project_dir / "skills" / "__init__.py").write_text(TEMPLATE_SKILLS_INIT)
         print_success("Created skills/__init__.py")
 
-    def _create_app_file(self):
+    def _create_app_file(self) -> None:
         """Create main app.py entry point."""
         app_code = get_app_template(self.features)
         (self.project_dir / "app.py").write_text(app_code)
         print_success("Created app.py")
 
-    def _create_config_files(self):
+    def _create_config_files(self) -> None:
         """Create configuration files."""
         # .env
         env_content = f"""# SignalWire Credentials
@@ -2357,7 +2357,7 @@ DEBUG_WEBHOOK_LEVEL=1
         (self.project_dir / "requirements.txt").write_text(TEMPLATE_REQUIREMENTS)
         print_success("Created requirements.txt")
 
-    def _create_test_files(self):
+    def _create_test_files(self) -> None:
         """Create test files."""
         tests_dir = self.project_dir / "tests"
 
@@ -2368,20 +2368,20 @@ DEBUG_WEBHOOK_LEVEL=1
         (tests_dir / "test_agent.py").write_text(test_code)
         print_success("Created tests/test_agent.py")
 
-    def _create_web_files(self):
+    def _create_web_files(self) -> None:
         """Create web UI files."""
         web_dir = self.project_dir / "web"
 
         (web_dir / "index.html").write_text(get_web_index_template())
         print_success("Created web/index.html")
 
-    def _create_readme(self):
+    def _create_readme(self) -> None:
         """Create README.md."""
         readme = get_readme_template(self.project_name, self.features)
         (self.project_dir / "README.md").write_text(readme)
         print_success("Created README.md")
 
-    def _create_virtualenv(self):
+    def _create_virtualenv(self) -> None:
         """Create and set up virtual environment."""
         venv_dir = self.project_dir / ".venv"
 
@@ -2627,7 +2627,7 @@ def run_quick(project_name: str, args: Any) -> dict[str, Any]:
     }
 
 
-def main():
+def main() -> None:
     """Main entry point."""
     import argparse
 

{signalwire_sdk-3.0.2.dev69 → signalwire_sdk-3.0.2.dev71}/signalwire/signalwire/cli/output/swml_dump.py

@@ -28,14 +28,14 @@ if TYPE_CHECKING:
 original_print = print
 
 
-def setup_output_suppression():
+def setup_output_suppression() -> None:
     """Set up output suppression for SWML dumping"""
     # The central logging system is already configured via environment variable
     # Just suppress any remaining warnings
     warnings.filterwarnings("ignore")
 
     # Capture and suppress print statements
-    def suppressed_print(*args, **kwargs):
+    def suppressed_print(*args: Any, **kwargs: Any) -> None:
         # If file is specified (like stderr), allow it
         if "file" in kwargs and kwargs["file"] is not sys.stdout:
             original_print(*args, **kwargs)