@vybestack/llxprt-code-agents 0.10.0-nightly.260613.1adad3b34

package/dist/src/compression/OneShotStrategy.js

@@ -0,0 +1,235 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20260211-HIGHDENSITY.P03
+ * @plan PLAN-20260211-HIGHDENSITY.P05
+ * @requirement REQ-HD-001.3
+ * @pseudocode strategy-interface.md lines 90-94
+ *
+ * One-shot compression strategy: summarizes the entire history except
+ * the last N messages in a single LLM call. The preserved tail is
+ * determined by the preserveThreshold ephemeral setting.
+ *
+ * Unlike middle-out (which preserves both top and bottom), one-shot
+ * preserves ONLY the recent tail. The summary replaces everything
+ * above the preserved messages.
+ */
+import { readFileSync } from 'node:fs';
+import { CompressionExecutionError, EmptySummaryError, PromptResolutionError, isTransientCompressionError, } from '@vybestack/llxprt-code-core/core/compression/types.js';
+import { adjustForToolCallBoundary, aggregateTextFromBlocks, buildTriggerInstruction, COMPRESSION_SECURITY_PREAMBLE, runVerificationPass, sanitizeHistoryForCompression, } from './utils.js';
+import { getCompressionPrompt } from '@vybestack/llxprt-code-core/core/prompts.js';
+import { buildContinuationDirective } from '@vybestack/llxprt-code-core/core/compression/continuationDirective.js';
+function destructureProviderResult(result) {
+    return {
+        provider: result.provider,
+        resolvedRuntime: result.runtime,
+        resolvedConfig: result.config,
+        resolvedOptions: result.resolved,
+        invocation: result.invocation,
+    };
+}
+const MINIMUM_COMPRESS_MESSAGES = 4;
+// ---------------------------------------------------------------------------
+// OneShotStrategy
+// ---------------------------------------------------------------------------
+export class OneShotStrategy {
+    name = 'one-shot';
+    requiresLLM = true;
+    /** @plan PLAN-20260211-HIGHDENSITY.P03 @requirement REQ-HD-001.3 */
+    trigger = {
+        mode: 'threshold',
+        defaultThreshold: 0.85,
+    };
+    // eslint-disable-next-line max-lines-per-function -- Strategy orchestration remains linear for readability.
+    async compress(context) {
+        const { history } = context;
+        if (history.length === 0) {
+            return this.noCompressionResult(history);
+        }
+        // Compute the split: everything above the preserved tail gets compressed
+        const { toCompress, toKeep } = this.computeSplit(context);
+        if (toCompress.length < MINIMUM_COMPRESS_MESSAGES) {
+            return this.noCompressionResult(history);
+        }
+        // Resolve the compression prompt
+        const prompt = this.resolvePrompt(context);
+        // Resolve the provider (compression profile may be undefined)
+        const compressionProfile = context.runtimeContext.ephemerals.compressionProfile();
+        const { provider, resolvedRuntime, resolvedConfig, resolvedOptions, invocation, } = destructureProviderResult(await context.resolveProvider(compressionProfile));
+        // Build the LLM request
+        // @plan PLAN-20260211-HIGHDENSITY.P23
+        // @requirement REQ-HD-011.3, REQ-HD-012.2
+        const triggerInstruction = buildTriggerInstruction(toCompress);
+        const compressionRequest = [
+            COMPRESSION_SECURITY_PREAMBLE,
+            {
+                speaker: 'human',
+                blocks: [{ type: 'text', text: prompt }],
+            },
+            ...sanitizeHistoryForCompression(toCompress),
+            ...this.buildContextInjections(context),
+            {
+                speaker: 'human',
+                blocks: [{ type: 'text', text: triggerInstruction }],
+            },
+        ];
+        // Call the provider and aggregate the streamed response
+        const { text: summary, usage: capturedUsage } = await this.callProvider(provider, compressionRequest, context, resolvedRuntime, resolvedConfig, resolvedOptions, invocation);
+        if (!summary.trim()) {
+            throw new EmptySummaryError('one-shot');
+        }
+        // Optional verification pass — gated by compressionVerification flag (default off)
+        let finalSummary = summary;
+        if (context.compressionVerification === true) {
+            finalSummary = await runVerificationPass(provider, summary, context, resolvedRuntime, resolvedConfig, resolvedOptions, invocation);
+        }
+        // Assemble result: summary + continuation directive + preserved tail
+        const summaryEntry = {
+            speaker: 'human',
+            blocks: [{ type: 'text', text: finalSummary }],
+            ...(capturedUsage ? { metadata: { usage: capturedUsage } } : {}),
+        };
+        const newHistory = [
+            summaryEntry,
+            {
+                speaker: 'ai',
+                blocks: [
+                    {
+                        type: 'text',
+                        text: buildContinuationDirective(context.activeTodos),
+                    },
+                ],
+            },
+            ...toKeep,
+        ];
+        const metadata = {
+            originalMessageCount: history.length,
+            compressedMessageCount: newHistory.length,
+            strategyUsed: 'one-shot',
+            llmCallMade: true,
+            topPreserved: 0,
+            bottomPreserved: toKeep.length,
+            middleCompressed: toCompress.length,
+            ...(capturedUsage ? { usage: capturedUsage } : {}),
+        };
+        return { newHistory, metadata };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    computeSplit(context) {
+        const history = context.history;
+        const preserveThreshold = context.runtimeContext.ephemerals.preserveThreshold();
+        let splitIndex = Math.floor(history.length * (1 - preserveThreshold));
+        if (splitIndex < MINIMUM_COMPRESS_MESSAGES) {
+            return { toCompress: [], toKeep: [...history] };
+        }
+        splitIndex = adjustForToolCallBoundary(history, splitIndex);
+        if (splitIndex < MINIMUM_COMPRESS_MESSAGES) {
+            return { toCompress: [], toKeep: [...history] };
+        }
+        return {
+            toCompress: history.slice(0, splitIndex),
+            toKeep: history.slice(splitIndex),
+        };
+    }
+    resolvePrompt(context) {
+        const resolved = context.promptResolver.resolveFile(context.promptBaseDir, 'compression.md', context.promptContext);
+        if (resolved.found && resolved.path) {
+            try {
+                return readFileSync(resolved.path, 'utf-8');
+            }
+            catch {
+                // Fall through to hardcoded default
+            }
+        }
+        const fallback = getCompressionPrompt();
+        if (!fallback) {
+            throw new PromptResolutionError('compression.md');
+        }
+        return fallback;
+    }
+    async callProvider(provider, request, context, resolvedRuntime, resolvedConfig, resolvedOptions, invocation) {
+        const providerRuntime = resolvedRuntime;
+        try {
+            const stream = provider.generateChatCompletion({
+                contents: request,
+                tools: undefined,
+                config: resolvedConfig ?? context.config ?? providerRuntime.config,
+                runtime: providerRuntime,
+                invocation,
+                settings: providerRuntime.settingsService,
+                resolved: resolvedOptions,
+                metadata: {
+                    ...(providerRuntime.metadata ?? {}),
+                    source: 'OneShotStrategy.callProvider',
+                },
+            });
+            let summary = '';
+            let lastBlockWasNonText = false;
+            let capturedUsage;
+            for await (const chunk of stream) {
+                const result = aggregateTextFromBlocks(chunk.blocks, summary, lastBlockWasNonText);
+                summary = result.text;
+                lastBlockWasNonText = result.lastBlockWasNonText;
+                if (chunk.metadata?.usage) {
+                    capturedUsage = chunk.metadata.usage;
+                }
+            }
+            return { text: summary, usage: capturedUsage };
+        }
+        catch (error) {
+            throw new CompressionExecutionError('one-shot', `LLM provider call failed: ${error instanceof Error ? error.message : String(error)}`, { isTransient: isTransientCompressionError(error) });
+        }
+    }
+    noCompressionResult(history) {
+        return {
+            newHistory: [...history],
+            metadata: {
+                originalMessageCount: history.length,
+                compressedMessageCount: history.length,
+                strategyUsed: 'one-shot',
+                llmCallMade: false,
+                topPreserved: 0,
+                bottomPreserved: 0,
+                middleCompressed: 0,
+            },
+        };
+    }
+    /**
+     * @plan PLAN-20260211-HIGHDENSITY.P23
+     * @requirement REQ-HD-011.3, REQ-HD-012.2
+     */
+    buildContextInjections(context) {
+        const injections = [];
+        if (context.activeTodos && context.activeTodos.trim().length > 0) {
+            injections.push({
+                speaker: 'human',
+                blocks: [
+                    {
+                        type: 'text',
+                        text: `The following are the current active todo/task items. When summarizing, preserve context about why each task exists and what has been tried:
+
+${context.activeTodos}`,
+                    },
+                ],
+            });
+        }
+        if (context.transcriptPath) {
+            injections.push({
+                speaker: 'human',
+                blocks: [
+                    {
+                        type: 'text',
+                        text: `Note: The full pre-compression transcript is available at: ${context.transcriptPath}`,
+                    },
+                ],
+            });
+        }
+        return injections;
+    }
+}
+//# sourceMappingURL=OneShotStrategy.js.map

package/dist/src/compression/OneShotStrategy.js.map

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

package/dist/src/compression/TopDownTruncationStrategy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CompressionContext, CompressionResult, CompressionStrategy, StrategyTrigger } from '@vybestack/llxprt-code-core/core/compression/types.js';
+export declare class TopDownTruncationStrategy implements CompressionStrategy {
+    readonly name: "top-down-truncation";
+    readonly requiresLLM = false;
+    /** @plan PLAN-20260211-HIGHDENSITY.P03 @requirement REQ-HD-001.3 */
+    readonly trigger: StrategyTrigger;
+    compress(context: CompressionContext): Promise<CompressionResult>;
+}

