minimal-agent 0.8.2 → 0.10.0

package/src/ui/AskQuestion.js

@@ -13,18 +13,37 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *  每题选项列表末尾自动追加一个「✏️ 其他（自由输入）」伪选项，命中即切到文本
  *  输入子模式，让用户填选项之外的答案（自由输入按单值处理，覆盖多选集合）。
  *
- *  Ink 用法与风格对齐 cli/configWizard.tsx：useInput 手写键位、↑↓ 取模移动
+ *  Ink 用法与风格对齐 cli/wizards/providerWizard.tsx：useInput 手写键位、↑↓ 取模移动
  *  高亮、`> ` 前缀 + cyan 高亮、gray 操作提示、文本输入用累积 draft + backspace。
  * ============================================================
  */
-import { useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import { Box, Text, useInput } from 'ink';
+import { theme } from './theme.js';
 /** description 过长截断到此长度，防止 live 区被超长文本撑爆。 */
 const DESC_MAX = 80;
+/**
+ * 提问上限——与 system prompt 里的"最多 4 题"硬性对齐。超出会：
+ *   - UI 截断到 4 题（仅前 4 题可答，后面的被静默丢弃）
+ *   - stderr 注记，提示上游（callers 应在调 AskUserQuestion 工具前自检）
+ * 这是防御层——理想情况是 tool 上游 Zod 校验就拦住。
+ */
+const MAX_QUESTIONS = 4;
 function clampDesc(s) {
     return s.length > DESC_MAX ? `${s.slice(0, DESC_MAX - 1)}…` : s;
 }
-export function AskQuestion({ questions, onAnswer, onCancel, }) {
+export function AskQuestion({ questions, source, queuedCount = 0, onAnswer, onCancel, }) {
+    // 硬限 4 题；超量截断。注记走 useEffect（只发一次）：渲染期写 stderr 会随
+    // 每次按键重渲重复打行，且 Ink 渲染期间写 stdout/stderr 会撕裂终端画面。
+    const effectiveQuestions = useMemo(() => questions.slice(0, MAX_QUESTIONS), [questions]);
+    useEffect(() => {
+        if (questions.length <= MAX_QUESTIONS)
+            return;
+        try {
+            process.stderr.write(`[AskUserQuestion] 收到 ${questions.length} 题超过上限 ${MAX_QUESTIONS}，已截断\n`);
+        }
+        catch { /* ignore */ }
+    }, [questions]);
     // 当前进行到第几题
     const [questionIndex, setQuestionIndex] = useState(0);
     // 当前题高亮的选项下标（含末尾「其他」伪选项）
@@ -37,7 +56,7 @@ export function AskQuestion({ questions, onAnswer, onCancel, }) {
     const [textMode, setTextMode] = useState(false);
     // 文本子模式的累积草稿
     const [draft, setDraft] = useState('');
-    const current = questions[questionIndex];
+    const current = effectiveQuestions[questionIndex];
     const multi = current?.multiSelect === true;
     const options = current?.options ?? [];
     // 末尾「其他」伪选项占据下标 options.length，故列表总长 = options.length + 1
@@ -47,7 +66,7 @@ export function AskQuestion({ questions, onAnswer, onCancel, }) {
     function advance(answer) {
         const nextAnswers = [...answers, answer];
         const nextQ = questionIndex + 1;
-        if (nextQ >= questions.length) {
+        if (nextQ >= effectiveQuestions.length) {
             onAnswer(nextAnswers);
             return;
         }
@@ -164,14 +183,14 @@ export function AskQuestion({ questions, onAnswer, onCancel, }) {
     });
     // 无题可问（空数组）→ 渲染占位（useInput 已处理取消，这里只防御渲染崩）
     if (!current) {
-        return (_jsx(Box, { paddingX: 1, children: _jsx(Text, { color: "gray", children: "\uFF08\u65E0\u95EE\u9898\uFF09" }) }));
+        return (_jsx(Box, { paddingX: 1, children: _jsx(Text, { color: theme.subtle, children: "\uFF08\u65E0\u95EE\u9898\uFF09" }) }));
     }
-    const progress = `提问 (${questionIndex + 1}/${questions.length}) · ${current.header}`;
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "cyan", bold: true, children: progress }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: current.question }) }), textMode ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "gray", children: "\u270F\uFE0F \u81EA\u7531\u8F93\u5165\uFF1A" }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: draft || ' ' }) }), _jsx(Text, { color: "gray", children: "\u8F93\u5165\u540E Enter \u63D0\u4EA4 \u00B7 ESC \u8FD4\u56DE" })] })) : (_jsxs(Box, { flexDirection: "column", children: [options.map((opt, i) => {
+    const progress = `提问 (${questionIndex + 1}/${effectiveQuestions.length}) · ${current.header}`;
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [source?.kind === 'subagent' && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: theme.subtle, dimColor: true, children: `⚡ 子任务：${source.description ?? '执行任务'}（其他子任务继续运行中）` }) })), queuedCount > 0 && (_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: theme.subtle, dimColor: true, children: `另有 ${queuedCount} 个问题排队` }) })), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: theme.user, bold: true, children: progress }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { children: current.question }) }), textMode ? (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: theme.subtle, children: "\u270F\uFE0F \u81EA\u7531\u8F93\u5165\uFF1A" }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: draft || ' ' }) }), _jsx(Text, { color: theme.subtle, children: "\u8F93\u5165\u540E Enter \u63D0\u4EA4 \u00B7 ESC \u8FD4\u56DE" })] })) : (_jsxs(Box, { flexDirection: "column", children: [options.map((opt, i) => {
                         const active = i === idx;
                         const box = multi ? (picked.has(i) ? '[x] ' : '[ ] ') : '';
-                        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: active ? 'cyan' : undefined, children: [active ? '> ' : '  ', box, opt.label] }), opt.description ? (_jsxs(Text, { color: "gray", children: ['      ', clampDesc(opt.description)] })) : null] }, `${i}-${opt.label}`));
-                    }), _jsxs(Text, { color: idx === otherIndex ? 'cyan' : undefined, children: [idx === otherIndex ? '> ' : '  ', multi ? '    ' : '', "\u270F\uFE0F \u5176\u4ED6\uFF08\u81EA\u7531\u8F93\u5165\uFF09"] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: multi
+                        return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: active ? theme.user : undefined, children: [active ? '> ' : '  ', box, opt.label] }), opt.description ? (_jsxs(Text, { color: theme.subtle, children: ['      ', clampDesc(opt.description)] })) : null] }, `${i}-${opt.label}`));
+                    }), _jsxs(Text, { color: idx === otherIndex ? theme.user : undefined, children: [idx === otherIndex ? '> ' : '  ', multi ? '    ' : '', "\u270F\uFE0F \u5176\u4ED6\uFF08\u81EA\u7531\u8F93\u5165\uFF09"] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.subtle, children: multi
                                 ? '↑↓ 移动 · 空格 多选 · Enter 确认本题 · ESC 取消'
                                 : '↑↓ 选择 · Enter 确认 · ESC 取消' }) })] }))] }));
 }

