@qduc/term2 0.3.1 → 0.5.0

package/dist/modes/companion/context-buffer.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Context buffer for companion mode.
+ * Stores recent commands and their outputs in a rolling window.
+ */
+export interface CommandEntry {
+    command: string;
+    output: string;
+    exitCode: number;
+    timestamp: number;
+    outputLines: number;
+}
+export interface CommandIndexEntry {
+    index: number;
+    command: string;
+    exitCode: number;
+    relativeTime: string;
+    outputLines: number;
+    hasErrors: boolean;
+}
+export interface ContextBufferOptions {
+    maxSize: number;
+    maxCommands: number;
+}
+/**
+ * Rolling buffer that stores command history with outputs.
+ * Generates lightweight command index for AI context.
+ */
+export declare class ContextBuffer {
+    #private;
+    constructor(options: ContextBufferOptions);
+    /**
+     * Add a command entry to the buffer.
+     */
+    addEntry(entry: CommandEntry): void;
+    /**
+     * Get entry by index (0 = most recent).
+     */
+    getEntry(index: number): CommandEntry | undefined;
+    /**
+     * Get the last N entries (most recent first).
+     */
+    getLastN(n: number): CommandEntry[];
+    /**
+     * Search entries by command or output text.
+     */
+    search(pattern: string, limit?: number): CommandEntry[];
+    /**
+     * Get lightweight command index for AI context.
+     * This is always included in the AI's context window.
+     */
+    getIndex(): CommandIndexEntry[];
+    /**
+     * Get the total number of entries.
+     */
+    get length(): number;
+    /**
+     * Get the current buffer size in bytes.
+     */
+    get size(): number;
+    /**
+     * Clear all entries.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=context-buffer.d.ts.map

package/dist/modes/companion/context-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-buffer.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/context-buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,aAAa;;gBAMV,OAAO,EAAE,oBAAoB;IAKzC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IA2BnC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIjD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAInC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE;IAWlD;;;OAGG;IACH,QAAQ,IAAI,iBAAiB,EAAE;IAY/B;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAoEhB"}

package/dist/modes/companion/context-buffer.js

@@ -0,0 +1,156 @@
+/**
+ * Context buffer for companion mode.
+ * Stores recent commands and their outputs in a rolling window.
+ */
+/**
+ * Rolling buffer that stores command history with outputs.
+ * Generates lightweight command index for AI context.
+ */
+export class ContextBuffer {
+    #entries = [];
+    #maxSize;
+    #maxCommands;
+    #currentSize = 0;
+    constructor(options) {
+        this.#maxSize = options.maxSize;
+        this.#maxCommands = options.maxCommands;
+    }
+    /**
+     * Add a command entry to the buffer.
+     */
+    addEntry(entry) {
+        const entrySize = this.#calculateEntrySize(entry);
+        // Evict oldest entries if buffer would exceed max size
+        while (this.#entries.length > 0 &&
+            this.#currentSize + entrySize > this.#maxSize) {
+            const removed = this.#entries.pop();
+            if (removed) {
+                this.#currentSize -= this.#calculateEntrySize(removed);
+            }
+        }
+        // Evict if we'd exceed max commands
+        while (this.#entries.length >= this.#maxCommands) {
+            const removed = this.#entries.pop();
+            if (removed) {
+                this.#currentSize -= this.#calculateEntrySize(removed);
+            }
+        }
+        // Add new entry at the beginning (most recent first)
+        this.#entries.unshift(entry);
+        this.#currentSize += entrySize;
+    }
+    /**
+     * Get entry by index (0 = most recent).
+     */
+    getEntry(index) {
+        return this.#entries[index];
+    }
+    /**
+     * Get the last N entries (most recent first).
+     */
+    getLastN(n) {
+        return this.#entries.slice(0, Math.min(n, this.#entries.length));
+    }
+    /**
+     * Search entries by command or output text.
+     */
+    search(pattern, limit = 5) {
+        const lowerPattern = pattern.toLowerCase();
+        return this.#entries
+            .filter(entry => entry.command.toLowerCase().includes(lowerPattern) ||
+            entry.output.toLowerCase().includes(lowerPattern))
+            .slice(0, limit);
+    }
+    /**
+     * Get lightweight command index for AI context.
+     * This is always included in the AI's context window.
+     */
+    getIndex() {
+        const now = Date.now();
+        return this.#entries.map((entry, index) => ({
+            index,
+            command: entry.command,
+            exitCode: entry.exitCode,
+            relativeTime: this.#formatRelativeTime(now - entry.timestamp),
+            outputLines: entry.outputLines,
+            hasErrors: this.#detectErrors(entry),
+        }));
+    }
+    /**
+     * Get the total number of entries.
+     */
+    get length() {
+        return this.#entries.length;
+    }
+    /**
+     * Get the current buffer size in bytes.
+     */
+    get size() {
+        return this.#currentSize;
+    }
+    /**
+     * Clear all entries.
+     */
+    clear() {
+        this.#entries = [];
+        this.#currentSize = 0;
+    }
+    /**
+     * Calculate the approximate size of an entry in bytes.
+     *
+     * Size calculation methodology:
+     * - Command string length in bytes
+     * - Output string length in bytes
+     * - Fixed metadata overhead (100 bytes) accounts for:
+     *   - exitCode: number (~8 bytes in V8)
+     *   - timestamp: number (~8 bytes in V8)
+     *   - outputLines: number (~8 bytes in V8)
+     *   - Object overhead and references (~76 bytes estimated)
+     *
+     * This is intentionally conservative to ensure we don't exceed memory limits.
+     */
+    #calculateEntrySize(entry) {
+        const METADATA_OVERHEAD_BYTES = 100;
+        return ((entry.command?.length || 0) +
+            (entry.output?.length || 0) +
+            METADATA_OVERHEAD_BYTES);
+    }
+    /**
+     * Format timestamp as relative time string.
+     */
+    #formatRelativeTime(ms) {
+        const seconds = Math.floor(ms / 1000);
+        if (seconds < 60) {
+            return `${seconds}s ago`;
+        }
+        const minutes = Math.floor(seconds / 60);
+        if (minutes < 60) {
+            return `${minutes}m ago`;
+        }
+        const hours = Math.floor(minutes / 60);
+        return `${hours}h ago`;
+    }
+    /**
+     * Detect if an entry likely contains errors.
+     */
+    #detectErrors(entry) {
+        if (entry.exitCode !== 0) {
+            return true;
+        }
+        const output = entry.output.toLowerCase();
+        const errorPatterns = [
+            'error',
+            'fail',
+            'exception',
+            'fatal',
+            'critical',
+            'cannot',
+            "can't",
+            'denied',
+            'not found',
+            'no such file',
+        ];
+        return errorPatterns.some(pattern => output.includes(pattern));
+    }
+}
+//# sourceMappingURL=context-buffer.js.map

