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

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-evolution-io
+
+IO seam for evolution providers
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-evolution-io` 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,31 @@
+import { Service } from "@deepseek-ai/cordis";
+//#region lib/types/index.js
+/**
+* IO seam for evolution providers.
+* @module @lmzhen/dsh-evolution-io
+*/
+var EvolutionIoRegistry = class extends Service {
+	providers = /* @__PURE__ */ new Map();
+	constructor(ctx) {
+		super(ctx, "evolutionIo");
+	}
+	registerProvider(provider) {
+		if (this.providers.has(provider.name)) throw new Error(`evolution IO 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 IO provider "${name}" is not registered`);
+		}
+		const first = this.providers.values().next().value;
+		if (!first) throw new Error("no evolution IO provider registered");
+		return first;
+	}
+};
+//#endregion
+export { EvolutionIoRegistry, EvolutionIoRegistry as default };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-evolution-io";
+const name = "evolution-io-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,28 @@
+/**
+ * IO seam for evolution providers.
+ * @module @deepseek-ai/dsh-evolution-io
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+export interface EvolutionIo {
+    readonly name: string;
+    readText(path: string, signal?: AbortSignal): Promise<string | null>;
+    writeText(path: string, content: string, signal?: AbortSignal): Promise<void>;
+    remove(path: string): Promise<void>;
+    list(path: string): Promise<string[]>;
+    exists(path: string): Promise<boolean>;
+    rename(path: string, destination: string): Promise<void>;
+    copy(path: string, destination: string): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        evolutionIo: EvolutionIoRegistry;
+    }
+}
+export declare class EvolutionIoRegistry extends Service {
+    private readonly providers;
+    constructor(ctx: Context);
+    registerProvider(provider: EvolutionIo): () => void;
+    provider(name?: string): EvolutionIo;
+}
+export default EvolutionIoRegistry;
+//# 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-io-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-evolution-io",
+  "description": "IO seam for evolution 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-io"
+  },
+  "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"
+  }
+}