better-dsh 0.2.2-c → 0.2.3-c

package/docs/50_test-reports/v0.2.3b-hashline-content-locator/345/256/236/346/265/213/346/212/245/345/221/212.md

@@ -0,0 +1,73 @@
+# v0.2.3b hashline-content-locator 实测报告
+
+> 2026-09-08 · 环境：DSH 4999 dev 线（upstream checkout `0.1.3-alpha.2-82a5fd6-dirty`，
+> `DSH_HOME=~/.workspaces/dashr/.dsh-test` 语义路径 `.dsh-test`），better-dsh vendored
+> hashline 桥（change `2026-09-08-v0-2-3b-hashline-content-locator`）。
+> 前置：诊断报告 `2026-09-08-hashline-edit-E_RANGE_UNVERIFIED跨轮会话键失效-诊断报告.md` §7。
+
+## 0. 一句话结论
+
+五项裁决全部落地并实测通过：served 账本去 session 化（schema v7，path 主键）、集中存储
+`$DSH_HOME/storages/dsh-better-edit/`、verifyServedRange 内容快道、write 回放移除、失败文案
+修正。单测 12/12 新增全绿、全量 491 过 2 挂（挂项为先于本改动存在的上游类型漂移，stash 基线
+复跑证实）；4999 真实 agent session 第一人称实测：write 只回确认信封（无锚点回放）、read 记账
+进中心库（served 表 `path,hashes,reported,updated_at`，无 session_id 列）、跨会话 edit 链路
+走通、全程无任何 `.dsh_better_edit` 点目录。
+
+## 1. 单元层（canonical，`npx vitest --run`）
+
+- 新增 `test/hashline-store.spec.ts` **12/12 绿**：v7 中心库落位与无点目录断言、path 主键
+  upsert 合并、跨"会话"上下文免 read 取行（fork 模拟）、drift 标记随 path、v6→v7 迁移重建
+  （ handmade 旧库打开后 `session_id` 列消失、version=7）、TTL prune、verifyServedRange 六态
+  矩阵（账本未见→内容快道通过；账本全知匹配→过；内部漂移→`E_RANGE_STALE`；账本洞→
+  `E_RANGE_UNSERVED`；单边账本→`E_RANGE_UNVERIFIED`；拒绝文案含"Read the file once…
+  resubmit the whole batch"）。
+- 全量：**491 passed / 2 failed**，2 挂项（`handlers/agent.ts` `snapshotEvents`、
+  `SessionHeader.isSeeded`）经 `git stash` 基线复跑**证实先于本改动存在**（上游 alpha.2 对齐
+  类型漂移，非本 change 引入；tsc 同样仅此 3 条既有错）。
+
+## 2. 构建（monorepo 副本）
+
+- rsync（AGENTS exclude 表）→ `pnpm --filter better-dsh exec tsdown` → **9 files 529.98 kB**，
+  `lib/index.js` 形态正确 → `tsx scripts/build-client.ts` → `lib/client/index.js`
+  17.82 kB（md5 `a88850ec056aae943934adfdeb79347e`，client 半零改动）。
+- **教训（新增坑，已亲历）**：直接以 `node_modules/.bin/tsdown` 裸跑（不经 pnpm workspace env）
+  会产出 `.mjs` 形态（7 files），boot 即 `ERR_MODULE_NOT_FOUND lib/index.js`——**必须用
+  `pnpm --filter better-dsh exec tsdown`**；且 `--delete` rsync + tsdown clean 会连带重置副本
+  配置与 lib（本次已重建，副本 package.json/tsdown.config 现与 canonical 一致）。
+
+## 3. 4999 第一人称实测（真实 agent session，CDP 驱动 GUI）
+
+工作区 `/home/u1`（GUI 工作区选择器未绑到 ws-probe，落在默认 home 桶——不影响断言），
+模型 DeepSeek-V4-Flash。三段剧本：
+
+| 步 | 动作 | 断言 | 结果 |
+|---|---|---|---|
+| S1 | write 创建 `probe-v023b.md`（6 行规格内容） | write 结果**无** `--- Auto-read (hashline anchors) ---` 段，仅确认信封 | ✅（transcript 仅 "Produced probe-v023b.md"） |
+| S1 | read 全文 | 锚点记账进**中心库** | ✅ `.dsh-test/storages/dsh-better-edit/hash-store.sqlite`（+WAL）出现；served 表列 `path,hashes,reported,updated_at`，**无 session_id**；单行 `path=/home/u1/probe-v023b.md → ["Udx","nyO","zlr","DBc","Zuy","GTH"]` |
+| S2（**新会话**，不同 session id，从未观察/读过该文件） | 直接 edit（锚点 zlr/zlr 来自 S1） | 旧代码此处必 `E_RANGE_UNVERIFIED` | ⚠️ 见 §4——被**宿主层另一道闸**前置拦截 |
+| S2 | read 一次后同参数 edit | 成功落盘 | ✅ 文件第 3 行 = `beta line EDITED-BY-v0.2.3b-PROBE`；无任何 E_RANGE_* |
+
+存储探针：`/home/u1/.dsh_better_edit` **不存在** ✓（home 即 workspace，dot-dir 若仍会创建必然在此）。
+
+## 4. 实测发现：宿主 fs 观察策略是跨会话 edit 的另一道（设计内）闸
+
+S2 盲 edit 返回 `[E_NOT_OBSERVED] The file has not been observed in this session
+(read-before-write policy). Call read() first` ——这是 **`dsh-fs-observation-policy` 宿主插件**
+的 observed-state 守卫（owner=agent 会话的 WeakMap，read/write/edit 记版本），**不是** hashline
+served 账本。定性：
+
+- **保留**（user 裁决语义："安全守卫在确认覆盖/见过"——read-before-edit 正是宿主层的"见过"）；
+  本 change 的范围是把 hashline 层的**重复**session 账本拿掉，不是拆宿主守卫。
+- 事故剧本（S1 write → fork 子会话 edit）在原线上之所以先报 hashline 错，是 fork 继承了观察态；
+  hashline 层修复后，**同进程 fork 续聊**的 edit 将直接由内容快道放行（fork 不再需要冗余 read）。
+- 全新无关会话（如本 S2）盲 edit 被宿主拦——符合"读过才许改"的常理，非回归。
+
+## 5. 残留与移交
+
+- 预置 guidance 覆盖目录现种子于 `storages/dsh-better-edit/`（ensurePresetGuidance 同目录）——
+  与 store 同居一处，属可接受的组织形态。
+- 旧 12 个 `<workspace>/.dsh_better_edit/` 弃置未删（TTL 语义自然清空；物理清理留 user 决定）。
+- 4999 实例已停本探针产物：`/home/u1/probe-v023b.md` 与 `.scratch/ws-probe/` 已清理。
+- **发布闸状态**：a 第一人称实测 ✅ → b 本报告 ✅ → **c user 明确确认放行 ⏳**（单次有效；
+  未 commit、未 tag、未 publish）。

