aicodeman 0.2.9 → 0.3.1

package/dist/respawn-metrics.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fileoverview Cycle metrics tracker for respawn controller.
+ *
+ * Extracted from respawn-controller.ts for modularity. Tracks per-cycle metrics
+ * and maintains aggregate statistics across all tracked cycles.
+ *
+ * @module respawn-metrics
+ */
+import type { RespawnCycleMetrics, RespawnAggregateMetrics, CycleOutcome } from './types.js';
+/**
+ * Tracks respawn cycle metrics and maintains aggregate statistics.
+ *
+ * Each respawn cycle is tracked from start to completion, recording timing,
+ * steps completed, and outcome. Aggregate metrics provide a rolling view
+ * of system health across recent cycles.
+ */
+export declare class RespawnCycleMetricsTracker {
+    /** Current cycle being tracked */
+    private currentCycleMetrics;
+    /** Recent cycle metrics (rolling window for aggregate calculation) */
+    private recentCycleMetrics;
+    /** Aggregate metrics across all tracked cycles */
+    private aggregateMetrics;
+    /**
+     * Start tracking metrics for a new cycle.
+     * Called when a respawn cycle begins.
+     *
+     * @param sessionId - The session this cycle belongs to
+     * @param cycleNumber - The cycle number within the session
+     * @param idleReason - What triggered idle detection
+     * @param idleDetectionStartTime - Timestamp when idle detection started
+     * @param lastTokenCount - Token count at start of cycle
+     * @param adaptiveCompletionConfirmMs - Completion confirm timeout used
+     */
+    startCycle(sessionId: string, cycleNumber: number, idleReason: string, idleDetectionStartTime: number, lastTokenCount: number, adaptiveCompletionConfirmMs: number): void;
+    /**
+     * Record a completed step in the current cycle.
+     * @param step - Name of the step (e.g., 'update', 'clear', 'init')
+     */
+    recordStep(step: string): void;
+    /**
+     * Mark that /clear was skipped in the current cycle.
+     */
+    markClearSkipped(): void;
+    /**
+     * Get the current in-progress cycle metrics (for external inspection).
+     * @returns The current cycle metrics, or null if no cycle is in progress
+     */
+    getCurrentCycle(): Partial<RespawnCycleMetrics> | null;
+    /**
+     * Complete the current cycle metrics with outcome.
+     * Adds to recent metrics and updates aggregates.
+     *
+     * @param outcome - Outcome of the cycle
+     * @param lastTokenCount - Token count at end of cycle
+     * @param errorMessage - Optional error message if outcome is 'error'
+     * @returns The completed cycle metrics, or null if no cycle was in progress
+     */
+    completeCycle(outcome: CycleOutcome, lastTokenCount: number, errorMessage?: string): RespawnCycleMetrics | null;
+    /**
+     * Get aggregate metrics for monitoring.
+     * @returns Copy of aggregate metrics
+     */
+    getAggregate(): RespawnAggregateMetrics;
+    /**
+     * Get recent cycle metrics for analysis.
+     * @param limit - Maximum number of metrics to return (default: 20)
+     * @returns Recent cycle metrics, newest first
+     */
+    getRecent(limit?: number): RespawnCycleMetrics[];
+    /**
+     * Reset all metrics state.
+     */
+    reset(): void;
+    /**
+     * Update aggregate metrics with a new cycle's data.
+     * @param metrics - The completed cycle metrics
+     */
+    private updateAggregateMetrics;
+}
+//# sourceMappingURL=respawn-metrics.d.ts.map

package/dist/respawn-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respawn-metrics.d.ts","sourceRoot":"","sources":["../src/respawn-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO7F;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACrC,kCAAkC;IAClC,OAAO,CAAC,mBAAmB,CAA6C;IAExE,sEAAsE;IACtE,OAAO,CAAC,kBAAkB,CAA6B;IAEvD,kDAAkD;IAClD,OAAO,CAAC,gBAAgB,CAWtB;IAEF;;;;;;;;;;OAUG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,sBAAsB,EAAE,MAAM,EAC9B,cAAc,EAAE,MAAM,EACtB,2BAA2B,EAAE,MAAM,GAClC,IAAI;IAgBP;;;OAGG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAMxB;;;OAGG;IACH,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAItD;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI;IA4B/G;;;OAGG;IACH,YAAY,IAAI,uBAAuB;IAIvC;;;;OAIG;IACH,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,mBAAmB,EAAE;IAIpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAiBb;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CA6C/B"}

