bikky 0.3.1 → 0.3.3

package/dist/lifecycle.test.js

@@ -0,0 +1,74 @@
+/**
+ * Tests for daemon lifecycle PID-file management.
+ *
+ * Backs up and restores the real PID file at ~/.bikky/state/daemon.pid so
+ * we don't clobber an actual running daemon during the test run.
+ */
+import { describe, it, before, after, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import path from "node:path";
+import { getDaemonStatus, killDaemon } from "./lifecycle.js";
+import { PID_PATH } from "./config.js";
+let backup = null;
+describe("lifecycle (PID file)", () => {
+    before(() => {
+        if (fs.existsSync(PID_PATH)) {
+            backup = fs.readFileSync(PID_PATH, "utf-8");
+        }
+    });
+    after(() => {
+        if (backup !== null) {
+            fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+            fs.writeFileSync(PID_PATH, backup);
+        }
+        else if (fs.existsSync(PID_PATH)) {
+            fs.unlinkSync(PID_PATH);
+        }
+    });
+    beforeEach(() => {
+        if (fs.existsSync(PID_PATH))
+            fs.unlinkSync(PID_PATH);
+    });
+    afterEach(() => {
+        if (fs.existsSync(PID_PATH))
+            fs.unlinkSync(PID_PATH);
+    });
+    it("returns running:false when no PID file exists", () => {
+        const status = getDaemonStatus();
+        assert.deepEqual(status, { running: false, pid: null });
+    });
+    it("returns running:true when PID belongs to a live process", () => {
+        fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+        fs.writeFileSync(PID_PATH, String(process.pid));
+        const status = getDaemonStatus();
+        assert.equal(status.running, true);
+        assert.equal(status.pid, process.pid);
+    });
+    it("returns running:false and cleans up a stale PID file", () => {
+        // PID 999999 is virtually guaranteed not to exist
+        fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+        fs.writeFileSync(PID_PATH, "999999");
+        const status = getDaemonStatus();
+        assert.deepEqual(status, { running: false, pid: null });
+        assert.ok(!fs.existsSync(PID_PATH), "stale PID file should be removed");
+    });
+    it("treats unparseable PID file as 'no daemon'", () => {
+        fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+        fs.writeFileSync(PID_PATH, "not-a-number\n");
+        const status = getDaemonStatus();
+        assert.equal(status.running, false);
+        assert.equal(status.pid, null);
+    });
+    it("killDaemon returns false when no PID file exists", () => {
+        assert.equal(killDaemon(), false);
+    });
+    it("killDaemon removes the PID file even for a stale entry", () => {
+        fs.mkdirSync(path.dirname(PID_PATH), { recursive: true });
+        fs.writeFileSync(PID_PATH, "999999");
+        const result = killDaemon();
+        assert.equal(result, true);
+        assert.ok(!fs.existsSync(PID_PATH));
+    });
+});
+//# sourceMappingURL=lifecycle.test.js.map

package/dist/lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.js","sourceRoot":"","sources":["../src/lifecycle.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,IAAI,MAAM,GAAkB,IAAI,CAAC;AAEjC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,MAAM,CAAC,GAAG,EAAE;QACV,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,GAAG,EAAE;QACT,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhD,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,kDAAkD;QAClD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,kCAAkC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Public embedding API.
+ *
+ * - initEmbedding(cfg)   — resolve provider + defaults, run optional init().
+ * - embed(text)          — compute one embedding via the resolved provider.
+ * - getEmbeddingConfig() — current resolved config (throws if not initialised).
+ * - getEmbeddingDimensions() — convenience accessor used by Qdrant collection setup.
+ *
+ * Provider routing is delegated to the registry — see ./registry.ts and
+ * ./providers/*.ts.
+ *
+ * Errors: providers throw typed `LlmHttpError` subclasses (see `../errors.ts`)
+ * — `LlmAuthError`, `LlmRateLimitError`, `LlmTransientError`, `LlmTimeoutError`,
+ * `LlmBadRequestError`. Dimension mismatches throw
+ * `EmbeddingDimensionMismatchError`. Callers should catch these and convert
+ * to a user-facing message rather than letting them leak through MCP transport.
+ */
+import "./providers/index.js";
+import type { ResolvedEmbeddingConfig } from "./types.js";
+export type { EmbeddingProvider, ResolvedEmbeddingConfig } from "./types.js";
+export { registerEmbeddingProvider, getEmbeddingProvider, listEmbeddingProviders, } from "./registry.js";
+export interface InitEmbeddingInput {
+    provider: string;
+    model?: string;
+    dimensions?: number;
+    baseUrl?: string;
+    apiKey?: string | null;
+    extra?: Record<string, string | undefined>;
+    /** Per-request HTTP timeout. Defaults to 30s. */
+    timeoutMs?: number;
+    /** Max retries on transient/rate-limit/timeout failures. Defaults to 2. */
+    retries?: number;
+    /** Base backoff delay (ms) for retries. Defaults to 250ms. */
+    retryBaseDelayMs?: number;
+}
+export declare function initEmbedding(input: InitEmbeddingInput): ResolvedEmbeddingConfig;
+export declare function getEmbeddingConfig(): ResolvedEmbeddingConfig;
+export declare function getEmbeddingDimensions(): number;
+export declare function embed(text: string): Promise<number[]>;
+/** Test-only: drop cached config so initEmbedding can be called fresh. */
+export declare function _resetEmbedding(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/llm/embedding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAMvB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3C,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAehF;AAED,wBAAgB,kBAAkB,IAAI,uBAAuB,CAG5D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAG/C;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqB3D;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/llm/embedding/index.js

@@ -0,0 +1,78 @@
+/**
+ * Public embedding API.
+ *
+ * - initEmbedding(cfg)   — resolve provider + defaults, run optional init().
+ * - embed(text)          — compute one embedding via the resolved provider.
+ * - getEmbeddingConfig() — current resolved config (throws if not initialised).
+ * - getEmbeddingDimensions() — convenience accessor used by Qdrant collection setup.
+ *
+ * Provider routing is delegated to the registry — see ./registry.ts and
+ * ./providers/*.ts.
+ *
+ * Errors: providers throw typed `LlmHttpError` subclasses (see `../errors.ts`)
+ * — `LlmAuthError`, `LlmRateLimitError`, `LlmTransientError`, `LlmTimeoutError`,
+ * `LlmBadRequestError`. Dimension mismatches throw
+ * `EmbeddingDimensionMismatchError`. Callers should catch these and convert
+ * to a user-facing message rather than letting them leak through MCP transport.
+ */
+// Side-effect: registers every built-in provider before anyone calls us.
+import "./providers/index.js";
+import { getEmbeddingProvider } from "./registry.js";
+import { EmbeddingDimensionMismatchError } from "../errors.js";
+export { registerEmbeddingProvider, getEmbeddingProvider, listEmbeddingProviders, } from "./registry.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_RETRIES = 2;
+const DEFAULT_RETRY_BASE_MS = 250;
+let resolved = null;
+/** Tracks whether we've successfully validated the model's actual dimensions. */
+let dimensionsValidated = false;
+export function initEmbedding(input) {
+    const provider = getEmbeddingProvider(input.provider);
+    resolved = {
+        provider: provider.name,
+        model: input.model ?? provider.defaults.model,
+        dimensions: input.dimensions ?? provider.defaults.dimensions,
+        baseUrl: (input.baseUrl ?? provider.defaults.baseUrl ?? "").replace(/\/+$/, ""),
+        apiKey: input.apiKey ?? null,
+        extra: input.extra ?? {},
+        timeoutMs: input.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        retries: input.retries ?? DEFAULT_RETRIES,
+        retryBaseDelayMs: input.retryBaseDelayMs ?? DEFAULT_RETRY_BASE_MS,
+    };
+    dimensionsValidated = false;
+    return resolved;
+}
+export function getEmbeddingConfig() {
+    if (!resolved)
+        throw new Error("Embedding not initialized — call initEmbedding() first");
+    return resolved;
+}
+export function getEmbeddingDimensions() {
+    if (!resolved)
+        throw new Error("Embedding not initialized — call initEmbedding() first");
+    return resolved.dimensions;
+}
+export async function embed(text) {
+    if (!resolved)
+        throw new Error("Embedding not initialized — call initEmbedding() first");
+    if (!text?.trim())
+        throw new Error("embed() called with empty text");
+    const provider = getEmbeddingProvider(resolved.provider);
+    const vec = await provider.embed(text, resolved);
+    // First-success dimension validation. Catches the classic "config says
+    // 1536 but the model returns 3072" foot-gun before it cascades into a
+    // cryptic Qdrant 400 "vector size mismatch".
+    if (!dimensionsValidated) {
+        if (vec.length !== resolved.dimensions) {
+            throw new EmbeddingDimensionMismatchError(resolved.provider, resolved.model, resolved.dimensions, vec.length);
+        }
+        dimensionsValidated = true;
+    }
+    return vec;
+}
+/** Test-only: drop cached config so initEmbedding can be called fresh. */
+export function _resetEmbedding() {
+    resolved = null;
+    dimensionsValidated = false;
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Tests for the public embedding API.
+ *
+ * Provider request shapes are tested in providers/*.test.ts; this file covers
+ * resolution (defaults, overrides, baseUrl normalisation) and error paths.
+ */
+export {};
+//# sourceMappingURL=index.test.d.ts.map

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

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

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

@@ -0,0 +1,100 @@
+/**
+ * Tests for the public embedding API.
+ *
+ * Provider request shapes are tested in providers/*.test.ts; this file covers
+ * resolution (defaults, overrides, baseUrl normalisation) and error paths.
+ */
+import { describe, it, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import { initEmbedding, getEmbeddingConfig, getEmbeddingDimensions, embed, _resetEmbedding, } from "./index.js";
+describe("initEmbedding — resolution", () => {
+    beforeEach(() => _resetEmbedding());
+    it("applies ollama defaults when no overrides given", async () => {
+        const cfg = await initEmbedding({ provider: "ollama" });
+        assert.strictEqual(cfg.provider, "ollama");
+        assert.strictEqual(cfg.model, "qwen3-embedding:0.6b");
+        assert.strictEqual(cfg.dimensions, 1024);
+        assert.strictEqual(cfg.baseUrl, "http://localhost:11434");
+        assert.strictEqual(cfg.apiKey, null);
+        assert.deepStrictEqual(cfg.extra, {});
+    });
+    it("applies openai defaults", async () => {
+        const cfg = await initEmbedding({ provider: "openai", apiKey: "sk-test" });
+        assert.strictEqual(cfg.model, "text-embedding-3-small");
+        assert.strictEqual(cfg.dimensions, 1536);
+        assert.strictEqual(cfg.baseUrl, "https://api.openai.com");
+        assert.strictEqual(cfg.apiKey, "sk-test");
+    });
+    it("applies bedrock defaults (no baseUrl)", async () => {
+        const cfg = await initEmbedding({ provider: "bedrock" });
+        assert.strictEqual(cfg.model, "amazon.titan-embed-text-v2:0");
+        assert.strictEqual(cfg.dimensions, 1024);
+        assert.strictEqual(cfg.baseUrl, "");
+    });
+    it("applies portkey defaults", async () => {
+        const cfg = await initEmbedding({ provider: "portkey", apiKey: "pk-test" });
+        assert.strictEqual(cfg.model, "@openai/text-embedding-3-small");
+        assert.strictEqual(cfg.baseUrl, "https://api.portkey.ai");
+        assert.strictEqual(cfg.dimensions, 1536);
+    });
+    it("overrides win over defaults", async () => {
+        const cfg = await initEmbedding({
+            provider: "ollama",
+            model: "nomic-embed-text",
+            dimensions: 768,
+            baseUrl: "http://custom:11434",
+        });
+        assert.strictEqual(cfg.model, "nomic-embed-text");
+        assert.strictEqual(cfg.dimensions, 768);
+        assert.strictEqual(cfg.baseUrl, "http://custom:11434");
+    });
+    it("strips trailing slashes from baseUrl", async () => {
+        const cfg = await initEmbedding({
+            provider: "ollama",
+            baseUrl: "http://localhost:11434///",
+        });
+        assert.strictEqual(cfg.baseUrl, "http://localhost:11434");
+    });
+    it("passes extra bag through unchanged", async () => {
+        const cfg = await initEmbedding({
+            provider: "portkey",
+            apiKey: "pk",
+            extra: { virtual_key: "vk-1", config_id: "cfg-2" },
+        });
+        assert.deepStrictEqual(cfg.extra, { virtual_key: "vk-1", config_id: "cfg-2" });
+    });
+    it("throws when provider is unknown", () => {
+        assert.throws(() => initEmbedding({ provider: "nope" }), {
+            message: /Unknown embedding provider: "nope"/,
+        });
+    });
+});
+describe("getEmbeddingConfig / getEmbeddingDimensions", () => {
+    it("throws when not initialised", () => {
+        _resetEmbedding();
+        assert.throws(() => getEmbeddingConfig(), { message: /not initialized/ });
+        assert.throws(() => getEmbeddingDimensions(), { message: /not initialized/ });
+    });
+    it("returns the resolved config / dimensions", async () => {
+        await initEmbedding({ provider: "openai", apiKey: "k", dimensions: 512 });
+        assert.strictEqual(getEmbeddingDimensions(), 512);
+        assert.strictEqual(getEmbeddingConfig().provider, "openai");
+    });
+});
+describe("embed — input validation", () => {
+    beforeEach(async () => {
+        _resetEmbedding();
+        await initEmbedding({ provider: "ollama", baseUrl: "http://localhost:99999" });
+    });
+    it("throws on empty text", async () => {
+        await assert.rejects(() => embed(""), { message: /empty text/ });
+    });
+    it("throws on whitespace-only text", async () => {
+        await assert.rejects(() => embed("   "), { message: /empty text/ });
+    });
+    it("throws when called before init", async () => {
+        _resetEmbedding();
+        await assert.rejects(() => embed("hello"), { message: /not initialized/ });
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * AWS Bedrock embedding provider — Titan Embed V2 via the Bedrock Runtime SDK.
+ *
+ * The @aws-sdk/client-bedrock-runtime package is heavy (~5 MB), so we
+ * dynamic-import it inside init() — users on Ollama/OpenAI/Portkey never pay
+ * the cold-start cost.
+ *
+ * Errors: SDK exceptions are translated into the shared `LlmHttpError`
+ * hierarchy when possible (using `$metadata.httpStatusCode`) so callers can
+ * branch on `err.kind` the same way they do for HTTP-based providers.
+ */
+import type { EmbeddingProvider } from "../types.js";
+export declare const bedrockEmbeddingProvider: EmbeddingProvider;
+/** Test-only: drop the cached SDK so unit tests can re-mock the dynamic import. */
+export declare function _resetBedrockEmbeddingClient(): void;
+//# sourceMappingURL=bedrock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/bedrock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,OAAO,KAAK,EAAE,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AA2D9E,eAAO,MAAM,wBAAwB,EAAE,iBAiCtC,CAAC;AAIF,mFAAmF;AACnF,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

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

@@ -0,0 +1,90 @@
+/**
+ * AWS Bedrock embedding provider — Titan Embed V2 via the Bedrock Runtime SDK.
+ *
+ * The @aws-sdk/client-bedrock-runtime package is heavy (~5 MB), so we
+ * dynamic-import it inside init() — users on Ollama/OpenAI/Portkey never pay
+ * the cold-start cost.
+ *
+ * Errors: SDK exceptions are translated into the shared `LlmHttpError`
+ * hierarchy when possible (using `$metadata.httpStatusCode`) so callers can
+ * branch on `err.kind` the same way they do for HTTP-based providers.
+ */
+import { registerEmbeddingProvider } from "../registry.js";
+import { classifyHttpStatus, LlmAuthError, LlmBadRequestError, LlmRateLimitError, LlmTransientError, LlmUnknownError, } from "../../errors.js";
+let client = null;
+let InvokeModelCommand = null;
+async function ensureSdk(cfg) {
+    if (client && InvokeModelCommand)
+        return;
+    const region = cfg.extra.region ??
+        process.env.AWS_BEDROCK_REGION ??
+        process.env.AWS_REGION ??
+        "us-east-1";
+    const sdk = await import("@aws-sdk/client-bedrock-runtime");
+    // SDK resolves credentials via its default chain (env → shared credentials → SSO → IAM role).
+    client = new sdk.BedrockRuntimeClient({ region });
+    InvokeModelCommand = sdk.InvokeModelCommand;
+}
+function translateSdkError(err, model) {
+    const e = err;
+    const status = e.$metadata?.httpStatusCode;
+    const details = {
+        provider: "bedrock",
+        model,
+        status,
+        body: e.message ?? e.name,
+        cause: err,
+    };
+    if (status === undefined) {
+        return new LlmTransientError(details);
+    }
+    switch (classifyHttpStatus(status)) {
+        case "auth": return new LlmAuthError(details);
+        case "rate_limit": return new LlmRateLimitError(details);
+        case "bad_request": return new LlmBadRequestError(details);
+        case "transient": return new LlmTransientError(details);
+        default: return new LlmUnknownError(details);
+    }
+}
+export const bedrockEmbeddingProvider = {
+    name: "bedrock",
+    label: "AWS Bedrock (Titan Embed)",
+    browserCompatible: false,
+    defaults: {
+        model: "amazon.titan-embed-text-v2:0",
+        dimensions: 1024,
+    },
+    async embed(text, cfg) {
+        await ensureSdk(cfg);
+        const payload = JSON.stringify({
+            inputText: text,
+            dimensions: cfg.dimensions,
+            normalize: true,
+        });
+        const command = new InvokeModelCommand({
+            modelId: cfg.model,
+            contentType: "application/json",
+            accept: "application/json",
+            body: new TextEncoder().encode(payload),
+        });
+        let resp;
+        try {
+            resp = await client.send(command);
+        }
+        catch (e) {
+            throw translateSdkError(e, cfg.model);
+        }
+        const raw = JSON.parse(new TextDecoder().decode(resp.body));
+        if (!raw.embedding) {
+            throw new Error(`Embedding response from bedrock missing data (model: ${cfg.model})`);
+        }
+        return raw.embedding;
+    },
+};
+registerEmbeddingProvider(bedrockEmbeddingProvider);
+/** Test-only: drop the cached SDK so unit tests can re-mock the dynamic import. */
+export function _resetBedrockEmbeddingClient() {
+    client = null;
+    InvokeModelCommand = null;
+}
+//# sourceMappingURL=bedrock.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,24 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { bedrockEmbeddingProvider } from "./bedrock.js";
+describe("bedrock embedding provider — metadata", () => {
+    it("declares the correct name + label", () => {
+        assert.strictEqual(bedrockEmbeddingProvider.name, "bedrock");
+        assert.strictEqual(bedrockEmbeddingProvider.label, "AWS Bedrock (Titan Embed)");
+    });
+    it("is NOT browserCompatible (cannot be called from the UI)", () => {
+        assert.strictEqual(bedrockEmbeddingProvider.browserCompatible, false);
+    });
+    it("defaults to titan-embed-text-v2 with 1024 dimensions and no baseUrl", () => {
+        assert.strictEqual(bedrockEmbeddingProvider.defaults.model, "amazon.titan-embed-text-v2:0");
+        assert.strictEqual(bedrockEmbeddingProvider.defaults.dimensions, 1024);
+        assert.strictEqual(bedrockEmbeddingProvider.defaults.baseUrl, undefined);
+    });
+    it("loads the AWS SDK lazily on first embed() call (not at module load)", () => {
+        // The provider intentionally has no init() hook — the SDK is dynamic-imported
+        // inside embed(). Just verify the provider only exposes embed().
+        assert.strictEqual(typeof bedrockEmbeddingProvider.embed, "function");
+        assert.strictEqual(bedrockEmbeddingProvider.init, undefined);
+    });
+});
+//# sourceMappingURL=bedrock.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bedrock.test.js","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/bedrock.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,QAAQ,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACrD,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,QAAQ,CAAC,KAAK,EAAE,8BAA8B,CAAC,CAAC;QAC5F,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,WAAW,CAAC,wBAAwB,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,8EAA8E;QAC9E,iEAAiE;QACjE,MAAM,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACtE,MAAM,CAAC,WAAW,CAAE,wBAA0D,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Side-effect barrel — importing this file registers every built-in embedding
+ * provider. Adding a new provider? Add a line here and a file alongside.
+ */
+import "./ollama.js";
+import "./openai.js";
+import "./bedrock.js";
+import "./portkey.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,aAAa,CAAC;AACrB,OAAO,aAAa,CAAC;AACrB,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Side-effect barrel — importing this file registers every built-in embedding
+ * provider. Adding a new provider? Add a line here and a file alongside.
+ */
+import "./ollama.js";
+import "./openai.js";
+import "./bedrock.js";
+import "./portkey.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,aAAa,CAAC;AACrB,OAAO,aAAa,CAAC;AACrB,OAAO,cAAc,CAAC;AACtB,OAAO,cAAc,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Ollama embedding provider — local /v1/embeddings (OpenAI-compatible).
+ */
+import type { EmbeddingProvider } from "../types.js";
+export declare const ollamaEmbeddingProvider: EmbeddingProvider;
+//# sourceMappingURL=ollama.d.ts.map

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

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

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

@@ -0,0 +1,39 @@
+/**
+ * Ollama embedding provider — local /v1/embeddings (OpenAI-compatible).
+ */
+import { registerEmbeddingProvider } from "../registry.js";
+import { resilientFetch } from "../../fetch.js";
+const RETRY_CAP_MS = 5_000;
+export const ollamaEmbeddingProvider = {
+    name: "ollama",
+    label: "Ollama (local)",
+    browserCompatible: true,
+    defaults: {
+        model: "qwen3-embedding:0.6b",
+        dimensions: 1024,
+        baseUrl: "http://localhost:11434",
+    },
+    async embed(text, cfg) {
+        const resp = await resilientFetch({
+            url: `${cfg.baseUrl}/v1/embeddings`,
+            init: {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ model: cfg.model, input: text }),
+            },
+            timeoutMs: cfg.timeoutMs,
+            retries: cfg.retries,
+            baseDelayMs: cfg.retryBaseDelayMs,
+            capDelayMs: RETRY_CAP_MS,
+            provider: "ollama",
+            model: cfg.model,
+        });
+        const data = (await resp.json());
+        const first = data.data[0];
+        if (!first)
+            throw new Error(`Embedding response from ollama missing data`);
+        return first.embedding;
+    },
+};
+registerEmbeddingProvider(ollamaEmbeddingProvider);
+//# sourceMappingURL=ollama.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../../src/llm/embedding/providers/ollama.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,gBAAgB;IACvB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE;QACR,KAAK,EAAE,sBAAsB;QAC7B,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,wBAAwB;KAClC;IACD,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,GAA4B;QACpD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC;YAChC,GAAG,EAAE,GAAG,GAAG,CAAC,OAAO,gBAAgB;YACnC,IAAI,EAAE;gBACJ,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,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,CAAyB,CAAC;QACzD,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/ollama.test.d.ts

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

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

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