@mneme-ai/embeddings 0.8.3

package/README.md

@@ -0,0 +1,25 @@
+# @mneme-ai/embeddings
+
+Embedding providers for [Mneme](https://github.com/patsa2561-art/mneme-ai). Three implementations of the same `EmbeddingProvider` interface.
+
+```ts
+import { resolveEmbedder } from "@mneme-ai/embeddings";
+
+// Auto: try Ollama → OpenAI → hash fallback
+const embedder = await resolveEmbedder({ provider: "auto" });
+const [vec] = await embedder.embed(["fix Stripe webhook crash on bigint"]);
+```
+
+## Providers
+
+| Provider | Quality | Setup | Cost |
+|---|---|---|---|
+| `OllamaEmbedder` | ★★★★ | `ollama pull nomic-embed-text` | $0 |
+| `OpenAIEmbedder` | ★★★★★ | `OPENAI_API_KEY=…` | ~$0.02/M tokens |
+| `HashEmbedder` | ★★ | nothing | $0 |
+
+The `HashEmbedder` is a deterministic FNV-1a hashing-trick fallback. Useful for tests, CI, and "I want to try mneme without installing anything." Not a substitute for a real embedder in production.
+
+## License
+
+MIT.

package/dist/enrich.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Enricher — LLM access for *generating text* (commit-note synthesis,
+ * incident summaries, future agentic flows).
+ *
+ * Sister contract to EmbeddingProvider but with a different shape:
+ * embedders return vectors, enrichers return strings.
+ *
+ * Both Ollama and OpenAI implementations are local-first compatible:
+ * - Ollama needs `ollama serve` + `ollama pull <model>`. Free.
+ * - OpenAI needs OPENAI_API_KEY. ~$0.10 to enrich a 1k-bad-commit repo.
+ */
+export interface EnrichInput {
+    /** System-style instruction (rules + persona). */
+    system: string;
+    /** User-style request (the actual question/task). */
+    user: string;
+    /** Soft cap on output tokens. */
+    maxTokens?: number;
+    /** Sampling temperature; 0 = deterministic, 0.7 = creative. */
+    temperature?: number;
+}
+export interface EnrichResult {
+    text: string;
+    /** Provider name + model — for provenance tracking. */
+    source: string;
+    /** Input + output token counts when available. */
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+    };
+}
+export interface EnricherProvider {
+    readonly name: string;
+    enrich(input: EnrichInput): Promise<EnrichResult>;
+}
+export interface OllamaEnricherOptions {
+    model?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+export declare class OllamaEnricher implements EnricherProvider {
+    readonly name: string;
+    private readonly baseUrl;
+    private readonly model;
+    private readonly timeoutMs;
+    constructor(opts?: OllamaEnricherOptions);
+    enrich(input: EnrichInput): Promise<EnrichResult>;
+    ping(): Promise<boolean>;
+}
+export interface OpenAIEnricherOptions {
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+}
+export declare class OpenAIEnricher implements EnricherProvider {
+    readonly name: string;
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    constructor(opts: OpenAIEnricherOptions);
+    enrich(input: EnrichInput): Promise<EnrichResult>;
+}
+export interface ResolveEnricherOptions {
+    provider?: "auto" | "ollama" | "openai";
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare function resolveEnricher(opts?: ResolveEnricherOptions): Promise<EnricherProvider>;
+//# sourceMappingURL=enrich.d.ts.map

package/dist/enrich.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../src/enrich.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD;AAID,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,GAAE,qBAA0B;IAOtC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IA0CjD,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B;AAID,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,qBAAa,cAAe,YAAW,gBAAgB;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,IAAI,EAAE,qBAAqB;IAQjC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAwCxD;AAID,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CACnC,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}

package/dist/enrich.js

@@ -0,0 +1,143 @@
+/**
+ * Enricher — LLM access for *generating text* (commit-note synthesis,
+ * incident summaries, future agentic flows).
+ *
+ * Sister contract to EmbeddingProvider but with a different shape:
+ * embedders return vectors, enrichers return strings.
+ *
+ * Both Ollama and OpenAI implementations are local-first compatible:
+ * - Ollama needs `ollama serve` + `ollama pull <model>`. Free.
+ * - OpenAI needs OPENAI_API_KEY. ~$0.10 to enrich a 1k-bad-commit repo.
+ */
+const OLLAMA_DEFAULT_MODEL = "llama3.2:1b";
+const OLLAMA_DEFAULT_URL = "http://localhost:11434";
+export class OllamaEnricher {
+    name;
+    baseUrl;
+    model;
+    timeoutMs;
+    constructor(opts = {}) {
+        this.model = opts.model ?? OLLAMA_DEFAULT_MODEL;
+        this.baseUrl = (opts.baseUrl ?? OLLAMA_DEFAULT_URL).replace(/\/$/, "");
+        this.timeoutMs = opts.timeoutMs ?? 60_000;
+        this.name = `ollama:${this.model}`;
+    }
+    async enrich(input) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/api/chat`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [
+                        { role: "system", content: input.system },
+                        { role: "user", content: input.user },
+                    ],
+                    stream: false,
+                    options: {
+                        temperature: input.temperature ?? 0.2,
+                        num_predict: input.maxTokens ?? 256,
+                    },
+                }),
+                signal: ctrl.signal,
+            });
+            if (!res.ok) {
+                throw new Error(`Ollama enrich failed (${res.status}): ${await res.text()}`);
+            }
+            const json = (await res.json());
+            return {
+                text: json.message?.content?.trim() ?? "",
+                source: this.name,
+                usage: {
+                    promptTokens: json.prompt_eval_count,
+                    completionTokens: json.eval_count,
+                },
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async ping() {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/tags`);
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+const OPENAI_DEFAULT_MODEL = "gpt-4o-mini";
+const OPENAI_DEFAULT_URL = "https://api.openai.com/v1";
+export class OpenAIEnricher {
+    name;
+    apiKey;
+    model;
+    baseUrl;
+    timeoutMs;
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.model = opts.model ?? OPENAI_DEFAULT_MODEL;
+        this.baseUrl = (opts.baseUrl ?? OPENAI_DEFAULT_URL).replace(/\/$/, "");
+        this.timeoutMs = opts.timeoutMs ?? 60_000;
+        this.name = `openai:${this.model}`;
+    }
+    async enrich(input) {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);
+        try {
+            const res = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [
+                        { role: "system", content: input.system },
+                        { role: "user", content: input.user },
+                    ],
+                    temperature: input.temperature ?? 0.2,
+                    max_tokens: input.maxTokens ?? 256,
+                }),
+                signal: ctrl.signal,
+            });
+            if (!res.ok) {
+                throw new Error(`OpenAI enrich failed (${res.status}): ${await res.text()}`);
+            }
+            const json = (await res.json());
+            return {
+                text: json.choices?.[0]?.message?.content?.trim() ?? "",
+                source: this.name,
+                usage: {
+                    promptTokens: json.usage?.prompt_tokens,
+                    completionTokens: json.usage?.completion_tokens,
+                },
+            };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+export async function resolveEnricher(opts = {}) {
+    const provider = opts.provider ?? "auto";
+    if (provider === "ollama" || provider === "auto") {
+        const ollama = new OllamaEnricher({ model: opts.model, baseUrl: opts.baseUrl });
+        if (await ollama.ping())
+            return ollama;
+        if (provider === "ollama") {
+            throw new Error("Ollama not reachable. Start it: ollama serve");
+        }
+    }
+    const apiKey = opts.apiKey ?? process.env["OPENAI_API_KEY"];
+    if ((provider === "openai" || provider === "auto") && apiKey) {
+        return new OpenAIEnricher({ apiKey, model: opts.model, baseUrl: opts.baseUrl });
+    }
+    throw new Error("No enricher available. Install Ollama (recommended) or set OPENAI_API_KEY.");
+}
+//# sourceMappingURL=enrich.js.map

