dsh-mobile 0.4.7 → 0.5.1

package/lib/client.js

@@ -513,6 +513,30 @@ window.__ModuleLoader__.load({
 			wsPathsAnnounce: "{n} 条插件连接等待放行",
 			wsPathsAdvancedHint: "通常不需要手动填写：用上方按钮即可。只有当你确切知道所需路径时才填。"
 		});
+		Object.assign(MOBILE_CONTROL_MESSAGES.en, {
+			cpolarDownloadFailed: "Could not download cpolar from its official site. Check this computer’s network or proxy, then retry.",
+			cpolarDownloadTimeout: "The cpolar download timed out. Check this computer’s network or proxy, then retry.",
+			cpolarDownloadHttp: "The official cpolar download returned HTTP {status}. Retry later or check the official download page.",
+			cpolarIntegrityFailed: "The cpolar download did not match the pinned build, so it was not installed. Retry later or update DSH Mobile; do not bypass verification.",
+			cpolarExtractFailed: "The cpolar download completed, but extraction failed. Check system extraction tools and security software, then retry.",
+			cpolarStorageFailed: "Could not write the cpolar component in DSH Mobile’s private directory. Check disk space, permissions, and security software, then retry."
+		});
+		Object.assign(MOBILE_CONTROL_MESSAGES.it, {
+			cpolarDownloadFailed: "Impossibile scaricare cpolar dal sito ufficiale. Controlla rete o proxy del computer e riprova.",
+			cpolarDownloadTimeout: "Download di cpolar scaduto. Controlla rete o proxy del computer e riprova.",
+			cpolarDownloadHttp: "Il download ufficiale di cpolar ha restituito HTTP {status}. Riprova più tardi o controlla la pagina ufficiale.",
+			cpolarIntegrityFailed: "Il pacchetto cpolar non corrisponde alla versione verificata e non è stato installato. Riprova più tardi o aggiorna DSH Mobile; non aggirare la verifica.",
+			cpolarExtractFailed: "Download di cpolar completato, ma estrazione non riuscita. Controlla gli strumenti di estrazione e il software di sicurezza, poi riprova.",
+			cpolarStorageFailed: "Impossibile scrivere cpolar nella directory privata di DSH Mobile. Controlla spazio, permessi e software di sicurezza, poi riprova."
+		});
+		Object.assign(MOBILE_CONTROL_MESSAGES.zh, {
+			cpolarDownloadFailed: "无法从 cpolar 官网下载组件。请检查这台电脑的网络或代理，然后重试。",
+			cpolarDownloadTimeout: "下载 cpolar 组件超时。请检查这台电脑的网络或代理，然后重试。",
+			cpolarDownloadHttp: "cpolar 官网下载返回 HTTP {status}。请稍后重试，或检查官网下载页。",
+			cpolarIntegrityFailed: "下载的 cpolar 组件未通过固定版本校验，因此没有安装。请稍后重试或更新 DSH Mobile，不要跳过校验。",
+			cpolarExtractFailed: "cpolar 下载完成，但解包失败。请检查系统解压组件和安全软件，然后重试。",
+			cpolarStorageFailed: "无法把 cpolar 写入 DSH Mobile 私有目录。请检查磁盘空间、目录权限和安全软件，然后重试。"
+		});
 		Object.assign(MOBILE_CONTROL_MESSAGES.en, {
 			lanSetupTitle: "Finish local network setup",
 			lanSetupIntro: "Choose the network shared by this computer and your phone. DSH Mobile creates private certificates only after you confirm.",
@@ -1402,6 +1426,7 @@ window.__ModuleLoader__.load({
 				"remote-needs-login": ["Tailscale is waiting for login to finish.", "Return to Remote access and continue login."],
 				"remote-connecting": ["The {provider} remote channel is still connecting.", "Wait briefly, then check again."],
 				"remote-controller-error": ["The {provider} controller reported {controllerCode}.", "Return to Remote access and reconnect."],
+				"competing-remote-channel": ["Another remote plugin is injecting its own request channel; the phone may show that plugin’s pairing screen.", "Turn off dsh-remote-web-ui remote access on the computer, refresh, and pair using the current DSH Mobile QR code. Do not mix pairing codes."],
 				"phone-network-unknown": ["The computer cannot determine whether the router isolates the phone.", "Confirm the phone and computer use the same network, then disable guest-network or AP isolation."]
 			},
 			it: {
@@ -1426,6 +1451,7 @@ window.__ModuleLoader__.load({
 				"remote-needs-login": ["Tailscale attende il completamento dell’accesso.", "Torna ad Accesso remoto e continua l’accesso."],
 				"remote-connecting": ["Il canale remoto {provider} è ancora in connessione.", "Attendi qualche istante e ripeti il controllo."],
 				"remote-controller-error": ["Il controller {provider} ha segnalato {controllerCode}.", "Torna ad Accesso remoto e riconnettiti."],
+				"competing-remote-channel": ["Un altro plugin remoto sta inserendo il proprio canale di richieste; sul telefono potrebbe apparire la sua schermata di abbinamento.", "Disattiva l’accesso remoto di dsh-remote-web-ui sul computer, aggiorna la pagina e usa il codice QR corrente di DSH Mobile. Non mescolare i codici."],
 				"phone-network-unknown": ["Il computer non può stabilire se il router isola il telefono.", "Verifica che telefono e computer usino la stessa rete, poi disattiva rete ospiti o isolamento AP."]
 			},
 			zh: {
@@ -1450,6 +1476,7 @@ window.__ModuleLoader__.load({
 				"remote-needs-login": ["Tailscale 正在等待完成登录。", "返回远程访问并继续登录。"],
 				"remote-connecting": ["{provider} 远程通道仍在连接。", "等待片刻后重新检查。"],
 				"remote-controller-error": ["{provider} 控制器报告 {controllerCode}。", "返回远程访问并重新连接。"],
+				"competing-remote-channel": ["检测到另一个远程插件注入自己的请求通道；手机可能显示它的配对页面。", "在电脑端关闭 dsh-remote-web-ui 的远程访问并刷新，再用 DSH Mobile 当前二维码配对；不要混用配对码。"],
 				"phone-network-unknown": ["电脑无法判断路由器是否隔离了手机。", "确认手机与电脑使用同一网络，并关闭访客网络或 AP 隔离。"]
 			}
 		};
@@ -2599,12 +2626,13 @@ window.__ModuleLoader__.load({
   [data-dsh-mobile-center] { grid-column:2 !important; width:100vw !important; min-width:0 !important; }
   [data-dsh-mobile-center] > * { min-width:0 !important; }
   [data-dsh-mobile-header] { box-sizing:border-box !important; width:calc(100% - 16px) !important; margin:0 8px !important; min-width:0; padding-top:max(4px,env(safe-area-inset-top)) !important; padding-right:8px !important; padding-left:42px !important; }
+  [data-dsh-mobile-header] :is([class*="_titleRow"],[class*="_headerLeading"]) { touch-action:pan-y; }
   [data-dsh-mobile-header] [class*="_titleRow"] { box-sizing:border-box !important; display:flex !important; align-items:center !important; min-width:0; min-height:32px !important; height:32px !important; gap:6px !important; padding:0 6px !important; }
   [data-dsh-mobile-header] [class*="_titleCluster"] { min-width:0; }
   [data-dsh-mobile-header] [class*="_crumbs"] { min-width:0; overflow:hidden; }
   [data-dsh-mobile-header] [class*="_crumb"] { max-width:46vw; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
-  [data-dsh-mobile-header] [class*="_headerActions"] { min-width:0; overflow-x:auto; scrollbar-width:none; }
-  [data-dsh-mobile-header] [class*="_headerActions"]::-webkit-scrollbar { display:none; }
+  /* Nested header actions (including the Jobs menu) must paint outside the row. */
+  [data-dsh-mobile-header] [class*="_headerActions"] { flex:none; min-width:max-content; overflow:visible; }
   [data-dsh-mobile-header] [class*="_headerUtilities"] { gap:2px !important; }
   [data-dsh-mobile-header] [class*="_sessionLogButton"] { width:40px; min-width:40px; padding:0 !important; overflow:hidden; color:transparent; font-size:0 !important; }
   [data-dsh-mobile-header] [class*="_sessionLogButton"] > * { display:none !important; }
@@ -2691,6 +2719,15 @@ window.__ModuleLoader__.load({
   [data-dsh-mobile-center] [data-composer-card] ~ * [class*="_root"] [class*="_sep"] { margin:0 6px !important; }
   /* Composer dock stats strip (turns/steps/tokens) reads small on phones. */
   [data-dsh-mobile-center] [data-slot="conversation.composer.dock"] [class*="_root"] { font-size:10px !important; line-height:16px !important; }
+  /* The context ring is a composer-metadata _root too, so the metadata rule
+     above stretched it across the whole dock. It cannot shrink, which left the
+     session statistics beside it a few pixels wide, every number clipped to an
+     ellipsis. Put the numbers in a wrapping left column and the ring in a right
+     column it cannot grow out of: a phone then shows every number in full, and
+     a wide screen keeps the ring beside them on one line. */
+  [data-dsh-mobile-center] [data-composer-card] ~ * [class*="_root"]:has(> [class*="_trigger"][aria-haspopup="dialog"]) { width:auto !important; max-width:none !important; flex:0 0 auto !important; }
+  [data-dsh-mobile-center] [class*="_dock"]:has([data-composer-stats]) { display:grid !important; grid-template-columns:minmax(0,1fr) max-content !important; align-items:center !important; column-gap:12px !important; }
+  [data-dsh-mobile-center] [data-composer-card] ~ * [class*="_root"][data-composer-stats] { box-sizing:border-box !important; width:auto !important; max-width:none !important; flex:0 1 auto !important; flex-wrap:wrap !important; justify-content:flex-start !important; row-gap:2px !important; }
   /* Message runtime details are inline on desktop. Give the clock/runtime
      label its own wrapping row on narrow screens so TTFT and throughput do
      not push the action buttons or clip at the viewport edge. */
@@ -2739,7 +2776,6 @@ window.__ModuleLoader__.load({
 @keyframes dsh-mobile-panel-in { from { opacity:.72; transform:translateY(6px); } }
 @keyframes dsh-mobile-view-in { from { opacity:.58; transform:translateY(5px); } }
 @media (max-width:420px) {
-  [data-dsh-mobile-header] [class*="_headerActions"] { max-width:42vw; }
   [data-dsh-mobile-settings-options] [data-slot="settings.general.item"] [class*="_selector"] { align-self:stretch !important; width:100% !important; }
   [data-dsh-mobile-message-column] [data-context-fields] > * { grid-template-columns:1fr !important; }
 }
@@ -2756,6 +2792,48 @@ window.__ModuleLoader__.load({
 		function firstByClassSuffix(root, suffix) {
 			return Array.from(root.querySelectorAll("[class]")).find((element) => classToken(element, suffix));
 		}
+		/**
+		* Whether this composer is the landing hero rather than the composer of an open
+		* conversation. DSH marks the hero composer's root with a `_hero` class and drops
+		* it once a session owns the surface, which is the only difference available
+		* without the layout's session id.
+		*/
+		function composerIsLandingHero(composer, depth = 4) {
+			let node = composer;
+			for (let step = 0; step < depth && node !== null; step += 1) {
+				if (classToken(node, "_hero")) return true;
+				node = node.parentElement;
+			}
+			return false;
+		}
+		/** Resolve only identities published by the current conversation or selected session row. */
+		function resolveComposerSessionOrigin(composer, selectedRow, selectedRowToken) {
+			const conversationRoot = composer?.closest("[data-conversation-session]") ?? null;
+			const conversationId = conversationRoot?.getAttribute("data-conversation-session");
+			if (conversationRoot !== null && conversationId) return {
+				sessionRoot: conversationRoot,
+				sessionId: conversationId
+			};
+			const dedicatedRoot = composer?.closest("[data-dsh-mobile-session]") ?? null;
+			const dedicatedId = dedicatedRoot?.getAttribute("data-dsh-mobile-session");
+			if (dedicatedRoot !== null && dedicatedId) return {
+				sessionRoot: dedicatedRoot,
+				sessionId: dedicatedId
+			};
+			if (selectedRow === null) return {
+				sessionRoot: null,
+				sessionId: null
+			};
+			const identity = selectedRow.getAttribute("data-session-id") ?? selectedRow.getAttribute("aria-label") ?? selectedRow.textContent?.trim() ?? "";
+			return {
+				sessionRoot: selectedRow,
+				sessionId: `${selectedRowToken(selectedRow)}:${identity}`
+			};
+		}
+		/** An id-less non-hero composer still accepts App soft-keyboard line breaks, but not camera results. */
+		function activeSessionForSoftEnter(composer, sessionId) {
+			return sessionId !== null || composer !== null && composer.closest(".dshm-main") !== null && !composerIsLandingHero(composer);
+		}
 		/** Find the stock DSH application frame without mistaking a feature card for the shell. */
 		function resolveNativeMobileFrame(root, dedicatedCenter) {
 			if (dedicatedCenter !== void 0) return void 0;
@@ -2782,6 +2860,93 @@ window.__ModuleLoader__.load({
 			return marked;
 		}
 		const AUTO_HISTORY_THRESHOLD_PX = 64;
+		/** Travel, in CSS pixels, that separates a header strip pan from a tap on a chip. */
+		const STRIP_DRAG_THRESHOLD_PX = 8;
+		/** Measure flowing title controls without counting an open absolute-positioned menu. */
+		function measureHeaderStripOverflow(row) {
+			const left = row.getBoundingClientRect().left;
+			const controls = Array.from(row.children);
+			const actions = row.querySelector(":scope > [class*=\"_titleCluster\"] [class*=\"_headerActions\"]");
+			if (actions !== null) controls.push(actions);
+			const right = Math.max(left, ...controls.map((control) => control.getBoundingClientRect().right));
+			return Math.max(0, right - left - row.clientWidth);
+		}
+		/** Touch-only pan state; browser pointer cancellation does not interrupt the touch stream. */
+		function createHeaderStripPanController(options) {
+			let offset = 0;
+			let drag;
+			let suppressUntil = 0;
+			const clamp = (value) => Math.min(Math.max(0, options.range()), Math.max(0, value));
+			const setOffset = (value) => {
+				const next = clamp(value);
+				if (next === offset) return;
+				offset = next;
+				options.render(offset);
+			};
+			const end = () => {
+				if (drag === void 0) return;
+				if (drag.claimed) suppressUntil = options.now() + 400;
+				drag = void 0;
+			};
+			const cancel = () => {
+				if (drag?.claimed) suppressUntil = options.now() + 400;
+				drag = void 0;
+			};
+			return {
+				offset: () => offset,
+				start: (x, y) => {
+					drag = {
+						x,
+						y,
+						offset,
+						claimed: false
+					};
+					suppressUntil = 0;
+				},
+				move: (x, y) => {
+					if (drag === void 0) return false;
+					const travel = x - drag.x;
+					if (!drag.claimed) {
+						const drift = y - drag.y;
+						if (Math.abs(travel) < STRIP_DRAG_THRESHOLD_PX && Math.abs(drift) < STRIP_DRAG_THRESHOLD_PX) return false;
+						if (Math.abs(drift) > Math.abs(travel)) {
+							drag = void 0;
+							return false;
+						}
+						drag.claimed = true;
+					}
+					setOffset(drag.offset - travel);
+					return true;
+				},
+				end,
+				cancel,
+				sync: () => {
+					if (options.range() === 0) {
+						drag = void 0;
+						suppressUntil = 0;
+					}
+					setOffset(offset);
+				},
+				reveal: (left, right, visibleLeft, visibleRight) => {
+					if (left < visibleLeft) setOffset(offset - (visibleLeft - left));
+					else if (right > visibleRight) setOffset(offset + right - visibleRight);
+				},
+				resetClickSuppression: () => {
+					suppressUntil = 0;
+				},
+				suppressClick: (inHeader, detail) => {
+					if (suppressUntil === 0 || detail === 0) return false;
+					const suppress = inHeader && options.now() <= suppressUntil;
+					suppressUntil = 0;
+					return suppress;
+				},
+				dispose: () => {
+					drag = void 0;
+					suppressUntil = 0;
+					setOffset(0);
+				}
+			};
+		}
 		function controlledFileDragEvent(type, files, initialDropEffect) {
 			const event = new Event(type, {
 				bubbles: true,
@@ -2839,6 +3004,38 @@ window.__ModuleLoader__.load({
 		function drawerScrimVisible(sidebarCollapsed, overlayActive) {
 			return !sidebarCollapsed && overlayActive;
 		}
+		/** Let the stock page close one visible layer before Android navigates its WebView. */
+		function installStockMobileBack(view, current, actions) {
+			const onBack = (event) => {
+				if (!event.cancelable || event.defaultPrevented) return;
+				const layers = current();
+				if (layers === null) return;
+				if (layers.detailsOpen) {
+					event.preventDefault();
+					actions.closeDetails();
+				} else if (layers.drawerOpen) {
+					event.preventDefault();
+					actions.closeDrawer();
+				} else if (layers.mainPanelOpen) {
+					event.preventDefault();
+					actions.closeMainPanel();
+				}
+			};
+			view.addEventListener("dsh-mobile:native-back", onBack);
+			return () => {
+				view.removeEventListener("dsh-mobile:native-back", onBack);
+			};
+		}
+		function stockLayoutBackControl(value) {
+			return typeof value === "object" && value !== null ? value : void 0;
+		}
+		/** Whether the stock layout can return from a selected main panel. */
+		function stockMainPanelOpen(value) {
+			const layout = stockLayoutBackControl(value);
+			if (typeof layout?.selectPanel !== "function" || typeof layout.panelInfo?.getSnapshot !== "function") return false;
+			const snapshot = layout.panelInfo.getSnapshot();
+			return typeof snapshot === "object" && snapshot !== null && typeof snapshot.activePanelId === "string";
+		}
 		/** Only a known on-screen keyboard in an active App composer may change Enter into a line break. */
 		function isSoftKeyboardEnterLineBreak(event, context) {
 			if (context.nativeState?.imeVisible !== true || context.nativeState.noHardwareKeyboard !== true || !context.editable || !context.activeSession || context.commandMenuOpen || context.recentlyComposing) return false;
@@ -2886,7 +3083,7 @@ window.__ModuleLoader__.load({
 			return !current.disposed && origin.generation === current.generation && origin.href === current.href && origin.composer !== null && current.composerConnected && origin.composer === current.composer && origin.sessionRoot !== null && origin.sessionRoot === current.sessionRoot && origin.sessionId !== null && origin.sessionId === current.sessionId;
 		}
 		/** Add mobile semantics without replacing feature trees. */
-		function installNativeMobileSurface() {
+		function installNativeMobileSurface(backServices) {
 			document.documentElement.classList.add("dsh-native-mobile-active");
 			const browserLanguages = navigator.languages.length > 0 ? navigator.languages : [navigator.language];
 			const language = resolveNativeMobileLanguage(document.documentElement.lang, browserLanguages);
@@ -2983,27 +3180,15 @@ window.__ModuleLoader__.load({
 			const sessionTokens = /* @__PURE__ */ new WeakMap();
 			let nextSessionToken = 0;
 			const currentSessionOrigin = () => {
-				const dedicatedRoot = boundComposer?.closest("[data-dsh-mobile-session]") ?? null;
-				const dedicatedId = dedicatedRoot?.getAttribute("data-dsh-mobile-session");
-				if (dedicatedRoot !== null && typeof dedicatedId === "string" && dedicatedId !== "") return {
-					sessionRoot: dedicatedRoot,
-					sessionId: dedicatedId
-				};
 				const selectedRow = document.querySelector("[role=\"treeitem\"][aria-selected=\"true\"]");
-				if (selectedRow === null) return {
-					sessionRoot: null,
-					sessionId: null
-				};
-				let token = sessionTokens.get(selectedRow);
-				if (token === void 0) {
-					token = `stock-${String(++nextSessionToken)}`;
-					sessionTokens.set(selectedRow, token);
-				}
-				const identity = selectedRow.getAttribute("data-session-id") ?? selectedRow.getAttribute("aria-label") ?? selectedRow.textContent?.trim() ?? "";
-				return {
-					sessionRoot: selectedRow,
-					sessionId: `${token}:${identity}`
-				};
+				return resolveComposerSessionOrigin(boundComposer, selectedRow, (row) => {
+					let token = sessionTokens.get(row);
+					if (token === void 0) {
+						token = `stock-${String(++nextSessionToken)}`;
+						sessionTokens.set(row, token);
+					}
+					return token;
+				});
 			};
 			const mediaRequestContext = () => {
 				const session = currentSessionOrigin();
@@ -3180,6 +3365,101 @@ window.__ModuleLoader__.load({
 				if (branch === null || branch.hasAttribute("disabled") || branch.getAttribute("aria-disabled") === "true") return;
 				window.setTimeout(showBranchToast, 80);
 			};
+			let stripHeader;
+			const stripParts = () => {
+				const row = stripHeader?.querySelector("[class*=\"_titleRow\"]");
+				if (row === void 0 || row === null) return void 0;
+				return {
+					row,
+					lead: stripHeader?.querySelector("[class*=\"_headerLeading\"]") ?? void 0
+				};
+			};
+			const stripRange = () => {
+				const parts = stripParts();
+				if (!overlayQuery.matches || parts === void 0) return 0;
+				const overflow = measureHeaderStripOverflow(parts.row);
+				return overflow > 1 ? overflow : 0;
+			};
+			const applyStrip = (offset) => {
+				const parts = stripParts();
+				if (parts === void 0) return;
+				const value = offset === 0 ? "" : `translateX(${-offset}px)`;
+				if (parts.row.style.transform !== value) parts.row.style.transform = value;
+				if (parts.lead !== void 0 && parts.lead.style.transform !== value) parts.lead.style.transform = value;
+			};
+			const pan = createHeaderStripPanController({
+				range: stripRange,
+				render: applyStrip,
+				now: () => performance.now()
+			});
+			const syncPanHeader = (header) => {
+				if (header !== stripHeader) {
+					pan.dispose();
+					stripHeader = header;
+				}
+				pan.sync();
+				applyStrip(pan.offset());
+			};
+			let activeTouchId;
+			const onStripTouchStart = (event) => {
+				if (activeTouchId !== void 0) pan.cancel();
+				activeTouchId = void 0;
+				pan.resetClickSuppression();
+				if (event.touches.length !== 1) return;
+				if (!overlayQuery.matches) return;
+				if (!(event.target instanceof Element)) return;
+				if (event.target.closest("[data-dsh-mobile-header]") !== stripHeader) return;
+				if (event.target.closest("[data-dsh-mobile-header] [class*=\"_titleRow\"],[data-dsh-mobile-header] [class*=\"_headerLeading\"]") === null) return;
+				if (stripRange() === 0) return;
+				const touch = event.touches[0];
+				if (touch === void 0) return;
+				activeTouchId = touch.identifier;
+				pan.start(touch.clientX, touch.clientY);
+			};
+			const onStripTouchMove = (event) => {
+				if (activeTouchId === void 0) return;
+				if (event.touches.length !== 1) {
+					activeTouchId = void 0;
+					pan.cancel();
+					return;
+				}
+				const touch = event.touches[0];
+				if (touch === void 0 || touch.identifier !== activeTouchId) return;
+				if (pan.move(touch.clientX, touch.clientY)) event.preventDefault();
+			};
+			const onStripTouchEnd = (event) => {
+				if (activeTouchId === void 0 || !Array.from(event.changedTouches).some((touch) => touch.identifier === activeTouchId)) return;
+				activeTouchId = void 0;
+				pan.end();
+			};
+			const onStripTouchCancel = (event) => {
+				if (activeTouchId === void 0 || !Array.from(event.changedTouches).some((touch) => touch.identifier === activeTouchId)) return;
+				activeTouchId = void 0;
+				pan.cancel();
+			};
+			const onStripFocus = (event) => {
+				if (!(event.target instanceof HTMLElement)) return;
+				const header = event.target.closest("[data-dsh-mobile-header]");
+				if (header === null || header !== stripHeader || stripRange() === 0 || event.target.closest("[class*=\"_titleRow\"],[class*=\"_headerLeading\"]") === null) return;
+				const focused = event.target.getBoundingClientRect();
+				const visible = header.getBoundingClientRect();
+				pan.reveal(focused.left, focused.right, visible.left + 42, visible.right - 8);
+			};
+			const onStripClickCapture = (event) => {
+				const inHeader = event.target instanceof Element && event.target.closest("[data-dsh-mobile-header]") !== null;
+				if (!pan.suppressClick(inHeader, event.detail)) return;
+				event.preventDefault();
+				event.stopPropagation();
+			};
+			document.addEventListener("touchstart", onStripTouchStart, true);
+			document.addEventListener("touchmove", onStripTouchMove, {
+				capture: true,
+				passive: false
+			});
+			document.addEventListener("touchend", onStripTouchEnd, true);
+			document.addEventListener("touchcancel", onStripTouchCancel, true);
+			document.addEventListener("focusin", onStripFocus, true);
+			document.addEventListener("click", onStripClickCapture, true);
 			document.addEventListener("click", onBranchClick, true);
 			let frame;
 			let sidebar;
@@ -3254,7 +3534,7 @@ window.__ModuleLoader__.load({
 				disposeEnterBinding = editor === null || composerCard === null ? void 0 : bindComposerSoftEnter(editor, () => ({
 					nativeState: window.__DSH_MOBILE_NATIVE__ === void 0 ? null : window.__DSH_MOBILE_KEYBOARD_STATE__,
 					editable: editor.isConnected && editor.getAttribute("contenteditable") === "true" && editor.getAttribute("aria-disabled") !== "true" && editor.getAttribute("aria-haspopup") !== "menu" && composerCard.getAttribute("aria-busy") !== "true",
-					activeSession: currentSessionOrigin().sessionId !== null,
+					activeSession: activeSessionForSoftEnter(composerCard, currentSessionOrigin().sessionId),
 					commandMenuOpen: composerCard.querySelector("[data-trigger-menu],button[aria-haspopup=\"listbox\"][aria-expanded=\"true\"]") !== null
 				}));
 			};
@@ -3280,6 +3560,7 @@ window.__ModuleLoader__.load({
 				const handle = frame === void 0 ? void 0 : firstByClassSuffix(frame, "_handle");
 				markNativeMobileSettings(document);
 				if (center === void 0) {
+					syncPanHeader(void 0);
 					syncComposerEnterNewline(null);
 					bindHistoryScroller(void 0);
 					syncMediaBinding(null);
@@ -3289,7 +3570,9 @@ window.__ModuleLoader__.load({
 				}
 				if (center !== void 0) {
 					center.dataset.dshMobileCenter = "true";
-					center.querySelector("header")?.setAttribute("data-dsh-mobile-header", "true");
+					const header = center.querySelector("header") ?? void 0;
+					header?.setAttribute("data-dsh-mobile-header", "true");
+					syncPanHeader(header);
 					viewArea = firstByClassSuffix(center, "_viewArea");
 					if (viewArea !== void 0) viewArea.dataset.dshMobileView = "true";
 					const conversation = center.querySelector("[data-conversation-scroll]");
@@ -3400,6 +3683,33 @@ window.__ModuleLoader__.load({
 				if (sidebar?.dataset.open === "true") toggle?.click();
 			});
 			sync();
+			const stopStockBack = installStockMobileBack(window, () => {
+				if (frame?.isConnected !== true) return null;
+				const lastColumn = frame.style.gridTemplateColumns.trim().split(/\s+/).at(-1);
+				return {
+					detailsOpen: overlayQuery.matches && lastColumn !== void 0 && lastColumn !== "" && lastColumn !== "0px" && lastColumn !== "0",
+					drawerOpen: overlayQuery.matches && sidebarRoot?.isConnected === true && toggle?.isConnected === true && !classToken(sidebarRoot, "_collapsed"),
+					mainPanelOpen: stockMainPanelOpen(backServices.getLayout())
+				};
+			}, {
+				closeDetails: () => {
+					const layout = stockLayoutBackControl(backServices.getLayout());
+					if (typeof layout?.closeRightbar !== "function") return;
+					const sidebarRight = backServices.getSidebarRight();
+					if (typeof sidebarRight === "object" && sidebarRight !== null) {
+						const control = sidebarRight;
+						if (typeof control.isExpanded === "function" && typeof control.toggleExpanded === "function" && control.isExpanded()) control.toggleExpanded();
+					}
+					layout.closeRightbar();
+				},
+				closeDrawer: () => {
+					toggle?.click();
+				},
+				closeMainPanel: () => {
+					const layout = stockLayoutBackControl(backServices.getLayout());
+					if (typeof layout?.selectPanel === "function") layout.selectPanel(null);
+				}
+			});
 			const disposeTaskWatcher = installTaskCompletionWatcher({
 				completionFallback: false,
 				label: (kind, sessionLabel) => kind === "done" ? {
@@ -3412,6 +3722,7 @@ window.__ModuleLoader__.load({
 			});
 			return () => {
 				disposed = true;
+				stopStockBack();
 				disposeTaskWatcher();
 				mediaRequestGeneration += 1;
 				mediaPickerAbortController.abort();
@@ -3421,6 +3732,14 @@ window.__ModuleLoader__.load({
 				observer.disconnect();
 				overlayQuery.removeEventListener("change", schedule);
 				document.removeEventListener("click", onBranchClick, true);
+				document.removeEventListener("touchstart", onStripTouchStart, true);
+				document.removeEventListener("touchmove", onStripTouchMove, true);
+				document.removeEventListener("touchend", onStripTouchEnd, true);
+				document.removeEventListener("touchcancel", onStripTouchCancel, true);
+				document.removeEventListener("focusin", onStripFocus, true);
+				document.removeEventListener("click", onStripClickCapture, true);
+				pan.dispose();
+				applyStrip(0);
 				cameraButton.removeEventListener("pointerdown", quietMediaPointer);
 				cameraButton.removeEventListener("click", takePhoto);
 				if (branchToastTimer !== 0) window.clearTimeout(branchToastTimer);
@@ -3445,6 +3764,16 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/local-admin-host.ts
 		/** Browser-safe desktop-admin Host checks. Do not import Node APIs here. */
+		const DESKTOP_ADMIN_HEADER = "x-dsh-mobile-desktop-admin";
+		const DESKTOP_ADMIN_MARKER = "dsh-app://app";
+		/** Add the forwarded Desktop marker only to this plugin's mutating admin requests. */
+		function localAdminRequestHeaders(init, location) {
+			const headers = new Headers(init?.headers);
+			if (!headers.has("content-type")) headers.set("content-type", "application/json");
+			headers.delete(DESKTOP_ADMIN_HEADER);
+			if (init?.method?.toUpperCase() === "POST" && location.protocol === "dsh-app:" && location.hostname === "app") headers.set(DESKTOP_ADMIN_HEADER, DESKTOP_ADMIN_MARKER);
+			return headers;
+		}
 		function unwrapBrackets(hostname) {
 			return hostname.startsWith("[") && hostname.endsWith("]") ? hostname.slice(1, -1) : hostname;
 		}
@@ -3485,11 +3814,12 @@ window.__ModuleLoader__.load({
 		/**
 		* Whether the current browser document should mount the desktop Mobile access
 		* control. Dedicated Mobile HTTPS (the phone surface) stays native even when
-		* the Host is a private LAN address.
+		* the Host is a private LAN address. DSH Desktop (dsh-app://app) has neither,
+		* so its protocol gated on the fixed hostname "app" counts too.
 		*/
-		function isDesktopAdminSurface(hostname, search = "", frontend) {
+		function isDesktopAdminSurface(hostname, search = "", frontend, protocol = "") {
 			const query = search.startsWith("?") ? search.slice(1) : search;
-			return isLocalAdminHostname(hostname) && frontend !== "dedicated" && !new URLSearchParams(query).has("dsh-mobile-preview");
+			return (protocol === "dsh-app:" ? hostname === "app" : (protocol === "" || protocol === "http:" || protocol === "https:") && isLocalAdminHostname(hostname)) && frontend !== "dedicated" && !new URLSearchParams(query).has("dsh-mobile-preview");
 		}
 		//#endregion
 		//#region src/client.ts
@@ -3497,6 +3827,64 @@ window.__ModuleLoader__.load({
 		function parseMobileRemoteProvider(value) {
 			return value === "cpolar" || value === "cloudflared" || value === "frp" || value === "origin" ? value : "tailscale";
 		}
+		/**
+		* Set a surface's visibility; opening a page or overlay brings it to the front.
+		* @param container - the registered surface element.
+		* @param open - whether to show it.
+		*/
+		function setMobileSurfaceOpen(container, open) {
+			container.hidden = !open;
+			if (open && container.isConnected && (container.dataset.dshMobileSurfacePlacement === "page" || container.dataset.dshMobileSurfacePlacement === "overlay")) container.parentElement?.append(container);
+		}
+		function visibleBackLayer(view, element) {
+			if (!element.isConnected || element.hidden || element.closest("[hidden],[inert],[aria-hidden=\"true\"]") !== null) return false;
+			const style = view.getComputedStyle(element);
+			return style.display !== "none" && style.visibility !== "hidden" && element.getClientRects().length > 0;
+		}
+		/**
+		* Consume page-level surfaces and dismissible DSH overlays before layout navigation.
+		* @param view - the page window receiving the native Back request.
+		* @param page - the current DSH document.
+		* @param blocked - feedback for a foreground layer without a safe close action.
+		* @returns a disposer for the capture listener.
+		*/
+		function installMobileNativeBack(view, page, blocked) {
+			const onBack = (event) => {
+				if (!event.cancelable || event.defaultPrevented) return;
+				const claim = () => {
+					event.preventDefault();
+					event.stopImmediatePropagation();
+				};
+				const surface = [...page.querySelectorAll("[data-dsh-mobile-surface-placement=\"page\"], [data-dsh-mobile-surface-placement=\"overlay\"]")].filter((element) => visibleBackLayer(view, element)).at(-1);
+				if (surface !== void 0) {
+					setMobileSurfaceOpen(surface, false);
+					claim();
+					return;
+				}
+				const layers = [...page.querySelectorAll("[role=\"dialog\"][aria-modal=\"true\"], [role=\"menu\"]")].filter((element) => visibleBackLayer(view, element));
+				const top = layers.at(-1);
+				if (top === void 0) return;
+				claim();
+				if (top.getAttribute("role") === "dialog") {
+					const wrapper = top.parentElement;
+					const mask = wrapper?.firstElementChild;
+					const maskStyle = mask === void 0 || mask === null ? void 0 : view.getComputedStyle(mask);
+					if (wrapper?.getAttribute("role") === "presentation" && wrapper.children.length === 2 && wrapper.lastElementChild === top && mask?.tagName === "DIV" && mask.getAttribute("aria-hidden") === "true" && mask.isConnected && !mask.hidden && maskStyle?.display !== "none" && maskStyle?.visibility !== "hidden" && mask.getClientRects().length > 0) {
+						mask.click();
+						return;
+					}
+				} else if (top.getAttribute("data-menu-material") === "translucent" && layers.filter((layer) => layer.getAttribute("role") === "menu").length === 1) {
+					page.dispatchEvent(new Event("pointerdown", { bubbles: true }));
+					return;
+				}
+				blocked();
+			};
+			const capture = { capture: true };
+			view.addEventListener("dsh-mobile:native-back", onBack, capture);
+			return () => {
+				view.removeEventListener("dsh-mobile:native-back", onBack, capture);
+			};
+		}
 		const queuedDefinitions = [];
 		let queuedLegacyMount;
 		if (typeof window !== "undefined" && window.dshMobile === void 0) window.dshMobile = {
@@ -3517,6 +3905,18 @@ window.__ModuleLoader__.load({
 		function selectedMobileControlLocale() {
 			return selectMobileControlLocale(document.documentElement.lang, navigator.languages?.length ? navigator.languages : [navigator.language]);
 		}
+		/**
+		* Guidance when an open third-party layer has no safe close action.
+		* @param locale - current Mobile UI language.
+		* @returns localized guidance.
+		*/
+		function mobileBackBlockedMessage(locale) {
+			return {
+				en: "Close the open panel first.",
+				it: "Chiudi prima il pannello aperto.",
+				zh: "请先关闭当前弹层。"
+			}[locale];
+		}
 		/** Remount one plugin-owned surface when DSH changes the document language. */
 		function installDshLanguageBoundSurface(install) {
 			let locale = selectedMobileControlLocale();
@@ -3810,10 +4210,7 @@ window.__ModuleLoader__.load({
 				const response = await fetch(path, {
 					...init,
 					signal: controller.signal,
-					headers: {
-						"content-type": "application/json",
-						...init?.headers
-					}
+					headers: localAdminRequestHeaders(init, location)
 				});
 				const body = await response.json();
 				if (!response.ok) throw new Error(typeof body.error === "string" ? body.error : `HTTP ${String(response.status)}`);
@@ -3913,6 +4310,18 @@ window.__ModuleLoader__.load({
 			control_channel_failed: "controlChannelFailed",
 			cpolar_component_missing: "cpolarMissing",
 			cpolar_component_invalid: "cpolarInvalid",
+			cpolar_download_failed: "cpolarDownloadFailed",
+			cpolar_download_timeout: "cpolarDownloadTimeout",
+			cpolar_download_size_mismatch: "cpolarIntegrityFailed",
+			cpolar_download_hash_mismatch: "cpolarIntegrityFailed",
+			cpolar_executable_hash_mismatch: "cpolarIntegrityFailed",
+			cpolar_download_redirect_missing: "cpolarDownloadFailed",
+			cpolar_download_redirect_invalid: "cpolarDownloadFailed",
+			cpolar_download_redirect_rejected: "cpolarDownloadFailed",
+			cpolar_installer_missing: "cpolarExtractFailed",
+			cpolar_executable_missing: "cpolarExtractFailed",
+			cpolar_extract_failed: "cpolarExtractFailed",
+			cpolar_storage_failed: "cpolarStorageFailed",
 			cpolar_config_missing: "cpolarConfigMissing",
 			cpolar_config_invalid: "cpolarConfigInvalid",
 			cpolar_port_unavailable: "cpolarPortUnavailable",
@@ -4048,6 +4457,8 @@ window.__ModuleLoader__.load({
 			*/
 			const remoteFailureTextFor = (error, fallbackKey) => {
 				const message = error instanceof Error ? error.message : String(error);
+				const cpolarHttpStatus = /^cpolar_download_http_(\d{3})$/u.exec(message)?.[1];
+				if (cpolarHttpStatus !== void 0) return t("cpolarDownloadHttp", { status: cpolarHttpStatus });
 				const key = REMOTE_ERROR_MESSAGE_KEYS[message];
 				return key === void 0 ? t(fallbackKey, { error: message }) : t(key);
 			};
@@ -7629,6 +8040,9 @@ window.__ModuleLoader__.load({
 				shellLayer().append(node);
 				window.setTimeout(() => node.remove(), 2600);
 			};
+			const stopNativeBack = installMobileNativeBack(window, document, () => {
+				toast(mobileBackBlockedMessage(selectedMobileControlLocale()));
+			});
 			const materializeNativeFile = (value) => {
 				if (typeof value !== "object" || value === null || !("base64" in value) || !("name" in value)) return value;
 				const candidate = value;
@@ -7761,6 +8175,7 @@ window.__ModuleLoader__.load({
 					return registerUniqueDisposable(surfaces, surfaceIds, surface.id, () => {
 						const container = element("section");
 						container.dataset.dshMobileSurface = surface.id;
+						container.dataset.dshMobileSurfacePlacement = surface.placement;
 						container.hidden = surface.placement === "page" || surface.placement === "overlay";
 						container.style.cssText = surface.placement === "page" || surface.placement === "overlay" ? "position:absolute;inset:0;overflow:auto;background:var(--dsw-alias-bg-layer-1,#fff);padding:16px;pointer-events:auto" : "pointer-events:auto";
 						const host = () => surface.placement === "page" || surface.placement === "overlay" ? shellLayer() : surfaceHost(surface.placement) ?? shellLayer();
@@ -7813,12 +8228,12 @@ window.__ModuleLoader__.load({
 						open: (surfaceId) => {
 							ensureCurrent();
 							const entry = surfaces.get(surfaceId);
-							if (entry !== void 0) entry.container.hidden = false;
+							if (entry !== void 0) setMobileSurfaceOpen(entry.container, true);
 						},
 						close: (surfaceId) => {
 							ensureCurrent();
 							const entry = surfaces.get(surfaceId);
-							if (entry !== void 0) entry.container.hidden = true;
+							if (entry !== void 0) setMobileSurfaceOpen(entry.container, false);
 						},
 						toast: (message) => {
 							ensureCurrent();
@@ -8190,6 +8605,7 @@ window.__ModuleLoader__.load({
 			});
 			return () => {
 				disposed = true;
+				stopNativeBack();
 				stopEvents();
 				stopRefresh();
 				started = false;
@@ -8286,7 +8702,7 @@ window.__ModuleLoader__.load({
 				return trustAuthenticatedGatewayConnection(ctx.get("connection"));
 			}, "dsh-mobile: authenticated gateway client trust");
 			ctx.effect(() => {
-				const desktopAdmin = isDesktopAdminSurface(location.hostname, location.search, window.__DSH_MOBILE_FRONTEND__);
+				const desktopAdmin = isDesktopAdminSurface(location.hostname, location.search, window.__DSH_MOBILE_FRONTEND__, location.protocol);
 				const style = element("style");
 				style.dataset.plugin = "dsh-mobile";
 				style.textContent = desktopAdmin ? CONTROL_STYLES : NATIVE_MOBILE_STYLES;
@@ -8309,7 +8725,10 @@ window.__ModuleLoader__.load({
 						};
 					});
 					const removeCustom = installCustomAssets();
-					const removeSurface = installDshLanguageBoundSurface(installNativeMobileSurface);
+					const removeSurface = installDshLanguageBoundSurface(() => installNativeMobileSurface({
+						getLayout: () => ctx.get("layout"),
+						getSidebarRight: () => ctx.get("sidebarRight")
+					}));
 					return () => {
 						removeSettingsAction();
 						removeCustom();
@@ -8392,6 +8811,8 @@ window.__ModuleLoader__.load({
 		exports.handleMissingExtensionManifest = handleMissingExtensionManifest;
 		exports.inject = inject;
 		exports.installDshLanguageBoundSurface = installDshLanguageBoundSurface;
+		exports.installMobileNativeBack = installMobileNativeBack;
+		exports.mobileBackBlockedMessage = mobileBackBlockedMessage;
 		exports.normalizeDiagnosticOverall = normalizeDiagnosticOverall;
 		exports.normalizeDiagnosticStatus = normalizeDiagnosticStatus;
 		exports.parseMobileExtensionManifest = parseMobileExtensionManifest;
@@ -8402,6 +8823,7 @@ window.__ModuleLoader__.load({
 		exports.renderDiagnosticPayloadSafely = renderDiagnosticPayloadSafely;
 		exports.selectMobileControlLocale = selectMobileControlLocale;
 		exports.selectedMobileControlLocale = selectedMobileControlLocale;
+		exports.setMobileSurfaceOpen = setMobileSurfaceOpen;
 		exports.startExtensionChangeStream = startExtensionChangeStream;
 		exports.startLifecycleRefreshScheduler = startLifecycleRefreshScheduler;
 		exports.trustAuthenticatedGatewayConnection = trustAuthenticatedGatewayConnection;