@deepseek-harness-tui/dsh-tui 0.13.0 → 0.14.1

package/lib/types/components/sidePanel/PanelStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PanelStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErF,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,kBAAkB;AAClB,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;4CAE4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAatD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAI;IACpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IA0BpE,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI;IAUtE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,GAAI,UAAU,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrE;IAED,OAAO,CAAC,IAAI;CAIb;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAmB,CAAA"}
+{"version":3,"file":"PanelStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErF,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,kBAAkB;AAClB,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;4CAE4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAatD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAI;IACpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IA0BpE,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC;;+CAE2C;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI;IAWtE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,GAAI,UAAU,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrE;IAED,OAAO,CAAC,IAAI;CAIb;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAmB,CAAA"}

package/lib/types/components/sidePanel/PanelStore.js

@@ -54,14 +54,18 @@ export class PanelStore {
     get(id) {
         return this.entries.get(id);
     }
-    /** 只允许 owner 或宿主调用（调用侧自律，与 tuiStatus 相同）。 */
+    /** 只允许 owner 或宿主调用（调用侧自律，与 tuiStatus 相同）。
+     *  level/unread 都没变时不通知：适配器在每次 channel 变化（流式时每个
+     *  delta）都会调这里，每次通知都会让订阅 list() 的宿主重渲染。 */
     setBadge(id, badge) {
         const entry = this.entries.get(id);
         if (entry === undefined)
             return;
-        const next = badge === null
-            ? null
-            : { level: badge.level, unread: Math.min(PANEL_UNREAD_CAP, Math.max(0, badge.unread)), latestAt: Date.now() };
+        const unread = badge === null ? 0 : Math.min(PANEL_UNREAD_CAP, Math.max(0, badge.unread));
+        const current = entry.badge;
+        if (badge === null ? current === null : current !== null && current.level === badge.level && current.unread === unread)
+            return;
+        const next = badge === null ? null : { level: badge.level, unread, latestAt: Date.now() };
         this.entries.set(id, { ...entry, badge: next });
         this.emit({ type: 'badge', id });
     }

package/lib/types/components/sidePanel/SidePanelColumn.d.ts

@@ -1,14 +1,7 @@
 /**
- * SidePanelColumn: the right surface's chrome — PanelBar on top, PanelHost
- * in the middle, and a 1-row key hint at the bottom (design doc §6.1).
- *
- * The hint row swaps text with focus: unfocused it advertises Ctrl+B,
- * focused it lists the panel keys. The two thin rules frame the host and
- * brighten to 'accent' together with the divider when the column has the
- * focus — the whole seam lights up as one surface.
- *
- * Tabs come from the PanelStore (enabled ∩ registered, badge included);
- * builtin registrations arrive via registerBuiltinPanels on module import.
+ * SidePanelColumn: PanelBar, the active panel surface and a one-row key hint.
+ * The hint follows focus, and the rules brighten with the divider as one surface.
+ * Tabs follow the enabled registration order and carry each panel's badge.
  */
 import React from 'react';
 import type { ChannelUi } from '../../adapter/channel/ui-policy.js';

package/lib/types/components/sidePanel/SidePanelColumn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidePanelColumn.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelColumn.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAMnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;CAChF;AAoCD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAkEhJ"}
+{"version":3,"file":"SidePanelColumn.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelColumn.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAMnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;CAChF;AAoCD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAsEhJ"}

package/lib/types/components/sidePanel/SidePanelColumn.js

@@ -1,15 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * SidePanelColumn: the right surface's chrome — PanelBar on top, PanelHost
- * in the middle, and a 1-row key hint at the bottom (design doc §6.1).
- *
- * The hint row swaps text with focus: unfocused it advertises Ctrl+B,
- * focused it lists the panel keys. The two thin rules frame the host and
- * brighten to 'accent' together with the divider when the column has the
- * focus — the whole seam lights up as one surface.
- *
- * Tabs come from the PanelStore (enabled ∩ registered, badge included);
- * builtin registrations arrive via registerBuiltinPanels on module import.
+ * SidePanelColumn: PanelBar, the active panel surface and a one-row key hint.
+ * The hint follows focus, and the rules brighten with the divider as one surface.
+ * Tabs follow the enabled registration order and carry each panel's badge.
  */
 import React from 'react';
 import { Box, Text, useTerminalSize } from '../../ui.js';
@@ -47,7 +40,6 @@ export function SidePanelColumn({ width, controller, channel, activity, attentio
         return {
             id,
             title: def.titleKey !== undefined ? t(def.titleKey) : def.title ?? fallbackTitle(id),
-            icon: def.icon,
             badge: entry.badge,
         };
     });
@@ -56,7 +48,12 @@ export function SidePanelColumn({ width, controller, channel, activity, attentio
     // ⤢ 只对「活动面板 + 声明了整屏形态 + 宿主接了出口」出现：能力位是
     // 声明的唯一真源，没有整屏对应物的面板（info/companion）不画。
     const activeEntry = entries.find(entry => entry.definition.id === controller.activePanelId);
-    const canExpand = activeEntry?.definition.capabilities?.fullscreen === true && onExpand !== undefined;
+    // 没有轨迹来源（unsupported）时收起轨迹的 ⤢：全屏只会放大同一句「不支
+    // 持」，面板自己的文案说明了原因。channel 不报告来源（旧夹具/部分
+    // channel）时照旧显示。
+    // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: partial fixture channels
+    const trajectoryUnsupported = controller.activePanelId === 'trajectory' && channel.trajectorySource?.() === 'unsupported';
+    const canExpand = activeEntry?.definition.capabilities?.fullscreen === true && onExpand !== undefined && !trajectoryUnsupported;
     // 标签点击与 ←/→ 宿主键走同一条路（openPanel 会顺带把焦点给右栏）。
     const onSelectPanel = React.useCallback((id) => { controller.openPanel(id, { focus: true }); }, 
     // openPanel 在 useSidePanel 里是空依赖 useCallback（引用稳定）；

package/lib/types/components/sidePanel/TrajectoryPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrajectoryPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/TrajectoryPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA0BzB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,YAAY,CAAA;AAwB7D,KAAK,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5C,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAuYhG;AAED,+EAA+E;AAC/E,YAAY,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"TrajectoryPanel.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/TrajectoryPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA2BzB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,YAAY,CAAA;AA4B7D,KAAK,cAAc,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5C,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAydhG;AAED,+EAA+E;AAC/E,YAAY,EAAE,cAAc,EAAE,CAAA"}

package/lib/types/components/sidePanel/TrajectoryPanel.js

@@ -8,12 +8,15 @@ import { Inspector } from '../trajectory/Inspector.js';
 import { HotspotView, hotspotRows } from '../trajectory/HotspotView.js';
 import { Divider } from '../design-system/Divider.js';
 import { MOTION_TICK_MS } from '../../trajectory/motion.js';
+import { ledgerWindow } from '../../trajectory/window.js';
 import { truncateWidth } from '../../trajectory/format.js';
 import { stringWidth } from '../../ink/stringWidth.js';
 import { t } from '../../i18n.js';
 import { aggregate, columnOfIndex, emptyTrajectory, inspectNode, projectWave, HOTSPOT_SORTS, WAVE_PROJECTIONS, } from '../../dsh-adapter/trajectory/index.js';
 import { SidePanelRuntimeContext, useSidePanelTrajectory } from './SidePanelRuntimeContext.js';
 import { usePanelInput } from './usePanelInput.js';
+import { useTrajectoryScope } from '../trajectory/useTrajectoryScope.js';
+import { scopeChipParts } from '../trajectory/scope.js';
 /**
  * The trajectory as a side-panel form of the fullscreen TrajectoryScene.
  *
@@ -34,14 +37,23 @@ import { usePanelInput } from './usePanelInput.js';
 const INSPECTOR_ROWS = 4;
 /** Tabs row, the wake's two rows, the ledger/inspector divider, the hint. */
 const CHROME_ROWS = 5;
+/** Shared read-only identity for a panel mounted before any fold exists. */
+const EMPTY_BUILD = emptyTrajectory();
 export function TrajectoryPanel({ width, height, focused, visible }) {
     // The channel comes from the same runtime context the trajectory build
     // does. Reading it tolerantly (rather than via useSidePanelChannel, which
     // throws) keeps the component mountable in headless fallback probes.
     const channel = React.useContext(SidePanelRuntimeContext)?.channel;
-    const build = useSidePanelTrajectory();
-    const nodes = build?.nodes;
-    const empty = nodes === undefined || nodes.length === 0;
+    const mainBuild = useSidePanelTrajectory();
+    const build = mainBuild ?? EMPTY_BUILD;
+    // 跨 Agent 下钻：面板与全屏场景共用同一个 scope 数据面，波形/账本/检视器
+    // 随 scope 一起切换。面板不消费 Esc，范围循环走 a 键与 chip 点击。
+    const { scope, lanes, scoped, drill } = useTrajectoryScope(channel, build);
+    const nodes = scoped.build.nodes;
+    // The empty-state copy promises "data once turns happen" — that is only
+    // honest for the SESSION scope; a scoped view of an eventless lane falls
+    // through to the normal chrome (tabs + chip + the ledger's own '—').
+    const empty = mainBuild === undefined || (scope.kind === 'session' && scoped.build.nodes.length === 0);
     // visible=false (inactive tab / collapsed sidebar) stops the motion clock:
     // zero animation-frame subscriptions, the store keeps folding underneath.
     const [ref, time] = useAnimationFrame(visible && !empty ? MOTION_TICK_MS : null);
@@ -63,14 +75,26 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
     const [hoverAxis, setHoverAxis] = React.useState(false);
     // ── projection (no query in the panel form: the filtered list is the
     //    ledger itself, and the column index map is the identity) ─────────────
-    const filtered = nodes ?? [];
+    const filtered = nodes;
     const indexes = React.useMemo(() => filtered.map((_, index) => index), [filtered.length]);
-    // `emptyTrajectory()` keeps the memo body total: hooks run before the
+    // EMPTY_BUILD (shared read-only identity) keeps the memo body total: hooks run before the
     // empty-state early return, so the aggregators must tolerate a missing
     // build rather than throwing on first paint.
     const agg = React.useMemo(
     // oxlint-disable-next-line react-hooks/exhaustive-deps
-    () => aggregate(build ?? emptyTrajectory(), sort), [build, filtered.length, sort]);
+    () => aggregate(scoped.build, sort), [scoped.build, filtered.length, sort]);
+    // A scope switch swaps the row list: re-arm arrival at the scoped head.
+    const scopeKey = scope.kind === 'session' ? 's'
+        : scope.kind === 'parent-turn' ? 'p:' + scope.agentId + ':' + scope.turn
+            : (scope.kind === 'agent' ? 'a:' : 'd:') + scope.agentId;
+    React.useEffect(() => {
+        seenRef.current = 0;
+        errorsRef.current = agg.totals.errors;
+        setCursor(0);
+        setFollow(true);
+        setInspectScroll(0);
+        // oxlint-disable-next-line react-hooks/exhaustive-deps
+    }, [scopeKey]);
     // ── arrival + alert detection (same contract as the scene) ───────────────
     const seenRef = React.useRef(0);
     const errorsRef = React.useRef(0);
@@ -98,14 +122,16 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
         : Math.max(3, Math.min(INSPECTOR_ROWS, height - CHROME_ROWS - 2));
     const ledgerRows = Math.max(1, height - CHROME_ROWS - inspectorRows);
     const clampedCursor = filtered.length === 0 ? 0 : Math.min(cursor, filtered.length - 1);
-    const windowStart = Math.max(0, Math.min(clampedCursor - Math.floor(ledgerRows / 2), filtered.length - ledgerRows));
+    // The same windowing as the scene: one viewport's worth of rows at any
+    // session length.
+    const windowStart = ledgerWindow(filtered.length, clampedCursor, ledgerRows).start;
     const band = React.useMemo(
     // oxlint-disable-next-line react-hooks/exhaustive-deps
-    () => projectWave(nodes ?? emptyTrajectory().nodes, bandWidth, projection), [nodes, filtered.length, bandWidth, projection]);
+    () => projectWave(scoped.build.nodes, bandWidth, projection), [scoped.build, filtered.length, bandWidth, projection]);
     const focusedNode = filtered[clampedCursor];
     const detail = React.useMemo(() => focusedNode === undefined || channel === undefined
         ? undefined
-        : inspectNode(focusedNode, channel.traceEvents()), [focusedNode, channel]);
+        : inspectNode(focusedNode, scoped.events), [focusedNode, scoped.events]);
     // ── navigation helpers (mirroring the scene's semantics) ─────────────────
     const move = React.useCallback((delta) => {
         setExpanded(false);
@@ -209,6 +235,13 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
             setSwitchTick(tick);
             return true;
         }
+        // 会话范围内 a 下钻到焦点行所指的 lane；已在范围内则循环
+        // 当前 Agent → 父回合 → 全部后代 → 会话。面板不消费 Esc，循环也可以
+        // 点 scope chip。
+        if (input === 'a' && !key.ctrl && !key.meta && lanes.length > 0) {
+            drill(filtered[clampedCursor]);
+            return true;
+        }
         if (key.return_) {
             setExpanded(previous => !previous);
             setInspectScroll(0);
@@ -220,17 +253,37 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
         }
         return false;
         // oxlint-disable-next-line react-hooks/exhaustive-deps
-    }, [view, agg, hotCursor, expanded, inspectorRows, ledgerRows, move, switchView, jumpFromHotspot, tick]);
+    }, [view, agg, hotCursor, expanded, inspectorRows, ledgerRows, move, switchView, jumpFromHotspot, tick, lanes, drill, filtered, clampedCursor]);
     usePanelInput(onKey, { active: focused && visible });
