@qduc/term2 0.6.0 → 0.6.1

package/dist/modes/companion/command-index.test.js

@@ -0,0 +1,86 @@
+import test from 'ava';
+import { formatCommandIndex, generateCommandIndexPrompt, estimateTokens, } from './command-index.js';
+// Helper to create a test index entry
+function createIndexEntry(index, command, exitCode = 0, relativeTime = '5s ago', outputLines = 10, hasErrors = false) {
+    return {
+        index,
+        command,
+        exitCode,
+        relativeTime,
+        outputLines,
+        hasErrors,
+    };
+}
+test('formatCommandIndex returns message for empty array', t => {
+    const result = formatCommandIndex([]);
+    t.is(result, 'No recent commands.');
+});
+test('formatCommandIndex formats single entry', t => {
+    const entries = [createIndexEntry(0, 'npm test', 0, '5s ago', 100)];
+    const result = formatCommandIndex(entries);
+    t.true(result.includes('[0]'));
+    t.true(result.includes('npm test'));
+    t.true(result.includes('✓'));
+    t.true(result.includes('exit:0'));
+    t.true(result.includes('5s ago'));
+    t.true(result.includes('100 lines'));
+});
+test('formatCommandIndex shows ✗ for non-zero exit code', t => {
+    const entries = [createIndexEntry(0, 'npm test', 1, '5s ago', 100)];
+    const result = formatCommandIndex(entries);
+    t.true(result.includes('✗'));
+});
+test('formatCommandIndex formats multiple entries', t => {
+    const entries = [
+        createIndexEntry(0, 'npm test', 1, '5s ago', 100),
+        createIndexEntry(1, 'git status', 0, '30s ago', 10),
+        createIndexEntry(2, 'npm install', 0, '2m ago', 500),
+    ];
+    const result = formatCommandIndex(entries);
+    const lines = result.split('\n');
+    t.is(lines.length, 3);
+    t.true(lines[0].includes('[0]'));
+    t.true(lines[1].includes('[1]'));
+    t.true(lines[2].includes('[2]'));
+});
+test('formatCommandIndex truncates long commands', t => {
+    const longCommand = 'npm run very-long-script-name-that-exceeds-width';
+    const entries = [createIndexEntry(0, longCommand)];
+    const result = formatCommandIndex(entries);
+    // Should be truncated to 25 chars
+    t.true(result.length < longCommand.length + 100);
+});
+test('generateCommandIndexPrompt includes context header', t => {
+    const entries = [createIndexEntry(0, 'npm test')];
+    const result = generateCommandIndexPrompt(entries);
+    t.true(result.includes('Terminal Context'));
+    t.true(result.includes('recent commands'));
+});
+test('generateCommandIndexPrompt includes formatted index', t => {
+    const entries = [createIndexEntry(0, 'npm test', 0, '5s ago', 100)];
+    const result = generateCommandIndexPrompt(entries);
+    t.true(result.includes('npm test'));
+    t.true(result.includes('[0]'));
+});
+test('generateCommandIndexPrompt includes tool usage hint', t => {
+    const entries = [createIndexEntry(0, 'npm test')];
+    const result = generateCommandIndexPrompt(entries);
+    t.true(result.includes('terminal_history'));
+});
+test('estimateTokens returns reasonable estimate', t => {
+    const entries = [
+        createIndexEntry(0, 'npm test', 0, '5s ago', 100),
+        createIndexEntry(1, 'git status', 0, '30s ago', 10),
+    ];
+    const tokens = estimateTokens(entries);
+    // ~4 chars per token, each entry is ~60 chars
+    t.true(tokens > 20);
+    t.true(tokens < 100);
+});
+test('estimateTokens returns 0 for empty index', t => {
+    const entries = [];
+    const tokens = estimateTokens(entries);
+    // "No recent commands." is ~20 chars, ~5 tokens
+    t.true(tokens < 10);
+});
+//# sourceMappingURL=command-index.test.js.map

package/dist/modes/companion/command-index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-index.test.js","sourceRoot":"","sources":["../../../source/modes/companion/command-index.test.ts"],"names":[],"mappings":"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"}