package/dist/respawn-metrics.js

@@ -0,0 +1,198 @@
+/**
+ * @fileoverview Cycle metrics tracker for respawn controller.
+ *
+ * Extracted from respawn-controller.ts for modularity. Tracks per-cycle metrics
+ * and maintains aggregate statistics across all tracked cycles.
+ *
+ * @module respawn-metrics
+ */
+import { assertNever } from './utils/index.js';
+/**
+ * Maximum number of cycle metrics to keep in memory.
+ */
+const MAX_CYCLE_METRICS_IN_MEMORY = 100;
+/**
+ * Tracks respawn cycle metrics and maintains aggregate statistics.
+ *
+ * Each respawn cycle is tracked from start to completion, recording timing,
+ * steps completed, and outcome. Aggregate metrics provide a rolling view
+ * of system health across recent cycles.
+ */
+export class RespawnCycleMetricsTracker {
+    /** Current cycle being tracked */
+    currentCycleMetrics = null;
+    /** Recent cycle metrics (rolling window for aggregate calculation) */
+    recentCycleMetrics = [];
+    /** Aggregate metrics across all tracked cycles */
+    aggregateMetrics = {
+        totalCycles: 0,
+        successfulCycles: 0,
+        stuckRecoveryCycles: 0,
+        blockedCycles: 0,
+        errorCycles: 0,
+        avgCycleDurationMs: 0,
+        avgIdleDetectionMs: 0,
+        p90CycleDurationMs: 0,
+        successRate: 100,
+        lastUpdatedAt: Date.now(),
+    };
+    /**
+     * Start tracking metrics for a new cycle.
+     * Called when a respawn cycle begins.
+     *
+     * @param sessionId - The session this cycle belongs to
+     * @param cycleNumber - The cycle number within the session
+     * @param idleReason - What triggered idle detection
+     * @param idleDetectionStartTime - Timestamp when idle detection started
+     * @param lastTokenCount - Token count at start of cycle
+     * @param adaptiveCompletionConfirmMs - Completion confirm timeout used
+     */
+    startCycle(sessionId, cycleNumber, idleReason, idleDetectionStartTime, lastTokenCount, adaptiveCompletionConfirmMs) {
+        const now = Date.now();
+        this.currentCycleMetrics = {
+            cycleId: `${sessionId}:${cycleNumber}`,
+            sessionId,
+            cycleNumber,
+            startedAt: now,
+            idleReason,
+            idleDetectionMs: now - idleDetectionStartTime,
+            stepsCompleted: [],
+            clearSkipped: false,
+            tokenCountAtStart: lastTokenCount,
+            completionConfirmMsUsed: adaptiveCompletionConfirmMs,
+        };
+    }
+    /**
+     * Record a completed step in the current cycle.
+     * @param step - Name of the step (e.g., 'update', 'clear', 'init')
+     */
+    recordStep(step) {
+        if (!this.currentCycleMetrics)
+            return;
+        this.currentCycleMetrics.stepsCompleted?.push(step);
+    }
+    /**
+     * Mark that /clear was skipped in the current cycle.
+     */
+    markClearSkipped() {
+        if (this.currentCycleMetrics) {
+            this.currentCycleMetrics.clearSkipped = true;
+        }
+    }
+    /**
+     * Get the current in-progress cycle metrics (for external inspection).
+     * @returns The current cycle metrics, or null if no cycle is in progress
+     */
+    getCurrentCycle() {
+        return this.currentCycleMetrics;
+    }
+    /**
+     * Complete the current cycle metrics with outcome.
+     * Adds to recent metrics and updates aggregates.
+     *
+     * @param outcome - Outcome of the cycle
+     * @param lastTokenCount - Token count at end of cycle
+     * @param errorMessage - Optional error message if outcome is 'error'
+     * @returns The completed cycle metrics, or null if no cycle was in progress
+     */
+    completeCycle(outcome, lastTokenCount, errorMessage) {
+        if (!this.currentCycleMetrics)
+            return null;
+        const now = Date.now();
+        const metrics = {
+            ...this.currentCycleMetrics,
+            completedAt: now,
+            durationMs: now - (this.currentCycleMetrics.startedAt ?? now),
+            outcome,
+            errorMessage,
+            tokenCountAtEnd: lastTokenCount,
+        };
+        // Add to recent metrics
+        this.recentCycleMetrics.push(metrics);
+        if (this.recentCycleMetrics.length > MAX_CYCLE_METRICS_IN_MEMORY) {
+            this.recentCycleMetrics.shift();
+        }
+        // Update aggregate metrics
+        this.updateAggregateMetrics(metrics);
+        // Clear current cycle
+        this.currentCycleMetrics = null;
+        return metrics;
+    }
+    /**
+     * Get aggregate metrics for monitoring.
+     * @returns Copy of aggregate metrics
+     */
+    getAggregate() {
+        return { ...this.aggregateMetrics };
+    }
+    /**
+     * Get recent cycle metrics for analysis.
+     * @param limit - Maximum number of metrics to return (default: 20)
+     * @returns Recent cycle metrics, newest first
+     */
+    getRecent(limit = 20) {
+        return this.recentCycleMetrics.slice(-limit).reverse();
+    }
+    /**
+     * Reset all metrics state.
+     */
+    reset() {
+        this.currentCycleMetrics = null;
+        this.recentCycleMetrics = [];
+        this.aggregateMetrics = {
+            totalCycles: 0,
+            successfulCycles: 0,
+            stuckRecoveryCycles: 0,
+            blockedCycles: 0,
+            errorCycles: 0,
+            avgCycleDurationMs: 0,
+            avgIdleDetectionMs: 0,
+            p90CycleDurationMs: 0,
+            successRate: 100,
+            lastUpdatedAt: Date.now(),
+        };
+    }
+    /**
+     * Update aggregate metrics with a new cycle's data.
+     * @param metrics - The completed cycle metrics
+     */
+    updateAggregateMetrics(metrics) {
+        const agg = this.aggregateMetrics;
+        agg.totalCycles++;
+        switch (metrics.outcome) {
+            case 'success':
+                agg.successfulCycles++;
+                break;
+            case 'stuck_recovery':
+                agg.stuckRecoveryCycles++;
+                break;
+            case 'blocked':
+                agg.blockedCycles++;
+                break;
+            case 'error':
+                agg.errorCycles++;
+                break;
+            case 'cancelled':
+                // Cancelled cycles don't count towards any specific category
+                // but are still counted in totalCycles
+                break;
+            default:
+                assertNever(metrics.outcome, `Unhandled CycleOutcome: ${metrics.outcome}`);
+        }
+        // Recalculate averages using all recent metrics
+        const durations = this.recentCycleMetrics.map((m) => m.durationMs);
+        const idleTimes = this.recentCycleMetrics.map((m) => m.idleDetectionMs);
+        if (durations.length > 0) {
+            agg.avgCycleDurationMs = Math.round(durations.reduce((a, b) => a + b, 0) / durations.length);
+            agg.avgIdleDetectionMs = Math.round(idleTimes.reduce((a, b) => a + b, 0) / idleTimes.length);
+            // Calculate P90
+            const sortedDurations = [...durations].sort((a, b) => a - b);
+            const p90Index = Math.floor(sortedDurations.length * 0.9);
+            agg.p90CycleDurationMs = sortedDurations[p90Index];
+        }
+        // Calculate success rate
+        agg.successRate = agg.totalCycles > 0 ? Math.round((agg.successfulCycles / agg.totalCycles) * 100) : 100;
+        agg.lastUpdatedAt = Date.now();
+    }
+}
+//# sourceMappingURL=respawn-metrics.js.map

