dsh-update-status 0.2.1 → 0.3.1

package/lib/client.js

@@ -53,6 +53,12 @@ window.__ModuleLoader__.load({
 			getStatus: "dsh-update-status.get-status",
 			checkUpdate: "dsh-update-status.check-update"
 		};
+		/** Restart RPC remains on the same authenticated Connection `/api` channel. */
+		const RESTART_ENDPOINTS = {
+			status: "dsh-update-status.restart-status",
+			check: "dsh-update-status.restart-check",
+			request: "dsh-update-status.restart"
+		};
 		//#endregion
 		//#region src/client/i18n.ts
 		const DICTIONARY = {
@@ -177,12 +183,88 @@ window.__ModuleLoader__.load({
 				en: "Clipboard unavailable; the command is selected for long-press or copy."
 			},
 			"panel.commandNote": {
-				zh: "仅复制，不会执行。请在运行 DSH 的那台电脑的终端执行；完成后由你自行重启 DSH。",
-				en: "Copy only — nothing runs here. Execute it in a terminal on the computer running DSH, then restart DSH yourself."
+				zh: "仅复制，不会执行。请在运行 DSH 的那台电脑的终端执行；完成后仅在已安装用户级监督服务时使用本面板的重启，否则由你自行重启 DSH。",
+				en: "Copy only — nothing runs here. Execute it in a terminal on the computer running DSH, then use this panel’s restart only when user-level supervision is installed; otherwise restart DSH yourself."
 			},
 			"panel.readOnly": {
-				zh: "阶段 1 仅提示：本插件不会安装、重启、回滚或替换任何文件。",
-				en: "Phase 1 is advisory only: this plugin never installs, restarts, rolls back, or replaces files."
+				zh: "插件不会安装、升级、回滚或替换 DSH 文件；只有当前 DSH 已由用户显式安装的后台服务监督时，才允许安全重启。",
+				en: "The plugin never installs, upgrades, rolls back, or replaces DSH files. Safe restart is available only when the current DSH is supervised by a user-installed service."
+			},
+			"restart.title": {
+				zh: "安全重启 DSH Web",
+				en: "Safely restart DSH Web"
+			},
+			"restart.button": {
+				zh: "重启",
+				en: "Restart"
+			},
+			"restart.loading": {
+				zh: "读取重启状态…",
+				en: "Reading restart status…"
+			},
+			"restart.checking": {
+				zh: "检查活动任务…",
+				en: "Checking active work…"
+			},
+			"restart.confirm": {
+				zh: "确认重启",
+				en: "Confirm restart"
+			},
+			"restart.force": {
+				zh: "强制重启",
+				en: "Force restart"
+			},
+			"restart.cancel": {
+				zh: "取消",
+				en: "Cancel"
+			},
+			"restart.retry": {
+				zh: "重新检查",
+				en: "Check again"
+			},
+			"restart.confirmHint": {
+				zh: "再次点击“确认重启”后，页面会短暂断开；后台服务恢复新实例后将自动刷新。",
+				en: "Click Confirm restart again. The page disconnects briefly and refreshes once the supervised service starts a new instance."
+			},
+			"restart.activeWarning": {
+				zh: "检测到 {count} 个正在运行的任务。强制重启会中断它们。",
+				en: "{count} active work item(s) are running. A forced restart interrupts them."
+			},
+			"restart.waitingShort": {
+				zh: "重启中…",
+				en: "Restarting…"
+			},
+			"restart.waiting": {
+				zh: "正在等待后台服务恢复 DSH（已等待 {seconds} 秒）…",
+				en: "Waiting for the user service to restore DSH ({seconds}s elapsed)…"
+			},
+			"restart.timeout": {
+				zh: "60 秒内未检测到新 DSH 实例。请检查用户服务状态和日志；重新加载本页不会再次触发重启。",
+				en: "No new DSH instance was detected within 60 seconds. Check the user-service status and logs; reloading this page will not trigger another restart."
+			},
+			"restart.unavailable": {
+				zh: "当前 DSH 不是由已确认的用户级后台服务启动。为避免页面重启后无法恢复，按钮已禁用；请先按服务管理文档安装并接管 DSH。",
+				en: "This DSH is not running under a verified user-level service. Restart is disabled so the page cannot strand itself; install and activate supervision first."
+			},
+			"restart.unavailableDesktop": {
+				zh: "DSH Desktop 管理当前 Host；请退出并重新打开桌面应用。",
+				en: "DSH Desktop manages this Host. Quit and reopen the desktop app instead."
+			},
+			"restart.unavailableMismatch": {
+				zh: "检测到监督标记，但当前进程不符合对应平台服务的身份。为安全起见，重启已禁用。",
+				en: "A supervision marker exists, but this process does not match the platform service identity. Restart is disabled for safety."
+			},
+			"restart.unavailableActivity": {
+				zh: "无法完整读取正在运行的任务。为避免中断未能列出的工作，重启已禁用。",
+				en: "Active work could not be inspected completely. Restart is disabled to avoid interrupting work that could not be listed."
+			},
+			"restart.unavailableTimer": {
+				zh: "当前 Host 没有可用的安全退出调度器。为确保响应先送达浏览器，重启已禁用。",
+				en: "This Host has no safe exit scheduler. Restart is disabled so its response can reach the browser first."
+			},
+			"restart.unavailableStale": {
+				zh: "此页面连接的是过期 DSH 实例。请等待恢复或重新加载后再重试。",
+				en: "This page is connected to a stale DSH instance. Wait for recovery or reload before trying again."
 			},
 			"panel.error": {
 				zh: "检查提示",
@@ -412,6 +494,85 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
+		function restartUnavailableText(reason) {
+			if (reason === "desktop") return t("restart.unavailableDesktop");
+			if (reason === "supervisor-mismatch") return t("restart.unavailableMismatch");
+			if (reason === "activity-unavailable") return t("restart.unavailableActivity");
+			if (reason === "timer-unavailable") return t("restart.unavailableTimer");
+			if (reason === "stale-instance") return t("restart.unavailableStale");
+			return t("restart.unavailable");
+		}
+		function RestartControl({ restart }) {
+			const snapshot = useObservable(restart);
+			React.useEffect(() => {
+				restart.refresh();
+			}, [restart]);
+			const unavailable = snapshot.status !== null && !snapshot.status.available;
+			const hasActivity = snapshot.activity.length > 0;
+			const waiting = snapshot.phase === "waiting";
+			const label = snapshot.phase === "unknown" ? t("restart.loading") : snapshot.phase === "checking" ? t("restart.checking") : snapshot.phase === "armed" ? hasActivity ? t("restart.force") : t("restart.confirm") : waiting ? t("restart.waitingShort") : snapshot.phase === "timeout" ? t("restart.retry") : snapshot.phase === "error" ? t("restart.retry") : t("restart.button");
+			const disabled = snapshot.phase === "unknown" || snapshot.phase === "checking" || waiting || unavailable;
+			const click = () => {
+				if (snapshot.phase === "armed") {
+					restart.request(hasActivity);
+					return;
+				}
+				if (snapshot.phase === "timeout" || snapshot.phase === "error") {
+					restart.check();
+					return;
+				}
+				restart.check();
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					className: "dus-action dus-restart",
+					type: "button",
+					disabled,
+					title: unavailable ? restartUnavailableText(snapshot.status?.unavailableReason) : t("restart.title"),
+					onClick: click,
+					children: label
+				}),
+				snapshot.phase === "armed" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					className: "dus-action",
+					type: "button",
+					onClick: () => restart.cancel(),
+					children: t("restart.cancel")
+				}),
+				unavailable && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-restart-message",
+					role: "status",
+					children: restartUnavailableText(snapshot.status?.unavailableReason)
+				}),
+				snapshot.phase === "armed" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-restart-message",
+					role: "status",
+					children: hasActivity ? t("restart.activeWarning", { count: String(snapshot.activity.length) }) : t("restart.confirmHint")
+				}),
+				hasActivity && snapshot.phase === "armed" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+					className: "dus-restart-work",
+					children: snapshot.activity.map((item) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", { children: [
+						item.label,
+						" · ",
+						item.status
+					] }, `${item.type}:${item.id}`))
+				}),
+				waiting && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-restart-message",
+					role: "status",
+					children: t("restart.waiting", { seconds: String(Math.floor(snapshot.elapsedMs / 1e3)) })
+				}),
+				snapshot.phase === "timeout" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-restart-message",
+					role: "alert",
+					children: t("restart.timeout")
+				}),
+				snapshot.phase === "error" && snapshot.error !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "dus-restart-message",
+					role: "alert",
+					children: snapshot.error
+				})
+			] });
+		}
 		function statusSummary(status, loading, error) {
 			if (loading && status === null) return {
 				kind: "warning",
@@ -655,21 +816,25 @@ window.__ModuleLoader__.load({
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dus-actions",
-							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								className: "dus-action",
-								type: "button",
-								disabled: snapshot.loading,
-								onClick: () => {
-									ui.status.refresh(preferences.cacheTtlMinutes);
-								},
-								children: snapshot.loading ? t("panel.checking") : t("panel.check")
-							}), status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-								className: "dus-action",
-								href: status.changelogUrl,
-								target: "_blank",
-								rel: "noreferrer",
-								children: t("panel.releaseNotes")
-							})]
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									className: "dus-action",
+									type: "button",
+									disabled: snapshot.loading,
+									onClick: () => {
+										ui.status.refresh(preferences.cacheTtlMinutes);
+									},
+									children: snapshot.loading ? t("panel.checking") : t("panel.check")
+								}),
+								status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+									className: "dus-action",
+									href: status.changelogUrl,
+									target: "_blank",
+									rel: "noreferrer",
+									children: t("panel.releaseNotes")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RestartControl, { restart: ui.restart })
+							]
 						}),
 						hasUpdate && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CommandBlock, {
 							command,
@@ -762,21 +927,29 @@ window.__ModuleLoader__.load({
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 								className: "dus-actions",
-								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-									className: "dus-action",
-									type: "button",
-									disabled: snapshot.loading,
-									onClick: () => {
-										ui.status.refresh(preferences.cacheTtlMinutes);
-									},
-									children: snapshot.loading ? t("panel.checking") : t("panel.check")
-								}), status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-									className: "dus-action",
-									href: status.changelogUrl,
-									target: "_blank",
-									rel: "noreferrer",
-									children: t("panel.releaseNotes")
-								})]
+								children: [
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+										className: "dus-action",
+										type: "button",
+										disabled: snapshot.loading,
+										onClick: () => {
+											ui.status.refresh(preferences.cacheTtlMinutes);
+										},
+										children: snapshot.loading ? t("panel.checking") : t("panel.check")
+									}),
+									status !== null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+										className: "dus-action",
+										href: status.changelogUrl,
+										target: "_blank",
+										rel: "noreferrer",
+										children: t("panel.releaseNotes")
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)(RestartControl, { restart: ui.restart })
+								]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dus-settings-hint",
+								children: t("panel.readOnly")
 							})
 						]
 					})
