mcp-proxy-adapter 6.0.0__py3-none-any.whl → 6.1.1__py3-none-any.whl

mcp_proxy_adapter/examples/custom_commands/custom_settings_manager.py

@@ -1,241 +0,0 @@
-"""
-Custom Settings Manager Example
-
-This module demonstrates how to create a custom settings manager
-that extends the framework's settings system with application-specific settings.
-"""
-
-import json
-import os
-from typing import Dict, Any, Optional
-from mcp_proxy_adapter.core.settings import (
-    add_custom_settings,
-    get_custom_settings,
-    get_custom_setting_value,
-    set_custom_setting_value
-)
-from mcp_proxy_adapter.core.logging import get_logger
-
-
-class CustomSettingsManager:
-    """
-    Custom settings manager for the extended server example.
-    
-    This class demonstrates how to:
-    1. Load custom settings from JSON files
-    2. Add them to the framework's settings system
-    3. Provide convenient access methods
-    4. Handle settings validation and defaults
-    """
-    
-    def __init__(self, config_file: str = "custom_settings.json"):
-        """
-        Initialize the custom settings manager.
-        
-        Args:
-            config_file: Path to custom settings JSON file
-        """
-        self.config_file = config_file
-        self.logger = get_logger("custom_settings_manager")
-        self._load_custom_settings()
-    
-    def _load_custom_settings(self) -> None:
-        """Load custom settings from JSON file."""
-        try:
-            if os.path.exists(self.config_file):
-                with open(self.config_file, 'r', encoding='utf-8') as f:
-                    custom_settings = json.load(f)
-                
-                self.logger.info(f"📁 Loaded custom settings from: {self.config_file}")
-                self.logger.debug(f"📋 Custom settings: {custom_settings}")
-                
-                # Add to framework's settings system
-                add_custom_settings(custom_settings)
-                
-            else:
-                self.logger.warning(f"⚠️  Custom settings file not found: {self.config_file}")
-                self.logger.info("📝 Using default custom settings")
-                
-                # Use default settings
-                default_settings = self._get_default_settings()
-                add_custom_settings(default_settings)
-                
-        except Exception as e:
-            self.logger.error(f"❌ Failed to load custom settings: {e}")
-            self.logger.info("📝 Using default custom settings")
-            
-            # Use default settings on error
-            default_settings = self._get_default_settings()
-            add_custom_settings(default_settings)
-    
-    def _get_default_settings(self) -> Dict[str, Any]:
-        """Get default custom settings."""
-        return {
-            "application": {
-                "name": "Extended MCP Proxy Server",
-                "version": "2.0.0",
-                "environment": "development"
-            },
-            "features": {
-                "advanced_hooks": True,
-                "custom_commands": True,
-                "data_transformation": True,
-                "command_interception": True,
-                "performance_monitoring": False
-            },
-            "security": {
-                "enable_authentication": False,
-                "max_request_size": "10MB",
-                "rate_limiting": {
-                    "enabled": False,
-                    "requests_per_minute": 100
-                }
-            },
-            "monitoring": {
-                "enable_metrics": True,
-                "metrics_interval": 60,
-                "health_check_interval": 30
-            },
-            "custom_commands": {
-                "auto_echo": {
-                    "enabled": True,
-                    "max_length": 1000
-                },
-                "data_transform": {
-                    "enabled": True,
-                    "transform_types": ["uppercase", "lowercase", "reverse"]
-                },
-                "intercept": {
-                    "enabled": True,
-                    "bypass_conditions": ["input_value == 0"]
-                }
-            }
-        }
-    
-    def get_application_name(self) -> str:
-        """Get application name."""
-        return get_custom_setting_value("application.name", "Extended MCP Proxy Server")
-    
-    def get_application_version(self) -> str:
-        """Get application version."""
-        return get_custom_setting_value("application.version", "2.0.0")
-    
-    def get_environment(self) -> str:
-        """Get application environment."""
-        return get_custom_setting_value("application.environment", "development")
-    
-    def is_feature_enabled(self, feature_name: str) -> bool:
-        """Check if a feature is enabled."""
-        return get_custom_setting_value(f"features.{feature_name}", False)
-    
-    def get_security_setting(self, setting_name: str, default: Any = None) -> Any:
-        """Get security setting."""
-        return get_custom_setting_value(f"security.{setting_name}", default)
-    
-    def get_monitoring_setting(self, setting_name: str, default: Any = None) -> Any:
-        """Get monitoring setting."""
-        return get_custom_setting_value(f"monitoring.{setting_name}", default)
-    
-    def get_custom_command_setting(self, command_name: str, setting_name: str, default: Any = None) -> Any:
-        """Get custom command setting."""
-        return get_custom_setting_value(f"custom_commands.{command_name}.{setting_name}", default)
-    
-    def set_custom_setting(self, key: str, value: Any) -> None:
-        """Set a custom setting."""
-        set_custom_setting_value(key, value)
-        self.logger.info(f"🔧 Set custom setting: {key} = {value}")
-    
-    def get_all_custom_settings(self) -> Dict[str, Any]:
-        """Get all custom settings."""
-        return get_custom_settings()
-    
-    def reload_settings(self) -> None:
-        """Reload custom settings from file."""
-        self.logger.info("🔄 Reloading custom settings...")
-        self._load_custom_settings()
-        self.logger.info("✅ Custom settings reloaded")
-    
-    def validate_settings(self) -> Dict[str, Any]:
-        """
-        Validate current settings and return validation results.
-        
-        Returns:
-            Dictionary with validation results
-        """
-        validation_results = {
-            "valid": True,
-            "errors": [],
-            "warnings": []
-        }
-        
-        # Validate required settings
-        required_settings = [
-            "application.name",
-            "application.version",
-            "features.advanced_hooks"
-        ]
-        
-        for setting in required_settings:
-            if get_custom_setting_value(setting) is None:
-                validation_results["valid"] = False
-                validation_results["errors"].append(f"Missing required setting: {setting}")
-        
-        # Validate feature dependencies
-        if self.is_feature_enabled("data_transformation"):
-            if not self.is_feature_enabled("custom_commands"):
-                validation_results["warnings"].append(
-                    "data_transformation requires custom_commands to be enabled"
-                )
-        
-        # Validate security settings
-        if self.get_security_setting("enable_authentication"):
-            if not self.get_security_setting("rate_limiting.enabled"):
-                validation_results["warnings"].append(
-                    "Authentication enabled but rate limiting is disabled"
-                )
-        
-        return validation_results
-    
-    def print_settings_summary(self) -> None:
-        """Print a summary of current settings."""
-        self.logger.info("📊 Custom Settings Summary:")
-        self.logger.info(f"   Application: {self.get_application_name()} v{self.get_application_version()}")
-        self.logger.info(f"   Environment: {self.get_environment()}")
-        
-        # Features
-        features = []
-        for feature in ["advanced_hooks", "custom_commands", "data_transformation", "command_interception"]:
-            if self.is_feature_enabled(feature):
-                features.append(feature)
-        
-        self.logger.info(f"   Enabled Features: {', '.join(features) if features else 'None'}")
-        
-        # Security
-        auth_enabled = self.get_security_setting("enable_authentication", False)
-        rate_limiting = self.get_security_setting("rate_limiting.enabled", False)
-        self.logger.info(f"   Security: Auth={auth_enabled}, Rate Limiting={rate_limiting}")
-        
-        # Monitoring
-        metrics_enabled = self.get_monitoring_setting("enable_metrics", False)
-        self.logger.info(f"   Monitoring: Metrics={metrics_enabled}")
-
-
-# Convenience functions for easy access
-def get_app_name() -> str:
-    """Get application name."""
-    return get_custom_setting_value("application.name", "Extended MCP Proxy Server")
-
-
-def is_feature_enabled(feature_name: str) -> bool:
-    """Check if a feature is enabled."""
-    return get_custom_setting_value(f"features.{feature_name}", False)
-
-
-def get_security_setting(setting_name: str, default: Any = None) -> Any:
-    """Get security setting."""
-    return get_custom_setting_value(f"security.{setting_name}", default)
-
-
-def get_monitoring_setting(setting_name: str, default: Any = None) -> Any:
-    """Get monitoring setting."""
-    return get_custom_setting_value(f"monitoring.{setting_name}", default) 

