@qduc/term2 0.6.0 → 0.6.1

package/dist/modes/companion/event-detector.js

@@ -0,0 +1,169 @@
+import { EventEmitter } from 'events';
+const DEFAULT_OPTIONS = {
+    errorCascadeThreshold: 3,
+    retryLoopThreshold: 2,
+    pauseHintDelayMs: 30000,
+};
+/**
+ * Detects patterns in command history that might indicate user needs help.
+ * Emits events when patterns are detected.
+ */
+export class EventDetector extends EventEmitter {
+    #options;
+    #recentCommands = [];
+    #lastActivityTime = Date.now();
+    #lastErrorTime = null;
+    #pauseTimer = null;
+    constructor(options = {}) {
+        super();
+        this.#options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Get time since last activity in milliseconds.
+     */
+    get timeSinceLastActivity() {
+        return Date.now() - this.#lastActivityTime;
+    }
+    /**
+     * Process a new command entry and check for patterns.
+     */
+    processCommand(entry) {
+        this.#recentCommands.unshift(entry);
+        this.#lastActivityTime = Date.now();
+        // Clear pause timer on new activity
+        if (this.#pauseTimer) {
+            clearTimeout(this.#pauseTimer);
+            this.#pauseTimer = null;
+        }
+        // Keep only recent commands for pattern detection
+        if (this.#recentCommands.length > 10) {
+            this.#recentCommands = this.#recentCommands.slice(0, 10);
+        }
+        // Check for error cascade
+        const cascadeEvent = this.#checkErrorCascade();
+        if (cascadeEvent) {
+            return cascadeEvent;
+        }
+        // Check for retry loop
+        const retryEvent = this.#checkRetryLoop();
+        if (retryEvent) {
+            return retryEvent;
+        }
+        // Track error time for pause detection
+        if (entry.exitCode !== 0) {
+            this.#lastErrorTime = Date.now();
+            this.#startPauseTimer();
+        }
+        return null;
+    }
+    /**
+     * Mark user activity to reset pause detection.
+     */
+    markActivity() {
+        this.#lastActivityTime = Date.now();
+        if (this.#pauseTimer) {
+            clearTimeout(this.#pauseTimer);
+            this.#pauseTimer = null;
+        }
+    }
+    /**
+     * Get current detector options.
+     */
+    getOptions() {
+        return { ...this.#options };
+    }
+    /**
+     * Update detector options.
+     */
+    setOptions(options) {
+        this.#options = { ...this.#options, ...options };
+    }
+    /**
+     * Clear state.
+     */
+    clear() {
+        this.#recentCommands = [];
+        this.#lastActivityTime = Date.now();
+        this.#lastErrorTime = null;
+        if (this.#pauseTimer) {
+            clearTimeout(this.#pauseTimer);
+            this.#pauseTimer = null;
+        }
+    }
+    /**
+     * Check for consecutive command failures.
+     */
+    #checkErrorCascade() {
+        const threshold = this.#options.errorCascadeThreshold;
+        let consecutiveFailures = 0;
+        for (const entry of this.#recentCommands) {
+            if (entry.exitCode !== 0) {
+                consecutiveFailures++;
+            }
+            else {
+                break;
+            }
+        }
+        if (consecutiveFailures >= threshold) {
+            return {
+                pattern: 'error_cascade',
+                message: `Stuck? ${consecutiveFailures} commands failed. Type ?? for help.`,
+                timestamp: Date.now(),
+            };
+        }
+        return null;
+    }
+    /**
+     * Check for repeated identical commands.
+     */
+    #checkRetryLoop() {
+        const threshold = this.#options.retryLoopThreshold;
+        if (this.#recentCommands.length < threshold) {
+            return null;
+        }
+        const lastCommand = this.#recentCommands[0]?.command;
+        if (!lastCommand) {
+            return null;
+        }
+        let repeatCount = 0;
+        for (const entry of this.#recentCommands) {
+            if (entry.command === lastCommand) {
+                repeatCount++;
+            }
+            else {
+                break;
+            }
+        }
+        if (repeatCount >= threshold) {
+            return {
+                pattern: 'retry_loop',
+                message: `Same command run ${repeatCount} times. Try ?? why isn't this working`,
+                timestamp: Date.now(),
+            };
+        }
+        return null;
+    }
+    /**
+     * Start timer for detecting long pause after error.
+     */
+    #startPauseTimer() {
+        if (this.#pauseTimer) {
+            clearTimeout(this.#pauseTimer);
+        }
+        this.#pauseTimer = setTimeout(() => {
+            if (this.#lastErrorTime !== null) {
+                const timeSinceError = Date.now() - this.#lastErrorTime;
+                if (timeSinceError >= this.#options.pauseHintDelayMs) {
+                    const event = {
+                        pattern: 'long_pause',
+                        message: 'Need help with that error?',
+                        timestamp: Date.now(),
+                    };
+                    this.emit('hint', event);
+                }
+            }
+            this.#pauseTimer = null;
+        }, this.#options.pauseHintDelayMs);
+    }
+}
+//# sourceMappingURL=event-detector.js.map

package/dist/modes/companion/event-detector.js.map

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

package/dist/modes/companion/event-detector.test.d.ts

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

package/dist/modes/companion/event-detector.test.d.ts.map

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

package/dist/modes/companion/event-detector.test.js

@@ -0,0 +1,121 @@
+import test from 'ava';
+import { EventDetector } from './event-detector.js';
+// Helper to create a test entry
+function createEntry(command, exitCode = 0, output = '') {
+    return {
+        command,
+        output,
+        exitCode,
+        timestamp: Date.now(),
+        outputLines: output.split('\n').length,
+    };
+}
+test('does not trigger on first failure', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 3 });
+    const result = detector.processCommand(createEntry('cmd', 1));
+    t.is(result, null);
+});
+test('triggers error_cascade after threshold consecutive failures', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 3 });
+    detector.processCommand(createEntry('cmd1', 1));
+    detector.processCommand(createEntry('cmd2', 1));
+    const result = detector.processCommand(createEntry('cmd3', 1));
+    t.not(result, null);
+    t.is(result?.pattern, 'error_cascade');
+    t.truthy(result?.message);
+});
+test('error cascade resets after success', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 3 });
+    detector.processCommand(createEntry('cmd1', 1));
+    detector.processCommand(createEntry('cmd2', 1));
+    detector.processCommand(createEntry('success', 0)); // Reset
+    detector.processCommand(createEntry('cmd3', 1));
+    const result = detector.processCommand(createEntry('cmd4', 1));
+    t.is(result, null);
+});
+test('does not trigger retry_loop on first occurrence', t => {
+    const detector = new EventDetector({ retryLoopThreshold: 2 });
+    const result = detector.processCommand(createEntry('npm test'));
+    t.is(result, null);
+});
+test('triggers retry_loop when same command repeated', t => {
+    const detector = new EventDetector({ retryLoopThreshold: 2 });
+    detector.processCommand(createEntry('npm test'));
+    const result = detector.processCommand(createEntry('npm test'));
+    t.not(result, null);
+    t.is(result?.pattern, 'retry_loop');
+    t.truthy(result?.message);
+});
+test('retry loop resets with different command', t => {
+    const detector = new EventDetector({ retryLoopThreshold: 2 });
+    detector.processCommand(createEntry('npm test'));
+    detector.processCommand(createEntry('git status')); // Different
+    const result = detector.processCommand(createEntry('npm test'));
+    t.is(result, null);
+});
+test('markActivity resets activity timer', t => {
+    const detector = new EventDetector();
+    detector.markActivity();
+    t.true(detector.timeSinceLastActivity < 100); // Should be very recent
+});
+test('getOptions returns current options', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 5 });
+    const options = detector.getOptions();
+    t.is(options.errorCascadeThreshold, 5);
+});
+test('setOptions updates options', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 3 });
+    detector.setOptions({ errorCascadeThreshold: 5 });
+    t.is(detector.getOptions().errorCascadeThreshold, 5);
+});
+test('setOptions preserves unset options', t => {
+    const detector = new EventDetector({
+        errorCascadeThreshold: 3,
+        retryLoopThreshold: 2,
+    });
+    detector.setOptions({ errorCascadeThreshold: 5 });
+    t.is(detector.getOptions().retryLoopThreshold, 2);
+});
+test('clear resets all state', t => {
+    const detector = new EventDetector({ errorCascadeThreshold: 2 });
+    detector.processCommand(createEntry('cmd', 1));
+    detector.clear();
+    const result = detector.processCommand(createEntry('cmd', 1));
+    t.is(result, null); // Cascade count should be reset
+});
+test('emits hint event for long_pause', async (t) => {
+    const detector = new EventDetector({ pauseHintDelayMs: 50 });
+    const events = [];
+    detector.on('hint', (event) => {
+        events.push(event);
+    });
+    // Trigger an error
+    detector.processCommand(createEntry('cmd', 1));
+    // Wait for pause hint
+    await new Promise(resolve => setTimeout(resolve, 100));
+    t.is(events.length, 1);
+    t.is(events[0]?.pattern, 'long_pause');
+});
+test('pause hint is cancelled by new activity', async (t) => {
+    const detector = new EventDetector({ pauseHintDelayMs: 100 });
+    const events = [];
+    detector.on('hint', (event) => {
+        events.push(event);
+    });
+    // Trigger an error
+    detector.processCommand(createEntry('cmd', 1));
+    // Add activity before pause triggers
+    await new Promise(resolve => setTimeout(resolve, 50));
+    detector.markActivity();
+    // Wait past original pause time
+    await new Promise(resolve => setTimeout(resolve, 100));
+    t.is(events.length, 0);
+});
+test('uses default options when not provided', t => {
+    const detector = new EventDetector();
+    const options = detector.getOptions();
+    t.is(options.errorCascadeThreshold, 3);
+    t.is(options.retryLoopThreshold, 2);
+    t.is(options.pauseHintDelayMs, 30000);
+});
+//# sourceMappingURL=event-detector.test.js.map

