daedalus-cli 0.4.0

package/Daedalus.bat

@@ -0,0 +1,18 @@
+@echo off
+chcp 65001 >nul
+title Daedalus - Local-First Coding CLI
+color 0A
+
+echo  +------------------------------------------+
+echo  ^|         Launching Daedalus CLI...         ^|
+echo  +------------------------------------------+
+echo.
+
+node "%~dp0dist/index.js" %*
+
+if errorlevel 1 (
+    echo.
+    echo  [ERROR] Daedalus exited with code %errorlevel%
+    echo  Make sure it's installed globally: npm install -g daedalus-cli
+    pause
+)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bgill55_art
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,254 @@
+# Daedalus
+
+**Local-first coding CLI with an embedded model router, multi-agent orchestration, and codebase indexing.**
+
+Daedalus is a standalone terminal-based AI coding assistant that runs entirely on your machine. It connects to local LLM servers (LM Studio, Ollama, llama.cpp, vLLM) or remote providers (OpenAI, Groq, OpenRouter, Anthropic), routes requests intelligently, and gives your AI agent access to your file system, terminal, git, web search, and codebase indexing — all from your command line.
+
+```text
+  ╭─ ⬡ You ───────────────────────────────────────────────╮
+  │ refactor the auth middleware to use async/await         │
+  ╰────────────────────────────────────────────────────────╯
+
+  ╭─ ◇ Daedalus ───────────────────────────────────────────╮
+  │ Let me look at the current auth middleware...            │
+  │ I'll refactor it to use async/await pattern.             │
+  ╰────────────────────────────────────────────────────────╯  ~132t · 3.2s
+```
+
+---
+
+## Features
+
+- **Local-first** — Works with local LLMs (LM Studio, Ollama, llama.cpp, vLLM) or remote APIs
+- **Embedded model router** — Priority, round-robin, or fastest-response routing across multiple models
+- **Multi-agent orchestration** — Spawns sub-agents (planner, coder, reviewer, debugger, researcher) for complex tasks
+- **Codebase indexing** — FTS5-powered symbol search, definitions, and call-graph references (TS/JS, Python, Go, Rust)
+- **File system tools** — Read, write, patch with interactive diff UI, search (ripgrep + native fallback)
+- **Terminal access** — Cross-platform shell execution (bash/cmd) with timeout and abort
+- **Git integration** — Status, diff, stage-all-and-commit, undo last patch
+- **Session management** — SQLite-backed conversation history with save/load/export
+- **Project memory** — Persist facts and conventions that auto-inject into every turn
+- **MCP support** — Connect Model Context Protocol servers (stdio and HTTP/SSE)
+- **Web tools** — DuckDuckGo search and URL fetching (no API key needed)
+- **Visual chat UI** — Bordered message blocks, tab completion, syntax-highlighted code blocks
+- **Configurable** — Per-project settings (test commands, auto-run), full daedalus config
+- **Windows + Unix** — Full cross-platform support
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js 20+
+- A local LLM server (recommended) or a remote API key
+
+### Install
+
+```bash
+npm install -g daedalus-cli
+```
+
+Or run directly from source:
+
+```bash
+git clone <repo-url>
+cd daedalus
+npm install
+npm run build
+```
+
+### Launch
+
+```bash
+daedalus
+```
+
+On first run, Daedalus will scan for local LLM servers and guide you through setup. If none are found, it prompts you to configure a remote provider (OpenAI, Groq, OpenRouter, Anthropic, or custom).
+
+---
+
+## Usage
+
+Once inside the REPL, type `?` or `help` for the full command reference.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `/add <file>` | Add file to active context |
+| `/remove <file>` | Remove file from context |
+| `/context` | Show active file context |
+| `/clear` | Clear conversation history |
+| `/commit [message]` | Stage all and commit changes |
+| `/undo` | Revert last file patch |
+| `/test [iterations]` | Run tests and auto-fix failures |
+| `/index` | Index codebase for symbol search |
+| `/find <query>` | Fuzzy-search indexed symbols |
+| `/refs <symbol>` | Find symbol references (callers) |
+| `/def <symbol>` | Get symbol definition |
+| `/project` | View or set project config |
+| `/session list\|load\|new\|delete` | Manage chat sessions |
+| `/models` | List available models |
+| `/tools` | List all tools |
+| `/doctor` | Diagnose local server connections |
+| `/onboard` | Re-run setup wizard |
+| `/spawn <role> <task>` | Spawn a sub-agent |
+| `/orchestrate <goal>` | Run multi-agent orchestration |
+| `?` / `help` | Show command reference |
+| `exit` / `quit` | Save and quit |
+
+### Tab Completion
+
+Start typing a command and press Tab — Daedalus auto-completes it:
+
+```
+  ⬡ › /fi[TAB]
+  ⬡ › /find
+```
+
+---
+
+## Configuration
+
+Daedalus stores its configuration at `~/.daedalus/config.json`. Key sections:
+
+```json
+{
+  "router": {
+    "strategy": "priority",
+    "chain": [
+      {
+        "name": "local",
+        "endpoint": "http://localhost:1234/v1",
+        "model": "auto",
+        "enabled": true,
+        "priority": 1,
+        "maxTokens": 8192
+      }
+    ]
+  },
+  "indexing": {
+    "enabled": true,
+    "exclude": ["node_modules", "dist", ".git"]
+  },
+  "ui": {
+    "showTokens": true
+  }
+}
+```
+
+### Router Strategies
+
+- **`priority`** (default) — Picks the healthy model with lowest priority number
+- **`round-robin`** — Cycles through healthy models evenly
+- **`fastest`** — Picks the model with the lowest cached response time
+
+### Per-Project Config
+
+Each project can have its own settings at `~/.daedalus/config/<project-hash>.json`:
+
+```json
+{
+  "testCommand": "npm test",
+  "buildCommand": "npm run build",
+  "lintCommand": "npm run lint",
+  "devCommand": "npm run dev"
+}
+```
+
+Configured via `/project set <key> <value>`.
+
+---
+
+## Architecture
+
+```text
+src/
+├── index.ts                # CLI entry point, REPL, command dispatch
+├── types.ts                # Shared type definitions
+├── highlight.ts            # Syntax highlighting for code blocks
+├── config/                 # Configuration loading, schema, discovery
+│   └── index.ts
+├── router/                 # Model routing engine
+│   ├── index.ts            # LocalRouter: routing, streaming, completion
+│   ├── types.ts            # Router types
+│   ├── health.ts           # Model health checks
+│   └── rate-limiter.ts     # Token-bucket rate limiter
+├── session/                # Session persistence
+│   ├── manager.ts          # Session orchestration
+│   ├── sqlite.ts           # SQLite CRUD
+│   ├── memory.ts           # Project facts & conventions
+│   └── jsonl.ts            # JSONL import/export
+├── agents/                 # Multi-agent system
+│   ├── agent.ts            # Agent interface
+│   ├── roles.ts            # Role definitions (coder, reviewer, etc.)
+│   └── orchestrator.ts     # Orchestration engine
+├── tools/                  # Tool system
+│   ├── definitions.ts      # 16 built-in tool definitions
+│   ├── executor.ts         # Tool execution engine
+│   ├── daedalus-spinner.ts # Terminal spinner
+│   ├── builtin/            # Built-in tool implementations
+│   │   ├── files.ts        # File read/write/patch/search
+│   │   ├── terminal.ts     # Shell execution
+│   │   ├── git.ts          # Git diff/status
+│   │   ├── web.ts          # Web search/fetch
+│   │   ├── todo.ts         # Task management
+│   │   ├── delegation.ts   # Sub-agent delegation
+│   │   ├── indexing.ts     # Codebase indexing tools
+│   │   ├── diff-ui.ts      # Interactive diff viewer
+│   │   └── project-config.ts
+│   └── mcp/                # MCP transport
+│       ├── registry.ts     # MCP server manager
+│       ├── stdio.ts        # stdio transport
+│       ├── http.ts         # HTTP/SSE transport
+│       └── tool-executor.ts
+├── indexing/               # Codebase indexing
+│   ├── fts.ts              # FTS5 database layer
+│   └── indexer.ts          # File crawler & language parsers
+└── onboarding/             # Setup wizard
+    └── wizard.ts
+```
+
+---
+
+## Development
+
+```bash
+# Run in dev mode (hot reload)
+npm run dev
+
+# Run directly
+npm start
+
+# Build
+npm run build
+
+# Type check
+npx tsc --noEmit
+
+# Test
+npm test
+
+# Lint
+npm run lint
+```
+
+---
+
+## Why Daedalus?
+
+Daedalus is built for developers who want AI assistance without:
+- Sending their code to third-party servers
+- Paying per-token for every interaction
+- Being locked into a single provider
+- Losing their conversation history between sessions
+- Having limited tool access
+
+It's for local-first, private, customizable AI coding — with the power to grow with you.
+
+---
+
+## License
+
+MIT

