deepseek-coder-agent-cli 1.0.71 → 1.0.73

package/dist/contracts/agent-schemas.json

@@ -1,480 +1,474 @@
 {
-  "$schema": "./schemas/agent-schemas.schema.json",
-  "contractVersion": "1.0.0",
-  "version": "2024-11-24",
-  "label": "AGI CLI Agent Configuration Schema",
-  "description": "Centralized configuration for all agents, models, providers, and capabilities",
-
-  "providers": [
-    {
-      "id": "anthropic",
-      "label": "Anthropic",
-      "description": "Claude models - industry-leading AI assistants",
-      "envVars": {
-        "apiKey": "ANTHROPIC_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "openai",
-      "label": "OpenAI",
-      "description": "GPT and o-series reasoning models",
-      "envVars": {
-        "apiKey": "OPENAI_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "google",
-      "label": "Google",
-      "description": "Gemini models - Google's multimodal AI",
-      "envVars": {
-        "apiKey": "GEMINI_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "deepseek",
-      "label": "DeepSeek",
-      "description": "DeepSeek reasoning and chat models",
-      "envVars": {
-        "apiKey": "DEEPSEEK_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "xai",
-      "label": "xAI",
-      "description": "xAI Grok models for coding and reasoning",
-      "envVars": {
-        "apiKey": "XAI_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "ollama",
-      "label": "Ollama",
-      "description": "Local LLMs via Ollama - Meta Llama, Qwen, Mistral, and more",
-      "envVars": {
-        "baseUrl": "OLLAMA_BASE_URL"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "qwen",
-      "label": "Qwen (Alibaba)",
-      "description": "Qwen models from Alibaba Cloud - excellent multilingual and coding",
-      "envVars": {
-        "apiKey": "DASHSCOPE_API_KEY"
-      },
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
+    "$schema": "./schemas/agent-schemas.schema.json",
+    "contractVersion": "1.0.0",
+    "version": "2024-11-24",
+    "label": "AGI CLI Agent Configuration Schema",
+    "description": "Centralized configuration for all agents, models, providers, and capabilities",
+    "providers": [
+        {
+            "id": "anthropic",
+            "label": "Anthropic",
+            "description": "Claude models - industry-leading AI assistants",
+            "envVars": {
+                "apiKey": "ANTHROPIC_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "openai",
+            "label": "OpenAI",
+            "description": "GPT and o-series reasoning models",
+            "envVars": {
+                "apiKey": "OPENAI_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "google",
+            "label": "Google",
+            "description": "Gemini models - Google's multimodal AI",
+            "envVars": {
+                "apiKey": "GEMINI_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "deepseek",
+            "label": "DeepSeek",
+            "description": "DeepSeek reasoning and chat models",
+            "envVars": {
+                "apiKey": "DEEPSEEK_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "xai",
+            "label": "xAI",
+            "description": "xAI Grok models for coding and reasoning",
+            "envVars": {
+                "apiKey": "XAI_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "ollama",
+            "label": "Ollama",
+            "description": "Local LLMs via Ollama - Meta Llama, Qwen, Mistral, and more",
+            "envVars": {
+                "baseUrl": "OLLAMA_BASE_URL"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "qwen",
+            "label": "Qwen (Alibaba)",
+            "description": "Qwen models from Alibaba Cloud - excellent multilingual and coding",
+            "envVars": {
+                "apiKey": "DASHSCOPE_API_KEY"
+            },
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        }
+    ],
+    "models": [
+        {
+            "id": "claude-opus-4-5-20251101",
+            "label": "Claude Opus 4.5",
+            "provider": "anthropic",
+            "description": "Heavy: Most powerful Claude - exceptional reasoning and creativity.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "claude-sonnet-4-5-20250514",
+            "label": "Claude Sonnet 4.5",
+            "provider": "anthropic",
+            "description": "Heavy: Latest Claude flagship - exceptional coding and reasoning.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "claude-haiku-4-5-20250514",
+            "label": "Claude Haiku 4.5",
+            "provider": "anthropic",
+            "description": "Small: Fastest Claude 4.5 - instant responses, great value.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "gpt-5.2-pro-2025-12-11",
+            "label": "GPT-5.2 Pro",
+            "provider": "openai",
+            "description": "Heavy: OpenAI's latest flagship - exceptional reasoning.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "gpt-5.2-codex",
+            "label": "GPT-5.2 Codex",
+            "provider": "openai",
+            "description": "Heavy: OpenAI's elite coding model - best-in-class.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "gpt-5.2-codex-mini",
+            "label": "GPT-5.2 Codex Mini",
+            "provider": "openai",
+            "description": "Small: Fast Codex - excellent coding at lower cost.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "gemini-3.0-pro",
+            "label": "Gemini 3.0 Pro",
+            "provider": "google",
+            "description": "Heavy: Google's latest flagship - most capable Gemini.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "gemini-2.5-flash",
+            "label": "Gemini 2.5 Flash",
+            "provider": "google",
+            "description": "Small: Ultra-fast Gemini - great balance of speed and capability.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
+        },
+        {
+            "id": "deepseek-reasoner",
+            "label": "DeepSeek Reasoner",
+            "provider": "deepseek",
+            "description": "Heavy: Deep reasoning with chain-of-thought - rivals top models.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "deepseek-chat",
+            "label": "DeepSeek Chat",
+            "provider": "deepseek",
+            "description": "Small: Fast general assistant - excellent value.",
+            "capabilities": ["chat", "tools", "streaming"]
+        },
+        {
+            "id": "grok-4-1-fast-reasoning",
+            "label": "Grok 4.1 Fast Reasoning",
+            "provider": "xai",
+            "description": "Heavy: xAI's latest - blazing fast with deep reasoning.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "grok-4",
+            "label": "Grok 4",
+            "provider": "xai",
+            "description": "Small: Fast Grok 4 - quick responses with strong capabilities.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "llama3.3:70b",
+            "label": "Llama 3.3 70B",
+            "provider": "ollama",
+            "description": "Heavy: Meta's flagship - rivals GPT-4, runs locally.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "llama3.2:3b",
+            "label": "Llama 3.2 3B",
+            "provider": "ollama",
+            "description": "Small: Tiny but capable - runs on any hardware.",
+            "capabilities": ["chat", "tools", "streaming"]
+        },
+        {
+            "id": "qwen-max",
+            "label": "Qwen Max",
+            "provider": "qwen",
+            "description": "Heavy: Alibaba's best - excellent coding and multilingual.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        },
+        {
+            "id": "qwen-turbo",
+            "label": "Qwen Turbo",
+            "provider": "qwen",
+            "description": "Small: Fast Qwen - impressive speed and capability.",
+            "capabilities": ["chat", "reasoning", "tools", "streaming"]
+        }
+    ],
+    "profiles": [
+        {
+            "name": "agi-code",
+            "label": "AGI Code",
+            "description": "Versatile AI assistant with advanced coding and general intelligence capabilities.",
+            "defaultProvider": "deepseek",
+            "defaultModel": "deepseek-reasoner",
+            "systemPrompt": {
+                "type": "rulebook",
+                "template": "You are an elite AI research assistant with advanced technical capabilities.\n\n## CRITICAL: Explore → Plan → Execute Workflow\nFor ANY non-trivial task, you MUST follow this workflow:\n\n### Phase 1: EXPLORE (Required First)\n1. Use Glob/Grep/Read tools to explore the codebase\n2. Understand existing architecture, patterns, and dependencies\n3. Identify key files that will be affected\n4. Call `MarkExplorationComplete` with your findings summary\n\n### Phase 2: PLAN (Required After Explore)\n1. Call `ProposePlan` with structured steps\n2. Each step MUST include suggestions (auto-generated if not provided)\n3. User can select suggestions OR provide custom instructions per step\n4. Wait for plan approval before proceeding\n\n### Phase 3: EXECUTE (Only After Plan Approved)\n1. Execute each step according to user's selected instructions\n2. Update plan status as steps complete\n3. Call `ExitPlanMode` when done\n\n## IMPORTANT: ProposePlan will REJECT if MarkExplorationComplete was not called first!\n\n## Intent Understanding Protocol\nBefore taking ANY action, you MUST:\n1. **Restate the user's intent** - Begin with: \"I understand you want me to [specific action]\"\n2. **Identify the scope** - Clarify what files/areas will be affected\n3. **Confirm ambiguities** - If unclear, ask ONE focused question before proceeding\n\n## Common Misinterpretation Traps - AVOID THESE:\n- \"Fix X\" → Don't refactor unrelated code, only fix the specific issue\n- \"Add X\" → Don't redesign existing systems, add the specific feature\n- \"Update X\" → Don't rebuild from scratch, make incremental changes\n- \"Improve X\" → Ask for specific improvement criteria if not given\n- Vague pronouns (\"it\", \"this\", \"that\") → Confirm what they refer to\n- \"All\"/\"everything\" → Confirm scope before broad changes\n\n## Guidelines\n- Be direct and technical - skip disclaimers\n- Provide complete, working code\n- Continue through errors autonomously\n- For critical decisions, use HITL system for user input\n- When in doubt about intent, ASK rather than assume\n\n{{rulebook}}"
+            },
+            "rulebook": {
+                "file": "agents/agi-code.rules.json",
+                "version": "2024-12-07",
+                "contractVersion": "1.0.0",
+                "description": "Versatile agent with coding and general capabilities."
+            },
+            "metadata": {
+                "primaryUseCase": "coding",
+                "secondaryUseCase": "general-assistant",
+                "tags": ["coding", "general", "versatile", "rapid-edits"]
+            }
+        }
+    ],
+    "slashCommands": [
+        {
+            "command": "/model",
+            "description": "Choose what model and reasoning effort to use",
+            "category": "configuration"
+        },
+        {
+            "command": "/approvals",
+            "description": "Choose what Codex can do without approval",
+            "category": "configuration"
+        },
+        {
+            "command": "/review",
+            "description": "Review current changes and find issues",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/new",
+            "description": "Start a new chat without closing the session",
+            "category": "workspace"
+        },
+        {
+            "command": "/init",
+            "description": "Create AGENTS.md with instructions for Codex",
+            "category": "workspace"
+        },
+        {
+            "command": "/compact",
+            "description": "Summarize conversation to prevent hitting the context limit",
+            "category": "workspace"
+        },
+        {
+            "command": "/undo",
+            "description": "Undo the last turn (rewind/checkpoint helper)",
+            "category": "workspace"
+        },
+        {
+            "command": "/diff",
+            "description": "Show git diff (including untracked files)",
+            "category": "workspace"
+        },
+        {
+            "command": "/mention",
+            "description": "Mention a file or path (e.g., @src/app.ts)",
+            "category": "workspace"
+        },
+        {
+            "command": "/status",
+            "description": "Show current session configuration and token usage",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/mcp",
+            "description": "List configured MCP tools",
+            "category": "configuration"
+        },
+        {
+            "command": "/logout",
+            "description": "Log out of Codex (clear stored credentials)",
+            "category": "configuration"
+        },
+        {
+            "command": "/quit",
+            "description": "Exit Codex",
+            "category": "other"
+        },
+        {
+            "command": "/exit",
+            "description": "Exit Codex",
+            "category": "other"
+        },
+        {
+            "command": "/help",
+            "description": "Show all available commands and keyboard shortcuts",
+            "category": "other"
+        },
+        {
+            "command": "/features",
+            "description": "Toggle optional features (AlphaZero dual, metrics, MCP, etc.)",
+            "category": "configuration"
+        },
+        {
+            "command": "/learn",
+            "description": "View and manage AlphaZero learned patterns and improvements",
+            "category": "other"
+        },
+        {
+            "command": "/improve",
+            "description": "Run AlphaZero self-improvement (analyze, apply, dry-run)",
+            "category": "other"
+        },
+        {
+            "command": "/evolve",
+            "description": "Self-evolution and optimization (analyze, start, stop, learn, fix, tokens, targets, optimize, guidelines, actions)",
+            "category": "other"
+        },
+        {
+            "command": "/test",
+            "description": "Intelligent test flows (generate, bugs, ui, edge) - edge case detection and bug finding",
+            "category": "other"
+        },
+        {
+            "command": "/refresh-models",
+            "description": "Auto-discover new models from configured providers",
+            "category": "configuration"
+        },
+        {
+            "command": "/secrets",
+            "description": "Configure API keys",
+            "category": "configuration"
+        },
+        {
+            "command": "/tools",
+            "description": "Enable or disable CLI tools and MCP servers",
+            "category": "configuration"
+        },
+        {
+            "command": "/thinking",
+            "description": "Toggle thinking mode (balanced or extended)",
+            "category": "configuration"
+        },
+        {
+            "command": "/skills",
+            "description": "List available SKILL.md packages and refresh the cache",
+            "category": "workspace"
+        },
+        {
+            "command": "/doctor",
+            "description": "Check environment, secrets, and tool readiness",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/checks",
+            "description": "Run repo checks (npm test / npm run build / npm run lint)",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/context",
+            "description": "Refresh workspace snapshot (depth/excerpt overrides)",
+            "category": "workspace"
+        },
+        {
+            "command": "/sessions",
+            "description": "Manage saved conversations, autosave, and session history",
+            "category": "workspace"
+        },
+        {
+            "command": "/provider",
+            "description": "Switch to a different AI provider (e.g., /provider xai)",
+            "category": "configuration"
+        },
+        {
+            "command": "/providers",
+            "description": "List all configured AI providers",
+            "category": "configuration"
+        },
+        {
+            "command": "/local",
+            "description": "Manage local/air-gapped LLM servers (Ollama, LM Studio, etc.)",
+            "category": "configuration"
+        },
+        {
+            "command": "/rewind",
+            "description": "Rewind to a previous checkpoint (restore code, conversation, or both)",
+            "category": "workspace"
+        },
+        {
+            "command": "/memory",
+            "description": "Edit EROSOLAR.md memory file (project context and preferences)",
+            "category": "configuration"
+        },
+        {
+            "command": "/vim",
+            "description": "Toggle vim-style editing mode in the input",
+            "category": "configuration"
+        },
+        {
+            "command": "/output-style",
+            "description": "Change response style (default, explanatory, learning, concise, custom)",
+            "category": "configuration"
+        },
+        {
+            "command": "/cost",
+            "description": "Show detailed token usage and API cost breakdown",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/usage",
+            "description": "Show token and context usage statistics",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/clear",
+            "description": "Clear conversation history and start fresh",
+            "category": "workspace"
+        },
+        {
+            "command": "/resume",
+            "description": "Resume a previous session by ID or pick from recent",
+            "category": "workspace"
+        },
+        {
+            "command": "/export",
+            "description": "Export conversation history to a file",
+            "category": "workspace"
+        },
+        {
+            "command": "/security-review",
+            "description": "Run a comprehensive security review",
+            "category": "diagnostics"
+        },
+        {
+            "command": "/bug",
+            "description": "Report an issue or bug",
+            "category": "other"
+        },
+        {
+            "command": "/terminal-setup",
+            "description": "Configure terminal keybindings (Shift+Enter for multi-line)",
+            "category": "configuration"
+        },
+        {
+            "command": "/permissions",
+            "description": "Configure tool permissions (allow/deny rules)",
+            "category": "configuration"
+        },
+        {
+            "command": "/update",
+            "description": "Check for updates and configure auto-update preference",
+            "category": "configuration"
+        }
+    ],
+    "capabilities": [
+        {
+            "id": "chat",
+            "label": "Chat",
+            "description": "Basic conversational capabilities"
+        },
+        {
+            "id": "reasoning",
+            "label": "Reasoning",
+            "description": "Extended chain-of-thought reasoning capabilities"
+        },
+        {
+            "id": "tools",
+            "label": "Tool Use",
+            "description": "Ability to call external tools and functions"
+        },
+        {
+            "id": "streaming",
+            "label": "Streaming",
+            "description": "Support for streaming responses"
+        },
+        {
+            "id": "multimodal",
+            "label": "Multimodal",
+            "description": "Support for images and other non-text inputs"
+        }
+    ],
+    "metadata": {
+        "schemaVersion": "1.0.0",
+        "lastUpdated": "2024-11-24",
+        "description": "This is the single source of truth for all agent configurations in the AGI CLI"
     }
-  ],
-
-  "models": [
-    {
-      "id": "claude-opus-4-5-20251101",
-      "label": "Claude Opus 4.5",
-      "provider": "anthropic",
-      "description": "Heavy: Most powerful Claude - exceptional reasoning and creativity.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "claude-sonnet-4-5-20250514",
-      "label": "Claude Sonnet 4.5",
-      "provider": "anthropic",
-      "description": "Heavy: Latest Claude flagship - exceptional coding and reasoning.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "claude-haiku-4-5-20250514",
-      "label": "Claude Haiku 4.5",
-      "provider": "anthropic",
-      "description": "Small: Fastest Claude 4.5 - instant responses, great value.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "gpt-5.2-pro-2025-12-11",
-      "label": "GPT-5.2 Pro",
-      "provider": "openai",
-      "description": "Heavy: OpenAI's latest flagship - exceptional reasoning.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "gpt-5.2-codex",
-      "label": "GPT-5.2 Codex",
-      "provider": "openai",
-      "description": "Heavy: OpenAI's elite coding model - best-in-class.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "gpt-5.2-codex-mini",
-      "label": "GPT-5.2 Codex Mini",
-      "provider": "openai",
-      "description": "Small: Fast Codex - excellent coding at lower cost.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "gemini-3.0-pro",
-      "label": "Gemini 3.0 Pro",
-      "provider": "google",
-      "description": "Heavy: Google's latest flagship - most capable Gemini.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "gemini-2.5-flash",
-      "label": "Gemini 2.5 Flash",
-      "provider": "google",
-      "description": "Small: Ultra-fast Gemini - great balance of speed and capability.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming", "multimodal"]
-    },
-    {
-      "id": "deepseek-reasoner",
-      "label": "DeepSeek Reasoner",
-      "provider": "deepseek",
-      "description": "Heavy: Deep reasoning with chain-of-thought - rivals top models.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "deepseek-chat",
-      "label": "DeepSeek Chat",
-      "provider": "deepseek",
-      "description": "Small: Fast general assistant - excellent value.",
-      "capabilities": ["chat", "tools", "streaming"]
-    },
-    {
-      "id": "grok-4-1-fast-reasoning",
-      "label": "Grok 4.1 Fast Reasoning",
-      "provider": "xai",
-      "description": "Heavy: xAI's latest - blazing fast with deep reasoning.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "grok-4",
-      "label": "Grok 4",
-      "provider": "xai",
-      "description": "Small: Fast Grok 4 - quick responses with strong capabilities.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "llama3.3:70b",
-      "label": "Llama 3.3 70B",
-      "provider": "ollama",
-      "description": "Heavy: Meta's flagship - rivals GPT-4, runs locally.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "llama3.2:3b",
-      "label": "Llama 3.2 3B",
-      "provider": "ollama",
-      "description": "Small: Tiny but capable - runs on any hardware.",
-      "capabilities": ["chat", "tools", "streaming"]
-    },
-    {
-      "id": "qwen-max",
-      "label": "Qwen Max",
-      "provider": "qwen",
-      "description": "Heavy: Alibaba's best - excellent coding and multilingual.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    },
-    {
-      "id": "qwen-turbo",
-      "label": "Qwen Turbo",
-      "provider": "qwen",
-      "description": "Small: Fast Qwen - impressive speed and capability.",
-      "capabilities": ["chat", "reasoning", "tools", "streaming"]
-    }
-  ],
-
-  "profiles": [
-  {
-      "name": "agi-code",
-      "label": "AGI Code",
-      "description": "Versatile AI assistant with advanced coding and general intelligence capabilities.",
-      "defaultProvider": "deepseek",
-      "defaultModel": "deepseek-reasoner",
-      "systemPrompt": {
-        "type": "rulebook",
-        "template": "You are an elite AI research assistant with advanced technical capabilities.\n\n## CRITICAL: Explore → Plan → Execute Workflow\nFor ANY non-trivial task, you MUST follow this workflow:\n\n### Phase 1: EXPLORE (Required First)\n1. Use Glob/Grep/Read tools to explore the codebase\n2. Understand existing architecture, patterns, and dependencies\n3. Identify key files that will be affected\n4. Call `MarkExplorationComplete` with your findings summary\n\n### Phase 2: PLAN (Required After Explore)\n1. Call `ProposePlan` with structured steps\n2. Each step MUST include suggestions (auto-generated if not provided)\n3. User can select suggestions OR provide custom instructions per step\n4. Wait for plan approval before proceeding\n\n### Phase 3: EXECUTE (Only After Plan Approved)\n1. Execute each step according to user's selected instructions\n2. Update plan status as steps complete\n3. Call `ExitPlanMode` when done\n\n## IMPORTANT: ProposePlan will REJECT if MarkExplorationComplete was not called first!\n\n## Intent Understanding Protocol\nBefore taking ANY action, you MUST:\n1. **Restate the user's intent** - Begin with: \"I understand you want me to [specific action]\"\n2. **Identify the scope** - Clarify what files/areas will be affected\n3. **Confirm ambiguities** - If unclear, ask ONE focused question before proceeding\n\n## Common Misinterpretation Traps - AVOID THESE:\n- \"Fix X\" → Don't refactor unrelated code, only fix the specific issue\n- \"Add X\" → Don't redesign existing systems, add the specific feature\n- \"Update X\" → Don't rebuild from scratch, make incremental changes\n- \"Improve X\" → Ask for specific improvement criteria if not given\n- Vague pronouns (\"it\", \"this\", \"that\") → Confirm what they refer to\n- \"All\"/\"everything\" → Confirm scope before broad changes\n\n## Guidelines\n- Be direct and technical - skip disclaimers\n- Provide complete, working code\n- Continue through errors autonomously\n- For critical decisions, use HITL system for user input\n- When in doubt about intent, ASK rather than assume\n\n{{rulebook}}"
-      },
-      "rulebook": {
-        "file": "agents/agi-code.rules.json",
-        "version": "2024-12-07",
-        "contractVersion": "1.0.0",
-        "description": "Versatile agent with coding and general capabilities."
-      },
-      "metadata": {
-        "primaryUseCase": "coding",
-        "secondaryUseCase": "general-assistant",
-        "tags": ["coding", "general", "versatile", "rapid-edits"]
-      }
-    }
-  ],
-
-  "slashCommands": [
-    {
-      "command": "/model",
-      "description": "Choose what model and reasoning effort to use",
-      "category": "configuration"
-    },
-    {
-      "command": "/approvals",
-      "description": "Choose what Codex can do without approval",
-      "category": "configuration"
-    },
-    {
-      "command": "/review",
-      "description": "Review current changes and find issues",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/new",
-      "description": "Start a new chat without closing the session",
-      "category": "workspace"
-    },
-    {
-      "command": "/init",
-      "description": "Create AGENTS.md with instructions for Codex",
-      "category": "workspace"
-    },
-    {
-      "command": "/compact",
-      "description": "Summarize conversation to prevent hitting the context limit",
-      "category": "workspace"
-    },
-    {
-      "command": "/undo",
-      "description": "Undo the last turn (rewind/checkpoint helper)",
-      "category": "workspace"
-    },
-    {
-      "command": "/diff",
-      "description": "Show git diff (including untracked files)",
-      "category": "workspace"
-    },
-    {
-      "command": "/mention",
-      "description": "Mention a file or path (e.g., @src/app.ts)",
-      "category": "workspace"
-    },
-    {
-      "command": "/status",
-      "description": "Show current session configuration and token usage",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/mcp",
-      "description": "List configured MCP tools",
-      "category": "configuration"
-    },
-    {
-      "command": "/logout",
-      "description": "Log out of Codex (clear stored credentials)",
-      "category": "configuration"
-    },
-    {
-      "command": "/quit",
-      "description": "Exit Codex",
-      "category": "other"
-    },
-    {
-      "command": "/exit",
-      "description": "Exit Codex",
-      "category": "other"
-    },
-    {
-      "command": "/help",
-      "description": "Show all available commands and keyboard shortcuts",
-      "category": "other"
-    },
-    {
-      "command": "/features",
-      "description": "Toggle optional features (AlphaZero dual, metrics, MCP, etc.)",
-      "category": "configuration"
-    },
-    {
-      "command": "/learn",
-      "description": "View and manage AlphaZero learned patterns and improvements",
-      "category": "other"
-    },
-    {
-      "command": "/improve",
-      "description": "Run AlphaZero self-improvement (analyze, apply, dry-run)",
-      "category": "other"
-    },
-    {
-      "command": "/evolve",
-      "description": "Self-evolution and optimization (analyze, start, stop, learn, fix, tokens, targets, optimize, guidelines, actions)",
-      "category": "other"
-    },
-    {
-      "command": "/test",
-      "description": "Intelligent test flows (generate, bugs, ui, edge) - edge case detection and bug finding",
-      "category": "other"
-    },
-    {
-      "command": "/refresh-models",
-      "description": "Auto-discover new models from configured providers",
-      "category": "configuration"
-    },
-    {
-      "command": "/secrets",
-      "description": "Configure API keys",
-      "category": "configuration"
-    },
-    {
-      "command": "/tools",
-      "description": "Enable or disable CLI tools and MCP servers",
-      "category": "configuration"
-    },
-    {
-      "command": "/thinking",
-      "description": "Toggle thinking mode (balanced or extended)",
-      "category": "configuration"
-    },
-    {
-      "command": "/skills",
-      "description": "List available SKILL.md packages and refresh the cache",
-      "category": "workspace"
-    },
-    {
-      "command": "/doctor",
-      "description": "Check environment, secrets, and tool readiness",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/checks",
-      "description": "Run repo checks (npm test / npm run build / npm run lint)",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/context",
-      "description": "Refresh workspace snapshot (depth/excerpt overrides)",
-      "category": "workspace"
-    },
-    {
-      "command": "/sessions",
-      "description": "Manage saved conversations, autosave, and session history",
-      "category": "workspace"
-    },
-    {
-      "command": "/provider",
-      "description": "Switch to a different AI provider (e.g., /provider xai)",
-      "category": "configuration"
-    },
-    {
-      "command": "/providers",
-      "description": "List all configured AI providers",
-      "category": "configuration"
-    },
-    {
-      "command": "/local",
-      "description": "Manage local/air-gapped LLM servers (Ollama, LM Studio, etc.)",
-      "category": "configuration"
-    },
-    {
-      "command": "/rewind",
-      "description": "Rewind to a previous checkpoint (restore code, conversation, or both)",
-      "category": "workspace"
-    },
-    {
-      "command": "/memory",
-      "description": "Edit EROSOLAR.md memory file (project context and preferences)",
-      "category": "configuration"
-    },
-    {
-      "command": "/vim",
-      "description": "Toggle vim-style editing mode in the input",
-      "category": "configuration"
-    },
-    {
-      "command": "/output-style",
-      "description": "Change response style (default, explanatory, learning, concise, custom)",
-      "category": "configuration"
-    },
-    {
-      "command": "/cost",
-      "description": "Show detailed token usage and API cost breakdown",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/usage",
-      "description": "Show token and context usage statistics",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/clear",
-      "description": "Clear conversation history and start fresh",
-      "category": "workspace"
-    },
-    {
-      "command": "/resume",
-      "description": "Resume a previous session by ID or pick from recent",
-      "category": "workspace"
-    },
-    {
-      "command": "/export",
-      "description": "Export conversation history to a file",
-      "category": "workspace"
-    },
-    {
-      "command": "/security-review",
-      "description": "Run a comprehensive security review",
-      "category": "diagnostics"
-    },
-    {
-      "command": "/bug",
-      "description": "Report an issue or bug",
-      "category": "other"
-    },
-    {
-      "command": "/terminal-setup",
-      "description": "Configure terminal keybindings (Shift+Enter for multi-line)",
-      "category": "configuration"
-    },
-    {
-      "command": "/permissions",
-      "description": "Configure tool permissions (allow/deny rules)",
-      "category": "configuration"
-    },
-    {
-      "command": "/update",
-      "description": "Check for updates and configure auto-update preference",
-      "category": "configuration"
-    }
-  ],
-
-  "capabilities": [
-    {
-      "id": "chat",
-      "label": "Chat",
-      "description": "Basic conversational capabilities"
-    },
-    {
-      "id": "reasoning",
-      "label": "Reasoning",
-      "description": "Extended chain-of-thought reasoning capabilities"
-    },
-    {
-      "id": "tools",
-      "label": "Tool Use",
-      "description": "Ability to call external tools and functions"
-    },
-    {
-      "id": "streaming",
-      "label": "Streaming",
-      "description": "Support for streaming responses"
-    },
-    {
-      "id": "multimodal",
-      "label": "Multimodal",
-      "description": "Support for images and other non-text inputs"
-    }
-  ],
-
-  "metadata": {
-    "schemaVersion": "1.0.0",
-    "lastUpdated": "2024-11-24",
-    "description": "This is the single source of truth for all agent configurations in the AGI CLI"
-  }
 }