-    // ── empty state ───────────────────────────────────────────────────────────
+    // ── unsupported state ──────────────────────────────────────────────────────
+    // The channel's trajectorySource() decides, not the node count: a session
+    // with no trajectory source must not read as "no turns yet". Every
+    // in-tree composition mounts one (DSH: raw history; other backends: the
+    // AgentEvent fold), so only fixtures reach this branch today. The ⤢
+    // outlet is hidden for it (SidePanelColumn) and the second line says
+    // why. A channel without the report (partial fixtures) keeps the old
+    // behavior.
+    const source = channel?.trajectorySource?.();
+    if (source === 'unsupported') {
+        // Copy selection only: unsupported sources share the same explanation.
+        const unsupportedLine = t('trajectory-unsupported');
+        return (_jsxs(Box, { ref: ref, flexDirection: "column", width: "100%", paddingX: 1, children: [_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "subtle", wrap: "truncate", children: truncateWidth(unsupportedLine, contentWidth) }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: truncateWidth(t('trajectory-unsupported-fullscreen'), contentWidth) }) })] }));
+    }
+    // ── empty state (supported + no events yet — the ONLY state allowed to
+    //    promise data once turns happen) ────────────────────────────────────────
     if (empty) {
         return (_jsxs(Box, { ref: ref, flexDirection: "column", width: "100%", paddingX: 1, children: [_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "subtle", wrap: "truncate", children: t('panel-trajectory-empty') }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: truncateWidth(t('panel-trajectory-hint'), contentWidth) }) })] }));
     }
     // ── tabs row: two clickable segments + the axis label (cycle on click) ───
     const tabTimelineText = `${view === 'timeline' ? '●' : '○'} ${t('traj-tab-timeline')}`;
     const tabHotspotText = `${view === 'hotspot' ? '●' : '○'} ${t('traj-tab-hotspot')}`;
