empathy-framework 5.3.0__py3-none-any.whl → 5.4.0__py3-none-any.whl

empathy_llm_toolkit/agents_md/parser.py

@@ -1,271 +0,0 @@
-"""Markdown Agent Parser
-
-Parses Markdown files with YAML frontmatter into UnifiedAgentConfig.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import logging
-import re
-from pathlib import Path
-from typing import Any
-
-from empathy_llm_toolkit.config.unified import ModelTier, Provider, UnifiedAgentConfig
-
-logger = logging.getLogger(__name__)
-
-# YAML frontmatter regex pattern
-FRONTMATTER_PATTERN = re.compile(
-    r"^---\s*\n(.*?)\n---\s*\n",
-    re.DOTALL,
-)
-
-
-class MarkdownAgentParser:
-    """Parser for Markdown agent definition files.
-
-    Parses files with YAML frontmatter containing agent configuration,
-    followed by Markdown content that becomes the system prompt.
-
-    Example file format:
-        ---
-        name: architect
-        description: Software architecture specialist
-        model: capable
-        tools: Read, Grep, Glob
-        empathy_level: 4
-        ---
-
-        You are an expert software architect...
-
-    Example usage:
-        parser = MarkdownAgentParser()
-        config = parser.parse_file("agents/architect.md")
-    """
-
-    # Mapping from string model names to ModelTier
-    MODEL_TIER_MAP = {
-        "cheap": ModelTier.CHEAP,
-        "haiku": ModelTier.CHEAP,
-        "capable": ModelTier.CAPABLE,
-        "sonnet": ModelTier.CAPABLE,
-        "premium": ModelTier.PREMIUM,
-        "opus": ModelTier.PREMIUM,
-    }
-
-    # Mapping from string provider names to Provider
-    PROVIDER_MAP = {
-        "anthropic": Provider.ANTHROPIC,
-        "openai": Provider.OPENAI,
-        "local": Provider.LOCAL,
-    }
-
-    def __init__(self):
-        """Initialize the parser."""
-        pass
-
-    def parse_file(self, file_path: str | Path) -> UnifiedAgentConfig:
-        """Parse a Markdown agent file into UnifiedAgentConfig.
-
-        Args:
-            file_path: Path to the Markdown agent file
-
-        Returns:
-            UnifiedAgentConfig instance
-
-        Raises:
-            FileNotFoundError: If file doesn't exist
-            ValueError: If file format is invalid
-
-        """
-        file_path = Path(file_path)
-
-        if not file_path.exists():
-            raise FileNotFoundError(f"Agent file not found: {file_path}")
-
-        with open(file_path, encoding="utf-8") as f:
-            content = f.read()
-
-        return self.parse_content(content, source=str(file_path))
-
-    def parse_content(
-        self,
-        content: str,
-        source: str = "unknown",
-    ) -> UnifiedAgentConfig:
-        """Parse Markdown content into UnifiedAgentConfig.
-
-        Args:
-            content: Markdown content with YAML frontmatter
-            source: Source identifier for error messages
-
-        Returns:
-            UnifiedAgentConfig instance
-
-        Raises:
-            ValueError: If content format is invalid
-
-        """
-        # Extract frontmatter
-        match = FRONTMATTER_PATTERN.match(content)
-
-        if not match:
-            raise ValueError(f"Invalid agent file format - missing YAML frontmatter: {source}")
-
-        frontmatter_yaml = match.group(1)
-        body = content[match.end() :].strip()
-
-        # Parse YAML
-        try:
-            import yaml
-
-            frontmatter = yaml.safe_load(frontmatter_yaml) or {}
-        except yaml.YAMLError as e:
-            raise ValueError(f"Invalid YAML frontmatter in {source}: {e}")
-
-        return self._create_config(frontmatter, body, source)
-
-    def _create_config(
-        self,
-        frontmatter: dict[str, Any],
-        body: str,
-        source: str,
-    ) -> UnifiedAgentConfig:
-        """Create UnifiedAgentConfig from parsed data.
-
-        Args:
-            frontmatter: Parsed YAML frontmatter
-            body: Markdown body content
-            source: Source identifier
-
-        Returns:
-            UnifiedAgentConfig instance
-
-        """
-        # Required field
-        name = frontmatter.get("name")
-        if not name:
-            raise ValueError(f"Agent file missing required 'name' field: {source}")
-
-        # Parse model tier
-        model_str = frontmatter.get("model", "capable").lower()
-        model_tier = self.MODEL_TIER_MAP.get(model_str, ModelTier.CAPABLE)
-
-        # Parse provider
-        provider_str = frontmatter.get("provider", "anthropic").lower()
-        provider = self.PROVIDER_MAP.get(provider_str, Provider.ANTHROPIC)
-
-        # Parse tools list
-        tools_raw = frontmatter.get("tools", [])
-        if isinstance(tools_raw, str):
-            # Handle comma-separated string
-            tools = [t.strip() for t in tools_raw.split(",")]
-        else:
-            tools = list(tools_raw)
-
-        # Parse capabilities
-        capabilities = frontmatter.get("capabilities", [])
-        if isinstance(capabilities, str):
-            capabilities = [c.strip() for c in capabilities.split(",")]
-
-        # Build config
-        config = UnifiedAgentConfig(
-            name=name,
-            role=frontmatter.get("role", name),
-            description=frontmatter.get("description", ""),
-            model_tier=model_tier,
-            model_override=frontmatter.get("model_override"),
-            provider=provider,
-            empathy_level=int(frontmatter.get("empathy_level", 4)),
-            memory_enabled=frontmatter.get("memory_enabled", True),
-            pattern_learning=frontmatter.get("pattern_learning", True),
-            cost_tracking=frontmatter.get("cost_tracking", True),
-            use_patterns=frontmatter.get("use_patterns", True),
-            temperature=float(frontmatter.get("temperature", 0.7)),
-            max_tokens=int(frontmatter.get("max_tokens", 4096)),
-            timeout=int(frontmatter.get("timeout", 120)),
-            retry_attempts=int(frontmatter.get("retry_attempts", 3)),
-            retry_delay=float(frontmatter.get("retry_delay", 1.0)),
-            system_prompt=body if body else None,
-            tools=tools,
-            capabilities=capabilities,
-            framework_options=frontmatter.get("framework_options", {}),
-            extra={
-                "source_file": source,
-                "raw_frontmatter": frontmatter,
-                "interaction_mode": frontmatter.get("interaction_mode", "standard"),
-                "socratic_config": frontmatter.get("socratic_config", {}),
-            },
-        )
-
-        logger.debug("Parsed agent config: %s from %s", name, source)
-        return config
-
-    def validate_file(self, file_path: str | Path) -> list[str]:
-        """Validate a Markdown agent file without fully parsing.
-
-        Args:
-            file_path: Path to validate
-
-        Returns:
-            List of validation error messages (empty if valid)
-
-        """
-        errors = []
-        file_path = Path(file_path)
-
-        if not file_path.exists():
-            return [f"File not found: {file_path}"]
-
-        try:
-            with open(file_path, encoding="utf-8") as f:
-                content = f.read()
-        except OSError as e:
-            return [f"Cannot read file: {e}"]
-
-        # Check frontmatter
-        match = FRONTMATTER_PATTERN.match(content)
-        if not match:
-            errors.append("Missing YAML frontmatter (must start with ---)")
-            return errors
-
-        # Parse YAML
-        try:
-            import yaml
-
-            frontmatter = yaml.safe_load(match.group(1)) or {}
-        except yaml.YAMLError as e:
-            errors.append(f"Invalid YAML: {e}")
-            return errors
-
-        # Check required fields
-        if not frontmatter.get("name"):
-            errors.append("Missing required field: name")
-
-        # Validate model tier
-        model = frontmatter.get("model", "").lower()
-        if model and model not in self.MODEL_TIER_MAP:
-            errors.append(
-                f"Invalid model '{model}'. Valid options: {', '.join(self.MODEL_TIER_MAP.keys())}"
-            )
-
-        # Validate provider
-        provider = frontmatter.get("provider", "").lower()
-        if provider and provider not in self.PROVIDER_MAP:
-            errors.append(
-                f"Invalid provider '{provider}'. "
-                f"Valid options: {', '.join(self.PROVIDER_MAP.keys())}"
-            )
-
-        # Validate empathy level
-        empathy_level = frontmatter.get("empathy_level")
-        if empathy_level is not None:
-            try:
-                level = int(empathy_level)
-                if not 1 <= level <= 5:
-                    errors.append(f"empathy_level must be 1-5, got {level}")
-            except (TypeError, ValueError):
-                errors.append(f"empathy_level must be an integer, got {empathy_level}")
-
-        return errors

empathy_llm_toolkit/agents_md/registry.py

@@ -1,307 +0,0 @@
-"""Agent Registry
-
-Central registry for managing available agents.
-
-Copyright 2025 Smart-AI-Memory
-Licensed under Fair Source License 0.9
-"""
-
-import logging
-from collections.abc import Iterator
-from pathlib import Path
-from typing import Any
-
-from empathy_llm_toolkit.agents_md.loader import AgentLoader
-from empathy_llm_toolkit.config.unified import UnifiedAgentConfig
-
-logger = logging.getLogger(__name__)
-
-
-class AgentRegistry:
-    """Central registry for agent configurations.
-
-    Provides a single point of access for all available agents,
-    supporting both programmatic registration and directory loading.
-
-    Example:
-        # Create registry and load agents
-        registry = AgentRegistry()
-        registry.load_from_directory("agents/")
-
-        # Get an agent by name
-        architect = registry.get("architect")
-
-        # Register a custom agent
-        registry.register(my_custom_config)
-
-        # List all available agents
-        for name in registry.list_agents():
-            print(name)
-    """
-
-    _instance: "AgentRegistry | None" = None
-
-    def __init__(self):
-        """Initialize the registry."""
-        self._agents: dict[str, UnifiedAgentConfig] = {}
-        self._loader = AgentLoader()
-        self._load_paths: list[Path] = []
-
-    @classmethod
-    def get_instance(cls) -> "AgentRegistry":
-        """Get the singleton registry instance.
-
-        Returns:
-            The global AgentRegistry instance
-
-        """
-        if cls._instance is None:
-            cls._instance = cls()
-        return cls._instance
-
-    @classmethod
-    def reset_instance(cls) -> None:
-        """Reset the singleton instance (mainly for testing)."""
-        cls._instance = None
-
-    def register(
-        self,
-        config: UnifiedAgentConfig,
-        overwrite: bool = False,
-    ) -> None:
-        """Register an agent configuration.
-
-        Args:
-            config: Agent configuration to register
-            overwrite: If True, overwrite existing agent with same name
-
-        Raises:
-            ValueError: If agent name already exists and overwrite=False
-
-        """
-        if config.name in self._agents and not overwrite:
-            raise ValueError(
-                f"Agent '{config.name}' already registered. Use overwrite=True to replace."
-            )
-
-        self._agents[config.name] = config
-        logger.debug("Registered agent: %s", config.name)
-
-    def unregister(self, name: str) -> bool:
-        """Unregister an agent by name.
-
-        Args:
-            name: Agent name to remove
-
-        Returns:
-            True if agent was found and removed
-
-        """
-        if name in self._agents:
-            del self._agents[name]
-            logger.debug("Unregistered agent: %s", name)
-            return True
-        return False
-
-    def get(self, name: str) -> UnifiedAgentConfig | None:
-        """Get an agent configuration by name.
-
-        Args:
-            name: Agent name
-
-        Returns:
-            Agent config or None if not found
-
-        """
-        return self._agents.get(name)
-
-    def get_required(self, name: str) -> UnifiedAgentConfig:
-        """Get an agent configuration, raising if not found.
-
-        Args:
-            name: Agent name
-
-        Returns:
-            Agent configuration
-
-        Raises:
-            KeyError: If agent not found
-
-        """
-        config = self.get(name)
-        if config is None:
-            available = ", ".join(sorted(self._agents.keys()))
-            raise KeyError(f"Agent '{name}' not found. Available agents: {available}")
-        return config
-
-    def has(self, name: str) -> bool:
-        """Check if an agent is registered.
-
-        Args:
-            name: Agent name
-
-        Returns:
-            True if agent exists
-
-        """
-        return name in self._agents
-
-    def list_agents(self) -> list[str]:
-        """Get list of all registered agent names.
-
-        Returns:
-            Sorted list of agent names
-
-        """
-        return sorted(self._agents.keys())
-
-    def iter_agents(self) -> Iterator[UnifiedAgentConfig]:
-        """Iterate over all registered agents.
-
-        Yields:
-            Agent configurations
-
-        """
-        for name in sorted(self._agents.keys()):
-            yield self._agents[name]
-
-    def load_from_directory(
-        self,
-        directory: str | Path,
-        recursive: bool = False,
-        overwrite: bool = False,
-    ) -> int:
-        """Load agents from a directory.
-
-        Args:
-            directory: Directory containing .md agent files
-            recursive: If True, scan subdirectories
-            overwrite: If True, overwrite existing agents
-
-        Returns:
-            Number of agents loaded
-
-        """
-        directory = Path(directory)
-        self._load_paths.append(directory)
-
-        agents = self._loader.load_directory(directory, recursive=recursive)
-
-        loaded = 0
-        for _name, config in agents.items():
-            try:
-                self.register(config, overwrite=overwrite)
-                loaded += 1
-            except ValueError as e:
-                logger.warning("Skipping agent: %s", e)
-
-        logger.info("Loaded %d agent(s) from %s", loaded, directory)
-        return loaded
-
-    def load_from_file(
-        self,
-        file_path: str | Path,
-        overwrite: bool = False,
-    ) -> UnifiedAgentConfig:
-        """Load a single agent from a file.
-
-        Args:
-            file_path: Path to agent markdown file
-            overwrite: If True, overwrite existing agent
-
-        Returns:
-            Loaded agent configuration
-
-        """
-        config = self._loader.load(file_path)
-        self.register(config, overwrite=overwrite)
-        return config
-
-    def reload(self) -> int:
-        """Reload all agents from previously loaded directories.
-
-        Returns:
-            Total number of agents after reload
-
-        """
-        self._agents.clear()
-
-        for directory in self._load_paths:
-            if directory.exists():
-                self.load_from_directory(directory, overwrite=True)
-
-        return len(self._agents)
-
-    def get_by_role(self, role: str) -> list[UnifiedAgentConfig]:
-        """Get all agents with a specific role.
-
-        Args:
-            role: Role to filter by
-
-        Returns:
-            List of matching agent configs
-
-        """
-        role = role.lower()
-        return [config for config in self._agents.values() if config.role.lower() == role]
-
-    def get_by_empathy_level(
-        self,
-        min_level: int = 1,
-        max_level: int = 5,
-    ) -> list[UnifiedAgentConfig]:
-        """Get agents within an empathy level range.
-
-        Args:
-            min_level: Minimum empathy level (inclusive)
-            max_level: Maximum empathy level (inclusive)
-
-        Returns:
-            List of matching agent configs
-
-        """
-        return [
-            config
-            for config in self._agents.values()
-            if min_level <= config.empathy_level <= max_level
-        ]
-
-    def get_summary(self) -> dict[str, Any]:
-        """Get a summary of registered agents.
-
-        Returns:
-            Summary dictionary
-
-        """
-        by_role = {}
-        by_level = {}
-        by_tier = {}
-
-        for config in self._agents.values():
-            role = config.role
-            by_role[role] = by_role.get(role, 0) + 1
-
-            level = config.empathy_level
-            by_level[level] = by_level.get(level, 0) + 1
-
-            tier = (
-                config.model_tier.value
-                if hasattr(config.model_tier, "value")
-                else str(config.model_tier)
-            )
-            by_tier[tier] = by_tier.get(tier, 0) + 1
-
-        return {
-            "total_agents": len(self._agents),
-            "agent_names": self.list_agents(),
-            "by_role": by_role,
-            "by_empathy_level": by_level,
-            "by_model_tier": by_tier,
-            "load_paths": [str(p) for p in self._load_paths],
-        }
-
-    def clear(self) -> None:
-        """Clear all registered agents."""
-        self._agents.clear()
-        self._load_paths.clear()
-        logger.debug("Cleared agent registry")