dsh-mnemon 0.4.5 → 0.4.6

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.5.md">Read the v0.4.5 notes</a> ·
+  <a href="./docs/en/releases/v0.4.6.md">Read the v0.4.6 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>
 
@@ -46,6 +46,8 @@ v0.4.4 fixes session history failures on older DSH hosts by supporting both sess
 
 v0.4.5 registers Memory System with an installed Better Sidebar while keeping the normal DSH Sidebar entry and both client activation orders working. See the [patch release notes](./docs/en/releases/v0.4.5.md).
 
+v0.4.6 keeps DSH 0.1.1-rc.2 as the stable baseline while adding capability-detected support for the Session event snapshots used by DSH 0.1.2-alpha.4 and alpha.5. See the [patch release notes](./docs/en/releases/v0.4.6.md).
+
 ## Understand the scope in 30 seconds
 
 | Tier | Keep here | How it reaches the Agent | Managed by |
@@ -120,7 +122,7 @@ Windows users can install the official v0.2.3-or-newer release ZIP. The expected
 
 ### 2. Install DSH and the plugin
 
-The registry installation remains verified against DSH 0.1.1-rc.2, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`; Node 20 lacks host primitives used by rc.2. Source compatibility is also verified against the source-only DSH 0.1.2-alpha.1 preview; it is not an npm installation target. The dsh-mnemon package itself retains Node.js 20 compatibility for older compatible DSH hosts. Use the exact published version below for a reproducible installation; plugin authors can follow the [alpha source workflow](./docs/en/development.md#dsh-012-alpha1-source-verification).
+The registry installation remains verified against stable DSH 0.1.1-rc.2, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`; Node 20 lacks host primitives used by rc.2. Source compatibility is also verified against the latest DSH 0.1.2-alpha.5 preview while rc.2 remains the recommended registry target. The dsh-mnemon package itself retains Node.js 20 compatibility for older compatible DSH hosts. Use the exact published version below for a reproducible installation; plugin authors can follow the [alpha source workflow](./docs/en/development.md#dsh-012-alpha5-source-verification).
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.1-rc.2
@@ -220,7 +222,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.5 release notes](./docs/en/releases/v0.4.5.md) |
+| Review the release | [v0.4.6 release notes](./docs/en/releases/v0.4.6.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.5.md">v0.4.5 升级说明</a> ·
+  <a href="./docs/zh-CN/releases/v0.4.6.md">v0.4.6 升级说明</a> ·
   <a href="https://github.com/omdsh-dev/dsh-mnemon/blob/e6ca446e45bdd17991f3c7c98560456de465282b/docs/assets/media/dsh-mnemon-memory-system-demo.mp4">观看宽屏实机演示</a>
 </p>
 
@@ -46,6 +46,8 @@ v0.4.4 同时支持新旧 DSH 会话投影接口，修复旧版宿主读取会
 
 v0.4.5 在已安装 Better Sidebar 时向其注册记忆系统，同时保留 DSH 普通 Sidebar 入口，并兼容两种客户端加载顺序。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.5.md)。
 
+v0.4.6 继续以 DSH 0.1.1-rc.2 作为稳定基线，并通过能力检测兼容 DSH 0.1.2-alpha.4 与 alpha.5 的 Session 事件快照接口。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.6.md)。
+
 ## 30 秒理解能力边界
 
 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 |
@@ -120,7 +122,7 @@ Windows 推荐安装 v0.2.3 或更高版本的官方 ZIP；标准安装目录与
 
 ### 2. 安装 DSH 与插件
 
