@lmzhen/dsh-memory 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-memory
+
+Memory provider registry for self-evolution
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-memory` 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,39 @@
+import { Service } from "@deepseek-ai/cordis";
+//#region lib/types/index.js
+/**
+* Memory provider registry for the evolution family.
+* Service Definition role; concrete providers register here.
+* @module @lmzhen/dsh-memory
+*/
+var MemoryRegistry = class extends Service {
+	providers = /* @__PURE__ */ new Map();
+	constructor(ctx) {
+		super(ctx, "memory");
+	}
+	registerProvider(provider) {
+		if (this.providers.has(provider.name)) throw new Error(`memory provider "${provider.name}" already registered`);
+		this.providers.set(provider.name, provider);
+		return () => {
+			if (this.providers.get(provider.name) === provider) this.providers.delete(provider.name);
+		};
+	}
+	provider() {
+		const first = this.providers.values().next().value;
+		if (!first) throw new Error("memory: no provider registered");
+		return first;
+	}
+	read(target, signal) {
+		return this.provider().read(target, signal);
+	}
+	applyBatch(target, operations, signal) {
+		return this.provider().applyBatch(target, operations, signal);
+	}
+	snapshot(signal) {
+		return this.provider().snapshot(signal);
+	}
+	renderContext() {
+		return this.provider().renderContext();
+	}
+};
+//#endregion
+export { MemoryRegistry, MemoryRegistry as default };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-memory";
+const name = "memory-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,50 @@
+/**
+ * Memory provider registry for the evolution family.
+ * Service Definition role; concrete providers register here.
+ * @module @deepseek-ai/dsh-memory
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+export type MemoryTarget = 'memory' | 'user';
+export interface MemoryOperation {
+    action: 'add' | 'replace' | 'remove';
+    facts?: string | undefined;
+    content?: string | undefined;
+    old_text?: string | undefined;
+}
+export interface MemoryApplyResult {
+    ok: boolean;
+    message: string;
+    entries: string[];
+    chars: number;
+    limit: number;
+}
+export interface MemorySnapshot {
+    version: number;
+    sha256: string;
+    memory: string[];
+    user: string[];
+}
+export interface MemoryProvider {
+    readonly name: string;
+    read(target: MemoryTarget, signal?: AbortSignal): Promise<string[]>;
+    applyBatch(target: MemoryTarget, operations: MemoryOperation[], signal?: AbortSignal): Promise<MemoryApplyResult>;
+    snapshot(signal?: AbortSignal): Promise<MemorySnapshot>;
+    renderContext(): Promise<string>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        memory: MemoryRegistry;
+    }
+}
+export declare class MemoryRegistry extends Service {
+    private readonly providers;
+    constructor(ctx: Context);
+    registerProvider(provider: MemoryProvider): () => void;
+    private provider;
+    read(target: MemoryTarget, signal?: AbortSignal): Promise<string[]>;
+    applyBatch(target: MemoryTarget, operations: MemoryOperation[], signal?: AbortSignal): Promise<MemoryApplyResult>;
+    snapshot(signal?: AbortSignal): Promise<MemorySnapshot>;
+    renderContext(): Promise<string>;
+}
+export default MemoryRegistry;
+//# 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-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,44 @@
+{
+  "name": "@lmzhen/dsh-memory",
+  "description": "Memory provider registry for self-evolution (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"
+  },
+  "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"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6"
+  }
+}