dsh-pause-session 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,23 +2,30 @@
 
 All notable changes to this project are documented here.
 
-The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project uses [Semantic Versioning](https://semver.org/).
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project uses [Semantic Versioning](https://semver.org/).
 
-## [0.2.0] - 2026-11-06
+## [0.2.1] - 2026-11-11
 
 ### Changed
 
-- Both controls now use a native DSH Remote namespace and stream. The plugin
-  registers no slash commands, so a status refresh never appends
-  `command/run`/`command/done` records to a Session.
-- Pause, resume, goal, and decision-list actions travel through the same
-  native namespace on Web and Desktop.
+- Adapt to DeepSeek Harness `0.2.2-rc.2`. Subagent children now resume through `ctx.subagents.prompt`, so the runtime owns their activation, composition, and tree membership; the plugin no longer loads them as independent Agents.
+- Release ordering reads `listDescendants` depth and reuses the tree walk, so a tree release no longer reads the catalogs twice.
+- The composition seam resolves a root Session's preset only; a child's composition is restored by the subagent runtime.
+
+### Removed
+
+- The `parentAgent` resume option, `listChildren` catalog reads, and the child-composition branch this plugin used to assemble itself.
+
+## [0.2.0] - 2026-11-08
+
+### Changed
+
+- Both controls now use a native DSH Remote namespace and stream. The plugin registers no slash commands, so a status refresh never appends `command/run`/`command/done` records to a Session.
+- Pause, resume, goal, and decision-list actions travel through the same native namespace on Web and Desktop.
 
 ### Added
 
-- Global progress names every draining session and its running tools, and the
-  in-progress action is **Cancel this pause**.
+- Global progress names every draining session and its running tools, and the in-progress action is **Cancel this pause**.
 - The Remote namespace is owner-only.
 - The client bundle uses a build-time codec-builder shim instead of bundling the full Zod runtime.
 - One snapshot is shared by every connected Remote observer, and the snapshot projection shares its tree walks.
@@ -27,53 +34,39 @@ and this project uses [Semantic Versioning](https://semver.org/).
 
 ### Fixed
 
-- A park reaches `safe` only when the session-level flush actually ran; an
-  unreadable record and a partially unread tree are reported instead of being
-  counted clean.
-- A restart-adopted park is no longer cancelled by the per-session button; it
-  stays on the decision path.
-- Stream and triage failures render as unavailable instead of stale rows, and
-  triage decisions that the host refuses show the refusal.
+- A park reaches `safe` only when the session-level flush actually ran; an unreadable record and a partially unread tree are reported instead of being counted clean.
+- A restart-adopted park is no longer cancelled by the per-session button; it stays on the decision path.
+- Stream and triage failures render as unavailable instead of stale rows, and triage decisions that the host refuses show the refusal.
 
 ### Removed
 
-- The `/pause`, `/pause-resume`, `/pause-state`, `/pause-goal`, and
-  `/pause-triage*` command surface.
-- The command-era `ReadBurst`/JSON-status-route client machinery and the
-  `@deepseek-ai/dsh-commands` dependency.
+- The `/pause`, `/pause-resume`, `/pause-state`, `/pause-goal`, and `/pause-triage*` command surface.
+- The command-era `ReadBurst`/JSON-status-route client machinery and the `@deepseek-ai/dsh-commands` dependency.
 
 ## [0.1.0] - 2026-11-02
 
 ### Added
 
-- Pause every running DSH session and its subagents at the next model-request
-  boundary, after the tool already running finishes.
-- Session-header and whole-app controls, with `Pausing`, `Paused`, and
-  `All Paused` states.
+- Pause every running DSH session and its subagents at the next model-request boundary, after the tool already running finishes.
+- Session-header and whole-app controls, with `Pausing`, `Paused`, and `All Paused` states.
 - Durable pause registry that re-holds parked sessions after a DSH restart.
-- Clean resume that restores the recorded Agent preset composition, including
-  subagent delegation context and tool restrictions.
+- Clean resume that restores the recorded Agent preset composition, including subagent delegation context and tool restrictions.
 - Goal re-arm toggle for cleanly paused sessions.
-- Decision list for sessions that did not pause cleanly, with continue,
-  continue-with-note, review-only, leave, and goal actions.
-- Localized English and Chinese UI copy, plugin-manager metadata, and a
-  user-facing README screenshot.
-- `/pause`, `/pause-resume`, `/pause-all`, `/pause-state`, `/pause-goal`, and
-  `/pause-triage*` command surface.
+- Decision list for sessions that did not pause cleanly, with continue, continue-with-note, review-only, leave, and goal actions.
+- Localized English and Chinese UI copy, plugin-manager metadata, and a user-facing README screenshot.
+- `/pause`, `/pause-resume`, `/pause-all`, `/pause-state`, `/pause-goal`, and `/pause-triage*` command surface.
 
 ### Changed
 
-- The package is published as `dsh-pause-session`; the slash-command namespace
-  remains `/pause*`.
-- One-shot and external subagent routes are reported as unresumable and are not
-  registered as local pause records.
+- The package is published as `dsh-pause-session`; the slash-command namespace remains `/pause*`.
+- One-shot and external subagent routes are reported as unresumable and are not registered as local pause records.
 
 ### Known Limitations
 
 - Background jobs and shell tasks outside the agent loop are not stopped.
-- A paused session still appears `running` to parts of DSH's session lifecycle;
-  exit, archive, compaction, and `wait_agent` can behave differently while held.
+- A paused session still appears `running` to parts of DSH's session lifecycle; exit, archive, compaction, and `wait_agent` can behave differently while held.
 - External one-shot subagent routes cannot be cold-resumed.
 
+[0.2.1]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.2.1
 [0.2.0]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.2.0
 [0.1.0]: https://github.com/timho1047/dsh-pause-session/releases/tag/v0.1.0

package/lib/client.js

@@ -346,9 +346,9 @@ window.__ModuleLoader__.load({
 				unclean: 0
 			};
 			if (reading.kind === "unavailable") return {
-				visible: false,
+				visible: true,
 				enabled: false,
-				ariaKey: "unavailable.aria",
+				ariaKey: "all.unavailable.aria",
 				action: "none",
 				detail: "",
 				caveats: [],
@@ -651,47 +651,60 @@ window.__ModuleLoader__.load({
 				sessions: Object.fromEntries(Object.entries(wire.sessions).map(([id, status]) => [id, status]))
 			};
 		}
+		/** First retry delay after the stream drops, in milliseconds. */
+		const RECONNECT_BASE_MS = 300;
+		/** Ceiling for the reconnect backoff, in milliseconds. */
+		const RECONNECT_MAX_MS = 5e3;
 		/**
 		* Open the native status stream and expose its latest snapshot to both controls.
+		*
+		* The stream owns no retry of its own: a carrier can drop it on a mux reconnect,
+		* a host reload, or a network blip, and the controls must not stay unavailable
+		* until the page is refreshed. This source reconnects with a bounded backoff and
+		* republishes the new snapshot; while it is disconnected the last value is
+		* discarded, so readers see "unavailable" rather than a stale claim.
 		* @param remote - the generated Remote namespace.
 		* @param lifetime - client lifetime; aborting it releases the stream.
 		* @returns the cached source and its change subscription.
 		*/
 		function openRemoteSource(remote, lifetime) {
 			let latest;
-			let failed = false;
-			let first;
+			let attempt = 0;
+			let timer;
+			/** Readers waiting for the first snapshot of any attempt. */
+			const waiters = /* @__PURE__ */ new Set();
 			const listeners = /* @__PURE__ */ new Set();
 			const snapshotListeners = /* @__PURE__ */ new Set();
 			const notify = () => {
+				for (const wake of [...waiters]) wake();
+				waiters.clear();
 				for (const listener of [...listeners]) listener();
-				for (const listener of [...snapshotListeners]) listener(failed ? void 0 : latest);
+				for (const listener of [...snapshotListeners]) listener(latest);
 			};
-			new Promise((resolve) => {
-				first = resolve;
-			});
-			(async () => {
+			const schedule = () => {
+				if (lifetime.aborted || timer !== void 0) return;
+				const delay = Math.min(RECONNECT_BASE_MS * 2 ** attempt, RECONNECT_MAX_MS);
+				attempt += 1;
+				timer = setTimeout(() => {
+					timer = void 0;
+					pump();
+				}, delay);
+			};
+			const pump = async () => {
+				if (lifetime.aborted) return;
 				try {
 					for await (const snapshot of remote.observe(lifetime)) {
+						attempt = 0;
 						latest = snapshotOf(snapshot);
-						first?.();
-						first = void 0;
 						notify();
 					}
-				} catch {
-					failed = true;
-					latest = void 0;
-					notify();
-				} finally {
-					if (!lifetime.aborted) {
-						failed = true;
-						latest = void 0;
-					}
-					first?.();
-					first = void 0;
-					notify();
-				}
-			})();
+				} catch {}
+				if (lifetime.aborted) return;
+				latest = void 0;
+				notify();
+				schedule();
+			};
+			pump();
 			return {
 				onChange: (listener) => {
 					listeners.add(listener);
@@ -706,20 +719,17 @@ window.__ModuleLoader__.load({
 					};
 				},
 				read: async (signal) => {
-					if (latest === void 0 && !failed) await new Promise((resolve) => {
-						const done = () => {
-							signal?.removeEventListener("abort", done);
+					if (latest === void 0 && !lifetime.aborted) await new Promise((resolve) => {
+						const wake = () => {
+							waiters.delete(wake);
+							signal?.removeEventListener("abort", wake);
 							resolve();
 						};
-						first = () => {
-							first = void 0;
-							done();
-						};
-						signal?.addEventListener("abort", done, { once: true });
-						if (latest !== void 0 || failed) done();
+						waiters.add(wake);
+						signal?.addEventListener("abort", wake, { once: true });
 					});
 					signal?.throwIfAborted();
-					return failed ? void 0 : latest;
+					return latest;
 				}
 			};
 		}
@@ -1630,7 +1640,7 @@ window.__ModuleLoader__.load({
 			const reading = props.usePauseGlobal((state) => state.global);
 			const triage = props.usePauseGlobal((state) => state.triage);
 			const open = props.usePauseGlobal((state) => state.panelOpen);
-			props.usePauseGlobal((state) => state.error);
+			const error = props.usePauseGlobal((state) => state.error);
 			const sessions = props.usePauseGlobal((state) => state.sessions);
 			const address = useSessions(addressingSession);
 			const view = globalPauseView(reading, sessions);
@@ -1643,7 +1653,8 @@ window.__ModuleLoader__.load({
 				address,
 				visible
 			]);
-			if (!visible || !view.visible || address === void 0) return null;
+			if (!visible || !view.visible) return null;
+			const actionable = view.enabled && address !== void 0;
 			const tip = view.caveats.map((caveat) => caveat.names.length === 0 ? t(caveat.key) : `${t(caveat.key)} (${caveat.names.join(", ")})`).join("\n");
 			return (0, react_jsx_runtime.jsxs)("span", {
 				className: button_module_css_default.dspPill,
@@ -1652,37 +1663,49 @@ window.__ModuleLoader__.load({
 						className: button_module_css_default.dspPillPanel,
 						role: "dialog",
 						"aria-label": t("triage.title"),
-						children: [(0, react_jsx_runtime.jsxs)("div", {
-							className: button_module_css_default.dspPillPanelHead,
-							children: [(0, react_jsx_runtime.jsx)("span", {
-								className: button_module_css_default.dspPillText,
-								children: t("triage.title")
-							}), (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: button_module_css_default.dspPillAction,
-								"aria-label": t("triage.refresh.aria"),
-								onClick: () => {
-									setPanel(true);
-								},
-								children: t("triage.refresh.aria")
-							})]
-						}), !list.visible ? (0, react_jsx_runtime.jsx)("p", {
-							className: button_module_css_default.dspPillPanelNote,
-							children: t("triage.reading")
-						}) : list.unavailable ? (0, react_jsx_runtime.jsx)("p", {
-							className: button_module_css_default.dspPillPanelNote,
-							children: t("triage.unavailable")
-						}) : list.rows.length === 0 ? (0, react_jsx_runtime.jsx)("p", {
-							className: button_module_css_default.dspPillPanelNote,
-							children: t("triage.empty")
-						}) : (0, react_jsx_runtime.jsx)("ul", {
-							className: button_module_css_default.dspPillRows,
-							children: list.rows.map((row) => (0, react_jsx_runtime.jsx)(TriageSessionRow, {
-								row,
-								decide,
-								t
-							}, row.sessionId))
-						})]
+						children: [
+							(0, react_jsx_runtime.jsxs)("div", {
+								className: button_module_css_default.dspPillPanelHead,
+								children: [(0, react_jsx_runtime.jsx)("span", {
+									className: button_module_css_default.dspPillText,
+									children: t("triage.title")
+								}), (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: button_module_css_default.dspPillAction,
+									"aria-label": t("triage.refresh.aria"),
+									onClick: () => {
+										setPanel(true);
+									},
+									children: t("triage.refresh.aria")
+								})]
+							}),
+							error === void 0 ? null : (0, react_jsx_runtime.jsx)("p", {
+								className: button_module_css_default.dspPillError,
+								role: "status",
+								children: error
+							}),
+							view.running === void 0 ? null : (0, react_jsx_runtime.jsx)("p", {
+								className: button_module_css_default.dspPillPanelNote,
+								children: view.running
+							}),
+							!list.visible ? (0, react_jsx_runtime.jsx)("p", {
+								className: button_module_css_default.dspPillPanelNote,
+								children: t("triage.reading")
+							}) : list.unavailable ? (0, react_jsx_runtime.jsx)("p", {
+								className: button_module_css_default.dspPillPanelNote,
+								children: t("triage.unavailable")
+							}) : list.rows.length === 0 ? (0, react_jsx_runtime.jsx)("p", {
+								className: button_module_css_default.dspPillPanelNote,
+								children: t("triage.empty")
+							}) : (0, react_jsx_runtime.jsx)("ul", {
+								className: button_module_css_default.dspPillRows,
+								children: list.rows.map((row) => (0, react_jsx_runtime.jsx)(TriageSessionRow, {
+									row,
+									decide,
+									t
+								}, row.sessionId))
+							})
+						]
 					}),
 					view.unclean === 0 ? null : (0, react_jsx_runtime.jsxs)("button", {
 						type: "button",
@@ -1703,10 +1726,10 @@ window.__ModuleLoader__.load({
 						className: view.labelKey === void 0 && view.detail.length === 0 ? `${button_module_css_default.dspPillBtn} ${button_module_css_default.dspPillIcon}` : button_module_css_default.dspPillBtn,
 						"aria-label": t(view.ariaKey),
 						"aria-pressed": view.action === "resume-all" || view.action === "cancel-all",
-						disabled: !view.enabled,
+						disabled: !actionable,
 						...tip.length === 0 ? {} : { title: tip },
 						onClick: () => {
-							toggle(address);
+							if (address !== void 0) toggle(address);
 						},
 						children: [
 							view.action === "resume-all" || view.action === "cancel-all" ? (0, react_jsx_runtime.jsx)(ResumeIcon, {}) : (0, react_jsx_runtime.jsx)(PauseIcon, {}),
@@ -1759,6 +1782,7 @@ window.__ModuleLoader__.load({
 			"all.unclean.aria": "有会话未暂停，不能在这里恢复；打开清单逐行处理",
 			"all.safe": "已暂停",
 			"all.checking.aria": "正在读取暂停状态",
+			"all.unavailable.aria": "暂停状态暂不可用，正在重新连接",
 			"all.caveat.jobs": "后台任务仍在运行",
 			"all.caveat.unresumable": "含无法恢复的子代理",
 			"all.caveat.stalled": "未暂停，需要你决定",
@@ -1821,6 +1845,7 @@ window.__ModuleLoader__.load({
 			"all.unclean.aria": "Some sessions are not paused and cannot be resumed here; open the list to decide",
 			"all.safe": "Paused",
 			"all.checking.aria": "Reading pause state",
+			"all.unavailable.aria": "Pause state unavailable; reconnecting",
 			"all.caveat.jobs": "background jobs are still running",
 			"all.caveat.unresumable": "contains a subagent that cannot be resumed",
 			"all.caveat.stalled": "did not pause; needs your decision",