dsh-turn-outline 0.2.6 → 0.3.1

package/README.en.md

@@ -5,7 +5,8 @@
 [![License: MIT](https://img.shields.io/github/license/Andor-Z/dsh-turn-outline)](LICENSE)
 [![GitHub release](https://img.shields.io/github/v/release/Andor-Z/dsh-turn-outline)](https://github.com/Andor-Z/dsh-turn-outline/releases)
 [![dsh-plugin](https://img.shields.io/badge/GitHub-dsh--plugin-blue)](https://github.com/topics/dsh-plugin)
-[![better-sidebar](https://img.shields.io/badge/better--sidebar-%5E0.17.0-6e56cf)](https://github.com/omdsh-dev/DSH-better-sidebar)
+[![better-sidebar](https://img.shields.io/badge/better--sidebar-%3E%3D0.17.0-6e56cf)](https://github.com/omdsh-dev/DSH-better-sidebar)
+[![dsh](https://img.shields.io/badge/DSH-0.2.0--rc.x_primary-0064ff)](https://github.com/omdsh-dev/DSH-better-sidebar)
 
 [中文](README.md)
 
@@ -24,7 +25,7 @@
 **What it solves**:
 
 - **Fold the session into user turns** — the conversation is collapsed into a structured "input → tool steps → output" trail, so long sessions become scannable at a glance; multi-level folding inside a turn plus tool-type filter chips let you focus on what matters.
-- **Structured jump-back** — click any turn / tool step to auto-load history and scroll to the matching row in the chat view / trajectory view. Navigation goes through the client `sessions` service (`loadOlder` + `anchorSeq` + `data-chat-anchor-key`) — no dependence on DOM text or hashed class names.
+- **Structured jump-back** — click any turn / tool step to auto-load history and scroll to the matching row in the chat view / trajectory view. On 0.2.0 navigation goes through the client `uiConversation` conversation view registry (`anchorSeq` node matching + `loadOlder` paging); on 0.1.x it falls back to the legacy session snapshot — no dependence on DOM text or hashed class names.
 - **Zero AI dependency** — pure event folding, no LLM calls: zero tokens, instant open, no failure states.
 - **Read-only & non-invasive** — never touches the DSH core: one read-only host route + one client tab; registers cleanly and unloads without residue.
 - **Incremental performance** — refreshes are driven by session subscriptions (no polling); `TrailFolder` only re-folds open turns (O(delta)); seq-keyed rows reconcile in place instead of remounting.
@@ -37,16 +38,16 @@
 
 ### Option 1: one-liner from npm (recommended)
 
-Install better-sidebar first (stable line pinned to 0.17.x), then this plugin:
+Install better-sidebar first, then this plugin:
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile desktop add dsh-better-sidebar@0.17.1
+npx @deepseek-ai/dsh plugin --profile desktop add dsh-better-sidebar
 npx @deepseek-ai/dsh plugin --profile desktop add dsh-turn-outline
 ```
 
 > Using the Web profile? Swap `--profile desktop` for `--profile web`.
 >
-> ⚠️ **Version-line note**: this plugin is currently validated on **better-sidebar 0.17.x + DSH 0.1.1-rc.x (stable)**. The npm `latest` better-sidebar 0.18.0 supports only DSH 0.1.2-rc.1+ and has not been co-tested with this plugin — until a 0.18-adapted release, pin `dsh-better-sidebar@0.17.1` before upgrading your host.
+> ℹ️ **Version-line note**: **since 0.3.0 the primary line is DSH 0.2.0-rc.x** (tested against the DSH Desktop 2.0.17 bundled runtime + better-sidebar 0.24.1; jump-back rides the `uiConversation` conversation view registry and the host live path uses `snapshotEvents()`). The 0.1.x lines stay fallback-compatible — **better-sidebar 0.18.0 + DSH 0.1.2-rc.1** and **better-sidebar 0.17.1 + DSH 0.1.1-rc.x (stable)**: on older hosts the plugin automatically uses the legacy snapshot jump and the `.events` live path, with no configuration. Note that better-sidebar 0.18.0 supports only DSH 0.1.2-rc.1+: on an older stable host (0.1.0-rc.8 ~ 0.1.1-rc.2), pin `dsh-better-sidebar@0.17.1`.
 
 ### Option 2: install from source (development / offline)
 
@@ -78,28 +79,32 @@ npx @deepseek-ai/dsh plugin --profile desktop remove dsh-turn-outline
 
 ```
 host (Node)      inject: ['webServer','sessionQuery','sessions']
-  POST /turntrail/api/events { sessionId, afterSeq }
-  → live sessions: borrow the frozen snapshot of the live store (O(1) probe + O(delta) projection, zero deep clones)
+  POST /turn-outline/api/events { sessionId, afterSeq }
+  → live sessions: borrow the frozen snapshot of the live store (snapshotEvents() on DSH
+    0.2.0, the .events property on 0.1.x; O(1) probe + O(delta) projection, zero deep clones)
   → cold sessions: sessionQuery persisted log + lastSeq cache (LRU + byte cap)
   → paged responses (PAGE_SIZE events per page, hasMore semantics) + field trimming (no full tool-result payloads)
   → 200 { events, hasMore } / 400 / 403 / 404 / 405 / 413
 
-client (browser) inject: ['sessions','betterSidebar'] (betterSidebar is an optional peer)
-  → registerTab({ id:'turn-outline', single:true })
-  → subscription-driven refresh (no polling) + incremental folding (TrailFolder: only re-folds open turns)
+client (browser) inject: ['sessions','uiConversation','betterSidebar'] (the latter two are optional peers)
+  → registerTab({ id:'turn-outline', single:true, description })
+  → jump-back: on 0.2.0 the ctx.uiConversation conversation view registry (chat/trajectory
+    targets); on 0.1.x the legacy session snapshot's chat.nodes / views fields
+  → subscription-driven refresh (session.subscribe + the 0.2.0 eventSource; no polling)
+    + incremental folding (TrailFolder: only re-folds open turns)
     + seq-keyed rows (append without remount) + per-turn React.memo + three-level folding + tool filter chips
 ```
 
 ## Performance design (introduced in v0.2.1)
 
-- **No more deep-cloning the whole log on the host**: the old `listEvents` probe and `readSession` read each `structuredClone` every event (~3 full deep clones per request for live sessions). Live sessions now borrow the store's frozen `events` snapshot directly (the cached, immutable array is reused): O(1) probe, O(delta) incremental reads, fully synchronous, zero copies.
+- **No more deep-cloning the whole log on the host**: the old `listEvents` probe and `readSession` read each `structuredClone` every event (~3 full deep clones per request for live sessions). Live sessions now borrow the store's frozen event snapshot directly (`snapshotEvents()` on 0.2.0 / the `events` property on 0.1.x — the cached, immutable array is reused): O(1) probe, O(delta) incremental reads, fully synchronous, zero copies.
 - **Paged + trimmed responses**: at most `PAGE_SIZE` events per page (`hasMore` pulls the rest; first paint renders progressively); events project only the fields folding needs (text capped at `TEXT_CAP`, arguments at `ARGS_CAP`, `tool/result` keeps only the error field — the largest transfer/memory cost is gone).
 - **Incremental client folding**: `TrailFolder.push()` consumes each event exactly once; `snapshot()` reuses the TrailTurn objects of already-sealed turns (stable identity → `React.memo` re-renders only open turns), turning each refresh from O(n) full refolds into O(delta); duplicate/re-sent pages are dropped by the seq watermark.
 - **Rows keyed by seq**: appended steps reconcile in place in the DOM instead of shifting indexes and remounting whole chunks.
 
 ## Permissions & data
 
-- **Session logs**: one read-only host route `POST /turntrail/api/events`, browser same-origin + Host-header trust fence; read-only, never writes or mutates the session.
+- **Session logs**: one read-only host route `POST /turn-outline/api/events`, browser same-origin + Host-header trust fence; read-only, never writes or mutates the session.
 - **Zero LLM calls**: nothing is sent to any model; no token consumption.
 - **No credential access**: no other network/file access besides session events; no user config, no persistent storage (tab state follows better-sidebar's layout persistence).
 
@@ -107,17 +112,18 @@ client (browser) inject: ['sessions','betterSidebar'] (betterSidebar is an optio
 
 | Item | Value |
 |---|---|
-| Platform | DSH 0.1.1-rc.x (stable line; web/desktop profile) |
-| Dependencies | dsh-better-sidebar (optional peer; inert when absent), react (injected by the DSH client seed) |
+| Platform (primary) | DSH 0.2.0-rc.x (tested against the DSH Desktop 2.0.17 bundled runtime; web/desktop profile) |
+| Platform (fallback-compatible) | DSH 0.1.2-rc.1 / 0.1.1-rc.x (stable line) |
+| Dependencies | dsh-better-sidebar (optional peer, `>=0.17.0`; inert when absent), react (injected by the DSH client seed) |
 | Build | TypeScript + esbuild, no runtime npm dependencies |
-| Tests | vitest, 80 cases (fold / folder / jump / tab / host) |
+| Tests | vitest, 100 cases (fold / folder / jump / tab / host) |
 
 ## Development
 
 ```sh
 pnpm install          # if pnpm 10+ blocks build scripts, allow esbuild as prompted (see pnpm-workspace.yaml)
 pnpm typecheck        # tsc --noEmit
-pnpm test             # vitest run (80 cases)
+pnpm test             # vitest run (100 cases)
 pnpm build            # esbuild → lib/index.js + lib/client.js (includes bundle-contract self check)
 pnpm pack             # produces dsh-turn-outline-<version>.tgz (prepack rebuilds automatically)
 ```

package/README.md

@@ -5,7 +5,8 @@
 [![License: MIT](https://img.shields.io/github/license/Andor-Z/dsh-turn-outline)](LICENSE)
 [![GitHub release](https://img.shields.io/github/v/release/Andor-Z/dsh-turn-outline)](https://github.com/Andor-Z/dsh-turn-outline/releases)
 [![dsh-plugin](https://img.shields.io/badge/GitHub-dsh--plugin-blue)](https://github.com/topics/dsh-plugin)
-[![better-sidebar](https://img.shields.io/badge/better--sidebar-%5E0.17.0-6e56cf)](https://github.com/omdsh-dev/DSH-better-sidebar)
+[![better-sidebar](https://img.shields.io/badge/better--sidebar-%3E%3D0.17.0-6e56cf)](https://github.com/omdsh-dev/DSH-better-sidebar)
+[![dsh](https://img.shields.io/badge/DSH-0.2.0--rc.x_主线-0064ff)](https://github.com/omdsh-dev/DSH-better-sidebar)
 
 [English](README.en.md)
 
@@ -24,7 +25,7 @@
 **解决什么问题**：
 
 - **按用户轮次折叠轨迹** —— 会话被折叠成「输入 → 工具步骤 → 输出」的结构化轨迹，长会话一目了然；轮次内支持多级折叠与工具类型筛选 chips，只看你想看的部分。
-- **一键跳回原位** —— 点击任意轮次 / 工具步骤，自动加载历史并滚动到聊天视图 / 轨迹视图的对应行；走 client `sessions` 服务（`loadOlder` + `anchorSeq` + `data-chat-anchor-key`），不依赖 DOM 文本与哈希类名。
+- **一键跳回原位** —— 点击任意轮次 / 工具步骤，自动加载历史并滚动到聊天视图 / 轨迹视图的对应行；0.2.0 走 client `uiConversation` 会话视图注册表（`anchorSeq` 节点匹配 + `loadOlder` 翻页），0.1.x 回退旧 session 快照，不依赖 DOM 文本与哈希类名。
 - **零 AI 依赖** —— 纯事件折叠，不调用 LLM：零 token、秒开、无失败态。
 - **只读零侵入** —— 不改动 DSH 核心：host 一个只读路由 + client 一个 tab，注册即用、卸载干净。
 - **增量性能** —— 会话订阅驱动刷新（无定时轮询）；`TrailFolder` 只重折打开中的轮次（O(delta)）；seq-keyed 行追加不重挂。
@@ -37,16 +38,16 @@
 
 ### 方式一：npm 一行命令（推荐）
 
-先装 better-sidebar（stable 线钉 0.17.x），再装本插件：
+先装 better-sidebar，再装本插件：
 
 ```sh
-npx @deepseek-ai/dsh plugin --profile desktop add dsh-better-sidebar@0.17.1
+npx @deepseek-ai/dsh plugin --profile desktop add dsh-better-sidebar
 npx @deepseek-ai/dsh plugin --profile desktop add dsh-turn-outline
 ```
 
 > 使用 Web profile 时把 `--profile desktop` 换成 `--profile web`。
 >
-> ⚠️ **版本线说明**：本插件当前验证于 **better-sidebar 0.17.x + DSH 0.1.1-rc.x（stable）**。npm `latest` 的 better-sidebar 0.18.0 仅支持 DSH 0.1.2-rc.1+，尚未与本插件联调——在 0.18 适配版发布前，升级宿主请先固定 `dsh-better-sidebar@0.17.1`。
+> ℹ️ **版本线说明**：**0.3.0 起以 DSH 0.2.0-rc.x 为主线**（DSH Desktop 2.0.17 内置运行时 + better-sidebar 0.24.1 实测联调；跳回走 `uiConversation` 会话视图注册表，host live 路径用 `snapshotEvents()`）。0.1.x 线继续回退兼容——**better-sidebar 0.18.0 + DSH 0.1.2-rc.1** 与 **better-sidebar 0.17.1 + DSH 0.1.1-rc.x（stable）**：旧宿主上插件自动走旧快照跳转与 `.events` live 路径，无需任何配置。注意 better-sidebar 0.18.0 仅支持 DSH 0.1.2-rc.1+：更旧的 stable 宿主（0.1.0-rc.8 ~ 0.1.1-rc.2）请固定安装 `dsh-better-sidebar@0.17.1`。
 
 ### 方式二：源码本地安装（开发 / 离线）
 
@@ -78,28 +79,32 @@ npx @deepseek-ai/dsh plugin --profile desktop remove dsh-turn-outline
 
 ```
 host（Node）  inject: ['webServer','sessionQuery','sessions']
-  POST /turntrail/api/events { sessionId, afterSeq }
-  → 活跃会话：直接借用 live store 冻结快照（O(1) 探测 + O(delta) 投影，零深拷贝）
+  POST /turn-outline/api/events { sessionId, afterSeq }
+  → 活跃会话：借用 live store 冻结快照（0.2.0 经 snapshotEvents()，0.1.x 读 .events；
+    O(1) 探测 + O(delta) 投影，零深拷贝）
   → 冷会话：sessionQuery 持久化日志 + lastSeq 缓存（LRU + 字节上限）
   → 响应逐页（每页 PAGE_SIZE 事件，hasMore 语义）+ 字段裁剪（不发 tool 结果全文）
   → 200 { events, hasMore } / 400 / 403 / 404 / 405 / 413
 
-client（浏览器）  inject: ['sessions','betterSidebar']（betterSidebar 可选 peer）
-  → registerTab({ id:'turn-outline', single:true })
-  → 会话订阅驱动刷新（无定时轮询）+ 增量折叠（TrailFolder：只重折打开中的轮次）
-    + seq-keyed 行（追加不重挂）+ 按轮次 React.memo + 三级折叠 + 工具筛选 chips
+client（浏览器）  inject: ['sessions','uiConversation','betterSidebar']（后两者可选 peer）
+  → registerTab({ id:'turn-outline', single:true, description })
+  → 跳回：0.2.0 走 ctx.uiConversation 会话视图注册表（chat/trajectory target）；
+    0.1.x 回退 session snapshot 的 chat.nodes / views 字段
+  → 会话订阅驱动刷新（session.subscribe + 0.2.0 eventSource，无定时轮询）
+  → 增量折叠（TrailFolder：只重折打开中的轮次）+ seq-keyed 行（追加不重挂）
+    + 按轮次 React.memo + 三级折叠 + 工具筛选 chips
 ```
 
 ## 性能设计（v0.2.1 引入）
 
-- **host 不再对整份日志做深拷贝**：旧的 `listEvents` 探测与 `readSession` 读取会对每个事件 `structuredClone`（活跃会话约 3 次全量深拷贝/请求）。现在活跃会话直接借用 store 的冻结 `events` 快照（复用不变数组），探测 O(1)、取增量 O(delta)，全程同步零拷贝。
+- **host 不再对整份日志做深拷贝**：旧的 `listEvents` 探测与 `readSession` 读取会对每个事件 `structuredClone`（活跃会话约 3 次全量深拷贝/请求）。现在活跃会话直接借用 store 的冻结事件快照（0.2.0 的 `snapshotEvents()` / 0.1.x 的 `events` 属性，复用不变数组），探测 O(1)、取增量 O(delta)，全程同步零拷贝。
 - **响应逐页 + 裁剪**：每页最多 `PAGE_SIZE` 事件（`hasMore` 续拉，首载渐进渲染）；事件只投影折叠所需字段（文本截断到 `TEXT_CAP`、arguments 到 `ARGS_CAP`、`tool/result` 只留 error 字段——最大的传输与内存占用被去掉）。
 - **client 增量折叠**：`TrailFolder.push()` 每事件只消费一次，`snapshot()` 复用已封口轮次的 TrailTurn 对象（身份稳定 → `React.memo` 只重渲染打开中的轮次），每轮刷新从 O(n) 全量重折降为 O(delta)；重复/重发的分页被 seq 水位线丢弃。
 - **行 key 用 seq**：新步骤追加时行在其 DOM 原位 reconcile，不再索引平移导致整段卸载重挂。
 
 ## 权限与数据
 
-- **会话日志**：host 只读路由 `POST /turntrail/api/events`，浏览器同源 + Host 头信任围栏；只读不回写、不改动会话。
+- **会话日志**：host 只读路由 `POST /turn-outline/api/events`，浏览器同源 + Host 头信任围栏；只读不回写、不改动会话。
 - **零 LLM 调用**：不向任何模型发送内容，无 token 消耗。
 - **不读取凭据**：除会话事件外无其他网络 / 文件访问；无用户配置、无持久化存储（tab 状态随 better-sidebar 布局持久化）。
 
@@ -107,17 +112,18 @@ client（浏览器）  inject: ['sessions','betterSidebar']（betterSidebar 可
 
 | 项 | 值 |
 |---|---|
-| 平台 | DSH 0.1.1-rc.x（stable 线；web/desktop profile） |
-| 依赖 | dsh-better-sidebar（可选 peer；未装则 inert）、react（DSH client 种子注入） |
+| 平台（主线） | DSH 0.2.0-rc.x（DSH Desktop 2.0.17 内置运行时实测；web/desktop profile） |
+| 平台（回退兼容） | DSH 0.1.2-rc.1 / 0.1.1-rc.x（stable 线） |
+| 依赖 | dsh-better-sidebar（可选 peer，`>=0.17.0`；未装则 inert）、react（DSH client 种子注入） |
 | 构建 | TypeScript + esbuild，无运行时 npm 依赖 |
-| 测试 | vitest 80 用例（fold / folder / jump / tab / host） |
+| 测试 | vitest 100 用例（fold / folder / jump / tab / host） |
 
 ## 开发
 
 ```sh
 pnpm install          # pnpm 10+ 拦截构建脚本时按提示允许 esbuild（见 pnpm-workspace.yaml）
 pnpm typecheck        # tsc --noEmit
-pnpm test             # vitest run（80 用例）
+pnpm test             # vitest run（100 用例）
 pnpm build            # esbuild → lib/index.js + lib/client.js（含 bundle 契约自检）
 pnpm pack             # 产出 dsh-turn-outline-<version>.tgz（prepack 自动重新构建）
 ```

package/lib/client.js

@@ -1107,7 +1107,7 @@ function t(lang, key) {
 var React = __toESM(require("react"), 1);
 var MAX_PULL_PAGES = 64;
 function fetchTrailEvents(sessionId, afterSeq, base) {
-  const url = new URL("/turntrail/api/events", base ?? window.location.origin);
+  const url = new URL("/turn-outline/api/events", base ?? window.location.origin);
   return fetch(url.toString(), {
     method: "POST",
     headers: { "content-type": "application/json", accept: "application/json" },
@@ -1223,18 +1223,60 @@ function useTrail(sessionId, visible, fetchEvents, sessionsService) {
     if (sessionId.length === 0 || !visible) return void 0;
     void pull();
     const binding = sessionsService?.binding(sessionId);
+    const disposers = [];
     const session = binding !== void 0 && binding.session !== void 0 ? binding.session : void 0;
-    if (session === void 0 || typeof session.subscribe !== "function") return void 0;
-    return session.subscribe(() => {
-      schedulePull();
-    });
+    if (session !== void 0 && typeof session.subscribe === "function") {
+      disposers.push(session.subscribe(() => {
+        schedulePull();
+      }));
+    }
+    const eventSource = binding !== void 0 ? binding.eventSource : void 0;
+    if (eventSource !== void 0 && typeof eventSource.subscribe === "function") {
+      try {
+        disposers.push(eventSource.subscribe(() => {
+          schedulePull();
+        }));
+      } catch {
+      }
+    }
+    if (disposers.length === 0) return void 0;
+    return () => {
+      for (const dispose of disposers) dispose();
+    };
   }, [sessionId, visible, pull, schedulePull, sessionsService]);
   return { turns, stats, status, error, refresh };
 }
 
 // src/client/trail-jump.ts
-function hasSeqInWindow(snapshot, seq) {
-  const store = snapshot.chat?.nodes;
+function targetSnapshot(conversation, name) {
+  try {
+    const target = conversation.target(name);
+    return target !== void 0 ? target.getSnapshot() : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function viewStateForJump(session, conversation) {
+  const snapshot = session.getSnapshot();
+  let chatNodes;
+  let trajectoryView;
+  if (conversation !== void 0) {
+    const chat = targetSnapshot(conversation, "chat");
+    if (chat !== null && typeof chat === "object" && chat.nodes !== void 0 && chat.nodes !== null) {
+      chatNodes = chat.nodes;
+    }
+    const trajectory = targetSnapshot(conversation, "trajectory");
+    if (trajectory !== null && typeof trajectory === "object") trajectoryView = trajectory;
+  }
+  if (chatNodes === void 0) chatNodes = snapshot.chat?.nodes;
+  if (trajectoryView === void 0 && snapshot.views !== void 0 && typeof snapshot.views.get === "function") {
+    const legacy = snapshot.views.get("trajectory");
+    if (legacy !== null && typeof legacy === "object") trajectoryView = legacy;
+  }
+  return { hasMore: snapshot.hasMore === true, chatNodes, trajectoryView };
+}
+function hasSeqInWindow(view, seq) {
+  const store = view.chatNodes;
   if (store === void 0 || typeof store.values !== "function") return false;
   let min = Number.POSITIVE_INFINITY;
   let max = Number.NEGATIVE_INFINITY;
@@ -1245,8 +1287,8 @@ function hasSeqInWindow(snapshot, seq) {
   }
   return min <= seq && seq <= max;
 }
-function findNodeForSeq(snapshot, seq) {
-  const store = snapshot.chat?.nodes;
+function findNodeForSeq(view, seq) {
+  const store = view.chatNodes;
   if (store === void 0 || typeof store.values !== "function") return null;
   let exact = null;
   let next = null;
@@ -1267,12 +1309,9 @@ function findNodeForSeq(snapshot, seq) {
 function isTrajectoryViewActive(document2) {
   return document2.querySelector("[data-trajectory-scroll]") !== null;
 }
-function trajectoryRecordIdFor(item, snapshot) {
-  const views = snapshot.views;
-  if (views === void 0 || typeof views.get !== "function") return null;
-  const trajectory = views.get("trajectory");
-  if (trajectory === null || typeof trajectory !== "object") return null;
-  const view = trajectory;
+function trajectoryRecordIdsFor(item, trajectoryView) {
+  if (trajectoryView === null || typeof trajectoryView !== "object") return [];
+  const view = trajectoryView;
   const nodes = Array.isArray(view.eventNodes) ? view.eventNodes : [];
   const requests = Array.isArray(view.requests) ? view.requests : [];
   const nodeWithKind = (kinds, seq) => {
@@ -1281,20 +1320,25 @@ function trajectoryRecordIdFor(item, snapshot) {
   };
   if (item.kind === "user" || item.kind === "context" || item.kind === "input") {
     const target = nodeWithKind(["user", "steering", "context"], item.seq);
-    if (target === void 0 || typeof target.seq !== "number") return null;
+    if (target === void 0 || typeof target.seq !== "number") return [];
     const rowKind = target.kind === "steering" ? "user" : target.kind;
-    return `${rowKind}\0seq\0${target.seq}`;
+    return [`${rowKind}\0seq\0${target.seq}`];
   }
   if (item.kind === "assistant" || item.kind === "output") {
     const target = nodeWithKind(["assistant"], item.seq);
-    if (target === void 0 || typeof target.turn !== "number" || typeof target.step !== "number") return null;
-    return `assistant\0${target.turn}\0${target.step}`;
+    if (target === void 0 || typeof target.seq !== "number") return [];
+    const ids = [];
+    if (typeof target.turn === "number" && typeof target.step === "number") {
+      ids.push(`assistant\0${target.turn}\0${target.step}`);
+    }
+    ids.push(`assistant\0seq\0${target.seq}`);
+    return ids;
   }
   if (item.kind === "tool" || item.kind === "error") {
-    if (typeof item.callId === "string" && item.callId.length > 0) return `tool\0call\0${item.callId}`;
+    if (typeof item.callId === "string" && item.callId.length > 0) return [`tool\0call\0${item.callId}`];
     const target = nodeWithKind(["tool-result"], item.seq);
-    if (target === void 0 || typeof target.callId !== "string") return null;
-    return `tool\0call\0${target.callId}`;
+    if (target === void 0 || typeof target.callId !== "string") return [];
+    return [`tool\0call\0${target.callId}`];
   }
   if (item.kind === "compaction") {
     const compactions = [];
@@ -1306,18 +1350,21 @@ function trajectoryRecordIdFor(item, snapshot) {
       }
     }
     const target = compactions.find((request) => request.resultSeq === item.seq) ?? compactions.filter((request) => (request.resultSeq ?? -1) >= item.seq).sort((a, b) => (a.resultSeq ?? -1) - (b.resultSeq ?? -1))[0];
-    if (target === void 0) return null;
-    return `compacted\0seq\0${target.startSeq}`;
+    if (target === void 0) return [];
+    return [`compacted\0seq\0${target.startSeq}`];
   }
-  return null;
-}
-function findTrajectoryRow(document2, key) {
-  const encoded = encodeURIComponent(key);
-  const rows = document2.querySelectorAll("tr[data-trajectory-row-key]");
-  for (let index = 0; index < rows.length; index += 1) {
-    const row = rows[index];
-    const value = row.dataset !== void 0 ? row.dataset.trajectoryRowKey : void 0;
-    if (value === encoded || value === key) return row;
+  return [];
+}
+function findTrajectoryRowByKeys(document2, keys) {
+  if (keys.length === 0) return null;
+  for (const key of keys) {
+    const encoded = encodeURIComponent(key);
+    const rows = document2.querySelectorAll("tr[data-trajectory-row-key]");
+    for (let index = 0; index < rows.length; index += 1) {
+      const row = rows[index];
+      const value = row.dataset !== void 0 ? row.dataset.trajectoryRowKey : void 0;
+      if (value === encoded || value === key) return row;
+    }
   }
   return null;
 }
@@ -1353,30 +1400,70 @@ function waitForNextFrame() {
     }
   });
 }
+function findChatRow(document2, key) {
+  const exact = document2.querySelector(`[data-chat-anchor-key="${cssEscape(key)}"]`);
+  if (exact !== null) return exact;
+  const rows = document2.querySelectorAll("[data-chat-node-key],[data-chat-anchor-key]");
+  for (let index = 0; index < rows.length; index += 1) {
+    const row = rows[index];
+    if (row.dataset !== void 0 && (row.dataset.chatNodeKey === key || row.dataset.chatAnchorKey === key)) return row;
+  }
+  return null;
+}
+function isHiddenInTree(row) {
+  let el = row;
+  while (el !== null && el !== void 0) {
+    if (typeof el.hasAttribute === "function" && el.hasAttribute("hidden")) return true;
+    el = el.parentElement;
+  }
+  return false;
+}
+function dispatchBeforematchUp(row) {
+  let el = row;
+  while (el !== null && el !== void 0) {
+    if (typeof el.hasAttribute === "function" && el.hasAttribute("hidden") && typeof el.dispatchEvent === "function" && typeof Event === "function") {
+      try {
+        el.dispatchEvent(new Event("beforematch"));
+      } catch {
+      }
+    }
+    el = el.parentElement;
+  }
+}
+async function revealRowUntilVisible(row, frames = 10) {
+  if (!isHiddenInTree(row)) return true;
+  for (let index = 0; index < frames; index += 1) {
+    dispatchBeforematchUp(row);
+    await waitForNextFrame();
+    if (!isHiddenInTree(row)) return true;
+  }
+  return !isHiddenInTree(row);
+}
 async function jumpToItem(session, item, options) {
   const guard = Number.isFinite(Number(options.guard)) && (options.guard ?? 0) > 0 ? Math.min(500, Math.max(1, Math.floor(options.guard ?? 200))) : 200;
   const document2 = options.document;
   try {
-    let snapshot = session.getSnapshot();
+    let view = viewStateForJump(session, options.conversation);
     const trajectoryActive = isTrajectoryViewActive(document2);
     if (trajectoryActive) {
-      let key = trajectoryRecordIdFor(item, snapshot);
-      let row2 = key === null ? null : findTrajectoryRow(document2, key);
+      let keys = trajectoryRecordIdsFor(item, view.trajectoryView);
+      let row2 = findTrajectoryRowByKeys(document2, keys);
       let pages2 = 0;
-      if (row2 === null && snapshot.hasMore === true) {
-        while (snapshot.hasMore === true && pages2 < guard) {
+      if (row2 === null && view.hasMore) {
+        while (view.hasMore && pages2 < guard) {
           await session.loadOlder();
-          snapshot = session.getSnapshot();
+          view = viewStateForJump(session, options.conversation);
           pages2 += 1;
           options.onProgress?.(pages2);
         }
-        key = trajectoryRecordIdFor(item, snapshot);
-        row2 = key === null ? null : findTrajectoryRow(document2, key);
+        keys = trajectoryRecordIdsFor(item, view.trajectoryView);
+        row2 = findTrajectoryRowByKeys(document2, keys);
       }
       if (row2 === null) {
         expandCollapsedSummaries(document2);
         await waitForNextFrame();
-        row2 = key === null ? null : findTrajectoryRow(document2, key);
+        keys = trajectoryRecordIdsFor(item, view.trajectoryView);
+        row2 = findTrajectoryRowByKeys(document2, keys);
       }
       if (row2 === null) {
         row2 = findTrajectoryRowBySeq(document2, item);
@@ -1386,23 +1473,36 @@ async function jumpToItem(session, item, options) {
       return { ok: true, mode: "trajectory" };
     }
     let pages = 0;
-    while (snapshot.hasMore === true && !hasSeqInWindow(snapshot, item.seq) && pages < guard) {
+    if (!hasSeqInWindow(view, item.seq) && typeof session.loadThrough === "function") {
+      await session.loadThrough(item.seq);
+      await waitForNextFrame();
+      await waitForNextFrame();
+      view = viewStateForJump(session, options.conversation);
+    }
+    while (view.hasMore && !hasSeqInWindow(view, item.seq) && pages < guard) {
       await session.loadOlder();
-      snapshot = session.getSnapshot();
+      view = viewStateForJump(session, options.conversation);
       pages += 1;
       options.onProgress?.(pages);
     }
-    const node = findNodeForSeq(snapshot, item.seq);
+    let node = findNodeForSeq(view, item.seq);
+    let nodeRetries = 0;
+    while (node === null && nodeRetries < 6) {
+      await waitForNextFrame();
+      view = viewStateForJump(session, options.conversation);
+      node = findNodeForSeq(view, item.seq);
+      nodeRetries += 1;
+    }
     if (node === null) return { ok: false, error: "seq-not-rendered" };
-    const selector = `[data-chat-anchor-key="${cssEscape(node.key)}"]`;
-    let row = document2.querySelector(selector);
+    let row = findChatRow(document2, node.key);
     let retries = 0;
     while (row === null && retries < 6) {
       await waitForNextFrame();
-      row = document2.querySelector(selector);
+      row = findChatRow(document2, node.key);
       retries += 1;
     }
     if (row === null) return { ok: false, error: "row-not-in-chat-view" };
+    if (!await revealRowUntilVisible(row)) return { ok: false, error: "row-hidden" };
     row.scrollIntoView({ behavior: "smooth", block: "center" });
     if (row.classList !== void 0 && typeof row.classList.add === "function") {
       row.classList.add("ttl-flash");
@@ -1423,6 +1523,17 @@ function sessionsOf(ctx) {
   const service = ctx.get("sessions");
   return service !== void 0 && service !== null && typeof service.binding === "function" ? service : void 0;
 }
+function conversationOf(ctx, sessionId) {
+  if (ctx === void 0 || typeof ctx.get !== "function") return void 0;
+  const service = ctx.get("uiConversation");
+  if (service === void 0 || service === null || typeof service.binding !== "function") return void 0;
+  try {
+    const targets = service.binding(sessionId);
+    return targets !== void 0 && targets !== null && typeof targets.target === "function" ? targets : void 0;
+  } catch {
+    return void 0;
+  }
+}
 function turnByIdentity(turn) {
   return turn.turn !== null ? `turn:${turn.turn}` : `input:${turn.anchorSeq}`;
 }
@@ -1701,6 +1812,10 @@ function TrailTab(props) {
     if (typeof face.loadOlder !== "function" || typeof face.getSnapshot !== "function") return null;
     return session;
   }, [sessionsService, sessionId]);
+  const conversationForJump = React2.useMemo(
+    () => conversationOf(props.ctx, sessionId),
+    [props.ctx, sessionId]
+  );
   const doJump = React2.useCallback(async (target, turn) => {
     if (jumpingRef.current) return;
     setActiveTurnId(turnByIdentity(turn));
@@ -1714,7 +1829,8 @@ function TrailTab(props) {
     setJumpMessage(null);
     const outcome = await jumpToItem(sessionForJump, target, {
       document: window.document,
-      onProgress: (pages) => setJumpPages(pages)
+      onProgress: (pages) => setJumpPages(pages),
+      ...conversationForJump !== void 0 ? { conversation: conversationForJump } : {}
     });
     jumpingRef.current = false;
     setJumping(null);
@@ -1723,7 +1839,7 @@ function TrailTab(props) {
     } else {
       setJumpMessage(t(lang, "jumpFailed"));
     }
-  }, [sessionForJump, lang]);
+  }, [sessionForJump, conversationForJump, lang]);
   const stepMatches = (step) => {
     if (filter === "all") return true;
     if (filter === "failed") return step.kind === "error";
@@ -1849,7 +1965,11 @@ function routeIcon(size) {
     children
   );
 }
-var inject = ["sessions", "betterSidebar"];
+var inject = ["sessions", "uiConversation", "betterSidebar"];
+function tabDescription() {
+  if (typeof navigator === "undefined") return "Turn outline";
+  return navigator.language.toLowerCase().startsWith("zh") ? "\u6309\u7528\u6237\u8F6E\u6B21\u6298\u53E0\u4F1A\u8BDD\u8F68\u8FF9\uFF0C\u4E00\u952E\u5B9A\u4F4D\u56DE\u5BF9\u8BDD\u539F\u4F4D" : "Fold the session into per-turn steps and jump back to any of them";
+}
 function apply(ctx) {
   const style = document.createElement("style");
   style.dataset.plugin = "dsh-turn-outline";
@@ -1863,6 +1983,7 @@ function apply(ctx) {
   ctx.effect(() => betterSidebar.registerTab({
     id: "turn-outline",
     title: () => typeof navigator !== "undefined" && navigator.language.toLowerCase().startsWith("zh") ? "\u8F6E\u6B21\u8F68\u8FF9" : "Turn Outline",
+    description: tabDescription,
     icon: (size) => routeIcon(size),
     order: 46,
     single: true,