mocode-ai 1.6.5 → 1.6.7

package/dist/bots/bus.js

@@ -0,0 +1,117 @@
+// D1 持久 Bot 消息总线：bot 之间（以及 main 用户与 bot 之间）跨时间的异步消息。
+// 与同步 sub-agent 的区别：收发双方不必同时在线——消息落盘，worker bot 之后由
+// scheduler / bg 唤起时拉 inbox 处理并回结果。
+//
+// 存储（<sandboxRoot>/.mocode/bus/）：
+//   <msgId>.json            一条消息（只创建、永不改写 → 并发安全，无丢消息）
+//   <receiver>.read.json    该接收者已读消息 id 数组（低频 RMW，原子写）
+//
+// 身份用 AsyncLocalStorage 注入（runAsIdentity）：headless --bot X 时整段运行为 X，
+// 其内派生的 sub-agent 自动继承；缺省身份为 'main'（用户主会话）。
+import fs from 'node:fs';
+import path from 'node:path';
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomBytes } from 'node:crypto';
+import { getSandboxRoot } from '../sandbox/index.js';
+export const DEFAULT_IDENTITY = 'main';
+const identityStorage = new AsyncLocalStorage();
+/** 在指定 bot 身份下执行 fn；子 agent / 工具内 getIdentity() 都返回该身份。 */
+export function runAsIdentity(identity, fn) {
+    return identityStorage.run(identity, fn);
+}
+export function getIdentity() {
+    return identityStorage.getStore() ?? DEFAULT_IDENTITY;
+}
+function busRoot() {
+    return path.join(getSandboxRoot() ?? process.cwd(), '.mocode', 'bus');
+}
+function messagePath(id) {
+    return path.join(busRoot(), `${id}.json`);
+}
+function readMarkerPath(receiver) {
+    // receiver 只允许安全文件名段，杜绝路径穿越。
+    const safe = receiver.replace(/[^a-zA-Z0-9_.-]/g, '_');
+    return path.join(busRoot(), `${safe}.read.json`);
+}
+export function sendMessage(input) {
+    const to = input.to.trim();
+    const body = input.body;
+    if (!to)
+        throw new Error('message recipient (to) is required');
+    if (!body)
+        throw new Error('message body is required');
+    const msg = {
+        id: `msg-${Date.now().toString(36)}-${randomBytes(3).toString('hex')}`,
+        from: (input.from ?? getIdentity()).trim() || DEFAULT_IDENTITY,
+        to,
+        body,
+        createdAt: new Date().toISOString(),
+        ...(input.inReplyTo ? { inReplyTo: input.inReplyTo } : {}),
+    };
+    fs.mkdirSync(busRoot(), { recursive: true });
+    const target = messagePath(msg.id);
+    fs.writeFileSync(`${target}.tmp`, `${JSON.stringify(msg, null, 2)}\n`, 'utf8');
+    fs.renameSync(`${target}.tmp`, target);
+    return msg;
+}
+function getReadSet(receiver) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(readMarkerPath(receiver), 'utf8'));
+        return new Set(Array.isArray(parsed) ? parsed.filter((x) => typeof x === 'string') : []);
+    }
+    catch {
+        return new Set();
+    }
+}
+function saveReadSet(receiver, set) {
+    const target = readMarkerPath(receiver);
+    fs.writeFileSync(`${target}.tmp`, `${JSON.stringify([...set], null, 2)}\n`, 'utf8');
+    fs.renameSync(`${target}.tmp`, target);
+}
+function allMessages() {
+    let files;
+    try {
+        files = fs.readdirSync(busRoot());
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const f of files) {
+        if (!f.endsWith('.json') || f.endsWith('.read.json'))
+            continue;
+        try {
+            out.push(JSON.parse(fs.readFileSync(path.join(busRoot(), f), 'utf8')));
+        }
+        catch {
+            // skip corrupt
+        }
+    }
+    return out.sort((a, b) => (a.createdAt < b.createdAt ? -1 : 1));
+}
+/** 某身份的未读收件箱。 */
+export function inbox(identity = getIdentity()) {
+    const read = getReadSet(identity);
+    return allMessages().filter((m) => m.to === identity && !read.has(m.id));
+}
+/** 标记消息已读（ack）。只能 ack 发给自己的消息。 */
+export function markRead(ids, identity = getIdentity()) {
+    const read = getReadSet(identity);
+    const mine = new Set(allMessages()
+        .filter((m) => m.to === identity)
+        .map((m) => m.id));
+    const marked = [];
+    for (const id of ids) {
+        if (mine.has(id) && !read.has(id)) {
+            read.add(id);
+            marked.push(id);
+        }
+    }
+    if (marked.length)
+        saveReadSet(identity, read);
+    return marked;
+}
+/** 与某身份相关的全部消息（发出或收到），按时间排序。 */
+export function messageHistory(identity = getIdentity()) {
+    return allMessages().filter((m) => m.from === identity || m.to === identity);
+}

