mocode-ai 1.2.8 → 1.2.9

package/dist/agent/mode.d.ts

@@ -1,29 +0,0 @@
-/**
- * agent 模式的共享状态(零依赖纯叶子)。
- *
- * 把 `agentMode` 从 repl 的模块变量提到这里,让三方都能用、且不破坏依赖单向:
- *  - `tools/builtins/switch-mode.ts` 写它(setAgentMode)——LLM 在 agent 循环里自切 plan↔auto。
- *  - `agent/index.ts` 每步读它(getAgentMode)——决定 chat() 用全量 chatTools 还是 planChatTools 只读子集,
- *    以及串行分支的 plan 防御 backstop。这样 LLM 中途切模式后,下一次 chat() 立即看到新工具集。
- *  - `repl/index.ts` 读写它 + 注册 onModeChange 监听器(做 applyMode 重写 history[0] + refreshStatusBase
- *    刷状态行 modeTag)。
- *
- * 依赖方向无环:本模块不 import 任何业务模块。`agent/index → tools/registry → tools/builtins/switch-mode
- * → agent/mode` 链终点是本叶子,不回到 agent/index。`tools → agent/mode` 与既有 `tools → ui`(ask-human)、
- * `tools → rollback`(registry)同性质——都是引叶子。
- *
- * listener 同步触发:setAgentMode 在变更模式后同步调 listener(无 async)。switch_mode 工具在 executeTool
- * 内调 setAgentMode → listener 同步 applyMode(重写 history[0])+ refreshStatusBase;execute 返回字符串后,
- * agent 串行分支继续,下一步 chat() 读到新模式 + 新系统提示,一致。
- */
-export type AgentMode = 'auto' | 'plan';
-/** 当前 agent 模式。auto=全工具执行;plan=只读探查 + 产出计划(写盘/命令/记忆写入工具被 schema 剔除)。 */
-export declare function getAgentMode(): AgentMode;
-/**
- * 设置 agent 模式。同模式 no-op(不触发 listener)。变更时同步触发 onModeChange 注册的监听器
- * (repl 在 startRepl 注册:applyMode 重写 history[0] + refreshStatusBase 刷状态行)。
- * 返回之前的模式,供调用方(如 runAgent 中断恢复)还原。
- */
-export declare function setAgentMode(m: AgentMode): AgentMode;
-/** 注册模式变更监听器(单一,后注册覆盖先注册)。repl 在 startRepl 启动时注册一次。 */
-export declare function onModeChange(cb: (m: AgentMode) => void): void;

package/dist/agent/retry-classifier.js

