dsh-mnemon 0.3.2 → 0.3.3

package/README.md

@@ -9,6 +9,7 @@
   <a href="https://github.com/omdsh-dev/dsh-mnemon/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/omdsh-dev/dsh-mnemon" /></a>
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
   <a href="https://dshfind.com/en/plugins/omdsh-dev/dsh-mnemon?ref=badge"><img alt="dshfind" src="https://dshfind.com/api/badge/omdsh-dev/dsh-mnemon?lang=en" /></a>
+  <a href="https://dshfind.com/en/plugins/omdsh-dev/dsh-mnemon?ref=badge"><img alt="dshfind downloads" src="https://dshfind.com/api/badge/omdsh-dev/dsh-mnemon?metric=downloads&amp;lang=en" /></a>
 </p>
 
 <p align="center"><strong>The three-tier, pluggable, Agent-driven memory system for DeepSeek Harness.</strong></p>
@@ -23,7 +24,7 @@
 <p align="center">
   <a href="./docs/en/capabilities.md"><strong>Explore the capability map</strong></a> ·
   <a href="./docs/en/getting-started.md">Start in five minutes</a> ·
-  <a href="./docs/en/releases/v0.3.2.md">Read the v0.3.2 notes</a> ·
+  <a href="./docs/en/releases/v0.3.3.md">Read the v0.3.3 notes</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">Watch the widescreen demo</a>
 </p>
 
@@ -205,7 +206,7 @@ See [Operations, security, and troubleshooting](./docs/en/operations.md) for bac
 | Back up, update, or troubleshoot | [Operations](./docs/en/operations.md) |
 | Integrate tools, commands, or RPC | [Interface reference](./docs/en/interfaces.md) |
 | Build a Layer, Adapter, Strategy, Guard, or MemorySource extension | [Extension guide](./docs/en/extensions.md) |
