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

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-state
+
+Durable storage-domain-backed evolution state with JSON fallback
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-state` 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,53 @@
+import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { EVOLUTION_DOMAIN, curatorStateSchema, pendingSchema, reviewStateSchema } from "@lmzhen/dsh-evolution-state-domain";
+//#region lib/types/index.js
+/**
+* Durable evolution state consumer.
+*
+* The service owns no medium and performs no IO. It resolves the mounted
+* provider from `ctx.evolutionStateStorage` (see evolution-state-json and
+* evolution-state-domain); `provider` config may pin one by name.
+* @module @lmzhen/dsh-evolution-state
+*/
+var EvolutionState = class extends Service {
+	static inject = ["evolutionStateStorage"];
+	static Config = z.object({ provider: z.string().default("") });
+	providerName;
+	constructor(ctx, config = {}) {
+		super(ctx, "evolutionState");
+		this.providerName = config.provider ?? "";
+	}
+	storage() {
+		return this.ctx.evolutionStateStorage.provider(this.providerName || void 0);
+	}
+	loadReviewState(sessionId) {
+		return this.storage().loadReviewState(sessionId);
+	}
+	saveReviewState(sessionId, record) {
+		return this.storage().saveReviewState(sessionId, record);
+	}
+	loadCuratorState() {
+		return this.storage().loadCuratorState();
+	}
+	saveCuratorState(record) {
+		return this.storage().saveCuratorState(record);
+	}
+	listPending(status = "pending") {
+		return this.storage().listPending(status);
+	}
+	savePending(record) {
+		return this.storage().savePending(record);
+	}
+	tryResolvePending(id, status) {
+		return this.storage().tryResolvePending(id, status);
+	}
+	claimPending(id, claimId) {
+		return this.storage().claimPending(id, claimId);
+	}
+	releasePendingClaim(id, claimId) {
+		return this.storage().releasePendingClaim(id, claimId);
+	}
+};
+//#endregion
+export { EVOLUTION_DOMAIN, EvolutionState, EvolutionState as default, curatorStateSchema, pendingSchema, reviewStateSchema };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-state";
+const name = "evolution-state-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,40 @@
+/**
+ * Durable evolution state consumer.
+ *
+ * The service owns no medium and performs no IO. It resolves the mounted
+ * provider from `ctx.evolutionStateStorage` (see evolution-state-json and
+ * evolution-state-domain); `provider` config may pin one by name.
+ * @module @deepseek-ai/dsh-evolution-state
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type Schema from '@deepseek-ai/schemastery';
+import type { CuratorStateRecord, PendingRecord, PendingStatus, ReviewStateRecord } from '@deepseek-ai/dsh-evolution-state-storage';
+export type { CuratorStateRecord, EvolutionStateStorage, PendingRecord, PendingStatus, ReviewStateRecord, } from '@deepseek-ai/dsh-evolution-state-storage';
+export { curatorStateSchema, EVOLUTION_DOMAIN, pendingSchema, reviewStateSchema, } from '@deepseek-ai/dsh-evolution-state-domain';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        evolutionState: EvolutionState;
+    }
+}
+export interface Config {
+    /** Pin a provider by name; empty = first registered provider. */
+    provider?: string;
+}
+export declare class EvolutionState extends Service {
+    static inject: string[];
+    static Config: Schema<Config>;
+    private readonly providerName;
+    constructor(ctx: Context, config?: Config);
+    private storage;
+    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>;
+    tryResolvePending(id: string, status: 'approved' | 'rejected'): Promise<import("@deepseek-ai/dsh-evolution-state-storage").PendingResolution>;
+    claimPending(id: string, claimId: string): Promise<PendingRecord | null>;
+    releasePendingClaim(id: string, claimId: string): Promise<void>;
+}
+export default EvolutionState;
+//# 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-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,53 @@
+{
+  "name": "@lmzhen/dsh-evolution-state",
+  "description": "Durable evolution state consumer over pluggable storage providers (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"
+  },
+  "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",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-state-storage": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-state-domain": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-state-storage": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-state-domain": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io-node": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-state-json": "^0.1.0-rc.1"
+  }
+}