@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

package/lib/types/components/questions/PlanReviewPanel.js

@@ -168,11 +168,22 @@ export function PlanReviewPanel({ question, onAnswer, onCancel, }) {
         }
     }, { isActive: true });
     const cursorChar = cursor < feedback.length ? feedback[cursor] : ' ';
+    /** Mouse: click a decision row = focus it + submit (same as Enter). */
+    const [hoverIndex, setHoverIndex] = React.useState(-1);
+    const clickOption = (index) => {
+        setFocusIndex(index);
+        submitOption(index);
+    };
+    /** Mouse: click the feedback row to focus it. */
+    const focusFeedbackRow = () => {
+        setFocusIndex(options.length);
+        setError(null);
+    };
     return (_jsxs(Box, { flexDirection: "column", marginTop: 1, paddingLeft: 2, paddingRight: 2, width: "100%", children: [_jsx(Divider, { color: "permission", title: ` ${question.header ?? t('plan-review-fallback-header')} `, padding: 4 }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { bold: true, wrap: "wrap", children: question.question }), question.detail !== undefined && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: _jsx(Markdown, { children: question.detail }) }))] }), _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [options.map((option, index) => {
                         const focused = index === focusIndex;
                         const isApprove = option.label === approveLabel;
-                        return (_jsxs(Box, { flexDirection: "row", marginTop: focused ? 1 : 0, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'claude' : undefined, bold: focused, children: focused ? POINTER : ' ' }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { bold: focused, color: focused || isApprove ? 'claude' : undefined, wrap: "wrap", children: [index + 1, ". ", option.label] }), option.description !== undefined && (_jsx(Text, { dimColor: true, wrap: "wrap", children: option.description }))] })] }, option.label));
-                    }), _jsxs(Box, { flexDirection: "row", marginTop: inputFocused ? 1 : 0, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : undefined, bold: inputFocused, children: inputFocused ? POINTER : ' ' }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : 'suggestion', children: PENCIL }) }), _jsx(Box, { flexDirection: "row", marginLeft: 1, children: feedback === '' && !inputFocused ? (_jsx(Text, { ref: caretRef, dimColor: true, children: t('plan-review-feedback-placeholder') })) : (_jsxs(_Fragment, { children: [_jsx(Text, { wrap: "wrap", children: feedback.slice(0, cursor) }), inputFocused
+                        return (_jsxs(Box, { flexDirection: "row", marginTop: focused ? 1 : 0, onClick: () => clickOption(index), onMouseEnter: () => setHoverIndex(index), onMouseLeave: () => setHoverIndex(current => (current === index ? -1 : current)), backgroundColor: hoverIndex === index && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: focused ? 'claude' : undefined, bold: focused, children: focused ? POINTER : ' ' }) }), _jsxs(Box, { flexDirection: "column", marginLeft: 1, children: [_jsxs(Text, { bold: focused, color: focused || isApprove ? 'claude' : undefined, wrap: "wrap", children: [index + 1, ". ", option.label] }), option.description !== undefined && (_jsx(Text, { dimColor: true, wrap: "wrap", children: option.description }))] })] }, option.label));
+                    }), _jsxs(Box, { flexDirection: "row", marginTop: inputFocused ? 1 : 0, onClick: focusFeedbackRow, onMouseEnter: () => setHoverIndex(options.length), onMouseLeave: () => setHoverIndex(current => (current === options.length ? -1 : current)), backgroundColor: hoverIndex === options.length && !inputFocused ? 'userMessageBackgroundHover' : undefined, children: [_jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : undefined, bold: inputFocused, children: inputFocused ? POINTER : ' ' }) }), _jsx(Box, { width: 1, flexShrink: 0, children: _jsx(Text, { color: inputFocused ? 'claude' : 'suggestion', children: PENCIL }) }), _jsx(Box, { flexDirection: "row", marginLeft: 1, children: feedback === '' && !inputFocused ? (_jsx(Text, { ref: caretRef, dimColor: true, children: t('plan-review-feedback-placeholder') })) : (_jsxs(_Fragment, { children: [_jsx(Text, { wrap: "wrap", children: feedback.slice(0, cursor) }), inputFocused
                                             ? _jsx(Text, { ref: caretRef, inverse: true, children: cursorChar })
                                             : _jsx(Text, { ref: caretRef, color: "suggestion", children: "\u258F" }), _jsx(Text, { wrap: "wrap", children: feedback.slice(inputFocused ? cursor + 1 : cursor) })] })) })] })] }), error !== null && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "error", children: error }) })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: t('plan-review-hint') }) })] }));
 }

package/lib/types/components/sessions/SessionListRow.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { ClickEvent } from '../../ink/events/click-event.js';
 import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
 /**
  * One session in the browser's list: a title line and a metadata line.
@@ -13,7 +14,7 @@ import type { SessionSummary } from '../../dsh-adapter/sessions/index.js';
  * stay exactly two lines at every terminal width, and a row that wraps
  * destroys the alignment that lets the eye scan a list at all.
  */