package/dist/modes/companion/event-detector.test.js.map

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

package/dist/modes/companion/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Companion Mode - Terminal Companion that observes, learns, and assists.
+ *
+ * Instead of the AI being the primary interface, the user's normal terminal remains primary.
+ * The AI watches silently in the background, building context from commands and outputs.
+ * When the user gets stuck or explicitly asks, the AI can assist or temporarily take control.
+ */
+export { CompanionApp } from './companion-app.js';
+export type { CompanionAppProps } from './companion-app.js';
+export { PTYWrapper } from './pty-wrapper.js';
+export type { PTYWrapperOptions, PTYWrapperEvents } from './pty-wrapper.js';
+export { ContextBuffer } from './context-buffer.js';
+export type { CommandEntry, CommandIndexEntry, ContextBufferOptions, } from './context-buffer.js';
+export { ModeManager } from './mode-manager.js';
+export type { CompanionMode } from './mode-manager.js';
+export { EventDetector } from './event-detector.js';
+export type { EventPattern, EventDetectorOptions, DetectedEvent, } from './event-detector.js';
+export { Summarizer } from './summarizer.js';
+export type { SummarizerDeps } from './summarizer.js';
+export { createTerminalHistoryToolDefinition } from './terminal-history.js';
+export type { TerminalHistoryParams } from './terminal-history.js';
+export { formatCommandIndex, generateCommandIndexPrompt, estimateTokens } from './command-index.js';
+export { classifyOutputType, shouldSummarize, getSummarizationPrompt, } from './output-classifier.js';
+export type { OutputType } from './output-classifier.js';
+export { StatusBar } from './components/status-bar.js';
+export type { StatusBarProps } from './components/status-bar.js';
+export { parseCompanionInput, isShellPrompt, extractCommandFromPromptLine, CommandOutputBuffer, } from './input-parser.js';
+export type { ParsedInput } from './input-parser.js';
+export { CompanionSession } from './companion-session.js';
+export type { CompanionSessionDeps, CompanionEvent } from './companion-session.js';
+export { classifyCommandSafety, shouldAutoApprove, shouldBlock, getSafetyDescription, } from './safety-classifier.js';
+export type { SafetyLevel, SafetyClassification } from './safety-classifier.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modes/companion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,YAAY,EAAC,iBAAiB,EAAC,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACR,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,GACvB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACR,YAAY,EACZ,oBAAoB,EACpB,aAAa,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAC3C,YAAY,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAC,mCAAmC,EAAC,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAC,kBAAkB,EAAE,0BAA0B,EAAE,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAElG,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACzB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,UAAU,EAAC,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AACrD,YAAY,EAAC,cAAc,EAAC,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,4BAA4B,EAC5B,mBAAmB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAC,oBAAoB,EAAE,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAC,WAAW,EAAE,oBAAoB,EAAC,MAAM,wBAAwB,CAAC"}

