mocode-ai 1.2.6 → 1.2.7

package/dist/config/index.js

@@ -5,6 +5,7 @@ import dotenv from 'dotenv';
 import { getCurrentSessionId } from '../session/state.js';
 import { getNotesFilePath, extractActiveNotesSections } from '../session/notes.js';
 import { buildWorkDisciplineSection, inferModelFamily } from '../agent/work-discipline.js';
+import { buildValidationCommandsSection } from '../verification/prompt.js';
 import { detectLanguage, setLanguage, t, } from '../i18n/index.js';
 /**
  * 按优先级加载配置文件并回填 process.env:
@@ -40,11 +41,14 @@ export const languageFromShell = process.env.MOCODE_LANGUAGE !== undefined;
 // 在 loadEnvFiles 回填前捕获:哪些 LLM 键由 shell 设置(决定 /model 写文件是否下次启动生效)。
 // 仿 themeFromShell 模式:shell export 的环境变量在 loadEnvFiles 中不被回填(优先级最高),
 // 故 /model 写入 ~/.mocode/config 的同名键下次启动会被 shell 值覆盖——据此给 dim 警告。
-const LLM_ENV_KEYS = ['LLM_BASE_URL', 'LLM_API_KEY', 'LLM_MODEL', 'CONTEXT_WINDOW_TOKENS'];
+const LLM_ENV_KEYS = ['LLM_PROVIDER', 'LLM_BASE_URL', 'LLM_API_KEY', 'LLM_MODEL', 'CONTEXT_WINDOW_TOKENS', 'ANTHROPIC_PROMPT_CACHE'];
 export const DEFAULT_CONTEXT_WINDOW_TOKENS = 256000;
 const llmKeysFromShell = LLM_ENV_KEYS.filter((k) => process.env[k] !== undefined);
 loadEnvFiles();
 setLanguage(detectLanguage(process.env.MOCODE_LANGUAGE));
+export function normalizeLlmProvider(value) {
+    return typeof value === 'string' && value.toLowerCase() === 'anthropic' ? 'anthropic' : 'openai';
+}
 /**
  * 取环境变量;缺则返回空字符串(不退出)。
  * 历史上缺 LLM_BASE_URL/LLM_API_KEY 会 process.exit(1),但 /model 命令已能在 REPL 内配置模型,
@@ -243,15 +247,43 @@ export function reinjectSessionNotesIntoSystem(history) {
     return true;
 }
 /**
- * 一次性重注入会话状态(plan 段 + 笔记段)到系统提示。调用点(core.ts compact 后 /
- * 本步改 notes.md、repl compact 时)统一用本函数替代 reinjectActivePlanIntoSystem,
- * 让笔记段享有与 plan 段完全对称的常驻 + 恢复时机。返回任一 marker 是否改动。
+ * 一次性重注入会话状态(plan 段 + 笔记段)到系统提示。返回任一 marker 是否改动。
+ *
+ * @deprecated 热路径已不再调用(#prompt-cache):往 history[0] 追加 plan/笔记会让
+ *   系统提示每次 plan_update / note_append 后变字节,前缀缓存整段失效(系统提示 6-8k token,
+ *   本轮后续每步全价重算)。现由 agent/core 每步在 requestHistory **末尾**注入
+ *   {@link buildSessionStateReminder} 的 ephemeral system 消息:模型看到的信息等价,
+ *   但变动落在前缀末端。本函数仅留给外部集成 / 旧测试,新增调用点请勿使用。
  */
 export function reinjectSessionStateIntoSystem(history) {
     const planChanged = reinjectActivePlanIntoSystem(history);
     const notesChanged = reinjectSessionNotesIntoSystem(history);
     return planChanged || notesChanged;
 }