package/dist/src/compression/TopDownTruncationStrategy.js

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { adjustForToolCallBoundary } from './utils.js';
+export class TopDownTruncationStrategy {
+    name = 'top-down-truncation';
+    requiresLLM = false;
+    /** @plan PLAN-20260211-HIGHDENSITY.P03 @requirement REQ-HD-001.3 */
+    trigger = {
+        mode: 'threshold',
+        defaultThreshold: 0.85,
+    };
+    async compress(context) {
+        const { history, runtimeContext, estimateTokens, currentTokenCount } = context;
+        const originalCount = history.length;
+        if (originalCount === 0) {
+            return {
+                newHistory: [],
+                metadata: {
+                    originalMessageCount: 0,
+                    compressedMessageCount: 0,
+                    strategyUsed: 'top-down-truncation',
+                    llmCallMade: false,
+                },
+            };
+        }
+        const compressionThreshold = runtimeContext.ephemerals.compressionThreshold();
+        const contextLimit = runtimeContext.ephemerals.contextLimit();
+        const target = compressionThreshold * contextLimit * 0.6;
+        if (currentTokenCount <= target) {
+            return {
+                newHistory: [...history],
+                metadata: {
+                    originalMessageCount: originalCount,
+                    compressedMessageCount: originalCount,
+                    strategyUsed: 'top-down-truncation',
+                    llmCallMade: false,
+                },
+            };
+        }
+        const minKeep = Math.min(2, originalCount);
+        // Remove messages from start (oldest first) until under target
+        let removeCount = 0;
+        for (let i = 1; i <= originalCount - minKeep; i++) {
+            const remaining = history.slice(i);
+            const tokens = await estimateTokens(remaining);
+            if (tokens < target) {
+                removeCount = i;
+                break;
+            }
+            removeCount = i;
+        }
+        // Ensure we keep at least minKeep messages
+        removeCount = Math.min(removeCount, originalCount - minKeep);
+        // Adjust boundary to avoid orphaning tool call/response pairs
+        const mutableHistory = [...history];
+        const adjustedIndex = adjustForToolCallBoundary(mutableHistory, removeCount);
+        // Clamp: never remove more than originalCount - minKeep
+        const finalRemoveCount = Math.min(adjustedIndex, originalCount - minKeep);
+        const newHistory = mutableHistory.slice(finalRemoveCount);
+        return {
+            newHistory,
+            metadata: {
+                originalMessageCount: originalCount,
+                compressedMessageCount: newHistory.length,
+                strategyUsed: 'top-down-truncation',
+                llmCallMade: false,
+            },
+        };
+    }
+}
+//# sourceMappingURL=TopDownTruncationStrategy.js.map

