@khorsheed/dsh-message-timeline 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 变更记录
 
+## 0.2.0（2026-09-10）
+
+适配宿主 0.1.2 线。
+
+- **BREAKING**：minHost 前移至 `0.1.2-rc.1`；宿主 `0.1.0-rc.6` ~ `0.1.1-rc.2` 的用户请停留在 0.1.x 线（末版 `0.1.0`）
+- 聊天快照改读 0.1.2 的 `useChat` 单座席（rc 线的 `useSession(...).chat` 读取臂退役）；座席缺席时面板静默隐藏，绝不报错
+- 导入面迁移：client bundle 不再引用宿主已删除的 `dsh-client-runtime`
+
 ## 0.1.0（2026-08-22）
 
 首个公开发布。

package/README.en.md

@@ -2,19 +2,22 @@
 
 English | [中文](README.md)
 
-A jump-to-message timeline for the dsh web GUI: a floating rail on the chat's left edge with one row per user message. Hover to reveal previews, click to scroll the transcript straight to that message.
+Every message you sent in a long conversation — visible at a glance, one click to jump back.
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline1.png" width="480" alt="floating message timeline along the chat's left edge">
+Once a session gets long, finding that requirement you mentioned three messages ago means scrolling up forever. This plugin parks a timeline on the chat's left edge: one row per message you sent, with a one-line preview. At rest it's just a strip of dimmed ticks that stays out of the way; hover to expand it, and clicking a row scrolls the transcript straight to that message. It only reads the session and never sends anything — the model doesn't notice it at all.
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline2.png" width="480" alt="the timeline rests as a thin rail out of sight, expanding on hover">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline1.png" width="640" alt="the expanded message timeline on the chat's left edge: one row per user message, click a row to jump to it">
 
 ## Features
 
-- **One row per user message** — tick plus ellipsized one-line preview; steering messages count too (configurable off).
+- **One row per user message** — tick plus ellipsized one-line preview; steering messages count too (configurable off), and message-tools edited/restored bubbles keep a row. Withdrawn originals are not listed (their transcript row is hidden, so a click could never reach them).
 - **Ambient rest state** — only dimmed ticks show until you hover the strip or focus the list.
 - **Reading position tracking** — the current position's tick stays lit blue, anchoring to the user message a long answer is replying to.
 - **Click to jump** — a row scrolls the transcript to that message; the list follows the reading position.
-- **Long-history friendly** — a short list centers vertically; a long one scrolls and pages older history at its top.
+- **Long-history friendly** — a short list centers vertically; a long one scrolls and pages older history at its top, its bottom-most row flush with the chat input box; goal/todo dock cards never push the timeline up.
+- **Never covers the message flow** — the panel's width is capped by the scrollport's left gutter; a gutter too small for the minimum width hides it rather than overlapping the transcript.
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline2.png" width="640" alt="the timeline at rest: a strip of dimmed ticks that stays out of the way, expanding on hover">
 
 ## Install
 
@@ -39,12 +42,15 @@ dsh plugin --profile web remove @khorsheed/dsh-message-timeline
 
 ## Compatibility
 
-- npm release line (`@deepseek-ai/dsh@0.1.1-rc.2`): ✅ full — the rc.8→0.1.1-rc.1 API audit (2026-08-21) confirms every surface this plugin consumes is unchanged or additive (the ProjectionDefinition restructure, cacheHitPercent return-type change, and the credentials/updated event rename do not touch this package); no source change was needed; re-audited for rc.2 (2026-08-22): consumed surface unchanged, full build+test green.
-- source line (deepseek-harness master): ✅
+- npm release line (`@deepseek-ai/dsh@0.1.2-rc.1`): ✅ full — baseline moved to the 0.1.2-rc.1 API surface (single-arm 0.1.2 API consumption; the 0.1.1-rc.2 runtime arm is retired), full build+test green; minHost moves up to 0.1.2-rc.1 — older hosts stay on the previous release line.
+- source line (deepseek-harness master): ✅ (verifiedHost: 0.1.2-rc.1)
+
+**Version line mapping**: 0.2.0 and up support host `0.1.2-rc.1` and later; hosts on `0.1.0-rc.6` ~ `0.1.1-rc.2` stay on the 0.1.x release line (last release `0.1.0`).
 
 ## Known Limitations
 
 - **DOM probe coupling** — the panel targets official row attributes and the `[data-conversation-scroll]` scrollport; if the official DOM changes, it hides itself (one `console.warn`) until the probe is updated.
+- **Best-effort width fallback** — while the message-flow probe is unanswered, the panel renders at a capped fraction of the scrollport instead of hiding, so it may overlap the flow until the probe recovers; with a healthy probe the width never crosses the flow's left edge.
 - **Single rendered session** — rows and jumps address only the currently rendered conversation.
 - **Loaded history only** — rows cover materialized nodes; older messages arrive one page at a time when the panel is scrolled to its top.
 - **No full index view yet** — a searchable message-index tab is planned.
