@qduc/term2 0.3.1 → 0.5.0

package/dist/modes/companion/safety-classifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Safety classifier for companion mode Auto commands.
+ *
+ * Classifies commands into safety levels:
+ * - GREEN: Safe, auto-approve
+ * - YELLOW: Potentially risky, show for confirmation
+ * - RED: Dangerous, block or require explicit approval
+ */
+export type SafetyLevel = 'green' | 'yellow' | 'red';
+export interface SafetyClassification {
+    level: SafetyLevel;
+    reason: string;
+    command: string;
+}
+/**
+ * Classify a command's safety level.
+ */
+export declare function classifyCommandSafety(command: string): SafetyClassification;
+/**
+ * Check if a command should be auto-approved.
+ */
+export declare function shouldAutoApprove(classification: SafetyClassification): boolean;
+/**
+ * Check if a command should be blocked.
+ */
+export declare function shouldBlock(classification: SafetyClassification): boolean;
+/**
+ * Get user-friendly description of safety level.
+ */
+export declare function getSafetyDescription(level: SafetyLevel): string;
+//# sourceMappingURL=safety-classifier.d.ts.map

package/dist/modes/companion/safety-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-classifier.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/safety-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAoFD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CA2B3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAEzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAS/D"}

package/dist/modes/companion/safety-classifier.js