-export declare function SessionListRow({ session, width, depth, focused, now, }: {
+export declare function SessionListRow({ session, width, depth, focused, now, onClick, }: {
     session: SessionSummary;
     /** Columns available to the row, indentation included. */
     width: number;
@@ -22,5 +23,7 @@ export declare function SessionListRow({ session, width, depth, focused, now, }:
     focused: boolean;
     /** Epoch ms used for every relative time in this render pass. */
     now: number;
+    /** 鼠标点击行（fullscreen）：恢复该会话（与 Enter 同路径）。 */
+    onClick?(event: ClickEvent): void;
 }): React.ReactNode;
 //# sourceMappingURL=SessionListRow.d.ts.map

package/lib/types/components/sessions/SessionListRow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionListRow.d.ts","sourceRoot":"","sources":["../../../../src/components/sessions/SessionListRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,GAAG,GACJ,EAAE;IACD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,KAAK,CAAC,SAAS,CAoClB"}
+{"version":3,"file":"SessionListRow.d.ts","sourceRoot":"","sources":["../../../../src/components/sessions/SessionListRow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAGvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAQjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,KAAK,EACL,KAAK,EACL,OAAO,EACP,GAAG,EACH,OAAO,GACR,EAAE;IACD,OAAO,EAAE,cAAc,CAAA;IACvB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAA;IACX,4CAA4C;IAC5C,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAClC,GAAG,KAAK,CAAC,SAAS,CA4ClB"}

package/lib/types/components/sessions/SessionListRow.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
 import { Box, Text } from '../../ui.js';
 import { t } from '../../i18n.js';
 import { formatBytes, formatWhen, kindMark, titleColor, truncateWidth, } from '../../sessions/format.js';
@@ -15,11 +16,12 @@ import { formatBytes, formatWhen, kindMark, titleColor, truncateWidth, } from '.
  * stay exactly two lines at every terminal width, and a row that wraps
  * destroys the alignment that lets the eye scan a list at all.
  */
-export function SessionListRow({ session, width, depth, focused, now, }) {
+export function SessionListRow({ session, width, depth, focused, now, onClick, }) {
     const indent = depth * 2;
     // Two cells for the focus marker, plus the indent for a nested run.
     const body = Math.max(8, width - 2 - indent);
     const mark = kindMark(session.kind);
+    const [hovered, setHovered] = useState(false);
     const facts = [formatWhen(session.updatedAt, now)];
     if (session.branch !== undefined)
         facts.push(session.branch);
@@ -31,5 +33,5 @@ export function SessionListRow({ session, width, depth, focused, now, }) {
     if (session.childCount > 0 && depth === 0) {
         facts.push(t('session-children', { n: session.childCount }));
     }
-    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsxs(Box, { children: [_jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: `${' '.repeat(indent)}${focused ? '❯ ' : '  '}` }), mark !== undefined && _jsx(Text, { color: mark.color, children: `${mark.glyph} ` }), _jsx(Text, { color: titleColor(session.title.source, focused), bold: focused, children: truncateWidth(session.label ?? session.title.text, body - (mark === undefined ? 0 : 2)) })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${' '.repeat(indent + 2)}${truncateWidth(facts.join(' · '), body)}` }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, onClick: onClick, onMouseEnter: onClick !== undefined ? () => setHovered(true) : undefined, onMouseLeave: onClick !== undefined ? () => setHovered(false) : undefined, backgroundColor: hovered && !focused ? 'userMessageBackgroundHover' : undefined, children: [_jsxs(Box, { children: [_jsx(Text, { color: focused ? 'suggestion' : 'subtle', children: `${' '.repeat(indent)}${focused ? '❯ ' : '  '}` }), mark !== undefined && _jsx(Text, { color: mark.color, children: `${mark.glyph} ` }), _jsx(Text, { color: titleColor(session.title.source, focused), bold: focused, children: truncateWidth(session.label ?? session.title.text, body - (mark === undefined ? 0 : 2)) })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${' '.repeat(indent + 2)}${truncateWidth(facts.join(' · '), body)}` }) })] }));
 }

package/lib/types/components/trajectory/HotspotView.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { HotspotRow, HotspotSort, TrajAggregate } from '../../dsh-adapter/types.js';
 /** Flatten the three sections into the single list the cursor walks. */
 export declare function hotspotRows(agg: TrajAggregate): HotspotRow[];
