codehere 0.1.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024
+
+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,378 @@
+# Codehere
+
+> **AI coding assistant that helps you learn and understand your codebase**
+
+**🎓 Learning-First • 🔒 Privacy-Focused • 🔌 Multi-Provider**
+
+**v0.1.0** - Early release with core features. Built for developers who want to understand their code, not just generate it.
+
+---
+
+## What It Does (v0.1.0)
+
+✅ **Index** - Build semantic search index of your codebase
+✅ **Ask** - Natural language queries about your code with context
+✅ **Plan** - Break down complex development tasks into steps
+✅ **Edit** - **Enterprise-grade code editing with security, verification, and governance** ⭐ NEW
+✅ **Multi-Provider** - Works with OpenAI, Cohere, Ollama, OpenRouter, local models
+✅ **Local-First** - SQLite storage, per-repository isolation, privacy-focused
+
+## What's Coming
+
+⏳ **Multi-file Edit** - Edit across multiple files simultaneously (v0.2.0)
+⏳ **Fix** - Automated bug fixing with context (v0.2.0)
+⏳ **Refactor** - Intelligent multi-file refactoring (v0.2.0)
+
+---
+
+## Philosophy
+
+**We believe:**
+- Learning > Dependency
+- Explanations > Solutions
+- Augmentation > Replacement
+
+Codehere explains the "why", not just the "what". It teaches patterns, not just code.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g codehere
+```
+
+### 2. Setup
+
+```bash
+# OpenAI (recommended for v0.1.0)
+export CODEHERE_AI_PROVIDER=openai
+export CODEHERE_OPENAI_API_KEY=sk-...
+
+# Or Cohere
+export CODEHERE_AI_PROVIDER=cohere
+export COHERE_API_KEY=your-key
+
+# Or Ollama (local, private)
+export CODEHERE_AI_PROVIDER=local
+export CODEHERE_LOCAL_BASE_URL=http://localhost:11434
+```
+
+### 3. Index Your Project
+
+```bash
+cd your-project
+codehere index
+```
+
+### 4. Ask Questions
+
+```bash
+codehere ask "how does authentication work?"
+codehere ask "where is error handling done?"
+codehere ask "explain the database schema"
+```
+
+### 5. Plan Tasks
+
+```bash
+codehere plan "add rate limiting to the API"
+codehere plan "refactor user service for better testability"
+```
+
+---
+
+## Core Features
+
+### 📚 Semantic Search
+
+Index your codebase once, query it naturally:
+
+```bash
+codehere index                    # Build embeddings
+codehere ask "how do we handle payments?"  # Query with AI
+```
+
+**What it does:**
+- Chunks your code intelligently
+- Creates embeddings (vector representations)
+- Stores in local SQLite (`.codehere-cache/`)
+- Retrieves relevant context for queries
+- Never sends your code externally (with local models)
+
+### 🤖 Multi-Provider Support
+
+Switch between providers seamlessly:
+
+```bash
+# OpenAI (GPT-4, GPT-4o, o1, o3)
+export CODEHERE_AI_PROVIDER=openai
+
+# Cohere (Command-R, Command-R+)
+export CODEHERE_AI_PROVIDER=cohere
+
+# OpenRouter (400+ models)
+export CODEHERE_AI_PROVIDER=openrouter
+
+# Ollama (local)
+export CODEHERE_AI_PROVIDER=local
+
+# Custom endpoint
+export CODEHERE_AI_PROVIDER=local
+export CODEHERE_LOCAL_BASE_URL=http://your-endpoint
+```
+
+No vendor lock-in. Your embeddings and configuration work with any provider.
+
+### 🎯 Task Planning
+
+Break down complex tasks:
+
+```bash
+codehere plan "migrate from REST to GraphQL"
+```
+
+Returns:
+- Step-by-step breakdown
+- Files that need changes
+- Potential risks
+- Testing strategy
+
+### ✏️ Enterprise-Grade Code Editing ⭐ NEW
+
+Edit code with enterprise security and governance:
+
+```bash
+codehere edit src/auth.ts "add rate limiting"
+codehere edit src/api.ts "optimize performance" --explain
+codehere edit src/config.ts "add feature" --show-cost
+```
+
+**What makes our edit command superior:**
+
+| Feature | Codehere | Claude Code | Aider | Cursor | GitHub Copilot |
+|---------|----------|-------------|-------|--------|----------------|
+| Multi-provider support | ✅ Any LLM | ❌ Claude only | ✅ Any | ❌ Proprietary | ⚠️ Limited |
+| Cost transparency | ✅ Per-op costs | ❌ Hidden | ❌ No | ❌ Hidden | ❌ Hidden |
+| Learning mode (explains changes) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Security scanning (SAST+License+Bias) | ✅ Full suite | ⚠️ Basic | ❌ No | ⚠️ Basic | ⚠️ Basic |
+| Automatic verification + rollback | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Team standards validation | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Enterprise governance (NIST AI RMF) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Policy-as-Code compliance | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Bi-directional learning | ✅ Learns from you | ❌ No | ❌ No | ❌ No | ❌ No |
+| Prompt-to-code lineage tracking | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| HITL validation | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |
+| Privacy (local-first) | ✅ Complete | ❌ Cloud | ⚠️ Optional | ❌ Cloud | ❌ Cloud |
+
+**Why this matters:**
+- **Multi-provider**: Never locked into one vendor. Compare GPT-4 vs Claude vs local models.
+- **Cost transparency**: Know exactly what each edit costs before you commit.
+- **Learning mode**: Understand WHY changes are made, become a better developer.
+- **Enterprise security**: Built-in SAST, license checks, bias detection, uncertainty quantification.
+- **Governance**: NIST AI RMF compliance, policy-as-code, audit trails for regulated industries.
+- **Privacy**: Your code never leaves your machine with local models.
+
+### 🔒 Privacy-Focused
+
+**Local-first architecture:**
+- SQLite storage (not cloud databases)
+- Per-repository isolation
+- No telemetry
+- No analytics
+- Your code = your data
+
+**Works completely offline** with Ollama or local models.
+
+---
+
+## Configuration
+
+```bash
+# Show current config
+codehere config
+
+# Interactive setup wizard
+codehere setup
+
+# Check system health
+codehere health
+
+# List available models
+codehere models
+```
+
+---
+
+## Commands
+
+| Command | Status | Description |
+|---------|--------|-------------|
+| `index` | ✅ Stable | Build embeddings index |
+| `ask` | ✅ Stable | Query your codebase |
+| `plan` | ✅ Stable | Break down tasks |
+| `edit` | ✅ **Stable** ⭐ | **Enterprise-grade code editing** |
+| `config` | ✅ Stable | Manage settings |
+| `models` | ✅ Stable | List providers/models |
+| `setup` | ✅ Stable | Interactive wizard |
+| `health` | ✅ Stable | System diagnostics |
+| `suggest` | ⚠️ Beta | Read-only queries |
+| `fix` | ⚠️ Beta | Automated bug fixing (uses edit) |
+| `refactor` | ⏳ v0.2.0 | Multi-file refactoring |
+
+---
+
+## Requirements
+
+- **Node.js** 20+ (22+ recommended)
+- **TypeScript/JavaScript** codebase (other languages partially supported)
+- **API Key** for your chosen provider (or Ollama for local)
+
+---
+
+## Examples
+
+### Understanding Authentication
+
+```bash
+$ codehere ask "explain the authentication flow"
+
+Answer:
+The authentication uses JWT tokens with a two-step process:
+
+1. Login (POST /api/auth/login):
+   - Validates credentials in auth-service.ts:45
+   - Generates JWT with 24h expiry in token-manager.ts:89
+   - Returns token + refresh token
+
+2. Protected Routes:
+   - Middleware in auth-middleware.ts:23 verifies JWT
+   - Extracts user from token payload
+   - Attaches to req.user for downstream handlers
+
+Key files:
+  - src/services/auth-service.ts
+  - src/middleware/auth-middleware.ts
+  - src/utils/token-manager.ts
+
+Potential improvements:
+  - Add rate limiting on login endpoint
+  - Consider refresh token rotation
+  - Add session invalidation on logout
+```
+
+### Planning a Feature
+
+```bash
+$ codehere plan "add rate limiting to API endpoints"
+
+Plan:
+1. Install rate-limiting library (express-rate-limit)
+   Risk: Medium - Choose library carefully
+   Files: package.json
+
+2. Create rate-limit middleware
+   Risk: Low - Standard pattern
+   Files: src/middleware/rate-limit.ts
+
+3. Apply to routes
+   Risk: Medium - Don't rate-limit health checks
+   Files: src/routes/*.ts
+
+4. Add configuration
+   Risk: Low
+   Files: src/config/rate-limits.ts
+
+5. Add tests
+   Risk: Low
+   Files: test/middleware/rate-limit.test.ts
+
+Testing approach:
+- Unit tests for middleware
+- Integration tests for actual rate limiting
+- Load testing to verify limits work under pressure
+```
+
+---
+
+## Roadmap
+
+### v0.1.0 (Current) ✅
+- Index, Ask, Plan commands
+- Multi-provider support
+- Local-first storage
+
+### v0.2.0 (Next)
+- Multi-file editing
+- Git integration (auto-commits)
+- IDE extension (VS Code)
+
+### v0.3.0
+- Refactor command (multi-file changes)
+- Better TypeScript support
+- Performance optimizations
+
+### v1.0.0
+- All core features stable
+- Production-ready
+- Comprehensive documentation
+
+---
+
+## Status & Limitations
+
+**v0.1.0 is an early release.**
+
+**What works well:**
+- ✅ Indexing TypeScript/JavaScript projects
+- ✅ Semantic search and context retrieval
+- ✅ Task planning and breakdown
+- ✅ Multi-provider abstraction
+- ✅ Code editing with security validation
+- ✅ Automatic backup and rollback
+
+**Known limitations:**
+- ⚠️ Large repos (>100K lines) may be slow to index
+- ⚠️ Multi-file editing not yet implemented
+- ⚠️ Non-TS/JS files have limited support
+- ⚠️ Embeddings need refresh after major code changes
+- ⚠️ IDE integration coming in v0.2.0
+
+**We're being honest about capabilities.** If something doesn't work, we want to know: [GitHub Issues](https://github.com/muhammadegaa/codehere/issues)
+
+---
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines.
+
+**Priority areas for v0.2.0:**
+- Multi-file editing
+- Git integration
+- VS Code extension
+
+---
+
+## License
+
+MIT License - see [LICENSE](../LICENSE) for details
+
+---
+
+## Philosophy
+
+Codehere is built on the belief that **developers should understand their code, not just generate it.**
+
+We focus on:
+- **Learning** - Explaining patterns and decisions
+- **Transparency** - Showing how conclusions are reached
+- **Augmentation** - Making developers better, not replacing them
+
+This is v0.1.0. We're learning too. Help us build something better.
+
+---
+
+**Questions?** Open an issue or discussion on GitHub.
+**Security concerns?** See [SECURITY.md](../.internal/docs/SECURITY.md)

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"}