dsh-mnemon 0.4.5 → 0.4.7

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.7.md">Read the v0.4.7 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,10 @@ 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).
+
+v0.4.7 promotes the published DSH 0.1.2-rc.1 release to the stable registry baseline, keeps source verification against its alpha.5 predecessor, and retains a real WebUI regression on the previous 0.1.1-rc.2 line. See the [patch release notes](./docs/en/releases/v0.4.7.md).
+
 ## Understand the scope in 30 seconds
 
 | Tier | Keep here | How it reaches the Agent | Managed by |
@@ -120,10 +124,10 @@ 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 is verified against stable DSH 0.1.2-rc.1, whose complete profiles require Node.js `^22.19.0 || >=24.0.0`. The immediately preceding DSH 0.1.2-alpha.5 remains covered from source, and the previous 0.1.1-rc.2 registry line remains a backward-regression 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-compatibility).
 
 ```sh
-npm install -g @deepseek-ai/dsh@0.1.1-rc.2
+npm install -g @deepseek-ai/dsh@0.1.2-rc.1
 dsh --version
 ```
 
@@ -132,6 +136,8 @@ dsh plugin --profile web add dsh-mnemon
 dsh --profile web
 ```
 
+When the Web profile is published under a cloud hostname, stable DSH 0.1.2-rc.1 needs an HTTPS reverse proxy or access gateway, an explicit trusted authority, and the one-time launch URL printed at Host startup. Follow the [cloud-hosted WebUI procedure](./docs/en/operations.md#cloud-hosted-webui); do not expose the loopback service directly.
+
 DSH profiles have independent plugin rosters. Install the same package separately for one-shot Headless tasks:
 
 ```sh
@@ -220,7 +226,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.7 release notes](./docs/en/releases/v0.4.7.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.7.md">v0.4.7 升级说明</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,10 @@ 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)。
+
+v0.4.7 将已发布的 DSH 0.1.2-rc.1 提升为稳定的 registry 基线，继续对其 alpha.5 前序版本执行源码验证，并保留上一条 0.1.1-rc.2 版本线的真实 WebUI 回归。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.7.md)。
+
 ## 30 秒理解能力边界
 
 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 |
@@ -120,10 +124,10 @@ 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.2-rc.1 验证；其完整 profile 需要 Node.js `^22.19.0 || >=24.0.0`。它的直接前序版本 DSH 0.1.2-alpha.5 继续通过源码覆盖，上一条 0.1.1-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
+npm install -g @deepseek-ai/dsh@0.1.2-rc.1
 dsh --version
 ```
 
@@ -132,6 +136,8 @@ dsh plugin --profile web add dsh-mnemon
 dsh --profile web
 ```
 
+将 Web profile 发布到云端域名时，稳定版 DSH 0.1.2-rc.1 需要 HTTPS 反向代理或访问网关、显式可信 authority，以及 Host 启动时输出的一次性启动 URL。请按[云端 WebUI 操作步骤](./docs/zh-CN/operations.md#cloud-hosted-webui)配置，不要把回环服务直接暴露到公网。
+
 DSH 各 profile 的插件清单彼此独立。一次性 Headless 任务需要单独安装：
 
 ```sh
@@ -220,7 +226,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.7 发布说明](./docs/zh-CN/releases/v0.4.7.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/client/subagent-token-usage.d.ts

@@ -1,4 +1,4 @@
-import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
 import type { MnemonClientContext, MnemonSessionListState } from './dsh-compat.ts';
 export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
 export interface MnemonTokenUsageProjection {

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.7",
   "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",
@@ -150,28 +150,30 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.1-rc.2",
-    "@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/cordis": "^4.0.2",
+    "@deepseek-ai/dsh": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-agent-loop": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "0.1.2-rc.1",
     "@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",
-    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session-query": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-subagent": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",
     "@types/react": "^18.3.0",