@graphorin/embedder-ollama 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @graphorin/embedder-ollama
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release. First-class opt-in alternative to
+  `@graphorin/embedder-transformersjs`. Wraps the local Ollama HTTP
+  API for in-process-friendly embedding via `nomic-embed-text` (default),
+  `mxbai-embed-large`, `snowflake-arctic-embed`, and `bge-m3`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleksiy Stepurenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# @graphorin/embedder-ollama
+
+> First-class opt-in alternative embedder for the Graphorin framework.
+
+`@graphorin/embedder-ollama` wraps the local Ollama HTTP API to produce
+dense embeddings without the bundled-model overhead of
+`@graphorin/embedder-transformersjs`. The package targets four models
+out of the box:
+
+| Model | Dim | Notes |
+|---|---:|---|
+| `nomic-embed-text` (default) | 768 | Multilingual; the de-facto Ollama default. |
+| `mxbai-embed-large` | 1024 | Strong English; competitive with cloud peers. |
+| `snowflake-arctic-embed` | 1024 | Strong English. |
+| `bge-m3` | 1024 | Multilingual; same family also ships via the transformers.js adapter. |
+
+## Install
+
+```bash
+pnpm add @graphorin/embedder-ollama
+```
+
+The package has **no native peers**. It uses the standard `fetch`
+API to talk to a running Ollama instance (default
+`http://127.0.0.1:11434`).
+
+## Quick start
+
+```ts
+import { createOllamaEmbedder } from '@graphorin/embedder-ollama';
+
+const embedder = createOllamaEmbedder({
+  model: 'nomic-embed-text',
+  baseUrl: 'http://127.0.0.1:11434',
+});
+
+const [vec] = await embedder.embed(['Loves espresso.']);
+console.log(embedder.id(), embedder.dim(), vec.length);
+```
+
+## Trust + privacy
+
+The embedder operates against the same `LocalProviderTrust`
+classifier as the Ollama LLM provider adapter (Phase 06). When
+`baseUrl` resolves to a loopback host (`localhost`, `127.0.0.1`,
+`::1`), the trust class is permanent `loopback` and accepts every
+sensitivity tier (`'public'`, `'internal'`, `'secret'`). Remote /
+private-network hosts trigger a one-time WARN per process and the
+runtime caller may pass an explicit `acceptsSensitivity` override.
+
+## Versioning of `embedder_id`
+
+The canonical id includes the Ollama model digest discovered via
+`POST /api/show` at construction time. A model upgrade in the same
+Ollama instance produces a different digest — and therefore a
+different `embedder_id`. The default `lock-on-first` policy in
+`@graphorin/store-sqlite` then fires the same migration path the
+existing `transformersjs` swap takes.
+
+## License
+
+MIT © 2026 Oleksiy Stepurenko.
+
+---
+
+**Project Graphorin** · v0.5.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { EmbedOptions, EmbedderProvider } from "@graphorin/core/contracts";
+
+//#region src/index.d.ts
+
+/** Canonical version constant. Mirrors the `package.json` version. */
+declare const VERSION = "0.5.0";
+/**
+ * Default Ollama base URL. Operators that run Ollama on a non-default
+ * port pass an explicit `baseUrl`.
+ *
+ * @stable
+ */
+declare const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+/**
+ * Default Ollama model. Matches the de-facto choice in the Ollama
+ * community for general-purpose multilingual embeddings.
+ *
+ * @stable
+ */
+declare const DEFAULT_OLLAMA_MODEL = "nomic-embed-text";
+/**
+ * Options accepted by {@link createOllamaEmbedder}.
+ *
+ * @stable
+ */
+interface OllamaEmbedderOptions {
+  /** Default `'nomic-embed-text'`. */
+  readonly model?: string;
+  /** Default `'http://127.0.0.1:11434'`. */
+  readonly baseUrl?: string;
+  /**
+   * Optional dimensionality hint. When known up-front, the canonical
+   * id is stable from the first `embed()` call instead of being
+   * resolved from the response.
+   */
+  readonly dim?: number;
+  /**
+   * Override `fetch`. Used by the test suite to inject a mock HTTP
+   * fixture. Production callers should leave this unset so the
+   * embedder uses the platform's `globalThis.fetch`.
+   */
+  readonly fetchImpl?: typeof fetch;
+  /**
+   * If `true`, skip the `POST /api/show` model-digest probe at
+   * construction. Used in test fixtures where the digest is
+   * pre-populated.
+   */
+  readonly skipDigestProbe?: boolean;
+  /**
+   * Optional pre-resolved digest (e.g. from a probe done elsewhere).
+   * When set, the embedder uses this value instead of issuing a
+   * `POST /api/show` request.
+   */
+  readonly digest?: string;
+  /** Optional API path override (default `'/api/embed'`). */
+  readonly embedPath?: string;
+  /** Optional API path override (default `'/api/embeddings'`). */
+  readonly legacyEmbedPath?: string;
+  /** Optional API path override (default `'/api/show'`). */
+  readonly showPath?: string;
+  /**
+   * Per-request hard timeout in milliseconds. Default `30000`. Each
+   * HTTP call (`/api/show`, `/api/embed`, legacy `/api/embeddings`) is
+   * aborted if the Ollama daemon does not respond in time, so a hung
+   * daemon never stalls the caller. A per-call {@link EmbedOptions.signal}
+   * is combined with this timeout. Set to `0` to disable.
+   */
+  readonly timeoutMs?: number;
+}
+/**
+ * Raised when the Ollama HTTP API returns a non-2xx response.
+ *
+ * @stable
+ */
+declare class OllamaEmbedderError extends Error {
+  readonly statusCode?: number | undefined;
+  readonly name = "OllamaEmbedderError";
+  constructor(message: string, statusCode?: number | undefined, options?: {
+    cause?: unknown;
+  });
+}
+/**
+ * Model -> output-dimension hints used to seed the canonical id before the
+ * first `embed()` resolves the real width from a response. Only single-width
+ * families are listed; size-variant families (e.g. `qwen3-embedding`, whose
+ * dim depends on the `:0.6b` / `:4b` / `:8b` tag) are deliberately omitted so
+ * an ambiguous bind fails loudly rather than baking a wrong width (PS-11).
+ */
+declare const KNOWN_OLLAMA_MODEL_DIMS: ReadonlyMap<string, number>;
+/**
+ * Build an Ollama-backed embedder. The first `embed()` call issues a
+ * `POST /api/show` to capture the model digest; subsequent calls hit
+ * the embedding endpoint directly.
+ *
+ * @stable
+ */
+declare function createOllamaEmbedder(options?: OllamaEmbedderOptions): OllamaEmbedder;
+/**
+ * `EmbedderProvider` implementation that talks to the Ollama HTTP API.
+ *
+ * @stable
+ */
+declare class OllamaEmbedder implements EmbedderProvider {
+  #private;
+  constructor(options: OllamaEmbedderOptions);
+  /** The canonical embedder id — `'ollama:<model>@<dim-or-digest>'`. */
+  id(): string;
+  /**
+   * Output dimension — the explicit `dim` option, the resolved width from the
+   * first `embed()`, or a known-family default. PS-11: throws for an unknown
+   * model with no `dim` hint instead of returning `0` (which the store would
+   * persist and use to create a `float[0]` vec0 table, silently breaking
+   * vector search). Pass `dim` for any model not in {@link
+   * KNOWN_OLLAMA_MODEL_DIMS}, or call `embed()` once first to resolve it.
+   */
+  dim(): number;
+  /**
+   * Deterministic hash over the embedder's full configuration —
+   * including the discovered digest. A model upgrade in the same
+   * Ollama instance changes the digest (and therefore the hash), so
+   * `lock-on-first` correctly fires a migration path instead of
+   * silently reusing the same `embedder_id`.
+   */
+  configHash(): string;
+  embed(texts: ReadonlyArray<string>, opts?: EmbedOptions): Promise<ReadonlyArray<Float32Array>>;
+}
+/**
+ * Canonical-JSON deterministic hash over an embedder configuration.
+ * Object keys are sorted lexicographically so the resulting hash is
+ * stable across `JSON.stringify` reorderings.
+ *
+ * @stable
+ */
+declare function canonicalConfigHash(config: unknown): string;
+//#endregion
+export { DEFAULT_OLLAMA_BASE_URL, DEFAULT_OLLAMA_MODEL, KNOWN_OLLAMA_MODEL_DIMS, OllamaEmbedder, OllamaEmbedderError, OllamaEmbedderOptions, VERSION, canonicalConfigHash, createOllamaEmbedder };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;AAoFA;AAkBa,cA3FA,OAAA,GAsGX,OAAA;AASF;AASA;;;;;AAwFa,cAxMA,uBAAA,GAwMA,wBAAA;;;;AAyJb;;;cAzVa,oBAAA;;;;;;UAOI,qBAAA;;;;;;;;;;;;;;;;8BAgBa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkCjB,mBAAA,SAA4B,KAAA;;;;;;;;;;;;;;cAkB5B,yBAAyB;;;;;;;;iBAoBtB,oBAAA,WAA8B,wBAA6B;;;;;;cAS9D,cAAA,YAA0B;;uBAchB;;;;;;;;;;;;;;;;;;;;eAwEZ,8BACD,eACL,QAAQ,cAAc;;;;;;;;;iBAyJX,mBAAA"}

