@lmzhen/dsh-skill-usage 0.1.0-rc.1

package/README.md

@@ -0,0 +1,24 @@
+# @deepseek-ai/dsh-skill-usage
+
+Skill usage telemetry service
+
+## Model Experience
+
+### Indirect model surface
+
+#### What the model sees
+
+`@deepseek-ai/dsh-skill-usage` 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,64 @@
+import { Service } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { bumpPatch, bumpUse, bumpView, evolutionIoAdapter, loadUsage, saveUsage, skillsRoot } from "@lmzhen/dsh-evolution-core";
+//#region lib/types/index.js
+/**
+* Skill usage telemetry service for the evolution family.
+* @module @lmzhen/dsh-skill-usage
+*/
+var SkillUsageRegistry = class extends Service {
+	static inject = ["evolutionIo"];
+	static Config = z.object({ root: z.string().default("") });
+	root;
+	io;
+	usage = null;
+	chain = Promise.resolve();
+	constructor(ctx, config = {}) {
+		super(ctx, "skillUsage");
+		this.root = config.root ?? skillsRoot();
+		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
+	}
+	async map() {
+		if (!this.usage) this.usage = await loadUsage(this.root, this.io);
+		return this.usage;
+	}
+	async flush() {
+		if (this.usage) await saveUsage(this.root, this.usage, this.io);
+	}
+	/** Serialize read-modify-write cycles so concurrent record calls never lose updates. */
+	mutate(task) {
+		const run = this.chain.then(async () => task(await this.map()));
+		this.chain = run.then(() => void 0, () => void 0);
+		return run;
+	}
+	async record(name, kind, at = /* @__PURE__ */ new Date()) {
+		await this.mutate(async (map) => {
+			if (kind === "use") bumpUse(map, name, at);
+			else if (kind === "view") bumpView(map, name, at);
+			else bumpPatch(map, name, at);
+			await this.flush();
+		});
+	}
+	report() {
+		return this.mutate((map) => Promise.resolve(new Map(map)));
+	}
+	async markAgentCreated(name) {
+		await this.mutate(async (map) => {
+			const { markAgentCreated } = await import("@lmzhen/dsh-evolution-core");
+			markAgentCreated(map, name);
+			await this.flush();
+		});
+	}
+	/** Write feedback-derived quality onto the usage sidecar; curator reads it. */
+	async setQuality(name, score, warn) {
+		await this.mutate(async (map) => {
+			const record = map.get(name);
+			if (!record) return;
+			record.quality_score = score;
+			record.quality_warn = warn;
+			await this.flush();
+		});
+	}
+};
+//#endregion
+export { SkillUsageRegistry, SkillUsageRegistry as default };

package/lib/invariant.js

@@ -0,0 +1,8 @@
+//#region lib/types/invariant.js
+const PACKAGE_NAME = "@deepseek-ai/dsh-skill-usage";
+const name = "skill-usage-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,35 @@
+/**
+ * Skill usage telemetry service for the evolution family.
+ * @module @deepseek-ai/dsh-skill-usage
+ */
+import { Context, Service } from '@deepseek-ai/cordis';
+import type Schema from '@deepseek-ai/schemastery';
+import { type UsageMap } from '@deepseek-ai/dsh-evolution-core';
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        skillUsage: SkillUsageRegistry;
+    }
+}
+export interface Config {
+    root?: string;
+}
+export declare class SkillUsageRegistry extends Service {
+    static inject: string[];
+    static Config: Schema<Config>;
+    readonly root: string;
+    private readonly io;
+    private usage;
+    private chain;
+    constructor(ctx: Context, config?: Config);
+    private map;
+    flush(): Promise<void>;
+    /** Serialize read-modify-write cycles so concurrent record calls never lose updates. */
+    private mutate;
+    record(name: string, kind: 'use' | 'view' | 'patch', at?: Date): Promise<void>;
+    report(): Promise<UsageMap>;
+    markAgentCreated(name: string): Promise<void>;
+    /** Write feedback-derived quality onto the usage sidecar; curator reads it. */
+    setQuality(name: string, score: number, warn: boolean): Promise<void>;
+}
+export default SkillUsageRegistry;
+//# 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 = "skill-usage-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,48 @@
+{
+  "name": "@lmzhen/dsh-skill-usage",
+  "description": "Skill usage telemetry service (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-skill-usage"
+  },
+  "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",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@lmzhen/dsh-evolution-core": "^0.1.0-rc.1",
+    "@lmzhen/dsh-evolution-io": "^0.1.0-rc.1"
+  }
+}