aicodeman 0.2.8 → 0.3.0

package/dist/session-auto-ops.js

@@ -0,0 +1,224 @@
+/**
+ * @fileoverview Auto-compact and auto-clear automation for Session.
+ *
+ * Monitors token counts and triggers /compact or /clear commands when
+ * configurable thresholds are reached. Waits for Claude to be idle
+ * before sending commands, with retry logic and mutual exclusion
+ * (compact and clear never run simultaneously).
+ *
+ * @module session-auto-ops
+ */
+import { EventEmitter } from 'node:events';
+// ============================================================================
+// Timing Constants
+// ============================================================================
+/** Delay for auto-compact/clear retry attempts (2 seconds) */
+const AUTO_RETRY_DELAY_MS = 2000;
+/** Delay for auto-compact/clear initial check (1 second) */
+const AUTO_INITIAL_DELAY_MS = 1000;
+/** Cooldown after compact completes before re-enabling (10 seconds) */
+const COMPACT_COOLDOWN_MS = 10000;
+/** Cooldown after clear completes before re-enabling (5 seconds) */
+const CLEAR_COOLDOWN_MS = 5000;
+/** Minimum valid threshold for auto-clear/compact (1000 tokens) */
+const MIN_AUTO_THRESHOLD = 1000;
+/** Maximum valid threshold for auto-clear/compact (500k tokens) */
+const MAX_AUTO_THRESHOLD = 500_000;
+/** Default auto-clear threshold when invalid value provided */
+const DEFAULT_AUTO_CLEAR_THRESHOLD = 140_000;
+/** Default auto-compact threshold when invalid value provided */
+const DEFAULT_AUTO_COMPACT_THRESHOLD = 110_000;
+/**
+ * Manages auto-compact and auto-clear automation for a Session.
+ *
+ * When enabled, monitors token counts after each update and triggers
+ * /compact or /clear commands when thresholds are exceeded. Ensures
+ * mutual exclusion between compact and clear operations.
+ */
+export class SessionAutoOps extends EventEmitter {
+    // Auto-compact state
+    _autoCompactThreshold;
+    _autoCompactEnabled = false;
+    _autoCompactPrompt = '';
+    _isCompacting = false;
+    _autoCompactTimer = null;
+    // Auto-clear state
+    _autoClearThreshold;
+    _autoClearEnabled = false;
+    _isClearing = false;
+    _autoClearTimer = null;
+    callbacks;
+    constructor(callbacks, config) {
+        super();
+        this.callbacks = callbacks;
+        this._autoCompactThreshold = config?.compactThreshold ?? DEFAULT_AUTO_COMPACT_THRESHOLD;
+        this._autoClearThreshold = config?.clearThreshold ?? DEFAULT_AUTO_CLEAR_THRESHOLD;
+    }
+    // ============================================================================
+    // Auto-compact getters/setters
+    // ============================================================================
+    get autoCompactThreshold() {
+        return this._autoCompactThreshold;
+    }
+    get autoCompactEnabled() {
+        return this._autoCompactEnabled;
+    }
+    get autoCompactPrompt() {
+        return this._autoCompactPrompt;
+    }
+    get isCompacting() {
+        return this._isCompacting;
+    }
+    setAutoCompact(enabled, threshold, prompt) {
+        this._autoCompactEnabled = enabled;
+        if (threshold !== undefined) {
+            if (threshold < MIN_AUTO_THRESHOLD || threshold > MAX_AUTO_THRESHOLD) {
+                console.warn(`[SessionAutoOps ${this.callbacks.getSessionId()}] Invalid autoCompact threshold ${threshold}, must be between ${MIN_AUTO_THRESHOLD} and ${MAX_AUTO_THRESHOLD}. Using default ${DEFAULT_AUTO_COMPACT_THRESHOLD}.`);
+                this._autoCompactThreshold = DEFAULT_AUTO_COMPACT_THRESHOLD;
+            }
+            else {
+                this._autoCompactThreshold = threshold;
+            }
+        }
+        if (prompt !== undefined) {
+            this._autoCompactPrompt = prompt;
+        }
+    }
+    // ============================================================================
+    // Auto-clear getters/setters
+    // ============================================================================
+    get autoClearThreshold() {
+        return this._autoClearThreshold;
+    }
+    get autoClearEnabled() {
+        return this._autoClearEnabled;
+    }
+    get isClearing() {
+        return this._isClearing;
+    }
+    setAutoClear(enabled, threshold) {
+        this._autoClearEnabled = enabled;
+        if (threshold !== undefined) {
+            if (threshold < MIN_AUTO_THRESHOLD || threshold > MAX_AUTO_THRESHOLD) {
+                console.warn(`[SessionAutoOps ${this.callbacks.getSessionId()}] Invalid autoClear threshold ${threshold}, must be between ${MIN_AUTO_THRESHOLD} and ${MAX_AUTO_THRESHOLD}. Using default ${DEFAULT_AUTO_CLEAR_THRESHOLD}.`);
+                this._autoClearThreshold = DEFAULT_AUTO_CLEAR_THRESHOLD;
+            }
+            else {
+                this._autoClearThreshold = threshold;
+            }
+        }
+    }
+    // ============================================================================
+    // Threshold checks
+    // ============================================================================
+    /**
+     * Check if auto-compact should be triggered based on current token count.
+     * Called after token count updates.
+     */
+    checkAutoCompact() {
+        if (this.callbacks.isStopped())
+            return;
+        if (!this._autoCompactEnabled || this._isCompacting || this._isClearing)
+            return;
+        const totalTokens = this.callbacks.getTotalTokens();
+        if (totalTokens >= this._autoCompactThreshold) {
+            this._isCompacting = true;
+            console.log(`[SessionAutoOps] Auto-compact triggered: ${totalTokens} tokens >= ${this._autoCompactThreshold} threshold`);
+            const checkAndCompact = async () => {
+                if (this.callbacks.isStopped())
+                    return;
+                if (!this._isCompacting)
+                    return;
+                if (!this.callbacks.isWorking()) {
+                    if (this.callbacks.isStopped())
+                        return;
+                    const compactCmd = this._autoCompactPrompt ? `/compact ${this._autoCompactPrompt}\r` : '/compact\r';
+                    await this.callbacks.writeCommand(compactCmd);
+                    this.emit('autoCompact', {
+                        tokens: totalTokens,
+                        threshold: this._autoCompactThreshold,
+                        prompt: this._autoCompactPrompt || undefined,
+                    });
+                    if (!this.callbacks.isStopped()) {
+                        this._autoCompactTimer = setTimeout(() => {
+                            if (this.callbacks.isStopped())
+                                return;
+                            this._autoCompactTimer = null;
+                            this._isCompacting = false;
+                        }, COMPACT_COOLDOWN_MS);
+                    }
+                }
+                else {
+                    if (!this.callbacks.isStopped()) {
+                        this._autoCompactTimer = setTimeout(checkAndCompact, AUTO_RETRY_DELAY_MS);
+                    }
+                }
+            };
+            if (!this.callbacks.isStopped()) {
+                this._autoCompactTimer = setTimeout(checkAndCompact, AUTO_INITIAL_DELAY_MS);
+            }
+        }
+    }
+    /**
+     * Check if auto-clear should be triggered based on current token count.
+     * Called after token count updates.
+     */
+    checkAutoClear() {
+        if (this.callbacks.isStopped())
+            return;
+        if (!this._autoClearEnabled || this._isClearing || this._isCompacting)
+            return;
+        const totalTokens = this.callbacks.getTotalTokens();
+        if (totalTokens >= this._autoClearThreshold) {
+            this._isClearing = true;
+            console.log(`[SessionAutoOps] Auto-clear triggered: ${totalTokens} tokens >= ${this._autoClearThreshold} threshold`);
+            const checkAndClear = async () => {
+                if (this.callbacks.isStopped())
+                    return;
+                if (!this._isClearing)
+                    return;
+                if (!this.callbacks.isWorking()) {
+                    if (this.callbacks.isStopped())
+                        return;
+                    await this.callbacks.writeCommand('/clear\r');
+                    this.emit('autoClear', { tokens: totalTokens, threshold: this._autoClearThreshold });
+                    if (!this.callbacks.isStopped()) {
+                        this._autoClearTimer = setTimeout(() => {
+                            if (this.callbacks.isStopped())
+                                return;
+                            this._autoClearTimer = null;
+                            this._isClearing = false;
+                        }, CLEAR_COOLDOWN_MS);
+                    }
+                }
+                else {
+                    if (!this.callbacks.isStopped()) {
+                        this._autoClearTimer = setTimeout(checkAndClear, AUTO_RETRY_DELAY_MS);
+                    }
+                }
+            };
+            if (!this.callbacks.isStopped()) {
+                this._autoClearTimer = setTimeout(checkAndClear, AUTO_INITIAL_DELAY_MS);
+            }
+        }
+    }
+    // ============================================================================
+    // Cleanup
+    // ============================================================================
+    /**
+     * Clear all timers and reset state. Called when the session stops.
+     */
+    destroy() {
+        if (this._autoCompactTimer) {
+            clearTimeout(this._autoCompactTimer);
+            this._autoCompactTimer = null;
+        }
+        this._isCompacting = false;
+        if (this._autoClearTimer) {
+            clearTimeout(this._autoClearTimer);
+            this._autoClearTimer = null;
+        }
+        this._isClearing = false;
+    }
+}
+//# sourceMappingURL=session-auto-ops.js.map

