@michengai/dsh-archive-manager 0.1.17 → 0.1.18

package/CHANGELOG.md

@@ -4,6 +4,14 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 0.1.18 — 2026-08-28
+
+- Added client compatibility for the split store layout in DSH `v0.1.2-alpha.1` while preserving the legacy runtime fallback used by `v0.1.1-rc.2`.
+- Restored the alpha Workspace navigation service required by the sidebar, conversation view, and directory picker when Archive Manager replaces the stock Workspace UI.
+- Bound observable stores at the Settings boundary and kept subagent-lineage indexing local, preventing archived-chat startup and rendering failures on the alpha release.
+
+Published package: [`@michengai/dsh-archive-manager@0.1.18`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.18).
+
 ## 0.1.17 — 2026-08-28
 
 - Enabled npm Trusted Publishing through the repository's GitHub Actions release workflow.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,14 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 0.1.18 — 2026-08-28
+
+- 兼容 DSH `v0.1.2-alpha.1` 拆分后的客户端 Store 布局，同时保留 `v0.1.1-rc.2` 使用的旧版 Runtime 回退路径。
+- 在归档管理器替换官方工作区 UI 后补齐 alpha 版侧栏、会话视图和目录选择器依赖的工作区导航服务。
+- 在设置页注入边界绑定可观察 Store，并将子代理谱系索引保留在插件内部，避免 alpha 版启动和归档页渲染失败。
+
+发布包：[`@michengai/dsh-archive-manager@0.1.18`](https://www.npmjs.com/package/@michengai/dsh-archive-manager/v/0.1.18)。
+
 ## 0.1.17 — 2026-08-28
 
 - 启用仓库 GitHub Actions 发布工作流的 npm Trusted Publishing。

package/lib/client.js

@@ -4,7 +4,16 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		let _deepseek_ai_dsh_client_store;
+		let hasSplitClientStore = true;
+		try {
+			_deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
+		} catch {
+			// DSH <= 0.1.1 owns the store engine in client-runtime; 0.1.2+
+			// seeds the split client-store package directly into the module table.
+			hasSplitClientStore = false;
+			_deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-runtime/client");
+		}
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
 		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
@@ -187,6 +196,38 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		//#endregion
+		//#region lib/types/client/subagent-lineage.js
+		/**
+		* Index uninterrupted subagent descendants under each ancestor.
+		* DSH 0.1.2 made this a UI-package-private projection, so the archive
+		* manager keeps the small pure helper locally instead of importing the
+		* removed client-runtime package.
+		* @param summaries - Session summaries keyed by id.
+		* @returns descendant totals keyed by possible parent id.
+		*/
+		function indexSubagentDescendants(summaries) {
+			const indexed = /* @__PURE__ */ new Map();
+			for (const descendant of Object.values(summaries)) {
+				if (descendant.origin !== "subagent") continue;
+				const seen = /* @__PURE__ */ new Set();
+				let current = descendant;
+				while (current?.origin === "subagent" && current.parentId !== void 0 && !seen.has(current.id)) {
+					seen.add(current.id);
+					const aggregate = indexed.get(current.parentId);
+					if (aggregate === void 0) indexed.set(current.parentId, {
+						count: 1,
+						runningCount: descendant.running ? 1 : 0
+					});
+					else {
+						aggregate.count += 1;
+						if (descendant.running) aggregate.runningCount += 1;
+					}
+					current = summaries[current.parentId];
+				}
+			}
+			return indexed;
+		}
+		//#endregion
 		//#region lib/types/client/stores.js
 		/**
 		* The workspace browser's viewing store: the session-list grouping mode,
@@ -202,7 +243,7 @@ window.__ModuleLoader__.load({
 		* @returns the store handle (spec + type + identity + factory in one).
 		*/
 		function createWorkspaceViewStore() {
-			return (0, _deepseek_ai_dsh_client_runtime_client.defineStore)({
+			return (0, _deepseek_ai_dsh_client_store.defineStore)({
 				init: () => ({
 					groupBy: "workspace",
 					orderBy: "updated",
@@ -402,7 +443,7 @@ window.__ModuleLoader__.load({
 		function deriveGroups(list, workspaces, archivedSessionIds, view) {
 			const archived = new Set(archivedSessionIds);
 			const expandedGroups = new Set(view.expandedGroups);
-			const descendants = (0, _deepseek_ai_dsh_client_runtime_client.indexSubagentDescendants)(list.byId);
+			const descendants = indexSubagentDescendants(list.byId);
 			const currentGroup = list.current === void 0 ? void 0 : workspaces.find((w) => w.sessionIds.includes(list.current))?.workspaceId ?? "";
 			const groups = [];
 			for (const g of groupByWorkspace(list, workspaces, archived, view.ungroupedOrder, view.showArchived)) {
@@ -435,7 +476,7 @@ window.__ModuleLoader__.load({
 		*/
 		function deriveFlat(list, archivedSessionIds, showArchived) {
 			const archived = new Set(archivedSessionIds);
-			const descendants = (0, _deepseek_ai_dsh_client_runtime_client.indexSubagentDescendants)(list.byId);
+			const descendants = indexSubagentDescendants(list.byId);
 			const rows = [];
 			for (const id of list.ids) {
 				const s = list.byId[id];
@@ -466,7 +507,7 @@ window.__ModuleLoader__.load({
 				hasMore: false
 			};
 			const archived = new Set(archivedSessionIds);
-			const descendants = (0, _deepseek_ai_dsh_client_runtime_client.indexSubagentDescendants)(list.byId);
+			const descendants = indexSubagentDescendants(list.byId);
 			const workspaceBySession = /* @__PURE__ */ new Map();
 			for (const workspace of workspaces) for (const sessionId of workspace.sessionIds) if (!workspaceBySession.has(sessionId)) workspaceBySession.set(sessionId, workspace.title);
 			const labelOf = (summary) => workspaceBySession.get(summary.id) ?? workspaceLabel(summary.cwd);
@@ -3242,6 +3283,158 @@ window.__ModuleLoader__.load({
 			"remote",
 			"typert"
 		];
+		/** Preserve the receiver required by alpha-era observable stores. */
+		function bindObservable(source) {
+			return {
+				getSnapshot: source.getSnapshot.bind(source),
+				subscribe: source.subscribe.bind(source)
+			};
+		}
+		class DirectoryBrowseError extends Error {
+			constructor(rpcError) {
+				super(`directory browse failed: ${rpcError.code}: ${rpcError.message}`);
+				this.name = "DirectoryBrowseError";
+				this.rpcError = rpcError;
+			}
+		}
+		/**
+		* Provide the Workspace navigation capability introduced by DSH 0.1.2.
+		* The archive manager replaces the stock ui-workspace row, so it must also
+		* preserve the service that alpha-era sidebar/conversation plugins wait for.
+		* Older hosts do not consume this service, making the provider harmless there.
+		* @param ctx - client root context.
+		* @returns disposer for the compatibility service, or a no-op when supplied.
+		*/
+		function provideUiWorkspace(ctx) {
+			if (ctx.get("uiWorkspace") !== void 0) return () => {};
+			const sessions = ctx.sessions;
+			const workspaces = ctx.workspaces;
+			const connecting = new Map();
+			const recentWorkspace = () => {
+				const workspaceState = workspaces.list.getSnapshot();
+				const sessionState = sessions.list.getSnapshot();
+				let selected;
+				let selectedTime = Number.NEGATIVE_INFINITY;
+				for (const workspace of workspaceState.items ?? []) {
+					let latest = Number.NEGATIVE_INFINITY;
+					for (const sessionId of workspace.sessionIds) {
+						const session = sessionState.byId[sessionId];
+						if (session !== void 0) latest = Math.max(latest, session.updatedAt);
+					}
+					if (latest === Number.NEGATIVE_INFINITY) latest = Date.parse(workspace.createdAt);
+					if (selected === void 0 || latest > selectedTime) {
+						selected = workspace.workspaceId;
+						selectedTime = latest;
+					}
+				}
+				return selected;
+			};
+			const directoryPicker = () => ctx.get("remote.directoryPicker") ?? ctx.get("remote")?.directoryPicker;
+			const service = {
+				connectWorkspace(workspaceId) {
+					const workspaceState = workspaces.list.getSnapshot();
+					const workspace = (workspaceState.items ?? []).find((item) => item.workspaceId === workspaceId);
+					if (workspace === void 0) return Promise.reject(new Error(`uiWorkspace.connectWorkspace: unknown workspace ${workspaceId}`));
+					const inflight = connecting.get(workspaceId);
+					if (inflight !== void 0) return inflight;
+					const sessionState = sessions.list.getSnapshot();
+					const archived = new Set(workspaceState.archivedSessionIds ?? []);
+					for (const id of sessionState.ids) {
+						const summary = sessionState.byId[id];
+						if (summary !== void 0 && summary.blank && summary.cwd === workspace.path && workspace.sessionIds.includes(summary.id) && !archived.has(summary.id)) return Promise.resolve(summary.id);
+					}
+					const attempt = sessions.create({ workspaceId }).finally(() => {
+						connecting.delete(workspaceId);
+					});
+					connecting.set(workspaceId, attempt);
+					return attempt;
+				},
+				startSession(workspaceId) {
+					const workspaceState = workspaces.list.getSnapshot();
+					const sessionState = sessions.list.getSnapshot();
+					const currentWorkspaceId = sessionState.current === void 0 ? void 0 : (workspaceState.items ?? []).find((item) => item.sessionIds.includes(sessionState.current))?.workspaceId;
+					const recent = workspaceState.phase === "ready" && sessionState.phase === "ready" ? recentWorkspace() : void 0;
+					const target = workspaceId ?? currentWorkspaceId ?? recent;
+					if (target === void 0) {
+						sessions.clear();
+						return;
+					}
+					void service.connectWorkspace(target).then((sessionId) => {
+						sessions.open(sessionId);
+					}, (reason) => {
+						console.warn("new session failed:", reason);
+					});
+				},
+				archiveSession(sessionId) {
+					return workspaces.archiveSession(sessionId);
+				},
+				async pickDirectory() {
+					const picker = directoryPicker();
+					if (picker === void 0) throw new Error("directory picker is unavailable");
+					const result = await picker.pick();
+					if (!result.ok) throw new Error(`directory picker failed: ${result.error.message}`);
+					return result.value;
+				},
+				async listDirectory(path, signal) {
+					const picker = directoryPicker();
+					if (picker === void 0) throw new Error("directory picker is unavailable");
+					const result = await picker.list(path, signal);
+					if (!result.ok) throw new DirectoryBrowseError(result.error);
+					return result.value;
+				},
+				async createDirectory(path, name) {
+					const picker = directoryPicker();
+					if (picker === void 0) throw new Error("directory picker is unavailable");
+					const result = await picker.createDirectory(path, name);
+					if (!result.ok) throw new DirectoryBrowseError(result.error);
+					return result.value;
+				}
+			};
+			const dispose = ctx.provide("uiWorkspace", service);
+			ctx.slots.provideRoot?.({ hooks: { workspaces: workspaces.list } });
+			ctx.effect(() => {
+				let initial = "waiting";
+				let disposed = false;
+				const reconcile = () => {
+					if (disposed) return;
+					const workspaceState = workspaces.list.getSnapshot();
+					const sessionState = sessions.list.getSnapshot();
+					if (sessionState.current !== void 0 && (workspaceState.archivedSessionIds ?? []).includes(sessionState.current)) {
+						sessions.clear();
+						return;
+					}
+					if (initial !== "waiting" || workspaceState.phase !== "ready" || sessionState.phase !== "ready") return;
+					if (sessionState.current !== void 0) {
+						initial = "done";
+						return;
+					}
+					const target = recentWorkspace();
+					if (target === void 0) {
+						initial = "done";
+						return;
+					}
+					initial = "connecting";
+					void service.connectWorkspace(target).then((sessionId) => {
+						if (disposed) return;
+						if (sessions.list.getSnapshot().current === void 0) sessions.open(sessionId);
+						initial = "done";
+					}, (reason) => {
+						if (disposed) return;
+						initial = "waiting";
+						console.warn("initial workspace selection failed:", reason);
+					});
+				};
+				const disposeWorkspaces = workspaces.list.subscribe(reconcile);
+				const disposeSessions = sessions.list.subscribe(reconcile);
+				reconcile();
+				return () => {
+					disposed = true;
+					disposeSessions();
+					disposeWorkspaces();
+				};
+			}, "dsh-archive-manager: uiWorkspace navigation policy");
+			return dispose;
+		}
 		/**
 		* Plugin body: mount the archive-manager Remote contribution, then
 		* register the workspace browser. `$mount` must complete before the
@@ -3255,8 +3448,10 @@ window.__ModuleLoader__.load({
 			const remote = ctx.get("remote");
 			let disposeRemote = () => {};
 			if (remote !== void 0) disposeRemote = await remote.$mount(ARCHIVE_MANAGER_REMOTE);
+			const disposeUiWorkspace = hasSplitClientStore ? provideUiWorkspace(ctx) : () => {};
 			applyWorkspaceBrowser(ctx);
 			return async () => {
+				disposeUiWorkspace();
 				await disposeRemote();
 			};
 		}
@@ -3271,6 +3466,7 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "dsh-archive-manager: dictionaries");
+			const uiWorkspace = ctx.get("uiWorkspace");
 			const searchSessions = async (query, signal) => {
 				const result = await ctx.sessions.search(query, signal);
 				if (!result.ok) throw new Error(result.error.message);
@@ -3317,7 +3513,8 @@ window.__ModuleLoader__.load({
 			};
 			const browserInjected = () => ({
 				startSession: (workspaceId) => {
-					ctx.workspaces.startSession(workspaceId);
+					if (uiWorkspace !== void 0) uiWorkspace.startSession(workspaceId);
+					else ctx.workspaces.startSession(workspaceId);
 				},
 				open: (sessionId) => {
 					ctx.sessions.open(sessionId);
@@ -3387,8 +3584,8 @@ window.__ModuleLoader__.load({
 				icon: "archive",
 				locale: NS,
 				inject: () => ({
-					sessionStore: ctx.sessions.list,
-					workspaceStore: ctx.workspaces.list,
+					sessionStore: bindObservable(ctx.sessions.list),
+					workspaceStore: bindObservable(ctx.workspaces.list),
 					unarchiveSession,
 					deleteSession,
 					unarchiveSessions,
@@ -3403,6 +3600,7 @@ window.__ModuleLoader__.load({
 		exports.__test = {
 			displayTitle,
 			sessionVisible,
+			indexSubagentDescendants,
 			isUnknownSessionError,
 			deriveGroups,
 			deriveFlat,
@@ -3412,6 +3610,9 @@ window.__ModuleLoader__.load({
 			deriveArchivedBatchIds,
 			archivedDeleteFeedback,
 			createWorkspaceViewStore,
+			bindObservable,
+			hasSplitClientStore,
+			provideUiWorkspace,
 			groupByWorkspace,
 			byRecency,
 			ARCHIVE_MANAGER_REMOTE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-archive-manager",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "NPM-installable DSH Web plugin for managing archived sessions.",
   "type": "module",
   "packageManager": "pnpm@11.21.0",
@@ -47,6 +47,11 @@
     "@deepseek-ai/dsh-typert-registry": ">=0.1.0-rc.5 <0.2.0",
     "@deepseek-ai/dsh-workspace": ">=0.1.0-rc.5 <0.2.0"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "@deepseek-ai/dsh-api-gateway": "0.1.0-rc.6",
@@ -69,7 +74,6 @@
     "client": {
       "inject": [
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-sidebar",
         "@deepseek-ai/dsh-typert-registry",