@defai.digital/automatosx 5.0.13 → 5.1.2

package/examples/claude/mcp/automatosx.json

@@ -0,0 +1,244 @@
+{
+  "mcpServers": {
+    "automatosx": {
+      "command": "automatosx",
+      "args": ["mcp"],
+      "description": "AutomatosX AI Agent Orchestration Platform with persistent memory and multi-agent coordination",
+      "tools": [
+        {
+          "name": "run_agent",
+          "description": "Execute an AutomatosX agent with a specific task",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "agent": {
+                "type": "string",
+                "description": "The name of the agent to run (e.g., backend, Paris, Bob)"
+              },
+              "task": {
+                "type": "string",
+                "description": "The task for the agent to perform"
+              },
+              "provider": {
+                "type": "string",
+                "description": "Optional: Override the AI provider",
+                "enum": ["claude", "gemini", "openai"]
+              },
+              "no_memory": {
+                "type": "boolean",
+                "description": "Optional: Skip memory injection",
+                "default": false
+              }
+            },
+            "required": ["agent", "task"]
+          }
+        },
+        {
+          "name": "list_agents",
+          "description": "List all available AutomatosX agents",
+          "inputSchema": {
+            "type": "object",
+            "properties": {}
+          }
+        },
+        {
+          "name": "search_memory",
+          "description": "Search AutomatosX memory for relevant information",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "query": {
+                "type": "string",
+                "description": "Search query"
+              },
+              "limit": {
+                "type": "number",
+                "description": "Maximum number of results",
+                "default": 10
+              }
+            },
+            "required": ["query"]
+          }
+        },
+        {
+          "name": "get_status",
+          "description": "Get AutomatosX system status and configuration",
+          "inputSchema": {
+            "type": "object",
+            "properties": {}
+          }
+        },
+        {
+          "name": "session_create",
+          "description": "Create a new multi-agent session",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Session name/task description"
+              },
+              "agent": {
+                "type": "string",
+                "description": "Initiating agent name"
+              }
+            },
+            "required": ["name", "agent"]
+          }
+        },
+        {
+          "name": "session_list",
+          "description": "List all active sessions",
+          "inputSchema": {
+            "type": "object",
+            "properties": {}
+          }
+        },
+        {
+          "name": "session_status",
+          "description": "Get detailed status of a specific session",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Session ID"
+              }
+            },
+            "required": ["id"]
+          }
+        },
+        {
+          "name": "session_complete",
+          "description": "Mark a session as completed",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Session ID"
+              }
+            },
+            "required": ["id"]
+          }
+        },
+        {
+          "name": "session_fail",
+          "description": "Mark a session as failed with an error reason",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Session ID"
+              },
+              "reason": {
+                "type": "string",
+                "description": "Failure reason"
+              }
+            },
+            "required": ["id", "reason"]
+          }
+        },
+        {
+          "name": "memory_add",
+          "description": "Add a new memory entry to the system",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "content": {
+                "type": "string",
+                "description": "Memory content"
+              },
+              "metadata": {
+                "type": "object",
+                "description": "Optional metadata (agent, timestamp, etc.)",
+                "properties": {
+                  "agent": { "type": "string" },
+                  "timestamp": { "type": "string" }
+                }
+              }
+            },
+            "required": ["content"]
+          }
+        },
+        {
+          "name": "memory_list",
+          "description": "List memory entries with optional filtering",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "agent": {
+                "type": "string",
+                "description": "Filter by agent name"
+              },
+              "limit": {
+                "type": "number",
+                "description": "Maximum number of entries",
+                "default": 50
+              }
+            }
+          }
+        },
+        {
+          "name": "memory_delete",
+          "description": "Delete a specific memory entry by ID",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "number",
+                "description": "Memory entry ID"
+              }
+            },
+            "required": ["id"]
+          }
+        },
+        {
+          "name": "memory_export",
+          "description": "Export all memory entries to a JSON file",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Export file path (relative to .automatosx/memory/exports/)"
+              }
+            },
+            "required": ["path"]
+          }
+        },
+        {
+          "name": "memory_import",
+          "description": "Import memory entries from a JSON file",
+          "inputSchema": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string",
+                "description": "Import file path"
+              }
+            },
+            "required": ["path"]
+          }
+        },
+        {
+          "name": "memory_stats",
+          "description": "Get detailed memory statistics",
+          "inputSchema": {
+            "type": "object",
+            "properties": {}
+          }
+        },
+        {
+          "name": "memory_clear",
+          "description": "Clear all memory entries from the database",
+          "inputSchema": {
+            "type": "object",
+            "properties": {}
+          }
+        }
+      ]
+    }
+  }
+}

