claude-mpm 4.20.3__py3-none-any.whl → 4.25.10__py3-none-any.whl

claude_mpm/schemas/frontmatter_schema.json

@@ -0,0 +1,165 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0.0",
+  "title": "Agent Frontmatter Schema",
+  "description": "Schema for validating agent file frontmatter in .md, .claude, and .claude-mpm files",
+  "type": "object",
+  "required": [
+    "name",
+    "description",
+    "version",
+    "model"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_-]*$",
+      "minLength": 1,
+      "maxLength": 50,
+      "description": "Agent identifier (kebab-case or snake_case)"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 200,
+      "description": "Brief description of agent purpose"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g., 1.0.0)"
+    },
+    "base_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Base agent version this extends"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Author name or organization"
+    },
+    "tools": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "Read",
+          "Write",
+          "Edit",
+          "MultiEdit",
+          "Grep",
+          "Glob",
+          "LS",
+          "Bash",
+          "WebSearch",
+          "WebFetch",
+          "NotebookRead",
+          "NotebookEdit",
+          "TodoWrite",
+          "ExitPlanMode",
+          "git",
+          "docker",
+          "kubectl",
+          "terraform",
+          "aws",
+          "gcloud",
+          "azure"
+        ]
+      },
+      "uniqueItems": true,
+      "description": "List of available tools for the agent"
+    },
+    "model": {
+      "type": "string",
+      "enum": ["opus", "sonnet", "haiku"],
+      "description": "Claude model tier to use"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*$"
+      },
+      "uniqueItems": true,
+      "description": "Tags for categorization"
+    },
+    "category": {
+      "type": "string",
+      "enum": ["engineering", "research", "quality", "operations", "specialized"],
+      "description": "Agent category"
+    },
+    "max_tokens": {
+      "type": "integer",
+      "minimum": 1000,
+      "maximum": 200000,
+      "default": 8192,
+      "description": "Maximum tokens for response"
+    },
+    "temperature": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "default": 0.7,
+      "description": "Model temperature setting"
+    },
+    "resource_tier": {
+      "type": "string",
+      "enum": ["basic", "standard", "intensive", "lightweight"],
+      "description": "Resource allocation tier"
+    },
+    "dependencies": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Other agents this agent depends on"
+    },
+    "capabilities": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of agent capabilities"
+    }
+  },
+  "additionalProperties": true,
+  "definitions": {
+    "model_mappings": {
+      "description": "Mappings for model normalization",
+      "mappings": {
+        "claude-3-5-sonnet-20241022": "sonnet",
+        "claude-3-5-sonnet-20240620": "sonnet",
+        "claude-sonnet-4-20250514": "sonnet",
+        "claude-4-sonnet-20250514": "sonnet",
+        "claude-3-sonnet-20240229": "sonnet",
+        "20241022": "sonnet",
+        "claude-3-opus-20240229": "opus",
+        "claude-opus-4-20250514": "opus",
+        "claude-4-opus-20250514": "opus",
+        "claude-3-haiku-20240307": "haiku",
+        "claude-3-5-haiku-20241022": "haiku"
+      }
+    },
+    "tool_corrections": {
+      "description": "Common tool name corrections",
+      "mappings": {
+        "read": "Read",
+        "write": "Write",
+        "edit": "Edit",
+        "multiedit": "MultiEdit",
+        "grep": "Grep",
+        "glob": "Glob",
+        "ls": "LS",
+        "bash": "Bash",
+        "websearch": "WebSearch",
+        "webfetch": "WebFetch",
+        "notebookread": "NotebookRead",
+        "notebookedit": "NotebookEdit",
+        "todowrite": "TodoWrite",
+        "exitplanmode": "ExitPlanMode"
+      }
+    }
+  }
+}

claude_mpm/scripts/claude-hook-handler.sh

@@ -89,7 +89,7 @@ fi
 # STRATEGY:
 # This function implements a fallback chain to find Python with claude-mpm dependencies:
 # 1. Project-specific virtual environments (venv, .venv)
-# 2. Currently active virtual environment ($VIRTUAL_ENV)  
+# 2. Currently active virtual environment ($VIRTUAL_ENV)
 # 3. System python3 (may lack dependencies)
 # 4. System python (last resort)
 #
