signalwire-sdk 3.2.0.dev91__tar.gz → 3.2.0.dev94__tar.gz

{signalwire_sdk-3.2.0.dev91/signalwire/signalwire_sdk.egg-info → signalwire_sdk-3.2.0.dev94}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire-sdk
-Version: 3.2.0.dev91
+Version: 3.2.0.dev94
 Summary: SignalWire SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -21,7 +21,6 @@ Requires-Dist: fastapi>=0.115.12
 Requires-Dist: pydantic>=2.11.4
 Requires-Dist: PyYAML>=6.0.2
 Requires-Dist: Requests>=2.32.4
-Requires-Dist: docopt>=0.6.2
 Requires-Dist: structlog>=25.3.0
 Requires-Dist: uvicorn>=0.34.2
 Requires-Dist: beautifulsoup4>=4.12.3

{signalwire_sdk-3.2.0.dev91 → signalwire_sdk-3.2.0.dev94}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire-sdk"
-version = "3.2.0.dev91"
+version = "3.2.0.dev94"
 description = "SignalWire SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -28,7 +28,6 @@ dependencies = [
     "pydantic>=2.11.4",
     "PyYAML>=6.0.2",
     "Requests>=2.32.4",
-    "docopt>=0.6.2",
     "structlog>=25.3.0",
     "uvicorn>=0.34.2",
     "beautifulsoup4>=4.12.3",

{signalwire_sdk-3.2.0.dev91 → signalwire_sdk-3.2.0.dev94}/signalwire/signalwire/__init__.py

@@ -22,40 +22,80 @@ if TYPE_CHECKING:
     from signalwire.core.skill_base import SkillBase
     from signalwire.skills.registry import SkillRegistry
 
+    # §6.2-python: the public symbols are LAZY at runtime (PEP 562, below) so
+    # `import signalwire` doesn't drag FastAPI/uvicorn/pydantic at import time; the
+    # eager imports here keep type checkers and IDEs fully aware of the real types.
+    from signalwire.core.agent_base import AgentBase
+    from signalwire.core.contexts import (
+        ContextBuilder,
+        Context,
+        Step,
+        GatherInfo,
+        GatherQuestion,
+        create_simple_context,
+    )
+    from signalwire.core.data_map import (
+        DataMap,
+        create_simple_api_tool,
+        create_expression_tool,
+    )
+    from signalwire.agent_server import AgentServer
+    from signalwire.core.swml_service import SWMLService
+    from signalwire.core.swml_builder import SWMLBuilder
+    from signalwire.core.function_result import FunctionResult, SwaigFunctionResult
+    from signalwire.core.swaig_function import SWAIGFunction
+    from signalwire.agents.bedrock import BedrockAgent
+    from signalwire.utils.schema_utils import SchemaValidationError
+    from signalwire.web import WebService
+
 configure_logging()
 