package/dist/modes/companion/companion-app.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { ISettingsService, ILoggingService } from '../../services/service-interfaces.js';
+export interface CompanionAppProps {
+    settingsService: ISettingsService;
+    loggingService: ILoggingService;
+}
+/**
+ * Main companion mode application.
+ * Wraps user's shell in a PTY and provides AI assistance.
+ */
+export declare const CompanionApp: React.FC<CompanionAppProps>;
+//# sourceMappingURL=companion-app.d.ts.map

package/dist/modes/companion/companion-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-app.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/companion-app.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAW9D,OAAO,KAAK,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,sCAAsC,CAAC;AAqC5F,MAAM,WAAW,iBAAiB;IAC9B,eAAe,EAAE,gBAAgB,CAAC;IAClC,cAAc,EAAE,eAAe,CAAC;CACnC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAyTpD,CAAC"}

package/dist/modes/companion/companion-app.js

@@ -0,0 +1,297 @@
+import React, { useEffect, useState, useCallback } from 'react';
+import { Box, Text, useInput, useApp } from 'ink';
+import { PTYWrapper } from './pty-wrapper.js';
+import { ContextBuffer } from './context-buffer.js';
+import { ModeManager } from './mode-manager.js';
+import { EventDetector } from './event-detector.js';
+import { Summarizer } from './summarizer.js';
+import { StatusBar } from './components/status-bar.js';
+import { CompanionSession } from './companion-session.js';
+import { parseCompanionInput, CommandOutputBuffer } from './input-parser.js';
+import { getPtyInputSequence } from './input-key-mapper.js';
+/** Height reserved at bottom of terminal for status bar and AI response */
+const STATUS_BAR_RESERVED_ROWS = 4;
+/**
+ * Infer exit code from command output patterns.
+ * Since PTY doesn't provide per-command exit codes, we use heuristics.
+ */
+function inferExitCodeFromOutput(output) {
+    const lowerOutput = output.toLowerCase();
+    // Common error patterns that indicate failure
+    const errorPatterns = [
+        /\berror\b/i,
+        /\bfail(ed|ure)?\b/i,
+        /\bfatal\b/i,
+        /\bexception\b/i,
+        /\bcommand not found\b/i,
+        /\bno such file\b/i,
+        /\bpermission denied\b/i,
+        /\bdoes not exist\b/i,
+        /\bcannot\b/i,
+        /\bexit status [1-9]/i,
+        /\bexit code [1-9]/i,
+        /\breturned [1-9]/i,
+    ];
+    for (const pattern of errorPatterns) {
+        if (pattern.test(lowerOutput)) {
+            return 1;
+        }
+    }
+    return 0; // Assume success if no error patterns found
+}
+/**
+ * Main companion mode application.
+ * Wraps user's shell in a PTY and provides AI assistance.
+ */
+export const CompanionApp = ({ settingsService, loggingService, }) => {
+    const { exit } = useApp();
+    // Core services
+    const [ptyWrapper] = useState(() => new PTYWrapper({ logger: loggingService }));
+    const [contextBuffer] = useState(() => new ContextBuffer({
+        maxSize: settingsService.get('companion.maxContextBufferSize') || 1048576,
+        maxCommands: settingsService.get('companion.maxCommandIndexSize') || 10,
+    }));
+    const [modeManager] = useState(() => new ModeManager());
+    const [eventDetector] = useState(() => new EventDetector({
+        errorCascadeThreshold: settingsService.get('companion.errorCascadeThreshold') || 3,
+        retryLoopThreshold: settingsService.get('companion.retryLoopThreshold') || 2,
+        pauseHintDelayMs: settingsService.get('companion.pauseHintDelayMs') || 30000,
+    }));
+    const [summarizer] = useState(() => new Summarizer({
+        settings: settingsService,
+        logger: loggingService,
+    }));
+    const [companionSession] = useState(() => new CompanionSession({
+        contextBuffer,
+        summarizer,
+        settings: settingsService,
+        logger: loggingService,
+    }));
+    const [commandOutputBuffer] = useState(() => new CommandOutputBuffer());
+    // UI state
+    const [currentMode, setCurrentMode] = useState(modeManager.mode);
+    const [hint, setHint] = useState();
+    const [isProcessing, setIsProcessing] = useState(false);
+    const [error, setError] = useState();
+    const [aiResponse, setAiResponse] = useState('');
+    // Input buffer for detecting ?? and !auto
+    const [inputLine, setInputLine] = useState('');
+    // Handle ?? query
+    const handleQuery = useCallback(async (query) => {
+        setIsProcessing(true);
+        setAiResponse('');
+        setHint(undefined);
+        try {
+            for await (const event of companionSession.handleWatchQuery(query)) {
+                if (event.type === 'text' && event.content) {
+                    setAiResponse(prev => prev + event.content);
+                }
+                else if (event.type === 'error') {
+                    loggingService.error('Query failed', { error: event.content });
+                }
+            }
+        }
+        finally {
+            setIsProcessing(false);
+        }
+    }, [companionSession, loggingService]);
+    // Handle !auto task
+    const handleAutoTask = useCallback(async (task) => {
+        setIsProcessing(true);
+        setAiResponse('');
+        setHint(undefined);
+        modeManager.enterAutoMode();
+        try {
+            for await (const event of companionSession.handleAutoTask(task)) {
+                if (event.type === 'text' && event.content) {
+                    setAiResponse(prev => prev + event.content);
+                }
+                else if (event.type === 'tool_call' && event.tool) {
+                    loggingService.info('Tool call', { tool: event.tool, args: event.args });
+                }
+                else if (event.type === 'error') {
+                    loggingService.error('Auto task failed', { error: event.content });
+                }
+            }
+        }
+        finally {
+            setIsProcessing(false);
+            modeManager.enterWatchMode();
+        }
+    }, [companionSession, modeManager, loggingService]);
+    // Setup PTY and event handlers
+    useEffect(() => {
+        // Mode change handler
+        modeManager.on('modeChange', (mode) => {
+            setCurrentMode(mode);
+            loggingService.info('Mode changed', { mode });
+        });
+        // Event detector hint handler
+        eventDetector.on('hint', (event) => {
+            if (settingsService.get('companion.showHints') !== false) {
+                setHint(event.message);
+            }
+        });
+        // PTY output handler
+        ptyWrapper.on('output', (data) => {
+            // Pass through to stdout
+            process.stdout.write(data);
+            // Process output for command boundary detection
+            const completed = commandOutputBuffer.processData(data);
+            if (completed) {
+                // Infer exit code from output patterns when not available directly
+                // This is a heuristic since PTY doesn't provide per-command exit codes
+                const inferredExitCode = inferExitCodeFromOutput(completed.output);
+                const entry = {
+                    command: completed.command,
+                    output: completed.output,
+                    exitCode: inferredExitCode,
+                    timestamp: Date.now(),
+                    outputLines: completed.output.split('\n').length,
+                };
+                contextBuffer.addEntry(entry);
+                // Check for patterns
+                const event = eventDetector.processCommand(entry);
+                if (event && settingsService.get('companion.showHints') !== false) {
+                    setHint(event.message);
+                }
+            }
+            // Mark activity
+            eventDetector.markActivity();
+        });
+        // PTY exit handler
+        ptyWrapper.on('exit', (exitCode) => {
+            loggingService.info('PTY exited', { exitCode });
+            exit();
+        });
+        // PTY error handler
+        ptyWrapper.on('error', (err) => {
+            loggingService.error('PTY error', { error: err.message });
+            setError(err.message);
+        });
+        // Start PTY
+        ptyWrapper.start();
+        process.stdout.write('\x1b[?25h');
+        // Setup terminal resize handling
+        const handleResize = () => {
+            if (process.stdout.columns && process.stdout.rows) {
+                // Reserve bottom rows for status bar and AI response
+                ptyWrapper.resize(process.stdout.columns, process.stdout.rows - STATUS_BAR_RESERVED_ROWS);
+            }
+        };
+        process.stdout.on('resize', handleResize);
+        handleResize();
+        return () => {
+            process.stdout.off('resize', handleResize);
+            ptyWrapper.stop();
+            process.stdout.write('\x1b[?25h');
+        };
+    }, [
+        ptyWrapper,
+        contextBuffer,
+        commandOutputBuffer,
+        modeManager,
+        eventDetector,
+        settingsService,
+        loggingService,
+        exit,
+    ]);
+    // Handle keyboard input
+    useInput((input, key) => {
+        // Ctrl+C to exit or abort
+        if (key.ctrl && input === 'c') {
+            if (isProcessing) {
+                companionSession.abort();
+                setIsProcessing(false);
+            }
+            else {
+                ptyWrapper.stop();
+                exit();
+            }
+            return;
+        }
+        // Clear hint on any input
+        if (hint) {
+            setHint(undefined);
+        }
+        const isSpecialCommandInput = inputLine.startsWith('??') || inputLine.startsWith('!auto');
+        const ptySequence = getPtyInputSequence(input, key);
+        if (key.upArrow || key.downArrow || key.leftArrow || key.rightArrow) {
+            if (!isSpecialCommandInput && ptySequence) {
+                ptyWrapper.write(ptySequence);
+            }
+            return;
+        }
+        // Build up input line to detect ?? and !auto commands
+        let newInputLine = inputLine;
+        if (input === '\r' || input === '\n') {
+            const parsed = parseCompanionInput(inputLine);
+            if (parsed.type === 'query') {
+                // ?? query detected - handle with AI instead of passing to shell
+                handleQuery(parsed.content);
+                setInputLine('');
+                // Write newline to keep terminal output clean
+                process.stdout.write('\n');
+                return;
+            }
+            if (parsed.type === 'auto') {
+                // !auto command detected - handle with AI instead of passing to shell
+                handleAutoTask(parsed.content);
+                setInputLine('');
+                // Write newline to keep terminal output clean
+                process.stdout.write('\n');
+                return;
+            }
+            // Normal command - pass Enter to PTY and track for context
+            ptyWrapper.write(input);
+            if (inputLine.trim()) {
+                commandOutputBuffer.startCommand(inputLine.trim());
+            }
+            setInputLine('');
+            return;
+        }
+        if (key.backspace || key.delete) {
+            newInputLine = inputLine.slice(0, -1);
+            setInputLine(newInputLine);
+            if (isSpecialCommandInput) {
+                process.stdout.write('\b \b');
+                return;
+            }
+            if (ptySequence) {
+                ptyWrapper.write(ptySequence);
+            }
+            return;
+        }
+        // Accumulate input
+        newInputLine = inputLine + input;
+        setInputLine(newInputLine);
+        // Check if we're building a ?? or !auto command
+        // If so, echo locally but don't send to PTY yet
+        if (newInputLine.startsWith('??') || newInputLine.startsWith('!auto')) {
+            // Echo the character locally (since we're not sending to PTY)
+            process.stdout.write(input);
+        }
+        else {
+            // Normal input - pass through to PTY
+            ptyWrapper.write(input);
+        }
+    });
+    if (error) {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { color: "red" },
+                "Error: ",
+                error),
+            React.createElement(Text, { color: "gray" }, "Press Ctrl+C to exit")));
+    }
+    // The main rendering is handled by PTY direct output to stdout
+    // We only render the status bar and AI response via Ink
+    const defaultRows = 24; // Standard terminal height fallback
+    const marginTop = process.stdout.rows
+        ? process.stdout.rows - STATUS_BAR_RESERVED_ROWS
+        : defaultRows - STATUS_BAR_RESERVED_ROWS;
+    return (React.createElement(Box, { flexDirection: "column", position: "absolute", marginTop: marginTop },
+        aiResponse && (React.createElement(Box, { borderStyle: "single", borderColor: "cyan", paddingX: 1, marginBottom: 1 },
+            React.createElement(Text, { color: "cyan" }, aiResponse))),
+        React.createElement(StatusBar, { mode: currentMode, hint: hint, isProcessing: isProcessing })));
+};
+//# sourceMappingURL=companion-app.js.map

