@codebolt/agent 6.0.0 → 6.0.1

package/dist/unified/services/compaction/contextCollapse.js

@@ -0,0 +1,291 @@
+"use strict";
+/**
+ * Layer 3: Context Collapse
+ *
+ * Incrementally archives messages into a collapse store with granular summaries.
+ * Unlike full auto-compact which produces one monolithic summary, context collapse
+ * preserves granular per-range summaries so more context is retained.
+ *
+ * Key properties:
+ * - Commits at ~90% of context window
+ * - Blocks at ~95% (hard limit)
+ * - Archives messages incrementally (not all at once)
+ * - Read-time projection over full history
+ * - Recovery: drains staged collapses on 413 errors (cheap)
+ * - When enabled, suppresses auto-compact to avoid racing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextCollapse = void 0;
+const types_1 = require("./types");
+/** Default commit threshold (fraction of context window) */
+const DEFAULT_COMMIT_THRESHOLD = 0.9;
+/** Default blocking threshold */
+const DEFAULT_BLOCKING_THRESHOLD = 0.95;
+/** Minimum tokens to archive per collapse commit */
+const MIN_COLLAPSE_TOKENS = 2000;
+class ContextCollapse {
+    constructor(options) {
+        var _a, _b, _c, _d, _e, _f;
+        this.name = 'collapse';
+        /** The collapse store: ordered list of collapsed ranges */
+        this.store = [];
+        /** Staged collapses waiting for API confirmation */
+        this.staged = [];
+        this.options = {
+            commitThreshold: (_a = options === null || options === void 0 ? void 0 : options.commitThreshold) !== null && _a !== void 0 ? _a : DEFAULT_COMMIT_THRESHOLD,
+            blockingThreshold: (_b = options === null || options === void 0 ? void 0 : options.blockingThreshold) !== null && _b !== void 0 ? _b : DEFAULT_BLOCKING_THRESHOLD,
+            modelTokenLimit: (_c = options === null || options === void 0 ? void 0 : options.modelTokenLimit) !== null && _c !== void 0 ? _c : 128000,
+            llmRole: (_d = options === null || options === void 0 ? void 0 : options.llmRole) !== null && _d !== void 0 ? _d : 'summarizer',
+            maxSummaries: (_e = options === null || options === void 0 ? void 0 : options.maxSummaries) !== null && _e !== void 0 ? _e : 20,
+            enableLogging: (_f = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _f !== void 0 ? _f : false,
+        };
+    }
+    shouldApply(ctx) {
+        if (!ctx.contextCollapseEnabled)
+            return false;
+        const estimator = new types_1.TokenEstimator();
+        const tokenCount = estimator.estimateForMessages(ctx.messages);
+        const threshold = this.options.commitThreshold * this.options.modelTokenLimit;
+        return tokenCount >= threshold;
+    }
+    async apply(ctx) {
+        if (!ctx.contextCollapseEnabled)
+            return ctx;
+        const estimator = new types_1.TokenEstimator();
+        const tokenCount = estimator.estimateForMessages(ctx.messages);
+        const commitThreshold = this.options.commitThreshold * this.options.modelTokenLimit;
+        if (tokenCount < commitThreshold) {
+            return ctx;
+        }
+        // Determine how many messages to archive
+        const messages = ctx.messages;
+        const targetTokens = commitThreshold * 0.8; // Target 80% of threshold after collapse
+        const currentTokens = tokenCount;
+        const tokensToArchive = currentTokens - targetTokens;
+        if (tokensToArchive < MIN_COLLAPSE_TOKENS) {
+            return ctx;
+        }
+        // Find the split point: archive from the beginning, after system messages
+        const splitIdx = this.findSplitPoint(messages, tokensToArchive, estimator);
+        if (splitIdx <= 0) {
+            return ctx;
+        }
+        // Archive the range
+        const toArchive = messages.slice(0, splitIdx);
+        const preserved = messages.slice(splitIdx);
+        // Generate granular summary
+        const summary = await this.generateGranularSummary(toArchive);
+        const entry = {
+            startIdx: 0,
+            endIdx: splitIdx,
+            summary,
+            originalTokens: estimator.estimateForMessages(toArchive),
+            timestamp: new Date().toISOString(),
+            staged: true,
+        };
+        // Add to staged (will be confirmed after successful API call)
+        this.staged.push(entry);
+        // Build projected view: summaries + preserved messages
+        const systemMessages = toArchive.filter(m => m.role === 'system');
+        const projectedMessages = [
+            ...systemMessages,
+            ...this.buildSummaryMessages(),
+            ...preserved,
+        ];
+        const tokensFreed = currentTokens - estimator.estimateForMessages(projectedMessages);
+        const boundary = {
+            layer: 'collapse',
+            tokensFreed: Math.max(0, tokensFreed),
+            messagesRemoved: toArchive.length - systemMessages.length,
+            timestamp: entry.timestamp,
+        };
+        if (this.options.enableLogging) {
+            console.log(`[ContextCollapse] Collapsed ${toArchive.length} messages (~${entry.originalTokens} tokens). Freed ~${tokensFreed} tokens.`);
+        }
+        return {
+            ...ctx,
+            messages: projectedMessages,
+            compactionHistory: [...(ctx.compactionHistory || []), boundary],
+        };
+    }
+    /**
+     * Drain staged collapses on API 413 errors (recovery path).
+     * Confirms all staged entries into the permanent store.
+     */
+    drainStaged() {
+        if (this.staged.length === 0)
+            return 0;
+        const count = this.staged.length;
+        for (const entry of this.staged) {
+            entry.staged = false;
+            this.store.push(entry);
+        }
+        // Trim store to max size
+        if (this.store.length > this.options.maxSummaries) {
+            this.store = this.store.slice(-this.options.maxSummaries);
+        }
+        this.staged = [];
+        return count;
+    }
+    /**
+     * Recovery from overflow: drain staged collapses and rebuild.
+     */
+    recoverFromOverflow(messages) {
+        const committed = this.drainStaged();
+        if (committed === 0) {
+            return { messages, committed: 0 };
+        }
+        // Rebuild with confirmed summaries
+        const systemMessages = messages.filter(m => m.role === 'system');
+        const nonSystem = messages.filter(m => m.role !== 'system');
+        const rebuilt = [
+            ...systemMessages,
+            ...this.buildSummaryMessages(),
+            ...nonSystem,
+        ];
+        return { messages: rebuilt, committed };
+    }
+    /**
+     * Check if at blocking threshold.
+     */
+    isAtBlockingLimit(messages) {
+        const estimator = new types_1.TokenEstimator();
+        const tokenCount = estimator.estimateForMessages(messages);
+        const blockingLimit = this.options.blockingThreshold * this.options.modelTokenLimit;
+        return tokenCount >= blockingLimit;
+    }
+    reset() {
+        this.store = [];
+        this.staged = [];
+    }
+    // ─── Private Helpers ──────────────────────────────────────────────
+    findSplitPoint(messages, tokensToArchive, estimator) {
+        var _a, _b;
+        let accumulated = 0;
+        // Skip system messages at the beginning
+        let startIdx = 0;
+        while (startIdx < messages.length && ((_a = messages[startIdx]) === null || _a === void 0 ? void 0 : _a.role) === 'system') {
+            startIdx++;
+        }
+        for (let i = startIdx; i < messages.length; i++) {
+            const msg = messages[i];
+            if (!msg)
+                continue;
+            const content = typeof msg.content === 'string'
+                ? msg.content
+                : JSON.stringify((_b = msg.content) !== null && _b !== void 0 ? _b : '');
+            accumulated += estimator.estimate(content) + 4;
+            // Don't split in the middle of a tool call/response pair
+            if (msg.role === 'assistant' && msg.tool_calls && msg.tool_calls.length > 0) {
+                continue;
+            }
+            if (msg.role === 'tool' || msg.tool_call_id) {
+                continue;
+            }
+            // Safe split point: user message or assistant without pending tools
+            if (accumulated >= tokensToArchive) {
+                return i + 1;
+            }
+        }
+        return 0; // No safe split point found
+    }
+    buildSummaryMessages() {
+        const allEntries = [...this.store, ...this.staged];
+        if (allEntries.length === 0)
+            return [];
+        const combinedSummary = allEntries
+            .map((entry, i) => `--- Collapsed Section ${i + 1} ---\n${entry.summary}`)
+            .join('\n\n');
+        return [
+            {
+                role: 'user',
+                content: `[Context Summary - The following sections were collapsed to manage context length. Key information has been preserved.]\n\n${combinedSummary}`,
+            },
+            {
+                role: 'assistant',
+                content: 'Understood. I have the collapsed context summary and will continue from the current state.',
+            },
+        ];
+    }
+    async generateGranularSummary(messages) {
+        var _a, _b, _c, _d, _e;
+        const estimator = new types_1.TokenEstimator();
+        // For small ranges, create a structural summary without LLM
+        const tokenCount = estimator.estimateForMessages(messages);
+        if (tokenCount < 5000) {
+            return this.createStructuralSummary(messages);
+        }
+        // For larger ranges, try LLM summarization
+        try {
+            const codebolt = require('@codebolt/codeboltjs');
+            const historyText = messages
+                .map((msg, i) => {
+                var _a;
+                const content = typeof msg.content === 'string'
+                    ? msg.content
+                    : JSON.stringify((_a = msg.content) !== null && _a !== void 0 ? _a : '');
+                const truncated = content.length > 500
+                    ? content.slice(0, 250) + '...[truncated]...' + content.slice(-250)
+                    : content;
+                return `[${i}] ${msg.role}: ${truncated}`;
+            })
+                .join('\n');
+            const prompt = `Summarize this conversation segment concisely. Preserve: key decisions, file paths, code changes, errors encountered, current task state. Be factual and specific.
+
+${historyText}`;
+            const response = await codebolt.llm.inference({
+                messages: [
+                    { role: 'system', content: 'You are a precise conversation summarizer. Be concise but complete.' },
+                    { role: 'user', content: prompt },
+                ],
+            });
+            const summary = ((_a = response === null || response === void 0 ? void 0 : response.completion) === null || _a === void 0 ? void 0 : _a.content) || ((_e = (_d = (_c = (_b = response === null || response === void 0 ? void 0 : response.completion) === null || _b === void 0 ? void 0 : _b.choices) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.message) === null || _e === void 0 ? void 0 : _e.content);
+            if (summary && typeof summary === 'string' && summary.trim().length > 0) {
+                return summary.trim();
+            }
+        }
+        catch {
+            // Fall back to structural summary
+        }
+        return this.createStructuralSummary(messages);
+    }
+    createStructuralSummary(messages) {
+        var _a, _b;
+        const parts = [];
+        let userMessages = 0;
+        let toolCalls = 0;
+        const files = new Set();
+        for (const msg of messages) {
+            if (!msg)
+                continue;
+            if (msg.role === 'user' && !msg.tool_call_id)
+                userMessages++;
+            if (msg.tool_calls)
+                toolCalls += msg.tool_calls.length;
+            // Extract file paths from content
+            const content = typeof msg.content === 'string'
+                ? msg.content
+                : JSON.stringify((_a = msg.content) !== null && _a !== void 0 ? _a : '');
+            const filePathMatches = content.match(/['"`](\/?[^\s'"`]+\.[a-zA-Z0-9]+)['"`]/g);
+            if (filePathMatches) {
+                for (const match of filePathMatches) {
+                    files.add(match.replace(/['"`]/g, ''));
+                }
+            }
+        }
+        parts.push(`Messages: ${messages.length} (${userMessages} user, ${toolCalls} tool calls)`);
+        if (files.size > 0) {
+            parts.push(`Files referenced: ${Array.from(files).slice(0, 10).join(', ')}`);
+        }
+        // Include first and last user message content (truncated)
+        const firstUser = messages.find(m => m.role === 'user' && !m.tool_call_id);
+        if (firstUser) {
+            const content = typeof firstUser.content === 'string'
+                ? firstUser.content
+                : JSON.stringify((_b = firstUser.content) !== null && _b !== void 0 ? _b : '');
+            parts.push(`First user message: ${content.slice(0, 200)}${content.length > 200 ? '...' : ''}`);
+        }
+        return parts.join('\n');
+    }
+}
+exports.ContextCollapse = ContextCollapse;

