minimal-agent 0.10.0 → 0.12.0

package/src/ui/advisorCommand.js

@@ -0,0 +1,54 @@
+/**
+ * `/advisor` 命令解析（纯函数，与 ui/computerCommand.ts 同构，单独导出可测）。
+ *
+ * ⚠️ 关键约束：**子命令不能写死进正则**。
+ *
+ * 旧版用 `/^\/advisor(?:\s+(status|on|off|ask|select)(?:\s+(.*))?)?$/` 一把梭，
+ * 后果是任何不匹配的写法整条掉进 App.tsx 末尾的 `chat.submit()`，被当成普通聊天
+ * 文本发给 LLM：
+ *   - `/advisor 看看这个方案` —— 很自然的写法，用户却收到模型对 "/advisor" 这串
+ *     字符的困惑回答，而不是顾问意见；
+ *   - `/advisor stat`（打错）—— 同样静默变成聊天，用户完全看不出自己敲错了。
+ * 而旧代码注释还宣称支持「无参数但有 note 文本」，那条路径在旧正则下根本不可达
+ * —— 注释与实现矛盾，是 bug 的强信号。
+ *
+ * 现在的语义：认得的子命令照旧；认不得的一律当成 `ask` 的咨询内容 —— 这是最合
+ * 直觉的降级（用户写 `/advisor <一句话>` 就是想问顾问），也让「无参数但有 note」
+ * 从注释变成真实行为。
+ */
+const KNOWN_SUBCOMMANDS = [
+    'help',
+    'status',
+    'on',
+    'off',
+    'ask',
+    'select',
+];
+export function parseAdvisorCommand(input) {
+    const trimmed = input.trim();
+    const match = /^\/advisor(?:\s+([\s\S]+))?$/.exec(trimmed);
+    if (!match)
+        return { matched: false };
+    const rest = match[1]?.trim() ?? '';
+    // 裸 `/advisor` = 查状态（与 `/computer` 的既有约定一致）。
+    if (rest.length === 0)
+        return { matched: true, command: 'status' };
+    const firstToken = rest.split(/\s+/)[0].toLowerCase();
+    const known = KNOWN_SUBCOMMANDS.find((candidate) => candidate === firstToken);
+    if (!known)
+        return { matched: true, command: 'ask', note: rest };
+    const note = rest.slice(firstToken.length).trim();
+    return { matched: true, command: known, ...(note.length > 0 ? { note } : {}) };
+}
+/** `/advisor help` 的文案（纯数据，测试可断言它覆盖了全部子命令）。 */
+export function advisorHelpText() {
+    return [
+        '[/advisor] 顾问模型 —— 独立配置的第二个 LLM，在关键判断点给第二意见。',
+        '  /advisor               查看当前状态',
+        '  /advisor ask <内容>    立即咨询（ask 可省略，直接 /advisor <内容>）',
+        '  /advisor on | off      开启 / 关闭（关闭后模型也不会自动咨询）',
+        '  /advisor select [模型] 选择顾问模型（省略参数弹选择器）',
+        '  /advisor help          显示本说明',
+        '咨询期间可按 ESC 中断；模型自动咨询的配额随本回合工作量增长（1~3 次）。',
+    ].join('\n');
+}

package/src/ui/advisorCommand.ts