package/dist/modes/companion/companion-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-app.js","sourceRoot":"","sources":["../../../source/modes/companion/companion-app.tsx"],"names":[],"mappings":"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"}

package/dist/modes/companion/companion-session.d.ts

@@ -0,0 +1,63 @@
+import type { ContextBuffer } from './context-buffer.js';
+import type { Summarizer } from './summarizer.js';
+import type { ISettingsService, ILoggingService } from '../../services/service-interfaces.js';
+import type { CompanionMode } from './mode-manager.js';
+export interface CompanionAgentClient {
+    chat: (message: string, options?: {
+        model?: string;
+        reasoningEffort?: string;
+        instructions?: string;
+    }) => Promise<string>;
+    startStream: (userInput: string | any[], options?: {
+        previousResponseId?: string | null;
+    }) => Promise<any>;
+    abort: () => void;
+}
+export interface CompanionSessionDeps {
+    contextBuffer: ContextBuffer;
+    summarizer: Summarizer;
+    settings: ISettingsService;
+    logger: ILoggingService;
+    agentClient?: CompanionAgentClient;
+}
+export interface CompanionEvent {
+    type: 'text' | 'tool_call' | 'complete' | 'error' | 'approval_required' | 'blocked';
+    content?: string;
+    tool?: string;
+    args?: unknown;
+    safety?: 'green' | 'yellow' | 'red';
+    reason?: string;
+}
+/**
+ * Lightweight session for companion mode queries.
+ *
+ * Unlike chat mode's ConversationSession:
+ * - No persistent conversation history (each query is standalone)
+ * - No previousResponseId chaining
+ * - Simpler approval flow (Auto mode only)
+ */
+export declare class CompanionSession {
+    #private;
+    constructor(deps: CompanionSessionDeps);
+    /**
+     * Get the summarizer instance (for terminal_history tool integration).
+     */
+    get summarizer(): Summarizer;
+    get mode(): CompanionMode;
+    setMode(mode: CompanionMode): void;
+    /**
+     * Handle a ?? query in Watch mode.
+     * Creates ephemeral session, streams response, then disposes.
+     */
+    handleWatchQuery(query: string): AsyncGenerator<CompanionEvent>;
+    /**
+     * Handle !auto task in Auto mode.
+     * Full agent loop with tool execution.
+     */
+    handleAutoTask(task: string): AsyncGenerator<CompanionEvent>;
+    /**
+     * Abort the current operation.
+     */
+    abort(): void;
+}
+//# sourceMappingURL=companion-session.d.ts.map

