dsh-mnemon 0.4.3 → 0.4.5

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.5.md">Read the v0.4.5 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,10 @@ 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).
+
+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).
+
 ## Understand the scope in 30 seconds
 
 | Tier | Keep here | How it reaches the Agent | Managed by |
@@ -216,7 +220,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.5 release notes](./docs/en/releases/v0.4.5.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.5.md">v0.4.5 升级说明</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,10 @@ 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)。
+
+v0.4.5 在已安装 Better Sidebar 时向其注册记忆系统，同时保留 DSH 普通 Sidebar 入口，并兼容两种客户端加载顺序。详见[补丁发布说明](./docs/zh-CN/releases/v0.4.5.md)。
+
 ## 30 秒理解能力边界
 
 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 |
@@ -216,7 +220,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.5 发布说明](./docs/zh-CN/releases/v0.4.5.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

@@ -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/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/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.5",
   "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",