@@ -57,14 +63,16 @@ dsh plugin --profile web remove @khorsheed/dsh-message-timeline
 The plugin is purely additive and modifies no official code.
 
 - `src/client/index.ts` — plugin body (`apply`/`inject`)
-- `src/client/rail-tracker.ts` — the only DOM the plugin touches: read-only probes plus the jump's scroll write
+- `src/client/rail-tracker.ts` — the only DOM the plugin touches: read-only probes, the reading-position resolution, plus the jump's scroll write
 - `src/client/TimelineRail.tsx` — the panel component
+- `src/client/timeline-kinds.ts` — the single source of truth for which node kinds are rows and which carry a hidden span
+- `src/client/hidden-spans.ts` — folds the message-tools withdraw/edit spans so covered originals are dropped as dead rows
 - `src/client/preview.ts` — message content to one-line preview text
 - `src/index.ts` — empty host `apply`, anchors the plugin into the host Loader
 
-**Mount & data** — one entry in the official `conversation.session.header.utilities` slot anchors the plugin into the session scope; the panel renders through a body portal with fixed geometry measured from the official scrollport. Rows derive from the framework `useSession` chat snapshot (`s.chat.order` / `s.chat.nodes`), filtered to `user` / `steering` nodes — no store outside the session, no event registration.
+**Mount & data** — one entry in the official `conversation.session.header.utilities` slot anchors the plugin into the session scope; the panel renders through a body portal with fixed geometry measured from the official scrollport. Rows derive from the framework `useSession` chat snapshot (`s.chat.order` / `s.chat.nodes`): the ordinary `user` (and optional `steering`) rows come from the host order, and message-tools `message-tools-edited`/`message-tools-restored` bubbles that the host order does not always surface are appended from the node store — no store outside the session, no event registration. A bubble for a withdrawn original is dropped (its row is hidden by the DOM hider, so a click could never reach it), and appended bubbles are sorted by their anchor seq so the newest message is always last.
 
-**Jump & degradation** — clicking a row finds the transcript row by the official `data-chat-anchor-key` attribute and writes `scrollTop`; the official ChatView treats that as a normal reader move (bottom-follow and scroll memory keep working). The probed attributes are official render output, not a declared API: when they change, the panel hides itself with one `console.warn`; nothing throws and the boot never fails.
+**Jump & degradation** — clicking a row finds the transcript row by the official `data-chat-anchor-key` attribute and writes `scrollTop`; the official ChatView treats that as a normal reader move (bottom-follow and scroll memory keep working). The probed attributes are official render output, not a declared API: when they change, the panel hides itself with one `console.warn`; nothing throws and the boot never fails. The panel's width is capped by the scrollport's left gutter so it never covers the message flow; while the flow probe is unanswered (an official structure change) the width degrades to a capped fraction of the scrollport as a best-effort fallback — the panel may then overlap the flow until the probe recovers.
 
 **Model experience: none.** The panel reads the session snapshot and scrolls the transcript; it never sends prompts, appends session events, or enters the session log. KV cache effect: none. The `enabled` config turns the plugin off entirely; removing it from cordis.yml removes every surface it adds.
 

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/message-timeline/README.en.md
-packages/message-timeline/README.en.md: 6c23db63db34214d844f5db121fb8e87b9565a05
-packages/message-timeline/README.md: da68ead740c42b8ceb770047aefdb8f61ce733d2
+packages/message-timeline/README.en.md: 5c8d6f4b24c2852e1d64db8aeb0a4817e0832c64
+packages/message-timeline/README.md: 1718fba1afa90e0cdd1e23956cea3aa45fde0502

package/README.md

@@ -1,20 +1,23 @@
-# dsh-message-timeline
+# @khorsheed/dsh-message-timeline
 
 [English](README.en.md) | 中文
 
-dsh web GUI 的历史消息导览:会话左缘的一条悬浮时间轴,每行一条用户消息。悬停显示预览,点击直接把会话滚动到对应消息。
+长对话里你说过的每句话，一眼看到、一点就跳回去。
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline1.png" width="480" alt="会话左缘的悬浮消息时间轴">
+会话一长，想找回三条消息前提过的那个要求，就只能一路往上滚。这个插件在对话左缘放了一条时间轴：你说过的每句话占一行，带单行预览；平时它收成一排压淡的刻度，不占视线，鼠标一悬停才展开，点哪一行就把会话滚到哪一句。它只读会话、不发任何消息，模型完全无感。
 