mcp_proxy_adapter/examples/custom_commands/data_transform_command.py

@@ -1,135 +0,0 @@
-"""
-Data Transform Command Example
-
-A command that demonstrates advanced hooks with data transformation.
-"""
-
-from typing import Dict, Any, Optional
-from mcp_proxy_adapter.commands.base import Command
-from mcp_proxy_adapter.commands.result import CommandResult
-
-
-class DataTransformResult(CommandResult):
-    """
-    Result of the data transform command execution.
-    """
-    
-    def __init__(self, original_data: Dict[str, Any], transformed_data: Dict[str, Any], 
-                 processing_info: Dict[str, Any]):
-        """
-        Initialize data transform command result.
-        
-        Args:
-            original_data: Original input data
-            transformed_data: Transformed output data
-            processing_info: Information about processing steps
-        """
-        self.original_data = original_data
-        self.transformed_data = transformed_data
-        self.processing_info = processing_info
-    
-    def to_dict(self) -> Dict[str, Any]:
-        """
-        Convert result to dictionary.
-        
-        Returns:
-            Dict[str, Any]: Result as dictionary
-        """
-        return {
-            "original_data": self.original_data,
-            "transformed_data": self.transformed_data,
-            "processing_info": self.processing_info,
-            "command_type": "data_transform"
-        }
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for the result.
-        
-        Returns:
-            Dict[str, Any]: JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "original_data": {"type": "object"},
-                "transformed_data": {"type": "object"},
-                "processing_info": {"type": "object"},
-                "command_type": {"type": "string"}
-            }
-        }
-
-
-class DataTransformCommand(Command):
-    """
-    Data transform command for demonstrating advanced hooks.
-    """
-    
-    name = "data_transform"
-    result_class = DataTransformResult
-    
-    async def execute(self, data: Optional[Dict[str, Any]] = None, 
-                     transform_type: Optional[str] = None, **kwargs) -> DataTransformResult:
-        """
-        Execute data transform command.
-        
-        Args:
-            data: Input data to transform
-            transform_type: Type of transformation to apply
-            **kwargs: Additional parameters
-            
-        Returns:
-            DataTransformResult: Data transform command result
-        """
-        # Get original data (may be modified by hooks)
-        original_data = data or {}
-        transform_type = transform_type or "default"
-        
-        # Apply transformation based on type
-        if transform_type == "uppercase":
-            transformed_data = {k: str(v).upper() for k, v in original_data.items()}
-        elif transform_type == "lowercase":
-            transformed_data = {k: str(v).lower() for k, v in original_data.items()}
-        elif transform_type == "reverse":
-            transformed_data = {k: str(v)[::-1] for k, v in original_data.items()}
-        else:
-            transformed_data = original_data.copy()
-        
-        # Add processing info
-        processing_info = {
-            "transform_type": transform_type,
-            "input_keys": list(original_data.keys()),
-            "output_keys": list(transformed_data.keys()),
-            "hook_enhanced": kwargs.get("hook_enhanced", False),
-            "data_modified": kwargs.get("data_modified", False)
-        }
-        
-        return DataTransformResult(
-            original_data=original_data,
-            transformed_data=transformed_data,
-            processing_info=processing_info
-        )
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for command parameters.
-        
-        Returns:
-            Dict[str, Any]: JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "data": {
-                    "type": "object",
-                    "description": "Input data to transform"
-                },
-                "transform_type": {
-                    "type": "string",
-                    "enum": ["uppercase", "lowercase", "reverse", "default"],
-                    "description": "Type of transformation to apply"
-                }
-            }
-        } 