package/dist/bots/cli.js

@@ -0,0 +1,102 @@
+// `mocode bots …` 管理：
+//   add --name <n> (--prompt "<text>" | --prompt-file <path>) [--description <d>]
+//       [--tools "a,b,c"] [--sandbox-path <p>] [--global]
+//   list | show <name> | rm <name> [--global]
+// 作用域默认项目（.mocode/bots）；--global 写 ~/.mocode/bots。
+import fs from 'node:fs';
+import { saveBot, listBots, getBot, deleteBot } from './store.js';
+function flagValue(args, flag) {
+    const i = args.indexOf(flag);
+    if (i === -1)
+        return undefined;
+    const v = args[i + 1];
+    return v && !v.startsWith('-') ? v : undefined;
+}
+export async function runBotsCli(rawArgs) {
+    const sub = rawArgs[0] ?? 'list';
+    const args = rawArgs.slice(1);
+    switch (sub) {
+        case 'add': {
+            const name = flagValue(args, '--name');
+            const description = flagValue(args, '--description') ?? '';
+            const inline = flagValue(args, '--prompt');
+            const promptFile = flagValue(args, '--prompt-file');
+            const toolsRaw = flagValue(args, '--tools');
+            const sandboxPath = flagValue(args, '--sandbox-path');
+            const scope = args.includes('--global') ? 'global' : 'project';
+            if (!name) {
+                process.stderr.write('usage: mocode bots add --name <n> (--prompt "<text>" | --prompt-file <path>) ' +
+                    '[--description <d>] [--tools "a,b"] [--sandbox-path <p>] [--global]\n');
+                return 1;
+            }
+            let systemPrompt = inline ?? '';
+            if (promptFile) {
+                try {
+                    systemPrompt = fs.readFileSync(promptFile, 'utf8');
+                }
+                catch (e) {
+                    process.stderr.write(`mocode: cannot read prompt file: ${e instanceof Error ? e.message : String(e)}\n`);
+                    return 1;
+                }
+            }
+            if (!systemPrompt.trim()) {
+                process.stderr.write('mocode: bot prompt is empty (use --prompt or --prompt-file)\n');
+                return 1;
+            }
+            const tools = toolsRaw
+                ? toolsRaw
+                    .split(',')
+                    .map((t) => t.trim())
+                    .filter(Boolean)
+                : undefined;
+            try {
+                const rec = saveBot({ name, description, systemPrompt, tools, sandboxPath, scope });
+                process.stdout.write(`Bot saved: ${rec.name} (${rec.scope})\n`);
+                return 0;
+            }
+            catch (e) {
+                process.stderr.write(`mocode: ${e instanceof Error ? e.message : String(e)}\n`);
+                return 1;
+            }
+        }
+        case 'show': {
+            const name = args[0];
+            if (!name) {
+                process.stderr.write('usage: mocode bots show <name>\n');
+                return 1;
+            }
+            const rec = getBot(name);
+            if (!rec) {
+                process.stderr.write(`mocode: bot "${name}" not found\n`);
+                return 1;
+            }
+            process.stdout.write(`${JSON.stringify(rec, null, 2)}\n`);
+            return 0;
+        }
+        case 'rm':
+        case 'remove': {
+            const name = args[0];
+            if (!name) {
+                process.stderr.write('usage: mocode bots rm <name> [--global]\n');
+                return 1;
+            }
+            const scope = args.includes('--global') ? 'global' : 'project';
+            const ok = deleteBot(name, scope);
+            process.stdout.write(ok ? `Removed bot ${name} (${scope})\n` : `mocode: bot ${name} (${scope}) not found\n`);
+            return ok ? 0 : 1;
+        }
+        case 'list':
+        default: {
+            const all = listBots();
+            if (all.length === 0) {
+                process.stdout.write('(no bots; create one with `mocode bots add …`)\n');
+                return 0;
+            }
+            for (const b of all) {
+                process.stdout.write(`${b.scope === 'global' ? 'g' : 'p'} ${b.name}` +
+                    `${b.tools && b.tools.length ? `  tools:${b.tools.length}` : ''}  ${b.description}\n`);
+            }
+            return 0;
+        }
+    }
+}