package/dist/src/compression/TopDownTruncationStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TopDownTruncationStrategy.js","sourceRoot":"","sources":["../../../src/compression/TopDownTruncationStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,OAAO,yBAAyB;IAC3B,IAAI,GAAG,qBAA8B,CAAC;IACtC,WAAW,GAAG,KAAK,CAAC;IAC7B,oEAAoE;IAC3D,OAAO,GAAoB;QAClC,IAAI,EAAE,WAAW;QACjB,gBAAgB,EAAE,IAAI;KACvB,CAAC;IAEF,KAAK,CAAC,QAAQ,CAAC,OAA2B;QACxC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAClE,OAAO,CAAC;QACV,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;QAErC,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,UAAU,EAAE,EAAE;gBACd,QAAQ,EAAE;oBACR,oBAAoB,EAAE,CAAC;oBACvB,sBAAsB,EAAE,CAAC;oBACzB,YAAY,EAAE,qBAAqB;oBACnC,WAAW,EAAE,KAAK;iBACnB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,oBAAoB,GACxB,cAAc,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;QACnD,MAAM,YAAY,GAAG,cAAc,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAG,oBAAoB,GAAG,YAAY,GAAG,GAAG,CAAC;QAEzD,IAAI,iBAAiB,IAAI,MAAM,EAAE,CAAC;YAChC,OAAO;gBACL,UAAU,EAAE,CAAC,GAAG,OAAO,CAAC;gBACxB,QAAQ,EAAE;oBACR,oBAAoB,EAAE,aAAa;oBACnC,sBAAsB,EAAE,aAAa;oBACrC,YAAY,EAAE,qBAAqB;oBACnC,WAAW,EAAE,KAAK;iBACnB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAE3C,+DAA+D;QAC/D,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;YAC/C,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;gBACpB,WAAW,GAAG,CAAC,CAAC;gBAChB,MAAM;YACR,CAAC;YACD,WAAW,GAAG,CAAC,CAAC;QAClB,CAAC;QAED,2CAA2C;QAC3C,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;QAE7D,8DAA8D;QAC9D,MAAM,cAAc,GAAG,CAAC,GAAG,OAAO,CAAe,CAAC;QAClD,MAAM,aAAa,GAAG,yBAAyB,CAC7C,cAAc,EACd,WAAW,CACZ,CAAC;QAEF,wDAAwD;QACxD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;QAE1E,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE1D,OAAO;YACL,UAAU;YACV,QAAQ,EAAE;gBACR,oBAAoB,EAAE,aAAa;gBACnC,sBAAsB,EAAE,UAAU,CAAC,MAAM;gBACzC,YAAY,EAAE,qBAAqB;gBACnC,WAAW,EAAE,KAAK;aACnB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/compression/compressionBudgeting.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IContent } from '@vybestack/llxprt-code-core/services/history/IContent.js';
+import type { HistoryService } from '@vybestack/llxprt-code-core/services/history/HistoryService.js';
+import type { GenerateContentConfig } from '@google/genai';
+import type { RuntimeProvider as IProvider } from '@vybestack/llxprt-code-core/runtime/contracts/RuntimeProvider.js';
+/**
+ * Extract a number from various value types (number, string, etc.)
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export declare function asNumber(value: unknown): number | undefined;
+/**
+ * Extract completion budget from generation config parameters.
+ * Checks multiple possible parameter names for output token limits.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export declare function extractCompletionBudgetFromParams(params: Record<string, unknown> | undefined): number | undefined;
+/**
+ * Get completion budget from generation config, provider params, or default.
+ * Used to reserve output tokens when calculating context limits.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export declare function getCompletionBudget(generationConfig: GenerateContentConfig, _model: string, provider?: IProvider, settingsService?: {
+    get: (key: string) => unknown;
+}): number;
+/**
+ * Estimate token count for pending content that hasn't been added to history yet.
+ * Uses historyService tokenizer when available, falls back to text-based estimation.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export declare function estimatePendingTokens(contents: IContent[], historyService: HistoryService, model: string): Promise<number>;

package/dist/src/compression/compressionBudgeting.js

@@ -0,0 +1,139 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { estimateTokens as estimateTextTokens } from '@vybestack/llxprt-code-core/utils/toolOutputLimiter.js';
+import { DebugLogger } from '@vybestack/llxprt-code-core/debug/index.js';
+const logger = new DebugLogger('llxprt:gemini:compression-budgeting');
+/**
+ * Extract a number from various value types (number, string, etc.)
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export function asNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed)) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract completion budget from generation config parameters.
+ * Checks multiple possible parameter names for output token limits.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export function extractCompletionBudgetFromParams(params) {
+    if (!params) {
+        return undefined;
+    }
+    const candidateKeys = [
+        'maxOutputTokens',
+        'maxTokens',
+        'max_output_tokens',
+        'max_tokens',
+    ];
+    for (const key of candidateKeys) {
+        if (key in params) {
+            const value = asNumber(params[key]);
+            if (value !== undefined) {
+                return value;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Get completion budget from generation config, provider params, or default.
+ * Used to reserve output tokens when calculating context limits.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export function getCompletionBudget(generationConfig, _model, provider, settingsService) {
+    const DEFAULT_COMPLETION_BUDGET = 65_536;
+    // Check global ephemeral setting for maxOutputTokens (set via /set maxOutputTokens)
+    // This is a generic setting that providers should translate to their native param
+    const liveMaxOutputTokens = settingsService?.get('maxOutputTokens');
+    const liveBudget = asNumber(liveMaxOutputTokens);
+    if (liveBudget !== undefined && liveBudget > 0) {
+        return liveBudget;
+    }
+    const generationBudget = asNumber(generationConfig.maxOutputTokens);
+    const providerParams = provider?.getModelParams?.();
+    const providerBudget = extractCompletionBudgetFromParams(providerParams);
+    return generationBudget ?? providerBudget ?? DEFAULT_COMPLETION_BUDGET;
+}
+/**
+ * Estimate token count for pending content that hasn't been added to history yet.
+ * Uses historyService tokenizer when available, falls back to text-based estimation.
+ * @plan PLAN-20260220-DECOMPOSE.P03
+ */
+export async function estimatePendingTokens(contents, historyService, model) {
+    if (contents.length === 0) {
+        return 0;
+    }
+    try {
+        return await historyService.estimateTokensForContents(contents, model);
+    }
+    catch (error) {
+        logger.debug('Falling back to local token estimate', error);
+        let fallback = 0;
+        for (const content of contents) {
+            fallback += estimateFallbackContentTokens(content, logger);
+        }
+        return fallback;
+    }
+}
+function estimateFallbackContentTokens(content, fallbackLogger) {
+    try {
+        const serialized = JSON.stringify(content);
+        return estimateTextTokens(serialized);
+    }
+    catch (stringifyError) {
+        fallbackLogger.debug('Failed to stringify content for fallback token estimate', stringifyError);
+        return estimateBlockTokens(content);
+    }
+}
+function estimateBlockTokens(content) {
+    try {
+        const blockStrings = content.blocks
+            .map((block) => {
+            switch (block.type) {
+                case 'text':
+                    return block.text;
+                case 'tool_call':
+                    return JSON.stringify({
+                        name: block.name,
+                        parameters: block.parameters,
+                    });
+                case 'tool_response':
+                    return JSON.stringify({
+                        callId: block.callId,
+                        toolName: block.toolName,
+                        result: block.result,
+                        error: block.error,
+                    });
+                case 'thinking':
+                    return block.thought;
+                case 'code':
+                    return block.code;
+                case 'media':
+                    return block.caption ?? '';
+                default:
+                    return '';
+            }
+        })
+            .join('\n');
+        if (blockStrings) {
+            return estimateTextTokens(blockStrings);
+        }
+    }
+    catch (blockError) {
+        logger.debug('Failed to estimate tokens from blocks', blockError);
+    }
+    return 0;
+}
+//# sourceMappingURL=compressionBudgeting.js.map

