signalwire-agents 0.1.34__tar.gz → 0.1.36__tar.gz

{signalwire_agents-0.1.34/signalwire_agents.egg-info → signalwire_agents-0.1.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: signalwire_agents
-Version: 0.1.34
+Version: 0.1.36
 Summary: SignalWire AI Agents SDK
 Author-email: SignalWire Team <info@signalwire.com>
 License: MIT
@@ -74,7 +74,9 @@ Dynamic: license-file
 
 <!-- Header -->
 <div align="center">
-    <img src="https://github.com/user-attachments/assets/0c8ed3b9-8c50-4dc6-9cc4-cc6cd137fd50" width="500" href="https://signalwire.com" />
+    <a href="https://signalwire.com" target="_blank">
+        <img src="https://github.com/user-attachments/assets/0c8ed3b9-8c50-4dc6-9cc4-cc6cd137fd50" width="500" />
+    </a>
 
 # Agents SDK
 
@@ -92,15 +94,17 @@ Dynamic: license-file
 
 <!-- Badges -->
 <div align="center">
-    <img src="https://img.shields.io/badge/Discord%20Community-5865F2" alt="Discord" href="https://discord.com/invite/F2WNYTNjuF"/>
-    <img src="https://img.shields.io/badge/MIT-License-blue" alt="MIT License" href="LICENSE" />
-    <img src="https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&logoColor=white&" alt="GitHub" href="https://github.com/signalwire"/>
-    <img src="https://img.shields.io/github/stars/signalwire/signalwire-agents" alt="GitHub Stars" href="https://github.com/signalwire/docs"/>
+    <a href="https://discord.com/invite/F2WNYTNjuF" target="_blank"><img src="https://img.shields.io/badge/Discord%20Community-5865F2" alt="Discord" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/MIT-License-blue" alt="MIT License" /></a>
+    <a href="https://github.com/signalwire" target="_blank"><img src="https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&logoColor=white&" alt="GitHub" /></a>
+    <a href="https://github.com/signalwire/docs" target="_blank"><img src="https://img.shields.io/github/stars/signalwire/signalwire-agents" alt="GitHub Stars" /></a>
 </div>
 
 <br/>
 
-<img src="https://github.com/user-attachments/assets/c2510c86-ae03-42a9-be06-ab9bcea948e1" alt="Sign Up" href="https://signalwire.com/signup" height="65"/>
+<a href="https://signalwire.com/signup" target="_blank">
+    <img src="https://github.com/user-attachments/assets/c2510c86-ae03-42a9-be06-ab9bcea948e1" alt="Sign Up" height="65"/>
+</a>
 
 </div>
 

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/README.md

@@ -1,6 +1,8 @@
 <!-- Header -->
 <div align="center">
-    <img src="https://github.com/user-attachments/assets/0c8ed3b9-8c50-4dc6-9cc4-cc6cd137fd50" width="500" href="https://signalwire.com" />
+    <a href="https://signalwire.com" target="_blank">
+        <img src="https://github.com/user-attachments/assets/0c8ed3b9-8c50-4dc6-9cc4-cc6cd137fd50" width="500" />
+    </a>
 
 # Agents SDK
 
@@ -18,15 +20,17 @@
 
 <!-- Badges -->
 <div align="center">
-    <img src="https://img.shields.io/badge/Discord%20Community-5865F2" alt="Discord" href="https://discord.com/invite/F2WNYTNjuF"/>
-    <img src="https://img.shields.io/badge/MIT-License-blue" alt="MIT License" href="LICENSE" />
-    <img src="https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&logoColor=white&" alt="GitHub" href="https://github.com/signalwire"/>
-    <img src="https://img.shields.io/github/stars/signalwire/signalwire-agents" alt="GitHub Stars" href="https://github.com/signalwire/docs"/>
+    <a href="https://discord.com/invite/F2WNYTNjuF" target="_blank"><img src="https://img.shields.io/badge/Discord%20Community-5865F2" alt="Discord" /></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/MIT-License-blue" alt="MIT License" /></a>
+    <a href="https://github.com/signalwire" target="_blank"><img src="https://img.shields.io/badge/GitHub-%23121011.svg?logo=github&logoColor=white&" alt="GitHub" /></a>
+    <a href="https://github.com/signalwire/docs" target="_blank"><img src="https://img.shields.io/github/stars/signalwire/signalwire-agents" alt="GitHub Stars" /></a>
 </div>
 
 <br/>
 
-<img src="https://github.com/user-attachments/assets/c2510c86-ae03-42a9-be06-ab9bcea948e1" alt="Sign Up" href="https://signalwire.com/signup" height="65"/>
+<a href="https://signalwire.com/signup" target="_blank">
+    <img src="https://github.com/user-attachments/assets/c2510c86-ae03-42a9-be06-ab9bcea948e1" alt="Sign Up" height="65"/>
+</a>
 
 </div>
 

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/pyproject.toml

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

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/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.34"
+__version__ = "0.1.36"
 
 # Import core classes for easier access
 from .core.agent_base import AgentBase
@@ -62,6 +62,67 @@ def list_skills(*args, **kwargs):
     except ImportError:
         raise NotImplementedError("CLI helpers not available")
 
+def list_skills_with_params():
+    """
+    Get complete schema for all available skills including parameter metadata
+    
+    This function returns a comprehensive schema for all available skills,
+    including their metadata and parameter definitions. This is useful for
+    GUI configuration tools, API documentation, or programmatic skill discovery.
+    
+    Returns:
+        Dict[str, Dict[str, Any]]: Complete skill schema where keys are skill names
+        
+    Example:
+        >>> schema = list_skills_with_params()
+        >>> print(schema['web_search']['parameters']['api_key'])
+        {
+            'type': 'string',
+            'description': 'Google Custom Search API key',
+            'required': True,
+            'hidden': True,
+            'env_var': 'GOOGLE_SEARCH_API_KEY'
+        }
+    """
+    from signalwire_agents.skills.registry import skill_registry
+    return skill_registry.get_all_skills_schema()
+
+def register_skill(skill_class):
+    """
+    Register a custom skill class
+    
+    This allows third-party code to register skill classes directly without
+    requiring them to be in a specific directory structure.
+    
+    Args:
+        skill_class: A class that inherits from SkillBase
+        
+    Example:
+        >>> from my_custom_skills import MyWeatherSkill
+        >>> register_skill(MyWeatherSkill)
+        >>> # Now you can use it in agents:
+        >>> agent.add_skill('my_weather')
+    """
+    from signalwire_agents.skills.registry import skill_registry
+    return skill_registry.register_skill(skill_class)
+
+def add_skill_directory(path):
+    """
+    Add a directory to search for skills
+    
+    This allows third-party skill collections to be registered by path.
+    Skills in these directories should follow the same structure as built-in skills.
+    
+    Args:
+        path: Path to directory containing skill subdirectories
+        
+    Example:
+        >>> add_skill_directory('/opt/custom_skills')
+        >>> # Now agent.add_skill('my_custom_skill') will search in this directory
+    """
+    from signalwire_agents.skills.registry import skill_registry
+    return skill_registry.add_skill_directory(path)
+
 __all__ = [
     "AgentBase",
     "AgentServer", 
@@ -78,5 +139,8 @@ __all__ = [
     "create_simple_context",
     "start_agent",
     "run_agent",
-    "list_skills"
+    "list_skills",
+    "list_skills_with_params",
+    "register_skill",
+    "add_skill_directory"
 ]

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/signalwire_agents/core/agent_base.py

@@ -692,6 +692,13 @@ class AgentBase(
         # Add answer verb with auto-answer enabled
         agent_to_use.add_verb("answer", {})
         
+        # Add recording if enabled
+        if agent_to_use._record_call:
+            agent_to_use.add_verb("record_call", {
+                "format": agent_to_use._record_format,
+                "stereo": agent_to_use._record_stereo
+            })
+        
         # Use the AI verb handler to build and validate the AI verb config
         ai_config = {}
         
@@ -811,6 +818,14 @@ class AgentBase(
             # Clear and rebuild the document with the modified AI config
             agent_to_use.reset_document()
             agent_to_use.add_verb("answer", {})
+            
+            # Add recording if enabled
+            if agent_to_use._record_call:
+                agent_to_use.add_verb("record_call", {
+                    "format": agent_to_use._record_format,
+                    "stereo": agent_to_use._record_stereo
+                })
+            
             agent_to_use.add_verb("ai", ai_config)
         
         # Return the rendered document as a string

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/signalwire_agents/core/skill_base.py

@@ -114,4 +114,67 @@ class SkillBase(ABC):
             
         # For multi-instance skills, create key from skill name + tool name
         tool_name = self.params.get('tool_name', self.SKILL_NAME)
-        return f"{self.SKILL_NAME}_{tool_name}" 
+        return f"{self.SKILL_NAME}_{tool_name}"
+    
+    @classmethod
+    def get_parameter_schema(cls) -> Dict[str, Dict[str, Any]]:
+        """
+        Get the parameter schema for this skill
+        
+        This method returns metadata about all parameters the skill accepts,
+        including their types, descriptions, default values, and whether they
+        are required or should be hidden (e.g., API keys).
+        
+        The base implementation provides common parameters available to all skills.
+        Subclasses should override this method and merge their specific parameters
+        with the base schema.
+        
+        Returns:
+            Dict[str, Dict[str, Any]]: Parameter schema where keys are parameter names
+            and values are dictionaries containing:
+                - type: Parameter type ("string", "integer", "number", "boolean", "object", "array")
+                - description: Human-readable description
+                - default: Default value if not provided (optional)
+                - required: Whether the parameter is required (default: False)
+                - hidden: Whether to hide this field in UIs (for secrets/keys)
+                - env_var: Environment variable that can provide this value (optional)
+                - enum: List of allowed values (optional)
+                - min/max: Minimum/maximum values for numeric types (optional)
+        
+        Example:
+            {
+                "tool_name": {
+                    "type": "string",
+                    "description": "Name for the tool when using multiple instances",
+                    "default": "my_skill",
+                    "required": False
+                },
+                "api_key": {
+                    "type": "string",
+                    "description": "API key for the service",
+                    "required": True,
+                    "hidden": True,
+                    "env_var": "MY_API_KEY"
+                }
+            }
+        """
+        schema = {}
+        
+        # Add swaig_fields parameter (available to all skills)
+        schema["swaig_fields"] = {
+            "type": "object",
+            "description": "Additional SWAIG function metadata to merge into tool definitions",
+            "default": {},
+            "required": False
+        }
+        
+        # Add tool_name for multi-instance skills
+        if cls.SUPPORTS_MULTIPLE_INSTANCES:
+            schema["tool_name"] = {
+                "type": "string",
+                "description": "Custom name for this skill instance (for multiple instances)",
+                "default": cls.SKILL_NAME,
+                "required": False
+            }
+        
+        return schema 

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/signalwire_agents/skills/datetime/skill.py

@@ -110,4 +110,19 @@ class DateTimeSkill(SkillBase):
                     "Both tools support different timezones"
                 ]
             }
-        ] 
+        ]
+    
+    @classmethod
+    def get_parameter_schema(cls) -> Dict[str, Dict[str, Any]]:
+        """
+        Get the parameter schema for the datetime skill
+        
+        The datetime skill has no custom parameters - it inherits only
+        the base parameters from SkillBase.
+        """
+        # Get base schema from parent
+        schema = super().get_parameter_schema()
+        
+        # No additional parameters for datetime skill
+        
+        return schema 

{signalwire_agents-0.1.34 → signalwire_agents-0.1.36}/signalwire_agents/skills/math/skill.py

@@ -88,4 +88,19 @@ class MathSkill(SkillBase):
                     "Can handle parentheses for complex expressions"
                 ]
             }
-        ] 
+        ]
+    
+    @classmethod
+    def get_parameter_schema(cls) -> Dict[str, Dict[str, Any]]:
+        """
+        Get the parameter schema for the math skill
+        
+        The math skill has no custom parameters - it inherits only
+        the base parameters from SkillBase.
+        """
+        # Get base schema from parent
+        schema = super().get_parameter_schema()
+        
+        # No additional parameters for math skill
+        
+        return schema