@lmzhen/dsh-tool-memory 0.5.0 → 0.6.0

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, resolveExecOrigins } from "@lmzhen/dsh-evolution-core";
+import { MEMORY_GUIDANCE_SECTION_ORDER, PARAM_NAMESPACES, clampedNumber, installParamSection, resolveExecOrigins } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Model-facing memory tool and runtime-context memory snapshot.
@@ -10,6 +10,7 @@ import { MEMORY_GUIDANCE_SECTION_ORDER, clampedNumber, resolveExecOrigins } from
 const name = "tool-memory";
 /** Max characters of each echoed memory entry (single source for the Config default and the runtime slice). */
 const DEFAULT_ENTRY_PREVIEW_CHARS = 200;
+const TOOL_MEMORY_SETTINGS_SCHEMA = z.object({ entryPreviewChars: z.number().min(1).default(DEFAULT_ENTRY_PREVIEW_CHARS) });
 const inject = ["tools", "memory"];
 /**
 * System-prompt memory guidance, aligned with Hermes `MEMORY_GUIDANCE`.
@@ -34,6 +35,10 @@ const Config = z.object({
 async function apply(ctx, rawConfig = {}) {
 	const memoryDisabled = rawConfig.memoryEnabled === false;
 	const entryPreviewChars = clampedNumber(rawConfig.entryPreviewChars, DEFAULT_ENTRY_PREVIEW_CHARS, { min: 1 });
+	const previewOverrides = installParamSection(ctx, PARAM_NAMESPACES["tool-memory"] ?? "tool-memory", TOOL_MEMORY_SETTINGS_SCHEMA, { entryPreviewChars }, { warn: (message) => {
+		ctx.logger.warn("tool-memory: " + message);
+	} });
+	const previewChars = () => previewOverrides.get("entryPreviewChars") ?? entryPreviewChars;
 	if (entryPreviewChars !== (rawConfig.entryPreviewChars ?? DEFAULT_ENTRY_PREVIEW_CHARS)) ctx.logger.warn(`tool-memory: entryPreviewChars=${String(rawConfig.entryPreviewChars)} is invalid; falling back to the default ${DEFAULT_ENTRY_PREVIEW_CHARS}`);
 	const systemPrompt = ctx.get("systemPrompt");
 	let snapshotText = "";
@@ -115,7 +120,7 @@ async function apply(ctx, rawConfig = {}) {
 		return {
 			ok: result.ok,
 			message: result.message,
-			entries: result.entries.map((entry) => entry.slice(0, entryPreviewChars)),
+			entries: result.entries.map((entry) => entry.slice(0, previewChars())),
 			chars: result.chars,
 			limit: result.limit
 		};
@@ -314,4 +319,4 @@ async function apply(ctx, rawConfig = {}) {
 	});
 }
 //#endregion
-export { Config, MEMORY_GUIDANCE, MEMORY_TOOL_DESCRIPTION, apply, inject, name };
+export { Config, MEMORY_GUIDANCE, MEMORY_TOOL_DESCRIPTION, TOOL_MEMORY_SETTINGS_SCHEMA, apply, inject, name };

package/lib/types/index.d.ts

@@ -5,6 +5,16 @@
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 export declare const name = "tool-memory";
+/** G3/S3.2: the memory TOOL's user-tunable display knob (canonical id).
+ * `memoryEnabled` stays a deployment switch on purpose: it decides whether the
+ * tool and its prompt section are REGISTERED at all, so making it live would mean
+ * dynamic registration with catalog-visible effects — a structural change this
+ * batch deliberately does not make (registry tier E2). */
+export interface ToolMemorySettings {
+    /** Characters of one memory entry shown in a tool result preview. */
+    entryPreviewChars: number;
+}
+export declare const TOOL_MEMORY_SETTINGS_SCHEMA: z<ToolMemorySettings>;
 export declare const inject: string[];
 /**
  * System-prompt memory guidance, aligned with Hermes `MEMORY_GUIDANCE`.

package/package.json

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