@@ -121,7 +121,7 @@ find_python_command() {
             return
         fi
     fi
-    
+
     # 2. Check for project-local virtual environment (common in development)
     if [ -f "$CLAUDE_MPM_ROOT/venv/bin/activate" ]; then
         source "$CLAUDE_MPM_ROOT/venv/bin/activate"
@@ -152,7 +152,7 @@ if [[ "$SCRIPT_DIR" == *"/.local/pipx/venvs/claude-mpm/"* ]]; then
 elif [ -d "$CLAUDE_MPM_ROOT/src" ]; then
     # Development install - add src to PYTHONPATH
     export PYTHONPATH="$CLAUDE_MPM_ROOT/src:$PYTHONPATH"
-    
+
     if [ "${CLAUDE_MPM_HOOK_DEBUG}" = "true" ]; then
         echo "[$(date -u +%Y-%m-%dT%H:%M:%S.%3NZ)] Development environment detected" >> /tmp/claude-mpm-hook.log
     fi

claude_mpm/scripts/start_activity_logging.py

@@ -51,7 +51,9 @@ if __name__ == "__main__":
 
     # Initialize aggregator
     aggregator = EventAggregator(
-        host="localhost", port=dashboard_port, save_dir=None  # Will use config value
+        host="localhost",
+        port=dashboard_port,
+        save_dir=None,  # Will use config value
     )
 
     # Set up signal handlers

claude_mpm/services/agents/deployment/agent_format_converter.py

@@ -166,7 +166,7 @@ class AgentFormatConverter:
 
 <example>
 Context: When you need specialized assistance from the {name} agent.
-user: "I need help with {agent_name.replace('_', ' ').replace('-', ' ')} tasks"
+user: "I need help with {agent_name.replace("_", " ").replace("-", " ")} tasks"
 assistant: "I'll use the {name} agent to provide specialized assistance."
 </example>"""
 

claude_mpm/services/agents/deployment/agent_metrics_collector.py

@@ -176,9 +176,9 @@ class AgentMetricsCollector:
             agent_name: Name of the agent being validated
             validation_time_ms: Validation time in milliseconds
         """
-        self._deployment_metrics["template_validation_times"][
-            agent_name
-        ] = validation_time_ms
+        self._deployment_metrics["template_validation_times"][agent_name] = (
+            validation_time_ms
+        )
 
     def get_performance_summary(self) -> Dict[str, Any]:
         """

claude_mpm/services/agents/deployment/facade/deployment_facade.py

@@ -89,9 +89,9 @@ class DeploymentFacade:
 
             results["metadata"]["facade_version"] = "1.0.0"
             results["metadata"]["selected_executor"] = executor.get_executor_name()
-            results["metadata"][
-                "executor_characteristics"
-            ] = executor.get_performance_characteristics()
+            results["metadata"]["executor_characteristics"] = (
+                executor.get_performance_characteristics()
+            )
 
             return results
 

claude_mpm/services/agents/deployment/pipeline/pipeline_executor.py

@@ -51,11 +51,11 @@ class DeploymentPipelineExecutor:
             try:
                 # Check if step should be executed
                 if not step.should_execute(context):
-                    self.logger.info(f"Skipping step {i+1}/{len(steps)}: {step.name}")
+                    self.logger.info(f"Skipping step {i + 1}/{len(steps)}: {step.name}")
                     skipped_steps.append(step.name)
                     continue
 
-                self.logger.info(f"Executing step {i+1}/{len(steps)}: {step.name}")
+                self.logger.info(f"Executing step {i + 1}/{len(steps)}: {step.name}")
 
                 # Execute the step
                 result = step.execute(context)

claude_mpm/services/agents/loading/framework_agent_loader.py

@@ -404,8 +404,8 @@ class FrameworkAgentLoader:
 **{agent_type} Agent Profile Loaded**
 
 **Agent Identity**: {agent_type} Agent
-**Profile Source**: {profile.get('source_path', 'Unknown')}
-**Primary Role**: {profile.get('role', 'Not specified')}
+**Profile Source**: {profile.get("source_path", "Unknown")}
+**Primary Role**: {profile.get("role", "Not specified")}
 
 **Core Capabilities**:
 """
@@ -415,9 +415,9 @@ class FrameworkAgentLoader:
 
         instruction += f"""
 **Context Preferences**:
-- **Include**: {profile.get('context_preferences', {}).get('include', 'Not specified')}
-- **Exclude**: {profile.get('context_preferences', {}).get('exclude', 'Not specified')}
-- **Focus**: {profile.get('context_preferences', {}).get('focus', 'Not specified')}
+- **Include**: {profile.get("context_preferences", {}).get("include", "Not specified")}
+- **Exclude**: {profile.get("context_preferences", {}).get("exclude", "Not specified")}
+- **Focus**: {profile.get("context_preferences", {}).get("focus", "Not specified")}
 
 **Authority Scope**:
 """
@@ -426,9 +426,9 @@ class FrameworkAgentLoader:
             instruction += f"- **{authority}**: Authorized operation area\n"
 
         instruction += f"""
-**Quality Standards**: {len(profile.get('quality_standards', []))} standards defined
-**Escalation Triggers**: {len(profile.get('escalation_criteria', []))} criteria defined
-**Integration Partners**: {len(profile.get('integration_patterns', {}))} agent coordination patterns
+**Quality Standards**: {len(profile.get("quality_standards", []))} standards defined
+**Escalation Triggers**: {len(profile.get("escalation_criteria", []))} criteria defined
+**Integration Partners**: {len(profile.get("integration_patterns", {}))} agent coordination patterns
 
 Please operate according to your profile specifications and maintain quality standards.
 """

claude_mpm/services/agents/local_template_manager.py

@@ -270,7 +270,9 @@ class LocalAgentTemplateManager:
                 "tools": (
                     tools
                     if isinstance(tools, str)
-                    else ",".join(tools) if tools else "*"
+                    else ",".join(tools)
+                    if tools
+                    else "*"
                 ),
             },
             instructions=instructions,