bikky 0.3.1 → 0.3.3

package/dist/llm/embedding/providers/ollama.test.js

@@ -0,0 +1,54 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { ollamaEmbeddingProvider } from "./ollama.js";
+const cfg = {
+    provider: "ollama",
+    model: "qwen3-embedding:0.6b",
+    dimensions: 4,
+    baseUrl: "http://localhost:11434",
+    apiKey: null,
+    extra: {},
+    timeoutMs: 5_000,
+    retries: 0,
+    retryBaseDelayMs: 10,
+};
+describe("ollama embedding provider", () => {
+    const realFetch = globalThis.fetch;
+    beforeEach(() => { globalThis.fetch = realFetch; });
+    afterEach(() => { globalThis.fetch = realFetch; });
+    it("POSTs to /v1/embeddings with model + input, no auth header", async () => {
+        let captured = null;
+        globalThis.fetch = (async (url, init) => {
+            captured = { url, init };
+            return new Response(JSON.stringify({ data: [{ embedding: [1, 2, 3, 4] }] }), { status: 200 });
+        });
+        const out = await ollamaEmbeddingProvider.embed("hello", cfg);
+        assert.deepStrictEqual(out, [1, 2, 3, 4]);
+        assert.ok(captured, "fetch should have been called");
+        const cap = captured;
+        assert.strictEqual(cap.url, "http://localhost:11434/v1/embeddings");
+        assert.strictEqual(cap.init.method, "POST");
+        const headers = cap.init.headers;
+        assert.strictEqual(headers["Content-Type"], "application/json");
+        assert.ok(!("Authorization" in headers), "should not send Authorization header");
+        assert.deepStrictEqual(JSON.parse(cap.init.body), {
+            model: "qwen3-embedding:0.6b", input: "hello",
+        });
+    });
+    it("throws with status + body snippet on non-OK response", async () => {
+        globalThis.fetch = (async () => new Response("model not found", { status: 404 }));
+        await assert.rejects(() => ollamaEmbeddingProvider.embed("hi", cfg), {
+            message: /\[ollama\/qwen3-embedding:0\.6b\] \(404\): model not found/,
+        });
+    });
+    it("throws when response data array is empty", async () => {
+        globalThis.fetch = (async () => new Response(JSON.stringify({ data: [] }), { status: 200 }));
+        await assert.rejects(() => ollamaEmbeddingProvider.embed("hi", cfg), { message: /missing data/ });
+    });
+    it("declares browserCompatible + ollama defaults", () => {
+        assert.strictEqual(ollamaEmbeddingProvider.name, "ollama");
+        assert.strictEqual(ollamaEmbeddingProvider.browserCompatible, true);
+        assert.strictEqual(ollamaEmbeddingProvider.defaults.dimensions, 1024);
+    });
+});
+//# sourceMappingURL=ollama.test.js.map

package/dist/llm/embedding/providers/ollama.test.js.map

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

package/dist/llm/embedding/providers/openai.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OpenAI embedding provider — /v1/embeddings with bearer auth.
+ */
+import type { EmbeddingProvider } from "../types.js";
+export declare const openaiEmbeddingProvider: EmbeddingProvider;
+//# sourceMappingURL=openai.d.ts.map

package/dist/llm/embedding/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/openai.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AAQ9E,eAAO,MAAM,uBAAuB,EAAE,iBAiCrC,CAAC"}

package/dist/llm/embedding/providers/openai.js

