minimal-agent 0.13.0 → 0.15.0

package/plugins/workflow-runner/test/workflows.smoke.test.ts

@@ -1,76 +0,0 @@
-/**
- * ============================================================
- *  test/workflows.smoke.test.ts
- * ------------------------------------------------------------
- *  内置工作流「解析+校验」冒烟测试 —— 守护「引擎对所有 workflows/*.yaml 的通用支持」。
- *
- *  为什么需要它（真实缺口）：
- *    `listWorkflows()` 对损坏 yaml 是**静默跳过**（loader.ts catch→warn→continue），
- *    而既有 loader 单测只显式校验了 book-review-short.yaml 一个内置工作流。
- *    于是若某次引擎/loader/schema 改动破坏了 plan / youtube-shorts / adaptive-research /
- *    e2e-write-greet 等的结构，**没有任何测试会失败**——它只会被悄悄忽略。
- *    本文件把「每个内置工作流都能 parse + validate 通过」锁成不变量：任一被改坏即红。
- *
- *  隔离性（同 loader.test.ts 的教训）：
- *    直接定位 packageRoot 的 workflows 目录 + `parseWorkflowFile()` 逐个解析，
- *    **零依赖 getWorkingDir() 全局状态**，避免其它测试文件经 mock.module 留下的污染。
- * ============================================================
- */
-
-import { describe, expect, it } from 'bun:test';
-import { readdirSync } from 'node:fs';
-import { join } from 'node:path';
-
-import { parseWorkflowFile } from '../src/loader.js';
-
-// packageRoot 下的 workflows 目录（不依赖 getWorkingDir）。
-// import.meta.dir = plugins/workflow-runner/test；向上三级到 minimal-agent 根。
-// 兼容 Windows：用 [/\\] 同时匹配两种路径分隔符（同 loader.test.ts:94 的教训）。
-const WORKFLOWS_DIR = join(
-  import.meta.dir.replace(/[/\\]test$/, ''), // plugins/workflow-runner
-  '..', // plugins
-  '..', // minimal-agent 根
-  'workflows',
-);
-
-// 内置工作流的「全集快照」：意外删除/改名任一个即红（防止悄悄少掉一个工作流）。
-const EXPECTED_WORKFLOWS = [
-  'adaptive-research',
-  'book-review-short',
-  'e2e-write-greet',
-  'plan',
-  'ppt',
-  'ralph-loop',
-  'webppt',
-  'word',
-  'youtube-shorts',
-].sort();
-
-function yamlFiles(): string[] {
-  return readdirSync(WORKFLOWS_DIR)
-    .filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'))
-    .sort();
-}
-
-describe('内置 workflows/*.yaml 解析+校验冒烟', () => {
-  // 逐个文件成测：哪个被改坏，失败信息直接点名是哪个工作流。
-  for (const file of yamlFiles()) {
-    it(`${file} 能被 parseWorkflowFile 解析且通过校验`, async () => {
-      const def = await parseWorkflowFile(join(WORKFLOWS_DIR, file));
-      expect(typeof def.name).toBe('string');
-      expect(def.name.length).toBeGreaterThan(0);
-      expect(def.description.length).toBeGreaterThan(0);
-      expect(def.steps.length).toBeGreaterThan(0);
-    });
-  }
-
-  it('内置工作流全集齐全（没有被悄悄删除/改名）', async () => {
-    const defs = await Promise.all(
-      yamlFiles().map((f) => parseWorkflowFile(join(WORKFLOWS_DIR, f))),
-    );
-    const names = defs.map((d) => d.name).sort();
-    for (const expected of EXPECTED_WORKFLOWS) {
-      expect(names).toContain(expected);
-    }
-  });
-});

package/plugins/workflow-runner/test/yamlGuardConditions.test.ts

