dsh-mnemon-source-memory-spaces 0.5.9 → 0.5.11

package/lib/contracts.d.ts

@@ -19,7 +19,7 @@ interface MemoryProviderConfigField {
   label: string;
   /** Optional Host-provided translation key; clients fall back to label. */
   i18nKey?: string;
-  /** Service fields are configured once in Settings; memory fields belong to each Memory Space. */
+  /** Service fields are configured once on the dsh-mnemon page under Plugins; memory fields belong to each Memory Space. */
   scope: 'service' | 'memory';
   /** A reusable local data location presented with the same default/custom scope UI as Mnemon Native. */
   role?: 'global-location';
@@ -60,6 +60,8 @@ interface MemoryPersistenceStrategy {
 interface ResolvedMemoryPersistenceStrategy {
   mode: 'manual' | 'automatic';
   providerId: MemoryProviderId;
+  /** Set when no provider was chosen; manual mode then uses whichever provider is ready. */
+  providerDefaulted?: true;
   prompt: string;
   rules: {
     allowedProviderIds: MemoryProviderId[];

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 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 z from "schemastery";
+import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts
 interface MemorySpacesConfig {

package/lib/index.js

@@ -5,8 +5,8 @@ import { t as runProcess } from "./process-BvrgxPNP.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";
-import { basename, dirname, isAbsolute, join, resolve } from "node:path";
-import z from "schemastery";
+import { basename, dirname, isAbsolute, join } from "node:path";
+import z from "@deepseek-ai/schemastery";
 import { createMemoryMutationReceipt, defineMemoryPlugin, defineMemorySource, installMemory, memoryConfigurationDigest, memoryInputInteger, memoryInputRecord, memoryInputStringArray, memoryInputText, truncateMemoryText, withMemoryStorageLock } from "dsh-mnemon/extension-sdk";
 import { createHash, randomUUID } from "node:crypto";
 import { COMPOSABLE_MEMORY_API_VERSION } from "dsh-mnemon/contracts";
@@ -273,17 +273,6 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 		if (body === void 0) throw new Error(`unknown memory space: ${normalized}`);
 		return body;
 	}
-	openVikingConnection(id) {
-		const connection = this.providerConnection(id, "openviking");
-		return {
-			endpoint: String(connection.endpoint ?? ""),
-			targetUri: String(connection.targetUri ?? ""),
-			apiKey: String(connection.apiKey ?? ""),
-			account: String(connection.account ?? ""),
-			user: String(connection.user ?? ""),
-			actorPeerId: String(connection.actorPeerId ?? "")
-		};
-	}
 	providerConnection(id, expectedProviderId) {
 		this.refreshIfChanged();
 		const normalized = validateMemorySpaceId(id);
@@ -308,6 +297,15 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 	providerServiceEnabled(providerId) {
 		return this.isNative(providerId) ? this.runner.commandFound : this.providerServiceConfigured(providerId) && this.serviceEnabled[providerId] === true;
 	}
+	/**
+	* The provider used when none is named: Mnemon Native while its CLI is
+	* available, which keeps the long-standing default, otherwise the first
+	* other provider, in catalog order, that can take writes now.
+	*/
+	defaultProviderId() {
+		const ready = this.providerCatalog.providers.filter((provider) => this.providerServiceEnabled(provider.id));
+		return (ready.find((provider) => this.isNative(provider.id)) ?? ready[0])?.id;
+	}
 	providerServices(options = {}) {
 		this.refreshIfChanged();
 		const providers = this.providerCatalog.providers.filter((provider) => (provider.typeId ?? provider.id) !== "mnemon-native");
@@ -430,7 +428,8 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 		const description = requiredText(request.description, "description", 1e3);
 		if (request.placement !== void 0 && placement === void 0) throw new Error("automatic provider placement must be resolved before creating a Memory Space");
 		if (placement !== void 0 && request.providerId !== void 0 && request.providerId !== placement.providerId) throw new Error("resolved provider placement conflicts with providerId");
-		const providerId = placement?.providerId ?? request.providerId ?? "mnemon-native";
+		const providerId = placement?.providerId ?? request.providerId ?? this.defaultProviderId();
+		if (providerId === void 0) throw new Error("No memory provider is ready: install the Mnemon CLI to use Mnemon Native, or connect another provider on the dsh-mnemon page under Plugins");
 		if (!this.providerCatalog.has(providerId)) throw new Error(`unsupported memory provider: ${String(providerId)}`);
 		const normalizedPlacement = placement === void 0 ? void 0 : normalizePlacementDecision(placement, providerId, this.providerCatalog);
 		if (placement !== void 0 && normalizedPlacement === void 0) throw new Error("resolved provider placement is invalid");
@@ -447,7 +446,7 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 				this.services[providerId] = this.providerCatalog.normalizeService(providerId, split.service, this.services[providerId] ?? {});
 				this.serviceEnabled[providerId] = true;
 			}
-			if (!this.providerServiceEnabled(providerId)) throw new Error(`${this.providerCatalog.descriptor(providerId).label} service is not enabled; enable it in Settings first`);
+			if (!this.providerServiceEnabled(providerId)) throw new Error(`${this.providerCatalog.descriptor(providerId).label} service is not enabled; enable it on the dsh-mnemon page under Plugins first`);
 			connection = this.providerCatalog.normalizeMemory(providerId, split.memory);
 			this.providerCatalog.normalize(providerId, {
 				...this.services[providerId],
@@ -502,7 +501,7 @@ var MemorySpaceRegistry = class MemorySpaceRegistry {
 				this.services[current.providerId] = this.providerCatalog.normalizeService(current.providerId, split.service, this.services[current.providerId] ?? {}, clearSecrets);
 				this.serviceEnabled[current.providerId] = true;
 			}
-			if (!this.providerServiceEnabled(current.providerId)) throw new Error(`${this.providerCatalog.descriptor(current.providerId).label} service is not enabled; enable it in Settings first`);
+			if (!this.providerServiceEnabled(current.providerId)) throw new Error(`${this.providerCatalog.descriptor(current.providerId).label} service is not enabled; enable it on the dsh-mnemon page under Plugins first`);
 			connection = this.providerCatalog.normalizeMemory(current.providerId, split.memory, previousConnection);
 			this.providerCatalog.normalize(current.providerId, {
 				...this.services[current.providerId],
@@ -1286,11 +1285,6 @@ function insightColor(category) {
 	if (category === "context") return "#f39c12";
 	return "#6574d9";
 }
-function boundedInteger(value, fallback, min, max) {
-	if (value === void 0) return fallback;
-	if (!Number.isInteger(value) || value < min || value > max) throw new Error(`value must be an integer within ${min}..${max}`);
-	return value;
-}
 function required(value, label, max) {
 	const normalized = value.trim();
 	if (normalized === "") throw new Error(`${label} is required`);
@@ -1376,8 +1370,6 @@ var MemorySpacesService = class {
 	recallQualityPolicyRegistry;
 	providerCatalog;
 	memorySpaces;
-	/** @deprecated Use memorySpaces. Both names share the same registry authority. */
-	memoryBodies;
 	providers;
 	recallQualityPolicy;
 	spacesInFlight;
@@ -1400,7 +1392,6 @@ var MemorySpacesService = class {
 		this.recallQualityPolicyRegistry = recallQualityPolicyRegistry;
 		this.providerCatalog = providerCatalog;
 		this.memorySpaces = memorySpaces === void 0 ? new MemorySpaceRegistry(runner, true, () => /* @__PURE__ */ new Date(), providerCatalog) : providerCatalog === EMPTY_MEMORY_PROVIDER_CATALOG ? memorySpaces : memorySpaces.withProviderCatalog(providerCatalog);
-		this.memoryBodies = this.memorySpaces;
 		this.recallQualityPolicy = recallQualityPolicyRegistry.resolve(config.recallQuality.policy);
 		this.providers = providerAdapterRegistry.create({
 			memorySpaces: this.memorySpaces,
@@ -1440,7 +1431,7 @@ var MemorySpacesService = class {
 			let status;
 			if (!(body.providerEnabled !== false)) status = {
 				healthy: false,
-				error: `${body.provider.label} is disabled in Settings`
+				error: `${body.provider.label} is disabled on the dsh-mnemon page under Plugins`
 			};
 			else try {
 				status = await this.providerFor(body).status(body, signal);
@@ -1483,11 +1474,11 @@ var MemorySpacesService = class {
 			items,
 			providers: this.providerCatalog.providers.map((provider) => ({
 				...provider,
-				serviceConfigured: (provider.typeId ?? provider.id) === "mnemon-native" || enabled.has(provider.id)
+				serviceConfigured: (provider.typeId ?? provider.id) === "mnemon-native" ? this.runner.commandFound : enabled.has(provider.id)
 			})),
 			persistenceStrategy: {
 				mode: this.config.persistenceStrategy.mode,
-				providerId: this.config.persistenceStrategy.providerId,
+				providerId: this.persistenceProviderId() ?? this.config.persistenceStrategy.providerId,
 				prompt: this.config.persistenceStrategy.prompt,
 				rules: { ...this.config.persistenceStrategy.rules }
 			},
@@ -1586,9 +1577,9 @@ var MemorySpacesService = class {
 		};
 	}
 	async status(signal) {
-		const hasNativeSpace = this.memorySpaces.list().some((body) => this.isNativeSpace(body));
+		const nativeInUse = this.runner.commandFound || this.memorySpaces.list().some((body) => this.isNativeSpace(body));
 		let versionError;
-		const [catalog, rawVersion] = await Promise.all([this.spaces(signal), hasNativeSpace ? this.runner.runText(["--version"], signal === void 0 ? { globalFlags: false } : {
+		const [catalog, rawVersion] = await Promise.all([this.spaces(signal), nativeInUse ? this.runner.runText(["--version"], signal === void 0 ? { globalFlags: false } : {
 			signal,
 			globalFlags: false
 		}).catch((error) => {
@@ -1630,7 +1621,6 @@ var MemorySpacesService = class {
 			providerServices
 		};
 		try {
-			if (versionError !== void 0) throw versionError;
 			const healthySpaces = active.filter((body) => body.healthy && body.stats !== void 0);
 			const topEntities = /* @__PURE__ */ new Map();
 			const byCategory = {};
@@ -1651,13 +1641,13 @@ var MemorySpacesService = class {
 				})).sort((left, right) => right.count - left.count),
 				...active.length === 1 ? { dbPath: active[0].dbPath } : {}
 			};
-			const failed = active.filter((body) => !body.healthy);
+			const errors = [...versionError === void 0 ? [] : [versionError instanceof Error ? versionError.message : String(versionError)], ...active.filter((body) => !body.healthy).map((body) => `${body.name}: ${body.error ?? "unavailable"}`)];
 			return {
 				healthy: true,
 				...base,
 				...rawVersion === void 0 ? {} : { version: rawVersion.trim().replace(/^mnemon version\s+/i, "") },
 				stats,
-				...failed.length === 0 ? {} : { error: failed.map((body) => `${body.name}: ${body.error ?? "unavailable"}`).join("; ") }
+				...errors.length === 0 ? {} : { error: errors.join("; ") }
 			};
 		} catch (error) {
 			return {
@@ -1671,7 +1661,7 @@ var MemorySpacesService = class {
 		const body = this.memorySpaces.list().find((candidate) => candidate.id === id);
 		if (body === void 0) throw new Error(`unknown memory space: ${id}`);
 		if (!this.isNativeSpace(body)) {
-			if (!this.memorySpaces.providerServiceEnabled(body.provider.id)) throw new Error(`${body.provider.label} is disabled in Settings`);
+			if (!this.memorySpaces.providerServiceEnabled(body.provider.id)) throw new Error(`${body.provider.label} is disabled on the dsh-mnemon page under Plugins`);
 		}
 		const provider = this.providerFor(body);
 		provider.invalidateStatus?.(body.id);
@@ -1685,7 +1675,7 @@ var MemorySpacesService = class {
 	}
 	async search(request, signal) {
 		const query = required(request.query, "query", 2e3);
-		const limit = boundedInteger(request.limit, this.config.defaultRecallLimit, 1, 50);
+		const limit = memoryInputInteger(request.limit, this.config.defaultRecallLimit, 1, 50);
 		const qualityContext = {
 			requestedLimit: limit,
 			config: this.config.recallQuality
@@ -1939,7 +1929,7 @@ var MemorySpacesService = class {
 		const query = rawQuery.toLocaleLowerCase();
 		if (rawQuery.length > 500) throw new Error("query is too long (max 500 characters)");
 		const category = allowed(request.category, CATEGORIES$1, "category");
-		const limit = boundedInteger(request.limit, 200, 1, 1e3);
+		const limit = memoryInputInteger(request.limit, 200, 1, 1e3);
 		const spaces = this.readSpaces(request.memoryBodyIds);
 		const batches = await Promise.all(spaces.map(async (body) => {
 			const mode = body.provider.capabilities.browse ? "enumerable" : body.provider.capabilities.search ? "query-only" : "unsupported";
@@ -2015,7 +2005,7 @@ var MemorySpacesService = class {
 			insights: readableIds.length === 0 ? [] : (await this.search({
 				query: selected,
 				intent: "ENTITY",
-				limit: boundedInteger(limit, 20, 1, 50),
+				limit: memoryInputInteger(limit, 20, 1, 50),
 				memoryBodyIds: readableIds
 			}, signal)).results,
 			sources
@@ -2072,7 +2062,7 @@ var MemorySpacesService = class {
 		const selectedEdge = allowed(edge, EDGE_TYPES, "edge");
 		const provider = this.providerFor(body);
 		if (provider.related === void 0 || !body.provider.capabilities.related) throw new Error(`${body.provider.label} does not support related-memory traversal`);
-		return (await provider.related(body, required(id, "id", 2e3), boundedInteger(depth, 2, 1, 5), selectedEdge, signal)).map((entry) => this.annotate(entry, body));
+		return (await provider.related(body, required(id, "id", 2e3), memoryInputInteger(depth, 2, 1, 5), selectedEdge, signal)).map((entry) => this.annotate(entry, body));
 	}
 	async link(sourceId, targetId, type = "semantic", weight = .5, reason, signal, memoryBodyId) {
 		this.assertWritable();
@@ -2114,11 +2104,12 @@ var MemorySpacesService = class {
 	}) {
 		const strategy = this.config.persistenceStrategy;
 		if (strategy.mode === "manual") {
-			const connection = strategy.providerConnections[strategy.providerId];
+			const providerId = this.persistenceProviderId();
+			const connection = providerId === void 0 ? void 0 : strategy.providerConnections[providerId];
 			return this.createSpace({
 				...body,
-				providerId: strategy.providerId,
-				...this.isNativeProvider(strategy.providerId) || connection === void 0 ? {} : { connection }
+				...providerId === void 0 ? {} : { providerId },
+				...providerId === void 0 || this.isNativeProvider(providerId) || connection === void 0 ? {} : { connection }
 			}, signal);
 		}
 		const request = {
@@ -2138,6 +2129,11 @@ var MemorySpacesService = class {
 		}, delegation);
 		return this.createSpace(request, signal, decision);
 	}
+	/** A chosen provider stays fixed; the built-in default follows whichever provider is ready. */
+	persistenceProviderId() {
+		const strategy = this.config.persistenceStrategy;
+		return strategy.providerDefaulted === true ? this.memorySpaces.defaultProviderId() : strategy.providerId;
+	}
 	async updateProviderService(providerId, settings, clearSecrets = [], enabled = true, signal) {
 		this.assertWritable();
 		if (this.isNativeProvider(providerId)) throw new Error("Mnemon Native service settings are managed by the native configuration");
@@ -2263,7 +2259,7 @@ var MemorySpacesService = class {
 		return [...new Set(ids.map((id) => id.trim()).filter((id) => id !== ""))].map((id) => {
 			const body = this.memorySpaces.get(id);
 			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 in Settings`);
+			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;
 		});
 	}
@@ -2271,7 +2267,7 @@ var MemorySpacesService = class {
 		if (id !== void 0 && id.trim() !== "") {
 			const body = this.memorySpaces.get(id);
 			if (!body.active) throw new Error(`memory space is not active for reading: ${body.id}`);
-			if (!this.isNativeSpace(body) && !this.memorySpaces.providerServiceEnabled(body.provider.id)) throw new Error(`${body.provider.label} is disabled in Settings`);
+			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;
 		}
 		const active = this.memorySpaces.active();
@@ -2281,7 +2277,7 @@ var MemorySpacesService = class {
 	writeSpace(id) {
 		if (id !== void 0 && id.trim() !== "") {
 			const body = this.memorySpaces.get(id);
-			if (!this.isNativeSpace(body) && !this.memorySpaces.providerServiceEnabled(body.provider.id)) throw new Error(`${body.provider.label} is disabled in Settings`);
+			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;
 		}
 		const active = this.memorySpaces.active();
@@ -2291,7 +2287,7 @@ var MemorySpacesService = class {
 	prepareRemember(request) {
 		const body = this.writeSpace(request.memoryBodyId);
 		const content = required(request.content, "content", 8192);
-		const importance = boundedInteger(request.importance, 3, 1, 5);
+		const importance = memoryInputInteger(request.importance, 3, 1, 5);
 		const category = allowed(request.category, CATEGORIES$1, "category") ?? "general";
 		const source = allowed(request.source, SOURCES$1, "source") ?? "user";
 		const tags = commaList(request.tags, "tags", 20)?.split(",");
@@ -2337,60 +2333,13 @@ var MemorySpacesService = class {
 	assertWritable() {
 		if (!this.config.writeEnabled) throw new Error("dsh-mnemon is configured read-only (writeEnabled: false)");
 	}
-	/** @deprecated Use spaces. */
-	bodies(...args) {
-		return this.spaces(...args);
-	}
-	/** @deprecated Use spaceDirectory. */
-	bodyDirectory(...args) {
-		return this.spaceDirectory(...args);
-	}
-	/** @deprecated Use reconnectSpace. */
-	reconnectBody(...args) {
-		return this.reconnectSpace(...args);
-	}
-	/** @deprecated Use prepareSpacePlacement. */
-	prepareBodyPlacement(...args) {
-		return this.prepareSpacePlacement(...args);
-	}
-	/** @deprecated Use createSpace. */
-	createBody(...args) {
-		return this.createSpace(...args);
-	}
-	/** @deprecated Use createSpaceForPersistence. */
-	createBodyForPersistence(...args) {
-		return this.createSpaceForPersistence(...args);
-	}
-	/** @deprecated Use updateSpace. */
-	updateBody(...args) {
-		return this.updateSpace(...args);
-	}
-	/** @deprecated Use updateSpaceMetadata. */
-	updateBodyMetadata(...args) {
-		return this.updateSpaceMetadata(...args);
-	}
-	/** @deprecated Use deleteSpace. */
-	deleteBody(...args) {
-		return this.deleteSpace(...args);
-	}
-	/** @deprecated Use mergeSpaces. */
-	mergeBodies(...args) {
-		return this.mergeSpaces(...args);
-	}
 };
 //#endregion
 //#region src/runner.ts
-function expandHome(path) {
-	return path === "~" ? homedir() : path.startsWith("~/") || path.startsWith("~\\") ? join(homedir(), path.slice(2)) : path;
-}
 var MnemonCliError = class extends Error {
-	exitCode;
-	stderr;
-	constructor(message, exitCode = null, stderr = "") {
+	constructor(message) {
 		super(message);
 		this.name = "MnemonCliError";
-		this.exitCode = exitCode;
-		this.stderr = stderr;
 	}
 };
 const EMBEDDING_ENVIRONMENT_KEYS = /* @__PURE__ */ new Set([
@@ -2410,20 +2359,15 @@ function processEnvironment(config) {
 		...config.embedding.protocol === "auto" ? {} : { MNEMON_EMBED_PROTOCOL: config.embedding.protocol }
 	};
 }
-function createRunner(config, processRunner = runProcess, workspaceRoot) {
+function createRunner(config, processRunner = runProcess) {
 	const currentCommand = () => findMnemonCommand(config) ?? config.cliPath ?? "mnemon";
 	const globalArgs = (store) => {
-		const args = [];
-		if (config.storageScope !== "global" || config.dataDir !== void 0) args.push("--data-dir", effectiveDataDir());
+		const args = ["--data-dir", effectiveDataDir()];
 		if (store !== void 0) args.push("--store", store);
 		else if (config.store !== void 0) args.push("--store", config.store);
 		return args;
 	};
-	const effectiveDataDir = () => {
-		if (config.storageScope === "workspace") return resolve(workspaceRoot ?? process.cwd(), ".mnemon");
-		if (config.storageScope === "custom") return expandHome(config.dataDir);
-		return expandHome(process.env.MNEMON_DATA_DIR?.trim() || "~/.mnemon");
-	};
+	const effectiveDataDir = () => config.dataDir;
 	const persistedStore = () => {
 		const active = join(effectiveDataDir(), "active");
 		if (existsSync(active)) try {
@@ -2454,7 +2398,7 @@ function createRunner(config, processRunner = runProcess, workspaceRoot) {
 		}
 		if (result.exitCode !== 0) {
 			const detail = result.stderr.trim() || result.stdout.trim() || "no output";
-			throw new MnemonCliError(`mnemon ${args.join(" ")} exited ${String(result.exitCode)}: ${detail}`, result.exitCode, result.stderr);
+			throw new MnemonCliError(`mnemon ${args.join(" ")} exited ${String(result.exitCode)}: ${detail}`);
 		}
 		return result.stdout;
 	};
@@ -2469,7 +2413,6 @@ function createRunner(config, processRunner = runProcess, workspaceRoot) {
 			const found = findMnemonCommand(config);
 			return found !== void 0 && isMnemonExecutable(found);
 		},
-		config,
 		async runJson(args, options) {
 			const stdout = await execute(args, options);
 			try {
@@ -2486,9 +2429,6 @@ function createRunner(config, processRunner = runProcess, workspaceRoot) {
 				return outputs;
 			});
 		},
-		withExclusive(operation) {
-			return withMemoryStorageLock(effectiveDataDir(), operation);
-		},
 		effectiveDataDir() {
 			return effectiveDataDir();
 		},
@@ -2561,6 +2501,7 @@ function resolvePersistenceStrategy(value) {
 	return {
 		mode,
 		providerId,
+		...value?.providerId === void 0 ? { providerDefaulted: true } : {},
 		prompt,
 		rules: {
 			allowedProviderIds,
@@ -3365,7 +3306,6 @@ function createMemorySpacesSource(providerSnapshot, config = {}) {
 		}
 	});
 }
-/** Empty template; actual installations must provide explicit Provider children. */
 //#endregion
 //#region src/index.ts
 const name = "dsh-mnemon-source-memory-spaces";
@@ -3377,8 +3317,8 @@ const memoryPlugin = defineMemoryPlugin({
 		"zh-CN": "记忆空间"
 	},
 	description: {
-		en: "Durable evidence backed by explicitly configured Provider children.",
-		"zh-CN": "由显式配置的 Provider 子插件承载的长期证据。"
+		en: "Provider-backed durable evidence recalled on demand across tasks and sessions.",
+		"zh-CN": "由 Provider 支撑的持久证据，按需跨任务与会话召回。"
 	},
 	roles: ["source"],
 	provides: [{ id: "source" }, { id: "source.durable-evidence" }]
@@ -3392,27 +3332,25 @@ const Config = z.intersect([MemorySpacesConfig, z.object({ providers: z.array(z.
 function sourceInstanceId(ctx, explicit) {
 	const configured = explicit?.trim();
 	if (configured !== void 0 && configured !== "") return configured;
-	const located = (typeof ctx.get === "function" ? ctx.get("loader", false) : void 0)?.locate(ctx.fiber)?.trim();
+	const located = ctx.get("loader", false)?.locate(ctx.fiber)?.trim();
 	if (located !== void 0 && located !== "") return located;
-	const entryId = ctx.fiber.entry?.options?.id;
-	if (typeof entryId === "string" && entryId.trim() !== "") return entryId.trim();
 	throw new Error("Memory Spaces requires a stable Loader Entry id; pass instanceId for a direct mount");
 }
 function importedProviderModule(loader, value, specifier) {
-	const unwrapped = loader.unwrapExports?.(value) ?? (typeof value === "object" && value !== null && "default" in value ? value.default : value);
+	const unwrapped = loader.unwrapExports(value);
 	if (typeof unwrapped !== "object" || unwrapped === null) throw new Error(`Memory Space Provider module ${specifier} did not export a typed child module`);
 	return defineMemorySpaceProvider(unwrapped);
 }
 /** Resolve only the explicitly listed children; no dependency scanning occurs. */
 async function resolveMemorySpaceProviderEntries(ctx, declarations) {
 	if (declarations.length === 0) throw new Error("Memory Spaces requires at least one explicit Provider child");
-	const loader = typeof ctx.get === "function" ? ctx.get("loader", false) : void 0;
+	const loader = ctx.get("loader", false);
 	const entries = [];
 	const instanceIds = /* @__PURE__ */ new Set();
 	for (const declaration of declarations) {
 		const use = (typeof declaration === "string" ? declaration : declaration.use).trim();
 		if (use === "") throw new Error("Memory Space Provider declaration use is required");
-		if (loader?.import === void 0) throw new Error("cannot resolve installed Memory Space Provider module without the DSH Loader: " + use);
+		if (loader === void 0) throw new Error("cannot resolve installed Memory Space Provider module without the DSH Loader: " + use);
 		const module = importedProviderModule(loader, await loader.import(use), use);
 		const entry = {
 			instanceId: typeof declaration === "string" ? module.id : declaration.instanceId?.trim() || module.id,

package/lib/types/client/pages.d.ts

@@ -36,6 +36,7 @@ export declare function ExplorePage(props: {
     seed: string;
     writeEnabled: boolean;
     onForget: (insight: Insight) => Promise<void>;
+    onRevealElement?(element: HTMLElement): void;
 }): JSX.Element;
 export declare function EntitiesPage(props: {
     client: MemorySpacesPageClient;

package/lib/types/client/provider-presentation.d.ts

@@ -1,6 +1,5 @@
 import type { MemoryProviderConfigField, MemoryProviderDescriptor } from '../contracts.ts';
 import type { MnemonTranslate } from 'dsh-mnemon/client';
-export declare function providerDisplayLabel(_providerId: string, label: string): string;
 export declare function providerSummary(t: MnemonTranslate, provider: MemoryProviderDescriptor): string;
 export declare function providerFieldLabel(t: MnemonTranslate, field: MemoryProviderConfigField): string;
 export declare function providerOptionLabel(t: MnemonTranslate, option: NonNullable<MemoryProviderConfigField['options']>[number]): string;

package/lib/types/contracts.d.ts

@@ -25,7 +25,7 @@ export interface MemoryProviderConfigField {
     label: string;
     /** Optional Host-provided translation key; clients fall back to label. */
     i18nKey?: string;
-    /** Service fields are configured once in Settings; memory fields belong to each Memory Space. */
+    /** Service fields are configured once on the dsh-mnemon page under Plugins; memory fields belong to each Memory Space. */
     scope: 'service' | 'memory';
     /** A reusable local data location presented with the same default/custom scope UI as Mnemon Native. */
     role?: 'global-location';
@@ -66,6 +66,8 @@ export interface MemoryPersistenceStrategy {
 export interface ResolvedMemoryPersistenceStrategy {
     mode: 'manual' | 'automatic';
     providerId: MemoryProviderId;
+    /** Set when no provider was chosen; manual mode then uses whichever provider is ready. */
+    providerDefaulted?: true;
     prompt: string;
     rules: {
         allowedProviderIds: MemoryProviderId[];

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Memory Spaces",
+    "description": "Provider-backed durable evidence recalled on demand across tasks and sessions."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "记忆空间",
+    "description": "由 Provider 支撑的持久证据，按需跨任务与会话召回。"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon-source-memory-spaces",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "description": "Memory Spaces Source and its private Provider SDK.",
   "license": "MIT",
   "type": "module",
@@ -17,6 +17,7 @@
       "default": "./lib/provider-sdk.js"
     },
     "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
     "./testing": {
       "types": "./lib/testing.d.ts",
       "default": "./lib/testing.js"
@@ -39,6 +40,7 @@
   },
   "files": [
     "lib",
+    "locale",
     "README.md",
     "presentation"
   ],
@@ -49,29 +51,30 @@
     "verify": "pnpm typecheck && pnpm test && pnpm build"
   },
   "dependencies": {
-    "schemastery": "^3.18.0"
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
     "dsh-mnemon": "^0.5.1",
     "react": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",
     "@types/react-dom": "^18.3.0",
-    "dsh-mnemon": "^0.5.14",
-    "dsh-mnemon-provider-byterover": "^0.5.4",
-    "dsh-mnemon-provider-hindsight": "^0.5.4",
-    "dsh-mnemon-provider-holographic": "^0.5.4",
-    "dsh-mnemon-provider-honcho": "^0.5.4",
-    "dsh-mnemon-provider-mem0": "^0.5.4",
-    "dsh-mnemon-provider-mnemon-native": "^0.5.5",
-    "dsh-mnemon-provider-openviking": "^0.5.6",
-    "dsh-mnemon-provider-retaindb": "^0.5.4",
-    "dsh-mnemon-provider-supermemory": "^0.5.4",
+    "dsh-mnemon": "^0.5.17",
+    "dsh-mnemon-provider-byterover": "^0.5.5",
+    "dsh-mnemon-provider-hindsight": "^0.5.5",
+    "dsh-mnemon-provider-holographic": "^0.5.5",
+    "dsh-mnemon-provider-honcho": "^0.5.5",
+    "dsh-mnemon-provider-mem0": "^0.5.5",
+    "dsh-mnemon-provider-mnemon-native": "^0.5.6",
+    "dsh-mnemon-provider-openviking": "^0.5.7",
+    "dsh-mnemon-provider-retaindb": "^0.5.5",
+    "dsh-mnemon-provider-supermemory": "^0.5.5",
     "jsdom": "^26.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
@@ -94,7 +97,14 @@
     "micromark-util-classify-character": "^2.0.1",
     "micromark-util-sanitize-uri": "^2.0.1",
     "micromark-util-symbol": "^2.0.1",
-    "shiki": "^4.3.1"
+    "shiki": "^4.3.1",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
+    "diff": "^9.0.0",
+    "immer": "^10.1.1",
+    "simple-icons": "16.31.0",
+    "zustand": "~4.4.7"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -103,9 +113,6 @@
   },
   "dsh": {
     "client": {
-      "inject": [
-        "slots"
-      ],
       "platform": "web",
       "external": [
         "dsh-mnemon/client"