package/dist/bots/store.js

@@ -0,0 +1,100 @@
+// 具名 Bot 存储：一个 Bot = 岗位系统提示 + 可选工具白名单 + 可选沙箱范围。
+//
+// 两级存储（与 AGENTS.md 发现规则同风格）：
+// - 全局：~/.mocode/bots/<name>.json
+// - 项目：<sandboxRoot>/.mocode/bots/<name>.json
+// 合并时全局先、项目后，项目同名覆盖全局。
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getSandboxRoot } from '../sandbox/index.js';
+const NAME_RE = /^[a-z0-9][a-z0-9-]{0,31}$/;
+export function globalBotsDir() {
+    return path.join(os.homedir(), '.mocode', 'bots');
+}
+export function projectBotsDir() {
+    return path.join(getSandboxRoot() ?? process.cwd(), '.mocode', 'bots');
+}
+function botPath(dir, name) {
+    return path.join(dir, `${name}.json`);
+}
+function assertValidName(name) {
+    if (!NAME_RE.test(name)) {
+        throw new Error(`bad bot name "${name}": use 1-32 chars, lowercase letters/digits/dash, cannot start with dash`);
+    }
+}
+/** 校验并落盘一个 bot（scope 决定写全局还是项目）。 */
+export function saveBot(input) {
+    assertValidName(input.name);
+    if (!input.systemPrompt.trim())
+        throw new Error('bot systemPrompt must not be empty');
+    const scope = input.scope ?? 'project';
+    const record = {
+        name: input.name,
+        description: input.description ?? '',
+        systemPrompt: input.systemPrompt,
+        ...(input.tools && input.tools.length ? { tools: input.tools } : {}),
+        ...(input.sandboxPath ? { sandboxPath: input.sandboxPath } : {}),
+        scope,
+        createdAt: new Date().toISOString(),
+    };
+    const dir = scope === 'global' ? globalBotsDir() : projectBotsDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const target = botPath(dir, record.name);
+    const tmp = `${target}.tmp`;
+    fs.writeFileSync(tmp, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+    fs.renameSync(tmp, target);
+    return record;
+}
+function readOne(dir, file) {
+    try {
+        return JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function readDir(dir) {
+    let files;
+    try {
+        files = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const f of files) {
+        if (!f.endsWith('.json'))
+            continue;
+        const rec = readOne(dir, f);
+        if (rec)
+            out.push(rec);
+    }
+    return out;
+}
+/** 列出全部 bot（全局 + 项目，项目同名覆盖）。 */
+export function listBots() {
+    const byName = new Map();
+    for (const b of readDir(globalBotsDir()))
+        byName.set(b.name, b);
+    for (const b of readDir(projectBotsDir()))
+        byName.set(b.name, b);
+    return [...byName.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+export function getBot(name) {
+    // 项目优先（覆盖语义）：先找项目再找全局。
+    const project = readOne(projectBotsDir(), `${name}.json`);
+    if (project)
+        return project;
+    return readOne(globalBotsDir(), `${name}.json`);
+}
+export function deleteBot(name, scope = 'project') {
+    assertValidName(name);
+    try {
+        fs.rmSync(botPath(scope === 'global' ? globalBotsDir() : projectBotsDir(), name));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/config/index.js

@@ -495,7 +495,7 @@ ${buildVoiceSection()}
 - Stop immediately when no more tools are needed; give conclusions directly.
 - **Do not stop prematurely during exploration**: if you started investigating but haven't gathered enough information to answer the user's question, keep calling tools. Only stop when you have sufficient evidence or hit a dead end.
 - **No flattery / no preamble in conclusions**: skip "Sure", "好的", "我已经完成了" and similar no-information prefixes — jump straight to substance.
-- Report honestly: say success when successful, say where you're stuck when failing, and mention anything skipped. Reference code in "path:line" format (e.g., src/index.ts:42). Keep it concise.
+- Close with a brief explanation of what you did and why, not just a verdict, so the user doesn't have to re-read the tool trace: when files changed, group them by file or logical change — what changed and the behavior/fix it delivers, one or two lines each with "path:line" references, noting renames/deletions and skipping purely mechanical edits; for investigation or analysis, state the conclusion and the key evidence. Say success when successful, where you're stuck when failing, and anything skipped. Keep it concise.
 - Definition of done: never declare a multi-feature request finished just because the code exists. Each distinct user request listed in the plan must be actually verified (the relevant check run / observed result), not merely implemented; mark plan steps \`[x]\` only after that verification. If the user supplied an acceptance list, every item on it must pass. Leave unverified items explicitly listed as pending instead of collapsing them into "done".`;
     // 动态段(置于末尾):AGENTS.md 项目记忆 + notepad 索引/说明。工具簇特定指导由
     // ToolPolicyController.reminder() 按当前 turn 的 route 注入，避免旧全局 profile 与真实 schema 分裂。
@@ -618,6 +618,7 @@ export const config = {
     llmKeysFromShell,
     permissionEnabled: process.env.MOCODE_PERMISSION !== 'false',
     permissionNonInteractiveAllow: process.env.MOCODE_PERMISSION_NON_INTERACTIVE_ALLOW === 'true',
+    notifyWebhook: process.env.MOCODE_NOTIFY_WEBHOOK || undefined,
 };
 /**
  * 创建一份独立 Config 快照，不重新读取环境变量、配置文件或 preset。

package/dist/headless.js

@@ -0,0 +1,302 @@
+// Headless（一次性 / 非交互）模式：mocode -p "任务" 或 echo "任务" | mocode。
+// 与 REPL 共用同一套装配（builtins 工具包 + MCP + runAgentCore），区别只在展示：
+// 没有全屏 TUI，正文流式写 stdout，进度写 stderr（保 stdout 可被管道解析）。
+//
+// 工具进度：默认每个调用打一行「[工具名] 关键参数」（summarizeToolCall，与 TUI
+// 同源；browser fill 等敏感值刻意不显示）。--verbose 追加工具结果摘要。
+//
+// 具名 Bot（C2）：--bot <name> 时用 Bot 的岗位提示作为角色前缀，并按其工具白名单
+// 过滤可调用工具（toolsOverride + runtimeAllowedToolNames，schema 即上限）。
+//
+// 隔离：--session-dir <path> 会话独立目录；--worktree 在 git detached worktree 中
+// 执行并自动销毁。两者走独立 Runtime（不碰全局单例）。
+//
+// 权限：非交互默认 fail-closed（permissions/index.ts 的 !isTTY 分支）。
+// --dangerously-skip-permissions 显式关闭权限闸。
+import path from 'node:path';
+import { setSandboxRoot } from './sandbox/root.js';
+import { registerToolsExtension } from './tools/registry.js';
+// 装配官方默认工具包：registry 不顶层 import builtins（破模块循环），入口须显式装配。
+import './tools/builtins/index.js';
+import { initializeAllMcp, getMcpTools, closeAllMcp } from './mcp/index.js';
+import { config, buildBasePrompt, isMemoryEnabled } from './config/index.js';
+import { effectiveSystemPrompt } from './skills/index.js';
+import { buildMemoryIndexSection } from './memory/store.js';
+import { defaultRuntime, Runtime } from './runtime/index.js';
+import { runAgentCore } from './agent/core.js';
+import { summarizeToolCall, summarizeToolResult } from './ui/render.js';
+import { getToolChatSchema } from './tools/policy.js';
+import { createWorktree, removeWorktree } from './jobs/worktree.js';
+import { runAsIdentity } from './bots/bus.js';
+import { createAsyncApprovalChecker } from './jobs/approval.js';
+import { writeCheckpoint, readCheckpoint } from './jobs/checkpoint.js';
+import { getBot } from './bots/store.js';
+/** 读取 stdin 全部内容作为 prompt（管道场景）。 */
+async function readStdin() {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    for await (const chunk of process.stdin)
+        data += chunk;
+    return data;
+}
+/**
+ * 解析 Bot：查记录、解析其沙箱范围、校验白名单。
+ * 返回 null 表示未使用 Bot；找不到 Bot 抛错（不静默用默认身份，避免误以为岗位生效）。
+ */
+function resolveBot(botName, baseSandbox) {
+    if (!botName)
+        return null;
+    const bot = getBot(botName);
+    if (!bot)
+        throw new Error(`bot "${botName}" not found (project .mocode/bots or global ~/.mocode/bots)`);
+    let sandboxRoot = baseSandbox;
+    if (bot.sandboxPath) {
+        // project bot 相对其工作区；global bot 相对当前 cwd。
+        const anchor = bot.scope === 'project' ? baseSandbox : process.cwd();
+        sandboxRoot = path.resolve(anchor, bot.sandboxPath);
+    }
+    return { bot, sandboxRoot };
+}
+/** 从工具目录按白名单构造 schema 集 + 允许名集合。 */
+function buildBotToolFilter(catalog, allowNames) {
+    const wanted = new Set(allowNames);
+    const toolsOverride = catalog
+        .filter((t) => wanted.has(t.name))
+        .map((t) => getToolChatSchema(t.name, catalog))
+        .filter((s) => s !== null);
+    return { toolsOverride, allowed: new Set(toolsOverride.map((s) => s.function.name)) };
+}
+export async function runHeadless(opts) {
+    const prompt = (opts.prompt ?? '').trim();
+    if (!prompt) {
+        process.stderr.write('mocode: empty prompt (use -p "..." or pipe via stdin)\n');
+        return 1;
+    }
+    if (opts.skipPermissions)
+        config.permissionEnabled = false;
+    // worktree 先建（失败明确报错，不静默回退主工作区）。
+    let wt = null;
+    if (opts.worktree) {
+        try {
+            wt = createWorktree();
+        }
+        catch (e) {
+            process.stderr.write(`mocode: worktree setup failed: ${e instanceof Error ? e.message : String(e)}\n`);
+            return 1;
+        }
+    }
+    const initialSandbox = wt?.path ?? opts.sandboxRootOverride ?? config.sandboxRoot ?? process.cwd();
+    // Bot 解析（在选沙箱之后：bot.sandboxPath 可进一步收窄）。
+    let botInfo;
+    try {
+        botInfo = resolveBot(opts.botName, initialSandbox);
+    }
+    catch (e) {
+        if (wt) {
+            try {
+                removeWorktree(wt);
+            }
+            catch {
+                // ignore
+            }
+        }
+        process.stderr.write(`mocode: ${e instanceof Error ? e.message : String(e)}\n`);
+        return 1;
+    }
+    const effectiveSandboxRoot = botInfo?.sandboxRoot ?? initialSandbox;
+    const isolated = wt !== null || opts.sessionDir !== undefined || opts.jobId !== undefined;
+    // MCP 先初始化注册：独立 Runtime 创建时复制当前 builtinTools（含 MCP），须早于 new Runtime。
+    await initializeAllMcp();
+    registerToolsExtension('mcp', getMcpTools());
+    let runtime;
+    if (isolated) {
+        runtime = new Runtime({
+            sandboxRoot: effectiveSandboxRoot,
+            ...(opts.sessionDir ? { configOverrides: { sessionDir: path.resolve(opts.sessionDir) } } : {}),
+            // bg job：注入异步审批 checker（命中需授权动作时挂起，等 mocode approve）。
+            ...(opts.jobId
+                ? {
+                    services: {
+                        checkPermission: createAsyncApprovalChecker({
+                            jobId: opts.jobId,
+                            sandboxRoot: effectiveSandboxRoot,
+                            getPrompt: () => prompt,
+                        }),
+                    },
+                }
+                : {}),
+        });
+    }
+    else {
+        setSandboxRoot(effectiveSandboxRoot);
+        runtime = defaultRuntime;
+    }
+    await runtime.start();
+    const sessionId = runtime.session.create();
+    // Bot 工具白名单：从该 runtime 实际工具目录过滤。
+    let toolFilter = null;
+    if (botInfo?.bot.tools && botInfo.bot.tools.length) {
+        toolFilter = buildBotToolFilter(runtime.context.toolRuntime.tools, botInfo.bot.tools);
+        if (toolFilter.toolsOverride.length === 0) {
+            process.stderr.write('mocode: bot tool whitelist matched no available tools\n');
+            await runtime.close();
+            if (wt) {
+                try {
+                    removeWorktree(wt);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            return 1;
+        }
+    }
+    // 系统提示：Bot 岗位角色在前，基础约定在后；白名单存在时补一句工具边界。
+    const baseConventions = buildBasePrompt(sessionId) + buildMemoryIndexSection(isMemoryEnabled());
+    const systemContent = botInfo
+        ? `# Role\n${botInfo.bot.systemPrompt}\n\n` +
+            `${botInfo.bot.description ? `**Position:** ${botInfo.bot.description}\n\n` : ''}` +
+            `---\n\n${baseConventions}` +
+            (toolFilter ? `\n\n## Tool boundary\nOnly these tools are available: ${[...toolFilter.allowed].join(', ')}.` : '')
+        : baseConventions;
+    const history = [{ role: 'system', content: effectiveSystemPrompt(systemContent) }];
+    let resumedFromCheckpoint = false;
+    if (opts.resumeFromCheckpoint && opts.jobId) {
+        const snap = readCheckpoint(opts.jobId);
+        if (snap && snap.length) {
+            history.length = 0;
+            history.push(...snap);
+            resumedFromCheckpoint = true;
+        }
+        else {
+            process.stderr.write('mocode: no checkpoint to resume from\n');
+            await runtime.close();
+            return 1;
+        }
+    }
+    let textBuffer = '';
+    // D3 runaway guard (bg jobs only): hard wall-clock / token caps.
+    let jobSignal;
+    let jobGuard;
+    if (opts.jobId) {
+        const maxMs = Number(process.env.MOCODE_JOB_MAX_MS ?? 0);
+        const maxTokens = Number(process.env.MOCODE_JOB_MAX_TOKENS ?? 0);
+        if (maxMs > 0 || maxTokens > 0) {
+            const controller = new AbortController();
+            const state = { tokens: 0, maxTokens, controller, timer: undefined };
+            if (maxMs > 0)
+                state.timer = setTimeout(() => {
+                    process.stderr.write(`\n[guard] job exceeded ${maxMs}ms; aborting\n`);
+                    controller.abort();
+                }, maxMs);
+            jobGuard = state;
+            jobSignal = controller.signal;
+        }
+    }
+    const hooks = {
+        onLiveUsage: (u) => {
+            if (!jobGuard)
+                return;
+            jobGuard.tokens = Math.max(jobGuard.tokens, u.totalTokens);
+            if (jobGuard.maxTokens && jobGuard.tokens > jobGuard.maxTokens) {
+                process.stderr.write(`\n[guard] job exceeded ${jobGuard.maxTokens} tokens; aborting\n`);
+                jobGuard.controller?.abort();
+            }
+        },
+        onText: (delta) => {
+            textBuffer += delta;
+            if (!opts.json)
+                process.stdout.write(delta);
+        },
+        onToolHeader: (tc) => {
+            if (!opts.json && textBuffer && !textBuffer.endsWith('\n')) {
+                process.stdout.write('\n');
+                textBuffer += '\n';
+            }
+            process.stderr.write(`[${tc.name}] ${summarizeToolCall(tc.name, tc.arguments)}\n`);
+        },
+        onToolResult: (tc, output) => {
+            if (!opts.verbose)
+                return;
+            process.stderr.write(`  → ${summarizeToolResult(tc.name, output)}\n`);
+        },
+        ...(opts.jobId
+            ? {
+                onCheckpoint: (h) => writeCheckpoint(opts.jobId, h),
+            }
+            : {}),
+        onModelRetry: (info) => {
+            process.stderr.write(`[retry] model error (${info.code}), retry ${info.nextAttempt} in ${info.waitMs}ms\n`);
+        },
+    };
+    const startedAt = Date.now();
+    let exitCode = 0;
+    let result;
+    const invokeCore = () => runAgentCore({
+        history,
+        userInput: prompt,
+        hooks,
+        ...(jobSignal ? { signal: jobSignal } : {}),
+        runtimeContext: runtime.context,
+        ...(resumedFromCheckpoint ? { continueFromHistory: true } : {}),
+        ...(toolFilter ? { toolsOverride: toolFilter.toolsOverride, runtimeAllowedToolNames: toolFilter.allowed } : {}),
+    });
+    try {
+        result = opts.botName ? await runAsIdentity(opts.botName, () => invokeCore()) : await invokeCore();
+    }
+    finally {
+        if (jobGuard?.timer)
+            clearTimeout(jobGuard.timer);
+        try {
+            runtime.session.save(history, sessionId, [prompt], []);
+        }
+        catch {
+            // 落盘失败不覆盖主结果
+        }
+        closeAllMcp();
+        await runtime.close();
+        if (wt) {
+            try {
+                removeWorktree(wt);
+            }
+            catch {
+                process.stderr.write(`mocode: failed to remove worktree ${wt.path}（手动清理）\n`);
+            }
+        }
+    }
+    const elapsedMs = Date.now() - startedAt;
+    const finalText = result.finalText ?? (opts.json ? null : textBuffer);
+    if (opts.json) {
+        const payload = {
+            terminationReason: result.terminationReason,
+            text: finalText,
+            sessionId,
+            changedFiles: result.changedFiles ?? [],
+            usage: result.usage,
+            elapsedMs,
+            model: config.model,
+            ...(opts.botName ? { bot: opts.botName } : {}),
+        };
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+    }
+    else if (finalText && !textBuffer) {
+        process.stdout.write(finalText);
+    }
+    if (!opts.json && process.stdout.isTTY && finalText && !finalText.endsWith('\n'))
+        process.stdout.write('\n');
+    if (result.terminationReason === 'aborted')
+        exitCode = 130;
+    else if (result.terminationReason === 'max_steps' || !result.completed)
+        exitCode = 1;
+    return exitCode;
+}
+/** 无 -p 且 stdin 被重定向时，从 stdin 取 prompt；返回 null 表示无可用输入。 */
+export async function resolvePrompt(inlinePrompt) {
+    if (inlinePrompt !== undefined)
+        return inlinePrompt;
+    if (!process.stdin.isTTY) {
+        const piped = (await readStdin()).trim();
+        return piped || null;
+    }
+    return null;
+}