package/dist/session-auto-ops.js.map

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

package/dist/session-cli-builder.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Pure functions for building CLI arguments and environment variables
+ * for Claude and OpenCode CLI spawning.
+ *
+ * Extracted from Session to keep argument construction logic testable and
+ * separate from PTY lifecycle management.
+ *
+ * @module session-cli-builder
+ */
+import type { ClaudeMode } from './types.js';
+/**
+ * Build Claude CLI permission flags based on the configured mode.
+ * Returns an array of args to pass to the CLI.
+ */
+export declare function buildPermissionArgs(claudeMode: ClaudeMode, allowedTools?: string): string[];
+/**
+ * Build args for an interactive Claude CLI session (direct PTY, non-mux fallback).
+ *
+ * @param sessionId - The Codeman session ID (passed as --session-id to Claude)
+ * @param claudeMode - Permission mode for the CLI
+ * @param model - Optional model override (e.g., 'opus', 'sonnet')
+ * @param allowedTools - Optional comma-separated allowed tools list
+ * @returns Array of CLI arguments
+ */
+export declare function buildInteractiveArgs(sessionId: string, claudeMode: ClaudeMode, model?: string, allowedTools?: string): string[];
+/**
+ * Build args for a one-shot Claude CLI prompt (runPrompt mode).
+ *
+ * @param prompt - The prompt text to send
+ * @param model - Optional model override
+ * @returns Array of CLI arguments
+ */
+export declare function buildPromptArgs(prompt: string, model?: string): string[];
+/**
+ * Build environment variables for Claude CLI processes (direct PTY, non-mux).
+ *
+ * Augments process.env with:
+ * - UTF-8 locale settings
+ * - Augmented PATH (includes Claude CLI directory)
+ * - xterm-256color terminal type
+ * - Codeman session identification vars
+ *
+ * @param sessionId - The Codeman session ID
+ * @returns Environment variables object for pty.spawn
+ */
+export declare function buildClaudeEnv(sessionId: string): Record<string, string | undefined>;
+/**
+ * Build environment variables for mux-attached PTY sessions (tmux attach).
+ * Lighter than buildClaudeEnv — no PATH augmentation or Codeman vars needed
+ * since the mux session already has those set.
+ *
+ * @returns Environment variables object for pty.spawn
+ */
+export declare function buildMuxAttachEnv(): Record<string, string | undefined>;
+/**
+ * Build environment variables for a direct shell session (non-mux fallback).
+ *
+ * @param sessionId - The Codeman session ID
+ * @returns Environment variables object for pty.spawn
+ */
+export declare function buildShellEnv(sessionId: string): Record<string, string | undefined>;
+//# sourceMappingURL=session-cli-builder.d.ts.map