package/docs/upstream-dsh-0.1.5-rc.2-report.md

@@ -0,0 +1,156 @@
+# upstream dsh npm 版本对账：prod 0.1.3-alpha.2 → 0.1.5-rc.2
+
+> 生成时间：2026-09-10（本地时区）
+> 数据源：npm registry（`@deepseek-ai/dsh`）元数据 + `upstream/deepseek-harness` git tag 对账
+> 目标：回答「npm 上比 prod 更高的版本是什么、diff 有多大、对 prod 意味着什么」
+
+---
+
+## 〇、一句话结论
+
+prod 当前跑 **`@deepseek-ai/dsh@0.1.3-alpha.2`**。npm 上比它高的版本是整条 **0.1.5 线**（`alpha.1 / alpha.2 / rc.1 / rc.2`，**0.1.4 从未发布，直接跳号**）。最高版本是 **`0.1.5-rc.2`**（挂在 `next` dist-tag，而 `latest` 还停在 `0.1.5-rc.1`）。
+
+这条 0.1.5 线是**大版本级聚合**：846 commits、3170 文件、约 10.4 万行新增。核心是 **Session 格式 v3 重写**（会话持久化契约变更，对 prod 是**破坏性升级，不可 drop-in**），外加 Electron 桌面打包、Sidebar/dockkit 重构、文件交付「present」工具、图渲染预览、模型默认值切换（DeepSeek V41 Flash）等一批功能。**升级 prod 前必须按 AGENTS.md §一/§二 走对齐轮，不能只换版本号。**
+
+---
+
+## 一、版本全景
+
+npm registry 当前 dist-tags：
+
+| dist-tag | 指向版本 |
+|---|---|
+| `latest` | 0.1.5-rc.1 |
+| `next` | **0.1.5-rc.2**（最高） |
+| `alpha` | 0.1.5-alpha.2 |
+
+比 prod（0.1.3-alpha.2）更高的版本，按发布顺序：
+
+| 版本 | npm 发布时间 (UTC) | dist-tag |
+|---|---|---|
+| 0.1.5-alpha.1 | 2026-09-08 15:57 | — |
+| 0.1.5-alpha.2 | 2026-09-09 14:41 | `alpha` |
+| 0.1.5-rc.1 | 2026-09-10 03:12 | `latest` |
+| **0.1.5-rc.2** | **2026-09-10 14:57** | `next` |
+
+> 注意点：`latest` 并不指向最高版本（rc.1 vs rc.2）；「最高版本」= `next` 上的 **0.1.5-rc.2**。0.1.4 未在 npm 出现过。
+
+对应 git tag（本地 `upstream/deepseek-harness`，已 fetch）：
+
+```
+dsh-v0.1.3-alpha.2  2026-09-07 19:45 +0800   ← prod 当前
+dsh-v0.1.5-alpha.1  2026-09-08 23:25 +0800
+dsh-v0.1.5-alpha.2  2026-09-09 22:13 +0800
+dsh-v0.1.5-rc.1     2026-09-10 09:36 +0800
+dsh-v0.1.5-rc.2     2026-09-10 21:50 +0800
+```
+
+---
+
+## 二、diff 规模
+
+`dsh-v0.1.3-alpha.2 .. dsh-v0.1.5-rc.2`：
+
+| 指标 | 值 |
+|---|---|
+| commits | **846** |
+| 文件 | 3170 changed |
+| 行 | +103,990 / −17,687 |
+| 源码侧（排除 snapshots/tests） | 2474 文件，+68,818 / −13,973 |
+
+分段 commit 分布：
+
+| 区间 | commits |
+|---|---|
+| 0.1.3-alpha.2 → 0.1.5-alpha.1 | 563（大头，聚合了 Session V3 与一堆 feature） |
+| 0.1.5-alpha.1 → 0.1.5-alpha.2 | 262 |
+| 0.1.5-alpha.2 → 0.1.5-rc.1 | 17 |
+| 0.1.5-rc.1 → 0.1.5-rc.2 | 4（收尾/backport） |
+
+---
+
+## 三、依赖面变化（对 prod 直接可见）
+
+prod 0.1.3-alpha.2 有 **71 个 dependencies**，0.1.5-rc.2 有 **72 个**。差异：
+
+1. **新增运行期包 `@deepseek-ai/dsh-tool-present`**（`packages/fs/tool-present`）——新「present」工具：把 agent 产出的文件以不可变交付卡片（download card）呈现，是文件交付特性的宿主半。
+2. `apps/cli` devDeps 新增 `@deepseek-ai/dsh-agent-loop`、`@deepseek-ai/dsh-agent-loop-testkit`（内部，不影响 prod 运行面）。
+3. 新增 client 包 `ui-deliverables`（`PresentRow` / `PresentedFileCard` / `present-open`），属 web shell 交付卡片 UI。
+4. 其余全部 `@deepseek-ai/*` 依赖整体从 `^0.1.3-alpha.2` 抬到 `^0.1.5-rc.2`（同版本号齐步，无个别漂移）。
+5. 底层 `cordis` / `schemastery` / `commander` / `js-yaml` 等版本**未变**（`cordis ^4.0.2`、`schemastery ^3.18.2` 等，与 0.1.3-alpha.2 相同）。
+
+---
+
+## 四、主要变更主题（按 prod 相关度排序）
+
+### 1. Session 格式 v3 重写（⚠ 破坏性，最高风险）
+`session-log-v3` 工作线，是本次最大的变更块。要点：
+
+- 会话身份 **V2 → V3 迁移**（`feat(session): add identity V2-to-V3 migration and writer skeleton`）。
+- system prompt 表示为 **surface node zero**（`refactor(session): represent the system prompt as surface node zero`）。
+- **canonical envelopes**、PTC durable vocabulary、in-history system prompt 表示、JSONL 跨进程写所有权（lease）。
+- 大量 `session.v3.jsonl` 快照与 V2/V3 迁移覆盖面单测。
+
+> **对 prod 的含义**：会话持久化契约改变。上一轮（0.1.3-alpha.2 对齐）已实测：上游 tag diff 会打到 `session-persistence-omp.ts` / `replay.ts` / store 的 handle+lease 契约（见 2026-09-08 对齐报告）。**0.1.5 的 V3 比 0.1.3 的 V2 更进一步，破坏面更大**，`better-dsh` / `omp-web` 这类桥接会话数据的插件必须重新对齐，不能 drop-in。
+
+### 2. Electron 桌面打包（对 3080 web 无直接作用）
+Windows/macOS/Linux 构建、mac 签名+公证、Windows 签名、auto-update、IPC 性能优化。纯桌面宿主线，与本机 `dsh web`（3080）部署无关，但意味着上游发布面从此多一个桌面产物。
+
+### 3. Sidebar / dockkit 重构
+- `dockkit` 可逆停靠引擎、pointer 交互。
+- 全局 sidebar panel、tab 导航、live tab 标题 + 文件类型图标、末 tab 关闭规则、响应式右栏、全屏 shell。
+- session-log 控制移入 header「更多」菜单。
+
+### 4. 文件交付「present」工具 + 文档预览
+- 新 `dsh-tool-present` 包：不可变文件交付下载卡片、artifact 卡原生文件动作、workspace 文件操作。
+- 可扩展文档预览、文本预览分页 tab、文件类型图标集、`ui-deliverables` client 卡。
+- `feat(fs)`：bounded byte-range reads（fs-local / fs-e2b）、dual-face 文件 API。
+
+### 5. 图表 / Markdown 预览
+Chat 代码块内预览 Mermaid / Graphviz / SVG / HTML fence，适配应用主题。
+
+### 6. LLM 模型默认值切换（⚠ 影响 prod 行为）
+- Chat Completions 默认切到 **DeepSeek V41 Flash**（`feat(llm): default Chat Completions to DeepSeek V41 Flash`）。
+- 保留 V4 模型、恢复 V4 Flash Vision Exp catalog 条目。
+> prod 若升级，默认模型会跟着变；需确认是否期望。
+
+### 7. Feedback 对话框
+`/feedback` 与 Dislike 统一为一个带分类的对话框 + toast。
+
+### 8. Subagent catalog
+记录并观察 parent-owned child catalog（子代理目录）。
+
+### 9. native system / node-addon-system
+包族改名 `node-addon-system`，预编译 Node-API flock、Landlock capability 子路径。**新增原生依赖面，升级安装需留意 prod 机上的原生构建/预编译匹配**（本机已有一处 zeromq allowBuilds 特例，见 AGENTS.md §二）。
+
+### 10. minimal profile 行为调整
+- `str_replace_editor` 从 minimal profiles 移除。
+- persistent bash 输出与 one-shot shell 契约对齐。
+> 只影响 minimal profile，不影响 prod `web` profile 的默认工具集。
+
+### 11. 其它
+- CLI：从 shipped 模板创建 profile。
+- skills：Playwright 视频录制 GIF。
+- 内部 CI/审查自动化（weighted PR approval、review owner 排名等）——与 prod 运行无关。
+
+---
+
+## 五、对 prod 升级的风险评估（简要）
+
+| 风险项 | 级别 | 说明 |
+|---|---|---|
+| Session V3 格式迁移 | 🔴 高 | 会话持久化契约变更；`better-dsh`/`omp-web` 会话桥接面需重新对齐，先例（0.1.3 V2）已证实非 drop-in |
+| 模型默认切 V41 Flash | 🟠 中 | 默认行为变化，需 user 确认是否接受 |
+| 新原生依赖（node-addon-system） | 🟡 中低 | 安装面原生构建/预编译匹配；本机 pnpm strictDepBuilds/allowBuilds 需复核 |
+| 新工具 `dsh-tool-present` | 🟡 中低 | 新工具进入 agent 运行时，需确认与现有工具/插件无 id 冲突 |
+| Sidebar/dockkit UI 重构 | 🟢 低（功能面） | 纯增量 UI，但 better-dsh 的 mobile 手势/侧栏 patch 需复测是否仍对齐 |
+| Electron 桌面 | ⚪ 无关 | 不影响 web 部署 |
+
+---
+
+## 六、建议
+
+1. 本次**只做对账、不做升级**：0.1.5 是聚合大版本，且含 Session V3 破坏性契约变更，不能当「换版本号」处理。
+2. 若后续要升级，按 AGENTS.md §一/§二走 **Dev/Test 1（4999 源码级）对齐轮**：切 `dsh-v0.1.5-rc.2` → 重放三处本地 patch（storeDir / unrun devDep / resolveRepositoryRoot）→ install/build → 插件契约对齐（重点 `session-persistence-omp.ts`/`replay.ts`/store 的 V3 handle+lease）→ tsc/单测 → 4999 第一人称实测 → 报告落 `docs/50_test-reports/` → user 确认 → 才动 prod 3080。
+3. 升级目标版本**首选 `0.1.5-rc.2`（`next`）而非 `latest`（rc.1）**，因为 rc.2 才是最高版本；但 rc 阶段仍建议等上游正式 stable 后再定。
+4. 升级前单独确认模型默认值（V41 Flash）是否要在 prod 生效。

