dsh-mnemon 0.4.4 → 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.4.md">Read the v0.4.4 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>
 
@@ -44,6 +44,8 @@ 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).
+
 ## Understand the scope in 30 seconds
 
 | Tier | Keep here | How it reaches the Agent | Managed by |
@@ -218,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.4 release notes](./docs/en/releases/v0.4.4.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.4.md">v0.4.4 升级说明</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>
 
@@ -44,6 +44,8 @@ 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)。
+
 ## 30 秒理解能力边界
 
 | 层级 | 适合保存 | 如何进入 Agent 上下文 | 由谁管理 |
@@ -218,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.4 发布说明](./docs/zh-CN/releases/v0.4.4.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/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/package.json

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