-<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline2.png" width="480" alt="时间轴日常收成一条细线不占视线,悬停才展开">
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline1.png" width="640" alt="对话左缘展开的消息时间轴：每行一条用户消息，点行即跳转到对应消息">
 
 ## 特性
 
-- **每行一条用户消息**——竖刻度加单行省略预览;steering 消息也计入(可配置关闭)。
-- **环境化静止态**——只显示压淡的刻度,悬停刻度条或聚焦列表才展开文字。
-- **阅读位置跟踪**——当前位置的刻度保持蓝色高亮,停在超长回复中时锚定在所回答的用户消息上。
-- **点击跳转**——点击行把会话滚动到对应消息;列表跟随阅读位置。
-- **长历史友好**——列表短时垂直居中,长时隐形滚动并在顶部翻页加载更早历史。
+- **每行一条用户消息**——竖刻度加单行省略预览；steering 消息也计入（可配置关闭），message-tools 的编辑/恢复气泡也保留一行。被撤回的原消息不展示（其会话行被隐藏，点击也到不了）。
+- **环境化静止态**——只显示压淡的刻度，悬停刻度条或聚焦列表才展开文字。
+- **阅读位置跟踪**——当前位置的刻度保持蓝色高亮，停在超长回复中时锚定在所回答的用户消息上。
+- **点击跳转**——点击行把会话滚动到对应消息；列表跟随阅读位置。
+- **长历史友好**——列表短时垂直居中；长时隐形滚动并在顶部翻页加载更早历史，最底部贴着聊天输入框；目标/任务等 dock 卡片不会把时间轴顶上去。
+- **绝不遮住消息流**——面板宽度受滚动区左缘沟槽约束；沟槽放不下最小宽度时隐藏而不是盖住会话。
+
+<img src="https://raw.githubusercontent.com/Khorsheed/dsh-web-basic/main/docs/screenshots/message-timeline2.png" width="640" alt="时间轴的静止态：收成一排压淡的刻度条，不挡视线，悬停才展开">
 
 ## 安装
 
@@ -22,7 +25,7 @@ dsh web GUI 的历史消息导览:会话左缘的一条悬浮时间轴,每行一
 dsh plugin --profile web add @khorsheed/dsh-message-timeline
 ```
 
-然后重启 web 实例。卸载:
+然后重启 web 实例。卸载：
 
 ```sh
 dsh plugin --profile web remove @khorsheed/dsh-message-timeline
@@ -32,47 +35,52 @@ dsh plugin --profile web remove @khorsheed/dsh-message-timeline
 
 | 字段 | 默认 | 含义 |
 | --- | --- | --- |
-| `enabled` | `true` | 总开关;false 时面板完全不渲染。 |
-| `includeSteering` | `true` | 回合中插入的用户消息(steering)是否也算行。 |
-| `panelWidth` | `360` | 面板宽度(px,限 120–640);窄列自动收缩,左缘沟槽放不下时整条隐藏。 |
-| `initialPages` | `5` | 面板打开时预取的历史页数(每页 50 条事件);更早历史在面板滚动到顶部时按需加载(限 1–20)。 |
+| `enabled` | `true` | 总开关；false 时面板完全不渲染。 |
+| `includeSteering` | `true` | 回合中插入的用户消息（steering）是否也算行。 |
+| `panelWidth` | `360` | 面板宽度（px，限 120–640）；窄列自动收缩，左缘沟槽放不下时整条隐藏。 |
+| `initialPages` | `5` | 面板打开时预取的历史页数（每页 50 条事件）；更早历史在面板滚动到顶部时按需加载（限 1–20）。 |
 
 ## Compatibility
 
-- npm 发布线（`@deepseek-ai/dsh@0.1.1-rc.2`）：✅ 完整——rc.8→0.1.1-rc.1 API 审计（2026-08-21）确认本插件消费的所有面无变化或纯增量（ProjectionDefinition 重构、cacheHitPercent 返回值变更、credentials/updated 事件改名均不涉及本包），无需改动源码；rc.1→rc.2 复核（2026-08-22）：消费面无变化，全量构建测试通过。
-- 源码线(deepseek-harness master):✅
+- npm 发布线（`@deepseek-ai/dsh@0.1.2-rc.1`）：✅ 完整——基线迁移至 0.1.2-rc.1 API 面（单臂消费 0.1.2 API，0.1.1-rc.2 运行臂已退役），全量构建测试通过；minHost 前移至 0.1.2-rc.1，旧宿主请停留在旧发布线。
+- 源码线（deepseek-harness master）：✅（verifiedHost: 0.1.2-rc.1）
+
+**版本线对照**：0.2.0 起支持宿主 `0.1.2-rc.1` 及以后；宿主 `0.1.0-rc.6` ~ `0.1.1-rc.2` 的用户请停留在 0.1.x 发布线（末版 `0.1.0`）。
 
 ## 已知限制
 
