@lmzhen/dsh-tool-memory 0.16.1 → 0.17.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, PARAM_NAMESPACES, clampedNumber, installParamSection, resolveExecOrigins } from "@lmzhen/dsh-evolution-core";
+import { MEMORY_GUIDANCE_SECTION_ORDER, clampedNumber, resolveExecOrigins } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Model-facing memory tool and runtime-context memory snapshot.
@@ -10,7 +10,6 @@ import { MEMORY_GUIDANCE_SECTION_ORDER, PARAM_NAMESPACES, clampedNumber, install
 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`.
@@ -30,16 +29,26 @@ const MEMORY_GUIDANCE = "You have durable memory across sessions. Save stable us
 const MEMORY_TOOL_DESCRIPTION = "Save durable facts to persistent memory that survive across sessions. Memory is injected into future turns, so keep entries compact and high-signal.\n\nHOW: make all changes in ONE call via an `operations` array (each item {action, facts?|content?, old_text?}). The batch applies atomically and the char limit is checked on the final result — so one call can remove/replace stale entries to free room AND add new ones. Use bare action/content/old_text only for a single lone change.\n\nWHEN: save proactively when the user states a preference, correction, or personal detail, or you learn a stable fact about their environment, conventions, or workflow. Priority: user preferences & corrections > environment facts > procedures. The best memory stops the user repeating themselves.\n\nTARGETS: \"user\" = who the user is (name, role, preferences, style). \"memory\" = your notes (environment, conventions, tool quirks, lessons).\n\nSKIP: trivial/obvious info, easily re-discovered facts, task progress, completed-work logs, temporary TODO state. To recall a past session use the session query tool, not memory. Reusable procedures belong in a skill, not memory.";
 const Config = z.object({
 	memoryEnabled: z.boolean().default(true),
-	entryPreviewChars: z.number().min(1).default(DEFAULT_ENTRY_PREVIEW_CHARS)
+	entryPreviewChars: z.number().min(1).default(DEFAULT_ENTRY_PREVIEW_CHARS).volatile()
 });
 async function apply(ctx, rawConfig = {}) {
+	ctx.inject(["settings"], (injected) => {
+		const settings = injected.settings;
+		if (typeof settings?.configure !== "function") return;
+		const disposer = settings.configure({ auto: false });
+		if (typeof disposer === "function") ctx.effect(() => disposer, "tool-memory: settings presentation");
+	});
 	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}`);
+	let previewClampWarned = false;
+	const previewChars = () => {
+		const value = rawConfig.entryPreviewChars?.get();
+		const clamped = clampedNumber(value, DEFAULT_ENTRY_PREVIEW_CHARS, { min: 1 });
+		if (!previewClampWarned && value !== void 0 && clamped !== value) {
+			previewClampWarned = true;
+			ctx.logger.warn(`tool-memory: entryPreviewChars=${String(value)} is invalid; falling back to the default ${DEFAULT_ENTRY_PREVIEW_CHARS}`);
+		}
+		return clamped;
+	};
 	const systemPrompt = ctx.get("systemPrompt");
 	let snapshotText = "";
 	if (!memoryDisabled) try {
@@ -319,4 +328,4 @@ async function apply(ctx, rawConfig = {}) {
 	});
 }
 //#endregion
-export { Config, MEMORY_GUIDANCE, MEMORY_TOOL_DESCRIPTION, TOOL_MEMORY_SETTINGS_SCHEMA, apply, inject, name };
+export { Config, MEMORY_GUIDANCE, MEMORY_TOOL_DESCRIPTION, apply, inject, name };

package/lib/types/index.d.ts

@@ -2,19 +2,9 @@
  * Model-facing memory tool and runtime-context memory snapshot.
  * @module @lmzhen/dsh-tool-memory
  */
-import type { Context } from '@deepseek-ai/cordis';
+import type { Context, Volatile } 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`.
@@ -32,11 +22,21 @@ export declare const MEMORY_GUIDANCE: string;
  * `MEMORY_GUIDANCE` system prompt.
  */
 export declare const MEMORY_TOOL_DESCRIPTION: string;
+/** G3/S3.2: `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 (registry tier E2). The display knob the user
+ * may tune (`entryPreviewChars`) is a volatile row field instead (G1 §8.1). */
 export interface Config {
     memoryEnabled?: boolean;
-    /** Maximum characters of each memory entry echoed back in tool results. */
-    entryPreviewChars?: number;
+    /** Maximum characters of each memory entry echoed back in tool results (live reference). */
+    entryPreviewChars?: Volatile<number>;
 }
-export declare const Config: z<Config>;
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    memoryEnabled: z<boolean, boolean, "defined">;
+    entryPreviewChars: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    memoryEnabled: z<boolean, boolean, "defined">;
+    entryPreviewChars: z<number, number, "volatile-defined">;
+}>>, "plain">;
 export declare function apply(ctx: Context, rawConfig?: Config): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-tool-memory",
   "description": "Model-facing memory tool and prompt context (community build)",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,21 +27,21 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-approval": "^0.16.1",
-    "@lmzhen/dsh-evolution-core": "^0.16.1"
+    "@lmzhen/dsh-evolution-approval": "^0.17.0",
+    "@lmzhen/dsh-evolution-core": "^0.17.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.16.1"
+    "@deepseek-ai/dsh-tools": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "^0.2.0-rc.1",
+    "@lmzhen/dsh-memory": "^0.17.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.16.1",
-    "@lmzhen/dsh-memory": "^0.16.1",
-    "@lmzhen/dsh-memory-files": "^0.16.1"
+    "@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.17.0",
+    "@lmzhen/dsh-memory": "^0.17.0",
+    "@lmzhen/dsh-memory-files": "^0.17.0"
   }
 }