mocode-ai 1.2.7 → 1.2.9

package/dist/skills/skill-improve.js

@@ -1,221 +0,0 @@
-// skill description 进化循环(自进化 Phase 1b)。
-//
-// 协议移植自 skill-creator 的 run_loop.py(调研见 docs/skill-self-evolution-research.md Part 1.2):
-//  - 分层切 train/holdout(默认 0.4)防过拟合
-//  - 每轮:LLM 读失败案例 → 提案新 description → 评测 → 接受门
-//  - 接受门(保守双条件):train 严格提升 且 holdout 不降;holdout 为空时退化为全集严格提升
-//  - 拒绝缓冲:被拒的候选记下来,后续提案明确告知「这些已试过且更差」,防重复打转
-//  - 迭代上限(默认 5);全程记录 history,返回最佳 description
-//
-// 安全边界(调研 Part 3):
-//  - 默认 dry-run(只打印不落盘);--apply 才写回 SKILL.md,且写前再显式确认一次
-//  - builtin skill 无磁盘载体,拒绝(入口在 skill-eval.loadSkillForEval)
-//  - 进化对象仅 description 一行;正文/脚本/执行面字段不在自动编辑范围
-//
-// 依赖:skill-eval.ts(评测引擎 + 纯函数)+ llm.chat(提案,单轮无工具)。
-import { readFileSync, writeFileSync } from 'node:fs';
-import { chat } from '../llm/index.js';
-import { runTriggerEval, splitTriggerSet, applyDescription, MAX_DESCRIPTION_CHARS, } from './skill-eval.js';
-/** 提案 LLM 的系统指令:确定性模板(不用 t(),保证跨语言可比、可单测断言)。 */
-export function buildImprovePrompt(skill, currentDescription, failingCases, rejected) {
-    const body = (skill.body ?? '').slice(0, 1500);
-    const failLines = failingCases
-        .map((c) => {
-        const expect = c.should_trigger ? 'SHOULD trigger' : 'should NOT trigger';
-        return `- "${c.query}" → ${expect}, actual trigger rate ${c.trigger_rate.toFixed(2)}`;
-    })
-        .join('\n');
-    const rejectedBlock = rejected.length
-        ? `\nThese descriptions were already tried and performed WORSE. Do not propose any of them or near-duplicates:\n${rejected
-            .map((d) => `- ${d}`)
-            .join('\n')}\n`
-        : '';
-    return [
-        `You are optimizing the frontmatter "description" field of an agent skill named "${skill.name}".`,
-        'The description is the ONLY text the model sees when deciding whether to trigger the skill.',
-        `The skill body (what it actually does) begins with:\n---\n${body}\n---`,
-        `Current description:\n${currentDescription}`,
-        'Test results with the current description (failures to fix):',
-        failLines,
-        rejectedBlock,
-        'Propose ONE improved description that makes the skill trigger for the SHOULD-trigger cases and stay silent for the should-NOT-trigger cases.',
-        'Rules:',
-        '- Output ONLY the description text, nothing else (no quotes, no "description:", no markdown).',
-        '- One line only, 100-400 characters.',
-        '- Write it as a routing rule: state WHAT it does and WHEN to use it (concrete triggers/phrases), not as documentation.',
-        '- Preserve the language of the current description (English stays English, Chinese stays Chinese).',
-    ].join('\n');
-}
-/**
- * 从 LLM 输出里提取候选 description(纯函数):
- * 去首尾空白 → 若以 "description:" 开头则剥掉 → 只取第一行 → 去配对引号 → 校验长度。
- * 非法(空 / 超长)返 null。
- */
-export function extractDescriptionProposal(text, maxChars = MAX_DESCRIPTION_CHARS) {
-    let t = (text ?? '').trim();
-    if (!t)
-        return null;
-    t = t.replace(/^description\s*[:：]\s*/i, '');
-    let first = t.split(/\r?\n/)[0].trim();
-    if (!first)
-        return null;
-    if (first.length >= 2 && (first[0] === '"' || first[0] === "'") && first[first.length - 1] === first[0]) {
-        first = first.slice(1, -1).trim();
-    }
-    if (!first || first.length > maxChars)
-        return null;
-    return first;
-}
-/** 接受门(纯函数):train 严格提升 且 holdout 不降;holdout 为空时全集严格提升。 */
-export function shouldAcceptCandidate(base, cand) {
-    const trainUp = cand.trainPass > base.trainPass;
-    if (!trainUp) {
-        return { accept: false, reason: `train 未提升 (${cand.trainPass}/${cand.trainTotal} ≤ ${base.trainPass}/${base.trainTotal})` };
-    }
-    if (base.holdoutPass === null || cand.holdoutPass === null) {
-        return { accept: true, reason: `train 提升且无 holdout(${base.trainPass}→${cand.trainPass})` };
-    }
-    if (cand.holdoutPass < base.holdoutPass) {
-        return { accept: false, reason: `holdout 回退 (${cand.holdoutPass} < ${base.holdoutPass}),过拟合 train` };
-    }
-    return { accept: true, reason: `train ${base.trainPass}→${cand.trainPass},holdout ${base.holdoutPass}→${cand.holdoutPass}(不降)` };
-}
-/** 把报告按 query 集合拆成 train / holdout 的分项(纯函数)。 */
-function partitionReport(report, trainQueries) {
-    const train = report.results.filter((r) => trainQueries.has(r.query));
-    const holdout = report.results.filter((r) => !trainQueries.has(r.query));
-    return {
-        trainPass: train.filter((r) => r.pass).length,
-        trainTotal: train.length,
-        holdoutPass: holdout.length ? holdout.filter((r) => r.pass).length : null,
-        holdoutTotal: holdout.length,
-    };
-}
-function failingCases(report) {
-    return report.results
-        .filter((r) => !r.pass)
-        .map((r) => ({ query: r.query, should_trigger: r.should_trigger, trigger_rate: r.trigger_rate }));
-}
-/** 调 LLM 提案一次(单轮、无工具、超时 abort)。失败抛错由调用方捕获。 */
-async function proposeDescription(prompt, timeoutMs, signal) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    // AbortSignal.any 需 Node ≥20;engines>=18,手动桥接外部 signal。
-    const externalAbort = () => controller.abort();
-    if (signal) {
-        if (signal.aborted)
-            controller.abort();
-        else
-            signal.addEventListener('abort', externalAbort, { once: true });
-    }
-    try {
-        const messages = [{ role: 'user', content: prompt }];
-        const res = await chat(messages, {}, controller.signal);
-        return extractDescriptionProposal(res.content ?? '');
-    }
-    finally {
-        clearTimeout(timer);
-        signal?.removeEventListener('abort', externalAbort);
-    }
-}
-/**
- * 进化主循环。evalSet 必须非空(调用方保证;无 evals 的 skill 在 CLI 层拒绝——
- * 「没验证门的 skill 禁止自动落盘」,调研共识 1)。
- */
-export async function runImproveLoop(skill, evalSet, opts = {}) {
-    const maxIterations = opts.maxIterations ?? 5;
-    const runsPerQuery = opts.runsPerQuery ?? 3;
-    const threshold = opts.threshold ?? 0.5;
-    const { train, holdout } = splitTriggerSet(evalSet, opts.holdout ?? 0.4, opts.seed ?? 42);
-    if (train.length === 0)
-        throw new Error('train 集为空:eval 集太小,无法进化(至少需要 2 条且覆盖触发/不触发)');
-    const trainQueries = new Set(train.map((t) => t.query));
-    const evalOpts = { runsPerQuery, threshold, timeoutMs: opts.timeoutMs, signal: opts.signal };
-    let baseDescription = skill.description;
-    let baseReport = await runTriggerEval(skill, baseDescription, evalSet, runsPerQuery, threshold, evalOpts);
-    let baseParts = partitionReport(baseReport, trainQueries);
-    const iterations = [];
-    const rejected = [];
-    let bestDescription = baseDescription;
-    let bestKey = [baseParts.trainPass, baseParts.holdoutPass ?? 0];
-    const earlyExit = () => baseParts.trainTotal > 0 &&
-        baseParts.trainPass === baseParts.trainTotal &&
-        (baseParts.holdoutPass === null || (baseParts.holdoutTotal > 0 && baseParts.holdoutPass === baseParts.holdoutTotal));
-    if (earlyExit()) {
-        opts.onIteration?.(0, maxIterations, '当前 description 在 train + holdout 全通过,无需进化。');
-    }
-    for (let iter = 1; iter <= maxIterations && !earlyExit(); iter++) {
-        opts.onIteration?.(iter, maxIterations, `第 ${iter}/${maxIterations} 轮:提案新 description…`);
-        const prompt = buildImprovePrompt(skill, baseDescription, failingCases(baseReport), rejected);
-        let candidate;
-        try {
-            candidate = await proposeDescription(prompt, opts.proposeTimeoutMs ?? 120_000, opts.signal);
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            opts.onIteration?.(iter, maxIterations, `提案失败(${msg.slice(0, 120)}),终止。`);
-            break;
-        }
-        if (!candidate || candidate === baseDescription) {
-            opts.onIteration?.(iter, maxIterations, '提案无效(空/超长/与当前相同),终止。');
-            break;
-        }
-        const candReport = await runTriggerEval(skill, candidate, evalSet, runsPerQuery, threshold, evalOpts);
-        const candParts = partitionReport(candReport, trainQueries);
-        const gate = shouldAcceptCandidate(baseParts, candParts);
-        const iteration = {
-            iteration: iter,
-            description: candidate,
-            trainPass: candParts.trainPass,
-            trainTotal: candParts.trainTotal,
-            holdoutPass: candParts.holdoutPass,
-            holdoutTotal: candParts.holdoutTotal,
-            accepted: gate.accept,
-            reason: gate.reason,
-        };
-        iterations.push(iteration);
-        opts.onIteration?.(iter, maxIterations, `${gate.accept ? '✓ 接受' : '· 拒绝'}: train ${candParts.trainPass}/${candParts.trainTotal}, holdout ${candParts.holdoutPass ?? '-'}/${candParts.holdoutTotal} — ${gate.reason}`);
-        if (gate.accept) {
-            baseDescription = candidate;
-            baseReport = candReport;
-            baseParts = candParts;
-            const key = [candParts.trainPass, candParts.holdoutPass ?? 0];
-            if (key[0] > bestKey[0] || (key[0] === bestKey[0] && key[1] > bestKey[1])) {
-                bestKey = key;
-                bestDescription = candidate;
-            }
-        }
-        else {
-            rejected.push(candidate);
-            if (rejected.length > 5)
-                rejected.shift();
-        }
-    }
-    return {
-        skill: skill.name,
-        originalDescription: skill.description,
-        bestDescription,
-        improved: bestDescription !== skill.description,
-        iterations,
-    };
-}
-/**
- * 把进化结果写回 SKILL.md 的 description(唯一的落盘点;CLI --apply 时才调)。
- * 返回写后的文件内容;frontmatter 无法安全替换时抛错(不落盘)。
- */
-export function applyImprovedDescription(skill, description) {
-    if (skill.dir === 'builtin')
-        throw new Error('内置 skill 不可修改');
-    if (description.length > MAX_DESCRIPTION_CHARS)
-        throw new Error(`description 超长(>${MAX_DESCRIPTION_CHARS})`);
-    const original = readFileSync(skill.skillMdPath, 'utf8');
-    const next = applyDescription(original, description);
-    if (next === null) {
-        throw new Error('无法定位 SKILL.md frontmatter 的 description 字段,拒绝写回(请手工编辑)');
-    }
-    if (next === original) {
-        throw new Error('写回无变化(description 与当前一致)');
-    }
-    writeFileSync(skill.skillMdPath, next, 'utf8');
-    return next;
-}

