mocode-ai 1.2.8 → 1.2.9

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;

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

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

package/dist/tools/builtins/project-skill-update.js

@@ -1,102 +0,0 @@
-import { readProjectSkill, writeProjectSkillWithCompression, appendProjectSkillWithCompression, } from '../../project-skill/index.js';
-/**
- * 项目专属 Skill 更新工具。
- * 支持三种操作:
- *   - read: 读取当前 skill 内容
- *   - write: 全量覆盖(适合重构整个 skill)
- *   - append: 追加到末尾(适合发现新坑点/约定时增量更新)
- *
- * 使用场景:
- *   - 开发过程中发现项目特有的架构模式、命名约定
- *   - 踩坑后记录避坑指南
- *   - 总结项目关键决策和设计理由
- *   - 随着项目开发，skill 越来越了解项目，开发效率越来越高
- */
-export const projectSkillUpdateTool = {
-    name: 'project_skill_update',
-    description: 'Update the project-specific skill file (.mocode/project-skill.md). ' +
-        'Use this to record architectural patterns, naming conventions, common pitfalls, ' +
-        'and key decisions specific to this project. The skill persists across sessions and ' +
-        'is injected into the system prompt when MOCODE_PROJECT_SKILL=true. ' +
-        'Actions: "read" (view current content), "write" (replace all), "append" (add to end). ' +
-        '\n\n' +
-        '## Skill 维护指南\n' +
-        'Skill 专注 Snapshot 无法自动提供的洞察知识（why/how/gotchas）。Snapshot 已提供文件结构和静态文件内容——Skill 不要重复这些信息。\n' +
-        '\n' +
-        '**Skill 该写什么（Snapshot 不能替代的）**：\n' +
-        '- 设计决策的 why（为什么这样设计、取舍是什么）\n' +
-        '- 模块行为和职责描述（怎么工作、数据流、调用链）\n' +
-        '- 常见坑点和解决方案（踩过的坑、非直觉行为、边界条件）\n' +
-        '- 项目约定（命名规范、代码风格、测试策略）\n' +
-        '- 开发流程（构建/测试/部署命令及注意事项）\n' +
-        '- 关键 API 的使用限制和特殊行为\n' +
-        '\n' +
-        '**Skill 不该写什么（交给 Snapshot）**：\n' +
-        '- 文件列表和目录结构（Snapshot 自动扫描 src 树）\n' +
-        '- 静态文件内容摘要（依赖、编译器选项等 → package.json / tsconfig.json）\n' +
-        '\n' +
-        '**何时更新**：发现新架构模式、踩坑后总结、学到新约定、完成重要重构、用户纠正理解时。\n' +
-        '\n' +
-        '**注意事项**：\n' +
-        '- 内容长度不设硬上限，按项目实际复杂度完整记录有价值的信息\n' +
-        '- 写可操作的内容，避免空泛描述\n' +
-        '- 用具体路径和例子（不要写"有多个模块"，要写"src/agent 负责 agent 循环"）\n' +
-        '- 定期整理，删除过时和重复信息\n' +
-        '- 更新前建议先 `read` 看一下现有内容，避免重复。',
-    risk: 'safe',
-    parameters: {
-        type: 'object',
-        properties: {
-            action: {
-                type: 'string',
-                enum: ['read', 'write', 'append'],
-                description: 'Action to perform: "read" to view current content, "write" to replace all, "append" to add to end',
-            },
-            content: {
-                type: 'string',
-                description: 'Content to write or append (required for "write" and "append" actions, ignored for "read")',
-            },
-        },
-        required: ['action'],
-    },
-    execute: async (args, ctx) => {
-        const action = String(args.action ?? '').trim();
-        const content = String(args.content ?? '');
-        const signal = ctx?.signal;
-        switch (action) {
-            case 'read': {
-                const current = readProjectSkill();
-                if (!current) {
-                    return 'Project skill is empty or does not exist yet.';
-                }
-                return `Current project skill:\n\n${current}`;
-            }
-            case 'write': {
-                if (!content.trim()) {
-                    return 'Error: "write" action requires non-empty content parameter.';
-                }
-                const result = await writeProjectSkillWithCompression(content, 3, signal);
-                if (!result.ok) {
-                    return `Error: ${result.error}`;
-                }
-                return result.compressed
-                    ? 'Project skill updated successfully (full replacement, auto-compressed to fit limit).'
-                    : 'Project skill updated successfully (full replacement).';
-            }
-            case 'append': {
-                if (!content.trim()) {
-                    return 'Error: "append" action requires non-empty content parameter.';
-                }
-                const result = await appendProjectSkillWithCompression(content, 3, signal);
-                if (!result.ok) {
-                    return `Error: ${result.error}`;
-                }
-                return result.compressed
-                    ? 'Project skill updated successfully (appended, auto-compressed to fit limit).'
-                    : 'Project skill updated successfully (appended).';
-            }
-            default:
-                return `Error: Unknown action "${action}". Use "read", "write", or "append".`;
-        }
-    },
-};

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

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

package/dist/tools/builtins/run-command.d.ts

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

package/dist/tools/builtins/switch-mode.d.ts

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

package/dist/tools/builtins/switch-mode.js

@@ -1,44 +0,0 @@
-import { setAgentMode, getAgentMode } from '../../agent/mode.js';
-// ---------- switch_mode ----------
-export const switchModeTool = {
-    name: 'switch_mode',
-    description: [
-        'Switch agent mode between "plan" (read-only investigation) and "auto" (full tool execution).',
-        'Use to transition from planning to execution WITHIN THE SAME TURN: in plan, after presenting a plan, call switch_mode("auto") and continue — ONLY when the user asked for autonomous execution ("先 plan 再 auto" etc.).',
-        'If the user entered plan mode manually (/plan or Shift+Tab) for review, do NOT switch to auto — present the plan and STOP for approval.',
-    ].join(' '),
-    parameters: {
-        type: 'object',
-        properties: {
-            mode: {
-                type: 'string',
-                enum: ['auto', 'plan'],
-                description: 'Target mode: "plan" (read-only) or "auto" (full tools)',
-            },
-        },
-        required: ['mode'],
-    },
-    async execute(args) {
-        const target = String(args.mode);
-        if (target !== 'auto' && target !== 'plan') {
-            return `错误:mode 必须是 "auto" 或 "plan",收到 "${target}"`;
-        }
-        const prev = getAgentMode();
-        if (prev === target) {
-            return `已在 ${target} 模式,无需切换。`;
-        }
-        setAgentMode(target); // 触发 listener:repl 重写 history[0] 系统提示 + 刷状态行 modeTag
-        if (target === 'auto') {
-            return [
-                `已从 plan 切换到 auto 模式。`,
-                `写盘 / 命令 / 记忆写入工具(write_file / edit_file / run_command / memory_save / memory_update / memory_forget)现已恢复可用。`,
-                `请按你刚才产出的计划继续执行(同一轮内,无需重述计划)。`,
-            ].join('\n');
-        }
-        return [
-            `已从 auto 切换到 plan 模式(只读探查)。`,
-            `写盘 / 命令 / 记忆写入工具已禁用;只用 read_file / glob / grep / codegraph / web_search / web_fetch / use_skill / ask_human / memory_search / memory_list 探查。`,
-            `产出计划后 STOP 等用户审批,或(若用户要求自主执行)再调 switch_mode("auto") 续跑。`,
-        ].join('\n');
-    },
-};

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

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

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

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