@planu/cli 0.30.1 → 0.32.0

package/dist/engine/token-optimizer/incremental.js

@@ -0,0 +1,88 @@
+// engine/token-optimizer/incremental.ts — Incremental/delta responses (SPEC-082 AC-06)
+import { createHash } from 'node:crypto';
+/**
+ * Tracks previous responses and computes deltas for incremental updates.
+ */
+export class IncrementalTracker {
+    // key = toolName + inputHash -> previous response
+    snapshots = new Map();
+    /**
+     * Build a composite key from tool name and input.
+     */
+    static buildKey(toolName, input) {
+        const inputHash = createHash('sha256').update(input).digest('hex').slice(0, 12);
+        return `${toolName}:${inputHash}`;
+    }
+    /**
+     * Compare current response against previous snapshot.
+     * If first time or changed, stores new snapshot.
+     */
+    compare(key, currentResponse) {
+        const previous = this.snapshots.get(key);
+        const fullSize = currentResponse.length;
+        if (previous === undefined) {
+            // First time — store and return full
+            this.snapshots.set(key, currentResponse);
+            return { changed: true, delta: currentResponse, fullSize, deltaSize: fullSize };
+        }
+        if (previous === currentResponse) {
+            // No change
+            return { changed: false, delta: '', fullSize, deltaSize: 0 };
+        }
+        // Compute line-level delta
+        const delta = this.computeDelta(previous, currentResponse);
+        this.snapshots.set(key, currentResponse);
+        return {
+            changed: true,
+            delta,
+            fullSize,
+            deltaSize: delta.length,
+        };
+    }
+    /**
+     * Clear snapshot for a specific key.
+     */
+    clearKey(key) {
+        this.snapshots.delete(key);
+    }
+    /**
+     * Clear all snapshots.
+     */
+    clear() {
+        this.snapshots.clear();
+    }
+    /**
+     * Get the number of stored snapshots.
+     */
+    size() {
+        return this.snapshots.size;
+    }
+    // --- Internal ---
+    computeDelta(previous, current) {
+        const prevLines = previous.split('\n');
+        const currLines = current.split('\n');
+        const prevSet = new Set(prevLines);
+        const added = [];
+        const removed = [];
+        for (const line of currLines) {
+            if (!prevSet.has(line)) {
+                added.push(`+ ${line}`);
+            }
+        }
+        const currSet = new Set(currLines);
+        for (const line of prevLines) {
+            if (!currSet.has(line)) {
+                removed.push(`- ${line}`);
+            }
+        }
+        const parts = [];
+        if (removed.length > 0) {
+            parts.push('--- Removed:', ...removed);
+        }
+        if (added.length > 0) {
+            parts.push('+++ Added:', ...added);
+        }
+        return parts.join('\n');
+    }
+}
+//# sourceMappingURL=incremental.js.map

package/dist/engine/token-optimizer/incremental.js.map

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

package/dist/engine/token-optimizer/index.d.ts

@@ -0,0 +1,10 @@
+export { countTokens, estimateCost, getSupportedModels } from './counter.js';
+export { ResponseCache } from './response-cache.js';
+export { compress, selectStrategy, compressChain } from './context-compressor.js';
+export { Deduplicator } from './deduplicator.js';
+export { Batcher } from './batcher.js';
+export { IncrementalTracker } from './incremental.js';
+export { BudgetManager } from './budget.js';
+export { OptimizationReporter } from './reporter.js';
+export { TokenOptimizer } from './optimizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/token-optimizer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/token-optimizer/index.js

@@ -0,0 +1,11 @@
+// engine/token-optimizer/index.ts — Barrel re-exports (SPEC-082)
+export { countTokens, estimateCost, getSupportedModels } from './counter.js';
+export { ResponseCache } from './response-cache.js';
+export { compress, selectStrategy, compressChain } from './context-compressor.js';
+export { Deduplicator } from './deduplicator.js';
+export { Batcher } from './batcher.js';
+export { IncrementalTracker } from './incremental.js';
+export { BudgetManager } from './budget.js';
+export { OptimizationReporter } from './reporter.js';
+export { TokenOptimizer } from './optimizer.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/token-optimizer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/token-optimizer/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/token-optimizer/optimizer.d.ts

