codehere 0.1.0 → 0.3.0

package/README.md

@@ -31,23 +31,47 @@ Once installed globally, you can use `codehere` from any directory in your termi
 
 ### Quick Start
 
+**First Time Setup:**
+
 ```bash
-# Set up your Cohere API key (in your project directory)
-echo "COHERE_API_KEY=your_key_here" > .env
+# 1. Run the interactive setup wizard
+codehere setup
+
+# This will:
+#   - Detect your API key (or guide you to configure it)
+#   - Detect your codebase
+#   - Configure model preferences
+#   - Set up your environment
 
-# Index your codebase
+# 2. Index your codebase
 codehere index
 
-# Start interactive session
-codehere
+# 3. Start using Codehere!
+codehere "How does authentication work?"
+```
 
-# Or use commands directly
+**Using Codehere:**
+
+```bash
+# Natural language queries (unified command)
+codehere "explain this function"
+codehere "add error handling to src/utils.ts"
+codehere "refactor user service to use dependency injection"
+
+# Or use explicit commands
 codehere ask "How does authentication work?"
 codehere explain src/utils.ts
-codehere fix src/utils.ts "Add error handling"
-codehere fix src/utils.ts "Add error handling" --dry-run  # Preview changes
-codehere scaffold node-api ./playground/todo-api  # Scaffold app skeleton
-codehere debug-search "logging"  # Debug search results
+codehere plan "implement user authentication system"
+codehere orchestrate "add comprehensive logging"
+
+# Manage configuration
+codehere config                    # Show current configuration
+codehere config set autoCommit true
+codehere config get defaultModel
+
+# Get help
+codehere --help
+codehere help <command>
 ```
 
 ## ✨ Features
@@ -118,29 +142,31 @@ codehere debug-search "logging"  # Debug search results
 
 ## 📈 Use Cases
 
+Codehere helps developers, teams, and enterprises in many ways:
+
 ### For Developers
-- Understand large codebases quickly
-- Get context-aware answers about code
-- Safely refactor with AI assistance
-- Learn from code explanations
+- **Onboard faster**: Understand new codebases in hours, not days
+- **Debug smarter**: AI-powered reasoning to find root causes
+- **Refactor safely**: Automatic verification and rollback
+- **Learn continuously**: Get explanations of any code
 
 ### For Teams
-- Onboard new developers faster
-- Document code automatically
-- Enforce coding standards
-- Audit code changes
+- **Better documentation**: Auto-generate accurate, up-to-date docs
+- **Faster code reviews**: AI-assisted review catches issues early
+- **Consistent patterns**: Learn and apply team conventions automatically
+- **Knowledge sharing**: Preserve and share patterns across projects
 
 ### For Enterprises
-- Code review assistance
-- Compliance logging
-- Safe AI-assisted development
-- Knowledge base building
+- **Secure by default**: Built-in security scanning and audit trails
+- **Privacy-first**: Local processing, code never leaves your machine
+- **Productivity metrics**: Track ROI and developer productivity
+- **Organizational memory**: Build knowledge that survives team changes
 
-## 📚 Documentation
+**See [docs/USE_CASES.md](../docs/USE_CASES.md) for detailed scenarios and examples.**
 
-**Main Reference:** See [docs/CODEHERE_LIVING_DOC.md](docs/CODEHERE_LIVING_DOC.md) for the complete design, roadmap, and current capabilities.
+## 🧪 Testing
 
-This is the single source of truth for CodeHere's vision, current state, limitations, and future plans.
+See [TESTING.md](TESTING.md) for complete testing guide.
 
 **Test Results:**
 - ✅ Indexing: Working with retry logic