@@ -0,0 +1,63 @@
+/**
+ * `/advisor` 命令解析（纯函数，与 ui/computerCommand.ts 同构，单独导出可测）。
+ *
+ * ⚠️ 关键约束：**子命令不能写死进正则**。
+ *
+ * 旧版用 `/^\/advisor(?:\s+(status|on|off|ask|select)(?:\s+(.*))?)?$/` 一把梭，
+ * 后果是任何不匹配的写法整条掉进 App.tsx 末尾的 `chat.submit()`，被当成普通聊天
+ * 文本发给 LLM：
+ *   - `/advisor 看看这个方案` —— 很自然的写法，用户却收到模型对 "/advisor" 这串
+ *     字符的困惑回答，而不是顾问意见；
+ *   - `/advisor stat`（打错）—— 同样静默变成聊天，用户完全看不出自己敲错了。
+ * 而旧代码注释还宣称支持「无参数但有 note 文本」，那条路径在旧正则下根本不可达
+ * —— 注释与实现矛盾，是 bug 的强信号。
+ *
+ * 现在的语义：认得的子命令照旧；认不得的一律当成 `ask` 的咨询内容 —— 这是最合
+ * 直觉的降级（用户写 `/advisor <一句话>` 就是想问顾问），也让「无参数但有 note」
+ * 从注释变成真实行为。
+ */
+
+export type AdvisorCommand = 'help' | 'status' | 'on' | 'off' | 'ask' | 'select';
+
+const KNOWN_SUBCOMMANDS: readonly AdvisorCommand[] = [
+  'help',
+  'status',
+  'on',
+  'off',
+  'ask',
+  'select',
+];
+
+export type AdvisorCommandParseResult =
+  | { matched: false }
+  | { matched: true; command: AdvisorCommand; note?: string };
+
+export function parseAdvisorCommand(input: string): AdvisorCommandParseResult {
+  const trimmed = input.trim();
+  const match = /^\/advisor(?:\s+([\s\S]+))?$/.exec(trimmed);
+  if (!match) return { matched: false };
+
+  const rest = match[1]?.trim() ?? '';
+  // 裸 `/advisor` = 查状态（与 `/computer` 的既有约定一致）。
+  if (rest.length === 0) return { matched: true, command: 'status' };
+
+  const firstToken = rest.split(/\s+/)[0]!.toLowerCase();
+  const known = KNOWN_SUBCOMMANDS.find((candidate) => candidate === firstToken);
+  if (!known) return { matched: true, command: 'ask', note: rest };
+
+  const note = rest.slice(firstToken.length).trim();
+  return { matched: true, command: known, ...(note.length > 0 ? { note } : {}) };
+}
+
+/** `/advisor help` 的文案（纯数据，测试可断言它覆盖了全部子命令）。 */
+export function advisorHelpText(): string {
+  return [
+    '[/advisor] 顾问模型 —— 独立配置的第二个 LLM，在关键判断点给第二意见。',
+    '  /advisor               查看当前状态',
+    '  /advisor ask <内容>    立即咨询（ask 可省略，直接 /advisor <内容>）',
+    '  /advisor on | off      开启 / 关闭（关闭后模型也不会自动咨询）',
+    '  /advisor select [模型] 选择顾问模型（省略参数弹选择器）',
+    '  /advisor help          显示本说明',
+    '咨询期间可按 ESC 中断；模型自动咨询的配额随本回合工作量增长（1~3 次）。',
+  ].join('\n');
+}

package/src/ui/computerCommand.js

@@ -0,0 +1,19 @@
+export function parseComputerCommand(input) {
+    const trimmed = input.trim();
+    // 裸 `/computer` = status，与 `/advisor` 的既有约定一致（裸命令查状态）。
+    // 用户敲这个命令最常见的意图是「现在能不能用」，而不是「有哪些子命令」；
+    // status 的输出里带一句 `/computer help` 就够指路了。
+    if (trimmed === '/computer') {
+        return { matched: true, command: 'status', invalid: false };
+    }
+    if (!/^\/computer(?:\s|$)/.test(trimmed))
+        return { matched: false };
+    const match = /^\/computer\s+(help|status|apps|permissions|observe|interactive|takeover|resume|cancel|stop|audit)$/.exec(trimmed);
+    if (!match)
+        return { matched: true, invalid: true };
+    return {
+        matched: true,
+        command: match[1],
+        invalid: false,
+    };
+}

package/src/ui/computerCommand.ts