@@ -1,207 +0,0 @@
-/**
- * ============================================================
- *  真实 yaml 的护栏条件必须真的能判真、也真的能判假
- * ------------------------------------------------------------
- *  护栏（assert / when）有一个非常隐蔽的失效模式：**永远判假，且不报任何错**。
- *  用户看到的是 onFail 里那段业务文案，与真实原因毫无关系，排查方向被彻底带偏。
- *
- *  实测踩到的两个源头，都只在真机跑到那一步才暴露，单测不覆盖就查不出来：
- *
- *  ① **反斜杠被吃掉两层**。表达式引擎的字符串字面量吃一层，YAML 双引号标量再吃一层
- *     —— 写 '(\w+)' 传到引擎手上变成 '(w+)'，正则悄悄失配。
- *     对策：正则一律写字符类 [a-z] / [0-9]，不用 \w / \d。
- *
- *  ② **用 includes 在自由文本里找关键词会被解释性文字骗过**。
- *     实测：模型回「right/pagedown/space 全部无效」，`includes(pager,'right')` 判真放行，
- *     于是本该在探针步诚实停下的运行，一路空转到后面才崩。
- *     对策：让模型输出 `PAGER=xxx` 协议令牌，用 extract 精确取值。
- *
- *  所以这个测试直接读**真实 yaml 文件**，用**真实形状的捕获文本**求值每个护栏，
- *  正反两面都断言。不自造样本 —— 自造样本正是上面两个 bug 能溜过单测的原因。
- * ============================================================
- */
-
-import { describe, expect, test } from 'bun:test';
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { parse } from 'yaml';
-import { evalExpr } from '../src/expressions.js';
-import { VarStack } from '../src/types.js';
-
-const YAML_PATH = join(
-  import.meta.dir,
-  '..',
-  '..',
-  '..',
-  'workflows',
-  'wechat-reading-shots.yaml',
-);
-
-type Step = { id: string; condition?: string; when?: string };
-const def = parse(readFileSync(YAML_PATH, 'utf8')) as { steps: Step[] };
-
-function stepById(id: string): Step {
-  const found = def.steps.find((s) => s.id === id);
-  expect(found).toBeDefined();
-  return found!;
-}
-
-function varsWith(overrides: Record<string, unknown>): VarStack {
-  const vs = new VarStack();
-  vs.set('cfg', { book: '某本书', page: 12, shots: 10 });
-  vs.set('open_state', 'OPEN=ok');
-  vs.set('cur_page', 'PAGE=11 12');
-  for (const [k, v] of Object.entries(overrides)) vs.set(k, v);
-  return vs;
-}
-
-describe('wechat-reading-shots 护栏条件', () => {
-  test('★ 定位护栏不能被解释性文字骗过（令牌必须精确取值）', () => {
-    // 真实形状：模型写一大段说明再给结论。若护栏写成 includes(open_state,'ok')，
-    // 「ok 的路子都走不通」这句话里的 'ok' 会让它判真放行。
-    const deceptive = '归位、书架、搜索都试过了，ok 的路子都走不通。\n\nOPEN=fail';
-    expect(
-      evalExpr(stepById('guard_open').condition!, varsWith({ open_state: deceptive })),
-    ).toBe(false);
-  });
-
-  test('★ 定位护栏能从一大段说明文字里取出 OPEN 令牌', () => {
-    // 反斜杠转义写错时这条会静默判假 —— onFail 会说「没能停到正文页」，
-    // 与真实原因（正则失配）毫无关系，排查方向被彻底带偏。
-    const verbose =
-      '点了书架里的封面，放大镜读到「81 / 116」，已经在正文了。\n\nOPEN=ok';
-    expect(
-      evalExpr(stepById('guard_open').condition!, varsWith({ open_state: verbose })),
-    ).toBe(true);
-  });
-
-  test('落点护栏：双页对开时目标落在左页或右页都算到位', () => {
-    const cond = stepById('guard_landing').condition!;
-    expect(evalExpr(cond, varsWith({ cur_page: 'PAGE=12 13' }))).toBe(true); // 左页命中
-    expect(evalExpr(cond, varsWith({ cur_page: 'PAGE=11 12' }))).toBe(true); // 右页命中
-    expect(evalExpr(cond, varsWith({ cur_page: 'PAGE=80 81' }))).toBe(false); // 差得远
-    expect(evalExpr(cond, varsWith({ cur_page: 'PAGE=0 0' }))).toBe(false); // 读不出来
-  });
-
-  test('落点护栏不能被「112 里含 12」这类子串匹配蒙混过关', () => {
-    // includes 写法会在这里判真（'PAGE 112 113' 含 '12'），extract 精确取值不会。
-    expect(
-      evalExpr(stepById('guard_landing').condition!, varsWith({ cur_page: 'PAGE=112 113' })),
-    ).toBe(false);
-  });
-
-  test('所有护栏正则都不含反斜杠转义（\\w/\\d 会被 YAML 吃掉一层）', () => {
-    // 必须**递归进 loop 的 do[]** —— 循环体里的 when 同样是护栏，
-    // 只扫顶层会漏掉截图循环的边界判定（那正是最容易写错的地方）。
-    const collect = (steps: (Step & { do?: Step[] })[]): string[] =>
-      steps.flatMap((st) => [
-        ...[st.condition, st.when].filter((e): e is string => typeof e === 'string'),
-        ...(Array.isArray(st.do) ? collect(st.do as (Step & { do?: Step[] })[]) : []),
-      ]);
-    const exprs = collect(def.steps as (Step & { do?: Step[] })[]);
-    expect(exprs.length).toBeGreaterThan(4);
-    for (const e of exprs) {
-      expect(e).not.toContain('\\w');
-      expect(e).not.toContain('\\d');
-      expect(e).not.toContain('\\s');
-    }
-  });
-});
-
-/**
- * ============================================================
- *  循环体里 capture 出来的变量必须活到循环之外
- * ------------------------------------------------------------
- *  真实事故：seek 循环一路把书从第 84 页翻到第 12 页，循环里每轮都 capture
- *  `cur_page`，最后一轮读到「PAGE=12 13」—— 任务其实已经成功。但 loop 每轮
- *  `vars.push()` … `vars.pop()`，capture 写进的是**迭代帧**，循环一结束就被弹掉。
- *  循环外的 guard_landing 读到空串，报「没能翻到第 12 页（最后读到的页码：）」，
- *  把一个刚刚成功的任务判成失败，报错文案还完全指不向真因。
- *
- *  正确的语义分界：**迭代变量（as / as_idx）按帧作用域，作者显式命名的变量不按。**
- * ============================================================
- */
-describe('VarStack 作用域：迭代变量 vs 作者变量', () => {
-  test('★ 循环体里 set 的作者变量，pop 之后依然在', () => {
-    const vs = new VarStack();
-    vs.pushIteration();
-    vs.setIteration('i', 3); // 迭代变量
-    vs.set('cur_page', 'PAGE=12 13'); // capture / set 步写的作者变量
-    expect(vs.get('i')).toBe(3);
-    vs.pop();
-    expect(vs.get('i')).toBeUndefined(); // 迭代变量随帧消失 —— 这是对的
-    expect(vs.get('cur_page')).toBe('PAGE=12 13'); // 作者变量必须留下
-  });
-
-  test('嵌套循环：内层写的作者变量穿透到所有循环之外', () => {
-    const vs = new VarStack();
-    vs.pushIteration();
-    vs.pushIteration();
-    vs.set('hit_edge', true);
-    vs.pop();
-    vs.pop();
-    expect(vs.get('hit_edge')).toBe(true);
-  });
-
-  test('迭代变量不会互相污染：内层 pop 后外层的值还在', () => {
-    const vs = new VarStack();
-    vs.pushIteration();
-    vs.setIteration('i', 1);
-    vs.pushIteration();
-    vs.setIteration('i', 99);
-    expect(vs.get('i')).toBe(99);
-    vs.pop();
-    expect(vs.get('i')).toBe(1);
-  });
-
-  test('snapshot 里也能看到循环体写的作者变量（落盘/事件用同一份）', () => {
-    const vs = new VarStack();
-    vs.pushIteration();
-    vs.set('cur_page', 'PAGE=12 13');
-    vs.pop();
-    expect(vs.snapshot().cur_page).toBe('PAGE=12 13');
-  });
-});
-
-/**
- * ============================================================
- *  参数解析必须容忍模型的自由文本
- * ------------------------------------------------------------
- *  「最后只回复一行 JSON」是**没法强制**的约定。实测模型会在 JSON 前加一句
- *  「三项参数都已给出：…」，也可能套 ```json 围栏。
- *
- *  裸 `parseJson(整段文本)` 一炸，`cfg` 变成 null，下游 guard_params 报
- *  「参数没收齐（书名为空…）」—— 而参数其实齐了，是解析被前言撑爆的。
- *  又一次「报错文案指不向真因」，这类静默偏航是本项目反复踩的坑。
- * ============================================================
- */
-describe('参数 JSON 解析的容错', () => {
-  const setStep = def.steps.find((s) => s.id === 'set_params') as unknown as {
-    set: { cfg: string };
-  };
-  /** 取出 ${...} 里的表达式 */
-  const expr = setStep.set.cfg.replace(/^\$\{/, '').replace(/\}$/, '');
-
-  const cases: [string, string][] = [
-    ['纯 JSON', '{"book":"a","page":12,"shots":10}'],
-    ['带前言', '三项参数都已给出。\n\n{"book":"a","page":12,"shots":10}'],
-    ['带 ```json 围栏', '```json\n{"book":"a","page":12,"shots":10}\n```'],
-    ['前后都有话', '好的：\n{"book":"a","page":12,"shots":10}\n以上。'],
-  ];
-
-  for (const [name, raw] of cases) {
-    test(`★ ${name} 都能解出参数`, () => {
-      const vs = new VarStack();
-      vs.set('params_json', raw);
-      const cfg = evalExpr(expr, vs) as { book: string; page: number; shots: number };
-      expect(cfg).toEqual({ book: 'a', page: 12, shots: 10 });
-    });
-  }
-
-  test('解出来的 cfg 能通过 guard_params', () => {
-    const vs = new VarStack();
-    vs.set('params_json', '说明在前。\n{"book":"a","page":12,"shots":10}');
-    vs.set('cfg', evalExpr(expr, vs));
-    expect(evalExpr(stepById('guard_params').condition!, vs)).toBe(true);
-  });
-});

