dsh-mnemon 0.2.4 → 0.2.6

package/README.md

@@ -3,7 +3,7 @@
 <p align="center"><strong>English</strong> · <a href="./README.zh-CN.md">简体中文</a></p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/release-v0.2.4-5b5bd6" alt="release v0.2.4">
+  <img src="https://img.shields.io/badge/release-v0.2.6-5b5bd6" alt="release v0.2.6">
   <img src="https://img.shields.io/badge/memory-3%20tiers-087c5b" alt="three memory tiers">
   <img src="https://img.shields.io/badge/providers-9-c66a09" alt="nine providers">
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A520-43853d" alt="Node.js 20 or newer">
@@ -22,7 +22,7 @@
 <p align="center">
   <a href="./docs/en/capabilities.md"><strong>Explore the capability map</strong></a> ·
   <a href="./docs/en/getting-started.md">Start in five minutes</a> ·
-  <a href="./docs/en/releases/v0.2.4.md">Read the v0.2.4 notes</a> ·
+  <a href="./docs/en/releases/v0.2.6.md">Read the v0.2.6 notes</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">Watch the widescreen demo</a>
 </p>
 
@@ -190,7 +190,7 @@ See [Operations, security, and troubleshooting](./docs/en/operations.md) for bac
 | Configure scope, routing, and model selection | [Configuration](./docs/en/configuration.md) |
 | Back up, update, or troubleshoot | [Operations](./docs/en/operations.md) |
 | Integrate tools, commands, or RPC | [Interface reference](./docs/en/interfaces.md) |