@@ -0,0 +1,140 @@
+/**
+ * Safety classifier for companion mode Auto commands.
+ *
+ * Classifies commands into safety levels:
+ * - GREEN: Safe, auto-approve
+ * - YELLOW: Potentially risky, show for confirmation
+ * - RED: Dangerous, block or require explicit approval
+ */
+// Patterns for dangerous operations (RED)
+const DANGEROUS_PATTERNS = [
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*\/\s*$/i, reason: 'Recursive delete of root' },
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*~\s*$/i, reason: 'Recursive delete of home' },
+    { pattern: /\brm\s+(-rf?|--recursive)?\s*\.\s*$/i, reason: 'Recursive delete of current directory' },
+    { pattern: /\bsudo\s+rm\b/i, reason: 'Sudo delete operation' },
+    { pattern: /\bsudo\s+dd\b/i, reason: 'Sudo disk write operation' },
+    { pattern: /\bmkfs\b/i, reason: 'Filesystem creation' },
+    { pattern: /\bformat\s+[a-z]:/i, reason: 'Drive format' },
+    { pattern: /\bshutdown\b/i, reason: 'System shutdown' },
+    { pattern: /\breboot\b/i, reason: 'System reboot' },
+    { pattern: /\bsystemctl\s+(stop|disable|mask)\b/i, reason: 'System service modification' },
+    { pattern: /\bchmod\s+777\b/i, reason: 'Overly permissive chmod' },
+    { pattern: /\bchown\s+-R\s+root\b/i, reason: 'Recursive chown to root' },
+    { pattern: />\s*\/dev\/(sd[a-z]|nvme|hd[a-z])/i, reason: 'Direct disk write' },
+    { pattern: /\bcurl\b.*\|\s*(bash|sh)\b/i, reason: 'Pipe remote script to shell' },
+    { pattern: /\bwget\b.*\|\s*(bash|sh)\b/i, reason: 'Pipe remote script to shell' },
+    { pattern: /\beval\s+.*\$\(/i, reason: 'Eval with command substitution' },
+    { pattern: /\bkill\s+-9\s+1\b/i, reason: 'Kill init process' },
+    { pattern: /\b:()\s*{\s*:\s*\|\s*:\s*&\s*}\s*;\s*:/i, reason: 'Fork bomb' },
+];
+// Patterns for risky operations (YELLOW)
+const RISKY_PATTERNS = [
+    { pattern: /\brm\s+(-r|-f|-rf)/i, reason: 'Recursive or forced delete' },
+    { pattern: /\bsudo\b/i, reason: 'Sudo command' },
+    { pattern: /\bgit\s+(push|force-push|reset\s+--hard)/i, reason: 'Git destructive operation' },
+    { pattern: /\bgit\s+checkout\s+--\s*\./i, reason: 'Git discard all changes' },
+    { pattern: /\bnpm\s+(publish|unpublish)/i, reason: 'npm publish operation' },
+    { pattern: /\bdocker\s+(rm|rmi|stop|kill)/i, reason: 'Docker destructive operation' },
+    { pattern: /\bchmod\s+[0-7]{3}/i, reason: 'Permission change' },
+    { pattern: /\bchown\b/i, reason: 'Ownership change' },
+    { pattern: />\s*[^|&]/i, reason: 'File overwrite redirection' },
+    { pattern: /\bmv\b.*\//i, reason: 'File move operation' },
+    { pattern: /\bcp\s+-r/i, reason: 'Recursive copy' },
+    { pattern: /\btar\s+.*-x/i, reason: 'Archive extraction' },
+    { pattern: /\bunzip\b/i, reason: 'Archive extraction' },
+    { pattern: /\bpip\s+install\b(?!.*--user)/i, reason: 'System-wide pip install' },
+    { pattern: /\bnpm\s+install\s+-g/i, reason: 'Global npm install' },
+    { pattern: /\bapt\s+(install|remove|purge)/i, reason: 'System package operation' },
+    { pattern: /\bbrew\s+(install|uninstall|remove)/i, reason: 'Homebrew package operation' },
+];
+// Patterns for safe operations (GREEN)
+const SAFE_PATTERNS = [
+    { pattern: /^\s*(ls|ll|la|dir)\b/i, reason: 'List files' },
+    { pattern: /^\s*cd\b/i, reason: 'Change directory' },
+    { pattern: /^\s*pwd\b/i, reason: 'Print working directory' },
+    { pattern: /^\s*echo\b/i, reason: 'Echo output' },
+    { pattern: /^\s*cat\b/i, reason: 'View file' },
+    { pattern: /^\s*head\b/i, reason: 'View file head' },
+    { pattern: /^\s*tail\b/i, reason: 'View file tail' },
+    { pattern: /^\s*less\b/i, reason: 'View file with pager' },
+    { pattern: /^\s*more\b/i, reason: 'View file with pager' },
+    { pattern: /^\s*grep\b/i, reason: 'Search text' },
+    { pattern: /^\s*find\b/i, reason: 'Find files' },
+    { pattern: /^\s*which\b/i, reason: 'Locate command' },
+    { pattern: /^\s*whereis\b/i, reason: 'Locate command' },
+    { pattern: /^\s*type\b/i, reason: 'Describe command' },
+    { pattern: /^\s*whoami\b/i, reason: 'Show current user' },
+    { pattern: /^\s*hostname\b/i, reason: 'Show hostname' },
+    { pattern: /^\s*date\b/i, reason: 'Show date' },
+    { pattern: /^\s*uptime\b/i, reason: 'Show uptime' },
+    { pattern: /^\s*df\b/i, reason: 'Show disk usage' },
+    { pattern: /^\s*du\b/i, reason: 'Show directory usage' },
+    { pattern: /^\s*free\b/i, reason: 'Show memory usage' },
+    { pattern: /^\s*top\b/i, reason: 'Show processes' },
+    { pattern: /^\s*ps\b/i, reason: 'Show processes' },
+    { pattern: /^\s*git\s+(status|log|diff|branch|show|stash\s+list)\b/i, reason: 'Git read-only' },
+    { pattern: /^\s*npm\s+(ls|list|outdated|audit|view|info)\b/i, reason: 'npm read-only' },
+    { pattern: /^\s*node\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*npm\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*python\s+--version/i, reason: 'Version check' },
+    { pattern: /^\s*npm\s+test\b/i, reason: 'Run tests' },
+    { pattern: /^\s*npm\s+run\s+(test|lint|check|build)\b/i, reason: 'Run npm script' },
+    { pattern: /^\s*npm\s+install\b(?!.*-g)/i, reason: 'Local npm install' },
+    { pattern: /^\s*yarn\s+(install|add)\b(?!.*--global)/i, reason: 'Local yarn install' },
+    { pattern: /^\s*pnpm\s+(install|add)\b(?!.*--global)/i, reason: 'Local pnpm install' },
+    { pattern: /^\s*pip\s+install\s+--user\b/i, reason: 'User pip install' },
+    { pattern: /^\s*pip\s+list\b/i, reason: 'pip read-only' },
+];
+/**
+ * Classify a command's safety level.
+ */
+export function classifyCommandSafety(command) {
+    const trimmed = command.trim();
+    // Check for dangerous patterns first (RED) - always takes precedence
+    for (const { pattern, reason } of DANGEROUS_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'red', reason, command: trimmed };
+        }
+    }
+    // Check for risky patterns (YELLOW) - before safe patterns
+    // This ensures operations like redirects are caught even with safe base commands
+    for (const { pattern, reason } of RISKY_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'yellow', reason, command: trimmed };
+        }
+    }
+    // Check for safe patterns (GREEN)
+    for (const { pattern, reason } of SAFE_PATTERNS) {
+        if (pattern.test(trimmed)) {
+            return { level: 'green', reason, command: trimmed };
+        }
+    }
+    // Default to YELLOW for unknown commands
+    return { level: 'yellow', reason: 'Unknown command', command: trimmed };
+}
+/**
+ * Check if a command should be auto-approved.
+ */
+export function shouldAutoApprove(classification) {
+    return classification.level === 'green';
+}
+/**
+ * Check if a command should be blocked.
+ */
+export function shouldBlock(classification) {
+    return classification.level === 'red';
+}
+/**
+ * Get user-friendly description of safety level.
+ */
+export function getSafetyDescription(level) {
+    switch (level) {
+        case 'green':
+            return 'Safe - will auto-execute';
+        case 'yellow':
+            return 'Needs confirmation';
+        case 'red':
+            return 'Blocked - potentially dangerous';
+    }
+}
+//# sourceMappingURL=safety-classifier.js.map

