dsh-zen-remote 1.1.7 → 1.1.9

package/AGENTS.md

@@ -57,3 +57,23 @@ pnpm test      # 网关 node:test 用例 + 三个界面自检脚本 + 文档版
 - **`lib/` 是产物，不手改**：改 `src/` → `pnpm build` → 提交 `lib/`。
 - **桌面必须 no-op**：≥1024px 逐像素与未安装时一致。
   是从真机事故里攒出来的，改相关代码前先读。
+- **要藏宿主刚渲染出来的东西，别用 `requestAnimationFrame`**：React 在该帧的
+  rAF 阶段之后才提交 DOM，所以从 mutation 里排的 rAF 落在**下一帧**——中间那
+  一帧已经画到屏幕上，用户就看见闪。两个月内三次「晚一帧」的 bug（2026-08-18
+  回复要等回合结束才出现、08-22 工具调用行先显后折、08-25 issue #3 流式抖动）
+  都是这个根子。两条出路：能用选择器表达的交给样式表（`turn-fold.css.ts` 的
+  `BORN_FOLDED`，读宿主自己的 `data-chat-flow-kind` / `data-variant`，React
+  插入节点的同一次提交里就带着，第一帧就是隐藏的）；表达不了的放进
+  MutationObserver 回调里同步做（`turn-fold.ts` 的 `markWholeRows`）——回调是
+  微任务，跑在这一帧渲染更新之前，两个方向都不会晚。rAF 只留给能容忍晚一帧的
+  活（全量重扫、插 chip、改文案）。
+- **别用 `:has()` 写死宿主的 DOM 层数**：包裹层数不等于组件源码看上去的层数
+  ——槽位会额外套一层（真实是 `flowItem > seat > AssistantMarkdown root >
+  body > 块`，比组件自身结构多一层）。深度猜错的选择器**静默失效**：测试全绿、
+  控制台干净，只有拿真界面量才看得出来。需要结构判断就用 JS 遍历
+  （`foldsWholeRow` 那种沿父节点上溯的写法），不假设层数。
+- **改了界面就去真界面上量**：`turn-fold` 这类规则用自建的静态页面验证会给出
+  假阳性（合成 DOM 猜不对宿主的包裹层）。打开 `127.0.0.1:3080` 读现有会话的
+  `getComputedStyle` 即可，**不要为了验证去建会话或发消息**（耗真实 token，见
+  工作区 AGENTS.md 的硬约束）。注意浏览器标签在后台时 rAF 不触发，chip 会是 0
+  个——那是观测假象，不是回归，截图把窗口唤到前台再看。

package/README.md

@@ -3,7 +3,7 @@
 
 <p align="center">
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-0B7285?style=flat-square" alt="MIT"></a>
-<img src="https://img.shields.io/badge/release-v1.1.7-5B4CF0?style=flat-square" alt="v1.1.7">
+<img src="https://img.shields.io/badge/release-v1.1.9-5B4CF0?style=flat-square" alt="v1.1.9">
 <img src="https://img.shields.io/badge/DSH-Web%20Profile-5B4CF0?style=flat-square" alt="DSH Web Profile">
 </p>
 