package/dist/unified/services/compaction/microCompact.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Layer 2: Micro Compact
+ *
+ * Three sub-mechanisms for clearing old tool results:
+ *   2a. Time-based: clear old tool results after inactivity gap, keeps N most recent.
+ *   2b. Count-based: Clear when registered results exceed threshold.
+ *   2c. Budget-based: truncate largest results when total exceeds budget.
+ *
+ * Key properties:
+ * - Cheaper than collapse/auto (no LLM call, just content replacement)
+ * - Time-based fires when cache is cold (long gap = server cache expired)
+ * - Count-based fires when tool result count exceeds threshold
+ * - Both preserve the most recent N tool results
+ */
+import { type CompactionContext, type CompactionLayer, type CompactionLayerKind } from './types';
+export interface MicroCompactOptions {
+    gapThresholdMinutes?: number;
+    keepRecent?: number;
+    compactableTools?: string[];
+    tokenBudget?: number;
+    enableLogging?: boolean;
+}
+export declare class MicroCompact implements CompactionLayer {
+    readonly name: CompactionLayerKind;
+    private readonly options;
+    constructor(options?: MicroCompactOptions);
+    shouldApply(ctx: CompactionContext): boolean;
+    apply(ctx: CompactionContext): Promise<CompactionContext>;
+    reset(): void;
+    private evaluateTimeTrigger;
+    private collectCompactableToolIds;
+    private clearOldToolResults;
+    private estimateToolResultTokens;
+}

