@qduc/term2 0.1.1 → 0.1.3

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

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

@@ -0,0 +1,28 @@
+import test from 'ava';
+import { CompanionSession } from './companion-session.js';
+test('handleWatchQuery uses chat and yields text', async (t) => {
+    const events = [];
+    const fakeClient = {
+        chat: async (message) => {
+            t.true(message.includes('User question: why did this fail'));
+            return 'Try rerunning with verbose logging.';
+        },
+        startStream: async () => {
+            throw new Error('startStream should not be called for watch queries');
+        },
+        abort: () => undefined,
+    };
+    const session = new CompanionSession({
+        contextBuffer: { getIndex: () => [] },
+        summarizer: {},
+        settings: { get: () => 'gpt-5' },
+        logger: { info: () => undefined, error: () => undefined },
+        agentClient: fakeClient,
+    });
+    for await (const event of session.handleWatchQuery('why did this fail')) {
+        events.push(event);
+    }
+    t.true(events.some(event => event.type === 'text' && event.content === 'Try rerunning with verbose logging.'));
+    t.is(events[events.length - 1]?.type, 'complete');
+});
+//# sourceMappingURL=companion-session.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"companion-session.test.js","sourceRoot":"","sources":["../../../source/modes/companion/companion-session.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,KAAK,CAAC;AACvB,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAExD,IAAI,CAAC,4CAA4C,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;IACzD,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG;QACf,IAAI,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;YAC5B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC,CAAC;YAC7D,OAAO,qCAAqC,CAAC;QACjD,CAAC;QACD,WAAW,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACjC,aAAa,EAAE,EAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,EAAQ;QAC1C,UAAU,EAAE,EAAS;QACrB,QAAQ,EAAE,EAAC,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,EAAQ;QACrC,MAAM,EAAE,EAAC,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,EAAQ;QAC9D,WAAW,EAAE,UAAiB;KACjC,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,CAAC,CAAC,IAAI,CACF,MAAM,CAAC,IAAI,CACP,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,qCAAqC,CAC5F,CACJ,CAAC;IACF,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AACtD,CAAC,CAAC,CAAC"}

package/dist/modes/companion/components/status-bar.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { CompanionMode } from '../mode-manager.js';
+export interface StatusBarProps {
+    mode: CompanionMode;
+    hint?: string;
+    isProcessing?: boolean;
+}
+/**
+ * Status bar component for companion mode.
+ * Shows current mode, help hints, and processing status.
+ */
+export declare const StatusBar: React.FC<StatusBarProps>;
+//# sourceMappingURL=status-bar.d.ts.map

package/dist/modes/companion/components/status-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-bar.d.ts","sourceRoot":"","sources":["../../../../source/modes/companion/components/status-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAuC9C,CAAC"}

package/dist/modes/companion/components/status-bar.js

@@ -0,0 +1,26 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+/**
+ * Status bar component for companion mode.
+ * Shows current mode, help hints, and processing status.
+ */
+export const StatusBar = ({ mode, hint, isProcessing = false, }) => {
+    const modeIcon = mode === 'watch' ? '👁' : '🤖';
+    const modeLabel = mode === 'watch' ? 'Watch' : 'Auto';
+    return (React.createElement(Box, { flexDirection: "row", justifyContent: "space-between", paddingX: 1, borderStyle: "single", borderColor: "gray" },
+        React.createElement(Box, null,
+            React.createElement(Text, { color: "cyan" },
+                "[",
+                modeLabel,
+                "] ",
+                modeIcon),
+            isProcessing && (React.createElement(Text, { color: "yellow" }, " \u23F3 Processing..."))),
+        React.createElement(Box, null,
+            React.createElement(Text, { color: "gray" }, "?? for help"),
+            mode === 'watch' && (React.createElement(Text, { color: "gray" }, " \u2502 !auto to delegate"))),
+        hint && (React.createElement(Box, null,
+            React.createElement(Text, { color: "yellow" },
+                "\uD83D\uDCA1 ",
+                hint)))));
+};
+//# sourceMappingURL=status-bar.js.map

package/dist/modes/companion/components/status-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-bar.js","sourceRoot":"","sources":["../../../../source/modes/companion/components/status-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,GAAG,EAAE,IAAI,EAAC,MAAM,KAAK,CAAC;AAS9B;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAA6B,CAAC,EAChD,IAAI,EACJ,IAAI,EACJ,YAAY,GAAG,KAAK,GACvB,EAAE,EAAE;IACD,MAAM,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAEtD,OAAO,CACH,oBAAC,GAAG,IACA,aAAa,EAAC,KAAK,EACnB,cAAc,EAAC,eAAe,EAC9B,QAAQ,EAAE,CAAC,EACX,WAAW,EAAC,QAAQ,EACpB,WAAW,EAAC,MAAM;QAElB,oBAAC,GAAG;YACA,oBAAC,IAAI,IAAC,KAAK,EAAC,MAAM;;gBACZ,SAAS;;gBAAI,QAAQ,CACpB;YACN,YAAY,IAAI,CACb,oBAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,4BAAwB,CAC/C,CACC;QAEN,oBAAC,GAAG;YACA,oBAAC,IAAI,IAAC,KAAK,EAAC,MAAM,kBAAmB;YACpC,IAAI,KAAK,OAAO,IAAI,CACjB,oBAAC,IAAI,IAAC,KAAK,EAAC,MAAM,gCAA4B,CACjD,CACC;QAEL,IAAI,IAAI,CACL,oBAAC,GAAG;YACA,oBAAC,IAAI,IAAC,KAAK,EAAC,QAAQ;;gBAAK,IAAI,CAAQ,CACnC,CACT,CACC,CACT,CAAC;AACN,CAAC,CAAC"}

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":"AAAA;;;GAGG;AAwBH;;;GAGG;AACH,MAAM,OAAO,aAAa;IACtB,QAAQ,GAAmB,EAAE,CAAC;IAC9B,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,YAAY,GAAG,CAAC,CAAC;IAEjB,YAAY,OAA6B;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAmB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAElD,uDAAuD;QACvD,OACI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC,QAAQ,EAC/C,CAAC;YACC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC;QACL,CAAC;QAED,oCAAoC;QACpC,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAC3D,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,YAAY,IAAI,SAAS,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,CAAS;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe,EAAE,KAAK,GAAG,CAAC;QAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,QAAQ;aACf,MAAM,CACH,KAAK,CAAC,EAAE,CACJ,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAClD,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CACxD;aACA,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxC,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,YAAY,EAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;YAC7D,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;SACvC,CAAC,CAAC,CAAC;IACR,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,KAAmB;QACnC,MAAM,uBAAuB,GAAG,GAAG,CAAC;QACpC,OAAO,CACH,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;YAC5B,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;YAC3B,uBAAuB,CAC1B,CAAC;IACN,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,EAAU;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACf,OAAO,GAAG,OAAO,OAAO,CAAC;QAC7B,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACzC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACf,OAAO,GAAG,OAAO,OAAO,CAAC;QAC7B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACvC,OAAO,GAAG,KAAK,OAAO,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAmB;QAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG;YAClB,OAAO;YACP,MAAM;YACN,WAAW;YACX,OAAO;YACP,UAAU;YACV,QAAQ;YACR,OAAO;YACP,QAAQ;YACR,WAAW;YACX,cAAc;SACjB,CAAC;QAEF,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACnE,CAAC;CACJ"}

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