dsh-edge 0.9.0 → 0.10.0

package/dist/plugins/@deepseek-ai/dsh-client-ui-settings/client.js

@@ -5,7 +5,7 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
-		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		//#region ../../../vendor/cosmokit/src/misc.ts
 		/** Return true when a value is `null` or `undefined`. */
 		function isNullable(value) {
@@ -934,11 +934,9 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/settings-scope.js
 		/**
-		* Host transport for the settings-namespace scope contract. The contract types
-		* live in `dsh-client-runtime` (the common dependency of every feature that
-		* owns a preference); this file owns the per-namespace derivation over the
-		* shared {@link SettingsDescribeMirror} and the serialized write path, both of
-		* which are Settings-surface concerns. Reads never touch the wire here: the
+		* Host transport for the settings-namespace scope contract. This file owns the
+		* per-namespace derivation over the shared {@link SettingsDescribeMirror} and
+		* the serialized write path. Reads never touch the wire here: the
 		* mirror is the one `settings.describe` reader, and every scope is a selector
 		* over its snapshot.
 		*/
@@ -949,7 +947,7 @@ window.__ModuleLoader__.load({
 		* the operation already crossing the wire.
 		*/
 		var SettingsScopeController = class {
-			api;
+			ctx;
 			spec;
 			mirror;
 			persistence;
@@ -966,19 +964,20 @@ window.__ModuleLoader__.load({
 			*/
 			pendingRevision;
 			/**
-			* @param api - settings wire face (writes only; reads ride the mirror).
+			* @param ctx - the providing plugin's context, whose `remote.settings`
+			* namespace carries this scope's writes (reads ride the mirror).
 			* @param spec - namespace identity and optional narrowing decoder.
 			* @param mirror - the shared describe mirror this scope derives from.
-			* @param persistence - remote browsers remain process-local because settings RPCs are loopback-only.
+			* @param persistence - client-selected Host persistence; non-loopback pages may remain process-local.
 			* @param schema - settings-owned schema operations.
 			*/
-			constructor(api, spec, mirror, persistence, schema) {
-				this.api = api;
+			constructor(ctx, spec, mirror, persistence, schema) {
+				this.ctx = ctx;
 				this.spec = spec;
 				this.mirror = mirror;
 				this.persistence = persistence;
 				this.schema = schema;
-				this.store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+				this.store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
 					status: persistence === "host" ? "loading" : "unavailable",
 					value: void 0,
 					base: void 0,
@@ -1014,11 +1013,11 @@ window.__ModuleLoader__.load({
 			* @returns settlement after the write and any latest-write recovery read.
 			*/
 			set(field, value) {
-				return this.write({
+				return this.mutate([{
 					op: "set",
 					path: [field],
 					value
-				});
+				}]);
 			}
 			/**
 			* Queue one field clear; see {@link SettingsScope.unset} for the ordering,
@@ -1027,35 +1026,32 @@ window.__ModuleLoader__.load({
 			* @returns settlement after the clear and any latest-write recovery read.
 			*/
 			unset(field) {
-				return this.write({
+				return this.mutate([{
 					op: "unset",
 					path: [field]
-				});
+				}]);
 			}
-			write(op) {
+			/**
+			* Queue one atomic namespace mutation; see {@link SettingsScope.mutate}.
+			* @param ops - ordered field operations copied when queued.
+			* @param expectedRevision - optional fixed revision read by the domain editor.
+			* @returns settlement after the mutation and any latest-write recovery read.
+			*/
+			mutate(ops, expectedRevision) {
+				const ownedOps = structuredClone(ops);
 				const generation = ++this.writeGeneration;
 				return this.enqueue(async () => {
-					const revision = this.pendingRevision ?? this.getSnapshot().revision;
-					let response;
-					try {
-						response = await this.api.settings.mutate({
-							ns: this.spec.namespace,
-							ops: [op],
-							...revision === void 0 ? {} : { expectedRevision: revision }
-						});
-					} catch (_settingsWriteFailure) {
-						await this.recover(generation);
-						return;
-					}
-					if (!response.result.ok) {
+					const revision = expectedRevision ?? this.pendingRevision ?? this.getSnapshot().revision;
+					const response = await this.ctx.remote.settings.mutate(this.spec.namespace, ownedOps, revision);
+					if (!response.ok) {
 						await this.recover(generation);
 						return;
 					}
 					if (this.disposed) return;
 					if (generation === this.writeGeneration) {
 						this.pendingRevision = void 0;
-						this.mirror.acceptView(response.result.value);
-					} else this.pendingRevision = response.result.value.revision;
+						this.mirror.acceptView(response.value);
+					} else this.pendingRevision = response.value.revision;
 				});
 			}
 			/** Reload Host state for the latest failed write; superseded failures leave recovery to it. */
@@ -1130,15 +1126,25 @@ window.__ModuleLoader__.load({
 		var SettingsScopeBinder = class extends _deepseek_ai_cordis.Service {
 			mirror;
 			schema;
+			persistence;
+			/**
+			* The PROVIDING fiber, kept because a Service reads `ctx` as its *consumer's*
+			* fiber: letting a bound scope write through the caller's context would make
+			* every caller declare `remote.settings` in its own `inject`.
+			*/
+			owner;
 			/**
 			* @param ctx - the providing plugin's context.
 			* @param config - the shared describe mirror every bound scope derives from,
-			* plus the settings-owned schema operations.
+			* the settings-owned schema operations, and the Host persistence the provider
+			* resolved from `remote.$host`.
 			*/
 			constructor(ctx, config) {
 				super(ctx, "settingsScope");
 				this.mirror = config.mirror;
 				this.schema = config.schema;
+				this.persistence = config.persistence;
+				this.owner = ctx;
 			}
 			/**
 			* The shared mirror's read/fold face for cross-namespace surfaces (schema
@@ -1162,8 +1168,7 @@ window.__ModuleLoader__.load({
 			*/
 			bind(spec) {
 				const ctx = this.ctx;
-				const connection = ctx.get("connection");
-				const controller = new SettingsScopeController(connection.api, spec, this.mirror, connection.isLoopback ? "host" : "memory", this.schema);
+				const controller = new SettingsScopeController(this.owner, spec, this.mirror, this.persistence, this.schema);
 				ctx.effect(() => {
 					this.mirror.ensure();
 					return async () => {
@@ -1191,20 +1196,21 @@ window.__ModuleLoader__.load({
 		* so an invalidation arriving mid-read is never lost and never duplicated.
 		*/
 		var SettingsDescribeMirror = class {
-			api;
+			ctx;
 			persistence;
 			store;
 			inFlight;
 			rerun = false;
 			generation = 0;
 			/**
-			* @param api - settings wire face.
-			* @param persistence - remote browsers stay process-local because settings RPCs are loopback-only.
+			* @param ctx - the providing plugin's context, whose `remote.settings`
+			* namespace answers the describe read.
+			* @param persistence - client-selected Host persistence; non-loopback pages may remain process-local.
 			*/
-			constructor(api, persistence = "host") {
-				this.api = api;
+			constructor(ctx, persistence = "host") {
+				this.ctx = ctx;
 				this.persistence = persistence;
-				this.store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+				this.store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
 					status: persistence === "host" ? "idle" : "unavailable",
 					view: void 0,
 					error: null
@@ -1290,8 +1296,8 @@ window.__ModuleLoader__.load({
 						const generation = ++this.generation;
 						let outcome;
 						try {
-							const response = await this.api.settings.describe({});
-							outcome = response.result.ok ? { view: response.result.value } : { failure: response.result.error.message };
+							const response = await this.ctx.remote.settings.describe();
+							outcome = response.ok ? { view: response.value } : { failure: response.error.message };
 						} catch (error) {
 							outcome = { failure: error instanceof Error ? error.message : String(error) };
 						}
@@ -1321,10 +1327,10 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/index.js
 		/**
-		* Required services: the wire handle for the mirror's reads and the forwarded
-		* settings invalidation the mirror refreshes on.
+		* Required services: the Remote namespace the mirror reads through and the
+		* forwarded settings invalidation it refreshes on.
 		*/
-		const inject = ["connection", "remote"];
+		const inject = ["remote", "remote.settings"];
 		/**
 		* Provide the settings-namespace scope service over one shared describe
 		* mirror, and keep that mirror fresh on the two signals that can move the
@@ -1336,10 +1342,10 @@ window.__ModuleLoader__.load({
 		*/
 		function apply(ctx) {
 			const schema = new SettingsSchemaService(ctx);
-			const connection = ctx.get("connection");
-			const mirror = new SettingsDescribeMirror(connection.api, connection.isLoopback ? "host" : "memory");
+			const persistence = ctx.remote.$host.isLoopback ? "host" : "memory";
+			const mirror = new SettingsDescribeMirror(ctx, persistence);
 			ctx.effect(() => {
-				const disposers = [ctx.get("remote").$on("settings/document-updated", () => {
+				const disposers = [ctx.remote.$on("settings/document-updated", () => {
 					mirror.load();
 				}), ctx.on("connection/reset", () => {
 					mirror.load();
@@ -1351,7 +1357,8 @@ window.__ModuleLoader__.load({
 			}, "ui-settings: describe mirror invalidations");
 			new SettingsScopeBinder(ctx, {
 				mirror,
-				schema
+				schema,
+				persistence
 			});
 		}
 		//#endregion

package/dist/plugins/@deepseek-ai/dsh-client-ui-settings-general/client.js

@@ -8,7 +8,7 @@ window.__ModuleLoader__.load({
 		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");
-		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		//#region ../../../node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 		function r(e) {
 			var t, f, n = "";
@@ -25,7 +25,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-settings-general/src/client/SettingsRoot.module.css.mjs
-		const css$3 = ".VOzbGW_trigger{box-sizing:border-box;cursor:pointer;width:calc(100% + 4px);height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:none;align-items:center;gap:8px;margin:4px -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.VOzbGW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_trigger.VOzbGW_rail{border-radius:50%;justify-content:center;gap:0;width:36px;height:36px;margin:8px 0 10px;padding:0}.VOzbGW_triggerLabel{white-space:nowrap;overflow:hidden}.VOzbGW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.VOzbGW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.VOzbGW_panel{z-index:1;background:var(--dsw-alias-bg-layer-2);width:800px;max-width:calc(100vw - 48px);height:min(800px,100vh - 48px);box-shadow:var(--dsw-shadow-lv3);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:24px;display:flex;position:relative;overflow:hidden}.VOzbGW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.VOzbGW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.VOzbGW_navList{flex-direction:column;gap:4px;display:flex}.VOzbGW_navCell{box-sizing:border-box;cursor:pointer;height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:9px 16px 9px 12px;font-family:inherit;font-size:14px;font-weight:400;line-height:22px;display:flex}.VOzbGW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.VOzbGW_navCell.VOzbGW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.VOzbGW_navIcon{flex:none}.VOzbGW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.VOzbGW_content{flex-direction:column;flex:1;min-width:0;display:flex}.VOzbGW_header{box-sizing:border-box;flex:none;justify-content:space-between;align-items:flex-start;gap:8px;height:54px;padding:20px 14px 8px 10px;display:flex}.VOzbGW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.VOzbGW_close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:0;display:inline-flex}.VOzbGW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.VOzbGW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
+		const css$3 = ".VOzbGW_triggerRow{flex:none;align-items:center;gap:8px;width:calc(100% + 4px);margin:4px -2px;display:flex}.VOzbGW_triggerRow.VOzbGW_railRow{width:36px;margin:8px 0 10px}.VOzbGW_trigger{box-sizing:border-box;cursor:pointer;width:auto;min-width:0;height:42px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:12px;flex:1;align-items:center;gap:8px;margin:0;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;display:flex;overflow:hidden}.VOzbGW_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_trigger.VOzbGW_rail{corner-shape:round;border-radius:50%;flex:none;justify-content:center;gap:0;width:36px;height:36px;margin:0;padding:0}.VOzbGW_triggerLabel{white-space:nowrap;overflow:hidden}.VOzbGW_overlay{z-index:1000;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.VOzbGW_mask{background:var(--dsw-alias-bg-mask-1);backdrop-filter:var(--dsw-mask-blur);position:absolute;inset:0}.VOzbGW_panel{z-index:1;background:var(--dsw-alias-bg-layer-2);width:800px;max-width:calc(100vw - 48px);height:min(800px,100vh - 48px);box-shadow:var(--dsw-elevation-prominent);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border-radius:32px;display:flex;position:relative;overflow:hidden}.VOzbGW_nav{box-sizing:border-box;flex-direction:column;flex:none;gap:18px;width:188px;padding:22px 12px 0;display:flex}.VOzbGW_navTitle{color:var(--dsw-alias-label-primary);padding:0 12px;font-size:16px;font-weight:500;line-height:24px}.VOzbGW_navList{flex-direction:column;gap:4px;display:flex}.VOzbGW_navCell{box-sizing:border-box;cursor:pointer;height:40px;color:var(--dsw-alias-label-primary);text-align:left;background:0 0;border:none;border-radius:12px;align-items:center;gap:8px;padding:9px 16px 9px 12px;font-family:inherit;font-size:14px;font-weight:400;line-height:22px;display:flex}.VOzbGW_navCell:hover{background:var(--dsw-specific-sidebar-nav-item-hover)}.VOzbGW_navCell.VOzbGW_active{background:var(--dsw-specific-sidebar-nav-item-active)}.VOzbGW_navIcon{flex:none}.VOzbGW_navLabel{white-space:nowrap;text-overflow:ellipsis;flex:1;min-width:0;overflow:hidden}.VOzbGW_content{flex-direction:column;flex:1;min-width:0;display:flex}.VOzbGW_header{box-sizing:border-box;flex:none;justify-content:space-between;align-items:flex-start;gap:8px;height:54px;padding:20px 14px 8px 10px;display:flex}.VOzbGW_actions{justify-content:flex-end;align-items:center;gap:8px;min-width:0;margin-left:auto;display:flex}.VOzbGW_close{cursor:pointer;width:28px;height:28px;color:var(--dsw-alias-label-primary);background:0 0;border:none;border-radius:28px;justify-content:center;align-items:center;padding:0;display:inline-flex}.VOzbGW_close:hover{background:var(--dsw-alias-interactive-bg-hover)}.VOzbGW_options{flex:1;min-height:0;padding:0 24px 24px;overflow-y:auto}.VOzbGW_hiddenLabel{clip:rect(0 0 0 0);white-space:nowrap;width:1px;height:1px;position:absolute;overflow:hidden}";
 		const tagId$3 = "@deepseek-ai/dsh-client-ui-settings-general/SettingsRoot.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$3) + "]") === null) {
 			const tag = document.createElement("style");
@@ -52,8 +52,10 @@ window.__ModuleLoader__.load({
 			"overlay": "VOzbGW_overlay",
 			"panel": "VOzbGW_panel",
 			"rail": "VOzbGW_rail",
+			"railRow": "VOzbGW_railRow",
 			"trigger": "VOzbGW_trigger",
-			"triggerLabel": "VOzbGW_triggerLabel"
+			"triggerLabel": "VOzbGW_triggerLabel",
+			"triggerRow": "VOzbGW_triggerRow"
 		};
 		//#endregion
 		//#region lib/types/client/SettingsRoot.js
@@ -69,6 +71,7 @@ window.__ModuleLoader__.load({
 		* sessions-derived empty-Hero fact is active. Visible dialog chrome belongs
 		* to the step, so a mounted-but-deciding step paints nothing here.
 		*/
+		const RECOVERY_CONFIRMATION_MS = 2e3;
 		/** Nav glyph by section id; unknown ids fall back to the settings gear. */
 		function navIcon(id) {
 			if (id === "models") return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconDataOutline16, {
@@ -173,19 +176,28 @@ window.__ModuleLoader__.load({
 		* @returns the settings shell element tree.
 		*/
 		function SettingsRoot(props) {
-			const { wide, useSections, useOnboardingSteps, useSessions, renderSlot } = props;
+			const { wide, reconnect, useConnectionState, useSections, useOnboardingSteps, useSessions, renderSlot, t } = props;
 			const [open, setOpen] = (0, react.useState)(false);
 			const [activeId, setActiveId] = (0, react.useState)(void 0);
 			const [completedOnboarding, setCompletedOnboarding] = (0, react.useState)(() => /* @__PURE__ */ new Set());
+			const [showRecovery, setShowRecovery] = (0, react.useState)(false);
+			const triggerButton = (0, react.useRef)(null);
+			const wasOpen = (0, react.useRef)(open);
 			const close = (0, react.useCallback)(() => {
 				setOpen(false);
 				setActiveId(void 0);
 			}, []);
+			(0, react.useEffect)(() => {
+				if (wasOpen.current && !open) triggerButton.current?.focus();
+				wasOpen.current = open;
+			}, [open]);
 			const openSection = (0, react.useCallback)((id) => {
 				setActiveId(id);
 				setOpen(true);
 			}, []);
 			const rows = useSections((s) => s);
+			const connectionState = useConnectionState((state) => state);
+			const previousConnectionState = (0, react.useRef)(connectionState);
 			const onboardingSteps = useOnboardingSteps((s) => s);
 			const onboardingActive = useSessions((state) => state.phase === "ready" && (state.current === void 0 || state.byId[state.current]?.blank === true));
 			const onboardingStep = onboardingActive ? onboardingSteps.find((step) => !completedOnboarding.has(step.id)) : void 0;
@@ -193,22 +205,55 @@ window.__ModuleLoader__.load({
 				if (onboardingActive) return;
 				setCompletedOnboarding(/* @__PURE__ */ new Set());
 			}, [onboardingActive]);
+			(0, react.useLayoutEffect)(() => {
+				const previous = previousConnectionState.current;
+				previousConnectionState.current = connectionState;
+				if (connectionState !== "connected") {
+					setShowRecovery(false);
+					return;
+				}
+				if (previous !== "disconnected" && previous !== "connecting") return;
+				setShowRecovery(true);
+				const timeout = window.setTimeout(() => {
+					setShowRecovery(false);
+				}, RECOVERY_CONFIRMATION_MS);
+				return () => {
+					window.clearTimeout(timeout);
+				};
+			}, [connectionState]);
 			const completeOnboardingStep = (0, react.useCallback)((id) => {
 				setCompletedOnboarding((previous) => {
 					if (previous.has(id)) return previous;
 					return new Set([...previous, id]);
 				});
 			}, []);
+			let connectionIndicator;
+			if (connectionState === "disconnected") connectionIndicator = "disconnected";
+			else if (connectionState === "connecting") connectionIndicator = "connecting";
+			else if (showRecovery) connectionIndicator = "recovered";
 			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
-				(0, react_jsx_runtime.jsx)("button", {
-					type: "button",
-					className: clsx(SettingsRoot_module_css_default.trigger, !wide && SettingsRoot_module_css_default.rail),
-					"aria-haspopup": "dialog",
-					"aria-expanded": open,
-					onClick: () => {
-						setOpen(true);
-					},
-					children: renderSlot("settings.trigger", { wide })
+				(0, react_jsx_runtime.jsxs)("div", {
+					className: clsx(SettingsRoot_module_css_default.triggerRow, !wide && SettingsRoot_module_css_default.railRow),
+					children: [(0, react_jsx_runtime.jsx)("button", {
+						ref: triggerButton,
+						type: "button",
+						className: clsx(SettingsRoot_module_css_default.trigger, !wide && SettingsRoot_module_css_default.rail),
+						"aria-haspopup": "dialog",
+						"aria-expanded": open,
+						onClick: () => {
+							setOpen(true);
+						},
+						children: renderSlot("settings.trigger", { wide })
+					}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ConnectionIndicator, {
+						state: wide ? connectionIndicator : void 0,
+						disconnectedLabel: t("connection.error"),
+						reconnectLabel: t("connection.retry"),
+						connectingLabel: t("connection.connecting"),
+						recoveredLabel: t("connection.connected"),
+						reconnectActionLabel: t("connection.reconnect"),
+						restartActionLabel: t("connection.restart"),
+						onReconnect: reconnect
+					})]
 				}),
 				open && (0, react_jsx_runtime.jsx)(SettingsPanel, {
 					rows,
@@ -347,26 +392,24 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region lib/types/client/settings-document-store.js
 		/** State owner for the optional local settings-document action. */
-		function messageOf(error) {
-			return error instanceof Error ? error.message : String(error);
-		}
 		/** Derives local-document availability from the shared mirror and invokes the pathless Host-owned open operation. */
 		var SettingsDocumentStore = class {
-			api;
+			ctx;
 			describeFace;
 			/** uSES-safe state source shared by the registered header action. */
-			store = (0, _deepseek_ai_dsh_client_runtime_client.createSnapshotStore)({
+			store = (0, _deepseek_ai_dsh_client_store.createSnapshotStore)({
 				status: "idle",
 				opening: false,
 				error: null
 			});
 			following;
 			/**
-			* @param api - loopback settings wire face that opens the provider document.
+			* @param ctx - the plugin's context, whose loopback `remote.settings`
+			* namespace opens the provider document.
 			* @param describeFace - the shared mirror's describe face (`hasDocument` source).
 			*/
-			constructor(api, describeFace) {
-				this.api = api;
+			constructor(ctx, describeFace) {
+				this.ctx = ctx;
 				this.describeFace = describeFace;
 			}
 			/**
@@ -397,12 +440,13 @@ window.__ModuleLoader__.load({
 					state.error = null;
 				});
 				try {
-					const response = await this.api.settings.openDocument({});
-					if (!response.result.ok) throw new Error(response.result.error.message);
-				} catch (error) {
-					this.store.update((state) => {
-						state.error = messageOf(error);
-					});
+					const result = await this.ctx.remote.settings.openSettingsDocument();
+					if (!result.ok) {
+						const { message } = result.error;
+						this.store.update((state) => {
+							state.error = message;
+						});
+					}
 				} finally {
 					this.store.update((state) => {
 						state.opening = false;
@@ -440,7 +484,13 @@ window.__ModuleLoader__.load({
 			"close": "关闭",
 			"openDocument": "打开配置文件",
 			"openDocument.error": "无法打开配置文件",
-			"general.nav": "通用设置"
+			"general.nav": "通用设置",
+			"connection.error": "连接异常",
+			"connection.retry": "立即重连",
+			"connection.connecting": "连接中",
+			"connection.connected": "连接成功",
+			"connection.reconnect": "连接异常，点击立即重连",
+			"connection.restart": "连接中，点击立即重连"
 		};
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
@@ -449,7 +499,13 @@ window.__ModuleLoader__.load({
 			"close": "Close",
 			"openDocument": "Open configuration file",
 			"openDocument.error": "Could not open configuration file",
-			"general.nav": "General"
+			"general.nav": "General",
+			"connection.error": "Disconnected",
+			"connection.retry": "Reconnect now",
+			"connection.connecting": "Connecting",
+			"connection.connected": "Connected",
+			"connection.reconnect": "Disconnected, reconnect now",
+			"connection.restart": "Connecting, restart now"
 		};
 		//#endregion
 		//#region lib/types/client/index.js
@@ -464,6 +520,8 @@ window.__ModuleLoader__.load({
 			"slots",
 			"locale",
 			"connection",
+			"remote",
+			"remote.settings",
 			"settingsScope"
 		];
 		/**
@@ -476,9 +534,9 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "ui-settings-general: dictionaries");
-			const t = ctx.locale.bind(NS);
 			const connection = ctx.get("connection");
-			const documentController = connection.isLoopback ? new SettingsDocumentStore(connection.api, ctx.settingsScope.describe()) : void 0;
+			const t = ctx.locale.bind(NS);
+			const documentController = ctx.remote.$host.isLoopback ? new SettingsDocumentStore(ctx, ctx.settingsScope.describe()) : void 0;
 			const documentInjected = documentController === void 0 ? void 0 : () => ({
 				controller: documentController,
 				hooks: { snapshot: documentController.store }
@@ -491,50 +549,57 @@ window.__ModuleLoader__.load({
 			let rows = [];
 			let onboardingVersion = -1;
 			let onboardingSteps = [];
-			const shellInjected = () => ({ hooks: {
-				sections: {
-					getSnapshot: () => {
-						const version = ctx.slots.getVersion("settings.section");
-						const revision = ctx.locale.getSnapshot().revision;
-						if (version !== rowsVersion || revision !== rowsRevision) {
-							rowsVersion = version;
-							rowsRevision = revision;
-							rows = ctx.slots.entries("settings.section").map((e) => ({
-								/* v8 ignore next -- list-slot registration requires id (SlotCore rejects an entry without one) */
-								id: e.options.id ?? "",
-								order: e.options.order ?? 0,
-								label: (0, _deepseek_ai_dsh_client_ui_slots.resolveSlotLabel)(e.options.label) ?? ""
-							})).sort((a, b) => a.order - b.order);
-						}
-						return rows;
-					},
-					subscribe: (listener) => {
-						const offLedger = ctx.slots.subscribe("settings.section", listener);
-						const offLocale = ctx.locale.subscribe(listener);
-						return () => {
-							offLedger();
-							offLocale();
-						};
-					}
+			const shellInjected = () => ({
+				reconnect: () => {
+					connection.reconnect();
 				},
-				onboardingSteps: {
-					getSnapshot: () => {
-						const version = ctx.slots.getVersion("settings.onboarding");
-						if (version !== onboardingVersion) {
-							onboardingVersion = version;
-							onboardingSteps = ctx.slots.entries("settings.onboarding").map((e) => ({
-								/* v8 ignore next -- list-slot registration requires id */
-								id: e.options.id ?? "",
-								order: e.options.order ?? 0
-							})).sort((a, b) => a.order - b.order);
+				hooks: {
+					connectionState: connection.state,
+					sections: {
+						getSnapshot: () => {
+							const version = ctx.slots.getVersion("settings.section");
+							const revision = ctx.locale.getSnapshot().revision;
+							if (version !== rowsVersion || revision !== rowsRevision) {
+								rowsVersion = version;
+								rowsRevision = revision;
+								rows = ctx.slots.entries("settings.section").map((e) => ({
+									/* v8 ignore next -- list-slot registration requires id (SlotCore rejects an entry without one) */
+									id: e.options.id ?? "",
+									order: e.options.order ?? 0,
+									label: (0, _deepseek_ai_dsh_client_ui_slots.resolveSlotLabel)(e.options.label) ?? ""
+								})).sort((a, b) => a.order - b.order);
+							}
+							return rows;
+						},
+						subscribe: (listener) => {
+							const offLedger = ctx.slots.subscribe("settings.section", listener);
+							const offLocale = ctx.locale.subscribe(listener);
+							return () => {
+								offLedger();
+								offLocale();
+							};
 						}
-						return onboardingSteps;
 					},
-					subscribe: (listener) => ctx.slots.subscribe("settings.onboarding", listener)
+					onboardingSteps: {
+						getSnapshot: () => {
+							const version = ctx.slots.getVersion("settings.onboarding");
+							if (version !== onboardingVersion) {
+								onboardingVersion = version;
+								onboardingSteps = ctx.slots.entries("settings.onboarding").map((e) => ({
+									/* v8 ignore next -- list-slot registration requires id */
+									id: e.options.id ?? "",
+									order: e.options.order ?? 0
+								})).sort((a, b) => a.order - b.order);
+							}
+							return onboardingSteps;
+						},
+						subscribe: (listener) => ctx.slots.subscribe("settings.onboarding", listener)
+					}
 				}
-			} });
+			});
 			ctx.slots.inject("sidebar.settings", () => ctx.slots.register({
 				name: "sidebar.settings",
+				locale: NS,
 				children: {
 					"settings.trigger": {
 						kind: "single",