@@ -0,0 +1,47 @@
+import type { OptimizationConfig, OptimizationReport, OptimizeInputResult } from '../../types/index.js';
+import { ResponseCache } from './response-cache.js';
+import { Deduplicator } from './deduplicator.js';
+import { Batcher } from './batcher.js';
+import { IncrementalTracker } from './incremental.js';
+import { BudgetManager } from './budget.js';
+import { OptimizationReporter } from './reporter.js';
+/**
+ * Central orchestrator for all token optimization components.
+ */
+export declare class TokenOptimizer {
+    readonly cache: ResponseCache;
+    readonly deduplicator: Deduplicator;
+    readonly batcher: Batcher;
+    readonly incremental: IncrementalTracker;
+    readonly budget: BudgetManager;
+    readonly reporter: OptimizationReporter;
+    private readonly config;
+    private readonly sessionId;
+    constructor(sessionId: string, config?: Partial<OptimizationConfig>);
+    /**
+     * Optimize a tool's input before execution.
+     * Returns cached result if available, or compressed input.
+     */
+    optimizeInput(toolName: string, input: string): OptimizeInputResult;
+    /**
+     * Optimize a tool's response after execution.
+     */
+    optimizeResponse(toolName: string, input: string, response: string): string;
+    /**
+     * Generate optimization report for this session.
+     */
+    getReport(): OptimizationReport;
+    /**
+     * Get human-readable report.
+     */
+    getFormattedReport(): string;
+    /**
+     * Get current configuration.
+     */
+    getConfig(): OptimizationConfig;
+    /**
+     * Reset all optimization state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=optimizer.d.ts.map

package/dist/engine/token-optimizer/optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimizer.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/optimizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAWrD;;GAEG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC;IAWnE;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,mBAAmB;IA4BnE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgC3E;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;CAQd"}

package/dist/engine/token-optimizer/optimizer.js

@@ -0,0 +1,126 @@
+import { countTokens } from './counter.js';
+import { ResponseCache } from './response-cache.js';
+import { compress, selectStrategy } from './context-compressor.js';
+import { Deduplicator } from './deduplicator.js';
+import { Batcher } from './batcher.js';
+import { IncrementalTracker } from './incremental.js';
+import { BudgetManager } from './budget.js';
+import { OptimizationReporter } from './reporter.js';
+const DEFAULT_CONFIG = {
+    cacheEnabled: true,
+    compressionEnabled: true,
+    deduplicationEnabled: true,
+    batchingEnabled: false, // opt-in
+    incrementalEnabled: true,
+    budgetLimit: null,
+};
+/**
+ * Central orchestrator for all token optimization components.
+ */
+export class TokenOptimizer {
+    cache;
+    deduplicator;
+    batcher;
+    incremental;
+    budget;
+    reporter;
+    config;
+    sessionId;
+    constructor(sessionId, config) {
+        this.sessionId = sessionId;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.cache = new ResponseCache();
+        this.deduplicator = new Deduplicator();
+        this.batcher = new Batcher();
+        this.incremental = new IncrementalTracker();
+        this.budget = new BudgetManager({ limit: this.config.budgetLimit });
+        this.reporter = new OptimizationReporter();
+    }
+    /**
+     * Optimize a tool's input before execution.
+     * Returns cached result if available, or compressed input.
+     */
+    optimizeInput(toolName, input) {
+        const inputTokens = countTokens(input).tokens;
+        this.reporter.recordUsage(toolName, inputTokens);
+        this.budget.consume(inputTokens, toolName);
+        // Check cache
+        if (this.config.cacheEnabled) {
+            const cacheKey = ResponseCache.hashKey(`${toolName}:${input}`);
+            const cached = this.cache.get(cacheKey);
+            if (cached !== undefined) {
+                this.reporter.recordCacheHit(toolName, countTokens(cached).tokens);
+                return { cached: true, cachedResult: cached, processedInput: input };
+            }
+            this.reporter.recordCacheMiss(toolName);
+        }
+        // Compress if enabled and input is large
+        let processed = input;
+        if (this.config.compressionEnabled && inputTokens > 2000) {
+            const strategy = selectStrategy(input);
+            const result = compress(input, strategy);
+            processed = result.compressed;
+            this.reporter.recordCompression(result.ratio);
+        }
+        return { cached: false, processedInput: processed };
+    }
+    /**
+     * Optimize a tool's response after execution.
+     */
+    optimizeResponse(toolName, input, response) {
+        const responseTokens = countTokens(response).tokens;
+        this.budget.consume(responseTokens, toolName);
+        let result = response;
+        // Cache the response
+        if (this.config.cacheEnabled) {
+            const cacheKey = ResponseCache.hashKey(`${toolName}:${input}`);
+            this.cache.set(cacheKey, response);
+        }
+        // Deduplicate
+        if (this.config.deduplicationEnabled) {
+            const dedupResult = this.deduplicator.deduplicate(result, this.sessionId);
+            if (dedupResult.ratio > 0) {
+                result = dedupResult.deduplicated;
+                this.reporter.recordDeduplication(dedupResult.ratio);
+            }
+        }
+        // Compress if over budget
+        if (this.config.compressionEnabled && this.budget.isOverBudget()) {
+            const strategy = selectStrategy(result);
+            const compressed = compress(result, strategy);
+            result = compressed.compressed;
+            this.reporter.recordCompression(compressed.ratio);
+        }
+        return result;
+    }
+    /**
+     * Generate optimization report for this session.
+     */
+    getReport() {
+        return this.reporter.generateReport(this.sessionId, this.cache.stats());
+    }
+    /**
+     * Get human-readable report.
+     */
+    getFormattedReport() {
+        return this.reporter.formatReport(this.getReport());
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reset all optimization state.
+     */
+    reset() {
+        this.cache.clear();
+        this.deduplicator.clear();
+        this.batcher.clear();
+        this.incremental.clear();
+        this.budget.reset();
+        this.reporter.reset();
+    }
+}
+//# sourceMappingURL=optimizer.js.map

package/dist/engine/token-optimizer/optimizer.js.map

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

package/dist/engine/token-optimizer/reporter.d.ts

@@ -0,0 +1,51 @@
+import type { TokenCacheStats, OptimizationReport, ToolTokenRecord } from '../../types/index.js';
+/**
+ * Tracks per-tool token consumption and generates optimization reports.
+ */
+export declare class OptimizationReporter {
+    private readonly toolRecords;
+    private totalProcessed;
+    private totalSaved;
+    private compressionRatioSum;
+    private compressionCount;
+    private deduplicationRatioSum;
+    private deduplicationCount;
+    /**
+     * Record tokens processed by a tool.
+     */
+    recordUsage(toolName: string, tokens: number): void;
+    /**
+     * Record a cache hit for a tool.
+     */
+    recordCacheHit(toolName: string, tokensSaved: number): void;
+    /**
+     * Record a cache miss for a tool.
+     */
+    recordCacheMiss(toolName: string): void;
+    /**
+     * Record compression ratio achieved.
+     */
+    recordCompression(ratio: number): void;
+    /**
+     * Record deduplication ratio achieved.
+     */
+    recordDeduplication(ratio: number): void;
+    /**
+     * Get records for all tools.
+     */
+    getToolRecords(): ToolTokenRecord[];
+    /**
+     * Generate full optimization report.
+     */
+    generateReport(sessionId: string, cacheStats: TokenCacheStats): OptimizationReport;
+    /**
+     * Format report as human-readable text.
+     */
+    formatReport(report: OptimizationReport): string;
+    /**
+     * Reset all tracking data.
+     */
+    reset(): void;
+    private getOrCreateRecord;
+}
+//# sourceMappingURL=reporter.d.ts.map

package/dist/engine/token-optimizer/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/reporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGjG;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;IAClE,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,kBAAkB,CAAK;IAE/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAOnD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAO3D;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKvC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,cAAc,IAAI,eAAe,EAAE;IAInC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,kBAAkB;IAyBlF;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;IAsChD;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,iBAAiB;CAe1B"}

package/dist/engine/token-optimizer/reporter.js

@@ -0,0 +1,143 @@
+import { estimateCost } from './counter.js';
+/**
+ * Tracks per-tool token consumption and generates optimization reports.
+ */
+export class OptimizationReporter {
+    toolRecords = new Map();
+    totalProcessed = 0;
+    totalSaved = 0;
+    compressionRatioSum = 0;
+    compressionCount = 0;
+    deduplicationRatioSum = 0;
+    deduplicationCount = 0;
+    /**
+     * Record tokens processed by a tool.
+     */
+    recordUsage(toolName, tokens) {
+        this.totalProcessed += tokens;
+        const record = this.getOrCreateRecord(toolName);
+        record.totalTokens += tokens;
+        record.callCount++;
+    }
+    /**
+     * Record a cache hit for a tool.
+     */
+    recordCacheHit(toolName, tokensSaved) {
+        const record = this.getOrCreateRecord(toolName);
+        record.cacheHits++;
+        record.tokensSaved += tokensSaved;
+        this.totalSaved += tokensSaved;
+    }
+    /**
+     * Record a cache miss for a tool.
+     */
+    recordCacheMiss(toolName) {
+        const record = this.getOrCreateRecord(toolName);
+        record.cacheMisses++;
+    }
+    /**
+     * Record compression ratio achieved.
+     */
+    recordCompression(ratio) {
+        this.compressionRatioSum += ratio;
+        this.compressionCount++;
+    }
+    /**
+     * Record deduplication ratio achieved.
+     */
+    recordDeduplication(ratio) {
+        this.deduplicationRatioSum += ratio;
+        this.deduplicationCount++;
+    }
+    /**
+     * Get records for all tools.
+     */
+    getToolRecords() {
+        return [...this.toolRecords.values()];
+    }
+    /**
+     * Generate full optimization report.
+     */
+    generateReport(sessionId, cacheStats) {
+        const avgCompression = this.compressionCount > 0 ? this.compressionRatioSum / this.compressionCount : 0;
+        const avgDedup = this.deduplicationCount > 0 ? this.deduplicationRatioSum / this.deduplicationCount : 0;
+        const costWithout = estimateCost(this.totalProcessed, 'claude-sonnet').totalCostUsd;
+        const costWith = estimateCost(this.totalProcessed - this.totalSaved, 'claude-sonnet').totalCostUsd;
+        return {
+            sessionId,
+            totalTokensProcessed: this.totalProcessed,
+            totalTokensSaved: this.totalSaved,
+            savingsPercent: this.totalProcessed > 0 ? (this.totalSaved / this.totalProcessed) * 100 : 0,
+            cacheStats,
+            compressionRatio: avgCompression,
+            deduplicationRatio: avgDedup,
+            costWithoutOptimization: costWithout,
+            costWithOptimization: costWith,
+        };
+    }
+    /**
+     * Format report as human-readable text.
+     */
+    formatReport(report) {
+        const lines = [
+            '## Token Optimization Report',
+            '',
+            `Session: ${report.sessionId}`,
+            `Total tokens processed: ${String(report.totalTokensProcessed)}`,
+            `Total tokens saved: ${String(report.totalTokensSaved)}`,
+            `Savings: ${report.savingsPercent.toFixed(1)}%`,
+            '',
+            '### Cache Performance',
+            `Hit rate: ${(report.cacheStats.hitRate * 100).toFixed(1)}%`,
+            `Hits: ${String(report.cacheStats.hits)} | Misses: ${String(report.cacheStats.misses)}`,
+            `Entries: ${String(report.cacheStats.entries)}`,
+            '',
+            '### Optimization Ratios',
+            `Compression: ${(report.compressionRatio * 100).toFixed(1)}%`,
+            `Deduplication: ${(report.deduplicationRatio * 100).toFixed(1)}%`,
+            '',
+            '### Cost Impact',
+            `Without optimization: $${report.costWithoutOptimization.toFixed(6)}`,
+            `With optimization: $${report.costWithOptimization.toFixed(6)}`,
+        ];
+        const toolRecords = this.getToolRecords();
+        if (toolRecords.length > 0) {
+            lines.push('', '### Per-Tool Breakdown');
+            for (const record of toolRecords) {
+                lines.push(`- ${record.toolName}: ${String(record.totalTokens)} tokens, ` +
+                    `${String(record.callCount)} calls, ` +
+                    `${String(record.tokensSaved)} saved`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Reset all tracking data.
+     */
+    reset() {
+        this.toolRecords.clear();
+        this.totalProcessed = 0;
+        this.totalSaved = 0;
+        this.compressionRatioSum = 0;
+        this.compressionCount = 0;
+        this.deduplicationRatioSum = 0;
+        this.deduplicationCount = 0;
+    }
+    // --- Internal ---
+    getOrCreateRecord(toolName) {
+        let record = this.toolRecords.get(toolName);
+        if (!record) {
+            record = {
+                toolName,
+                totalTokens: 0,
+                callCount: 0,
+                cacheHits: 0,
+                cacheMisses: 0,
+                tokensSaved: 0,
+            };
+            this.toolRecords.set(toolName, record);
+        }
+        return record;
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/engine/token-optimizer/reporter.js.map

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

package/dist/engine/token-optimizer/response-cache.d.ts

@@ -0,0 +1,49 @@
+import type { TokenCacheEntry, TokenCacheConfig, TokenCacheStats } from '../../types/index.js';
+/**
+ * In-memory LRU response cache with content-hash keys and TTL support.
+ */
+export declare class ResponseCache {
+    private readonly entries;
+    private readonly config;
+    private hits;
+    private misses;
+    private totalTokensSaved;
+    constructor(config?: Partial<TokenCacheConfig>);
+    /**
+     * Generate a content-hash key from input text.
+     */
+    static hashKey(input: string): string;
+    /**
+     * Get a cached response by key. Returns undefined on miss.
+     */
+    get(key: string): string | undefined;
+    /**
+     * Cache a response with optional TTL override.
+     */
+    set(key: string, value: string, ttlMs?: number): void;
+    /**
+     * Invalidate a specific cache entry or entries matching a pattern.
+     */
+    invalidate(keyOrPattern: string): number;
+    /**
+     * Get cache statistics.
+     */
+    stats(): TokenCacheStats;
+    /**
+     * Remove all expired entries.
+     */
+    cleanup(): number;
+    /**
+     * Clear all entries and reset stats.
+     */
+    clear(): void;
+    /**
+     * Get entries suitable for persistence (TTL > persistMinTtlMs).
+     */
+    getPersistableEntries(): TokenCacheEntry<string>[];
+    /**
+     * Load entries from persistence.
+     */
+    loadEntries(entries: TokenCacheEntry<string>[]): void;
+}
+//# sourceMappingURL=response-cache.d.ts.map

package/dist/engine/token-optimizer/response-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-cache.d.ts","sourceRoot":"","sources":["../../../src/engine/token-optimizer/response-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAU/F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IA0BpC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBrD;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAmBxC;;OAEG;IACH,KAAK,IAAI,eAAe;IAWxB;;OAEG;IACH,OAAO,IAAI,MAAM;IAYjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,qBAAqB,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE;IAYlD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI;CAQtD"}