@@ -0,0 +1,35 @@
+export type ComputerCommand =
+  | 'help'
+  | 'status'
+  | 'apps'
+  | 'permissions'
+  | 'observe'
+  | 'interactive'
+  | 'takeover'
+  | 'resume'
+  | 'cancel'
+  | 'stop'
+  | 'audit';
+
+export type ComputerCommandParseResult =
+  | { matched: false }
+  | { matched: true; command?: ComputerCommand; invalid: boolean };
+
+export function parseComputerCommand(input: string): ComputerCommandParseResult {
+  const trimmed = input.trim();
+  // 裸 `/computer` = status，与 `/advisor` 的既有约定一致（裸命令查状态）。
+  // 用户敲这个命令最常见的意图是「现在能不能用」，而不是「有哪些子命令」；
+  // status 的输出里带一句 `/computer help` 就够指路了。
+  if (trimmed === '/computer') {
+    return { matched: true, command: 'status', invalid: false };
+  }
+  if (!/^\/computer(?:\s|$)/.test(trimmed)) return { matched: false };
+  const match =
+    /^\/computer\s+(help|status|apps|permissions|observe|interactive|takeover|resume|cancel|stop|audit)$/.exec(trimmed);
+  if (!match) return { matched: true, invalid: true };
+  return {
+    matched: true,
+    command: match[1] as ComputerCommand,
+    invalid: false,
+  };
+}

package/src/ui/figures.ts

@@ -0,0 +1,45 @@
+/**
+ * ============================================================
+ *  src/ui/figures.ts —— TUI 符号表（单一出处）
+ * ------------------------------------------------------------
+ *  借鉴 Claude Code 的 constants/figures.ts：所有语义符号集中一处，
+ *  组件不再散落硬编码字符。
+ *
+ *  ⚠️ 出现在 LiveArea（live 区）的字形必须被 liveViewport.charWidth
+ *  按宽度 2 上界覆盖（INV-1 行宽记账依赖它，宁宽不窄）——新增符号时
+ *  确认其码点落在 charWidth 已覆盖的区间内。
+ *
+ *  SPINNER_FRAMES 留在 LiveArea 本地：它是动画帧组不是语义符号。
+ * ============================================================
+ */
+
+export const figures = {
+  /** 答案锚点（assistant 首条 prose 行前缀） */
+  anchor: '⏺',
+  /** 思维链块 */
+  thought: '💭',
+  /** 折叠提示 */
+  fold: '▾',
+  /** 工作流步骤开始 */
+  step: '▶',
+  /** 成功 */
+  ok: '✓',
+  /** 失败 */
+  fail: '✗',
+  /** 跳过 */
+  skip: '⊘',
+  /** 树分支（非末条） */
+  branch: '├─',
+  /** 树末条 */
+  corner: '└─',
+  /** 树竖线 */
+  pipe: '│',
+  /** 结果/子行连接符（借鉴 Claude Code 的 ⎿ 语汇） */
+  elbow: '⎿',
+  /** 蜂群（并行子任务）头行 */
+  swarm: '⚡',
+  /** 引用块竖条 */
+  quote: '▎',
+  /** 水平分隔 */
+  hr: '─',
+} as const;

package/src/ui/hooks/askSlot.ts

