@deepseek-harness-tui/dsh-tui 0.12.0 → 0.14.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"BtwThreadScene.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwThreadScene.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AAOtE,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,OAAO,GACR,EAAE;IACD,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B,GAAG,KAAK,CAAC,SAAS,CAkHlB"}

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

@@ -0,0 +1,131 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * BtwThreadScene（btw 面板的 ⤢ 全屏）：完整问题与 Markdown 长文、线程
+ * 滚动、composer 追问。Esc 返回侧栏，面板状态原样（mountPolicy=enabled
+ * 不卸载，thread 与 draft 都在线程 store）。
+ *
+ * 键层级：composer 编辑（Esc 收起草稿）> 场景滚动/动作 > Esc 退出场景。
+ */
+import React from 'react';
+import { Box, Text, useInput, useTerminalSize } from '../../../ui.js';
+import { t } from '../../../i18n.js';
+import { setClipboard } from '../../../ink/termio/osc.js';
+import { btwThreads } from './threads.js';
+import { getBtwContextBudget, getBtwContextTurns } from '../../../tuiDisplayPrefs.js';
+import { BtwComposer, btwComposerKey } from './BtwComposer.js';
+import { BtwThreadView } from './BtwThreadView.js';
+export function BtwThreadScene({ channel, onClose, }) {
+    const { columns, rows } = useTerminalSize();
+    const sessionId = String(channel.agentId);
+    const thread = React.useSyncExternalStore(btwThreads.subscribe, () => btwThreads.get(sessionId));
+    const [composerFocus, setComposerFocus] = React.useState(true);
+    const caretRef = React.useRef(0);
+    const [caret, setCaretState] = React.useState(0);
+    const setCaret = (next) => {
+        caretRef.current = next;
+        setCaretState(next);
+    };
+    const [notice, setNotice] = React.useState(null);
+    const scrollRef = React.useRef(null);
+    const busy = thread !== undefined && thread.activeTurnId !== null;
+    const attachTurn = React.useCallback((turn) => {
+        if (turn.phase !== 'completed')
+            return;
+        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]);
+    useInput((input, key, event) => {
+        if (composerFocus) {
+            const text = btwThreads.get(sessionId)?.draft ?? '';
+            const result = btwComposerKey({ text, caret: caretRef.current }, input, key);
+            if (result !== null) {
+                event.stopImmediatePropagation();
+                if (result.exitFocus === true) {
+                    setComposerFocus(false);
+                    return;
+                }
+                if (result.submit === true) {
+                    if (text.trim() !== '') {
+                        const outcome = btwThreads.submit(sessionId, text, (question, options) => channel.sideQuestion(question, options), { recentTurnsLimit: getBtwContextTurns(), contextBudget: getBtwContextBudget() });
+                        if (!outcome.ok)
+                            setNotice({ text: t('btw-thread-busy'), failure: true });
+                        else {
+                            btwThreads.setDraft(sessionId, '');
+                            setCaret(0);
+                            setNotice(null);
+                        }
+                    }
+                    return;
+                }
+                if (result.state !== undefined) {
+                    btwThreads.setDraft(sessionId, result.state.text);
+                    setCaret(result.state.caret);
+                    setNotice(null);
+                }
+                return;
+            }
+            return;
+        }
+        if (key.escape) {
+            event.stopImmediatePropagation();
+            onClose();
+            return;
+        }
+        if (key.upArrow) {
+            scrollRef.current?.scrollBy(-3);
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (key.downArrow) {
+            scrollRef.current?.scrollBy(3);
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (key.pageUp) {
+            scrollRef.current?.scrollBy(-(rows - 4));
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (key.pageDown) {
+            scrollRef.current?.scrollBy(rows - 4);
+            event.stopImmediatePropagation();
+            return;
+        }
+        // ink reports a plain Tab as key.tab with an empty input.
+        if (key.tab || input === '\t') {
+            setComposerFocus(true);
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (input === 'n' && !key.ctrl && !key.meta) {
+            btwThreads.newTopic(sessionId);
+            channel.notify(t('btw-thread-clear'), { timeoutMs: 2500 });
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (input === 's' && !key.ctrl && !key.meta) {
+            const latest = [...(btwThreads.get(sessionId)?.turns ?? [])].reverse().find(turn => turn.phase === 'completed');
+            if (latest !== undefined)
+                attachTurn(latest);
+            event.stopImmediatePropagation();
+            return;
+        }
+        if (input === 'c' && !key.ctrl && !key.meta) {
+            const latest = [...(btwThreads.get(sessionId)?.turns ?? [])].reverse().find(turn => turn.phase === 'completed');
+            if (latest !== undefined) {
+                void setClipboard(latest.answer);
+                channel.notify(t('copied-chars', { n: latest.answer.length }), { timeoutMs: 1500 });
+            }
+            event.stopImmediatePropagation();
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", width: columns, height: rows, paddingX: 1, children: [_jsxs(Box, { flexDirection: "row", width: "100%", height: 1, flexShrink: 0, children: [_jsx(Text, { color: "warning", bold: true, children: t('btw-fullscreen-title') }), _jsx(Text, { dimColor: true, children: '  ' + t('btw-thread-send-to-chat') + ' [s] · ' + t('btw-thread-new') + ' [n] · Esc' })] }), _jsx(BtwThreadView, { thread: thread, width: columns - 2, height: Math.max(3, rows - 4), alive: true, onAttachTurn: attachTurn, scrollHandleRef: scrollRef }), _jsx(BtwComposer, { state: { text: thread?.draft ?? '', caret }, focused: composerFocus, busy: busy, notice: notice === null ? undefined : notice })] }));
+}

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

@@ -0,0 +1,30 @@
+/**
+ * BtwThreadView：Q/A 轮次的滚动列表（面板 / 全屏场景 / 浮层 fallback
+ * 共用）。Question 走用户侧视觉（accent ❯ 前缀），Answer 走共享
+ * Markdown；运行中显示本轮 spinner；失败或中止时保留已流出的部分答复，
+ * 下面标出错误/已中止。
+ *
+ * 跟尾：默认跟随尾部；用户上滚后暂停 follow，
+ * 出现「有新回答」跳尾提示（点击回底）。ScrollBox 的 sticky 位就是
+ * follow 信号——上滚打破 sticky，scrollToBottom/贴底恢复。
+ */
+import React from 'react';
+import { type ScrollBoxHandle } from '../../../ui.js';
+import type { BtwThreadSnapshot, BtwTurn } from './threads.js';
+export declare function BtwThreadView({ thread, width, height, 
+/** 渲时钟的开关（面板不可见/场景失焦时停表）。 */
+alive, onAttachTurn, 
+/** 宿主（全屏场景/浮层）接管键盘滚动用的句柄透传。 */
+scrollHandleRef, }: {
+    readonly thread: BtwThreadSnapshot | undefined;
+    readonly width: number;
+    /** 滚动区行预算（含滚动区自身；跳尾提示一行另计）。 */
+    readonly height: number;
+    readonly alive: boolean;
+    /** 点击已完成轮的答案区触发送到聊天（fallback 形态不传 = 无该交互）。 */
+    readonly onAttachTurn?: (turn: BtwTurn) => void;
+    readonly scrollHandleRef?: {
+        current: ScrollBoxHandle | null;
+    };
+}): React.ReactNode;
+//# sourceMappingURL=BtwThreadView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BtwThreadView.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwThreadView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAI3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK9D,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,KAAK,EACL,MAAM;AACN,6BAA6B;AAC7B,KAAK,EACL,YAAY;AACZ,+BAA+B;AAC/B,eAAe,GAChB,EAAE;IACD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAA;CAC/D,GAAG,KAAK,CAAC,SAAS,CAuHlB"}

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

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * BtwThreadView：Q/A 轮次的滚动列表（面板 / 全屏场景 / 浮层 fallback
+ * 共用）。Question 走用户侧视觉（accent ❯ 前缀），Answer 走共享
+ * Markdown；运行中显示本轮 spinner；失败或中止时保留已流出的部分答复，
+ * 下面标出错误/已中止。
+ *
+ * 跟尾：默认跟随尾部；用户上滚后暂停 follow，
+ * 出现「有新回答」跳尾提示（点击回底）。ScrollBox 的 sticky 位就是
+ * follow 信号——上滚打破 sticky，scrollToBottom/贴底恢复。
+ */
+import React from 'react';
+import { Box, Text, ScrollBox } from '../../../ui.js';
+import { Markdown } from '../../Markdown.js';
+import { SpinnerGlyph } from '../../Spinner/SpinnerGlyph.js';
+import { t } from '../../../i18n.js';
+/** 80ms spinner 帧（只在有 running 轮且其还没收到首段文本时走时钟）。 */
+const SPINNER_MS = 80;
+export function BtwThreadView({ thread, width, height, 
+/** 渲时钟的开关（面板不可见/场景失焦时停表）。 */
+alive, onAttachTurn, 
+/** 宿主（全屏场景/浮层）接管键盘滚动用的句柄透传。 */
+scrollHandleRef, }) {
+    const localScrollRef = React.useRef(null);
+    const scrollRef = scrollHandleRef ?? localScrollRef;
+    const [frame, setFrame] = React.useState(0);
+    const [follow, setFollow] = React.useState(true);
+    const [pendingJump, setPendingJump] = React.useState(false);
+    const activeTurn = thread === undefined
+        ? undefined
+        : thread.turns.find(turn => turn.turnId === thread.activeTurnId);
+    const spinning = alive && activeTurn !== undefined && activeTurn.answer === '';
+    React.useEffect(() => {
+        if (!spinning)
+            return;
+        const interval = setInterval(() => setFrame(previous => previous + 1), SPINNER_MS);
+        return () => clearInterval(interval);
+    }, [spinning]);
+    // 滚动订阅：sticky 位翻转 = follow 翻转（上滚离开底部即暂停跟尾）。
+    // 空线程时不渲染 ScrollBox——turns 首次出现后（hasTurns 翻转）重新绑定。
+    const hasTurns = thread !== undefined && thread.turns.length > 0;
+    React.useEffect(() => {
+        if (!hasTurns)
+            return;
+        const handle = scrollRef.current;
+        if (handle === null)
+            return;
+        return handle.subscribe(() => {
+            const sticky = handle.isSticky();
+            setFollow(previous => (previous === sticky ? previous : sticky));
+            if (sticky)
+                setPendingJump(false);
+        });
+    }, [hasTurns]);
+    // 内容增长：跟尾则钉底；暂停跟尾且有新答案内容时亮「有新回答」。
+    const version = thread?.version ?? 0;
+    const answerLengths = React.useMemo(() => thread?.turns.map(turn => turn.answer.length).join(',') ?? '', [thread]);
+    const prevRef = React.useRef({ version: 0, answerLengths: '' });
+    React.useEffect(() => {
+        const previous = prevRef.current;
+        prevRef.current = { version, answerLengths };
+        if (version === 0 || previous.version === 0)
+            return;
+        const grew = answerLengths !== previous.answerLengths;
+        if (!grew)
+            return;
+        if (follow)
+            scrollRef.current?.scrollToBottom();
+        else
+            setPendingJump(true);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [version, answerLengths, follow]);
+    const jumpTail = React.useCallback(() => {
+        scrollRef.current?.scrollToBottom();
+        setFollow(true);
+        setPendingJump(false);
+    }, []);
+    if (thread === undefined || thread.turns.length === 0) {
+        return (_jsx(Box, { flexDirection: "column", flexGrow: 1, paddingX: 1, children: _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "subtle", wrap: "truncate", children: t('btw-thread-empty') }) }) }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", paddingX: 1, children: [_jsx(ScrollBox, { ref: scrollRef, flexDirection: "column", flexGrow: 1, stickyScroll: true, children: thread.turns.map(turn => (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", flexShrink: 0, children: [_jsx(Text, { color: "accent", bold: true, children: '❯ ' }), _jsx(Text, { color: "accent", wrap: "wrap", children: turn.question })] }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [turn.phase === 'completed' ? (_jsx(Box, { onClick: onAttachTurn === undefined ? undefined : event => {
+                                        event.stopImmediatePropagation();
+                                        onAttachTurn(turn);
+                                    }, children: _jsx(Markdown, { cacheTokens: false, children: turn.answer }) })) : turn.phase === 'failed' || turn.phase === 'cancelled' ? (_jsxs(_Fragment, { children: [turn.answer !== '' && _jsx(Markdown, { cacheTokens: false, children: turn.answer }), turn.phase === 'failed'
+                                            ? _jsxs(Text, { color: "error", wrap: "wrap", children: [t('btw-thread-error'), turn.error === undefined ? '' : ': ' + turn.error] })
+                                            : _jsx(Text, { dimColor: true, italic: true, children: t('btw-thread-cancelled') })] })) : turn.answer !== '' ? (_jsx(Markdown, { cacheTokens: false, children: turn.answer })) : (_jsxs(Box, { flexShrink: 0, children: [_jsx(SpinnerGlyph, { frame: frame, messageColor: "warning" }), _jsxs(Text, { color: "warning", children: [" ", t('btw-answering')] })] })), turn.omittedOlderCount > 0 && (_jsx(Text, { dimColor: true, italic: true, wrap: "truncate", children: t('btw-thread-context-omitted', { n: turn.omittedOlderCount }) }))] }), _jsx(Box, { height: 1, flexShrink: 0 })] }, turn.turnId))) }), pendingJump && !follow && (_jsx(Box, { flexShrink: 0, onClick: event => { event.stopImmediatePropagation(); jumpTail(); }, children: _jsxs(Text, { color: "permission", children: ["\u2193 ", t('btw-thread-unread')] }) }))] }));
+}

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