@@ -39,7 +39,7 @@ dsh plugin add dsh-zen-remote
 ```jsonc
 {
   "dependencies": {
-    "dsh-zen-remote": "^1.1.7"        // 本地开发换成 "link:/path/to/dsh-zen-remote"
+    "dsh-zen-remote": "^1.1.9"        // 本地开发换成 "link:/path/to/dsh-zen-remote"
   },
   "dsh": { "profile": { "bundles": [
     "@deepseek-ai/dsh-base",

package/docs/interface.md

@@ -239,13 +239,12 @@ composer 最左的回形针打开的是**手机本地**的文件选择器（iOS
 
 ## 兼容插件
 
-- [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)(移动端全宽抽屉,本插件在会话页头部给它留入口位)——本机实测 **0.15.0**
+- [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)(移动端全宽抽屉,本插件在会话页头部给它留入口位;手机上文件树里点 @ 引用后代点开关自动收起面板——面板全屏盖住会话页,草稿变化看不见,收起本身就是点击反馈)——本机实测 **0.15.0**
 - [@nanmicoder/dsh-agent-teams](https://github.com/NanmiCoder/dsh-agent-teams)(AgentTeams 活动浮层:手机端挪到会话头部下方、避开安全区,会话列表页隐藏;子代理会话头部保留可点的父会话面包屑用于切回)——本机实测 **0.1.9**
 - [@ychris12138/dsh-usage-stats](https://github.com/Ychris12138/dsh-usage-stats)(用量与余额,主屏 chips 行可直接打开;旧包名 `dsh-usage-stats` 已废弃,两个名字同时留在 profile 里会因重复的 `usage-stats` 行让 DSH 起不来)——本机实测 **0.2.9**
 - [@opendsh/dsh-plugin-scheduled-tasks](https://github.com/Ceelog/dsh-plugins)(定时任务,主屏 chips 行自动收割入口)——本机实测 **0.2.3**
 - dsh-at-file(@文件引用;它和本插件的附件 chip 读的是同一份草稿 token,手机端会为一个上传文件同时画出缩略图和文件名两条,故隐藏它 `.dsh-uploads/` 下那几行,其余 @ 引用不动;桌面端不隐藏——那边本插件的 chip 是关掉的,它是唯一的呈现)——本机实测 **0.6.7**
 - [@ace-zone/dsh-market](https://www.npmjs.com/package/@ace-zone/dsh-market)(插件市场;它的弹窗顶栏在手机上放不下,关闭的 × 被挤出面板外,故隐藏标语/版本号/官网链接三个装饰位并让标题省略号收缩,语言切换和 × 保留;认插件自己渲染的 `.dshm-ver[title="@ace-zone/dsh-market"]` 版本片,同名的其他"市场"插件不会被误伤)——本机实测 **0.1.66**
-- [dsh-vision-toolkit](https://www.npmjs.com/package/@anionex/dsh-vision-toolkit)(图像 Q&A/OCR,配合手机端附件上传使用)
 - [dsh-web-ui 全家桶](https://www.npmjs.com/package/@linxin666/dsh-web-ui-all)(文件树 / 预览 / 任务看板 / SSH / 宠物 / 会话统计 / 远程配对 / 设置)——沿用上游兼容规则,本次未扩展
 
 ## 安装

package/lib/client.js

@@ -885,6 +885,99 @@ const session_dot_ts_1 = require("./session-dot.js");
 const MobileHomeChips_tsx_1 = require("./MobileHomeChips.js");
 /** Phone breakpoint: below the tablet range, where the app-shell layout applies. */
 const PHONE_QUERY = '(max-width: 767px)';
+/** Swipe geometry: reveal width of the archive action / settle threshold. */
+const SWIPE_REVEAL = 88;
+const SWIPE_SETTLE = 44;
+/**
+ * Direction-lock slop: total displacement before the gesture commits to
+ * horizontal (card drag) or vertical (native scroll) — decided ONCE per
+ * touch, the way native swipe rows do it. Before the lock nothing moves.
+ */
+const SWIPE_SLOP = 10;
+/** Horizontal wins only when clearly flatter than ~35° (|dx| > 1.4·|dy|). */
+const SWIPE_SLOPE = 1.4;
+/**
+ * One session row with swipe-left-to-archive (user request, 2026-08-25;
+ * interaction redone after real-device feedback the same day).
+ *
+ * Native-pattern mechanics:
+ * - **One-shot direction lock.** The first ~10px of displacement decides the
+ *   whole gesture: clearly-flat movement (|dx| > 1.4·|dy|) locks to the card
+ *   drag, anything else locks to native vertical scroll and the card never
+ *   moves again for that touch. The first version re-judged every move
+ *   sample, so a curvy upward scroll could flip mid-gesture into a drag.
+ * - **Progressive reveal, iOS-mail style.** The wrapper clips (overflow:
+ *   hidden) and the archive button is PARKED past the right edge, sliding in
+ *   lock-step with the card (button shift = reveal + card shift). Nothing is
+ *   pre-painted under the card, so a 1px drag shows a 1px slice of button
+ *   edge — not a fully drawn button popping through a gap.
+ * - At most one row open at a time (parent owns `open`); tapping an open or
+ *   mid-drag card closes it instead of navigating.
+ *
+ * Touch-only by design — the list only exists on the phone breakpoint.
+ */
+function SwipeRow({ open, onOpenChange, onArchive, archiveLabel, children }) {
+    const start = (0, react_1.useRef)(null);
+    const lock = (0, react_1.useRef)(null);
+    const [drag, setDrag] = (0, react_1.useState)(null);
+    // Ref mirror of `drag`: touchend must read the LATEST position even when
+    // the browser delivers move+end in one task (coalesced touch events) —
+    // the state value in this render's closure can be a frame stale.
+    const dragRef = (0, react_1.useRef)(null);
+    const moveTo = (value) => {
+        dragRef.current = value;
+        setDrag(value);
+    };
+    const base = open ? -SWIPE_REVEAL : 0;
+    const shift = drag ?? base;
+    const dragging = drag !== null;
+    const onTouchStart = (e) => {
+        const t = e.touches[0];
+        if (t === undefined)
+            return;
+        start.current = { x: t.clientX, y: t.clientY };
+        lock.current = null;
+    };
+    const onTouchMove = (e) => {
+        const s = start.current;
+        const t = e.touches[0];
+        if (s === null || t === undefined)
+            return;
+        const dx = t.clientX - s.x;
+        const dy = t.clientY - s.y;
+        if (lock.current === null) {
+            if (Math.hypot(dx, dy) < SWIPE_SLOP)
+                return;
+            lock.current = Math.abs(dx) > SWIPE_SLOPE * Math.abs(dy) ? 'h' : 'v';
+            if (lock.current === 'v')
+                return;
+            // Re-anchor so the card starts moving from here, not with a 10px jump.
+            start.current = { x: t.clientX, y: t.clientY };
+            return;
+        }
+        if (lock.current === 'v')
+            return;
+        moveTo(Math.max(-SWIPE_REVEAL, Math.min(0, base + dx)));
+    };
+    const onTouchEnd = () => {
+        start.current = null;
+        if (lock.current !== 'h')
+            return;
+        const settled = (dragRef.current ?? base) < -SWIPE_SETTLE;
+        moveTo(null);
+        onOpenChange(settled);
+    };
+    const guardClick = (navigate) => {
+        // A tap on an open (or mid-drag) card closes it; navigation needs a
+        // second, clean tap. Matches every list app's swipe convention.
+        if (open || lock.current === 'h')
+            onOpenChange(false);
+        else
+            navigate();
+    };
+    const motion = dragging ? { transition: 'none' } : {};
+    return ((0, jsx_runtime_1.jsxs)("li", { "data-mobile-nav": "home-swipe", onTouchStart: onTouchStart, onTouchMove: onTouchMove, onTouchEnd: onTouchEnd, onTouchCancel: onTouchEnd, children: [(0, jsx_runtime_1.jsx)("button", { type: "button", "data-mobile-nav": "home-archive", tabIndex: open ? 0 : -1, "aria-hidden": !open, style: { transform: `translateX(${SWIPE_REVEAL + shift}px)`, ...motion }, onClick: onArchive, children: archiveLabel }), (0, jsx_runtime_1.jsx)("div", { "data-mobile-nav": "home-swipe-card", style: { transform: `translateX(${shift}px)`, ...motion }, children: children(guardClick) })] }));
+}
 /** Live matchMedia hook for the phone breakpoint. */
 function usePhone() {
     const [phone, setPhone] = (0, react_1.useState)(() => window.matchMedia(PHONE_QUERY).matches);
@@ -959,7 +1052,7 @@ function statusLine(row, dot, t) {
  * all navigation from the injected official actions; nothing here reads the
  * official DOM.
  */
-function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession, startSession, downloadSessionLog, t, }) {
+function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession, startSession, downloadSessionLog, archiveSession, t, }) {
     const phone = usePhone();
     const iconHref = useSiteIconHref();
     const [iconBroken, setIconBroken] = (0, react_1.useState)(false);
@@ -970,6 +1063,19 @@ function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession
     const sessions = useSessions((s) => s);
     const workspaces = useWorkspaces((s) => s);
     const [sheet, setSheet] = (0, react_1.useState)(null);
+    /** The one row whose archive action is swiped open (null = none). */
+    const [swipeOpen, setSwipeOpen] = (0, react_1.useState)(null);
+    /** Archive with the same confirm gate the session-info card uses. */
+    const onArchiveRow = (id) => {
+        if (!window.confirm(t('infoArchiveConfirm'))) {
+            setSwipeOpen(null);
+            return;
+        }
+        setSwipeOpen(null);
+        // The store removes the row reactively (archivedSessionIds frame echo);
+        // failures leave the row in place, which is the honest outcome.
+        void archiveSession(id);
+    };
     // Workspace of the current session — the untouched filter default.
     const currentWorkspaceId = (0, react_1.useMemo)(() => {
         const current = sessions.current;
@@ -994,8 +1100,23 @@ function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession
             .filter((row) => !row.blank && row.parentId === undefined && row.origin !== 'subagent')
             .filter((row) => !archived.has(row.id))
             .filter((row) => scope === null || scope.has(row.id))
+            // A session that never completed a single turn is not established yet —
+            // creating one from the FAB and backing out leaves these behind, and
+            // they pile up as basename-titled rows (user report, 2026-08-25). The
+            // host's sessionStats projection rides every list row; `turns` counts
+            // turns with at least one CLOSED step, and cancelled steps count too,
+            // so an interrupted first reply still shows. Keep when: it is the
+            // current session (highlight row), it is running (first reply in
+            // flight), it earned a title, or the projection is absent (no signal —
+            // show rather than silently hide).
+            .filter((row) => {
+            if (row.id === sessions.current || row.running || row.title !== undefined)
+                return true;
+            const stats = row.projectionValues?.sessionStats;
+            return stats?.turns === undefined || stats.turns > 0;
+        })
             .sort((a, b) => b.updatedAt - a.updatedAt);
-    }, [sessions.ids, sessions.byId, workspaces.archivedSessionIds, selectedWorkspace]);
+    }, [sessions.ids, sessions.byId, sessions.current, workspaces.archivedSessionIds, selectedWorkspace]);
     // The session header's back button (session scope) cannot hold this
     // store directly — a handle mounts under exactly one scope, and this one
     // is already root-scoped here (see nav-store.ts) — so it dispatches
@@ -1046,7 +1167,7 @@ function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession
                                 const dot = (0, session_dot_ts_1.dotState)(row);
                                 const status = statusLine(row, dot, t);
                                 const initial = row.displayTitle.trim().charAt(0).toUpperCase();
-                                return ((0, jsx_runtime_1.jsx)("li", { children: (0, jsx_runtime_1.jsxs)("button", { type: "button", "data-mobile-nav": "home-row", "data-current": row.id === sessions.current ? '' : undefined, onClick: () => enter(() => openSession(row.id)), children: [(0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-avatar", "aria-hidden": "true", children: dot !== undefined ? (0, jsx_runtime_1.jsx)(dsh_client_ui_primitives_1.StateDot, { state: dot, size: 10 }) : initial }), (0, jsx_runtime_1.jsxs)("span", { "data-mobile-nav": "home-row-body", children: [(0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-title", children: row.displayTitle }), status !== undefined && ((0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-status", children: status }))] }), (0, jsx_runtime_1.jsx)("time", { "data-mobile-nav": "home-row-time", dateTime: new Date(row.updatedAt).toISOString(), children: relativeTime(row.updatedAt) })] }) }, row.id));
+                                return ((0, jsx_runtime_1.jsx)(SwipeRow, { open: swipeOpen === row.id, onOpenChange: (open) => setSwipeOpen(open ? row.id : null), onArchive: () => onArchiveRow(row.id), archiveLabel: t('infoArchive'), children: (guardClick) => ((0, jsx_runtime_1.jsxs)("button", { type: "button", "data-mobile-nav": "home-row", "data-current": row.id === sessions.current ? '' : undefined, onClick: () => guardClick(() => enter(() => openSession(row.id))), children: [(0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-avatar", "aria-hidden": "true", children: dot !== undefined ? (0, jsx_runtime_1.jsx)(dsh_client_ui_primitives_1.StateDot, { state: dot, size: 10 }) : initial }), (0, jsx_runtime_1.jsxs)("span", { "data-mobile-nav": "home-row-body", children: [(0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-title", children: row.displayTitle }), status !== undefined && ((0, jsx_runtime_1.jsx)("span", { "data-mobile-nav": "home-row-status", children: status }))] }), (0, jsx_runtime_1.jsx)("time", { "data-mobile-nav": "home-row-time", dateTime: new Date(row.updatedAt).toISOString(), children: relativeTime(row.updatedAt) })] })) }, row.id));
                             }), rows.length === 0 && (0, jsx_runtime_1.jsx)("li", { "data-mobile-nav": "home-empty", children: t('noSessions') })] }), (0, jsx_runtime_1.jsxs)("button", { type: "button", "data-mobile-nav": "home-fab", "aria-label": t('newSession'), title: t('newSession'), onClick: () => enter(() => startSession(selectedWorkspace?.workspaceId)), children: [(0, jsx_runtime_1.jsx)(dsh_client_ui_primitives_1.IconPlusOutline16, { size: 18 }), (0, jsx_runtime_1.jsx)("span", { children: t('newSession') })] }), sheet !== null && ((0, jsx_runtime_1.jsxs)("div", { "data-mobile-nav": "home-sheet-layer", children: [(0, jsx_runtime_1.jsx)("div", { "data-mobile-nav": "home-sheet-mask", role: "button", tabIndex: -1, "aria-label": t('close'), onClick: () => setSheet(null) }), (0, jsx_runtime_1.jsxs)("div", { "data-mobile-nav": "home-sheet", role: sheet === 'filter' ? 'menu' : undefined, children: [sheet === 'filter' && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("div", { "data-mobile-nav": "home-sheet-title", children: t('switchWorkspace') }), (0, jsx_runtime_1.jsx)("button", { type: "button", role: "menuitem", "data-mobile-nav": "home-sheet-item", "data-selected": selected === 'all' ? '' : undefined, onClick: () => {
                                                     actions.filter('all');
                                                     setSheet(null);
@@ -3293,6 +3414,59 @@ exports.COMPAT_CSS = `  /* ---------- dsh-web-ui family compatibility ----------
       padding: 6px 12px !important;
     }
   }
+
+  /* ---------- dsh-auto-approve compatibility ----------
+     The composer.css.ts phone rules collapse the permission trigger to an
+     icon-only pill, but the official permissionGlyphs table only draws
+     icons for read-only / workspace-write — the auto-approve plugin's
+     "auto" preset gets none, so its pill showed a bare chevron. The plugin
+     injects its shield+sparkle svg into the MENU items itself (DOM,
+     content-anchored), but the collapsed TRIGGER re-renders on every
+     preset change, so a CSS pseudo-element is the survives-re-render fix
+     (same reasoning as the old model Sparkle ::before above).
+
+     Presence gates, honestly stated (2026-08-25 review):
+     - Trigger rule: aria-label is t('input.accessMode', {name}) with the
+       raw preset display name embedded untranslated and (zh/en verified)
+       at the END of the string — [aria-label$="Auto"] matches exactly the
+       auto-approve preset being selected, and cannot match a future
+       "Autopilot"-style preset. Plugin absent → the name never renders →
+       inert. This is a DIRECT gate on the plugin's own preset name.
+     - Menu-item rule: INDIRECT gate only. It matches "permission-menu item
+       without an official icon span"; the official three presets all ship
+       icon spans in the menu (verified live), so with the plugin absent
+       nothing matches. Known boundary: another plugin's icon-less preset,
+       or a host redesign dropping icon spans, would wrongly receive this
+       shield. A direct gate is not possible: menu items carry no
+       id/data attributes to anchor on, CSS cannot match text, and gating
+       on the plugin's own JS-injected markers would kill this fallback in
+       exactly the JS-did-not-run case it exists for. Paths are the plugin's own
+     shield outline + four-point sparkle (permission-glyph.ts), stroke
+     shield + filled sparkle, drawn as a currentColor mask. */
+  @media (max-width: 767px) {
+    /* Fallback for the MENU items too (real-phone report 2026-08-25: the
+       plugin's DOM injection did not run in that page instance while this
+       CSS did — bundle load timing differs per plugin). Any permission-menu
+       item WITHOUT the official icon span gets the shield drawn by CSS;
+       today that is exactly the plugin "auto" preset (the official three
+       all ship icons in the menu). Self-coordinating with the plugin's own
+       injection: once its svg lands it arrives inside a cloned icon span,
+       the :not() stops matching, no double icon. */
+    [data-slot="conversation.composer.bar"] [class$="_card"] > [class$="_row"] > [class$="_tools"] > [class$="_modes"] [role="menu"] button[role="menuitem"]:not(:has([class*="_itemIcon_"]))::before,
+    [data-slot="conversation.composer.bar"] [class$="_card"] > [class$="_row"] > [class$="_tools"] > [class$="_modes"] button[class$="_trigger"][aria-label$="Auto"]::before {
+      content: '';
+      width: 16px;
+      height: 16px;
+      flex: none;
+      background: currentColor;
+      -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8.20554 0.899994L14.7901 3.36857V7.01026C14.7901 12 11.0466 14.2103 8.20554 15.3C5.36446 14.2103 1.62012 12 1.62012 7.01026V3.36857L8.20554 0.899994Z' fill='none' stroke='black' stroke-width='1.31831' stroke-linejoin='round'/%3E%3Cpath d='M8.35 5.4C8.35 7.2 7.15 8.4 5.35 8.4C7.15 8.4 8.35 9.6 8.35 11.4C8.35 9.6 9.55 8.4 11.35 8.4C9.55 8.4 8.35 7.2 8.35 5.4Z'/%3E%3C/svg%3E");
+      mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M8.20554 0.899994L14.7901 3.36857V7.01026C14.7901 12 11.0466 14.2103 8.20554 15.3C5.36446 14.2103 1.62012 12 1.62012 7.01026V3.36857L8.20554 0.899994Z' fill='none' stroke='black' stroke-width='1.31831' stroke-linejoin='round'/%3E%3Cpath d='M8.35 5.4C8.35 7.2 7.15 8.4 5.35 8.4C7.15 8.4 8.35 9.6 8.35 11.4C8.35 9.6 9.55 8.4 11.35 8.4C9.55 8.4 8.35 7.2 8.35 5.4Z'/%3E%3C/svg%3E");
+      -webkit-mask-size: contain;
+      mask-size: contain;
+      -webkit-mask-repeat: no-repeat;
+      mask-repeat: no-repeat;
+    }
+  }
 `;
 };
 __modules["styles/misc.css.js"] = function (require, module, exports) {
@@ -3654,6 +3828,70 @@ exports.HOME_CSS = `/* ---------- phone app shell (< 768px) ---------- */
     overscroll-behavior: contain;
     -webkit-overflow-scrolling: touch;
   }