package/dist/agents/agent.d.ts

@@ -0,0 +1,10 @@
+export interface Agent {
+    /**
+     * Run the agent on a given goal.
+     * @param goal The high-level task description.
+     * @param context Optional additional context (e.g., list of active files).
+     * @returns A string summary of what the agent accomplished.
+     */
+    run(goal: string, context?: string): Promise<string>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agents/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agents/agent.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,KAAK;IACpB;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD"}

package/dist/agents/agent.js

@@ -0,0 +1,3 @@
+// Base Agent interface for Daedalus sub-agents
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/agents/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/agents/agent.ts"],"names":[],"mappings":"AAAA,+CAA+C"}

package/dist/agents/orchestrator.d.ts

@@ -0,0 +1,18 @@
+import { LocalRouter } from '../router/index.js';
+import { ToolContext, ChatMessage } from '../types.js';
+export declare class Orchestrator {
+    private router;
+    private messages;
+    private toolContext;
+    private results;
+    constructor(router: LocalRouter, messages: ChatMessage[], toolContext: ToolContext);
+    run(goal: string): Promise<string>;
+    private createPlan;
+    private executePlan;
+    private parseDelegationTasks;
+    private delegateTask;
+    private runAgent;
+    private executeOpenAIToolCalls;
+    private synthesize;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/agents/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAIjD,OAAO,EAAE,WAAW,EAAY,WAAW,EAAE,MAAM,aAAa,CAAC;AAgBjE,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,WAAW;IAM5E,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAa1B,UAAU;YAiDV,WAAW;IAQzB,OAAO,CAAC,oBAAoB;YAoCd,YAAY;YAiBZ,QAAQ;YAsDR,sBAAsB;IASpC,OAAO,CAAC,UAAU;CAWnB"}

package/dist/agents/orchestrator.js

@@ -0,0 +1,171 @@
+// Multi-agent orchestrator - coordinates delegation and synthesis
+import { BUILTIN_TOOLS } from '../tools/definitions.js';
+import { executeToolCalls } from '../tools/executor.js';
+import { getAgentRole, filterToolsForRole } from './roles.js';
+export class Orchestrator {
+    router;
+    messages;
+    toolContext;
+    results = [];
+    constructor(router, messages, toolContext) {
+        this.router = router;
+        this.messages = messages;
+        this.toolContext = toolContext;
+    }
+    async run(goal) {
+        this.results = [];
+        // Create initial plan
+        const plan = await this.createPlan(goal);
+        // Execute plan by delegating to agents
+        await this.executePlan(plan);
+        // Synthesize results
+        return this.synthesize(goal);
+    }
+    async createPlan(goal) {
+        const plannerRole = getAgentRole('planner');
+        const tools = filterToolsForRole(BUILTIN_TOOLS, 'planner');
+        const systemPrompt = plannerRole.systemPrompt;
+        const messages = [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: `Create a plan for: ${goal}\n\nContext:\n${this.toolContext.activeFiles.size > 0 ? 'Files in context: ' + Array.from(this.toolContext.activeFiles.values()).join(', ') : 'No files in context'}` },
+        ];
+        const completion = await this.router.chat.completions.create({
+            model: 'auto',
+            messages: messages,
+            temperature: plannerRole.temperature ?? 0.2,
+            tools,
+            tool_choice: 'auto',
+        });
+        const assistantMessage = completion.choices[0].message;
+        const toolCalls = assistantMessage.tool_calls;
+        if (toolCalls && toolCalls.length > 0) {
+            // Push the assistant turn with its tool calls
+            messages.push(assistantMessage);
+            // Execute tool calls and push results back into the conversation
+            const results = await this.executeOpenAIToolCalls(toolCalls);
+            for (const result of results) {
+                messages.push({
+                    role: 'tool',
+                    content: result.content,
+                    tool_call_id: result.toolCallId,
+                });
+            }
+            // Ask the planner for a final text summary now that tools have run
+            const followUp = await this.router.chat.completions.create({
+                model: 'auto',
+                messages,
+                temperature: plannerRole.temperature ?? 0.2,
+                tools,
+                tool_choice: 'none', // No more tool calls — just produce the plan text
+            });
+            return followUp.choices[0].message.content || 'No plan generated';
+        }
+        return assistantMessage.content || 'No plan generated';
+    }
+    async executePlan(plan) {
+        const delegationTasks = this.parseDelegationTasks(plan);
+        for (const task of delegationTasks) {
+            await this.delegateTask(task);
+        }
+    }
+    parseDelegationTasks(plan) {
+        const tasks = [];
+        const lines = plan.split('\n');
+        let currentRole = '';
+        let currentGoal = '';
+        for (const line of lines) {
+            const roleMatch = line.match(/(?:delegate to|have|assign to)\s+(planner|coder|reviewer|debugger|researcher)/i);
+            if (roleMatch) {
+                if (currentRole && currentGoal) {
+                    tasks.push({ goal: currentGoal, context: '', role: currentRole });
+                }
+                currentRole = roleMatch[1].toLowerCase();
+                currentGoal = line.replace(roleMatch[0], '').trim();
+            }
+            else if (currentRole && line.trim()) {
+                currentGoal += ' ' + line.trim();
+            }
+        }
+        if (currentRole && currentGoal) {
+            tasks.push({ goal: currentGoal, context: '', role: currentRole });
+        }
+        // If no explicit delegation found, default to coder for implementation tasks
+        if (tasks.length === 0) {
+            tasks.push({
+                goal: plan,
+                context: `Files in context: ${Array.from(this.toolContext.activeFiles.values()).join(', ')}`,
+                role: 'coder'
+            });
+        }
+        return tasks;
+    }
+    async delegateTask(task) {
+        const role = getAgentRole(task.role);
+        console.log(`\n🤝 Delegating to ${role.name}: ${task.goal.slice(0, 80)}...`);
+        const tools = filterToolsForRole(BUILTIN_TOOLS, task.role);
+        const result = await this.runAgent(role, task.goal, task.context, tools);
+        this.results.push({
+            role: task.role,
+            goal: task.goal,
+            summary: result,
+            success: !result.includes('Error') && !result.includes('Failed'),
+        });
+        console.log(`✅ ${role.name} completed`);
+    }
+    async runAgent(role, goal, context, tools) {
+        const messages = [
+            { role: 'system', content: role.systemPrompt },
+            { role: 'user', content: `${context}\n\nTask: ${goal}` },
+        ];
+        let turns = 0;
+        const maxTurns = role.maxTurns ?? 10;
+        while (turns < maxTurns) {
+            const completion = await this.router.chat.completions.create({
+                model: 'auto',
+                messages: messages,
+                temperature: role.temperature ?? 0.1,
+                tools,
+                tool_choice: 'auto',
+            });
+            const message = completion.choices[0].message;
+            messages.push(message);
+            if (message.tool_calls && message.tool_calls.length > 0) {
+                const results = await executeToolCalls(message.tool_calls.map((tc) => ({
+                    id: tc.id,
+                    type: 'function',
+                    function: { name: tc.function.name, arguments: tc.function.arguments },
+                })), this.toolContext);
+                for (const result of results) {
+                    messages.push({
+                        role: 'tool',
+                        content: result.content,
+                        tool_call_id: result.toolCallId,
+                    });
+                }
+                turns++;
+                continue;
+            }
+            // No tool calls - agent is done
+            return message.content || 'Agent completed without response';
+        }
+        return 'Agent reached max turns';
+    }
+    async executeOpenAIToolCalls(toolCalls) {
+        const tc = toolCalls.map((rawTc) => ({
+            id: rawTc.id,
+            type: 'function',
+            function: { name: rawTc.function.name, arguments: rawTc.function.arguments },
+        }));
+        return executeToolCalls(tc, this.toolContext);
+    }
+    synthesize(goal) {
+        let output = `## Orchestration Complete: ${goal}\n\n`;
+        for (const result of this.results) {
+            const status = result.success ? '✅' : '❌';
+            output += `${status} **${result.role}**: ${result.goal.slice(0, 100)}\n`;
+            output += `   ${result.summary.slice(0, 200)}\n\n`;
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/agents/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/agents/roles.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from '../tools/definitions.js';
+export interface AgentRole {
+    name: string;
+    description: string;
+    systemPrompt: string;
+    allowedTools: string[];
+    canDelegate: boolean;
+    maxTurns?: number;
+    temperature?: number;
+}
+export declare const AGENT_ROLES: Record<string, AgentRole>;
+export declare function getAgentRole(name: string): AgentRole;
+export declare function filterToolsForRole(tools: ToolDefinition[], roleName: string): ToolDefinition[];
+//# sourceMappingURL=roles.d.ts.map

package/dist/agents/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/agents/roles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAqHjD,CAAC;AAGF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEpD;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAI9F"}

package/dist/agents/roles.js

@@ -0,0 +1,126 @@
+// Agent role definitions
+export const AGENT_ROLES = {
+    orchestrator: {
+        name: 'orchestrator',
+        description: 'Plans, delegates, and coordinates multi-agent workflows',
+        systemPrompt: `You are an Orchestrator Agent. Your job is to break down complex tasks into subtasks and delegate them to specialized agents.
+
+AVAILABLE SUB-AGENTS:
+- planner: Break down vague tasks into concrete, ordered subtasks
+- coder: Implement changes, write/edit files, fix bugs
+- reviewer: Code review: correctness, security, style, tests
+- debugger: Reproduce, isolate, fix bugs; add logging; bisect
+- researcher: Web search, docs lookup, API exploration
+
+WORKFLOW:
+1. Analyze the user's request
+2. Create a todo list with todo tool
+3. Delegate subtasks to appropriate agents using delegate_task tool
+4. Collect and synthesize results
+5. Present final outcome to user
+
+Always use the todo tool to track progress. Delegate liberally - agents run in parallel.`,
+        allowedTools: ['todo', 'delegate_task', 'read_file', 'search_files', 'list_files', 'web_search'],
+        canDelegate: true,
+        temperature: 0.2,
+    },
+    planner: {
+        name: 'planner',
+        description: 'Breaks down vague tasks into concrete, ordered subtasks',
+        systemPrompt: `You are a Planning Agent. Your job is to analyze a task and create a clear, actionable plan.
+
+OUTPUT: A todo list with specific, ordered subtasks. Each task should be:
+- Concrete and verifiable
+- Assigned to an appropriate agent (coder, reviewer, debugger, researcher)
+- Sized to be completable in one agent session
+
+Use the todo tool to create the plan. Do not implement - only plan.`,
+        allowedTools: ['todo', 'read_file', 'search_files', 'list_files', 'terminal', 'web_search'],
+        canDelegate: false,
+        temperature: 0.2,
+    },
+    coder: {
+        name: 'coder',
+        description: 'Implements changes, writes/edits files, fixes bugs',
+        systemPrompt: `You are a Coder Agent. Your job is to implement code changes based on the plan.
+
+CAPABILITIES:
+- Read and understand existing code
+- Write new files and edit existing ones
+- Run tests, builds, linters
+- Use git for version control
+
+GUIDELINES:
+- Make minimal, focused changes
+- Follow existing code style and patterns
+- Write tests for new functionality
+- Run tests to verify changes
+- Commit with clear messages
+
+Use tools: read_file, write_file, patch, search_files, terminal, git_diff, git_status, todo.`,
+        allowedTools: ['read_file', 'write_file', 'patch', 'search_files', 'list_files', 'terminal', 'git_diff', 'git_status', 'todo', 'web_search', 'fetch_url'],
+        canDelegate: false,
+        temperature: 0.1,
+    },
+    reviewer: {
+        name: 'reviewer',
+        description: 'Code review: correctness, security, style, tests',
+        systemPrompt: `You are a Code Reviewer Agent. Your job is to review code for quality, security, and correctness.
+
+FOCUS AREAS:
+- Correctness: Does the code do what it's supposed to?
+- Security: No vulnerabilities, proper auth, input validation
+- Style: Consistency with project conventions
+- Tests: Adequate coverage, meaningful assertions
+- Performance: No obvious bottlenecks
+
+OUTPUT: A review summary with specific, actionable comments. Use todo tool to track review items.`,
+        allowedTools: ['read_file', 'search_files', 'list_files', 'terminal', 'git_diff', 'todo'],
+        canDelegate: false,
+        temperature: 0.1,
+    },
+    debugger: {
+        name: 'debugger',
+        description: 'Reproduces, isolates, and fixes bugs; adds logging; bisects',
+        systemPrompt: `You are a Debugger Agent. Your job is to find and fix bugs systematically.
+
+PROCESS:
+1. Reproduce the issue (run tests, create test case)
+2. Isolate the root cause (add logging, bisect, analyze stack traces)
+3. Implement minimal fix
+4. Verify fix works and doesn't regress
+
+TOOLS: read_file, write_file, patch, search_files, terminal, git_diff, git_status, todo.`,
+        allowedTools: ['read_file', 'write_file', 'patch', 'search_files', 'list_files', 'terminal', 'git_diff', 'git_status', 'todo'],
+        canDelegate: false,
+        temperature: 0.1,
+    },
+    researcher: {
+        name: 'researcher',
+        description: 'Web search, docs lookup, API exploration, unknowns',
+        systemPrompt: `You are a Research Agent. Your job is to gather information from external sources.
+
+CAPABILITIES:
+- Web search for technical information
+- Fetch and parse documentation
+- Explore APIs and libraries
+- Summarize findings for other agents
+
+OUTPUT: Concise summaries with source links. Use todo tool to track research questions.`,
+        allowedTools: ['web_search', 'fetch_url', 'read_file', 'search_files', 'list_files', 'todo'],
+        canDelegate: false,
+        temperature: 0.3,
+    },
+};
+// Get role by name, with fallback to coder
+export function getAgentRole(name) {
+    return AGENT_ROLES[name] ?? AGENT_ROLES.coder;
+}
+// Filter tools for a specific role
+export function filterToolsForRole(tools, roleName) {
+    const role = getAgentRole(roleName);
+    if (role.allowedTools.includes('*'))
+        return tools;
+    return tools.filter(t => role.allowedTools.includes(t.function.name));
+}
+//# sourceMappingURL=roles.js.map