package/dist/session-cli-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cli-builder.d.ts","sourceRoot":"","sources":["../src/session-cli-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAIV;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAOxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAcpF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAStE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAUnF"}

package/dist/session-cli-builder.js

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Pure functions for building CLI arguments and environment variables
+ * for Claude and OpenCode CLI spawning.
+ *
+ * Extracted from Session to keep argument construction logic testable and
+ * separate from PTY lifecycle management.
+ *
+ * @module session-cli-builder
+ */
+import { getAugmentedPath } from './utils/claude-cli-resolver.js';
+/**
+ * Build Claude CLI permission flags based on the configured mode.
+ * Returns an array of args to pass to the CLI.
+ */
+export function buildPermissionArgs(claudeMode, allowedTools) {
+    switch (claudeMode) {
+        case 'dangerously-skip-permissions':
+            return ['--dangerously-skip-permissions'];
+        case 'allowedTools':
+            if (allowedTools) {
+                return ['--allowedTools', allowedTools];
+            }
+            // Fall back to normal mode if no tools specified
+            return [];
+        case 'normal':
+        default:
+            return [];
+    }
+}
+/**
+ * Build args for an interactive Claude CLI session (direct PTY, non-mux fallback).
+ *
+ * @param sessionId - The Codeman session ID (passed as --session-id to Claude)
+ * @param claudeMode - Permission mode for the CLI
+ * @param model - Optional model override (e.g., 'opus', 'sonnet')
+ * @param allowedTools - Optional comma-separated allowed tools list
+ * @returns Array of CLI arguments
+ */
+export function buildInteractiveArgs(sessionId, claudeMode, model, allowedTools) {
+    const args = [...buildPermissionArgs(claudeMode, allowedTools), '--session-id', sessionId];
+    if (model)
+        args.push('--model', model);
+    return args;
+}
+/**
+ * Build args for a one-shot Claude CLI prompt (runPrompt mode).
+ *
+ * @param prompt - The prompt text to send
+ * @param model - Optional model override
+ * @returns Array of CLI arguments
+ */
+export function buildPromptArgs(prompt, model) {
+    const args = ['-p', '--verbose', '--dangerously-skip-permissions', '--output-format', 'stream-json'];
+    if (model) {
+        args.push('--model', model);
+    }
+    args.push(prompt);
+    return args;
+}
+/**
+ * Build environment variables for Claude CLI processes (direct PTY, non-mux).
+ *
+ * Augments process.env with:
+ * - UTF-8 locale settings
+ * - Augmented PATH (includes Claude CLI directory)
+ * - xterm-256color terminal type
+ * - Codeman session identification vars
+ *
+ * @param sessionId - The Codeman session ID
+ * @returns Environment variables object for pty.spawn
+ */
+export function buildClaudeEnv(sessionId) {
+    return {
+        ...process.env,
+        LANG: 'en_US.UTF-8',
+        LC_ALL: 'en_US.UTF-8',
+        PATH: getAugmentedPath(),
+        TERM: 'xterm-256color',
+        COLORTERM: undefined,
+        CLAUDECODE: undefined,
+        // Inform Claude it's running within Codeman (helps prevent self-termination)
+        CODEMAN_MUX: '1',
+        CODEMAN_SESSION_ID: sessionId,
+        CODEMAN_API_URL: process.env.CODEMAN_API_URL || 'http://localhost:3000',
+    };
+}
+/**
+ * Build environment variables for mux-attached PTY sessions (tmux attach).
+ * Lighter than buildClaudeEnv — no PATH augmentation or Codeman vars needed
+ * since the mux session already has those set.
+ *
+ * @returns Environment variables object for pty.spawn
+ */
+export function buildMuxAttachEnv() {
+    return {
+        ...process.env,
+        LANG: 'en_US.UTF-8',
+        LC_ALL: 'en_US.UTF-8',
+        TERM: 'xterm-256color',
+        COLORTERM: undefined,
+        CLAUDECODE: undefined,
+    };
+}
+/**
+ * Build environment variables for a direct shell session (non-mux fallback).
+ *
+ * @param sessionId - The Codeman session ID
+ * @returns Environment variables object for pty.spawn
+ */
+export function buildShellEnv(sessionId) {
+    return {
+        ...process.env,
+        LANG: 'en_US.UTF-8',
+        LC_ALL: 'en_US.UTF-8',
+        TERM: 'xterm-256color',
+        CODEMAN_MUX: '1',
+        CODEMAN_SESSION_ID: sessionId,
+        CODEMAN_API_URL: process.env.CODEMAN_API_URL || 'http://localhost:3000',
+    };
+}
+//# sourceMappingURL=session-cli-builder.js.map