package/src/ui/InputBox.js

@@ -16,17 +16,45 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *    - 保留强制刷新但精准控制时机
  * ============================================================
  */
-import React, { useRef, useState, useCallback } from 'react';
+import React, { useRef, useState, useCallback, useEffect } from 'react';
 import { Box, Text, useApp, useInput } from 'ink';
 import { useTextBuffer } from './hooks/useTextBuffer.js';
 import { usePasteHandler } from './hooks/usePasteHandler.js';
 import { useInputHistory } from './hooks/useInputHistory.js';
-function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
+import { theme } from './theme.js';
+// ============================================================
+//  IME 启发式（中文输入法防护）
+// ------------------------------------------------------------
+//  Ink 5.0.1 的 useInput（基于 readline）不暴露 composition event，
+//  无法原生支持 IME 状态机。本启发式做"最小可行"的兜底：
+//    1. 跟踪"短时间内连续插入"——IME 拼音→候选→提交过程中会产生
+//       一连串短间隔字符（pinyin 字母 + 单字 commit）
+//    2. 检测到 burst 后，**短时间窗口内**把 Enter 视为"IME 确认"
+//       而非"提交"（避免候选窗按 Enter 时把半截拼音+候选字提交）
+//    3. 不试图拦截或过滤 IME 字符——那是终端的活，拦了反而破坏
+//
+//  调参依据：微软拼音/搜狗拼音的 commit 节奏典型 < 100ms/char，
+//  而人手打英文 ≥ 200ms/char。500ms idle 视作 IME 结束。
+//
+//  注意：这是 best-effort，**不能 100% 解决 IME 问题**。
+//  终态方案是换掉 Ink 底层走 use-stdin 的 raw mode。
+// ============================================================
+const IME_BURST_GAP_MS = 200; // 字符间隔 < 此值视作 IME 连续输入
+const IME_BURST_MIN_COUNT = 3; // 连续 N 个字符才触发 IME 锁定
+const IME_LOCKOUT_MS = 500; // 触发后禁 Enter 提交的窗口
+function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact, onWorkspaces }) {
     const buf = useTextBuffer();
     const hist = useInputHistory();
     const ctrlCCountRef = useRef(0);
     const ctrlCTimerRef = useRef(null);
     const { exit } = useApp();
+    // 卸载清理：双击退出计数窗口的定时器（组件被 AskQuestion/ConfigMenu 顶替时）
+    useEffect(() => {
+        return () => {
+            if (ctrlCTimerRef.current)
+                clearTimeout(ctrlCTimerRef.current);
+        };
+    }, []);
     // 刷新触发器：值本身不读，只用 setter 触发 InputBoxImpl 重渲（→ BufferView 随父重渲）。
     const [, setRefreshCounter] = useState(0);
     // ✅ Ctrl+R 反向搜索模式（null 表示不在搜索）
@@ -34,6 +62,30 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
     // ✅ Delete 专用去重：只防止 Windows 双事件，不影响其他键
     const lastDeleteTime = useRef(0);
     const DELETE_DEBOUNCE_MS = 20; // 仅 Delete 键用极短防抖
+    // ✅ IME 启发式：跟踪字符插入节奏，检测 IME 草稿期间
+    //   imeBurstRef: { lastAt: 上次插入 ms, count: 当前 burst 内插入数, lastInsertEnd: 上次 IME 锁定结束 ms }
+    const imeBurstRef = useRef({
+        lastAt: 0,
+        count: 0,
+        lockoutUntil: 0,
+    });
+    /** 把"刚插入了非空非控制字符"事件喂给 IME 检测器 */
+    const noteTextInsert = useCallback((textLen) => {
+        if (textLen <= 0)
+            return;
+        const now = Date.now();
+        const s = imeBurstRef.current;
+        if (now - s.lastAt < IME_BURST_GAP_MS) {
+            s.count++;
+            if (s.count >= IME_BURST_MIN_COUNT) {
+                s.lockoutUntil = now + IME_LOCKOUT_MS;
+            }
+        }
+        else {
+            s.count = 1;
+        }
+        s.lastAt = now;
+    }, []);
     const forceRefresh = useCallback(() => {
         setRefreshCounter((c) => c + 1);
     }, []);
@@ -47,6 +99,10 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
         multiline: true,
     });
     useInput((input, key) => {
+        if (key.ctrl && input === 'p') {
+            onWorkspaces();
+            return;
+        }
         // ---- ✅ 粘贴检测（必须优先处理）----
         // 这会在粘贴期间忽略 Enter 键，防止多行内容被截断
         const pasteResult = handlePasteInput(input, key);
@@ -116,13 +172,21 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
         }
         // ---- ESC ----
         if (key.escape) {
-            if (disabled)
-                onAbort();
+            if (disabled) {
+                // try/catch 防 onAbort 异常冒泡到 Ink 渲染层（abort handler 多在 useChat 里，
+                // 内部若 throw 会黑屏；吞掉仅 stderr 注记）
+                try {
+                    onAbort();
+                }
+                catch (e) {
+                    console.error('[InputBox] onAbort threw:', e);
+                }
+            }
             return;
         }
-        // ---- ✅ Ctrl+R 进入反向搜索（仅在空 buf + 非 disabled）----
+        // ---- ✅ Ctrl+R 进入反向搜索（仅在空 buf）----
         if (key.ctrl && input === 'r') {
-            if (!disabled && buf.state.text.length === 0) {
+            if (buf.state.text.length === 0) {
                 setSearchMode({ query: '', hit: null });
             }
             return;
@@ -135,7 +199,23 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
                 return;
             }
             if (disabled) {
-                onAbort();
+                // 同 ESC 路径，try/catch 防 onAbort 异常冒泡到 Ink 渲染层
+                try {
+                    onAbort();
+                }
+                catch (e) {
+                    console.error('[InputBox] onAbort threw:', e);
+                }
+                // 强制退出安全阀（2026-07-02「Ctrl+C 退不出来」事故）：abort 收尾慢
+                // （长时子进程/网络挂起）时用户不能被困在程序里——1s 窗口内再按一次
+                // Ctrl+C 直接退出（复用下方双击退出的计数/窗口；工作流现场已由状态目录
+                // 持久化 halt 语义，强退不丢进度、可 resume）。ESC 保持只 abort 不退出。
+                ctrlCCountRef.current++;
+                if (ctrlCCountRef.current >= 2)
+                    exit();
+                if (ctrlCTimerRef.current)
+                    clearTimeout(ctrlCTimerRef.current);
+                ctrlCTimerRef.current = setTimeout(() => { ctrlCCountRef.current = 0; }, 1000);
                 return;
             }
             ctrlCCountRef.current++;
@@ -152,7 +232,15 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
         //   - Alt+Enter（Mac: Option+Enter）：返回 'enter-newline' → 上面已处理为**插入换行**
         //   - Ctrl+Enter：返回 'continue' → 这里也执行**强制发送**
         //   - 粘贴期间 + Enter：返回 'enter-in-paste' → **忽略**（防误发）
+        //   - IME 草稿期间 + Enter：视为 IME 确认而非提交（启发式，见 IME_BURST_* 常量）
         if (key.return) {
+            const now = Date.now();
+            if (now < imeBurstRef.current.lockoutUntil) {
+                // IME 候选窗按 Enter → 走换行而非提交（pinyin 候选确认不打断草稿）
+                buf.insert('\n');
+                forceRefresh();
+                return;
+            }
             const text = buf.state.text.trim();
             if (text.length === 0)
                 return;
@@ -290,6 +378,7 @@ function InputBoxImpl({ onSubmit, disabled, onAbort, onClear, onCompact }) {
         // （否则 layout 永远 1 行 → ↑/↓ 失效、输入框不长高，光标只能左右）。
         if (input && !key.meta) {
             const normalized = input.replace(/\r\n?/g, '\n');
+            noteTextInsert(normalized.length);
             buf.insert(normalized);
             forceRefresh();
         }
@@ -326,19 +415,22 @@ function ReverseSearchView({ query, hit, }) {
         : hit !== null && hit.includes('\n')
             ? `${hitFirstLine} …`
             : hitFirstLine;
-    return (_jsxs(Box, { borderStyle: "round", borderColor: "magenta", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "magenta", bold: true, children: '(reverse-i-search)`' }), _jsx(Text, { color: "yellow", children: query }), _jsx(Text, { color: "magenta", bold: true, children: "': " }), _jsx(Text, { color: hitFirstLine === null ? 'gray' : 'white', children: hitDisplay })] }), _jsx(Box, { children: _jsx(Text, { color: "gray", dimColor: true, children: "Enter \u63D0\u4EA4 \u00B7 ESC \u53D6\u6D88 \u00B7 Backspace \u5220\u5B57\u7B26" }) })] }));
+    return (_jsxs(Box, { borderStyle: "round", borderColor: "magenta", paddingX: 1, flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: theme.plugin, bold: true, children: '(reverse-i-search)`' }), _jsx(Text, { color: theme.warning, children: query }), _jsx(Text, { color: theme.plugin, bold: true, children: "': " }), _jsx(Text, { color: hitFirstLine === null ? theme.subtle : 'white', children: hitDisplay })] }), _jsx(Box, { children: _jsx(Text, { color: theme.subtle, dimColor: true, children: "Enter \u63D0\u4EA4 \u00B7 ESC \u53D6\u6D88 \u00B7 Backspace \u5220\u5B57\u7B26" }) })] }));
 }
 function BufferView({ buf, disabled }) {
     // buf.layout 由 useTextBuffer 的 useMemo([state]) 维护：父组件每次重渲传入的 buf
     // 都已带最新 layout，这里直接读即可（BufferView 故意不 memo，随父重渲）。
     const { lines, cursorRow, cursorCol } = buf.layout;
-    const promptColor = disabled ? 'gray' : 'cyan';
-    const prompt = disabled ? '⏳ ' : '> ';
+    const promptColor = disabled ? theme.warning : theme.user;
+    const prompt = disabled ? '📝 ' : '> ';
+    const hasContent = lines.some(l => l.length > 0);
     return (_jsx(Box, { borderStyle: "round", borderColor: promptColor, paddingX: 1, flexDirection: "column", children: lines.map((line, row) => {
             const isFirst = row === 0;
-            const isCursorRow = row === cursorRow && !disabled;
+            const isCursorRow = row === cursorRow;
             // key 只用 row：保持稳定，避免逐行重建（layout 变化由父级重渲带下来）
-            return (_jsxs(Box, { children: [_jsx(Text, { color: promptColor, bold: true, children: isFirst ? prompt : '  ' }), isCursorRow ? _jsx(CursorLine, { line: line, col: cursorCol }) : _jsx(Text, { children: line || ' ' })] }, row));
+            return (_jsxs(Box, { children: [_jsx(Text, { color: promptColor, bold: true, children: isFirst ? prompt : '  ' }), isCursorRow ? (_jsx(CursorLine, { line: line, col: cursorCol })) : disabled && isFirst && !hasContent ? (
+                    /* 执行中占位提示：告知可继续输入插话 */
+                    _jsx(Text, { color: theme.subtle, dimColor: true, children: "AI \u5DE5\u4F5C\u4E2D\uFF0C\u53EF\u7EE7\u7EED\u8F93\u5165\u8865\u5145\u6D88\u606F\uFF08Ctrl+C \u4E2D\u65AD\uFF0C\u53CC\u51FB Ctrl+C \u5F3A\u5236\u9000\u51FA\uFF09" })) : (_jsx(Text, { children: line || ' ' }))] }, row));
         }) }));
 }
 /** 光标行渲染（稳定，不会被重建） */