package/dist/src/compression/compressionBudgeting.js.map

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

package/dist/src/compression/compressionStrategyFactory.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @plan PLAN-20260211-COMPRESSION.P10
+ * @plan PLAN-20260211-HIGHDENSITY.P17
+ * @requirement REQ-CS-001.2, REQ-CS-001.3, REQ-HD-004.2
+ * @pseudocode settings-factory.md lines 140-157
+ *
+ * Factory functions for resolving compression strategies by name.
+ */
+import type { CompressionStrategy, CompressionStrategyName } from '@vybestack/llxprt-code-core/core/compression/types.js';
+/**
+ * Validates a raw string against the known strategy names.
+ * Returns the typed name on success; throws {@link UnknownStrategyError} otherwise.
+ */
+export declare function parseCompressionStrategyName(name: string): CompressionStrategyName;
+/**
+ * Returns a fresh {@link CompressionStrategy} instance for the given name.
+ */
+export declare function getCompressionStrategy(name: CompressionStrategyName): CompressionStrategy;

package/dist/src/compression/compressionStrategyFactory.js

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { COMPRESSION_STRATEGIES, UnknownStrategyError, } from '@vybestack/llxprt-code-core/core/compression/types.js';
+import { MiddleOutStrategy } from './MiddleOutStrategy.js';
+import { TopDownTruncationStrategy } from './TopDownTruncationStrategy.js';
+import { OneShotStrategy } from './OneShotStrategy.js';
+import { HighDensityStrategy } from './HighDensityStrategy.js';
+/**
+ * Validates a raw string against the known strategy names.
+ * Returns the typed name on success; throws {@link UnknownStrategyError} otherwise.
+ */
+export function parseCompressionStrategyName(name) {
+    if (COMPRESSION_STRATEGIES.includes(name)) {
+        return name;
+    }
+    throw new UnknownStrategyError(name);
+}
+/**
+ * Returns a fresh {@link CompressionStrategy} instance for the given name.
+ */
+export function getCompressionStrategy(name) {
+    switch (name) {
+        case 'middle-out':
+            return new MiddleOutStrategy();
+        case 'top-down-truncation':
+            return new TopDownTruncationStrategy();
+        case 'one-shot':
+            return new OneShotStrategy();
+        case 'high-density':
+            return new HighDensityStrategy();
+        default: {
+            const exhaustive = name;
+            throw new UnknownStrategyError(exhaustive);
+        }
+    }
+}
+//# sourceMappingURL=compressionStrategyFactory.js.map