-| Review the release | [v0.2.4 release notes](./docs/en/releases/v0.2.4.md) |
+| Review the release | [v0.2.6 release notes](./docs/en/releases/v0.2.6.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 

package/README.zh-CN.md

@@ -3,7 +3,7 @@
 <p align="center"><a href="./README.md">English</a> · <strong>简体中文</strong></p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/release-v0.2.4-5b5bd6" alt="发布版本 v0.2.4">
+  <img src="https://img.shields.io/badge/release-v0.2.6-5b5bd6" alt="发布版本 v0.2.6">
   <img src="https://img.shields.io/badge/%E8%AE%B0%E5%BF%86-3%20%E5%B1%82-087c5b" alt="三层记忆">
   <img src="https://img.shields.io/badge/Provider-9-c66a09" alt="九种 Provider">
   <img src="https://img.shields.io/badge/Node.js-%E2%89%A520-43853d" alt="Node.js 20 或更新版本">
@@ -22,7 +22,7 @@
 <p align="center">
   <a href="./docs/zh-CN/capabilities.md"><strong>先看能力地图</strong></a> ·
   <a href="./docs/zh-CN/getting-started.md">5 分钟开始</a> ·
-  <a href="./docs/zh-CN/releases/v0.2.4.md">v0.2.4 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.2.6.md">v0.2.6 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -190,7 +190,7 @@ dsh plugin --profile headless add "link:/absolute/path/to/dsh-mnemon"
 | 配置范围、路由与模型 | [配置参考](./docs/zh-CN/configuration.md) |
 | 备份、更新或排障 | [运维指南](./docs/zh-CN/operations.md) |
 | 接入工具、命令或 RPC | [接口参考](./docs/zh-CN/interfaces.md) |
-| 查看本次升级 | [v0.2.4 发布说明](./docs/zh-CN/releases/v0.2.4.md) |
+| 查看本次升级 | [v0.2.6 发布说明](./docs/zh-CN/releases/v0.2.6.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/client.js

@@ -243,7 +243,7 @@ window.__ModuleLoader__.load({
 				});
 			}
 			reconnectBody(memoryBodyId) {
-				return this.call(MNEMON_WRITE_CHANNEL, "body-reconnect", this.scoped({ memoryBodyId }));
+				return this.call(MNEMON_READ_CHANNEL, "body-reconnect", this.scoped({ memoryBodyId }));
 			}
 			maintainBodyMetadata(memoryBodyIds) {
 				return this.call(MNEMON_WRITE_CHANNEL, "body-metadata-maintain", this.scoped({ memoryBodyIds }));
@@ -2480,6 +2480,25 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region src/client/use-request-version.ts
+		/**
+		* Guards UI state against responses from an older request or an unmounted
+		* component. Starting a request invalidates every earlier version.
+		*/
+		function useRequestVersion() {
+			const current = (0, react.useRef)(0);
+			(0, react.useEffect)(() => () => {
+				current.current += 1;
+			}, []);
+			return (0, react.useMemo)(() => ({
+				begin: () => {
+					current.current += 1;
+					return current.current;
+				},
+				isCurrent: (version) => current.current === version
+			}), []);
+		}
+		//#endregion
 		//#region src/client/ProviderSettingsSection.tsx
 		const SAVED_SECRET_MASK = "••••••••••••";
 		const PREVIEW_CAPABILITIES = {
@@ -3004,21 +3023,26 @@ window.__ModuleLoader__.load({
 			const [catalog, setCatalog] = (0, react.useState)(() => initialCatalog ?? EMPTY_PROVIDER_CATALOG);
 			const [loading, setLoading] = (0, react.useState)(client !== null && initialCatalog === void 0);
 			const [failed, setFailed] = (0, react.useState)(null);
+			const loadRequests = useRequestVersion();
 			const load = (0, react.useCallback)(async (quiet = false) => {
 				if (client === null) return;
+				const request = loadRequests.begin();
 				if (!quiet) setLoading(true);
 				setFailed(null);
 				try {
 					const next = await client.providerServices();
+					if (!loadRequests.isCurrent(request)) return;
 					cacheCatalog(props.connection, routeKey, next);
 					setCatalog(next);
 				} catch (reason) {
+					if (!loadRequests.isCurrent(request)) return;
 					setFailed(message$1(reason));
 				} finally {
-					if (!quiet) setLoading(false);
+					if (!quiet && loadRequests.isCurrent(request)) setLoading(false);
 				}
 			}, [
 				client,
+				loadRequests,
 				props.connection,
 				routeKey
 			]);
@@ -6769,7 +6793,7 @@ window.__ModuleLoader__.load({
 				}
 			};
 			const reconnect = async (body) => {
-				if (!props.writeEnabled || reconnectingBody !== null || editingBody !== null || deletingBody !== null) return;
+				if (reconnectingBody !== null || editingBody !== null || deletingBody !== null) return;
 				setReconnectingBody(body.id);
 				setError(null);
 				setCatalog((current) => current === null ? current : {
@@ -7211,13 +7235,13 @@ window.__ModuleLoader__.load({
 									"data-active": body.active || void 0,
 									"data-healthy": !body.statusLoading && body.healthy || void 0,
 									"data-status-loading": body.statusLoading || void 0,
-									"data-reconnectable": props.writeEnabled || void 0,
+									"data-reconnectable": "",
 									"data-reconnecting": reconnectingBody === body.id || void 0,
 									"data-mnemon-default": body.mnemonDefault || void 0,
 									"data-editing": appearance.surface === "buildin" && editingBody === body.id || void 0,
-									tabIndex: props.writeEnabled ? 0 : void 0,
-									"aria-label": props.writeEnabled ? t("overview.reconnectAria", { name: body.name }) : void 0,
-									title: reconnectingBody === body.id ? t("overview.reconnecting") : body.error ?? (props.writeEnabled ? t("overview.reconnectHint") : void 0),
+									tabIndex: 0,
+									"aria-label": t("overview.reconnectAria", { name: body.name }),
+									title: reconnectingBody === body.id ? t("overview.reconnecting") : body.error ?? t("overview.reconnectHint"),
 									onClick: (event) => {
 										if (event.target instanceof Element && event.target.closest("button, input, textarea, select, label, a, [role=\"switch\"]") !== null) return;
 										reconnect(body);
@@ -7744,11 +7768,13 @@ window.__ModuleLoader__.load({
 			const [relatedLoading, setRelatedLoading] = (0, react.useState)(false);
 			const [visibleResultLimit, setVisibleResultLimit] = (0, react.useState)(pageSize);
 			const [visibleRelatedLimit, setVisibleRelatedLimit] = (0, react.useState)(pageSize);
+			const relatedRequests = useRequestVersion();
 			(0, react.useEffect)(() => {
 				if (props.seed !== "") setQuery(props.seed);
 			}, [props.seed]);
 			const runSearch = async (withAgent) => {
 				if (query.trim() === "") return;
+				relatedRequests.begin();
 				setSearchKind(withAgent ? "agent" : "direct");
 				setSearched(true);
 				setError(null);
@@ -7792,21 +7818,23 @@ window.__ModuleLoader__.load({
 			};
 			const searching = searchKind !== null;
 			const showRelated = async (insight) => {
+				const request = relatedRequests.begin();
 				setRelatedTo(insight);
 				setRelated([]);
 				setRelatedLoading(true);
 				setError(null);
 				setVisibleRelatedLimit(pageSize);
-				if (typeof window.requestAnimationFrame === "function") window.requestAnimationFrame(() => document.getElementById("mnemon-related-pane")?.scrollIntoView({
+				if (typeof window.requestAnimationFrame === "function") window.requestAnimationFrame(() => document.getElementById("mnemon-related-pane")?.scrollIntoView?.({
 					block: "nearest",
 					behavior: "smooth"
 				}));
 				try {
-					setRelated(await props.client.related(insight.id, insight.memoryBodyId));
+					const response = await props.client.related(insight.id, insight.memoryBodyId);
+					if (relatedRequests.isCurrent(request)) setRelated(response);
 				} catch (reason) {
-					setError(message(reason));
+					if (relatedRequests.isCurrent(request)) setError(message(reason));
 				} finally {
-					setRelatedLoading(false);
+					if (relatedRequests.isCurrent(request)) setRelatedLoading(false);
 				}
 			};
 			const forget = async (insight) => {
@@ -7963,7 +7991,11 @@ window.__ModuleLoader__.load({
 											className: MnemonView_module_css_default.sectionHeading,
 											children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", { children: t("search.related") }) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 												type: "button",
-												onClick: () => setRelatedTo(null),
+												onClick: () => {
+													relatedRequests.begin();
+													setRelatedTo(null);
+													setRelatedLoading(false);
+												},
 												"aria-label": t("search.closeRelated"),
 												children: "×"
 											})]
@@ -8014,20 +8046,24 @@ window.__ModuleLoader__.load({
 			const [error, setError] = (0, react.useState)(null);
 			const [visibleEntityLimit, setVisibleEntityLimit] = (0, react.useState)(entityPageSize);
 			const [visibleInsightLimit, setVisibleInsightLimit] = (0, react.useState)(insightPageSize);
+			const entityRequests = useRequestVersion();
 			const load = (0, react.useCallback)(async (selected) => {
+				const request = entityRequests.begin();
 				setLoading(true);
 				setError(null);
 				setVisibleInsightLimit(insightPageSize);
 				if (selected === void 0) setVisibleEntityLimit(entityPageSize);
 				try {
-					setView(await props.client.entities(selected, 20));
+					const response = await props.client.entities(selected, 20);
+					if (entityRequests.isCurrent(request)) setView(response);
 				} catch (reason) {
-					setError(message(reason));
+					if (entityRequests.isCurrent(request)) setError(message(reason));
 				} finally {
-					setLoading(false);
+					if (entityRequests.isCurrent(request)) setLoading(false);
 				}
 			}, [
 				entityPageSize,
+				entityRequests,
 				insightPageSize,
 				props.client
 			]);
@@ -9415,25 +9451,33 @@ window.__ModuleLoader__.load({
 			const [description, setDescription] = (0, react.useState)("");
 			const [content, setContent] = (0, react.useState)("");
 			const [sources, setSources] = (0, react.useState)("");
+			const displayRequests = useRequestVersion();
 			const display = (0, react.useCallback)(async (nextQuery, nextStatus) => {
+				const request = displayRequests.begin();
 				setLoading(true);
 				setError(null);
 				setVisibleLimit(pageSize);
 				try {
 					const current = await props.client.documents();
 					const filtered = (nextQuery.trim() === "" ? current.documents : (await props.client.searchDocuments(nextQuery, nextStatus === "archived")).results).filter((record) => record.status === nextStatus);
+					if (!displayRequests.isCurrent(request)) return;
 					setSnapshot(current);
 					setItems(filtered);
 					setSelectedId((previous) => previous !== null && filtered.some((record) => record.id === previous) ? previous : filtered[0]?.id ?? null);
 				} catch (reason) {
+					if (!displayRequests.isCurrent(request)) return;
 					setError(message(reason));
 					setSnapshot(null);
 					setItems([]);
 					setSelectedId(null);
 				} finally {
-					setLoading(false);
+					if (displayRequests.isCurrent(request)) setLoading(false);
 				}
-			}, [pageSize, props.client]);
+			}, [
+				displayRequests,
+				pageSize,
+				props.client
+			]);
 			(0, react.useEffect)(() => {
 				display(query, status);
 			}, [

package/lib/index.js

@@ -896,7 +896,7 @@ var DocumentManager = class {
 //#endregion
 //#region src/guidance.ts
 const GUIDANCE_SECTION_NAME = "mnemon:routing";
-const RUNTIME_MEMORY_SECTION_NAME = "mnemon:runtime-memory";
+const RUNTIME_MEMORY_CONTEXT_NAME = "mnemon:runtime-memory";
 const ROUTING_GUIDANCE = "Use memory only by need. For substantial project records, search active Mnemon Documents before deep recall. Call mnemon_recall when durable history may matter or an exact prior detail is missing; never infer a missing historical rule. New explicit reusable facts normally go to mnemon_runtime_memory. A write completes only with a tool receipt.";
 const RUNTIME_MEMORY_EMPTY_BRACES_VARIABLE = "mnemon_runtime_memory_empty_braces";
 const LITERAL_EMPTY_BRACES = "{{}}";
@@ -916,20 +916,20 @@ function registerGuidance(ctx, config) {
 		text: () => config?.routingGuidance === false ? "" : ROUTING_GUIDANCE
 	});
 }
-/** Inject the latest committed USER.md/MEMORY.md projections on every prompt assembly. */
+/** Project the latest committed USER.md/MEMORY.md as DSH's durable runtime-context snapshot. */
 function registerRuntimeMemoryContext(ctx, runtimeMemory) {
 	const prompt = systemPrompt(ctx);
 	prompt?.variable?.(RUNTIME_MEMORY_EMPTY_BRACES_VARIABLE, () => LITERAL_EMPTY_BRACES);
-	prompt?.section?.({
-		name: RUNTIME_MEMORY_SECTION_NAME,
+	prompt?.context?.({
+		name: RUNTIME_MEMORY_CONTEXT_NAME,
 		order: 145,
 		text: () => runtimeMemoryPromptText(runtimeMemory)
 	});
 }
 /** Shadow the global fallback with the current Agent workspace's hot memory. */
 function registerAgentRuntimeMemoryContext(agent, runtimeMemory) {
-	const dispose = scopedSystemPrompt(agent)?.section?.({
-		name: RUNTIME_MEMORY_SECTION_NAME,
+	const dispose = scopedSystemPrompt(agent)?.context?.({
+		name: RUNTIME_MEMORY_CONTEXT_NAME,
 		order: 145,
 		text: () => runtimeMemoryPromptText(runtimeMemory())
 	});
@@ -3765,7 +3765,7 @@ function number$1(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
 function delay(ms, signal) {
-	if (signal?.aborted === true) return Promise.reject(signal.reason);
+	if (signal?.aborted === true) return Promise.reject(signal.reason ?? /* @__PURE__ */ new Error("OpenViking request aborted"));
 	return new Promise((resolve, reject) => {
 		const aborted = () => {
 			clearTimeout(timer);
@@ -4005,6 +4005,7 @@ var OpenVikingProvider = class {
 		return this.requestConnection(connection, path, init, options);
 	}
 	async requestConnection(connection, path, init = {}, options = {}) {
+		options.signal?.throwIfAborted();
 		const controller = new AbortController();
 		const relay = () => controller.abort(options.signal?.reason);
 		options.signal?.addEventListener("abort", relay, { once: true });
@@ -4100,6 +4101,7 @@ var HttpMemoryProvider = class {
 		const label = memoryProviderDescriptor(this.id).label;
 		if (endpoint === "") throw new Error(`${label} endpoint is not configured`);
 		if (!path.startsWith("/")) throw new Error(`${label} request path must be absolute`);
+		options.signal?.throwIfAborted();
 		const controller = new AbortController();
 		const relay = () => controller.abort(options.signal?.reason);
 		options.signal?.addEventListener("abort", relay, { once: true });
@@ -5777,7 +5779,6 @@ var MnemonService = class {
 		}
 	}
 	async reconnectBody(id, signal) {
-		this.assertWritable();
 		const body = this.memoryBodies.list().find((candidate) => candidate.id === id);
 		if (body === void 0) throw new Error(`unknown memory body: ${id}`);
 		if (body.provider.id !== "mnemon-native") {
@@ -9142,6 +9143,7 @@ function createReadHandler(input, lifecycle, runtimeMemory, storage, versions) {
 				case "graph": return success$1(await service.graph(void 0, Array.isArray(payload.memoryBodyIds) ? payload.memoryBodyIds.map(String) : void 0));
 				case "bodies": return success$1(await service.bodies());
 				case "body-directory": return success$1(service.bodyDirectory());
+				case "body-reconnect": return success$1(await service.reconnectBody(String(payload.memoryBodyId ?? "")));
 				case "provider-services": return success$1(service.memoryBodies.providerServices());
 				case "list": return success$1(await service.list({
 					...payload.query === void 0 ? {} : { query: String(payload.query) },

package/lib/types/client/use-request-version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Guards UI state against responses from an older request or an unmounted
+ * component. Starting a request invalidates every earlier version.
+ */
+export declare function useRequestVersion(): {
+    begin: () => number;
+    isCurrent: (version: number) => boolean;
+};

package/lib/types/guidance.d.ts

@@ -2,10 +2,10 @@ import type { HostAgent, HostContextShape } from './contracts.ts';
 import type { ResolvedConfig } from './config.ts';
 import type { RuntimeMemoryController } from './runtime-memory.ts';
 export declare const GUIDANCE_SECTION_NAME = "mnemon:routing";
-export declare const RUNTIME_MEMORY_SECTION_NAME = "mnemon:runtime-memory";
+export declare const RUNTIME_MEMORY_CONTEXT_NAME = "mnemon:runtime-memory";
 export declare const ROUTING_GUIDANCE = "Use memory only by need. For substantial project records, search active Mnemon Documents before deep recall. Call mnemon_recall when durable history may matter or an exact prior detail is missing; never infer a missing historical rule. New explicit reusable facts normally go to mnemon_runtime_memory. A write completes only with a tool receipt.";
 export declare function registerGuidance(ctx: HostContextShape, config?: Pick<ResolvedConfig, 'routingGuidance'>): void;
-/** Inject the latest committed USER.md/MEMORY.md projections on every prompt assembly. */
+/** Project the latest committed USER.md/MEMORY.md as DSH's durable runtime-context snapshot. */
 export declare function registerRuntimeMemoryContext(ctx: HostContextShape, runtimeMemory: RuntimeMemoryController): void;
 /** Shadow the global fallback with the current Agent workspace's hot memory. */
 export declare function registerAgentRuntimeMemoryContext(agent: HostAgent, runtimeMemory: () => RuntimeMemoryController): () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Three-tier memory control plane for DeepSeek Harness: persistent runtime context, searchable project documents, pluggable long-term memory, smart routing, supervised agent workflows, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",