@vivantel/virage-embedder-openai 0.2.0

package/README.md

@@ -0,0 +1,91 @@
+# @vivantel/virage-embedder-openai
+
+[![npm version](https://img.shields.io/npm/v/@vivantel/virage-embedder-openai.svg)](https://www.npmjs.com/package/@vivantel/virage-embedder-openai)
+
+OpenAI-compatible embedding provider for `@vivantel/virage-core`. Works with OpenAI, Azure OpenAI, GitHub Models, Ollama, LM Studio, and any OpenAI-compatible endpoint.
+
+## Installation
+
+```bash
+npm install @vivantel/virage-embedder-openai
+```
+
+## Usage
+
+### OpenAI
+
+```typescript
+import { OpenAICompatibleEmbedder } from "@vivantel/virage-embedder-openai";
+
+const embedder = new OpenAICompatibleEmbedder({
+  apiKey: process.env.OPENAI_API_KEY!,
+  model: "text-embedding-3-small",
+  dimensions: 1536,
+});
+```
+
+### GitHub Models (preset)
+
+```typescript
+import { createGitHubModelsEmbedder } from "@vivantel/virage-embedder-openai";
+
+const embedder = createGitHubModelsEmbedder({
+  token: process.env.GITHUB_TOKEN!,
+  model: "openai/text-embedding-3-small", // optional, this is the default
+});
+```
+
+### Azure OpenAI (preset)
+
+```typescript
+import { createAzureOpenAIEmbedder } from "@vivantel/virage-embedder-openai";
+
+const embedder = createAzureOpenAIEmbedder({
+  apiKey: process.env.AZURE_OPENAI_KEY!,
+  endpoint: "https://my-resource.openai.azure.com",
+  model: "text-embedding-3-small",
+});
+```
+
+### Ollama (preset)
+
+```typescript
+import { createOllamaEmbedder } from "@vivantel/virage-embedder-openai";
+
+const embedder = createOllamaEmbedder({
+  model: "nomic-embed-text",
+  dimensions: 768,
+  baseURL: "http://localhost:11434", // optional, this is the default
+});
+```
+
+## JSON config
+
+```json
+{
+  "embedder": {
+    "package": "@vivantel/virage-embedder-openai",
+    "config": {
+      "apiKey": "${GITHUB_TOKEN}",
+      "baseURL": "https://models.github.ai/inference",
+      "model": "openai/text-embedding-3-small",
+      "dimensions": 1536
+    }
+  }
+}
+```
+
+## Options
+
+| Option | Type | Required | Description |
+| --- | --- | --- | --- |
+| `apiKey` | `string` | ✓ | API key |
+| `model` | `string` | ✓ | Model identifier |
+| `dimensions` | `number` | — | Output dimensions (default: 1536) |
+| `baseURL` | `string` | — | API base URL (default: OpenAI) |
+| `organizationId` | `string` | — | OpenAI organization ID |
+| `maxRetries` | `number` | — | Retry attempts (default: 3) |
+
+## License
+
+MIT

package/dist/embedder.d.ts

@@ -0,0 +1,32 @@
+import type { EmbeddingProvider, EmbeddingMetrics, Logger } from "@vivantel/virage-core";
+import { type SemanticCacheConfig } from "./semantic-cache.js";
+export interface OpenAICompatibleEmbedderOptions {
+    apiKey: string;
+    model: string;
+    dimensions?: number;
+    /** Defaults to https://api.openai.com/v1 */
+    baseURL?: string;
+    organizationId?: string;
+    maxRetries?: number;
+    /** Optional semantic or exact embedding cache. */
+    cache?: SemanticCacheConfig;
+}
+export declare class OpenAICompatibleEmbedder implements EmbeddingProvider {
+    readonly name: string;
+    readonly dimensions: number;
+    readonly model: string;
+    readonly preferredBatchSize = 100;
+    private readonly client;
+    private readonly cache;
+    private readonly baseURL;
+    private logger;
+    constructor(options: OpenAICompatibleEmbedderOptions);
+    setLogger(logger: Logger): void;
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../src/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,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;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAAuB;gBAEzB,OAAO,EAAE,+BAA+B;IAkBpD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAU9B,WAAW;IAanB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YA8BxC,gBAAgB;IAaxB,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

@@ -0,0 +1,96 @@
+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;
+    baseURL;
+    logger = null;
+    constructor(options) {
+        this.model = options.model;
+        this.dimensions = options.dimensions ?? 1536;
+        this.baseURL = options.baseURL;
+        this.name = options.baseURL
+            ? `openai-compatible:${new URL(options.baseURL).hostname}`
+            : "openai";
+        this.client = new OpenAI({
+            apiKey: options.apiKey,
+            baseURL: options.baseURL,
+            organization: options.organizationId,
+            maxRetries: options.maxRetries ?? 3,
+        });
+        this.cache = options.cache ? new SemanticCache(options.cache) : null;
+    }
+    setLogger(logger) {
+        this.logger = logger.withTag("openai");
+    }
+    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 start = Date.now();
+        const res = await this.client.embeddings.create({
+            model: this.model,
+            input: text,
+            dimensions: this.dimensions !== 1536 ? this.dimensions : undefined,
+        });
+        this.logger?.debug(`Embed call: ${Date.now() - start}ms, ${text.length} chars`);
+        return res.data[0].embedding;
+    }
+    async embedBatch(texts) {
+        this.logger?.verbose(`Batch ${texts.length} texts to ${this.baseURL ?? "https://api.openai.com/v1"}`);
+        this.logger?.trace(`Text lengths: ${texts.map((t) => t.length).join(", ")}`);
+        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 start = Date.now();
+        const res = await this.client.embeddings.create({
+            model: this.model,
+            input: texts,
+            dimensions: this.dimensions !== 1536 ? this.dimensions : undefined,
+        });
+        this.logger?.debug(`Batch call: ${Date.now() - start}ms, ${texts.length} texts`);
+        return res.data.map((d) => d.embedding);
+    }
+    async healthCheck() {
+        try {
+            await this.embed("health check");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getMetrics(embeddings) {
+        return computeEmbeddingMetrics(embeddings);
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/embedder.js.map

@@ -0,0 +1 @@
+{"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/virage-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,uBAAuB,CAAC;AAE9D,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

@@ -0,0 +1,9 @@
+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/virage-core";
+/** Factory used by the JSON config loader. */
+export declare function createEmbedder(config: Record<string, unknown>): EmbeddingProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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,uBAAuB,CAAC;AAM/D,8CAA8C;AAC9C,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,iBAAiB,CA6BnB"}

package/dist/index.js

@@ -0,0 +1,29 @@
+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. */
+export function createEmbedder(config) {
+    const apiKey = config.apiKey;
+    if (typeof apiKey !== "string" || !apiKey) {
+        throw new Error("@vivantel/virage-embedder-openai: config.apiKey is required");
+    }
+    const model = config.model;
+    if (typeof model !== "string" || !model) {
+        throw new Error("@vivantel/virage-embedder-openai: config.model is required");
+    }
+    const opts = {
+        apiKey,
+        model,
+        dimensions: typeof config.dimensions === "number" ? config.dimensions : undefined,
+        baseURL: typeof config.baseURL === "string" ? config.baseURL : undefined,
+        organizationId: typeof config.organizationId === "string"
+            ? config.organizationId
+            : undefined,
+        maxRetries: typeof config.maxRetries === "number" ? config.maxRetries : undefined,
+    };
+    return new OpenAICompatibleEmbedder(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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,CACb,6DAA6D,CAC9D,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,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/virage-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,uBAAuB,CAAC;AAGtD,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/presets.d.ts

@@ -0,0 +1,24 @@
+import { OpenAICompatibleEmbedder } from "./embedder.js";
+export interface GitHubModelsPresetOptions {
+    token: string;
+    model?: string;
+    dimensions?: number;
+}
+export interface AzureOpenAIPresetOptions {
+    apiKey: string;
+    endpoint: string;
+    model?: string;
+    dimensions?: number;
+}
+export interface OllamaPresetOptions {
+    model: string;
+    dimensions: number;
+    baseURL?: string;
+}
+/** Pre-configured embedder for GitHub Models (OpenAI-compatible endpoint). */
+export declare function createGitHubModelsEmbedder(options: GitHubModelsPresetOptions): OpenAICompatibleEmbedder;
+/** Pre-configured embedder for Azure OpenAI. */
+export declare function createAzureOpenAIEmbedder(options: AzureOpenAIPresetOptions): OpenAICompatibleEmbedder;
+/** Pre-configured embedder for a local Ollama server. */
+export declare function createOllamaEmbedder(options: OllamaPresetOptions): OpenAICompatibleEmbedder;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EAEzB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,CAO1B;AAED,gDAAgD;AAChD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAO1B;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,GAC3B,wBAAwB,CAO1B"}

package/dist/presets.js

@@ -0,0 +1,29 @@
+import { OpenAICompatibleEmbedder, } from "./embedder.js";
+/** Pre-configured embedder for GitHub Models (OpenAI-compatible endpoint). */
+export function createGitHubModelsEmbedder(options) {
+    return new OpenAICompatibleEmbedder({
+        apiKey: options.token,
+        baseURL: "https://models.github.ai/inference",
+        model: options.model ?? "openai/text-embedding-3-small",
+        dimensions: options.dimensions ?? 1536,
+    });
+}
+/** Pre-configured embedder for Azure OpenAI. */
+export function createAzureOpenAIEmbedder(options) {
+    return new OpenAICompatibleEmbedder({
+        apiKey: options.apiKey,
+        baseURL: `${options.endpoint.replace(/\/$/, "")}/openai`,
+        model: options.model ?? "text-embedding-3-small",
+        dimensions: options.dimensions ?? 1536,
+    });
+}
+/** Pre-configured embedder for a local Ollama server. */
+export function createOllamaEmbedder(options) {
+    return new OpenAICompatibleEmbedder({
+        apiKey: "ollama",
+        baseURL: (options.baseURL ?? "http://localhost:11434") + "/v1",
+        model: options.model,
+        dimensions: options.dimensions,
+    });
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAEzB,MAAM,eAAe,CAAC;AAqBvB,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B,CACxC,OAAkC;IAElC,OAAO,IAAI,wBAAwB,CAAC;QAClC,MAAM,EAAE,OAAO,CAAC,KAAK;QACrB,OAAO,EAAE,oCAAoC;QAC7C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,+BAA+B;QACvD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACvC,CAAC,CAAC;AACL,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,yBAAyB,CACvC,OAAiC;IAEjC,OAAO,IAAI,wBAAwB,CAAC;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS;QACxD,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,wBAAwB;QAChD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACvC,CAAC,CAAC;AACL,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB,CAClC,OAA4B;IAE5B,OAAO,IAAI,wBAAwB,CAAC;QAClC,MAAM,EAAE,QAAQ;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC,OAAO,IAAI,wBAAwB,CAAC,GAAG,KAAK;QAC9D,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KACI,CAAC,CAAC;AACxC,CAAC"}

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":"AAYA,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,GAAG,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,2DAA2D;AAC3D,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAUD,MAAM,OAAO,aAAa;IACP,MAAM,CAAgC;IACvD,2CAA2C;IAC1B,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACnD,uEAAuE;IAC/D,QAAQ,GAA8B,EAAE,CAAC;IACzC,EAAE,GAAoB,IAAI,CAAC;IAC3B,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,GAAG;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,IAAI;YACvD,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;YAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ;YAC3C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,yBAAyB;SAC3D,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,KAAuC;QAEvC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE3B,yBAAyB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,sBAAsB;QACtB,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;YACjB,IAAI,OAAO,GAAoB,IAAI,CAAC;YAEpC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;gBAC5C,IAAI,GAAG,GAAG,OAAO,EAAE,CAAC;oBAClB,OAAO,GAAG,GAAG,CAAC;oBACd,OAAO,GAAG,GAAG,CAAC;gBAChB,CAAC;YACH,CAAC;YAED,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,IAAI,OAAO,EAAE,CAAC;gBAC1D,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,SAAmB;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAE5B,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,GAAW,EAAE,SAAmB;QAC7C,8DAA8D;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAC3B,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;YACnC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAC1C,CAAC;QACF,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC9C,IAAI,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;QACjD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,6DAA6D;YAC7D,6DAA6D;YAC7D,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAE5D,CAAC;YACF,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChD,EAAE,CAAC,IAAI,CACL;;;WAGG,CACJ,CAAC;YACF,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CACV,kFAAkF,CACnF,CAAC;YACF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,4BAA4B;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,GAAW;QAC7B,MAAM,EAAE,GAAoB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAChD,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CAAC,gDAAgD,CAAC;iBACzD,GAAG,CAAC,GAAG,CAAsC,CAAC;YACjD,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,SAAmB;QAClD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;YAC5D,EAAE,CAAC,OAAO,CACR,kEAAkE,CACnE,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@vivantel/virage-embedder-openai",
+  "version": "0.2.0",
+  "description": "OpenAI-compatible embedding provider for @vivantel/rag-core",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "fix": "npm run lint:fix && npm run format"
+  },
+  "keywords": [
+    "rag",
+    "embeddings",
+    "openai",
+    "azure",
+    "github-models"
+  ],
+  "author": "Vivantel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vivantel/virage",
+    "directory": "packages/virage-embedder-openai"
+  },
+  "dependencies": {
+    "openai": "^6.41.0"
+  },
+  "peerDependencies": {
+    "@vivantel/virage-core": "*"
+  },
+  "devDependencies": {
+    "@vivantel/virage-core": "0.2.0",
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}