-export declare function HotspotView({ agg, sort, width, height, cursor, tick, switchTick, }: {
+export declare function HotspotView({ agg, sort, width, height, cursor, tick, switchTick, onRowClick, }: {
     agg: TrajAggregate;
     sort: HotspotSort;
     width: number;
@@ -10,5 +10,11 @@ export declare function HotspotView({ agg, sort, width, height, cursor, tick, sw
     cursor: number;
     tick: number;
     switchTick: number;
+    /**
+     * Mouse pick (fullscreen): reports the clicked row's cursor index — the
+     * scene jumps back to the timeline positioned on the group's first member
+     * (same path as the keyboard Enter). Hover shows a dim `▸` pointer.
+     */
+    onRowClick?: (cursorIndex: number) => void;
 }): React.ReactNode;
 //# sourceMappingURL=HotspotView.d.ts.map

package/lib/types/components/trajectory/HotspotView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HotspotView.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/HotspotView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AA6CxF,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE,CAE5D;AAOD,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,IAAI,EACJ,UAAU,GACX,EAAE;IACD,GAAG,EAAE,aAAa,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,KAAK,CAAC,SAAS,CA4ElB"}
+{"version":3,"file":"HotspotView.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/HotspotView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AA6CxF,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,UAAU,EAAE,CAE5D;AAOD,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,IAAI,EACJ,UAAU,EACV,UAAU,GACX,EAAE;IACD,GAAG,EAAE,aAAa,CAAA;IAClB,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;CAC3C,GAAG,KAAK,CAAC,SAAS,CA6FlB"}

package/lib/types/components/trajectory/HotspotView.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
 import { Box, Text, useTheme } from '../../ui.js';
 import { getTheme } from '../../theme.js';
 import { formatDuration, formatTokens, truncateWidth } from '../../trajectory/format.js';
@@ -40,9 +41,10 @@ export function hotspotRows(agg) {
 function valueOf(row, sort) {
     return sort === 'count' ? row.count : sort === 'tokens' ? row.tokens : row.totalMs;
 }
-export function HotspotView({ agg, sort, width, height, cursor, tick, switchTick, }) {
+export function HotspotView({ agg, sort, width, height, cursor, tick, switchTick, onRowClick, }) {
     const [themeName] = useTheme();
     const theme = getTheme(themeName);
+    const [hoverIndex, setHoverIndex] = React.useState(-1);
     const labelWidth = Math.min(18, Math.max(10, Math.floor(width * 0.16)));
     const barWidth = Math.max(6, Math.min(30, width - labelWidth - 34));
     // Build the flat list once, tagging each row with its section's scale.
@@ -72,12 +74,16 @@ export function HotspotView({ agg, sort, width, height, cursor, tick, switchTick
             }
             const { row, max, colorKey } = entry;
             const focused = entry.cursorIndex === cursor;
+            // 鼠标：行点击跳回 timeline 定位；悬停轻指示（dim ▸，不刷背景）
+            const hovered = onRowClick !== undefined && hoverIndex === entry.cursorIndex;
             // Stagger the settle by row so a section reads top-down on switch.
             const dim = reproject(tick - offset, switchTick);
             const base = row.error === true ? theme.error : theme[colorKey];
             const stats = `${row.count}×` +
                 (row.tokens > 0 ? ` · ${formatTokens(row.tokens)}` : '') +
                 (row.count > 0 && row.totalMs > 0 ? ` · ⌀${formatDuration(row.totalMs / row.count)}` : '');
-            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, children: [_jsx(Box, { flexShrink: 0, width: 2, children: _jsx(Text, { color: "suggestion", children: focused ? '▸' : ' ' }) }), _jsx(Box, { flexShrink: 0, width: labelWidth, children: _jsx(Text, { color: focused ? 'suggestion' : row.error === true ? 'error' : undefined, children: truncateWidth(row.label, labelWidth) }) }), _jsx(Box, { flexShrink: 0, width: barWidth, children: _jsx(Text, { color: mix(base, theme.background, dim), children: bar(valueOf(row, sort), max, barWidth) }) }), _jsx(Box, { flexShrink: 0, width: 8, justifyContent: "flex-end", children: _jsx(Text, { bold: true, color: row.error === true ? 'error' : undefined, children: formatDuration(row.totalMs) }) }), _jsx(Box, { flexShrink: 1, overflow: "hidden", children: _jsx(Text, { color: "subtle", children: truncateWidth(stats, Math.max(4, width - labelWidth - barWidth - 16)) }) })] }, `r${entry.cursorIndex}`));
+            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, onClick: onRowClick === undefined ? undefined : () => onRowClick(entry.cursorIndex), onMouseEnter: onRowClick === undefined ? undefined : () => setHoverIndex(entry.cursorIndex), onMouseLeave: onRowClick === undefined
+                    ? undefined
+                    : () => setHoverIndex(previous => (previous === entry.cursorIndex ? -1 : previous)), children: [_jsx(Box, { flexShrink: 0, width: 2, children: _jsx(Text, { color: focused ? 'suggestion' : 'inactive', children: focused || hovered ? '▸' : ' ' }) }), _jsx(Box, { flexShrink: 0, width: labelWidth, children: _jsx(Text, { color: focused ? 'suggestion' : row.error === true ? 'error' : undefined, children: truncateWidth(row.label, labelWidth) }) }), _jsx(Box, { flexShrink: 0, width: barWidth, children: _jsx(Text, { color: mix(base, theme.background, dim), children: bar(valueOf(row, sort), max, barWidth) }) }), _jsx(Box, { flexShrink: 0, width: 8, justifyContent: "flex-end", children: _jsx(Text, { bold: true, color: row.error === true ? 'error' : undefined, children: formatDuration(row.totalMs) }) }), _jsx(Box, { flexShrink: 1, overflow: "hidden", children: _jsx(Text, { color: "subtle", children: truncateWidth(stats, Math.max(4, width - labelWidth - barWidth - 16)) }) })] }, `r${entry.cursorIndex}`));
         }) }));
 }

package/lib/types/components/trajectory/Ledger.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
+import type { ClickEvent } from '../../ink/events/click-event.js';
 import type { TrajNode } from '../../dsh-adapter/types.js';