+/**
+ * 构造"会话状态提醒"正文(活跃 `## Plan:` 段 + 活跃笔记段正文),供 agent/core 每步
+ * 拼进 requestHistory **末尾**的 ephemeral system 消息。
+ *
+ * 为什么在尾部而不是 history[0](prompt 缓存):plan_update / note_append 是设计上鼓励
+ * 高频调用的工具,一旦它们改写系统提示,支持自动前缀缓存的后端(OpenAI / DeepSeek /
+ * GLM / Qwen)就会从第一个 token 起全部 miss。放到历史末尾后,前面整段(系统提示 + 全部
+ * 已有对话)保持逐字节稳定,只有尾部这一小条随 notes.md 变化。
+ *
+ * 纯读函数:不改 history,也不写文件。notes.md 不存在 / 无活跃内容时返回 ''(零开销)。
+ */
+export function buildSessionStateReminder(sessionId = getCurrentSessionId()) {
+    const plan = extractActivePlanSection(sessionId);
+    const notes = extractActiveNotesSections(undefined, sessionId);
+    if (!plan && !notes)
+        return '';
+    const parts = [
+        '## Session state (current, from notes.md)',
+        'This block mirrors the live session notepad and is refreshed every step; treat it as the authoritative plan/notes state, and ignore any older copy earlier in this conversation.',
+        ...(plan ? [plan] : []),
+        ...(notes ? [notes] : []),
+    ];
+    return parts.join('\n\n');
+}
 const SYSTEM_PROMPT_MEMORY_SECTION = `
 ## Memory (cross-session facts)
 - The prompt may contain a title/summary index; retrieve details with memory_search or inspect all with memory_list. memory_search also surfaces knowledge-graph facts (relations between entities) alongside entry bodies.
@@ -345,6 +377,7 @@ Complete programming tasks through an "analyze → call tool → observe result
 - Report: stop when done and give honest conclusions with path:line references (see Reporting).
 - Use web search only when freshness materially affects the answer.
 ${buildCodegraphSection()}
+${buildValidationCommandsSection()}
 
 ## Engineering principles
 ${buildWorkDisciplineSection(inferModelFamily(config.model))}
@@ -446,6 +479,7 @@ export function getPlanModeSuffix() {
     return buildPlanModeSuffix();
 }
 export const config = {
+    provider: normalizeLlmProvider(process.env.LLM_PROVIDER),
     baseURL: requireEnv('LLM_BASE_URL'),
     apiKey: requireEnv('LLM_API_KEY'),
     model: process.env.LLM_MODEL || 'gpt-4o-mini',
@@ -457,6 +491,7 @@ export const config = {
     },
     contextWindowTokens: Number(process.env.CONTEXT_WINDOW_TOKENS) || DEFAULT_CONTEXT_WINDOW_TOKENS,
     includeUsage: process.env.LLM_STREAM_USAGE !== 'false',
+    anthropicPromptCache: process.env.ANTHROPIC_PROMPT_CACHE !== 'false',
     autoCompact: process.env.AUTO_COMPACT !== 'false',
     contextOptimize: process.env.MOCODE_CONTEXT_OPTIMIZE === 'true',
     contextRelprune: process.env.MOCODE_CONTEXT_RELPRUNE === 'true',
@@ -482,6 +517,21 @@ export const config = {
     permissionEnabled: process.env.MOCODE_PERMISSION !== 'false',
     permissionNonInteractiveAllow: process.env.MOCODE_PERMISSION_NON_INTERACTIVE_ALLOW === 'true',
 };
+/**
+ * 会话钉死模型：窗口/会话启动时由 pinSessionModel() 捕获一次。
+ * 运行中 agent 一律经 getActiveModel() 取模型，而非热切的 config.model——
+ * 这样某窗口 /model switch 改写全局 config 后，其它【已经打开】的窗口的
+ * 运行 agent 仍用各自启动时的模型，不会被影响；只有重启/新开窗口才会读全局 config。
+ */
+let sessionModel = null;
+/** 在 REPL 启动时调用一次，把当前模型钉成本会话的活跃模型。 */
+export function pinSessionModel() {
+    sessionModel = config.model;
+}
+/** 运行中 agent 实际使用的模型：优先钉死值，未钉(极早路径)则回退 config.model。 */
+export function getActiveModel() {
+    return sessionModel ?? config.model;
+}
 /**
  * 运行时更新模型相关配置(/model 命令调)。
  * - 更新 config 对象字段(即时生效:chat() 读 config.model,reconfigureClient 读 config.baseURL/apiKey)。
@@ -491,8 +541,16 @@ export const config = {
  * 重建 OpenAI 客户端(baseURL/apiKey 是构造时固化的实例字段)由调用方走 reconfigureClient。
  */
 export function updateModelConfig(opts) {
+    if (opts.provider !== undefined) {
+        config.provider = opts.provider;
+        process.env.LLM_PROVIDER = opts.provider;
+    }
     if (opts.model !== undefined) {
         config.model = opts.model;
+        // 钉死值同步更新：本窗口显式 /model switch 立即对本窗口运行 agent 生效；
+        // 其它已开窗口的 sessionModel 不受影响（各自启动时钉死）。
+        if (sessionModel !== null)
+            sessionModel = opts.model;
         process.env.LLM_MODEL = opts.model;
     }
     if (opts.baseURL !== undefined) {
@@ -507,6 +565,10 @@ export function updateModelConfig(opts) {
         config.contextWindowTokens = opts.contextWindowTokens;
         process.env.CONTEXT_WINDOW_TOKENS = String(opts.contextWindowTokens);
     }
+    if (opts.anthropicPromptCache !== undefined) {
+        config.anthropicPromptCache = opts.anthropicPromptCache;
+        process.env.ANTHROPIC_PROMPT_CACHE = opts.anthropicPromptCache ? 'true' : 'false';
+    }
 }
 /** 子 Agent 总开关；默认 false，关闭时 sub-agent 不进入模型工具表。 */
 export function isSubAgentEnabled() {

package/dist/config/presets.js

@@ -31,8 +31,8 @@ function filePathFor(name) {
     }
     return path.join(MODELS_DIR, `${name}.json`);
 }
-/** 把磁盘上的 raw JSON 解析并校验为 ModelPreset;非法字段抛错。 */
-function parsePreset(raw) {
+/** 把磁盘上的 raw JSON 解析并校验为 ModelPreset;旧预设缺 provider 时按 openai 读取。 */
+export function parsePreset(raw) {
     const obj = JSON.parse(raw);
     const { name, baseURL, apiKey, model, contextWindow } = obj;
     if (typeof name !== 'string' || !isValidPresetName(name)) {
@@ -50,7 +50,17 @@ function parsePreset(raw) {
     if (typeof contextWindow !== 'number' || !Number.isFinite(contextWindow) || contextWindow <= 0) {
         throw new Error(`预设 ${name}: contextWindow 必须为正数`);
     }
-    return { name, baseURL, apiKey, model, contextWindow: Math.floor(contextWindow) };
+    const provider = obj.provider === 'anthropic' ? 'anthropic' : 'openai';
+    const anthropicPromptCache = provider === 'anthropic' && obj.anthropicPromptCache !== false;
+    return {
+        name,
+        provider,
+        baseURL,
+        apiKey,
+        model,
+        contextWindow: Math.floor(contextWindow),
+        anthropicPromptCache,
+    };
 }
 /** 读单个预设;不存在抛错。 */
 export function getPreset(name) {
@@ -68,15 +78,21 @@ export function readPreset(name) {
         throw e;
     }
 }
-/** 写/覆盖一个预设(原子:写 tmp 再 rename)。 */
+/** 写/覆盖一个预设(原子:写 tmp 再 rename)。旧调用缺 provider 时仍按 openai 保存。 */
 export function savePreset(preset) {
     if (!isValidPresetName(preset.name)) {
         throw new Error(`非法预设名: ${JSON.stringify(preset.name)}`);
     }
+    const provider = preset.provider ?? 'openai';
+    const normalized = {
+        ...preset,
+        provider,
+        anthropicPromptCache: provider === 'anthropic' && preset.anthropicPromptCache !== false,
+    };
     fs.mkdirSync(MODELS_DIR, { recursive: true });
     const dest = filePathFor(preset.name);
     const tmp = `${dest}.tmp-${process.pid}-${Date.now()}`;
-    fs.writeFileSync(tmp, JSON.stringify(preset, null, 2), 'utf8');
+    fs.writeFileSync(tmp, JSON.stringify(normalized, null, 2), 'utf8');
     fs.renameSync(tmp, dest);
 }
 /** 删除一个预设;不存在返回 false,成功返回 true。 */
@@ -156,11 +172,15 @@ export function migrateCurrentToPreset(input) {
         return null;
     if (!Number.isFinite(input.contextWindow) || input.contextWindow <= 0)
         return null;
+    const provider = input.provider ?? 'openai';
+    const anthropicPromptCache = provider === 'anthropic' && input.anthropicPromptCache !== false;
     const existing = listPresets();
-    const dup = existing.find((p) => p.baseURL === input.baseURL &&
+    const dup = existing.find((p) => p.provider === provider &&
+        p.baseURL === input.baseURL &&
         p.apiKey === input.apiKey &&
         p.model === input.model &&
-        p.contextWindow === input.contextWindow);
+        p.contextWindow === input.contextWindow &&
+        p.anthropicPromptCache === anthropicPromptCache);
     if (dup)
         return null;
     // 'default' 已被占 → 用户已显式起过预设,无需老数据迁入;返回 null 让调用方跳过即可。
@@ -168,10 +188,12 @@ export function migrateCurrentToPreset(input) {
         return null;
     savePreset({
         name: 'default',
+        provider,
         baseURL: input.baseURL,
         apiKey: input.apiKey,
         model: input.model,
         contextWindow: input.contextWindow,
+        anthropicPromptCache,
     });
     return 'default';
 }

package/dist/context/artifacts.js

@@ -131,6 +131,26 @@ export function recordArtifact(state, history, idx, output, succeeded) {
     stateFor(state).artifacts.set(id, artifact);
     updateStats(state, stateFor(state));
 }
+/**
+ * 按读取时间倒序返回最近若干「仍新鲜的 read_file 目标」(path + hash)。
+ * 用途:文件编辑工具参数校验失败(如缺 path)时,把系统已知的候选直接回灌给模型照抄,
+ * 避免模型在长上下文里凭记忆复述出错、补一个字段丢另一个字段的乒乓重试。
+ * 只展示事实、不替模型填值——选哪个候选仍由模型判断。永不抛错。
+ */
+export function knownEditTargets(state, limit = 3) {
+    const artifacts = stateFor(state).artifacts;
+    const targets = [];
+    for (const artifact of artifacts.values()) {
+        if (artifact.freshness !== 'fresh' || artifact.source.type !== 'read')
+            continue;
+        const dependency = artifact.dependencies[0];
+        if (!dependency || dependency.path === '*' || !dependency.hash)
+            continue;
+        targets.push({ path: dependency.path, hash: dependency.hash, version: artifact.version ?? 0 });
+    }
+    targets.sort((a, b) => b.version - a.version);
+    return targets.slice(0, Math.max(1, Math.floor(limit) || 3)).map(({ path, hash }) => ({ path, hash }));
+}
 function affected(artifact, changed) {
     // '*' 依赖(无法解析出具体文件路径的诊断/搜索结果)不与任何具体写操作关联:
     // 任何文件写入都会作废全部 '*' artifact,等于每次 mutation 都销毁

package/dist/context/budget.js

@@ -54,8 +54,10 @@ export function userTurnBoundary(history, window) {
 /** 评估当前 history 的五区预算(纯函数,改不动 history)。
  * 传入 step 是当前所在 step 编号(agent 循环 step 变量),用于日志/调试。
  * correction:API 实测 / 估算的校正系数(默认 1);>1 表示粗估偏低,乘以系数后 actual 更接近真实值。
- * activeTools 必须与下一次 chat() 实际发送的工具集合一致，避免 plan/子 agent 误算 schema。 */
-export function evaluateBudget(history, window, step = 0, correction = 1, activeTools = chatTools) {
+ * activeTools 必须与下一次 chat() 实际发送的工具集合一致，避免 plan/子 agent 误算 schema。
+ * ephemeralTokens:本次请求会追加、但不在 history 里的尾部注入(会话状态提醒等)的裸 token,
+ *   必须传入,否则压力线看不见这部分开销(见 SystemCostBreakdown.ephemeral)。 */
+export function evaluateBudget(history, window, step = 0, correction = 1, activeTools = chatTools, ephemeralTokens = 0) {
     const layers = {};
     for (const k of BUDGET_LAYERS) {
         const budget = Math.floor(BUDGET_RATIO[k] * window);
@@ -66,12 +68,17 @@ export function evaluateBudget(history, window, step = 0, correction = 1, active
     // 裸总量(不乘 correction):硬闸用它判断,防止 correction 折扣否决真实溢出。
     let rawTotal = 0;
     const sysMsg = history[0];
+    const safeEphemeral = Number.isFinite(ephemeralTokens)
+        ? Math.max(0, Math.round(ephemeralTokens))
+        : 0;
     const systemCosts = {
         prompt: sysMsg ? msgTokens(sysMsg) : 0,
         toolSchemas: estimateToolSchemaTokens(activeTools),
+        ephemeralInjection: safeEphemeral,
     };
-    // 工具 schema 与 system prompt 同属请求固定开销；必须计入总量才能可靠触发压缩。
-    const systemRaw = systemCosts.prompt + systemCosts.toolSchemas;
+    // 工具 schema、system prompt 与尾部 ephemeral 注入同属请求固定开销；
+    // 必须计入总量才能可靠触发压缩(尾部注入不在 history 里,只能由调用方传入)。
+    const systemRaw = systemCosts.prompt + systemCosts.toolSchemas + systemCosts.ephemeralInjection;
     layers.system.actual = adj(systemRaw);
     rawTotal += systemRaw;
     // Summary 检测:role:'system' 且不是 history[0] 的,视为摘要(compact.ts 摘要插 index 1)。
@@ -143,7 +150,7 @@ export function scheduleActions(report) {
     const actions = [];
     const { layers } = report;
     if (layers.system.overBudget) {
-        const { prompt, toolSchemas } = report.systemCosts;
+        const { prompt, toolSchemas, ephemeralInjection } = report.systemCosts;
         const { actual, budget } = layers.system;
         const excess = actual - budget;
         const percent = ((actual / Math.max(budget, 1)) * 100).toFixed(0);
@@ -151,7 +158,9 @@ export function scheduleActions(report) {
             kind: 'warn',
             layer: 'system',
             reason: `固定开销 ${actual}/${budget} (+${excess}, ${percent}%)；`
-                + `提示 ${prompt} + 工具 ${toolSchemas}，×${report.correction.toFixed(2)}。`,
+                + `提示 ${prompt} + 工具 ${toolSchemas}`
+                + (ephemeralInjection > 0 ? ` + 尾部注入 ${ephemeralInjection}` : '')
+                + `，×${report.correction.toFixed(2)}。`,
         });
     }
     const pressureLine = DEFAULT_BUDGET_POLICY.pressureTriggerRatio * report.window;

package/dist/context/index.js

@@ -3,7 +3,7 @@
 // scheduler is the only automatic rewrite coordinator at real pressure.
 export { optimizeToolResult } from './pipeline.js';
 export { classify, knownToolKinds } from './classifier.js';
-export { recordArtifact, invalidateArtifacts, rehydrateArtifacts, refreshArtifactFreshness, pruneStaleArtifacts, collectArtifactRefs, formatArtifactTokenSources, } from './artifacts.js';
+export { recordArtifact, invalidateArtifacts, rehydrateArtifacts, refreshArtifactFreshness, pruneStaleArtifacts, collectArtifactRefs, formatArtifactTokenSources, knownEditTargets, } from './artifacts.js';
 export { registerEncoder, registerAll, getEncoder, registeredKinds, } from './registry.js';
 // ── Context Budget Scheduler ───────────────────────────────────────────────
 export { evaluateBudget, scheduleActions, formatReport, quickEstimate, userTurnBoundary, BUDGET_LAYERS, DEFAULT_BUDGET_POLICY, BUDGET_RATIO, HOT_TURN_WINDOW, } from './budget.js';

package/dist/host/stdio.js

@@ -33,7 +33,12 @@ async function initializeRuntime() {
         await initializeAllMcp();
         registerToolsExtension('mcp', getMcpTools());
         refreshChatTools();
-        emit('runtime_ready', { projectRoot: process.cwd(), warnings: getMcpWarnings() });
+        emit('runtime_ready', {
+            projectRoot: process.cwd(),
+            provider: config.provider,
+            promptCache: config.provider === 'anthropic' && config.anthropicPromptCache,
+            warnings: getMcpWarnings(),
+        });
     })();
     return initialized;
 }
@@ -117,6 +122,8 @@ async function run(command) {
             sessionId,
             projectRoot: process.cwd(),
             resumed,
+            provider: config.provider,
+            promptCache: config.provider === 'anthropic' && config.anthropicPromptCache,
             attachments: command.attachments?.map((attachment) => attachment.name) ?? [],
         }, command.id);
         const result = await runAgentCore({
@@ -134,6 +141,8 @@ async function run(command) {
             terminationReason: result.terminationReason,
             changedFiles: result.changedFiles ?? [],
             usage: result.usage,
+            provider: config.provider,
+            promptCache: config.provider === 'anthropic' && config.anthropicPromptCache,
             usagePercent: Math.round(contextUsagePercent() * 100),
             contextWindow: config.contextWindowTokens,
         }, command.id);

package/dist/llm/index.js

@@ -1,8 +1,9 @@
 import OpenAI from 'openai';
-import { config, isSubAgentEnabled, isFrontendToolsEnabled } from '../config/index.js';
+import { config, getActiveModel, isSubAgentEnabled, isFrontendToolsEnabled } from '../config/index.js';
 import { tools } from '../tools/registry.js';
 import { getPlanDisabledTools, FRONTEND_TOOLS } from '../tools/constants.js';
 import { ThinkTagFilter } from './think-filter.js';
+import { anthropicChatOnce } from './providers/anthropic.js';
 // 强制关闭第三方调试日志泄漏:openai SDK 在 process.env.DEBUG === 'true' 时用裸
 // console.log 把请求/响应直写 stdout,会污染 TUI 输入框(并泄露 headers/URL)。
 // 仅拦截 'true' 这一开关值——保留 namespace 形式的 DEBUG(如 DEBUG=express:*) 调试能力。
@@ -267,6 +268,9 @@ toolsOverride) {
             throw new DOMException('This operation was aborted', 'AbortError');
         }
         try {
+            if (config.provider === 'anthropic') {
+                return await anthropicChatOnce(messages, handlers, signal, toolsOverride ?? chatTools);
+            }
             return await chatOnce(messages, handlers, signal, toolsOverride);
         }
         catch (err) {
@@ -327,6 +331,22 @@ export function normalizeImageDetail(messages) {
 }
 /** 单次流式 LLM 请求(无重试);chat() 的内部实现,可被 __setChatCreateImpl 注入桩以做单测。 */
 async function chatOnce(messages, handlers, signal, toolsOverride) {
+    // 防御:messages 必须至少含一条非空 user 消息,否则 OpenAI/Anthropic 都会 400。
+    // compact force 分支曾把所有 user 丢进摘要 → 重建 history 无 user → 下一轮 400。
+    // 在 transport 边界拦住所有类似回归(compact / 外部注入 / resume 损坏)。
+    const hasNonEmptyUser = messages.some((m) => {
+        if (m.role !== 'user')
+            return false;
+        const c = m.content;
+        if (typeof c === 'string')
+            return c.length > 0;
+        if (Array.isArray(c))
+            return c.some((p) => p.type === 'text' && (p.text?.length ?? 0) > 0);
+        return false;
+    });
+    if (!hasNonEmptyUser) {
+        throw new Error('messages must contain at least one non-empty user message');
+    }
     // signal 透传给 SDK 第二参(RequestOptions);abort 后 for await 抛错,chat 不 catch,透传 runAgent 处理。
     // createImplOverride 的 body 类型故意宽成 Record(测试桩用),生产走 client 分支时由 OpenAI 自己的类型守门。
     const create = createImplOverride
@@ -334,7 +354,7 @@ async function chatOnce(messages, handlers, signal, toolsOverride) {
         : (body, opts) => client.chat.completions.create(body, opts);
     const activeTools = toolsOverride ?? chatTools;
     const stream = await create({
-        model: config.model,
+        model: getActiveModel(),
         messages: normalizeImageDetail(messages),
         tools: activeTools,
         stream: true,