package/lib/client/index.js

@@ -69,7 +69,7 @@ const zh = {
 };
 
 //#endregion
-//#region \0dsh-css:/home/u1/workspaces/dashr/dashr/src/failover/client/FailoverRow.module.css.mjs
+//#region \0dsh-css:/home/u1/workspaces/dashr/upstream/deepseek-harness/packages/better-dsh/better-dsh/src/failover/client/FailoverRow.module.css.mjs
 const css = "._440e1d7b_row {\n  display: flex;\n  flex-direction: column;\n  gap: 8px;\n  padding: 12px 0;\n}\n\n._9865b509_title {\n  font-weight: 600;\n  font-size: 14px;\n}\n\n._3cfec826_slots {\n  display: flex;\n  flex-direction: column;\n  gap: 6px;\n}\n\n._70954771_slot {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n}\n\n._ba1fd839_slotLabel {\n  min-width: 88px;\n  flex-shrink: 0;\n  font-size: 13px;\n  color: var(--dsw-alias-text-secondary, #666);\n}\n\n._11c2662d_select {\n  flex: 1;\n  max-width: 280px;\n  min-width: 0;\n}\n\n._b7c358f9_alert {\n  color: var(--dsw-alias-danger, #c0392b);\n  font-size: 12px;\n}\n";
 const tagId = "better-dsh/FailoverRow.module.css";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
