dsh-mnemon 0.2.9 → 0.2.10

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.9-5b5bd6" alt="release v0.2.9">
+  <img src="https://img.shields.io/badge/release-v0.2.10-5b5bd6" alt="release v0.2.10">
   <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.9.md">Read the v0.2.9 notes</a> ·
+  <a href="./docs/en/releases/v0.2.10.md">Read the v0.2.10 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.9 release notes](./docs/en/releases/v0.2.9.md) |
+| Review the release | [v0.2.10 release notes](./docs/en/releases/v0.2.10.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 
@@ -203,6 +203,8 @@ pnpm run verify
 
 `verify` runs TypeScript checks, Vitest, a reproducible double build, an isolated real Headless-profile activation check, and published-package validation. `lib/` is generated and intentionally not tracked.
 
+Before opening an Issue or Pull Request, read the [contribution rules](./CONTRIBUTING.md) ([简体中文](./CONTRIBUTING.zh-CN.md)) and use the bilingual repository templates. Incomplete reports and PR descriptions are rejected by bilingual automated policy checks.
+
 ## License
 
 MIT. Report security issues privately through [SECURITY.md](./SECURITY.md), not a public issue.

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.9-5b5bd6" alt="发布版本 v0.2.9">
+  <img src="https://img.shields.io/badge/release-v0.2.10-5b5bd6" alt="发布版本 v0.2.10">
   <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.9.md">v0.2.9 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.2.10.md">v0.2.10 升级说明</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.9 发布说明](./docs/zh-CN/releases/v0.2.9.md) |