package/src/ui/LiveArea.js

@@ -11,6 +11,12 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *        tool_executing → runningTools 逐行人话描述（gray dim）
  *        compacting/idle→ 无内容行
  *
+ *  ★ 暂态错误行（transientError）：工作流步执行中 LLM 调用失败（会被该步重试）时，
+ *    不把它当永久红字提交进 scrollback，而是作为**状态行下方的一条黄色暂态行**显示。
+ *    它随状态行每帧刷新而被覆盖（不 strand），重试成功后由 useChat 丢弃 → 自然消失。
+ *    彻底失败（步 ok:false / 顶层 halt）才由 useChat 改走永久红字（chat.error）。
+ *    这条行同样走 INV-1 宽度钳制（clampWidthStart），不破坏防刷屏不变量。
+ *
  *  ★ 为什么这样能既"多行打字机 + 流式答案"又**不刷屏**（详见 liveViewport.ts 头部）：
  *    - INV-1：每行都用 wrapToDisplayLines / clampWidthStart 按 CJK/emoji=2 钳到
  *      ≤ cols - LIVE_RIGHT_MARGIN → 终端永不自动折行 → ink eraseLines 每帧精确。
@@ -26,6 +32,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import React, { useEffect, useRef, useState } from 'react';
 import { Box, Text } from 'ink';
 import { LIVE_RIGHT_MARGIN, clampWidthStart, wrapToDisplayLines, } from './liveViewport.js';