-| Review the release | [v0.3.2 release notes](./docs/en/releases/v0.3.2.md) |
+| Review the release | [v0.3.3 release notes](./docs/en/releases/v0.3.3.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 

package/README.zh-CN.md

@@ -9,6 +9,7 @@
   <a href="https://github.com/omdsh-dev/dsh-mnemon/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/omdsh-dev/dsh-mnemon" /></a>
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg" /></a>
   <a href="https://dshfind.com/zh/plugins/omdsh-dev/dsh-mnemon?ref=badge"><img alt="dshfind" src="https://dshfind.com/api/badge/omdsh-dev/dsh-mnemon?lang=zh" /></a>
+  <a href="https://dshfind.com/zh/plugins/omdsh-dev/dsh-mnemon?ref=badge"><img alt="dshfind 下载量" src="https://dshfind.com/api/badge/omdsh-dev/dsh-mnemon?metric=downloads&amp;lang=zh" /></a>
 </p>
 
 <p align="center"><strong>DeepSeek Harness 的三层、可插拔、Agent 驱动记忆系统。</strong></p>
@@ -23,7 +24,7 @@
 <p align="center">
   <a href="./docs/zh-CN/capabilities.md"><strong>先看能力地图</strong></a> ·
   <a href="./docs/zh-CN/getting-started.md">5 分钟开始</a> ·
-  <a href="./docs/zh-CN/releases/v0.3.2.md">v0.3.2 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.3.3.md">v0.3.3 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -205,7 +206,7 @@ dsh plugin --profile headless add "link:/absolute/path/to/dsh-mnemon"
 | 备份、更新或排障 | [运维指南](./docs/zh-CN/operations.md) |
 | 接入工具、命令或 RPC | [接口参考](./docs/zh-CN/interfaces.md) |
 | 开发 Layer、Adapter、Strategy、Guard 或 MemorySource 扩展 | [扩展开发指南](./docs/zh-CN/extensions.md) |
-| 查看本次升级 | [v0.3.2 发布说明](./docs/zh-CN/releases/v0.3.2.md) |
+| 查看本次升级 | [v0.3.3 发布说明](./docs/zh-CN/releases/v0.3.3.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/client.js

@@ -12515,6 +12515,106 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/subagent-token-usage.tsx
+		/** Mnemon compatibility shim for DSH's fork-backed subagent token metric. */
+		const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
+		const SUBAGENT_LINEAGE_SLOT = "conversation.session.header.lineage";
+		const SUBAGENT_LOCALE = "subagent";
+		const MNEMON_SHADOW_PRIORITY = -100;
+		const scopedSnapshots = /* @__PURE__ */ new WeakMap();
+		function isTokenUsage(value) {
+			if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+			const usage = value;
+			return [
+				"uncachedInputTokens",
+				"outputTokens",
+				"cacheReadTokens",
+				"cacheWriteTokens"
+			].every((key) => {
+				const count = usage[key];
+				return typeof count === "number" && Number.isSafeInteger(count) && count >= 0;
+			});
+		}
+		/**
+		* Present the child-local projection under the generic key expected by the
+		* released official catalog component. All other consumers continue seeing
+		* DSH's complete-log `tokenUsage` value.
+		*/
+		function scopeSubagentTokenUsage(state) {
+			const cached = scopedSnapshots.get(state);
+			if (cached !== void 0) return cached;
+			let byId;
+			for (const [id, summary] of Object.entries(state.byId)) {
+				if (summary.origin !== "subagent") continue;
+				const projections = summary.projectionValues;
+				const scopedUsage = projections?.[MNEMON_SUBAGENT_TOKEN_USAGE_KEY];
+				if (!isTokenUsage(scopedUsage)) continue;
+				byId ??= { ...state.byId };
+				byId[id] = {
+					...summary,
+					projectionValues: {
+						...projections,
+						tokenUsage: scopedUsage
+					}
+				};
+			}
+			const scoped = byId === void 0 ? state : {
+				...state,
+				byId
+			};
+			scopedSnapshots.set(state, scoped);
+			return scoped;
+		}
+		/** Wrap the framework hook while preserving its selector/equality contract. */
+		function createScopedUseSessions(useSessions) {
+			return (selector, equal) => useSessions((state) => selector(scopeSubagentTokenUsage(state)), equal);
+		}
+		function lineageShadow(official) {
+			return function MnemonSubagentHeaderLineage(props) {
+				return (0, react.createElement)(official, {
+					...props,
+					useSessions: createScopedUseSessions(props.useSessions)
+				});
+			};
+		}
+		function officialLineage(entries) {
+			return entries.find((entry) => (entry.options.priority ?? 0) === 0 && entry.locale === SUBAGENT_LOCALE && typeof entry.component === "function" && typeof entry.inject === "function");
+		}
+		/**
+		* Shadow the released official single-slot entry at a lower priority. The
+		* component and action factory are captured from the public slot ledger, so
+		* Mnemon keeps the official UI, styles, locale, and navigation behavior.
+		*/
+		function mountSubagentTokenUsageOverride(ctx) {
+			const slots = ctx.slots;
+			if (typeof slots.entries !== "function" || typeof slots.subscribe !== "function" || typeof slots.register !== "function") return () => {};
+			let official;
+			let disposeShadow;
+			const reconcile = () => {
+				const entries = slots.entries(SUBAGENT_LINEAGE_SLOT);
+				if (official !== void 0 && entries.includes(official)) return;
+				const disposePreviousShadow = disposeShadow;
+				disposeShadow = void 0;
+				official = void 0;
+				disposePreviousShadow?.();
+				official = officialLineage(entries);
+				if (official === void 0) return;
+				disposeShadow = slots.register({
+					name: SUBAGENT_LINEAGE_SLOT,
+					priority: MNEMON_SHADOW_PRIORITY,
+					locale: official.locale,
+					inject: official.inject,
+					registrant: "dsh-mnemon/subagent-token-usage"
+				}, lineageShadow(official.component));
+			};
+			const unsubscribe = slots.subscribe(SUBAGENT_LINEAGE_SLOT, reconcile);
+			reconcile();
+			return () => {
+				unsubscribe();
+				disposeShadow?.();
+			};
+		}
+		//#endregion
 		//#region src/client/index.ts
 		const inject = [
 			"slots",
@@ -12600,6 +12700,7 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "dsh-mnemon: locale dictionaries");
+			ctx.slots.inject("conversation.session.header.lineage", () => mountSubagentTokenUsageOverride(ctx));
 			const translate = ctx.locale.bind(namespace);
 			let activeMemoryWorkspace;
 			const reconcileMemoryWorkspace = () => {

package/lib/index.js

@@ -12,6 +12,7 @@ import { accessSync, closeSync, constants, existsSync, fstatSync, lstatSync, mkd
 import { homedir, tmpdir } from "node:os";
 import { strToU8, unzipSync, zipSync } from "fflate";
 import { fileURLToPath } from "node:url";
+import { z as z$1 } from "zod";
 //#region src/shared/contracts.ts
 const MNEMON_READ_CHANNEL = "/dsh-mnemon-read";
 const MNEMON_ACTIVATION_CHANNEL = "/dsh-mnemon-activation";
@@ -10280,6 +10281,130 @@ function registerTools(ctx, serviceOrSource, coordinator, runtimeMemory, documen
 	}));
 }
 //#endregion
+//#region src/subagent-token-usage.ts
+/**
+* Mnemon-owned projection for provider usage after a subagent descriptor.
+*
+* Fork-backed subagents inherit the parent's durable event prefix. DSH's
+* generic `tokenUsage` projection intentionally totals that complete log, so
+* it cannot also represent the cost of the child shown in the subagent
+* catalog. This independent projection keeps the generic metric untouched
+* and resets at every durable descriptor.
+*/
+const tokenCountSchema = z$1.number().int().nonnegative();
+const tokenUsageSchema = z$1.object({
+	uncachedInputTokens: tokenCountSchema,
+	outputTokens: tokenCountSchema,
+	cacheReadTokens: tokenCountSchema,
+	cacheWriteTokens: tokenCountSchema
+}).strict();
+const tokenUsageStateSchema = z$1.object({
+	descriptorSeen: z$1.boolean(),
+	totals: tokenUsageSchema,
+	last: z$1.object({
+		turn: tokenCountSchema,
+		step: tokenCountSchema,
+		buckets: tokenUsageSchema
+	}).strict().nullable()
+}).strict();
+const emptyTokenUsage = () => ({
+	uncachedInputTokens: 0,
+	outputTokens: 0,
+	cacheReadTokens: 0,
+	cacheWriteTokens: 0
+});
+function nonnegativeInteger(value) {
+	return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : void 0;
+}
+function usageBuckets(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+	const usage = value;
+	const inputTokens = nonnegativeInteger(usage.inputTokens);
+	const outputTokens = nonnegativeInteger(usage.outputTokens);
+	const cacheReadTokens = usage.cacheReadTokens === void 0 ? 0 : nonnegativeInteger(usage.cacheReadTokens);
+	const cacheWriteTokens = usage.cacheWriteTokens === void 0 ? 0 : nonnegativeInteger(usage.cacheWriteTokens);
+	if (inputTokens === void 0 || outputTokens === void 0 || cacheReadTokens === void 0 || cacheWriteTokens === void 0) return void 0;
+	return {
+		uncachedInputTokens: inputTokens,
+		outputTokens,
+		cacheReadTokens,
+		cacheWriteTokens
+	};
+}
+function usageSample(event) {
+	const turn = nonnegativeInteger(event.data.turn);
+	const step = nonnegativeInteger(event.data.step);
+	if (turn === void 0 || step === void 0) return void 0;
+	let rawUsage;
+	if (event.type === "assistant/chunk") {
+		const chunk = event.data.chunk;
+		if (typeof chunk !== "object" || chunk === null || Array.isArray(chunk)) return void 0;
+		const record = chunk;
+		if (record.type !== "usage") return void 0;
+		rawUsage = record.usage;
+	} else if (event.type === "assistant/message") rawUsage = event.data.usage;
+	else return;
+	const buckets = usageBuckets(rawUsage);
+	return buckets === void 0 ? void 0 : {
+		turn,
+		step,
+		buckets
+	};
+}
+function equalTokenUsage(left, right) {
+	return left.uncachedInputTokens === right.uncachedInputTokens && left.outputTokens === right.outputTokens && left.cacheReadTokens === right.cacheReadTokens && left.cacheWriteTokens === right.cacheWriteTokens;
+}
+function replaceTokenUsage(totals, previous, next) {
+	return {
+		uncachedInputTokens: totals.uncachedInputTokens - (previous?.uncachedInputTokens ?? 0) + next.uncachedInputTokens,
+		outputTokens: totals.outputTokens - (previous?.outputTokens ?? 0) + next.outputTokens,
+		cacheReadTokens: totals.cacheReadTokens - (previous?.cacheReadTokens ?? 0) + next.cacheReadTokens,
+		cacheWriteTokens: totals.cacheWriteTokens - (previous?.cacheWriteTokens ?? 0) + next.cacheWriteTokens
+	};
+}
+/**
+* Fold provider usage after the latest subagent descriptor. A fork may carry
+* an ancestor descriptor as part of its seed, so every descriptor resets the
+* fold and the child's own descriptor becomes the final authoritative origin.
+*/
+const mnemonSubagentTokenUsageProjectionDefinition = {
+	key: "mnemonSubagentTokenUsage",
+	stateVersion: 1,
+	stateSchema: tokenUsageStateSchema,
+	init: () => ({
+		descriptorSeen: false,
+		totals: emptyTokenUsage(),
+		last: null
+	}),
+	apply: (state, event) => {
+		if (event.type === "subagent/descriptor") return {
+			descriptorSeen: true,
+			totals: emptyTokenUsage(),
+			last: null
+		};
+		if (!state.descriptorSeen) return state;
+		const sample = usageSample(event);
+		if (sample === void 0) return state;
+		const previous = state.last !== null && state.last.turn === sample.turn && state.last.step === sample.step ? state.last.buckets : void 0;
+		if (previous !== void 0 && equalTokenUsage(previous, sample.buckets)) return state;
+		return {
+			descriptorSeen: true,
+			totals: replaceTokenUsage(state.totals, previous, sample.buckets),
+			last: sample
+		};
+	},
+	wire: {
+		viewSchema: tokenUsageSchema.nullable(),
+		view: (state) => state.descriptorSeen ? state.totals : null
+	}
+};
+/** Register lazily when the optional DSH projection service is present. */
+function registerMnemonSubagentTokenUsageProjection(ctx) {
+	ctx.inject(["sessionProjections"], (rawContext) => {
+		rawContext.sessionProjections?.register(mnemonSubagentTokenUsageProjectionDefinition);
+	});
+}
+//#endregion
 //#region src/index.ts
 const name = "dsh-mnemon";
 const provide = ["mnemonMemory"];
@@ -10301,6 +10426,7 @@ function optionalWorkspaceRegistry(ctx) {
 /** Mount native model tools on every DSH surface and UI RPC only when Web connection exists. */
 function apply(rawContext, config = {}) {
 	const ctx = rawContext;
+	registerMnemonSubagentTokenUsageProjection(ctx);
 	const extensions = memoryBoot;
 	ctx.provide?.("mnemonMemory", extensions);
 	const prepared = /* @__PURE__ */ new Map();

package/lib/types/src/client/subagent-token-usage.d.ts

@@ -0,0 +1,24 @@
+import type { SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MnemonClientContext } from './dsh-compat.ts';
+export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
+export interface MnemonTokenUsageProjection {
+    uncachedInputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+/**
+ * Present the child-local projection under the generic key expected by the
+ * released official catalog component. All other consumers continue seeing
+ * DSH's complete-log `tokenUsage` value.
+ */
+export declare function scopeSubagentTokenUsage(state: SessionListState): SessionListState;
+/** Wrap the framework hook while preserving its selector/equality contract. */
+export declare function createScopedUseSessions(useSessions: SnapshotSelectorHook<SessionListState>): SnapshotSelectorHook<SessionListState>;
+/**
+ * Shadow the released official single-slot entry at a lower priority. The
+ * component and action factory are captured from the public slot ledger, so
+ * Mnemon keeps the official UI, styles, locale, and navigation behavior.
+ */
+export declare function mountSubagentTokenUsageOverride(ctx: MnemonClientContext): () => void;

package/lib/types/src/subagent-token-usage.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mnemon-owned projection for provider usage after a subagent descriptor.
+ *
+ * Fork-backed subagents inherit the parent's durable event prefix. DSH's
+ * generic `tokenUsage` projection intentionally totals that complete log, so
+ * it cannot also represent the cost of the child shown in the subagent
+ * catalog. This independent projection keeps the generic metric untouched
+ * and resets at every durable descriptor.
+ */
+import { z } from 'zod';
+import type { HostContextShape, HostSessionEvent } from './contracts.ts';
+export interface MnemonTokenUsageProjection {
+    uncachedInputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+export interface MnemonSubagentTokenUsageState {
+    descriptorSeen: boolean;
+    totals: MnemonTokenUsageProjection;
+    last: {
+        turn: number;
+        step: number;
+        buckets: MnemonTokenUsageProjection;
+    } | null;
+}
+/** Wire key consumed only by Mnemon's subagent-catalog compatibility shim. */
+export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
+/**
+ * Fold provider usage after the latest subagent descriptor. A fork may carry
+ * an ancestor descriptor as part of its seed, so every descriptor resets the
+ * fold and the child's own descriptor becomes the final authoritative origin.
+ */
+export declare const mnemonSubagentTokenUsageProjectionDefinition: {
+    readonly key: "mnemonSubagentTokenUsage";
+    readonly stateVersion: 1;
+    readonly stateSchema: z.ZodType<MnemonSubagentTokenUsageState, unknown, z.core.$ZodTypeInternals<MnemonSubagentTokenUsageState, unknown>>;
+    readonly init: () => MnemonSubagentTokenUsageState;
+    readonly apply: (state: MnemonSubagentTokenUsageState, event: HostSessionEvent) => MnemonSubagentTokenUsageState;
+    readonly wire: {
+        readonly viewSchema: z.ZodNullable<z.ZodType<MnemonTokenUsageProjection, unknown, z.core.$ZodTypeInternals<MnemonTokenUsageProjection, unknown>>>;
+        readonly view: (state: MnemonSubagentTokenUsageState) => MnemonTokenUsageProjection | null;
+    };
+};
+/** Register lazily when the optional DSH projection service is present. */
+export declare function registerMnemonSubagentTokenUsageProjection(ctx: HostContextShape): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Composable three-tier memory control plane for DeepSeek Harness: persistent runtime context, searchable project documents, pluggable long-term memory, guarded strategies, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",
@@ -138,7 +138,8 @@
   "dependencies": {
     "fflate": "^0.8.3",
     "markdown-to-jsx": "^7.7.17",
-    "schemastery": "^3.18.0"
+    "schemastery": "^3.18.0",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.1",