@@ -1,64 +0,0 @@
-// RETRY-01: 错误反思分类器。
-//
-// 在 tools/retry.ts 之上叠加一层"反思"语义:把每个 ToolOutcomeCode 映射到
-// 一个 ErrorCategory,供 (a) PROMPT 反思 prompt 注入、(b) QUAL-01 trace 指标。
-//
-// 设计要点:
-// - 纯映射函数,无副作用 → 易测,易扩展(新 code → 改一处)。
-// - 6 类对齐路线图 L163:`TRANSIENT_RATE_LIMIT` / `TRANSIENT_TIMEOUT` /
-//   `INVALID_ARGUMENTS` / `PERMISSION_DENIED` / `CONFLICT` / `UNKNOWN_FAILURE`。
-// - 提供"反思指针"模板(reflectionHint),与 PROMPT-01 hard rule
-//   / PROMPT-02 checklist 共用同一套"先想清楚再动"语言,避免新造话。
-// - 不**决策**重试与否(`shouldRetry` 在 tools/retry.ts 已经稳定;本次不动),
-//   只**注解**每个错误"该反思什么"。
-/** code → category 的稳定映射。fixture 直接断言(避免漏改)。 */
-const CODE_TO_CATEGORY = {
-    OK: 'UNKNOWN_FAILURE', // OK 不该走到这里;归 UNKNOWN 是为了编译期不漏。
-    // rate-limit / timeout / network
-    TIMEOUT: 'TRANSIENT_TIMEOUT',
-    HTTP_ERROR: 'TRANSIENT_RATE_LIMIT', // 4xx/5xx 中除 408/429 之外的 5xx 视为 rate-limit 语义
-    NETWORK_ERROR: 'TRANSIENT_TIMEOUT', // 网络层错(ECONNRESET 等)→ 与 timeout 同类反思
-    // 参数 / schema(模型自己改,不是 retry 自己改)
-    INVALID_JSON: 'INVALID_ARGUMENTS',
-    INVALID_ARGUMENTS: 'INVALID_ARGUMENTS',
-    INVALID_TOOL_SCHEMA: 'INVALID_ARGUMENTS',
-    UNKNOWN_TOOL: 'INVALID_ARGUMENTS', // 调用了不存在的工具 → 模型改 tool name
-    // 权限 / 沙箱 / 模式(永久拒绝)
-    SANDBOX_DENIED: 'PERMISSION_DENIED',
-    PERMISSION_DENIED: 'PERMISSION_DENIED',
-    TOOL_DISABLED: 'PERMISSION_DENIED',
-    MODE_DENIED: 'PERMISSION_DENIED',
-    ABORTED: 'PERMISSION_DENIED', // 用户主动 abort,与 permission 同类(无 retry 价值)
-    // 冲突 / 写失败(retry 之前必须重新读)
-    EDIT_CONFLICT: 'CONFLICT',
-    CHANGE_CONFLICT: 'CONFLICT',
-    PATCH_INVALID: 'CONFLICT',
-    POSTCONDITION_FAILED: 'CONFLICT',
-    PROCESS_FAILED: 'CONFLICT',
-    // 兜底
-    EXECUTION_ERROR: 'UNKNOWN_FAILURE',
-    MCP_ERROR: 'UNKNOWN_FAILURE',
-};
-export function classifyError(code) {
-    return CODE_TO_CATEGORY[code];
-}
-/** 反思指针:每类错误给 LLM 一句"反思什么"的话。 */
-const REFLECTION_HINTS = {
-    TRANSIENT_RATE_LIMIT: 'The remote is throttling or returned 5xx. Re-running the same call with identical arguments is unlikely to help — wait, downgrade call frequency, or reduce request size; do not retry the same args in tight loop.',
-    TRANSIENT_TIMEOUT: 'A network or process timeout occurred. Re-running the same call may help once, but if it fails again with identical args, the path/host/argument is wrong; switch tool, reduce scope, or ask the user.',
-    INVALID_ARGUMENTS: 'The tool rejected the call shape (JSON / schema / unknown tool). Read the tool description again and fix the arguments yourself; do not resend the same call and do not retry automatically — only the model can fix argument shape.',
-    PERMISSION_DENIED: 'The call was denied (sandbox / permission / disabled / mode). Retry will not help; surface the constraint to the user and ask for guidance or a permission grant.',
-    CONFLICT: 'A write/patch conflicted with the on-disk state. Do not resend the same args; re-read the file or change target, then re-derive the diff. If the conflict is structural, the plan itself is wrong — go back to the spec.',
-    UNKNOWN_FAILURE: 'An unclassified error occurred. Do not retry blindly; capture the message, re-read the tool description, and decide whether the same call with a smaller scope or a different tool is appropriate. If unsure, ask the user.',
-};
-export function reflectionHint(category) {
-    return REFLECTION_HINTS[category];
-}
-/**
- * 一站式:对 ToolOutcome 给出"反思 category + 反思 hint"。
- * 调用方一般是 tools/retry.ts 的 onRetry hook,把 hint 注入 retry 提示尾部。
- */
-export function reflectOn(code) {
-    const category = classifyError(code);
-    return { category, hint: reflectionHint(category) };
-}

package/dist/agent/spawn.d.ts

@@ -1,36 +0,0 @@
-/** 子 agent 运行选项。 */
-export interface SpawnOptions {
-    /** 子任务指令(作为子 agent 的 user 消息)。 */
-    prompt: string;
-    /** 附加系统提示(角色/约束),拼在 SUBAGENT_SUFFIX 后。 */
-    systemPromptSuffix?: string;
-    /** 允许的工具名白名单(可选)。无 = 全量工具;给则从 chatTools 过滤。 */
-    tools?: string[];
-    /** 步数上限(可选,默认 config.subAgentMaxSteps ?? 50)。 */
-    maxSteps?: number;
-    /** 主 agent 的 abort signal(可选)。透传给子 runAgentCore → chat/executeTool,
-     *  主 Ctrl+C 树杀子 agent(chat 流式 abort + run_command/web_fetch 即时取消)。 */
-    signal?: AbortSignal;
-}
-/** 子 agent 运行结果。 */
-export interface SpawnResult {
-    /** 子 agent 最终文本回复;中断或无回复为 null。 */
-    summary: string | null;
-    /** 正常完毕 true;中断 false。 */
-    completed: boolean;
-    /** 子 agent 中间过程的人类可读日志(工具调用 + 结果摘要 + 流式正文片段)。主 agent 通常不看,调试用。 */
-    transcript: string;
-}
-/**
- * 派生一个子 agent 执行独立子任务。
- *
- * 行为:
- *  - 构造独立 history:[{system: 主系统提示 + SUBAGENT_SUFFIX + 自定义后缀}, {user: prompt}]
- *  - 工具子集:按 opts.tools 白名单过滤 chatTools;无白名单 = 全量。
- *  - 静默 hooks:流式正文 / 工具头 / 结果缓冲到 transcript;不写主屏(layout)。
- *  - 返回 { summary, completed, transcript }。summary 给 task 工具回灌主 history。
- *
- * 中断:opts.signal 透传给子 runAgentCore——主 Ctrl+C 树杀子 agent(chat abort + 工具 abort)。
- * 子 agent 跑在主 signal 下,主 abort 即子 abort;子 agent 的 abortRestore 还原子 history + 模式。
- */
-export declare function spawnAgent(opts: SpawnOptions): Promise<SpawnResult>;