package/dist/modes/companion/index.js

@@ -0,0 +1,21 @@
+/**
+ * Companion Mode - Terminal Companion that observes, learns, and assists.
+ *
+ * Instead of the AI being the primary interface, the user's normal terminal remains primary.
+ * The AI watches silently in the background, building context from commands and outputs.
+ * When the user gets stuck or explicitly asks, the AI can assist or temporarily take control.
+ */
+export { CompanionApp } from './companion-app.js';
+export { PTYWrapper } from './pty-wrapper.js';
+export { ContextBuffer } from './context-buffer.js';
+export { ModeManager } from './mode-manager.js';
+export { EventDetector } from './event-detector.js';
+export { Summarizer } from './summarizer.js';
+export { createTerminalHistoryToolDefinition } from './terminal-history.js';
+export { formatCommandIndex, generateCommandIndexPrompt, estimateTokens } from './command-index.js';
+export { classifyOutputType, shouldSummarize, getSummarizationPrompt, } from './output-classifier.js';
+export { StatusBar } from './components/status-bar.js';
+export { parseCompanionInput, isShellPrompt, extractCommandFromPromptLine, CommandOutputBuffer, } from './input-parser.js';
+export { CompanionSession } from './companion-session.js';
+export { classifyCommandSafety, shouldAutoApprove, shouldBlock, getSafetyDescription, } from './safety-classifier.js';
+//# sourceMappingURL=index.js.map

