signalwire-agents 0.1.20__tar.gz → 0.1.23__tar.gz

{signalwire_agents-0.1.20/signalwire_agents.egg-info → signalwire_agents-0.1.23}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 0.1.20
+Version: 0.1.23
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
-Project-URL: Homepage, https://github.com/signalwire/signalwire-ai-agents
-Classifier: Development Status :: 3 - Alpha
+Project-URL: Homepage, https://github.com/signalwire/signalwire-agents
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
@@ -176,7 +176,7 @@ agent.serve()
 - **Dependency validation**: Clear error messages for missing requirements
 - **Modular architecture**: Skills are self-contained and reusable
 
-For detailed documentation, see [Skills System README](docs/SKILLS_SYSTEM_README.md).
+For detailed documentation, see [Skills System README](docs/skills_system.md).
 
 ## DataMap Tools
 
@@ -572,10 +572,7 @@ class SimpleAgent(AgentBase):
         self.prompt_add_section("Goal", body="Help users with basic questions.")
         self.prompt_add_section("Instructions", bullets=["Be concise and clear."])
         
-        # Alternative using convenience methods:
-        # self.setPersonality("You are a helpful assistant.")
-        # self.setGoal("Help users with basic questions.")
-        # self.setInstructions(["Be concise and clear."])
+        # Note: Use prompt_add_section() for all prompt configuration
     
     @AgentBase.tool(
         name="get_time", 

{signalwire_agents-0.1.20 → signalwire_agents-0.1.23}/README.md

@@ -105,7 +105,7 @@ agent.serve()
 - **Dependency validation**: Clear error messages for missing requirements
 - **Modular architecture**: Skills are self-contained and reusable
 
-For detailed documentation, see [Skills System README](docs/SKILLS_SYSTEM_README.md).
+For detailed documentation, see [Skills System README](docs/skills_system.md).
 
 ## DataMap Tools
 
@@ -501,10 +501,7 @@ class SimpleAgent(AgentBase):
         self.prompt_add_section("Goal", body="Help users with basic questions.")
         self.prompt_add_section("Instructions", bullets=["Be concise and clear."])
         
-        # Alternative using convenience methods:
-        # self.setPersonality("You are a helpful assistant.")
-        # self.setGoal("Help users with basic questions.")
-        # self.setInstructions(["Be concise and clear."])
+        # Note: Use prompt_add_section() for all prompt configuration
     
     @AgentBase.tool(
         name="get_time", 

{signalwire_agents-0.1.20 → signalwire_agents-0.1.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "signalwire_agents"
-version = "0.1.20"
+version = "0.1.23"
 description = "SignalWire AI Agents SDK"
 authors = [
     {name = "SignalWire Team", email = "info@signalwire.com"}
@@ -12,7 +12,7 @@ authors = [
 readme = "README.md"
 requires-python = ">=3.7"
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
@@ -95,14 +95,14 @@ search-all = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/signalwire/signalwire-ai-agents"
+Homepage = "https://github.com/signalwire/signalwire-agents"
 
 [project.scripts]
 swaig-test = "signalwire_agents.cli.test_swaig:console_entry_point"
 sw-search = "signalwire_agents.cli.build_search:console_entry_point"
 
 [tool.setuptools]
-packages = ["signalwire_agents", "signalwire_agents.prefabs", "signalwire_agents.utils", "signalwire_agents.core", "signalwire_agents.core.state", "signalwire_agents.core.security", "signalwire_agents.skills", "signalwire_agents.skills.web_search", "signalwire_agents.skills.datetime", "signalwire_agents.skills.math", "signalwire_agents.skills.joke", "signalwire_agents.skills.datasphere", "signalwire_agents.skills.datasphere_serverless", "signalwire_agents.skills.wikipedia_search", "signalwire_agents.skills.native_vector_search", "signalwire_agents.cli", "signalwire_agents.search"]
+packages = {find = {where = ["."], include = ["signalwire_agents*"]}}
 include-package-data = true
 
 [tool.setuptools.package-data]

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

{signalwire_agents-0.1.20 → signalwire_agents-0.1.23}/signalwire_agents/agent_server.py

@@ -11,6 +11,7 @@ See LICENSE file in the project root for full license information.
 AgentServer - Class for hosting multiple SignalWire AI Agents in a single server
 """
 
+import os
 import re
 from typing import Dict, Any, Optional, List, Tuple, Callable
 
@@ -575,24 +576,62 @@ class AgentServer:
             # No matching agent found
             return {"error": "Not Found"}
             
-        # Print server info
+        # Set host and port
         host = host or self.host
         port = port or self.port
         
-        self.logger.info(f"Starting server on {host}:{port}")
+        # Check for SSL configuration from environment variables
+        ssl_enabled_env = os.environ.get('SWML_SSL_ENABLED', '').lower()
+        ssl_enabled = ssl_enabled_env in ('true', '1', 'yes')
+        ssl_cert_path = os.environ.get('SWML_SSL_CERT_PATH')
+        ssl_key_path = os.environ.get('SWML_SSL_KEY_PATH')
+        domain = os.environ.get('SWML_DOMAIN')
+        
+        # Validate SSL configuration if enabled
+        if ssl_enabled:
+            if not ssl_cert_path or not os.path.exists(ssl_cert_path):
+                self.logger.warning(f"SSL cert not found: {ssl_cert_path}")
+                ssl_enabled = False
+            elif not ssl_key_path or not os.path.exists(ssl_key_path):
+                self.logger.warning(f"SSL key not found: {ssl_key_path}")
+                ssl_enabled = False
+        
+        # Update server info display with correct protocol
+        protocol = "https" if ssl_enabled else "http"
+        
+        # Determine display host - include port unless it's the standard port for the protocol
+        if ssl_enabled and domain:
+            # Use domain, but include port if it's not the standard HTTPS port (443)
+            display_host = f"{domain}:{port}" if port != 443 else domain
+        else:
+            # Use host:port for HTTP or when no domain is specified
+            display_host = f"{host}:{port}"
+        
+        self.logger.info(f"Starting server on {protocol}://{display_host}")
         for route, agent in self.agents.items():
             username, password = agent.get_basic_auth_credentials()
             self.logger.info(f"Agent '{agent.get_name()}' available at:")
-            self.logger.info(f"URL: http://{host}:{port}{route}")
+            self.logger.info(f"URL: {protocol}://{display_host}{route}")
             self.logger.info(f"Basic Auth: {username}:{password}")
-            
-        # Start the server
-        uvicorn.run(
-            self.app,
-            host=host,
-            port=port,
-            log_level=self.log_level
-        )
+        
+        # Start the server with or without SSL
+        if ssl_enabled and ssl_cert_path and ssl_key_path:
+            self.logger.info(f"Starting with SSL - cert: {ssl_cert_path}, key: {ssl_key_path}")
+            uvicorn.run(
+                self.app,
+                host=host,
+                port=port,
+                log_level=self.log_level,
+                ssl_certfile=ssl_cert_path,
+                ssl_keyfile=ssl_key_path
+            )
+        else:
+            uvicorn.run(
+                self.app,
+                host=host,
+                port=port,
+                log_level=self.log_level
+            )
 
     def register_global_routing_callback(self, callback_fn: Callable[[Request, Dict[str, Any]], Optional[str]], 
                                         path: str) -> None:

{signalwire_agents-0.1.20 → signalwire_agents-0.1.23}/signalwire_agents/core/__init__.py

@@ -13,7 +13,7 @@ Core components for SignalWire AI Agents
 
 from signalwire_agents.core.agent_base import AgentBase
 from signalwire_agents.core.function_result import SwaigFunctionResult
-from signalwire_agents.core.swaig_function import SwaigFunction
+from signalwire_agents.core.swaig_function import SWAIGFunction
 from signalwire_agents.core.swml_service import SWMLService
 from signalwire_agents.core.swml_handler import SWMLVerbHandler, VerbHandlerRegistry
 from signalwire_agents.core.swml_builder import SWMLBuilder
@@ -21,7 +21,7 @@ from signalwire_agents.core.swml_builder import SWMLBuilder
 __all__ = [
     'AgentBase', 
     'SwaigFunctionResult', 
-    'SwaigFunction',
+    'SWAIGFunction',
     'SWMLService',
     'SWMLVerbHandler',
     'VerbHandlerRegistry',

signalwire_agents-0.1.23/signalwire_agents/core/agent/__init__.py

@@ -0,0 +1,14 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire AI Agents SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+"""
+
+"""Agent refactored components."""
+
+from .config.ephemeral import EphemeralAgentConfig
+
+__all__ = ['EphemeralAgentConfig']

signalwire_agents-0.1.23/signalwire_agents/core/agent/config/__init__.py

@@ -0,0 +1,14 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire AI Agents SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+"""
+
+"""Configuration management modules."""
+
+from .ephemeral import EphemeralAgentConfig
+
+__all__ = ['EphemeralAgentConfig']

signalwire_agents-0.1.23/signalwire_agents/core/agent/config/ephemeral.py

@@ -0,0 +1,176 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire AI Agents SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+"""
+
+"""Ephemeral agent configuration for dynamic per-request settings."""
+
+from typing import Dict, Any, Optional, List
+
+
+class EphemeralAgentConfig:
+    """
+    An ephemeral configurator object that mimics AgentBase's configuration interface.
+    
+    This allows dynamic configuration callbacks to use the same familiar methods
+    they would use during agent initialization, but for per-request configuration.
+    """
+    
+    def __init__(self):
+        # Initialize all configuration containers
+        self._hints = []
+        self._languages = []
+        self._pronounce = []
+        self._params = {}
+        self._global_data = {}
+        self._prompt_sections = []
+        self._raw_prompt = None
+        self._post_prompt = None
+        self._function_includes = []
+        self._native_functions = []
+    
+    # Mirror all the AgentBase configuration methods
+    
+    def add_hint(self, hint: str) -> 'EphemeralAgentConfig':
+        """Add a simple string hint"""
+        if isinstance(hint, str) and hint:
+            self._hints.append(hint)
+        return self
+    
+    def add_hints(self, hints: List[str]) -> 'EphemeralAgentConfig':
+        """Add multiple string hints"""
+        if hints and isinstance(hints, list):
+            for hint in hints:
+                if isinstance(hint, str) and hint:
+                    self._hints.append(hint)
+        return self
+    
+    def add_language(self, name: str, code: str, voice: str, **kwargs) -> 'EphemeralAgentConfig':
+        """Add a language configuration"""
+        language = {
+            "name": name,
+            "code": code,
+            "voice": voice
+        }
+        
+        # Handle additional parameters
+        for key, value in kwargs.items():
+            if key in ["engine", "model", "speech_fillers", "function_fillers", "fillers"]:
+                language[key] = value
+        
+        self._languages.append(language)
+        return self
+    
+    def add_pronunciation(self, replace: str, with_text: str, ignore_case: bool = False) -> 'EphemeralAgentConfig':
+        """Add a pronunciation rule"""
+        if replace and with_text:
+            rule = {"replace": replace, "with": with_text}
+            if ignore_case:
+                rule["ignore_case"] = True
+            self._pronounce.append(rule)
+        return self
+    
+    def set_param(self, key: str, value: Any) -> 'EphemeralAgentConfig':
+        """Set a single AI parameter"""
+        if key:
+            self._params[key] = value
+        return self
+    
+    def set_params(self, params: Dict[str, Any]) -> 'EphemeralAgentConfig':
+        """Set multiple AI parameters"""
+        if params and isinstance(params, dict):
+            self._params.update(params)
+        return self
+    
+    def set_global_data(self, data: Dict[str, Any]) -> 'EphemeralAgentConfig':
+        """Set global data"""
+        if data and isinstance(data, dict):
+            self._global_data = data
+        return self
+    
+    def update_global_data(self, data: Dict[str, Any]) -> 'EphemeralAgentConfig':
+        """Update global data"""
+        if data and isinstance(data, dict):
+            self._global_data.update(data)
+        return self
+    
+    def set_prompt_text(self, text: str) -> 'EphemeralAgentConfig':
+        """Set raw prompt text"""
+        self._raw_prompt = text
+        return self
+    
+    def set_post_prompt(self, text: str) -> 'EphemeralAgentConfig':
+        """Set post-prompt text"""
+        self._post_prompt = text
+        return self
+    
+    def prompt_add_section(self, title: str, body: str = "", bullets: Optional[List[str]] = None, **kwargs) -> 'EphemeralAgentConfig':
+        """Add a prompt section"""
+        section = {
+            "title": title,
+            "body": body
+        }
+        if bullets:
+            section["bullets"] = bullets
+        
+        # Handle additional parameters
+        for key, value in kwargs.items():
+            if key in ["numbered", "numbered_bullets", "subsections"]:
+                section[key] = value
+        
+        self._prompt_sections.append(section)
+        return self
+    
+    def set_native_functions(self, function_names: List[str]) -> 'EphemeralAgentConfig':
+        """Set native functions"""
+        if function_names and isinstance(function_names, list):
+            self._native_functions = [name for name in function_names if isinstance(name, str)]
+        return self
+    
+    def add_function_include(self, url: str, functions: List[str], meta_data: Optional[Dict[str, Any]] = None) -> 'EphemeralAgentConfig':
+        """Add a function include"""
+        if url and functions and isinstance(functions, list):
+            include = {"url": url, "functions": functions}
+            if meta_data and isinstance(meta_data, dict):
+                include["meta_data"] = meta_data
+            self._function_includes.append(include)
+        return self
+    
+    def extract_config(self) -> Dict[str, Any]:
+        """
+        Extract the configuration as a dictionary for applying to the real agent.
+        
+        Returns:
+            Dictionary containing all the configuration changes
+        """
+        config = {}
+        
+        if self._hints:
+            config["hints"] = self._hints
+        if self._languages:
+            config["languages"] = self._languages
+        if self._pronounce:
+            config["pronounce"] = self._pronounce
+        if self._params:
+            config["params"] = self._params
+        if self._global_data:
+            config["global_data"] = self._global_data
+        if self._function_includes:
+            config["function_includes"] = self._function_includes
+        if self._native_functions:
+            config["native_functions"] = self._native_functions
+        
+        # Handle prompt sections - these should be applied to the agent's POM, not as raw config
+        # The calling code should use these to build the prompt properly
+        if self._prompt_sections:
+            config["_ephemeral_prompt_sections"] = self._prompt_sections
+        if self._raw_prompt:
+            config["_ephemeral_raw_prompt"] = self._raw_prompt
+        if self._post_prompt:
+            config["_ephemeral_post_prompt"] = self._post_prompt
+        
+        return config

signalwire_agents-0.1.23/signalwire_agents/core/agent/prompt/__init__.py

@@ -0,0 +1,14 @@
+"""
+Copyright (c) 2025 SignalWire
+
+This file is part of the SignalWire AI Agents SDK.
+
+Licensed under the MIT License.
+See LICENSE file in the project root for full license information.
+"""
+
+"""Prompt management modules."""
+
+from .manager import PromptManager
+
+__all__ = ['PromptManager']