package/examples/teams/business.yaml

@@ -0,0 +1,56 @@
+# Business & Product Team Configuration
+# Executive leadership and product management
+
+name: business
+displayName: "Business & Product"
+description: "Executive leadership and product management"
+
+# Provider Configuration
+provider:
+  primary: claude
+  fallback: codex
+  fallbackChain:
+    - claude
+    - codex
+    - gemini
+
+# Shared Abilities
+sharedAbilities:
+  - business-analysis
+  - product-strategy
+  - stakeholder-management
+
+# Team Capabilities (v4.11.0 - Self-assessment for intelligent delegation)
+capabilities:
+  canDo:
+    - Business strategy and planning
+    - Product roadmap development
+    - Stakeholder management
+    - Market analysis and research
+    - Technology strategy
+    - Organizational leadership
+    - Business case development
+    - Executive decision-making
+
+  shouldDelegate:
+    - Code implementation → coder (engineering team)
+    - Technical architecture → cto (engineering team) or backend (engineering team)
+    - UX/UI design → design (design team)
+    - Documentation writing → writer (design team)
+    - Code review → reviewer (core team)
+    - Security audits → security (core team)
+
+# Orchestration Defaults
+orchestration:
+  maxDelegationDepth: 2  # v4.11.0: Reduced from 4 to 2
+  canWriteToShared: true
+  canReadWorkspaces:
+    - ceo
+    - cto
+
+# Metadata
+metadata:
+  color: "#8B5CF6"
+  icon: "💼"
+  priority: 3
+version: "1.0.0"

package/examples/teams/core.yaml

@@ -0,0 +1,59 @@
+# Core Team Configuration
+# General-purpose assistants and quality assurance
+
+name: core
+displayName: "Core Team"
+description: "General-purpose assistants and quality assurance"
+
+# Provider Configuration
+provider:
+  primary: claude
+  fallback: gemini
+  fallbackChain:
+    - claude
+    - gemini
+    - codex
+
+# Shared Abilities
+sharedAbilities:
+  - general-knowledge
+  - our-code-review-checklist
+  - testing
+  - documentation
+
+# Team Capabilities (v4.11.0 - Self-assessment for intelligent delegation)
+capabilities:
+  canDo:
+    - General knowledge and assistance
+    - Code review and quality assurance
+    - Testing strategy and QA planning
+    - Security audits and vulnerability assessment
+    - Debugging and error analysis
+    - Performance analysis
+    - Best practices recommendations
+    - Quality metrics and reporting
+
+  shouldDelegate:
+    - Code implementation → coder (engineering team)
+    - Backend development → backend (engineering team)
+    - Frontend development → frontend (engineering team)
+    - Documentation writing → writer (design team)
+    - Product strategy → product (design team)
+    - UX/UI design → design (design team)
+
+# Orchestration Defaults
+orchestration:
+  maxDelegationDepth: 2  # v4.11.0: Enforced limit
+  canWriteToShared: true
+  canReadWorkspaces:
+    - assistant
+    - debugger
+    - reviewer
+    - quality
+
+# Metadata
+metadata:
+  color: "#10B981"
+  icon: "🛠️"
+  priority: 2
+version: "1.0.0"

package/examples/teams/design.yaml

@@ -0,0 +1,58 @@
+# Design Team Configuration
+# UX/UI design and technical writing
+
+name: design
+displayName: "Design Team"
+description: "UX/UI design and technical writing"
+
+# Provider Configuration
+provider:
+  primary: gemini
+  fallback: claude
+  fallbackChain:
+    - gemini
+    - claude
+    - codex
+
+# Shared Abilities
+sharedAbilities:
+  - design-principles
+  - documentation
+  - user-research
+
+# Team Capabilities (v4.11.0 - Self-assessment for intelligent delegation)
+capabilities:
+  canDo:
+    - UX/UI design and prototyping
+    - User research and testing
+    - Visual design and branding
+    - Technical writing and documentation
+    - README and user guide writing
+    - Content creation and editing
+    - Documentation quality assessment
+    - Design system development
+    - Accessibility and usability review
+
+  shouldDelegate:
+    - Code implementation → coder (engineering team)
+    - Backend development → backend (engineering team)
+    - Frontend implementation → frontend (engineering team)
+    - Security audits → security (core team)
+    - Testing automation → quality (core team)
+    - Product strategy → product (design team)
+
+# Orchestration Defaults
+orchestration:
+  maxDelegationDepth: 2  # v4.11.0: Enforced limit
+  canWriteToShared: true
+  canReadWorkspaces:
+    - design
+    - writer
+    - product
+
+# Metadata
+metadata:
+  color: "#EC4899"
+  icon: "🎨"
+  priority: 4
+version: "1.0.0"