@@ -0,0 +1,44 @@
+/**
+ * OpenAI embedding provider — /v1/embeddings with bearer auth.
+ */
+import { registerEmbeddingProvider } from "../registry.js";
+import { resilientFetch } from "../../fetch.js";
+const RETRY_CAP_MS = 5_000;
+export const openaiEmbeddingProvider = {
+    name: "openai",
+    label: "OpenAI",
+    browserCompatible: true,
+    defaults: {
+        model: "text-embedding-3-small",
+        dimensions: 1536,
+        baseUrl: "https://api.openai.com",
+    },
+    async embed(text, cfg) {
+        if (!cfg.apiKey)
+            throw new Error("Embedding failed [openai]: api key not configured");
+        const resp = await resilientFetch({
+            url: `${cfg.baseUrl}/v1/embeddings`,
+            init: {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${cfg.apiKey}`,
+                },
+                body: JSON.stringify({ model: cfg.model, input: text }),
+            },
+            timeoutMs: cfg.timeoutMs,
+            retries: cfg.retries,
+            baseDelayMs: cfg.retryBaseDelayMs,
+            capDelayMs: RETRY_CAP_MS,
+            provider: "openai",
+            model: cfg.model,
+        });
+        const data = (await resp.json());
+        const first = data.data[0];
+        if (!first)
+            throw new Error(`Embedding response from openai missing data`);
+        return first.embedding;
+    },
+};
+registerEmbeddingProvider(openaiEmbeddingProvider);
+//# sourceMappingURL=openai.js.map

package/dist/llm/embedding/providers/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/openai.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOhD,MAAM,YAAY,GAAG,KAAK,CAAC;AAE3B,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACxD,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,QAAQ;IACf,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE;QACR,KAAK,EAAE,wBAAwB;QAC/B,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,wBAAwB;KAClC;IACD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,GAA4B;QACpD,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACtF,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;YAChC,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,gBAAgB;YACnC,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE;iBACtC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACxD;YACD,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,gBAAgB;YACjC,UAAU,EAAE,YAAY;YACxB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAwB,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC3E,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;CACF,CAAC;AAEF,yBAAyB,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/llm/embedding/providers/openai.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openai.test.d.ts.map

package/dist/llm/embedding/providers/openai.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.test.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/openai.test.ts"],"names":[],"mappings":""}

package/dist/llm/embedding/providers/openai.test.js

@@ -0,0 +1,48 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { openaiEmbeddingProvider } from "./openai.js";
+const baseCfg = {
+    provider: "openai",
+    model: "text-embedding-3-small",
+    dimensions: 1536,
+    baseUrl: "https://api.openai.com",
+    apiKey: "sk-test",
+    extra: {},
+    timeoutMs: 5_000,
+    retries: 0,
+    retryBaseDelayMs: 10,
+};
+describe("openai embedding provider", () => {
+    const realFetch = globalThis.fetch;
+    beforeEach(() => { globalThis.fetch = realFetch; });
+    afterEach(() => { globalThis.fetch = realFetch; });
+    it("POSTs to /v1/embeddings with bearer auth", async () => {
+        let captured = null;
+        globalThis.fetch = (async (url, init) => {
+            captured = { url, init };
+            return new Response(JSON.stringify({ data: [{ embedding: [0.1, 0.2] }] }), { status: 200 });
+        });
+        const out = await openaiEmbeddingProvider.embed("hello", baseCfg);
+        assert.deepStrictEqual(out, [0.1, 0.2]);
+        assert.strictEqual(captured.url, "https://api.openai.com/v1/embeddings");
+        const headers = captured.init.headers;
+        assert.strictEqual(headers["Authorization"], "Bearer sk-test");
+    });
+    it("throws when api key is missing", async () => {
+        await assert.rejects(() => openaiEmbeddingProvider.embed("hi", { ...baseCfg, apiKey: null }), {
+            message: /api key not configured/,
+        });
+    });
+    it("surfaces upstream error status + body", async () => {
+        globalThis.fetch = (async () => new Response("invalid_api_key", { status: 401 }));
+        await assert.rejects(() => openaiEmbeddingProvider.embed("hi", baseCfg), {
+            message: /\[openai\/text-embedding-3-small\] \(401\): invalid_api_key/,
+        });
+    });
+    it("declares browserCompatible + openai defaults", () => {
+        assert.strictEqual(openaiEmbeddingProvider.browserCompatible, true);
+        assert.strictEqual(openaiEmbeddingProvider.defaults.model, "text-embedding-3-small");
+        assert.strictEqual(openaiEmbeddingProvider.defaults.dimensions, 1536);
+    });
+});
+//# sourceMappingURL=openai.test.js.map

package/dist/llm/embedding/providers/openai.test.js.map

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

package/dist/llm/embedding/providers/portkey.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Portkey embedding provider — OpenAI-compatible gateway with provider routing.
+ *
+ * Portkey is a unified gateway: one endpoint, many underlying providers, with
+ * routing/fallback/observability handled server-side. Configure the underlying
+ * provider via either:
+ *
+ *   - extra.virtual_key  → server-side credential alias (recommended)
+ *   - extra.config_id    → a saved Portkey config bundle
+ *
+ * Reference: https://portkey.ai/docs/api-reference/embeddings
+ */
+import type { EmbeddingProvider } from "../types.js";
+export declare const portkeyEmbeddingProvider: EmbeddingProvider;
+//# sourceMappingURL=portkey.d.ts.map

package/dist/llm/embedding/providers/portkey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portkey.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/portkey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AAQ9E,eAAO,MAAM,wBAAwB,EAAE,iBAqCtC,CAAC"}

package/dist/llm/embedding/providers/portkey.js

@@ -0,0 +1,58 @@
+/**
+ * Portkey embedding provider — OpenAI-compatible gateway with provider routing.
+ *
+ * Portkey is a unified gateway: one endpoint, many underlying providers, with
+ * routing/fallback/observability handled server-side. Configure the underlying
+ * provider via either:
+ *
+ *   - extra.virtual_key  → server-side credential alias (recommended)
+ *   - extra.config_id    → a saved Portkey config bundle
+ *
+ * Reference: https://portkey.ai/docs/api-reference/embeddings
+ */
+import { registerEmbeddingProvider } from "../registry.js";
+import { resilientFetch } from "../../fetch.js";
+const RETRY_CAP_MS = 5_000;
+export const portkeyEmbeddingProvider = {
+    name: "portkey",
+    label: "Portkey (gateway)",
+    browserCompatible: true,
+    defaults: {
+        model: "@openai/text-embedding-3-small",
+        dimensions: 1536,
+        baseUrl: "https://api.portkey.ai",
+    },
+    async embed(text, cfg) {
+        if (!cfg.apiKey)
+            throw new Error("Embedding failed [portkey]: api key not configured");
+        const headers = {
+            "Content-Type": "application/json",
+            "x-portkey-api-key": cfg.apiKey,
+        };
+        if (cfg.extra.virtual_key)
+            headers["x-portkey-virtual-key"] = cfg.extra.virtual_key;
+        if (cfg.extra.config_id)
+            headers["x-portkey-config"] = cfg.extra.config_id;
+        const resp = await resilientFetch({
+            url: `${cfg.baseUrl}/v1/embeddings`,
+            init: {
+                method: "POST",
+                headers,
+                body: JSON.stringify({ model: cfg.model, input: text }),
+            },
+            timeoutMs: cfg.timeoutMs,
+            retries: cfg.retries,
+            baseDelayMs: cfg.retryBaseDelayMs,
+            capDelayMs: RETRY_CAP_MS,
+            provider: "portkey",
+            model: cfg.model,
+        });
+        const data = (await resp.json());
+        const first = data.data[0];
+        if (!first)
+            throw new Error(`Embedding response from portkey missing data`);
+        return first.embedding;
+    },
+};
+registerEmbeddingProvider(portkeyEmbeddingProvider);
+//# sourceMappingURL=portkey.js.map

package/dist/llm/embedding/providers/portkey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portkey.js","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/portkey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOhD,MAAM,YAAY,GAAG,KAAK,CAAC;AAE3B,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACzD,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,mBAAmB;IAC1B,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE;QACR,KAAK,EAAE,gCAAgC;QACvC,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,wBAAwB;KAClC;IACD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,GAA4B;QACpD,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACvF,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,mBAAmB,EAAE,GAAG,CAAC,MAAM;SAChC,CAAC;QACF,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC;QACpF,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;QAE3E,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;YAChC,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,gBAAgB;YACnC,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;aACxD;YACD,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,gBAAgB;YACjC,UAAU,EAAE,YAAY;YACxB,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAyB,CAAC;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC5E,OAAO,KAAK,CAAC,SAAS,CAAC;IACzB,CAAC;CACF,CAAC;AAEF,yBAAyB,CAAC,wBAAwB,CAAC,CAAC"}

package/dist/llm/embedding/providers/portkey.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=portkey.test.d.ts.map

package/dist/llm/embedding/providers/portkey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portkey.test.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/portkey.test.ts"],"names":[],"mappings":""}

package/dist/llm/embedding/providers/portkey.test.js

@@ -0,0 +1,56 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { portkeyEmbeddingProvider } from "./portkey.js";
+const baseCfg = {
+    provider: "portkey",
+    model: "@openai/text-embedding-3-small",
+    dimensions: 1536,
+    baseUrl: "https://api.portkey.ai",
+    apiKey: "pk-test",
+    extra: {},
+    timeoutMs: 5_000,
+    retries: 0,
+    retryBaseDelayMs: 10,
+};
+describe("portkey embedding provider", () => {
+    const realFetch = globalThis.fetch;
+    beforeEach(() => { globalThis.fetch = realFetch; });
+    afterEach(() => { globalThis.fetch = realFetch; });
+    it("sends x-portkey-api-key + virtual key + config id when present", async () => {
+        let captured = null;
+        globalThis.fetch = (async (_url, init) => {
+            captured = init;
+            return new Response(JSON.stringify({ data: [{ embedding: [9, 9] }] }), { status: 200 });
+        });
+        const out = await portkeyEmbeddingProvider.embed("hi", {
+            ...baseCfg,
+            extra: { virtual_key: "vk-openai", config_id: "cfg-fallback" },
+        });
+        assert.deepStrictEqual(out, [9, 9]);
+        const headers = captured.headers;
+        assert.strictEqual(headers["x-portkey-api-key"], "pk-test");
+        assert.strictEqual(headers["x-portkey-virtual-key"], "vk-openai");
+        assert.strictEqual(headers["x-portkey-config"], "cfg-fallback");
+    });
+    it("omits virtual key + config id when not in extra", async () => {
+        let captured = null;
+        globalThis.fetch = (async (_url, init) => {
+            captured = init;
+            return new Response(JSON.stringify({ data: [{ embedding: [1] }] }), { status: 200 });
+        });
+        await portkeyEmbeddingProvider.embed("hi", baseCfg);
+        const headers = captured.headers;
+        assert.ok(!("x-portkey-virtual-key" in headers));
+        assert.ok(!("x-portkey-config" in headers));
+    });
+    it("throws when api key is missing", async () => {
+        await assert.rejects(() => portkeyEmbeddingProvider.embed("hi", { ...baseCfg, apiKey: null }), {
+            message: /api key not configured/,
+        });
+    });
+    it("declares browserCompatible + portkey defaults", () => {
+        assert.strictEqual(portkeyEmbeddingProvider.browserCompatible, true);
+        assert.strictEqual(portkeyEmbeddingProvider.defaults.baseUrl, "https://api.portkey.ai");
+    });
+});
+//# sourceMappingURL=portkey.test.js.map

package/dist/llm/embedding/providers/portkey.test.js.map

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

package/dist/llm/embedding/registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * In-memory registry of embedding providers.
+ *
+ * Providers self-register from their own files — see ./providers/*.ts.
+ * The registry is populated as a side-effect of importing ./providers/index.js,
+ * which ./index.ts does at module top.
+ */
+import type { EmbeddingProvider } from "./types.js";
+export declare function registerEmbeddingProvider(provider: EmbeddingProvider): void;
+export declare function getEmbeddingProvider(name: string): EmbeddingProvider;
+export declare function listEmbeddingProviders(): EmbeddingProvider[];
+/** Test-only: clear the registry. Not exported from the package barrel. */
+export declare function _resetEmbeddingRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/llm/embedding/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/llm/embedding/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAE3E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAOpE;AAED,wBAAgB,sBAAsB,IAAI,iBAAiB,EAAE,CAE5D;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/llm/embedding/registry.js

@@ -0,0 +1,27 @@
+/**
+ * In-memory registry of embedding providers.
+ *
+ * Providers self-register from their own files — see ./providers/*.ts.
+ * The registry is populated as a side-effect of importing ./providers/index.js,
+ * which ./index.ts does at module top.
+ */
+const providers = new Map();
+export function registerEmbeddingProvider(provider) {
+    providers.set(provider.name, provider);
+}
+export function getEmbeddingProvider(name) {
+    const p = providers.get(name);
+    if (!p) {
+        const known = [...providers.keys()].sort().join(", ") || "(none registered)";
+        throw new Error(`Unknown embedding provider: "${name}". Registered: ${known}`);
+    }
+    return p;
+}
+export function listEmbeddingProviders() {
+    return [...providers.values()];
+}
+/** Test-only: clear the registry. Not exported from the package barrel. */
+export function _resetEmbeddingRegistry() {
+    providers.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/llm/embedding/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/llm/embedding/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEvD,MAAM,UAAU,yBAAyB,CAAC,QAA2B;IACnE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,kBAAkB,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB;IACrC,SAAS,CAAC,KAAK,EAAE,CAAC;AACpB,CAAC"}

package/dist/llm/embedding/registry.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tests for the embedding registry — the dispatch layer.
+ *
+ * Provider-specific behaviour is tested in providers/*.test.ts.
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/llm/embedding/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../../src/llm/embedding/registry.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/llm/embedding/registry.test.js

@@ -0,0 +1,68 @@
+/**
+ * Tests for the embedding registry — the dispatch layer.
+ *
+ * Provider-specific behaviour is tested in providers/*.test.ts.
+ */
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import { registerEmbeddingProvider, getEmbeddingProvider, listEmbeddingProviders, _resetEmbeddingRegistry, } from "./registry.js";
+const fakeProvider = {
+    name: "fake-test",
+    label: "Fake (test)",
+    browserCompatible: true,
+    defaults: { model: "fake-model", dimensions: 4 },
+    async embed() { return [0, 0, 0, 0]; },
+};
+describe("embedding registry", () => {
+    let snapshot;
+    beforeEach(() => {
+        snapshot = listEmbeddingProviders();
+        _resetEmbeddingRegistry();
+    });
+    afterEach(() => {
+        _resetEmbeddingRegistry();
+        for (const p of snapshot)
+            registerEmbeddingProvider(p);
+    });
+    it("registers and retrieves a provider by name", () => {
+        registerEmbeddingProvider(fakeProvider);
+        const got = getEmbeddingProvider("fake-test");
+        assert.strictEqual(got.name, "fake-test");
+        assert.strictEqual(got.defaults.dimensions, 4);
+    });
+    it("throws a helpful error when the provider is unknown", () => {
+        registerEmbeddingProvider(fakeProvider);
+        assert.throws(() => getEmbeddingProvider("nope"), {
+            message: /Unknown embedding provider: "nope"\. Registered: fake-test/,
+        });
+    });
+    it("lists all registered providers", () => {
+        registerEmbeddingProvider(fakeProvider);
+        registerEmbeddingProvider({ ...fakeProvider, name: "fake-2", label: "Fake 2" });
+        const names = listEmbeddingProviders().map((p) => p.name).sort();
+        assert.deepStrictEqual(names, ["fake-2", "fake-test"]);
+    });
+});
+describe("built-in embedding providers (registered via barrel import)", () => {
+    it("registers ollama, openai, bedrock, portkey by importing the index", async () => {
+        // Snapshot before mutating
+        const snap = listEmbeddingProviders();
+        _resetEmbeddingRegistry();
+        try {
+            // Re-import the barrel — providers self-register.
+            // (Cache-busting is unnecessary; the module-level register call ran on first import.)
+            await import("./providers/index.js");
+            const names = listEmbeddingProviders().map((p) => p.name).sort();
+            // bedrock + ollama + openai + portkey
+            for (const expected of ["bedrock", "ollama", "openai", "portkey"]) {
+                assert.ok(names.includes(expected), `expected ${expected} to be registered, got ${names.join(", ")}`);
+            }
+        }
+        finally {
+            _resetEmbeddingRegistry();
+            for (const p of snap)
+                registerEmbeddingProvider(p);
+        }
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/llm/embedding/registry.test.js.map

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

package/dist/llm/embedding/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Embedding provider interface.
+ *
+ * Each embedding backend (Ollama, OpenAI, Bedrock, Portkey, …) lives in its
+ * own file under ./providers/ and self-registers via registerEmbeddingProvider().
+ * Adding a new provider is a single-file change — no edits to dispatchers,
+ * no edits to config types, no edits to UI gates.
+ *
+ * See CONTRIBUTING.md → "Adding a provider" for the recipe.
+ */
+import type { LogFn } from "../types.js";
+export type { LogFn };
+/**
+ * Resolved per-call embedding configuration. Built once by initEmbedding()
+ * from the user's config + the provider's defaults, then passed to embed()
+ * on every call.
+ */
+export interface ResolvedEmbeddingConfig {
+    /** Provider name — matches EmbeddingProvider.name. */
+    provider: string;
+    /** Model identifier. Provider-specific (e.g. "text-embedding-3-small", "@openai/text-embedding-3-small"). */
+    model: string;
+    /** Output vector dimensions. The Qdrant collection is created with this. */
+    dimensions: number;
+    /** HTTP base URL (no trailing slash). Empty for SDK-only providers like Bedrock. */
+    baseUrl: string;
+    /** API key, or null for unauthenticated/SDK providers. */
+    apiKey: string | null;
+    /** Provider-specific bag — region for Bedrock, virtual_key for Portkey, project_id for Vertex, … */
+    extra: Record<string, string | undefined>;
+    /** Per-request timeout in milliseconds (HTTP providers). Defaults set by initEmbedding. */
+    timeoutMs: number;
+    /** Max retries on transient/rate-limit/timeout failures. */
+    retries: number;
+    /** Base backoff delay in milliseconds (full-jitter exponential). */
+    retryBaseDelayMs: number;
+}
+export interface EmbeddingProvider {
+    /** Stable identifier used in config (e.g. "ollama"). Lowercase, no spaces. */
+    readonly name: string;
+    /** Human label for logs and tooling. */
+    readonly label: string;
+    /** Defaults applied when the user picks this provider with no overrides. */
+    readonly defaults: {
+        model: string;
+        dimensions: number;
+        /** Default HTTP base URL. Omit for SDK-only providers. */
+        baseUrl?: string;
+    };
+    /** Whether this provider can be called from a browser (UI uses this to gate semantic search). */
+    readonly browserCompatible: boolean;
+    /** Compute one embedding. Providers that need heavy SDKs should dynamic-import on first call. */
+    embed(text: string, cfg: ResolvedEmbeddingConfig): Promise<number[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/embedding/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/embedding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY,EAAE,KAAK,EAAE,CAAC;AAEtB;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,6GAA6G;IAC7G,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1C,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,0DAA0D;QAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,iGAAiG;IACjG,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,iGAAiG;IACjG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACtE"}

package/dist/llm/embedding/types.js

@@ -0,0 +1,12 @@
+/**
+ * Embedding provider interface.
+ *
+ * Each embedding backend (Ollama, OpenAI, Bedrock, Portkey, …) lives in its
+ * own file under ./providers/ and self-registers via registerEmbeddingProvider().
+ * Adding a new provider is a single-file change — no edits to dispatchers,
+ * no edits to config types, no edits to UI gates.
+ *
+ * See CONTRIBUTING.md → "Adding a provider" for the recipe.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/llm/embedding/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/llm/embedding/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}