-Registry 安装仍以 DSH 0.1.1-rc.2 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`，Node 20 缺少 rc.2 使用的宿主原语。源码兼容性也已针对仅提供源码的 DSH 0.1.2-alpha.1 预览版验证；它不是 npm 安装目标。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 支持。下面显式指定已发布版本以保证可复现安装；插件作者可参照 [alpha 源码验证流程](./docs/zh-CN/development.md#dsh-012-alpha1-源码验证)。
+Registry 安装仍以稳定的 DSH 0.1.1-rc.2 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`，Node 20 缺少 rc.2 使用的宿主原语。源码兼容性也已针对最新的 DSH 0.1.2-alpha.5 预览版验证，rc.2 仍是推荐的 registry 安装目标。dsh-mnemon 包本身仍为较旧且兼容的 DSH Host 保留 Node.js 20 支持。下面显式指定已发布版本以保证可复现安装；插件作者可参照 [alpha 源码验证流程](./docs/zh-CN/development.md#dsh-012-alpha5-源码验证)。
 
 ```sh
 npm install -g @deepseek-ai/dsh@0.1.1-rc.2
@@ -220,7 +222,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.5 发布说明](./docs/zh-CN/releases/v0.4.5.md) |
+| 查看本次升级 | [v0.4.6 发布说明](./docs/zh-CN/releases/v0.4.6.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/index.js

@@ -6085,6 +6085,29 @@ var LiveMnemonRuntime = class {
 	}
 };
 //#endregion
+//#region src/session-events.ts
+function eventArray(value) {
+	return Array.isArray(value) ? value : void 0;
+}
+/**
+* Materialize one immutable event-log snapshot across supported DSH releases.
+* Capability detection keeps alpha and stable rc behavior on one code path.
+*/
+function hostSessionEvents(session) {
+	if (typeof session.snapshotEvents === "function") {
+		const events = eventArray(session.snapshotEvents());
+		if (events !== void 0) return events;
+	}
+	const events = eventArray(session.events);
+	if (events !== void 0) return events;
+	throw new TypeError("Unsupported DSH Session event API: expected snapshotEvents() or events[]");
+}
+/** Read one exact event without materializing the alpha log when possible. */
+function hostSessionEventAt(session, seq) {
+	if (typeof session.eventAt === "function") return session.eventAt(seq);
+	return hostSessionEvents(session)[seq];
+}
+//#endregion
 //#region src/subagent.ts
 function isAgentRuntimeSource$1(value) {
 	return typeof value === "object" && value !== null && "forAgent" in value && typeof value.forAgent === "function";
@@ -6519,7 +6542,7 @@ function subagentFailureDetail(run, result) {
 		const diagnostic = safeFailureDetail(result.diagnostic);
 		if (diagnostic !== "") return diagnostic;
 	}
-	const events = run.localAgent?.session.events ?? [];
+	const events = run.localAgent === void 0 ? [] : hostSessionEvents(run.localAgent.session);
 	for (let index = events.length - 1; index >= 0; index -= 1) {
 		const event = events[index];
 		if (event?.type !== "turn/end") continue;
@@ -7877,7 +7900,7 @@ function agentMemoryScope(agent, graph) {
 /** The durable log, not a parent session id, identifies the executing turn. */
 function openAgentTurn(agent) {
 	let open;
-	for (const event of agent.session.events) {
+	for (const event of hostSessionEvents(agent.session)) {
 		const turn = typeof event.data.turn === "number" ? event.data.turn : void 0;
 		if (event.type === "turn/start" && turn !== void 0) open = turn;
 		else if (event.type === "turn/end" && turn === open) open = void 0;
@@ -8181,7 +8204,7 @@ var MnemonAgentLifecycle = class {
 			startSource: this.startSource,
 			primePending: this.primePending,
 			guidedTurns: this.guidedTurns.size,
-			memoryToolCalls: memoryToolCalls(this.agent.session.events),
+			memoryToolCalls: memoryToolCalls(hostSessionEvents(this.agent.session)),
 			idleReviewPending: this.idleReviewTimer !== void 0,
 			reviewRunning: this.reviewRunning,
 			reviewActivity: this.reviewActivity(),
@@ -8200,11 +8223,11 @@ var MnemonAgentLifecycle = class {
 	}
 	/** Incremental snapshot of settled Mnemon activity in this durable log. */
 	turnMemoryActivities() {
-		return this.memoryActivity.snapshot(this.agent.session.events);
+		return this.memoryActivity.snapshot(hostSessionEvents(this.agent.session));
 	}
 	/** Plain text of one finalized assistant message, from this agent's session log. */
 	assistantMessageText(messageId) {
-		return assistantMessageText(this.agent.session.events, messageId);
+		return assistantMessageText(hostSessionEvents(this.agent.session), messageId);
 	}
 	memoryWake() {
 		const pinned = this.memoryTurn?.current;
@@ -8225,7 +8248,7 @@ var MnemonAgentLifecycle = class {
 	cueAlreadyVisible() {
 		const nodes = this.agent.session.surface?.nodes;
 		if (nodes === void 0) return this.cueInjected;
-		for (const seq of nodes) if (isOwnUserMessageEvent(this.agent.session.events[seq])) return true;
+		for (const seq of nodes) if (isOwnUserMessageEvent(hostSessionEventAt(this.agent.session, seq))) return true;
 		return false;
 	}
 	/**
@@ -8315,14 +8338,14 @@ var MnemonAgentLifecycle = class {
 		if (!this.config.lifecycleEnabled || !this.config.writeEnabled || this.config.writebackMode !== "guided") return;
 		this.cancelIdleReview(true);
 		const activity = this.ensureTurnActivity(turn);
-		const tools = completedToolActivity(this.agent.session.events, turn);
+		const tools = completedToolActivity(hostSessionEvents(this.agent.session), turn);
 		activity.toolCallCount = tools.count;
 		activity.toolNames = tools.names;
 		if (!this.reviewActivity().eligible || !this.reviewAdmitted(turn)) return;
 		this.idleReviewTimer = setTimeout(() => {
 			this.idleReviewTimer = void 0;
 			if (this.agent.status !== "idle") return;
-			if (!this.agent.session.events.some((event) => event.type === "turn/end" && eventTurn(event) === turn) || !this.reviewActivity().eligible || !this.reviewAdmitted(turn)) return;
+			if (!hostSessionEvents(this.agent.session).some((event) => event.type === "turn/end" && eventTurn(event) === turn) || !this.reviewActivity().eligible || !this.reviewAdmitted(turn)) return;
 			this.runIdleReview();
 		}, this.config.idleReviewMs);
 	}
@@ -8394,7 +8417,7 @@ var MnemonAgentLifecycle = class {
 			explicitCandidate ||= activity.explicitCandidate;
 			completedNonMemoryTool ||= activity.toolCallCount > 0 && [...activity.toolNames].some((name) => !name.startsWith("mnemon_"));
 		}
-		const assistantTextLength = this.agent.session.events.filter((event) => {
+		const assistantTextLength = hostSessionEvents(this.agent.session).filter((event) => {
 			const turn = eventTurn(event);
 			return turn !== void 0 && turns.has(turn);
 		}).map(assistantEventTextLength).reduce((total, length) => total + length, 0);

package/lib/types/src/contracts.d.ts

@@ -129,6 +129,34 @@ export interface HostSessionEvent {
     time?: number;
     data: Record<string, unknown>;
 }
+/**
+ * Minimum session log surface shared by the stable DSH rc line and the 0.1.2
+ * alpha line. rc.2 exposes the immutable log through `events`; alpha.4+
+ * replaces that property with range snapshots and indexed reads.
+ */
+export interface HostSession {
+    header?: {
+        origin?: 'subagent';
+        parentSession?: string;
+        delegationDepth?: number;
+        cwd?: string;
+        agentPreset?: string;
+    };
+    /** Stable rc.2 event-log accessor. */
+    events?: readonly HostSessionEvent[];
+    /** DSH 0.1.2-alpha.4+ event-log accessor. */
+    snapshotEvents?(fromSeq?: number, toSeqExclusive?: number): readonly HostSessionEvent[];
+    /** DSH 0.1.2-alpha.4+ indexed event accessor. */
+    eventAt?(seq: number): HostSessionEvent | undefined;
+    /**
+     * Model-visible event sequences, in order. Optional because not every host
+     * publishes a surface projection; when absent, callers fall back to
+     * session-scoped state.
+     */
+    surface?: {
+        readonly nodes: readonly number[];
+    };
+}
 export type HostPreStepDecision = {
     kind: 'reject';
 } | {
@@ -156,24 +184,7 @@ export interface HostAgent {
         model?: string;
         maxTokens?: number;
     };
-    session: {
-        header?: {
-            origin?: 'subagent';
-            parentSession?: string;
-            delegationDepth?: number;
-            cwd?: string;
-            agentPreset?: string;
-        };
-        events: readonly HostSessionEvent[];
-        /**
-         * Model-visible event sequences, in order. Optional because not every host
-         * publishes a surface projection; when absent, callers fall back to
-         * session-scoped state.
-         */
-        surface?: {
-            readonly nodes: readonly number[];
-        };
-    };
+    session: HostSession;
     ctx: HostAgentContext;
     followup(message: HostUserMessage): void;
     steer(message: HostUserMessage): void;

package/lib/types/src/session-events.d.ts

@@ -0,0 +1,8 @@
+import type { HostSession, HostSessionEvent } from './contracts.ts';
+/**
+ * Materialize one immutable event-log snapshot across supported DSH releases.
+ * Capability detection keeps alpha and stable rc behavior on one code path.
+ */
+export declare function hostSessionEvents(session: HostSession): readonly HostSessionEvent[];
+/** Read one exact event without materializing the alpha log when possible. */
+export declare function hostSessionEventAt(session: HostSession, seq: number): HostSessionEvent | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "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",