package/examples/teams/engineering.yaml

@@ -0,0 +1,69 @@
+# Engineering Team Configuration
+# Software engineers, data engineers, and infrastructure specialists
+
+name: engineering
+displayName: "Engineering Team"
+description: "Software engineers, data engineers, and infrastructure specialists"
+
+# Provider Configuration
+provider:
+  primary: codex
+  fallback: gemini
+  fallbackChain:
+    - codex
+    - gemini
+    - claude
+
+# Shared Abilities (all team members inherit these)
+sharedAbilities:
+  - our-coding-standards
+  - our-project-structure
+  - our-architecture-decisions
+  - code-generation
+  - refactoring
+  - testing
+
+# Team Capabilities (v4.11.0 - Self-assessment for intelligent delegation)
+capabilities:
+  canDo:
+    - Code implementation (TypeScript, Python, Go, Rust, etc.)
+    - Test-driven development (TDD)
+    - API design and implementation
+    - Bug fixing and debugging
+    - Performance optimization
+    - Architecture design
+    - Code refactoring
+    - Database design and optimization
+    - Infrastructure and DevOps automation
+    - CI/CD pipeline management
+
+  shouldDelegate:
+    - Documentation writing and review → writer (design team)
+    - User-facing content creation → writer (design team)
+    - README quality assessment → writer (design team)
+    - Product strategy and planning → product (design team)
+    - Business analysis → ceo (business team)
+    - Security audits (when specialized review needed) → security (core team)
+    - QA strategy and testing (when specialized review needed) → quality (core team)
+    - Code review (when independent review needed) → reviewer (core team)
+
+# Orchestration Defaults
+orchestration:
+  maxDelegationDepth: 2  # v4.11.0: Reduced from 3 to 2
+  canWriteToShared: true
+  canReadWorkspaces:
+    - backend
+    - frontend
+    - devops
+    - data
+    - data-pipeline
+    - security
+    - coder
+    - coder-lean
+
+# Metadata
+metadata:
+  color: "#3B82F6"
+  icon: "⚙️"
+  priority: 1
+version: "1.0.0"

package/examples/teams/research.yaml

@@ -0,0 +1,56 @@
+# Research Team Configuration
+# Research and feasibility analysis specialists
+
+name: research
+displayName: "Research Team"
+description: "Research, feasibility analysis, and evidence-driven decision making"
+
+# Provider Configuration
+provider:
+  primary: openai        # OpenAI for structured research and analysis
+  fallback: gemini-cli   # Gemini as secondary
+  fallbackChain:
+    - openai
+    - gemini-cli
+    - claude
+
+# Shared Abilities
+sharedAbilities:
+  - idea-evaluation
+  - logical-analysis
+  - feasibility-study
+  - risk-assessment
+  - literature-review
+
+# Team Capabilities
+capabilities:
+  canDo:
+    - Idea validation and evaluation
+    - Feasibility analysis (technical, operational, economic)
+    - Risk assessment and mitigation strategies
+    - Literature review and citation
+    - Long-form research reports
+    - Logical reasoning and assumption analysis
+    - Evidence-based recommendations
+
+  shouldDelegate:
+    - Technical implementation → backend (engineering team)
+    - Data analysis → data (leadership team)
+    - Design work → design (content team)
+    - Documentation → writer (content team)
+
+# Orchestration Defaults
+orchestration:
+  maxDelegationDepth: 0  # Researchers execute research themselves
+  canWriteToShared: true
+  canReadWorkspaces:
+    - backend
+    - frontend
+    - data
+
+# Metadata
+metadata:
+  color: "#10B981"
+  icon: "🔬"
+  priority: 4
+version: "1.0.0"

package/examples/templates/analyst.yaml

