@lmzhen/dsh-tool-memory 0.22.0 → 0.24.0

package/lib/index.js

@@ -9,6 +9,8 @@ import { MEMORY_GUIDANCE_SECTION_ORDER, clampedNumber, payloadText, resolveExecO
 */
 const name = "tool-memory";
 /** Max characters of each echoed memory entry (single source for the Config default and the runtime slice). */
+/** G2.4/C3: the give-up bound of the snapshot retry — a NAMED ceiling, not a literal in the call. */
+const SNAPSHOT_RETRY_GIVE_UP_MS = 6e4;
 const DEFAULT_ENTRY_PREVIEW_CHARS = 200;
 const inject = ["tools", "memory"];
 /**
@@ -90,7 +92,7 @@ async function apply(ctx, rawConfig = {}) {
 			}, "tool-memory.snapshot-retry");
 			setTimeout(() => {
 				clearInterval(retryTimer);
-			}, 6e4).unref();
+			}, SNAPSHOT_RETRY_GIVE_UP_MS).unref();
 		}
 	} else if (!memoryDisabled) ctx.logger.warn("tool-memory: systemPrompt service not mounted; memory guidance and snapshot are not injected (the write tool still works)");
 	async function executeCore(normalized) {
@@ -99,7 +101,7 @@ async function apply(ctx, rawConfig = {}) {
 			return raw === null || typeof raw !== "object";
 		})) return {
 			ok: false,
-			message: "Every entry of operations must be an object.",
+			message: "operations 的每一项都必须是对象。",
 			entries: [],
 			chars: 0,
 			limit: 0
@@ -107,7 +109,7 @@ async function apply(ctx, rawConfig = {}) {
 		const target = normalized.target;
 		if (target !== "memory" && target !== "user") return {
 			ok: false,
-			message: `memory: "target" must be "memory" or "user" (got ${String(target)}); refusing the write.`,
+			message: `memory："target" 必须是 "memory" 或 "user"（收到 ${String(target)}）；拒绝写入。`,
 			entries: [],
 			chars: 0,
 			limit: 0
@@ -120,7 +122,7 @@ async function apply(ctx, rawConfig = {}) {
 			const value = normalized[field];
 			if (value !== void 0 && value !== null && typeof value !== "string") return {
 				ok: false,
-				message: `memory: "${field}" must be a string (got ${typeof value}); refusing the write.`,
+				message: `memory："${field}" 必须是字符串（收到 ${typeof value}）；拒绝写入。`,
 				entries: [],
 				chars: 0,
 				limit: 0
@@ -135,7 +137,7 @@ async function apply(ctx, rawConfig = {}) {
 			if (value === void 0 || value === null || typeof value === "string") continue;
 			return {
 				ok: false,
-				message: `memory: operations[${index}].${field} must be a string (got ${typeof value}); refusing the write — re-approving cannot fix a payload defect, so reject the record.`,
+				message: `memory：operations[${index}].${field} 必须是字符串（收到 ${typeof value}）；拒绝写入 —— 重新批准无法修复载荷缺陷，请驳回该记录。`,
 				entries: [],
 				chars: 0,
 				limit: 0
@@ -156,10 +158,10 @@ async function apply(ctx, rawConfig = {}) {
 	}
 	const requiredFieldRejection = (op, position) => {
 		const body = payloadText(op);
-		if (op.action === "add") return body ? null : `Operation ${position} (add): facts is required. No operations were applied.`;
-		if (op.action !== "remove" && op.action !== "replace") return `Operation ${position}: unknown action "${String(op.action)}" (expected add/remove/replace). No operations were applied.`;
-		if (!(op.old_text ?? "").trim()) return `Operation ${position} (${op.action}): old_text is required. No operations were applied.`;
-		if (op.action === "replace" && !body) return `Operation ${position} (replace): facts is required.`;
+		if (op.action === "add") return body ? null : `第 ${position} 个操作（add）：必须提供 facts。未应用任何操作。`;
+		if (op.action !== "remove" && op.action !== "replace") return `第 ${position} 个操作：未知动作「${String(op.action)}」（应为 add/remove/replace）。未应用任何操作。`;
+		if (!(op.old_text ?? "").trim()) return `第 ${position} 个操作（${op.action}）：必须提供 old_text。未应用任何操作。`;
+		if (op.action === "replace" && !body) return `第 ${position} 个操作（replace）：必须提供 facts。`;
 		return null;
 	};
 	if (!memoryDisabled) ctx.tools.register(defineTool({
@@ -249,14 +251,14 @@ async function apply(ctx, rawConfig = {}) {
 				const raw = op;
 				if (raw === null || typeof raw !== "object") return {
 					ok: false,
-					message: "Every entry of operations must be an object.",
+					message: "operations 的每一项都必须是对象。",
 					entries: [],
 					chars: 0,
 					limit: 0
 				};
 				if (conflict(op)) return {
 					ok: false,
-					message: "Provide only one of facts or content per operation (same field); different values were given.",
+					message: "每个操作只能提供 facts 或 content 之一（同一字段）：两者给了不同的值。",
 					entries: [],
 					chars: 0,
 					limit: 0
@@ -264,21 +266,21 @@ async function apply(ctx, rawConfig = {}) {
 			}
 			else if (conflict(args)) return {
 				ok: false,
-				message: "Provide only one of facts or content (same field); different values were given.",
+				message: "只能提供 facts 或 content 之一（同一字段）：两者给了不同的值。",
 				entries: [],
 				chars: 0,
 				limit: 0
 			};
 			if (Array.isArray(args.operations) && args.operations.length === 0) return {
 				ok: false,
-				message: "No operations provided (the operations array is empty).",
+				message: "没有提供任何操作（operations 数组为空）。",
 				entries: [],
 				chars: 0,
 				limit: 0
 			};
 			if (args.operations !== void 0 && !Array.isArray(args.operations)) return {
 				ok: false,
-				message: "Invalid shape: operations must be an array of {action, content?, old_text?} objects (or omit operations for a single operation).",
+				message: "形状不合法：operations 必须是 {action, content?, old_text?} 对象的数组（单个操作时可省略 operations）。",
 				entries: [],
 				chars: 0,
 				limit: 0
@@ -343,7 +345,7 @@ async function apply(ctx, rawConfig = {}) {
 		const approval = approvalCtx.evolutionApproval;
 		const dispose = memoryDisabled ? approval.registerRunner("memory", () => Promise.resolve({
 			ok: false,
-			message: "Refused: the memory tool is disabled (tool-memory memoryEnabled:false) — its replay runner cannot execute this staged write. Reject the record; re-stage after re-enabling the tool if the write is still wanted."
+			message: "拒绝：记忆工具已禁用（tool-memory memoryEnabled:false）—— 它的回放运行器无法执行这条暂存写入。请驳回该记录；若仍需要该写入，请在重新启用该工具后再暂存。"
 		})) : approval.registerRunner("memory", (args) => executeCore(args));
 		approvalCtx.effect(() => dispose, memoryDisabled ? "tool-memory.approval-runner-disabled" : "tool-memory.approval-runner");
 	});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-tool-memory",
   "description": "Model-facing memory tool and prompt context (community build)",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,21 +27,21 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.4",
-    "@lmzhen/dsh-evolution-approval": "^0.22.0",
-    "@lmzhen/dsh-evolution-core": "^0.22.0"
+    "@lmzhen/dsh-evolution-approval": "^0.24.0",
+    "@lmzhen/dsh-evolution-core": "^0.24.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-tools": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-system-prompt": "^0.2.0-rc.1",
-    "@lmzhen/dsh-memory": "^0.22.0"
+    "@lmzhen/dsh-memory": "^0.24.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-tools": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-system-prompt": "^0.2.0-rc.1",
     "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.0-rc.1",
-    "@lmzhen/dsh-evolution-approval": "^0.22.0",
-    "@lmzhen/dsh-memory": "^0.22.0",
-    "@lmzhen/dsh-memory-files": "^0.22.0"
+    "@lmzhen/dsh-evolution-approval": "^0.24.0",
+    "@lmzhen/dsh-memory": "^0.24.0",
+    "@lmzhen/dsh-memory-files": "^0.24.0"
   }
 }