package/dist/modes/companion/safety-classifier.js.map

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

package/dist/modes/companion/safety-classifier.test.d.ts

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

package/dist/modes/companion/safety-classifier.test.d.ts.map

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

package/dist/modes/companion/safety-classifier.test.js

@@ -0,0 +1,151 @@
+import test from 'ava';
+import { classifyCommandSafety, shouldAutoApprove, shouldBlock, getSafetyDescription, } from './safety-classifier.js';
+// GREEN (safe) commands
+test('classifies ls as green', t => {
+    const result = classifyCommandSafety('ls -la');
+    t.is(result.level, 'green');
+});
+test('classifies cd as green', t => {
+    const result = classifyCommandSafety('cd /path/to/dir');
+    t.is(result.level, 'green');
+});
+test('classifies git status as green', t => {
+    const result = classifyCommandSafety('git status');
+    t.is(result.level, 'green');
+});
+test('classifies git log as green', t => {
+    const result = classifyCommandSafety('git log --oneline');
+    t.is(result.level, 'green');
+});
+test('classifies npm test as green', t => {
+    const result = classifyCommandSafety('npm test');
+    t.is(result.level, 'green');
+});
+test('classifies npm install (local) as green', t => {
+    const result = classifyCommandSafety('npm install lodash');
+    t.is(result.level, 'green');
+});
+test('classifies cat as green', t => {
+    const result = classifyCommandSafety('cat file.txt');
+    t.is(result.level, 'green');
+});
+test('classifies grep as green', t => {
+    const result = classifyCommandSafety('grep -r "pattern" .');
+    t.is(result.level, 'green');
+});
+// YELLOW (risky) commands
+test('classifies rm -r as yellow', t => {
+    const result = classifyCommandSafety('rm -r directory');
+    t.is(result.level, 'yellow');
+});
+test('classifies sudo as yellow', t => {
+    const result = classifyCommandSafety('sudo apt update');
+    t.is(result.level, 'yellow');
+});
+test('classifies git push as yellow', t => {
+    const result = classifyCommandSafety('git push origin main');
+    t.is(result.level, 'yellow');
+});
+test('classifies npm install -g as yellow', t => {
+    const result = classifyCommandSafety('npm install -g typescript');
+    t.is(result.level, 'yellow');
+});
+test('classifies file overwrite redirect as yellow', t => {
+    const result = classifyCommandSafety('echo "test" > file.txt');
+    t.is(result.level, 'yellow');
+});
+test('classifies chmod as yellow', t => {
+    const result = classifyCommandSafety('chmod 644 file.txt');
+    t.is(result.level, 'yellow');
+});
+test('classifies unknown command as yellow', t => {
+    const result = classifyCommandSafety('someunknowncommand --flag');
+    t.is(result.level, 'yellow');
+    t.is(result.reason, 'Unknown command');
+});
+// RED (dangerous) commands
+test('classifies rm -rf / as red', t => {
+    const result = classifyCommandSafety('rm -rf /');
+    t.is(result.level, 'red');
+});
+test('classifies rm -rf ~ as red', t => {
+    const result = classifyCommandSafety('rm -rf ~');
+    t.is(result.level, 'red');
+});
+test('classifies sudo rm as red', t => {
+    const result = classifyCommandSafety('sudo rm -rf /var');
+    t.is(result.level, 'red');
+});
+test('classifies curl pipe to bash as red', t => {
+    const result = classifyCommandSafety('curl http://example.com/script.sh | bash');
+    t.is(result.level, 'red');
+});
+test('classifies wget pipe to sh as red', t => {
+    const result = classifyCommandSafety('wget -qO- http://example.com/script.sh | sh');
+    t.is(result.level, 'red');
+});
+test('classifies chmod 777 as red', t => {
+    const result = classifyCommandSafety('chmod 777 /etc/passwd');
+    t.is(result.level, 'red');
+});
+test('classifies direct disk write as red', t => {
+    const result = classifyCommandSafety('dd if=/dev/zero > /dev/sda');
+    t.is(result.level, 'red');
+});
+test('classifies mkfs as red', t => {
+    const result = classifyCommandSafety('mkfs.ext4 /dev/sdb1');
+    t.is(result.level, 'red');
+});
+// Helper functions
+test('shouldAutoApprove returns true for green', t => {
+    const result = classifyCommandSafety('ls');
+    t.true(shouldAutoApprove(result));
+});
+test('shouldAutoApprove returns false for yellow', t => {
+    const result = classifyCommandSafety('rm -r dir');
+    t.false(shouldAutoApprove(result));
+});
+test('shouldAutoApprove returns false for red', t => {
+    const result = classifyCommandSafety('rm -rf /');
+    t.false(shouldAutoApprove(result));
+});
+test('shouldBlock returns false for green', t => {
+    const result = classifyCommandSafety('ls');
+    t.false(shouldBlock(result));
+});
+test('shouldBlock returns false for yellow', t => {
+    const result = classifyCommandSafety('rm -r dir');
+    t.false(shouldBlock(result));
+});
+test('shouldBlock returns true for red', t => {
+    const result = classifyCommandSafety('rm -rf /');
+    t.true(shouldBlock(result));
+});
+test('getSafetyDescription returns correct text for green', t => {
+    t.is(getSafetyDescription('green'), 'Safe - will auto-execute');
+});
+test('getSafetyDescription returns correct text for yellow', t => {
+    t.is(getSafetyDescription('yellow'), 'Needs confirmation');
+});
+test('getSafetyDescription returns correct text for red', t => {
+    t.is(getSafetyDescription('red'), 'Blocked - potentially dangerous');
+});
+// Edge cases
+test('handles empty command', t => {
+    const result = classifyCommandSafety('');
+    t.is(result.level, 'yellow');
+});
+test('handles whitespace-only command', t => {
+    const result = classifyCommandSafety('   ');
+    t.is(result.level, 'yellow');
+});
+test('is case insensitive for patterns', t => {
+    const result1 = classifyCommandSafety('LS -LA');
+    const result2 = classifyCommandSafety('ls -la');
+    t.is(result1.level, result2.level);
+});
+test('trims command before classification', t => {
+    const result = classifyCommandSafety('   ls   ');
+    t.is(result.level, 'green');
+});
+//# sourceMappingURL=safety-classifier.test.js.map