package/dist/enrich.js.map

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

package/dist/hash.d.ts

@@ -0,0 +1,16 @@
+import type { EmbeddingProvider } from "@mneme-ai/core";
+/**
+ * Deterministic hashing-trick embedder. Zero dependencies, zero infrastructure.
+ * Useful for: testing, CI, "I just want to try mneme right now without installing Ollama".
+ *
+ * Quality is much lower than nomic-embed, but the architecture downstream is identical
+ * so users can upgrade by changing one line.
+ */
+export declare class HashEmbedder implements EmbeddingProvider {
+    readonly name = "hash:fnv-256";
+    readonly dimensions: number;
+    constructor(dimensions?: number);
+    embed(texts: string[]): Promise<Float32Array[]>;
+    private embedOne;
+}
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,iBAAiB;IACpD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,SAAM;IAItB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrD,OAAO,CAAC,QAAQ;CAejB"}

package/dist/hash.js

@@ -0,0 +1,50 @@
+/**
+ * Deterministic hashing-trick embedder. Zero dependencies, zero infrastructure.
+ * Useful for: testing, CI, "I just want to try mneme right now without installing Ollama".
+ *
+ * Quality is much lower than nomic-embed, but the architecture downstream is identical
+ * so users can upgrade by changing one line.
+ */
+export class HashEmbedder {
+    name = "hash:fnv-256";
+    dimensions;
+    constructor(dimensions = 256) {
+        this.dimensions = dimensions;
+    }
+    async embed(texts) {
+        return texts.map((t) => this.embedOne(t));
+    }
+    embedOne(text) {
+        const vec = new Float32Array(this.dimensions);
+        const tokens = tokenize(text);
+        for (const tok of tokens) {
+            const h1 = fnv1a(tok) % this.dimensions;
+            const h2 = fnv1a(`#${tok}`) % this.dimensions;
+            vec[h1] += 1;
+            vec[h2] += 0.5;
+        }
+        let n = 0;
+        for (let i = 0; i < vec.length; i++)
+            n += vec[i] * vec[i];
+        const norm = Math.sqrt(n) || 1;
+        for (let i = 0; i < vec.length; i++)
+            vec[i] /= norm;
+        return vec;
+    }
+}
+function tokenize(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9_]+/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 2);
+}
+function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,cAAc,CAAC;IACtB,UAAU,CAAS;IAE5B,YAAY,UAAU,GAAG,GAAG;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YACxC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9C,GAAG,CAAC,EAAE,CAAE,IAAI,CAAC,CAAC;YACd,GAAG,CAAC,EAAE,CAAE,IAAI,GAAG,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAE,IAAI,IAAI,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC;SACL,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,KAAK,CAAC,CAAS;IACtB,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC"}