@@ -0,0 +1,111 @@
+export type BtwTurnPhase = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface BtwTurn {
+    readonly turnId: string;
+    /** 全局单调序（unread 的 seen-through 标尺）。 */
+    readonly seq: number;
+    readonly question: string;
+    readonly answer: string;
+    readonly phase: BtwTurnPhase;
+    readonly error?: string;
+    readonly startedAt?: number;
+    readonly finishedAt?: number;
+    /** 本次 ask 实际携带的上下文轮次（最近 N 且在预算内）。 */
+    readonly includedContextTurnIds: readonly string[];
+    /** 超出 N/字符预算被裁掉的更早完成轮数（UI 显示 omitted count）。 */
+    readonly omittedOlderCount: number;
+}
+export interface BtwThreadSnapshot {
+    readonly sessionId: string;
+    readonly threadId: string;
+    readonly createdAt: number;
+    readonly generation: number;
+    readonly turns: readonly BtwTurn[];
+    readonly activeTurnId: string | null;
+    readonly draft: string;
+    /** seen-through 标尺之后的完成/失败轮（cancelled 不计：用户自己中止，
+     * 不是没看到的新答案）。 */
+    readonly unread: {
+        readonly count: number;
+        readonly error: boolean;
+    };
+    readonly version: number;
+}
+/** 最近 N 组问答：默认 4，可配范围 1–8（normalize 钳制）。 */
+export declare const BTW_RECENT_TURNS_DEFAULT = 4;
+export declare const BTW_RECENT_TURNS_MIN = 1;
+export declare const BTW_RECENT_TURNS_MAX = 8;
+/** 线程上下文总字符预算（问题+裁剪后答案）。 */
+export declare const BTW_CONTEXT_CHAR_BUDGET = 24000;
+/** 单条答案进入上下文时的裁剪上限。 */
+export declare const BTW_ANSWER_CHAR_BUDGET = 8000;
+/** 跨线程并发上限：超过显示忙，不隐式取消。 */
+export declare const BTW_MAX_CONCURRENT_ASKS = 2;
+/** submit 的 ask 门面 = channel.sideQuestion（一次无工具单答案旁路）。 */
+export type BtwAskFacade = (question: string, options?: {
+    readonly signal?: AbortSignal;
+    readonly onText?: (delta: string) => void;
+}) => Promise<{
+    readonly answer: string | null;
+    readonly error?: string;
+}>;
+export type BtwSubmitResult = {
+    readonly ok: true;
+    readonly turnId: string;
+} | {
+    readonly ok: false;
+    readonly reason: 'empty' | 'busy' | 'congested';
+};
+/** 钳到 1–8；非有限值取默认 4。 */
+export declare function normalizeRecentTurnsLimit(value: number | undefined): number;
+export interface BtwContextSelection {
+    /** 参与下一次 ask 的完成轮（旧→新）。 */
+    readonly included: readonly BtwTurn[];
+    readonly omittedOlderCount: number;
+}
+/**
+ * 选出下一次 ask 携带的上下文：先取最近 N 组**完成**轮，再按字符预算
+ * （单答案 8k 裁剪后计入、总计 24k）从最旧开始整轮丢弃；被丢的轮数
+ * （窗口外 + 超预算）汇成 omittedOlderCount。纯函数。
+ */
+export declare function selectContextTurns(turns: readonly BtwTurn[], limit?: number, budgets?: {
+    readonly total?: number;
+    readonly perAnswer?: number;
+}): BtwContextSelection;
+declare class BtwThreadStore {
+    private threads;
+    private controllers;
+    private listeners;
+    private turnSeq;
+    private threadSeq;
+    subscribe: (listener: () => void) => (() => void);
+    /** 当前 session 的线程快照（缺失 = 无线程；快照在两次更新间恒等）。 */
+    get(sessionId: string): BtwThreadSnapshot | undefined;
+    /**
+     * 发起一轮追问：拼好线程上下文作为 question 整段交给 ask（一次
+     * sideQuery 调用），流式增量与落定都经代际/相位守卫写回。同线程
+     * 在途时 busy 拒绝；全局并发超上限 congested 拒绝（都不隐式取消）。
+     */
+    submit(sessionId: string, question: string, ask: BtwAskFacade, opts?: {
+        readonly recentTurnsLimit?: number;
+        readonly contextBudget?: number;
+    }): BtwSubmitResult;
+    /** 中止在途追问（相位立即转 cancelled；迟到的流/结果被守卫丢弃）。 */
+    abortActive(sessionId: string): boolean;
+    /**
+     * 新话题：abort 在途、清 turns/draft/unread、换 thread id、generation+1。
+     * 不影响其它 session 的线程，也不触发任何持久化。
+     */
+    newTopic(sessionId: string): boolean;
+    setDraft(sessionId: string, text: string): void;
+    /** 看到最新线程：把已落定轮全部记为已读（running 轮落定时再见分晓）。 */
+    markSeen(sessionId: string): void;
+    /** 测试/多夹具隔离用：清空全部线程状态。 */
+    resetForTest(): void;
+    private recordOf;
+    private bump;
+    private emit;
+}
+/** 进程级单例（与 jobsFocusStore 同款挂法）。 */
+export declare const btwThreads: BtwThreadStore;
+export {};
+//# sourceMappingURL=threads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/threads.ts"],"names":[],"mappings":"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"}