+  /* Swipe-to-archive wrapper (redone 2026-08-25, real-device round): iOS-mail
+     mechanics. The wrapper CLIPS (overflow hidden, same 22px radius as the
+     card) and the archive button is parked past the right edge, sliding in
+     lock-step with the card — a 1px drag reveals a 1px slice, never a
+     fully-drawn button behind a gap. Clipping would eat the card's cast
+     shadow, so the light-theme shadow moves up to this wrapper (identical
+     values; the dark theme's INSET hairline on the card survives clipping
+     untouched). pan-y keeps vertical list scrolling native; the direction
+     lock in MobileHome.tsx decides horizontal-vs-vertical once per touch. */
+  [data-mobile-nav="home-swipe"] {
+    position: relative;
+    overflow: hidden;
+    border-radius: 22px;
+    /* The list is a flex column: without this, an overflowing list SHRINKS
+       every row and the clip above slices the squashed card's bottom edge
+       flat (real-device report, 2026-08-25). Rows keep natural height; the
+       list scrolls. */
+    flex: 0 0 auto;
+    touch-action: pan-y;
+    box-shadow: 0 1px 3px rgba(0, 0, 0, .06), 0 4px 12px rgba(0, 0, 0, .05);
+  }
+  body[data-ds-dark-theme] [data-mobile-nav="home-swipe"] {
+    box-shadow: none;
+  }
+  /* Press = settle toward the page (mirrors the card's own :active swap,
+     which the clip made invisible at wrapper level). */
+  [data-mobile-nav="home-swipe"]:has([data-mobile-nav="home-row"]:active) {
+    box-shadow: 0 1px 2px rgba(0, 0, 0, .05);
+  }
+  body[data-ds-dark-theme] [data-mobile-nav="home-swipe"]:has([data-mobile-nav="home-row"]:active) {
+    box-shadow: none;
+  }
+  [data-mobile-nav="home-swipe-card"] {
+    position: relative;
+    z-index: 1;
+    transition: transform .22s var(--ds-ease-out, ease-out);
+    will-change: transform;
+  }
+  /* Inset pill, not a full-bleed slab (real-device feedback: hard edges).
+     5px breathing room on three sides inside the 88px reveal; its own
+     radius echoes the card family. It still slides in lock-step from past
+     the right edge (transform driven from MobileHome.tsx). */
+  [data-mobile-nav="home-archive"] {
+    position: absolute;
+    z-index: 0;
+    top: 5px;
+    bottom: 5px;
+    right: 5px;
+    width: 78px;
+    border: none;
+    border-radius: 17px;
+    background: var(--dsw-alias-state-error-primary, #d4494c);
+    color: #fff;
+    font-size: 13px;
+    font-weight: 600;
+    cursor: pointer;
+    -webkit-tap-highlight-color: transparent;
+    transition: transform .22s var(--ds-ease-out, ease-out);
+    will-change: transform;
+  }
+  [data-mobile-nav="home-archive"]:active {
+    filter: brightness(.9);
+  }
+
   [data-mobile-nav="home-row"] {
     display: flex;
     align-items: center;
@@ -4502,6 +4740,10 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
     justify-content: flex-start !important;
     gap: 5px !important;
     padding: 2px 8px 8px !important;
+    /* One line, always: the model pill is the only shrinkable item (its
+       label ellipsizes), so wrapping would only ever push the send button
+       to a second row (real-device report, 2026-08-25). */
+    flex-wrap: nowrap !important;
   }
   ${ROW} > [class$="_tools"],
   ${ROW} > [class$="_trailing"] {
@@ -4528,8 +4770,14 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
      the right edge, so no spacer element is needed. */
   ${MODEL} {
     order: 4 !important;
-    flex: 0 1 auto !important;
+    /* A definite flex-basis (not auto) breaks the circular sizing between
+       this seat and the trigger's max-width:100%: the seat's width comes
+       from flex resolution, the trigger fills up to it, the label
+       ellipsizes inside. Under nowrap pressure this is the only
+       min-width:0 seat, so it absorbs all shrink. */
+    flex: 0 1 min(48vw, 200px) !important;
     min-width: 0 !important;
+    max-width: min(48vw, 200px) !important;
     margin-right: auto !important;
   }
   /* Third-party input.right entries park next to the ring rather than
@@ -4546,11 +4794,11 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
     order: 7 !important;
   }
 
-  /* --- 3. permission + model as icon-only pills (real-device round 2, 2026-08-17) ---
-     S3's icon-and-label capsules read as noise on an actual phone — there
-     is no room to usefully show a preset name or a model id, so the label
-     text is now hidden outright and both triggers collapse to a plain
-     ~44x30 icon button. This AGREES with (rather than fights) the official
+  /* --- 3. permission as icon-only pill; model as name+effort pill ---
+     (real-device round 2, 2026-08-17; model pill reworked 2026-08-25:
+     the user wants to SEE which model/effort is active, so only the
+     permission trigger stays icon-only — its label is hidden and it
+     collapses to a plain ~44x30 icon button. This AGREES with (rather than fights) the official
      container query (\`@container (width <= 460px) { .trigger:has(.triggerIcon)
      .triggerLabel { display: none } }\`) that S3 had to override — no need
      to override it back. Accessible name is unaffected: both official
@@ -4573,13 +4821,10 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
      accessible-name computation (empty generated content). S3's
      rtl-ellipsis trick on the model label is simply inert under
      display:none now; left alone rather than unpicked. */
-  ${PERM} [class$="_triggerLabel"],
-  ${MODEL} > [class$="_trigger"] > [class$="_triggerLabel"],
-  ${MODEL} > [class$="_trigger"] > [class$="_triggerEffort"] {
+  ${PERM} [class$="_triggerLabel"] {
     display: none !important;
   }
-  ${PERM} button[class$="_trigger"],
-  ${MODEL} > [class$="_trigger"] {
+  ${PERM} button[class$="_trigger"] {
     background: var(--dsw-specific-selector, rgba(127, 127, 127, .12)) !important;
     width: 44px !important;
     height: 30px !important;
@@ -4591,29 +4836,47 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
     border-radius: 999px !important;
     touch-action: manipulation !important;
   }
+  /* Model trigger: name + effort pill (2026-08-25 user request — the
+     icon-only form hid which model was active). The effort text must stay
+     whole; the model NAME is the elastic part and ellipsizes. max-width
+     caps the pill so the row's elastic gap survives extreme model ids;
+     the label rules below override the <=1023px grow rules in
+     layout.css.ts (flex 1 1 auto) that would otherwise pad the pill. */
+  ${MODEL} > [class$="_trigger"] {
+    background: var(--dsw-specific-selector, rgba(127, 127, 127, .12)) !important;
+    height: 30px !important;
+    width: auto !important;
+    max-width: 100% !important;
+    min-width: 0 !important;
+    padding: 0 10px !important;
+    gap: 4px !important;
+    justify-content: flex-start !important;
+    border-radius: 999px !important;
+    touch-action: manipulation !important;
+    font-size: 12px !important;
+  }
+  ${MODEL} > [class$="_trigger"] > [class$="_triggerLabel"] {
+    display: block !important;
+    flex: 0 1 auto !important;
+    min-width: 0 !important;
+    overflow: hidden !important;
+    text-overflow: ellipsis !important;
+    white-space: nowrap !important;
+  }
+  ${MODEL} > [class$="_trigger"] > [class$="_triggerEffort"] {
+    display: block !important;
+    flex: none !important;
+    white-space: nowrap !important;
+  }
   /* PermissionSelect wraps its trigger in the Menu primitive's root span,
      which must shrink to the icon button's fixed width. */
   ${PERM} > span:has(> button[class$="_trigger"]) {
     flex: 0 0 auto !important;
     min-width: 0 !important;
   }
-  /* ic_ds_sparkle_16 (@deepseek-ai/dsh-client-ui-primitives IconSparkle16
-     path, copied verbatim) as a mask so it inherits currentColor like every
-     other icon in the row — the model trigger has no official icon slot to
-     hook into. */
-  ${MODEL} > [class$="_trigger"]::before {
-    content: '';
-    width: 16px;
-    height: 16px;
-    flex: none;
-    background: currentColor;
-    -webkit-mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M6.1 3.1Q6.6 7.8 11.3 8.3Q6.6 8.8 6.1 13.5Q5.6 8.8 0.9 8.3Q5.6 7.8 6.1 3.1Z'/%3E%3Cpath d='M11.9 1Q12.2 3.7 14.9 4Q12.2 4.3 11.9 7Q11.6 4.3 8.9 4Q11.6 3.7 11.9 1Z'/%3E%3C/svg%3E");
-    mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'%3E%3Cpath d='M6.1 3.1Q6.6 7.8 11.3 8.3Q6.6 8.8 6.1 13.5Q5.6 8.8 0.9 8.3Q5.6 7.8 6.1 3.1Z'/%3E%3Cpath d='M11.9 1Q12.2 3.7 14.9 4Q12.2 4.3 11.9 7Q11.6 4.3 8.9 4Q11.6 3.7 11.9 1Z'/%3E%3C/svg%3E");
-    -webkit-mask-size: contain;
-    mask-size: contain;
-    -webkit-mask-repeat: no-repeat;
-    mask-repeat: no-repeat;
-  }
+  /* (2026-08-25) The model trigger's CSS-only Sparkle ::before icon is gone:
+     the pill now shows the model name + effort text itself, so an icon would
+     just eat label width. */
 
   /* --- 4. both menus become bottom sheets ---
      The permission menu is the Menu primitive (role=menu, absolute, side=top)
@@ -4731,6 +4994,16 @@ exports.COMPOSER_CSS = `/* ---------- phone composer (< 768px) ---------- */
     overflow-x: auto !important;
     overflow-y: hidden !important;
     scrollbar-width: none !important;
+    /* The dock is itself a flex ITEM of the composer stack, and the
+       new-session hero pins that stack to a fixed height. overflow-x:auto
+       above makes this a scroll container, which drops a flex item's
+       automatic minimum size to 0 — so the hero squeezed the dock to ~5px
+       and the attachment chips slid under the card drawn after it (only the
+       top sliver of a thumbnail showed; reported from a real phone,
+       2026-08-26). Refuse the squeeze: natural height, the stack centers a
+       few px lower instead. In-chat the column is not height-pinned and this
+       is a no-op. */
+    flex-shrink: 0 !important;
   }
   [data-slot="conversation.input.dock"]::-webkit-scrollbar {
     display: none !important;
@@ -7222,6 +7495,78 @@ function installAionuiCompat(ctx) {
     }, 'dsh-mobile-nav: sheet rise animation replay');
 }
 };
+__modules["effects/workbench-ref-close.js"] = function (require, module, exports) {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installWorkbenchRefClose = installWorkbenchRefClose;
+/** Phone breakpoint — same query every phone-only effect in this plugin uses. */
+const PHONE_QUERY = '(max-width: 767px)';
+/**
+ * The file tree's per-row @-reference button (dsh-better-sidebar's
+ * `_explorerRef` class suffix — same anchoring convention as every other
+ * better-sidebar hook in this plugin: the plugin's own root marker plus a
+ * stable class suffix, so the selector misses entirely when the plugin is
+ * not installed). Covers the search results too: TreePanel renders both
+ * through the same row-actions slot.
+ */
+const REF_SELECTOR = '[data-dsh-better-sidebar] [class$="_explorerRef"]';
+/** The panel's own (phone-hidden) toggle — the one official way to close it.
+ * Same anchor gestures.ts and MobileSessionHeader.tsx already use. */
+const TOGGLE_SELECTOR = '[data-dsh-better-sidebar] button[class$="_toggleButton"]';
+/** Open-state read, shared convention with gestures.ts: the class ends in
+ * "_panel" only while open ("_panelHidden" is appended once closed). */
+const PANEL_OPEN_SELECTOR = '[data-dsh-better-sidebar] [class$="_panel"]';
+/**
+ * Phone: an @-file reference tap in the workbench closes the workbench.
+ *
+ * On a phone the panel is a full-screen surface over the conversation, so
+ * after tapping a row's @ button the user is still looking at the file tree
+ * — the ONLY feedback for the tap is a draft change on a composer they
+ * cannot see (real-device report, 2026-08-26: reads as "nothing happened",
+ * and the close pill can end up behind the software keyboard on top of it).
+ * Closing the panel IS the feedback: the conversation comes back with the
+ * fresh `@path` sitting in the composer.
+ *
+ * Capture phase on document, deliberately: the button's own React handler
+ * calls stopPropagation() (its row would otherwise open the file), so a
+ * bubble listener never hears the tap. Capture runs on the way DOWN, before
+ * the target handler and its stopPropagation can matter — the aionui-compat
+ * chevron listener set this precedent.
+ *
+ * The close is deferred one macrotask so the reference lands first: the
+ * button's handler (which appends `@path` to the draft) runs at target
+ * phase, synchronously inside this same event dispatch — by the time the
+ * timeout fires the draft is written and the toggle click only changes what
+ * is on screen. Desktop is untouched (checked per tap, not at install: a
+ * resize mid-session must not leave a stale arm either way), where the
+ * panel is a docked column and closing it after every reference would be
+ * hostile to multi-file referencing.
+ */
+function installWorkbenchRefClose(ctx) {
+    ctx.effect(() => {
+        const phone = window.matchMedia(PHONE_QUERY);
+        const onClick = (event) => {
+            if (!phone.matches)
+                return;
+            const target = event.target;
+            if (!(target instanceof Element))
+                return;
+            if (target.closest(REF_SELECTOR) === null)
+                return;
+            setTimeout(() => {
+                // Re-check open state at fire time: the tap's own handler chain (or
+                // a second tap) may already have closed the panel — the toggle is a
+                // toggle, and blind-clicking it would REOPEN what just closed.
+                if (document.querySelector(PANEL_OPEN_SELECTOR) === null)
+                    return;
+                document.querySelector(TOGGLE_SELECTOR)?.click();
+            }, 0);
+        };
+        document.addEventListener('click', onClick, true);
+        return () => document.removeEventListener('click', onClick, true);
+    }, 'dsh-mobile-nav: workbench @-reference closes the panel');
+}
+};
 __modules["effects/header-status.js"] = function (require, module, exports) {
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -8292,6 +8637,7 @@ const index_ts_1 = require("./styles/index.js");
 const debug_ts_1 = require("./debug.js");
 const phone_chrome_ts_1 = require("./effects/phone-chrome.js");
 const aionui_compat_ts_1 = require("./effects/aionui-compat.js");
+const workbench_ref_close_ts_1 = require("./effects/workbench-ref-close.js");
 const header_status_ts_1 = require("./effects/header-status.js");
 const gestures_ts_1 = require("./effects/gestures.js");
 const turn_fold_ts_1 = require("./effects/turn-fold.js");
@@ -8333,6 +8679,9 @@ function apply(ctx) {
     // stack more blank page on top of it.
     (0, phone_chrome_ts_1.installSunkInset)(ctx);
     (0, aionui_compat_ts_1.installAionuiCompat)(ctx);
+    // Phone: tapping a file's @-reference in the workbench closes the panel —
+    // the conversation returning with the fresh mention IS the tap feedback.
+    (0, workbench_ref_close_ts_1.installWorkbenchRefClose)(ctx);
     // Session header running-status dot (S2): no official element exists to
     // reposition, so this reads ctx.sessions directly and self-draws via CSS.
     (0, header_status_ts_1.installHeaderStatusDot)(ctx);
@@ -8462,6 +8811,8 @@ function apply(ctx) {
             startSession: (workspaceId) => ctx.workspaces.startSession(workspaceId),
             // S5 session-log chip — the same service call MobileDrawerFooter uses.
             downloadSessionLog: (id) => ctx.sessionLogDownload.download(id),
+            // Row swipe action — the same binding MobileSessionInfo archives with.
+            archiveSession: (id) => ctx.workspaces.archiveSession(id),
         }),
     }, MobileHome_tsx_1.MobileHome));
     // Session log download, relocated from the session header to the drawer