package/dist/respawn-metrics.js.map

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

package/dist/respawn-patterns.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Pure utility functions for terminal pattern detection in respawn controller.
+ *
+ * Extracted from respawn-controller.ts for modularity. These are stateless functions
+ * and constants used to detect completion messages, working patterns, and token counts
+ * in terminal output.
+ *
+ * @module respawn-patterns
+ */
+/**
+ * Patterns indicating Claude is ready for input (legacy fallback).
+ * Used as secondary signals, not primary detection.
+ */
+export declare const PROMPT_PATTERNS: string[];
+/**
+ * Patterns indicating Claude is actively working.
+ * When detected, resets all idle detection timers.
+ * Note: ✻ and ✽ removed - they appear in completion messages too.
+ */
+export declare const WORKING_PATTERNS: string[];
+/**
+ * Check if data contains a completion message pattern.
+ * Matches "Worked for Xh Xm Xs" time duration patterns.
+ *
+ * @param data - Raw terminal output data
+ * @returns True if completion message pattern is found
+ */
+export declare function isCompletionMessage(data: string): boolean;
+/**
+ * Check if a rolling window of terminal output contains working patterns.
+ * The rolling window catches patterns split across chunks (e.g., "Thin" + "king").
+ *
+ * @param window - Rolling window of recent terminal output (already includes current data)
+ * @returns True if any working pattern is found in the window
+ */
+export declare function hasWorkingPattern(window: string): boolean;
+/**
+ * Extract token count from data if present.
+ * Parses patterns like "123.4k tokens" or "1.5M tokens".
+ *
+ * @param data - Raw terminal output data
+ * @returns Parsed token count, or null if no token pattern found
+ */
+export declare function extractTokenCount(data: string): number | null;
+//# sourceMappingURL=respawn-patterns.d.ts.map