@@ -185,14 +185,12 @@ function FailoverRow({ catalog, loadConfig, save, t }) {
 
 //#endregion
 //#region src/mobile/gesture.ts
-/**
-* Resolved defaults — the `1706b81` constants (120 / viewport÷4 / 40 / 1.3 /
-* 768) plus the one addition, the velocity gate. A slow text-selection drag
-* runs ~0.13 px/ms; 0.15 px/ms filters those while any comfortable sweep
-* (0.4 px/ms and up) passes.
+/** Resolved defaults — the `1706b81` constants (120 / viewport÷4 / 40 / 1.3)
+* plus the one addition, the velocity gate. A slow text-selection drag runs
+* ~0.13 px/ms; 0.15 px/ms filters those while any comfortable sweep (0.4
+* px/ms and up) passes.
 */
 const DEFAULT_SWIPE_THRESHOLDS = {
-	breakpoint: 768,
 	swipeDistancePx: 40,
 	dominanceRatio: 1.3,
 	leftEdgeBandPx: 120,
@@ -200,16 +198,6 @@ const DEFAULT_SWIPE_THRESHOLDS = {
 	swipeVelocityPxPerMs: .15
 };
 /**
-* Whether one completed gesture's viewport is in the gesture band.
-*
-* @param viewportWidth - viewport width at gesture time (px).
-* @param thresholds - resolved recognition thresholds (`.breakpoint`).
-* @returns `true` when `viewportWidth` is strictly below the breakpoint.
-*/
-function isNarrowViewport(viewportWidth, thresholds) {
-	return viewportWidth < thresholds.breakpoint;
-}
-/**
 * Whether a pointerdown may START a gesture — the source's pointerdown
 * gate, verbatim: with both panels closed, only the left band (X120) or
 * the right three quarters of the screen admit; with a panel open, any
@@ -275,7 +263,6 @@ function resolveMobileConfig(pageConfig) {
 	const v = (value, fallback) => typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
 	return {
 		enabled: true,
-		breakpoint: n(pageConfig.breakpoint, DEFAULT_SWIPE_THRESHOLDS.breakpoint),
 		swipeDistancePx: n(pageConfig.swipeDistancePx, DEFAULT_SWIPE_THRESHOLDS.swipeDistancePx),
 		dominanceRatio: n(pageConfig.dominanceRatio, DEFAULT_SWIPE_THRESHOLDS.dominanceRatio),
 		leftEdgeBandPx: n(pageConfig.leftEdgeBandPx, DEFAULT_SWIPE_THRESHOLDS.leftEdgeBandPx),
@@ -291,19 +278,32 @@ function readLeftCollapsed() {
 	return document.querySelector("[data-sidebar-collapsed]") !== null;
 }
 /**
-* Better Sidebar's right-panel state, live off the body attribute the
-* plugin itself publishes (collapsed = closed). Read SYNCHRONOUSLY in the
-* handlers — a cached mirror lags the panel's own DOM write by a render,
-* and a close-swipe issued right after an open-swipe would misroute.
+* The OFFICIAL right sidebar's state (0.1.5 ui-sidebar-right), read from
+* AppFrame's TWO presentation facets, synchronously (a cached mirror lags
+* the panel's own DOM write by a render, and a close-swipe issued right
+* after an open-swipe would misroute):
+*
+* - `[data-rightbar-collapsed]` — the reserved GRID TRACK facet (present =
+*   zero-width right column). On phones (<768) the panel presents FULLSCREEN
+*   WITHOUT a track (`autoFullscreen` in SidebarRight), so this attribute
+*   alone misreads a panel that covers the whole frame as "closed" — the
+*   2026-09-11 field bug: every close-swipe misrouted to open-left.
+* - `[data-rightbar-fullscreen]` — the overlay facet (present = fullscreen
+*   presentation active, open by definition).
+*
+* Open = track reserved OR fullscreen overlay. On hosts before 0.1.5 both
+* attributes never appear: closed, permanently — left gestures unaffected.
 */
 function readRightOpen() {
-	return !document.body.hasAttribute("data-dsh-sidebar-collapsed");
+	const fullscreen = document.querySelector("[data-rightbar-fullscreen]") !== null;
+	const trackless = document.querySelector("[data-rightbar-collapsed]") !== null;
+	return fullscreen || !trackless;
 }
 /**
 * Whether a session is current — the plugin-side stand-in for the source's
-* `detailsSession !== undefined` guard (the right panel opens in a session
-* only). Better Sidebar's own shipped CSS keys off the same slot selector,
-* so it is load-bearing beyond this feature.
+* `detailsSession !== undefined` guard (the right panel is a
+* session-scoped surface; without a session its expand button is not
+* rendered, so opening would be a no-op anyway).
 */
 function readSessionLive() {
 	return document.querySelector("[data-slot=\"conversation.session.header\"]") !== null;
@@ -316,32 +316,38 @@ function readPanelState() {
 	};
 }
 /**
-* Toggle Better Sidebar's right panel through its persistent DOM: the
-* plugin exposes no JS toggle on its client service (its open/close
-* reducer is store-internal), so the swipe reaches it the same way the
-* source did — clicking the LAST button of its always-rendered
-* `[data-dsh-toggle-cluster]` (the bottom-panel button precedes it and is
-* absent below the plugin's 768px narrow breakpoint). Absent cluster or
-* buttons: a no-op, never a crash.
+* Drive the OFFICIAL right sidebar through its own controls (0.1.5
+* ui-sidebar-right): opening clicks `[data-sidebar-right-expand]` (the
+* conversation header corner button — the panel's own documented "way
+* into a hidden panel", rendered exactly while collapsed with a session);
+* closing clicks `[data-sidebar-right-toggle]` (the dock chrome toggle).
+* The store action behind them (`setExpanded`/`toggleExpanded`) is
+* slot-store-internal — cross-plugin imports are the hard boundary, so
+* the native buttons ARE the sanctioned entry. Absent button (pre-0.1.5
+* host, no session, or already in the target state): a no-op, never a
+* crash.
 */
-function toggleBetterSidebar() {
-	const buttons = document.querySelector("[data-dsh-toggle-cluster]")?.querySelectorAll("button");
-	(buttons?.[buttons.length - 1])?.click();
+function openRightPanel() {
+	document.querySelector("[data-sidebar-right-expand]")?.click();
+}
+function closeRightPanel() {
+	document.querySelector("[data-sidebar-right-toggle]")?.click();
 }
 /**
-* The narrow-viewport CSS: zero-width sidebar track under the breakpoint,
-* keyed to AppFrame's semantic attribute (survives class-hash churn).
-* Rendered with the breakpoint baked in (media queries cannot read JS
-* config); the tag carries the plugin-owned dataset so the loader's
-* style-claim machinery removes it on unload, like module CSS.
+* The responsive CSS: zero-width sidebar track whenever upstream's layout
+* has collapsed the sidebar, keyed PURELY to AppFrame's semantic
+* attribute (survives class-hash churn). No width media query of our own
+* (2026-09-11 ruling): upstream owns the auto-collapse threshold (1024
+* today), and this rule simply takes the 56px rail they leave behind to
+* zero. If upstream renames the attribute the rule stops matching and
+* their native rail renders (benign degradation). The tag carries the
+* plugin-owned dataset so the loader's style-claim machinery removes it
+* on unload, like module CSS.
 */
-function mobileCss(breakpointPx) {
-	const wide = Math.max(1, Math.floor(breakpointPx) - .02);
+function mobileCss() {
 	return [
-		`@media (max-width: ${String(wide)}px) {`,
-		`  [data-sidebar-collapsed] {`,
-		`    grid-template-columns: 0px minmax(0, 1fr) 0px !important;`,
-		`  }`,
+		`[data-sidebar-collapsed] {`,
+		`  grid-template-columns: 0px minmax(0, 1fr) 0px !important;`,
 		`}`
 	].join("\n");
 }
@@ -361,7 +367,7 @@ function setupMobileLayout(ctx) {
 		const tag = document.createElement("style");
 		tag.dataset.plugin = "better-dsh";
 		tag.dataset.pluginCss = styleTagId;
-		tag.textContent = mobileCss(config.breakpoint);
+		tag.textContent = mobileCss();
 		document.head.append(tag);
 		const offLayout = ctx.inject(["layout"], (layoutCtx) => {
 			const layout = layoutCtx.get("layout");
@@ -370,8 +376,10 @@ function setupMobileLayout(ctx) {
 			const onPointerDown = (event) => {
 				start = void 0;
 				const viewport = window.innerWidth;
-				if (!isNarrowViewport(viewport, config)) return;
-				if (!admitsSwipeStart(event.clientX, viewport, readPanelState(), config)) return;
+				const coarsePointer = window.matchMedia?.("(pointer: coarse)").matches === true;
+				const panels = readPanelState();
+				if (!coarsePointer && !panels.leftCollapsed && !panels.rightOpen) return;
+				if (!admitsSwipeStart(event.clientX, viewport, panels, config)) return;
 				start = {
 					x: event.clientX,
 					y: event.clientY,
@@ -389,7 +397,8 @@ function setupMobileLayout(ctx) {
 				if (action === null) return;
 				start = void 0;
 				if (action === "open-left" || action === "close-left") layout.toggleSidebar();
-				else toggleBetterSidebar();
+				else if (action === "open-right") openRightPanel();
+				else closeRightPanel();
 			};
 			const onPointerEnd = () => {
 				start = void 0;

package/lib/index.d.ts

@@ -549,7 +549,6 @@ interface WebTrustConfig {
   trustedPageAuthorities?: readonly string[];
   mobile?: {
     enabled?: boolean;
-    breakpoint?: number;
     swipeDistancePx?: number;
     dominanceRatio?: number;
     leftEdgeBandPx?: number;
@@ -671,7 +670,7 @@ declare module '@deepseek-ai/cordis' {
     /**
      * Allow a listener to replace content in the DURABLE LOG COPY of one
      * `eval` sub-dispatch outcome before the bridge appends its
-     * `tool/code-dispatch` event. `next()` keeps the content unchanged; a
+     * `tool/ptc-dispatch` event. `next()` keeps the content unchanged; a
      * listener may return replacement blocks (e.g. the spill policy's preview
      * + locator for an oversized text result). Scope-filtered dispatch
      * (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only that
@@ -714,7 +713,7 @@ interface RunCellBridgeOptions {
  * in the module doc. Sub-calls ride the registry's exported staged scheduler
  * (`prepare`/`dispatch`/`finalize`/`finish`) under the native concurrency
  * contract; each sub-dispatch is logged for reconstruction
- * (`tool/code-dispatch-start` / `tool/code-dispatch`) while only the outer
+ * (`tool/ptc-dispatch-start` / `tool/ptc-dispatch`) while only the outer
  * curated result enters model history.
  * @param registry - the host tool registry (sub-calls go through its staged
  *   scheduler, bindings cover its registered tools).