-- **依赖官方 DOM 探针** —— 面板针对官方行属性与 `[data-conversation-scroll]` 滚动区;官方结构变化时面板自行隐藏(console.warn 一次)直到探针更新。
+- **依赖官方 DOM 探针** —— 面板针对官方行属性与 `[data-conversation-scroll]` 滚动区；官方结构变化时面板自行隐藏（console.warn 一次）直到探针更新。
+- **best-effort 宽度兜底** —— 消息流探针无应答时，面板以滚动区受限比例渲染而非隐藏，可能压到消息流直到探针恢复；探针健康时宽度绝不越过消息流左缘。
 - **单会话渲染** —— 行与跳转只作用于当前渲染的会话。
-- **仅已加载历史** —— 行覆盖已物化的节点;更早消息在面板滚动到顶部时逐页加载。
+- **仅已加载历史** —— 行覆盖已物化的节点；更早消息在面板滚动到顶部时逐页加载。
 - **暂无整页导览** —— 可搜索的消息索引标签页在计划中。
 
 ## 实现原理
 
 <details>
-<summary>内部结构(点击展开)</summary>
+<summary>内部结构（点击展开）</summary>
 
 插件纯增量、不改任何官方代码。
 
-- `src/client/index.ts` —— 插件主体(`apply`/`inject`)
-- `src/client/rail-tracker.ts` —— 插件唯一接触的 DOM:只读探针加跳转时的滚动写入
+- `src/client/index.ts` —— 插件主体（`apply`/`inject`）
+- `src/client/rail-tracker.ts` —— 插件唯一接触的 DOM：只读探针、阅读位置解析，加跳转时的滚动写入
 - `src/client/TimelineRail.tsx` —— 面板组件
+- `src/client/timeline-kinds.ts` —— 哪些 kind 算行、哪些 kind 携带隐藏范围，的唯一权威
+- `src/client/hidden-spans.ts` —— 折叠 message-tools 撤回/编辑范围，把被覆盖的原消息作为死行丢弃
 - `src/client/preview.ts` —— 消息内容转单行预览文本
-- `src/index.ts` —— 空的宿主 `apply`,只负责把插件锚定进宿主 Loader
+- `src/index.ts` —— 空的宿主 `apply`，只负责把插件锚定进宿主 Loader
 
-**挂载与数据** —— 一个条目注册进官方 `conversation.session.header.utilities` 槽位,把插件锚定进会话作用域;面板通过 body portal 以固定几何渲染,数据从官方滚动区实测。行取自框架 `useSession` 会话快照(`s.chat.order` / `s.chat.nodes`),过滤 `user` / `steering` 节点——不持有会话外状态,不注册事件。
+**挂载与数据** —— 一个条目注册进官方 `conversation.session.header.utilities` 槽位，把插件锚定进会话作用域；面板通过 body portal 以固定几何渲染，数据从官方滚动区实测。行取自框架 `useSession` 会话快照（`s.chat.order` / `s.chat.nodes`）：普通 `user`（及可选 `steering`）行来自宿主 order，而宿主 order 未必补上的 message-tools `message-tools-edited`/`message-tools-restored` 气泡从节点库追加——不持有会话外状态，不注册事件。被撤回原消息的气泡会被丢弃（其会话行已被 DOM hider 隐藏，点击到不了），追加的气泡按锚定 seq 排序，保证最新消息恒为最后一行。
 
-**跳转与降级** —— 点击行按官方 `data-chat-anchor-key` 属性找到会话行并写 `scrollTop`;官方 ChatView 把这种程序化滚动当正常读者移动处理(底部跟随与滚动记忆照常工作)。探测的属性是官方渲染产物而非契约 API:官方改结构时面板自行隐藏并 console.warn 一次,不抛错、boot 永不失败。
+**跳转与降级** —— 点击行按官方 `data-chat-anchor-key` 属性找到会话行并写 `scrollTop`；官方 ChatView 把这种程序化滚动当正常读者移动处理（底部跟随与滚动记忆照常工作）。探测的属性是官方渲染产物而非契约 API：官方改结构时面板自行隐藏并 console.warn 一次，不抛错、boot 永不失败。面板宽度受左缘沟槽约束、不越过消息流左缘；流探针无应答（官方结构变化）时宽度退化为滚动区受限比例以 best-effort 兜底——此时面板可能压到消息流，直到探针恢复。
 
-**模型体验:无。** 面板只读会话快照并滚动会话,不发送提示词、不追加会话事件、不进会话日志。KV 缓存影响:无。`enabled` 配置可整体关闭插件;从 cordis.yml 移除本插件即移除它添加的所有界面。
+**模型体验：无。** 面板只读会话快照并滚动会话，不发送提示词、不追加会话事件、不进会话日志。KV 缓存影响：无。`enabled` 配置可整体关闭插件；从 cordis.yml 移除本插件即移除它添加的所有界面。
 
 </details>
 
 ## 开发
 