package/dist/modes/companion/safety-classifier.test.js.map

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

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

@@ -0,0 +1,24 @@
+import type { ISettingsService, ILoggingService } from '../../services/service-interfaces.js';
+import type { CommandEntry } from './context-buffer.js';
+export interface SummarizerDeps {
+    settings: ISettingsService;
+    logger: ILoggingService;
+}
+/**
+ * Summarizer for command outputs using a small, fast LLM.
+ * Caches summaries to avoid reprocessing.
+ */
+export declare class Summarizer {
+    #private;
+    constructor(deps: SummarizerDeps);
+    /**
+     * Summarize command output.
+     * Returns the original output if summarization is not needed or fails.
+     */
+    summarize(entry: CommandEntry, detail: 'summary' | 'errors_only'): Promise<string>;
+    /**
+     * Clear the summary cache.
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=summarizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/summarizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,sCAAsC,CAAC;AAC5F,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,eAAe,CAAC;CAC3B;AASD;;;GAGG;AACH,qBAAa,UAAU;;gBAMP,IAAI,EAAE,cAAc;IAKhC;;;OAGG;IACG,SAAS,CACX,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,GAAG,aAAa,GAClC,OAAO,CAAC,MAAM,CAAC;IAkDlB;;OAEG;IACH,UAAU,IAAI,IAAI;CAsFrB"}

package/dist/modes/companion/summarizer.js

@@ -0,0 +1,132 @@
+import OpenAI from 'openai';
+import { classifyOutputType, getSummarizationPrompt, shouldSummarize } from './output-classifier.js';
+const CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+/**
+ * Summarizer for command outputs using a small, fast LLM.
+ * Caches summaries to avoid reprocessing.
+ */
+export class Summarizer {
+    #client = null;
+    #settings;
+    #logger;
+    #cache = new Map();
+    constructor(deps) {
+        this.#settings = deps.settings;
+        this.#logger = deps.logger;
+    }
+    /**
+     * Summarize command output.
+     * Returns the original output if summarization is not needed or fails.
+     */
+    async summarize(entry, detail) {
+        // Check if summarization is needed
+        if (!shouldSummarize(entry)) {
+            return entry.output;
+        }
+        // Check cache
+        const cacheKey = this.#getCacheKey(entry, detail);
+        const cached = this.#cache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.summary;
+        }
+        try {
+            const client = await this.#getClient();
+            const model = this.#settings.get('companion.summarizerModel') || 'gpt-4o-mini';
+            const maxTokens = this.#settings.get('companion.summarizerMaxTokens') || 500;
+            const outputType = classifyOutputType(entry);
+            const prompt = this.#buildPrompt(entry, detail, outputType);
+            const response = await client.chat.completions.create({
+                model,
+                max_tokens: maxTokens,
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a concise technical summarizer. Extract key information only.',
+                    },
+                    { role: 'user', content: prompt },
+                ],
+            });
+            const summary = response.choices[0]?.message?.content || entry.output;
+            // Cache result
+            this.#cache.set(cacheKey, { summary, timestamp: Date.now() });
+            return summary;
+        }
+        catch (error) {
+            this.#logger.warn('Summarization failed, using fallback', {
+                error: error instanceof Error ? error.message : String(error),
+                command: entry.command.slice(0, 50),
+            });
+            // Fallback: smart truncation
+            return this.#fallbackSummarize(entry, detail);
+        }
+    }
+    /**
+     * Clear the summary cache.
+     */
+    clearCache() {
+        this.#cache.clear();
+    }
+    /**
+     * Get or create OpenAI client.
+     */
+    async #getClient() {
+        if (this.#client) {
+            return this.#client;
+        }
+        const provider = this.#settings.get('companion.summarizerProvider') || 'openai';
+        // Use OpenAI API key from environment
+        const apiKey = process.env.OPENAI_API_KEY;
+        // For non-OpenAI providers, get baseURL from settings
+        const baseURL = provider === 'openai'
+            ? undefined
+            : this.#settings.get(`agent.${provider}.baseUrl`);
+        if (!apiKey) {
+            throw new Error('OPENAI_API_KEY not set');
+        }
+        this.#client = new OpenAI({ apiKey, baseURL });
+        return this.#client;
+    }
+    /**
+     * Build the summarization prompt.
+     */
+    #buildPrompt(entry, detail, outputType) {
+        const basePrompt = getSummarizationPrompt(outputType);
+        return `Command: ${entry.command}
+Exit code: ${entry.exitCode}
+
+Output:
+\`\`\`
+${entry.output}
+\`\`\`
+
+${detail === 'errors_only' ? getSummarizationPrompt('error_output') : basePrompt}`;
+    }
+    /**
+     * Fallback summarization without LLM.
+     */
+    #fallbackSummarize(entry, detail) {
+        const lines = entry.output.split('\n');
+        if (detail === 'errors_only') {
+            // Extract lines containing common error patterns
+            const errorPatterns = /error|fail|exception|fatal|critical|warning/i;
+            const errorLines = lines.filter(l => errorPatterns.test(l));
+            return errorLines.slice(0, 20).join('\n') || 'No obvious errors found';
+        }
+        // Default: first and last N lines
+        if (lines.length <= 30) {
+            return entry.output;
+        }
+        return [
+            ...lines.slice(0, 15),
+            `... (${lines.length - 30} lines omitted)`,
+            ...lines.slice(-15),
+        ].join('\n');
+    }
+    /**
+     * Generate cache key for an entry.
+     */
+    #getCacheKey(entry, detail) {
+        return `${entry.command}:${entry.timestamp}:${detail}`;
+    }
+}
+//# sourceMappingURL=summarizer.js.map

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

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