+    // The scope chip: shown exactly while a non-session scope
+    // is active; its width is charged to the axis label's budget so a narrow
+    // panel drops the axis before it drops the scope identity.
+    const scopeChip = scopeChipParts(scope);
+    const scopeChipText = scopeChip === undefined ? '' : '◆ ' + t(scopeChip.key, scopeChip.params);
     const axisText = view === 'hotspot' ? t(`traj-sort-${sort}`) : t(`traj-proj-${projection}`);
-    const axisRoom = contentWidth - stringWidth(tabTimelineText) - stringWidth(tabHotspotText) - 3;
+    const axisRoom = contentWidth - stringWidth(tabTimelineText) - stringWidth(tabHotspotText) - stringWidth(scopeChipText) - 3;
     const axisShown = axisRoom >= stringWidth(axisText) ? axisText : '';
     const tabs = (_jsxs(Box, { width: "100%", height: 1, flexShrink: 0, children: [_jsx(Box, { flexShrink: 0, width: stringWidth(tabTimelineText), onClick: (event) => {
                     event.stopImmediatePropagation();
@@ -238,7 +291,13 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
                 }, onMouseEnter: () => setHoverTab('timeline'), onMouseLeave: () => setHoverTab(previous => (previous === 'timeline' ? null : previous)), children: _jsx(Text, { color: view === 'timeline' ? 'permission' : hoverTab === 'timeline' ? 'text' : 'subtle', bold: view === 'timeline', children: tabTimelineText }) }), _jsx(Box, { flexShrink: 0, width: stringWidth(tabHotspotText), onClick: (event) => {
                     event.stopImmediatePropagation();
                     switchView('hotspot');
-                }, onMouseEnter: () => setHoverTab('hotspot'), onMouseLeave: () => setHoverTab(previous => (previous === 'hotspot' ? null : previous)), children: _jsx(Text, { color: view === 'hotspot' ? 'permission' : hoverTab === 'hotspot' ? 'text' : 'subtle', bold: view === 'hotspot', children: tabHotspotText }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { children: " " }) }), axisShown !== '' && (_jsx(Box, { flexShrink: 0, width: stringWidth(axisShown) + 1, onClick: (event) => {
+                }, onMouseEnter: () => setHoverTab('hotspot'), onMouseLeave: () => setHoverTab(previous => (previous === 'hotspot' ? null : previous)), children: _jsx(Text, { color: view === 'hotspot' ? 'permission' : hoverTab === 'hotspot' ? 'text' : 'subtle', bold: view === 'hotspot', children: tabHotspotText }) }), scopeChipText !== '' && (_jsx(Box, { flexShrink: 0, width: stringWidth(scopeChipText), 
+                // 点击 scope chip = a 键的鼠标等价（循环 当前 Agent → 父回合 →
+                // 全部后代 → 会话）。
+                onClick: (event) => {
+                    event.stopImmediatePropagation();
+                    drill(undefined);
+                }, children: _jsx(Text, { color: "accent", bold: true, children: scopeChipText }) })), _jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { children: " " }) }), axisShown !== '' && (_jsx(Box, { flexShrink: 0, width: stringWidth(axisShown) + 1, onClick: (event) => {
                     event.stopImmediatePropagation();
                     if (view === 'hotspot') {
                         setSort(previous => HOTSPOT_SORTS[(HOTSPOT_SORTS.indexOf(previous) + 1) % HOTSPOT_SORTS.length]);
@@ -259,5 +318,10 @@ export function TrajectoryPanel({ width, height, focused, visible }) {
                 } }), _jsx("ink-box", { style: { flexDirection: 'column', flexGrow: 1, flexShrink: 1, overflow: 'hidden', width: '100%' }, onWheel: handleWheel, children: view === 'timeline' ? (_jsxs(_Fragment, { children: [_jsx(Ledger, { rows: filtered, start: windowStart, height: ledgerRows, cursor: clampedCursor, width: contentWidth, tick: tick, arrivalTick: arrivalTick, arrivalFrom: arrivalFrom, onRowClick: (index, event) => {
                                 event.stopImmediatePropagation();
                                 jumpTo(index);
-                            } }), _jsx(Divider, { color: "permission", width: bandWidth }), _jsx(Inspector, { node: focusedNode, detail: detail, height: inspectorRows, width: contentWidth, expanded: expanded, scroll: inspectScroll })] })) : (_jsx(HotspotView, { agg: agg, sort: sort, width: contentWidth, height: ledgerRows + inspectorRows + 1, cursor: hotCursor, tick: tick, switchTick: switchTick, onRowClick: index => jumpFromHotspot(hotspotRows(agg)[index]) })) }), _jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: truncateWidth(t('panel-trajectory-hint'), contentWidth) }) })] }));
+                            } }), _jsx(Divider, { color: "permission", width: bandWidth }), _jsx(Inspector, { node: focusedNode, detail: detail, height: inspectorRows, width: contentWidth, expanded: expanded, scroll: inspectScroll })] })) : (_jsx(HotspotView, { agg: agg, sort: sort, width: contentWidth, height: ledgerRows + inspectorRows + 1, cursor: hotCursor, tick: tick, switchTick: switchTick, onRowClick: index => jumpFromHotspot(hotspotRows(agg)[index]) })) }), _jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: truncateWidth(
+                    // 有 lane 可下钻时教一次 a 键；进入范围后改说怎么出来（面板
+                    // 不消费 Esc，循环回会话也是出口）。
+                    lanes.length === 0 ? t('panel-trajectory-hint')
+                        : scope.kind === 'session' ? t('panel-trajectory-hint') + ' · ' + t('trajectory-drill-hint')
+                            : t('trajectory-scope-hint-panel'), contentWidth) }) })] }));
 }

