dsh-mnemon-source-memory-spaces 0.5.13 → 0.5.15

package/lib/{definitions-C5y84OE6.d.ts → definitions-DwiEZSE_.d.ts}

@@ -9,16 +9,21 @@ interface MemorySpaceAuthority {
   list(): MemorySpace[];
   providerConnection(id: string, expectedProviderId?: string): MemoryProviderConnection;
 }
+/** Per-call options of the Native command transport. */
+interface MemorySpaceNativeRunOptions {
+  signal?: AbortSignal;
+  store?: string;
+  /**
+   * Output cap for this call, in bytes (default 2 MiB). Raise it only for reads
+   * whose size the Store itself bounds, such as a whole-Store dump; Source
+   * hosts older than 0.5.14 ignore it and keep the default.
+   */
+  maxOutputBytes?: number;
+}
 /** Scoped command transport consumed by the Native Provider. */
 interface MemorySpaceNativeRunner {
-  runJson(args: readonly string[], options?: {
-    signal?: AbortSignal;
-    store?: string;
-  }): Promise<JsonValue>;
-  runText(args: readonly string[], options?: {
-    signal?: AbortSignal;
-    store?: string;
-  }): Promise<string>;
+  runJson(args: readonly string[], options?: MemorySpaceNativeRunOptions): Promise<JsonValue>;
+  runText(args: readonly string[], options?: MemorySpaceNativeRunOptions): Promise<string>;
 }
 interface MemoryProviderAdapterFactoryContext {
   /** Canonical name; optional while older Source hosts remain supported. */
@@ -137,4 +142,4 @@ interface MemorySpaceProviderEntry<Config = unknown> {
 declare function defineMemorySpaceProvider<Config>(module: MemorySpaceProviderModule<Config>): MemorySpaceProviderModule<Config>;
 declare function defineMemorySpaceProviderDefinition(definition: MemorySpaceProviderDefinition): MemorySpaceProviderDefinition;
 //#endregion
-export { ProviderSpaceStatus as S, NORMALIZED_RELEVANCE_SCORE as _, MemorySpaceProviderHost as a, ProviderScoreSemantics as b, MemorySpaceProviderRuntimeContext as c, defineMemorySpaceProviderDefinition as d, MemoryProviderAdapter as f, MemorySpaceNativeRunner as g, MemorySpaceAuthority as h, MemorySpaceProviderEntry as i, MemorySpaceProviderScoreSemantics as l, MemoryProviderScoreSemantics as m, MemorySpaceProviderDefinition as n, MemorySpaceProviderManifest as o, MemoryProviderAdapterFactoryContext as p, MemorySpaceProviderDisposer as r, MemorySpaceProviderModule as s, MEMORY_SPACE_PROVIDER_API_VERSION as t, defineMemorySpaceProvider as u, ProviderBodyStatus as v, ProviderSearchResult as x, ProviderMemorySpace as y };
+export { ProviderSpaceStatus as C, ProviderSearchResult as S, MemorySpaceNativeRunner as _, MemorySpaceProviderHost as a, ProviderMemorySpace as b, MemorySpaceProviderRuntimeContext as c, defineMemorySpaceProviderDefinition as d, MemoryProviderAdapter as f, MemorySpaceNativeRunOptions as g, MemorySpaceAuthority as h, MemorySpaceProviderEntry as i, MemorySpaceProviderScoreSemantics as l, MemoryProviderScoreSemantics as m, MemorySpaceProviderDefinition as n, MemorySpaceProviderManifest as o, MemoryProviderAdapterFactoryContext as p, MemorySpaceProviderDisposer as r, MemorySpaceProviderModule as s, MEMORY_SPACE_PROVIDER_API_VERSION as t, defineMemorySpaceProvider as u, NORMALIZED_RELEVANCE_SCORE as v, ProviderScoreSemantics as x, ProviderBodyStatus as y };

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 import { AutomaticMemoryPlacementRequest, CATEGORIES, Category, CreateMemoryBodyRequest, CreateMemorySpaceRequest, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, EDGE_TYPES, EMBEDDING_PROTOCOL_AUTO, EMBEDDING_PROTOCOL_OLLAMA, EMBEDDING_PROTOCOL_OPENAI, EdgeType, EntityView, INTENTS, Insight, Intent, JsonValue, LlmMemoryPlacementSelection, MNEMON_EMBEDDING_PROTOCOLS, MemoryBody, MemoryBodyCatalog, MemoryBodyMetadataMaintenanceResult, MemoryBodyMetadataSample, MemoryBodyMetadataUpdate, MemoryBodyProvider, MemoryBodyStats, MemoryBodyView, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryListView, MemoryPersistenceStrategy, MemoryPlacementCandidate, MemoryPlacementCapability, MemoryPlacementDecision, MemoryPlacementPreference, MemoryPlacementRules, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemoryProviderRuntimeStatus, MemoryProviderServiceCatalog, MemoryProviderServiceView, MemoryReadMode, MemoryReadSource, MemoryReadStatus, MemorySpace, MemorySpaceCatalog, MemorySpaceMetadataMaintenanceResult, MemorySpaceMetadataSample, MemorySpaceMetadataUpdate, MemorySpaceProvider, MemorySpaceStats, MemorySpaceView, MemorySpaceWriteScope, MemorySpaceWriteScopeRequest, MemorySpacesStatus, MnemonEmbeddingConfig, MnemonEmbeddingProtocol, MnemonEmbeddingStatus, OpenVikingBodyConnection, OpenVikingSpaceConnection, PreparedMemoryPlacement, RecallQualityConfig, RecallQualityStats, RecallRelevanceTier, RememberRequest, ResolvedMemoryPersistenceStrategy, ResolvedMnemonEmbeddingConfig, ResolvedRecallQualityConfig, SOURCES, SearchRequest, Source, UpdateMemoryBodyRequest, UpdateMemoryProviderServiceRequest, UpdateMemorySpaceRequest } from "./contracts.js";
-import { i as MemorySpaceProviderEntry } from "./definitions-C5y84OE6.js";
+import { i as MemorySpaceProviderEntry } from "./definitions-DwiEZSE_.js";
 import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts

package/lib/index.js

@@ -1,7 +1,7 @@
 import { findMnemonCommand, isMnemonExecutable, resolveMnemonInvocation } from "./native-cli.js";
 import { CATEGORIES as CATEGORIES$1, EDGE_TYPES, INTENTS as INTENTS$1, MNEMON_EMBEDDING_PROTOCOLS, SOURCES as SOURCES$1 } from "./contracts.js";
 import { a as MemoryProviderCatalog, i as EMPTY_MEMORY_PROVIDER_CATALOG, n as PrivateMemorySpaceProviderHost, r as MemoryProviderAdapterRegistry, t as createMemorySpaceProviderPlugin } from "./plugin-DlsNeZbQ.js";
-import { t as runProcess } from "./process-BvrgxPNP.js";
+import { n as ProcessError, r as runProcess } from "./process-DIK9NnTg.js";
 import { r as defineMemorySpaceProvider } from "./definitions-DfmOqJjR.js";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
@@ -348,6 +348,8 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 		let normalizedService = this.providerCatalog.normalizeService(providerId, service);
 		const seen = /* @__PURE__ */ new Set();
 		const existing = this.spaces.filter((body) => body.providerId === providerId);
+		const existingByExternalId = /* @__PURE__ */ new Map();
+		for (const body of existing) if (!existingByExternalId.has(body.externalId)) existingByExternalId.set(body.externalId, body);
 		const reservedIds = new Set(this.spaces.filter((body) => body.providerId !== providerId).map((body) => body.id));
 		const timestamp = this.now().toISOString();
 		const projections = discovered.map((candidate) => {
@@ -359,7 +361,7 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 				...normalizedService,
 				...connection
 			});
-			const previous = existing.find((body) => body.externalId === externalId);
+			const previous = existingByExternalId.get(externalId);
 			let id = previous?.id ?? validateMemorySpaceId(`${providerId}-${createHash("sha256").update(externalId).digest("hex").slice(0, 24)}`);
 			let suffix = 1;
 			while (reservedIds.has(id)) {
@@ -756,9 +758,10 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 		const timestamp = this.now().toISOString();
 		const legacyActive = this.runner.effectiveStore();
 		let changed = false;
+		const knownIds = new Set(this.spaces.map((body) => body.id));
 		for (const entry of readdirSync(this.directory, { withFileTypes: true })) {
 			if (!entry.isDirectory() || !ID_PATTERN.test(entry.name) || !existsSync(join(this.directory, entry.name, "mnemon.db"))) continue;
-			if (this.spaces.some((body) => body.id === entry.name)) continue;
+			if (knownIds.has(entry.name)) continue;
 			this.spaces.push({
 				id: entry.name,
 				name: entry.name,
@@ -768,6 +771,7 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 				createdAt: timestamp,
 				updatedAt: timestamp
 			});
+			knownIds.add(entry.name);
 			changed = true;
 		}
 		if (changed) this.save();
@@ -1797,22 +1801,36 @@ var MemorySpacesService = class {
 		}
 		const { hints, quality } = evaluation;
 		const selected = recoveryPlan === void 0 ? quality.selected : prioritizeRecoveryEvidence(quality.selected, recoveryPlan);
-		const qualityStats = (memoryBodyId) => {
-			const evaluated = quality.evaluated.filter((candidate) => candidate.candidate.memoryBodyId === memoryBodyId);
-			const selected = quality.selected.filter((candidate) => candidate.candidate.memoryBodyId === memoryBodyId);
-			return {
-				policyId: quality.policyId,
-				...quality.fallbackFrom === void 0 ? {} : { fallbackFrom: quality.fallbackFrom },
-				fetched: evaluated.length,
-				retained: evaluated.filter((candidate) => candidate.decision.action === "keep").length,
-				selected: selected.length,
-				droppedLowScore: evaluated.filter((candidate) => candidate.decision.action === "drop" && candidate.decision.reason === "low-score").length,
-				droppedNonPositiveScore: evaluated.filter((candidate) => candidate.decision.action === "drop" && candidate.decision.reason === "non-positive-score").length,
-				droppedInvalidScore: evaluated.filter((candidate) => candidate.decision.action === "drop" && candidate.decision.reason === "invalid-score").length,
-				unscored: evaluated.filter((candidate) => candidate.decision.reason === "unscored").length,
-				unscaled: evaluated.filter((candidate) => candidate.decision.reason === "unscaled-score").length
-			};
-		};
+		const qualityStats = /* @__PURE__ */ new Map();
+		for (const { body } of batches) qualityStats.set(body.id, {
+			policyId: quality.policyId,
+			...quality.fallbackFrom === void 0 ? {} : { fallbackFrom: quality.fallbackFrom },
+			fetched: 0,
+			retained: 0,
+			selected: 0,
+			droppedLowScore: 0,
+			droppedNonPositiveScore: 0,
+			droppedInvalidScore: 0,
+			unscored: 0,
+			unscaled: 0
+		});
+		for (const { candidate, decision } of quality.evaluated) {
+			const stats = qualityStats.get(candidate.memoryBodyId);
+			if (stats === void 0) continue;
+			stats.fetched += 1;
+			if (decision.action === "keep") stats.retained += 1;
+			if (decision.action === "drop") {
+				if (decision.reason === "low-score") stats.droppedLowScore += 1;
+				if (decision.reason === "non-positive-score") stats.droppedNonPositiveScore += 1;
+				if (decision.reason === "invalid-score") stats.droppedInvalidScore += 1;
+			}
+			if (decision.reason === "unscored") stats.unscored += 1;
+			if (decision.reason === "unscaled-score") stats.unscaled += 1;
+		}
+		for (const { candidate } of quality.selected) {
+			const stats = qualityStats.get(candidate.memoryBodyId);
+			if (stats !== void 0) stats.selected += 1;
+		}
 		return {
 			query,
 			mode,
@@ -1822,7 +1840,7 @@ var MemorySpacesService = class {
 				...decision.normalizedScore === void 0 ? {} : { normalizedScore: decision.normalizedScore }
 			})),
 			sources: batches.map((batch) => {
-				const stats = qualityStats(batch.body.id);
+				const stats = qualityStats.get(batch.body.id);
 				if (batch.source.status === "unavailable" || batch.source.status === "unsupported") return {
 					...batch.source,
 					quality: stats
@@ -2044,13 +2062,21 @@ var MemorySpacesService = class {
 	*/
 	async rememberMany(requests, signal) {
 		this.assertWritable();
-		const prepared = requests.map((request) => this.prepareRemember(request));
+		const destinations = /* @__PURE__ */ new Map();
+		const prepared = requests.map((request) => this.prepareRemember(request, destinations));
 		const results = new Array(prepared.length);
 		const groups = /* @__PURE__ */ new Map();
-		for (const [index, entry] of prepared.entries()) groups.set(entry.body.id, [...groups.get(entry.body.id) ?? [], {
-			...entry,
-			index
-		}]);
+		for (const [index, entry] of prepared.entries()) {
+			const group = groups.get(entry.body.id);
+			if (group === void 0) groups.set(entry.body.id, [{
+				...entry,
+				index
+			}]);
+			else group.push({
+				...entry,
+				index
+			});
+		}
 		for (const group of groups.values()) {
 			const body = group[0].body;
 			const provider = this.providerFor(body);
@@ -2066,8 +2092,9 @@ var MemorySpacesService = class {
 					providerChanged ||= mutationResultCommitted(result);
 				}
 			}
+			const batched = new Set(batch);
 			for (const entry of group) {
-				if (batch.includes(entry)) continue;
+				if (batched.has(entry)) continue;
 				const result = await provider.remember(body, entry.request, signal);
 				results[entry.index] = this.annotateResult(result, body);
 				providerChanged ||= mutationResultCommitted(result);
@@ -2273,10 +2300,14 @@ var MemorySpacesService = class {
 		return provider;
 	}
 	readSpaces(ids) {
-		const active = this.memorySpaces.active();
-		if (ids === void 0 || ids.length === 0) return active;
-		return [...new Set(ids.map((id) => id.trim()).filter((id) => id !== ""))].map((id) => {
-			const body = this.memorySpaces.get(id);
+		if (ids === void 0 || ids.length === 0) return this.memorySpaces.active();
+		const requested = [...new Set(ids.map((id) => id.trim()).filter((id) => id !== ""))];
+		const available = /* @__PURE__ */ new Map();
+		for (const body of this.memorySpaces.list()) if (!available.has(body.id)) available.set(body.id, body);
+		return requested.map((id) => {
+			const normalized = validateMemorySpaceId(id);
+			const body = available.get(normalized);
+			if (body === void 0) throw new Error(`unknown memory space: ${normalized}`);
 			if (!body.active) throw new Error(`memory space is not active for reading: ${id}`);
 			if (!this.isNativeSpace(body) && !this.memorySpaces.providerServiceEnabled(body.provider.id)) throw new Error(`${body.provider.label} is disabled on the dsh-mnemon page under Plugins`);
 			return body;
@@ -2303,8 +2334,10 @@ var MemorySpacesService = class {
 		if (active.length !== 1) throw new Error("memoryBodyId is required when the number of active memory spaces is not exactly one");
 		return active[0];
 	}
-	prepareRemember(request) {
-		const body = this.writeSpace(request.memoryBodyId);
+	prepareRemember(request, destinations) {
+		const key = request.memoryBodyId?.trim() ?? "";
+		const body = destinations?.get(key) ?? this.writeSpace(request.memoryBodyId);
+		destinations?.set(key, body);
 		const content = required(request.content, "content", 8192);
 		const importance = memoryInputInteger(request.importance, 3, 1, 5);
 		const category = allowed(request.category, CATEGORIES$1, "category") ?? "general";
@@ -2367,6 +2400,18 @@ const EMBEDDING_ENVIRONMENT_KEYS = /* @__PURE__ */ new Set([
 	"MNEMON_EMBED_API_KEY",
 	"MNEMON_EMBED_PROTOCOL"
 ]);
+/**
+* Explain a CLI call that produced no result. Only a failed launch means the
+* executable is missing or unusable, so only that case carries the install
+* hint; a timeout, a cancellation or an oversized output names its own cause.
+*/
+function processFailureMessage(error, args) {
+	const detail = error instanceof Error ? error.message : String(error);
+	const reason = error instanceof ProcessError ? error.reason : "launch";
+	if (reason === "output-limit") return `mnemon ${args.find((arg) => !arg.startsWith("-")) ?? "command"} stopped: ${detail.replace(/^mnemon /u, "")}`;
+	if (reason !== "launch") return detail;
+	return `${detail}. ${process.platform === "win32" ? "Install the official Mnemon Windows release, ensure mnemon.exe is on PATH or under %LOCALAPPDATA%\\Programs\\mnemon, or set MNEMON_CLI_PATH or mnemon.cliPath to its absolute path." : "Install Mnemon and ensure \"mnemon\" is on PATH, or set MNEMON_CLI_PATH or mnemon.cliPath."}`;
+}
 /** Preserve the Host environment while making saved embedding overrides authoritative. */
 function processEnvironment(config) {
 	if (!config.embedding.enabled) return void 0;
@@ -2402,7 +2447,8 @@ function createRunner(config, processRunner = runProcess) {
 		const processOptions = {
 			timeoutMs: config.timeoutMs,
 			...environment === void 0 ? {} : { env: environment },
-			...options.signal === void 0 ? {} : { signal: options.signal }
+			...options.signal === void 0 ? {} : { signal: options.signal },
+			...options.maxOutputBytes === void 0 ? {} : { maxOutputBytes: options.maxOutputBytes }
 		};
 		let result;
 		try {
@@ -2412,7 +2458,7 @@ function createRunner(config, processRunner = runProcess) {
 				...invocation.env === void 0 ? {} : { env: invocation.env }
 			});
 		} catch (error) {
-			throw new MnemonCliError(`${error instanceof Error ? error.message : String(error)}. ${process.platform === "win32" ? "Install the official Mnemon Windows release, ensure mnemon.exe is on PATH or under %LOCALAPPDATA%\\Programs\\mnemon, or set MNEMON_CLI_PATH or mnemon.cliPath to its absolute path." : "Install Mnemon and ensure \"mnemon\" is on PATH, or set MNEMON_CLI_PATH or mnemon.cliPath."}`);
+			throw new MnemonCliError(processFailureMessage(error, args));
 		}
 		if (result.exitCode !== 0) {
 			const detail = result.stderr.trim() || result.stdout.trim() || "no output";

package/lib/{process-BvrgxPNP.js → process-DIK9NnTg.js}

@@ -4,6 +4,14 @@ import { StringDecoder } from "node:string_decoder";
 const NORMALIZED_RELEVANCE_SCORE = Object.freeze({ kind: "normalized-relevance" });
 //#endregion
 //#region src/providers/process.ts
+var ProcessError = class extends Error {
+	reason;
+	constructor(message, reason) {
+		super(message);
+		this.reason = reason;
+		this.name = "ProcessError";
+	}
+};
 const DEFAULT_MAX_OUTPUT_BYTES = 2097152;
 /** Spawn without a shell, with bounded output and cooperative cancellation. */
 const runProcess = (command, args, options) => new Promise((resolve, reject) => {
@@ -19,7 +27,7 @@ const runProcess = (command, args, options) => new Promise((resolve, reject) =>
 		...options.cwd === void 0 ? {} : { cwd: options.cwd },
 		...options.env === void 0 ? {} : { env: options.env }
 	});
-	const maxOutputBytes = options.maxOutputBytes ?? DEFAULT_MAX_OUTPUT_BYTES;
+	const maxOutputBytes = options.maxOutputBytes ?? 2097152;
 	let stdout = "";
 	let stderr = "";
 	const stdoutDecoder = new StringDecoder("utf8");
@@ -45,13 +53,13 @@ const runProcess = (command, args, options) => new Promise((resolve, reject) =>
 	};
 	const abort = () => {
 		stop();
-		finish(/* @__PURE__ */ new Error(`${label} command aborted: ${String(options.signal?.reason ?? "cancelled")}`));
+		finish(new ProcessError(`${label} command aborted: ${String(options.signal?.reason ?? "cancelled")}`, "aborted"));
 	};
 	const append = (target, chunk) => {
 		outputBytes += chunk.byteLength;
 		if (outputBytes > maxOutputBytes) {
 			stop();
-			finish(/* @__PURE__ */ new Error(`${label} output exceeded ${maxOutputBytes} bytes`));
+			finish(new ProcessError(`${label} output exceeded ${maxOutputBytes} bytes`, "output-limit"));
 			return;
 		}
 		if (target === "stdout") stdout += stdoutDecoder.write(chunk);
@@ -64,7 +72,7 @@ const runProcess = (command, args, options) => new Promise((resolve, reject) =>
 		append("stderr", chunk);
 	});
 	child.on("error", (error) => {
-		finish(/* @__PURE__ */ new Error(`failed to launch ${label} (${JSON.stringify(command)}): ${error.message}`));
+		finish(new ProcessError(`failed to launch ${label} (${JSON.stringify(command)}): ${error.message}`, "launch"));
 	});
 	child.on("close", (exitCode) => {
 		stdout += stdoutDecoder.end();
@@ -77,10 +85,10 @@ const runProcess = (command, args, options) => new Promise((resolve, reject) =>
 	});
 	const timeout = setTimeout(() => {
 		stop();
-		finish(/* @__PURE__ */ new Error(`${label} did not respond within ${options.timeoutMs}ms`));
+		finish(new ProcessError(`${label} did not respond within ${options.timeoutMs}ms`, "timeout"));
 	}, options.timeoutMs);
 	if (options.signal?.aborted === true) abort();
 	else options.signal?.addEventListener("abort", abort, { once: true });
 });
 //#endregion
-export { NORMALIZED_RELEVANCE_SCORE as n, runProcess as t };
+export { NORMALIZED_RELEVANCE_SCORE as i, ProcessError as n, runProcess as r, DEFAULT_MAX_OUTPUT_BYTES as t };

package/lib/provider-sdk.d.ts

@@ -1,5 +1,5 @@
 import { CATEGORIES, Category, EDGE_TYPES, EdgeType, INTENTS, Insight, Intent, JsonValue, MemoryBody, MemoryBodyProvider, MemoryBodyStats, MemoryGraphEdge, MemoryGraphNode, MemoryGraphSnapshot, MemoryListRequest, MemoryProviderCapabilities, MemoryProviderConfigField, MemoryProviderConfigOption, MemoryProviderConnection, MemoryProviderConnectionValue, MemoryProviderDescriptor, MemoryProviderIcon, MemoryProviderId, MemorySpace, MemorySpaceProvider, MemorySpaceStats, OpenVikingBodyConnection, OpenVikingSpaceConnection, RememberRequest, SOURCES, SearchRequest, Source } from "./contracts.js";
-import { S as ProviderSpaceStatus, _ as NORMALIZED_RELEVANCE_SCORE, a as MemorySpaceProviderHost, b as ProviderScoreSemantics, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunner, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as ProviderBodyStatus, x as ProviderSearchResult, y as ProviderMemorySpace } from "./definitions-C5y84OE6.js";
+import { C as ProviderSpaceStatus, S as ProviderSearchResult, _ as MemorySpaceNativeRunner, a as MemorySpaceProviderHost, b as ProviderMemorySpace, c as MemorySpaceProviderRuntimeContext, d as defineMemorySpaceProviderDefinition, f as MemoryProviderAdapter, g as MemorySpaceNativeRunOptions, h as MemorySpaceAuthority, i as MemorySpaceProviderEntry, l as MemorySpaceProviderScoreSemantics, m as MemoryProviderScoreSemantics, n as MemorySpaceProviderDefinition, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, r as MemorySpaceProviderDisposer, s as MemorySpaceProviderModule, t as MEMORY_SPACE_PROVIDER_API_VERSION, u as defineMemorySpaceProvider, v as NORMALIZED_RELEVANCE_SCORE, x as ProviderScoreSemantics, y as ProviderBodyStatus } from "./definitions-DwiEZSE_.js";
 //#region src/providers/http.d.ts
 interface HttpProviderOptions {
   label?: string;
@@ -50,7 +50,14 @@ interface ProcessOptions {
   label?: string | undefined;
 }
 type ProcessRunner = (command: string, args: readonly string[], options: ProcessOptions) => Promise<ProcessResult>;
+/** Why a process did not produce a result, so callers can explain each case differently. */
+type ProcessFailureReason = 'launch' | 'timeout' | 'aborted' | 'output-limit';
+declare class ProcessError extends Error {
+  readonly reason: ProcessFailureReason;
+  constructor(message: string, reason: ProcessFailureReason);
+}
+declare const DEFAULT_MAX_OUTPUT_BYTES: number;
 /** Spawn without a shell, with bounded output and cooperative cancellation. */
 declare const runProcess: ProcessRunner;
 //#endregion
-export { CATEGORIES, type Category, EDGE_TYPES, type EdgeType, HttpMemoryProvider, HttpProviderOptions, INTENTS, type Insight, type Intent, JsonRequestOptions, type JsonValue, MEMORY_SPACE_PROVIDER_API_VERSION, type MemoryBody, type MemoryBodyProvider, type MemoryBodyStats, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, MemoryProviderAdapter, MemoryProviderAdapterFactoryContext, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, MemoryProviderScoreSemantics, type MemorySpace, MemorySpaceAuthority, MemorySpaceNativeRunner, type MemorySpaceProvider, type MemorySpaceProviderDefinition, type MemorySpaceProviderDisposer, type MemorySpaceProviderEntry, type MemorySpaceProviderHost, type MemorySpaceProviderManifest, type MemorySpaceProviderModule, type MemorySpaceProviderRuntimeContext, type MemorySpaceProviderScoreSemantics, type MemorySpaceStats, NORMALIZED_RELEVANCE_SCORE, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, ProcessOptions, ProcessResult, ProcessRunner, ProviderBodyStatus, ProviderMemorySpace, ProviderScoreSemantics, ProviderSearchResult, ProviderSpaceStatus, type RememberRequest, SOURCES, type SearchRequest, type Source, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };
+export { CATEGORIES, type Category, DEFAULT_MAX_OUTPUT_BYTES, EDGE_TYPES, type EdgeType, HttpMemoryProvider, HttpProviderOptions, INTENTS, type Insight, type Intent, JsonRequestOptions, type JsonValue, MEMORY_SPACE_PROVIDER_API_VERSION, type MemoryBody, type MemoryBodyProvider, type MemoryBodyStats, type MemoryGraphEdge, type MemoryGraphNode, type MemoryGraphSnapshot, type MemoryListRequest, MemoryProviderAdapter, MemoryProviderAdapterFactoryContext, type MemoryProviderCapabilities, type MemoryProviderConfigField, type MemoryProviderConfigOption, type MemoryProviderConnection, type MemoryProviderConnectionValue, type MemoryProviderDescriptor, type MemoryProviderIcon, type MemoryProviderId, MemoryProviderScoreSemantics, type MemorySpace, MemorySpaceAuthority, MemorySpaceNativeRunOptions, MemorySpaceNativeRunner, type MemorySpaceProvider, type MemorySpaceProviderDefinition, type MemorySpaceProviderDisposer, type MemorySpaceProviderEntry, type MemorySpaceProviderHost, type MemorySpaceProviderManifest, type MemorySpaceProviderModule, type MemorySpaceProviderRuntimeContext, type MemorySpaceProviderScoreSemantics, type MemorySpaceStats, NORMALIZED_RELEVANCE_SCORE, type OpenVikingBodyConnection, type OpenVikingSpaceConnection, ProcessError, ProcessFailureReason, ProcessOptions, ProcessResult, ProcessRunner, ProviderBodyStatus, ProviderMemorySpace, ProviderScoreSemantics, ProviderSearchResult, ProviderSpaceStatus, type RememberRequest, SOURCES, type SearchRequest, type Source, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };

package/lib/provider-sdk.js

@@ -1,5 +1,5 @@
 import { CATEGORIES, EDGE_TYPES, INTENTS, SOURCES } from "./contracts.js";
-import { n as NORMALIZED_RELEVANCE_SCORE, t as runProcess } from "./process-BvrgxPNP.js";
+import { i as NORMALIZED_RELEVANCE_SCORE, n as ProcessError, r as runProcess, t as DEFAULT_MAX_OUTPUT_BYTES } from "./process-DIK9NnTg.js";
 import { i as defineMemorySpaceProviderDefinition, r as defineMemorySpaceProvider, t as MEMORY_SPACE_PROVIDER_API_VERSION } from "./definitions-DfmOqJjR.js";
 //#region src/providers/http.ts
 function jsonObject(value) {
@@ -105,4 +105,4 @@ var HttpMemoryProvider = class {
 	}
 };
 //#endregion
-export { CATEGORIES, EDGE_TYPES, HttpMemoryProvider, INTENTS, MEMORY_SPACE_PROVIDER_API_VERSION, NORMALIZED_RELEVANCE_SCORE, SOURCES, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };
+export { CATEGORIES, DEFAULT_MAX_OUTPUT_BYTES, EDGE_TYPES, HttpMemoryProvider, INTENTS, MEMORY_SPACE_PROVIDER_API_VERSION, NORMALIZED_RELEVANCE_SCORE, ProcessError, SOURCES, defineMemorySpaceProvider, defineMemorySpaceProviderDefinition, firstArray, jsonArray, jsonNumber, jsonObject, jsonString, runProcess };

package/lib/testing.d.ts

@@ -1,5 +1,5 @@
 import { MemoryProviderConnection, MemoryProviderDescriptor, MemorySpace } from "./contracts.js";
-import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-C5y84OE6.js";
+import { f as MemoryProviderAdapter, h as MemorySpaceAuthority, o as MemorySpaceProviderManifest, p as MemoryProviderAdapterFactoryContext, s as MemorySpaceProviderModule } from "./definitions-DwiEZSE_.js";
 //#region src/testing.d.ts
 interface MemorySpaceProviderTest {
   readonly registered: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-memory-spaces",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -65,13 +65,13 @@
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.19",
+    "dsh-mnemon": "^0.5.23",
     "dsh-mnemon-provider-byterover": "^0.5.5",
     "dsh-mnemon-provider-hindsight": "^0.5.5",
-    "dsh-mnemon-provider-holographic": "^0.5.5",
+    "dsh-mnemon-provider-holographic": "^0.5.6",
     "dsh-mnemon-provider-honcho": "^0.5.5",
     "dsh-mnemon-provider-mem0": "^0.5.5",
-    "dsh-mnemon-provider-mnemon-native": "^0.5.7",
+    "dsh-mnemon-provider-mnemon-native": "^0.5.8",
     "dsh-mnemon-provider-openviking": "^0.5.7",
     "dsh-mnemon-provider-retaindb": "^0.5.5",
     "dsh-mnemon-provider-supermemory": "^0.5.5",