package/dist/modes/companion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/modes/companion/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAOlD,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAOlD,OAAO,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAC,mCAAmC,EAAC,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAC,kBAAkB,EAAE,0BAA0B,EAAE,cAAc,EAAC,MAAM,oBAAoB,CAAC;AAElG,OAAO,EACH,kBAAkB,EAClB,eAAe,EACf,sBAAsB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAGrD,OAAO,EACH,mBAAmB,EACnB,aAAa,EACb,4BAA4B,EAC5B,mBAAmB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACH,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACvB,MAAM,wBAAwB,CAAC"}

package/dist/modes/companion/input-key-mapper.d.ts

@@ -0,0 +1,3 @@
+import type { Key } from 'ink';
+export declare function getPtyInputSequence(input: string, key: Key): string | null;
+//# sourceMappingURL=input-key-mapper.d.ts.map

package/dist/modes/companion/input-key-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-key-mapper.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/input-key-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,KAAK,CAAC;AAS7B,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI,CA8B1E"}

package/dist/modes/companion/input-key-mapper.js

@@ -0,0 +1,31 @@
+const BACKSPACE_SEQUENCE = '\x08';
+const DELETE_SEQUENCE = '\x1b[3~';
+const UP_ARROW_SEQUENCE = '\x1b[A';
+const DOWN_ARROW_SEQUENCE = '\x1b[B';
+const RIGHT_ARROW_SEQUENCE = '\x1b[C';
+const LEFT_ARROW_SEQUENCE = '\x1b[D';
+export function getPtyInputSequence(input, key) {
+    if (key.upArrow) {
+        return UP_ARROW_SEQUENCE;
+    }
+    if (key.downArrow) {
+        return DOWN_ARROW_SEQUENCE;
+    }
+    if (key.rightArrow) {
+        return RIGHT_ARROW_SEQUENCE;
+    }
+    if (key.leftArrow) {
+        return LEFT_ARROW_SEQUENCE;
+    }
+    if (key.delete) {
+        return DELETE_SEQUENCE;
+    }
+    if (key.backspace) {
+        return BACKSPACE_SEQUENCE;
+    }
+    if (input) {
+        return input;
+    }
+    return null;
+}
+//# sourceMappingURL=input-key-mapper.js.map

