cmdr-agent 1.0.0

package/dist/src/core/agent-runner.js

@@ -0,0 +1,251 @@
+/**
+ * AgentRunner — the core conversation loop engine for cmdr.
+ *
+ * Drives: LLM call -> tool extraction -> parallel execution -> tool results -> loop
+ */
+import { classifyIntent, filterToolsByIntent } from './intent.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractText(content) {
+    return content
+        .filter((b) => b.type === 'text')
+        .map(b => b.text)
+        .join('');
+}
+function extractToolUseBlocks(content) {
+    return content.filter((b) => b.type === 'tool_use');
+}
+function addTokenUsage(a, b) {
+    return {
+        input_tokens: a.input_tokens + b.input_tokens,
+        output_tokens: a.output_tokens + b.output_tokens,
+    };
+}
+const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+// ---------------------------------------------------------------------------
+// AgentRunner
+// ---------------------------------------------------------------------------
+export class AgentRunner {
+    adapter;
+    toolRegistry;
+    toolExecutor;
+    options;
+    permissionManager;
+    maxTurns;
+    constructor(adapter, toolRegistry, toolExecutor, options, permissionManager) {
+        this.adapter = adapter;
+        this.toolRegistry = toolRegistry;
+        this.toolExecutor = toolExecutor;
+        this.options = options;
+        this.permissionManager = permissionManager;
+        this.maxTurns = options.maxTurns ?? 10;
+    }
+    /** Run a complete conversation, collecting all stream events internally. */
+    async run(messages, callbacks = {}) {
+        let result = {
+            messages: [],
+            output: '',
+            toolCalls: [],
+            tokenUsage: ZERO_USAGE,
+            turns: 0,
+        };
+        for await (const event of this.stream(messages, callbacks)) {
+            if (event.type === 'done') {
+                result = event.data;
+            }
+        }
+        return result;
+    }
+    /** Run the conversation and yield StreamEvents incrementally.
+     *  Uses the adapter's stream() for real-time token-by-token output. */
+    async *stream(initialMessages, callbacks = {}) {
+        const conversationMessages = [...initialMessages];
+        let totalUsage = ZERO_USAGE;
+        const allToolCalls = [];
+        let finalOutput = '';
+        let turns = 0;
+        // Build the full tool set (may be narrowed per-turn by intent)
+        const allDefs = this.toolRegistry.toToolDefs();
+        const fullToolDefs = this.options.allowedTools
+            ? allDefs.filter(d => this.options.allowedTools.includes(d.name))
+            : allDefs;
+        // Extract latest user text for intent classification
+        const lastUserMsg = [...conversationMessages]
+            .reverse()
+            .find(m => m.role === 'user');
+        const lastUserText = lastUserMsg
+            ? lastUserMsg.content
+                .filter((b) => b.type === 'text')
+                .map(b => b.text)
+                .join('')
+            : '';
+        const intent = classifyIntent(lastUserText);
+        try {
+            while (true) {
+                if (this.options.abortSignal?.aborted)
+                    break;
+                if (turns >= this.maxTurns)
+                    break;
+                turns++;
+                // Dynamic tool injection:
+                // Turn 1 uses intent-filtered tools (may be empty for chat).
+                // Turns 2+ (model is mid-agentic-loop after tool results) get full tools.
+                const turnTools = turns === 1
+                    ? filterToolsByIntent(intent, fullToolDefs)
+                    : fullToolDefs;
+                const turnChatOptions = {
+                    model: this.options.model,
+                    tools: turnTools.length > 0 ? turnTools : undefined,
+                    maxTokens: this.options.maxTokens,
+                    temperature: this.options.temperature,
+                    systemPrompt: this.options.systemPrompt,
+                    abortSignal: this.options.abortSignal,
+                };
+                // Step 1: Stream from LLM — yield text tokens in real-time
+                const turnContent = [];
+                let turnText = '';
+                const pendingToolUse = [];
+                let turnUsage = ZERO_USAGE;
+                for await (const event of this.adapter.stream(conversationMessages, turnChatOptions)) {
+                    if (event.type === 'text') {
+                        const chunk = event.data;
+                        turnText += chunk;
+                        yield { type: 'text', data: chunk };
+                        callbacks.onText?.(chunk);
+                    }
+                    else if (event.type === 'tool_use') {
+                        const block = event.data;
+                        pendingToolUse.push(block);
+                        yield { type: 'tool_use', data: block };
+                    }
+                    else if (event.type === 'done') {
+                        const response = event.data;
+                        turnUsage = response.usage;
+                    }
+                    else if (event.type === 'error') {
+                        yield event;
+                        return;
+                    }
+                }
+                totalUsage = addTokenUsage(totalUsage, turnUsage);
+                // Build assistant content blocks
+                if (turnText) {
+                    turnContent.push({ type: 'text', text: turnText });
+                }
+                for (const block of pendingToolUse) {
+                    turnContent.push(block);
+                }
+                // Step 2: Build assistant message
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: turnContent,
+                };
+                conversationMessages.push(assistantMessage);
+                callbacks.onMessage?.(assistantMessage);
+                // Step 3: No tools? We're done.
+                if (pendingToolUse.length === 0) {
+                    finalOutput = turnText;
+                    break;
+                }
+                // Step 4: Execute all tool calls in parallel
+                const toolContext = {
+                    agent: {
+                        name: this.options.agentName ?? 'cmdr',
+                        role: this.options.agentRole ?? 'assistant',
+                        model: this.options.model,
+                    },
+                    cwd: this.options.cwd,
+                    abortSignal: this.options.abortSignal,
+                };
+                const executionPromises = pendingToolUse.map(async (block) => {
+                    callbacks.onToolCall?.(block.name, block.input);
+                    // --- HITL gate: check permissions before executing ---
+                    if (this.permissionManager && callbacks.onToolApproval) {
+                        const decision = await this.permissionManager.gate(block.name, block.input, callbacks.onToolApproval);
+                        if (decision === 'deny') {
+                            const deniedResult = {
+                                data: `Tool "${block.name}" was denied by the user.`,
+                                isError: true,
+                            };
+                            callbacks.onToolResult?.(block.name, deniedResult);
+                            const resultBlock = {
+                                type: 'tool_result',
+                                tool_use_id: block.id,
+                                content: deniedResult.data,
+                                is_error: true,
+                            };
+                            return { resultBlock, record: {
+                                    toolName: block.name,
+                                    input: block.input,
+                                    output: deniedResult.data,
+                                    duration: 0,
+                                } };
+                        }
+                    }
+                    const startTime = Date.now();
+                    let result;
+                    try {
+                        result = await this.toolExecutor.execute(block.name, block.input, toolContext);
+                    }
+                    catch (err) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        result = { data: message, isError: true };
+                    }
+                    const duration = Date.now() - startTime;
+                    callbacks.onToolResult?.(block.name, result);
+                    const record = {
+                        toolName: block.name,
+                        input: block.input,
+                        output: result.data,
+                        duration,
+                    };
+                    const resultBlock = {
+                        type: 'tool_result',
+                        tool_use_id: block.id,
+                        content: result.data,
+                        is_error: result.isError,
+                    };
+                    return { resultBlock, record };
+                });
+                const executions = await Promise.all(executionPromises);
+                // Step 5: Accumulate results
+                const toolResultBlocks = executions.map(e => e.resultBlock);
+                for (const { record, resultBlock } of executions) {
+                    allToolCalls.push(record);
+                    yield { type: 'tool_result', data: resultBlock };
+                }
+                const toolResultMessage = {
+                    role: 'user',
+                    content: toolResultBlocks,
+                };
+                conversationMessages.push(toolResultMessage);
+                callbacks.onMessage?.(toolResultMessage);
+                // Loop back — send updated conversation to LLM
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            yield { type: 'error', data: error };
+            return;
+        }
+        // If loop exited due to maxTurns, use last text
+        if (finalOutput === '' && conversationMessages.length > 0) {
+            const lastAssistant = [...conversationMessages]
+                .reverse()
+                .find(m => m.role === 'assistant');
+            if (lastAssistant) {
+                finalOutput = extractText(lastAssistant.content);
+            }
+        }
+        const runResult = {
+            messages: conversationMessages.slice(initialMessages.length),
+            output: finalOutput,
+            toolCalls: allToolCalls,
+            tokenUsage: totalUsage,
+            turns,
+        };
+        yield { type: 'done', data: runResult };
+    }
+}
+//# sourceMappingURL=agent-runner.js.map