@@ -0,0 +1,112 @@
+/**
+ * ============================================================
+ *  src/ui/hooks/askSlot.ts —— TUI 的 AskUserQuestion 单槽状态机
+ * ------------------------------------------------------------
+ *  从 useChat 抽出的纯函数工厂（仿 LiveArea 的 buildLiveView 先例：
+ *  React hook 闭包没法单测，抽成纯函数才能给真实事故上回归锚）。
+ *
+ *  单槽的依据：工具 isConcurrencySafe:false + workflow 串行 →
+ *  同一时刻至多一个 pending 提问。
+ *
+ *  ⚠️ 归属校验（`current !== me` 早退）是本模块的核心防线：
+ *  同一轮里模型可以**先后**多次 AskUserQuestion，它们共享同一个 turn
+ *  AbortSignal——每次提问都在 signal 上挂一个 {once:true} 的 abort
+ *  监听器，已答完提问的监听器**不会消失**。中断时监听器按注册顺序全部
+ *  触发：若不校验「槽位是否还归我」，第 1 问的监听器会抢先把属于第 2 问
+ *  的槽清掉，第 2 问的监听器再看到空槽早退 → 第 2 问的 promise 永不落定
+ *  → 工具 await 挂死 → 整轮死锁只能杀进程（真实事故，
+ *  test/askSlot.test.ts「同轮两问」场景锁定）。
+ * ============================================================
+ */
+
+import type { AskAnswer, AskControl, AskHandler, AskQuestionSpec, AskSource } from '../../askBridge.js';
+import { dlog } from '../../utils/debugLog.js';
+
+interface PendingResolver {
+  resolve: (answers: AskAnswer[]) => void;
+  reject: (err: Error) => void;
+  cleanup: () => void;
+  source?: AskSource;
+  control?: AskControl;
+}
+
+export interface AskSlot {
+  /** 注册给 askBridge.setAskHandler 的处理器：弹界面、等用户选完。 */
+  handler: AskHandler;
+  /** 用户答完当前提问：清槽 + resolve 工具侧 Promise；无 pending 时空操作（幂等）。 */
+  answer: (answers: AskAnswer[]) => void;
+  /** 只取消当前提问所属执行单元；子任务取消不会中断主回合。 */
+  cancel: () => void;
+}
+
+/**
+ * @param onPendingChange 槽位变化回调：questions = 有待答题目（宿主该弹界面），
+ *                        null = 槽已清（该收界面）。source 描述提问来源（子任务提问时
+ *                        kind:'subagent' + description），供 UI 显示「子任务：X」徽标。
+ *                        TUI 用它同时驱动 setPendingAsk + setPendingAskSource。
+ */
+export function createAskSlot(
+  onPendingChange: (
+    questions: AskQuestionSpec[] | null,
+    source?: AskSource,
+  ) => void,
+): AskSlot {
+  let current: PendingResolver | null = null;
+
+  const handler: AskHandler = (questions, signal, source, control) =>
+    new Promise<AskAnswer[]>((resolve, reject) => {
+      current?.cleanup();
+      current?.reject(new Error('被新的提问取代'));
+      const onAbort = () => {
+        if (current !== me) return;
+        me.cleanup();
+        current = null;
+        onPendingChange(null);
+        reject(new DOMException('已被用户中断', 'AbortError'));
+      };
+      const me: PendingResolver = {
+        resolve,
+        reject,
+        source,
+        control,
+        cleanup: () => signal?.removeEventListener('abort', onAbort),
+      };
+      current = me;
+      dlog('ui', 'ask handler INVOKED (等待用户答题)', {
+        n: questions.length,
+        headers: questions.map((q) => q.header),
+        source: source?.kind,
+      });
+      onPendingChange(questions, source);
+      if (signal?.aborted) {
+        onAbort();
+        return;
+      }
+      signal?.addEventListener('abort', onAbort, { once: true });
+    });
+
+  const answer = (answers: AskAnswer[]): void => {
+    const r = current;
+    current = null;
+    if (!r) return; // abort 已清槽后用户又确认：空操作，无双落定
+    r.cleanup();
+    onPendingChange(null);
+    dlog('ui', 'ask ANSWERED (继续执行)', { selected: answers.map((a) => a.selected) });
+    r.resolve(answers);
+  };
+
+  const cancel = (): void => {
+    const r = current;
+    current = null;
+    if (!r) return;
+    r.cleanup();
+    r.control?.cancelSource();
+    onPendingChange(null);
+    r.reject(new DOMException(
+      r.source?.kind === 'subagent' ? 'subagent cancelled by owner' : 'ask cancelled by user',
+      'AbortError',
+    ));
+  };
+
+  return { handler, answer, cancel };
+}