package/dist/session-cli-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cli-builder.js","sourceRoot":"","sources":["../src/session-cli-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsB,EAAE,YAAqB;IAC/E,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,8BAA8B;YACjC,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC5C,KAAK,cAAc;YACjB,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YAC1C,CAAC;YACD,iDAAiD;YACjD,OAAO,EAAE,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAiB,EACjB,UAAsB,EACtB,KAAc,EACd,YAAqB;IAErB,MAAM,IAAI,GAAG,CAAC,GAAG,mBAAmB,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAC3F,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,KAAc;IAC5D,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,gCAAgC,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC;IACrG,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,OAAO;QACL,GAAG,OAAO,CAAC,GAAG;QACd,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,gBAAgB,EAAE;QACxB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,SAAS;QACrB,6EAA6E;QAC7E,WAAW,EAAE,GAAG;QAChB,kBAAkB,EAAE,SAAS;QAC7B,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,uBAAuB;KACxE,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,GAAG,OAAO,CAAC,GAAG;QACd,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO;QACL,GAAG,OAAO,CAAC,GAAG;QACd,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,aAAa;QACrB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,GAAG;QAChB,kBAAkB,EAAE,SAAS;QAC7B,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,uBAAuB;KACxE,CAAC;AACJ,CAAC"}

package/dist/session-task-cache.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview LRU cache for task descriptions parsed from terminal output.
+ *
+ * Stores descriptions extracted from Claude Code's Task tool invocations
+ * (e.g., "Explore(Check files)") keyed by timestamp. Used to correlate
+ * with SubagentWatcher discoveries for better window titles.
+ *
+ * @module session-task-cache
+ */
+/**
+ * LRU cache for task descriptions parsed from terminal output.
+ *
+ * Descriptions are keyed by the timestamp when they were parsed.
+ * Old entries are automatically cleaned up based on maxAgeMs.
+ * Size is bounded by the underlying LRUMap.
+ */
+export declare class SessionTaskCache {
+    private readonly cache;
+    private readonly maxAgeMs;
+    constructor(maxSize?: number, maxAgeMs?: number);
+    /**
+     * Add a task description at the given timestamp.
+     */
+    add(timestamp: number, description: string): void;
+    /**
+     * Remove task descriptions older than maxAgeMs.
+     * LRUMap maintains insertion order, so we can break early
+     * once we find a non-expired entry.
+     */
+    private cleanupOld;
+    /**
+     * Get all recent task descriptions sorted by timestamp (most recent first).
+     */
+    getAll(): Array<{
+        timestamp: number;
+        description: string;
+    }>;
+    /**
+     * Find a task description that was parsed close to a given timestamp.
+     * Used to correlate with SubagentWatcher discoveries.
+     *
+     * @param subagentStartTime - The timestamp when the subagent was discovered
+     * @param maxAgeMs - Maximum age difference to consider (default 10 seconds)
+     * @returns The matching description or undefined
+     */
+    findNear(subagentStartTime: number, maxAgeMs?: number): string | undefined;
+    /**
+     * Clear all cached descriptions.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=session-task-cache.d.ts.map

package/dist/session-task-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-task-cache.d.ts","sourceRoot":"","sources":["../src/session-task-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,GAAE,MAAyB,EAAE,QAAQ,GAAE,MAA2B;IAKrF;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIjD;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAS3D;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAc,GAAG,MAAM,GAAG,SAAS;IAiBjF;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/session-task-cache.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview LRU cache for task descriptions parsed from terminal output.
+ *
+ * Stores descriptions extracted from Claude Code's Task tool invocations
+ * (e.g., "Explore(Check files)") keyed by timestamp. Used to correlate
+ * with SubagentWatcher discoveries for better window titles.
+ *
+ * @module session-task-cache
+ */
+import { LRUMap } from './utils/lru-map.js';
+/** Default maximum number of task descriptions to keep */
+const DEFAULT_MAX_SIZE = 100;
+/** Default maximum age for task descriptions (30 seconds) */
+const DEFAULT_MAX_AGE_MS = 30_000;
+/**
+ * LRU cache for task descriptions parsed from terminal output.
+ *
+ * Descriptions are keyed by the timestamp when they were parsed.
+ * Old entries are automatically cleaned up based on maxAgeMs.
+ * Size is bounded by the underlying LRUMap.
+ */
+export class SessionTaskCache {
+    cache;
+    maxAgeMs;
+    constructor(maxSize = DEFAULT_MAX_SIZE, maxAgeMs = DEFAULT_MAX_AGE_MS) {
+        this.cache = new LRUMap({ maxSize });
+        this.maxAgeMs = maxAgeMs;
+    }
+    /**
+     * Add a task description at the given timestamp.
+     */
+    add(timestamp, description) {
+        this.cache.set(timestamp, description);
+    }
+    /**
+     * Remove task descriptions older than maxAgeMs.
+     * LRUMap maintains insertion order, so we can break early
+     * once we find a non-expired entry.
+     */
+    cleanupOld() {
+        const cutoff = Date.now() - this.maxAgeMs;
+        for (const timestamp of this.cache.keysInOrder()) {
+            if (timestamp < cutoff) {
+                this.cache.delete(timestamp);
+            }
+            else {
+                break;
+            }
+        }
+    }
+    /**
+     * Get all recent task descriptions sorted by timestamp (most recent first).
+     */
+    getAll() {
+        this.cleanupOld();
+        const results = [];
+        for (const [timestamp, description] of this.cache) {
+            results.push({ timestamp, description });
+        }
+        return results.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Find a task description that was parsed close to a given timestamp.
+     * Used to correlate with SubagentWatcher discoveries.
+     *
+     * @param subagentStartTime - The timestamp when the subagent was discovered
+     * @param maxAgeMs - Maximum age difference to consider (default 10 seconds)
+     * @returns The matching description or undefined
+     */
+    findNear(subagentStartTime, maxAgeMs = 10000) {
+        this.cleanupOld();
+        let bestMatch;
+        let bestDiff = Infinity;
+        for (const [timestamp, description] of this.cache) {
+            const diff = Math.abs(subagentStartTime - timestamp);
+            if (diff < maxAgeMs && diff < bestDiff) {
+                bestMatch = { timestamp, description };
+                bestDiff = diff;
+            }
+        }
+        return bestMatch?.description;
+    }
+    /**
+     * Clear all cached descriptions.
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=session-task-cache.js.map

package/dist/session-task-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-task-cache.js","sourceRoot":"","sources":["../src/session-task-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,0DAA0D;AAC1D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,6DAA6D;AAC7D,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,CAAyB;IAC9B,QAAQ,CAAS;IAElC,YAAY,UAAkB,gBAAgB,EAAE,WAAmB,kBAAkB;QACnF,IAAI,CAAC,KAAK,GAAG,IAAI,MAAM,CAAiB,EAAE,OAAO,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,WAAmB;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACK,UAAU;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC1C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACjD,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAsD,EAAE,CAAC;QACtE,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,iBAAyB,EAAE,WAAmB,KAAK;QAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,SAAiE,CAAC;QACtE,IAAI,QAAQ,GAAG,QAAQ,CAAC;QAExB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;YACrD,IAAI,IAAI,GAAG,QAAQ,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACvC,SAAS,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;gBACvC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,EAAE,WAAW,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/session.d.ts

@@ -157,9 +157,7 @@ export declare class Session extends EventEmitter {
     readonly workingDir: string;
     readonly createdAt: number;
     readonly mode: SessionMode;
-    /** Maximum number of task descriptions to keep (LRUMap handles size limit automatically) */
-    private static readonly MAX_TASK_DESCRIPTIONS;
-    private static readonly TASK_DESCRIPTION_MAX_AGE_MS;
+    private _taskCache;
     private _name;
     private ptyProcess;
     private _pid;
@@ -184,13 +182,7 @@ export declare class Session extends EventEmitter {
     private _taskTracker;
     private _totalInputTokens;
     private _totalOutputTokens;
-    private _autoClearThreshold;
-    private _autoClearEnabled;
-    private _isClearing;
-    private _autoCompactThreshold;
-    private _autoCompactEnabled;
-    private _autoCompactPrompt;
-    private _isCompacting;
+    private _autoOps;
     private _imageWatcherEnabled;
     private _flickerFilterEnabled;
     private _cliVersion;
@@ -198,8 +190,6 @@ export declare class Session extends EventEmitter {
     private _cliAccountType;
     private _cliLatestVersion;
     private _cliInfoParsed;
-    private _autoCompactTimer;
-    private _autoClearTimer;
     private _promptCheckInterval;
     private _promptCheckTimeout;
     private _shellIdleTimer;
@@ -220,7 +210,6 @@ export declare class Session extends EventEmitter {
     private _ralphHandlers;
     private _bashToolParser;
     private _bashToolHandlers;
-    private _recentTaskDescriptions;
     private _lastExpensiveProcessTime;
     private _pendingCleanData;
     private _expensiveProcessTimer;
@@ -288,11 +277,6 @@ export declare class Session extends EventEmitter {
     get claudeMode(): ClaudeMode;
     /** Allowed tools list (for 'allowedTools' mode) */
     get allowedTools(): string | undefined;
-    /**
-     * Build Claude CLI permission flags based on the configured mode.
-     * Returns an array of args to pass to the CLI.
-     */
-    private _buildPermissionArgs;
     /**
      * Set CPU priority configuration.
      * Note: This only affects new sessions; existing running processes won't be changed.
@@ -312,14 +296,6 @@ export declare class Session extends EventEmitter {
     get autoClearEnabled(): boolean;
     get name(): string;
     set name(value: string);
-    /** Minimum valid threshold for auto-clear/compact (1000 tokens) */
-    private static readonly MIN_AUTO_THRESHOLD;
-    /** Maximum valid threshold for auto-clear/compact (500k tokens) */
-    private static readonly MAX_AUTO_THRESHOLD;
-    /** Default auto-clear threshold when invalid value provided */
-    private static readonly DEFAULT_AUTO_CLEAR_THRESHOLD;
-    /** Default auto-compact threshold when invalid value provided */
-    private static readonly DEFAULT_AUTO_COMPACT_THRESHOLD;
     setAutoClear(enabled: boolean, threshold?: number): void;
     get autoCompactThreshold(): number;
     get autoCompactEnabled(): boolean;
@@ -580,11 +556,6 @@ export declare class Session extends EventEmitter {
      * Used by both processOutput() and parseTaskDescriptionsFromTerminalData().
      */
     private parseTaskDescriptionsDirect;
-    /**
-     * Remove task descriptions older than TASK_DESCRIPTION_MAX_AGE_MS.
-     * Size limit is handled automatically by LRUMap eviction on set().
-     */
-    private cleanupOldTaskDescriptions;
     /**
      * Get recent task descriptions parsed from terminal output.
      * Returns descriptions sorted by timestamp (most recent first).
@@ -604,8 +575,6 @@ export declare class Session extends EventEmitter {
     findTaskDescriptionNear(subagentStartTime: number, maxAgeMs?: number): string | undefined;
     private parseTokensFromStatusLine;
     private parseClaudeCodeInfo;
-    private checkAutoCompact;
-    private checkAutoClear;
     /**
      * Sends input directly to the PTY process.
      *