-__version__ = "3.2.0.dev91"
-
-# Import core classes for easier access.
-# These imports are intentionally placed after configure_logging() so the SDK's
-# logging is initialized before any submodule is imported (E402 expected).
-from .core.agent_base import AgentBase  # noqa: E402
-from .core.contexts import (  # noqa: E402
-    ContextBuilder,
-    Context,
-    Step,
-    GatherInfo,
-    GatherQuestion,
-    create_simple_context,
-)
-from .core.data_map import (  # noqa: E402
-    DataMap,
-    create_simple_api_tool,
-    create_expression_tool,
-)
-from signalwire.agent_server import AgentServer  # noqa: E402
-from signalwire.core.swml_service import SWMLService  # noqa: E402
-from signalwire.core.swml_builder import SWMLBuilder  # noqa: E402
-from signalwire.core.function_result import (  # noqa: E402
-    FunctionResult,
-    SwaigFunctionResult,
-)
-from signalwire.core.swaig_function import SWAIGFunction  # noqa: E402
-from signalwire.agents.bedrock import BedrockAgent  # noqa: E402
-from signalwire.utils.schema_utils import SchemaValidationError  # noqa: E402
-
-# Import WebService for static file serving
-from signalwire.web import WebService  # noqa: E402
+__version__ = "3.2.0.dev94"
+
+# §6.2-python (owner decision: NO packaging split — one package, all deps required;
+# IMPORT-TIME behavior only): the agent/web symbols are lazy-imported via module
+# __getattr__ (PEP 562) so `import signalwire` no longer drags FastAPI / uvicorn /
+# starlette / pydantic into every process — a REST-only script imports in
+# milliseconds. First ATTRIBUTE ACCESS (signalwire.AgentBase,
+# `from signalwire import AgentBase`) triggers the real import and caches it on the
+# module, so the public surface is byte-identical to the old eager form.
+_LAZY_IMPORTS: dict[str, tuple[str, str]] = {
+    "AgentBase": ("signalwire.core.agent_base", "AgentBase"),
+    "ContextBuilder": ("signalwire.core.contexts", "ContextBuilder"),
+    "Context": ("signalwire.core.contexts", "Context"),
+    "Step": ("signalwire.core.contexts", "Step"),
+    "GatherInfo": ("signalwire.core.contexts", "GatherInfo"),
+    "GatherQuestion": ("signalwire.core.contexts", "GatherQuestion"),
+    "create_simple_context": ("signalwire.core.contexts", "create_simple_context"),
+    "DataMap": ("signalwire.core.data_map", "DataMap"),
+    "create_simple_api_tool": ("signalwire.core.data_map", "create_simple_api_tool"),
+    "create_expression_tool": ("signalwire.core.data_map", "create_expression_tool"),
+    "AgentServer": ("signalwire.agent_server", "AgentServer"),
+    "SWMLService": ("signalwire.core.swml_service", "SWMLService"),
+    "SWMLBuilder": ("signalwire.core.swml_builder", "SWMLBuilder"),
+    "FunctionResult": ("signalwire.core.function_result", "FunctionResult"),
+    "SwaigFunctionResult": ("signalwire.core.function_result", "SwaigFunctionResult"),
+    "SWAIGFunction": ("signalwire.core.swaig_function", "SWAIGFunction"),
+    "BedrockAgent": ("signalwire.agents.bedrock", "BedrockAgent"),
+    "SchemaValidationError": ("signalwire.utils.schema_utils", "SchemaValidationError"),
+    "WebService": ("signalwire.web", "WebService"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    """PEP 562 lazy attribute resolution for the public agent/web symbols."""
+    spec = _LAZY_IMPORTS.get(name)
+    if spec is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    import importlib
+
+    value = getattr(importlib.import_module(spec[0]), spec[1])
+    globals()[name] = value  # cache — subsequent access skips __getattr__
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted(set(globals()) | set(_LAZY_IMPORTS))
 
 
 # Lazy import skills to avoid slow startup for CLI tools

{signalwire_sdk-3.2.0.dev91 → signalwire_sdk-3.2.0.dev94}/signalwire/signalwire/agent_server.py

@@ -68,7 +68,7 @@ class AgentServer:
         self.app = FastAPI(
             title="SignalWire AI Agents",
             description="Hosted SignalWire AI Agents",
-            version="3.2.0.dev91",
+            version="3.2.0.dev94",
             redirect_slashes=False,
             docs_url=None,
             redoc_url=None,

signalwire_sdk-3.2.0.dev94/signalwire/signalwire/core/__init__.py

@@ -0,0 +1,59 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+
+Core components for SignalWire AI Agents
+"""
+
+from typing import TYPE_CHECKING, Any
+
+if TYPE_CHECKING:
+    from signalwire.core.agent_base import AgentBase
+    from signalwire.core.function_result import FunctionResult
+    from signalwire.core.swaig_function import SWAIGFunction
+    from signalwire.core.swml_service import SWMLService
+    from signalwire.core.swml_handler import SWMLVerbHandler, VerbHandlerRegistry
+    from signalwire.core.swml_builder import SWMLBuilder
+
+# §6.2-python: lazy (PEP 562) so importing any signalwire.core.* leaf (e.g.
+# logging_config from the package root) doesn't drag AgentBase → FastAPI into every
+# process. First attribute access resolves + caches; public surface unchanged.
+_LAZY_IMPORTS: dict[str, tuple[str, str]] = {
+    "AgentBase": ("signalwire.core.agent_base", "AgentBase"),
+    "FunctionResult": ("signalwire.core.function_result", "FunctionResult"),
+    "SWAIGFunction": ("signalwire.core.swaig_function", "SWAIGFunction"),
+    "SWMLService": ("signalwire.core.swml_service", "SWMLService"),
+    "SWMLVerbHandler": ("signalwire.core.swml_handler", "SWMLVerbHandler"),
+    "VerbHandlerRegistry": ("signalwire.core.swml_handler", "VerbHandlerRegistry"),
+    "SWMLBuilder": ("signalwire.core.swml_builder", "SWMLBuilder"),
+}
+
+
+def __getattr__(name: str) -> Any:
+    spec = _LAZY_IMPORTS.get(name)
+    if spec is None:
+        raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+    import importlib
+
+    value = getattr(importlib.import_module(spec[0]), spec[1])
+    globals()[name] = value
+    return value
+
+
+def __dir__() -> list[str]:
+    return sorted(set(globals()) | set(_LAZY_IMPORTS))
+
+
+__all__ = [
+    "AgentBase",
+    "FunctionResult",
+    "SWAIGFunction",
+    "SWMLBuilder",
+    "SWMLService",
+    "SWMLVerbHandler",
+    "VerbHandlerRegistry",
+]

{signalwire_sdk-3.2.0.dev91 → signalwire_sdk-3.2.0.dev94}/signalwire/signalwire/pom/pom_tool.py

@@ -13,11 +13,11 @@ Options:
     --merge_pom=<arg>   Merge another POM into a section: "<section name>:<filename>"
 """
 
+import argparse
 import sys
 import json
 from pathlib import Path
 import yaml
-from docopt import docopt
 from signalwire.pom import PromptObjectModel
 
 
@@ -82,19 +82,38 @@ def render_pom(pom: "PromptObjectModel", output_format: str) -> str:
 
 def main() -> None:
     """Main entry point for the POM tool."""
-    args = docopt(__doc__)
-
-    input_file = args["<input_file>"]
-    output_format = args["--output"] or "md"
-    output_file = args["--outfile"]
-    merge_pom = args["--merge_pom"]
-
-    # Validate output format
-    if output_format not in ["md", "xml", "json", "yaml"]:
-        print(
-            f"Error: Invalid output format '{output_format}'. Must be one of: md, xml, json, yaml"
-        )
-        sys.exit(1)
+    # §6.2-python: argparse (stdlib) replaced the unmaintained docopt — identical CLI
+    # surface (same flags/defaults/usage), one fewer dependency.
+    parser = argparse.ArgumentParser(
+        prog="pom_tool",
+        description="POM Tool - work with Prompt Object Model files",
+    )
+    parser.add_argument("input_file", help="POM file to load (JSON or YAML)")
+    parser.add_argument(
+        "--output",
+        default="md",
+        metavar="<format>",
+        choices=["md", "xml", "json", "yaml"],
+        help="Output format: md, xml, json, yaml [default: md]",
+    )
+    parser.add_argument(
+        "--outfile",
+        default=None,
+        metavar="<file>",
+        help="Output file (if not specified, prints to stdout)",
+    )
+    parser.add_argument(
+        "--merge_pom",
+        default=None,
+        metavar="<arg>",
+        help='Merge another POM into a section: "<section name>:<filename>"',
+    )
+    ns = parser.parse_args()
+
+    input_file = ns.input_file
+    output_format = ns.output
+    output_file = ns.outfile
+    merge_pom = ns.merge_pom
 
     try:
         # Load the POM

{signalwire_sdk-3.2.0.dev91 → signalwire_sdk-3.2.0.dev94}/signalwire/signalwire/rest/__init__.py

@@ -11,10 +11,12 @@ SignalWire REST API client module.
 
 from .client import RestClient
 from ._base import SignalWireRestError, SignalWireRestTransportError
+from ._request_options import RequestOptions
 from .namespaces.relay_rest_types_generated import PhoneCallHandler
 
 __all__ = [
     "PhoneCallHandler",
+    "RequestOptions",
     "RestClient",
     "SignalWireRestError",
     "SignalWireRestTransportError",