package/lib/types/components/sidePanel/agentViewStore.d.ts

@@ -0,0 +1,20 @@
+/**
+ * agentViewStore：面板/详情 → Chat 的主屏 Agent View 打开请求通道（镜像
+ * jobsFocusStore 的三行 store 模式）。agents 侧栏面板与 Detail 场景自己没有
+ * Chat 的场景 state，主屏查看动作经这里请求；Chat 订阅后压入来源栈。
+ *
+ * surface 记录请求来自侧栏面板还是整屏形态，Esc 返回时回到同一形态。
+ */
+export interface AgentViewRequest {
+    readonly agentId: string;
+    readonly source: 'agents-dashboard' | 'agent-detail';
+    /** 请求来自侧栏 agents 面板（Esc 返回面板而非整屏形态）。 */
+    readonly panel: boolean;
+    readonly nonce: number;
+}
+export declare const agentViewStore: {
+    subscribe(listener: () => void): () => void;
+    get(): AgentViewRequest | null;
+    request(agentId: string, source: AgentViewRequest["source"], panel: boolean): void;
+};
+//# sourceMappingURL=agentViewStore.d.ts.map

package/lib/types/components/sidePanel/agentViewStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentViewStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/agentViewStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,cAAc,CAAA;IACpD,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AASD,eAAO,MAAM,cAAc;wBACL,MAAM,IAAI,GAAG,MAAM,IAAI;WAIpC,gBAAgB,GAAG,IAAI;qBAGb,MAAM,UAAU,gBAAgB,CAAC,QAAQ,CAAC,SAAS,OAAO,GAAG,IAAI;CAInF,CAAA"}