package/dist/modes/companion/context-buffer.js.map

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

package/dist/modes/companion/context-buffer.test.d.ts

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

package/dist/modes/companion/context-buffer.test.d.ts.map

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

package/dist/modes/companion/context-buffer.test.js

@@ -0,0 +1,154 @@
+import test from 'ava';
+import { ContextBuffer } from './context-buffer.js';
+// Helper to create a test entry
+function createEntry(command, output, exitCode = 0, timestamp = Date.now()) {
+    return {
+        command,
+        output,
+        exitCode,
+        timestamp,
+        outputLines: output.split('\n').length,
+    };
+}
+test('stores commands with output', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 5 });
+    buffer.addEntry(createEntry('ls -la', 'file1.txt\nfile2.txt'));
+    const entries = buffer.getLastN(1);
+    t.is(entries[0]?.command, 'ls -la');
+    t.is(entries[0]?.output, 'file1.txt\nfile2.txt');
+});
+test('returns entries in most-recent-first order', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 5 });
+    buffer.addEntry(createEntry('cmd1', 'out1', 0, 1));
+    buffer.addEntry(createEntry('cmd2', 'out2', 0, 2));
+    buffer.addEntry(createEntry('cmd3', 'out3', 0, 3));
+    const entries = buffer.getLastN(3);
+    t.is(entries[0]?.command, 'cmd3');
+    t.is(entries[1]?.command, 'cmd2');
+    t.is(entries[2]?.command, 'cmd1');
+});
+test('evicts oldest entries when maxCommands exceeded', t => {
+    const buffer = new ContextBuffer({ maxSize: 10000, maxCommands: 2 });
+    buffer.addEntry(createEntry('cmd1', 'out1', 0, 1));
+    buffer.addEntry(createEntry('cmd2', 'out2', 0, 2));
+    buffer.addEntry(createEntry('cmd3', 'out3', 0, 3));
+    const entries = buffer.getLastN(10);
+    t.is(entries.length, 2);
+    t.is(entries[0]?.command, 'cmd3');
+    t.is(entries[1]?.command, 'cmd2');
+});
+test('evicts entries when maxSize exceeded', t => {
+    // Each entry is ~100 bytes (command + output + overhead)
+    const buffer = new ContextBuffer({ maxSize: 200, maxCommands: 10 });
+    buffer.addEntry(createEntry('cmd1', 'x'.repeat(80), 0, 1));
+    buffer.addEntry(createEntry('cmd2', 'y'.repeat(80), 0, 2));
+    buffer.addEntry(createEntry('cmd3', 'z'.repeat(80), 0, 3));
+    // Should have evicted some entries due to size
+    t.true(buffer.length <= 2);
+});
+test('getEntry returns entry by index', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 5 });
+    buffer.addEntry(createEntry('cmd1', 'out1', 0, 1));
+    buffer.addEntry(createEntry('cmd2', 'out2', 0, 2));
+    const entry = buffer.getEntry(1);
+    t.is(entry?.command, 'cmd1');
+});
+test('getEntry returns undefined for out of bounds index', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 5 });
+    buffer.addEntry(createEntry('cmd1', 'out1'));
+    t.is(buffer.getEntry(5), undefined);
+});
+test('search finds entries by command', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('npm test', 'passed'));
+    buffer.addEntry(createEntry('npm install', 'installed'));
+    buffer.addEntry(createEntry('git status', 'clean'));
+    const results = buffer.search('npm');
+    t.is(results.length, 2);
+    t.true(results.some(e => e.command === 'npm test'));
+    t.true(results.some(e => e.command === 'npm install'));
+});
+test('search finds entries by output', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('test1', 'error: file not found'));
+    buffer.addEntry(createEntry('test2', 'success'));
+    const results = buffer.search('error');
+    t.is(results.length, 1);
+    t.is(results[0]?.command, 'test1');
+});
+test('search is case insensitive', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('NPM TEST', 'passed'));
+    const results = buffer.search('npm');
+    t.is(results.length, 1);
+});
+test('search limits results', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    for (let i = 0; i < 10; i++) {
+        buffer.addEntry(createEntry(`npm cmd${i}`, 'out'));
+    }
+    const results = buffer.search('npm', 3);
+    t.is(results.length, 3);
+});
+test('getIndex generates lightweight command index', t => {
+    const now = Date.now();
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('npm test', 'FAIL: 2 tests failed', 1, now - 30000));
+    buffer.addEntry(createEntry('git diff', '+new line', 0, now - 5000));
+    const index = buffer.getIndex();
+    // Note: entries are in most-recent-first order, so git diff is first
+    t.is(index.length, 2);
+    t.is(index[0]?.command, 'git diff');
+    t.is(index[0]?.exitCode, 0);
+    t.false(index[0]?.hasErrors);
+    t.truthy(index[0]?.relativeTime);
+    t.is(index[1]?.command, 'npm test');
+    t.is(index[1]?.exitCode, 1);
+    t.true(index[1]?.hasErrors);
+});
+test('getIndex detects errors from exit code', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('cmd', 'no error keywords', 1));
+    const index = buffer.getIndex();
+    t.true(index[0]?.hasErrors);
+});
+test('getIndex detects errors from output patterns', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('cmd', 'fatal: something went wrong', 0));
+    const index = buffer.getIndex();
+    t.true(index[0]?.hasErrors);
+});
+test('getIndex formats relative time correctly', t => {
+    const now = Date.now();
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('cmd1', 'out', 0, now - 120000)); // 2 minutes ago
+    buffer.addEntry(createEntry('cmd2', 'out', 0, now - 5000)); // 5 seconds ago (most recent)
+    const index = buffer.getIndex();
+    // Note: entries are in most-recent-first order
+    // cmd2 is most recent (5s ago), cmd1 is older (2m ago)
+    t.regex(index[0]?.relativeTime ?? '', /\d+s ago/);
+    t.regex(index[1]?.relativeTime ?? '', /\d+m ago/);
+});
+test('clear removes all entries', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    buffer.addEntry(createEntry('cmd1', 'out1'));
+    buffer.addEntry(createEntry('cmd2', 'out2'));
+    buffer.clear();
+    t.is(buffer.length, 0);
+    t.is(buffer.size, 0);
+});
+test('length returns correct count', t => {
+    const buffer = new ContextBuffer({ maxSize: 1024, maxCommands: 10 });
+    t.is(buffer.length, 0);
+    buffer.addEntry(createEntry('cmd1', 'out1'));
+    t.is(buffer.length, 1);
+    buffer.addEntry(createEntry('cmd2', 'out2'));
+    t.is(buffer.length, 2);
+});
+test('size tracks buffer size in bytes', t => {
+    const buffer = new ContextBuffer({ maxSize: 10000, maxCommands: 10 });
+    t.is(buffer.size, 0);
+    buffer.addEntry(createEntry('cmd', 'output'));
+    t.true(buffer.size > 0);
+});
+//# sourceMappingURL=context-buffer.test.js.map