package/dist/skills/stats.js

@@ -1,102 +0,0 @@
-// skill 使用台账(自进化 Phase 0)。
-// 为什么不在 trace.jsonl 上做:工具事件出于隐私只存参数指纹(sha256/keys,
-// trace-sanitize.ts 刻意不存值),拿不到 skill name。台账因此在工具层直接记录——
-// use_skill / run_skill 是唯一知道真实 skill name 的落点。
-//
-// 落盘:<cwd>/.mocode/skill-stats.jsonl(append-only JSONL,每行一次使用)。
-// 纯观测:任何写失败静默吞掉,绝不阻断 agent 主流程(风格对齐 session/trace.ts)。
-// 聚合是纯函数(aggregateSkillStats),吃记录数组吐按 skill 的计数,便于单测。
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-/**
- * 台账路径(项目级,与 sessions 同根;使用是项目上下文相关的,不写全局)。
- * baseDir 可选:测试指向临时目录用;缺省 process.cwd()。
- */
-export function skillStatsPath(baseDir = process.cwd()) {
-    return path.join(baseDir, '.mocode', 'skill-stats.jsonl');
-}
-/**
- * 追加一条台账记录;任何失败静默(观测不得阻断主流程)。
- * MOCODE_SKILL_EVAL=1(触发评测进程内设置)时跳过:评测里的人工构造调用
- * 是测量手段不是真实使用,记入会污染自进化的输入信号。
- */
-export function recordSkillUsage(rec, baseDir = process.cwd()) {
-    if (process.env.MOCODE_SKILL_EVAL === '1')
-        return;
-    try {
-        const p = skillStatsPath(baseDir);
-        const dir = path.dirname(p);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        appendFileSync(p, JSON.stringify(rec) + '\n', 'utf8');
-    }
-    catch {
-        // 观测失败静默
-    }
-}
-/** 读取台账原始记录;文件不存在 / 单行损坏 → 跳过(不抛)。 */
-export function loadSkillUsage(baseDir = process.cwd()) {
-    try {
-        const content = readFileSync(skillStatsPath(baseDir), 'utf8');
-        const out = [];
-        for (const line of content.split('\n')) {
-            const s = line.trim();
-            if (!s)
-                continue;
-            try {
-                const v = JSON.parse(s);
-                if (v && typeof v.skill === 'string' && (v.kind === 'use' || v.kind === 'run')) {
-                    out.push(v);
-                }
-            }
-            catch {
-                // 损坏行跳过
-            }
-        }
-        return out;
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * 纯聚合:记录 → 按 skill 的计数视图。按 skill 名分组(大小写敏感),
- * lastUsedAt 取 ts 字符串字典序最大(ISO 时间戳字典序 == 时间序)。
- * 输入乱序也安全。空输入返回 []。
- */
-export function aggregateSkillStats(records) {
-    const bySkill = new Map();
-    for (const r of records) {
-        const list = bySkill.get(r.skill);
-        if (list)
-            list.push(r);
-        else
-            bySkill.set(r.skill, [r]);
-    }
-    const out = [];
-    for (const [skill, list] of bySkill) {
-        const runs = list.filter((r) => r.kind === 'run');
-        const runSuccess = runs.filter((r) => r.status === 'success').length;
-        let lastFailure = null;
-        let lastUsedAt = '';
-        for (const r of list) {
-            if (typeof r.ts === 'string' && r.ts > lastUsedAt)
-                lastUsedAt = r.ts;
-            if (r.status !== 'success' && (!lastFailure || r.ts > lastFailure.ts)) {
-                lastFailure = { ts: r.ts, status: r.status, code: r.code };
-            }
-        }
-        out.push({
-            skill,
-            total: list.length,
-            uses: list.length - runs.length,
-            runs: runs.length,
-            runSuccessRate: runs.length ? runSuccess / runs.length : null,
-            lastFailure,
-            lastUsedAt,
-        });
-    }
-    // 按最近使用倒序,让 /skills 徽标与人工浏览都「最活跃的在前」。
-    out.sort((a, b) => (a.lastUsedAt < b.lastUsedAt ? 1 : a.lastUsedAt > b.lastUsedAt ? -1 : 0));
-    return out;
-}

package/dist/tools/builtins/apply-patch.js

@@ -1,174 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { jailResolve } from '../../sandbox/index.js';
-import { commitChangeSet, contentHash, createChangeSet, summarizeChangeSet, } from '../../changeset/index.js';
-function invalid(message) {
-    const error = new Error(message);
-    error.name = 'PatchError';
-    return error;
-}
-function parsePatch(input) {
-    const lines = input.replace(/\r\n/g, '\n').split('\n');
-    if (lines[0] !== '*** Begin Patch')
-        throw invalid('patch 必须以 *** Begin Patch 开始。');
-    const operations = [];
-    let i = 1;
-    while (i < lines.length && lines[i] !== '*** End Patch') {
-        const header = lines[i++];
-        let match = /^\*\*\* Add File: (.+)$/.exec(header);
-        if (match) {
-            const body = [];
-            while (i < lines.length && !lines[i].startsWith('*** ')) {
-                const line = lines[i++];
-                if (!line.startsWith('+'))
-                    throw invalid(`Add File ${match[1]} 的内容行必须以 + 开头。`);
-                body.push(line.slice(1));
-            }
-            operations.push({ kind: 'add', path: match[1], lines: body });
-            continue;
-        }
-        match = /^\*\*\* Delete File: (.+)$/.exec(header);
-        if (match) {
-            operations.push({ kind: 'delete', path: match[1] });
-            continue;
-        }
-        match = /^\*\*\* Update File: (.+)$/.exec(header);
-        if (!match)
-            throw invalid(`未知 patch 指令: ${header}`);
-        const hunks = [];
-        while (i < lines.length && !lines[i].startsWith('*** ')) {
-            if (!lines[i].startsWith('@@'))
-                throw invalid(`Update File ${match[1]} 缺少 @@ hunk。`);
-            i++;
-            const hunk = [];
-            while (i < lines.length && !lines[i].startsWith('@@') && !lines[i].startsWith('*** ')) {
-                hunk.push(lines[i++]);
-            }
-            hunks.push(hunk);
-        }
-        operations.push({ kind: 'update', path: match[1], hunks });
-    }
-    if (lines[i] !== '*** End Patch')
-        throw invalid('patch 缺少 *** End Patch。');
-    if (operations.length === 0)
-        throw invalid('patch 不包含文件操作。');
-    return operations;
-}
-function applyHunks(source, hunks, file) {
-    let current = source.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-    for (const hunk of hunks) {
-        const before = [];
-        const after = [];
-        for (const line of hunk) {
-            if (line.startsWith(' ')) {
-                before.push(line.slice(1));
-                after.push(line.slice(1));
-            }
-            else if (line.startsWith('-')) {
-                before.push(line.slice(1));
-            }
-            else if (line.startsWith('+')) {
-                after.push(line.slice(1));
-            }
-            else if (line === '\') {
-                continue;
-            }
-            else {
-                throw invalid(`Update File ${file} 的 hunk 行必须以空格、+ 或 - 开头。`);
-            }
-        }
-        const oldText = before.join('\n');
-        const newText = after.join('\n');
-        if (!oldText)
-            throw invalid(`Update File ${file} 的 hunk 缺少上下文或删除行。`);
-        const first = current.indexOf(oldText);
-        if (first < 0)
-            throw invalid(`Update File ${file} 的 hunk 与当前文件不匹配。`);
-        if (current.indexOf(oldText, first + 1) >= 0) {
-            throw invalid(`Update File ${file} 的 hunk 上下文不唯一，请增加上下文。`);
-        }
-        current = current.slice(0, first) + newText + current.slice(first + oldText.length);
-    }
-    return source.includes('\r\n') ? current.replace(/\n/g, '\r\n') : current;
-}
-async function buildChanges(operations) {
-    const changes = [];
-    for (const operation of operations) {
-        if (operation.kind === 'add') {
-            changes.push({
-                path: operation.path,
-                operation: 'create',
-                expectedHash: null,
-                replacement: operation.lines.join('\n'),
-            });
-            continue;
-        }
-        const raw = await readFile(jailResolve(operation.path));
-        const expectedHash = contentHash(raw);
-        if (operation.kind === 'delete') {
-            changes.push({ path: operation.path, operation: 'delete', expectedHash });
-            continue;
-        }
-        const source = raw.toString('utf8');
-        changes.push({
-            path: operation.path,
-            operation: 'update',
-            expectedHash,
-            replacement: applyHunks(source, operation.hunks, operation.path),
-        });
-    }
-    return changes;
-}
-function conflictOutcome(result) {
-    return {
-        status: 'error',
-        code: 'CHANGE_CONFLICT',
-        retryable: false,
-        changedFiles: [],
-        staleFiles: result.conflicts.map((item) => item.path),
-        output: [
-            '错误:apply_patch 检测到内容冲突，磁盘未发生变化。',
-            ...result.conflicts.map((item) => `- ${item.path}: expected=${item.expectedHash ?? 'missing'}, actual=${item.actualHash ?? 'missing'} (${item.reason})`),
-        ].join('\n'),
-    };
-}
-export const applyPatchTool = {
-    name: 'apply_patch',
-    description: 'Apply a multi-file patch transactionally. Format: *** Begin Patch, then *** Add/Update/Delete File sections, then *** End Patch. All files are dry-run and hash-checked before any file is committed; failure leaves disk unchanged.',
-    risk: 'confirm',
-    parameters: {
-        type: 'object',
-        properties: {
-            patch: { type: 'string', description: 'The complete *** Begin Patch ... *** End Patch document.' },
-        },
-        required: ['patch'],
-    },
-    async execute(args, ctx) {
-        try {
-            const changes = await buildChanges(parsePatch(String(args.patch)));
-            const result = await commitChangeSet(createChangeSet(changes), ctx?.signal);
-            if (result.status === 'conflict')
-                return conflictOutcome(result);
-            if (result.status === 'failed') {
-                return { status: 'error', code: 'PATCH_INVALID', retryable: false, changedFiles: [], output: `错误:apply_patch 提交失败，已恢复磁盘: ${result.error}` };
-            }
-            const summary = summarizeChangeSet(result.changeSet);
-            return {
-                status: 'success',
-                code: 'OK',
-                retryable: false,
-                changedFiles: result.changedFiles,
-                changeSet: summary,
-                output: `已事务化应用 ChangeSet ${summary.id}:\n${summary.changes.map((item) => `- ${item.operation} ${item.path} (${item.beforeHash ?? 'missing'} -> ${item.afterHash ?? 'missing'})`).join('\n')}`,
-            };
-        }
-        catch (error) {
-            return {
-                status: 'error',
-                code: 'PATCH_INVALID',
-                retryable: false,
-                changedFiles: [],
-                output: `错误:apply_patch 无效，磁盘未发生变化: ${error instanceof Error ? error.message : String(error)}`,
-            };
-        }
-    },
-};

package/dist/tools/builtins/ask-human.d.ts

@@ -1,9 +0,0 @@
-import type { Tool } from '../types.js';
-/** 单个选项:label 是选项本身,detail 是选它意味着什么/取舍(可选)。 */
-export interface ChoiceOption {
-    label: string;
-    detail?: string;
-}
-/** 公开以便 check-ask-human-options.ts 单元测试。 */
-export declare function coerceOptions(raw: unknown): ChoiceOption[];
-export declare const askHumanTool: Tool;

package/dist/tools/builtins/codegraph.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const codegraphTool: Tool;

package/dist/tools/builtins/codegraph.js

@@ -1,128 +0,0 @@
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { MAX_OUTPUT } from '../constants.js';
-// ---------- codegraph ----------
-// 已建代码索引(.codegraph/)的仓库里,理解/定位代码、查调用链、看改动影响面时
-// 的首选工具。比逐文件 read_file/grep 拼凑更准更省。
-// 检查 .codegraph/ 是否存在:不存在则提示建索引,不盲目调 CLI(避免报错噪音)。
-/** 同步判断当前 cwd 是否已建 codegraph 索引。 */
-function hasCodegraphIndex() {
-    return existsSync(path.join(process.cwd(), '.codegraph'));
-}
-/** 跑 codegraph CLI 子进程,返回合并 stdout+stderr(带退出码),超时 60s。
- *  signal 透传(用户 Ctrl+C)→ 即时杀子进程,不等 60s 超时。 */
-function runCodegraph(args, signal) {
-    return new Promise((done) => {
-        const isWin = process.platform === 'win32';
-        // win32 必须走 cmd.exe /c:Node 自 CVE-2024-27980 修复后,shell:false 直接 spawn
-        // .cmd/.bat 会抛 EINVAL;cmd.exe 是真二进制,直接 spawn 安全(与 run_command 同约定)。
-        const child = isWin
-            ? spawn('cmd.exe', ['/c', 'codegraph', ...args], { cwd: process.cwd() })
-            : spawn('codegraph', args, { cwd: process.cwd() });
-        let out = '';
-        let finished = false;
-        const finish = (s) => {
-            if (finished)
-                return;
-            finished = true;
-            clearTimeout(timer);
-            signal?.removeEventListener('abort', onAbort);
-            done(s);
-        };
-        const onChunk = (chunk) => {
-            if (out.length < MAX_OUTPUT)
-                out += chunk.toString('utf8');
-        };
-        child.stdout.on('data', onChunk);
-        child.stderr.on('data', onChunk);
-        child.on('error', (e) => finish(`codegraph 执行失败(可能未安装或不在 PATH): ${e.message}\n` +
-            '安装: npm i -g @colbymchenry/codegraph'));
-        child.on('close', (code) => {
-            let r = out.trim();
-            if (out.length >= MAX_OUTPUT)
-                r += '\n...(输出已截断)';
-            finish(`[退出码 ${code}]\n${r || '(无输出)'}`);
-        });
-        const timer = setTimeout(() => {
-            child.kill();
-            finish(`[超时,已终止]\n${out.trim()}`);
-        }, 60000);
-        // abort(用户 Ctrl+C,经 executeTool ctx.signal 透传)→ 杀子进程 + 返[已中断]
-        const onAbort = () => {
-            child.kill();
-            finish(`[已中断]\n${out.trim()}`);
-        };
-        if (signal) {
-            if (signal.aborted)
-                onAbort();
-            else
-                signal.addEventListener('abort', onAbort, { once: true });
-        }
-    });
-}
-export const codegraphTool = {
-    name: 'codegraph',
-    description: 'FIRST CHOICE for understanding/locating code, tracing call chains, or assessing the impact of changes — use this before read_file/grep when a .codegraph/ index exists.' +
-        ' Returns symbol source + call paths in one shot — more accurate and economical than piecing together read_file/grep.' +
-        ' When to use: starting any code exploration; locating a symbol; understanding how a feature works; seeing what calls a function or what a change affects.' +
-        ' When NOT to use: no .codegraph/ index (build it first with `codegraph init`); reading a file you just edited; editing a single known small file — in those cases go straight to read_file/edit_file; or the symbol/area was already retrieved earlier in this session — reuse that result instead of calling again.' +
-        ' Fallback: if codegraph misses or the result is incomplete, then use read_file/grep/glob to fill the gaps.',
-    parameters: {
-        type: 'object',
-        properties: {
-            action: {
-                type: 'string',
-                enum: ['explore', 'node'],
-                description: "explore=fetch relevant source + call paths by question/symbol (use when understanding a feature/architecture);" +
-                    "node=look up a single symbol's source + callers/callees, or read a file + dependencies (use when locating a specific symbol)",
-            },
-            query: {
-                type: 'string',
-                description: 'explore: the question or symbol name to investigate (e.g. "runAgent" or "how history is compacted").' +
-                    'node: symbol name (e.g. runAgent) or file path (used with file mode)',
-            },
-            file: {
-                type: 'string',
-                description: 'node only: treat query as a file path to read (file mode), or disambiguate to a specific file',
-            },
-            offset: {
-                type: 'integer',
-                description: 'node file mode only: start line (1-based)',
-            },
-            limit: {
-                type: 'integer',
-                description: 'node file mode only: max number of lines',
-            },
-        },
-        required: ['action', 'query'],
-    },
-    async execute(args, ctx) {
-        if (!hasCodegraphIndex()) {
-            return ('当前目录无 .codegraph/ 索引。codegraph 工具不可用。\n' +
-                '建索引:运行 `codegraph init`(需要 codegraph CLI:`npm i -g @colbymchenry/codegraph`)。\n' +
-                '在此之前,可改用 read_file / grep / glob 探索代码。');
-        }
-        const action = String(args.action);
-        const query = String(args.query);
-        const cliArgs = [];
-        if (action === 'explore') {
-            // explore 接 <query...> 多 token,拆分后逐个 push
-            cliArgs.push('explore', ...query.split(/\s+/).filter(Boolean));
-        }
-        else if (action === 'node') {
-            cliArgs.push('node', query);
-            const file = args.file ? String(args.file) : '';
-            if (file)
-                cliArgs.push('--file', file);
-            if (args.offset !== undefined)
-                cliArgs.push('--offset', String(args.offset));
-            if (args.limit !== undefined)
-                cliArgs.push('--limit', String(args.limit));
-        }
-        else {
-            return `错误:未知 action "${action}",可选 explore 或 node。`;
-        }
-        return runCodegraph(cliArgs, ctx?.signal);
-    },
-};

package/dist/tools/builtins/edit-file.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const editFileTool: Tool;

package/dist/tools/builtins/glob.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const globTool: Tool;

package/dist/tools/builtins/grep.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const grepTool: Tool;

package/dist/tools/builtins/index.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const builtinTools: Tool[];

package/dist/tools/builtins/memory-forget.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const memoryForgetTool: Tool;

package/dist/tools/builtins/memory-list.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const memoryListTool: Tool;

package/dist/tools/builtins/memory-save.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const memorySaveTool: Tool;

package/dist/tools/builtins/memory-search.d.ts

@@ -1,2 +0,0 @@
-import type { Tool } from '../types.js';
-export declare const memorySearchTool: Tool;