package/lib/types/components/sidePanel/agentViewStore.js

@@ -0,0 +1,26 @@
+/**
+ * agentViewStore：面板/详情 → Chat 的主屏 Agent View 打开请求通道（镜像
+ * jobsFocusStore 的三行 store 模式）。agents 侧栏面板与 Detail 场景自己没有
+ * Chat 的场景 state，主屏查看动作经这里请求；Chat 订阅后压入来源栈。
+ *
+ * surface 记录请求来自侧栏面板还是整屏形态，Esc 返回时回到同一形态。
+ */
+let snapshot = null;
+const listeners = new Set();
+function emit() {
+    for (const listener of [...listeners])
+        listener();
+}
+export const agentViewStore = {
+    subscribe(listener) {
+        listeners.add(listener);
+        return () => { listeners.delete(listener); };
+    },
+    get() {
+        return snapshot;
+    },
+    request(agentId, source, panel) {
+        snapshot = Object.freeze({ agentId, source, panel, nonce: (snapshot?.nonce ?? 0) + 1 });
+        emit();
+    },
+};

package/lib/types/components/sidePanel/btw/BtwComposer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * BtwComposer：btw 线程的追问输入框。草稿存在线程 store 里（面板与全屏
+ * 共享），Enter 发送，Esc 退出编辑焦点但保留草稿，失败或忙时草稿原样保留。
+ * 没有 steer/queue：sideQuery 是一次旁路问答，不进父会话。
+ *
+ * 键处理是纯函数 btwComposerKey，面板（usePanelInput 分发）与全屏场景
+ * （useInput）共用；组件本身受控渲染（text 在 store，caret 是各处自己的）。
+ */
+import React from 'react';
+import type { SidePanelKeyFlags } from '../types.js';
+/** 编辑态（text 来自线程 store；caret 属于当前 surface）。 */
+export interface BtwComposerState {
+    readonly text: string;
+    readonly caret: number;
+}
+/** btwComposerKey 的结果：undefined 字段 = 无此动作；整体为 null = 键未消费。 */
+export interface BtwComposerKeyResult {
+    readonly state?: BtwComposerState;
+    readonly submit?: boolean;
+    /** Esc/Tab：退出编辑焦点（草稿保留），焦点回落线程列表/宿主。 */
+    readonly exitFocus?: boolean;
+}
+/** 运行时补充键位（ink Key 实际携带；SidePanelKeyFlags 类型面未列）。 */
+type BtwKeyFlags = SidePanelKeyFlags & {
+    readonly tab?: boolean;
+    readonly backspace?: boolean;
+    readonly delete?: boolean;
+    readonly home?: boolean;
+    readonly end?: boolean;
+    readonly return?: boolean;
+};
+/**
+ * 单行 composer 的键语义。返回 null = 未消费（面板形态交宿主回退键，
+ * 全屏形态交场景其余分支）；返回对象按 exitFocus > submit > 编辑 写回。
+ */
+export declare function btwComposerKey(state: BtwComposerState, input: string, key: BtwKeyFlags): BtwComposerKeyResult | null;
+export declare function BtwComposer({ state, focused, busy, notice, }: {
+    readonly state: BtwComposerState;
+    /** 编辑焦点（决定 caret 反白块的画法）。 */
+    readonly focused: boolean;
+    /** 线程在途：Enter 不发送，提示稍候。 */
+    readonly busy: boolean;
+    /** 提交失败/忙的本地提示（显示到下一次动作）。 */
+    readonly notice?: {
+        readonly text: string;
+        readonly failure: boolean;
+    } | undefined;
+}): React.ReactNode;
+export {};
+//# sourceMappingURL=BtwComposer.d.ts.map