package/dist/agents/base.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Base Agent Interface
+ * Foundation for multi-agent system in Codehere
+ *
+ * These agents ARE Codehere - they help end-users.
+ * But organizing them this way makes it easier for YOU to develop and improve Codehere.
+ */
+import type { IntentResult } from '../intent/classifier.js';
+import type { QueryContext } from '../intent/context.js';
+/**
+ * Request to an agent
+ */
+export interface AgentRequest {
+    query: string;
+    context: QueryContext;
+    intent: IntentResult;
+    caller?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Response from an agent
+ */
+export interface AgentResponse {
+    success: boolean;
+    result?: any;
+    message?: string;
+    error?: string;
+    suggestions?: string[];
+    nextAgent?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Agent interface
+ * Each agent owns a specific domain (e.g., ScaffoldAgent owns all templates)
+ */
+export interface Agent {
+    /** Unique agent name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** What this agent can do */
+    capabilities: string[];
+    /** Other agents this agent can call */
+    canCall: string[];
+    /** Handle a request */
+    handle(request: AgentRequest): Promise<AgentResponse>;
+    /** Check if this agent can handle a request */
+    canHandle?(request: AgentRequest): boolean;
+    /** Validate request before handling */
+    validate?(request: AgentRequest): boolean;
+}
+/**
+ * Base agent class
+ * Provides common functionality for all agents
+ */
+export declare abstract class BaseAgent implements Agent {
+    abstract name: string;
+    abstract description: string;
+    abstract capabilities: string[];
+    abstract canCall: string[];
+    abstract handle(request: AgentRequest): Promise<AgentResponse>;
+    /** Agent registry (set by OrchestratorAgent) */
+    protected agentRegistry?: AgentRegistry;
+    /**
+     * Call another agent
+     * Enables agent-to-agent collaboration
+     */
+    protected callAgent(agentName: string, request: AgentRequest): Promise<AgentResponse>;
+    /**
+     * Default canHandle implementation
+     * Checks if intent matches agent's name
+     */
+    canHandle(request: AgentRequest): boolean;
+    /**
+     * Default validate implementation
+     * Can be overridden by subclasses
+     */
+    validate(request: AgentRequest): boolean;
+}
+/**
+ * Agent Registry
+ * Manages all agents in the system
+ */
+export declare class AgentRegistry {
+    private agents;
+    /**
+     * Register an agent
+     */
+    register(agent: Agent): void;
+    /**
+     * Get an agent by name
+     */
+    get(name: string): Agent | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAll(): Agent[];
+    /**
+     * Get agents by capability
+     */
+    getByCapability(capability: string): Agent[];
+    /**
+     * Get agent names
+     */
+    getNames(): string[];
+}
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IAEpB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,uCAAuC;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,uBAAuB;IACvB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAEtD,+CAA+C;IAC/C,SAAS,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAE3C,uCAAuC;IACvC,QAAQ,CAAC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;CAC3C;AAED;;;GAGG;AACH,8BAAsB,SAAU,YAAW,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAE3B,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAE9D,gDAAgD;IAChD,SAAS,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IAExC;;;OAGG;cACa,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,aAAa,CAAC;IA8BzB;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAIzC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CAGzC;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA4B;IAE1C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAS5B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE;IAM5C;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/dist/agents/base.js

@@ -0,0 +1,101 @@
+/**
+ * Base Agent Interface
+ * Foundation for multi-agent system in Codehere
+ *
+ * These agents ARE Codehere - they help end-users.
+ * But organizing them this way makes it easier for YOU to develop and improve Codehere.
+ */
+/**
+ * Base agent class
+ * Provides common functionality for all agents
+ */
+export class BaseAgent {
+    /** Agent registry (set by OrchestratorAgent) */
+    agentRegistry;
+    /**
+     * Call another agent
+     * Enables agent-to-agent collaboration
+     */
+    async callAgent(agentName, request) {
+        if (!this.agentRegistry) {
+            return {
+                success: false,
+                error: 'AgentRegistry not set. Cannot call other agents.',
+            };
+        }
+        const agent = this.agentRegistry.get(agentName);
+        if (!agent) {
+            return {
+                success: false,
+                error: `Agent "${agentName}" not found. Available agents: ${this.agentRegistry.getAll().map(a => a.name).join(', ')}`,
+            };
+        }
+        // Check if this agent is allowed to call the target agent
+        if (!this.canCall.includes(agentName) && this.canCall.length > 0) {
+            return {
+                success: false,
+                error: `Agent "${this.name}" is not allowed to call "${agentName}". Allowed: ${this.canCall.join(', ')}`,
+            };
+        }
+        return agent.handle({
+            ...request,
+            caller: this.name,
+        });
+    }
+    /**
+     * Default canHandle implementation
+     * Checks if intent matches agent's name
+     */
+    canHandle(request) {
+        return request.intent.intent === this.name;
+    }
+    /**
+     * Default validate implementation
+     * Can be overridden by subclasses
+     */
+    validate(request) {
+        return true;
+    }
+}
+/**
+ * Agent Registry
+ * Manages all agents in the system
+ */
+export class AgentRegistry {
+    agents = new Map();
+    /**
+     * Register an agent
+     */
+    register(agent) {
+        this.agents.set(agent.name, agent);
+        // Set agent registry on BaseAgent instances
+        if (agent instanceof BaseAgent) {
+            agent.agentRegistry = this;
+        }
+    }
+    /**
+     * Get an agent by name
+     */
+    get(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get all registered agents
+     */
+    getAll() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get agents by capability
+     */
+    getByCapability(capability) {
+        return this.getAll().filter(agent => agent.capabilities.includes(capability));
+    }
+    /**
+     * Get agent names
+     */
+    getNames() {
+        return Array.from(this.agents.keys());
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/agents/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/agents/base.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwDH;;;GAGG;AACH,MAAM,OAAgB,SAAS;IAQ7B,gDAAgD;IACtC,aAAa,CAAiB;IAExC;;;OAGG;IACO,KAAK,CAAC,SAAS,CACvB,SAAiB,EACjB,OAAqB;QAErB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,kDAAkD;aAC1D,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU,SAAS,kCAAkC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACtH,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,6BAA6B,SAAS,eAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACzG,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,CAAC;YAClB,GAAG,OAAO;YACV,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAqB;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,OAAqB;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,KAAY;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEnC,4CAA4C;QAC5C,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC9B,KAAa,CAAC,aAAa,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,CACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/agents/orchestrator-model-driven.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Model-Driven Orchestrator
+ * Uses minimal prompts to let model make routing decisions
+ * Following Claude Code approach: minimal prompts, model-driven decisions
+ */
+import { BaseAgent } from './base.js';
+import type { AgentRequest, AgentResponse, AgentRegistry } from './base.js';
+export declare class ModelDrivenOrchestratorAgent extends BaseAgent {
+    name: string;
+    description: string;
+    capabilities: string[];
+    canCall: string[];
+    private registry;
+    private toolExecutor;
+    constructor(registry: AgentRegistry);
+    /**
+     * Handle query - let model choose the agent or tool
+     */
+    handle(request: AgentRequest): Promise<AgentResponse>;
+    /**
+     * Get LLM response (can be overridden for testing)
+     */
+    protected getLLMResponse(prompt: string): Promise<string>;
+    /**
+     * Build prompt for model
+     */
+    private buildPrompt;
+    /**
+     * Get available agents with descriptions
+     */
+    private getAvailableAgents;
+    /**
+     * Generate contextual error message
+     */
+    private generateError;
+    /**
+     * Generate contextual suggestions
+     */
+    private generateSuggestions;
+}
+//# sourceMappingURL=orchestrator-model-driven.d.ts.map

package/dist/agents/orchestrator-model-driven.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-model-driven.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator-model-driven.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM5E,qBAAa,4BAA6B,SAAQ,SAAS;IACzD,IAAI,SAAkB;IACtB,WAAW,SAAoE;IAC/E,YAAY,WAA2D;IACvE,OAAO,EAAE,MAAM,EAAE,CAAM;IAEvB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;gBAEvB,QAAQ,EAAE,aAAa;IAOnC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAmE3D;;OAEG;cACa,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;YACW,aAAa;IAI3B;;OAEG;YACW,mBAAmB;CAOlC"}

package/dist/agents/orchestrator-model-driven.js

@@ -0,0 +1,141 @@
+/**
+ * Model-Driven Orchestrator
+ * Uses minimal prompts to let model make routing decisions
+ * Following Claude Code approach: minimal prompts, model-driven decisions
+ */
+import { BaseAgent } from './base.js';
+import { chatWithContext } from '../chat.js';
+import { getToolRegistry } from '../tools/registry.js';
+import { ToolExecutor } from '../tools/executor.js';
+import { parseToolCalls } from '../tools/parser.js';
+export class ModelDrivenOrchestratorAgent extends BaseAgent {
+    name = 'orchestrator';
+    description = 'Model-driven orchestrator that lets AI choose agents and tools';
+    capabilities = ['routing', 'model-driven-decisions', 'tool-execution'];
+    canCall = [];
+    registry;
+    toolExecutor;
+    constructor(registry) {
+        super();
+        this.registry = registry;
+        this.agentRegistry = registry;
+        this.toolExecutor = new ToolExecutor();
+    }
+    /**
+     * Handle query - let model choose the agent or tool
+     */
+    async handle(request) {
+        // Get list of available agents
+        const availableAgents = this.getAvailableAgents();
+        // Get list of available tools
+        const toolRegistry = getToolRegistry();
+        const availableTools = toolRegistry.getAll();
+        // Let model choose agent or tool
+        const prompt = this.buildPrompt(request.query, availableAgents, availableTools);
+        try {
+            const response = await this.getLLMResponse(prompt);
+            // 1. Check for tool calls first
+            const toolCalls = parseToolCalls(response);
+            if (toolCalls.length > 0) {
+                console.log(`🛠️ Orchestrator: Executing ${toolCalls.length} tool call(s)`);
+                const results = await this.toolExecutor.executeAll(toolCalls);
+                // Check if any tool failed
+                const failures = results.filter(r => !r.success);
+                if (failures.length > 0) {
+                    return {
+                        success: false,
+                        error: `Tool execution failed: ${failures.map(f => f.error).join(', ')}`,
+                        message: `I tried to execute some tools but encountered errors:\n${failures.map(f => `- ${f.tool}: ${f.error}`).join('\n')}`,
+                    };
+                }
+                // Format tool results
+                const output = results.map(r => `Tool '${r.tool}' executed successfully:\n${JSON.stringify(r.result, null, 2)}`).join('\n\n');
+                return {
+                    success: true,
+                    message: output,
+                    metadata: { toolResults: results }
+                };
+            }
+            // 2. If no tools, check for agent selection
+            const selectedAgentName = response.trim().split('\n')[0].toLowerCase(); // Simple heuristic
+            const selectedAgent = this.registry.get(selectedAgentName);
+            if (selectedAgent) {
+                console.log(`🤖 Orchestrator: Routing to ${selectedAgentName}`);
+                return await selectedAgent.handle(request);
+            }
+            // 3. Fallback: Treat response as direct answer
+            return {
+                success: true,
+                message: response
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+                message: await this.generateError(request.query, err instanceof Error ? err.message : String(err)),
+                suggestions: await this.generateSuggestions(request.query),
+            };
+        }
+    }
+    /**
+     * Get LLM response (can be overridden for testing)
+     */
+    async getLLMResponse(prompt) {
+        return chatWithContext(prompt, []);
+    }
+    /**
+     * Build prompt for model
+     */
+    buildPrompt(query, agents, tools) {
+        const agentList = agents.map(a => `- ${a.name}: ${a.description}`).join('\n');
+        const toolList = tools.map(t => `- ${t.name}: ${t.modelDescription}`).join('\n');
+        return `Query: "${query}"
+
+Available Agents:
+${agentList}
+
+Available Tools:
+${toolList}
+
+INSTRUCTIONS:
+1. If a specific agent is best suited, respond with JUST the agent name.
+2. If a tool can solve this directly (e.g. running a command, editing a file), use the tool.
+3. If you can answer directly, provide the answer.
+
+What should be done?`;
+    }
+    /**
+     * Get available agents with descriptions
+     */
+    getAvailableAgents() {
+        const agents = [];
+        const allAgents = this.registry.getAll();
+        for (const agent of allAgents) {
+            if (agent.name !== 'orchestrator') { // Don't include self
+                agents.push({
+                    name: agent.name,
+                    description: agent.description || `Handles ${agent.name} requests`,
+                });
+            }
+        }
+        return agents;
+    }
+    /**
+     * Generate contextual error message
+     */
+    async generateError(query, error) {
+        return `An error occurred while processing your query: ${error}`;
+    }
+    /**
+     * Generate contextual suggestions
+     */
+    async generateSuggestions(query) {
+        return [
+            'Try rephrasing your query',
+            'Be more specific about what you want',
+            'Check if all required information is provided',
+        ];
+    }
+}
+//# sourceMappingURL=orchestrator-model-driven.js.map

package/dist/agents/orchestrator-model-driven.js.map

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

package/dist/agents/react-orchestrator-agent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ReAct Orchestrator Agent
+ * Uses ReAct loop for reasoning and tool execution
+ */
+import { BaseAgent } from './base.js';
+import type { AgentRequest, AgentResponse } from './base.js';
+export declare class ReActOrchestratorAgent extends BaseAgent {
+    name: string;
+    description: string;
+    capabilities: string[];
+    canCall: string[];
+    handle(request: AgentRequest): Promise<AgentResponse>;
+    private getAvailableAgents;
+}
+//# sourceMappingURL=react-orchestrator-agent.d.ts.map

package/dist/agents/react-orchestrator-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-orchestrator-agent.d.ts","sourceRoot":"","sources":["../../src/agents/react-orchestrator-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI7D,qBAAa,sBAAuB,SAAQ,SAAS;IACnD,IAAI,SAAwB;IAC5B,WAAW,SAAuD;IAClE,YAAY,WAA+D;IAC3E,OAAO,EAAE,MAAM,EAAE,CAAM;IAEjB,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA2C3D,OAAO,CAAC,kBAAkB;CAI3B"}

package/dist/agents/react-orchestrator-agent.js

@@ -0,0 +1,54 @@
+/**
+ * ReAct Orchestrator Agent
+ * Uses ReAct loop for reasoning and tool execution
+ */
+import { BaseAgent } from './base.js';
+import { container } from '../application/services/dependency-container.js';
+import { getToolRegistry } from '../tools/registry.js';
+export class ReActOrchestratorAgent extends BaseAgent {
+    name = 'react-orchestrator';
+    description = 'ReAct-based orchestrator with iterative reasoning';
+    capabilities = ['react-reasoning', 'tool-execution', 'memory-integration'];
+    canCall = [];
+    async handle(request) {
+        const useCase = container.reactOrchestrationUseCase;
+        const toolRegistry = getToolRegistry();
+        // Build context with available tools
+        const context = {
+            availableTools: toolRegistry.getToolList(),
+            availableAgents: this.getAvailableAgents(),
+        };
+        try {
+            const result = await useCase.execute({
+                query: request.query,
+                context,
+                maxTurns: 20,
+            });
+            // Record observation in memory
+            if (result.trajectory.success) {
+                await container.memoryStreamService.recordObservation(`Successfully handled: ${request.query}`, { trajectory: result.trajectory });
+            }
+            return {
+                success: result.trajectory.success,
+                message: result.answer,
+                metadata: {
+                    trajectory: result.trajectory,
+                    memoriesUsed: result.memoriesUsed.length,
+                    steps: result.trajectory.steps.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                message: `ReAct orchestration failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    getAvailableAgents() {
+        // Return list of available agent names
+        return ['editor', 'search', 'code-analysis', 'scaffold', 'general'];
+    }
+}
+//# sourceMappingURL=react-orchestrator-agent.js.map

package/dist/agents/react-orchestrator-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-orchestrator-agent.js","sourceRoot":"","sources":["../../src/agents/react-orchestrator-agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,iDAAiD,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACnD,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAAG,mDAAmD,CAAC;IAClE,YAAY,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;IAC3E,OAAO,GAAa,EAAE,CAAC;IAEvB,KAAK,CAAC,MAAM,CAAC,OAAqB;QAChC,MAAM,OAAO,GAAG,SAAS,CAAC,yBAAyB,CAAC;QACpD,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QAEvC,qCAAqC;QACrC,MAAM,OAAO,GAAG;YACd,cAAc,EAAE,YAAY,CAAC,WAAW,EAAE;YAC1C,eAAe,EAAE,IAAI,CAAC,kBAAkB,EAAE;SAC3C,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC;gBACnC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO;gBACP,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YAEH,+BAA+B;YAC/B,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;gBAC9B,MAAM,SAAS,CAAC,mBAAmB,CAAC,iBAAiB,CACnD,yBAAyB,OAAO,CAAC,KAAK,EAAE,EACxC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAClC,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO;gBAClC,OAAO,EAAE,MAAM,CAAC,MAAM;gBACtB,QAAQ,EAAE;oBACR,UAAU,EAAE,MAAM,CAAC,UAAU;oBAC7B,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;oBACxC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM;iBACtC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7D,OAAO,EAAE,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,uCAAuC;QACvC,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/application/agents/execution-agent.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Application Agent: Execution Agent (Code Migration)
+ * Specialized agent for performing mechanical changes across files
+ *
+ * Based on enterprise architecture: Separate Execution Agent
+ * Role: Executes plans created by Planning Agent
+ */
+import type { IAIService } from '../../domain/interfaces/ai-service.interface.js';
+import type { ToolExecutorService } from '../services/tool-executor-service.js';
+import type { Plan } from '../../domain/entities/plan.js';
+import type { Observation } from '../../domain/services/react-loop.js';
+export interface ExecutionRequest {
+    plan: Plan;
+    subPlanId?: string;
+    context?: Record<string, any>;
+}
+export interface ExecutionResult {
+    subPlanId: string;
+    success: boolean;
+    result?: any;
+    error?: string;
+    observations: Observation[];
+    duration: number;
+}
+export interface ExecutionResponse {
+    plan: Plan;
+    results: ExecutionResult[];
+    overallSuccess: boolean;
+    completedSubPlans: number;
+    totalSubPlans: number;
+}
+export declare class ExecutionAgent {
+    private aiService;
+    private toolExecutor;
+    private cwd;
+    private gitTool;
+    constructor(aiService: IAIService, toolExecutor: ToolExecutorService, cwd?: string);
+    /**
+     * Execute plan or specific sub-plan
+     */
+    execute(request: ExecutionRequest): Promise<ExecutionResponse>;
+    /**
+     * Commit successful changes to Git
+     * Only commits if there are actual file modifications
+     */
+    private commitSuccessfulChanges;
+    /**
+     * Mark sub-plans with failed dependencies as failed
+     */
+    private markBlockedSubPlans;
+    /**
+     * Get sub-plans ready for execution (dependencies satisfied)
+     */
+    private getExecutableSubPlans;
+    /**
+     * Execute a single sub-plan
+     */
+    private executeSubPlan;
+    /**
+     * Create action from sub-plan
+     */
+    private createActionFromSubPlan;
+    /**
+     * Extract action parameters from sub-plan description
+     */
+    private extractParameters;
+}
+//# sourceMappingURL=execution-agent.d.ts.map