package/src/advisorState.js

@@ -1,22 +0,0 @@
-/**
- * ============================================================
- *  src/advisorState.ts —— 顾问模型（Advisor 工具）开关状态
- * ------------------------------------------------------------
- *  模块级单例，镜像 askBridge.ts::setAskHandler 的简单风格——这不是按请求
- *  隔离的状态（不需要 AsyncLocalStorage），TUI 单进程单会话场景下一个
- *  进程内全局开关就够用。
- *
- *  默认 true：用户配置了 5 个 ADVISOR_AGENT_* 环境变量本身就是"我要用"的
- *  信号，/advisor off 是需要时的临时关闭手段。
- *
- *  纯内存，不落盘——进程重启即重置为默认值（与 sessionState.ts 的
- *  "运行时态、不持久化"定位一致）。
- * ============================================================
- */
-let enabled = true;
-export function isAdvisorEnabled() {
-    return enabled;
-}
-export function setAdvisorEnabled(value) {
-    enabled = value;
-}

package/src/cli/configWizard.js

@@ -1,293 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * ============================================================
- *  src/cli/configWizard.tsx —— 首次启动配置向导（Ink TUI）
- * ------------------------------------------------------------
- *  当 loadProviderLayered() 返回 null（env 和 ~/.minimal-agent/config.json 都没有
- *  完整 provider 配置）时，由 Root.tsx 渲染本组件。
- *
- *  流程：
- *    Step 1: 选 provider 预设（minimax / openai / deepseek / kimi / custom）
- *    Step 2: 输入 baseURL（预设有默认值，用户可改）
- *    Step 3: 输入 apiKey（不回显，用 * 替代）
- *    Step 4: 输入 model（预设有候选）
- *    Step 5: 连接测试（POST /chat/completions max_tokens=5）
- *      - 通过 → saveConfig + onSuccess(provider) → Root 切到 App
- *      - 失败 → 显示错误 + 回到 Step 1（保留已输入的值方便修改）
- *
- *  设计取舍：
- *    - 不引第三方 prompt 库（@inquirer/prompts 等），用 Ink + useInput 手写，
- *      保持"零新增依赖"承诺。
- *    - 不做 spinner 动画，loading 时显示一行文字够用。
- *    - 不做"返回上一步"，要修改请按 ESC 退出向导重跑（简化键位逻辑）。
- *      —— 用户中途退出 = 不写文件 = 下次启动继续向导，符合需求 "直到成功为止"。
- * ============================================================
- */
-import { useCallback, useMemo, useState } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
-import { saveConfig } from '../config/configFile.js';
-import { configService } from '../config/configService.js';
-// 兜底值：custom 或表外 model 都退到这里。
-// 与 src/config.ts 的同名常量含义对齐（"既没 env、saved 也没填 contextWindow" 的最终兜底）。
-const FALLBACK_CONTEXT_WINDOW = 128_000;
-const PRESETS = [
-    {
-        name: 'minimax',
-        label: 'MiniMax (海螺)',
-        baseURL: 'https://api.minimax.chat/v1',
-        models: ['MiniMax-M3', 'MiniMax-M2.7', 'MiniMax-M1', 'abab6.5s-chat'],
-        contextWindow: 204_800,
-    },
-    {
-        // 火山方舟 ARK Coding Plan —— 一个 endpoint 后挂多个 model id，
-        // model 字段大小写严格匹配（'glm-5.1' 而非 'GLM-5.1'）。
-        // 部分 model（如 glm-5.1）走 draft-2020-12 严校验，靠 zodToJson 的
-        // modernizeExclusiveBounds 兼容。
-        name: 'volces',
-        label: '火山方舟 Coding Plan (ARK)',
-        baseURL: 'https://ark.cn-beijing.volces.com/api/coding/v3',
-        models: [
-            'doubao-seed-2.0-pro',
-            'doubao-seed-2.0-code',
-            'doubao-seed-code',
-            'glm-5.1',
-            'minimax-latest',
-            'deepseek-v3.2',
-            'kimi-k2.7-code',
-            'kimi-k2.6',
-        ],
-        contextWindow: 204_800,
-        modelContextWindows: {
-            'kimi-k2.7-code': 512_000,
-        },
-    },
-    {
-        name: 'deepseek',
-        label: 'DeepSeek',
-        baseURL: 'https://api.deepseek.com/v1',
-        models: ['deepseek-chat', 'deepseek-reasoner'],
-        contextWindow: 128_000,
-    },
-    {
-        name: 'openai',
-        label: 'OpenAI',
-        baseURL: 'https://api.openai.com/v1',
-        models: ['gpt-4o', 'gpt-4o-mini'],
-        contextWindow: 128_000,
-    },
-    {
-        name: 'moonshot',
-        label: 'Moonshot (Kimi)',
-        baseURL: 'https://api.moonshot.cn/v1',
-        models: ['moonshot-v1-8k', 'moonshot-v1-32k', 'moonshot-v1-128k'],
-        contextWindow: 128_000,
-        modelContextWindows: {
-            'moonshot-v1-8k': 8_000,
-            'moonshot-v1-32k': 32_000,
-            'moonshot-v1-128k': 128_000,
-        },
-    },
-    {
-        name: 'custom',
-        label: '自定义（手动填 baseURL）',
-        baseURL: '',
-        models: [],
-        contextWindow: FALLBACK_CONTEXT_WINDOW,
-    },
-];
-function resolveContextWindow(preset, model) {
-    return (preset.modelContextWindows?.[model] ??
-        preset.contextWindow ??
-        FALLBACK_CONTEXT_WINDOW);
-}
-export function ConfigWizard({ onSuccess }) {
-    const { exit } = useApp();
-    const [step, setStep] = useState('preset');
-    const [presetIndex, setPresetIndex] = useState(0);
-    const [baseURL, setBaseURL] = useState('');
-    const [apiKey, setApiKey] = useState('');
-    const [model, setModel] = useState('');
-    const [modelIndex, setModelIndex] = useState(0);
-    const [draft, setDraft] = useState('');
-    const [errorMsg, setErrorMsg] = useState(null);
-    const preset = PRESETS[presetIndex];
-    const enterStep = useCallback((next) => {
-        setErrorMsg(null);
-        if (next === 'baseURL')
-            setDraft(baseURL || preset.baseURL);
-        if (next === 'apiKey')
-            setDraft('');
-        if (next === 'model') {
-            if (preset.models.length > 0) {
-                setDraft(model || preset.models[0]);
-                setModelIndex(0);
-            }
-            else {
-                setDraft(model);
-            }
-        }
-        setStep(next);
-    }, [baseURL, model, preset]);
-    // handleTest 接受 finalModel 作为参数：
-    // Step 4 里调用方 `setModel(...) + handleTest()` 时，setModel 是异步的，handleTest
-    // 的 closure 还引用着旧的 model state；直接传 finalModel 才能避免"首次必跑两轮"
-    // —— 第一次发请求时 model 还是空串，API 报错，回到 Step 1 再走一遍才能成功。
-    //
-    // 测试通过后 **不立即** saveConfig + onSuccess，而是转去 Step 5（tavily）
-    // 让用户决定是否一并填 Tavily key，最后在 finalize() 一次性落盘。
-    const handleTest = useCallback(async (finalModel) => {
-        setStep('testing');
-        setErrorMsg(null);
-        try {
-            const url = `${baseURL.replace(/\/$/, '')}/chat/completions`;
-            const resp = await fetch(url, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    Authorization: `Bearer ${apiKey}`,
-                },
-                body: JSON.stringify({
-                    model: finalModel,
-                    messages: [{ role: 'user', content: 'ping' }],
-                    max_tokens: 5,
-                    stream: false,
-                }),
-            });
-            if (!resp.ok) {
-                const body = await resp.text().catch(() => '');
-                throw new Error(`HTTP ${resp.status}: ${body.slice(0, 200) || resp.statusText}`);
-            }
-            const data = (await resp.json());
-            if (!Array.isArray(data.choices)) {
-                throw new Error('响应中没有 choices 字段，可能不是 OpenAI 兼容协议');
-            }
-            setDraft('');
-            setStep('tavily');
-        }
-        catch (e) {
-            setErrorMsg(e.message || '连接失败');
-            setStep('error');
-        }
-    }, [apiKey, baseURL]);
-    // 落盘 + 切到 App。tavily key 为空表示用户跳过 WebSearch 配置。
-    const finalize = useCallback(async (finalModel, tavilyApiKey) => {
-        const contextWindow = resolveContextWindow(preset, finalModel);
-        await saveConfig({
-            baseURL,
-            apiKey,
-            model: finalModel,
-            provider: preset.name,
-            contextWindow,
-            tavilyApiKey,
-        });
-        await configService.reload();
-        onSuccess({
-            name: preset.name,
-            baseURL,
-            apiKey,
-            model: finalModel,
-            contextWindow,
-        });
-    }, [apiKey, baseURL, onSuccess, preset]);
-    useInput((input, key) => {
-        if (key.escape || (key.ctrl && input === 'c')) {
-            exit();
-            return;
-        }
-        if (step === 'preset') {
-            if (key.upArrow) {
-                setPresetIndex((i) => (i - 1 + PRESETS.length) % PRESETS.length);
-            }
-            else if (key.downArrow) {
-                setPresetIndex((i) => (i + 1) % PRESETS.length);
-            }
-            else if (key.return) {
-                enterStep('baseURL');
-            }
-            return;
-        }
-        if (step === 'baseURL') {
-            if (key.return) {
-                if (draft.trim().length === 0)
-                    return;
-                setBaseURL(draft.trim());
-                enterStep('apiKey');
-            }
-            else if (key.backspace || key.delete) {
-                setDraft((s) => s.slice(0, -1));
-            }
-            else if (input && !key.meta && !key.ctrl) {
-                setDraft((s) => s + input);
-            }
-            return;
-        }
-        if (step === 'apiKey') {
-            if (key.return) {
-                if (draft.length === 0)
-                    return;
-                setApiKey(draft);
-                enterStep('model');
-            }
-            else if (key.backspace || key.delete) {
-                setDraft((s) => s.slice(0, -1));
-            }
-            else if (input && !key.meta && !key.ctrl) {
-                setDraft((s) => s + input);
-            }
-            return;
-        }
-        if (step === 'model') {
-            if (preset.models.length > 0) {
-                if (key.upArrow) {
-                    const ni = (modelIndex - 1 + preset.models.length) % preset.models.length;
-                    setModelIndex(ni);
-                    setDraft(preset.models[ni]);
-                }
-                else if (key.downArrow) {
-                    const ni = (modelIndex + 1) % preset.models.length;
-                    setModelIndex(ni);
-                    setDraft(preset.models[ni]);
-                }
-                else if (key.tab) {
-                    setDraft((s) => s + '');
-                }
-            }
-            if (key.return) {
-                const finalModel = draft.trim();
-                if (finalModel.length === 0)
-                    return;
-                setModel(finalModel);
-                void handleTest(finalModel);
-            }
-            else if (key.backspace || key.delete) {
-                setDraft((s) => s.slice(0, -1));
-            }
-            else if (input && !key.meta && !key.ctrl && !key.upArrow && !key.downArrow) {
-                setDraft((s) => s + input);
-            }
-            return;
-        }
-        if (step === 'tavily') {
-            if (key.return) {
-                // 空 draft 表示用户跳过 WebSearch 配置（合法路径，不报错）
-                const tavilyApiKey = draft.trim().length > 0 ? draft.trim() : undefined;
-                void finalize(model, tavilyApiKey);
-            }
-            else if (key.backspace || key.delete) {
-                setDraft((s) => s.slice(0, -1));
-            }
-            else if (input && !key.meta && !key.ctrl) {
-                setDraft((s) => s + input);
-            }
-            return;
-        }
-        if (step === 'error') {
-            if (key.return) {
-                enterStep('preset');
-            }
-            return;
-        }
-    });
-    const maskedApiKey = useMemo(() => '*'.repeat(Math.min(draft.length, 32)), [draft]);
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "cyan", bold: true, children: "minimal-agent \u00B7 \u9996\u6B21\u914D\u7F6E\u5411\u5BFC" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "gray", children: "\u6309 ESC \u6216 Ctrl+C \u9000\u51FA\uFF08\u4E0D\u5199\u914D\u7F6E\uFF0C\u4E0B\u6B21\u542F\u52A8\u7EE7\u7EED\u5411\u5BFC\uFF09" }) }), step === 'preset' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Step 1/5 \u00B7 \u9009\u62E9 provider \u9884\u8BBE\uFF08\u2191\u2193 \u79FB\u52A8\uFF0CEnter \u786E\u8BA4\uFF09" }), _jsx(Box, { flexDirection: "column", marginTop: 1, children: PRESETS.map((p, i) => (_jsxs(Text, { color: i === presetIndex ? 'cyan' : undefined, children: [i === presetIndex ? '> ' : '  ', p.label, p.baseURL ? `  (${p.baseURL})` : ''] }, p.name))) })] })), step === 'baseURL' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Step 2/5 \u00B7 \u8F93\u5165 API base URL\uFF08\u9ED8\u8BA4\u4E3A\u9884\u8BBE\u503C\uFF0C\u53EF\u6539\uFF09" }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: draft || ' ' }) }), _jsx(Text, { color: "gray", children: "Enter \u786E\u8BA4 \u00B7 Backspace \u5220\u9664" })] })), step === 'apiKey' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Step 3/5 \u00B7 \u8F93\u5165 API key\uFF08\u8F93\u5165\u5185\u5BB9\u4E0D\u4F1A\u663E\u793A\uFF09" }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: maskedApiKey || ' ' }) }), _jsxs(Text, { color: "gray", children: ["Enter \u786E\u8BA4 \u00B7 Backspace \u5220\u9664\uFF08\u5DF2\u8F93\u5165 ", draft.length, " \u5B57\u7B26\uFF09"] })] })), step === 'model' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Step 4/5 \u00B7 \u8F93\u5165\u6216\u9009\u62E9 model", preset.models.length > 0 ? '（↑↓ 切换预设，或直接编辑）' : ''] }), preset.models.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: preset.models.map((m, i) => (_jsxs(Text, { color: i === modelIndex ? 'cyan' : 'gray', children: [i === modelIndex ? '> ' : '  ', m] }, m))) })), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: draft || ' ' }) }), _jsx(Text, { color: "gray", children: "Enter \u63D0\u4EA4\u5E76\u6D4B\u8BD5\u8FDE\u63A5" })] })), step === 'testing' && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: "yellow", children: ["\u23F3 \u6B63\u5728\u6D4B\u8BD5\u8FDE\u63A5 ", baseURL, " ..."] }), _jsxs(Text, { color: "gray", children: ["model = ", model] })] })), step === 'tavily' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", children: "\u2713 LLM \u8FDE\u63A5\u6D4B\u8BD5\u901A\u8FC7" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { children: "Step 5/5 \u00B7 \u53EF\u9009 - Tavily API key\uFF08\u7528\u4E8E WebSearch \u5DE5\u5177\uFF09" }) }), _jsx(Box, { marginTop: 1, borderStyle: "round", borderColor: "cyan", paddingX: 1, children: _jsx(Text, { children: maskedApiKey || ' ' }) }), _jsx(Text, { color: "gray", children: "\u76F4\u63A5 Enter \u8DF3\u8FC7\uFF08\u4E4B\u540E\u53EF\u5728\u5BF9\u8BDD\u91CC\u8F93\u5165 /config \u6DFB\u52A0\uFF0C\u6216\u8BBE env TAVILY_API_KEY\uFF09" }), _jsxs(Text, { color: "gray", children: ["\u514D\u8D39 key \u7533\u8BF7\uFF1Ahttps://tavily.com/  \u00B7  \u5DF2\u8F93\u5165 ", draft.length, " \u5B57\u7B26"] })] })), step === 'error' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "red", children: "\u2717 \u8FDE\u63A5\u6D4B\u8BD5\u5931\u8D25" }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "red", children: errorMsg ?? '未知错误' }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "gray", children: "\u5DF2\u8F93\u5165\uFF1A" }) }), _jsxs(Text, { color: "gray", children: ["  provider = ", preset.name] }), _jsxs(Text, { color: "gray", children: ["  baseURL  = ", baseURL] }), _jsxs(Text, { color: "gray", children: ["  model    = ", model] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: "\u6309 Enter \u56DE\u5230 Step 1 \u91CD\u8BD5 \u00B7 ESC \u9000\u51FA" }) })] }))] }));
-}

