@lmzhen/dsh-evolution-state-storage 0.1.0-rc.1

package/README.md

@@ -0,0 +1,26 @@
+# @deepseek-ai/dsh-evolution-state-storage
+
+Provider registry seam for durable evolution state
+
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-state-storage` 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
+
+
+- - Provider registry has no default medium. Mount `evolution-state-domain` or `evolution-state-json` before state reads.
+

package/lib/index.js

@@ -0,0 +1,35 @@
+import { Service } from "@deepseek-ai/cordis";
+//#region lib/types/index.js
+/**
+* Provider seam for durable evolution state.
+*
+* The state CONSUMER (`@lmzhen/dsh-evolution-state`) never touches a
+* medium. Providers register here: `domain` (storage-domain KV) and `json`
+* (IO-seam files) are the two shipped providers.
+* @module @lmzhen/dsh-evolution-state-storage
+*/
+var EvolutionStateStorageRegistry = class extends Service {
+	providers = /* @__PURE__ */ new Map();
+	constructor(ctx) {
+		super(ctx, "evolutionStateStorage");
+	}
+	registerProvider(provider) {
+		if (this.providers.has(provider.name)) throw new Error(`evolution state storage 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(name) {
+		if (name) {
+			const provider = this.providers.get(name);
+			if (provider) return provider;
+			throw new Error(`evolution state storage provider "${name}" is not registered`);
+		}
+		const first = this.providers.values().next().value;
+		if (!first) throw new Error("no evolution state storage provider registered; mount @lmzhen/dsh-evolution-state-json or @lmzhen/dsh-evolution-state-domain");
+		return first;
+	}
+};
+//#endregion
+export { EvolutionStateStorageRegistry, EvolutionStateStorageRegistry as default };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-state-storage";
+const name = "evolution-state-storage-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,65 @@
+/**
+ * Provider seam for durable evolution state.
+ *
+ * The state CONSUMER (`@deepseek-ai/dsh-evolution-state`) never touches a
+ * medium. Providers register here: `domain` (storage-domain KV) and `json`
+ * (IO-seam files) are the two shipped providers.
+ * @module @deepseek-ai/dsh-evolution-state-storage
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+export type PendingKind = 'memory' | 'skill' | 'skill_batch' | 'capability';
+export type PendingStatus = 'pending' | 'approved' | 'rejected';
+export interface ReviewStateRecord {
+    turnsSinceMemory: number;
+    turnsSinceSkill: number;
+    lastTurn: number;
+}
+export interface CuratorStateRecord {
+    lastRunAt: number;
+    runCount: number;
+    lastSummary: string;
+    paused: boolean;
+}
+export interface PendingRecord {
+    id: string;
+    kind: PendingKind;
+    summary: string;
+    args: unknown;
+    createdAt: string;
+    status: PendingStatus;
+    resolvedAt?: string | undefined;
+    claimedBy?: string | undefined;
+    claimedAt?: string | undefined;
+}
+export interface PendingResolution {
+    record: PendingRecord | null;
+    applied: boolean;
+}
+export interface EvolutionStateStorage {
+    readonly name: string;
+    loadReviewState(sessionId: string): Promise<ReviewStateRecord | null>;
+    saveReviewState(sessionId: string, record: ReviewStateRecord): Promise<void>;
+    loadCuratorState(): Promise<CuratorStateRecord | null>;
+    saveCuratorState(record: CuratorStateRecord): Promise<void>;
+    listPending(status?: PendingStatus): Promise<PendingRecord[]>;
+    savePending(record: PendingRecord): Promise<void>;
+    /** Atomically transition a pending record exactly once. */
+    tryResolvePending(id: string, status: Exclude<PendingStatus, 'pending'>): Promise<PendingResolution>;
+    /** Atomically mark a pending record as claimed by one approver, or return null. */
+    claimPending(id: string, claimId: string): Promise<PendingRecord | null>;
+    /** Release this claim when the replay runner cannot complete. */
+    releasePendingClaim(id: string, claimId: string): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        evolutionStateStorage: EvolutionStateStorageRegistry;
+    }
+}
+export declare class EvolutionStateStorageRegistry extends Service {
+    private readonly providers;
+    constructor(ctx: Context);
+    registerProvider(provider: EvolutionStateStorage): () => void;
+    provider(name?: string): EvolutionStateStorage;
+}
+export default EvolutionStateStorageRegistry;
+//# 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 = "evolution-state-storage-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,42 @@
+{
+  "name": "@lmzhen/dsh-evolution-state-storage",
+  "description": "Provider registry seam for durable evolution state (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-evolution-state-storage"
+  },
+  "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": {},
+  "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"
+  }
+}