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

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

@@ -0,0 +1,302 @@
+/**
+ * btw 线程 store：sideQuery 的问答线程只是 UI 状态——按 session id 隔离、
+ * 只在内存里、进程重启即清空，不写会话记录（DSH SessionEvent / Claude
+ * JSONL 都不碰）。每次追问带上最近 N 组完成的问答（有字符预算，按整轮从
+ * 最旧裁剪）；新话题清空线程并中止在途的一轮。
+ *
+ * sideQuery 仍是一次无工具的单答调用：submit 只经调用方传入的 ask
+ * （= channel.sideQuestion）调用一次，上下文由 sideThreadQuestion 拼进
+ * question。本模块不 import 后端，也没有任何写主会话的入口。
+ *
+ * 并发：每个线程最多一轮在途（忙则拒绝，不隐式取消）；全局最多 2 轮
+ * （切换 session 后旧线程仍可流完）。每次写回前核对线程 generation 与
+ * 这一轮的 phase，新话题或中止之后迟到的 onText/result 都丢弃。
+ */
+import { sideThreadQuestion } from '../../../channel/side-prompts.js';
+import { t } from '../../../i18n.js';
+/** 最近 N 组问答：默认 4，可配范围 1–8（normalize 钳制）。 */
+export const BTW_RECENT_TURNS_DEFAULT = 4;
+export const BTW_RECENT_TURNS_MIN = 1;
+export const BTW_RECENT_TURNS_MAX = 8;
+/** 线程上下文总字符预算（问题+裁剪后答案）。 */
+export const BTW_CONTEXT_CHAR_BUDGET = 24_000;
+/** 单条答案进入上下文时的裁剪上限。 */
+export const BTW_ANSWER_CHAR_BUDGET = 8_000;
+/** 跨线程并发上限：超过显示忙，不隐式取消。 */
+export const BTW_MAX_CONCURRENT_ASKS = 2;
+/** 钳到 1–8；非有限值取默认 4。 */
+export function normalizeRecentTurnsLimit(value) {
+    if (value === undefined || !Number.isFinite(value))
+        return BTW_RECENT_TURNS_DEFAULT;
+    return Math.min(BTW_RECENT_TURNS_MAX, Math.max(BTW_RECENT_TURNS_MIN, Math.round(value)));
+}
+/** 按字符预算从尾部裁（不撕裂代理对；与 sideQuestion.ts 的 clip 同语义）。 */
+function clip(text, limit) {
+    if (text.length <= limit)
+        return text;
+    const code = text.charCodeAt(limit - 1);
+    const end = code >= 0xd800 && code <= 0xdbff ? limit - 1 : limit;
+    return `${text.slice(0, end)}…`;
+}
+/**
+ * 选出下一次 ask 携带的上下文：先取最近 N 组**完成**轮，再按字符预算
+ * （单答案 8k 裁剪后计入、总计 24k）从最旧开始整轮丢弃；被丢的轮数
+ * （窗口外 + 超预算）汇成 omittedOlderCount。纯函数。
+ */
+export function selectContextTurns(turns, limit = BTW_RECENT_TURNS_DEFAULT, budgets = {}) {
+    const window = normalizeRecentTurnsLimit(limit);
+    const total = budgets.total ?? BTW_CONTEXT_CHAR_BUDGET;
+    // 单答预算内部派生（设置裁定：用户心智一个总量键就够）：默认 8k，
+    // 但永远不超过总量的一半——一个收紧的总量不该被单答上限架空。
+    const perAnswer = budgets.perAnswer ?? Math.min(BTW_ANSWER_CHAR_BUDGET, Math.floor(total / 2));
+    const completed = turns.filter(turn => turn.phase === 'completed');
+    if (completed.length === 0)
+        return { included: [], omittedOlderCount: 0 };
+    const recent = completed.slice(-window);
+    const accepted = [];
+    let used = 0;
+    for (let index = recent.length - 1; index >= 0; index -= 1) {
+        const turn = recent[index];
+        const clippedAnswer = clip(turn.answer, perAnswer);
+        const size = turn.question.length + clippedAnswer.length;
+        if (accepted.length > 0 && used + size > total)
+            break;
+        accepted.unshift({ ...turn, answer: clippedAnswer });
+        used += size;
+    }
+    return { included: accepted, omittedOlderCount: completed.length - accepted.length };
+}
+/** DSH 空答案的字面错误映射成本地化文案（Claude 侧已有 i18n 键）。 */
+function presentableError(error) {
+    return error === 'No response received' ? t('btw-output-unavailable') : error;
+}
+function buildSnapshot(record) {
+    const active = record.turns.find(turn => turn.phase === 'queued' || turn.phase === 'running') ?? null;
+    let unreadCount = 0;
+    let unreadError = false;
+    for (const turn of record.turns) {
+        if (turn.seq <= record.seenThroughSeq)
+            continue;
+        if (turn.phase === 'completed')
+            unreadCount += 1;
+        else if (turn.phase === 'failed') {
+            unreadCount += 1;
+            unreadError = true;
+        }
+    }
+    return Object.freeze({
+        sessionId: record.sessionId,
+        threadId: record.threadId,
+        createdAt: record.createdAt,
+        generation: record.generation,
+        turns: Object.freeze([...record.turns]),
+        activeTurnId: active === null ? null : active.turnId,
+        draft: record.draft,
+        unread: Object.freeze({ count: unreadCount, error: unreadError }),
+        version: record.version,
+    });
+}
+class BtwThreadStore {
+    threads = new Map();
+    controllers = new Map();
+    listeners = new Set();
+    turnSeq = 0;
+    threadSeq = 0;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    /** 当前 session 的线程快照（缺失 = 无线程；快照在两次更新间恒等）。 */
+    get(sessionId) {
+        return this.threads.get(sessionId)?.snapshot;
+    }
+    /**
+     * 发起一轮追问：拼好线程上下文作为 question 整段交给 ask（一次
+     * sideQuery 调用），流式增量与落定都经代际/相位守卫写回。同线程
+     * 在途时 busy 拒绝；全局并发超上限 congested 拒绝（都不隐式取消）。
+     */
+    submit(sessionId, question, ask, opts) {
+        const trimmed = question.trim();
+        if (trimmed === '')
+            return { ok: false, reason: 'empty' };
+        const record = this.recordOf(sessionId);
+        if (record.turns.some(turn => turn.phase === 'queued' || turn.phase === 'running')) {
+            return { ok: false, reason: 'busy' };
+        }
+        let runningElsewhere = 0;
+        for (const other of this.threads.values()) {
+            if (other === record)
+                continue;
+            if (other.turns.some(turn => turn.phase === 'queued' || turn.phase === 'running'))
+                runningElsewhere += 1;
+        }
+        if (runningElsewhere >= BTW_MAX_CONCURRENT_ASKS)
+            return { ok: false, reason: 'congested' };
+        const selection = selectContextTurns(record.turns, opts?.recentTurnsLimit, {
+            ...(opts?.contextBudget === undefined ? {} : { total: opts.contextBudget }),
+        });
+        const seq = ++this.turnSeq;
+        const turn = {
+            turnId: `btw-${seq}`,
+            seq,
+            question: trimmed,
+            answer: '',
+            phase: 'running',
+            startedAt: Date.now(),
+            includedContextTurnIds: selection.included.map(prior => prior.turnId),
+            omittedOlderCount: selection.omittedOlderCount,
+        };
+        record.turns.push(turn);
+        this.bump(record);
+        const controller = new AbortController();
+        this.controllers.set(turn.turnId, controller);
+        const generation = record.generation;
+        const prompt = sideThreadQuestion(trimmed, selection.included.map((prior) => ({ question: prior.question, answer: prior.answer })), selection.omittedOlderCount);
+        const settle = (write) => {
+            const current = this.threads.get(sessionId);
+            if (current === undefined || current.generation !== generation)
+                return;
+            const index = current.turns.findIndex(candidate => candidate.turnId === turn.turnId);
+            if (index < 0)
+                return;
+            const existing = current.turns[index];
+            if (existing.phase !== 'running')
+                return;
+            current.turns[index] = write({ ...existing, finishedAt: Date.now() });
+            this.bump(current);
+        };
+        ask(prompt, {
+            signal: controller.signal,
+            onText: delta => {
+                const current = this.threads.get(sessionId);
+                if (current === undefined || current.generation !== generation || controller.signal.aborted)
+                    return;
+                const index = current.turns.findIndex(candidate => candidate.turnId === turn.turnId);
+                if (index < 0)
+                    return;
+                const existing = current.turns[index];
+                if (existing.phase !== 'running')
+                    return;
+                current.turns[index] = { ...existing, answer: existing.answer + delta };
+                this.bump(current);
+            },
+        }).then(result => {
+            this.controllers.delete(turn.turnId);
+            settle(existing => {
+                if (controller.signal.aborted)
+                    return { ...existing, phase: 'cancelled' };
+                if (result.answer !== null)
+                    return { ...existing, answer: result.answer, phase: 'completed' };
+                if (result.error !== undefined)
+                    return { ...existing, error: presentableError(result.error), phase: 'failed' };
+                return { ...existing, phase: 'cancelled' };
+            });
+        }, error => {
+            this.controllers.delete(turn.turnId);
+            settle(existing => ({
+                ...existing,
+                error: presentableError(error instanceof Error ? error.message : String(error)),
+                phase: 'failed',
+            }));
+        });
+        return { ok: true, turnId: turn.turnId };
+    }
+    /** 中止在途追问（相位立即转 cancelled；迟到的流/结果被守卫丢弃）。 */
+    abortActive(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return false;
+        const active = record.turns.find(turn => turn.phase === 'queued' || turn.phase === 'running');
+        if (active === undefined)
+            return false;
+        const index = record.turns.indexOf(active);
+        record.turns[index] = { ...active, phase: 'cancelled', finishedAt: Date.now() };
+        this.bump(record);
+        this.controllers.get(active.turnId)?.abort();
+        this.controllers.delete(active.turnId);
+        return true;
+    }
+    /**
+     * 新话题：abort 在途、清 turns/draft/unread、换 thread id、generation+1。
+     * 不影响其它 session 的线程，也不触发任何持久化。
+     */
+    newTopic(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return false;
+        this.abortActive(sessionId);
+        record.threadId = `btw-thread-${++this.threadSeq}-${Date.now().toString(36)}`;
+        record.createdAt = Date.now();
+        record.generation += 1;
+        record.turns = [];
+        record.draft = '';
+        record.seenThroughSeq = this.turnSeq;
+        this.bump(record);
+        return true;
+    }
+    setDraft(sessionId, text) {
+        const record = this.recordOf(sessionId);
+        if (record.draft === text)
+            return;
+        record.draft = text;
+        this.bump(record);
+    }
+    /** 看到最新线程：把已落定轮全部记为已读（running 轮落定时再见分晓）。 */
+    markSeen(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return;
+        const newestSettled = record.turns.reduce((max, turn) => turn.phase === 'completed' || turn.phase === 'failed' ? Math.max(max, turn.seq) : max, record.seenThroughSeq);
+        if (newestSettled === record.seenThroughSeq)
+            return;
+        record.seenThroughSeq = newestSettled;
+        this.bump(record);
+    }
+    /** 测试/多夹具隔离用：清空全部线程状态。 */
+    resetForTest() {
+        for (const record of this.threads.values())
+            this.abortActive(record.sessionId);
+        this.threads.clear();
+        this.emit();
+    }
+    recordOf(sessionId) {
+        let record = this.threads.get(sessionId);
+        if (record === undefined) {
+            record = {
+                sessionId,
+                threadId: `btw-thread-${++this.threadSeq}-${Date.now().toString(36)}`,
+                createdAt: Date.now(),
+                generation: 0,
+                turns: [],
+                draft: '',
+                seenThroughSeq: this.turnSeq,
+                version: 0,
+                snapshot: Object.freeze({
+                    sessionId,
+                    threadId: '',
+                    createdAt: 0,
+                    generation: 0,
+                    turns: Object.freeze([]),
+                    activeTurnId: null,
+                    draft: '',
+                    unread: Object.freeze({ count: 0, error: false }),
+                    version: 0,
+                }),
+            };
+            record.snapshot = buildSnapshot(record);
+            this.threads.set(sessionId, record);
+        }
+        return record;
+    }
+    bump(record) {
+        record.version += 1;
+        record.snapshot = buildSnapshot(record);
+        this.emit();
+    }
+    emit() {
+        for (const listener of [...this.listeners])
+            listener();
+    }
+}
+/** 进程级单例（与 jobsFocusStore 同款挂法）。 */
+export const btwThreads = new BtwThreadStore();

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

