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

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

@@ -0,0 +1,229 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 内置 Panel 注册（设计文档 §16.3：内置与插件从第一天走同一个
+ * PanelStore.register；source 只是标记）。模块首次导入时注册——
+ * SidePanelColumn 引用本模块，所以任何挂到侧栏的树（含回归夹具）
+ * 都会自动带上内置 Panel；插件 Panel 在 Phase 6 经准入外壳进同一个
+ * 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 { panelStore } from './PanelStore.js';
+import { useSidePanelChannel } from './SidePanelRuntimeContext.js';
+import { usePanelInput } from './usePanelInput.js';
+import { jobsFocusStore } from './jobsFocusStore.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);
+    // 已读基线：上次 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, 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) => {
+            // Send to Chat（§6.7）：任务摘要附为下一次提交的上下文；chip 在
+            // 输入框上方出现，Esc 可撤、提交即消耗。
+            if (typeof channel.attachContext !== 'function')
+                return;
+            const lines = job.outputLines ?? [];
+            const summary = [
+                `后台任务 ${job.id}（${job.status}）`,
+                job.command !== undefined && job.command !== '' ? `命令：${job.command}` : `命令：${job.label}`,
+                lines.length > 0
+                    ? `输出（末 ${Math.min(10, lines.length)} 行）：\n${lines.slice(-10).map(line => line.text).join('\n')}`
+                    : '（暂无输出）',
+            ].join('\n');
+            channel.attachContext({ source: 'panel', sourceId: job.id, title: `Job ${job.id}`, content: summary });
+            channel.notify(t('panel-sent-to-chat', { title: job.id }), { color: 'success' });
+        } }));
+}
+/**
+ * agents：SubagentDashboard / SubagentDetailScene 的 panel variant——同一份
+ * channel.subagents 与 subagentControl，布局与键盘按侧栏契约重排。二级路由
+ * 是组件内 state：mountPolicy:'enabled' 让它在切面板 / 收侧栏时保留（评审
+ * §四的硬需求）。badge 派生：running/starting>0 → info；面板不可见期间新
+ * 出现的 failed → error（unread 计数）；两者皆无 → 清空；可见时把当前
+ * failed 集合记为已读。
+ */
+function AgentsPanelAdapter({ focused, visible }) {
+    const channel = useSidePanelChannel();
+    const subagents = channel.subagents;
+    const version = channel.version;
+    const [route, setRoute] = React.useState('dashboard');
+    // 已读基线：上次 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) }));
+    }
+    return (_jsx(SubagentDashboard, { subagents: subagents, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }) }));
+}
+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',
+        // opt-in（在 dsh-tui.sidePanel.panels 里加入才出现，同 companion）。
+        defaultEnabled: false,
+        minColumns: 24,
+        capabilities: { scroll: true },
+        component: InfoPanel,
+    }, 'builtin');
+    panelStore.register({
+        id: 'trajectory',
+        titleKey: 'panel-title-trajectory',
+        icon: '∿',
+        order: 25,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        defaultEnabled: false,
+        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: false,
+        minColumns: 28,
+        // 整屏对应物 = /home 的工作区主页（分屏时 /home 也走本面板）。
+        capabilities: { scroll: true, fullscreen: true },
+        component: WorkspacePanel,
+    }, 'builtin');
+    panelStore.register({
+        id: 'companion',
+        titleKey: 'panel-title-companion',
+        icon: '♥',
+        order: 40,
+        source: 'builtin',
+        mountPolicy: 'enabled',
+        // 默认不启用（在 dsh-tui.sidePanel.panels 里显式加入才出现）。
+        defaultEnabled: false,
+        component: CompanionPanel,
+    }, 'builtin');
+}

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