mcp_proxy_adapter/examples/custom_commands/echo_command.py

@@ -1,122 +0,0 @@
-"""
-Echo Command Example
-
-A simple echo command that returns the input message.
-"""
-
-from typing import Dict, Any, Optional
-from datetime import datetime
-from mcp_proxy_adapter.commands.base import Command
-from mcp_proxy_adapter.commands.result import SuccessResult
-
-
-class EchoResult(SuccessResult):
-    """
-    Result of the echo command execution.
-    """
-    
-    def __init__(self, message: str, timestamp: str):
-        """
-        Initialize echo command result.
-        
-        Args:
-            message: The echoed message
-            timestamp: Timestamp of execution
-        """
-        super().__init__(
-            data={
-                "message": message,
-                "timestamp": timestamp,
-                "echoed": True
-            }
-        )
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for result validation.
-        
-        Returns:
-            Dict[str, Any]: JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "data": {
-                    "type": "object",
-                    "properties": {
-                        "message": {"type": "string"},
-                        "timestamp": {"type": "string"},
-                        "echoed": {"type": "boolean"}
-                    },
-                    "required": ["message", "timestamp", "echoed"]
-                }
-            },
-            "required": ["data"]
-        }
-
-
-class EchoCommand(Command):
-    """
-    Echo command that returns the input message.
-    """
-    
-    name = "echo"
-    result_class = EchoResult
-    
-    async def execute(self, message: Optional[str] = None, **kwargs) -> EchoResult:
-        """
-        Execute echo command.
-        
-        Args:
-            message: Message to echo (optional)
-            **kwargs: Additional parameters
-            
-        Returns:
-            EchoResult: Echo command result
-        """
-        # Use provided message or default
-        if message is None:
-            message = kwargs.get("text", "Hello, World!")
-        
-        # Check if hook added timestamp
-        hook_timestamp = kwargs.get("hook_timestamp")
-        if hook_timestamp:
-            # Use hook timestamp if available
-            timestamp = hook_timestamp
-        else:
-            # Get current timestamp
-            timestamp = datetime.now().isoformat()
-        
-        # Add hook metadata to result
-        result = EchoResult(message=message, timestamp=timestamp)
-        
-        # Add hook information if available
-        if kwargs.get("hook_processed"):
-            result.data["hook_processed"] = True
-            result.data["hook_timestamp"] = hook_timestamp
-        
-        return result
-    
-    @classmethod
-    def get_schema(cls) -> Dict[str, Any]:
-        """
-        Get JSON schema for command parameters.
-        
-        Returns:
-            Dict[str, Any]: JSON schema
-        """
-        return {
-            "type": "object",
-            "properties": {
-                "message": {
-                    "type": "string",
-                    "description": "Message to echo",
-                    "default": "Hello, World!"
-                },
-                "text": {
-                    "type": "string", 
-                    "description": "Alternative parameter name for message"
-                }
-            }
-        } 