package/dist/modes/companion/companion-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-session.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/companion-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,sCAAsC,CAAC;AAE5F,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,CACF,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,KACA,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,WAAW,EAAE,CACT,SAAS,EAAE,MAAM,GAAG,GAAG,EAAE,EACzB,OAAO,CAAC,EAAE;QAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAC,KAC7C,OAAO,CAAC,GAAG,CAAC,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAAC;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAgB;;gBAQb,IAAI,EAAE,oBAAoB;IAQtC;;OAEG;IACH,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,IAAI,IAAI,aAAa,CAExB;IAED,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI;IAKlC;;;OAGG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC;IAmCtE;;;OAGG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC;IAqDnE;;OAEG;IACH,KAAK,IAAI,IAAI;CAwBhB"}

package/dist/modes/companion/companion-session.js

@@ -0,0 +1,146 @@
+import { OpenAIAgentClient } from '../../lib/openai-agent-client.js';
+import { generateCommandIndexPrompt } from './command-index.js';
+/**
+ * Lightweight session for companion mode queries.
+ *
+ * Unlike chat mode's ConversationSession:
+ * - No persistent conversation history (each query is standalone)
+ * - No previousResponseId chaining
+ * - Simpler approval flow (Auto mode only)
+ */
+export class CompanionSession {
+    #agentClient = null;
+    #contextBuffer;
+    #summarizer;
+    #settings;
+    #logger;
+    #currentMode = 'watch';
+    constructor(deps) {
+        this.#contextBuffer = deps.contextBuffer;
+        this.#summarizer = deps.summarizer;
+        this.#settings = deps.settings;
+        this.#logger = deps.logger;
+        this.#agentClient = deps.agentClient ?? null;
+    }
+    /**
+     * Get the summarizer instance (for terminal_history tool integration).
+     */
+    get summarizer() {
+        return this.#summarizer;
+    }
+    get mode() {
+        return this.#currentMode;
+    }
+    setMode(mode) {
+        this.#currentMode = mode;
+        this.#logger.info(`Companion mode changed to: ${mode}`);
+    }
+    /**
+     * Handle a ?? query in Watch mode.
+     * Creates ephemeral session, streams response, then disposes.
+     */
+    async *handleWatchQuery(query) {
+        try {
+            const client = this.#getOrCreateClient();
+            const commandIndex = this.#contextBuffer.getIndex();
+            const contextPrompt = generateCommandIndexPrompt(commandIndex);
+            // Build the full query with context
+            const fullQuery = query
+                ? `${contextPrompt}\n\nUser question: ${query}`
+                : `${contextPrompt}\n\nThe user typed ?? for help. Analyze the recent commands and provide helpful suggestions.`;
+            this.#logger.info('Handling watch query', {
+                query: query.slice(0, 100),
+                commandCount: commandIndex.length,
+            });
+            const response = await client.chat(fullQuery, {
+                model: this.#settings.get('agent.model'),
+                reasoningEffort: this.#settings.get('agent.reasoningEffort'),
+                instructions: 'You are a helpful terminal assistant. Answer directly without calling tools.',
+            });
+            if (response) {
+                yield { type: 'text', content: response };
+            }
+            yield { type: 'complete' };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.#logger.error('Watch query failed', { error: message });
+            yield { type: 'error', content: message };
+        }
+    }
+    /**
+     * Handle !auto task in Auto mode.
+     * Full agent loop with tool execution.
+     */
+    async *handleAutoTask(task) {
+        this.setMode('auto');
+        try {
+            const client = this.#getOrCreateClient();
+            const commandIndex = this.#contextBuffer.getIndex();
+            const contextPrompt = generateCommandIndexPrompt(commandIndex);
+            const fullTask = `${contextPrompt}\n\nUser task: ${task}\n\nYou are in Auto mode. Execute commands to complete this task. Use the shell tool to run commands.`;
+            this.#logger.info('Handling auto task', {
+                task: task.slice(0, 100),
+                commandCount: commandIndex.length,
+            });
+            // Stream response using existing API
+            const stream = await client.startStream(fullTask);
+            for await (const event of stream) {
+                if (event?.type === 'text_delta' || event?.data?.type === 'output_text') {
+                    const delta = event?.data?.delta ?? event?.delta ?? '';
+                    if (delta) {
+                        yield { type: 'text', content: delta };
+                    }
+                }
+                // Check for tool calls
+                if (event?.type === 'tool_call' || event?.item?.type === 'function_call') {
+                    const toolName = event?.name ?? event?.item?.name ?? event?.item?.rawItem?.name;
+                    const toolArgs = event?.arguments ?? event?.item?.arguments ?? event?.item?.rawItem?.arguments;
+                    if (toolName) {
+                        yield {
+                            type: 'tool_call',
+                            tool: toolName,
+                            args: toolArgs,
+                        };
+                    }
+                }
+            }
+            yield { type: 'complete' };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.#logger.error('Auto task failed', { error: message });
+            yield { type: 'error', content: message };
+        }
+        finally {
+            this.setMode('watch');
+        }
+    }
+    /**
+     * Abort the current operation.
+     */
+    abort() {
+        if (this.#agentClient) {
+            this.#agentClient.abort();
+        }
+        this.setMode('watch');
+    }
+    /**
+     * Get or create the agent client.
+     */
+    #getOrCreateClient() {
+        if (!this.#agentClient) {
+            this.#agentClient = new OpenAIAgentClient({
+                model: this.#settings.get('agent.model'),
+                reasoningEffort: this.#settings.get('agent.reasoningEffort'),
+                maxTurns: 10, // Lower than chat mode - companion queries should be quick
+                deps: {
+                    settings: this.#settings,
+                    logger: this.#logger,
+                },
+            });
+        }
+        return this.#agentClient;
+    }
+}
+//# sourceMappingURL=companion-session.js.map

package/dist/modes/companion/companion-session.js.map

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

package/dist/modes/companion/companion-session.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=companion-session.test.d.ts.map

package/dist/modes/companion/companion-session.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-session.test.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/companion-session.test.ts"],"names":[],"mappings":""}