package/dist/modes/companion/context-buffer.test.js.map

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

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

@@ -0,0 +1,46 @@
+import { EventEmitter } from 'events';
+import type { CommandEntry } from './context-buffer.js';
+export type EventPattern = 'error_cascade' | 'retry_loop' | 'long_pause';
+export interface EventDetectorOptions {
+    errorCascadeThreshold: number;
+    retryLoopThreshold: number;
+    pauseHintDelayMs: number;
+}
+export interface DetectedEvent {
+    pattern: EventPattern;
+    message: string;
+    timestamp: number;
+}
+/**
+ * Detects patterns in command history that might indicate user needs help.
+ * Emits events when patterns are detected.
+ */
+export declare class EventDetector extends EventEmitter {
+    #private;
+    constructor(options?: Partial<EventDetectorOptions>);
+    /**
+     * Get time since last activity in milliseconds.
+     */
+    get timeSinceLastActivity(): number;
+    /**
+     * Process a new command entry and check for patterns.
+     */
+    processCommand(entry: CommandEntry): DetectedEvent | null;
+    /**
+     * Mark user activity to reset pause detection.
+     */
+    markActivity(): void;
+    /**
+     * Get current detector options.
+     */
+    getOptions(): EventDetectorOptions;
+    /**
+     * Update detector options.
+     */
+    setOptions(options: Partial<EventDetectorOptions>): void;
+    /**
+     * Clear state.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=event-detector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-detector.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/event-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACjC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB;AAQD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,YAAY;;gBAO/B,OAAO,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAKvD;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,IAAI;IAoCzD;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;OAEG;IACH,UAAU,IAAI,oBAAoB;IAIlC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,KAAK,IAAI,IAAI;CA6FhB"}

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