@nexus-cortex/cli 4.26.0

package/dist/commands/autoresearch/loop.js

@@ -0,0 +1,242 @@
+/**
+ * `cortex autoresearch loop` — the autonomous recursive loop: pick a goal, fix it in an
+ * isolated worktree, measure base-vs-candidate through the gate, KEEP only what verifies,
+ * advance the base, and repeat until a stop condition. The single-process, local analogue
+ * of the NPC swarm — useful for "improve project X until the metric clears a bar" without
+ * the container infrastructure.
+ *
+ * Each round:
+ *   1. Goal = --prompt, else the highest-priority workable backlog deficiency.
+ *   2. Create a candidate worktree detached at the current base ref.
+ *   3. Mutate it: --fixer-cmd (any transformer), else the LLM `cortex autoresearch fix`.
+ *   4. Commit the candidate (no change → skip the round).
+ *   5. Run `cortex autoresearch experiment` (base vs candidate) and read the verdict.
+ *   6. ACCEPT = mergeEligible when a holdout is given (keep + FWER + holdout-verified); with
+ *      no holdout, accept = keep-on-train (logged as UNVERIFIED — provide --holdout-set for
+ *      the overfitting guard). On accept: advance base to the candidate + anchor the loop
+ *      branch to it. On reject: drop the worktree.
+ *   7. Stop on: success metric met, max rounds, max consecutive stale rounds, or a dry backlog.
+ *
+ * GIT SAFETY: all work happens in throwaway worktrees off a dedicated loop branch
+ * (`autoresearch/loop-*`). The user's branch and working tree are never touched. Accepted
+ * candidate commits are anchored to the loop branch so detached-HEAD commits survive
+ * worktree removal; the operator merges the loop branch when satisfied.
+ */
+import { execFileSync, spawnSync } from 'node:child_process';
+import { mkdtempSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { ResearchBacklog } from '@nexus-cortex/core';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+function shQuote(s) { return `'${s.replace(/'/g, `'\\''`)}'`; }
+export async function autoResearchLoop(options) {
+    const theme = ThemeManager.getTheme();
+    const json = !!options.json;
+    const log = (m) => { if (!json)
+        console.log(theme.colors.muted(` ${m}`)); };
+    const self = process.argv[1]; // re-invoke this same CLI for fix/experiment
+    const miss = [];
+    if (!options.repo)
+        miss.push('--repo');
+    if (!options.taskSet)
+        miss.push('--task-set');
+    if (miss.length) {
+        console.error(theme.colors.error(`Error: missing ${miss.join(', ')}`));
+        process.exit(1);
+    }
+    const repo = resolve(options.repo);
+    const git = (args, cwd = repo) => execFileSync('git', ['-C', cwd, ...args], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+    const sh = (cmd, cwd) => spawnSync('sh', ['-c', cmd], { cwd, stdio: json ? 'ignore' : 'inherit' });
+    let baseRef;
+    try {
+        baseRef = options.baseRef ?? git(['rev-parse', 'HEAD']);
+    }
+    catch {
+        console.error(theme.colors.error(`Error: ${repo} is not a git repository`));
+        process.exit(1);
+        return;
+    }
+    const maxRounds = Number(options.maxRounds ?? '10');
+    const maxStale = Number(options.maxStale ?? String(maxRounds));
+    const branch = options.branch ?? `autoresearch/loop-${baseRef.slice(0, 8)}`;
+    const store = options.cortexDir ? resolve(options.cortexDir) : repo;
+    const backlog = new ResearchBacklog(repo);
+    const successMetric = options.successMetric
+        ? { taskId: options.successMetric.split(':')[0], threshold: Number(options.successMetric.split(':')[1]) }
+        : undefined;
+    // The loop branch anchors accepted candidate commits (so detached worktree commits survive).
+    try {
+        git(['branch', '-f', branch, baseRef]);
+    }
+    catch { /* branch may already exist at ref */ }
+    const worktrees = [];
+    const addWorktree = (ref) => {
+        const dir = mkdtempSync(join(tmpdir(), 'arloop-'));
+        git(['worktree', 'add', '--detach', dir, ref]);
+        worktrees.push(dir);
+        return dir;
+    };
+    const removeWorktree = (dir) => { try {
+        git(['worktree', 'remove', '--force', dir]);
+    }
+    catch { /* */ } };
+    let baseDir = addWorktree(baseRef);
+    const rounds = [];
+    let stale = 0;
+    let stop = 'max-rounds';
+    if (!json)
+        console.log(`\n ${theme.colors.highlight('Auto-research loop')}  repo=${repo}  branch=${branch}  base=${baseRef.slice(0, 8)}  max=${maxRounds}\n`);
+    try {
+        for (let r = 1; r <= maxRounds; r++) {
+            // 1. Goal
+            let goal = options.prompt;
+            let defId;
+            if (!goal) {
+                const d = backlog.next();
+                if (!d) {
+                    stop = 'backlog-dry';
+                    break;
+                }
+                goal = d.description;
+                defId = d.id;
+                backlog.markInProgress(d.id, `loop-r${r}`);
+            }
+            // 2. Candidate worktree at the current base.
+            const candDir = addWorktree(baseRef);
+            // 3. Mutate (fixer).
+            log(`r${r}: fixing → ${goal.slice(0, 80)}`);
+            if (options.fixerCmd) {
+                const cmd = options.fixerCmd.replace(/\{prompt\}/g, shQuote(goal));
+                const f = sh(cmd, candDir);
+                if (f.status !== 0) {
+                    log(`r${r}: fixer-cmd failed (exit ${f.status}) → skip`);
+                    removeWorktree(candDir);
+                    stale++;
+                    if (stale >= maxStale) {
+                        stop = 'max-stale';
+                        break;
+                    }
+                    continue;
+                }
+            }
+            else {
+                const f = spawnSync('node', [self, 'autoresearch', 'fix', '--cwd', candDir, '--prompt', goal, '--json'], { stdio: json ? 'ignore' : 'inherit' });
+                if (f.status !== 0) {
+                    log(`r${r}: fixer failed → skip`);
+                    removeWorktree(candDir);
+                    stale++;
+                    if (stale >= maxStale) {
+                        stop = 'max-stale';
+                        break;
+                    }
+                    continue;
+                }
+            }
+            // 4. Commit candidate (no change → skip the round).
+            git(['add', '-A'], candDir);
+            const dirty = spawnSync('git', ['-C', candDir, 'diff', '--cached', '--quiet']).status !== 0;
+            if (!dirty) {
+                log(`r${r}: no change → skip`);
+                removeWorktree(candDir);
+                stale++;
+                if (stale >= maxStale) {
+                    stop = 'max-stale';
+                    break;
+                }
+                continue;
+            }
+            git(['commit', '-q', '-m', `autoresearch loop r${r}: ${goal.slice(0, 60)}`], candDir);
+            const candRef = git(['rev-parse', '--short', 'HEAD'], candDir);
+            // 5. Experiment base vs candidate (subprocess → JSON verdict).
+            const expArgs = ['autoresearch', 'experiment',
+                '--experiment-tag', `loop-r${r}`,
+                '--base-dir', baseDir, '--candidate-dir', candDir,
+                '--base-ref', git(['rev-parse', '--short', 'HEAD'], baseDir), '--candidate-ref', candRef,
+                '--task-set', resolve(options.taskSet), '--no-build',
+                '--cortex-dir', store, '--runs', options.runs ?? '3', '--json'];
+            if (options.holdoutSet)
+                expArgs.push('--holdout-set', resolve(options.holdoutSet));
+            if (options.model)
+                expArgs.push('--model', options.model);
+            if (options.temperature)
+                expArgs.push('--temperature', options.temperature);
+            if (options.strategy)
+                expArgs.push('--strategy', options.strategy);
+            if (options.runCmd) {
+                expArgs.push('--run-cmd', options.runCmd, '--accept-exit', options.acceptExit ?? '0');
+                if (options.buildCmd)
+                    expArgs.push('--build-cmd', options.buildCmd);
+            }
+            const exp = spawnSync('node', [self, ...expArgs], { encoding: 'utf8' });
+            let res;
+            try {
+                res = JSON.parse(exp.stdout);
+            }
+            catch {
+                log(`r${r}: experiment produced no verdict → skip`);
+                removeWorktree(candDir);
+                stale++;
+                if (stale >= maxStale) {
+                    stop = 'max-stale';
+                    break;
+                }
+                continue;
+            }
+            const keep = res.verdict?.decision === 'keep';
+            const accept = options.holdoutSet ? !!res.mergeEligible : keep;
+            const candScore = (() => {
+                const s = res.benchSummaries?.candidate?.holdout ?? res.benchSummaries?.candidate?.train;
+                const t = s?.tasks?.find((x) => x.taskId === successMetric?.taskId);
+                return t?.meanScore;
+            })();
+            rounds.push({ round: r, candRef, decision: res.verdict?.decision, effect: res.verdict?.effect, mergeEligible: res.mergeEligible, accepted: accept, candScore });
+            log(`r${r}: ${res.verdict?.decision?.toUpperCase()} effect ${res.verdict?.effect}  ${accept ? theme.colors.success('ACCEPT') : theme.colors.error('reject')}${options.holdoutSet ? '' : ' (train-only, UNVERIFIED — pass --holdout-set)'}`);
+            // 6. Advance or discard.
+            if (accept) {
+                git(['branch', '-f', branch, candRef]); // anchor the accepted commit
+                removeWorktree(baseDir); // old base
+                baseDir = candDir;
+                baseRef = candRef;
+                stale = 0;
+                if (defId) {
+                    if (options.holdoutSet)
+                        backlog.markVerified(defId, `loop-r${r}`);
+                    else
+                        backlog.markFixed(defId, candRef);
+                }
+                if (successMetric && candScore != null && candScore >= successMetric.threshold) {
+                    stop = 'success';
+                    break;
+                }
+            }
+            else {
+                if (!options.keepWorktrees)
+                    removeWorktree(candDir);
+                stale++;
+                if (stale >= maxStale) {
+                    stop = 'max-stale';
+                    break;
+                }
+            }
+        }
+    }
+    finally {
+        // Anchor the final result on the loop branch, then clean every loop worktree.
+        try {
+            git(['branch', '-f', branch, baseRef]);
+        }
+        catch { /* */ }
+        for (const w of worktrees)
+            removeWorktree(w);
+    }
+    const out = { repo, branch, finalRef: baseRef, rounds: rounds.length, merges: rounds.filter(r => r.accepted).length, stop, history: rounds };
+    if (json) {
+        console.log(JSON.stringify(out, null, 2));
+        return;
+    }
+    console.log();
+    console.log(` ${theme.colors.highlight('Loop done')}  stop=${stop}  rounds=${rounds.length}  merges=${out.merges}`);
+    console.log(theme.colors.muted(` Result on branch ${branch} → ${baseRef.slice(0, 8)}. Merge it when satisfied:  git -C ${repo} merge ${branch}`));
+    console.log();
+}
+//# sourceMappingURL=loop.js.map

package/dist/commands/autoresearch/loop.js.map

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

package/dist/commands/cache/metrics.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cache Metrics Command
+ * Display prompt caching statistics
+ */
+export interface CacheMetricsOptions {
+    serverUrl?: string;
+    json?: boolean;
+}
+/**
+ * Display cache metrics
+ */
+export declare function cacheMetrics(_sessionId: string, options?: CacheMetricsOptions): Promise<void>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/commands/cache/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/commands/cache/metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CA4Ef"}

package/dist/commands/cache/metrics.js

@@ -0,0 +1,77 @@
+/**
+ * Cache Metrics Command
+ * Display prompt caching statistics
+ */
+import { OrchestratorClient } from '../../orchestrator/OrchestratorClient.js';
+import { ConfigManager } from '../../config/ConfigManager.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+/**
+ * Display cache metrics
+ */
+export async function cacheMetrics(_sessionId, options = {}) {
+    const config = await ConfigManager.load();
+    const theme = ThemeManager.getTheme();
+    // Determine mode from environment
+    const envMode = (process.env.CORTEX_MODE);
+    const mode = envMode === 'server' ? 'server' : 'direct';
+    const client = new OrchestratorClient({
+        mode,
+        serverUrl: options.serverUrl || config.serverUrl || 'http://localhost:4000',
+        debug: process.env.DEBUG === 'true'
+    });
+    try {
+        await client.initialize();
+        // Get cache metrics (sessionId not needed in direct mode)
+        const response = await client.getCacheMetrics();
+        // JSON output
+        if (options.json) {
+            console.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        // Formatted output
+        console.log(theme.colors.primary('\n Prompt Caching Metrics\n'));
+        if (response.metrics) {
+            const m = response.metrics;
+            console.log(theme.colors.secondary('Cache Activity:'));
+            console.log(` Total Requests: ${theme.colors.highlight(m.requestCount?.toString() || '0')}`);
+            console.log(` Requests with Cache Hits: ${theme.colors.highlight(m.requestsWithCacheHits?.toString() || '0')}`);
+            if (m.overallCacheHitRate) {
+                const hitRate = (m.overallCacheHitRate * 100).toFixed(1);
+                console.log(` Hit Rate: ${theme.colors.success(hitRate + '%')}`);
+            }
+            console.log();
+            console.log(theme.colors.secondary('Token Usage:'));
+            console.log(` Total Input Tokens: ${theme.colors.highlight(m.totalInputTokens?.toLocaleString() || '0')}`);
+            console.log(` Cache Creation: ${theme.colors.highlight(m.totalCacheCreationTokens?.toLocaleString() || '0')}`);
+            console.log(` Cache Reads: ${theme.colors.success(m.totalCacheReadTokens?.toLocaleString() || '0')}`);
+            console.log(` Uncached: ${theme.colors.muted(m.totalUncachedInputTokens?.toLocaleString() || '0')}`);
+            if (m.overallCostSavingsRatio) {
+                const costSavings = (m.overallCostSavingsRatio * 100).toFixed(1);
+                console.log(` Est. Cost Savings: ${theme.colors.success(costSavings + '%')}`);
+            }
+            console.log();
+            // Show provider breakdown
+            if (m.byProvider && Object.keys(m.byProvider).length > 0) {
+                console.log(theme.colors.secondary('By Provider:'));
+                for (const [provider, pm] of Object.entries(m.byProvider)) {
+                    const providerHitRate = pm.cacheHitRate ? `${(pm.cacheHitRate * 100).toFixed(1)}%` : '0%';
+                    console.log(` ${provider}: ${theme.colors.highlight(pm.cacheReadTokens.toLocaleString())} cached (${providerHitRate})`);
+                }
+                console.log();
+            }
+        }
+        if (response.report) {
+            console.log(theme.colors.secondary('Report:'));
+            console.log(theme.colors.muted(response.report));
+            console.log();
+        }
+    }
+    catch (error) {
+        console.error(theme.colors.error(`Error: ${error.message}`));
+        process.exitCode = 1;
+    }
+    finally {
+        await client.disconnect();
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/commands/cache/metrics.js.map

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

package/dist/commands/chat/AgenticChat.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Rich Agentic Chat Interface
+ * Orchestrates streaming responses with tool visualization
+ */
+export interface AgenticChatOptions {
+    serverUrl?: string;
+    model?: string;
+    system?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export declare class AgenticChat {
+    private client;
+    private messages;
+    private currentToolCalls;
+    private theme;
+    private extendedTheme;
+    private toolRenderer;
+    private rl;
+    private options;
+    constructor(options?: AgenticChatOptions);
+    /**
+     * Start the interactive chat
+     */
+    start(): Promise<void>;
+    /**
+     * Show prompt and handle user input
+     */
+    private prompt;
+    /**
+     * Handle a user message
+     */
+    private handleUserMessage;
+    /**
+     * Handle a stream event
+     */
+    private handleStreamEvent;
+}
+//# sourceMappingURL=AgenticChat.d.ts.map

package/dist/commands/chat/AgenticChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgenticChat.d.ts","sourceRoot":"","sources":["../../../src/commands/chat/AgenticChat.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,aAAa,CAAkD;IACvE,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,EAAE,CAAqB;IAC/B,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,kBAAuB;IAW5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACH,OAAO,CAAC,MAAM;IAqCd;;OAEG;YACW,iBAAiB;IA6D/B;;OAEG;YACW,iBAAiB;CA6EhC"}

package/dist/commands/chat/AgenticChat.js

@@ -0,0 +1,201 @@
+/**
+ * Rich Agentic Chat Interface
+ * Orchestrates streaming responses with tool visualization
+ */
+import { CortexClient } from '../../client/CortexClient.js';
+import { ThemeManager } from '../../themes/ThemeManager.js';
+import { ToolRenderer } from './renderers/ToolRenderer.js';
+import * as readline from 'readline';
+export class AgenticChat {
+    client;
+    messages = [];
+    currentToolCalls = new Map();
+    theme = ThemeManager.getTheme();
+    extendedTheme = ThemeManager.getExtendedTheme();
+    toolRenderer;
+    rl;
+    options;
+    constructor(options = {}) {
+        this.options = options;
+        this.client = new CortexClient(options.serverUrl);
+        this.toolRenderer = new ToolRenderer(this.theme);
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+    }
+    /**
+     * Start the interactive chat
+     */
+    async start() {
+        // Enhanced header with rounded box
+        console.log();
+        console.log(this.extendedTheme.doubleBox(`Nexus Cortex - Agentic Chat\n` +
+            `Advanced streaming with tool visualization\n` +
+            `Commands: "exit" to quit, "clear" to reset`, ' Agentic Mode'));
+        console.log();
+        if (this.options.model) {
+            console.log(this.extendedTheme.infoMessage(`Model: ${this.theme.colors.highlight(this.options.model)}`));
+        }
+        console.log(this.extendedTheme.dimmed('Real-time streaming • Tool execution • Enhanced feedback'));
+        console.log();
+        this.prompt();
+    }
+    /**
+     * Show prompt and handle user input
+     */
+    prompt() {
+        this.rl.question(this.theme.colors.info('\n❯ You: '), async (input) => {
+            const userInput = input.trim();
+            // Handle commands
+            if (userInput.toLowerCase() === 'exit') {
+                console.log();
+                console.log(this.extendedTheme.roundedBox('Thank you for using Agentic Chat!\n' +
+                    'Session saved automatically.', ' Goodbye'));
+                console.log();
+                this.rl.close();
+                return;
+            }
+            if (userInput.toLowerCase() === 'clear') {
+                this.messages.length = 0;
+                this.currentToolCalls.clear();
+                console.log();
+                console.log(this.extendedTheme.successMessage('Conversation history cleared'));
+                console.log();
+                this.prompt();
+                return;
+            }
+            if (!userInput) {
+                this.prompt();
+                return;
+            }
+            await this.handleUserMessage(userInput);
+            this.prompt();
+        });
+    }
+    /**
+     * Handle a user message
+     */
+    async handleUserMessage(input) {
+        // Add user message
+        this.messages.push({
+            role: 'user',
+            content: input,
+        });
+        try {
+            console.log();
+            console.log(this.theme.colors.secondary(' Assistant:'));
+            console.log(this.extendedTheme.dimmed('─'.repeat(50)));
+            console.log();
+            let currentText = '';
+            const contentBlocks = [];
+            // Stream the response
+            for await (const event of this.client.streamMessage(this.messages, {
+                model: this.options.model,
+                system: this.options.system,
+                max_tokens: this.options.maxTokens,
+                temperature: this.options.temperature,
+                tools: [], // Enable all tools
+            })) {
+                await this.handleStreamEvent(event, contentBlocks);
+                // Track text for final message
+                if (event.type === 'content_block_delta' && event.delta?.type === 'text_delta') {
+                    currentText += event.delta.text;
+                }
+            }
+            // Add assistant message to history
+            if (contentBlocks.length > 0 || currentText) {
+                this.messages.push({
+                    role: 'assistant',
+                    content: contentBlocks.length > 0 ? contentBlocks : currentText,
+                });
+            }
+            // Clear current tool calls for next message
+            this.currentToolCalls.clear();
+            // Show stats
+            console.log();
+            console.log(this.extendedTheme.dimmed('─'.repeat(50)));
+            console.log(this.extendedTheme.dimmed(`Messages: ${this.messages.length} | Tools used: ${contentBlocks.filter(b => b.type === 'tool_use').length}`));
+        }
+        catch (error) {
+            console.log();
+            console.log(this.extendedTheme.errorMessage(error.message));
+            console.log();
+            // Show helpful hints
+            if (error.message.includes('ECONNREFUSED')) {
+                console.log(this.extendedTheme.infoMessage('Hint: Server not responding'));
+                console.log(this.extendedTheme.dimmed(' Try: npm run dev:full'));
+            }
+        }
+    }
+    /**
+     * Handle a stream event
+     */
+    async handleStreamEvent(event, contentBlocks) {
+        switch (event.type) {
+            case 'message_start':
+                // Message starting, no action needed
+                break;
+            case 'content_block_start':
+                if (event.content_block) {
+                    contentBlocks.push(event.content_block);
+                    // If it's a tool use, initialize tracking
+                    if (event.content_block.type === 'tool_use') {
+                        const toolCall = {
+                            id: event.content_block.id || 'unknown',
+                            name: event.content_block.name || 'unknown',
+                            input: event.content_block.input || {},
+                            status: 'running',
+                        };
+                        this.currentToolCalls.set(toolCall.id, toolCall);
+                        // Render tool start
+                        console.log('\n' + this.toolRenderer.renderToolStart(toolCall) + '\n');
+                    }
+                }
+                break;
+            case 'content_block_delta':
+                if (event.delta?.type === 'text_delta') {
+                    // Stream text character by character
+                    process.stdout.write(event.delta.text);
+                }
+                else if (event.delta?.type === 'input_json_delta') {
+                    // Tool input accumulation (if needed)
+                }
+                break;
+            case 'content_block_stop':
+                // Block completed
+                break;
+            case 'tool_result':
+                // Tool execution completed
+                const toolId = event.tool_use_id;
+                const toolCall = this.currentToolCalls.get(toolId);
+                if (toolCall) {
+                    toolCall.status = event.is_error ? 'error' : 'success';
+                    toolCall.result = event.content;
+                    toolCall.error = event.is_error ? event.content : undefined;
+                    // Render tool result
+                    console.log(this.toolRenderer.renderToolResult(toolCall) + '\n');
+                    // Add tool result to content blocks
+                    contentBlocks.push({
+                        type: 'tool_result',
+                        tool_use_id: toolId,
+                        content: event.content,
+                        is_error: event.is_error,
+                    });
+                }
+                break;
+            case 'message_delta':
+                // Usage stats, ignore for now
+                break;
+            case 'message_stop':
+                // Message complete
+                break;
+            default:
+                // Unknown event type
+                if (process.env.DEBUG) {
+                    console.log(this.theme.colors.muted(`[Unknown event: ${event.type}]`));
+                }
+        }
+    }
+}
+//# sourceMappingURL=AgenticChat.js.map

package/dist/commands/chat/AgenticChat.js.map

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