package/lib/types/client/MobileHome.d.ts

@@ -10,6 +10,8 @@ export type MobileHomeProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnT
     startSession: (workspaceId?: WorkspaceId) => void;
     /** Bound ctx.sessionLogDownload.download() — the session-log chip (S5). */
     downloadSessionLog: (id: SessionId) => void;
+    /** Bound ctx.workspaces.archiveSession(id) — the row swipe action. */
+    archiveSession: (id: SessionId) => Promise<void>;
 };
 /**
  * Phone home screen: the full-screen session list that owns the first level
@@ -20,5 +22,5 @@ export type MobileHomeProps = PropsRuntime<'shell.overlay'> & PropsStore<ReturnT
  * all navigation from the injected official actions; nothing here reads the
  * official DOM.
  */
-export declare function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession, startSession, downloadSessionLog, t, }: MobileHomeProps): import("react").JSX.Element | null;
+export declare function MobileHome({ useSessions, useWorkspaces, useStore, actions, openSession, startSession, downloadSessionLog, archiveSession, t, }: MobileHomeProps): import("react").JSX.Element | null;
 //# sourceMappingURL=MobileHome.d.ts.map

package/lib/types/client/MobileHome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileHome.d.ts","sourceRoot":"","sources":["../../../src/client/MobileHome.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAS7F,OAAO,KAAK,EAAE,SAAS,EAAkB,WAAW,EAAE,MAAM,wCAAwC,CAAA;AACpG,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAMjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAMpD,kEAAkE;AAClE,MAAM,MAAM,eAAe,GACvB,YAAY,CAAC,eAAe,CAAC,GAC7B,UAAU,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,GAC7C,WAAW,CAAC,OAAO,EAAE,CAAC,GACtB;IACA,mCAAmC;IACnC,WAAW,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;IACpC,uDAAuD;IACvD,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IACjD,2EAA2E;IAC3E,kBAAkB,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;CAC5C,CAAA;AAuEH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,CAAC,GACF,EAAE,eAAe,sCA+OjB"}
+{"version":3,"file":"MobileHome.d.ts","sourceRoot":"","sources":["../../../src/client/MobileHome.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAS7F,OAAO,KAAK,EAAE,SAAS,EAAkB,WAAW,EAAE,MAAM,wCAAwC,CAAA;AACpG,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAA;AAMjC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAMpD,kEAAkE;AAClE,MAAM,MAAM,eAAe,GACvB,YAAY,CAAC,eAAe,CAAC,GAC7B,UAAU,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,GAC7C,WAAW,CAAC,OAAO,EAAE,CAAC,GACtB;IACA,mCAAmC;IACnC,WAAW,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;IACpC,uDAAuD;IACvD,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;IACjD,2EAA2E;IAC3E,kBAAkB,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,CAAA;IAC3C,sEAAsE;IACtE,cAAc,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD,CAAA;AAkMH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,OAAO,EACP,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,CAAC,GACF,EAAE,eAAe,sCAgRjB"}