package/lib/types/components/sidePanel/btw/BtwComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BtwComposer.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwComposer.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,qDAAqD;AACrD,KAAK,WAAW,GAAG,iBAAiB,GAAG;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI,CAuBpH;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,IAAI,EACJ,MAAM,GACP,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;CACnF,GAAG,KAAK,CAAC,SAAS,CAsBlB"}

package/lib/types/components/sidePanel/btw/BtwComposer.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from '../../../ui.js';
+import { t } from '../../../i18n.js';
+import { nextCodePoint, previousCodePoint } from '../../AgentMessageComposer.js';
+/**
+ * 单行 composer 的键语义。返回 null = 未消费（面板形态交宿主回退键，
+ * 全屏形态交场景其余分支）；返回对象按 exitFocus > submit > 编辑 写回。
+ */
+export function btwComposerKey(state, input, key) {
+    if (key.escape === true)
+        return { exitFocus: true };
+    // The caret is per surface while the draft is shared through the store:
+    // an edit on the other surface can leave this caret past the end.
+    const caret = Math.min(state.caret, state.text.length);
+    const plainReturn = (key.return_ === true || key.return === true || /^[\r\n]+$/u.test(input))
+        && key.ctrl !== true && key.meta !== true && key.shift !== true;
+    if (plainReturn)
+        return { submit: true };
+    // Tab 离开编辑层去列表（与 TrajectoryPanel 同款双形态判定）。
+    if (key.tab === true || input === '\t')
+        return { exitFocus: true };
+    if (key.backspace === true || key.delete === true) {
+        if (caret <= 0)
+            return { state: { ...state, caret } };
+        const at = previousCodePoint(state.text, caret);
+        return { state: { text: state.text.slice(0, at) + state.text.slice(caret), caret: at } };
+    }
+    if (key.leftArrow === true)
+        return { state: { ...state, caret: previousCodePoint(state.text, caret) } };
+    if (key.rightArrow === true)
+        return { state: { ...state, caret: nextCodePoint(state.text, caret) } };
+    if (key.home === true)
+        return { state: { ...state, caret: 0 } };
+    if (key.end === true)
+        return { state: { ...state, caret: state.text.length } };
+    if (input !== '' && key.ctrl !== true && key.meta !== true) {
+        return { state: { text: state.text.slice(0, caret) + input + state.text.slice(caret), caret: caret + input.length } };
+    }
+    return null;
+}
+export function BtwComposer({ state, focused, busy, notice, }) {
+    const { text, caret } = state;
+    const shown = Math.min(caret, text.length);
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsxs(Box, { flexDirection: "row", flexShrink: 0, children: [_jsx(Text, { color: "warning", bold: true, children: '› ' }), focused ? (_jsxs(_Fragment, { children: [_jsx(Text, { children: text.slice(0, shown) }), _jsx(Text, { inverse: true, children: text.slice(shown, shown + 1) || ' ' }), text.slice(shown + 1) !== '' ? _jsx(Text, { children: text.slice(shown + 1) }) : null] })) : (_jsx(Text, { dimColor: true, children: text === '' ? t('btw-thread-followup') : text }))] }), notice !== undefined && (_jsx(Text, { color: notice.failure ? 'error' : undefined, wrap: "truncate", children: notice.text }))] }));
+}