package/dist/attachments/image.d.ts

@@ -1,22 +0,0 @@
-export type ImageMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
-export interface ImageAttachment {
-    id: string;
-    path: string;
-    name: string;
-    bytes: number;
-    mime: ImageMime;
-    dataUrl: string;
-}
-export declare const MAX_INLINE_BYTES_DEFAULT: number;
-export declare function detectMime(p: string): ImageMime | null;
-export declare function renderChip(att: ImageAttachment): string;
-export type LoadImageResult = {
-    ok: true;
-    att: ImageAttachment;
-} | {
-    ok: false;
-    reason: string;
-};
-export declare function loadImageAttachment(input: string, opts: {
-    maxBytes: number;
-}): Promise<LoadImageResult>;

package/dist/commands/config.d.ts

@@ -1,8 +0,0 @@
-/**
- * 首跑配置向导:交互填 LLM_BASE_URL / LLM_API_KEY / LLM_MODEL,写 ~/.mocode/config。
- * 只交互三键、保留文件里其它键(MAX_TOKENS / CONTEXT_WINDOW_TOKENS / MOCODE_THEME 等)。
- * prompt 全纯文本(readline 光标按字符算,不能含 ANSI)。
- * 由 index.ts 在 `mocode config` 时动态加载,故不 import config/index.ts(避免触发 config 单例初始化 / loadEnvFiles,
- * 直接退出);只 import config/file.ts(纯 I/O 叶子,无 env 校验 / process.exit)。
- */
-export declare function runConfigWizard(): Promise<void>;

package/dist/commands/skill.js