-export declare function Ledger({ rows, start, height, cursor, width, tick, arrivalTick, arrivalFrom, }: {
+export declare function Ledger({ rows, start, height, cursor, width, tick, arrivalTick, arrivalFrom, onRowClick, }: {
     /** The (possibly filtered) ledger. */
     rows: readonly TrajNode[];
     /** Index of the first visible row. */
@@ -16,5 +17,12 @@ export declare function Ledger({ rows, start, height, cursor, width, tick, arriv
     arrivalTick: number;
     /** Rows at or after this index are the ones that just arrived. */
     arrivalFrom: number;
+    /**
+     * Mouse pick (fullscreen): reports the clicked row's absolute index — the
+     * scene jumps the cursor to it (same semantics as the keyboard jumps).
+     * Hover on a non-focused row shows a dim `▸` pointer — light indication,
+     * no background wash (the ledger is content, not a menu).
+     */
+    onRowClick?: (index: number, event: ClickEvent) => void;
 }): React.ReactNode;
 //# sourceMappingURL=Ledger.d.ts.map

package/lib/types/components/trajectory/Ledger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Ledger.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Ledger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAiBzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AA6C1D,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,GACZ,EAAE;IACD,sCAAsC;IACtC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IACzB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CAoJlB"}
+{"version":3,"file":"Ledger.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/Ledger.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAgBjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AA6C1D,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,UAAU,GACX,EAAE;IACD,sCAAsC;IACtC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;IACzB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CACxD,GAAG,KAAK,CAAC,SAAS,CAsKlB"}

package/lib/types/components/trajectory/Ledger.js

@@ -1,4 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from 'react';
 import { Box, Text, useTheme } from '../../ui.js';
 import { burstDurationMs, burstErrors, previewText } from '../../dsh-adapter/trajectory/index.js';
 import { costGlyph, formatDuration, formatClock, heatColor, KIND_BADGE, KIND_BADGE_BG, KIND_FG, KIND_GLYPH, ledgerLayout, } from '../../trajectory/format.js';
@@ -46,9 +47,10 @@ function spineGlyph(rows, index) {
         return SPINE.close;
     return SPINE.mid;
 }
-export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick, arrivalFrom, }) {
+export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick, arrivalFrom, onRowClick, }) {
     const [themeName] = useTheme();
     const theme = getTheme(themeName);
+    const [hoverIndex, setHoverIndex] = React.useState(-1);
     const layout = ledgerLayout(width);
     const visible = rows.slice(start, start + height);
     const arriving = arrive(tick, arrivalTick);
@@ -65,6 +67,22 @@ export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick,
             const running = node.status === 'running';
             const isNew = index >= arrivalFrom && arriving > 0;
             const duration = node.burst === undefined ? node.durationMs : burstDurationMs(node.burst);
+            // 鼠标：行点击跳光标；悬停在非焦点行亮出 dim ▸（轻指示，不刷背景）
+            const hovered = onRowClick !== undefined && hoverIndex === index;
+            const pointer = focused || hovered ? '▸' : ' ';
+            const rowEvents = onRowClick === undefined
+                ? undefined
+                : {
+                    onClick: (event) => {
+                        onRowClick(index, event);
+                    },
+                    onMouseEnter: () => {
+                        setHoverIndex(index);
+                    },
+                    onMouseLeave: () => {
+                        setHoverIndex(previous => (previous === index ? -1 : previous));
+                    },
+                };
             // ── structural rows are RULES, not rows ────────────────────────────
             //
             // A ledger with five hundred entries needs chapters. Turn and step
@@ -82,7 +100,7 @@ export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick,
                 // attention than the work between them. Only the turn, which is the
                 // session's actual chapter break, gets a rule.
                 if (!isTurn) {
-                    return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: "subtle", children: `${focused ? '▸' : ' '}╵` }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsx(Text, { color: focused ? 'suggestion' : 'subtle', wrap: "truncate", children: node.label }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: heatColor(duration), children: right }) })] }, `${node.seq}:step`));
+                    return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, ...rowEvents, children: [_jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: "subtle", children: `${pointer}╵` }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsx(Text, { color: focused ? 'suggestion' : 'subtle', wrap: "truncate", children: node.label }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: heatColor(duration), children: right }) })] }, `${node.seq}:step`));
                 }
                 const tone = failed ? 'error' : running ? 'success' : 'inactiveShimmer';
                 // Idle before a turn is wall-clock the session spent waiting on the
@@ -92,9 +110,9 @@ export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick,
                 const previous = rows[index - 1];
                 const idle = previous === undefined ? 0 : node.time - (previous.time + (previous.durationMs ?? 0));
                 const idleText = idle >= IDLE_FLOOR_MS ? `  ⋯ ${formatDuration(idle)}` : '';
-                const head = `${focused ? '▸' : ' '}━━ ${node.label}${idleText} `;
+                const head = `${pointer}━━ ${node.label}${idleText} `;
                 const fill = Math.max(2, width - stringWidth(head) - stringWidth(right) - 2);
-                return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, children: _jsxs(Text, { color: tone, bold: true, children: [`${focused ? '▸' : ' '}━━ ${node.label}`, _jsx(Text, { color: "subtle", children: idleText }), _jsx(Text, { color: "inactive", children: ` ${'━'.repeat(fill)} ` }), _jsx(Text, { color: failed ? 'error' : heatColor(duration), children: right })] }) }, `${node.seq}:turn`));
+                return (_jsx(Box, { width: "100%", height: 1, flexShrink: 0, ...rowEvents, children: _jsxs(Text, { color: tone, bold: true, children: [`${pointer}━━ ${node.label}`, _jsx(Text, { color: "subtle", children: idleText }), _jsx(Text, { color: "inactive", children: ` ${'━'.repeat(fill)} ` }), _jsx(Text, { color: failed ? 'error' : heatColor(duration), children: right })] }) }, `${node.seq}:turn`));
             }
             const spineColor = failed ? 'error' : running ? 'success' : node.seed === true ? 'subtle' : 'inactive';
             const badgeBg = KIND_BADGE_BG[node.kind];