package/dist/modes/companion/input-key-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-key-mapper.js","sourceRoot":"","sources":["../../../source/modes/companion/input-key-mapper.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,eAAe,GAAG,SAAS,CAAC;AAClC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AACnC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AACrC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AACtC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAErC,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,GAAQ;IACvD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACjB,OAAO,oBAAoB,CAAC;IAChC,CAAC;IAED,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,eAAe,CAAC;IAC3B,CAAC;IAED,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,kBAAkB,CAAC;IAC9B,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/modes/companion/input-key-mapper.test.d.ts

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

package/dist/modes/companion/input-key-mapper.test.d.ts.map

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

package/dist/modes/companion/input-key-mapper.test.js

@@ -0,0 +1,26 @@
+import test from 'ava';
+import { getPtyInputSequence } from './input-key-mapper.js';
+function makeKey(overrides = {}) {
+    return overrides;
+}
+test('getPtyInputSequence returns input when provided', t => {
+    const key = makeKey({ upArrow: true });
+    t.is(getPtyInputSequence('a', key), 'a');
+});
+test('getPtyInputSequence prefers special key mappings over input', t => {
+    t.is(getPtyInputSequence('\b', makeKey({ backspace: true })), '\x08');
+});
+test('getPtyInputSequence maps arrow keys when input is empty', t => {
+    t.is(getPtyInputSequence('', makeKey({ upArrow: true })), '\x1b[A');
+    t.is(getPtyInputSequence('', makeKey({ downArrow: true })), '\x1b[B');
+    t.is(getPtyInputSequence('', makeKey({ rightArrow: true })), '\x1b[C');
+    t.is(getPtyInputSequence('', makeKey({ leftArrow: true })), '\x1b[D');
+});
+test('getPtyInputSequence maps delete and backspace when input is empty', t => {
+    t.is(getPtyInputSequence('', makeKey({ delete: true })), '\x1b[3~');
+    t.is(getPtyInputSequence('', makeKey({ backspace: true })), '\x08');
+});
+test('getPtyInputSequence returns null when no input or mapping', t => {
+    t.is(getPtyInputSequence('', makeKey()), null);
+});
+//# sourceMappingURL=input-key-mapper.test.js.map

package/dist/modes/companion/input-key-mapper.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-key-mapper.test.js","sourceRoot":"","sources":["../../../source/modes/companion/input-key-mapper.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AAEvB,OAAO,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAC;AAE1D,SAAS,OAAO,CAAC,YAA0B,EAAE;IACzC,OAAO,SAAgB,CAAC;AAC5B,CAAC;AAED,IAAI,CAAC,iDAAiD,EAAE,CAAC,CAAC,EAAE;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,EAAC,OAAO,EAAE,IAAI,EAAC,CAAC,CAAC;IACrC,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6DAA6D,EAAE,CAAC,CAAC,EAAE;IACpE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,CAAC,CAAC,EAAE;IAChE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,OAAO,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,UAAU,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mEAAmE,EAAE,CAAC,CAAC,EAAE;IAC1E,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,MAAM,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,CAAC,CAAC,EAAE;IAClE,CAAC,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC"}