@@ -1,230 +0,0 @@
-// `mocode skill` CLI 子命令(skill 自进化 Phase 0/1 的用户入口)。
-//
-//   mocode skill eval <name> [--runs N] [--threshold x] [--timeout ms]
-//       触发评测:对 <skill-dir>/evals/trigger.json 的每条 query 跑单轮 agent,
-//       统计 use_skill/run_skill 触发率,输出 PASS/FAIL 报告并落盘 JSON。
-//
-//   mocode skill improve <name> [--runs N] [--threshold x] [--iterations N]
-//                     [--holdout x] [--timeout ms] [--apply]
-//       description 进化循环:train/holdout 切分 + LLM 提案 + 接受门,默认 dry-run
-//       只打印最佳 description;--apply 才写回 SKILL.md(写前显式确认;非 TTY 拒绝)。
-//
-//   mocode skill usage [name]
-//       展示使用台账(Phase 0):按 skill 的调用次数/成功率/最近失败。
-//
-// 由 index.ts 在 `mocode skill …` 时动态加载(与 mocode config 同模式):
-// 此时才引入 config 单例(LLM 配置)+ agent 依赖图,缺 LLM 配置时给友好报错而非崩。
-// 纯打印/非 TUI:本进程不进 alt screen,输出走 stdout。
-import * as readline from 'node:readline';
-import path from 'node:path';
-import { config, isModelConfigured } from '../config/index.js';
-import { listSkills } from '../skills/index.js';
-import { loadSkillForEval, loadTriggerEvalSet, triggerEvalTemplate, triggerEvalPath, runTriggerEval, renderTriggerReport, saveTriggerReport, validateEvalParams, } from '../skills/skill-eval.js';
-import { runImproveLoop, applyImprovedDescription } from '../skills/skill-improve.js';
-import { loadSkillUsage, aggregateSkillStats, skillStatsPath } from '../skills/stats.js';
-function usage() {
-    console.log(`mocode skill — skill 自进化(触发评测 / description 进化 / 使用台账)
-
-用法:
-  mocode skill eval <name> [选项]        触发评测(需要 <skill-dir>/evals/trigger.json)
-  mocode skill improve <name> [选项]     description 进化循环(默认 dry-run)
-  mocode skill usage [name]              展示使用台账
-
-eval 选项:
-  --runs <n>          每 query 运行次数(默认 3;1..10)
-  --threshold <x>     触发率判定阈值(默认 0.5;>0 且 ≤1)
-  --timeout <ms>      单 query 超时(默认 60000)
-
-improve 选项:
-  --runs <n>          同 eval(默认 3)
-  --threshold <x>     同 eval(默认 0.5)
-  --iterations <n>    迭代上限(默认 5)
-  --holdout <x>       holdout 比例(默认 0.4;0 禁用)
-  --timeout <ms>      单 query 超时(默认 60000)
-  --apply             把最佳 description 写回 SKILL.md(默认 dry-run,仅打印)
-
-eval 集格式(<skill-dir>/evals/trigger.json,非空数组):
-  [
-    { "query": "应该触发该 skill 的真实请求", "should_trigger": true },
-    { "query": "不应触发的相近请求", "should_trigger": false }
-  ]
-
-注: 进化对象仅限 ~/.mocode/skills 与 <cwd>/.mocode/skills 下的 skill(内置 skill 不可进化)。
-    没有 evals/trigger.json 的 skill 只能 eval 前手工补建,improve 一律拒绝(没验证门不优化)。`);
-}
-function numArg(args, name, fallback) {
-    const i = args.indexOf(name);
-    if (i === -1 || i + 1 >= args.length)
-        return fallback;
-    const v = Number(args[i + 1]);
-    if (!Number.isFinite(v) || v <= 0) {
-        throw new Error(`${name} 需要正数: ${args[i + 1]}`);
-    }
-    return v;
-}
-function parseCommon(args) {
-    const runs = Math.round(numArg(args, '--runs', 3));
-    const threshold = numArg(args, '--threshold', 0.5);
-    const timeoutMs = Math.round(numArg(args, '--timeout', 60_000));
-    const err = validateEvalParams(runs, threshold);
-    if (err)
-        throw new Error(err);
-    return { runs, threshold, timeoutMs };
-}
-function requireModel() {
-    if (!isModelConfigured()) {
-        console.error('未配置 LLM(缺 LLM_BASE_URL / LLM_API_KEY)。先运行 `mocode config` 或设置环境变量。');
-        process.exit(1);
-    }
-}
-/** 定位 eval 集;缺失时打印模板并退出(不猜、不自动建)。 */
-function requireEvalSet(skillName) {
-    const skill = loadSkillForEval(skillName);
-    const cases = loadTriggerEvalSet(skill);
-    if (!cases) {
-        console.error(`未找到触发评测集: ${path.relative(process.cwd(), triggerEvalPath(skill))}`);
-        console.error('手工创建该文件(格式):');
-        console.error(triggerEvalTemplate(skill));
-        process.exit(1);
-    }
-    return { skill, cases };
-}
-async function evalCommand(args) {
-    const rest = args.slice();
-    const name = rest.find((a) => !a.startsWith('--'));
-    if (!name)
-        throw new Error('缺少 skill 名。见: mocode skill eval --help');
-    requireModel();
-    const { skill, cases } = requireEvalSet(name);
-    const { runs, threshold, timeoutMs } = parseCommon(rest);
-    console.log(`评测 skill "${skill.name}" — ${cases.length} 条 query × ${runs} 次,模型 ${config.model}\n`);
-    const startedAt = Date.now();
-    const report = await runTriggerEval(skill, skill.description, cases, runs, threshold, {
-        timeoutMs,
-        onProgress: (_d, _t, line) => process.stdout.write(line + '\n'),
-    });
-    const saved = saveTriggerReport(report);
-    console.log(`\n${renderTriggerReport(report, { runsPerQuery: runs, threshold })}`);
-    console.log(`\n耗时 ${((Date.now() - startedAt) / 1000).toFixed(1)}s,结果已存: ${path.relative(process.cwd(), saved)}`);
-    if (report.summary.passed < report.summary.total) {
-        console.log('存在失败项。可用 `mocode skill improve ' + skill.name + '` 尝试自动优化 description(dry-run)。');
-        process.exitCode = 1;
-    }
-}
-function confirmApply(skillName) {
-    if (!process.stdin.isTTY) {
-        // 非 TTY fail closed:自动落盘必须有人在场。
-        console.error('非 TTY 环境拒绝 --apply 自动落盘。请在终端运行,或手工编辑 SKILL.md 的 description。');
-        process.exit(1);
-    }
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    return new Promise((resolve) => {
-        rl.question(`确认把新 description 写回 skill "${skillName}" 的 SKILL.md?(y/N) `, (ans) => {
-            rl.close();
-            resolve(ans.trim().toLowerCase() === 'y' || ans.trim().toLowerCase() === 'yes');
-        });
-    });
-}
-async function improveCommand(args) {
-    const rest = args.slice();
-    const name = rest.find((a) => !a.startsWith('--'));
-    if (!name)
-        throw new Error('缺少 skill 名。见: mocode skill improve --help');
-    requireModel();
-    const { skill, cases } = requireEvalSet(name);
-    const { runs, threshold, timeoutMs } = parseCommon(rest);
-    const iterations = Math.round(numArg(rest, '--iterations', 5));
-    const holdout = (() => {
-        const i = rest.indexOf('--holdout');
-        const v = i === -1 ? 0.4 : Number(rest[i + 1]);
-        if (i !== -1 && (!Number.isFinite(v) || v < 0 || v > 0.9))
-            throw new Error('--holdout 需要 0..0.9 的数');
-        return v;
-    })();
-    const apply = rest.includes('--apply');
-    console.log(`进化 skill "${skill.name}" — ${cases.length} 条 query,train/holdout=${1 - holdout}/${holdout},${apply ? '将写回(--apply)' : 'dry-run(不落盘)'}\n`);
-    const result = await runImproveLoop(skill, cases, {
-        maxIterations: iterations,
-        runsPerQuery: runs,
-        threshold,
-        holdout,
-        timeoutMs,
-        onIteration: (_i, _max, line) => console.log(line),
-    });
-    console.log('');
-    if (!result.improved) {
-        console.log(`没有更优的 description(原 description 已是最佳或循环未产出改进)。`);
-        console.log(`原: ${result.originalDescription}`);
-        return;
-    }
-    console.log(`原 description: ${result.originalDescription}`);
-    console.log(`新 description: ${result.bestDescription}`);
-    if (apply) {
-        const ok = await confirmApply(skill.name);
-        if (!ok) {
-            console.log('已取消写回(dry-run 结果见上,可手工应用)。');
-            return;
-        }
-        applyImprovedDescription(skill, result.bestDescription);
-        console.log(`已写回: ${skill.skillMdPath}`);
-        console.log('提示: 内容哈希已变更,project 级 skill 下次 run_skill 会重新要求信任确认。');
-    }
-    else {
-        console.log('dry-run:未写文件。确认满意后加 --apply 重跑,或直接手工把新 description 写进 SKILL.md。');
-    }
-}
-function usageCommand(args) {
-    const filter = args.find((a) => !a.startsWith('--'));
-    const records = loadSkillUsage();
-    const summaries = aggregateSkillStats(records);
-    const list = filter ? summaries.filter((s) => s.skill === filter) : summaries;
-    if (list.length === 0) {
-        console.log(`(台账为空: ${path.relative(process.cwd(), skillStatsPath())})`);
-        console.log('台账在模型调用 use_skill / run_skill 时自动记录,跑几个会话后这里有数。');
-        return;
-    }
-    for (const s of list) {
-        const rate = s.runSuccessRate === null ? '' : ` run 成功率 ${(s.runSuccessRate * 100).toFixed(0)}%`;
-        console.log(`${s.skill}  ×${s.total}(use ${s.uses} / run ${s.runs})${rate}  最近 ${s.lastUsedAt}`);
-        if (s.lastFailure) {
-            console.log(`  最近失败: ${s.lastFailure.status}${s.lastFailure.code ? ` (${s.lastFailure.code})` : ''} @ ${s.lastFailure.ts}`);
-        }
-    }
-}
-export async function runSkillCommand(args) {
-    const sub = args[0];
-    if (!sub || sub === '--help' || sub === '-h' || sub === 'help') {
-        usage();
-        return;
-    }
-    try {
-        if (sub === 'eval')
-            await evalCommand(args.slice(1));
-        else if (sub === 'improve')
-            await improveCommand(args.slice(1));
-        else if (sub === 'usage')
-            usageCommand(args.slice(1));
-        else {
-            console.error(`未知子命令 "${sub}"。`);
-            usage();
-            process.exitCode = 1;
-        }
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        if (/aborted/i.test(msg)) {
-            console.error('\n已中断。');
-            process.exitCode = 130;
-        }
-        else {
-            console.error(`错误: ${msg}`);
-            process.exitCode = 1;
-        }
-    }
-}
-// 供 index.ts 判断子命令名集合(避免它 parse 我们的参数)。
-export const SKILL_SUBCOMMANDS = ['eval', 'improve', 'usage', 'help', '--help', '-h'];
-// listSkills 在 eval/improve 未命中时供报错文案复用(保持与 /skills 一致的名字集)。
-export function listSkillNames() {
-    return listSkills().map((s) => s.name);
-}

