@testrelic/mcp 2.1.0

package/dist/cache/blob.d.ts

@@ -0,0 +1,22 @@
+/**
+ * L4: filesystem blob store. Keys by content SHA256 so duplicate payloads
+ * share one file. LRU-evicted by total size on disk.
+ */
+export interface BlobLayerOptions {
+    cacheDir: string;
+    maxBytes?: number;
+}
+export declare class BlobLayer {
+    private readonly dir;
+    private readonly maxBytes;
+    constructor(opts: BlobLayerOptions);
+    write(content: string | Buffer): string;
+    read(sha: string): Buffer | null;
+    readText(sha: string): string | null;
+    has(sha: string): boolean;
+    private pathFor;
+    private maybeEvict;
+    private initDirsSync;
+    ensureShards(): void;
+}
+//# sourceMappingURL=blob.d.ts.map

package/dist/cache/blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../src/cache/blob.ts"],"names":[],"mappings":"AAKA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,IAAI,EAAE,gBAAgB;IAM3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAWvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMhC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,UAAU;IAqClB,OAAO,CAAC,YAAY;IAOb,YAAY,IAAI,IAAI;CAG5B"}

package/dist/cache/blob.js

@@ -0,0 +1,92 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getLogger } from "../logger.js";
+export class BlobLayer {
+    dir;
+    maxBytes;
+    constructor(opts) {
+        this.dir = join(opts.cacheDir, "blobs");
+        this.maxBytes = opts.maxBytes ?? 500 * 1024 * 1024;
+        mkdirSync(this.dir, { recursive: true });
+    }
+    write(content) {
+        const buf = typeof content === "string" ? Buffer.from(content, "utf-8") : content;
+        const sha = createHash("sha256").update(buf).digest("hex");
+        const p = this.pathFor(sha);
+        if (!existsSync(p)) {
+            writeFileSync(p, buf);
+            this.maybeEvict();
+        }
+        return sha;
+    }
+    read(sha) {
+        const p = this.pathFor(sha);
+        if (!existsSync(p))
+            return null;
+        return readFileSync(p);
+    }
+    readText(sha) {
+        const b = this.read(sha);
+        return b ? b.toString("utf-8") : null;
+    }
+    has(sha) {
+        return existsSync(this.pathFor(sha));
+    }
+    pathFor(sha) {
+        return join(this.dir, sha.slice(0, 2), `${sha}.blob`);
+    }
+    maybeEvict() {
+        try {
+            const files = [];
+            for (const sub of readdirSync(this.dir)) {
+                const subDir = join(this.dir, sub);
+                try {
+                    if (!statSync(subDir).isDirectory())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                for (const f of readdirSync(subDir)) {
+                    const p = join(subDir, f);
+                    try {
+                        const st = statSync(p);
+                        files.push({ path: p, size: st.size, atime: st.atimeMs });
+                    }
+                    catch {
+                        // skip missing files
+                    }
+                }
+            }
+            let total = files.reduce((a, f) => a + f.size, 0);
+            if (total <= this.maxBytes)
+                return;
+            files.sort((a, b) => a.atime - b.atime);
+            for (const f of files) {
+                if (total <= this.maxBytes * 0.9)
+                    break;
+                try {
+                    unlinkSync(f.path);
+                    total -= f.size;
+                }
+                catch {
+                    // ignore eviction errors
+                }
+            }
+        }
+        catch (err) {
+            getLogger().debug({ err }, "blob eviction failed");
+        }
+    }
+    initDirsSync() {
+        // Make sure shard directories exist on first use
+        for (let i = 0; i < 256; i++) {
+            mkdirSync(join(this.dir, i.toString(16).padStart(2, "0")), { recursive: true });
+        }
+    }
+    ensureShards() {
+        this.initDirsSync();
+    }
+}
+//# sourceMappingURL=blob.js.map

package/dist/cache/blob.js.map

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

package/dist/cache/diff-reader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 3-state reader: returns either the full payload, an "unchanged" stub, or a
+ * unified diff against the previously returned state. Keyed by caller-supplied
+ * resource id.
+ *
+ * Token savings: 80–95% on repeats of large, mostly-stable payloads
+ * (e.g. coverage reports, repo manifests, journey catalogs).
+ */
+export type ReadState = {
+    state: "full";
+    content: string;
+    fingerprint: string;
+} | {
+    state: "unchanged";
+    fingerprint: string;
+} | {
+    state: "diff";
+    content: string;
+    fingerprint: string;
+    previousFingerprint: string;
+};
+export declare class DiffReader {
+    private readonly snapshots;
+    read(resourceId: string, content: string): ReadState;
+    forget(resourceId: string): void;
+    clear(): void;
+    size(): number;
+}
+//# sourceMappingURL=diff-reader.d.ts.map

package/dist/cache/diff-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-reader.d.ts","sourceRoot":"","sources":["../../src/cache/diff-reader.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,MAAM,SAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAA;CAAE,CAAC;AAQzF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAExD,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAuBpD,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGtB"}

package/dist/cache/diff-reader.js

@@ -0,0 +1,34 @@
+import { createPatch } from "diff";
+import { simHash } from "./key.js";
+export class DiffReader {
+    snapshots = new Map();
+    read(resourceId, content) {
+        const fingerprint = simHash(content);
+        const prev = this.snapshots.get(resourceId);
+        if (!prev) {
+            this.snapshots.set(resourceId, { fingerprint, content, ts: Date.now() });
+            return { state: "full", content, fingerprint };
+        }
+        if (prev.fingerprint === fingerprint) {
+            return { state: "unchanged", fingerprint };
+        }
+        const patch = createPatch(resourceId, prev.content, content, "previous", "current");
+        this.snapshots.set(resourceId, { fingerprint, content, ts: Date.now() });
+        return {
+            state: "diff",
+            content: patch,
+            fingerprint,
+            previousFingerprint: prev.fingerprint,
+        };
+    }
+    forget(resourceId) {
+        this.snapshots.delete(resourceId);
+    }
+    clear() {
+        this.snapshots.clear();
+    }
+    size() {
+        return this.snapshots.size;
+    }
+}
+//# sourceMappingURL=diff-reader.js.map

package/dist/cache/diff-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-reader.js","sourceRoot":"","sources":["../../src/cache/diff-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAsBnC,MAAM,OAAO,UAAU;IACJ,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAExD,IAAI,CAAC,UAAkB,EAAE,OAAe;QAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACzE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;YACrC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzE,OAAO;YACL,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,KAAK;YACd,WAAW;YACX,mBAAmB,EAAE,IAAI,CAAC,WAAW;SACtC,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,UAAkB;QAC9B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/cache/index.d.ts

@@ -0,0 +1,57 @@
+import type { ResolvedConfig } from "../config.js";
+import { BlobLayer } from "./blob.js";
+import { DiffReader } from "./diff-reader.js";
+import { LruLayer } from "./lru.js";
+import { SqliteLayer } from "./sqlite.js";
+import { VectorStore } from "./vector.js";
+/**
+ * Unified cache facade. Tools talk to this; it in turn decides which tier to
+ * consult. For the token-reduction strategy:
+ *   1. L1 LRU (ms) — burst repeats
+ *   2. L2 SQLite (ms) — warm hits across sessions
+ *   3. L3 HNSW vector (ms) — semantic neighbors
+ *   4. L4 blob (ms) — large artifacts referenced by `cache_key`
+ */
+export interface CacheLookup<T> {
+    value: T;
+    layer: "L1" | "L2" | "L3" | "L4";
+}
+export interface CacheStats {
+    l1Hits: number;
+    l1Misses: number;
+    l2Hits: number;
+    l2Misses: number;
+    l3Hits: number;
+    l3Misses: number;
+    l4Hits: number;
+    l4Misses: number;
+    lruSize: number;
+    vectorSize: number;
+}
+export declare class CacheManager {
+    private readonly config;
+    readonly lru: LruLayer;
+    readonly sqlite: SqliteLayer;
+    readonly vector: VectorStore;
+    readonly blob: BlobLayer;
+    readonly diff: DiffReader;
+    readonly stats: CacheStats;
+    constructor(config: ResolvedConfig);
+    init(): Promise<void>;
+    key(tool: string, input: unknown, schemaVersion?: string): string;
+    get<T>(key: string): CacheLookup<T> | undefined;
+    set<T>(key: string, value: T, opts?: {
+        ttlSeconds?: number;
+        namespace?: string;
+    }): void;
+    invalidateNamespace(namespace: string): void;
+    close(): Promise<void>;
+    snapshot(): CacheStats;
+}
+export { cacheKey, simHash } from "./key.js";
+export { LruLayer } from "./lru.js";
+export { SqliteLayer } from "./sqlite.js";
+export { VectorStore } from "./vector.js";
+export { BlobLayer } from "./blob.js";
+export { DiffReader, type ReadState } from "./diff-reader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IAmBX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAlBnC,SAAgB,GAAG,WAA+C;IAClE,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,IAAI,aAAoB;IACxC,SAAgB,KAAK,EAAE,UAAU,CAW/B;gBAE2B,MAAM,EAAE,cAAc;IAMtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,SAAO,GAAG,MAAM;IAI/D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS;IAkB/C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKvF,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,QAAQ,IAAI,UAAU;CAO9B;AAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,99 @@
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+import { getLogger } from "../logger.js";
+import { BlobLayer } from "./blob.js";
+import { DiffReader } from "./diff-reader.js";
+import { cacheKey } from "./key.js";
+import { LruLayer } from "./lru.js";
+import { SqliteLayer } from "./sqlite.js";
+import { VectorStore } from "./vector.js";
+export class CacheManager {
+    config;
+    lru = new LruLayer({ max: 2_000, ttlMs: 60_000 });
+    sqlite;
+    vector;
+    blob;
+    diff = new DiffReader();
+    stats = {
+        l1Hits: 0,
+        l1Misses: 0,
+        l2Hits: 0,
+        l2Misses: 0,
+        l3Hits: 0,
+        l3Misses: 0,
+        l4Hits: 0,
+        l4Misses: 0,
+        lruSize: 0,
+        vectorSize: 0,
+    };
+    constructor(config) {
+        this.config = config;
+        this.sqlite = new SqliteLayer({ path: join(config.cacheDir, "store.sqlite") });
+        this.vector = new VectorStore({ cacheDir: config.cacheDir });
+        this.blob = new BlobLayer({ cacheDir: config.cacheDir });
+    }
+    async init() {
+        if (this.config.isolated) {
+            // Best-effort wipe. Windows can hold the dir open when concurrent
+            // runs share a parent; a failure just means we append, not replace.
+            try {
+                rmSync(this.config.cacheDir, { recursive: true, force: true, maxRetries: 2, retryDelay: 50 });
+            }
+            catch (err) {
+                getLogger().debug({ err }, "isolated cacheDir wipe skipped (likely in use)");
+            }
+        }
+        this.blob.ensureShards();
+        await this.sqlite.init();
+        await this.vector.init();
+    }
+    key(tool, input, schemaVersion = "v1") {
+        return cacheKey(tool, input, schemaVersion);
+    }
+    get(key) {
+        const l1 = this.lru.get(key);
+        if (l1 !== undefined) {
+            this.stats.l1Hits++;
+            return { value: l1, layer: "L1" };
+        }
+        this.stats.l1Misses++;
+        const l2 = this.sqlite.get(key);
+        if (l2 !== undefined) {
+            this.stats.l2Hits++;
+            this.lru.set(key, l2);
+            return { value: l2, layer: "L2" };
+        }
+        this.stats.l2Misses++;
+        return undefined;
+    }
+    set(key, value, opts) {
+        this.lru.set(key, value);
+        this.sqlite.set(key, value, opts);
+    }
+    invalidateNamespace(namespace) {
+        this.sqlite.invalidateNamespace(namespace);
+        this.lru.clear();
+    }
+    async close() {
+        this.stats.lruSize = this.lru.size();
+        this.stats.vectorSize = this.vector.size();
+        if (this.config.saveSession) {
+            this.vector.persist();
+        }
+        this.sqlite.close();
+    }
+    snapshot() {
+        return {
+            ...this.stats,
+            lruSize: this.lru.size(),
+            vectorSize: this.vector.size(),
+        };
+    }
+}
+export { cacheKey, simHash } from "./key.js";
+export { LruLayer } from "./lru.js";
+export { SqliteLayer } from "./sqlite.js";
+export { VectorStore } from "./vector.js";
+export { BlobLayer } from "./blob.js";
+export { DiffReader } from "./diff-reader.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

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

package/dist/cache/key.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Stable cache key derivation.
+ *
+ * Shape: sha256(tool + "::" + schemaVersion + "::" + canonicalJSON(input))
+ *
+ * Canonicalization ensures `{a:1,b:2}` and `{b:2,a:1}` yield the same key.
+ */
+export declare function canonicalJSON(value: unknown): string;
+export declare function cacheKey(tool: string, input: unknown, schemaVersion?: string): string;
+/**
+ * SimHash-style stable fingerprint of a text blob. Used by the 3-state diff reader
+ * to detect "unchanged" on re-reads cheaply.
+ */
+export declare function simHash(text: string): string;
+//# sourceMappingURL=key.d.ts.map

package/dist/cache/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/cache/key.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAWD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,SAAO,GAAG,MAAM,CAGnF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/cache/key.js

@@ -0,0 +1,32 @@
+import { createHash } from "node:crypto";
+/**
+ * Stable cache key derivation.
+ *
+ * Shape: sha256(tool + "::" + schemaVersion + "::" + canonicalJSON(input))
+ *
+ * Canonicalization ensures `{a:1,b:2}` and `{b:2,a:1}` yield the same key.
+ */
+export function canonicalJSON(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value !== null && typeof value === "object") {
+        const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+        return Object.fromEntries(entries.map(([k, v]) => [k, sortKeys(v)]));
+    }
+    return value;
+}
+export function cacheKey(tool, input, schemaVersion = "v1") {
+    const payload = `${tool}::${schemaVersion}::${canonicalJSON(input)}`;
+    return createHash("sha256").update(payload).digest("hex");
+}
+/**
+ * SimHash-style stable fingerprint of a text blob. Used by the 3-state diff reader
+ * to detect "unchanged" on re-reads cheaply.
+ */
+export function simHash(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=key.js.map

package/dist/cache/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/cache/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AAEH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QACxG,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAc,EAAE,aAAa,GAAG,IAAI;IACzE,MAAM,OAAO,GAAG,GAAG,IAAI,KAAK,aAAa,KAAK,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IACrE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/cache/lru.d.ts

@@ -0,0 +1,21 @@
+export interface LruEntry<T> {
+    value: T;
+    storedAt: number;
+}
+/**
+ * L1: in-process LRU. Short TTL, sized by count.
+ */
+export declare class LruLayer {
+    private cache;
+    constructor(opts?: {
+        max?: number;
+        ttlMs?: number;
+    });
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    size(): number;
+}
+//# sourceMappingURL=lru.d.ts.map

package/dist/cache/lru.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.d.ts","sourceRoot":"","sources":["../../src/cache/lru.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAsC;gBAEvC,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAOhD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;CAGtB"}

package/dist/cache/lru.js

@@ -0,0 +1,32 @@
+import { LRUCache } from "lru-cache";
+/**
+ * L1: in-process LRU. Short TTL, sized by count.
+ */
+export class LruLayer {
+    cache;
+    constructor(opts = {}) {
+        this.cache = new LRUCache({
+            max: opts.max ?? 1_000,
+            ttl: opts.ttlMs ?? 60_000,
+        });
+    }
+    get(key) {
+        return this.cache.get(key)?.value;
+    }
+    set(key, value) {
+        this.cache.set(key, { value, storedAt: Date.now() });
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    size() {
+        return this.cache.size;
+    }
+}
+//# sourceMappingURL=lru.js.map

package/dist/cache/lru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lru.js","sourceRoot":"","sources":["../../src/cache/lru.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAOrC;;GAEG;AACH,MAAM,OAAO,QAAQ;IACX,KAAK,CAAsC;IAEnD,YAAY,OAAyC,EAAE;QACrD,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC;YACxB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK;YACtB,GAAG,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;IAEM,GAAG,CAAI,GAAW;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAsB,CAAC;IACrD,CAAC;IAEM,GAAG,CAAI,GAAW,EAAE,KAAQ;QACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACvD,CAAC;IAEM,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAEM,MAAM,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/cache/sqlite.d.ts

@@ -0,0 +1,22 @@
+export interface SqliteLayerOptions {
+    path: string;
+    /** Default TTL in seconds. Individual writes can override. */
+    defaultTtlSeconds?: number;
+}
+export declare class SqliteLayer {
+    private readonly opts;
+    private db;
+    private fallback;
+    private readonly defaultTtlSeconds;
+    constructor(opts: SqliteLayerOptions);
+    init(): Promise<void>;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, value: T, opts?: {
+        ttlSeconds?: number;
+        namespace?: string;
+    }): void;
+    invalidateNamespace(namespace: string): void;
+    clear(): void;
+    close(): void;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/cache/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/cache/sqlite.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,WAAW;IAKV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,EAAE,CAA6B;IACvC,OAAO,CAAC,QAAQ,CAA2D;IAC3E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAEd,IAAI,EAAE,kBAAkB;IAIxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAsBlC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAevF,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAS5C,KAAK,IAAI,IAAI;IAQb,KAAK,IAAI,IAAI;CAOrB"}

package/dist/cache/sqlite.js

@@ -0,0 +1,102 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { getLogger } from "../logger.js";
+export class SqliteLayer {
+    opts;
+    db = null;
+    fallback = new Map();
+    defaultTtlSeconds;
+    constructor(opts) {
+        this.opts = opts;
+        this.defaultTtlSeconds = opts.defaultTtlSeconds ?? 3_600;
+    }
+    async init() {
+        try {
+            // Dynamic import — optional dependency. Not typed because it's
+            // optional; we wrap with a guard and fall back cleanly.
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore optional native dep
+            const mod = await import("better-sqlite3").catch(() => null);
+            if (!mod || !mod.default) {
+                getLogger().warn("better-sqlite3 not available — L2 cache falls back to in-memory map");
+                return;
+            }
+            mkdirSync(dirname(this.opts.path), { recursive: true });
+            const Database = mod.default;
+            this.db = new Database(this.opts.path);
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS kv (
+          k TEXT PRIMARY KEY,
+          v TEXT NOT NULL,
+          expires_at INTEGER NOT NULL,
+          namespace TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_kv_namespace ON kv(namespace);
+        CREATE INDEX IF NOT EXISTS idx_kv_expires ON kv(expires_at);
+      `);
+        }
+        catch (err) {
+            getLogger().warn({ err }, "SQLite init failed; using in-memory fallback");
+            this.db = null;
+        }
+    }
+    get(key) {
+        const now = Date.now();
+        if (this.db) {
+            const row = this.db.prepare("SELECT v, expires_at FROM kv WHERE k = ?").get(key);
+            if (!row)
+                return undefined;
+            if (row.expires_at < now) {
+                this.db.prepare("DELETE FROM kv WHERE k = ?").run(key);
+                return undefined;
+            }
+            return JSON.parse(row.v);
+        }
+        const fb = this.fallback.get(key);
+        if (!fb)
+            return undefined;
+        if (fb.expiresAt < now) {
+            this.fallback.delete(key);
+            return undefined;
+        }
+        return JSON.parse(fb.value);
+    }
+    set(key, value, opts) {
+        const ttl = opts?.ttlSeconds ?? this.defaultTtlSeconds;
+        const expiresAt = Date.now() + ttl * 1000;
+        const serialized = JSON.stringify(value);
+        if (this.db) {
+            this.db
+                .prepare("INSERT INTO kv (k, v, expires_at, namespace) VALUES (?, ?, ?, ?) ON CONFLICT(k) DO UPDATE SET v = excluded.v, expires_at = excluded.expires_at")
+                .run(key, serialized, expiresAt, opts?.namespace ?? null);
+        }
+        else {
+            this.fallback.set(key, { value: serialized, expiresAt });
+        }
+    }
+    invalidateNamespace(namespace) {
+        if (this.db) {
+            this.db.prepare("DELETE FROM kv WHERE namespace = ?").run(namespace);
+        }
+        else {
+            // No namespace tracking in fallback — nuke all.
+            this.fallback.clear();
+        }
+    }
+    clear() {
+        if (this.db) {
+            this.db.exec("DELETE FROM kv");
+        }
+        else {
+            this.fallback.clear();
+        }
+    }
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+        this.fallback.clear();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/cache/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/cache/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAQ,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AA0BzC,MAAM,OAAO,WAAW;IAKO;IAJrB,EAAE,GAAwB,IAAI,CAAC;IAC/B,QAAQ,GAAG,IAAI,GAAG,EAAgD,CAAC;IAC1D,iBAAiB,CAAS;IAE3C,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;QACnD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC;IAC3D,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC;YACH,+DAA+D;YAC/D,wDAAwD;YACxD,6DAA6D;YAC7D,iCAAiC;YACjC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACzB,SAAS,EAAE,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;gBACxF,OAAO;YACT,CAAC;YACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAwD,CAAC;YAC9E,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;OASZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,8CAA8C,CAAC,CAAC;YAC1E,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAEM,GAAG,CAAI,GAAW;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,GAAG,CAElE,CAAC;YACd,IAAI,CAAC,GAAG;gBAAE,OAAO,SAAS,CAAC;YAC3B,IAAI,GAAG,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvD,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,CAAC;QAChC,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAC1B,IAAI,EAAE,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAM,CAAC;IACnC,CAAC;IAEM,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,IAAkD;QACrF,MAAM,GAAG,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC,iBAAiB,CAAC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE;iBACJ,OAAO,CACN,gJAAgJ,CACjJ;iBACA,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAEM,mBAAmB,CAAC,SAAiB;QAC1C,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,gDAAgD;YAChD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,KAAK;QACV,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,KAAK;QACV,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}