@lmzhen/dsh-skill-usage 0.3.74 → 0.3.77

package/README.md

@@ -30,3 +30,5 @@ Independent of request-prefix construction. This package does not alter the asse
 
 
 - No known durable consumer gaps at this time. Runtime contracts are covered by package and boundary tests.
+
+**Runtime invariant:** No companion is published. The platform auto-assembles nothing and the family mounts no `<pkg>/invariant` cordis row, so a companion here would never execute (v37 S2.1 / I-3).

package/lib/index.js

@@ -1,34 +1,20 @@
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
-import { appendEvolutionEvent, bumpPatch, bumpUse, bumpView, eventsFile, evolutionIoAdapter, evolutionRoot, getRecord, loadUsage, makeSerialQueue, markAgentCreated, mutateUsage, resolveSkillsRoot, usageObserved } from "@lmzhen/dsh-evolution-core";
+import { ToolDispatchNormalizer, appendEvolutionEvent, bumpPatch, bumpUse, bumpView, eventsFile, evolutionIoAdapter, evolutionRoot, getRecord, loadUsage, makeSerialQueue, markAgentCreated, mutateUsage, resolveSkillsRoot, sessionAudited, skillReadNameOf, usageObserved } from "@lmzhen/dsh-evolution-core";
 //#region lib/types/index.js
 /**
 * Skill usage telemetry service for the evolution family.
 * @module @lmzhen/dsh-skill-usage
 */
 /**
-* Read tool names -> usage kind. The single declarative classification table
-* for read-side observation (A2): any tool listed here records a `view` when
-* its call arguments name a skill.
+* Folds the session's dispatch events into one signal per READ (A2).
+*
+* The read tool table (only the real `skill` tool — the DSH catalog has no
+* `skill_load`/`skill_search` discovery pair, 0.3.18 E-59e) and the arguments
+* parse both live in evolution-core's `tool-dispatch` module: this sidecar used
+* to match `tool/call` itself, so every PTC session (`tool/ptc-dispatch*`)
+* counted zero views and never opened the observation window.
 */
-const READ_TOOL_KIND = { skill: "view" };
-/**
-* Skill name from a tool/call arguments payload (A2, mirrors
-* evolution-review's collectReadSkillNames): JSON strings are re-parsed and
-* `name` wins over `skill`. Empty when unparseable or anonymous.
-*/
-function skillNameFromToolCall(raw) {
-	let parsed = {};
-	if (typeof raw === "string") try {
-		parsed = JSON.parse(raw);
-	} catch {
-		return "";
-	}
-	else if (raw && typeof raw === "object") parsed = raw;
-	if (!parsed || typeof parsed !== "object") return "";
-	const obj = parsed;
-	return typeof obj.name === "string" ? obj.name : typeof obj.skill === "string" ? obj.skill : "";
-}
 /** Cumulative library-wide usage totals (C observation-window event counts). */
 function usageTotals(map) {
 	let views = 0;
@@ -50,7 +36,8 @@ var SkillUsageRegistry = class extends Service {
 	static inject = ["evolutionIo"];
 	static Config = z.object({
 		root: z.string().default(""),
-		eventsHome: z.string().default("")
+		eventsHome: z.string().default(""),
+		sessionScoped: z.boolean().default(false)
 	});
 	root;
 	eventsHome;
@@ -63,12 +50,13 @@ var SkillUsageRegistry = class extends Service {
 		this.eventsHome = config.eventsHome?.trim() || evolutionRoot();
 		this.io = evolutionIoAdapter(() => ctx.evolutionIo.provider());
 		ctx.effect(() => {
-			return ctx.on("session/event", (_session, event) => {
-				if (event.type !== "tool/call") return;
-				const data = event.data;
-				if (!(typeof data?.name === "string" ? READ_TOOL_KIND[data.name] : void 0)) return;
-				const name = skillNameFromToolCall(data?.arguments);
-				if (!name) return;
+			const reads = new ToolDispatchNormalizer();
+			return ctx.on("session/event", (session, event) => {
+				if (!sessionAudited(ctx, session.id, config.sessionScoped)) return;
+				const dispatch = reads.advance(event);
+				if (dispatch === null) return;
+				const name = skillReadNameOf(dispatch);
+				if (name === void 0) return;
 				this.observeRead(name).catch(() => {});
 			});
 		}, "skill-usage.telemetry");

package/lib/types/index.d.ts

@@ -14,6 +14,9 @@ export interface Config {
     root?: string;
     /** Home for the evolution event timeline (`<eventsHome>/evolution/events.json`); defaults to DSH_HOME or ~/.dsh. */
     eventsHome?: string;
+    /** Act only on sessions that carry the family's model tools (evolution-core's
+     * per-session probe). The shipped bundles set it; false observes every session. */
+    sessionScoped?: boolean;
 }
 export declare class SkillUsageRegistry extends Service {
     static inject: string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-skill-usage",
   "description": "Skill usage telemetry service (community build)",
-  "version": "0.3.74",
+  "version": "0.3.77",
   "publishConfig": {
     "access": "public"
   },
@@ -18,10 +18,6 @@
       "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": [
@@ -31,18 +27,16 @@
   "license": "MIT",
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@lmzhen/dsh-evolution-core": "^0.3.74"
+    "@lmzhen/dsh-evolution-core": "^0.3.77"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-io": "^0.3.74"
+    "@lmzhen/dsh-evolution-io": "^0.3.77"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@lmzhen/dsh-evolution-core": "^0.3.74",
-    "@lmzhen/dsh-evolution-io": "^0.3.74"
+    "@lmzhen/dsh-evolution-core": "^0.3.77",
+    "@lmzhen/dsh-evolution-io": "^0.3.77"
   }
 }

package/lib/invariant.js

@@ -1,8 +0,0 @@
-//#region lib/types/invariant.js
-const PACKAGE_NAME = "@lmzhen/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/invariant.d.ts

@@ -1,5 +0,0 @@
-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