@lmzhen/dsh-tool-memory 0.32.5 → 0.33.0

package/README.md

@@ -1,19 +1,19 @@
 # @lmzhen/dsh-tool-memory
 
-> Agent 写记忆的工具。
+Model-facing `memory` tool plus durable-memory guidance and snapshot sections for the system prompt.
 
-## 你会看到
+## Tool contract
 
-你对 Agent 说“记住…”，它写入项目记忆/用户画像。
+`target` selects `memory` for agent notes or `user` for stable user-profile facts. Actions are `add`, `replace`, and `remove`. `facts` and `content` are aliases; supplying different non-blank values for both is rejected.
 
-## 什么时候会用到
+Use one `operations` array for a batch. The batch is evaluated against the final result so removal/replacement can free budget before additions. Add requires content; replace requires matching old text and new content; remove requires matching old text. Empty batches and malformed operations are rejected before approval.
 
-你想让 Agent 跨会话记住事实/偏好时。
+## Defaults and boundaries
 
-## 默认 / 前提
+- `memoryEnabled`: default `true`; disabling removes the model tool and prompt sections while retaining an explicit refusal runner for previously staged writes.
+- `entryPreviewChars`: default 200 characters per entry in the tool response; this does not truncate stored content.
+- `memoryChars` and `userChars`: enforced by the selected provider, not by this tool; see [memory-files](../memory-files/README.md).
 
-all/分层预设才有；host 没有。
+When ordinary approval is enabled, a write can return `pending_id` instead of executing immediately. An effective platform session policy of `never` bypasses staging as designed.
 
-## 边界
-
-审批开启时会先进入待批。
+Guidance and snapshot injection require the optional `systemPrompt` service. Without it, the write tool still works but memory context is not injected. Successful writes through the memory registry refresh the snapshot, including graph and background-review writes.

package/lib/index.js

@@ -1,7 +1,7 @@
 import { effectiveSessionPolicy } from "@lmzhen/dsh-evolution-approval";
 import z from "@deepseek-ai/schemastery";
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { MEMORY_GUIDANCE_SECTION_ORDER, clampedNumber, payloadText, resolveExecOrigins, unwrapLive } from "@lmzhen/dsh-evolution-core";
+import { MEMORY_GUIDANCE_SECTION_ORDER, clampedNumber, payloadText, registerOwnerSettings, resolveExecOrigins, unwrapLive } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Model-facing memory tool and runtime-context memory snapshot.
@@ -32,6 +32,7 @@ const Config = z.object({
 	entryPreviewChars: z.number().min(1).default(DEFAULT_ENTRY_PREVIEW_CHARS).volatile()
 });
 async function apply(ctx, rawConfig = {}) {
+	registerOwnerSettings(ctx, "tool-memory", Config);
 	ctx.inject(["settings"], (injected) => {
 		const settings = injected.settings;
 		if (typeof settings?.configure !== "function") return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-tool-memory",
   "description": "Model-facing memory tool and prompt context (community build)",
-  "version": "0.32.5",
+  "version": "0.33.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,22 +27,22 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-approval": "^0.32.5",
-    "@lmzhen/dsh-evolution-core": "^0.32.5"
+    "@lmzhen/dsh-evolution-approval": "^0.33.0",
+    "@lmzhen/dsh-evolution-core": "^0.33.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5",
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
-    "@lmzhen/dsh-memory": "^0.32.5"
+    "@lmzhen/dsh-memory": "^0.33.0"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-tools": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.2.1-rc.2",
     "@deepseek-ai/dsh-agent-loop-testkit": "^0.2.1-rc.2",
-    "@lmzhen/dsh-evolution-approval": "^0.32.5",
-    "@lmzhen/dsh-memory": "^0.32.5",
-    "@lmzhen/dsh-memory-files": "^0.32.5"
+    "@lmzhen/dsh-evolution-approval": "^0.33.0",
+    "@lmzhen/dsh-memory": "^0.33.0",
+    "@lmzhen/dsh-memory-files": "^0.33.0"
   },
   "engines": {
     "dsh": ">=0.2.1-rc.2 <0.2.2-0"