mocode-ai 0.4.5 → 0.4.7

package/dist/tools/builtins/ask-human.js

@@ -1,72 +1,85 @@
 import { promptIntervention } from '../../ui/intervention.js';
 import { sendState } from '../../pet/bridge.js';
-/** 将单个选项元素安全地转为可读字符串。
- *  LLM 有时会传对象(如 {name/label/title:"xxx", desc/description:"yyy"})而不是纯字符串,
- *  直接 String(obj) 会变成 "[object Object]"——这里智能提取可读字段。 */
-function optionToString(o) {
+/** 把单个选项元素安全地转成 {label, detail}。LLM 有时传对象而不是字符串,这里提取可读字段。 */
+function optionToChoice(o) {
     if (o === null || o === undefined)
-        return '';
+        return { label: '' };
     if (typeof o === 'string')
-        return o;
+        return { label: o };
     if (typeof o === 'number' || typeof o === 'boolean')
-        return String(o);
+        return { label: String(o) };
     if (typeof o === 'object') {
         const obj = o;
-        // 优先取常见的标签字段
+        const pickString = (source, keys) => {
+            for (const k of keys) {
+                const v = source[k];
+                if (typeof v === 'string' && v.trim())
+                    return v.trim();
+            }
+            return undefined;
+        };
         const labelKeys = ['label', 'name', 'title', 'text', 'option', 'choice', 'value', 'key'];
-        for (const k of labelKeys) {
-            const v = obj[k];
-            if (typeof v === 'string' && v.trim())
-                return v;
+        let label = pickString(obj, labelKeys);
+        const nestedOptions = obj.options;
+        if (!label && nestedOptions && typeof nestedOptions === 'object' && !Array.isArray(nestedOptions)) {
+            label = pickString(nestedOptions, labelKeys);
         }
-        // 其次尝试 "label + description" 组合
-        const label = obj.label ?? obj.name ?? obj.title;
-        const desc = obj.description ?? obj.desc ?? obj.detail;
-        if (typeof label === 'string' && typeof desc === 'string') {
-            return `${label}: ${desc}`;
+        const desc = pickString(obj, ['description', 'desc', 'detail', 'details', 'reason']);
+        if (label && desc && label !== desc)
+            return { label, detail: desc };
+        if (label)
+            return { label };
+        if (desc)
+            return { label: desc };
+        const nestedKeys = ['options', 'option', 'choice', 'value'];
+        for (const k of nestedKeys) {
+            const nested = obj[k];
+            if (nested && typeof nested === 'object' && !Array.isArray(nested)) {
+                const c = optionToChoice(nested);
+                if (c.label && !c.label.startsWith('{'))
+                    return c;
+            }
         }
-        // 兜底:JSON 序列化(去掉大括号让它看起来不像代码)
         try {
+            // 兜底:仍 stringify 原值,以便上游能看到真实内容做调试/日志;但若得到字面"{}"或"[]"
+            // (说明 obj 本身就是个空对象),返回空 label 让 coerceOptions 的 length>0 filter 自然过滤掉,
+            // 避免终端上显示「1. {}」这种对用户无意义的内容。
             const s = JSON.stringify(obj);
-            // 如果是简单对象尝试美化
-            return s;
+            if (s === '{}' || s === '[]')
+                return { label: '' };
+            return { label: s };
         }
         catch {
-            return String(o);
+            return { label: String(o) };
         }
     }
-    return String(o);
+    return { label: String(o) };
 }
 /** 公开以便 check-ask-human-options.ts 单元测试。 */
 export function coerceOptions(raw) {
-    // 路径 1:本身就是数组,map 成字符串。
     if (Array.isArray(raw)) {
-        // 子路径 1a:LLM 把真数组包成字符串塞在单元素里(本次 bug 现场)
         if (raw.length === 1 && typeof raw[0] === 'string') {
             const t = raw[0].trim();
             if (t.startsWith('[') && t.endsWith(']')) {
                 try {
                     const parsed = JSON.parse(t);
                     if (Array.isArray(parsed))
-                        return parsed.map(optionToString);
+                        return parsed.map(optionToChoice).filter((o) => o.label.length > 0);
                 }
                 catch {
                     // 不是合法 JSON 数组,降级原值
                 }
             }
         }
-        return raw.map(optionToString);
+        return raw.map(optionToChoice).filter((o) => o.label.length > 0);
     }
-    // 路径 2:LLM 直接把整个数组 stringify 成单字符串塞 options 字段(JSON.parse 出来是字符串)
-    // 例如 GLM 系经常这么做,arg h['options']='["A","B"]' → args.options='["A","B"]'
-    // 这里解开成真数组再转。
     if (typeof raw === 'string') {
         const t = raw.trim();
         if (t.startsWith('[') && t.endsWith(']')) {
             try {
                 const parsed = JSON.parse(t);
                 if (Array.isArray(parsed))
-                    return parsed.map(optionToString);
+                    return parsed.map(optionToChoice).filter((o) => o.label.length > 0);
             }
             catch {
                 // 不是合法 JSON,保留为单元素数组(对应 input 模式)
@@ -79,11 +92,11 @@ export function coerceOptions(raw) {
 export const askHumanTool = {
     name: 'ask_human',
     description: [
-        'Present the user with a menu of choices to pick from — not a generic "ask" tool.',
-        ' DEFAULT: pass 2–6 concrete options via `options`; the user picks one and the pick comes back.',
-        ' FREE-TEXT (omit `options`): only when the answer truly cannot be reduced to a few choices',
-        ' (e.g. "paste the error message", "enter the exact URL") — this blocks with a text input.',
-        ' DO NOT call when the task is clear and you can pick a sensible default — decide and proceed.',
+        'Present the user with a menu of choices to pick from.',
+        ' DEFAULT: pass 2-4 concrete options via `options`; each is a string, or { label, description } when the choice has a non-obvious tradeoff.',
+        ' STRICT: object form requires a non-empty `label` — never emit {} or omit label (renders as a literal "{}" menu item). Only `label` and `description` are recognized — no extra fields.',
+        ' FREE-TEXT (omit `options`): only when the answer truly cannot be reduced to a few choices (e.g. "paste the error message").',
+        ' DO NOT call when the task is clear and you can pick a sensible default.',
     ].join(' '),
     parameters: {
         type: 'object',
@@ -94,25 +107,39 @@ export const askHumanTool = {
             },
             options: {
                 type: 'array',
-                items: { type: 'string' },
-                description: '2–6 concrete choices the user can pick with one click. Required in most cases; omit only when free-form text is genuinely needed.',
+                items: {
+                    anyOf: [
+                        { type: 'string' },
+                        {
+                            type: 'object',
+                            properties: {
+                                label: {
+                                    type: 'string',
+                                    minLength: 1,
+                                    description: 'Short option title (1-5 words), shown as the choice itself.',
+                                },
+                                description: {
+                                    type: 'string',
+                                    description: 'What picking this option means or implies; explain the tradeoff when the label alone leaves the user unsure.',
+                                },
+                            },
+                            required: ['label'],
+                        },
+                    ],
+                },
+                description: '2-4 concrete choices. Each is a plain string, or { label, description } when the tradeoff is non-obvious. Required in most cases; omit only for free-form input.',
             },
             context: {
                 type: 'string',
-                description: 'Background explanation for the question (optional; helps the user understand why their decision is needed; shown under the title, may be multiline)',
+                description: 'Background explanation shown under the title; may be multiline.',
             },
         },
         required: ['question'],
     },
     async execute(args) {
         const question = String(args.question ?? '');
-        // 容错:部分 LLM(尤其 GLM 系)把数组/对象 stringify 后塞进来,这里识别「长得很像 JSON
-        // 数组的单字符串元素」并解开,避免菜单只剩一行 [object Object]、逼用户手动输入。
-        // 任何一步失败 / 解出非数组:降级 input,与原代码语义一致。
         const options = coerceOptions(args.options);
         const context = args.context ? String(args.context) : undefined;
-        // 桌宠:面板弹出期间广播 waiting_human(红灯闪烁,提示需要人工介入);拿到响应后 sendState 会被
-        // 下一个 hook 事件(如 onToolDone→tool_call)覆盖,这里不用手动切回——与其它工具状态转移逻辑一致。
         sendState('waiting_human');
         const result = await promptIntervention({
             type: options.length > 0 ? 'choice' : 'input',

package/dist/ui/batch.js

@@ -88,10 +88,10 @@ function buildSummaryLine(entries) {
 /** 把 batch 的详情行展开成自洽行数组(供 layout.contentInsertAfter 走 mid-buffer 插入)。
  *  每行末尾必须以 \x1B[0m 收尾(SGR 自洽模型),行内允许含 SGR(行末 reset 不影响行内样式),
  *  但**绝不**带 \n——rows[] 是行数组,不是流输出。 */
-function buildExpandedLines(entries) {
+function buildExpandedLines(entries, indent = '    ') {
     const lines = [];
     for (const e of entries) {
-        lines.push(`    ${ui.brightMagenta}●${ui.reset} ${ui.cyan}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}\x1B[0m`);
+        lines.push(`${indent}${ui.brightMagenta}●${ui.reset} ${ui.cyan}${e.name}${ui.reset}  ${ui.dim}${e.callSummary}${ui.reset}\x1B[0m`);
         if (e.diffBlock) {
             // diff 块多行文本(由 renderFileChange 渲染);按 \n 拆成物理行,
             // 每行单独入 rows[]。行末 reset 由本函数统一追加(若原行已带 reset,终端合并即可)。
@@ -105,7 +105,7 @@ function buildExpandedLines(entries) {
             }
         }
         else if (e.resultSummary) {
-            lines.push(`    ${ui.gray}↳ ${e.resultSummary}${ui.reset}\x1B[0m`);
+            lines.push(`${indent}${ui.gray}↳ ${e.resultSummary}${ui.reset}\x1B[0m`);
         }
     }
     return lines;
@@ -117,6 +117,17 @@ export function endBatch(id, layout) {
         return; // 幂等
     // 含 mutation(write_file/edit_file)时强制展开——写盘操作必须让用户看到 diff
     b.forceExpanded = b.entries.some((e) => isMutationTool(e.name));
+    // 单条 mutation 调用:摘要行("● edit_file path")与展开详情头逐字重复,跳过摘要行、只写详情
+    // (N>1 时摘要行是聚合信息 "Ran N tools · ...",与详情不重复,两者照常都写)。
+    if (b.forceExpanded && b.entries.length === 1) {
+        // 无摘要行可当父行,详情头改用顶层 2 空格缩进(与 buildSummaryLine/diff head 对齐,而非嵌套的 4 空格)
+        const lines = buildExpandedLines(b.entries, '  ');
+        layout.contentWrite(lines.join('\n') + '\n');
+        b.summaryAbsIdx = Math.max(0, layout.totalRows() - 1 - lines.length);
+        absLineToBatchId.set(b.summaryAbsIdx, b.id);
+        expandedBatches.add(b.id); // 已展开;防止 toggleBatch 再次 expand() 造成重复插入
+        return;
+    }
     const summary = buildSummaryLine(b.entries);
     // 写摘要行(以 \n 收尾;contentWrite 会 breakRow 让其成为完整物理行)
     layout.contentWrite(summary + '\n');
@@ -204,8 +215,14 @@ export function shiftBatchesAfter(absIdx, delta) {
 /** 把已构造好的 BatchEntry[] 直接落成摘要行(用于 renderHistory 回放;不记录 id 也不需可切换)。
  *  含 mutation(write_file/edit_file)时整批展开——与实时 endBatch 行为一致。 */
 export function writeSummaryOnly(entries, layout) {
-    layout.contentWrite(buildSummaryLine(entries) + '\n');
     const hasMutation = entries.some((e) => isMutationTool(e.name));
+    // 单条 mutation:同 endBatch,摘要行与展开详情头重复,跳过摘要行只写详情
+    if (hasMutation && entries.length === 1) {
+        const lines = buildExpandedLines(entries, '  ');
+        layout.contentWrite(lines.join('\n') + '\n');
+        return;
+    }
+    layout.contentWrite(buildSummaryLine(entries) + '\n');
     if (hasMutation) {
         // 回放时同步展开:重新调 expand 路径需要 BatchRecord,此处直接拼 line 插入
         const summaryIdx = Math.max(0, layout.totalRows() - 2);

package/dist/ui/diff.js

@@ -191,11 +191,14 @@ function compactCtx(ops) {
     }
     return items;
 }
-function gutterOf(op) {
+function gutterOf(op, restoreBg = '') {
+    // restoreBg:add/del 行在 pushBody 处已铺底色,gutter 的 `${ui.reset}` 会清掉底色,所以
+    // reset 后必须重发 bg SGR,让该行后续字符继续带底色(否则 gutter 后一小段会变无色)。
+    const rb = restoreBg;
     if (op === 'del')
-        return `${ui.red}-${ui.reset}`;
+        return `${ui.red}-${ui.reset}${rb}`;
     if (op === 'add')
-        return `${ui.green}+${ui.reset}`;
+        return `${ui.green}+${ui.reset}${rb}`;
     return `${ui.dim} ${ui.reset}`;
 }
 function lineWord(n) {
@@ -261,7 +264,41 @@ function renderBody(head, counts, items, padW, startLine, lang) {
     let overflow = 0;
     const pushBody = (num, op, text) => {
         const numStr = String(num).padStart(padW);
-        lines.push(`${BODY_INDENT}${ui.gray}${numStr}${ui.reset} ${gutterOf(op)} ${codeText(text, lang)}`);
+        // 行级底色:add/del 整行包裹主题底色(addBg/delBg),行末由 codeText 内置 reset 闭合 →
+        // bg 不污染下一行。ctx 行不加底色(避免整个 diff 块被背景化,符合 GitHub / VSCode 视觉)。
+        // 注意 gutterOf 与 numStr 的 `${ui.reset}` 会清除之前累加的 bg,所以要紧跟一个 bg 恢复 SGR
+        // 才能让该行后续字符(代码区)继续带底色。
+        //   同时,代码区由 cli-highlight 渲染,内部会反复 ${fg}tok${reset}tok${fg}tok${reset}…
+        //   每个 reset 都会清掉外层 bg → 后面的 token 变无色。所以要在每个 reset 后重发 bg SGR
+        //   (行末那枚 reset 是收尾的,后面紧跟换行而非字符,不需补 bg)。用行末 reset 之外的 reset
+        //   计数 = 内部重发点。
+        const bg = op === 'add' ? ui.addBg : op === 'del' ? ui.delBg : '';
+        if (bg === '') {
+            lines.push(`${BODY_INDENT}${ui.gray}${numStr}${ui.reset} ${gutterOf(op)} ${codeText(text, lang)}`);
+            return;
+        }
+        const raw = `${bg}${BODY_INDENT}${ui.gray}${numStr}${ui.reset}${bg} ${gutterOf(op, bg)} ${codeText(text, lang)}${ui.reset}`;
+        // 在每个非行末的 ${ui.reset} 后重发 bg。行末 reset 紧跟行尾或换行,无需补。
+        // 简单做法:把除最后一个 reset 外的所有 reset 后都补 bg——但要注意 cli-highlight
+        // 输出的代码区段内部还有"省略号截断"${ui.dim}…${ui.reset},它的 reset 也需补 bg。
+        // 用 split 走一遍:找出所有 reset 位置(除最后那个),在其后插入 bg。
+        const resetStr = ui.reset;
+        const lastResetIdx = raw.lastIndexOf(resetStr);
+        if (lastResetIdx < 0) {
+            lines.push(raw);
+            return;
+        }
+        // 把 raw 切成 [prefix + 末 reset] + (中间所有 reset 替换为 reset+bg)
+        const prefix = raw.slice(0, lastResetIdx);
+        const tail = raw.slice(lastResetIdx);
+        // 头部所有 reset 之后插 bg(注:用 split 重建)
+        const parts = prefix.split(resetStr);
+        // parts[i] 是第 i 段,紧跟一段 reset(最后一段后无 reset,故少一个元素)
+        let rebuilt = parts[0];
+        for (let i = 1; i < parts.length; i++) {
+            rebuilt += resetStr + bg + parts[i];
+        }
+        lines.push(rebuilt + tail);
     };
     for (const it of items) {
         if (shown >= MAX_BODY_LINES) {

package/dist/ui/intervention.js

@@ -1,7 +1,7 @@
 import readline from 'node:readline';
 import { stdin, stderr } from 'node:process';
 import { ui } from './theme.js';
-import { displayWidth, truncateDisplay } from './render.js';
+import { displayWidth, truncateDisplay, wrapByDisplayWidth } from './render.js';
 import * as layout from './layout.js';
 import * as mouse from './mouse.js';
 import { Spinner } from './spinner.js';
@@ -15,12 +15,16 @@ export async function promptIntervention(req) {
         const kind = req.type === 'choice' ? '自动选默认项' : '自动返回空输入';
         stderr.write(`[介入] ${req.title}(非交互环境,${kind})\n`);
         if (req.type === 'choice') {
-            return { action: 'selected', value: req.options?.[0] ?? '' };
+            const first = req.options?.[0];
+            const value = typeof first === 'string' ? first : first?.label ?? '';
+            return { action: 'selected', value };
         }
         return { action: 'submitted', value: req.seed ?? '' };
     }
     const options = req.type === 'choice' && Array.isArray(req.options)
-        ? req.options.map((o) => String(o)).filter((s) => s.length > 0)
+        ? req.options
+            .map((o) => typeof o === 'string' ? { label: o } : { label: String(o.label ?? ''), detail: o.detail })
+            .filter((o) => o.label.length > 0)
         : [];
     // choice 但选项被滤空 → 降级 input(对齐设计文档 §8:ask_human 选项为空数组→input)。
     const startMode = req.type === 'choice' && options.length > 0 ? 'choice' : 'input';
@@ -36,14 +40,23 @@ export async function promptIntervention(req) {
     let resolve;
     // 挂自己监听前快照的现有 keypress 监听(运行态即 onRunningKey),退出时按原序恢复。
     let savedListeners = [];
-    /** choice 菜单行:标题(bold)+ detail(dim,行数上限保选项可见)+ 空行 + 选项(▸ 选中/dim)。 */
+    /** choice 菜单行:标题(bold)+ 背景 detail(dim,行数上限保选项可见)+ 空行 + 选项(▸ label,有 detail 的项用全角括号()拼到 label 同行)。 */
     function menuLinesChoice() {
         const g = layout.getGeo();
         const cols = g.cols;
-        const items = [...options, CUSTOM_LABEL];
+        const allowCustom = req.allowCustom !== false;
+        const items = allowCustom ? [...options, { label: CUSTOM_LABEL }] : [...options];
         const optionCount = items.length;
-        // detail 上限:title(1)+detail(D)+空行(1)+options(O) ≤ contentBottom → D ≤ contentBottom-2-O
-        const detailCap = Math.max(0, g.contentBottom - 2 - optionCount);
+        // 每项占行数 = label + （detail）整体 wrap 到可用宽度后的实际行数(超长换行,不再省略)。
+        // 短 label 仍只占 1 行;长 detail 自然占用多行,菜单总高度随之动态增长。
+        const rowsFor = (o) => {
+            const prefixWidth = 2 + (optionCount <= 9 ? 3 : 4); // 保守:覆盖 1. 与 10. 两种前缀
+            const text = o.label + (o.detail ? `（${o.detail}）` : '');
+            return Math.max(1, wrapByDisplayWidth(text, Math.max(1, cols - prefixWidth)).length);
+        };
+        const totalOptionRows = items.reduce((n, o) => n + rowsFor(o), 0);
+        // detail 上限:title(1)+detail(D)+空行(1)+options(totalOptionRows) ≤ contentBottom
+        const detailCap = Math.max(0, g.contentBottom - 2 - totalOptionRows);
         const lines = [];
         lines.push(`${ui.bold}${truncateDisplay(req.title, cols)}${ui.reset}`);
         if (req.detail) {
@@ -56,21 +69,47 @@ export async function promptIntervention(req) {
                 lines.push(`${ui.dim}…${ui.reset}`);
         }
         lines.push(''); // 分隔空行
-        // 选项开窗:超屏高时以 selected 为中心取窗,保选中项可见。
+        // 选项开窗:超屏高时以 selected 为中心收选中项可见。
         const maxOptRows = Math.max(1, g.contentBottom - lines.length);
         let start = 0;
-        if (optionCount > maxOptRows) {
-            start = Math.max(0, Math.min(selected - Math.floor(maxOptRows / 2), optionCount - maxOptRows));
+        {
+            let acc = 0;
+            let s = 0;
+            for (let i = 0; i <= selected && i < optionCount; i++)
+                acc += rowsFor(items[i]);
+            while (acc > maxOptRows && s < selected) {
+                acc -= rowsFor(items[s]);
+                s++;
+            }
+            start = s;
         }
-        const count = Math.min(maxOptRows, optionCount);
-        for (let i = 0; i < count; i++) {
-            const idx = start + i;
+        let used = 0;
+        let idx = start;
+        while (idx < optionCount) {
+            const o = items[idx];
+            const rows = rowsFor(o);
+            if (used + rows > maxOptRows && idx > start)
+                break;
             // 选中项:▸ 与正文均 cyan+bold(去 dim),未选中项保持 dim——选中行整体高亮。
             const isSel = idx === selected;
             const color = isSel ? `${ui.cyan}${ui.bold}` : ui.dim;
             const marker = isSel ? `${ui.cyan}${ui.bold}▸${ui.reset}` : ' ';
-            const body = truncateDisplay(items[idx], cols - 2);
-            lines.push(`${marker} ${color}${body}${ui.reset}`);
+            // 数字前缀:只标真实选项(1-9,与 onKeyChoice 的数字直选对应);"自定义"项不占号。
+            const numStr = idx < options.length ? `${idx + 1}. ` : '';
+            const prefixWidth = 2 + numStr.length; // marker(1)+空格(1)+numStr
+            // 有 detail 的项:把说明拼到 label 后面、用全角括号()包裹;按可用宽度 wrap 多行(超长换行不再省略)。
+            // 第 1 行画 marker+numStr,后续行只画占位空白(prefixWidth)使 label 视觉上悬挂缩进、保持对齐。
+            // 颜色随 label 走(选中 cyan+bold、未选 dim),保持多行视觉整体性。
+            const detailSuffix = o.detail ? `（${o.detail}）` : '';
+            const fullText = o.label + detailSuffix;
+            const wrapped = wrapByDisplayWidth(fullText, Math.max(1, cols - prefixWidth));
+            const pad = ' '.repeat(prefixWidth);
+            for (let li = 0; li < wrapped.length; li++) {
+                const prefix = li === 0 ? `${marker} ${numStr}` : pad;
+                lines.push(`${prefix}${color}${wrapped[li]}${ui.reset}`);
+            }
+            used += rows;
+            idx++;
         }
         return lines;
     }
@@ -181,7 +220,8 @@ export async function promptIntervention(req) {
         }
     }
     function onKeyChoice(key) {
-        const itemCount = options.length + 1; // +自定义项
+        const allowCustom = req.allowCustom !== false;
+        const itemCount = allowCustom ? options.length + 1 : options.length;
         switch (key.name) {
             case 'up':
                 selected = (selected - 1 + itemCount) % itemCount;
@@ -193,7 +233,7 @@ export async function promptIntervention(req) {
                 return;
             case 'return':
             case 'enter':
-                if (selected === options.length) {
+                if (allowCustom && selected === options.length) {
                     // 自定义项 → 切 input 子态(空文本起)
                     mode = 'input';
                     cameFromChoice = true;
@@ -202,7 +242,7 @@ export async function promptIntervention(req) {
                     redraw();
                 }
                 else {
-                    finish({ action: 'selected', value: options[selected] });
+                    finish({ action: 'selected', value: options[selected]?.label });
                 }
                 return;
         }
@@ -211,7 +251,7 @@ export async function promptIntervention(req) {
         if (s >= '1' && s <= '9') {
             const n = Number(s) - 1;
             if (n < options.length) {
-                finish({ action: 'selected', value: options[n] });
+                finish({ action: 'selected', value: options[n].label });
             }
         }
     }