package/dist/src/compression/compressionStrategyFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compressionStrategyFactory.js","sourceRoot":"","sources":["../../../src/compression/compressionStrategyFactory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAY;IAEZ,IAAK,sBAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,OAAO,IAA+B,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAA6B;IAE7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,qBAAqB;YACxB,OAAO,IAAI,yBAAyB,EAAE,CAAC;QACzC,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,EAAE,CAAC;QAC/B,KAAK,cAAc;YACjB,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,IAAI,CAAC;YAC/B,MAAM,IAAI,oBAAoB,CAAC,UAAoB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/compression/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from '@vybestack/llxprt-code-core/core/compression/types.js';
+export * from './utils.js';
+export { MiddleOutStrategy } from './MiddleOutStrategy.js';
+export { TopDownTruncationStrategy } from './TopDownTruncationStrategy.js';
+export { OneShotStrategy } from './OneShotStrategy.js';
+/** @plan PLAN-20260211-HIGHDENSITY.P09 */
+export { HighDensityStrategy } from './HighDensityStrategy.js';
+export * from './compressionStrategyFactory.js';
+/** @plan PLAN-20260220-DECOMPOSE.P03 */
+export { CompressionHandler } from './CompressionHandler.js';
+export * from './compressionBudgeting.js';

package/dist/src/compression/index.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from '@vybestack/llxprt-code-core/core/compression/types.js';
+export * from './utils.js';
+export { MiddleOutStrategy } from './MiddleOutStrategy.js';
+export { TopDownTruncationStrategy } from './TopDownTruncationStrategy.js';
+export { OneShotStrategy } from './OneShotStrategy.js';
+/** @plan PLAN-20260211-HIGHDENSITY.P09 */
+export { HighDensityStrategy } from './HighDensityStrategy.js';
+export * from './compressionStrategyFactory.js';
+/** @plan PLAN-20260220-DECOMPOSE.P03 */
+export { CompressionHandler } from './CompressionHandler.js';
+export * from './compressionBudgeting.js';
+//# sourceMappingURL=index.js.map

package/dist/src/compression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compression/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,uDAAuD,CAAC;AACtE,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,0CAA0C;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,cAAc,iCAAiC,CAAC;AAChD,wCAAwC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,cAAc,2BAA2B,CAAC"}

package/dist/src/compression/reasoningUtils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Core-owned reasoning helpers used by compression.
+ *
+ * Provider-specific reasoning parsing remains in the providers package. Core
+ * keeps only generic thinking-block accounting helpers needed by compression.
+ *
+ * @plan:PLAN-20260603-ISSUE1584.P11
+ * @requirement:REQ-DEP-001
+ * @requirement:REQ-SHIM-001
+ */
+import type { IContent, ThinkingBlock } from '@vybestack/llxprt-code-core/services/history/IContent.js';
+export declare function extractThinkingBlocks(content: IContent): ThinkingBlock[];
+export declare function estimateThinkingTokens(blocks: ThinkingBlock[]): number;