dsh-library 0.1.4 → 0.2.1

package/lib/index.js

@@ -3,6 +3,7 @@ import { MessageId } from "@deepseek-ai/dsh-llm";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
 import { createHash, randomUUID } from "node:crypto";
+import { KNOWN_SESSION_EVENT_TYPES } from "@deepseek-ai/dsh-session";
 //#region node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/core/core.js
 var _a$1;
 function $constructor(name, initializer, params) {
@@ -4011,6 +4012,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 +4034,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 +4142,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 +4196,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 +4446,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
 /**
@@ -5173,6 +5372,48 @@ function verifyPurge(remaining, removedContent, options = {}) {
 	};
 }
 //#endregion
+//#region src/events.ts
+/**
+* Session audit events for dsh-library (declaration merging into the harness's
+* `SessionEventMap`) and the adaptive append gate. Both events are log-only;
+* tool arguments and rendered results are already logged by the tool runtime
+* as `tool/call` + `tool/result`, and these events carry the audit facts that
+* exist outside them: the inject id linking the injected marker text back to
+* the search that produced it, and each purge-verification verdict.
+*
+* The gate appends only when the host can carry the events safely:
+* - hosts whose known-type set covers the vocabulary append plainly;
+* - hosts with an `ignorable` append option (pre-0.1.2 master builds) append
+*   with the marker, so builds that do not know the type skip it on restore;
+* - envelope-less hosts (0.1.0-rc.6/rc.8, 0.1.1-rc.2, and 0.1.2-alpha.1,
+*   which removed the envelope and fails closed on unknown types at read)
+*   get no append — the tool results remain the reconstructable audit trail.
+*
+* @module dsh-library/events
+*/
+/** The injection audit event type. */
+const INJECT_EVENT = "library/inject";
+/** The purge audit event type. */
+const PURGE_EVENT = "library/purge";
+/**
+* Append one dsh-library audit event when the host can carry it safely; skip
+* silently otherwise (the `tool/call` + `tool/result` events remain the
+* model-visible log, so nothing model-visible is lost). See the module doc
+* for the three host classes.
+* @param session - the calling session.
+* @param type - the audit event type.
+* @param data - the audit payload.
+*/
+function appendAuditEvent(session, type, data) {
+	if (KNOWN_SESSION_EVENT_TYPES.has(type)) {
+		if (type === "library/inject") session.append(type, data);
+		else session.append(type, data);
+		return;
+	}
+	const append = session.append;
+	if (Function.prototype.toString.call(append).includes("ignorable")) append.call(session, type, data, { ignorable: true });
+}
+//#endregion
 //#region src/quality/few-shot.ts
 /**
 * Port of Few-Shot-Selector (upstream/PerryLink, Apache-2.0): the
@@ -5310,16 +5551,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,16 +5785,19 @@ var LibraryStore = class {
 		};
 	}
 };
-/** Optional services resolved at call time (fail closed). */
-function storeDepsOf(ctx) {
-	return { subprocess: ctx.get("subprocess") };
-}
-/** Append one audit event; a failed append never changes the outcome. */
+/** 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 through the adaptive host gate; a failed append never changes the outcome. */
 function audit(exec, type, event) {
 	const session = exec.agent?.session;
 	if (session === void 0) return;
 	try {
-		session.append(type, event);
+		appendAuditEvent(session, type, event);
 	} catch {}
 }
 /**
@@ -5574,7 +5811,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 +6308,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, INJECT_EVENT, LIBRARY_NAME, LibraryStore, OllamaEmbedder, PROBE_PREFIX, PURGE_EVENT, allTools, appendAuditEvent, 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/events.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Session audit events for dsh-library (declaration merging into the harness's
+ * `SessionEventMap`) and the adaptive append gate. Both events are log-only;
+ * tool arguments and rendered results are already logged by the tool runtime
+ * as `tool/call` + `tool/result`, and these events carry the audit facts that
+ * exist outside them: the inject id linking the injected marker text back to
+ * the search that produced it, and each purge-verification verdict.
+ *
+ * The gate appends only when the host can carry the events safely:
+ * - hosts whose known-type set covers the vocabulary append plainly;
+ * - hosts with an `ignorable` append option (pre-0.1.2 master builds) append
+ *   with the marker, so builds that do not know the type skip it on restore;
+ * - envelope-less hosts (0.1.0-rc.6/rc.8, 0.1.1-rc.2, and 0.1.2-alpha.1,
+ *   which removed the envelope and fails closed on unknown types at read)
+ *   get no append — the tool results remain the reconstructable audit trail.
+ *
+ * @module dsh-library/events
+ */
+import { type Session } from '@deepseek-ai/dsh-session';
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        /** One `library_search` injection: id links the injected marker text back to this event. */
+        'library/inject': LibraryInjectEvent;
+        /** One `library_remove` purge verification outcome. */
+        'library/purge': LibraryPurgeEvent;
+    }
+}
+/** The `library_search` injection audit payload. */
+export interface LibraryInjectEvent {
+    /** Inject id carried by the injected marker text. */
+    injectId: string;
+    /** Library the search ran against. */
+    library: string;
+    /** The search query. */
+    query: string;
+    /** Chunk ids of the injected result page. */
+    chunks: string[];
+    /** Injected page length in characters (after the budget cap). */
+    chars: number;
+}
+/** The `library_remove` purge-verification audit payload. */
+export interface LibraryPurgeEvent {
+    /** Purge probe run id. */
+    purgeId: string;
+    /** Library the document was removed from. */
+    library: string;
+    /** Removed document id. */
+    documentId: string;
+    /** Whether the purge probes found no residue. */
+    passed: boolean;
+    /** Residue hits found by the purge probes. */
+    totalFound: number;
+}
+/** The injection audit event type. */
+export declare const INJECT_EVENT: "library/inject";
+/** The purge audit event type. */
+export declare const PURGE_EVENT: "library/purge";
+/**
+ * Append one dsh-library audit event when the host can carry it safely; skip
+ * silently otherwise (the `tool/call` + `tool/result` events remain the
+ * model-visible log, so nothing model-visible is lost). See the module doc
+ * for the three host classes.
+ * @param session - the calling session.
+ * @param type - the audit event type.
+ * @param data - the audit payload.
+ */
+export declare function appendAuditEvent(session: Session, type: typeof INJECT_EVENT | typeof PURGE_EVENT, data: LibraryInjectEvent | LibraryPurgeEvent): void;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAElF,OAAO,QAAQ,gCAAgC,CAAC;IAC9C,UAAU,eAAe;QACvB,4FAA4F;QAC5F,gBAAgB,EAAE,kBAAkB,CAAA;QACpC,uDAAuD;QACvD,eAAe,EAAE,iBAAiB,CAAA;KACnC;CACF;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAA;IACf,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,sCAAsC;AACtC,eAAO,MAAM,YAAY,EAAG,gBAAyB,CAAA;AAErD,kCAAkC;AAClC,eAAO,MAAM,WAAW,EAAG,eAAwB,CAAA;AAKnD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,YAAY,GAAG,OAAO,WAAW,EAC9C,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,GAC3C,IAAI,CAUN"}