@@ -0,0 +1,53 @@
+/**
+ * CompanionPanel（设计分文档 §4 + v2.1 + 2026-10 沉底/互动/气泡改造）：
+ *
+ *   信号 ─▶ mood.ts 的派生 + 平滑层（防闪烁五规则）─▶ 显示语义
+ *         ─▶ deepy 动画键（20 个全接上）─▶ 半块渲染（42×15）
+ *
+ * 布局（沉底）：宠物锚定在面板最底部（贴着 SidePanelColumn 底部 hint 行
+ * 上方），腾出的上方空间放一个克制的状态区：心情 + 会话/工具统计行、
+ * 「当前动作」行（kit 自带中文 title，不走 i18n）、互动提示行。
+ * 宽度分三档：<44 列紧凑（不画皮肤，只留紧凑行）；连紧凑形态都摆不下
+ * （< PANEL_MIN_COLUMNS，分栏几何的列宽下限）只留一条居中的「好挤呀，
+ * 暂时躲起来了」标语（companion-cramped，{{name}}=皮肤 title；皮肤无关，
+ * 判定在面板层）。
+ *
+ * 互动（鼠标）：
+ * - 点击宠物左半/右半 → poke-left / poke-right（ClickEvent.localCol），
+ *   保留爱心 pass（whale 回退皮肤的 pose.heart）；
+ * - TICKLE_WINDOW_MS 内 ≥3 次点击 → tickle，窗口结束回平滑情绪；
+ * - 按住拖动（onDragStart/Move/End）→ drag 动画 + **真拖动**：本体跟着
+ *   指针在面板内容区内移动（clamp 在面板盒内，可以窜到状态区文字上面
+ *   ——调皮是特性），松手后 PET_REBOUND_MS 内插值弹回底部 home。位移是
+ *   面板层状态（两套皮肤共用），皮肤输出不动：水平=行内定宽 spacer
+ *   （左 spacer + 宠物 + 右 spacer 恒等于面板宽，§16.6 列宽不变式天然
+ *   成立），垂直=定高 home 槽行内负 marginTop（溢出可见）——刻意不用
+ *   position:absolute：图像版皮肤的可见性门与渲染路径要求宠物留在流内；
+ * - 指针进面板（near/左/右）→ idle-look（东张西望）；碰到宠物本体 →
+ *   idle-spout（开心喷水）；睡眠中被碰到 → waking（官方 trigger）。
+ * 鼠标契约：点击/拖拽 stopImmediatePropagation，hover 离开面板即复原。
+ *
+ * 通知气泡：channel.notifications（最新在最后）的新条目由宠物用圆角对话
+ * 气泡说出来（面板内的**加一层**表达；输入框上方的 toast 照旧，不动）。
+ * 颜色配反应动画：error→error、success→happy、warning→notification、
+ * 无色→idle-look。visible=false 期间清空队列，切回来不弹旧账。
+ *
+ * 活动自述气泡：working 回合里聊天区 ⏵ 工作行（ActivityLine）的那句
+ * 模型自述，由头顶气泡**逐字同步转述**（同一数据源 runtimeCtx.activity
+ * 的 line 字段，不自行派生；判定条件与 Chat 相同：working 且 line 非空
+ * 且 phase≠idle）。派生值、随渲染实时换词，无进出场可重触发；瞬态气泡
+ * （通知/戳一戳）有效期内盖过它，到期仍在 working 则回落。回合结束
+ * （working=false）即收起——庆祝动画走 mood 层，与此无关。拖动会话
+ * （含回弹）期间两层气泡都抑制，落定后恢复（气泡不跟宠物走：孤零零
+ * 留在 home 上方出戏，选抑制）。
+ *
+ * 时钟：visible=false 零订阅（useAnimationFrame 传 null）+ 零自有定时器；
+ * 可见时由 160ms（睡眠 1000ms）的本地 tick 驱动动画帧与气泡/互动过期——
+ * PanelHost 内 useAnimationFrame 因视口测量问题不订阅（见
+ * verify-companion-panel.tsx 文件头的既有 finding），本地 tick 是等价替代。
+ */
+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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AA6I7C,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CA8f/F;AAED,eAAO,MAAM,sBAAsB,QAAe,CAAA"}