package/lib/types/components/sidePanel/btw/BtwPanelAdapter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * btw 侧栏面板：线程滚动 + Markdown + 底部 composer 连续追问。Esc 先退出
+ * composer 编辑（草稿保留），列表层不消费 Esc，再交宿主回聊天；Tab 在列表
+ * 与 composer 间切焦点；未消费的键交宿主（←/→ 仍切面板）。
+ *
+ * badge 派生（镜像 jobs/agents 适配器）：面板不可见期间完成的新 answer
+ * 增 info unread、失败 error level 计未读、运行中只亮点不计未读；进入
+ * 面板（visible）即 markSeen 清 unread——仅开始生成不清旧未读。
+ */
+import React from 'react';
+import type { PanelProps } from '../types.js';
+export declare function BtwPanelAdapter({ width, height, focused, visible }: PanelProps): React.ReactNode;
+//# sourceMappingURL=BtwPanelAdapter.d.ts.map

package/lib/types/components/sidePanel/btw/BtwPanelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BtwPanelAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwPanelAdapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAYzB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAA;AAY9D,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAoJhG"}

package/lib/types/components/sidePanel/btw/BtwPanelAdapter.js

@@ -0,0 +1,147 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * btw 侧栏面板：线程滚动 + Markdown + 底部 composer 连续追问。Esc 先退出
+ * composer 编辑（草稿保留），列表层不消费 Esc，再交宿主回聊天；Tab 在列表
+ * 与 composer 间切焦点；未消费的键交宿主（←/→ 仍切面板）。
+ *
+ * badge 派生（镜像 jobs/agents 适配器）：面板不可见期间完成的新 answer
+ * 增 info unread、失败 error level 计未读、运行中只亮点不计未读；进入
+ * 面板（visible）即 markSeen 清 unread——仅开始生成不清旧未读。
+ */
+import React from 'react';
+import { Box, Text } from '../../../ui.js';
+import { t } from '../../../i18n.js';
+import { panelStore } from '../PanelStore.js';
+import { useSidePanelChannel } from '../SidePanelRuntimeContext.js';
+import { usePanelInput } from '../usePanelInput.js';
+import { truncateWidth } from '../../../trajectory/format.js';
+import { stringWidth } from '../../../ink/stringWidth.js';
+import { btwThreads } from './threads.js';
+import { getBtwContextBudget, getBtwContextTurns, subscribeBtwContextTurns } from '../../../tuiDisplayPrefs.js';
+import { BtwComposer, btwComposerKey } from './BtwComposer.js';
+import { BtwThreadView } from './BtwThreadView.js';
+function useBtwThread(sessionId) {
+    return React.useSyncExternalStore(btwThreads.subscribe, () => btwThreads.get(sessionId));
+}
+/** 提交时一次性读取线程上下文设置（dsh-tui.btw.*，live store）。 */
+function btwContextOptions() {
+    return { recentTurnsLimit: getBtwContextTurns(), contextBudget: getBtwContextBudget() };
+}
+export function BtwPanelAdapter({ width, height, focused, visible }) {
+    const channel = useSidePanelChannel();
+    const sessionId = String(channel.agentId);
+    const thread = useBtwThread(sessionId);
+    const version = thread?.version ?? 0;
+    const busy = thread !== undefined && thread.activeTurnId !== null;
+    const [composerFocus, setComposerFocus] = React.useState(true);
+    // The caret rides a ref too: two keys arriving before a re-render must
+    // see each other's caret (the draft itself is read from the store).
+    const caretRef = React.useRef(0);
+    const [caret, setCaretState] = React.useState(0);
+    const setCaret = React.useCallback((next) => {
+        caretRef.current = next;
+        setCaretState(next);
+    }, []);
+    const [notice, setNotice] = React.useState(null);
+    // badge（镜像 jobs：version/visible 驱动；可见即已读）。
+    React.useEffect(() => {
+        const running = thread?.turns.some(turn => turn.phase === 'running') ?? false;
+        if (visible) {
+            btwThreads.markSeen(sessionId);
+            panelStore.setBadge('btw', running ? { level: 'info', unread: 0 } : null);
+            return;
+        }
+        const unread = thread?.unread;
+        panelStore.setBadge('btw', unread !== undefined && unread.count > 0
+            ? { level: unread.error ? 'error' : 'info', unread: unread.count }
+            : running ? { level: 'info', unread: 0 } : null);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- badge derives from the thread snapshot version
+    }, [version, visible]);
+    const attachTurn = React.useCallback((turn) => {
+        if (typeof channel.attachContext !== 'function')
+            return;
+        channel.attachContext({
+            source: 'panel',
+            sourceId: turn.turnId,
+            title: '/btw: ' + turn.question,
+            content: turn.answer,
+        });
+        const staged = channel.attachedContexts.find(entry => entry.sourceId === turn.turnId);
+        channel.notify(staged?.truncated === true ? t('btw-thread-answer-truncated') : t('btw-thread-answer-attached'), { color: 'success' });
+    }, [channel]);
+    const submitDraft = React.useCallback(() => {
+        const text = btwThreads.get(sessionId)?.draft ?? '';
+        if (text.trim() === '')
+            return;
+        const result = btwThreads.submit(sessionId, text, (question, options) => channel.sideQuestion(question, options), btwContextOptions());
+        if (!result.ok) {
+            setNotice({
+                text: t(result.reason === 'busy' || result.reason === 'congested' ? 'btw-thread-busy' : 'btw-thread-followup'),
+                failure: true,
+            });
+            return;
+        }
+        // 发送成功才清草稿（失败/忙保留原文，AgentMessageComposer 同款契约）。
+        btwThreads.setDraft(sessionId, '');
+        setCaret(0);
+        setNotice(null);
+    }, [channel, sessionId, setCaret]);
+    const newTopic = React.useCallback(() => {
+        btwThreads.newTopic(sessionId);
+        setNotice(null);
+        channel.notify(t('btw-thread-clear'), { timeoutMs: 2500 });
+    }, [sessionId, channel]);
+    // ── 键盘：composer 层 > 列表层 > 宿主（未消费的键返回 false）──────────
+    const onKey = React.useCallback((input, key) => {
+        if (composerFocus) {
+            const text = btwThreads.get(sessionId)?.draft ?? '';
+            const result = btwComposerKey({ text, caret: caretRef.current }, input, key);
+            if (result === null)
+                return false;
+            if (result.exitFocus === true) {
+                setComposerFocus(false);
+                return true;
+            }
+            if (result.submit === true) {
+                submitDraft();
+                return true;
+            }
+            if (result.state !== undefined) {
+                btwThreads.setDraft(sessionId, result.state.text);
+                setCaret(result.state.caret);
+                setNotice(null);
+            }
+            return true;
+        }
+        const tabKey = key.tab === true || input === '\t';
+        if (tabKey) {
+            setComposerFocus(true);
+            return true;
+        }
+        if (input === 'n' && key.ctrl !== true && key.meta !== true) {
+            newTopic();
+            return true;
+        }
+        if (input === 's' && key.ctrl !== true && key.meta !== true) {
+            const latest = [...(btwThreads.get(sessionId)?.turns ?? [])].reverse().find(turn => turn.phase === 'completed');
+            if (latest !== undefined)
+                attachTurn(latest);
+            return true;
+        }
+        // 列表层不独占 Esc/←/→：返回 false 交宿主（Esc 回聊天、←/→ 切面板）。
+        return false;
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [composerFocus, sessionId, submitDraft, newTopic, attachTurn, setCaret]);
+    usePanelInput(onKey, { active: focused && visible });
+    // ── 头部：/btw + 首问标题（单行裁切）+ 新话题 + 上下文覆盖提示 ────────
+    const title = thread !== undefined && thread.turns.length > 0 ? thread.turns[0].question : '';
+    const newLabel = t('btw-thread-new');
+    // 覆盖提示跟随 dsh-tui.btw.contextTurns 的活值（/settings 改完即换词）。
+    const contextTurns = React.useSyncExternalStore(subscribeBtwContextTurns, getBtwContextTurns);
+    const contextLabel = t('btw-thread-context-recent', { n: contextTurns });
+    const budget = Math.max(6, width - 2);
+    const titleRoom = budget - stringWidth(newLabel) - stringWidth(contextLabel) - 5;
+    const header = (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, children: [_jsx(Text, { color: "warning", bold: true, children: "/btw " }), _jsx(Text, { dimColor: true, wrap: "truncate", children: truncateWidth(title, Math.max(2, titleRoom)) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { children: " " }) }), _jsx(Box, { flexShrink: 0, onClick: event => { event.stopImmediatePropagation(); newTopic(); }, children: _jsxs(Text, { color: "permission", children: ["[n] ", newLabel] }) })] }));
+    const contextNote = (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: contextLabel }) }));
+    return (_jsxs(Box, { flexDirection: "column", width: "100%", height: height, overflow: "hidden", children: [header, contextNote, _jsx(BtwThreadView, { thread: thread, width: width, height: Math.max(3, height - 5), alive: visible, onAttachTurn: attachTurn }), _jsx(BtwComposer, { state: { text: thread?.draft ?? '', caret }, focused: composerFocus && focused && visible, busy: busy, notice: notice === undefined || notice === null ? undefined : notice })] }));
+}

package/lib/types/components/sidePanel/btw/BtwThreadScene.d.ts

@@ -0,0 +1,14 @@
+/**
+ * BtwThreadScene（btw 面板的 ⤢ 全屏）：完整问题与 Markdown 长文、线程
+ * 滚动、composer 追问。Esc 返回侧栏，面板状态原样（mountPolicy=enabled
+ * 不卸载，thread 与 draft 都在线程 store）。
+ *
+ * 键层级：composer 编辑（Esc 收起草稿）> 场景滚动/动作 > Esc 退出场景。
+ */
+import React from 'react';
+import type { ChannelUi } from '../../../adapter/channel/ui-policy.js';
+export declare function BtwThreadScene({ channel, onClose, }: {
+    readonly channel: ChannelUi;
+    readonly onClose: () => void;
+}): React.ReactNode;
+//# sourceMappingURL=BtwThreadScene.d.ts.map