dsh-mnemon 0.4.3 → 0.4.4

package/README.md

@@ -24,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.4.3.md">Read the v0.4.3 notes</a> ·
+  <a href="./docs/en/releases/v0.4.4.md">Read the v0.4.4 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>
 
@@ -42,6 +42,8 @@ v0.4.2 restores optional `displayMode: builtin` as a conversation placement for
 
 v0.4.3 aligns the collapsed Memory System icon with neighboring sidebar controls while preserving the expanded appearance. See the [patch release notes](./docs/en/releases/v0.4.3.md).
 
+v0.4.4 fixes session history failures on older DSH hosts by supporting both session projection contracts. Newer hosts and existing projection checkpoints remain compatible. See the [patch release notes](./docs/en/releases/v0.4.4.md).
+
 ## Understand the scope in 30 seconds
 
 | Tier | Keep here | How it reaches the Agent | Managed by |
@@ -216,7 +218,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.4.3 release notes](./docs/en/releases/v0.4.3.md) |
+| Review the release | [v0.4.4 release notes](./docs/en/releases/v0.4.4.md) |
 
 See the [documentation hub](./docs/en/README.md) for the full map.
 

package/README.zh-CN.md

@@ -24,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.4.3.md">v0.4.3 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.4.4.md">v0.4.4 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -42,6 +42,8 @@ v0.4.2 恢复可选 `displayMode: builtin`，只将 Sidebar 优先迭代的共
 
 v0.4.3 让折叠后的记忆系统图标与侧栏相邻控件对齐，并保留原有展开样式。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.3.md)。
 
+v0.4.4 同时支持新旧 DSH 会话投影接口，修复旧版宿主读取会话历史失败的问题，并保持新版宿主和已有投影检查点兼容。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.4.md)。
+
 ## 30 秒理解能力边界
 
 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 |
@@ -216,7 +218,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.4.3 发布说明](./docs/zh-CN/releases/v0.4.3.md) |
+| 查看本次升级 | [v0.4.4 发布说明](./docs/zh-CN/releases/v0.4.4.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/index.js

@@ -10819,6 +10819,10 @@ const tokenUsageStateSchema = z$1.object({
 		buckets: tokenUsageSchema
 	}).strict().nullable()
 }).strict();
+const tokenUsageWire = {
+	viewSchema: tokenUsageSchema.nullable(),
+	view: (state) => state.descriptorSeen ? state.totals : null
+};
 const emptyTokenUsage = () => ({
 	uncachedInputTokens: 0,
 	outputTokens: 0,
@@ -10844,17 +10848,19 @@ function usageBuckets(value) {
 	};
 }
 function usageSample(event) {
-	const turn = nonnegativeInteger(event.data.turn);
-	const step = nonnegativeInteger(event.data.step);
+	if (typeof event.data !== "object" || event.data === null || Array.isArray(event.data)) return void 0;
+	const data = event.data;
+	const turn = nonnegativeInteger(data.turn);
+	const step = nonnegativeInteger(data.step);
 	if (turn === void 0 || step === void 0) return void 0;
 	let rawUsage;
 	if (event.type === "assistant/chunk") {
-		const chunk = event.data.chunk;
+		const chunk = 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 if (event.type === "assistant/message") rawUsage = data.usage;
 	else return;
 	const buckets = usageBuckets(rawUsage);
 	return buckets === void 0 ? void 0 : {
@@ -10883,6 +10889,7 @@ const mnemonSubagentTokenUsageProjectionDefinition = {
 	key: "mnemonSubagentTokenUsage",
 	stateVersion: 1,
 	stateSchema: tokenUsageStateSchema,
+	schema: tokenUsageWire.viewSchema,
 	init: () => ({
 		descriptorSeen: false,
 		totals: emptyTokenUsage(),
@@ -10905,10 +10912,8 @@ const mnemonSubagentTokenUsageProjectionDefinition = {
 			last: sample
 		};
 	},
-	wire: {
-		viewSchema: tokenUsageSchema.nullable(),
-		view: (state) => state.descriptorSeen ? state.totals : null
-	}
+	view: tokenUsageWire.view,
+	wire: tokenUsageWire
 };
 /** Register lazily when the optional DSH projection service is present. */
 function registerMnemonSubagentTokenUsageProjection(ctx) {

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

@@ -8,7 +8,7 @@
  * and resets at every durable descriptor.
  */
 import { z } from 'zod';
-import type { HostContextShape, HostSessionEvent } from './contracts.ts';
+import type { HostContextShape } from './contracts.ts';
 export interface MnemonTokenUsageProjection {
     uncachedInputTokens: number;
     outputTokens: number;
@@ -24,6 +24,10 @@ export interface MnemonSubagentTokenUsageState {
         buckets: MnemonTokenUsageProjection;
     } | null;
 }
+interface ProjectionEvent {
+    type: string;
+    data: unknown;
+}
 /** Wire key consumed only by Mnemon's subagent-catalog compatibility shim. */
 export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
 /**
@@ -35,12 +39,15 @@ export declare const mnemonSubagentTokenUsageProjectionDefinition: {
     readonly key: "mnemonSubagentTokenUsage";
     readonly stateVersion: 1;
     readonly stateSchema: z.ZodType<MnemonSubagentTokenUsageState, unknown, z.core.$ZodTypeInternals<MnemonSubagentTokenUsageState, unknown>>;
+    readonly schema: z.ZodNullable<z.ZodType<MnemonTokenUsageProjection, unknown, z.core.$ZodTypeInternals<MnemonTokenUsageProjection, unknown>>>;
     readonly init: () => MnemonSubagentTokenUsageState;
-    readonly apply: (state: MnemonSubagentTokenUsageState, event: HostSessionEvent) => MnemonSubagentTokenUsageState;
+    readonly apply: (state: MnemonSubagentTokenUsageState, event: ProjectionEvent) => MnemonSubagentTokenUsageState;
+    readonly view: (state: MnemonSubagentTokenUsageState) => MnemonTokenUsageProjection | null;
     readonly wire: {
-        readonly viewSchema: z.ZodNullable<z.ZodType<MnemonTokenUsageProjection, unknown, z.core.$ZodTypeInternals<MnemonTokenUsageProjection, unknown>>>;
-        readonly view: (state: MnemonSubagentTokenUsageState) => MnemonTokenUsageProjection | null;
+        viewSchema: z.ZodNullable<z.ZodType<MnemonTokenUsageProjection, unknown, z.core.$ZodTypeInternals<MnemonTokenUsageProjection, unknown>>>;
+        view: (state: MnemonSubagentTokenUsageState) => MnemonTokenUsageProjection | null;
     };
 };
 /** Register lazily when the optional DSH projection service is present. */
 export declare function registerMnemonSubagentTokenUsageProjection(ctx: HostContextShape): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "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",
@@ -165,6 +165,8 @@
     "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
     "@deepseek-ai/dsh-session": "0.1.1-rc.2",
     "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-projection-legacy": "npm:@deepseek-ai/dsh-session-projection@0.1.0-rc.8",
     "@deepseek-ai/dsh-session-query": "0.1.1-rc.2",
     "@deepseek-ai/dsh-subagent": "0.1.1-rc.2",
     "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.1-rc.2",