@lmzhen/dsh-memory 0.3.67 → 0.3.69

package/README.md

@@ -21,4 +21,4 @@ Independent of request-prefix construction. This package does not alter the asse
 ## Known Limitations and Deferred Work
 
 
-- No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
+- `provider` pins the registry to one provider name (V27 G6.3); empty (the default) serves the FIRST registered provider, so with two providers mounted the choice is row order. A pin that no mounted provider satisfies warns when a differently-named provider registers and then fails the first read/write with the pin named — the registry and the registration API are one service, so there is no earlier point to check it.

package/lib/index.js

@@ -1,4 +1,5 @@
 import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
 //#region lib/types/index.js
 /**
 * Memory provider registry for the evolution family.
@@ -6,17 +7,36 @@ import { Service } from "@deepseek-ai/cordis";
 * @module @lmzhen/dsh-memory
 */
 var MemoryRegistry = class extends Service {
+	/**
+	* V27 G6.3: the same provider-pin contract the io/state seams use. Before
+	* this, every delegation called `provider()` with no name, so with two
+	* providers mounted the session-visible store was decided by ROW ORDER while
+	* `memory-files.providerName` renamed a registration nothing selected — a
+	* config no consumer read. Empty keeps the old behavior (first registered).
+	*/
+	static Config = z.object({ provider: z.string().default("") });
 	providers = /* @__PURE__ */ new Map();
-	constructor(ctx) {
+	providerName;
+	pinWarned = false;
+	constructor(ctx, config = {}) {
 		super(ctx, "memory");
+		this.providerName = config.provider ?? "";
 	}
 	registerProvider(provider) {
 		if (this.providers.has(provider.name)) throw new Error(`memory provider "${provider.name}" already registered`);
 		this.providers.set(provider.name, provider);
+		if (this.providerName && provider.name !== this.providerName && !this.providers.has(this.providerName) && !this.pinWarned) {
+			this.pinWarned = true;
+			this.ctx.logger.warn(`memory: config.provider="${this.providerName}" is not registered (mounted: "${provider.name}"); memory reads and writes fail until that provider mounts`);
+		}
 		return () => {
 			if (this.providers.get(provider.name) === provider) this.providers.delete(provider.name);
 		};
 	}
+	/** Configured provider: the pinned name, or the first registered one. */
+	selected() {
+		return this.provider(this.providerName || void 0);
+	}
 	/** 0.3.17 (E-73): named lookup like the io/state-storage registries; no
 	* name = first registered (backward compatible). A named miss throws (F-333,
 	* 0.3.23) instead of silently falling back to the first provider, so a wrong
@@ -32,10 +52,10 @@ var MemoryRegistry = class extends Service {
 		return first;
 	}
 	read(target) {
-		return this.provider().read(target);
+		return this.selected().read(target);
 	}
 	async applyBatch(target, operations) {
-		const result = await this.provider().applyBatch(target, operations);
+		const result = await this.selected().applyBatch(target, operations);
 		if (result.ok) this.ctx.emit("evolution/memory-applied", {
 			target,
 			chars: result.chars,
@@ -48,10 +68,10 @@ var MemoryRegistry = class extends Service {
 	* consumer (tests inspect the raw snapshot, kept by declaration).
 	* @internal Exported for this package's own tests only. */
 	snapshot() {
-		return this.provider().snapshot();
+		return this.selected().snapshot();
 	}
 	renderContext() {
-		return this.provider().renderContext();
+		return this.selected().renderContext();
 	}
 };
 //#endregion

package/lib/types/index.d.ts

@@ -4,7 +4,13 @@
  * @module @lmzhen/dsh-memory
  */
 import { Context, Service } from '@deepseek-ai/cordis';
+import type Schema from '@deepseek-ai/schemastery';
 export type MemoryTarget = 'memory' | 'user';
+/** Service config (V27 G6.3): pin one provider by name. */
+export interface Config {
+    /** Provider to use; empty = first registered provider (row order). */
+    provider?: string;
+}
 export interface MemoryOperation {
     action: 'add' | 'replace' | 'remove';
     facts?: string | undefined;
@@ -51,9 +57,21 @@ declare module '@deepseek-ai/cordis' {
     }
 }
 export declare class MemoryRegistry extends Service {
+    /**
+     * V27 G6.3: the same provider-pin contract the io/state seams use. Before
+     * this, every delegation called `provider()` with no name, so with two
+     * providers mounted the session-visible store was decided by ROW ORDER while
+     * `memory-files.providerName` renamed a registration nothing selected — a
+     * config no consumer read. Empty keeps the old behavior (first registered).
+     */
+    static Config: Schema<Config>;
     private readonly providers;
-    constructor(ctx: Context);
+    private readonly providerName;
+    private pinWarned;
+    constructor(ctx: Context, config?: Config);
     registerProvider(provider: MemoryProvider): () => void;
+    /** Configured provider: the pinned name, or the first registered one. */
+    private selected;
     /** 0.3.17 (E-73): named lookup like the io/state-storage registries; no
      * name = first registered (backward compatible). A named miss throws (F-333,
      * 0.3.23) instead of silently falling back to the first provider, so a wrong

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-memory",
   "description": "Memory provider registry for self-evolution (community build)",
-  "version": "0.3.67",
+  "version": "0.3.69",
   "publishConfig": {
     "access": "public"
   },
@@ -29,7 +29,9 @@
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
-  "dependencies": {},
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
   "peerDependencies": {
     "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1"