dsh-mnemon 0.4.4 → 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.4.md">Read the v0.4.4 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>
 
@@ -44,6 +44,10 @@ v0.4.3 aligns the collapsed Memory System icon with neighboring sidebar controls
 
 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).
 
+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 |
@@ -118,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
@@ -218,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.4 release notes](./docs/en/releases/v0.4.4.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.4.md">v0.4.4 升级说明</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>
 
@@ -44,6 +44,10 @@ v0.4.3 让折叠后的记忆系统图标与侧栏相邻控件对齐，并保留
 
 v0.4.4 同时支持新旧 DSH 会话投影接口，修复旧版宿主读取会话历史失败的问题，并保持新版宿主和已有投影检查点兼容。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.4.md)。
 
+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 上下文 | 由谁管理 |
@@ -118,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
@@ -218,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.4 发布说明](./docs/zh-CN/releases/v0.4.4.md) |
+| 查看本次升级 | [v0.4.6 发布说明](./docs/zh-CN/releases/v0.4.6.md) |
 
 完整目录见[文档中心](./docs/zh-CN/README.md)。
 

package/lib/client.js

@@ -11931,14 +11931,16 @@ window.__ModuleLoader__.load({
 		const SSH_ACTIVE_ATTR = "data-dsh-ssh-active";
 		const ACTIVATE_EVENT = "dsh-panel-activate";
 		const SIDEBAR_CONTEXT_SELECTOR = "[data-dsh-taskboard-entry], [data-dsh-ssh-entry], [class*=\"sessionRow\"], [class*=\"projectRow\"], [class*=\"searchResultRow\"], [class*=\"searchResultWorkspace\"], [class*=\"newSession\"]";
-		function MnemonPanel({ ctx, settings, t, onClose }) {
+		/** Shared sidebar-sized view used by both the legacy workspace and Better Sidebar. */
+		function MnemonPanel({ ctx, settings, t, onClose, scope }) {
 			const subscribeLocale = (0, react.useCallback)((listener) => ctx.locale.subscribe(listener), [ctx.locale]);
 			const getLocaleSnapshot = (0, react.useCallback)(() => ctx.locale.getSnapshot(), [ctx.locale]);
 			const locale = (0, react.useSyncExternalStore)(subscribeLocale, getLocaleSnapshot, getLocaleSnapshot);
 			const sessions = (0, react.useSyncExternalStore)((listener) => ctx.sessions.list.subscribe(listener), () => ctx.sessions.list.getSnapshot(), () => ctx.sessions.list.getSnapshot());
 			const workspaces = (0, react.useSyncExternalStore)((listener) => ctx.workspaces.list.subscribe(listener), () => ctx.workspaces.list.getSnapshot(), () => ctx.workspaces.list.getSnapshot());
 			const [selectedWorkspaceId, setSelectedWorkspaceId] = (0, react.useState)();
-			const currentCwd = sessions.current === void 0 ? void 0 : sessions.byId[sessions.current]?.cwd;
+			const sessionId = scope?.sessionId ?? sessions.current;
+			const currentCwd = scope === void 0 ? sessions.current === void 0 ? void 0 : sessions.byId[sessions.current]?.cwd : scope.cwd;
 			const normalizePath = (value) => value.replace(/[\\/]+$/u, "");
 			const effectiveWorkspace = currentCwd === void 0 ? void 0 : workspaces.items.find((workspace) => normalizePath(workspace.path) === normalizePath(currentCwd));
 			const fallbackWorkspace = effectiveWorkspace ?? workspaces.items[0];
@@ -11966,12 +11968,12 @@ window.__ModuleLoader__.load({
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MnemonView, {
 				connection: ctx.connection,
 				settingsScope: settings,
-				...sessions.current === void 0 ? {} : { sessionId: sessions.current },
+				...sessionId === void 0 ? {} : { sessionId },
 				...resolvedSelectedId === void 0 ? {} : { workspaceId: resolvedSelectedId },
 				workspaceSelection: selection,
 				t,
 				locale: locale.active,
-				onClose
+				...onClose === void 0 ? {} : { onClose }
 			});
 		}
 		function conversationColumn() {
@@ -12084,6 +12086,71 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/better-sidebar.tsx
+		/** Stable type id exposed to Better Sidebar and its persisted tab state. */
+		const MNEMON_BETTER_SIDEBAR_TAB_ID = "dsh-mnemon:memory";
+		function MnemonTabIcon({ size }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				"aria-hidden": "true",
+				viewBox: "0 0 16 16",
+				width: size,
+				height: size,
+				fill: "none",
+				stroke: "currentColor",
+				strokeWidth: "1.5",
+				strokeLinecap: "round",
+				strokeLinejoin: "round",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("ellipse", {
+					cx: "8",
+					cy: "3.5",
+					rx: "5",
+					ry: "2"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", { d: "M3 3.5v4c0 1.1 2.2 2 5 2s5-.9 5-2v-4M3 7.5v4c0 1.1 2.2 2 5 2s5-.9 5-2v-4" })]
+			});
+		}
+		/**
+		* Register Mnemon through Better Sidebar's documented optional service.
+		*
+		* The service is deliberately a soft dependency. Watching Cordis service
+		* changes makes installation order and HMR irrelevant while preserving the
+		* standalone Mnemon sidebar on profiles that do not install Better Sidebar.
+		*/
+		function mountBetterSidebarTab(ctx, settings, t) {
+			let current;
+			const reconcile = () => {
+				const service = ctx.get("betterSidebar");
+				if (current?.service === service) return;
+				current?.dispose();
+				current = void 0;
+				if (service === void 0) return;
+				current = {
+					service,
+					dispose: service.registerTab({
+						id: MNEMON_BETTER_SIDEBAR_TAB_ID,
+						title: () => t("tab.label"),
+						icon: (size) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MnemonTabIcon, { size }),
+						order: 55,
+						single: true,
+						component: ({ scope }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MnemonPanel, {
+							ctx,
+							settings,
+							t,
+							scope
+						})
+					})
+				};
+			};
+			reconcile();
+			const unsubscribe = ctx.on("internal/service", (name) => {
+				if (name === "betterSidebar") reconcile();
+			});
+			return () => {
+				unsubscribe();
+				current?.dispose();
+				current = void 0;
+			};
+		}
+		//#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";
@@ -12281,9 +12348,18 @@ window.__ModuleLoader__.load({
 				const mode = snapshot.status === "loading" || snapshot.value?.tabEnabled === false ? void 0 : normalizeDisplayMode(snapshot.value?.displayMode);
 				if (activeMemoryWorkspace?.mode === mode) return;
 				activeMemoryWorkspace?.dispose();
-				activeMemoryWorkspace = mode === void 0 ? void 0 : {
+				if (mode === void 0) {
+					activeMemoryWorkspace = void 0;
+					return;
+				}
+				const disposeView = mode === "builtin" ? mountBuiltinMemoryView(ctx, settings, namespace, translate) : mountMnemonWorkspace(ctx, settings, translate);
+				const disposeBetterSidebar = mode === "sidebar" ? mountBetterSidebarTab(ctx, settings, translate) : () => {};
+				activeMemoryWorkspace = {
 					mode,
-					dispose: mode === "builtin" ? mountBuiltinMemoryView(ctx, settings, namespace, translate) : mountMnemonWorkspace(ctx, settings, translate)
+					dispose: () => {
+						disposeBetterSidebar();
+						disposeView();
+					}
 				};
 			};
 			ctx.effect(() => {

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/better-sidebar.d.ts

@@ -0,0 +1,13 @@
+import type { ClientSettingsScope, Config } from '../shared/contracts.ts';
+import type { MnemonClientContext } from './dsh-compat.ts';
+import type { MnemonTranslate } from './locales.ts';
+/** Stable type id exposed to Better Sidebar and its persisted tab state. */
+export declare const MNEMON_BETTER_SIDEBAR_TAB_ID = "dsh-mnemon:memory";
+/**
+ * Register Mnemon through Better Sidebar's documented optional service.
+ *
+ * The service is deliberately a soft dependency. Watching Cordis service
+ * changes makes installation order and HMR irrelevant while preserving the
+ * standalone Mnemon sidebar on profiles that do not install Better Sidebar.
+ */
+export declare function mountBetterSidebarTab(ctx: MnemonClientContext, settings: ClientSettingsScope<Config>, t: MnemonTranslate): () => void;

package/lib/types/src/client/workspace-mount.d.ts

@@ -2,5 +2,19 @@ import type { ClientSettingsScope, Config } from '../shared/contracts.ts';
 import type { MnemonClientContext } from './dsh-compat.ts';
 import type { MnemonTranslate } from './locales.ts';
 export declare const MNEMON_VIEW_SELECTOR = "[data-dsh-mnemon-view]";
+interface MnemonPanelProps {
+    ctx: MnemonClientContext;
+    settings: ClientSettingsScope<Config>;
+    t: MnemonTranslate;
+    onClose?: () => void;
+    scope?: MnemonWorkspaceScope;
+}
+export interface MnemonWorkspaceScope {
+    sessionId: string;
+    cwd?: string;
+}
+/** Shared sidebar-sized view used by both the legacy workspace and Better Sidebar. */
+export declare function MnemonPanel({ ctx, settings, t, onClose, scope }: MnemonPanelProps): JSX.Element;
 /** Mount the sidebar row and its stateful center-column workspace as one unit. */
 export declare function mountMnemonWorkspace(ctx: MnemonClientContext, settings: ClientSettingsScope<Config>, t: MnemonTranslate): () => void;
+export {};

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.4",
+  "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",