package/dist/unified/services/compaction/microCompact.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Layer 2: Micro Compact
+ *
+ * Three sub-mechanisms for clearing old tool results:
+ *   2a. Time-based: clear old tool results after inactivity gap, keeps N most recent.
+ *   2b. Count-based: Clear when registered results exceed threshold.
+ *   2c. Budget-based: truncate largest results when total exceeds budget.
+ *
+ * Key properties:
+ * - Cheaper than collapse/auto (no LLM call, just content replacement)
+ * - Time-based fires when cache is cold (long gap = server cache expired)
+ * - Count-based fires when tool result count exceeds threshold
+ * - Both preserve the most recent N tool results
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroCompact = void 0;
+const types_1 = require("./types");
+const CLEAR_PLACEHOLDER = '[Old tool result content cleared]';
+const DEFAULT_GAP_THRESHOLD_MINUTES = 60;
+const DEFAULT_KEEP_RECENT = 5;
+const DEFAULT_COMPACTABLE_TOOLS = [
+    'read_file', 'write_file', 'edit_file', 'list_directory',
+    'search_files', 'execute_command', 'shell', 'bash',
+    'glob', 'grep', 'web_search', 'web_fetch',
+];
+class MicroCompact {
+    constructor(options) {
+        var _a, _b, _c, _d, _e;
+        this.name = 'micro';
+        this.options = {
+            gapThresholdMinutes: (_a = options === null || options === void 0 ? void 0 : options.gapThresholdMinutes) !== null && _a !== void 0 ? _a : DEFAULT_GAP_THRESHOLD_MINUTES,
+            keepRecent: (_b = options === null || options === void 0 ? void 0 : options.keepRecent) !== null && _b !== void 0 ? _b : DEFAULT_KEEP_RECENT,
+            compactableTools: new Set((_c = options === null || options === void 0 ? void 0 : options.compactableTools) !== null && _c !== void 0 ? _c : DEFAULT_COMPACTABLE_TOOLS),
+            tokenBudget: (_d = options === null || options === void 0 ? void 0 : options.tokenBudget) !== null && _d !== void 0 ? _d : 50000,
+            enableLogging: (_e = options === null || options === void 0 ? void 0 : options.enableLogging) !== null && _e !== void 0 ? _e : false,
+        };
+    }
+    shouldApply(ctx) {
+        const messages = ctx.messages;
+        if (!messages || messages.length === 0)
+            return false;
+        // Time-based trigger
+        if (this.evaluateTimeTrigger(messages))
+            return true;
+        // Count-based trigger
+        if (this.collectCompactableToolIds(messages).length > this.options.keepRecent)
+            return true;
+        // Budget-based trigger
+        if (this.estimateToolResultTokens(messages) > this.options.tokenBudget)
+            return true;
+        return false;
+    }
+    async apply(ctx) {
+        const messages = ctx.messages;
+        const timeTrigger = this.evaluateTimeTrigger(messages);
+        const allIds = this.collectCompactableToolIds(messages);
+        const keepRecent = Math.max(1, this.options.keepRecent);
+        const keepSet = new Set(allIds.slice(-keepRecent));
+        const subMechanism = timeTrigger ? 'time_based' : 'count_based';
+        const { result, tokensSaved } = this.clearOldToolResults(messages, keepSet);
+        if (tokensSaved === 0) {
+            return ctx;
+        }
+        const boundary = {
+            layer: 'micro',
+            tokensFreed: tokensSaved,
+            messagesRemoved: 0,
+            timestamp: new Date().toISOString(),
+        };
+        if (this.options.enableLogging) {
+            console.log(`[MicroCompact] ${subMechanism}: cleared tool results, ~${tokensSaved} tokens freed`);
+        }
+        return {
+            ...ctx,
+            messages: result,
+            compactionHistory: [...(ctx.compactionHistory || []), boundary],
+        };
+    }
+    reset() {
+        // Stateless across turns
+    }
+    // ─── Private Helpers ──────────────────────────────────────────────
+    evaluateTimeTrigger(messages) {
+        var _a, _b;
+        let lastAssistant;
+        for (let i = messages.length - 1; i >= 0; i--) {
+            if (((_a = messages[i]) === null || _a === void 0 ? void 0 : _a.role) === 'assistant') {
+                lastAssistant = messages[i];
+                break;
+            }
+        }
+        if (!lastAssistant)
+            return null;
+        const timestamp = (_b = lastAssistant.timestamp) !== null && _b !== void 0 ? _b : lastAssistant.created_at;
+        if (!timestamp)
+            return null;
+        const gapMs = Date.now() - new Date(timestamp).getTime();
+        const gapMinutes = gapMs / 60000;
+        if (!Number.isFinite(gapMinutes) || gapMinutes < this.options.gapThresholdMinutes) {
+            return null;
+        }
+        return { gapMinutes };
+    }
+    collectCompactableToolIds(messages) {
+        var _a, _b;
+        const ids = [];
+        for (const msg of messages) {
+            if ((msg === null || msg === void 0 ? void 0 : msg.role) === 'assistant' && Array.isArray(msg.content)) {
+                for (const block of msg.content) {
+                    if (block && typeof block === 'object' &&
+                        block.type === 'tool_use' &&
+                        this.options.compactableTools.has(block.name)) {
+                        ids.push(block.id);
+                    }
+                }
+            }
+            if ((msg === null || msg === void 0 ? void 0 : msg.role) === 'assistant' && Array.isArray(msg.tool_calls)) {
+                for (const tc of msg.tool_calls) {
+                    if (tc && this.options.compactableTools.has((_b = (_a = tc.function) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : tc.name)) {
+                        ids.push(tc.id);
+                    }
+                }
+            }
+        }
+        return ids;
+    }
+    clearOldToolResults(messages, keepSet) {
+        const clearSet = new Set(this.collectCompactableToolIds(messages).filter(id => !keepSet.has(id)));
+        if (clearSet.size === 0) {
+            return { result: messages, tokensSaved: 0 };
+        }
+        let tokensSaved = 0;
+        const estimator = new types_1.TokenEstimator();
+        const result = messages.map(msg => {
+            var _a;
+            if (msg.role === 'tool' || msg.tool_call_id) {
+                const toolCallId = msg.tool_call_id;
+                if (clearSet.has(toolCallId)) {
+                    const originalContent = typeof msg.content === 'string'
+                        ? msg.content : JSON.stringify((_a = msg.content) !== null && _a !== void 0 ? _a : '');
+                    tokensSaved += estimator.estimate(originalContent);
+                    return { ...msg, content: CLEAR_PLACEHOLDER };
+                }
+            }
+            if (msg.role === 'user' && Array.isArray(msg.content)) {
+                let touched = false;
+                const newContent = msg.content.map((block) => {
+                    var _a, _b;
+                    if (block &&
+                        (block.type === 'tool_result' || block.type === 'function_response') &&
+                        clearSet.has((_a = block.tool_use_id) !== null && _a !== void 0 ? _a : block.tool_call_id)) {
+                        const originalContent = typeof block.content === 'string'
+                            ? block.content : JSON.stringify((_b = block.content) !== null && _b !== void 0 ? _b : '');
+                        tokensSaved += estimator.estimate(originalContent);
+                        touched = true;
+                        return { ...block, content: CLEAR_PLACEHOLDER };
+                    }
+                    return block;
+                });
+                if (!touched)
+                    return msg;
+                return { ...msg, content: newContent };
+            }
+            return msg;
+        });
+        return { result, tokensSaved };
+    }
+    estimateToolResultTokens(messages) {
+        var _a, _b, _c;
+        const estimator = new types_1.TokenEstimator();
+        let total = 0;
+        for (const msg of messages) {
+            if (msg.role === 'tool' || msg.tool_call_id) {
+                const toolName = (_a = msg.name) !== null && _a !== void 0 ? _a : '';
+                if (this.options.compactableTools.has(toolName)) {
+                    const content = typeof msg.content === 'string'
+                        ? msg.content : JSON.stringify((_b = msg.content) !== null && _b !== void 0 ? _b : '');
+                    total += estimator.estimate(content);
+                }
+            }
+            if (msg.role === 'user' && Array.isArray(msg.content)) {
+                for (const block of msg.content) {
+                    if (block && (block.type === 'tool_result' || block.type === 'function_response')) {
+                        const content = typeof block.content === 'string'
+                            ? block.content : JSON.stringify((_c = block.content) !== null && _c !== void 0 ? _c : '');
+                        total += estimator.estimate(content);
+                    }
+                }
+            }
+        }
+        return total;
+    }
+}
+exports.MicroCompact = MicroCompact;

package/dist/unified/services/compaction/postCompactCleanup.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Post-Compact Cleanup
+ *
+ * Resets ALL tracking state after any compaction event.
+ * Called after both auto-compact and manual /compact to free memory
+ * held by tracking structures that are invalidated by compaction.
+ */
+import type { CompactionLayerKind, CompactionLayer } from './types';
+export interface PostCompactCleanupOptions {
+    enableLogging?: boolean;
+}
+export declare class PostCompactCleanup {
+    constructor(_options?: PostCompactCleanupOptions);
+    runCleanup(layers: Map<CompactionLayerKind, CompactionLayer>, appliedLayers: CompactionLayerKind[]): void;
+}

package/dist/unified/services/compaction/postCompactCleanup.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Post-Compact Cleanup
+ *
+ * Resets ALL tracking state after any compaction event.
+ * Called after both auto-compact and manual /compact to free memory
+ * held by tracking structures that are invalidated by compaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostCompactCleanup = void 0;
+class PostCompactCleanup {
+    constructor(_options) { }
+    runCleanup(layers, appliedLayers) {
+        for (const layerName of appliedLayers) {
+            const layer = layers.get(layerName);
+            if (layer) {
+                try {
+                    layer.reset();
+                }
+                catch {
+                    // Ignore
+                }
+            }
+        }
+        // Always reset reactive compact even if not applied
+        const reactive = layers.get('reactive');
+        if (reactive && !appliedLayers.includes('reactive')) {
+            try {
+                reactive.reset();
+            }
+            catch {
+                // Ignore
+            }
+        }
+    }
+}
+exports.PostCompactCleanup = PostCompactCleanup;

package/dist/unified/services/compaction/reactiveCompact.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Layer 5: Reactive Compact
+ *
+ * Emergency compaction triggered by API errors (413 prompt-too-long,
+ * media-size errors). This is the last line of defense when all proactive
+ * layers fail to keep the context under the limit.
+ *
+ * Key properties:
+ * - Only fires on real API errors after proactive measures fail
+ * - Single-shot per turn (prevents spiral: error -> compact -> error -> compact)
+ * - Tries: strip images -> strip older messages -> full compact
+ * - Withholds error from consumers until recovery succeeds or exhausts
+ */
+import type { MessageObject } from '@codebolt/types/sdk';
+import { type CompactionContext, type CompactionLayer, type CompactionLayerKind } from './types';
+export interface ReactiveCompactOptions {
+    /** Max retry attempts per turn (default: 1) */
+    retryLimit?: number;
+    /** Model token limit (default: 128000) */
+    modelTokenLimit?: number;
+    /** Enable logging (default: false) */
+    enableLogging?: boolean;
+}
+export interface ReactiveRecoveryResult {
+    recovered: boolean;
+    messages: MessageObject[];
+    reason: string;
+    tokensBefore: number;
+    tokensAfter: number;
+}
+export declare class ReactiveCompact implements CompactionLayer {
+    readonly name: CompactionLayerKind;
+    private readonly options;
+    private hasAttemptedThisTurn;
+    private retryCount;
+    constructor(options?: ReactiveCompactOptions);
+    shouldApply(_ctx: CompactionContext): boolean;
+    apply(_ctx: CompactionContext): Promise<CompactionContext>;
+    reset(): void;
+    /**
+     * Reset per-turn guard (call at the start of each turn).
+     */
+    resetForTurn(): void;
+    /**
+     * Check if an error message indicates a recoverable context error.
+     */
+    isRecoverableError(errorMessage: string): boolean;
+    /**
+     * Check if an error is a media/size error (images, PDFs, etc.)
+     */
+    isMediaSizeError(error: unknown): boolean;
+    /**
+     * Attempt to recover from a context overflow error.
+     * Single-shot per turn to prevent death spirals.
+     *
+     * Recovery strategy:
+     *   1. Strip images and retry (for media errors)
+     *   2. Strip oldest messages (keep recent context)
+     *   3. Force full compact if available
+     */
+    tryRecoverFromError(ctx: CompactionContext, error: unknown): Promise<ReactiveRecoveryResult>;
+    private stripImages;
+    private stripOldestMessages;
+    private forceCompact;
+}