package/dist/respawn-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respawn-patterns.d.ts","sourceRoot":"","sources":["../src/respawn-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;GAGG;AACH,eAAO,MAAM,eAAe,UAI3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAkD5B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU7D"}

package/dist/respawn-patterns.js

@@ -0,0 +1,125 @@
+/**
+ * @fileoverview Pure utility functions for terminal pattern detection in respawn controller.
+ *
+ * Extracted from respawn-controller.ts for modularity. These are stateless functions
+ * and constants used to detect completion messages, working patterns, and token counts
+ * in terminal output.
+ *
+ * @module respawn-patterns
+ */
+import { TOKEN_PATTERN } from './utils/index.js';
+// ========== Constants ==========
+/**
+ * Pattern to detect completion messages from Claude Code.
+ * Requires "Worked for" prefix to avoid false positives from bare time durations
+ * in regular text (e.g., "wait for 5s", "run for 2m").
+ *
+ * Matches: "Worked for 2m 46s", "Worked for 46s", "Worked for 1h 2m 3s"
+ * Does NOT match: "wait for 5s", "run for 2m", "for 3s the system..."
+ */
+const COMPLETION_TIME_PATTERN = /\bWorked\s+for\s+\d+[hms](\s*\d+[hms])*/i;
+/**
+ * Patterns indicating Claude is ready for input (legacy fallback).
+ * Used as secondary signals, not primary detection.
+ */
+export const PROMPT_PATTERNS = [
+    '❯', // Standard prompt
+    '\u276f', // Unicode variant
+    '⏵', // Claude Code prompt variant
+];
+/**
+ * Patterns indicating Claude is actively working.
+ * When detected, resets all idle detection timers.
+ * Note: ✻ and ✽ removed - they appear in completion messages too.
+ */
+export const WORKING_PATTERNS = [
+    'Thinking',
+    'Writing',
+    'Reading',
+    'Running',
+    'Searching',
+    'Editing',
+    'Creating',
+    'Deleting',
+    'Analyzing',
+    'Executing',
+    'Synthesizing',
+    'Brewing', // Claude's processing indicators
+    'Compiling',
+    'Building',
+    'Installing',
+    'Fetching',
+    'Downloading',
+    'Processing',
+    'Generating',
+    'Loading',
+    'Starting',
+    'Updating',
+    'Checking',
+    'Validating',
+    'Testing',
+    'Formatting',
+    'Linting',
+    '⠋',
+    '⠙',
+    '⠹',
+    '⠸',
+    '⠼',
+    '⠴',
+    '⠦',
+    '⠧',
+    '⠇',
+    '⠏', // Spinner chars
+    '◐',
+    '◓',
+    '◑',
+    '◒', // Alternative spinners
+    '⣾',
+    '⣽',
+    '⣻',
+    '⢿',
+    '⡿',
+    '⣟',
+    '⣯',
+    '⣷', // Braille spinners
+];
+/**
+ * Check if data contains a completion message pattern.
+ * Matches "Worked for Xh Xm Xs" time duration patterns.
+ *
+ * @param data - Raw terminal output data
+ * @returns True if completion message pattern is found
+ */
+export function isCompletionMessage(data) {
+    return COMPLETION_TIME_PATTERN.test(data);
+}
+/**
+ * Check if a rolling window of terminal output contains working patterns.
+ * The rolling window catches patterns split across chunks (e.g., "Thin" + "king").
+ *
+ * @param window - Rolling window of recent terminal output (already includes current data)
+ * @returns True if any working pattern is found in the window
+ */
+export function hasWorkingPattern(window) {
+    return WORKING_PATTERNS.some((pattern) => window.includes(pattern));
+}
+/**
+ * Extract token count from data if present.
+ * Parses patterns like "123.4k tokens" or "1.5M tokens".
+ *
+ * @param data - Raw terminal output data
+ * @returns Parsed token count, or null if no token pattern found
+ */
+export function extractTokenCount(data) {
+    const match = data.match(TOKEN_PATTERN);
+    if (!match)
+        return null;
+    let count = parseFloat(match[1]);
+    const suffix = match[2]?.toLowerCase();
+    if (suffix === 'k')
+        count *= 1000;
+    else if (suffix === 'm')
+        count *= 1000000;
+    return Math.round(count);
+}
+//# sourceMappingURL=respawn-patterns.js.map