package/dist/config/file.d.ts

@@ -1,23 +0,0 @@
-/**
- * ~/.mocode/config 全局 dotenv 配置的读写叶子(纯 node:fs / node:os / node:path + dotenv)。
- *
- * 独立于 `config/index.ts`——**不**触发 config 单例初始化 / loadEnvFiles,故 `commands/config.ts`
- * (首跑向导,刻意不 import config/index.ts)与 `repl/index.ts`(`/theme` 持久化)都能安全共享。
- * 主题等 UI 偏好走 `updateConfigKey` 单键写;向导多键一次性写走 `writeConfigKeys`。
- */
-/** ~/.mocode/config:全局配置(与 ~/.mocode/skills 同目录,任意终端 / 任意目录生效)。 */
-export declare const CONFIG_PATH: string;
-/** 读已有配置(没有则空对象),用于回填默认值与保留其它键。 */
-export declare function readConfigFile(): Record<string, string>;
-/**
- * 读-合并-写:把 entries 覆盖进 ~/.mocode/config,保留文件里其它键。
- * mkdirSync 兜底(首跑无 ~/.mocode)。不吞 I/O 异常——向导路径让其抛(与历史行为一致);
- * UI 偏好路径用 `updateConfigKey`(自带 try/catch 静默)。
- */
-export declare function writeConfigKeys(entries: Record<string, string>): void;
-/**
- * 单键持久化(主题等 UI 偏好):写失败静默——下次启动读不到则回退默认,不阻断 REPL。
- * 注意:shell env 设了同名键时,`config/index.ts` 的 loadEnvFiles 只 backfill undefined 的
- * process.env,故文件写对**下次启动**可能被 shell 盖——调用方据此给 dim 警告。
- */
-export declare function updateConfigKey(key: string, value: string): void;

