dsh-library 0.1.4 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-08-26
+
+### Added
+
+- Embedder provider seam with an optional local Ollama backend.
+
 ## [0.1.4] - 2026-08-23
 
 ### Fixed

package/README.es.md

@@ -88,7 +88,9 @@ Todos los ajustes son campos `Config` de Schemastery (modificables desde cordis.
 | `chunkOverlap` | `120` | Solapamiento entre ventanas; debe ser menor que `chunkSize` |
 | `maxFileBytes` | `5242880` | Archivos mayores se rechazan en `library_add` |
 | `embedding.dims` | `256` | Dimensionalidad del hash embedding (≥ 8) |
-| `embedding.command` | `''` | Comando de embedder externo opcional (argv separado por espacios, sin shell) sobre `ctx.subprocess`; `''` = embedder hash integrado |
+| `embedding.provider` | `hash` | Backend del embedder: `hash` (integrado, cero descargas), `command` (subproceso externo, requiere `embedding.command`), `ollama` (Ollama local, probado y degradado a `hash` si es inalcanzable) |
+| `embedding.command` | `''` | Comando de embedder externo opcional (argv separado por espacios, sin shell) sobre `ctx.subprocess`; configurarlo selecciona el backend `command` |
+| `embedding.ollamaUrl` / `ollamaModel` | `http://127.0.0.1:11434` / `nomic-embed-text` | Endpoint y modelo de Ollama local para el backend `ollama` (cero nube) |
 | `embedding.timeoutMs` / `graceMs` / `maxOutputBytes` / `maxBatchItems` | `30000` / `1000` / `1048576` / `64` | Presupuesto del subproceso del embedder |
 | `search.topK` | `8` | Resultados devueltos tras el pipeline completo |
 | `search.hybridWeight` | `0.6` | 0 = solo palabras clave, 1 = solo semántica |

package/README.hi.md

@@ -88,7 +88,9 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-library'
 | `chunkOverlap` | `120` | लगातार विंडो के बीच ओवरलैप; `chunkSize` से छोटा होना चाहिए |
 | `maxFileBytes` | `5242880` | इससे बड़ी फ़ाइलें `library_add` पर अस्वीकार होती हैं |
 | `embedding.dims` | `256` | हैश-एम्बेडिंग आयाम (≥ 8) |
-| `embedding.command` | `''` | वैकल्पिक बाहरी एम्बेडर कमांड (स्पेस-सेपरेटेड argv, कोई शेल नहीं) `ctx.subprocess` से; `''` = अंतर्निहित हैश एम्बेडर |
+| `embedding.provider` | `hash` | एम्बेडर बैकएंड: `hash` (अंतर्निहित, शून्य डाउनलोड), `command` (बाहरी उपप्रक्रिया, `embedding.command` आवश्यक), `ollama` (स्थानीय Ollama, अनुपलब्ध होने पर `hash` में डिग्रेड) |
+| `embedding.command` | `''` | वैकल्पिक बाहरी एम्बेडर कमांड (स्पेस-सेपरेटेड argv, कोई शेल नहीं) `ctx.subprocess` से; सेट करने पर `command` बैकएंड चयनित होता है |
+| `embedding.ollamaUrl` / `ollamaModel` | `http://127.0.0.1:11434` / `nomic-embed-text` | `ollama` बैकएंड के लिए स्थानीय Ollama एंडपॉइंट व मॉडल (शून्य क्लाउड) |
 | `embedding.timeoutMs` / `graceMs` / `maxOutputBytes` / `maxBatchItems` | `30000` / `1000` / `1048576` / `64` | एम्बेडर उपप्रक्रिया बजट |
 | `search.topK` | `8` | पूरी पाइपलाइन के बाद लौटे परिणाम |
 | `search.hybridWeight` | `0.6` | 0 = केवल कीवर्ड, 1 = केवल सिमेंटिक |

package/README.md

@@ -89,7 +89,9 @@ All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id
 | `chunkOverlap` | `120` | Overlap between consecutive windows; must be smaller than `chunkSize` |
 | `maxFileBytes` | `5242880` | Files larger than this are rejected on `library_add` |
 | `embedding.dims` | `256` | Hash-embedding dimensionality (≥ 8) |
-| `embedding.command` | `''` | Optional external embedder command (space-separated argv, no shell) over `ctx.subprocess`; `''` = built-in hash embedder |
+| `embedding.provider` | `hash` | Embedder backend: `hash` (built-in, zero downloads), `command` (external subprocess, requires `embedding.command`), or `ollama` (local Ollama, probed and degraded to `hash` when unreachable) |
+| `embedding.command` | `''` | Optional external embedder command (space-separated argv, no shell) over `ctx.subprocess`; setting it selects the `command` provider |
+| `embedding.ollamaUrl` / `ollamaModel` | `http://127.0.0.1:11434` / `nomic-embed-text` | Local Ollama endpoint + model for the `ollama` provider (zero cloud) |
 | `embedding.timeoutMs` / `graceMs` / `maxOutputBytes` / `maxBatchItems` | `30000` / `1000` / `1048576` / `64` | Embedder subprocess budget |
 | `search.topK` | `8` | Results returned after the full pipeline |
 | `search.hybridWeight` | `0.6` | 0 = keyword-only, 1 = semantic-only |
@@ -129,7 +131,7 @@ All tunables are Schemastery `Config` fields (changeable from cordis.yml). An id
 
 ## Known limitations
 
-- **Lexical-grade embeddings.** The built-in hash embedder scores surface similarity, not meaning; retrieval quality on paraphrases is lower than a real embedding model — configure `embedding.command` for stronger semantics.
+- **Lexical-grade embeddings.** The built-in hash embedder scores surface similarity, not meaning; retrieval quality on paraphrases is lower than a real embedding model — configure `embedding.command` (any subprocess embedder) or `embedding.provider: ollama` (a local Ollama embedding model) for stronger semantics.
 - **Local citation model.** `library_cite_check` validates against the search result page (the `[n]` numbering), not against free-form source names; the fuzzy score is a bounded token-sequence partial ratio.
 - **No ingestion pipeline.** Documents must be imported by path (`md`/`txt`); PDF/docx extraction is out of scope for v0.1.0.
 

package/README.pt.md

@@ -88,7 +88,9 @@ Todos os ajustes são campos `Config` do Schemastery (alteráveis pelo cordis.ym
 | `chunkOverlap` | `120` | Sobreposição entre janelas; deve ser menor que `chunkSize` |
 | `maxFileBytes` | `5242880` | Arquivos maiores são rejeitados no `library_add` |
 | `embedding.dims` | `256` | Dimensionalidade do hash embedding (≥ 8) |
-| `embedding.command` | `''` | Comando de embedder externo opcional (argv separado por espaços, sem shell) via `ctx.subprocess`; `''` = embedder hash integrado |
+| `embedding.provider` | `hash` | Backend do embedder: `hash` (integrado, zero downloads), `command` (subprocesso externo, requer `embedding.command`), `ollama` (Ollama local, sondado e degradado para `hash` se inalcançável) |
+| `embedding.command` | `''` | Comando de embedder externo opcional (argv separado por espaços, sem shell) via `ctx.subprocess`; configurá-lo seleciona o backend `command` |
+| `embedding.ollamaUrl` / `ollamaModel` | `http://127.0.0.1:11434` / `nomic-embed-text` | Endpoint e modelo do Ollama local para o backend `ollama` (zero nuvem) |
 | `embedding.timeoutMs` / `graceMs` / `maxOutputBytes` / `maxBatchItems` | `30000` / `1000` / `1048576` / `64` | Orçamento do subprocesso do embedder |
 | `search.topK` | `8` | Resultados devolvidos após o pipeline completo |
 | `search.hybridWeight` | `0.6` | 0 = só palavras-chave, 1 = só semântica |

package/README.zh.md

@@ -88,7 +88,9 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-library'
 | `chunkOverlap` | `120` | 相邻窗口重叠；必须小于 `chunkSize` |
 | `maxFileBytes` | `5242880` | 超过该大小的文件在 `library_add` 被拒绝 |
 | `embedding.dims` | `256` | 哈希嵌入维度（≥ 8） |
-| `embedding.command` | `''` | 可选外部嵌入命令（空格分隔 argv、无 shell）走 `ctx.subprocess`；`''` = 内置哈希嵌入 |
+| `embedding.provider` | `hash` | 嵌入后端：`hash`（内置，零下载）、`command`（外部子进程，需 `embedding.command`）、`ollama`（本地 Ollama，探测不可用时降级回 `hash`） |
+| `embedding.command` | `''` | 可选外部嵌入命令（空格分隔 argv、无 shell）走 `ctx.subprocess`；设置后即选择 `command` 后端 |
+| `embedding.ollamaUrl` / `ollamaModel` | `http://127.0.0.1:11434` / `nomic-embed-text` | `ollama` 后端的本地 Ollama 端点与模型（零云端） |
 | `embedding.timeoutMs` / `graceMs` / `maxOutputBytes` / `maxBatchItems` | `30000` / `1000` / `1048576` / `64` | 嵌入子进程预算 |
 | `search.topK` | `8` | 完整管线后返回的结果数 |
 | `search.hybridWeight` | `0.6` | 0 = 仅关键词，1 = 仅语义 |
@@ -128,7 +130,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-library'
 
 ## 已知限制
 
-- **词法级嵌入。** 内置哈希嵌入打分的是表面相似而非语义；对改写表达的检索质量低于真实嵌入模型 —— 配置 `embedding.command` 可获得更强语义。
+- **词法级嵌入。** 内置哈希嵌入打分的是表面相似而非语义；对改写表达的检索质量低于真实嵌入模型 —— 配置 `embedding.command`（任意子进程嵌入）或 `embedding.provider: ollama`（本地 Ollama 嵌入模型）可获得更强语义。
 - **本地引用模型。** `library_cite_check` 针对搜索结果页（`[n]` 编号）验证，不支持自由形式的来源名；模糊分数是有界的词序列部分匹配率。
 - **无摄取管线。** 文档须按路径导入（`md`/`txt`）；PDF/docx 抽取不在 v0.1.0 范围。
 

package/lib/index.js

@@ -4011,6 +4011,10 @@ const LIBRARY_NAME = /^[a-z0-9][a-z0-9-]{0,63}$/;
 const DEFAULT_MAX_FILE_BYTES = 5242880;
 /** Absolute safety bound on one stored chunk (chunkSize must stay below it). */
 const MAX_CHUNK_CHARS = 4e3;
+/** Local Ollama base URL (zero cloud — only this localhost endpoint is ever contacted). */
+const DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434";
+/** Default Ollama embedding model. */
+const DEFAULT_OLLAMA_MODEL = "nomic-embed-text";
 /** Embedder subprocess budget. */
 const DEFAULT_EMBEDDING_TIMEOUT_MS = 3e4;
 const DEFAULT_EMBEDDING_GRACE_MS = 1e3;
@@ -4029,14 +4033,24 @@ const Config = z.object({
 	maxFileBytes: z.number().default(DEFAULT_MAX_FILE_BYTES),
 	embedding: z.object({
 		dims: z.number().default(256),
+		provider: z.union([
+			z.const("hash"),
+			z.const("command"),
+			z.const("ollama")
+		]).default("hash"),
 		command: z.string(),
+		ollamaUrl: z.string().default(DEFAULT_OLLAMA_URL),
+		ollamaModel: z.string().default(DEFAULT_OLLAMA_MODEL),
 		timeoutMs: z.number().default(DEFAULT_EMBEDDING_TIMEOUT_MS),
 		graceMs: z.number().default(DEFAULT_EMBEDDING_GRACE_MS),
 		maxOutputBytes: z.number().default(DEFAULT_EMBEDDING_MAX_OUTPUT_BYTES),
 		maxBatchItems: z.number().default(64)
 	}).default({
 		dims: 256,
+		provider: "hash",
 		command: "",
+		ollamaUrl: DEFAULT_OLLAMA_URL,
+		ollamaModel: DEFAULT_OLLAMA_MODEL,
 		timeoutMs: DEFAULT_EMBEDDING_TIMEOUT_MS,
 		graceMs: DEFAULT_EMBEDDING_GRACE_MS,
 		maxOutputBytes: DEFAULT_EMBEDDING_MAX_OUTPUT_BYTES,
@@ -4127,9 +4141,19 @@ function resolveConfig(config = {}) {
 		["embedding.maxBatchItems", embedding.maxBatchItems ?? 64]
 	]) assertPositiveInteger(name, value);
 	const rawCommand = embedding.command;
-	const command = rawCommand === void 0 || rawCommand.trim().length === 0 ? void 0 : rawCommand;
-	if (command !== void 0) {
-		if (command.split(/\s+/u)[0].length === 0) throw new TypeError("dsh-library: embedding.command must start with an executable (space-separated argv, no shell interpretation)");
+	const command = rawCommand === void 0 || rawCommand.trim().length === 0 ? void 0 : rawCommand.trim();
+	const rawProvider = embedding.provider;
+	let provider;
+	if (command !== void 0) provider = "command";
+	else if (rawProvider === void 0 || rawProvider === "hash") provider = "hash";
+	else if (rawProvider === "command") throw new TypeError("dsh-library: embedding.provider=command requires embedding.command to be set");
+	else if (rawProvider === "ollama") provider = "ollama";
+	else throw new TypeError(`dsh-library: embedding.provider must be hash|command|ollama, got ${JSON.stringify(rawProvider)}`);
+	const ollamaUrl = (embedding.ollamaUrl ?? "http://127.0.0.1:11434").trim();
+	const ollamaModel = (embedding.ollamaModel ?? "nomic-embed-text").trim();
+	if (provider === "ollama") {
+		if (ollamaUrl.length === 0) throw new TypeError("dsh-library: embedding.ollamaUrl must be a non-empty URL when provider=ollama");
+		if (ollamaModel.length === 0) throw new TypeError("dsh-library: embedding.ollamaModel must be a non-empty model name when provider=ollama");
 	}
 	const search = config.search ?? {};
 	const topK = search.topK ?? 8;
@@ -4171,7 +4195,10 @@ function resolveConfig(config = {}) {
 		maxFileBytes: config.maxFileBytes ?? 5242880,
 		embedding: {
 			dims,
+			provider,
 			command: command === void 0 ? void 0 : command.trim(),
+			ollamaUrl,
+			ollamaModel,
 			timeoutMs: embedding.timeoutMs ?? 3e4,
 			graceMs: embedding.graceMs ?? 1e3,
 			maxOutputBytes: embedding.maxOutputBytes ?? 1048576,
@@ -4418,6 +4445,177 @@ async function embedWithCommand(subprocess, argv, cwd, texts, dims, caps) {
 function splitCommandLine(command) {
 	return command.trim().split(/\s+/u).filter((part) => part.length > 0);
 }
+/** Built-in deterministic hash embedder: zero downloads, pure local hashing. */
+var HashEmbedder = class {
+	dims;
+	name = "hash";
+	/**
+	* @param dims - vector dimensionality (≥ 1).
+	*/
+	constructor(dims) {
+		this.dims = dims;
+	}
+	async embed(texts) {
+		return texts.map((text) => embedHash(text, this.dims));
+	}
+};
+/** External command embedder over the JSON-lines subprocess protocol. */
+var CommandEmbedder = class {
+	subprocess;
+	argv;
+	cwd;
+	dims;
+	caps;
+	maxBatchItems;
+	name = "command";
+	/**
+	* @param subprocess - the mounted subprocess seam.
+	* @param argv - the command line split into argv (argv[0] = program).
+	* @param cwd - working directory for the child.
+	* @param dims - expected vector dimensionality.
+	* @param caps - timeout, grace, and output caps.
+	* @param maxBatchItems - texts per subprocess invocation; larger batches split.
+	*/
+	constructor(subprocess, argv, cwd, dims, caps, maxBatchItems) {
+		this.subprocess = subprocess;
+		this.argv = argv;
+		this.cwd = cwd;
+		this.dims = dims;
+		this.caps = caps;
+		this.maxBatchItems = maxBatchItems;
+	}
+	async embed(texts) {
+		const out = [];
+		for (let index = 0; index < texts.length; index += this.maxBatchItems) out.push(...await embedWithCommand(this.subprocess, this.argv, this.cwd, texts.slice(index, index + this.maxBatchItems), this.dims, this.caps));
+		return out;
+	}
+};
+/**
+* Local Ollama embedder over the `/api/embed` endpoint. Zero cloud: the model
+* runs on a localhost Ollama server. A non-2xx response or a malformed vector
+* fails the batch (misconfiguration must surface, not silently degrade
+* retrieval); availability is probed up front by {@link probeOllama}.
+*/
+var OllamaEmbedder = class {
+	url;
+	model;
+	dims;
+	timeoutMs;
+	maxBatchItems;
+	name = "ollama";
+	/**
+	* @param url - the Ollama base URL (e.g. `http://127.0.0.1:11434`).
+	* @param model - the embedding model name (e.g. `nomic-embed-text`).
+	* @param dims - the probed embedding dimensionality.
+	* @param timeoutMs - per-request timeout.
+	* @param maxBatchItems - texts per `/api/embed` call; larger batches split.
+	*/
+	constructor(url, model, dims, timeoutMs, maxBatchItems) {
+		this.url = url;
+		this.model = model;
+		this.dims = dims;
+		this.timeoutMs = timeoutMs;
+		this.maxBatchItems = maxBatchItems;
+	}
+	async embed(texts) {
+		const out = [];
+		for (let index = 0; index < texts.length; index += this.maxBatchItems) out.push(...await this.embedBatch(texts.slice(index, index + this.maxBatchItems)));
+		return out;
+	}
+	/** POST one batch to `/api/embed` and validate the returned vectors. */
+	async embedBatch(texts) {
+		let response;
+		try {
+			response = await fetch(`${this.url}/api/embed`, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					model: this.model,
+					input: [...texts]
+				}),
+				signal: AbortSignal.timeout(this.timeoutMs)
+			});
+		} catch (error) {
+			throw new Error(`dsh-library: ollama embed request failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		if (!response.ok) throw new Error(`dsh-library: ollama embed failed (HTTP ${response.status})`);
+		const embeddings = (await response.json())["embeddings"];
+		if (!Array.isArray(embeddings) || embeddings.length !== texts.length) throw new Error(`dsh-library: ollama answered ${Array.isArray(embeddings) ? embeddings.length : 0} of ${texts.length} inputs`);
+		return embeddings.map((vector) => {
+			if (!Array.isArray(vector) || vector.length !== this.dims || vector.some((value) => typeof value !== "number" || !Number.isFinite(value))) throw new Error("dsh-library: ollama returned a malformed embedding vector");
+			return normalizeVector(Float64Array.from(vector));
+		});
+	}
+};
+/**
+* Probe a local Ollama server for one embedding model. Sends a single-word
+* probe through `/api/embed` and returns the model's vector dimensionality, or
+* undefined when the server is unreachable, the model is unknown, or the
+* response is malformed. Zero cloud — only the configured local URL is ever
+* contacted.
+* @param url - the Ollama base URL.
+* @param model - the embedding model name.
+* @param timeoutMs - probe timeout.
+* @returns the model's dimensionality, or undefined when unavailable.
+*/
+async function probeOllama(url, model, timeoutMs) {
+	try {
+		const response = await fetch(`${url}/api/embed`, {
+			method: "POST",
+			headers: { "content-type": "application/json" },
+			body: JSON.stringify({
+				model,
+				input: ["probe"]
+			}),
+			signal: AbortSignal.timeout(timeoutMs)
+		});
+		if (!response.ok) return void 0;
+		const embeddings = (await response.json())["embeddings"];
+		if (!Array.isArray(embeddings) || embeddings.length !== 1 || !Array.isArray(embeddings[0])) return void 0;
+		return embeddings[0].length;
+	} catch {
+		return;
+	}
+}
+/**
+* Resolve the embedder backend from the resolved config: the configured
+* command wins (fail loud without a subprocess seam), the `ollama` provider is
+* probed and degrades gracefully to the built-in hash embedder when the server
+* is unreachable, and the built-in hash embedder is the zero-download default.
+* @param config - the resolved embedding config.
+* @param subprocess - the optional subprocess seam (command provider only).
+* @param cwd - working directory for the command provider.
+* @returns the backend plus its degradation note.
+*/
+async function resolveEmbedder(config, subprocess, cwd) {
+	if (config.provider === "command") {
+		if (subprocess === void 0) throw new Error("dsh-library: embedding.provider=command but ctx.subprocess is not mounted — the external embedder cannot run");
+		return {
+			embedder: new CommandEmbedder(subprocess, splitCommandLine(config.command), cwd, config.dims, {
+				timeoutMs: config.timeoutMs,
+				graceMs: config.graceMs,
+				maxOutputBytes: config.maxOutputBytes
+			}, config.maxBatchItems),
+			degraded: false
+		};
+	}
+	if (config.provider === "ollama") {
+		const dims = await probeOllama(config.ollamaUrl, config.ollamaModel, config.timeoutMs);
+		if (dims === void 0) return {
+			embedder: new HashEmbedder(config.dims),
+			degraded: true,
+			reason: `ollama unavailable at ${config.ollamaUrl} (model ${config.ollamaModel}); degraded to the built-in hash embedder`
+		};
+		return {
+			embedder: new OllamaEmbedder(config.ollamaUrl, config.ollamaModel, dims, config.timeoutMs, config.maxBatchItems),
+			degraded: false
+		};
+	}
+	return {
+		embedder: new HashEmbedder(config.dims),
+		degraded: false
+	};
+}
 //#endregion
 //#region src/ids.ts
 /**
@@ -5310,16 +5508,9 @@ var LibraryStore = class {
 		this.chunks = domain.table("chunks");
 		this.purges = domain.table("purges");
 	}
-	/** Embed a text batch with the configured embedder (external command when set). */
+	/** Embed a text batch with the resolved embedder backend. */
 	async embed(texts) {
-		const command = this.config.embedding.command;
-		if (command === void 0) return texts.map((text) => embedHash(text, this.config.embedding.dims));
-		if (this.deps.subprocess === void 0) throw new Error("embedding.command is configured but ctx.subprocess is not mounted — the external embedder cannot run");
-		return embedWithCommand(this.deps.subprocess, splitCommandLine(command), process.cwd(), texts, this.config.embedding.dims, {
-			timeoutMs: this.config.embedding.timeoutMs,
-			graceMs: this.config.embedding.graceMs,
-			maxOutputBytes: this.config.embedding.maxOutputBytes
-		});
+		return this.deps.embedder.embed(texts);
 	}
 	/**
 	* Import one document: chunk it, embed the chunks, and store the records.
@@ -5551,9 +5742,12 @@ var LibraryStore = class {
 		};
 	}
 };
-/** Optional services resolved at call time (fail closed). */
-function storeDepsOf(ctx) {
-	return { subprocess: ctx.get("subprocess") };
+/** Resolve the embedder backend at mount; a degraded Ollama falls back to hash with a logged reason. */
+async function storeDepsOf(ctx, config) {
+	const subprocess = ctx.get("subprocess");
+	const resolution = await resolveEmbedder(config.embedding, subprocess, process.cwd());
+	if (resolution.degraded) ctx.logger("dsh-library").warn(`embedder: ${resolution.reason}`);
+	return { embedder: resolution.embedder };
 }
 /** Append one audit event; a failed append never changes the outcome. */
 function audit(exec, type, event) {
@@ -5574,7 +5768,7 @@ async function apply(ctx, config = {}) {
 	const resolved = resolveConfig(config);
 	const domain = await ctx.storageDomain.open(libraryDomainSpec);
 	ctx.effect(() => () => domain.close(), "dsh-library: storage domain");
-	const store = new LibraryStore(domain, resolved, storeDepsOf(ctx));
+	const store = new LibraryStore(domain, resolved, await storeDepsOf(ctx, resolved));
 	const services = {
 		ctx,
 		config: resolved,
@@ -6071,4 +6265,4 @@ function libraryDiagnoseTool(services) {
 	});
 }
 //#endregion
-export { CHUNK_SIZE_BUCKETS, Config, LIBRARY_NAME, LibraryStore, PROBE_PREFIX, allTools, apply, avoidLostMiddle, buildProbePrompt, checkDiversity, chunkHash, chunkSizeHistogram, chunkText, cosine, embedHash, extractCitationNumbers, extractCitations, extractContext, extractSentenceWithCitation, filterDocuments, findDuplicateChunks, formatFewShotPrompt, fuzzyPartialRatio, inject, insertProbe, libraryDomainSpec, makeProbe, maximalMarginalRelevance, middlePenalty, name, positionBins, resolveConfig, sampleSignatures, scoreBatch, scoreRelevance, selectFewShot, splitCommandLine, successByPosition, validateCitation, validateCitations, validateQaPair, verifyPurge, verifyReferences };
+export { CHUNK_SIZE_BUCKETS, CommandEmbedder, Config, HashEmbedder, LIBRARY_NAME, LibraryStore, OllamaEmbedder, PROBE_PREFIX, allTools, apply, avoidLostMiddle, buildProbePrompt, checkDiversity, chunkHash, chunkSizeHistogram, chunkText, cosine, embedHash, extractCitationNumbers, extractCitations, extractContext, extractSentenceWithCitation, filterDocuments, findDuplicateChunks, formatFewShotPrompt, fuzzyPartialRatio, inject, insertProbe, libraryDomainSpec, makeProbe, maximalMarginalRelevance, middlePenalty, name, positionBins, probeOllama, resolveConfig, resolveEmbedder, sampleSignatures, scoreBatch, scoreRelevance, selectFewShot, splitCommandLine, successByPosition, validateCitation, validateCitations, validateQaPair, verifyPurge, verifyReferences };

package/lib/types/config.d.ts

@@ -17,6 +17,10 @@ export declare const DEFAULT_MAX_FILE_BYTES: number;
 export declare const MAX_CHUNK_CHARS = 4000;
 /** Hash-embedding dimensionality used by the zero-download local embedder. */
 export declare const DEFAULT_EMBEDDING_DIMS = 256;
+/** Local Ollama base URL (zero cloud — only this localhost endpoint is ever contacted). */
+export declare const DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434";
+/** Default Ollama embedding model. */
+export declare const DEFAULT_OLLAMA_MODEL = "nomic-embed-text";
 /** Embedder subprocess budget. */
 export declare const DEFAULT_EMBEDDING_TIMEOUT_MS = 30000;
 export declare const DEFAULT_EMBEDDING_GRACE_MS = 1000;
@@ -44,10 +48,17 @@ export declare const DEFAULT_PURGE_MAX_PROBES = 24;
 export declare const DEFAULT_DIAGNOSE_MAX_DUPLICATE_PAIRS = 24;
 export declare const DEFAULT_DIAGNOSE_SAMPLE_CAP = 200;
 export declare const DEFAULT_DIAGNOSE_POSITION_BINS = 5;
-/** Embedder selection: built-in hash embedding, or an external command through `ctx.subprocess`. */
+/** Embedder selection: built-in hash embedding, an external command, or a local Ollama server. */
 export interface EmbeddingConfig {
     /** Hash-embedding dimensionality (built-in embedder only). Must be ≥ 8. */
     dims?: number;
+    /**
+     * Which embedder backend to use: `hash` (built-in, zero downloads), `command`
+     * (the external subprocess protocol, requires `command`), or `ollama` (a
+     * local Ollama server, probed and degraded to `hash` when unavailable).
+     * When `command` is set, the command provider wins regardless of this field.
+     */
+    provider?: 'hash' | 'command' | 'ollama';
     /**
      * Optional external embedder command line (space-separated, no shell
      * interpretation; executed through `ctx.subprocess`). The command must read
@@ -58,6 +69,10 @@ export interface EmbeddingConfig {
      * embedder runs with zero downloads.
      */
     command?: string;
+    /** Local Ollama base URL for the `ollama` provider (default `http://127.0.0.1:11434`). */
+    ollamaUrl?: string;
+    /** Ollama embedding model name (default `nomic-embed-text`). */
+    ollamaModel?: string;
     /** Cooperative timeout for one embedder invocation (ms). */
     timeoutMs?: number;
     /** Terminate-escalation grace handed to the subprocess seam (ms). */
@@ -143,7 +158,10 @@ export interface Config {
 /** Resolved embedding config: defaults applied, `command` explicitly optional. */
 export interface ResolvedEmbeddingConfig {
     readonly dims: number;
+    readonly provider: 'hash' | 'command' | 'ollama';
     readonly command: string | undefined;
+    readonly ollamaUrl: string;
+    readonly ollamaModel: string;
     readonly timeoutMs: number;
     readonly graceMs: number;
     readonly maxOutputBytes: number;

package/lib/types/config.d.ts.map

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

package/lib/types/embedding.d.ts

@@ -7,6 +7,7 @@
  * @module dsh-library/embedding
  */
 import type { SubprocessRuntime } from '@deepseek-ai/dsh-subprocess';
+import type { ResolvedEmbeddingConfig } from './config.js';
 /**
  * Embed one text with the built-in hash embedder. Each word token and each
  * character tri-gram hashes (FNV-1a) to a signed bucket: the index is the
@@ -53,4 +54,113 @@ export declare function embedWithCommand(subprocess: SubprocessRuntime, argv: re
  * @returns the argv vector; an empty string yields an empty vector.
  */
 export declare function splitCommandLine(command: string): string[];
+/**
+ * The embedder provider seam: one pluggable text→vector backend. The built-in
+ * {@link HashEmbedder} is the zero-download default; {@link CommandEmbedder}
+ * and {@link OllamaEmbedder} are optional backends (probe → use → degrade for
+ * Ollama; fail loud for a configured-but-absent command).
+ */
+export interface Embedder {
+    /** Provider name recorded alongside the index (hash | command | ollama). */
+    readonly name: 'hash' | 'command' | 'ollama';
+    /** Vector dimensionality this backend emits. */
+    readonly dims: number;
+    /**
+     * Embed one batch of texts, returning one vector per input in the same order.
+     * @param texts - the texts to embed.
+     * @returns the L2-normalized embeddings.
+     */
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/** Built-in deterministic hash embedder: zero downloads, pure local hashing. */
+export declare class HashEmbedder implements Embedder {
+    readonly dims: number;
+    readonly name: "hash";
+    /**
+     * @param dims - vector dimensionality (≥ 1).
+     */
+    constructor(dims: number);
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/** External command embedder over the JSON-lines subprocess protocol. */
+export declare class CommandEmbedder implements Embedder {
+    private readonly subprocess;
+    private readonly argv;
+    private readonly cwd;
+    readonly dims: number;
+    private readonly caps;
+    private readonly maxBatchItems;
+    readonly name: "command";
+    /**
+     * @param subprocess - the mounted subprocess seam.
+     * @param argv - the command line split into argv (argv[0] = program).
+     * @param cwd - working directory for the child.
+     * @param dims - expected vector dimensionality.
+     * @param caps - timeout, grace, and output caps.
+     * @param maxBatchItems - texts per subprocess invocation; larger batches split.
+     */
+    constructor(subprocess: SubprocessRuntime, argv: readonly string[], cwd: string, dims: number, caps: {
+        timeoutMs: number;
+        graceMs: number;
+        maxOutputBytes: number;
+    }, maxBatchItems: number);
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/**
+ * Local Ollama embedder over the `/api/embed` endpoint. Zero cloud: the model
+ * runs on a localhost Ollama server. A non-2xx response or a malformed vector
+ * fails the batch (misconfiguration must surface, not silently degrade
+ * retrieval); availability is probed up front by {@link probeOllama}.
+ */
+export declare class OllamaEmbedder implements Embedder {
+    private readonly url;
+    private readonly model;
+    readonly dims: number;
+    private readonly timeoutMs;
+    private readonly maxBatchItems;
+    readonly name: "ollama";
+    /**
+     * @param url - the Ollama base URL (e.g. `http://127.0.0.1:11434`).
+     * @param model - the embedding model name (e.g. `nomic-embed-text`).
+     * @param dims - the probed embedding dimensionality.
+     * @param timeoutMs - per-request timeout.
+     * @param maxBatchItems - texts per `/api/embed` call; larger batches split.
+     */
+    constructor(url: string, model: string, dims: number, timeoutMs: number, maxBatchItems: number);
+    embed(texts: readonly string[]): Promise<number[][]>;
+    /** POST one batch to `/api/embed` and validate the returned vectors. */
+    private embedBatch;
+}
+/**
+ * Probe a local Ollama server for one embedding model. Sends a single-word
+ * probe through `/api/embed` and returns the model's vector dimensionality, or
+ * undefined when the server is unreachable, the model is unknown, or the
+ * response is malformed. Zero cloud — only the configured local URL is ever
+ * contacted.
+ * @param url - the Ollama base URL.
+ * @param model - the embedding model name.
+ * @param timeoutMs - probe timeout.
+ * @returns the model's dimensionality, or undefined when unavailable.
+ */
+export declare function probeOllama(url: string, model: string, timeoutMs: number): Promise<number | undefined>;
+/** The outcome of {@link resolveEmbedder}: the backend plus its degradation note. */
+export interface EmbedderResolution {
+    /** The resolved backend. */
+    readonly embedder: Embedder;
+    /** True when the configured backend was unavailable and a default was substituted. */
+    readonly degraded: boolean;
+    /** Human-readable degradation reason (present only when {@link EmbedderResolution.degraded}). */
+    readonly reason?: string;
+}
+/**
+ * Resolve the embedder backend from the resolved config: the configured
+ * command wins (fail loud without a subprocess seam), the `ollama` provider is
+ * probed and degrades gracefully to the built-in hash embedder when the server
+ * is unreachable, and the built-in hash embedder is the zero-download default.
+ * @param config - the resolved embedding config.
+ * @param subprocess - the optional subprocess seam (command provider only).
+ * @param cwd - working directory for the command provider.
+ * @returns the backend plus its degradation note.
+ */
+export declare function resolveEmbedder(config: ResolvedEmbeddingConfig, subprocess: SubprocessRuntime | undefined, cwd: string): Promise<EmbedderResolution>;
 //# sourceMappingURL=embedding.d.ts.map

package/lib/types/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/embedding.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAIpE;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAU9D;AAcD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAYzE;AAqBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,iBAAiB,EAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACnE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CA0CrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1D"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/embedding.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -14,15 +14,16 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { type Domain } from '@deepseek-ai/dsh-storage-domain';
 import { z as zod } from 'zod';
-import type { SubprocessRuntime } from '@deepseek-ai/dsh-subprocess';
 import { Config, type ResolvedConfig } from './config.js';
+import { type Embedder } from './embedding.js';
 import { chunkSizeHistogram } from './quality/chunk-visual.js';
 export declare const name = "dsh-library";
 /** Hard services: the durable index lives in the storage domain; tools and the command register here. */
 export declare const inject: string[];
 export { Config, resolveConfig, LIBRARY_NAME } from './config.js';
 export type { ResolvedConfig, EmbeddingConfig, SearchConfig, InjectionConfig, CitationConfig, PurgeConfig, DiagnoseConfig } from './config.js';
-export { embedHash, cosine, splitCommandLine } from './embedding.js';
+export { embedHash, cosine, splitCommandLine, HashEmbedder, CommandEmbedder, OllamaEmbedder, probeOllama, resolveEmbedder } from './embedding.js';
+export type { Embedder, EmbedderResolution } from './embedding.js';
 export { CHUNK_SIZE_BUCKETS, chunkSizeHistogram, chunkText, chunkHash, findDuplicateChunks } from './quality/chunk-visual.js';
 export type { Chunk, ChunkSizeHistogram, ChunkDiagnostics } from './quality/chunk-visual.js';
 export { checkDiversity, maximalMarginalRelevance } from './quality/diversity.js';
@@ -98,9 +99,9 @@ declare module '@deepseek-ai/dsh-session/types' {
         };
     }
 }
-/** Optional seams read at call time (fail closed when absent). */
+/** Optional seams resolved at call time; the embedder is resolved at mount (fail closed when absent). */
 interface StoreDeps {
-    readonly subprocess: SubprocessRuntime | undefined;
+    readonly embedder: Embedder;
 }
 /** One `library_add` outcome. */
 export interface LibraryAddResult {
@@ -193,7 +194,7 @@ export declare class LibraryStore {
      * @param deps - optional subprocess seam for the external embedder.
      */
     constructor(domain: Domain<typeof libraryDomainSpec>, config: ResolvedConfig, deps: StoreDeps);
-    /** Embed a text batch with the configured embedder (external command when set). */
+    /** Embed a text batch with the resolved embedder backend. */
     private embed;
     /**
      * Import one document: chunk it, embed the chunks, and store the records.

package/lib/types/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-library",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "Local document knowledge base for DeepSeek Harness: library_add/remove/list, hybrid semantic+keyword library_search with diversity re-ranking, relevance filtering and lost-in-the-middle avoidance, citation-aware injection, library_cite_check and library_diagnose —SQLite-backed index via the storage domain, local embedding, zero model downloads",
   "repository": {
     "type": "git",