package/dist/modes/companion/input-parser.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Input parser for companion mode.
+ * Detects special commands like ?? and !auto in user input.
+ */
+export interface ParsedInput {
+    type: 'query' | 'auto' | 'normal';
+    content: string;
+}
+/**
+ * Parse input line to detect ?? queries and !auto commands.
+ */
+export declare function parseCompanionInput(input: string): ParsedInput;
+/**
+ * Check if a line looks like a shell prompt.
+ * Used to detect when a command has completed.
+ */
+export declare function isShellPrompt(line: string): boolean;
+/**
+ * Extract command from prompt line.
+ * Tries to separate the prompt from the actual command.
+ */
+export declare function extractCommandFromPromptLine(line: string): string | null;
+/**
+ * Buffer for accumulating PTY output and detecting command boundaries.
+ */
+export declare class CommandOutputBuffer {
+    #private;
+    /**
+     * Process incoming PTY data.
+     * Returns completed command+output when a command boundary is detected.
+     */
+    processData(data: string): {
+        command: string;
+        output: string;
+    } | null;
+    /**
+     * Mark start of a new command.
+     */
+    startCommand(command: string): void;
+    /**
+     * Get the current prompt line.
+     */
+    get promptLine(): string;
+    /**
+     * Check if currently waiting for command output.
+     */
+    get isWaitingForOutput(): boolean;
+    /**
+     * Clear the buffer.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=input-parser.d.ts.map

package/dist/modes/companion/input-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-parser.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/input-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAiB9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAanD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxE;AAED;;GAEG;AACH,qBAAa,mBAAmB;;IAK5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI;IA0BR;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnC;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAKhB"}

package/dist/modes/companion/input-parser.js

@@ -0,0 +1,114 @@
+/**
+ * Input parser for companion mode.
+ * Detects special commands like ?? and !auto in user input.
+ */
+/**
+ * Parse input line to detect ?? queries and !auto commands.
+ */
+export function parseCompanionInput(input) {
+    const trimmed = input.trim();
+    // Detect ?? query
+    if (trimmed.startsWith('??')) {
+        const query = trimmed.slice(2).trim();
+        return { type: 'query', content: query };
+    }
+    // Detect !auto command
+    if (trimmed.startsWith('!auto')) {
+        const task = trimmed.slice(5).trim();
+        return { type: 'auto', content: task };
+    }
+    // Normal input
+    return { type: 'normal', content: trimmed };
+}
+/**
+ * Check if a line looks like a shell prompt.
+ * Used to detect when a command has completed.
+ */
+export function isShellPrompt(line) {
+    // Common shell prompt patterns
+    const promptPatterns = [
+        /\$\s*$/, // bash/sh: ends with $
+        /%\s*$/, // zsh: ends with %
+        />\s*$/, // some shells: ends with >
+        /❯\s*$/, // oh-my-zsh/powerlevel: ends with ❯
+        /→\s*$/, // some prompts: ends with →
+        /^\[.+\]\s*[$%>❯→]\s*$/, // bracketed: [path]$
+        /^.+@.+:.+[$%>❯→]\s*$/, // user@host:path$
+    ];
+    return promptPatterns.some(pattern => pattern.test(line));
+}
+/**
+ * Extract command from prompt line.
+ * Tries to separate the prompt from the actual command.
+ */
+export function extractCommandFromPromptLine(line) {
+    // Look for common prompt endings followed by command
+    const promptEndings = ['$ ', '% ', '> ', '❯ ', '→ '];
+    for (const ending of promptEndings) {
+        const idx = line.lastIndexOf(ending);
+        if (idx !== -1 && idx < line.length - 2) {
+            return line.slice(idx + ending.length).trim();
+        }
+    }
+    return null;
+}
+/**
+ * Buffer for accumulating PTY output and detecting command boundaries.
+ */
+export class CommandOutputBuffer {
+    #currentCommand = null;
+    #outputBuffer = '';
+    #promptLine = '';
+    /**
+     * Process incoming PTY data.
+     * Returns completed command+output when a command boundary is detected.
+     */
+    processData(data) {
+        // Accumulate output
+        this.#outputBuffer += data;
+        // Check for command boundary (new prompt)
+        const lines = this.#outputBuffer.split('\n');
+        const lastLine = lines[lines.length - 1] ?? '';
+        if (isShellPrompt(lastLine) && this.#currentCommand) {
+            // Command completed
+            const result = {
+                command: this.#currentCommand,
+                output: this.#outputBuffer.slice(0, -lastLine.length).trim(),
+            };
+            // Reset for next command
+            this.#currentCommand = null;
+            this.#outputBuffer = lastLine;
+            this.#promptLine = lastLine;
+            return result;
+        }
+        return null;
+    }
+    /**
+     * Mark start of a new command.
+     */
+    startCommand(command) {
+        this.#currentCommand = command;
+        this.#outputBuffer = '';
+    }
+    /**
+     * Get the current prompt line.
+     */
+    get promptLine() {
+        return this.#promptLine;
+    }
+    /**
+     * Check if currently waiting for command output.
+     */
+    get isWaitingForOutput() {
+        return this.#currentCommand !== null;
+    }
+    /**
+     * Clear the buffer.
+     */
+    clear() {
+        this.#currentCommand = null;
+        this.#outputBuffer = '';
+        this.#promptLine = '';
+    }
+}
+//# sourceMappingURL=input-parser.js.map

package/dist/modes/companion/input-parser.js.map

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