package/dist/config/index.d.ts

@@ -1,114 +0,0 @@
-export interface Config {
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    maxTokens?: number;
-    systemPrompt: string;
-    /** 模型上下文窗口(token)。须对齐真实模型窗口(GLM-4.6≈128k,DeepSeek-V3≈64k,Qwen 视版本)。 */
-    contextWindowTokens: number;
-    /** 自动压缩触发阈值(占窗口比例)。默认 0.85,保守偏早以吸收估算误差与下一步增长。 */
-    compactThreshold: number;
-    /** 流式请求里带 stream_options.include_usage 拿真实 usage。后端不认 stream_options 时关掉。 */
-    includeUsage: boolean;
-    /** 自动压缩总开关。关掉则只靠手动 /compact。 */
-    autoCompact: boolean;
-    /** Context Optimization Pipeline 总开关(工具结果进 LLM 前的类型化编码:tree/search/log/…)。
-     *  关掉则工具结果原样进 LLM(仅长度裁剪),零行为变化。默认 true。 */
-    contextOptimize: boolean;
-    /** 相关性裁剪总开关(read_file 跨条裁剪:同 path 旧 read + 已被 mutation 覆写的旧 read
-     *  自动替换为存根)。纯静态、不调 LLM;关掉则保留所有 read 结果(只受 capToolResultForHistory
-     *  单条上限与 microcompact 旧区截短影响)。默认 true;
-     *  设 MOCODE_CONTEXT_RELPRUNE=false 全局回退。 */
-    contextRelprune: boolean;
-    /** 观察者生命周期总开关(LIVE→REFERENCED→OBSOLETE→STUB 四态机;grep/glob/codegraph
-     *  producer ↔ read/edit/write consumer 引用追踪;孤立+老化非观察类工具自动 STUB;
-     *  观察类工具永远只到 REFERENCED,不自动 STUB)。与 contextRelprune 并列,纯静态、不调 LLM。
-     *  默认 true;设 MOCODE_LIFECYCLE=false 全局回退。 */
-    contextLifecycle: boolean;
-    /** Context Budget Scheduler 总开关(五区分账 + ROI 排序调度)。
-     *  关掉则 agent 步前退化为 maybeCompact(history) 老路径(只看总占用 0.85 阈值),
-     *  零行为变化。默认 true;设 MOCODE_BUDGET_SCHEDULER=false 全局回退。 */
-    contextBudget: boolean;
-    /** 后台反思 pass 总开关。关掉则只靠手动 /reflect + 机会主义 memory_update。 */
-    autoReflect: boolean;
-    /**
-     * 记忆子系统总开关。关闭时:5 个 memory_* 工具不进工具表,buildSystemPrompt
-     * 里的 Memory Index 段 + memory_* 工具使用说明整段不出现,plan 模式提示词里的
-     * 工具名也跟着消失。运行时 /memory_switch 改;持久化 MEMORY_ENABLED。
-     * 默认 false:新用户零侵入,想用记忆功能显式打开。
-     */
-    memoryEnabled: boolean;
-    /** 每 N 个轮次触发一次后台反思 pass(与 agent 并发,不阻塞)。默认 5。 */
-    reflectEveryN: number;
-    /** 每轮 agent 循环最大步数(防无限循环)。默认 25。 */
-    maxSteps: number;
-    /** 子 agent(task 工具派生)默认步数上限。防子任务失控耗尽配额。默认 50。 */
-    subAgentMaxSteps: number;
-    /** 会话落盘目录(cwd 下)。 */
-    sessionDir: string;
-    /** AnySearch 联网搜索 API key(可选)。不配则走匿名免费额度(按 IP 限流)。 */
-    searchApiKey?: string;
-    /** 沙箱根目录(文件操作边界,可选)。未配则 startRepl 用 process.cwd() 兜底。优先级:--sandbox-root > 本项 > cwd。 */
-    sandboxRoot?: string;
-    /** AnySearch API base,默认官方端点。 */
-    searchBaseUrl: string;
-    /** 单张图片内联字节上限(base64 前的原始字节);超此大小拒绝并提示 TODO 走 URL 上传。默认 4MB。 */
-    maxImageBytes?: number;
-    /** 主题名(对应 src/ui/theme.ts 的 THEMES 表键)。默认 default;shell env MOCODE_THEME 覆盖文件。 */
-    theme: string;
-    /** MOCODE_THEME 是否由 shell 环境变量设置(非文件回填)。若是,/theme 写文件下次启动仍被 shell 盖。 */
-    themeFromShell: boolean;
-    /** 由 shell 环境变量设置的 LLM 键名列表(非文件回填)。若含某键,/model 写该键下次启动仍被 shell 盖。 */
-    llmKeysFromShell: string[];
-}
-/**
- * 模型是否已配置(baseURL + apiKey 非空)。REPL 开场据此决定是否提示 /model。
- * 未配置时 config.model 仍回退 'gpt-4o-mini',但发消息会因 baseURL/apiKey 空而失败——由 runTurn catch 友好提示。
- */
-export declare function isModelConfigured(): boolean;
-/** 兼容旧名字:repl 的 buildSystemMessage 仍引 PLAN_MODE_SUFFIX(变量)。运行时按需现拼。 */
-export declare function buildBasePrompt(): string;
-/**
- * plan 模式追加到系统提示末尾的指令。
- * 历史曾是 `export const PLAN_MODE_SUFFIX`(顶层字面量);现改为按 isMemoryEnabled()
- * 动态拼:false 时不出现 memory_* 工具名,避免 LLM 想调不存在的工具。
- *
- * 注意:已改为 getter(每次访问现拼),让运行时切 /memory_switch 后立即生效。
- * 旧 import `PLAN_MODE_SUFFIX` 路径不变;repl 推荐改用 getPlanModeSuffix()(语义更清晰)。
- * 不能直接 `export const PLAN_MODE_SUFFIX = buildPlanModeSuffix()`:
- * 该表达式在模块初始化时立即求值,而 buildPlanModeSuffix 内部读 config,config 还未求值 → TDZ。
- */
-export declare function getPlanModeSuffix(): string;
-export declare const config: Config;
-/**
- * 运行时更新模型相关配置(/model 命令调)。
- * - 更新 config 对象字段(即时生效:chat() 读 config.model,reconfigureClient 读 config.baseURL/apiKey)。
- * - 同步 process.env(保持内存一致:其他读 process.env 的路径也拿到新值;且使新值在下次启动的
- *   loadEnvFiles 中被视为"已设",不被文件回填覆盖——即"优先拿这里的")。
- * 持久化(写 ~/.mocode/config)由调用方走 writeConfigKeys,此处只管内存 + env。
- * 重建 OpenAI 客户端(baseURL/apiKey 是构造时固化的实例字段)由调用方走 reconfigureClient。
- */
-export declare function updateModelConfig(opts: {
-    model?: string;
-    baseURL?: string;
-    apiKey?: string;
-    contextWindowTokens?: number;
-}): void;
-/**
- * 记忆子系统总开关:单一来源。/memory_switch、/memory_status、buildSystemPrompt、
- * tools/builtins/index.ts、tools/constants.ts 的 plan-mode 列表都从这里查。
- * 默认 false(新用户零侵入)。
- */
-export declare function isMemoryEnabled(): boolean;
-/**
- * 切换记忆子系统开关(/memory_switch on|off 调)。
- * - 更新 config 单例字段(其它模块下次调 isMemoryEnabled() 即拿新值)。
- * - 同步 process.env.MEMORY_ENABLED(下次启动 loadEnvFiles 不被文件回填)。
- * 持久化(写 ~/.mocode/config 的 MEMORY_ENABLED 键)由调用方走 writeConfigKeys。
- *
- * 注:开关切换对当前会话的 tool list / 已拼好的 systemPrompt 不会自动重算 —
- * 工具表在 REPL 启动时构建,systemPrompt 在每轮 chat() 拼时按 isMemoryEnabled()
- * 现查现拼(关掉时该轮拼出来的 prompt 即不带 memory_* 段)。所以切换在「下一轮
- * agent 调用」起即时生效,本轮已发出的请求不会回滚。
- */
-export declare function updateMemoryConfig(enabled: boolean): void;