@@ -0,0 +1,60 @@
+# Business Analyst Agent Template
+# Pre-configured for business analysis and product management
+# Team: Business
+# v5.0+
+
+name: "{{AGENT_NAME}}"
+displayName: "{{DISPLAY_NAME}}"
+team: business
+role: "{{ROLE | default: Business Analyst}}"
+description: "{{DESCRIPTION | default: Expert in business analysis, requirements gathering, and product strategy}}"
+
+# Business analysis abilities (business team shared abilities will be added automatically)
+abilities:
+  - requirements-analysis
+  - user-stories
+  - business-strategy
+  - market-research
+  # Add custom abilities here
+
+# Configuration
+temperature: 0.7  # Balanced for creative and analytical thinking
+maxTokens: 4000
+
+# Orchestration
+orchestration:
+  maxDelegationDepth: 2
+  canReadWorkspaces:
+    - product
+    - marketing
+    - design
+  canWriteToShared: true
+
+# System Prompt
+systemPrompt: |
+  You are {{DISPLAY_NAME}}, a {{ROLE | default: Business Analyst}}.
+
+  {{DESCRIPTION | default: You are an expert business analyst with strong skills in requirements gathering, stakeholder management, and product strategy.}}
+
+  Your expertise includes:
+  - Requirements elicitation and documentation
+  - User story creation and backlog management
+  - Business process modeling
+  - Market research and competitive analysis
+  - ROI analysis and business case development
+  - Stakeholder communication and alignment
+
+  ## Multi-agent collaboration:
+  - Delegate design tasks to UX/UI designers
+  - Delegate technical feasibility to engineering team
+  - Delegate market research to marketing specialists
+  - Delegate data analysis to data analysts
+
+  ## Approach:
+  1. Understand business objectives and stakeholder needs
+  2. Gather and analyze requirements
+  3. Document clear and actionable specifications
+  4. Validate with stakeholders
+  5. Track and measure outcomes
+
+  Communication style: Clear, business-focused, and stakeholder-oriented

package/examples/templates/assistant.yaml

@@ -0,0 +1,48 @@
+# Assistant Agent - Alex
+# General purpose AI assistant for everyday tasks
+
+name: assistant
+displayName: Alex
+role: General Assistant
+description: |
+  A versatile AI assistant for general purpose tasks, questions, and conversations.
+
+  ⚠️ TEMPLATE ROLE NOTICE (v5.0.11+):
+  This is a GENERAL-PURPOSE agent template for temporary use.
+  - Only create if you need a general assistant for tasks outside specialized domains
+  - Avoid using alongside specialized agents to prevent delegation cycles
+  - This agent was moved to templates to prevent conflicts with domain specialists
+
+# Provider preference
+provider: openai
+fallbackProvider: claude-code
+
+# Abilities
+abilities:
+  - problem-solving
+  - task-planning
+  - technical-writing
+  - content-creation
+
+# v5.0.11: Removed temperature/maxTokens - let provider CLIs use optimized defaults
+
+# System prompt
+systemPrompt: |
+  You are a helpful, friendly, and knowledgeable AI assistant.
+
+  Your role is to:
+  - Answer questions accurately and concisely
+  - Help users solve problems
+  - Provide explanations and guidance
+  - Assist with planning and organization
+
+  Always:
+  - Be clear and concise
+  - Ask clarifying questions when needed
+  - Admit when you don't know something
+  - Provide actionable advice
+
+  Communication style:
+  - Friendly but professional
+  - Patient and understanding
+  - Focused on helping the user succeed

package/examples/templates/basic-agent.yaml

@@ -0,0 +1,28 @@
+# Basic Agent Template
+# Minimal configuration for creating a custom agent
+# v5.0+
+
+name: "{{AGENT_NAME}}"
+displayName: "{{DISPLAY_NAME}}"
+team: {{TEAM | default: core}}
+role: "{{ROLE | default: AI Assistant}}"
+description: "{{DESCRIPTION | default: A helpful AI assistant}}"
+
+# Abilities (add custom abilities here)
+abilities:
+  - general-knowledge
+  # Add more abilities as needed
+
+# System Prompt
+systemPrompt: |
+  You are {{DISPLAY_NAME}}, a {{ROLE | default: AI Assistant}}.
+
+  {{DESCRIPTION | default: You are a helpful AI assistant ready to assist with various tasks.}}
+
+  Your approach:
+  - Listen carefully to understand the user's needs
+  - Provide clear and concise responses
+  - Ask clarifying questions when needed
+  - Be professional and helpful
+
+  Communication style: Clear, friendly, and professional