@@ -788,6 +961,71 @@ window.__ModuleLoader__.load({
 		function errorMessage(error) {
 			return (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim().slice(0, 220) || "unknown error";
 		}
+		function objectOf(value) {
+			return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+		}
+		function restartStatusOf(value) {
+			const record = objectOf(value);
+			if (record === void 0 || typeof record.instanceId !== "string" || record.instanceId === "" || typeof record.available !== "boolean") return void 0;
+			const supervisor = record.supervisor === null ? null : record.supervisor === "launchd" || record.supervisor === "systemd" || record.supervisor === "task-scheduler" || record.supervisor === "unknown" ? record.supervisor : void 0;
+			const unavailableReason = record.unavailableReason === null ? null : record.unavailableReason === "not-supervised" || record.unavailableReason === "desktop" || record.unavailableReason === "supervisor-mismatch" || record.unavailableReason === "activity-unavailable" || record.unavailableReason === "timer-unavailable" || record.unavailableReason === "stale-instance" ? record.unavailableReason : void 0;
+			if (supervisor === void 0 || unavailableReason === void 0) return void 0;
+			if (record.available && (supervisor === null || unavailableReason !== null)) return void 0;
+			if (!record.available && unavailableReason === null) return void 0;
+			return {
+				instanceId: record.instanceId,
+				available: record.available,
+				supervisor,
+				unavailableReason
+			};
+		}
+		function restartActivityOf(value) {
+			const record = objectOf(value);
+			if (record === void 0 || typeof record.hasActive !== "boolean" || !Array.isArray(record.items)) return void 0;
+			const items = [];
+			for (const raw of record.items) {
+				const item = objectOf(raw);
+				if (item === void 0 || item.type !== "agent" && item.type !== "job" && item.type !== "terminal" || typeof item.id !== "string" || typeof item.label !== "string" || typeof item.status !== "string") return void 0;
+				if (item.ownerSession !== void 0 && typeof item.ownerSession !== "string") return void 0;
+				items.push({
+					type: item.type,
+					id: item.id,
+					label: item.label,
+					status: item.status,
+					...item.ownerSession === void 0 ? {} : { ownerSession: item.ownerSession }
+				});
+			}
+			if (record.hasActive !== items.length > 0) return void 0;
+			return {
+				hasActive: record.hasActive,
+				items
+			};
+		}
+		function restartCheckOf(value) {
+			const record = objectOf(value);
+			if (record === void 0 || record.kind !== "ready" && record.kind !== "active-work" && record.kind !== "unavailable") return void 0;
+			const status = restartStatusOf(record.status);
+			if (status === void 0) return void 0;
+			const activity = record.activity === void 0 ? void 0 : restartActivityOf(record.activity);
+			if (record.activity !== void 0 && activity === void 0) return void 0;
+			if (record.kind === "active-work" && (activity === void 0 || !activity.hasActive)) return void 0;
+			if (record.kind !== "active-work" && activity !== void 0) return void 0;
+			return {
+				kind: record.kind,
+				status,
+				...activity === void 0 ? {} : { activity }
+			};
+		}
+		function restartRequestOf(value) {
+			const record = objectOf(value);
+			if (record === void 0 || record.kind !== "ready" && record.kind !== "active-work" && record.kind !== "unavailable" && record.kind !== "scheduled" && record.kind !== "in-progress") return void 0;
+			if (record.kind === "scheduled" || record.kind === "in-progress") return typeof record.instanceId === "string" && record.instanceId !== "" ? {
+				kind: record.kind,
+				instanceId: record.instanceId
+			} : void 0;
+			const check = restartCheckOf(record);
+			return check === void 0 ? void 0 : check;
+		}
 		function stringOrNull(value) {
 			return typeof value === "string" ? value : null;
 		}
@@ -1064,6 +1302,292 @@ window.__ModuleLoader__.load({
 				for (const listener of this.listeners) listener();
 			}
 		};
+		const INITIAL_RESTART = {
+			phase: "unknown",
+			status: null,
+			activity: [],
+			elapsedMs: 0,
+			error: null
+		};
+		/**
+		* Restart state belongs to the client entry, not a modal component, so closing
+		* the update panel cannot strand a confirmed restart half-way through recovery.
+		* It starts no timer until the user confirms a restart request.
+		*/
+		var RestartStore = class {
+			connection;
+			snapshot = INITIAL_RESTART;
+			listeners = /* @__PURE__ */ new Set();
+			timer;
+			generation = 0;
+			stopped = false;
+			schedule;
+			cancelTimer;
+			requestTimeout;
+			cancelRequestTimeout;
+			liveness;
+			reload;
+			pendingAbort;
+			reloaded = false;
+			constructor(connection, options = {}) {
+				this.connection = connection;
+				this.schedule = options.schedule ?? ((callback, delay) => window.setTimeout(callback, delay));
+				this.cancelTimer = options.cancel ?? ((handle) => {
+					window.clearTimeout(handle);
+				});
+				this.requestTimeout = options.requestTimeout ?? ((callback, delay) => window.setTimeout(callback, delay));
+				this.cancelRequestTimeout = options.cancelRequestTimeout ?? ((handle) => {
+					window.clearTimeout(handle);
+				});
+				this.liveness = options.liveness ?? (async () => {
+					try {
+						const response = await fetch(new URL(".", window.location.href), {
+							method: "HEAD",
+							credentials: "same-origin",
+							cache: "no-store"
+						});
+						return response.status === 200 || response.status === 401;
+					} catch {
+						return false;
+					}
+				});
+				this.reload = options.reload ?? (() => window.location.reload());
+			}
+			getSnapshot = () => this.snapshot;
+			subscribe = (listener) => {
+				this.listeners.add(listener);
+				return () => {
+					this.listeners.delete(listener);
+				};
+			};
+			stop() {
+				this.stopped = true;
+				this.generation += 1;
+				if (this.timer !== void 0) this.cancelTimer(this.timer);
+				this.timer = void 0;
+				this.pendingAbort?.abort();
+				this.pendingAbort = void 0;
+				this.listeners.clear();
+			}
+			/** Read capability on a visible surface; this is not a restart and never polls. */
+			async refresh() {
+				if (this.snapshot.phase === "waiting") return;
+				const raw = await this.call(RESTART_ENDPOINTS.status, {});
+				if (raw === void 0) return;
+				const status = restartStatusOf(raw);
+				if (status === void 0) {
+					this.publish({
+						...this.snapshot,
+						phase: "error",
+						error: "invalid restart-status payload"
+					});
+					return;
+				}
+				this.publish({
+					phase: status.available ? "idle" : "idle",
+					status,
+					activity: [],
+					elapsedMs: 0,
+					error: null
+				});
+			}
+			/** First click checks active work and arms the second, destructive action. */
+			async check() {
+				this.publish({
+					...this.snapshot,
+					phase: "checking",
+					error: null
+				});
+				const raw = await this.call(RESTART_ENDPOINTS.check, {});
+				if (raw === void 0) return;
+				const checked = restartCheckOf(raw);
+				if (checked === void 0) {
+					this.publish({
+						...this.snapshot,
+						phase: "error",
+						error: "invalid restart-check payload"
+					});
+					return;
+				}
+				if (checked.kind === "unavailable") {
+					this.publish({
+						phase: "idle",
+						status: checked.status,
+						activity: [],
+						elapsedMs: 0,
+						error: null
+					});
+					return;
+				}
+				this.publish({
+					phase: "armed",
+					status: checked.status,
+					activity: checked.activity?.items ?? [],
+					elapsedMs: 0,
+					error: null
+				});
+			}
+			cancel() {
+				if (this.snapshot.phase !== "armed" && this.snapshot.phase !== "error" && this.snapshot.phase !== "timeout") return;
+				this.publish({
+					...this.snapshot,
+					phase: this.snapshot.status === null ? "unknown" : "idle",
+					activity: [],
+					elapsedMs: 0,
+					error: null
+				});
+			}
+			/** Second click emits the Host request; `force` is only true after the activity list was shown. */
+			async request(force) {
+				const current = this.snapshot;
+				if (current.phase !== "armed" || current.status === null || !current.status.available) return;
+				this.publish({
+					...current,
+					phase: "checking",
+					error: null
+				});
+				const raw = await this.call(RESTART_ENDPOINTS.request, {
+					force,
+					expectedInstanceId: current.status.instanceId
+				});
+				if (raw === void 0) return;
+				const result = restartRequestOf(raw);
+				if (result === void 0) {
+					this.publish({
+						...this.snapshot,
+						phase: "error",
+						error: "invalid restart payload"
+					});
+					return;
+				}
+				if (result.kind === "scheduled" || result.kind === "in-progress") {
+					if (result.instanceId === void 0) {
+						this.publish({
+							...this.snapshot,
+							phase: "error",
+							error: "restart response omitted instance identity"
+						});
+						return;
+					}
+					this.beginRecovery(result.instanceId);
+					return;
+				}
+				if (result.kind === "active-work" || result.kind === "ready") {
+					this.publish({
+						phase: "armed",
+						status: result.status ?? current.status,
+						activity: result.activity?.items ?? [],
+						elapsedMs: 0,
+						error: null
+					});
+					return;
+				}
+				this.publish({
+					phase: "idle",
+					status: result.status ?? current.status,
+					activity: [],
+					elapsedMs: 0,
+					error: null
+				});
+			}
+			beginRecovery(previousInstanceId) {
+				const generation = ++this.generation;
+				const startedAt = Date.now();
+				this.publish({
+					...this.snapshot,
+					phase: "waiting",
+					elapsedMs: 0,
+					error: null
+				});
+				const attempt = async (delay) => {
+					if (this.stopped || generation !== this.generation) return;
+					const elapsedMs = Date.now() - startedAt;
+					if (elapsedMs >= 6e4) {
+						this.publish({
+							...this.snapshot,
+							phase: "timeout",
+							elapsedMs,
+							error: null
+						});
+						return;
+					}
+					this.timer = this.schedule(() => {
+						(async () => {
+							if (this.stopped || generation !== this.generation) return;
+							const raw = await this.call(RESTART_ENDPOINTS.status, {}, false, 4e3);
+							if (this.stopped || generation !== this.generation) return;
+							const status = raw === void 0 ? void 0 : restartStatusOf(raw);
+							const nextElapsed = Date.now() - startedAt;
+							if (status !== void 0 && status.instanceId !== previousInstanceId) {
+								this.publish({
+									phase: "waiting",
+									status,
+									activity: [],
+									elapsedMs: nextElapsed,
+									error: null
+								});
+								if (!this.reloaded) {
+									this.reloaded = true;
+									this.reload();
+								}
+								return;
+							}
+							if (raw === void 0 && await this.liveness()) {
+								if (!this.reloaded) {
+									this.reloaded = true;
+									this.reload();
+								}
+								return;
+							}
+							this.publish({
+								...this.snapshot,
+								phase: "waiting",
+								elapsedMs: nextElapsed
+							});
+							await attempt(Math.min(delay * 2, 1e4));
+						})();
+					}, delay);
+				};
+				attempt(1e3);
+			}
+			async call(endpoint, payload, surfaceError = true, timeoutMs) {
+				const rpc = this.connection.rpc;
+				if (rpc === void 0 || typeof rpc.call !== "function") {
+					if (surfaceError) this.publish({
+						...this.snapshot,
+						phase: "error",
+						error: "DSH connection RPC is unavailable"
+					});
+					return;
+				}
+				const controller = timeoutMs === void 0 ? void 0 : new AbortController();
+				if (controller !== void 0) this.pendingAbort = controller;
+				let timeout;
+				if (controller !== void 0 && timeoutMs !== void 0) timeout = this.requestTimeout(() => controller.abort(), timeoutMs);
+				try {
+					const raw = await rpc.call(UPDATE_STATUS_CHANNEL, endpoint, payload, controller?.signal);
+					if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error("invalid restart RPC response");
+					const envelope = raw;
+					if (envelope.ok !== true) throw new Error(typeof envelope.error?.message === "string" ? envelope.error.message : "restart RPC failed");
+					return envelope.value;
+				} catch (error) {
+					if (surfaceError) this.publish({
+						...this.snapshot,
+						phase: "error",
+						error: errorMessage(error)
+					});
+					return;
+				} finally {
+					if (timeout !== void 0) this.cancelRequestTimeout(timeout);
+					if (this.pendingAbort === controller) this.pendingAbort = void 0;
+				}
+			}
+			publish(next) {
+				if (this.stopped) return;
+				this.snapshot = next;
+				for (const listener of this.listeners) listener();
+			}
+		};
 		/**
 		* The one settings namespace, which on DSH 0.1.7 IS the Loader entry id in
 		* `cordis.patch.yml`: the Host half's volatile `Config` fields are projected as
@@ -1543,6 +2067,12 @@ window.__ModuleLoader__.load({
 .dus-actions{display:flex;flex-wrap:wrap;gap:8px;margin:0 0 12px}
 .dus-action{background:var(--dsw-alias-button-floating-fill);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;color:inherit;cursor:pointer;font-size:12px;line-height:30px;min-height:32px;padding:0 10px;touch-action:manipulation}
 .dus-action:disabled{cursor:wait;opacity:.65}
+.dus-restart{border-color:var(--dsw-alias-state-warn-primary);color:var(--dsw-alias-state-warn-primary)}
+.dus-restart-message{color:var(--dsw-alias-label-secondary);flex-basis:100%;font-size:11px;line-height:1.45;margin:0}
+.dus-restart-work{color:var(--dsw-alias-label-secondary);flex-basis:100%;font-size:11px;line-height:1.5;margin:0;overflow-wrap:anywhere;padding-left:18px}
+/* A job label is a whole shell command: clamp it so one long command cannot push
+   the panel's buttons off a 390px card. */
+.dus-restart-work li{display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden}
 .dus-command-label{color:var(--dsw-alias-label-secondary);font-size:12px;font-weight:600;margin:0 0 6px}
 .dus-command{background:var(--dsw-specific-input-major);border:1px solid var(--dsw-alias-border-l2);border-radius:8px;display:block;font-family:var(--dsw-font-family-mono,ui-monospace,SFMono-Regular,Menlo,monospace);font-size:11px;line-height:1.5;margin:0;overflow-wrap:anywhere;padding:9px;tab-size:2;user-select:text;white-space:pre-wrap}
 .dus-command:focus{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}
@@ -1586,12 +2116,16 @@ window.__ModuleLoader__.load({
 			}
 		}
 		function apply(ctx) {
-			const status = new StatusStore(connectionOf(ctx));
+			const connection = connectionOf(ctx);
+			const status = new StatusStore(connection);
 			const preferences = new PreferencesStore();
+			const panel = new PanelStore();
+			const restart = new RestartStore(connection);
 			const ui = {
 				status,
 				preferences,
-				panel: new PanelStore()
+				panel,
+				restart
 			};
 			const disposers = [];
 			let stopped = false;
@@ -1644,6 +2178,7 @@ window.__ModuleLoader__.load({
 						dispose();
 					} catch {}
 					channel.dispose();
+					restart.stop();
 					status.stop();
 					disposeStyles();
 				};
@@ -1668,7 +2203,10 @@ window.__ModuleLoader__.load({
 				});
 			} catch {}
 			if (typeof ctx.on === "function") try {
-				own(ctx.on("connection/reset", () => channel.reload()));
+				own(ctx.on("connection/reset", () => {
+					channel.reload();
+					restart.refresh();
+				}));
 			} catch {}
 			ctx.slots.inject("sidebar.brand.name", () => {
 				let registration;