@vivantel/rag-embedder-openai 1.1.0 → 1.3.0

package/dist/embedder.d.ts

@@ -1,4 +1,5 @@
-import type { EmbeddingProvider } from "@vivantel/rag-core";
+import type { EmbeddingProvider, EmbeddingMetrics } from "@vivantel/rag-core";
+import { type SemanticCacheConfig } from "./semantic-cache.js";
 export interface OpenAICompatibleEmbedderOptions {
     apiKey: string;
     model: string;
@@ -7,6 +8,8 @@ export interface OpenAICompatibleEmbedderOptions {
     baseURL?: string;
     organizationId?: string;
     maxRetries?: number;
+    /** Optional semantic or exact embedding cache. */
+    cache?: SemanticCacheConfig;
 }
 export declare class OpenAICompatibleEmbedder implements EmbeddingProvider {
     readonly name: string;
@@ -14,9 +17,13 @@ export declare class OpenAICompatibleEmbedder implements EmbeddingProvider {
     readonly model: string;
     readonly preferredBatchSize = 100;
     private readonly client;
+    private readonly cache;
     constructor(options: OpenAICompatibleEmbedderOptions);
     embed(text: string): Promise<number[]>;
+    private embedDirect;
     embedBatch(texts: string[]): Promise<number[][]>;
+    private embedBatchDirect;
     healthCheck(): Promise<boolean>;
+    getMetrics(embeddings: number[][]): Promise<EmbeddingMetrics>;
 }
 //# sourceMappingURL=embedder.d.ts.map

package/dist/embedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,OAAO;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,+BAA+B;IAe9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAStC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAShD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAQtC"}
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG9E,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,qBAAa,wBAAyB,YAAW,iBAAiB;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,kBAAkB,OAAO;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;gBAEjC,OAAO,EAAE,+BAA+B;IAiB9C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAU9B,WAAW;IASnB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAuBxC,gBAAgB;IASxB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAGpE"}

package/dist/embedder.js

@@ -1,10 +1,13 @@
 import OpenAI from "openai";
+import { computeEmbeddingMetrics } from "./embedding-metrics.js";
+import { SemanticCache } from "./semantic-cache.js";
 export class OpenAICompatibleEmbedder {
     name;
     dimensions;
     model;
     preferredBatchSize = 100;
     client;
+    cache;
     constructor(options) {
         this.model = options.model;
         this.dimensions = options.dimensions ?? 1536;
@@ -17,8 +20,20 @@ export class OpenAICompatibleEmbedder {
             organization: options.organizationId,
             maxRetries: options.maxRetries ?? 3,
         });
+        this.cache = options.cache ? new SemanticCache(options.cache) : null;
     }
     async embed(text) {
+        if (this.cache) {
+            const hit = await this.cache.get(text, (t) => this.embedDirect(t));
+            if (hit)
+                return hit;
+        }
+        const embedding = await this.embedDirect(text);
+        if (this.cache)
+            await this.cache.set(text, embedding);
+        return embedding;
+    }
+    async embedDirect(text) {
         const res = await this.client.embeddings.create({
             model: this.model,
             input: text,
@@ -27,6 +42,25 @@ export class OpenAICompatibleEmbedder {
         return res.data[0].embedding;
     }
     async embedBatch(texts) {
+        if (this.cache) {
+            // Try cache for each text; fall back to batch API for misses
+            const results = await Promise.all(texts.map((t) => this.cache.get(t, (x) => this.embedDirect(x))));
+            const missIndices = results
+                .map((r, i) => (r === null ? i : -1))
+                .filter((i) => i >= 0);
+            if (missIndices.length === 0)
+                return results;
+            const missTexts = missIndices.map((i) => texts[i]);
+            const missEmbeddings = await this.embedBatchDirect(missTexts);
+            for (let k = 0; k < missIndices.length; k++) {
+                results[missIndices[k]] = missEmbeddings[k];
+                await this.cache.set(missTexts[k], missEmbeddings[k]);
+            }
+            return results;
+        }
+        return this.embedBatchDirect(texts);
+    }
+    async embedBatchDirect(texts) {
         const res = await this.client.embeddings.create({
             model: this.model,
             input: texts,
@@ -43,5 +77,8 @@ export class OpenAICompatibleEmbedder {
             return false;
         }
     }
+    async getMetrics(embeddings) {
+        return computeEmbeddingMetrics(embeddings);
+    }
 }
 //# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

@@ -1 +1 @@
-{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAY5B,MAAM,OAAO,wBAAwB;IAC1B,IAAI,CAAS;IACb,UAAU,CAAS;IACnB,KAAK,CAAS;IACd,kBAAkB,GAAG,GAAG,CAAC;IAEjB,MAAM,CAAS;IAEhC,YAAY,OAAwC;QAClD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,OAAO;YACzB,CAAC,CAAC,qBAAqB,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE;YAC1D,CAAC,CAAC,QAAQ,CAAC;QAEb,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,cAAc;YACpC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACnE,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;YAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,KAAK;YACZ,UAAU,EAAE,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACnE,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"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"}

package/dist/embedding-metrics.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure embedding quality metric functions.
+ * No I/O, no external dependencies.
+ */
+import type { EmbeddingMetrics } from "@vivantel/rag-core";
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * TWO-NN intrinsic dimension estimator.
+ * For each point, computes r1/r2 (ratio of distances to 1st and 2nd
+ * nearest neighbours). ID = -1 / mean(ln(r1/r2)).
+ * Reference: Facco et al. (2017).
+ */
+export declare function computeIntrinsicDimension(embeddings: number[][]): number;
+/**
+ * Mean cosine similarity between randomly sampled pairs.
+ * Close to 0 is ideal (well-spread embedding space).
+ */
+export declare function computeAvgCosineSimRandomPairs(embeddings: number[][], sampleSize?: number): number;
+/**
+ * Fraction of embeddings whose L2-norm z-score exceeds 2.5.
+ */
+export declare function detectOutliers(embeddings: number[][]): number;
+export declare function computeEmbeddingMetrics(embeddings: number[][]): Promise<EmbeddingMetrics>;
+//# sourceMappingURL=embedding-metrics.d.ts.map

package/dist/embedding-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-metrics.d.ts","sourceRoot":"","sources":["../src/embedding-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAWjE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAoCxE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAAE,EAAE,EACtB,UAAU,SAAM,GACf,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAe7D;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAAE,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAM3B"}

package/dist/embedding-metrics.js

@@ -0,0 +1,101 @@
+/**
+ * Pure embedding quality metric functions.
+ * No I/O, no external dependencies.
+ */
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+/**
+ * TWO-NN intrinsic dimension estimator.
+ * For each point, computes r1/r2 (ratio of distances to 1st and 2nd
+ * nearest neighbours). ID = -1 / mean(ln(r1/r2)).
+ * Reference: Facco et al. (2017).
+ */
+export function computeIntrinsicDimension(embeddings) {
+    const n = embeddings.length;
+    if (n < 3)
+        return embeddings[0]?.length ?? 0;
+    const l2sq = (a, b) => {
+        let s = 0;
+        for (let i = 0; i < a.length; i++)
+            s += (a[i] - b[i]) ** 2;
+        return s;
+    };
+    let sumLn = 0;
+    let count = 0;
+    for (let i = 0; i < n; i++) {
+        let d1 = Infinity;
+        let d2 = Infinity;
+        for (let j = 0; j < n; j++) {
+            if (i === j)
+                continue;
+            const d = l2sq(embeddings[i], embeddings[j]);
+            if (d < d1) {
+                d2 = d1;
+                d1 = d;
+            }
+            else if (d < d2) {
+                d2 = d;
+            }
+        }
+        if (d1 > 0 && d2 > 0 && d1 < d2) {
+            sumLn += Math.log(Math.sqrt(d1) / Math.sqrt(d2));
+            count++;
+        }
+    }
+    if (count === 0)
+        return embeddings[0]?.length ?? 0;
+    return -count / sumLn;
+}
+/**
+ * Mean cosine similarity between randomly sampled pairs.
+ * Close to 0 is ideal (well-spread embedding space).
+ */
+export function computeAvgCosineSimRandomPairs(embeddings, sampleSize = 500) {
+    const n = embeddings.length;
+    if (n < 2)
+        return 0;
+    const pairs = Math.min(sampleSize, (n * (n - 1)) / 2);
+    let sum = 0;
+    for (let i = 0; i < pairs; i++) {
+        const a = Math.floor(Math.random() * n);
+        let b = Math.floor(Math.random() * (n - 1));
+        if (b >= a)
+            b++;
+        sum += cosineSimilarity(embeddings[a], embeddings[b]);
+    }
+    return sum / pairs;
+}
+/**
+ * Fraction of embeddings whose L2-norm z-score exceeds 2.5.
+ */
+export function detectOutliers(embeddings) {
+    if (embeddings.length < 2)
+        return 0;
+    const norms = embeddings.map((e) => Math.sqrt(e.reduce((s, v) => s + v * v, 0)));
+    const mean = norms.reduce((s, v) => s + v, 0) / norms.length;
+    const variance = norms.reduce((s, v) => s + (v - mean) ** 2, 0) / norms.length;
+    const std = Math.sqrt(variance);
+    if (std === 0)
+        return 0;
+    const outliers = norms.filter((n) => Math.abs(n - mean) / std > 2.5).length;
+    return outliers / norms.length;
+}
+export async function computeEmbeddingMetrics(embeddings) {
+    return {
+        intrinsicDimension: computeIntrinsicDimension(embeddings),
+        avgCosineSimRandomPairs: computeAvgCosineSimRandomPairs(embeddings),
+        outlierFraction: detectOutliers(embeddings),
+    };
+}
+//# sourceMappingURL=embedding-metrics.js.map

package/dist/embedding-metrics.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export { OpenAICompatibleEmbedder, type OpenAICompatibleEmbedderOptions, } from "./embedder.js";
+export { computeEmbeddingMetrics, cosineSimilarity, computeIntrinsicDimension, computeAvgCosineSimRandomPairs, detectOutliers, } from "./embedding-metrics.js";
+export { OpenAIJudge, type OpenAIJudgeOptions } from "./judge.js";
+export { SemanticCache, type SemanticCacheConfig } from "./semantic-cache.js";
 export { createGitHubModelsEmbedder, createAzureOpenAIEmbedder, createOllamaEmbedder, type GitHubModelsPresetOptions, type AzureOpenAIPresetOptions, type OllamaPresetOptions, } from "./presets.js";
 import type { EmbeddingProvider } from "@vivantel/rag-core";
 /** Factory used by the JSON config loader. */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,8CAA8C;AAC9C,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAyBnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,+BAA+B,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,8BAA8B,EAC9B,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,8CAA8C;AAC9C,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CAyBnB"}

package/dist/index.js

@@ -1,4 +1,7 @@
 export { OpenAICompatibleEmbedder, } from "./embedder.js";
+export { computeEmbeddingMetrics, cosineSimilarity, computeIntrinsicDimension, computeAvgCosineSimRandomPairs, detectOutliers, } from "./embedding-metrics.js";
+export { OpenAIJudge } from "./judge.js";
+export { SemanticCache } from "./semantic-cache.js";
 export { createGitHubModelsEmbedder, createAzureOpenAIEmbedder, createOllamaEmbedder, } from "./presets.js";
 import { OpenAICompatibleEmbedder, } from "./embedder.js";
 /** Factory used by the JSON config loader. */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,GAIrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,wBAAwB,GAEzB,MAAM,eAAe,CAAC;AAEvB,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAC5B,MAA+B;IAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,IAAI,GAAoC;QAC5C,MAAM;QACN,KAAK;QACL,UAAU,EACR,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACvE,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACxE,cAAc,EACZ,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;YACvC,CAAC,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,SAAS;QACf,UAAU,EACR,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KACxE,CAAC;IAEF,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAEzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,yBAAyB,EACzB,8BAA8B,EAC9B,cAAc,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,GAIrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,wBAAwB,GAEzB,MAAM,eAAe,CAAC;AAEvB,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAC5B,MAA+B;IAE/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,IAAI,GAAoC;QAC5C,MAAM;QACN,KAAK;QACL,UAAU,EACR,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACvE,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACxE,cAAc,EACZ,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;YACvC,CAAC,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,SAAS;QACf,UAAU,EACR,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KACxE,CAAC;IAEF,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/judge.d.ts

@@ -0,0 +1,21 @@
+import type { LLMJudge } from "@vivantel/rag-core";
+export interface OpenAIJudgeOptions {
+    apiKey: string;
+    /** Defaults to "gpt-4o-mini" */
+    model?: string;
+    baseURL?: string;
+    maxRetries?: number;
+}
+export declare class OpenAIJudge implements LLMJudge {
+    readonly name: string;
+    private readonly client;
+    private readonly model;
+    constructor(options: OpenAIJudgeOptions);
+    evaluate(query: string, contexts: string[], groundTruth: string): Promise<{
+        faithfulness: number;
+        answerRelevance: number;
+        contextRecall: number;
+    }>;
+    private score;
+}
+//# sourceMappingURL=judge.d.ts.map

package/dist/judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../src/judge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4CD,qBAAa,WAAY,YAAW,QAAQ;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,EAAE,kBAAkB;IAUjC,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;YAWY,KAAK;CAkBpB"}

package/dist/judge.js

@@ -0,0 +1,73 @@
+import OpenAI from "openai";
+// RAGAS-style prompt templates
+// Reference: https://docs.ragas.io/en/stable/concepts/metrics/
+const FAITHFULNESS_PROMPT = (contexts, answer) => `You are evaluating RAG faithfulness. Given the retrieved context and an answer, score from 0.0 to 1.0 how much the answer is grounded in the context (1.0 = fully grounded, 0.0 = completely hallucinated).
+
+CONTEXT:
+${contexts.map((c, i) => `[${i + 1}] ${c}`).join("\n\n")}
+
+ANSWER:
+${answer}
+
+Respond with ONLY a JSON object: {"score": <number>}`;
+const ANSWER_RELEVANCE_PROMPT = (query, answer) => `You are evaluating RAG answer relevance. Given the query and the answer, score from 0.0 to 1.0 how well the answer addresses the question (1.0 = perfectly on-topic, 0.0 = completely irrelevant).
+
+QUERY:
+${query}
+
+ANSWER:
+${answer}
+
+Respond with ONLY a JSON object: {"score": <number>}`;
+const CONTEXT_RECALL_PROMPT = (groundTruth, contexts) => `You are evaluating RAG context recall. Given the expected answer and the retrieved contexts, score from 0.0 to 1.0 how much information from the expected answer is covered by the contexts (1.0 = fully covered, 0.0 = not covered at all).
+
+EXPECTED ANSWER:
+${groundTruth}
+
+RETRIEVED CONTEXTS:
+${contexts.map((c, i) => `[${i + 1}] ${c}`).join("\n\n")}
+
+Respond with ONLY a JSON object: {"score": <number>}`;
+export class OpenAIJudge {
+    name;
+    client;
+    model;
+    constructor(options) {
+        this.model = options.model ?? "gpt-4o-mini";
+        this.name = `openai-judge:${this.model}`;
+        this.client = new OpenAI({
+            apiKey: options.apiKey,
+            baseURL: options.baseURL,
+            maxRetries: options.maxRetries ?? 3,
+        });
+    }
+    async evaluate(query, contexts, groundTruth) {
+        // Use ground truth as the "answer" for faithfulness and relevance evaluation
+        const [faithfulness, answerRelevance, contextRecall] = await Promise.all([
+            this.score(FAITHFULNESS_PROMPT(contexts, groundTruth)),
+            this.score(ANSWER_RELEVANCE_PROMPT(query, groundTruth)),
+            this.score(CONTEXT_RECALL_PROMPT(groundTruth, contexts)),
+        ]);
+        return { faithfulness, answerRelevance, contextRecall };
+    }
+    async score(prompt) {
+        const response = await this.client.chat.completions.create({
+            model: this.model,
+            messages: [{ role: "user", content: prompt }],
+            response_format: { type: "json_object" },
+            temperature: 0,
+        });
+        const content = response.choices[0]?.message?.content ?? "{}";
+        try {
+            const parsed = JSON.parse(content);
+            const score = parsed.score;
+            if (typeof score !== "number")
+                return 0;
+            return Math.max(0, Math.min(1, score));
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=judge.js.map

package/dist/judge.js.map

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

package/dist/semantic-cache.d.ts

@@ -0,0 +1,28 @@
+export interface SemanticCacheConfig {
+    strategy: "exact" | "semantic";
+    /** Cosine similarity threshold for semantic cache hits. Defaults to 0.95. */
+    similarityThreshold?: number;
+    /** Max cache size in MB (in-memory LRU). Defaults to 500. */
+    maxSizeMB?: number;
+    /** Persistence backend. Defaults to "memory". */
+    persistence?: "memory" | "sqlite";
+    /** Path to SQLite database file. Defaults to ".rag-embedding-cache.db". */
+    sqlitePath?: string;
+}
+export declare class SemanticCache {
+    private readonly config;
+    /** In-memory LRU store: key → embedding */
+    private readonly lru;
+    /** Semantic store: [embedding, originalKey][] for cosine comparison */
+    private semantic;
+    private db;
+    private dbReady;
+    constructor(config: SemanticCacheConfig);
+    get(text: string, embed: (t: string) => Promise<number[]>): Promise<number[] | null>;
+    set(text: string, embedding: number[]): Promise<void>;
+    private lruPut;
+    private initDb;
+    private dbGet;
+    private dbSet;
+}
+//# sourceMappingURL=semantic-cache.d.ts.map

package/dist/semantic-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-cache.d.ts","sourceRoot":"","sources":["../src/semantic-cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAClC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA+B;IACnD,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,mBAAmB;IAUjC,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,GACtC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAsCrB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3D,OAAO,CAAC,MAAM;YAcA,MAAM;YA0BN,KAAK;YAcL,KAAK;CAYpB"}

package/dist/semantic-cache.js

@@ -0,0 +1,141 @@
+function cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+/** Simple SHA-256-free hash for exact cache key (djb2). */
+function hashText(text) {
+    let h = 5381;
+    for (let i = 0; i < text.length; i++) {
+        h = ((h << 5) + h) ^ text.charCodeAt(i);
+    }
+    return (h >>> 0).toString(36);
+}
+export class SemanticCache {
+    config;
+    /** In-memory LRU store: key → embedding */
+    lru = new Map();
+    /** Semantic store: [embedding, originalKey][] for cosine comparison */
+    semantic = [];
+    db = null;
+    dbReady = false;
+    constructor(config) {
+        this.config = {
+            strategy: config.strategy,
+            similarityThreshold: config.similarityThreshold ?? 0.95,
+            maxSizeMB: config.maxSizeMB ?? 500,
+            persistence: config.persistence ?? "memory",
+            sqlitePath: config.sqlitePath ?? ".rag-embedding-cache.db",
+        };
+    }
+    async get(text, embed) {
+        const key = hashText(text);
+        // 1. Exact in-memory hit
+        const memHit = this.lru.get(key);
+        if (memHit)
+            return memHit;
+        // 2. SQLite exact hit
+        if (this.config.persistence === "sqlite") {
+            const dbHit = await this.dbGet(key);
+            if (dbHit) {
+                this.lruPut(key, dbHit);
+                return dbHit;
+            }
+        }
+        // 3. Semantic hit (needs query embedding)
+        if (this.config.strategy === "semantic" && this.semantic.length > 0) {
+            const queryEmb = await embed(text);
+            let bestSim = -1;
+            let bestEmb = null;
+            for (const [emb] of this.semantic) {
+                const sim = cosineSimilarity(queryEmb, emb);
+                if (sim > bestSim) {
+                    bestSim = sim;
+                    bestEmb = emb;
+                }
+            }
+            if (bestSim >= this.config.similarityThreshold && bestEmb) {
+                return bestEmb;
+            }
+        }
+        return null;
+    }
+    async set(text, embedding) {
+        const key = hashText(text);
+        this.lruPut(key, embedding);
+        if (this.config.strategy === "semantic") {
+            this.semantic.push([embedding, key]);
+        }
+        if (this.config.persistence === "sqlite") {
+            await this.dbSet(key, embedding);
+        }
+    }
+    lruPut(key, embedding) {
+        // Evict oldest entry if we're over size (rough approximation)
+        const maxEntries = Math.floor((this.config.maxSizeMB * 1024 * 1024) /
+            (embedding.length * 4 + key.length * 2));
+        if (this.lru.size >= maxEntries) {
+            const firstKey = this.lru.keys().next().value;
+            if (firstKey !== undefined)
+                this.lru.delete(firstKey);
+        }
+        this.lru.delete(key); // move to end (LRU update)
+        this.lru.set(key, embedding);
+    }
+    async initDb() {
+        if (this.dbReady)
+            return this.db;
+        try {
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore — better-sqlite3 is an optional peer dependency
+            const { default: Database } = (await import("better-sqlite3"));
+            const db = new Database(this.config.sqlitePath);
+            db.exec(`CREATE TABLE IF NOT EXISTS embeddings (
+           key TEXT PRIMARY KEY,
+           embedding BLOB NOT NULL
+         )`);
+            this.db = db;
+            this.dbReady = true;
+        }
+        catch {
+            console.warn("[rag-embedder-openai] better-sqlite3 not available — cache will use memory only.");
+            this.dbReady = true; // prevent repeated attempts
+        }
+        return this.db;
+    }
+    async dbGet(key) {
+        const db = await this.initDb();
+        if (!db)
+            return null;
+        try {
+            const row = db
+                .prepare("SELECT embedding FROM embeddings WHERE key = ?")
+                .get(key);
+            if (!row)
+                return null;
+            return Array.from(new Float32Array(row.embedding.buffer));
+        }
+        catch {
+            return null;
+        }
+    }
+    async dbSet(key, embedding) {
+        const db = await this.initDb();
+        if (!db)
+            return;
+        try {
+            const buf = Buffer.from(new Float32Array(embedding).buffer);
+            db.prepare("INSERT OR REPLACE INTO embeddings (key, embedding) VALUES (?, ?)").run(key, buf);
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+//# sourceMappingURL=semantic-cache.js.map

package/dist/semantic-cache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivantel/rag-embedder-openai",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "OpenAI-compatible embedding provider for @vivantel/rag-core",
   "type": "module",
   "main": "dist/index.js",
@@ -44,7 +44,7 @@
     "directory": "packages/rag-embedder-openai"
   },
   "dependencies": {
-    "openai": "^4.0.0"
+    "openai": "^6.41.0"
   },
   "peerDependencies": {
     "@vivantel/rag-core": "^2.0.0"
@@ -53,7 +53,7 @@
     "@vivantel/rag-core": "file:../rag-core",
     "@types/node": "^25.9.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=18.0.0"