package/dist/config/presets.d.ts

@@ -1,57 +0,0 @@
-/**
- * 多模型预设(`/model save <name>` 保存的命名配置)的纯 I/O 叶子。
- *
- * 存储:每个预设一个独立 JSON 文件 `~/.mocode/models/<name>.json`。
- *   - 选用 per-file 而非单一 index.json:写不需要读-合并-写整本,天然原子(单文件 rename),
- *     符合 memory/store.ts 的惯例;并发写多个预设互不打架。
- *   - 路径前缀与 CONFIG_PATH 共享 `~/.mocode/`,保证权限/位置一致。
- *
- * 不读 process.env、不触发 config 单例初始化——repl(/model 子命令)与 commands/config.ts
- * 之外的脚本都能安全 import。错误一律抛(写失败属异常路径,调用方决定怎么提示用户)。
- *
- * 命名约束:[a-zA-Z0-9_-]{1,32}。理由:
- *   - 排除路径分隔符与 .. 防止越权写文件。
- *   - 与 dotenv key 风格一致,便于未来扩展到同名 env override。
- *   - 32 位上限防极长名撑爆文件名系统。
- */
-/** 预设目录:`~/.mocode/models/`(按需创建)。 */
-export declare const MODELS_DIR: string;
-/** 单个预设的内容:与 updateModelConfig 的可选字段对齐。 */
-export interface ModelPreset {
-    name: string;
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    contextWindow: number;
-}
-/** 名字是否合法(调用方复用,避免在多处重复同一正则)。 */
-export declare function isValidPresetName(name: string): boolean;
-/** 读单个预设;不存在抛错。 */
-export declare function getPreset(name: string): ModelPreset;
-/** 读单个预设;不存在返回 null(供列表/可选切换场景)。 */
-export declare function readPreset(name: string): ModelPreset | null;
-/** 写/覆盖一个预设(原子:写 tmp 再 rename)。 */
-export declare function savePreset(preset: ModelPreset): void;
-/** 删除一个预设;不存在返回 false,成功返回 true。 */
-export declare function deletePreset(name: string): boolean;
-/**
- * 重命名一个预设(原子:link+unlink,跨设备时退化为 copy+unlink)。
- * 用于 /model rename <old> <new>;不存在的旧名 / 已存在的新名返回 false,具体由调用方决定提示文案。
- */
-export declare function renamePreset(oldName: string, newName: string): boolean;
-/** 列出全部预设(按 name 升序);目录不存在返回空数组。 */
-export declare function listPresets(): ModelPreset[];
-/**
- * 把当前 config 的 LLM 四键(baseURL/apiKey/model/contextWindow)迁为命名预设。
- * 用于启动时一次性兜底老用户:加 /model 之前就已经在 ~/.mocode/config 写过的配置,
- * /model list 应该立刻能看到,而不是空。已有同名预设则不重复写。
- *
- * 返回新建的预设名;若未配置完整(baseURL/apiKey 缺失)或已有同名则返回 null。
- * 设计为幂等:重启调用一次也只会生效一次。
- */
-export declare function migrateCurrentToPreset(input: {
-    baseURL: string;
-    apiKey: string;
-    model: string;
-    contextWindow: number;
-}): string | null;