+import { theme } from './theme.js';
+import { figures } from './figures.js';
 const STAGE_LABELS = {
     thinking: '思考中',
     streaming: '回答中',
@@ -37,7 +45,7 @@ const SPINNER_FRAMES = ['✶', '✸', '✹', '✺', '✹', '✷'];
 /** spinner 推进 + 强制 re-render 间隔（ms）。~7Hz，远低于 ink 31Hz throttle，Windows 安全。 */
 const SPINNER_INTERVAL_MS = 150;
 /** 内容区行数硬顶（大终端也不铺满，保持清爽）。 */
-const CONTENT_HARD_CAP = 8;
+const CONTENT_HARD_CAP = 16;
 /** 终端高度里预留给 status(1) + 输入框(3) + StatusLine(1) + error/interrupt + 安全余量。 */
 const RESERVED_ROWS = 9;
 /** reasoning 行 💭 前缀 / 续行缩进的预留宽度（💭=2 + 空格；上界 4 更稳）。 */
@@ -53,28 +61,108 @@ function lastN(arr, n) {
     return arr.length <= n ? arr : arr.slice(arr.length - n);
 }
 function toolDesc(t) {
-    if (t.argsFriendly && t.argsFriendly.length > 0)
-        return t.argsFriendly;
-    const a = t.argsPreview.length > TOOL_ARGS_MAX
-        ? `${t.argsPreview.slice(0, TOOL_ARGS_MAX - 1)}…`
-        : t.argsPreview;
-    return `${t.toolName}(${a})`;
+    // 长时工具的步内实时进度（LoopEvent.tool_progress）追加在描述后——
+    // 比静态 args 信息量大得多（如生图 "[ai-image-plan] round 1/1 15/31 t2i → ai_p11.png"）。
+    // 宽度钳制由调用方 clampWidthStart 统一负责（INV-1），这里只拼内容。
+    const base = t.argsFriendly && t.argsFriendly.length > 0
+        ? t.argsFriendly
+        : `${t.toolName}(${t.argsPreview.length > TOOL_ARGS_MAX
+            ? `${t.argsPreview.slice(0, TOOL_ARGS_MAX - 1)}…`
+            : t.argsPreview})`;
+    return t.progress && t.progress.length > 0 ? `${base} · ${t.progress}` : base;
+}
+/** 不带 progress 的静态描述（蜂群树的描述行用；进度另起 ⎿ 行）。 */
+function toolDescStatic(t) {
+    return t.argsFriendly && t.argsFriendly.length > 0
+        ? t.argsFriendly
+        : `${t.toolName}(${t.argsPreview.length > TOOL_ARGS_MAX
+            ? `${t.argsPreview.slice(0, TOOL_ARGS_MAX - 1)}…`
+            : t.argsPreview})`;
+}
+/**
+ * 蜂群树：runningTools 里有 ≥2 个并行的 Agent 子任务时，把 tool_executing
+ * 内容区渲染成树形（借鉴 Claude Code 的 AgentProgressLine 语汇）：
+ *
+ *   ⚡ 3 个子任务并行中（另有 1 个工具）
+ *   ├─ 子任务[explore] 检索路由实现
+ *   │  ⎿ 第 2 轮 · Reading src/router.ts
+ *   └─ 子任务[explore] 调研配置系统
+ *      ⎿ 正在撰写报告…（已输出 850 字）
+ *
+ *  - <2 个 Agent → 返回 null，调用方走既有扁平路径（单 Agent 行为不变）。
+ *  - 行预算：两行模式（描述行 + ⎿ 进度行）放不下 maxLines 时降级单行模式
+ *    （进度拼在描述后），仍超则 lastN 截尾——INV-2 恒成立。
+ *  - 每行经 clampWidthStart 钳宽（INV-1；树形字形 ├└│⎿ 已入 charWidth=2 上界）。
+ *  - Agent 的 progress 行（agent.ts publish 的「label」第 N 轮 · …）剥掉与
+ *    描述行重复的「label」前缀，树里不重复念名字。
+ *  导出供单测断言（liveArea.test.ts 蜂群树 describe）。
+ */
+export function buildSwarmLines(runningTools, maxWidth, maxLines) {
+    const agents = runningTools.filter((t) => t.toolName === 'Agent');
+    if (agents.length < 2)
+        return null;
+    const others = runningTools.filter((t) => t.toolName !== 'Agent');
+    const queued = agents.filter((agent) => agent.progressDetail?.kind === 'subagent' && agent.progressDetail.phase === 'queued').length;
+    const activeCount = agents.length - queued;
+    const header = `${figures.swarm} ${activeCount} 运行${queued > 0 ? ` · ${queued} 排队` : ''}${others.length > 0 ? `（另有 ${others.length} 个工具）` : ''}`;
+    // 进度文案剥冗余 label 前缀（描述行已含「子任务[type] label」）
+    const stripLabel = (p) => p.replace(/^「[^」]*」\s*/, '');
+    const twoLine = 1 + agents.length * 2 + others.length <= maxLines;
+    const lines = [header];
+    agents.forEach((t, i) => {
+        const isLast = i === agents.length - 1 && others.length === 0;
+        const branch = isLast ? figures.corner : figures.branch;
+        const progress = t.progress ? stripLabel(t.progress) : '';
+        if (twoLine) {
+            lines.push(`${branch} ${toolDescStatic(t)}`);
+            lines.push(`${isLast ? '   ' : `${figures.pipe}  `}${figures.elbow} ${progress || '启动中…'}`);
+        }
+        else {
+            lines.push(`${branch} ${toolDescStatic(t)}${progress ? ` · ${progress}` : ''}`);
+        }
+    });
+    for (const t of others)
+        lines.push(`  ${toolDesc(t)}`);
+    return lastN(lines, maxLines).map((l) => clampWidthStart(l, maxWidth));
 }
 /**
  * 纯函数：把一帧的 props（+ 动画 frame / 已耗时秒数）算成 LiveView。
- * idle 返回 null。导出供单测断言 INV-1（每行宽）/ INV-2（行数）/ 颜色层次。
+ * idle 且无暂态错误时返回 null（live 区隐藏）；idle 但有暂态错误时仅渲染该黄色行
+ * （让"重试中/已恢复"提示在步间隙 stage 短暂回 idle 时也不闪没）。
+ * 导出供单测断言 INV-1（每行宽）/ INV-2（行数）/ 颜色层次。
  */
 export function buildLiveView(props) {
-    const { progressStage, reasoningPreview, streamingText, runningTools, pluginProgress, terminalCols, terminalRows, frame, elapsedSec, } = props;
-    if (progressStage === 'idle')
-        return null;
-    const stage = progressStage;
+    const { progressStage, reasoningPreview, streamingText, runningTools, pluginProgress, transientError, terminalCols, terminalRows, frame, elapsedSec, } = props;
     const maxWidth = Math.max(8, terminalCols - LIVE_RIGHT_MARGIN);
     const maxLines = contentMaxLines(terminalRows);
+    // 暂态错误行：单行、钳宽（满足 INV-1）。空串视为无。
+    const transientErrorLine = transientError && transientError.length > 0
+        ? clampWidthStart(transientError, maxWidth)
+        : null;
+    // idle 且无暂态错误 → 整个 live 区隐藏（保持既有行为）。
+    // idle 但有暂态错误 → 只渲染那一行黄字，无状态行 / 无 spinner（避免 idle 还转圈）。
+    if (progressStage === 'idle') {
+        if (transientErrorLine === null)
+            return null;
+        return {
+            statusLine: '',
+            statusColor: theme.user,
+            contentLines: [],
+            contentDim: true,
+            transientErrorLine,
+        };
+    }
+    const stage = progressStage;
     // ---- 状态行 ----
     let status = `${frame} ${STAGE_LABELS[stage]} (${elapsedSec}s)`;
     if (pluginProgress) {
-        status += `  ·  [plugin:${pluginProgress.pluginId}] ${pluginProgress.current}/${pluginProgress.max ?? '?'}${pluginProgress.message ? ` ${pluginProgress.message}` : ''}`;
+        // current 缺省 = 纯文案进度（工作流步骤 title），不渲染数字
+        const num = pluginProgress.current !== undefined
+            ? `${pluginProgress.current}/${pluginProgress.max ?? '?'}`
+            : '';
+        const msg = pluginProgress.message ?? '';
+        const body = [num, msg].filter(Boolean).join(' ');
+        status += `  ·  [plugin:${pluginProgress.pluginId}]${body ? ` ${body}` : ''}`;
     }
     status = clampWidthStart(status, maxWidth);
     // ---- 内容区 ----
@@ -82,7 +170,7 @@ export function buildLiveView(props) {
     let contentDim = true;
     if (stage === 'thinking' && reasoningPreview.length > 0) {
         const wrapped = wrapToDisplayLines(reasoningPreview, maxWidth - REASONING_PREFIX_RESERVE);
-        contentLines = lastN(wrapped, maxLines).map((line, i) => i === 0 ? `💭 ${line}` : `   ${line}`);
+        contentLines = lastN(wrapped, maxLines).map((line, i) => i === 0 ? `${figures.thought} ${line}` : `   ${line}`);
         contentDim = true;
     }
     else if (stage === 'streaming' && streamingText.length > 0) {
@@ -90,14 +178,19 @@ export function buildLiveView(props) {
         contentDim = false; // 答案 = 主角，默认亮色
     }
     else if (stage === 'tool_executing' && runningTools.length > 0) {
-        contentLines = lastN(runningTools, maxLines).map((t) => clampWidthStart(`  ${toolDesc(t)}`, maxWidth));
+        // ≥2 个并行 Agent 子任务 → 蜂群树；否则既有扁平路径（单工具/单 Agent 不变）
+        const swarm = buildSwarmLines(runningTools, maxWidth, maxLines);
+        contentLines =
+            swarm ??
+                lastN(runningTools, maxLines).map((t) => clampWidthStart(`  ${toolDesc(t)}`, maxWidth));
         contentDim = true;
     }
     return {
         statusLine: status,
-        statusColor: stage === 'compacting' ? 'magenta' : 'cyan',
+        statusColor: stage === 'compacting' ? theme.plugin : theme.user,
         contentLines,
         contentDim,
+        transientErrorLine,
     };
 }
 export const LiveArea = React.memo(function LiveArea(props) {
@@ -118,8 +211,8 @@ export const LiveArea = React.memo(function LiveArea(props) {
         const timer = setInterval(() => setTick((t) => (t + 1) % 1_000_000), SPINNER_INTERVAL_MS);
         return () => clearInterval(timer);
     }, [progressStage]);
-    if (progressStage === 'idle')
-        return null;
+    // 不在 idle 直接 return：idle 但存在暂态错误时 buildLiveView 仍会返回一个
+    // 只含 transientErrorLine 的 view（让"已恢复/重试中"提示在步间隙也不闪没）。
     const now = Date.now();
     const elapsedSec = startRef.current
         ? Math.max(0, Math.floor((now - startRef.current) / 1000))
@@ -128,5 +221,5 @@ export const LiveArea = React.memo(function LiveArea(props) {
     const view = buildLiveView({ ...props, frame, elapsedSec });
     if (!view)
         return null;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: view.statusColor, bold: true, wrap: "truncate", children: view.statusLine }), view.contentLines.map((line, i) => (_jsx(Text, { color: view.contentDim ? 'gray' : undefined, dimColor: view.contentDim, wrap: "truncate", children: line.length > 0 ? line : ' ' }, `live-${i}`)))] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [view.statusLine.length > 0 && (_jsx(Text, { color: view.statusColor, bold: true, wrap: "truncate", children: view.statusLine })), view.contentLines.map((line, i) => (_jsx(Text, { color: view.contentDim ? theme.subtle : theme.answer, dimColor: view.contentDim, wrap: "truncate", children: line.length > 0 ? line : ' ' }, `live-${i}`))), view.transientErrorLine !== null && (_jsx(Text, { color: theme.warning, wrap: "truncate", children: view.transientErrorLine }))] }));
 });