@@ -107,6 +125,6 @@ export function Ledger({ rows, start, height, cursor, width, tick, arrivalTick,
             const outcome = layout.outcome && node.outcome !== undefined && node.outcome !== ''
                 ? previewText(node.outcome, Math.max(8, Math.floor(layout.detail * 0.3)))
                 : '';
-            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: spineColor, children: [focused ? '▸' : ' ', spineGlyph(rows, index)] }) }), layout.index && (_jsx(Box, { flexShrink: 0, width: 8, children: _jsx(Text, { color: "subtle", children: formatClock(node.time) }) })), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: isNew ? mix(theme[KIND_FG[node.kind]], theme.text, arriving) : KIND_FG[node.kind], backgroundColor: badgeBg, bold: true, children: badge }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: focused ? 'suggestion' : node.seed === true ? 'subtle' : undefined, children: [label, detail === '' ? '' : ' ', _jsx(Text, { color: focused ? 'suggestion' : 'inactive', children: detail }), outcome === '' ? '' : _jsx(Text, { color: "subtle", children: `  → ${outcome}` })] }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: running ? '…' : duration === undefined ? '' : formatDuration(duration) }) })] }, `${node.seq}:${node.kind}`));
+            return (_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, gap: 1, ...rowEvents, children: [_jsx(Box, { flexShrink: 0, children: _jsxs(Text, { color: spineColor, children: [pointer, spineGlyph(rows, index)] }) }), layout.index && (_jsx(Box, { flexShrink: 0, width: 8, children: _jsx(Text, { color: "subtle", children: formatClock(node.time) }) })), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: isNew ? mix(theme[KIND_FG[node.kind]], theme.text, arriving) : KIND_FG[node.kind], backgroundColor: badgeBg, bold: true, children: badge }) }), _jsx(Box, { flexGrow: 1, flexShrink: 1, overflow: "hidden", children: _jsxs(Text, { wrap: "truncate", color: focused ? 'suggestion' : node.seed === true ? 'subtle' : undefined, children: [label, detail === '' ? '' : ' ', _jsx(Text, { color: focused ? 'suggestion' : 'inactive', children: detail }), outcome === '' ? '' : _jsx(Text, { color: "subtle", children: `  → ${outcome}` })] }) }), _jsx(Box, { flexShrink: 0, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: costGlyph(duration) }) }), _jsx(Box, { flexShrink: 0, justifyContent: "flex-end", width: 7, children: _jsx(Text, { color: running ? 'success' : heatColor(duration), children: running ? '…' : duration === undefined ? '' : formatDuration(duration) }) })] }, `${node.seq}:${node.kind}`));
         }) }));
 }

package/lib/types/components/trajectory/WaveBand.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
+import type { ClickEvent } from '../../ink/events/click-event.js';
 import type { WaveBand as Band } from '../../dsh-adapter/types.js';