mcp_proxy_adapter/examples/custom_commands/full_help_response.json

@@ -1 +0,0 @@
-{"jsonrpc":"2.0","result":{"commands":{"echo":{"name":"echo","metadata":{"name":"echo","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Echo command that returns the input message.","description":"Echo command that returns the input message.","params":{"message":{"name":"message","required":false,"type":"typing.Optional[str]","default":null},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"echo","params":{"kwargs":"..."},"description":"Call echo command with required parameters"},{"command":"echo","params":{"message":null,"kwargs":"..."},"description":"Call echo command with all parameters"}],"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message to echo","default":"Hello, World!"},"text":{"type":"string","description":"Alternative parameter name for message"}}},"result_schema":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"type":"string"},"timestamp":{"type":"string"},"echoed":{"type":"boolean"}},"required":["message","timestamp","echoed"]}},"required":["data"]},"result_class":"EchoResult"},"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message to echo","default":"Hello, World!"},"text":{"type":"string","description":"Alternative parameter name for message"}}},"type":"custom"},"help":{"name":"help","metadata":{"name":"help","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Custom help command with enhanced functionality.","description":"Custom help command with enhanced functionality.","params":{"cmdname":{"name":"cmdname","required":false,"type":"typing.Optional[str]","default":null},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"help","params":{"kwargs":"..."},"description":"Call help command with required parameters"},{"command":"help","params":{"cmdname":null,"kwargs":"..."},"description":"Call help command with all parameters"}],"schema":{"type":"object","properties":{"cmdname":{"type":"string","description":"Name of specific command to get help for"}}},"result_schema":{"type":"object","properties":{"cmdname":{"type":"string","description":"Name of the command"},"info":{"type":"object","properties":{"description":{"type":"string"},"summary":{"type":"string"},"params":{"type":"object"},"examples":{"type":"array"},"custom_help":{"type":"boolean"}}},"tool_info":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"version":{"type":"string"},"custom_help":{"type":"boolean"}}},"help_usage":{"type":"object","properties":{"description":{"type":"string"},"examples":{"type":"array"}}},"commands":{"type":"object"},"total":{"type":"integer"},"custom_features":{"type":"object"}}},"result_class":"CustomHelpResult"},"schema":{"type":"object","properties":{"cmdname":{"type":"string","description":"Name of specific command to get help for"}}},"type":"custom"},"health":{"name":"health","metadata":{"name":"health","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Custom health command with enhanced system information.","description":"Custom health command with enhanced system information.","params":{"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"health","params":{"kwargs":"..."},"description":"Call health command with required parameters"}],"schema":{"type":"object","properties":{},"description":"Get enhanced system health information"},"result_schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string"},"version":{"type":"string"},"uptime":{"type":"number"},"components":{"type":"object"},"custom_metrics":{"type":"object"},"custom_health":{"type":"boolean"}},"required":["status","version","uptime","components","custom_metrics","custom_health"]}},"required":["data"]},"result_class":"CustomHealthResult"},"schema":{"type":"object","properties":{},"description":"Get enhanced system health information"},"type":"custom"},"data_transform":{"name":"data_transform","metadata":{"name":"data_transform","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Data transform command for demonstrating advanced hooks.","description":"Data transform command for demonstrating advanced hooks.","params":{"data":{"name":"data","required":false,"type":"typing.Optional[typing.Dict[str, typing.Any]]","default":null},"transform_type":{"name":"transform_type","required":false,"type":"typing.Optional[str]","default":null},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"data_transform","params":{"kwargs":"..."},"description":"Call data_transform command with required parameters"},{"command":"data_transform","params":{"data":null,"transform_type":null,"kwargs":"..."},"description":"Call data_transform command with all parameters"}],"schema":{"type":"object","properties":{"data":{"type":"object","description":"Input data to transform"},"transform_type":{"type":"string","enum":["uppercase","lowercase","reverse","default"],"description":"Type of transformation to apply"}}},"result_schema":{"type":"object","properties":{"original_data":{"type":"object"},"transformed_data":{"type":"object"},"processing_info":{"type":"object"},"command_type":{"type":"string"}}},"result_class":"DataTransformResult"},"schema":{"type":"object","properties":{"data":{"type":"object","description":"Input data to transform"},"transform_type":{"type":"string","enum":["uppercase","lowercase","reverse","default"],"description":"Type of transformation to apply"}}},"type":"custom"},"intercept":{"name":"intercept","metadata":{"name":"intercept","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Intercept command for demonstrating hook interception.","description":"Intercept command for demonstrating hook interception.","params":{"action":{"name":"action","required":false,"type":"typing.Optional[str]","default":null},"bypass_flag":{"name":"bypass_flag","required":false,"type":"typing.Optional[int]","default":null},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"intercept","params":{"kwargs":"..."},"description":"Call intercept command with required parameters"},{"command":"intercept","params":{"action":null,"bypass_flag":null,"kwargs":"..."},"description":"Call intercept command with all parameters"}],"schema":{"type":"object","properties":{"action":{"type":"string","description":"Action to perform"},"bypass_flag":{"type":"integer","enum":[0,1],"description":"Flag to determine execution (0 = bypass, 1 = execute)"}}},"result_schema":{"type":"object","properties":{"message":{"type":"string"},"executed":{"type":"boolean"},"intercept_reason":{"type":"string"},"hook_data":{"type":"object"},"command_type":{"type":"string"}}},"result_class":"InterceptResult"},"schema":{"type":"object","properties":{"action":{"type":"string","description":"Action to perform"},"bypass_flag":{"type":"integer","enum":[0,1],"description":"Flag to determine execution (0 = bypass, 1 = execute)"}}},"type":"custom"},"manual_echo":{"name":"manual_echo","metadata":{"name":"manual_echo","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Manually registered echo command.","description":"Manually registered echo command.","params":{"message":{"name":"message","required":false,"type":"typing.Optional[str]","default":null},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"manual_echo","params":{"kwargs":"..."},"description":"Call manual_echo command with required parameters"},{"command":"manual_echo","params":{"message":null,"kwargs":"..."},"description":"Call manual_echo command with all parameters"}],"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message to echo","default":"Hello from manually registered command!"}}},"result_schema":{"type":"object","properties":{"message":{"type":"string"},"manually_registered":{"type":"boolean"},"command_type":{"type":"string"}}},"result_class":"ManualEchoResult"},"schema":{"type":"object","properties":{"message":{"type":"string","description":"Message to echo","default":"Hello from manually registered command!"}}},"type":"custom"},"config":{"name":"config","metadata":{"name":"config","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Command for managing service configuration.","description":"Command for managing service configuration.","params":{"operation":{"name":"operation","required":false,"type":"<class 'str'>","default":"get"},"path":{"name":"path","required":false,"type":"<class 'str'>","default":null},"value":{"name":"value","required":false,"type":"typing.Any","default":null}},"examples":[{"command":"config","description":"Call config command without parameters"},{"command":"config","params":{"operation":"get","path":null,"value":null},"description":"Call config command with all parameters"}],"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["get","set"],"default":"get","description":"Operation to perform (get or set)"},"path":{"type":"string","description":"Configuration path in dot notation (e.g. 'server.host')"},"value":{"description":"Value to set (required for 'set' operation)"}},"required":["operation"],"additionalProperties":false},"result_schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"message":{"type":"string"}},"required":["success"]},"result_class":"ConfigResult"},"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["get","set"],"default":"get","description":"Operation to perform (get or set)"},"path":{"type":"string","description":"Configuration path in dot notation (e.g. 'server.host')"},"value":{"description":"Value to set (required for 'set' operation)"}},"required":["operation"],"additionalProperties":false},"type":"built-in"},"reload":{"name":"reload","metadata":{"name":"reload","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Command for reloading configuration and rediscovering commands.","description":"Command for reloading configuration and rediscovering commands.\nUses the unified initialization logic.","params":{"params":{"name":"params","required":true}},"examples":[{"command":"reload","params":{"params":"..."},"description":"Call reload command with required parameters"}],"schema":{"type":"object","properties":{"config_path":{"type":"string","description":"Path to configuration file to reload","default":null}},"additionalProperties":false},"result_schema":{},"result_class":null},"schema":{"type":"object","properties":{"config_path":{"type":"string","description":"Path to configuration file to reload","default":null}},"additionalProperties":false},"type":"built-in"},"settings":{"name":"settings","metadata":{"name":"settings","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Command for managing framework settings.","description":"Command for managing framework settings.","params":{"params":{"name":"params","required":true}},"examples":[{"command":"settings","params":{"params":"..."},"description":"Call settings command with required parameters"}],"schema":{"type":"object","properties":{"operation":{"type":"string","description":"Operation to perform","enum":["get","set","get_all","reload"],"default":"get_all"},"key":{"type":"string","description":"Configuration key in dot notation (e.g., 'server.host', 'custom.feature_enabled')"},"value":{"description":"Configuration value to set (for 'set' operation)"}},"required":["operation"],"additionalProperties":false},"result_schema":{},"result_class":null},"schema":{"type":"object","properties":{"operation":{"type":"string","description":"Operation to perform","enum":["get","set","get_all","reload"],"default":"get_all"},"key":{"type":"string","description":"Configuration key in dot notation (e.g., 'server.host', 'custom.feature_enabled')"},"value":{"description":"Configuration value to set (for 'set' operation)"}},"required":["operation"],"additionalProperties":false},"type":"built-in"},"load":{"name":"load","metadata":{"name":"load","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Command that loads commands from local path or URL.","description":"Command that loads commands from local path or URL.\n\nThis command allows dynamic loading of command modules from either local file system\nor remote HTTP/HTTPS URLs. The command automatically detects whether the source\nis a local path or URL and handles the loading accordingly.\n\nFor local paths, the command loads Python modules ending with '_command.py'.\nFor URLs, the command downloads the Python code and loads it as a temporary module.\n\nThe loaded commands are registered in the command registry and become immediately\navailable for execution. Only commands that inherit from the base Command class\nand are properly structured will be loaded and registered.\n\nSecurity considerations:\n- Local paths are validated for existence and proper naming\n- URLs are downloaded with timeout protection\n- Temporary files are automatically cleaned up after loading\n- Only files ending with '_command.py' are accepted\n\nExamples:\n- Load from local file: \"./my_command.py\"\n- Load from URL: \"https://example.com/remote_command.py\"","params":{"source":{"name":"source","required":true,"type":"<class 'str'>"},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"load","params":{"source":"./custom_command.py"},"description":"Load a command from local file system"},{"command":"load","params":{"source":"https://raw.githubusercontent.com/user/repo/main/remote_command.py"},"description":"Load a command from GitHub raw content"},{"command":"load","params":{"source":"https://example.com/api/commands/test_command.py"},"description":"Load a command from remote API endpoint"}],"schema":{"type":"object","properties":{"source":{"type":"string","description":"Source path or URL to load command from (must end with '_command.py')","examples":["./my_command.py","https://example.com/remote_command.py"]}},"required":["source"]},"result_schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean"},"commands_loaded":{"type":"integer"},"loaded_commands":{"type":"array","items":{"type":"string"}},"source":{"type":"string"},"error":{"type":"string"}},"required":["success","commands_loaded","loaded_commands","source"]}},"required":["data"]},"result_class":"LoadResult"},"schema":{"type":"object","properties":{"source":{"type":"string","description":"Source path or URL to load command from (must end with '_command.py')","examples":["./my_command.py","https://example.com/remote_command.py"]}},"required":["source"]},"type":"built-in"},"unload":{"name":"unload","metadata":{"name":"unload","version":"0.1","plugin":"","descr":"","category":"","author":"","email":"","source_url":"","summary":"Command that unloads loaded commands from registry.","description":"Command that unloads loaded commands from registry.\n\nThis command allows removal of dynamically loaded commands from the command registry.\nOnly commands that were loaded via the 'load' command or from the commands directory\ncan be unloaded. Built-in commands and custom commands registered with higher priority\ncannot be unloaded using this command.\n\nWhen a command is unloaded:\n- The command class is removed from the loaded commands registry\n- Any command instances are also removed\n- The command becomes unavailable for execution\n- Built-in and custom commands with the same name remain unaffected\n\nThis is useful for:\n- Removing outdated or problematic commands\n- Managing memory usage by unloading unused commands\n- Testing different versions of commands\n- Cleaning up temporary commands loaded for testing\n\nNote: Unloading a command does not affect other commands and does not require\na system restart. The command can be reloaded later if needed.","params":{"command_name":{"name":"command_name","required":true,"type":"<class 'str'>"},"kwargs":{"name":"kwargs","required":true}},"examples":[{"command":"unload","params":{"command_name":"test_command"},"description":"Unload a previously loaded test command"},{"command":"unload","params":{"command_name":"remote_command"},"description":"Unload a command that was loaded from URL"},{"command":"unload","params":{"command_name":"custom_command"},"description":"Unload a custom command loaded from local file"}],"schema":{"type":"object","properties":{"command_name":{"type":"string","description":"Name of the command to unload (must be a loaded command)"}},"required":["command_name"]},"result_schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean"},"command_name":{"type":"string"},"error":{"type":"string"}},"required":["success","command_name"]}},"required":["data"]},"result_class":"UnloadResult"},"schema":{"type":"object","properties":{"command_name":{"type":"string","description":"Name of the command to unload (must be a loaded command)"}},"required":["command_name"]},"type":"built-in"},"plugins":{"name":"plugins","metadata":{"name":"plugins","summary":"Command that reads and displays available plugins from a plugins server","description":"\n    Command that reads and displays available plugins from a plugins server.\n    \n    This command fetches a JSON file from a configured plugins server URL that contains\n    a list of available plugins. Each plugin in the list typically contains metadata\n    such as name, description, URL, version, and author information.\n    \n    The plugins server URL is configured in the system configuration under\n    'commands.plugins_server'. The JSON file should contain an array of plugin objects\n    with the following structure:\n    \n    {\n        \"plugins\": [\n            {\n                \"name\": \"plugin_name\",\n                \"description\": \"Plugin description\",\n                \"url\": \"https://server.com/plugin.py\",\n                \"version\": \"1.0.0\",\n                \"author\": \"Author Name\"\n            }\n        ]\n    }\n    \n    This command is useful for:\n    - Discovering available plugins without manually browsing the server\n    - Getting metadata about plugins before loading them\n    - Building plugin management interfaces\n    - Checking plugin availability and versions\n    \n    The command will return the list of all available plugins along with their\n    metadata, making it easy to choose which plugins to load.\n    ","parameters":{},"examples":[{"command":"plugins","description":"Get list of available plugins from configured server"},{"command":"plugins","description":"Discover plugins without parameters"},{"command":"plugins","description":"Check plugin availability and metadata"}],"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"success":{"type":"boolean"},"plugins_server":{"type":"string"},"plugins":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"},"version":{"type":"string"},"author":{"type":"string"}}}},"total_plugins":{"type":"integer"},"error":{"type":"string"}},"required":["success","plugins_server","plugins","total_plugins"]}},"required":["data"]}},"schema":{"type":"object","properties":{},"additionalProperties":false},"type":"built-in"},"transport_management":{"name":"transport_management","metadata":{"name":"transport_management","version":"0.1","plugin":"","descr":"Manage and query transport configurations (HTTP, HTTPS, MTLS)","category":"","author":"","email":"","source_url":"","summary":"Transport management command.","description":"Transport management command.\n\nThis command provides functionality to manage and query transport configurations.","params":{"params":{"name":"params","required":true}},"examples":[{"command":"transport_management","params":{"params":"..."},"description":"Call transport_management command with required parameters"}],"schema":{"type":"object","properties":{"action":{"type":"string","enum":["get_info","validate","reload"],"description":"Action to perform"}},"required":["action"]},"result_schema":{},"result_class":null},"schema":{"type":"object","properties":{"action":{"type":"string","enum":["get_info","validate","reload"],"description":"Action to perform"}},"required":["action"]},"type":"built-in"},"proxy_registration":{"name":"proxy_registration","error":"ProxyRegistrationCommand.get_schema() missing 1 required positional argument: 'self'","type":"built-in"}},"total":14,"custom_help":true,"custom_features":{"enhanced":true,"total_commands":14,"custom_commands":["echo","help","health"],"request_id":null,"hook_processed":false}},"id":15}