zora-agent 0.10.0 → 0.10.2

package/dist/lib/error-normalizer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ErrorNormalizer — ERR-07: Safe Error Replay & Normalization
+ *
+ * Maps raw stderr/exceptions to structured error categories.
+ * Produces sanitized <failure_report> blocks safe for LLM injection.
+ * Integrates with LeakDetector to redact PII from error messages.
+ */
+import { LeakDetector } from '../security/leak-detector.js';
+export type ErrorCategory = 'AUTH_FAILURE' | 'SYNTAX_ERROR' | 'TIMEOUT' | 'NOT_FOUND' | 'RATE_LIMIT' | 'PERMISSION_DENIED' | 'NETWORK_ERROR' | 'UNKNOWN';
+export interface NormalizedError {
+    category: ErrorCategory;
+    /** Sanitized, truncated message safe for LLM injection */
+    safeMessage: string;
+    /** Original raw message (internal use only — never inject into prompts) */
+    rawMessage: string;
+}
+export declare class ErrorNormalizer {
+    private readonly _leakDetector;
+    constructor(leakDetector?: LeakDetector);
+    /**
+     * Normalize a raw error message into a structured, sanitized form.
+     *
+     * Steps:
+     *  1. Classify into an ErrorCategory.
+     *  2. Redact PII/secrets via LeakDetector.
+     *  3. Truncate to MAX_SAFE_LENGTH characters.
+     */
+    normalize(rawMessage: string): NormalizedError;
+    /**
+     * Normalize an Error object.
+     */
+    normalizeError(err: Error): NormalizedError;
+    /**
+     * Produce a <failure_report> XML block safe for LLM injection.
+     *
+     * Security: The <failure_report> tag is a terminal leaf — content is
+     * plain text only and cannot contain executable XML/HTML.
+     *
+     * @param toolCallId - The ID of the failing tool call
+     * @param normalized - The normalized error to render
+     */
+    toFailureReport(_toolCallId: string, normalized: NormalizedError): string;
+    /**
+     * Classify a raw error string into an ErrorCategory.
+     * Returns 'UNKNOWN' if no rule matches.
+     */
+    private _classify;
+    /**
+     * Escape XML special characters to prevent tag injection.
+     */
+    private _escapeXml;
+}
+//# sourceMappingURL=error-normalizer.d.ts.map

package/dist/lib/error-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-normalizer.d.ts","sourceRoot":"","sources":["../../src/lib/error-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAI5D,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,cAAc,GACd,SAAS,GACT,WAAW,GACX,YAAY,GACZ,mBAAmB,GACnB,eAAe,GACf,SAAS,CAAC;AAEd,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACpB;AA2DD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;gBAEjC,YAAY,CAAC,EAAE,YAAY;IAIvC;;;;;;;OAOG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAU9C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,eAAe;IAK3C;;;;;;;;OAQG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,MAAM;IAczE;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAQnB"}

package/dist/lib/error-normalizer.js