+| 查看本次升级 | [v0.2.10 发布说明](./docs/zh-CN/releases/v0.2.10.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 
@@ -203,6 +203,8 @@ pnpm run verify
 
 `verify` 会执行 TypeScript 检查、Vitest、可复现双构建、隔离的真实 Headless profile 激活检查与发布包验证。`lib/` 是生成产物，故意不进入版本库。
 
+提交 Issue 或 Pull Request 前请阅读[贡献规范](./CONTRIBUTING.zh-CN.md)（[English](./CONTRIBUTING.md)）并使用双语仓库模板；缺少必填信息的报告和 PR 描述会被双语自动化规则拒绝。
+
 ## 许可证
 
 MIT。安全问题请通过 [SECURITY.md](./SECURITY.md) 私下报告，不要公开提交 issue。

package/lib/client.js

@@ -10640,7 +10640,7 @@ window.__ModuleLoader__.load({
 				loadStatus();
 			};
 			const activationEnabled = status?.writeEnabled === true;
-			const writeEnabled = activationEnabled && connection.isLoopback !== false;
+			const writeEnabled = activationEnabled && settingsSnapshot.status === "ready" && settingsSnapshot.writable;
 			const stats = status?.stats;
 			const catalogKnown = status?.memoryBodies !== void 0;
 			const memoryBodies = (0, react.useMemo)(() => (status?.memoryBodies ?? []).map(normalizeMemoryBody), [status]);
@@ -11044,7 +11044,9 @@ window.__ModuleLoader__.load({
 		//#region src/client/MnemonSaveAction.tsx
 		const PREVIEW_LIMIT = 8e3;
 		/** Save-to-memory action on finalized assistant messages, routed through the supervised writeback gate. */
-		const MnemonSaveAction = (0, react.memo)(function MnemonSaveAction({ messageId, sessionId, connection, t }) {
+		const MnemonSaveAction = (0, react.memo)(function MnemonSaveAction({ messageId, sessionId, connection, settingsScope, t }) {
+			const settingsSnapshot = (0, react.useSyncExternalStore)(settingsScope.subscribe, settingsScope.getSnapshot, settingsScope.getSnapshot);
+			const managementWritable = settingsSnapshot.status === "ready" && settingsSnapshot.writable;
 			const [open, setOpen] = (0, react.useState)(false);
 			const [writeEnabled, setWriteEnabled] = (0, react.useState)(void 0);
 			const [candidate, setCandidate] = (0, react.useState)(void 0);
@@ -11078,7 +11080,7 @@ window.__ModuleLoader__.load({
 				setSubmitting(submitActiveRef.current);
 				const client = new MnemonClient(connection, sessionId);
 				client.status().then((status) => {
-					if (alive && requestVersionRef.current === requestVersion) setWriteEnabled(status.writeEnabled && connection.isLoopback !== false);
+					if (alive && requestVersionRef.current === requestVersion) setWriteEnabled(status.writeEnabled && managementWritable);
 				}).catch(() => {
 					if (alive && requestVersionRef.current === requestVersion) setWriteEnabled(false);
 				});
@@ -11099,7 +11101,8 @@ window.__ModuleLoader__.load({
 				open,
 				connection,
 				sessionId,
-				messageId
+				messageId,
+				managementWritable
 			]);
 			const submit = () => {
 				const content = textareaRef.current?.value.trim() ?? "";
@@ -11658,7 +11661,7 @@ window.__ModuleLoader__.load({
 			saveAction: {
 				slot: "conversation.chat.assistant-actions",
 				enabled: (value) => enabledOf(value, "saveAction"),
-				register(ctx, namespace, translate) {
+				register(ctx, namespace, translate, settings) {
 					return ctx.slots.register({
 						name: "conversation.chat.assistant-actions",
 						id: "mnemon-save",
@@ -11667,6 +11670,7 @@ window.__ModuleLoader__.load({
 						inject: (sessionId) => ({
 							...typeof sessionId === "string" && sessionId !== "" ? { sessionId } : {},
 							connection: ctx.connection,
+							settingsScope: settings,
 							t: translate
 						})
 					}, MnemonSaveAction);
@@ -11774,7 +11778,7 @@ window.__ModuleLoader__.load({
 				for (const key of Object.keys(INTERACTION_UNITS)) {
 					const unit = INTERACTION_UNITS[key];
 					const enabled = unit.enabled(value);
-					if (enabled && !active.has(key)) active.set(key, ctx.slots.inject(unit.slot, () => unit.register(ctx, namespace, translate)));
+					if (enabled && !active.has(key)) active.set(key, ctx.slots.inject(unit.slot, () => unit.register(ctx, namespace, translate, settings)));
 					else if (!enabled && active.has(key)) {
 						active.get(key)();
 						active.delete(key);

package/lib/index.js

@@ -7216,6 +7216,37 @@ const RESULT_TOOL_OUTPUT_SCHEMA = {
 	required: ["recorded"],
 	additionalProperties: false
 };
+const WRITE_ACTIONS = [
+	"stored",
+	"updated",
+	"added",
+	"replaced",
+	"removed",
+	"skipped",
+	"forgotten",
+	"linked",
+	"created",
+	"merged",
+	"failed"
+];
+const WRITE_ACTION_SET = new Set(WRITE_ACTIONS);
+const WRITE_OPERATION_RESULT_TOOL = {
+	remember: "mnemon_remember",
+	"supervised-writeback": "mnemon_remember",
+	link: "mnemon_link",
+	forget: "mnemon_forget",
+	"create-memory-body": "mnemon_memory_body_create",
+	"update-memory-body": "mnemon_memory_body_update",
+	"merge-memory-bodies": "mnemon_memory_body_merge"
+};
+const WRITE_TOOL_FALLBACK_ACTION = {
+	mnemon_remember: "stored",
+	mnemon_link: "linked",
+	mnemon_forget: "forgotten",
+	mnemon_memory_body_create: "created",
+	mnemon_memory_body_update: "updated",
+	mnemon_memory_body_merge: "merged"
+};
 const RECALL_SCHEMA = {
 	type: "object",
 	properties: {
@@ -7279,19 +7310,7 @@ const WRITE_SCHEMA = {
 		summary: { type: "string" },
 		action: {
 			type: "string",
-			enum: [
-				"stored",
-				"updated",
-				"added",
-				"replaced",
-				"removed",
-				"skipped",
-				"forgotten",
-				"linked",
-				"created",
-				"merged",
-				"failed"
-			]
+			enum: [...WRITE_ACTIONS]
 		},
 		memoryBodyIds: {
 			type: "array",
@@ -7707,6 +7726,84 @@ function insight(value) {
 	if (Array.isArray(item.entities)) result.entities = strings(item.entities);
 	return result;
 }
+function optionalObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function addString(target, value) {
+	if (typeof value === "string" && value.trim() !== "") target.add(value);
+}
+function addStrings(target, value) {
+	if (Array.isArray(value)) for (const entry of value) addString(target, entry);
+}
+function receiptMemoryBodyIds(receipt) {
+	const ids = /* @__PURE__ */ new Set();
+	const args = optionalObject(receipt.arguments);
+	const value = optionalObject(receipt.value);
+	for (const record of [args, value]) {
+		addString(ids, record?.memoryBodyId);
+		addString(ids, record?.targetMemoryBodyId);
+		addStrings(ids, record?.memoryBodyIds);
+		addStrings(ids, record?.sourceMemoryBodyIds);
+	}
+	if (receipt.name === "mnemon_memory_body_create" || receipt.name === "mnemon_memory_body_update") addString(ids, value?.id);
+	return [...ids];
+}
+function recoverRecallResult(receipts) {
+	if (receipts.length === 0) return void 0;
+	const results = [];
+	const seen = /* @__PURE__ */ new Set();
+	const selectedMemoryBodyIds = /* @__PURE__ */ new Set();
+	let summary = "";
+	for (const receipt of receipts) {
+		for (const id of receiptMemoryBodyIds(receipt)) selectedMemoryBodyIds.add(id);
+		const value = optionalObject(receipt.value);
+		if (typeof value?.hint === "string" && value.hint.trim() !== "") summary = value.hint;
+		else if (typeof value?.summary === "string" && value.summary.trim() !== "") summary = value.summary;
+		if (Array.isArray(value?.sources)) for (const source of value.sources) addString(selectedMemoryBodyIds, optionalObject(source)?.memoryBodyId);
+		if (!Array.isArray(value?.results)) continue;
+		for (const candidate of value.results) {
+			if (results.length >= 12) break;
+			const entry = insight(candidate);
+			if (entry === void 0 || typeof entry.memoryBodyId !== "string" || typeof entry.memoryBodyName !== "string") continue;
+			const key = `${entry.memoryBodyId}\u0000${entry.id}`;
+			if (seen.has(key)) continue;
+			seen.add(key);
+			selectedMemoryBodyIds.add(entry.memoryBodyId);
+			results.push(entry);
+		}
+	}
+	return {
+		summary,
+		selectedMemoryBodyIds: [...selectedMemoryBodyIds],
+		results
+	};
+}
+function recoverWriteResult(receipts) {
+	const receipt = receipts.at(-1);
+	if (receipt === void 0) return void 0;
+	const value = optionalObject(receipt.value);
+	const action = (typeof value?.action === "string" && WRITE_ACTION_SET.has(value.action) ? value.action : void 0) ?? WRITE_TOOL_FALLBACK_ACTION[receipt.name];
+	if (action === void 0) return void 0;
+	const memoryBodyIds = /* @__PURE__ */ new Set();
+	const documentIds = /* @__PURE__ */ new Set();
+	for (const entry of receipts) {
+		for (const id of receiptMemoryBodyIds(entry)) memoryBodyIds.add(id);
+		addStrings(documentIds, optionalObject(entry.value)?.documentIds);
+	}
+	return {
+		summary: typeof value?.summary === "string" ? value.summary : typeof value?.message === "string" ? value.message : "",
+		action,
+		memoryBodyIds: [...memoryBodyIds],
+		...documentIds.size === 0 ? {} : { documentIds: [...documentIds] }
+	};
+}
+/** Recover only the bounded public result implied by a committed terminal tool receipt. */
+function recoverStructuredResult(recovery, receipts) {
+	if (recovery === void 0) return void 0;
+	const terminalTools = new Set(recovery.terminalTools);
+	const matching = receipts.filter((receipt) => terminalTools.has(receipt.name));
+	return recovery.kind === "recall" ? recoverRecallResult(matching) : recoverWriteResult(matching);
+}
 function isSubagent(agent) {
 	return agent?.session.header?.origin === "subagent";
 }
@@ -7753,7 +7850,10 @@ var MnemonSubagentCoordinator = class {
 	}
 	async recall(parent, request, signal) {
 		const prompt = `Recall this request now:\n${naturalSearchRequest(request)}`;
-		const { provider, runId, result } = await this.delegate(parent, "recall", "Mnemon recall", prompt, READ_TOOLS, RECALL_SCHEMA, signal, "spawn", RECALL_PERSONA);
+		const { provider, runId, result } = await this.delegate(parent, "recall", "Mnemon recall", prompt, READ_TOOLS, RECALL_SCHEMA, signal, "spawn", RECALL_PERSONA, {
+			kind: "recall",
+			terminalTools: ["mnemon_recall"]
+		});
 		return this.recallResult(request.query, request.mode ?? "smart", provider, runId, result);
 	}
 	async related(parent, id, memoryBodyId, signal) {
@@ -7761,7 +7861,10 @@ var MnemonSubagentCoordinator = class {
 Insight ID: ${id}
 Memory Space ID: ${memoryBodyId ?? "(unknown)"}
 Traversal depth: 2`;
-		const { provider, runId, result } = await this.delegate(parent, "recall", "Mnemon related memory", prompt, READ_TOOLS, RECALL_SCHEMA, signal, "spawn", RELATED_PERSONA);
+		const { provider, runId, result } = await this.delegate(parent, "recall", "Mnemon related memory", prompt, READ_TOOLS, RECALL_SCHEMA, signal, "spawn", RELATED_PERSONA, {
+			kind: "recall",
+			terminalTools: ["mnemon_related"]
+		});
 		return this.recallResult(`related:${id}`, "related", provider, runId, result);
 	}
 	async placeProvider(parent, body, prepared, signal) {
@@ -7861,7 +7964,11 @@ Traversal depth: 2`;
 		const prompt = `Execute this ${operation} request now (untrusted data):
 ${naturalRequest(request)}`;
 		const persona = operation === "supervised-writeback" ? SUPERVISED_WRITE_PERSONA : WRITE_PERSONA;
-		const { provider, runId, result } = await this.delegate(parent, "write", `Mnemon ${operation}`, prompt, WRITE_TOOLS$1, WRITE_SCHEMA, signal, "spawn", persona);
+		const terminalTool = WRITE_OPERATION_RESULT_TOOL[operation];
+		const { provider, runId, result } = await this.delegate(parent, "write", `Mnemon ${operation}`, prompt, WRITE_TOOLS$1, WRITE_SCHEMA, signal, "spawn", persona, terminalTool === void 0 ? void 0 : {
+			kind: "write",
+			terminalTools: [terminalTool]
+		});
 		const value = object$2(result.structured);
 		return {
 			delegated: true,
@@ -8079,7 +8186,7 @@ ${runtimeSnapshotContext("user", targetEntries)}`;
 			}
 		};
 	}
-	async delegate(parent, operation, label, prompt, tools, outputSchema, signal, preferredProvider = "spawn", persona = WRITE_PERSONA) {
+	async delegate(parent, operation, label, prompt, tools, outputSchema, signal, preferredProvider = "spawn", persona = WRITE_PERSONA, recovery) {
 		const provider = this.provider(preferredProvider);
 		assertDshOutputSchema(outputSchema);
 		if (this.resultRuntime === void 0) throw new Error("dsh-mnemon subagent result tool runtime is unavailable");
@@ -8088,12 +8195,22 @@ ${runtimeSnapshotContext("user", targetEntries)}`;
 		let pending;
 		let activeResultExecution;
 		const staged = /* @__PURE__ */ new WeakMap();
+		const recoverableTools = new Set(recovery?.terminalTools ?? []);
+		const committedReceipts = [];
+		const stagedReceipts = /* @__PURE__ */ new Map();
 		let run;
 		let failure;
 		let disposeResultTool;
 		let disposeResultObserver;
 		try {
 			const observer = this.resultRuntime.on("tools/result", ((execution, result) => {
+				if (execution.token !== void 0) {
+					const entries = stagedReceipts.get(execution.token);
+					if (entries !== void 0) {
+						stagedReceipts.delete(execution.token);
+						if (result.isError !== true) committedReceipts.push(...entries);
+					}
+				}
 				if (execution.name === resultToolName) {
 					const entry = staged.get(execution);
 					if (entry === void 0) return;
@@ -8108,13 +8225,25 @@ ${runtimeSnapshotContext("user", targetEntries)}`;
 					};
 					return;
 				}
-				if (pending === void 0 || pending.parent !== execution.token) return;
-				const entry = pending;
-				pending = void 0;
-				if (result.isError !== true && captured === void 0) captured = {
-					agentId: entry.agentId,
-					value: entry.value
+				if (pending !== void 0 && pending.parent === execution.token) {
+					const entry = pending;
+					pending = void 0;
+					if (result.isError !== true && captured === void 0) captured = {
+						agentId: entry.agentId,
+						value: entry.value
+					};
+				}
+				if (execution.name === void 0 || !recoverableTools.has(execution.name) || result.isError === true || !Object.hasOwn(result, "value")) return;
+				const agent = execution.agent;
+				if (agent === void 0 || !isSubagent(agent)) return;
+				const receipt = {
+					agentId: agent.id,
+					name: execution.name,
+					arguments: execution.arguments,
+					value: result.value
 				};
+				if (execution.parent === void 0) committedReceipts.push(receipt);
+				else stagedReceipts.set(execution.parent, [...stagedReceipts.get(execution.parent) ?? [], receipt]);
 			}));
 			if (typeof observer !== "function") throw new Error("dsh-mnemon subagent result observer registration did not return a disposer");
 			disposeResultObserver = observer;
@@ -8162,22 +8291,24 @@ Completion protocol: call \`${resultToolName}\` exactly once with the final resu
 				toolFilter: { allow: [...tools, resultToolName] },
 				persona: completionPersona
 			});
-			const result = await run.result;
-			if (captured !== void 0 && captured.agentId !== run.id) throw new Error("Mnemon subagent result was recorded by a different child");
-			const structured = captured?.value ?? result.structured;
+			const activeRun = run;
+			const result = await activeRun.result;
+			if (captured !== void 0 && captured.agentId !== activeRun.id) throw new Error("Mnemon subagent result was recorded by a different child");
+			let structured = captured?.value ?? result.structured;
+			if (structured === void 0 && result.stopReason === "completed") structured = recoverStructuredResult(recovery, committedReceipts.filter((receipt) => receipt.agentId === activeRun.id));
 			if (structured !== void 0) assertDshOutputValue(outputSchema, structured);
 			if (result.stopReason !== "completed") {
-				const detail = subagentFailureDetail(run);
+				const detail = subagentFailureDetail(activeRun);
 				throw new Error(`memory subagent stopped with ${result.stopReason}${detail === void 0 ? "" : `: ${detail}`}`);
 			}
 			if (structured === void 0) throw new Error("memory subagent completed without recording its result");
 			this.counters[operation === "recall" ? "recalls" : operation === "write" ? "writes" : operation === "review" ? "reviews" : operation === "placement" ? "placements" : operation === "migration" ? "migrations" : operation === "compaction" ? "compactions" : operation === "document-archive" ? "documentArchives" : operation === "metadata-maintenance" ? "metadataMaintenances" : "answers"] += 1;
-			this.counters.lastRunId = run.id;
+			this.counters.lastRunId = activeRun.id;
 			if (operation !== "answer") this.counters.lastOperation = operation;
 			this.counters.lastAt = (/* @__PURE__ */ new Date()).toISOString();
 			return {
 				provider,
-				runId: run.id,
+				runId: activeRun.id,
 				result: {
 					...result,
 					structured
@@ -9219,10 +9350,11 @@ function inspectDshInstall(packageManifestPath, dshHome) {
 		locationDir: resolve(dirname(packageManifestPath))
 	};
 }
-async function resultOrThrow(runner, command, args, timeoutMs) {
+async function resultOrThrow(runner, command, args, timeoutMs, options = {}) {
 	const result = await runner(command, args, {
 		timeoutMs,
-		maxOutputBytes: MAX_UPDATE_OUTPUT_BYTES
+		maxOutputBytes: MAX_UPDATE_OUTPUT_BYTES,
+		...options
 	});
 	if (result.exitCode !== 0) {
 		const detail = result.stderr.trim() || result.stdout.trim() || `exit ${String(result.exitCode)}`;
@@ -9409,7 +9541,7 @@ var VersionUpdateManager = class {
 		const install = inspectDshInstall(this.packageManifestPath, this.dshHome);
 		const pnpm = this.executable("pnpm");
 		if (install.mode !== "npm" || install.profileDir === void 0 || pnpm === void 0) throw new Error("This dsh-mnemon installation cannot be updated automatically");
-		const outputText = updateOutput(await resultOrThrow(this.processRunner, pnpm, ["update", DSH_MNEMON_PACKAGE], UPDATE_TIMEOUT_MS));
+		const outputText = updateOutput(await resultOrThrow(this.processRunner, pnpm, ["update", DSH_MNEMON_PACKAGE], UPDATE_TIMEOUT_MS, { cwd: install.profileDir }));
 		this.dshMnemonVersion = latest;
 		return {
 			component,
@@ -9989,6 +10121,7 @@ const MUTABLE_FIELDS = [
 	"displayMode",
 	"tabEnabled",
 	"writeEnabled",
+	"persistenceStrategy",
 	"taskAgentModel"
 ];
 /** Nested paths of the live in-conversation interaction toggles. */

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

@@ -1,4 +1,4 @@
-import type { ClientConnectionHandle } from '../shared/contracts.ts';
+import type { ClientConnectionHandle, ClientSettingsScope, Config } from '../shared/contracts.ts';
 import type { MnemonKey } from './locales.ts';
 export interface MnemonSaveActionProps {
     /** Stable identity of the finalized assistant message this action addresses. */
@@ -6,6 +6,7 @@ export interface MnemonSaveActionProps {
     /** Injected by the slot host: the session this message belongs to. */
     sessionId?: string;
     connection: ClientConnectionHandle;
+    settingsScope: ClientSettingsScope<Config>;
     t: (key: MnemonKey, params?: Record<string, unknown>) => string;
 }
 /** Save-to-memory action on finalized assistant messages, routed through the supervised writeback gate. */

package/lib/types/contracts.d.ts

@@ -35,6 +35,8 @@ export interface ToolExecution {
     signal: AbortSignal;
     agent?: HostAgent;
     name?: string;
+    /** Parsed tool arguments, available on the authoritative tools/result event. */
+    arguments?: unknown;
     parent?: symbol;
     token?: symbol;
     /** End the current model turn after an authoritative terminal tool call. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "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",