package/dist/hash.test.d.ts

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

package/dist/hash.test.d.ts.map

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

package/dist/hash.test.js

@@ -0,0 +1,43 @@
+import { describe, it, expect } from "vitest";
+import { HashEmbedder } from "./hash.js";
+describe("HashEmbedder", () => {
+    const embedder = new HashEmbedder(64);
+    it("produces vectors of the configured dimension", async () => {
+        const [v] = await embedder.embed(["hello world"]);
+        expect(v).toBeInstanceOf(Float32Array);
+        expect(v.length).toBe(64);
+    });
+    it("is deterministic — same input → same output", async () => {
+        const [a] = await embedder.embed(["fix stripe webhook"]);
+        const [b] = await embedder.embed(["fix stripe webhook"]);
+        expect(Array.from(a)).toEqual(Array.from(b));
+    });
+    it("normalizes vectors to unit length", async () => {
+        const [v] = await embedder.embed(["arbitrary text content"]);
+        let norm = 0;
+        for (let i = 0; i < v.length; i++)
+            norm += v[i] * v[i];
+        expect(Math.sqrt(norm)).toBeCloseTo(1, 5);
+    });
+    it("handles empty input gracefully", async () => {
+        const [v] = await embedder.embed([""]);
+        expect(v).toBeInstanceOf(Float32Array);
+    });
+    it("similar inputs are more similar than dissimilar", async () => {
+        const big = new HashEmbedder(512);
+        const [a] = await big.embed(["fix stripe webhook crash on bigint amount"]);
+        const [b] = await big.embed(["fix stripe webhook bug for bigint"]);
+        const [c] = await big.embed(["unrelated documentation update for readme"]);
+        const sim = (x, y) => {
+            let d = 0;
+            for (let i = 0; i < x.length; i++)
+                d += x[i] * y[i];
+            return d;
+        };
+        expect(sim(a, b)).toBeGreaterThan(sim(a, c));
+    });
+    it("reports a stable name", () => {
+        expect(embedder.name).toBe("hash:fnv-256");
+    });
+});
+//# sourceMappingURL=hash.test.js.map