package/dist/index.js

@@ -0,0 +1,270 @@
+import { createHash } from "node:crypto";
+
+//#region src/index.ts
+/**
+* @graphorin/embedder-ollama — first-class opt-in alternative embedder
+* for the Graphorin framework. Wraps the local Ollama HTTP API.
+*
+* @packageDocumentation
+*/
+/** Canonical version constant. Mirrors the `package.json` version. */
+const VERSION = "0.5.0";
+/**
+* Default Ollama base URL. Operators that run Ollama on a non-default
+* port pass an explicit `baseUrl`.
+*
+* @stable
+*/
+const DEFAULT_OLLAMA_BASE_URL = "http://127.0.0.1:11434";
+/**
+* Default Ollama model. Matches the de-facto choice in the Ollama
+* community for general-purpose multilingual embeddings.
+*
+* @stable
+*/
+const DEFAULT_OLLAMA_MODEL = "nomic-embed-text";
+/**
+* Raised when the Ollama HTTP API returns a non-2xx response.
+*
+* @stable
+*/
+var OllamaEmbedderError = class extends Error {
+	name = "OllamaEmbedderError";
+	constructor(message, statusCode, options) {
+		super(message, options);
+		this.statusCode = statusCode;
+	}
+};
+/**
+* Model -> output-dimension hints used to seed the canonical id before the
+* first `embed()` resolves the real width from a response. Only single-width
+* families are listed; size-variant families (e.g. `qwen3-embedding`, whose
+* dim depends on the `:0.6b` / `:4b` / `:8b` tag) are deliberately omitted so
+* an ambiguous bind fails loudly rather than baking a wrong width (PS-11).
+*/
+const KNOWN_OLLAMA_MODEL_DIMS = new Map([
+	["nomic-embed-text", 768],
+	["mxbai-embed-large", 1024],
+	["snowflake-arctic-embed", 1024],
+	["snowflake-arctic-embed2", 1024],
+	["bge-m3", 1024],
+	["bge-large", 1024],
+	["embeddinggemma", 768],
+	["all-minilm", 384],
+	["granite-embedding", 384],
+	["paraphrase-multilingual", 768]
+]);
+/**
+* Build an Ollama-backed embedder. The first `embed()` call issues a
+* `POST /api/show` to capture the model digest; subsequent calls hit
+* the embedding endpoint directly.
+*
+* @stable
+*/
+function createOllamaEmbedder(options = {}) {
+	return new OllamaEmbedder(options);
+}
+/**
+* `EmbedderProvider` implementation that talks to the Ollama HTTP API.
+*
+* @stable
+*/
+var OllamaEmbedder = class {
+	#model;
+	#baseUrl;
+	#fetchImpl;
+	#skipDigestProbe;
+	#embedPath;
+	#legacyEmbedPath;
+	#showPath;
+	#timeoutMs;
+	#digest;
+	#resolvedDim;
+	#initialized = false;
+	#initializing = null;
+	constructor(options) {
+		this.#model = options.model ?? DEFAULT_OLLAMA_MODEL;
+		this.#baseUrl = stripTrailingSlashesLocal(options.baseUrl ?? DEFAULT_OLLAMA_BASE_URL);
+		this.#fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);
+		this.#skipDigestProbe = options.skipDigestProbe ?? false;
+		this.#embedPath = options.embedPath ?? "/api/embed";
+		this.#legacyEmbedPath = options.legacyEmbedPath ?? "/api/embeddings";
+		this.#showPath = options.showPath ?? "/api/show";
+		this.#timeoutMs = options.timeoutMs ?? 3e4;
+		this.#digest = options.digest ?? null;
+		this.#resolvedDim = options.dim ?? KNOWN_OLLAMA_MODEL_DIMS.get(this.#model) ?? null;
+	}
+	/**
+	* Build the `{ signal }` fetch-init fragment, combining the caller's
+	* abort signal (if any) with the per-request timeout so a hung Ollama
+	* daemon cannot stall the embed call. Returns `{}` when neither
+	* applies. Call once per fetch — each call mints a fresh timeout.
+	*/
+	#signalInit(opts) {
+		const timeoutSignal = this.#timeoutMs > 0 ? AbortSignal.timeout(this.#timeoutMs) : void 0;
+		const signal = opts.signal !== void 0 && timeoutSignal !== void 0 ? AbortSignal.any([opts.signal, timeoutSignal]) : opts.signal ?? timeoutSignal;
+		return signal === void 0 ? {} : { signal };
+	}
+	/** The canonical embedder id — `'ollama:<model>@<dim-or-digest>'`. */
+	id() {
+		const dim = this.dim();
+		const digest = this.#digest !== null ? `:${this.#digest.slice(0, 12)}` : "";
+		return `ollama:${this.#model}@${dim}${digest}`;
+	}
+	/**
+	* Output dimension — the explicit `dim` option, the resolved width from the
+	* first `embed()`, or a known-family default. PS-11: throws for an unknown
+	* model with no `dim` hint instead of returning `0` (which the store would
+	* persist and use to create a `float[0]` vec0 table, silently breaking
+	* vector search). Pass `dim` for any model not in {@link
+	* KNOWN_OLLAMA_MODEL_DIMS}, or call `embed()` once first to resolve it.
+	*/
+	dim() {
+		if (this.#resolvedDim !== null) return this.#resolvedDim;
+		const known = KNOWN_OLLAMA_MODEL_DIMS.get(this.#model);
+		if (known !== void 0) return known;
+		throw new OllamaEmbedderError(`[graphorin/embedder-ollama] unknown output dimension for model '${this.#model}'. Pass \`dim\` to ollamaEmbedder({ model, dim }), or call embed() once to resolve it from a response, before registering the embedder.`);
+	}
+	/**
+	* Deterministic hash over the embedder's full configuration —
+	* including the discovered digest. A model upgrade in the same
+	* Ollama instance changes the digest (and therefore the hash), so
+	* `lock-on-first` correctly fires a migration path instead of
+	* silently reusing the same `embedder_id`.
+	*/
+	configHash() {
+		return canonicalConfigHash({
+			adapter: "ollama",
+			model: this.#model,
+			baseUrl: this.#baseUrl,
+			digest: this.#digest ?? null,
+			dim: this.#resolvedDim ?? null
+		});
+	}
+	async embed(texts, opts = {}) {
+		if (texts.length === 0) return [];
+		await this.#ensureInitialized(opts);
+		return this.#callEmbed(texts, opts);
+	}
+	async #ensureInitialized(opts) {
+		if (this.#initialized) return;
+		if (this.#initializing !== null) return this.#initializing;
+		const inflight = (async () => {
+			try {
+				if (!this.#skipDigestProbe && this.#digest === null) await this.#probeDigest(opts);
+				this.#initialized = true;
+			} finally {
+				this.#initializing = null;
+			}
+		})();
+		this.#initializing = inflight;
+		return inflight;
+	}
+	async #probeDigest(opts) {
+		const url = `${this.#baseUrl}${this.#showPath}`;
+		let resp;
+		try {
+			resp = await this.#fetchImpl(url, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({ name: this.#model }),
+				...this.#signalInit(opts)
+			});
+		} catch (err) {
+			throw new OllamaEmbedderError(`[graphorin/embedder-ollama] failed to reach Ollama at ${url}`, void 0, { cause: err });
+		}
+		if (!resp.ok) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] /api/show returned ${resp.status} for model '${this.#model}'`, resp.status);
+		const json = await resp.json();
+		if (typeof json.digest === "string" && json.digest.length > 0) this.#digest = json.digest;
+	}
+	async #callEmbed(texts, opts) {
+		const batchUrl = `${this.#baseUrl}${this.#embedPath}`;
+		const batchBody = JSON.stringify({
+			model: this.#model,
+			input: [...texts]
+		});
+		let resp;
+		try {
+			resp = await this.#fetchImpl(batchUrl, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: batchBody,
+				...this.#signalInit(opts)
+			});
+		} catch (err) {
+			throw new OllamaEmbedderError(`[graphorin/embedder-ollama] failed to reach Ollama at ${batchUrl}`, void 0, { cause: err });
+		}
+		if (resp.status === 404) return this.#legacyEmbedPerText(texts, opts);
+		if (!resp.ok) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] /api/embed returned ${resp.status}`, resp.status);
+		const list = (await resp.json()).embeddings;
+		if (!Array.isArray(list) || list.length !== texts.length) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] /api/embed response had unexpected shape`);
+		const out = [];
+		for (let i = 0; i < list.length; i++) {
+			const row = list[i];
+			if (!Array.isArray(row)) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] embedding row ${i} is not an array`);
+			const f32 = Float32Array.from(row);
+			if (this.#resolvedDim === null) this.#resolvedDim = f32.length;
+			else if (this.#resolvedDim !== f32.length) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] embedding dim drifted: expected ${this.#resolvedDim}, got ${f32.length}`);
+			out.push(f32);
+		}
+		return out;
+	}
+	async #legacyEmbedPerText(texts, opts) {
+		const url = `${this.#baseUrl}${this.#legacyEmbedPath}`;
+		const out = [];
+		for (const text of texts) {
+			const resp = await this.#fetchImpl(url, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					model: this.#model,
+					prompt: text
+				}),
+				...this.#signalInit(opts)
+			});
+			if (!resp.ok) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] /api/embeddings returned ${resp.status}`, resp.status);
+			const json = await resp.json();
+			if (!Array.isArray(json.embedding)) throw new OllamaEmbedderError(`[graphorin/embedder-ollama] /api/embeddings response has no 'embedding' array`);
+			const f32 = Float32Array.from(json.embedding);
+			if (this.#resolvedDim === null) this.#resolvedDim = f32.length;
+			out.push(f32);
+		}
+		return out;
+	}
+};
+/**
+* Canonical-JSON deterministic hash over an embedder configuration.
+* Object keys are sorted lexicographically so the resulting hash is
+* stable across `JSON.stringify` reorderings.
+*
+* @stable
+*/
+function canonicalConfigHash(config) {
+	return createHash("sha256").update(canonicalize(config), "utf8").digest("hex");
+}
+function canonicalize(value) {
+	if (value === null) return "null";
+	if (typeof value === "boolean") return value ? "true" : "false";
+	if (typeof value === "number") return Number.isFinite(value) ? value.toString() : "null";
+	if (typeof value === "string") return JSON.stringify(value);
+	if (Array.isArray(value)) return `[${value.map(canonicalize).join(",")}]`;
+	if (typeof value === "object") {
+		const obj = value;
+		return `{${Object.keys(obj).sort().map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`).join(",")}}`;
+	}
+	return "null";
+}
+/**
+* Strip every trailing `/` from a URL string in `O(n)`. Kept regex-free
+* so CodeQL does not flag the (otherwise harmless) `/+` anchored
+* quantifier as a polynomial-redos vector.
+*/
+function stripTrailingSlashesLocal(url) {
+	let end = url.length;
+	while (end > 0 && url.charCodeAt(end - 1) === 47) end -= 1;
+	return end === url.length ? url : url.slice(0, end);
+}
+
+//#endregion
+export { DEFAULT_OLLAMA_BASE_URL, DEFAULT_OLLAMA_MODEL, KNOWN_OLLAMA_MODEL_DIMS, OllamaEmbedder, OllamaEmbedderError, VERSION, canonicalConfigHash, createOllamaEmbedder };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["statusCode?: number","KNOWN_OLLAMA_MODEL_DIMS: ReadonlyMap<string, number>","#model","#baseUrl","#fetchImpl","#skipDigestProbe","#embedPath","#legacyEmbedPath","#showPath","#timeoutMs","#digest","#resolvedDim","#ensureInitialized","#callEmbed","#initialized","#initializing","#probeDigest","resp: Response","#signalInit","#legacyEmbedPerText","out: Float32Array[]"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @graphorin/embedder-ollama — first-class opt-in alternative embedder\n * for the Graphorin framework. Wraps the local Ollama HTTP API.\n *\n * @packageDocumentation\n */\n\nimport { createHash } from 'node:crypto';\nimport type { EmbedderProvider, EmbedOptions } from '@graphorin/core/contracts';\n\n/** Canonical version constant. Mirrors the `package.json` version. */\nexport const VERSION = '0.5.0';\n\n/**\n * Default Ollama base URL. Operators that run Ollama on a non-default\n * port pass an explicit `baseUrl`.\n *\n * @stable\n */\nexport const DEFAULT_OLLAMA_BASE_URL = 'http://127.0.0.1:11434';\n\n/**\n * Default Ollama model. Matches the de-facto choice in the Ollama\n * community for general-purpose multilingual embeddings.\n *\n * @stable\n */\nexport const DEFAULT_OLLAMA_MODEL = 'nomic-embed-text';\n\n/**\n * Options accepted by {@link createOllamaEmbedder}.\n *\n * @stable\n */\nexport interface OllamaEmbedderOptions {\n  /** Default `'nomic-embed-text'`. */\n  readonly model?: string;\n  /** Default `'http://127.0.0.1:11434'`. */\n  readonly baseUrl?: string;\n  /**\n   * Optional dimensionality hint. When known up-front, the canonical\n   * id is stable from the first `embed()` call instead of being\n   * resolved from the response.\n   */\n  readonly dim?: number;\n  /**\n   * Override `fetch`. Used by the test suite to inject a mock HTTP\n   * fixture. Production callers should leave this unset so the\n   * embedder uses the platform's `globalThis.fetch`.\n   */\n  readonly fetchImpl?: typeof fetch;\n  /**\n   * If `true`, skip the `POST /api/show` model-digest probe at\n   * construction. Used in test fixtures where the digest is\n   * pre-populated.\n   */\n  readonly skipDigestProbe?: boolean;\n  /**\n   * Optional pre-resolved digest (e.g. from a probe done elsewhere).\n   * When set, the embedder uses this value instead of issuing a\n   * `POST /api/show` request.\n   */\n  readonly digest?: string;\n  /** Optional API path override (default `'/api/embed'`). */\n  readonly embedPath?: string;\n  /** Optional API path override (default `'/api/embeddings'`). */\n  readonly legacyEmbedPath?: string;\n  /** Optional API path override (default `'/api/show'`). */\n  readonly showPath?: string;\n  /**\n   * Per-request hard timeout in milliseconds. Default `30000`. Each\n   * HTTP call (`/api/show`, `/api/embed`, legacy `/api/embeddings`) is\n   * aborted if the Ollama daemon does not respond in time, so a hung\n   * daemon never stalls the caller. A per-call {@link EmbedOptions.signal}\n   * is combined with this timeout. Set to `0` to disable.\n   */\n  readonly timeoutMs?: number;\n}\n\n/**\n * Raised when the Ollama HTTP API returns a non-2xx response.\n *\n * @stable\n */\nexport class OllamaEmbedderError extends Error {\n  override readonly name = 'OllamaEmbedderError';\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    options?: { cause?: unknown },\n  ) {\n    super(message, options);\n  }\n}\n\n/**\n * Model -> output-dimension hints used to seed the canonical id before the\n * first `embed()` resolves the real width from a response. Only single-width\n * families are listed; size-variant families (e.g. `qwen3-embedding`, whose\n * dim depends on the `:0.6b` / `:4b` / `:8b` tag) are deliberately omitted so\n * an ambiguous bind fails loudly rather than baking a wrong width (PS-11).\n */\nexport const KNOWN_OLLAMA_MODEL_DIMS: ReadonlyMap<string, number> = new Map([\n  ['nomic-embed-text', 768],\n  ['mxbai-embed-large', 1024],\n  ['snowflake-arctic-embed', 1024],\n  ['snowflake-arctic-embed2', 1024],\n  ['bge-m3', 1024],\n  ['bge-large', 1024],\n  ['embeddinggemma', 768],\n  ['all-minilm', 384],\n  ['granite-embedding', 384],\n  ['paraphrase-multilingual', 768],\n]);\n\n/**\n * Build an Ollama-backed embedder. The first `embed()` call issues a\n * `POST /api/show` to capture the model digest; subsequent calls hit\n * the embedding endpoint directly.\n *\n * @stable\n */\nexport function createOllamaEmbedder(options: OllamaEmbedderOptions = {}): OllamaEmbedder {\n  return new OllamaEmbedder(options);\n}\n\n/**\n * `EmbedderProvider` implementation that talks to the Ollama HTTP API.\n *\n * @stable\n */\nexport class OllamaEmbedder implements EmbedderProvider {\n  readonly #model: string;\n  readonly #baseUrl: string;\n  readonly #fetchImpl: typeof fetch;\n  readonly #skipDigestProbe: boolean;\n  readonly #embedPath: string;\n  readonly #legacyEmbedPath: string;\n  readonly #showPath: string;\n  readonly #timeoutMs: number;\n  #digest: string | null;\n  #resolvedDim: number | null;\n  #initialized = false;\n  #initializing: Promise<void> | null = null;\n\n  constructor(options: OllamaEmbedderOptions) {\n    this.#model = options.model ?? DEFAULT_OLLAMA_MODEL;\n    this.#baseUrl = stripTrailingSlashesLocal(options.baseUrl ?? DEFAULT_OLLAMA_BASE_URL);\n    this.#fetchImpl = options.fetchImpl ?? globalThis.fetch.bind(globalThis);\n    this.#skipDigestProbe = options.skipDigestProbe ?? false;\n    this.#embedPath = options.embedPath ?? '/api/embed';\n    this.#legacyEmbedPath = options.legacyEmbedPath ?? '/api/embeddings';\n    this.#showPath = options.showPath ?? '/api/show';\n    this.#timeoutMs = options.timeoutMs ?? 30_000;\n    this.#digest = options.digest ?? null;\n    this.#resolvedDim = options.dim ?? KNOWN_OLLAMA_MODEL_DIMS.get(this.#model) ?? null;\n  }\n\n  /**\n   * Build the `{ signal }` fetch-init fragment, combining the caller's\n   * abort signal (if any) with the per-request timeout so a hung Ollama\n   * daemon cannot stall the embed call. Returns `{}` when neither\n   * applies. Call once per fetch — each call mints a fresh timeout.\n   */\n  #signalInit(opts: EmbedOptions): { signal?: AbortSignal } {\n    const timeoutSignal = this.#timeoutMs > 0 ? AbortSignal.timeout(this.#timeoutMs) : undefined;\n    const signal =\n      opts.signal !== undefined && timeoutSignal !== undefined\n        ? AbortSignal.any([opts.signal, timeoutSignal])\n        : (opts.signal ?? timeoutSignal);\n    return signal === undefined ? {} : { signal };\n  }\n\n  /** The canonical embedder id — `'ollama:<model>@<dim-or-digest>'`. */\n  id(): string {\n    const dim = this.dim();\n    const digest = this.#digest !== null ? `:${this.#digest.slice(0, 12)}` : '';\n    return `ollama:${this.#model}@${dim}${digest}`;\n  }\n\n  /**\n   * Output dimension — the explicit `dim` option, the resolved width from the\n   * first `embed()`, or a known-family default. PS-11: throws for an unknown\n   * model with no `dim` hint instead of returning `0` (which the store would\n   * persist and use to create a `float[0]` vec0 table, silently breaking\n   * vector search). Pass `dim` for any model not in {@link\n   * KNOWN_OLLAMA_MODEL_DIMS}, or call `embed()` once first to resolve it.\n   */\n  dim(): number {\n    if (this.#resolvedDim !== null) return this.#resolvedDim;\n    const known = KNOWN_OLLAMA_MODEL_DIMS.get(this.#model);\n    if (known !== undefined) return known;\n    throw new OllamaEmbedderError(\n      `[graphorin/embedder-ollama] unknown output dimension for model '${this.#model}'. ` +\n        'Pass `dim` to ollamaEmbedder({ model, dim }), or call embed() once to resolve it ' +\n        'from a response, before registering the embedder.',\n    );\n  }\n\n  /**\n   * Deterministic hash over the embedder's full configuration —\n   * including the discovered digest. A model upgrade in the same\n   * Ollama instance changes the digest (and therefore the hash), so\n   * `lock-on-first` correctly fires a migration path instead of\n   * silently reusing the same `embedder_id`.\n   */\n  configHash(): string {\n    return canonicalConfigHash({\n      adapter: 'ollama',\n      model: this.#model,\n      baseUrl: this.#baseUrl,\n      digest: this.#digest ?? null,\n      dim: this.#resolvedDim ?? null,\n    });\n  }\n\n  async embed(\n    texts: ReadonlyArray<string>,\n    opts: EmbedOptions = {},\n  ): Promise<ReadonlyArray<Float32Array>> {\n    if (texts.length === 0) return [];\n    await this.#ensureInitialized(opts);\n    return this.#callEmbed(texts, opts);\n  }\n\n  async #ensureInitialized(opts: EmbedOptions): Promise<void> {\n    if (this.#initialized) return;\n    if (this.#initializing !== null) return this.#initializing;\n    const inflight = (async () => {\n      try {\n        if (!this.#skipDigestProbe && this.#digest === null) {\n          await this.#probeDigest(opts);\n        }\n        this.#initialized = true;\n      } finally {\n        // Always clear the in-flight slot so a transient failure does\n        // not poison every subsequent call with the same rejection.\n        this.#initializing = null;\n      }\n    })();\n    this.#initializing = inflight;\n    return inflight;\n  }\n\n  async #probeDigest(opts: EmbedOptions): Promise<void> {\n    const url = `${this.#baseUrl}${this.#showPath}`;\n    let resp: Response;\n    try {\n      resp = await this.#fetchImpl(url, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ name: this.#model }),\n        ...this.#signalInit(opts),\n      });\n    } catch (err) {\n      throw new OllamaEmbedderError(\n        `[graphorin/embedder-ollama] failed to reach Ollama at ${url}`,\n        undefined,\n        { cause: err },\n      );\n    }\n    if (!resp.ok) {\n      throw new OllamaEmbedderError(\n        `[graphorin/embedder-ollama] /api/show returned ${resp.status} for model '${this.#model}'`,\n        resp.status,\n      );\n    }\n    const json = (await resp.json()) as { digest?: string };\n    if (typeof json.digest === 'string' && json.digest.length > 0) {\n      this.#digest = json.digest;\n    }\n  }\n\n  async #callEmbed(\n    texts: ReadonlyArray<string>,\n    opts: EmbedOptions,\n  ): Promise<ReadonlyArray<Float32Array>> {\n    const batchUrl = `${this.#baseUrl}${this.#embedPath}`;\n    const batchBody = JSON.stringify({ model: this.#model, input: [...texts] });\n    let resp: Response;\n    try {\n      resp = await this.#fetchImpl(batchUrl, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: batchBody,\n        ...this.#signalInit(opts),\n      });\n    } catch (err) {\n      throw new OllamaEmbedderError(\n        `[graphorin/embedder-ollama] failed to reach Ollama at ${batchUrl}`,\n        undefined,\n        { cause: err },\n      );\n    }\n    if (resp.status === 404) {\n      // Older Ollama versions only expose the legacy single-input path.\n      return this.#legacyEmbedPerText(texts, opts);\n    }\n    if (!resp.ok) {\n      throw new OllamaEmbedderError(\n        `[graphorin/embedder-ollama] /api/embed returned ${resp.status}`,\n        resp.status,\n      );\n    }\n    const json = (await resp.json()) as { embeddings?: number[][] };\n    const list = json.embeddings;\n    if (!Array.isArray(list) || list.length !== texts.length) {\n      throw new OllamaEmbedderError(\n        `[graphorin/embedder-ollama] /api/embed response had unexpected shape`,\n      );\n    }\n    const out: Float32Array[] = [];\n    for (let i = 0; i < list.length; i++) {\n      const row = list[i];\n      if (!Array.isArray(row)) {\n        throw new OllamaEmbedderError(\n          `[graphorin/embedder-ollama] embedding row ${i} is not an array`,\n        );\n      }\n      const f32 = Float32Array.from(row);\n      if (this.#resolvedDim === null) {\n        this.#resolvedDim = f32.length;\n      } else if (this.#resolvedDim !== f32.length) {\n        throw new OllamaEmbedderError(\n          `[graphorin/embedder-ollama] embedding dim drifted: expected ${this.#resolvedDim}, got ${f32.length}`,\n        );\n      }\n      out.push(f32);\n    }\n    return out;\n  }\n\n  async #legacyEmbedPerText(\n    texts: ReadonlyArray<string>,\n    opts: EmbedOptions,\n  ): Promise<ReadonlyArray<Float32Array>> {\n    const url = `${this.#baseUrl}${this.#legacyEmbedPath}`;\n    const out: Float32Array[] = [];\n    for (const text of texts) {\n      const resp = await this.#fetchImpl(url, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ model: this.#model, prompt: text }),\n        ...this.#signalInit(opts),\n      });\n      if (!resp.ok) {\n        throw new OllamaEmbedderError(\n          `[graphorin/embedder-ollama] /api/embeddings returned ${resp.status}`,\n          resp.status,\n        );\n      }\n      const json = (await resp.json()) as { embedding?: number[] };\n      if (!Array.isArray(json.embedding)) {\n        throw new OllamaEmbedderError(\n          `[graphorin/embedder-ollama] /api/embeddings response has no 'embedding' array`,\n        );\n      }\n      const f32 = Float32Array.from(json.embedding);\n      if (this.#resolvedDim === null) this.#resolvedDim = f32.length;\n      out.push(f32);\n    }\n    return out;\n  }\n}\n\n/**\n * Canonical-JSON deterministic hash over an embedder configuration.\n * Object keys are sorted lexicographically so the resulting hash is\n * stable across `JSON.stringify` reorderings.\n *\n * @stable\n */\nexport function canonicalConfigHash(config: unknown): string {\n  return createHash('sha256').update(canonicalize(config), 'utf8').digest('hex');\n}\n\nfunction canonicalize(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return value ? 'true' : 'false';\n  if (typeof value === 'number') return Number.isFinite(value) ? value.toString() : 'null';\n  if (typeof value === 'string') return JSON.stringify(value);\n  if (Array.isArray(value)) {\n    return `[${value.map(canonicalize).join(',')}]`;\n  }\n  if (typeof value === 'object') {\n    const obj = value as Record<string, unknown>;\n    const keys = Object.keys(obj).sort();\n    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalize(obj[k])}`).join(',')}}`;\n  }\n  return 'null';\n}\n\n/**\n * Strip every trailing `/` from a URL string in `O(n)`. Kept regex-free\n * so CodeQL does not flag the (otherwise harmless) `/+` anchored\n * quantifier as a polynomial-redos vector.\n */\nfunction stripTrailingSlashesLocal(url: string): string {\n  let end = url.length;\n  while (end > 0 && url.charCodeAt(end - 1) === 0x2f) end -= 1;\n  return end === url.length ? url : url.slice(0, end);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@graphorin/embedder-ollama",
+  "version": "0.5.0",
+  "description": "First-class opt-in alternative to @graphorin/embedder-transformersjs for the Graphorin framework. Wraps the local Ollama HTTP API to produce dense embeddings via models such as `nomic-embed-text` (768-dim, multilingual default), `mxbai-embed-large` (1024-dim), `snowflake-arctic-embed` (1024-dim), and `bge-m3` (1024-dim). Implements the `EmbedderProvider` contract with a deterministic configHash that includes the model digest reported by `POST /api/show`, so a model upgrade in the same Ollama instance produces a different embedder_id and the multi-table per-embedder vec0 layout in `@graphorin/store-sqlite` triggers a clean migration path.",
+  "license": "MIT",
+  "author": "Oleksiy Stepurenko",
+  "homepage": "https://github.com/o-stepper/graphorin/tree/main/packages/embedder-ollama",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/o-stepper/graphorin.git",
+    "directory": "packages/embedder-ollama"
+  },
+  "bugs": {
+    "url": "https://github.com/o-stepper/graphorin/issues"
+  },
+  "keywords": [
+    "graphorin",
+    "ai",
+    "agents",
+    "framework",
+    "embeddings",
+    "ollama",
+    "nomic-embed-text",
+    "bge-m3",
+    "local-first"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@graphorin/core": "0.5.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@graphorin/store-sqlite": "0.5.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.tests.json",
+    "test": "vitest run",
+    "lint": "biome check .",
+    "clean": "rimraf dist .turbo *.tsbuildinfo"
+  }
+}