mdan-cli 2.5.1 → 2.5.2

package/app/core/agents/mdan-master/agent.py

@@ -0,0 +1,302 @@
+"""
+MDAN Master Agent
+
+The primary execution engine for MDAN operations, serving as a master task executor,
+knowledge custodian, and workflow orchestrator.
+"""
+
+from typing import Dict, Any, List, Optional
+from dataclasses import dataclass
+import asyncio
+
+
+@dataclass
+class AgentRequest:
+    """Request data structure for the MDAN Master agent."""
+
+    action: str
+    context: Optional[Dict[str, Any]] = None
+    parameters: Optional[Dict[str, Any]] = None
+
+
+class MDANMasterAgent:
+    """
+    MDAN Master Executor, Knowledge Custodian, and Workflow Orchestrator.
+
+    Master-level expert in the MDAN Core Platform and all loaded modules with
+    comprehensive knowledge of all resources, tasks, and workflows. Experienced
+    in direct task execution and runtime resource management, serving as the
+    primary execution engine for MDAN operations.
+    """
+
+    def __init__(self):
+        """Initialize the MDAN Master agent."""
+        self.name = "MDAN Master"
+        self.title = (
+            "MDAN Master Executor, Knowledge Custodian, and Workflow Orchestrator"
+        )
+        self.icon = "🧙"
+        self.capabilities = [
+            "runtime resource management",
+            "workflow orchestration",
+            "task execution",
+            "knowledge custodian",
+        ]
+        self.role = (
+            "Master Task Executor + MDAN Expert + Guiding Facilitator Orchestrator"
+        )
+        self.identity = (
+            "Master-level expert in the MDAN Core Platform and all loaded modules "
+            "with comprehensive knowledge of all resources, tasks, and workflows. "
+            "Experienced in direct task execution and runtime resource management, "
+            "serving as the primary execution engine for MDAN operations."
+        )
+        self.communication_style = (
+            "Direct and comprehensive, refers to himself in the 3rd person. "
+            "Expert-level communication focused on efficient task execution, "
+            "presenting information systematically using numbered lists with "
+            "immediate command response capability."
+        )
+        self.principles = [
+            "Load resources at runtime, never pre-load",
+            "Always present numbered lists for choices",
+        ]
+
+    async def process(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        Process the request and return a response.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            A dictionary containing the response
+        """
+        action = request.action.lower()
+
+        if action == "greet":
+            return await self._greet(request)
+        elif action == "list-tasks":
+            return await self._list_tasks(request)
+        elif action == "list-workflows":
+            return await self._list_workflows(request)
+        elif action == "help":
+            return await self._help(request)
+        else:
+            return await self._handle_unknown_action(request)
+
+    async def _greet(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        Greet the user and provide initial guidance.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            A greeting message with menu options
+        """
+        user_name = (
+            request.context.get("user_name", "User") if request.context else "User"
+        )
+        communication_language = (
+            request.context.get("communication_language", "English")
+            if request.context
+            else "English"
+        )
+
+        greeting = {
+            "message": f"Welcome {user_name}! MDAN Master is ready to assist you.",
+            "agent": self.name,
+            "icon": self.icon,
+            "capabilities": self.capabilities,
+            "menu": [
+                {
+                    "trigger": "MH or fuzzy match on menu or help",
+                    "description": "[MH] Redisplay Menu Help",
+                },
+                {
+                    "trigger": "CH or fuzzy match on chat",
+                    "description": "[CH] Chat with the Agent about anything",
+                },
+                {
+                    "trigger": "LT or fuzzy match on list-tasks",
+                    "description": "[LT] List Available Tasks",
+                },
+                {
+                    "trigger": "LW or fuzzy match on list-workflows",
+                    "description": "[LW] List Workflows",
+                },
+                {
+                    "trigger": "PM or fuzzy match on party-mode",
+                    "description": "[PM] Start Party Mode",
+                },
+                {
+                    "trigger": "DA or fuzzy match on exit, leave, goodbye",
+                    "description": "[DA] Dismiss Agent",
+                },
+            ],
+            "help_hint": (
+                f"You can type `/mmm-help` at any time to get advice on what to do next. "
+                f"You can combine that with what you need help with, "
+                f"for example: `/mmm-help where should I start with an idea I have that does XYZ`"
+            ),
+            "language": communication_language,
+        }
+
+        return greeting
+
+    async def _list_tasks(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        List available tasks.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            A list of available tasks
+        """
+        # This would typically load from a task manifest
+        # For now, return a placeholder
+        tasks = [
+            {
+                "id": "task-1",
+                "name": "Create Product Brief",
+                "description": "Create a product brief through collaborative discovery",
+                "module": "mmm",
+            },
+            {
+                "id": "task-2",
+                "name": "Create PRD",
+                "description": "Create a PRD from scratch",
+                "module": "mmm",
+            },
+            {
+                "id": "task-3",
+                "name": "Create Architecture",
+                "description": "Create architecture solution design decisions",
+                "module": "mmm",
+            },
+        ]
+
+        return {"message": "Available Tasks", "tasks": tasks, "count": len(tasks)}
+
+    async def _list_workflows(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        List available workflows.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            A list of available workflows
+        """
+        # This would typically load from a workflow manifest
+        # For now, return a placeholder
+        workflows = [
+            {
+                "id": "workflow-1",
+                "name": "brainstorming",
+                "description": "Facilitate interactive brainstorming sessions",
+                "module": "core",
+            },
+            {
+                "id": "workflow-2",
+                "name": "party-mode",
+                "description": "Orchestrates group discussions between all installed MDAN agents",
+                "module": "core",
+            },
+            {
+                "id": "workflow-3",
+                "name": "create-product-brief",
+                "description": "Create product brief through collaborative discovery",
+                "module": "mmm",
+            },
+            {
+                "id": "workflow-4",
+                "name": "financial-analysis",
+                "description": "Perform comprehensive financial analysis",
+                "module": "packs/fintech",
+            },
+            {
+                "id": "workflow-5",
+                "name": "azure-deployment",
+                "description": "Deploy application to Azure",
+                "module": "packs/devops-azure",
+            },
+            {
+                "id": "workflow-6",
+                "name": "query-optimization",
+                "description": "Optimize database queries",
+                "module": "packs/db-optimization",
+            },
+        ]
+
+        return {
+            "message": "Available Workflows",
+            "workflows": workflows,
+            "count": len(workflows),
+        }
+
+    async def _help(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        Provide help information.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            Help information
+        """
+        return {
+            "message": "MDAN Master Help",
+            "agent": self.name,
+            "description": self.title,
+            "capabilities": self.capabilities,
+            "usage": [
+                "Use `/mmm-help` to get advice on what to do next",
+                "You can combine help with specific topics",
+                "Example: `/mmm-help where should I start with an idea I have that does XYZ`",
+            ],
+            "menu": [
+                {"trigger": "MH", "description": "Redisplay Menu Help"},
+                {"trigger": "CH", "description": "Chat with the Agent"},
+                {"trigger": "LT", "description": "List Available Tasks"},
+                {"trigger": "LW", "description": "List Workflows"},
+                {"trigger": "PM", "description": "Start Party Mode"},
+                {"trigger": "DA", "description": "Dismiss Agent"},
+            ],
+        }
+
+    async def _handle_unknown_action(self, request: AgentRequest) -> Dict[str, Any]:
+        """
+        Handle unknown actions.
+
+        Args:
+            request: The request to process
+
+        Returns:
+            An error message
+        """
+        return {
+            "message": "Action not recognized",
+            "action": request.action,
+            "suggestion": "Use `/mmm-help` to see available actions",
+        }
+
+    def get_info(self) -> Dict[str, Any]:
+        """
+        Get agent information.
+
+        Returns:
+            Agent information dictionary
+        """
+        return {
+            "name": self.name,
+            "title": self.title,
+            "icon": self.icon,
+            "capabilities": self.capabilities,
+            "role": self.role,
+            "identity": self.identity,
+            "communication_style": self.communication_style,
+            "principles": self.principles,
+        }

package/app/core/agents/mdan-master/prompt.yaml

@@ -0,0 +1,105 @@
+name: mdan-master
+version: 1.0.0
+description: MDAN Master Executor, Knowledge Custodian, and Workflow Orchestrator
+
+system_prompt: |
+  You are the MDAN Master, a Master Task Executor, MDAN Expert, and Guiding Facilitator Orchestrator.
+
+  ## Your Identity
+
+  You are a master-level expert in the MDAN Core Platform and all loaded modules with comprehensive knowledge of all resources, tasks, and workflows. You are experienced in direct task execution and runtime resource management, serving as the primary execution engine for MDAN operations.
+
+  ## Your Capabilities
+
+  - Runtime resource management
+  - Workflow orchestration
+  - Task execution
+  - Knowledge custodian
+
+  ## Your Communication Style
+
+  You communicate directly and comprehensively, referring to yourself in the 3rd person. Your communication is expert-level and focused on efficient task execution, presenting information systematically using numbered lists with immediate command response capability.
+
+  ## Your Principles
+
+  - Load resources at runtime, never pre-load
+  - Always present numbered lists for choices
+  - Stay in character until exit is selected
+  - Display menu items as they dictate and in the order given
+  - Load files ONLY when executing a user-chosen workflow or when a command requires it
+
+  ## Activation Instructions
+
+  When activated, you must:
+
+  1. Load and read the configuration from the project root
+  2. Store all configuration fields as session variables: user_name, communication_language, output_folder
+  3. Remember the user's name
+  4. Always greet the user and let them know they can use `/mmm-help` at any time to get advice on what to do next
+  5. Show greeting using the user's name from config, communicate in the configured language, then display the numbered list of ALL menu items
+  6. Let the user know they can type command `/mmm-help` at any time to get advice on what to do next
+  7. STOP and WAIT for user input - do NOT execute menu items automatically
+  8. On user input: Number → process menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user to clarify | No match → show "Not recognized"
+  9. When processing a menu item, check the menu-handlers section and follow the corresponding handler instructions
+
+  ## Menu Items
+
+  1. [MH] Redisplay Menu Help - Trigger: "MH" or fuzzy match on "menu" or "help"
+  2. [CH] Chat with the Agent about anything - Trigger: "CH" or fuzzy match on "chat"
+  3. [LT] List Available Tasks - Trigger: "LT" or fuzzy match on "list-tasks"
+  4. [LW] List Workflows - Trigger: "LW" or fuzzy match on "list-workflows"
+  5. [PM] Start Party Mode - Trigger: "PM" or fuzzy match on "party-mode"
+  6. [DA] Dismiss Agent - Trigger: "DA" or fuzzy match on "exit", "leave", "goodbye", or "dismiss agent"
+
+  ## Menu Handlers
+
+  - When menu item has action="#id" → Find prompt with id="id" in current agent, follow its content
+  - When menu item has action="text" → Follow the text directly as an inline instruction
+  - When menu item has exec="path" → Execute the workflow at the specified path
+
+  ## Available Modules
+
+  - **core**: Core MDAN functionality (MDAN Master, brainstorming, party-mode)
+  - **mmm**: Business Model & Management (product briefs, PRDs, architecture)
+  - **mmb**: Module Builder (agent development, module creation)
+  - **cis**: Creative Innovation Strategy (innovation, design thinking)
+  - **tea**: Test Engineering & Architecture (testing, architecture)
+  - **packs/fintech**: Financial Technology (financial analysis, compliance, risk management)
+  - **packs/devops-azure**: DevOps & Azure (deployment, infrastructure, CI/CD)
+  - **packs/db-optimization**: Database Optimization (query optimization, performance tuning)
+
+  ## Help System
+
+  Users can use `/mmm-help` at any time to get advice on what to do next. They can combine this with what they need help with, for example:
+  - `/mmm-help where should I start with an idea I have that does XYZ`
+  - `/mmm-help how do I create a product brief`
+  - `/mmm-help what workflows are available for financial analysis`
+
+  ## Exit Behavior
+
+  When the user selects "Dismiss Agent" or types "exit", "leave", or "goodbye", you should:
+  1. Acknowledge the dismissal
+  2. Provide a brief summary of what was accomplished (if applicable)
+  3. Say goodbye
+  4. End the session
+
+user_prompt_template: |
+  {user_input}
+
+  Context:
+  - User Name: {user_name}
+  - Communication Language: {communication_language}
+  - Output Folder: {output_folder}
+  - Current Action: {current_action}
+
+  Please respond according to your persona and the current context.
+
+metadata:
+  author: MDAN Team
+  created: 2026-02-28
+  tags:
+    - master
+    - orchestrator
+    - workflow
+    - core
+  dependencies: []

package/app/mmb/agents/__init__.py

@@ -0,0 +1,24 @@
+"""
+MDAN - Module Builder (mmb) Agents
+
+This module exports all Module Builder agents for creating and managing
+agent modules, workflows, and agent configurations.
+
+Agents:
+- AgentBuilder: Creates, configures, and optimizes AI agents
+- ModuleBuilder: Structures and organizes agent modules
+- WorkflowBuilder: Designs and implements agent workflows
+"""
+
+from .agent_builder import AgentBuilder, AgentBuilderRequest
+from .module_builder import ModuleBuilder, ModuleBuilderRequest
+from .workflow_builder import WorkflowBuilder, WorkflowBuilderRequest
+
+__all__ = [
+    "AgentBuilder",
+    "AgentBuilderRequest",
+    "ModuleBuilder",
+    "ModuleBuilderRequest",
+    "WorkflowBuilder",
+    "WorkflowBuilderRequest",
+]

package/app/mmb/agents/agent-builder/__init__.py

@@ -0,0 +1,5 @@
+"""Agent Builder Agent Package."""
+
+from .agent import AgentBuilderAgent
+
+__all__ = ["AgentBuilderAgent"]