@@ -0,0 +1,3 @@
+/** 幂等：重复调用（夹具多次挂载）不再注册。 */
+export declare function registerBuiltinPanels(): void;
+//# sourceMappingURL=builtinPanels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtinPanels.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/builtinPanels.tsx"],"names":[],"mappings":"AA6NA,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAmG5C"}

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

@@ -0,0 +1,269 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Register built-in panels in the shared panel store. */
+import React from 'react';
+import { t } from '../../i18n.js';
+import { GoalTodoPanel } from '../GoalTodoPanel.js';
+import { JobsPanel } from '../JobsPanel.js';
+import { SubagentDashboard } from '../SubagentDashboard.js';
+import { SubagentDetailScene } from '../SubagentDetailScene.js';
+import { CompanionPanel } from './companion/CompanionPanel.js';
+import { InfoPanel } from './InfoPanel.js';
+import { TrajectoryPanel } from './TrajectoryPanel.js';
+import { WorkspacePanel } from './WorkspacePanel.js';
+import { BtwPanelAdapter } from './btw/BtwPanelAdapter.js';
+import { panelStore } from './PanelStore.js';
+import { useSidePanelChannel } from './SidePanelRuntimeContext.js';
+import { usePanelInput } from './usePanelInput.js';
+import { jobsFocusStore } from './jobsFocusStore.js';
+import { agentViewStore } from './agentViewStore.js';
+import { agentComposeTargetOf } from '../messages/agentTeam.js';
+/** todo：GoalTodoPanel 的 panel variant（同一份 store，不重写业务）。 */
+function TodoPanelAdapter({ width, height, focused, visible }) {
+    const channel = useSidePanelChannel();
+    // 折叠态是面板内局部 state（默认展开）——不接 Chat 的 ctrl/cmd+q 热键
+    // 状态，两个形态各自独立。头部行点击与键盘（Enter/空格）走同一 toggle：
+    // 修复前头部行 onClick 没接（GoalTodoPanel 的 onToggle 未传），
+    // 侧栏里点折叠头是死控件。
+    const [collapsed, setCollapsed] = React.useState(false);
+    const toggleCollapsed = React.useCallback(() => setCollapsed(previous => !previous), []);
+    usePanelInput((input, key) => {
+        if (key.ctrl || key.meta || key.escape)
+            return false;
+        if (key.return_ !== true && input !== ' ')
+            return false;
+        toggleCollapsed();
+        return true;
+    }, { active: focused && visible });
+    // 行数预算：goal 区最多 2 行 + 折叠头 1 行 + 留白 1 行，其余给 todo 列表。
+    return (_jsx(GoalTodoPanel, { channel: channel, variant: "panel", visible: visible, collapsed: collapsed, onToggle: toggleCollapsed, maxTodos: Math.max(3, height - 4), 
+        // 折行宽 = 面板宽 − 左右 padding 2 − 树形前缀 3 − 状态 glyph 2，
+        // 再留 1 格余量防 ink 二次折行（长行溢出超过约束会把同行定宽列挤折）。
+        wrapWidth: Math.max(10, width - 8) }));
+}
+/**
+ * jobs：JobsPanel 的 panel variant（同一份 roster/kill 语义，布局与
+ * 键盘按侧栏契约重排）。badge 派生：running>0 → info；面板不可见
+ * 期间新出现的 failed → error（unread 计数）；两者皆无 → 清空。
+ * 面板可见时把当前 failed 集合记为已读并清 badge（running 仍亮点）。
+ */
+function JobsPanelAdapter({ focused, visible }) {
+    const channel = useSidePanelChannel();
+    const jobs = channel.backgroundJobs;
+    const version = channel.version;
+    const focusRequest = React.useSyncExternalStore(jobsFocusStore.subscribe, jobsFocusStore.get);
+    // A backend whose job output is read on demand keeps the focused job's
+    // tail fresh while this panel shows it (the same seam the full-screen
+    // panel and the transcript cards use); one identity per capability.
+    const jobControlRef = React.useRef(channel.jobControl);
+    jobControlRef.current = channel.jobControl;
+    const outputWatchable = typeof channel.jobControl?.watchOutput === 'function';
+    const watchOutput = React.useMemo(() => outputWatchable ? (id) => jobControlRef.current?.watchOutput?.(id) ?? (() => undefined) : undefined, [outputWatchable]);
+    // 已读基线：上次 visible=true 时见过的 failed id 集合。
+    const seenFailedRef = React.useRef(new Set());
+    React.useEffect(() => {
+        const running = jobs.filter(job => job.status === 'running' || job.status === 'stopping').length;
+        const failedIds = new Set(jobs.filter(job => job.status === 'failed').map(job => job.id));
+        if (visible) {
+            seenFailedRef.current = failedIds;
+            panelStore.setBadge('jobs', running > 0 ? { level: 'info', unread: 0 } : null);
+            return;
+        }
+        let unread = 0;
+        for (const id of failedIds)
+            if (!seenFailedRef.current.has(id))
+                unread += 1;
+        panelStore.setBadge('jobs', unread > 0 ? { level: 'error', unread } : running > 0 ? { level: 'info', unread: 0 } : null);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- badge derives from the channel version bump
+    }, [version, visible]);
+    return (_jsx(JobsPanel, { jobs: jobs, variant: "panel", focused: focused, visible: visible, focusRequest: focusRequest, onWatchOutput: watchOutput, onKill: (id) => {
+            // Stub channels (verify harnesses) have no jobControl — surface
+            // the same failure toast as a refused kill instead of throwing.
+            if (channel.jobControl?.kill(id) !== true) {
+                channel.notify(t('jobs-kill-failed', { id }), { color: 'error' });
+            }
+        }, onSendToChat: (job) => {
+            // Attach a localized job summary as the next message context.
+            if (typeof channel.attachContext !== 'function')
+                return;
+            const lines = job.outputLines ?? [];
+            const statusLabel = {
+                running: t('jobs-status-running'),
+                stopping: t('jobs-status-stopping'),
+                completed: t('jobs-status-completed'),
+                failed: t('jobs-status-failed'),
+                killed: t('jobs-status-killed'),
+            }[job.status];
+            const command = job.command !== undefined && job.command !== '' ? job.command : job.label;
+            const summary = [
+                t('jobs-panel-context-heading', { id: job.id, status: statusLabel }),
+                t('jobs-panel-context-command', { command }),
+                lines.length > 0
+                    ? t('jobs-panel-context-output', { n: Math.min(10, lines.length) }) + '\n' + lines.slice(-10).map(line => line.text).join('\n')
+                    : t('jobs-panel-context-no-output'),
+            ].join('\n');
+            channel.attachContext({ source: 'panel', sourceId: job.id, title: t('jobs-panel-context-title', { id: job.id }), content: summary });
+            channel.notify(t('panel-sent-to-chat', { title: job.id }), { color: 'success' });
+        } }));
+}
+/** 主屏 Agent View 盖过 Chat 时整棵主树（含本面板）会卸载；重挂载时从这里
+ *  恢复最后的路由。 */
+let lastAgentsRoute = 'dashboard';
+/**
+ * agents: the dashboard and detail scene share the panel's agent roster and
+ * message control. The route stays mounted while another panel is active. Badges
+ * reflect running agents and unseen failures.
+ */
+function AgentsPanelAdapter({ focused, visible }) {
+    const channel = useSidePanelChannel();
+    const subagents = channel.subagents;
+    const version = channel.version;
+    const [route, setRoute] = React.useState(lastAgentsRoute);
+    React.useEffect(() => { lastAgentsRoute = route; }, [route]);
+    // subagentControl.message 缺失 = 没有 composer 和消息流。可选链是给没有
+    // subagentControl 的桩 channel（回归夹具）用的。
+    const messageControl = channel.subagentControl?.message;
+    const detailAgentId = typeof route === 'object' ? route.detail : null;
+    const detailMessages = detailAgentId !== null && messageControl !== undefined
+        ? messageControl.messages().filter(m => m.from === detailAgentId || m.to === detailAgentId)
+        : [];
+    const detailTarget = React.useMemo(() => {
+        if (detailAgentId === null)
+            return undefined;
+        const labels = new Map(subagents.map(s => [s.agentId, s.description]));
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- roster may lag the route
+        return labels.has(detailAgentId) ? agentComposeTargetOf(detailAgentId, labels) : undefined;
+    }, [detailAgentId, subagents]);
+    const detailCompose = detailTarget !== undefined && messageControl !== undefined
+        ? { control: messageControl, target: detailTarget }
+        : undefined;
+    // 已读基线：上次 visible=true 时见过的 failed id 集合。
+    const seenFailedRef = React.useRef(new Set());
+    React.useEffect(() => {
+        const running = subagents.filter(s => s.status === 'running' || s.status === 'starting').length;
+        const failedIds = new Set(subagents.filter(s => s.status === 'failed').map(s => s.agentId));
+        if (visible) {
+            seenFailedRef.current = failedIds;
+            panelStore.setBadge('agents', running > 0 ? { level: 'info', unread: 0 } : null);
+            return;
+        }
+        let unread = 0;
+        for (const id of failedIds)
+            if (!seenFailedRef.current.has(id))
+                unread += 1;
+        panelStore.setBadge('agents', unread > 0 ? { level: 'error', unread } : running > 0 ? { level: 'info', unread: 0 } : null);
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- badge derives from the channel version bump
+    }, [version, visible]);
+    // 行暂时不在名册里（会话切换 / replay 尚未回填）时退回 dashboard，但不清
+    // 路由：行回来后用户原来看的那一页还在——这正是 enabled 挂载策略要保的
+    // 状态。
+    const detail = typeof route === 'object'
+        ? subagents.find(s => s.agentId === route.detail)
+        : undefined;
+    if (typeof route === 'object' && detail !== undefined) {
+        return (_jsx(SubagentDetailScene, { subagent: detail, variant: "panel", focused: focused, visible: visible, onBack: () => setRoute('dashboard'), onInterrupt: (id) => channel.subagentControl?.interrupt(id), ...(channel.subagentControl?.history === undefined ? {} : { loadTranscript: channel.subagentControl.history }), onOpenView: () => agentViewStore.request(detail.agentId, 'agent-detail', true), messages: detailMessages, ...(detailCompose === undefined ? {} : { compose: detailCompose }) }));
+    }
+    return (_jsx(SubagentDashboard, { subagents: subagents, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }), onOpenView: (id) => agentViewStore.request(id, 'agents-dashboard', true), messages: messageControl?.messages() }));
+}
+let registered = false;
+/** 幂等：重复调用（夹具多次挂载）不再注册。 */
+export function registerBuiltinPanels() {
+    if (registered)
+        return;
+    registered = true;
+    panelStore.register({
+        id: 'todo',
+        titleKey: 'panel-title-todo',
+        icon: '≡',
+        order: 10,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        component: TodoPanelAdapter,
+    }, 'builtin');
+    panelStore.register({
+        id: 'jobs',
+        titleKey: 'panel-title-jobs',
+        icon: '▸',
+        order: 20,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 28,
+        // 整屏对应物 = /jobs 的整屏 JobsPanel；PanelBar 右端因此有 ⤢ 全屏按钮。
+        capabilities: { scroll: true, sendToChat: true, fullscreen: true },
+        component: JobsPanelAdapter,
+    }, 'builtin');
+    panelStore.register({
+        id: 'agents',
+        titleKey: 'panel-title-agents',
+        icon: '◆',
+        order: 30,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        // 整屏对应物 = Ctrl+A 的 SubagentDashboard。
+        capabilities: { scroll: true, fullscreen: true },
+        component: AgentsPanelAdapter,
+    }, 'builtin');
+    panelStore.register({
+        id: 'info',
+        titleKey: 'panel-title-info',
+        icon: 'ⓘ',
+        order: 15,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 24,
+        capabilities: { scroll: true },
+        component: InfoPanel,
+    }, 'builtin');
+    panelStore.register({
+        id: 'trajectory',
+        titleKey: 'panel-title-trajectory',
+        icon: '∿',
+        order: 25,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 28,
+        // 整屏对应物 = Ctrl+T / /trace 的 TrajectoryScene（分屏时那两者也走本面板）。
+        capabilities: { scroll: true, fullscreen: true },
+        component: TrajectoryPanel,
+    }, 'builtin');
+    panelStore.register({
+        id: 'workspace',
+        titleKey: 'panel-title-workspace',
+        icon: '⌗',
+        order: 35,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 28,
+        // 整屏对应物 = /home 的工作区主页（分屏时 /home 也走本面板）。
+        capabilities: { scroll: true, fullscreen: true },
+        component: WorkspacePanel,
+    }, 'builtin');
+    panelStore.register({
+        id: 'btw',
+        titleKey: 'panel-title-btw',
+        icon: '?',
+        order: 22,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        minColumns: 28,
+        // 整屏对应物 = ⤢ 的 BtwThreadScene（Esc 返回侧栏，不清 thread/draft）。
+        capabilities: { scroll: true, sendToChat: true, fullscreen: true },
+        component: BtwPanelAdapter,
+    }, 'builtin');
+    panelStore.register({
+        id: 'companion',
+        titleKey: 'panel-title-companion',
+        icon: '♥',
+        order: 40,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: true,
+        component: CompanionPanel,
+    }, 'builtin');
+}

package/lib/types/components/sidePanel/companion/CompanionPanel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CompanionPanel derives mood, interaction animations and bubbles from the
+ * channel state. The companion stays at the bottom while status and activity
+ * occupy the space above it. A local visible-only tick advances frames and
+ * expires temporary reactions; dragging keeps the skin in normal document flow.
+ */
+import React from 'react';
+import type { PanelProps } from '../types.js';
+export declare function CompanionPanel({ width, height, focused, visible }: PanelProps): React.ReactNode;
+export declare const COMPANION_SKIN_DEFAULT: string;
+//# sourceMappingURL=CompanionPanel.d.ts.map

package/lib/types/components/sidePanel/companion/CompanionPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanionPanel.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/CompanionPanel.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAgJ7C,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAigB/F;AAED,eAAO,MAAM,sBAAsB,QAAe,CAAA"}