@lmzhen/dsh-memory-files 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-memory-files
+
+Local layered memory provider
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-memory-files` registers no direct prompt or tool schema itself. Model-visible effects are owned by the packages that consume this service.
+
+#### Token effect
+
+Zero direct token effect from this package; consumers add any model-visible tokens.
+
+#### KV Cache effect
+
+Independent of request-prefix construction. This package does not alter the assembled prompt or tool list.
+
+## Known Limitations and Deferred Work
+
+
+- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.

package/lib/index.js

@@ -0,0 +1,56 @@
+import { createHash } from "node:crypto";
+import z from "@deepseek-ai/schemastery";
+import { MemoryStore, evolutionIoAdapter } from "@lmzhen/dsh-evolution-core";
+//#region lib/types/index.js
+/**
+* Local layered memory provider for `ctx.memory`.
+* @module @lmzhen/dsh-memory-files
+*/
+const name = "memory-files";
+const inject = ["memory", "evolutionIo"];
+const Config = z.object({
+	providerName: z.string().default("files"),
+	memoryCharLimit: z.number().default(2200),
+	userCharLimit: z.number().default(1375),
+	addDatePrefix: z.boolean().default(false),
+	root: z.string().default(""),
+	maxConsolidationFailures: z.number().default(3)
+});
+function apply(ctx, rawConfig) {
+	const config = rawConfig;
+	const io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
+	const store = new MemoryStore({
+		memoryCharLimit: config.memoryCharLimit,
+		userCharLimit: config.userCharLimit,
+		addDatePrefix: config.addDatePrefix,
+		maxConsolidationFailures: config.maxConsolidationFailures,
+		...config.root ? { root: config.root } : {},
+		io
+	});
+	const provider = {
+		name: config.providerName,
+		read: (target, _signal) => store.read(target),
+		applyBatch: async (target, operations) => {
+			const normalized = operations.map((op) => ({
+				action: op.action,
+				facts: op.facts ?? op.content,
+				old_text: op.old_text
+			}));
+			return store.applyBatch(target, normalized);
+		},
+		snapshot: async () => {
+			const [memory, user] = await Promise.all([store.read("memory"), store.read("user")]);
+			const text = JSON.stringify([memory, user]);
+			return {
+				version: 1,
+				sha256: createHash("sha256").update(text).digest("hex"),
+				memory,
+				user
+			};
+		},
+		renderContext: () => store.renderContext()
+	};
+	ctx.effect(() => ctx.memory.registerProvider(provider), "memory-files.provider");
+}
+//#endregion
+export { Config, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-memory-files";
+const name = "memory-files-invariant";
+const inject = ["invariants"];
+const install = () => {};
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Local layered memory provider for `ctx.memory`.
+ * @module @deepseek-ai/dsh-memory-files
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+export declare const name = "memory-files";
+export declare const inject: string[];
+export interface Config {
+    providerName?: string;
+    memoryCharLimit?: number;
+    userCharLimit?: number;
+    addDatePrefix?: boolean;
+    root?: string;
+    /** How many consolidation failures one turn tolerates before the tool tells the model to stop retrying. */
+    maxConsolidationFailures?: number;
+}
+export declare const Config: z<Config>;
+export declare function apply(ctx: Context, rawConfig: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "memory-files-invariant";
+export declare const inject: string[];
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@lmzhen/dsh-memory-files",
+  "description": "Local layered memory provider (community build)",
+  "version": "0.1.0-rc.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lmzhen/dsh-evolution.git",
+    "directory": "packages/dsh-memory-files"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/invariant.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-memory": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-memory": "^0.1.0-rc.1"
+  }
+}