-export declare function WaveBand({ band, width, cursorColumn, viewportStart, viewportEnd, matches, tick, alertTick, }: {
+export declare function WaveBand({ band, width, cursorColumn, viewportStart, viewportEnd, matches, tick, alertTick, onColumnClick, }: {
     band: Band;
     /** Rendered width in cells; equals `band.buckets.length`. */
     width: number;
@@ -19,6 +20,14 @@ export declare function WaveBand({ band, width, cursorColumn, viewportStart, vie
     tick: number;
     /** Tick the most recent alert was triggered on. */
     alertTick: number;
+    /**
+     * Mouse pick (fullscreen): reports the clicked column (0-based within the
+     * band; the ruler row counts too — its ▐▌ bracket is the seek affordance).
+     * The scene jumps to that column's nearest event via bucket.firstIndex,
+     * which empty columns inherit from their predecessor for exactly this
+     * purpose. No hover: column density makes per-cell indication noise.
+     */
+    onColumnClick?: (column: number, event: ClickEvent) => void;
 }): React.ReactNode;
 /**
  * Convert a theme colour to the `#rrggbb` form chalk needs.

package/lib/types/components/trajectory/WaveBand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WaveBand.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/WaveBand.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,QAAQ,IAAI,IAAI,EAAe,MAAM,4BAA4B,CAAA;AAmD/E,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,OAAO,EACP,IAAI,EACJ,SAAS,GACV,EAAE;IACD,IAAI,EAAE,IAAI,CAAA;IACV,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,KAAK,CAAC,SAAS,CAgGlB;AAED;;;;;;GAMG;AACH,iBAAS,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrC;AAED,6EAA6E;AAC7E,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAA"}
+{"version":3,"file":"WaveBand.d.ts","sourceRoot":"","sources":["../../../../src/components/trajectory/WaveBand.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAIjE,OAAO,KAAK,EAAE,QAAQ,IAAI,IAAI,EAAe,MAAM,4BAA4B,CAAA;AAmD/E,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,aAAa,EACb,WAAW,EACX,OAAO,EACP,IAAI,EACJ,SAAS,EACT,aAAa,GACd,EAAE;IACD,IAAI,EAAE,IAAI,CAAA;IACV,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC7B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;CAC5D,GAAG,KAAK,CAAC,SAAS,CA2GlB;AAED;;;;;;GAMG;AACH,iBAAS,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMrC;AAED,6EAA6E;AAC7E,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAA"}

package/lib/types/components/trajectory/WaveBand.js

@@ -50,7 +50,7 @@ function channelColor(channel, theme) {
         default: return theme.subtle;
     }
 }
-export function WaveBand({ band, width, cursorColumn, viewportStart, viewportEnd, matches, tick, alertTick, }) {
+export function WaveBand({ band, width, cursorColumn, viewportStart, viewportEnd, matches, tick, alertTick, onColumnClick, }) {
     const [themeName] = useTheme();
     const theme = getTheme(themeName);
     if (band.buckets.length === 0) {
@@ -123,7 +123,12 @@ export function WaveBand({ band, width, cursorColumn, viewportStart, viewportEnd
             ? chalk.hex(toHex(theme.permission))(glyph)
             : chalk.hex(toHex(theme.subtle))(glyph);
     }
-    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Text, { children: wave }), _jsx(Text, { children: rulerText })] }));
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, onClick: onColumnClick === undefined
+            ? undefined
+            : (event) => {
+                const column = Math.max(0, Math.min(band.buckets.length - 1, event.localCol));
+                onColumnClick(column, event);
+            }, children: [_jsx(Text, { children: wave }), _jsx(Text, { children: rulerText })] }));
 }
 /**
  * Convert a theme colour to the `#rrggbb` form chalk needs.

package/lib/types/dsh-adapter/channel.d.ts

@@ -1,14 +1,16 @@
 import { type Agent, type AgentHandle, type AgentStatus } from '@deepseek-ai/dsh-agent';
-import type { LlmModelInfo } from '@deepseek-ai/dsh-llm';
+import type { LlmModelInfo, LlmProviderInfo } from '@deepseek-ai/dsh-llm';
 import { type ContentBlock } from '@deepseek-ai/dsh-llm';
+import { type RecapOutcome } from './recap.js';
 import { type SessionEvent } from '@deepseek-ai/dsh-session';
 import type { Context } from '@deepseek-ai/cordis';
 import { type CommandCompletion, type LocalCommand } from '../commands.js';
+import { type SessionTreeData } from './sessionTree.js';
 import { type PreviewEntry, type SessionSummary } from './sessions/index.js';
 import { type FileCandidate } from '../utils/fileSuggestions.js';
-import type { ProviderSetupHost } from './providerWizard.js';
+import type { OAuthProviderStatus, ProviderSetupHost } from './providerWizard.js';
 import { type SessionModeSpec } from '../sessionModes.js';
-import { type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
+import { type ScrollGutterMode, type StatusBarConfig, type ToolBackground } from '../tuiDisplayPrefs.js';
 import { type SubagentState } from './subagents.js';
 export type { SubagentState } from './subagents.js';
 import type { SpinnerMode } from '../components/Spinner/spinnerMode.js';
@@ -316,11 +318,32 @@ export interface Channel {
     readonly rows: readonly ChatRow[];
     readonly status: AgentStatus | 'starting' | 'disposed';
     readonly sessionTitle: string;
+    /** Per-session accent color name (`/color`), '' when unset — persisted via
+     *  a `session/color` log event so it survives resume/rewind. Renders as
+     *  the prompt-input border + session label chip accent (cc/sessionColors). */
+    readonly sessionColor: string;
     readonly agentId: string;
+    /** `dsh-tui.recapOnOpen` (default on): auto-summarize the session tail
+     *  into the dim AutoRecapRow when the session opens/resumes. Read live
+     *  (settings service), so a `/settings` change applies on the next
+     *  session switch; absent settings service → on. */
+    readonly autoRecapOnOpen: boolean;
     /** Resolved model id (from the plugin config). */
     readonly model: string;
     /** Provider route of the live agent. */
     readonly provider: string;
+    /** Raw cordis.yml `provider` key (undefined when unset) — the boot-time
+     *  pin `/reload` must never override. */
+    readonly configuredProvider: string | undefined;
+    /** Raw cordis.yml `model` key (undefined when unset). */
+    readonly configuredModel: string | undefined;
+    /** Explicit cordis.yml `preset` (undefined = roster default wins) — `/reload`
+     *  must not override a static deployment choice. */
+    readonly configuredPreset: string | undefined;
+    /** Explicit cordis.yml `activityFrames` (undefined = pref/default wins). */
+    readonly configuredActivityFrames: string | undefined;
+    /** Explicit cordis.yml `lang` (undefined = settings/lang.json wins). */
+    readonly configuredLang: string | undefined;
     /** Running token totals across the session's assistant messages. */
     readonly tokens: TokenUsage;
     /** Working directory of the session. */
@@ -376,6 +399,13 @@ export interface Channel {
     readonly thinkingFold: 'preview' | 'full';
     /** Live tool-card background treatment. */
     readonly toolBackground: ToolBackground;
+    /** What the fullscreen transcript's right gutter shows (settings
+     *  `dsh-tui.scrollGutter`: turn timeline / proportional scrollbar /
+     *  nothing). */
+    readonly scrollGutter: ScrollGutterMode;
+    /** Whether the session-name chip shows on the prompt top border's right
+     *  side (settings `dsh-tui.promptSessionLabel`; off by default). */
+    readonly promptSessionLabel: boolean;
     /** Live status-footer visibility and compactness preferences. */
     readonly statusBar: Readonly<StatusBarConfig>;
     /** Whether the header's pixel whale art shows (settings `dsh-tui.whale`). */
@@ -390,10 +420,11 @@ export interface Channel {
     readonly contextBarEnabled: boolean;
     /**
      * Current same-session goal projection, when a goal exists. Derived live
-     * from the durable `goal/change` context events (round-zero goal-sourced
-     * user messages) in the session log — every goal mutation appends one, so
-     * this snapshot tracks create/edit/pause/resume/complete/block/clear in
-     * real time and replays correctly on resume/rewind.
+     * from the durable goal events in the session log — top-level
+     * `goal/change` snapshots (every goal mutation appends one) plus the
+     * goal-sourced continuation rounds that advance the counter — so this
+     * snapshot tracks create/edit/pause/resume/complete/block/clear in real
+     * time and replays correctly on resume/rewind.
      */
     readonly goal: ChannelGoal | undefined;
     /**
@@ -500,6 +531,25 @@ export interface Channel {
     promptRewind(row: ChatRow): Promise<{
         modes: readonly TuiRewindMode[];
     } | 'cancel' | null>;
+    /**
+     * The session family tree for the /tree screen (pi's Session Tree): the
+     * live session's whole lineage — ancestors, siblings, descendants —
+     * stitched across fork sessions into one message-level tree. `null` (with
+     * a notify) when session persistence is unavailable or the live session
+     * swapped while the family loaded.
+     */
+    buildSessionTree(): Promise<SessionTreeData | null>;
+    /**
+     * Session-tree fork: `rewind` drops the picked user turn (its prompt comes
+     * back as the returned text), `fork` keeps the picked entry. `seq` is the
+     * tree entry's source event seq inside `sessionId`'s log; `sessionId` may
+     * be any family member (adopting a dead branch forks IT at the picked
+     * point). Null = refused (the channel notified why).
+     */
+    rewindToNode(sessionId: string, seq: number, mode?: 'rewind' | 'fork'): Promise<string | null>;
+    /** `/fork`: fork the current session at its tip into a persisted copy the
+     *  user enters via `/resume` — the live session keeps running untouched. */
+    forkSession(): Promise<boolean>;
     /** Switch the live agent to a persisted session, replaying its history. */
     resumeTo(sessionId: string): Promise<ResumeResult>;
     /** Start a fresh conversation (`/new`): a brand-new agent + session, the
@@ -570,6 +620,8 @@ export interface Channel {
     setActivityFrames(name: string): boolean;
     /** Advertised models across every registered provider route (empty when the LLM service is absent). */
     listModels(): Promise<readonly LlmModelInfo[]>;
+    /** Provider display identities for the same routes (picker group labels). */
+    listProviders(): Promise<readonly LlmProviderInfo[]>;
     /** The live agent's full skill catalog for `/skills` (issue #204) — name,
      *  description, invocation flags and source bucket. Undefined on a failed
      *  or incomplete registry read (the picker shows an error); empty only
@@ -581,6 +633,9 @@ export interface Channel {
      *  credentials / llm seams; undefined when the composition lacks them
      *  (bare cordis.yml start without the dsh-base services). */
     providerSetup(): ProviderSetupHost | undefined;
+    /** OAuth sign-in states from a mounted dsh-auth-style plugin; undefined
+     *  without the plugin, so `/login` renders exactly what it did before. */
+    oauthProviderStatuses(): Promise<readonly OAuthProviderStatus[] | undefined>;
     /**
      * Runtime capabilities for the `/settings` screen, over the settings /
      * credentials seams; undefined when the composition lacks the settings
@@ -610,6 +665,17 @@ export interface Channel {
     /** Rename the current session (CC's /rename): appends a `session/title`
      *  event, which the status line and the /resume picker both read. */
     renameSession(title: string): void;
+    /** Set the current session's accent color (`/color <name>`): appends a
+     *  `session/color` event; '' clears it back to the theme default. */
+    setSessionColor(color: string): void;
+    /** Generate a recap of the session's recent activity (`/recap`): one
+     *  tool-less LLM call over the tail exchanges, returning a one-line
+     *  summary plus an optional proposed title. The answer is pure UI state
+     *  and never enters the session log. */
+    recapRecent(options?: {
+        signal?: AbortSignal;
+        onText?: (delta: string) => void;
+    }): Promise<RecapOutcome>;
     /** Delete a persisted session (`/resume` picker ctrl+d): removes its log
      *  directory, its last-used entry, and the resume marker when it points
      *  here. False for the live session or a missing/unwritable log. */
@@ -696,6 +762,8 @@ export interface ChannelState {
     rows: ChatRow[];
     status: AgentStatus | 'starting' | 'disposed';
     sessionTitle: string;
+    sessionColor: string;
+    autoRecapOnOpen: boolean;
     agentId: string;
     model: string;
     provider: string;
@@ -734,12 +802,22 @@ export interface ChannelState {
     workingActivity: ActivityStatus | undefined;
     /** Working-activity indicator preset (see the public Channel type). */
     activityFrames: string | undefined;
+    /** Raw cordis.yml pins `/reload` must respect (see the public Channel type). */
+    configuredProvider: string | undefined;
+    configuredModel: string | undefined;
+    configuredPreset: string | undefined;
+    configuredActivityFrames: string | undefined;
+    configuredLang: string | undefined;
     /** Diff presentation preference (see the public Channel type). */
     diffLayout: 'auto' | 'split' | 'unified';
     /** Thinking-block display (see the public Channel type). */
     thinkingFold: 'preview' | 'full';
     /** Tool-card background treatment (see the public Channel type). */
     toolBackground: ToolBackground;
+    /** Transcript gutter mode (see the public Channel type). */
+    scrollGutter: ScrollGutterMode;
+    /** Session-name chip on the prompt border (see the public Channel type). */
+    promptSessionLabel: boolean;
     /** Status-footer preferences (see the public Channel type). */
     statusBar: StatusBarConfig;
     /** Apply a diff-layout change (see the public Channel type). */
@@ -748,6 +826,10 @@ export interface ChannelState {
     setThinkingFold(mode: 'preview' | 'full'): void;
     /** Apply a tool-card background change. */
     setToolBackground(background: ToolBackground): void;
+    /** Apply a transcript gutter mode change. */
+    setScrollGutter(mode: ScrollGutterMode): void;
+    /** Apply a prompt session-name chip change. */
+    setPromptSessionLabel(enabled: boolean): void;
     /** Apply status-footer preference changes. */
     setStatusBar(config: Partial<StatusBarConfig>): void;
     /** Whale header art switch (see the public Channel type). */
@@ -778,6 +860,13 @@ export interface ChannelState {
         answer: string | null;
         error?: string;
     }>;
+    /** 会话 recap（见 public Channel.recapRecent）。 */
+    recapRecent(options?: {
+        signal?: AbortSignal;
+        onText?: (delta: string) => void;
+    }): Promise<RecapOutcome>;
+    /** 会话强调色（见 public Channel.setSessionColor）。 */
+    setSessionColor(color: string): void;
     /** Effective slash commands (see the public Channel type). */
     commandList: readonly LocalCommand[];
     /** Context-aware slash completions (see the public Channel type). */
@@ -820,6 +909,12 @@ export interface ChannelState {
     promptRewind(row: ChatRow): Promise<{
         modes: readonly TuiRewindMode[];
     } | 'cancel' | null>;
+    /** @internal session-tree assembly (see the public Channel.buildSessionTree). */
+    buildSessionTree(): Promise<SessionTreeData | null>;
+    /** @internal tree-entry rewind/fork (see the public Channel.rewindToNode). */
+    rewindToNode(sessionId: string, seq: number, mode?: 'rewind' | 'fork'): Promise<string | null>;
+    /** @internal tip fork (see the public Channel.forkSession). */
+    forkSession(): Promise<boolean>;
     /** Switch the live agent to a persisted session, replaying its history. */
     resumeTo(sessionId: string): Promise<ResumeResult>;
     /** Start a fresh conversation (`/new`). */
@@ -861,12 +956,16 @@ export interface ChannelState {
     /** Switch the working-activity indicator preset (see the public Channel). */
     setActivityFrames(name: string): boolean;
     listModels(): Promise<readonly LlmModelInfo[]>;
+    /** Provider display identities (see the public Channel type). */
+    listProviders(): Promise<readonly LlmProviderInfo[]>;
     /** The live agent's skill catalog for `/skills` (see the public Channel type). */
     listSkills(): Promise<readonly SkillInfo[] | undefined>;
     /** Safe credential metadata for `/login` (see the public Channel type). */
     describeCredential(ref: string): Promise<CredentialStatus | undefined>;
     /** `/provider` wizard capabilities (see the public Channel type). */
     providerSetup(): ProviderSetupHost | undefined;
+    /** OAuth sign-in states (see the public Channel type). */
+    oauthProviderStatuses(): Promise<readonly OAuthProviderStatus[] | undefined>;
     /** `/settings` screen capabilities (see the public Channel type). */
     settingsHost(): SettingsHost | undefined;
     /** Plugin-declared settings sections (see the public Channel type). */
@@ -942,6 +1041,11 @@ export declare function createChannel(ctx: Context, initialAgent: Agent, options
     thinkingFold?: 'preview' | 'full';
     /** Tool-card background treatment; default `none`. */
     toolBackground?: ToolBackground;
+    /** Transcript gutter mode; default `timeline` (settings `dsh-tui.scrollGutter`). */
+    scrollGutter?: ScrollGutterMode;
+    /** Session-name chip on the prompt top border; default off (settings
+     *  `dsh-tui.promptSessionLabel`). */
+    promptSessionLabel?: boolean;
     /** Status-footer field visibility and compactness. */
     statusBar?: Partial<StatusBarConfig>;
     /** Show the header's pixel whale art; default on. */
@@ -960,6 +1064,12 @@ export declare function createChannel(ctx: Context, initialAgent: Agent, options
      *  only route a resume overrides the target's own record with. */
     configuredProvider?: string;
     configuredModel?: string;
+    /** cordis.yml's raw `lang` key, undefined when unset: `/reload` consults
+     *  it so a static deployment choice is never overridden by lang.json. */
+    configuredLang?: string;
+    /** cordis.yml's raw `activityFrames` key, undefined when unset: the
+     *  static choice `/reload` must not override. */
+    configuredActivityFrames?: string;
     /** The preset the initial agent's session runs under (from resolveAgent). */
     agentPreset?: string;
     /** Shift+Tab session-mode cycle from cordis.yml `modes`; undefined →