@graphorin/embedder-ollama 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @graphorin/embedder-ollama
 
+## 0.6.0
+
+### Patch Changes
+
+- Updated dependencies [[`32f20c1`](https://github.com/o-stepper/graphorin/commit/32f20c110f184f8cef7eec85bf39f5f07c886cb6), [`4f850d9`](https://github.com/o-stepper/graphorin/commit/4f850d9bc0a05d6256c59c5117b010336fcb41d3), [`4f850d9`](https://github.com/o-stepper/graphorin/commit/4f850d9bc0a05d6256c59c5117b010336fcb41d3), [`17a2d30`](https://github.com/o-stepper/graphorin/commit/17a2d30564154ca2ab87473335cdef43a5089c84), [`17a2d30`](https://github.com/o-stepper/graphorin/commit/17a2d30564154ca2ab87473335cdef43a5089c84), [`17a2d30`](https://github.com/o-stepper/graphorin/commit/17a2d30564154ca2ab87473335cdef43a5089c84), [`17a2d30`](https://github.com/o-stepper/graphorin/commit/17a2d30564154ca2ab87473335cdef43a5089c84), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627), [`ce06b47`](https://github.com/o-stepper/graphorin/commit/ce06b472af9e30ac5d0792f7a8b6f42170a94627)]:
+  - @graphorin/core@0.6.0
+
+## 0.5.0
+
+First version published to the npm registry (with Sigstore build
+provenance). The 0.2.0, 0.3.0, and 0.4.0 versions were internal lockstep
+milestones and were never published. All `@graphorin/*` packages release
+lockstep at the same version; the full release notes for 0.2.0-0.5.0 live
+in the repository-level
+[CHANGELOG](https://github.com/o-stepper/graphorin/blob/main/CHANGELOG.md).
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -52,7 +52,7 @@ runtime caller may pass an explicit `acceptsSensitivity` override.
 
 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
+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.
@@ -63,4 +63,4 @@ MIT © 2026 Oleksiy Stepurenko.
 
 ---
 
-**Project Graphorin** · v0.5.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>
+**Project Graphorin** · v0.6.0 · MIT License · © 2026 Oleksiy Stepurenko · <https://github.com/o-stepper/graphorin>

package/dist/index.d.ts

@@ -3,7 +3,7 @@ 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";
+declare const VERSION = "0.6.0";
 /**
  * Default Ollama base URL. Operators that run Ollama on a non-default
  * port pass an explicit `baseUrl`.
@@ -103,10 +103,10 @@ declare function createOllamaEmbedder(options?: OllamaEmbedderOptions): OllamaEm
 declare class OllamaEmbedder implements EmbedderProvider {
   #private;
   constructor(options: OllamaEmbedderOptions);
-  /** The canonical embedder id — `'ollama:<model>@<dim-or-digest>'`. */
+  /** The canonical embedder id - `'ollama:<model>@<dim-or-digest>'`. */
   id(): string;
   /**
-   * Output dimension — the explicit `dim` option, the resolved width from the
+   * 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
@@ -115,7 +115,7 @@ declare class OllamaEmbedder implements EmbedderProvider {
    */
   dim(): number;
   /**
-   * Deterministic hash over the embedder's full configuration —
+   * 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

package/dist/index.js

@@ -2,13 +2,13 @@ import { createHash } from "node:crypto";
 
 //#region src/index.ts
 /**
-* @graphorin/embedder-ollama — first-class opt-in alternative embedder
+* @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";
+const VERSION = "0.6.0";
 /**
 * Default Ollama base URL. Operators that run Ollama on a non-default
 * port pass an explicit `baseUrl`.
@@ -98,21 +98,21 @@ var OllamaEmbedder = class {
 	* 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.
+	* 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>'`. */
+	/** 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
+	* 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
@@ -126,7 +126,7 @@ var OllamaEmbedder = class {
 		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 —
+	* 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

package/dist/index.js.map

@@ -1 +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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"}
+{"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.6.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

@@ -1,6 +1,6 @@
 {
   "name": "@graphorin/embedder-ollama",
-  "version": "0.5.0",
+  "version": "0.6.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",
@@ -45,14 +45,14 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@graphorin/core": "0.5.0"
+    "@graphorin/core": "0.6.0"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "devDependencies": {
-    "@graphorin/store-sqlite": "0.5.0"
+    "@graphorin/store-sqlite": "0.6.0"
   },
   "scripts": {
     "build": "tsdown",