@@ -0,0 +1,128 @@
+/**
+ * ErrorNormalizer — ERR-07: Safe Error Replay & Normalization
+ *
+ * Maps raw stderr/exceptions to structured error categories.
+ * Produces sanitized <failure_report> blocks safe for LLM injection.
+ * Integrates with LeakDetector to redact PII from error messages.
+ */
+import { LeakDetector } from '../security/leak-detector.js';
+const CATEGORY_RULES = [
+    {
+        category: 'AUTH_FAILURE',
+        patterns: [
+            /\b(401|403|unauthorized|forbidden|auth.*fail|invalid.*token|expired.*token|token.*expired|authentication)\b/i,
+        ],
+    },
+    {
+        category: 'SYNTAX_ERROR',
+        patterns: [
+            /\b(SyntaxError|IndentationError|ParseError|parse.*error|syntax.*error|unexpected.*token|invalid.*json)\b/i,
+        ],
+    },
+    {
+        category: 'TIMEOUT',
+        patterns: [
+            /\b(timeout|timed?\s*out|504|408|ETIMEDOUT|deadline.*exceed)\b/i,
+        ],
+    },
+    {
+        category: 'NOT_FOUND',
+        patterns: [
+            /\b(404|not.*found|ENOENT|no.*such.*file|does.*not.*exist|missing.*file|missing.*path)\b/i,
+        ],
+    },
+    {
+        category: 'RATE_LIMIT',
+        patterns: [
+            /\b(429|rate.*limit|too.*many.*requests|quota.*exceed|throttl)\b/i,
+        ],
+    },
+    {
+        category: 'PERMISSION_DENIED',
+        patterns: [
+            /\b(EACCES|permission.*denied|access.*denied|not.*permitted|EPERM)\b/i,
+        ],
+    },
+    {
+        category: 'NETWORK_ERROR',
+        patterns: [
+            /\b(ECONNREFUSED|ECONNRESET|ENOTFOUND|network.*error|connection.*refused|socket.*hang)\b/i,
+        ],
+    },
+];
+/** Maximum length for the safe message injected into prompts */
+const MAX_SAFE_LENGTH = 400;
+// ─── ErrorNormalizer ──────────────────────────────────────────────────
+export class ErrorNormalizer {
+    _leakDetector;
+    constructor(leakDetector) {
+        this._leakDetector = leakDetector ?? new LeakDetector();
+    }
+    /**
+     * Normalize a raw error message into a structured, sanitized form.
+     *
+     * Steps:
+     *  1. Classify into an ErrorCategory.
+     *  2. Redact PII/secrets via LeakDetector.
+     *  3. Truncate to MAX_SAFE_LENGTH characters.
+     */
+    normalize(rawMessage) {
+        const category = this._classify(rawMessage);
+        const redacted = this._leakDetector.redact(rawMessage);
+        const safeMessage = redacted.length > MAX_SAFE_LENGTH
+            ? redacted.slice(0, MAX_SAFE_LENGTH - 3) + '...'
+            : redacted;
+        return { category, safeMessage, rawMessage };
+    }
+    /**
+     * Normalize an Error object.
+     */
+    normalizeError(err) {
+        const raw = err.message || String(err);
+        return this.normalize(raw);
+    }
+    /**
+     * Produce a <failure_report> XML block safe for LLM injection.
+     *
+     * Security: The <failure_report> tag is a terminal leaf — content is
+     * plain text only and cannot contain executable XML/HTML.
+     *
+     * @param toolCallId - The ID of the failing tool call
+     * @param normalized - The normalized error to render
+     */
+    toFailureReport(_toolCallId, normalized) {
+        // Escape any XML special chars in the safe message to prevent tag injection.
+        // <failure_report> must be a terminal leaf — no child tags allowed.
+        // NOTE: Do NOT wrap in <tool_result> here. The orchestrator places this string
+        // as the `result` field of a tool_result event, which the provider already
+        // wraps in a <tool_result> block when building API messages.
+        const escaped = this._escapeXml(normalized.safeMessage);
+        return (`<failure_report category="${normalized.category}">\n` +
+            `  ${escaped}\n` +
+            `</failure_report>`);
+    }
+    /**
+     * Classify a raw error string into an ErrorCategory.
+     * Returns 'UNKNOWN' if no rule matches.
+     */
+    _classify(message) {
+        for (const { category, patterns } of CATEGORY_RULES) {
+            if (patterns.some(p => p.test(message))) {
+                return category;
+            }
+        }
+        return 'UNKNOWN';
+    }
+    /**
+     * Escape XML special characters to prevent tag injection.
+     */
+    _escapeXml(text) {
+        return text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+}
+//# sourceMappingURL=error-normalizer.js.map

package/dist/lib/error-normalizer.js.map

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

package/dist/memory/context-compressor.d.ts

@@ -51,13 +51,15 @@ export declare class ContextCompressor {
     private _totalCompressions;
     /** Session ID for this compressor instance */
     private readonly _sessionId;
+    /** MEM-20: Optional callback triggered when session-tier observations overflow */
+    private readonly _onSessionTierFull?;
     /** Async buffer: pre-computed observations ready to activate */
     private _precomputedBlock;
     private _precomputePromise;
     private _precomputeThreshold;
     /** Track session tier size when precompute started to detect staleness */
     private _precomputeSessionObsCount;
-    constructor(config: CompressionConfig, store: ObservationStore, compressFn: CompressFn, sessionId?: string);
+    constructor(config: CompressionConfig, store: ObservationStore, compressFn: CompressFn, sessionId?: string, onSessionTierFull?: (observations: string, sessionId: string) => Promise<void>);
     /**
      * Load existing observations for this session (e.g., after restart).
      */

package/dist/memory/context-compressor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAKjF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,oBAAoB;IACpB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,wCAAwC;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAK;IAC3B,qDAAqD;IACrD,OAAO,CAAC,aAAa,CAAK;IAE1B,2DAA2D;IAC3D,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,cAAc,CAAK;IAE3B,mDAAmD;IACnD,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,mBAAmB,CAAK;IAEhC,iFAAiF;IACjF,OAAO,CAAC,oBAAoB,CAAsD;IAClF,OAAO,CAAC,kBAAkB,CAAK;IAE/B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,gEAAgE;IAChE,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,oBAAoB,CAAS;IACrC,0EAA0E;IAC1E,OAAO,CAAC,0BAA0B,CAAK;gBAGrC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM;IAUpB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B;;;OAGG;IACH,YAAY,IAAI,YAAY;IAgB5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B,uDAAuD;IACvD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,uDAAuD;IACvD,IAAI,KAAK,IAAI,gBAAgB,CAS5B;IAID,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,cAAc;IAwD5B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAyD7B"}
+{"version":3,"file":"context-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAKjF,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,oBAAoB;IACpB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,wCAAwC;IACxC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,2CAA2C;IAC3C,OAAO,CAAC,cAAc,CAAK;IAC3B,qDAAqD;IACrD,OAAO,CAAC,aAAa,CAAK;IAE1B,2DAA2D;IAC3D,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,cAAc,CAAK;IAE3B,mDAAmD;IACnD,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,mBAAmB,CAAK;IAEhC,iFAAiF;IACjF,OAAO,CAAC,oBAAoB,CAAsD;IAClF,OAAO,CAAC,kBAAkB,CAAK;IAE/B,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAA6D;IAEjG,gEAAgE;IAChE,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,kBAAkB,CAA8B;IACxD,OAAO,CAAC,oBAAoB,CAAS;IACrC,0EAA0E;IAC1E,OAAO,CAAC,0BAA0B,CAAK;gBAGrC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,UAAU,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAWhF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAM/B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B;;;OAGG;IACH,YAAY,IAAI,YAAY;IAgB5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B,uDAAuD;IACvD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,uDAAuD;IACvD,IAAI,KAAK,IAAI,gBAAgB,CAS5B;IAID,8EAA8E;IAC9E,OAAO,CAAC,aAAa;IAMrB;;OAEG;YACW,cAAc;IAmE5B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAyD7B"}

package/dist/memory/context-compressor.js

@@ -34,17 +34,20 @@ export class ContextCompressor {
     _totalCompressions = 0;
     /** Session ID for this compressor instance */
     _sessionId;
+    /** MEM-20: Optional callback triggered when session-tier observations overflow */
+    _onSessionTierFull;
     /** Async buffer: pre-computed observations ready to activate */
     _precomputedBlock = null;
     _precomputePromise = null;
     _precomputeThreshold;
     /** Track session tier size when precompute started to detect staleness */
     _precomputeSessionObsCount = 0;
-    constructor(config, store, compressFn, sessionId) {
+    constructor(config, store, compressFn, sessionId, onSessionTierFull) {
         this._config = config;
         this._store = store;
         this._observer = new ObserverWorker(compressFn);
         this._sessionId = sessionId ?? `session_${Date.now()}_${Math.random().toString(36).substring(2, 8)}`;
+        this._onSessionTierFull = onSessionTierFull;
         // Start pre-computing when working tier reaches 70% of threshold
         this._precomputeThreshold = Math.floor(config.working_tier_max_tokens * 0.7);
     }
@@ -213,8 +216,20 @@ export class ContextCompressor {
             }, 'Chunk compressed');
             // Check if session tier needs condensation
             if (this._sessionTokens > this._config.session_tier_max_tokens) {
-                log.info({ sessionTokens: this._sessionTokens, max: this._config.session_tier_max_tokens }, 'Session tier exceeds threshold — reflector pass needed');
-                // Reflector integration is handled by the orchestrator (OM-05/OM-07)
+                log.info({ sessionTokens: this._sessionTokens, max: this._config.session_tier_max_tokens }, 'Session tier exceeds threshold — triggering reflector pass');
+                // MEM-20: Trigger reflector pass if callback is wired
+                if (this._onSessionTierFull) {
+                    const blocks = await this._store.loadSession(this._sessionId);
+                    const observationText = blocks.map(b => b.observations).join('\n\n');
+                    if (observationText.trim()) {
+                        try {
+                            await this._onSessionTierFull(observationText, this._sessionId);
+                        }
+                        catch (err) {
+                            log.warn({ err }, 'Session-tier reflector pass failed');
+                        }
+                    }
+                }
             }
         }
         catch (err) {

package/dist/memory/context-compressor.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-compressor.js","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAmB,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAsB/C,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAoB;IAC3B,SAAS,CAAiB;IAC1B,MAAM,CAAmB;IAE1C,wCAAwC;IAChC,gBAAgB,GAAiB,EAAE,CAAC;IAC5C,2CAA2C;IACnC,cAAc,GAAG,CAAC,CAAC;IAC3B,qDAAqD;IAC7C,aAAa,GAAG,CAAC,CAAC;IAE1B,2DAA2D;IACnD,oBAAoB,GAAa,EAAE,CAAC;IACpC,cAAc,GAAG,CAAC,CAAC;IAE3B,mDAAmD;IAC3C,oBAAoB,GAAG,EAAE,CAAC;IAC1B,mBAAmB,GAAG,CAAC,CAAC;IAEhC,iFAAiF;IACzE,oBAAoB,GAAmD,EAAE,CAAC;IAC1E,kBAAkB,GAAG,CAAC,CAAC;IAE/B,8CAA8C;IAC7B,UAAU,CAAS;IAEpC,gEAAgE;IACxD,iBAAiB,GAA4B,IAAI,CAAC;IAClD,kBAAkB,GAAyB,IAAI,CAAC;IAChD,oBAAoB,CAAS;IACrC,0EAA0E;IAClE,0BAA0B,GAAG,CAAC,CAAC;IAEvC,YACE,MAAyB,EACzB,KAAuB,EACvB,UAAsB,EACtB,SAAkB;QAElB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,SAAS,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrG,iEAAiE;QACjE,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,uBAAuB,GAAG,GAAG,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,oBAAoB,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,wBAAwB,EAAE,CAAC;QACzE,IAAI,CAAC,mBAAmB,GAAG,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAErE,GAAG,CAAC,IAAI,CACN;YACE,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,aAAa,EAAE,aAAa,CAAC,MAAM;YACnC,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;SAC7C,EACD,8BAA8B,CAC/B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACR,kCAAkC;QAClC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAE9E,+EAA+E;QAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,uBAAuB,GAAG,CAAC,CAAC,CAAC;QACjG,IAAI,IAAI,CAAC,cAAc,GAAG,UAAU,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CACN,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,EAClD,8EAA8E,CAC/E,CAAC;YACF,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,mDAAmD;QACnD,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;YAC/D,8CAA8C;YAC9C,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO;QACT,CAAC;QAED,+DAA+D;QAC/D,IACE,IAAI,CAAC,OAAO,CAAC,YAAY;YACzB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,oBAAoB;YAC/C,CAAC,IAAI,CAAC,kBAAkB;YACxB,CAAC,IAAI,CAAC,iBAAiB;YACvB,IAAI,CAAC,gBAAgB,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EACvD,CAAC;YACD,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,OAAO;YACL,mBAAmB,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;YAC3D,mBAAmB,EAAE,IAAI,CAAC,oBAAoB;YAC9C,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;YAC3C,KAAK,EAAE;gBACL,aAAa,EAAE,IAAI,CAAC,cAAc;gBAClC,aAAa,EAAE,IAAI,CAAC,cAAc;gBAClC,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;gBAC5C,mBAAmB,EAAE,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;gBAC7E,qBAAqB,EAAE,IAAI,CAAC,aAAa;gBACzC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;aAC3C;SACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,+BAA+B;QAC/B,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,kBAAkB,CAAC;YAC9B,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,sFAAsF;QACtF,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAExE,gEAAgE;QAChE,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;QAED,sDAAsD;QACtD,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAChG,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAC;QAE/B,GAAG,CAAC,IAAI,CACN;YACE,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;YAC1C,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM;SAC/C,EACD,4BAA4B,CAC7B,CAAC;IACJ,CAAC;IAED,uDAAuD;IACvD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,uDAAuD;IACvD,IAAI,KAAK;QACP,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,kBAAkB,EAAE,IAAI,CAAC,mBAAmB;YAC5C,mBAAmB,EAAE,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YAC7E,qBAAqB,EAAE,IAAI,CAAC,aAAa;YACzC,iBAAiB,EAAE,IAAI,CAAC,kBAAkB;SAC3C,CAAC;IACJ,CAAC;IAED,oEAAoE;IAEpE,8EAA8E;IACtE,aAAa,CAAC,CAAgB;QACpC,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/C,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO;QAE5B,2BAA2B;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAEpF,kCAAkC;QAClC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxC,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAE7F,6CAA6C;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEhC,uDAAuD;YACvD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,CAAC;YAC7C,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAE1B,GAAG,CAAC,IAAI,CACN;gBACE,SAAS,EAAE,KAAK,CAAC,MAAM;gBACvB,iBAAiB,EAAE,KAAK,CAAC,eAAe;gBACxC,aAAa,EAAE,IAAI,CAAC,cAAc;gBAClC,aAAa,EAAE,IAAI,CAAC,cAAc;aACnC,EACD,kBAAkB,CACnB,CAAC;YAEF,2CAA2C;YAC3C,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;gBAC/D,GAAG,CAAC,IAAI,CACN,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,EACjF,wDAAwD,CACzD,CAAC;gBACF,qEAAqE;YACvE,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,kEAAkE;YAClE,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC5D,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACxC,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,oDAAoD,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,gBAAgB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAClF,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO;QAE5B,4EAA4E;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QACrE,MAAM,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3D,0EAA0E;QAC1E,IAAI,CAAC,0BAA0B,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC;QAEnE,IAAI,CAAC,kBAAkB,GAAG,CAAC,KAAK,IAAI,EAAE;YACpC,IAAI,CAAC;gBACH,IAAI,CAAC,iBAAiB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CACpD,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,UAAU,CAChD,CAAC;gBACF,GAAG,CAAC,IAAI,CACN,EAAE,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,EAClD,sCAAsC,CACvC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,qEAAqE,CAAC,CAAC;gBACzF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAChC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;IACP,CAAC;IAED;;;OAGG;IACK,oBAAoB;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,iFAAiF;QACjF,IAAI,IAAI,CAAC,oBAAoB,CAAC,MAAM,KAAK,IAAI,CAAC,0BAA0B,EAAE,CAAC;YACzE,GAAG,CAAC,IAAI,CACN;gBACE,aAAa,EAAE,IAAI,CAAC,0BAA0B;gBAC9C,WAAW,EAAE,IAAI,CAAC,oBAAoB,CAAC,MAAM;aAC9C,EACD,gEAAgE,CACjE,CAAC;YACF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,kBAAkB,CAAC;QAC9C,MAAM,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC;QAE9B,4EAA4E;QAC5E,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3G,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxC,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QAED,gFAAgF;QAChF,IAAI,CAAC,aAAa,CAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAClC,uDAAuD;YACvD,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACnD,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,eAAe,CAAC;YAC7C,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAE1B,GAAG,CAAC,IAAI,CACN;gBACE,SAAS;gBACT,iBAAiB,EAAE,KAAK,CAAC,eAAe;gBACxC,aAAa,EAAE,IAAI,CAAC,cAAc;gBAClC,aAAa,EAAE,IAAI,CAAC,cAAc;aACnC,EACD,8BAA8B,CAC/B,CAAC;QACJ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACb,6EAA6E;YAC7E,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,gEAAgE,CAAC,CAAC;YACrF,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACtE,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;YACxB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACxC,IAAI,CAAC,cAAc,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;QAEF,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAChC,CAAC;CACF"}
+{"version":3,"file":"context-compressor.js","sourceRoot":"","sources":["../../src/memory/context-compressor.ts"],"names":[],"mappings":"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"}

package/dist/memory/plan-cache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PlanCache — Persistent cache for TLCI ExecutionPlans.
+ * Stores plans as JSON files in ~/.zora/plan-cache/ (one file per plan hash).
+ */
+import type { ExecutionPlan } from '../orchestrator/execution-planner.js';
+export interface CachedPlan {
+    plan: ExecutionPlan;
+    executionCount: number;
+    totalSavingsUSD: number;
+    firstSeenAt: number;
+    lastUsedAt: number;
+}
+export declare class PlanCache {
+    private readonly _cacheDir;
+    constructor(cacheDir?: string);
+    init(): Promise<void>;
+    private _filePath;
+    get(planHash: string): Promise<ExecutionPlan | null>;
+    set(plan: ExecutionPlan): Promise<void>;
+    invalidate(planHash: string): Promise<void>;
+    getStats(): Promise<{
+        totalCachedPlans: number;
+        totalExecutions: number;
+        totalSavingsUSD: number;
+    }>;
+}
+//# sourceMappingURL=plan-cache.d.ts.map

package/dist/memory/plan-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-cache.d.ts","sourceRoot":"","sources":["../../src/memory/plan-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,aAAa,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AAE9I,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,QAAQ,CAAC,EAAE,MAAM;IAIvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,SAAS;IAQX,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAiBpD,GAAG,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3C,QAAQ,IAAI,OAAO,CAAC;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAuB1G"}

package/dist/memory/plan-cache.js

@@ -0,0 +1,91 @@
+/**
+ * PlanCache — Persistent cache for TLCI ExecutionPlans.
+ * Stores plans as JSON files in ~/.zora/plan-cache/ (one file per plan hash).
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { writeAtomic } from '../utils/fs.js';
+export class PlanCache {
+    _cacheDir;
+    constructor(cacheDir) {
+        this._cacheDir = cacheDir ?? path.join(os.homedir(), '.zora', 'plan-cache');
+    }
+    async init() {
+        await fs.mkdir(this._cacheDir, { recursive: true, mode: 0o700 });
+    }
+    _filePath(planHash) {
+        // Validate planHash is hex-only (SHA-256 output) to prevent path traversal
+        if (!/^[a-f0-9]+$/i.test(planHash)) {
+            throw new Error(`Invalid planHash "${planHash}" — must be hex characters only`);
+        }
+        return path.join(this._cacheDir, `${planHash}.json`);
+    }
+    async get(planHash) {
+        try {
+            const raw = await fs.readFile(this._filePath(planHash), 'utf-8');
+            const cached = JSON.parse(raw);
+            const updated = {
+                ...cached,
+                executionCount: cached.executionCount + 1,
+                totalSavingsUSD: cached.totalSavingsUSD + cached.plan.costComparison.savingsUSD,
+                lastUsedAt: Date.now(),
+            };
+            await writeAtomic(this._filePath(planHash), JSON.stringify(updated, null, 2));
+            return cached.plan;
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(plan) {
+        let existing = null;
+        try {
+            const raw = await fs.readFile(this._filePath(plan.planHash), 'utf-8');
+            existing = JSON.parse(raw);
+        }
+        catch {
+            // not cached yet
+        }
+        const entry = {
+            plan,
+            executionCount: existing?.executionCount ?? 0,
+            totalSavingsUSD: existing?.totalSavingsUSD ?? 0,
+            firstSeenAt: existing?.firstSeenAt ?? Date.now(),
+            lastUsedAt: Date.now(),
+        };
+        await writeAtomic(this._filePath(plan.planHash), JSON.stringify(entry, null, 2));
+    }
+    async invalidate(planHash) {
+        try {
+            await fs.unlink(this._filePath(planHash));
+        }
+        catch {
+            // already gone
+        }
+    }
+    async getStats() {
+        let entries = [];
+        try {
+            entries = (await fs.readdir(this._cacheDir)).filter(f => f.endsWith('.json'));
+        }
+        catch {
+            return { totalCachedPlans: 0, totalExecutions: 0, totalSavingsUSD: 0 };
+        }
+        let totalExecutions = 0;
+        let totalSavingsUSD = 0;
+        for (const file of entries) {
+            try {
+                const raw = await fs.readFile(path.join(this._cacheDir, file), 'utf-8');
+                const cached = JSON.parse(raw);
+                totalExecutions += cached.executionCount;
+                totalSavingsUSD += cached.totalSavingsUSD;
+            }
+            catch {
+                // skip corrupt entries
+            }
+        }
+        return { totalCachedPlans: entries.length, totalExecutions, totalSavingsUSD };
+    }
+}
+//# sourceMappingURL=plan-cache.js.map

package/dist/memory/plan-cache.js.map

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

package/dist/orchestrator/code-tool-runner.d.ts

@@ -0,0 +1,41 @@
+/**
+ * CodeToolRunner — Tier 1 deterministic tool implementations for TLCI.
+ *
+ * Each function corresponds to a `suggestedCodeTool` hint from the StepClassifier.
+ * Callers pass structured parameters via `step.context`.
+ *
+ * Context keys (caller-provided):
+ *   httpFetch:   { url: string, headers?: Record<string,string> }
+ *   httpPost:    { url: string, body?: unknown, headers?: Record<string,string> }
+ *   transform:   { data: unknown, operation?: 'json-parse'|'json-stringify'|'to-array'|'flatten' }
+ *   collectionOp:{ data: unknown[], operation?: 'sort'|'filter'|'count'|'deduplicate', key?: string, value?: unknown }
+ *   fileOp:      { path: string, operation?: 'read'|'write'|'list'|'exists', content?: string }
+ *   compute:     { expression: string }       — safe arithmetic only (no eval)
+ *   validate:    { data: unknown, required?: string[] }
+ *   notify:      { message: string, channel?: string }
+ *   dbQuery:     { query: string }            — stub; real DB wired by caller
+ */
+export interface CodeToolResult {
+    tool: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+type StepContext = Record<string, unknown>;
+/**
+ * Execute a Tier 1 code tool step.
+ * Returns a CodeToolResult — callers may inspect result.data for downstream steps.
+ */
+export declare function runCodeTool(tool: string, context?: StepContext): Promise<CodeToolResult>;
+/**
+ * Resolve the suggested tool from a ClassifiedStep and run it.
+ * The step's `context` field holds structured parameters.
+ */
+export declare function runCodeToolStep(step: {
+    id: string;
+    suggestedCodeTool?: string;
+    context?: Record<string, unknown>;
+    description: string;
+}): Promise<CodeToolResult>;
+export {};
+//# sourceMappingURL=code-tool-runner.d.ts.map

package/dist/orchestrator/code-tool-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-tool-runner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/code-tool-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyCH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4R3C;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CAK1B"}