package/dist/respawn-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respawn-patterns.js","sourceRoot":"","sources":["../src/respawn-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,kCAAkC;AAElC;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,0CAA0C,CAAC;AAE3E;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,kBAAkB;IACvB,QAAQ,EAAE,kBAAkB;IAC5B,GAAG,EAAE,6BAA6B;CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,SAAS;IACT,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;IACT,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,cAAc;IACd,SAAS,EAAE,iCAAiC;IAC5C,WAAW;IACX,UAAU;IACV,YAAY;IACZ,UAAU;IACV,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,UAAU;IACV,UAAU;IACV,UAAU;IACV,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,SAAS;IACT,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG,EAAE,gBAAgB;IACrB,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG,EAAE,uBAAuB;IAC5B,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG,EAAE,mBAAmB;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG;QAAE,KAAK,IAAI,IAAI,CAAC;SAC7B,IAAI,MAAM,KAAK,GAAG;QAAE,KAAK,IAAI,OAAO,CAAC;IAE1C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/session-auto-ops.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @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';
+/**
+ * Callbacks required by SessionAutoOps to interact with the parent Session.
+ */
+export interface AutoOpsCallbacks {
+    /** Send a command via the terminal multiplexer */
+    writeCommand: (command: string) => Promise<boolean>;
+    /** Check if Claude is currently working */
+    isWorking: () => boolean;
+    /** Check if the session has been stopped */
+    isStopped: () => boolean;
+    /** Get current total token count (input + output) */
+    getTotalTokens: () => number;
+    /** Get session ID for logging */
+    getSessionId: () => string;
+}
+/**
+ * Events emitted by SessionAutoOps.
+ */
+export interface SessionAutoOpsEvents {
+    /** Auto-compact was triggered and the /compact command was sent */
+    autoCompact: (data: {
+        tokens: number;
+        threshold: number;
+        prompt?: string;
+    }) => void;
+    /** Auto-clear was triggered and the /clear command was sent */
+    autoClear: (data: {
+        tokens: number;
+        threshold: number;
+    }) => void;
+}
+/**
+ * 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 declare class SessionAutoOps extends EventEmitter {
+    private _autoCompactThreshold;
+    private _autoCompactEnabled;
+    private _autoCompactPrompt;
+    private _isCompacting;
+    private _autoCompactTimer;
+    private _autoClearThreshold;
+    private _autoClearEnabled;
+    private _isClearing;
+    private _autoClearTimer;
+    private readonly callbacks;
+    constructor(callbacks: AutoOpsCallbacks, config?: {
+        compactThreshold?: number;
+        clearThreshold?: number;
+    });
+    get autoCompactThreshold(): number;
+    get autoCompactEnabled(): boolean;
+    get autoCompactPrompt(): string;
+    get isCompacting(): boolean;
+    setAutoCompact(enabled: boolean, threshold?: number, prompt?: string): void;
+    get autoClearThreshold(): number;
+    get autoClearEnabled(): boolean;
+    get isClearing(): boolean;
+    setAutoClear(enabled: boolean, threshold?: number): void;
+    /**
+     * Check if auto-compact should be triggered based on current token count.
+     * Called after token count updates.
+     */
+    checkAutoCompact(): void;
+    /**
+     * Check if auto-clear should be triggered based on current token count.
+     * Called after token count updates.
+     */
+    checkAutoClear(): void;
+    /**
+     * Clear all timers and reset state. Called when the session stops.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=session-auto-ops.d.ts.map

package/dist/session-auto-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-auto-ops.d.ts","sourceRoot":"","sources":["../src/session-auto-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA8B3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,2CAA2C;IAC3C,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,qDAAqD;IACrD,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,iCAAiC;IACjC,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,WAAW,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpF,+DAA+D;IAC/D,SAAS,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAE9C,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,mBAAmB,CAAkB;IAC7C,OAAO,CAAC,kBAAkB,CAAc;IACxC,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,iBAAiB,CAA+B;IAGxD,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;gBAEjC,SAAS,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE;IAWxG,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAqB3E,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBxD;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IA8CxB;;;OAGG;IACH,cAAc,IAAI,IAAI;IA6CtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB"}