@deepwhale/coding-agent 1.0.12 → 1.0.13

package/dist/modes/tui.js

@@ -0,0 +1,680 @@
+/**
+ * TUI 模式 — Sprint 1c-revive-4-D-20.3 P0-B (2026-06-05) v1.0 capability completion
+ *
+ * @deprecated LEGACY — Sprint 1c-revive-2-D-24.3 (2026-06-06) v1.0.9:
+ *   1.0.9+ `deepwhale tui` mode 走 Ink 容器 (@deepwhale/tui-ink 1.0.9 bundle).
+ *   本文件保留仅作 source-install dev 路径保底, 不再是 default path.
+ *   - bin/deepwhale.js 'tui' case → runTuiInkMode (D-24.3 dispatch)
+ *   - 跟 D-24.1 §6 红线 1 一致: legacy 0 删, fallback 兜底
+ *   - 现有 979 行 tui-smoke.test.ts 0 改动, 行为在 readline 容器仍验过
+ *
+ *   业务逻辑 0 重写: D-22 / D-23.1 / D-23.2 业务 1:1 搬到 tui-ink/, 跟本文件同形态.
+ *   不再维护 (sprint 1.1+): 计划完全删除本文件, 但保留 0 改动作 fallback.
+ *
+ *   ---- 下方为 v1.0.0 - v1.0.8 readline 容器实现 ----
+ *
+ * Minimal ANSI TUI. **不**装新依赖 (无 Ink), 用 node:readline + ANSI 转义码.
+ *
+ * 复用红线 (D-20.3 P0-B 拍板):
+ *   - 复用 runToolLoop + staticToolPolicy (不绕过 ToolPolicy)
+ *   - 复用 createReplConfirm (D-19 串行化, 不重建 2 套 confirm)
+ *   - 复用 SessionWriter (不绕过 session audit, 跟 REPL/print mode 同形态)
+ *   - 复用 formatUsageStatus (REPL 状态栏 4 字段, 风格统一)
+ *
+ * 必须实现 (用户红线):
+ *   1. `deepwhale tui` 启动
+ *   2. 用户可输入 prompt
+ *   3. assistant stream 可显示
+ *   4. tool call / result 可显示
+ *   5. destructive tool 触发 y/N confirm (走 createReplConfirm)
+ *   6. y 执行, n/empty 拒绝
+ *   7. /exit 或 q 退出
+ *   8. session 不损坏 (走 D-19.5 finish 路径, writer.close)
+ *   9. TUI 路径复用 ToolPolicy / SessionWriter / runToolLoop
+ *
+ * Minimal scope (v1.0):
+ *   - ANSI 颜色: 标题 / 用户 prompt / tool call / tool result / 状态栏
+ *   - 不做: 多行 / 自动补全 / 主题 / 鼠标 / 文件树 / syntax highlight
+ *
+ * NOT covered (defer to v1.1):
+ *   - 全屏 IDE-style TUI
+ *   - 主题切换
+ *   - 多 session 切换
+ *   - Plan mode / recovery
+ */
+import { createInterface } from 'node:readline';
+import { stdin, stdout, stderr } from 'node:process';
+import { SessionReader, SessionWriter } from '@deepwhale/core';
+import { tuiHistoryLoad, tuiHistoryAppend, } from '../util/tui-history.js';
+import { isToolLoopError, loadSession, persistToolLoopSteps, runToolLoop, } from '../agent/index.js';
+import { createDefaultRegistry } from '../tools/registry.js';
+import { formatUsageStatus } from '../repl.js';
+import { createDefaultClient } from '../llm-factory.js';
+import { resolveSandboxRunnerFromEnv } from '../sandbox/env-gate.js';
+import { staticToolPolicy } from '../policy/static-rules.js';
+import { createReplConfirm } from '../repl/repl-confirm.js'; // D-19: 复用 REPL confirm controller
+// ---- ANSI 颜色 (no dependency, 直接 escape) ----
+const ANSI = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    // 前景
+    cyan: '\x1b[36m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    blue: '\x1b[34m',
+    magenta: '\x1b[35m',
+    // 背景
+    bgBlue: '\x1b[44m',
+};
+/** 检测 TTY (跟 REPL 一样, 非 TTY 退回无色输出, 让 test 不依赖 ANSI) */
+const isTty = () => Boolean(stdout.isTTY);
+export const THEMES = {
+    default: {
+        header: ANSI.bold,
+        model: ANSI.cyan + ANSI.bold,
+        divider: ANSI.dim,
+        prompt: ANSI.bold,
+        error: ANSI.red,
+        success: ANSI.green,
+        toolName: ANSI.magenta + ANSI.bold,
+    },
+    solarized: {
+        // 暖冷对比: divider yellow, model blue, prompt bold, error red, success green
+        header: ANSI.yellow + ANSI.bold,
+        model: ANSI.blue + ANSI.bold,
+        divider: ANSI.yellow,
+        prompt: ANSI.bold,
+        error: ANSI.red,
+        success: ANSI.green,
+        toolName: ANSI.magenta + ANSI.bold, // solarized 仍 magenta 突出 tool
+    },
+    monochrome: {
+        // 全黑白, 区分靠 dim/bold, 不刺眼
+        header: ANSI.bold,
+        model: ANSI.bold,
+        divider: ANSI.dim,
+        prompt: ANSI.bold,
+        error: ANSI.dim + ANSI.bold, // monochrome 无红, 仍用 dim+bold 强调错误
+        success: ANSI.bold,
+        toolName: ANSI.dim + ANSI.bold, // monochrome tool name 用 dim+bold
+    },
+};
+const VALID_THEME_NAMES = new Set(['default', 'solarized', 'monochrome']);
+/**
+ * 解析 theme 来源 (env > 默认), 找不到或 invalid 时退化到 'default' + stderr warning.
+ * 不抛: 启动期不阻塞, 跟 env-gate 风格一致.
+ */
+export function resolveTuiTheme(themeArg) {
+    const fromArg = themeArg ?? process.env.DEEPWHALE_TUI_THEME;
+    if (fromArg === undefined || fromArg === '')
+        return 'default';
+    if (VALID_THEME_NAMES.has(fromArg))
+        return fromArg;
+    // invalid: stderr 提醒, 退化
+    stderr.write(`warning: unknown TUI theme '${fromArg}', falling back to 'default' (valid: ${[...VALID_THEME_NAMES].join(', ')})\n`);
+    return 'default';
+}
+/**
+ * 染色 wrapper (D-23.1 改签名) — 用 role 查当前 theme.
+ * 非 TTY 时退化到原文, 让 CI/管道 log 不带 ANSI.
+ */
+function colorize(text, role, theme = THEMES.default) {
+    if (!isTty())
+        return text;
+    return `${theme[role]}${text}${ANSI.reset}`;
+}
+// ---- 视觉元素 (D-21.2 轻量升级, 2026-06-06) ----
+// 复用红线 (D-20.3 P0-B): 不装新依赖 (无 Ink), 仍用 readline + ANSI.
+// 新增仅 2 个 helper, 替换 header 1 处 + status bar 1 处. 不动 prompt / onChunk /
+// confirm / session 路径.
+/**
+ * 画一条横线分隔符, 宽度按 `width` 截 (默认终端列宽, fallback 80).
+ * 配色 dim + cyan 拼接, 非 TTY 退化到 `─` 重复, 让 CI/管道 log 也可读.
+ */
+function horizontalRule(width, theme = THEMES.default) {
+    const cols = width ?? (stdout.columns && stdout.columns > 20 ? stdout.columns : 80);
+    const w = Math.max(20, Math.min(cols - 4, 100));
+    const line = '─'.repeat(w);
+    return colorize('  ' + line, 'divider', theme);
+}
+/**
+ * 格式化状态栏 — D-21.2 升级:
+ * - 复用 formatUsageStatus 的 4 字段 (model / in / cached / out / cost)
+ * - 加分隔线 + 颜色 (key: cyan, value: 黄色 token, 灰色 cost)
+ * - 改成 1 行, 终端窄时(< 60 列) 截断不溢出
+ * - 非 TTY 退化到纯文本 (跟现状一样, 不破坏 test)
+ *
+ * @param usage - formatUsageStatus 返回的原始行, 已是 `tokens X · cached Y · out Z · cost $W` 形态
+ * @param model - 模型名, 走 formatUsageStatus 已含, 这里再拼前面 banner 用 cyan 加粗
+ */
+function formatTuiStatusBar(usage, model, theme = THEMES.default) {
+    if (usage === null) {
+        return colorize(`  ${model} · (no usage)`, 'divider', theme);
+    }
+    // formatUsageStatus 输出形如 "tokens 1.2k · cached 80% · out 200 · cost $0.0012"
+    // 我们把 model 提到前面 + 加色 + 末尾补分隔线
+    const bar = `${model} · ${usage}`;
+    // 终端窄时: 简单截断, 不做折行 (readline prompt 单行假设)
+    const cols = stdout.columns && stdout.columns > 20 ? stdout.columns : 80;
+    const max = Math.max(40, cols - 4);
+    const text = bar.length > max ? bar.slice(0, max - 1) + '…' : bar;
+    // 颜色: model 走 model role (theme 决定), usage 走 divider (跟 horizontalRule 一致)
+    return colorize('  ' + text, 'divider', theme);
+}
+// ---- D-23.2 语法高亮 (2026-06-06) ----
+//
+// 用户拍板 B: onChunk 来的 assistant stream 染色 (不染 readline input, 染 cursor 会乱).
+// 4 类:
+//   1. 工具名 (BashTool / ReadFileTool / WriteFileTool / EditTool / GlobTool / GrepTool) → toolName role
+//   2. 数字 (整数 / 小数 / 百分号 / 倍数 / 货币) → success role
+//   3. 文件路径 (./rel / /abs / node_modules/...) → model role
+//   4. 其它 → 原样 (不染)
+//
+// 算法: 一次正则扫, 用 split-keep-separator 形式拼回原顺序. 非 TTY 退化到原 text (跟 colorize 一致).
+//
+// 风险: chunk content 是一次 fragment (e.g. "Hello, I "), 正则 match 走贪婪, 实际 chunk 长 50 chars 量级 OK.
+//       跟 Fish / Starship prompt 染色同形态. 不动 readline input 路径.
+/** 工具名白名单 (跟 registry.createDefaultRegistry 同步, 加新 tool 必加这里) */
+const TOOL_NAME_RE = /\b(BashTool|ReadFileTool|WriteFileTool|EditTool|GlobTool|GrepTool|ListDirectoryTool|FileReadTool|FileWriteTool)\b/g;
+/** 数字 (整数 / 小数 / 百分号 / 倍数 / 货币 / + 后缀 e.g. 100+) */
+const NUMBER_RE = /(\$?\d+(?:\.\d+)?(?:\+|%|x|ms|s|kb|mb|k|m|gb)?)/g;
+/** 文件路径 (./rel, /abs, 含 /) */
+const PATH_RE = /((?:\.{1,2}\/|\/)[^\s,;:'"`]+)/g;
+/**
+ * 语法高亮 chunk content. 非 TTY 退化到原 text (跟 colorize 行为一致, 跟 CI/管道 log 兼容).
+ *
+ * @param text - 单 chunk 文本 fragment
+ * @param theme - 当前 theme (从 runTuiMode 闭包传入)
+ * @param forceColor - D-23.2 测试 hook: 强制当 TTY (非默认) 用于 unit test 验证染色字节.
+ *                     生产路径 (runTuiMode) 不传, 走 isTty() 自动判断.
+ * @returns 染色后文本 (含 ANSI escape) 或原 text (非 TTY)
+ */
+export function highlightChunk(text, theme = THEMES.default, forceColor) {
+    if (!forceColor && !isTty())
+        return text;
+    if (text.length === 0)
+        return text;
+    // 用 1 个 split-keep 数组, 按出现顺序拼
+    // 简化: 用单个正则 union, 优先匹配顺序是 TOOL_NAME > PATH > NUMBER (用 capturing group).
+    // 但 4 类 union 互相覆盖 (path 含数字, 工具名可能跟 path 相邻), 改用"先标记后还原"算法:
+    //   1. 扫一遍, 收集 [start, end, role] 区间 (按优先级 tool > path > number)
+    //   2. 按顺序拼 (区间内用 theme 染色, 区间外原文)
+    // 这样避免 union 正则优先级错乱.
+    const ranges = [];
+    // 1) tool name (优先级最高, 因为是 word boundary, 不跟 path 重叠)
+    for (const m of text.matchAll(TOOL_NAME_RE)) {
+        if (m.index === undefined)
+            continue;
+        ranges.push({ start: m.index, end: m.index + m[0].length, role: 'toolName' });
+    }
+    // 2) path (跳过已被 tool 覆盖的区间)
+    for (const m of text.matchAll(PATH_RE)) {
+        if (m.index === undefined)
+            continue;
+        const start = m.index;
+        const end = m.index + m[0].length;
+        if (ranges.some((r) => start >= r.start && end <= r.end))
+            continue; // 在 tool 内, 跳过
+        ranges.push({ start, end, role: 'model' });
+    }
+    // 3) number (跳过已被 tool/path 覆盖)
+    for (const m of text.matchAll(NUMBER_RE)) {
+        if (m.index === undefined)
+            continue;
+        const start = m.index;
+        const end = m.index + m[0].length;
+        if (ranges.some((r) => start >= r.start && end <= r.end))
+            continue;
+        ranges.push({ start, end, role: 'success' });
+    }
+    if (ranges.length === 0)
+        return text;
+    // 按 start 排序, 拼回
+    ranges.sort((a, b) => a.start - b.start);
+    const parts = [];
+    let cursor = 0;
+    for (const r of ranges) {
+        if (r.start > cursor)
+            parts.push(text.slice(cursor, r.start));
+        parts.push(colorize(text.slice(r.start, r.end), r.role, theme));
+        cursor = r.end;
+    }
+    if (cursor < text.length)
+        parts.push(text.slice(cursor));
+    return parts.join('');
+}
+// ---- D-22.1 命令历史持久化 (2026-06-06) ----
+//
+// 复用红线 (D-20.3 P0-B): TUI-only feature, 不动 REPL/print mode.
+// 复用红线 (D-19 复用 confirm controller): 历史加载在 runTuiMode 启动期, confirm 期间不动 history.
+//
+// 存储: ~/.deepwhale/tui-history (JSONL, 每行 1 条 raw prompt, 0o600 权限, max 1000 条 LRU).
+// readline history 数组语义: 最新一条在尾部 (所以 load 时反序, append 时 push 后写尾).
+//
+// D-25 (2026-06-06) 抽 tuiHistoryPath/Load/Append/Truncate 到 coding-agent util
+// (跟 tui-ink 1:1 共享). 详见 ../util/tui-history.ts.
+// ---- D-22.2 流式 token spinner (2026-06-06) ----
+//
+// 5 帧: ⠋ ⠙ ⠹ ⠸ ⠼, 80ms / 帧. 走 \r carriage return + \x1b[K clear-to-end-of-line.
+// Windows 兼容: cursorTo(0) + clearLine(1) 兜底 (Win10/11 终端对 \r 也支持).
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼'];
+const SPINNER_INTERVAL_MS = 80;
+const SPINNER_LABEL = 'thinking…';
+class Spinner {
+    timer = null;
+    frame = 0;
+    active = false;
+    start(stream = stdout) {
+        if (this.active)
+            return;
+        if (!isTty())
+            return; // 非 TTY 不转 (跟 colorize 一致, 避免管道/重定向被转)
+        this.active = true;
+        this.frame = 0;
+        this.render(stream);
+        this.timer = setInterval(() => {
+            this.frame = (this.frame + 1) % SPINNER_FRAMES.length;
+            this.render(stream);
+        }, SPINNER_INTERVAL_MS);
+    }
+    stop(stream = stdout) {
+        if (!this.active)
+            return;
+        this.active = false;
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        // 清除当前行 (覆盖 spinner 字符)
+        // Windows 兼容: cursorTo(0) + clearLine(1) 是 TTY 行为, stdout 在 isTTY 时有这俩方法.
+        // 非 TTY 走空格 + \r 兜底.
+        const ttyStream = stream;
+        if (typeof ttyStream.cursorTo === 'function' && typeof ttyStream.clearLine === 'function') {
+            try {
+                ttyStream.cursorTo(0);
+                ttyStream.clearLine(1);
+            }
+            catch {
+                stream.write('\r' + ' '.repeat(SPINNER_LABEL.length + 4) + '\r');
+            }
+        }
+        else {
+            stream.write('\r' + ' '.repeat(SPINNER_LABEL.length + 4) + '\r');
+        }
+    }
+    render(stream) {
+        const text = `${SPINNER_FRAMES[this.frame]} ${SPINNER_LABEL}`;
+        // \r 回行首, [K 清到行尾
+        stream.write(`\r${text}\x1b[K`);
+    }
+}
+// 暴露 Spinner 类供测试用 (D-22.2 verification)
+export { Spinner, SPINNER_FRAMES, SPINNER_INTERVAL_MS, SPINNER_LABEL };
+// ---- D-22.3 Multi-line input (2026-06-06) ----
+//
+// Hermes 风格: `\` 续行 + `\\` 转义. readline 维持 terminal: true 拿 ↑↓ history.
+// 续行机制: 维护 `multiLineBuffer` 状态, 收到 `\` 结尾行不喂给 turn, 下次行追加.
+// 全局单例 (TUI 单 stream), 在 runTuiMode 闭包内状态化.
+function isContinuationLine(line) {
+    return line.endsWith('\\') && !line.endsWith('\\\\');
+}
+function joinContinuation(lines) {
+    // ["line1\\", "line2\\", "line3"] → "line1\nline2\nline3"
+    return lines.map((l) => l.replace(/\\$/, '')).join('\n');
+}
+// ---- TUI 主入口 ----
+export async function runTuiMode(options = {}) {
+    const out = options.output ?? stdout;
+    const err = options.errorOutput ?? stderr;
+    const enableToolLoop = options.enableToolLoop ?? true;
+    const sessionPath = options.sessionPath;
+    // D-23.1 (2026-06-06): 解析 theme. options.theme 优先 > DEEPWHALE_TUI_THEME env > 'default'.
+    // 解析里含 invalid → stderr warning + 退化, 不抛 (跟 env-gate 风格一致).
+    const themeName = resolveTuiTheme(options.theme);
+    const theme = THEMES[themeName];
+    // sandbox env 解析 (跟 print mode / REPL 一致)
+    const sandboxRunner = resolveSandboxRunnerFromEnv({ sandboxRoot: process.cwd() });
+    const policyYes = options.yes ?? false;
+    // lazy client (跟 REPL D-11-4 拍板一致: 无 key 不阻塞启动, 首次 chat 才报错)
+    const clientFromOptions = options.client;
+    let client = clientFromOptions ?? null;
+    let clientError = null;
+    const tryCreateClient = () => {
+        if (clientFromOptions)
+            return { client: clientFromOptions, error: null };
+        if (client !== null || clientError !== null) {
+            return { client, error: clientError };
+        }
+        try {
+            const c = createDefaultClient({
+                ...(options.provider !== undefined ? { provider: options.provider } : {}),
+                ...(options.model !== undefined ? { model: options.model } : {}),
+            });
+            client = c;
+            clientError = null;
+            return { client: c, error: null };
+        }
+        catch (e) {
+            const err0 = e instanceof Error ? e : new Error(String(e));
+            clientError = err0;
+            return { client: null, error: err0 };
+        }
+    };
+    // D-19 复用 confirm controller
+    const confirmController = createReplConfirm({ output: out });
+    const tuiPolicy = {
+        ...staticToolPolicy,
+        confirm: confirmController.confirm,
+    };
+    // session 加载
+    let workingMessages = [];
+    const writer = sessionPath ? new SessionWriter(sessionPath) : null;
+    const reader = sessionPath ? new SessionReader(sessionPath) : null;
+    if (writer && reader) {
+        try {
+            await writer.open();
+            const loaded = await loadSession(reader);
+            workingMessages = [...loaded.messages];
+            if (workingMessages.length > 0) {
+                out.write(colorize(`  ${loaded.messages.length} messages resumed from session\n`, 'divider', theme) + '\n');
+            }
+        }
+        catch (e) {
+            err.write(`warning: could not load session: ${String(e)}\n`);
+        }
+    }
+    // Sprint 1c-revive-4-D-20.3 P0-B (2026-06-05): TUI minimal scope 不接 compaction
+    // (跟 minimal 拍板一致: D-20.3 P0 只做启动/输入/stream/confirm/exit/session 闭环).
+    // Compaction 是 D-20.3 P2, 留 v1.1. options.compactionConfig 字段保留 (跟 print mode
+    // 同接口), 但当前 implementation 不消费. 这样 binary 接口稳定, 后续 sprint 直接接.
+    if (options.compactionConfig && writer) {
+        // 显式 silently no-op (minimal TUI 暂不接 compaction, 避免跟 P0 范围扩大).
+        // 注: print mode 抛 warning (D-6 拍板), TUI 不抛 (minimal scope, 留扩展点).
+    }
+    // 顶部 header — D-21.2 轻量升级: 横线分隔 + banner
+    const initialClientState = tryCreateClient();
+    const modelName = initialClientState.client?.model ?? 'not-configured';
+    out.write('\n');
+    out.write(horizontalRule(undefined, theme) + '\n');
+    out.write(colorize('  deepwhale tui ', 'header', theme) +
+        colorize(modelName, 'model', theme) +
+        colorize('  ·  type a prompt, /help, /verify, /exit (or q)\n', 'divider', theme));
+    out.write(horizontalRule(undefined, theme) + '\n\n');
+    if (initialClientState.error) {
+        err.write(`warning: API key not set, chat will fail until DEEPSEEK_API_KEY or ANTHROPIC_AUTH_TOKEN is set.\n`);
+    }
+    // readline (跟 REPL 同形态)
+    // D-22 (2026-06-06) 拍板: terminal: true 拿 ↑↓ history (D-22.1) + cursor (multi-line D-22.3).
+    // 复用红线: SIGINT 仍走 process.on('SIGINT', onSigint) (D-19 P2-Ctrl+C), readline 不接管
+    // (它 terminal mode 默认会按 Ctrl+C 抛 'SIGINT' 事件, 我们的 onSigint 仍 process 级别接收).
+    const rl = createInterface({
+        input: options.input ?? stdin,
+        terminal: true,
+        output: out,
+    });
+    // D-22.1: 加载历史到 readline (从老到新, 跟 readline 内部 history 数组语义一致)
+    // 注: Node 18+ readline 实例有 `.history: string[]` 字段, 但官方 .d.ts 没声明,
+    // 用 any cast 兜底.
+    const rlAny = rl;
+    rlAny.history = tuiHistoryLoad();
+    return new Promise((resolve) => {
+        let exiting = false;
+        let turnInFlight = false;
+        let pendingExit = false;
+        // D-22.3: multi-line input buffer (Hermes 风格 `\ 续行 + \\ 转义)
+        const multiLineBuffer = [];
+        // D-22.2: 流式 token spinner (assistant stream 期间)
+        const spinner = new Spinner();
+        const finish = async (code) => {
+            if (exiting)
+                return;
+            exiting = true;
+            process.off('SIGINT', onSigint);
+            // D-22.2: 退出前停 spinner (兜底, 避免动画卡住 shell prompt)
+            spinner.stop(out);
+            rl.close();
+            if (writer) {
+                try {
+                    await writer.close();
+                }
+                catch {
+                    /* best-effort */
+                }
+            }
+            out.write('\n' + colorize('  Goodbye!\n', 'divider', theme));
+            resolve(code);
+        };
+        // turn abort controller (D-19 P2-Ctrl+C 拍板)
+        let turnAbortController = new AbortController();
+        const onSigint = () => {
+            if (confirmController.hasPending()) {
+                confirmController.dismiss();
+            }
+            if (!turnAbortController.signal.aborted) {
+                turnAbortController.abort();
+            }
+        };
+        process.on('SIGINT', onSigint);
+        const prompt = () => {
+            out.write(colorize('  > ', 'prompt', theme));
+        };
+        prompt();
+        rl.on('line', async (rawLine) => {
+            // D-22.3 (2026-06-06): Hermes 风格多行输入.
+            // - 末尾 `\` 续行 (不喂给 turn, 攒入 multiLineBuffer)
+            // - 末尾 `\\` (转义) 不当续行, 当字面 `\` 处理
+            // - 空行 + 末尾 `\` → 取消续行, 提交空 prompt
+            const isCont = isContinuationLine(rawLine);
+            if (isCont) {
+                multiLineBuffer.push(rawLine);
+                // 续行提示 (跟 shell 类似 `> `)
+                out.write(colorize('  … ', 'divider', theme));
+                return;
+            }
+            // 收尾 (非续行), 把 buffer 最后一行 + 当前行合并
+            const assembled = multiLineBuffer.length > 0
+                ? joinContinuation([...multiLineBuffer, rawLine])
+                : rawLine;
+            multiLineBuffer.length = 0;
+            const line = assembled.trim();
+            // D-19 拍板: confirm 期间 line 优先喂 confirm
+            if (confirmController.hasPending()) {
+                if (line === 'exit' || line === 'quit' || line === '/exit' || line === '/quit' || line === 'q') {
+                    confirmController.dismiss();
+                    pendingExit = true;
+                    return;
+                }
+                const consumed = confirmController.offerLine(line);
+                if (consumed)
+                    return;
+            }
+            // 内建命令
+            if (line === '') {
+                prompt();
+                return;
+            }
+            if (line === 'q' || line === 'exit' || line === 'quit' || line === '/exit' || line === '/quit') {
+                if (turnInFlight) {
+                    pendingExit = true;
+                    return;
+                }
+                await finish(0);
+                return;
+            }
+            if (line === '/help') {
+                out.write(colorize('\n  Commands:\n' +
+                    '    /help            show this help\n' +
+                    '    /verify          run build/lint/typecheck/test (no LLM needed)\n' +
+                    '    /exit, /quit, q  exit TUI\n\n', 'divider', theme));
+                prompt();
+                return;
+            }
+            if (line === '/verify') {
+                // 跟 REPL /verify 同语义 — 调 runVerify, 写 verification event
+                try {
+                    const { runVerify, formatReport, buildSummaryAndNext } = await import('../verify/index.js');
+                    const report = await runVerify();
+                    const filled = buildSummaryAndNext(report);
+                    const text = formatReport({ ...report, summary: filled.summary, nextSuggestedAction: filled.nextSuggestedAction });
+                    out.write(text + '\n');
+                    if (writer) {
+                        const { appendVerificationEvent } = await import('../agent/index.js');
+                        const failedCount = report.checks.filter((c) => c.status !== 'passed').length;
+                        await appendVerificationEvent(writer, {
+                            status: report.overallStatus,
+                            durationMs: report.durationMs,
+                            commandCount: report.checks.length,
+                            failedCount,
+                            summary: filled.summary,
+                        });
+                    }
+                }
+                catch (e) {
+                    err.write(`error: verify failed: ${e instanceof Error ? e.message : String(e)}\n\n`);
+                }
+                prompt();
+                return;
+            }
+            // 队列守卫 (跟 REPL D-19.5 拍板)
+            if (turnInFlight) {
+                out.write(colorize('  (turn in flight, please wait)\n', 'divider', theme));
+                prompt();
+                return;
+            }
+            turnInFlight = true;
+            turnAbortController = new AbortController();
+            // lazy client
+            const c = clientFromOptions ? { client: clientFromOptions, error: null } : tryCreateClient();
+            if (c.client === null) {
+                err.write(`error: API key not set. set DEEPSEEK_API_KEY or ANTHROPIC_AUTH_TOKEN.\n\n`);
+                turnInFlight = false;
+                prompt();
+                return;
+            }
+            const liveClient = c.client;
+            try {
+                // 持久化 user input
+                if (writer) {
+                    const userEvent = { kind: 'user', ts: Date.now(), content: line };
+                    await writer.append(userEvent);
+                }
+                // 构造 turn messages
+                const turnMessages = [
+                    ...workingMessages,
+                    { role: 'user', content: line },
+                ];
+                out.write('\n'); // user 跟 assistant 间空行
+                let result;
+                if (enableToolLoop) {
+                    // D-22.2 (2026-06-06): turn 启动立刻启 spinner, content 来了就停
+                    spinner.start(out);
+                    result = await runToolLoop(liveClient, turnMessages, {
+                        registry: createDefaultRegistry({ sandboxRunner }),
+                        onChunk: (chunk) => {
+                            if (chunk.content) {
+                                spinner.stop(out);
+                                // D-23.2 (2026-06-06): 语法高亮 assistant stream (tool 名 / 数字 / path 染色)
+                                out.write(highlightChunk(chunk.content, theme));
+                            }
+                        },
+                        ...(options.maxSteps !== undefined ? { maxSteps: options.maxSteps } : {}),
+                        policy: tuiPolicy,
+                        isInteractive: true, // TUI = 交互
+                        yes: policyYes,
+                        // Sprint 1c-revive-5-D-20.6.4 review-fix (2026-06-06): 透传 turnAbortController.signal
+                        // 给 runToolLoop, 让 SIGINT (onSigint) abort 时透传到 LLM stream / tool exec /
+                        // policy.confirm. 跟 repl.ts:509 对齐. 之前漏传, SIGINT 只 abort controller
+                        // 不往下传, 工具循环在 tool execution / confirm 等关键点收不到 abort,
+                        // hang 住, 跟 D-19 Ctrl+C/cleanup 链路不完整.
+                        signal: turnAbortController.signal,
+                        ...(writer ? { writer } : {}),
+                    });
+                }
+                else {
+                    // --no-tool-loop 直发
+                    // D-22.2 (2026-06-06): spinner 启, content 来了停
+                    spinner.start(out);
+                    const streamResult = await liveClient.stream(turnMessages, {
+                        onChunk: (chunk) => {
+                            if (chunk.delta.content) {
+                                spinner.stop(out);
+                                // D-23.2 (2026-06-06): 语法高亮 --no-tool-loop 直发 stream
+                                out.write(highlightChunk(chunk.delta.content, theme));
+                            }
+                        },
+                    });
+                    result = {
+                        messages: [...turnMessages, { role: 'assistant', content: streamResult.content }],
+                        final: streamResult,
+                        steps: [
+                            {
+                                kind: 'assistant',
+                                ts: Date.now(),
+                                message: { role: 'assistant', content: streamResult.content },
+                                result: streamResult,
+                            },
+                        ],
+                    };
+                }
+                // TUI 格式化: tool call / result (跟 print mode printStepSummary 同形态, 但加 ANSI)
+                for (const step of result.steps) {
+                    if (step.kind === 'tool') {
+                        const status = step.result.success ? colorize('✓', 'success', theme) : colorize('✗', 'error', theme);
+                        out.write(`\n  ${status} ${colorize(step.tool_call.name, 'toolName', theme)} (${step.duration_ms}ms)\n`);
+                    }
+                }
+                // 持久化
+                if (writer) {
+                    try {
+                        await persistToolLoopSteps(writer, result.steps);
+                    }
+                    catch {
+                        /* best-effort */
+                    }
+                }
+                // 更新 working messages (跟 REPL 一致, 加 user + 所有 steps 消息)
+                workingMessages = [
+                    ...result.messages,
+                ];
+                // 状态栏 (复用 formatUsageStatus, 4 字段) — D-21.2 轻量升级: 上下加横线分隔
+                const usageLine = formatUsageStatus(result.final.usage);
+                if (usageLine !== null) {
+                    out.write('\n' + horizontalRule() + '\n');
+                    out.write(formatTuiStatusBar(usageLine, modelName) + '\n');
+                    out.write(horizontalRule() + '\n');
+                }
+                else {
+                    out.write('\n' + horizontalRule() + '\n');
+                }
+            }
+            catch (e) {
+                // D-22.2: 异常时停 spinner (兜底)
+                spinner.stop(out);
+                if (isToolLoopError(e)) {
+                    err.write(`\nerror: tool loop hit max steps (${e.steps})\n`);
+                }
+                else {
+                    err.write(`\nerror: ${e instanceof Error ? e.message : String(e)}\n`);
+                }
+            }
+            finally {
+                // D-22.2: turn 完 (正常/异常/abort) 停 spinner
+                spinner.stop(out);
+                // D-22.1: turn 完 (非空, 非内建命令) append 历史
+                // 注意: 续行合并后 assembled 才是真 prompt, 但历史里只存 trimmed 单行
+                // (跟 bash history 一致, 多行 prompt 存 \n 不易)
+                tuiHistoryAppend(assembled);
+                turnInFlight = false;
+                if (pendingExit) {
+                    void finish(0);
+                }
+                else {
+                    prompt();
+                }
+            }
+        });
+    });
+}
+//# sourceMappingURL=tui.js.map