package/src/tools/toolProgressBridge.js

@@ -1,48 +0,0 @@
-/**
- * ============================================================
- *  src/tools/toolProgressBridge.ts —— 长时工具的「步内进度」宿主桥
- * ------------------------------------------------------------
- *  仿 askBridge 的宿主交互桥模式（全局 handler 注册表）：
- *  长时工具（GenerateImage 批量生图,单步可达 10-30 分钟）在执行**中途**把
- *  逐项进度行发布出来,有 UI 的宿主（TUI useChat）订阅后实时上屏——
- *  否则整步在 LiveArea 上只有一行静态描述,十几分钟毫无变化,
- *  用户必然误判死机（2026-07-02 真实事故:31 张生图 ~13 分钟被当成卡死,
- *  差点手杀健康运行）。
- *
- *  两种宿主:
- *    - TUI:useChat mount 时 setToolProgressHandler() 注册,更新 runningTools
- *      对应条目的 progress 字段 → LiveArea tool_executing 行实时显示。
- *    - 非交互（`-p` / gateway / 子进程）:没有 handler → publish 是 no-op,
- *      零副作用（进度对结构化结局契约不可见,不污染 stdout/stderr）。
- *
- *  工具侧只依赖本模块,不 import ui/（与 askBridge 同样的中立位置理由:
- *  它是工具与宿主之间的中介,避免 tools → ui 反向耦合）。
- * ============================================================
- */
-let handler = null;
-/**
- * 注册 / 注销宿主处理器。
- * TUI 的 useChat 在 mount 时注册、unmount 时传 null 注销。
- * 单进程单 UI,模块级单例即可（与 askBridge 一致）。
- */
-export function setToolProgressHandler(h) {
-    handler = h;
-}
-/** 是否有宿主在场（测试 / 诊断用）。 */
-export function hasToolProgressHandler() {
-    return handler !== null;
-}
-/**
- * 发布一条进度行。无 handler 时 no-op;handler 抛异常也吞掉——
- * 进度是锦上添花,绝不能让 UI 侧的 bug 反噬工具执行。
- */
-export function publishToolProgress(toolName, line) {
-    if (!handler)
-        return;
-    try {
-        handler(toolName, line);
-    }
-    catch {
-        /* 进度上屏失败不阻断工具 */
-    }
-}