package/dist/hash.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./ollama.js";
+export * from "./openai.js";
+export * from "./hash.js";
+export * from "./resolve.js";
+export * from "./enrich.js";
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./ollama.js";
+export * from "./openai.js";
+export * from "./hash.js";
+export * from "./resolve.js";
+export * from "./enrich.js";
+//# 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,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/ollama.d.ts

@@ -0,0 +1,16 @@
+import type { EmbeddingProvider } from "@mneme-ai/core";
+export interface OllamaOptions {
+    model?: string;
+    baseUrl?: string;
+    dimensions?: number;
+}
+export declare class OllamaEmbedder implements EmbeddingProvider {
+    readonly name: string;
+    readonly dimensions: number;
+    private readonly baseUrl;
+    private readonly model;
+    constructor(opts?: OllamaOptions);
+    embed(texts: string[]): Promise<Float32Array[]>;
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=ollama.d.ts.map

package/dist/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../src/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,IAAI,GAAE,aAAkB;IAO9B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkB/C,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B"}

package/dist/ollama.js

@@ -0,0 +1,43 @@
+const DEFAULT_MODEL = "nomic-embed-text";
+const DEFAULT_DIMS = 768;
+const DEFAULT_URL = "http://localhost:11434";
+export class OllamaEmbedder {
+    name;
+    dimensions;
+    baseUrl;
+    model;
+    constructor(opts = {}) {
+        this.model = opts.model ?? DEFAULT_MODEL;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_URL).replace(/\/$/, "");
+        this.dimensions = opts.dimensions ?? DEFAULT_DIMS;
+        this.name = `ollama:${this.model}`;
+    }
+    async embed(texts) {
+        const out = [];
+        for (const text of texts) {
+            const res = await fetch(`${this.baseUrl}/api/embeddings`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ model: this.model, prompt: text }),
+            });
+            if (!res.ok) {
+                throw new Error(`Ollama embed failed (${res.status}): ${await res.text()}`);
+            }
+            const json = (await res.json());
+            if (!json.embedding)
+                throw new Error("Ollama returned no embedding");
+            out.push(Float32Array.from(json.embedding));
+        }
+        return out;
+    }
+    async ping() {
+        try {
+            const res = await fetch(`${this.baseUrl}/api/tags`);
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=ollama.js.map

package/dist/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../src/ollama.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,kBAAkB,CAAC;AACzC,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,WAAW,GAAG,wBAAwB,CAAC;AAE7C,MAAM,OAAO,cAAc;IAChB,IAAI,CAAS;IACb,UAAU,CAAS;IACX,OAAO,CAAS;IAChB,KAAK,CAAS;IAE/B,YAAY,OAAsB,EAAE;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,iBAAiB,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;aAC1D,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC9E,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACrE,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,WAAW,CAAC,CAAC;YACpD,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/openai.d.ts

@@ -0,0 +1,17 @@
+import type { EmbeddingProvider } from "@mneme-ai/core";
+export interface OpenAIOptions {
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+    dimensions?: number;
+}
+export declare class OpenAIEmbedder implements EmbeddingProvider {
+    readonly name: string;
+    readonly dimensions: number;
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(opts: OpenAIOptions);
+    embed(texts: string[]): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,cAAe,YAAW,iBAAiB;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,IAAI,EAAE,aAAa;IAQzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAmBtD"}

package/dist/openai.js

@@ -0,0 +1,36 @@
+const DEFAULT_MODEL = "text-embedding-3-small";
+const DEFAULT_DIMS = 1536;
+const DEFAULT_URL = "https://api.openai.com/v1";
+export class OpenAIEmbedder {
+    name;
+    dimensions;
+    apiKey;
+    model;
+    baseUrl;
+    constructor(opts) {
+        this.apiKey = opts.apiKey;
+        this.model = opts.model ?? DEFAULT_MODEL;
+        this.baseUrl = (opts.baseUrl ?? DEFAULT_URL).replace(/\/$/, "");
+        this.dimensions = opts.dimensions ?? DEFAULT_DIMS;
+        this.name = `openai:${this.model}`;
+    }
+    async embed(texts) {
+        if (!texts.length)
+            return [];
+        const res = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({ model: this.model, input: texts }),
+        });
+        if (!res.ok) {
+            throw new Error(`OpenAI embed failed (${res.status}): ${await res.text()}`);
+        }
+        const json = (await res.json());
+        json.data.sort((a, b) => a.index - b.index);
+        return json.data.map((d) => Float32Array.from(d.embedding));
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../src/openai.ts"],"names":[],"mappings":"AASA,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAC/C,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,WAAW,GAAG,2BAA2B,CAAC;AAEhD,MAAM,OAAO,cAAc;IAChB,IAAI,CAAS;IACb,UAAU,CAAS;IACX,MAAM,CAAS;IACf,KAAK,CAAS;IACd,OAAO,CAAS;IAEjC,YAAY,IAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;QACzC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,YAAY,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAe;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SAC1D,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/resolve.d.ts

@@ -0,0 +1,15 @@
+import type { EmbeddingProvider } from "@mneme-ai/core";
+export interface ResolveOptions {
+    provider?: "auto" | "ollama" | "openai" | "hash";
+    model?: string;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Auto-select an embedder.
+ *
+ *   auto: prefer Ollama → OpenAI (if key) → hash fallback
+ *   ollama / openai / hash: explicit
+ */
+export declare function resolveEmbedder(opts?: ResolveOptions): Promise<EmbeddingProvider>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuB3F"}

package/dist/resolve.js

@@ -0,0 +1,29 @@
+import { OllamaEmbedder } from "./ollama.js";
+import { OpenAIEmbedder } from "./openai.js";
+import { HashEmbedder } from "./hash.js";
+/**
+ * Auto-select an embedder.
+ *
+ *   auto: prefer Ollama → OpenAI (if key) → hash fallback
+ *   ollama / openai / hash: explicit
+ */
+export async function resolveEmbedder(opts = {}) {
+    const provider = opts.provider ?? "auto";
+    if (provider === "ollama" || provider === "auto") {
+        const ollama = new OllamaEmbedder({ model: opts.model, baseUrl: opts.baseUrl });
+        if (await ollama.ping())
+            return ollama;
+        if (provider === "ollama") {
+            throw new Error(`Ollama not reachable at ${opts.baseUrl ?? "http://localhost:11434"}. Start it with: ollama serve`);
+        }
+    }
+    const apiKey = opts.apiKey ?? process.env["OPENAI_API_KEY"];
+    if ((provider === "openai" || provider === "auto") && apiKey) {
+        return new OpenAIEmbedder({ apiKey, model: opts.model, baseUrl: opts.baseUrl });
+    }
+    if (provider === "openai") {
+        throw new Error("No OpenAI API key. Set OPENAI_API_KEY or pass --api-key.");
+    }
+    return new HashEmbedder();
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AASzC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAuB,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC;IAEzC,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAChF,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO,MAAM,CAAC;QACvC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,OAAO,IAAI,wBAAwB,+BAA+B,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QAC7D,OAAO,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@mneme-ai/embeddings",
+  "version": "0.8.3",
+  "description": "Embedding providers (Ollama, OpenAI, hash-fallback) for Mneme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/patsa2561-art/mneme-ai.git",
+    "directory": "packages/embeddings"
+  },
+  "homepage": "https://github.com/patsa2561-art/mneme-ai#readme",
+  "bugs": {
+    "url": "https://github.com/patsa2561-art/mneme-ai/issues"
+  },
+  "license": "MIT",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@mneme-ai/core": "0.8.3"
+  }
+}