package/dist/src/core/agent-runner.js.map

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

package/dist/src/core/agent.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Agent — high-level wrapper around AgentRunner.
+ *
+ * Provides persistent conversation (prompt), fresh-conversation (run), and streaming.
+ */
+import type { LLMAdapter, LLMMessage, AgentConfig, AgentState, AgentRunResult, StreamEvent } from './types.js';
+import { type RunCallbacks } from './agent-runner.js';
+import { ToolRegistry } from '../tools/registry.js';
+import type { PermissionManager } from './permissions.js';
+export declare class Agent {
+    readonly config: AgentConfig;
+    private readonly adapter;
+    private readonly toolRegistry;
+    private readonly toolExecutor;
+    private readonly permissionManager?;
+    private state;
+    private cwd;
+    constructor(config: AgentConfig, adapter: LLMAdapter, toolRegistry: ToolRegistry, cwd?: string, permissionManager?: PermissionManager);
+    /** Fresh conversation — does not carry history. */
+    run(task: string, callbacks?: RunCallbacks): Promise<AgentRunResult>;
+    /** Persistent conversation — appends to history. */
+    prompt(message: string, callbacks?: RunCallbacks): Promise<AgentRunResult>;
+    /** Streaming prompt — yields events in real time. */
+    stream(message: string, callbacks?: RunCallbacks): AsyncGenerator<StreamEvent>;
+    getState(): AgentState;
+    getHistory(): LLMMessage[];
+    reset(): void;
+    /** Replace internal message history (used after compaction). */
+    replaceMessages(messages: LLMMessage[]): void;
+    setCwd(cwd: string): void;
+    private createRunner;
+    private toAgentResult;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/src/core/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/core/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAC/C,cAAc,EAAc,WAAW,EACxC,MAAM,YAAY,CAAA;AACnB,OAAO,EAAe,KAAK,YAAY,EAAkB,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAIzD,qBAAa,KAAK;IAChB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,GAAG,CAAQ;gBAGjB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,GAAG,CAAC,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB;IAevC,mDAAmD;IAC7C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB1E,oDAAoD;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BhF,qDAAqD;IAC9C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,YAAY,GAAG,cAAc,CAAC,WAAW,CAAC;IAkCrF,QAAQ,IAAI,UAAU;IACtB,UAAU,IAAI,UAAU,EAAE;IAE1B,KAAK,IAAI,IAAI;IAIb,gEAAgE;IAChE,eAAe,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAI7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,aAAa;CAStB"}

package/dist/src/core/agent.js

@@ -0,0 +1,143 @@
+/**
+ * Agent — high-level wrapper around AgentRunner.
+ *
+ * Provides persistent conversation (prompt), fresh-conversation (run), and streaming.
+ */
+import { AgentRunner } from './agent-runner.js';
+import { ToolExecutor } from '../tools/executor.js';
+const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+export class Agent {
+    config;
+    adapter;
+    toolRegistry;
+    toolExecutor;
+    permissionManager;
+    state;
+    cwd;
+    constructor(config, adapter, toolRegistry, cwd, permissionManager) {
+        this.config = config;
+        this.adapter = adapter;
+        this.toolRegistry = toolRegistry;
+        this.toolExecutor = new ToolExecutor(toolRegistry);
+        this.permissionManager = permissionManager;
+        this.cwd = cwd ?? process.cwd();
+        this.state = {
+            status: 'idle',
+            messages: [],
+            tokenUsage: ZERO_USAGE,
+        };
+    }
+    /** Fresh conversation — does not carry history. */
+    async run(task, callbacks) {
+        const messages = [
+            { role: 'user', content: [{ type: 'text', text: task }] },
+        ];
+        this.state.status = 'running';
+        try {
+            const runner = this.createRunner();
+            const result = await runner.run(messages, callbacks);
+            this.state.status = 'completed';
+            return this.toAgentResult(result);
+        }
+        catch (err) {
+            this.state.status = 'error';
+            this.state.error = err instanceof Error ? err : new Error(String(err));
+            throw err;
+        }
+    }
+    /** Persistent conversation — appends to history. */
+    async prompt(message, callbacks) {
+        this.state.messages.push({
+            role: 'user',
+            content: [{ type: 'text', text: message }],
+        });
+        this.state.status = 'running';
+        try {
+            const runner = this.createRunner();
+            const result = await runner.run(this.state.messages, callbacks);
+            // Append new messages to history
+            for (const msg of result.messages) {
+                this.state.messages.push(msg);
+            }
+            this.state.tokenUsage = {
+                input_tokens: this.state.tokenUsage.input_tokens + result.tokenUsage.input_tokens,
+                output_tokens: this.state.tokenUsage.output_tokens + result.tokenUsage.output_tokens,
+            };
+            this.state.status = 'completed';
+            return this.toAgentResult(result);
+        }
+        catch (err) {
+            this.state.status = 'error';
+            this.state.error = err instanceof Error ? err : new Error(String(err));
+            throw err;
+        }
+    }
+    /** Streaming prompt — yields events in real time. */
+    async *stream(message, callbacks) {
+        this.state.messages.push({
+            role: 'user',
+            content: [{ type: 'text', text: message }],
+        });
+        this.state.status = 'running';
+        const runner = this.createRunner();
+        try {
+            for await (const event of runner.stream(this.state.messages, callbacks)) {
+                yield event;
+                if (event.type === 'done') {
+                    const result = event.data;
+                    for (const msg of result.messages) {
+                        this.state.messages.push(msg);
+                    }
+                    this.state.tokenUsage = {
+                        input_tokens: this.state.tokenUsage.input_tokens + result.tokenUsage.input_tokens,
+                        output_tokens: this.state.tokenUsage.output_tokens + result.tokenUsage.output_tokens,
+                    };
+                    this.state.status = 'completed';
+                }
+                else if (event.type === 'error') {
+                    this.state.status = 'error';
+                    this.state.error = event.data;
+                }
+            }
+        }
+        catch (err) {
+            this.state.status = 'error';
+            this.state.error = err instanceof Error ? err : new Error(String(err));
+        }
+    }
+    getState() { return { ...this.state }; }
+    getHistory() { return [...this.state.messages]; }
+    reset() {
+        this.state = { status: 'idle', messages: [], tokenUsage: ZERO_USAGE };
+    }
+    /** Replace internal message history (used after compaction). */
+    replaceMessages(messages) {
+        this.state.messages = [...messages];
+    }
+    setCwd(cwd) {
+        this.cwd = cwd;
+    }
+    createRunner() {
+        return new AgentRunner(this.adapter, this.toolRegistry, this.toolExecutor, {
+            model: this.config.model ?? 'qwen2.5-coder:14b',
+            systemPrompt: this.config.systemPrompt,
+            maxTurns: this.config.maxTurns ?? 30,
+            maxTokens: this.config.maxTokens,
+            temperature: this.config.temperature,
+            allowedTools: this.config.tools,
+            agentName: this.config.name,
+            agentRole: 'assistant',
+            cwd: this.cwd,
+        }, this.permissionManager);
+    }
+    toAgentResult(result) {
+        return {
+            success: true,
+            output: result.output,
+            messages: result.messages,
+            tokenUsage: result.tokenUsage,
+            toolCalls: result.toolCalls,
+        };
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/src/core/agent.js.map

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

package/dist/src/core/intent.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Intent classifier — determines what tools the model should receive
+ * based on the user's message.
+ *
+ * Inspired by claw-code's `simple_mode` pattern: don't tell the model
+ * about tools it doesn't need. When someone says "hi", the model gets
+ * zero tools, so it physically cannot start running glob/git_log.
+ *
+ * Three tiers:
+ *   conversational → no tools (just chat)
+ *   exploratory    → read-only tools (file_read, grep, glob, git_diff, git_log)
+ *   actionable     → full tool suite
+ */
+import type { LLMToolDef } from './types.js';
+export type UserIntent = 'conversational' | 'exploratory' | 'actionable';
+/**
+ * Classify the user's latest message to determine tool availability.
+ *
+ * The classifier is intentionally conservative — when in doubt it
+ * escalates to a higher tier (more tools). False negatives (giving
+ * tools when not needed) are less harmful than false positives
+ * (withholding tools when the user needs them).
+ */
+export declare function classifyIntent(message: string): UserIntent;
+/**
+ * Filter tool definitions based on intent.
+ *
+ * - conversational: returns empty array (no tools)
+ * - exploratory: returns only read-only tools
+ * - actionable: returns all tools
+ */
+export declare function filterToolsByIntent(intent: UserIntent, allTools: readonly LLMToolDef[]): LLMToolDef[];
+//# sourceMappingURL=intent.d.ts.map

package/dist/src/core/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAA;AA+BxE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA8B1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,SAAS,UAAU,EAAE,GAC9B,UAAU,EAAE,CASd"}

package/dist/src/core/intent.js

@@ -0,0 +1,91 @@
+/**
+ * Intent classifier — determines what tools the model should receive
+ * based on the user's message.
+ *
+ * Inspired by claw-code's `simple_mode` pattern: don't tell the model
+ * about tools it doesn't need. When someone says "hi", the model gets
+ * zero tools, so it physically cannot start running glob/git_log.
+ *
+ * Three tiers:
+ *   conversational → no tools (just chat)
+ *   exploratory    → read-only tools (file_read, grep, glob, git_diff, git_log)
+ *   actionable     → full tool suite
+ */
+// ---------------------------------------------------------------------------
+// Read-only tool set (exploratory tier)
+// ---------------------------------------------------------------------------
+const EXPLORATORY_TOOLS = new Set([
+    'file_read',
+    'grep',
+    'glob',
+    'git_diff',
+    'git_log',
+    'think',
+]);
+// ---------------------------------------------------------------------------
+// Intent detection heuristics
+// ---------------------------------------------------------------------------
+/** Words/phrases that signal the user wants the model to *do* something. */
+const ACTION_SIGNALS = /\b(fix|create|write|edit|add|remove|delete|refactor|implement|build|update|change|modify|rename|move|install|run|execute|deploy|migrate|convert|replace|rewrite|debug|patch|test|commit|push|merge|undo)\b/i;
+/** Words/phrases that signal the user wants to understand something. */
+const EXPLORE_SIGNALS = /\b(what is|what are|explain|describe|show me|how does|how do|where is|where are|find|search|look at|read|list|check|can you show|tell me about|look for|walk me through|overview)\b/i;
+/** Very short messages that are almost certainly conversational. */
+const GREETING_PATTERNS = /^(hi|hey|hello|yo|sup|thanks|thank you|ok|okay|cool|nice|great|good|sure|yep|nope|no|yes|bye|goodbye|cheers|what'?s up|how are you|how'?s it going|hm+|ah+)\b/i;
+/** Questions about the assistant itself — conversational, not actionable. */
+const META_PATTERNS = /\b(who are you|what are you|which model|what model|your name|what can you do|are you|tell me about yourself)\b/i;
+/**
+ * Classify the user's latest message to determine tool availability.
+ *
+ * The classifier is intentionally conservative — when in doubt it
+ * escalates to a higher tier (more tools). False negatives (giving
+ * tools when not needed) are less harmful than false positives
+ * (withholding tools when the user needs them).
+ */
+export function classifyIntent(message) {
+    const trimmed = message.trim();
+    // Empty or very short greetings → conversational
+    if (trimmed.length === 0)
+        return 'conversational';
+    if (GREETING_PATTERNS.test(trimmed))
+        return 'conversational';
+    if (META_PATTERNS.test(trimmed))
+        return 'conversational';
+    // Short messages (< 15 chars) with no action/explore signals → conversational
+    if (trimmed.length < 15 && !ACTION_SIGNALS.test(trimmed) && !EXPLORE_SIGNALS.test(trimmed)) {
+        return 'conversational';
+    }
+    // Clear action verbs → full tool suite
+    if (ACTION_SIGNALS.test(trimmed))
+        return 'actionable';
+    // Exploration language → read-only tools
+    if (EXPLORE_SIGNALS.test(trimmed))
+        return 'exploratory';
+    // Messages mentioning file paths or code constructs → actionable
+    if (/\.(ts|js|py|rs|go|java|c|cpp|h|json|yaml|yml|toml|md|html|css|sql)\b/.test(trimmed)) {
+        return 'actionable';
+    }
+    // Longer messages without clear signals → default to actionable
+    // (conservative: don't withhold tools on ambiguous requests)
+    if (trimmed.length >= 40)
+        return 'actionable';
+    // Medium-length messages that don't match anything → exploratory
+    return 'exploratory';
+}
+/**
+ * Filter tool definitions based on intent.
+ *
+ * - conversational: returns empty array (no tools)
+ * - exploratory: returns only read-only tools
+ * - actionable: returns all tools
+ */
+export function filterToolsByIntent(intent, allTools) {
+    switch (intent) {
+        case 'conversational':
+            return [];
+        case 'exploratory':
+            return allTools.filter(t => EXPLORATORY_TOOLS.has(t.name));
+        case 'actionable':
+            return [...allTools];
+    }
+}
+//# sourceMappingURL=intent.js.map

package/dist/src/core/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../src/core/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,8EAA8E;AAC9E,wCAAwC;AACxC,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,WAAW;IACX,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;CACR,CAAC,CAAA;AAEF,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,4EAA4E;AAC5E,MAAM,cAAc,GAAG,6MAA6M,CAAA;AAEpO,wEAAwE;AACxE,MAAM,eAAe,GAAG,sLAAsL,CAAA;AAE9M,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,gKAAgK,CAAA;AAE1L,6EAA6E;AAC7E,MAAM,aAAa,GAAG,iHAAiH,CAAA;AAEvI;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAE9B,iDAAiD;IACjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAA;IACjD,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC5D,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAExD,8EAA8E;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3F,OAAO,gBAAgB,CAAA;IACzB,CAAC;IAED,uCAAuC;IACvC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAA;IAErD,yCAAyC;IACzC,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,aAAa,CAAA;IAEvD,iEAAiE;IACjE,IAAI,sEAAsE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzF,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,gEAAgE;IAChE,6DAA6D;IAC7D,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE;QAAE,OAAO,YAAY,CAAA;IAE7C,iEAAiE;IACjE,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAkB,EAClB,QAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,gBAAgB;YACnB,OAAO,EAAE,CAAA;QACX,KAAK,aAAa;YAChB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5D,KAAK,YAAY;YACf,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;IACxB,CAAC;AACH,CAAC"}

package/dist/src/core/orchestrator.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Orchestrator — top-level coordinator for multi-agent workflows.
+ *
+ * Provides runAgent(), runTeam(), and runTasks() entry points.
+ */
+import type { AgentConfig, AgentRunResult, TeamConfig, TeamRunResult, Task, LLMAdapter, OrchestratorConfig, TokenUsage } from './types.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { PermissionManager } from './permissions.js';
+import { Team } from './team.js';
+import { TaskQueue } from '../communication/task-queue.js';
+export declare class Orchestrator {
+    private readonly adapter;
+    private readonly toolRegistry;
+    private readonly config;
+    private readonly permissionManager?;
+    private readonly cwd;
+    private activeTeam?;
+    constructor(adapter: LLMAdapter, toolRegistry: ToolRegistry, config?: OrchestratorConfig, cwd?: string, permissionManager?: PermissionManager);
+    /** Run a single agent on a task. */
+    runAgent(agentConfig: AgentConfig, task: string): Promise<AgentRunResult>;
+    /** Run a team on a goal. Returns aggregated results from all agents. */
+    runTeam(teamConfig: TeamConfig, goal: string): Promise<TeamRunResult>;
+    /**
+     * Run a set of tasks with dependency resolution and agent assignment.
+     * Uses topological ordering and semaphore-controlled parallelism.
+     */
+    runTasks(tasks: Task[], agentConfigs: readonly AgentConfig[]): Promise<{
+        results: Map<string, AgentRunResult>;
+        totalUsage: TokenUsage;
+    }>;
+    /** Get the active team (if any). */
+    getActiveTeam(): Team | undefined;
+    /** Get status of the active team. */
+    getStatus(): {
+        agents: Array<{
+            name: string;
+            status: string;
+        }>;
+        tasks?: ReturnType<TaskQueue['summary']>;
+    } | null;
+    private emit;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/core/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EACtD,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAqB,UAAU,EACpE,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAK1D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAM;gBAGvB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,kBAAuB,EAC/B,GAAG,CAAC,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB;IASvC,oCAAoC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB/E,wEAAwE;IAClE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB3E;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,IAAI,EAAE,EACb,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;IAwD5E,oCAAoC;IACpC,aAAa,IAAI,IAAI,GAAG,SAAS;IAIjC,qCAAqC;IACrC,SAAS,IAAI;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IAKjH,OAAO,CAAC,IAAI;CAGb"}