package/dist/modes/companion/terminal-history.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../../tools/types.js';
+import type { ContextBuffer } from './context-buffer.js';
+import type { Summarizer } from './summarizer.js';
+declare const TerminalHistoryParamsSchema: z.ZodObject<{
+    index: z.ZodOptional<z.ZodNumber>;
+    lastN: z.ZodOptional<z.ZodNumber>;
+    search: z.ZodOptional<z.ZodString>;
+    detail: z.ZodEnum<{
+        summary: "summary";
+        errors_only: "errors_only";
+        full: "full";
+    }>;
+    maxLines: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type TerminalHistoryParams = z.infer<typeof TerminalHistoryParamsSchema>;
+interface TerminalHistoryDeps {
+    contextBuffer: ContextBuffer;
+    summarizer: Summarizer;
+}
+/**
+ * Create the terminal_history tool definition for companion mode.
+ * This tool allows the AI to query command history and outputs on-demand.
+ */
+export declare function createTerminalHistoryToolDefinition(deps: TerminalHistoryDeps): ToolDefinition<TerminalHistoryParams>;
+export {};
+//# sourceMappingURL=terminal-history.d.ts.map

package/dist/modes/companion/terminal-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-history.d.ts","sourceRoot":"","sources":["../../../source/modes/companion/terminal-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,KAAK,EAAC,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AACzE,OAAO,KAAK,EAAC,aAAa,EAAe,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAIhD,QAAA,MAAM,2BAA2B;;;;;;;;;;iBA2B/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAShF,UAAU,mBAAmB;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,UAAU,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAC/C,IAAI,EAAE,mBAAmB,GAC1B,cAAc,CAAC,qBAAqB,CAAC,CA8HvC"}