-隶属 [dsh-plugins](https://github.com/Khorsheed/dsh-plugins) monorepo(`packages/message-timeline`)。问题与贡献请移步该仓库。
+隶属 [dsh-plugins](https://github.com/Khorsheed/dsh-plugins) monorepo（`packages/message-timeline`）。问题与贡献请移步该仓库。
 
 ## 变更记录
 

package/lib/client.js

@@ -40,6 +40,27 @@ window.__ModuleLoader__.load({
 			"rail.panel": "Message timeline",
 			"rail.empty": "No user messages"
 		};
+		/**
+		* Whether a node kind renders as a timeline row. The rail lists user messages
+		* (and optionally steering), plus the message-tools edited/restored bubbles
+		* that the host `order` does not always surface.
+		* @param kind - the node's kind string.
+		* @param includeSteering - whether steering rows count as user messages.
+		* @returns true when the kind belongs on the timeline.
+		*/
+		function isTimelineRowKind(kind, includeSteering) {
+			return kind === "user" || includeSteering && kind === "steering" || kind === "message-tools-edited" || kind === "message-tools-restored";
+		}
+		/**
+		* Whether a node kind carries a hidden span (`{ hiddenStartSeq, seq }`) that
+		* the rail must fold to drop the covered originals. The withdrawal divider and
+		* the edited bubble both declare the span they shadow.
+		* @param kind - the node's kind string.
+		* @returns true when the kind declares a hidden span.
+		*/
+		function isHiddenSpanCarrierKind(kind) {
+			return kind === "message-tools-withdrawn" || kind === "message-tools-edited";
+		}
 		//#endregion
 		//#region src/client/rail-tracker.ts
 		/** Horizontal inset of the rail from the scrollport's left edge (px). */
@@ -62,10 +83,15 @@ window.__ModuleLoader__.load({
 		};
 		/**
 		* Measure the panel's viewport box from one scrollport: its rect inset by the
-		* panel padding, minus the sticky composer seat at the bottom and the
-		* conversation tab strip at the top. The tabs render just above the
-		* scrollport, but centering reads against the whole window, so the strip
-		* height leaves the box either way — otherwise the list sits visibly high.
+		* panel padding, minus the chat input card at the bottom and the conversation
+		* tab strip at the top. The tabs render just above the scrollport, but
+		* centering reads against the whole window, so the strip height leaves the
+		* box either way — otherwise the list sits visibly high.
+		* The bottom ends at the `[data-composer-card]` top — the chat box — NOT the
+		* whole `[data-composer-seat]` top: dock cards (goal/todo/queue) sit above
+		* the input inside the seat, and counting them would push the timeline up off
+		* the conversation. Falls back to the seat top, then the column bottom, when
+		* the markers are absent.
 		* The scrollport's own width rides along for the width-cap fallback when the
 		* message-flow probe is unanswered.
 		* @param scrollport - the official conversation scrollport element.
@@ -75,7 +101,6 @@ window.__ModuleLoader__.load({
 		function measureGeometry(scrollport) {
 			const rect = scrollport.getBoundingClientRect();
 			if (rect.width === 0 && rect.height === 0) return null;
-			const composerHeight = scrollport.querySelector("[data-composer-seat]")?.getBoundingClientRect().height ?? 0;
 			let topInset = RAIL_VERTICAL_PADDING;
 			for (const tabs of scrollport.ownerDocument.querySelectorAll("[role=\"tablist\"]")) {
 				const tabsRect = tabs.getBoundingClientRect();
@@ -84,25 +109,40 @@ window.__ModuleLoader__.load({
 					break;
 				}
 			}
+			const card = scrollport.querySelector("[data-composer-card]");
+			const seat = scrollport.querySelector("[data-composer-seat]");
+			const bottom = card !== null ? card.getBoundingClientRect().top - RAIL_VERTICAL_PADDING : seat !== null ? seat.getBoundingClientRect().top - RAIL_VERTICAL_PADDING : rect.bottom - RAIL_VERTICAL_PADDING;
 			return {
 				left: rect.left + RAIL_LEFT_INSET,
 				top: rect.top + topInset,
-				height: Math.max(0, rect.height - composerHeight - topInset - RAIL_VERTICAL_PADDING),
+				height: Math.max(0, bottom - rect.top - topInset),
 				width: rect.width
 			};
 		}
 		/**
 		* The viewport x of the message flow's left edge: the left of the first
-		* rendered `[data-chat-flow-kind]` row, which sits flush inside the official
-		* centered content column (max 748px, `margin: 0 auto`). Every flow row
-		* shares that edge, so the first one found suffices. The panel's right edge
-		* stays left of it — the panel may only occupy the scrollport's left gutter.
+		* laid-out `[data-chat-flow-kind]` row, which sits flush inside the official
+		* centered content column (max 748px, `margin: 0 auto`). Laid-out flow rows
+		* share that edge, so the first meaningful one suffices. The panel's right
+		* edge stays left of it — the panel may only occupy the scrollport's left
+		* gutter.
+		*
+		* Rows that are not laid out in the flow are skipped: a message-tools edit
+		* leaves the withdrawn originals in the DOM (hidden, zero-size, or off the
+		* column at x=0), and probing their left edge yields 0 — which would make the
+		* width gate compute a negative left gutter and hide the entire rail. Any
+		* real flow row sits inside the conversation column at a positive x.
 		* @param scrollport - the official conversation scrollport element.
-		* @returns the flow's left edge, or null while no flow row is rendered.
+		* @returns the flow's left edge, or null while no laid-out flow row is rendered.
 		*/
 		function flowLeftX(scrollport) {
-			const row = scrollport.querySelector("[data-chat-flow-kind]");
-			return row === null ? null : row.getBoundingClientRect().left;
+			for (const row of scrollport.querySelectorAll("[data-chat-flow-kind]")) {
+				const rect = row.getBoundingClientRect();
+				if (rect.width === 0 && rect.height === 0) continue;
+				if (rect.left <= 0) continue;
+				return rect.left;
+			}
+			return null;
 		}
 		/**
 		* Resolve the key of the user-message row the reading position belongs to:
@@ -120,7 +160,7 @@ window.__ModuleLoader__.load({
 			let lastAbove = null;
 			for (const row of scrollport.querySelectorAll("[data-chat-flow-kind]")) {
 				const kind = row.dataset.chatFlowKind;
-				if (kind !== "user" && !(includeSteering && kind === "steering")) continue;
+				if (kind === void 0 || !isTimelineRowKind(kind, includeSteering)) continue;
 				if (row.getBoundingClientRect().bottom <= viewTop) {
 					lastAbove = row.dataset.chatAnchorKey ?? lastAbove;
 					continue;
@@ -159,6 +199,7 @@ window.__ModuleLoader__.load({
 			let resizeObserver;
 			let rafPending = false;
 			let warned = false;
+			let bindToken = 0;
 			const nextFrame = typeof requestAnimationFrame === "function" ? requestAnimationFrame : (callback) => {
 				setTimeout(callback, 16);
 			};
@@ -168,9 +209,28 @@ window.__ModuleLoader__.load({
 				state = next;
 				for (const fn of [...listeners]) fn();
 			};
+			const attach = (el) => {
+				if (scrollport !== null) scrollport.removeEventListener("scroll", onScroll);
+				resizeObserver?.disconnect();
+				scrollport = el;
+				scrollport.addEventListener("scroll", onScroll, { passive: true });
+				if (typeof ResizeObserver === "function") {
+					resizeObserver = new ResizeObserver(scheduleUpdate);
+					resizeObserver.observe(el);
+					const composer = el.querySelector("[data-composer-seat]");
+					if (composer !== null) resizeObserver.observe(composer);
+				}
+			};
 			const update = () => {
-				if (scrollport === null) return;
-				const geometry = measureGeometry(scrollport);
+				let el = scrollport;
+				if (el === null || !el.isConnected) {
+					if (activeSession === void 0) return;
+					const found = document.querySelector("[data-conversation-scroll]");
+					if (found === null) return;
+					attach(found);
+					el = found;
+				}
+				const geometry = measureGeometry(el);
 				if (geometry === null) return;
 				publish({
 					sessionId: activeSession,
@@ -179,9 +239,9 @@ window.__ModuleLoader__.load({
 					top: geometry.top,
 					height: geometry.height,
 					scrollportWidth: geometry.width,
-					flowLeft: flowLeftX(scrollport),
-					activeKey: activeRowKey(scrollport, includeSteering),
-					chatView: scrollport.querySelector("[data-chat-flow]") !== null
+					flowLeft: flowLeftX(el),
+					activeKey: activeRowKey(el, includeSteering),
+					chatView: el.querySelector("[data-chat-flow]") !== null
 				});
 			};
 			const scheduleUpdate = () => {
@@ -196,6 +256,7 @@ window.__ModuleLoader__.load({
 				scheduleUpdate();
 			};
 			const teardownBind = () => {
+				bindToken++;
 				if (scrollport !== null) scrollport.removeEventListener("scroll", onScroll);
 				scrollport = null;
 				resizeObserver?.disconnect();
@@ -210,7 +271,9 @@ window.__ModuleLoader__.load({
 					publish(IDLE);
 					return;
 				}
+				const token = bindToken;
 				nextFrame(() => {
+					if (token !== bindToken) return;
 					const found = document.querySelector("[data-conversation-scroll]");
 					if (found === null) {
 						if (!warned) {
@@ -220,14 +283,7 @@ window.__ModuleLoader__.load({
 						publish(IDLE);
 						return;
 					}
-					scrollport = found;
-					scrollport.addEventListener("scroll", onScroll, { passive: true });
-					if (typeof ResizeObserver === "function") {
-						resizeObserver = new ResizeObserver(scheduleUpdate);
-						resizeObserver.observe(scrollport);
-						const composer = scrollport.querySelector("[data-composer-seat]");
-						if (composer !== null) resizeObserver.observe(composer);
-					}
+					attach(found);
 					update();
 				});
 			};
@@ -235,7 +291,7 @@ window.__ModuleLoader__.load({
 				bind(ctx.sessions.list.getSnapshot().current);
 			};
 			const stopList = ctx.sessions.list.subscribe(bindCurrent);
-			const stopProvide = ctx.sessions.currentProvideInfo.subscribe(bindCurrent);
+			const stopProvide = ctx.sessions.currentProvideInfo?.subscribe(bindCurrent);
 			bindCurrent();
 			const onWindowResize = () => {
 				scheduleUpdate();
@@ -264,7 +320,7 @@ window.__ModuleLoader__.load({
 				},
 				dispose: () => {
 					stopList();
-					stopProvide();
+					stopProvide?.();
 					if (typeof window !== "undefined") window.removeEventListener("resize", onWindowResize);
 					mutationObserver?.disconnect();
 					teardownBind();
@@ -272,6 +328,26 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/chat-hook.ts
+		/** Empty slice behind the absent-prop degrade: no rows, so the panel hides. */
+		const EMPTY_SLICE = {
+			order: [],
+			nodes: {
+				get: () => void 0,
+				values: () => []
+			}
+		};
+		/** Constant hook answering every selector from the empty slice. */
+		const EMPTY_HOOK = (selector) => selector(EMPTY_SLICE);
+		/**
+		* Pick the live chat hook for this entry.
+		* @param props - the entry's composed props (useChat present on 0.1.2 hosts).
+		* @returns the `useChat` prop, or the empty-slice hook when the seat is absent.
+		*/
+		function chatHookOf(props) {
+			return props.useChat ?? EMPTY_HOOK;
+		}
+		//#endregion
 		//#region src/client/preview.ts
 		/**
 		* Join the text blocks of one message into a single preview string.
@@ -284,7 +360,44 @@ window.__ModuleLoader__.load({
 			return parts.length === 0 ? null : parts.join("\n");
 		}
 		//#endregion
-		//#region \0dsh-css:/Users/zhuyudan/code/dsh-plugins/packages/message-timeline/src/client/TimelineRail.module.css.mjs
+		//#region src/client/hidden-spans.ts
+		/**
+		* Fold the hidden seq spans out of the store into the flat
+		* `[start, endExclusive, ...]` pair list ordered by start — the same shape
+		* message-tools' renderers and DOM hider consume (`{ hiddenStartSeq, seq }`,
+		* inclusive start, exclusive end). A malformed carrier (missing or inverted
+		* bounds) is skipped rather than poisoning the fold.
+		* @param nodes - every materialized chat node (any order).
+		* @returns the flattened hidden spans; empty when no withdraw/edit landed.
+		*/
+		function foldHiddenSpans(nodes) {
+			const pairs = [];
+			for (const node of nodes) {
+				if (!isHiddenSpanCarrierKind(node.kind)) continue;
+				const data = node.data;
+				if (data.hiddenStartSeq === void 0 || data.seq === void 0) continue;
+				if (data.hiddenStartSeq >= data.seq) continue;
+				pairs.push([data.hiddenStartSeq, data.seq]);
+			}
+			pairs.sort((left, right) => left[0] - right[0]);
+			return pairs.flat();
+		}
+		/**
+		* Whether a node seq falls inside one of the folded hidden spans.
+		* @param spans - the flattened spans from {@link foldHiddenSpans}.
+		* @param seq - the node seq to test.
+		* @returns true when the seq is hidden (a withdrawn original).
+		*/
+		function isSeqHidden(spans, seq) {
+			for (let index = 0; index + 1 < spans.length; index += 2) {
+				const start = spans[index];
+				const end = spans[index + 1];
+				if (start !== void 0 && end !== void 0 && seq >= start && seq < end) return true;
+			}
+			return false;
+		}
+		//#endregion
+		//#region \0dsh-css:src/client/TimelineRail.module.css.mjs
 		const css = "._8u17xW_panel{scrollbar-width:none;z-index:100;pointer-events:none;flex-direction:column;padding:4px 8px;display:flex;position:fixed;overflow-y:auto}._8u17xW_panel:before,._8u17xW_panel:after{content:\"\";margin:auto}._8u17xW_panel::-webkit-scrollbar{display:none}._8u17xW_item{width:100%;max-width:20px;color:var(--dsw-alias-label-tertiary);text-align:left;cursor:pointer;-webkit-user-select:none;user-select:none;pointer-events:auto;opacity:.55;background:0 0;border:none;flex:none;align-items:center;gap:8px;padding:5px 0;font-size:13px;line-height:1.5;transition:opacity .12s;display:flex}._8u17xW_panel:hover ._8u17xW_item,._8u17xW_panel:focus-within ._8u17xW_item{opacity:1;max-width:100%}._8u17xW_tick{background:var(--dsw-static-deepseek-400);border-radius:2px;flex:none;width:3px;height:14px}._8u17xW_itemCurrent{color:var(--dsw-static-deepseek-500);opacity:.75}._8u17xW_tickCurrent{background:var(--dsw-static-deepseek-500)}._8u17xW_itemText{white-space:nowrap;text-overflow:ellipsis;opacity:0;transition:opacity .12s;overflow:hidden}._8u17xW_panel:hover ._8u17xW_itemText,._8u17xW_panel:focus-within ._8u17xW_itemText{opacity:1;transition-delay:90ms}._8u17xW_itemFocused{color:var(--dsw-alias-label-primary);font-weight:600}._8u17xW_item:focus:not(:focus-visible){outline:none}._8u17xW_item:focus-visible{outline:1px solid var(--dsw-alias-state-business-primary);outline-offset:1px}";
 		const tagId = "@khorsheed/dsh-message-timeline/TimelineRail.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
@@ -295,13 +408,13 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var TimelineRail_module_css_default = {
-			"panel": "_8u17xW_panel",
-			"itemText": "_8u17xW_itemText",
+			"item": "_8u17xW_item",
 			"tick": "_8u17xW_tick",
 			"itemCurrent": "_8u17xW_itemCurrent",
-			"itemFocused": "_8u17xW_itemFocused",
+			"panel": "_8u17xW_panel",
 			"tickCurrent": "_8u17xW_tickCurrent",
-			"item": "_8u17xW_item"
+			"itemText": "_8u17xW_itemText",
+			"itemFocused": "_8u17xW_itemFocused"
 		};
 		//#endregion
 		//#region src/client/TimelineRail.tsx
@@ -337,24 +450,47 @@ window.__ModuleLoader__.load({
 		* @param props - composed props (see {@link TimelineRailProps}).
 		* @returns nothing visible in the seat; the floating panel while the chat view shows.
 		*/
-		function TimelineRail({ useSession, sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t }) {
+		function TimelineRail({ sessionId, includeSteering, panelWidth, initialPages, loadOlder, jumpTo, useRail, t, ...standard }) {
 			const rail = useRail((s) => s);
-			const order = useSession((s) => s.chat.order);
-			const nodes = useSession((s) => s.chat.nodes);
+			const useChatSlice = chatHookOf(standard);
+			const useSession = standard.useSession;
+			const order = useChatSlice((c) => c.order);
+			const nodes = useChatSlice((c) => c.nodes);
 			const hasMore = useSession((s) => s.hasMore);
 			const loadingOlder = useSession((s) => s.loadingOlder);
 			const items = (0, react.useMemo)(() => {
+				let store = [];
+				let spans = [];
+				try {
+					store = nodes.values();
+					spans = foldHiddenSpans(store);
+				} catch {}
+				const hidden = (node) => isSeqHidden(spans, node.anchorSeq);
 				const result = [];
+				const seen = /* @__PURE__ */ new Set();
 				for (const key of order) {
 					const node = nodes.get(key);
 					if (node === void 0) continue;
-					const kind = node.kind;
-					if (kind !== "user" && !(includeSteering && kind === "steering")) continue;
+					if (!isTimelineRowKind(node.kind, includeSteering)) continue;
+					if (hidden(node)) continue;
 					result.push({
 						key,
 						node
 					});
+					seen.add(key);
+				}
+				for (const node of store) {
+					if (node.kind !== "message-tools-edited" && node.kind !== "message-tools-restored") continue;
+					if (node.visibility === "hidden") continue;
+					if (seen.has(node.key)) continue;
+					if (hidden(node)) continue;
+					result.push({
+						key: node.key,
+						node
+					});
+					seen.add(node.key);
 				}
+				result.sort((left, right) => left.node.anchorSeq - right.node.anchorSeq);
 				return result;
 			}, [
 				order,