mocode-ai 1.0.12 → 1.0.14

package/bin/mocode-agent-host.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+// Mocode Work 的本地 Agent Host。stdout 仅输出 NDJSON 协议事件；诊断写 stderr。
+await import('../dist/host/stdio.js');

package/dist/agent/core.js

@@ -693,7 +693,9 @@ export async function runAgentCore(opts) {
                                     : false;
                                 let denied;
                                 if (tool && argumentsValid) {
-                                    const perm = await checkPermission(tool, parsed ?? {}, signal);
+                                    const perm = await checkPermission(tool, parsed ?? {}, signal, {
+                                        prompt: opts.permissionPrompt,
+                                    });
                                     emitTrace('permission', {
                                         source: 'agent_tool',
                                         tool: tc.name,
@@ -785,7 +787,9 @@ export async function runAgentCore(opts) {
                                 ? validateToolArguments(tool, parsed).valid
                                 : false;
                             if (tool && argumentsValid) {
-                                const perm = await checkPermission(tool, parsed ?? {}, signal);
+                                const perm = await checkPermission(tool, parsed ?? {}, signal, {
+                                    prompt: opts.permissionPrompt,
+                                });
                                 emitTrace('permission', {
                                     source: 'agent_tool',
                                     tool: tc.name,

package/dist/host/protocol.js

@@ -0,0 +1,22 @@
+export function parseCommand(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const input = value;
+    if (typeof input.id !== 'string' || typeof input.type !== 'string')
+        return null;
+    if (input.type === 'run' && typeof input.prompt === 'string') {
+        return { id: input.id, type: 'run', prompt: input.prompt };
+    }
+    if (input.type === 'cancel')
+        return { id: input.id, type: 'cancel' };
+    if (input.type === 'approval' && typeof input.approvalId === 'string') {
+        return {
+            id: input.id,
+            type: 'approval',
+            approvalId: input.approvalId,
+            action: input.action === 'selected' ? 'selected' : 'cancelled',
+            value: typeof input.value === 'string' ? input.value : undefined,
+        };
+    }
+    return null;
+}

package/dist/i18n/index.js

@@ -240,12 +240,14 @@ const zhCN = {
     'upgrade.latestVersion': '最新版本：{version}',
     'upgrade.noUpdate': '已是最新版本 v{version}',
     'upgrade.hasUpdate': '发现新版本：当前 v{current} → 最新 v{latest}',
+    'upgrade.checkHint': '运行 /upgrade 即可升级到该版本。',
     'upgrade.upgradeStarted': '已启动后台升级 → {version}',
     'upgrade.upgradeHint': '后台升级进程已启动。当前 mocode 进程退出后才会执行 npm install -g mocode-ai@latest，完成后下次启动即生效。日志：~/.mocode/upgrade.log',
     'upgrade.begin': '开始升级 mocode-ai → {version}',
     'upgrade.completed': '升级完成，mocode 即将退出，请重新启动以使用新版本。',
     'upgrade.failedWithCode': '升级失败（退出码 {code}）。',
     'upgrade.manualHint': '可尝试退出 mocode 后手动运行：npm install -g mocode-ai@latest',
+    'upgrade.etargetHint': '（npm 找不到该版本，可能是 registry 镜像缓存未同步，建议稍后再试或手动指定源：npm install -g mocode-ai@latest --registry=https://registry.npmjs.org/）',
     'upgrade.devSkip': '当前为开发运行(tsx)，已跳过真实 npm install，避免误改全局包。',
     'upgrade.fetchFailed': '无法获取最新版本（请检查网络或 npm registry）。',
     'upgrade.pkgName': '包名：mocode-ai',
@@ -495,12 +497,14 @@ const en = {
     'upgrade.latestVersion': 'Latest version: {version}',
     'upgrade.noUpdate': 'Already up to date: v{version}',
     'upgrade.hasUpdate': 'New version available: v{current} → v{latest}',
+    'upgrade.checkHint': 'Run /upgrade to install it.',
     'upgrade.upgradeStarted': 'Background upgrade started → {version}',
     'upgrade.upgradeHint': 'Background upgrade process started. npm install -g mocode-ai@latest will run after you exit mocode. Log: ~/.mocode/upgrade.log',
     'upgrade.begin': 'Starting upgrade mocode-ai → {version}',
     'upgrade.completed': 'Upgrade complete. mocode will exit now; please restart to use the new version.',
     'upgrade.failedWithCode': 'Upgrade failed (exit code {code}).',
     'upgrade.manualHint': 'Try exiting mocode and run: npm install -g mocode-ai@latest',
+    'upgrade.etargetHint': '(npm cannot find this version, possibly due to registry mirror cache lag. Retry later or use the source registry: npm install -g mocode-ai@latest --registry=https://registry.npmjs.org/)',
     'upgrade.devSkip': 'Running in dev mode (tsx); skipped real npm install to avoid touching the global package.',
     'upgrade.fetchFailed': 'Unable to fetch the latest version (check network or npm registry).',
     'upgrade.pkgName': 'Package: mocode-ai',

package/dist/repl/index.js

@@ -1171,7 +1171,7 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                     }
                     else if (info.hasUpdate) {
                         layout.contentWrite(`${ui.cyan}● ${t('upgrade.hasUpdate', { current: info.current, latest: info.latest })}${ui.reset}\n`);
-                        layout.contentWrite(`${ui.dim}${t('upgrade.upgradeStarted', { version: `v${info.latest}` })}${ui.reset}\n`);
+                        layout.contentWrite(`${ui.dim}${t('upgrade.checkHint')}${ui.reset}\n`);
                     }
                     else {
                         layout.contentWrite(`${ui.green}✓ ${t('upgrade.noUpdate', { version: info.current })}${ui.reset}\n`);
@@ -1216,7 +1216,12 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
                     }
                     else {
                         layout.contentWrite(`${ui.red}✗ ${t('upgrade.failedWithCode', { code: String(result.exitCode ?? 'unknown') })}${ui.reset}\n`);
-                        layout.contentWrite(`${ui.dim}${t('upgrade.manualHint')}${ui.reset}\n`);
+                        if (result.output.includes('ETARGET') || result.output.includes('No matching version found')) {
+                            layout.contentWrite(`${ui.yellow}${t('upgrade.etargetHint')}${ui.reset}\n`);
+                        }
+                        else {
+                            layout.contentWrite(`${ui.dim}${t('upgrade.manualHint')}${ui.reset}\n`);
+                        }
                     }
                 }
                 catch (e) {
@@ -1420,16 +1425,16 @@ export async function startRepl(initialHistory, sessionId, sandboxRootOverride,
             continue;
         }
         if (line === '/compact' || line.startsWith('/compact ')) {
-            // /compact 可选语法:/compact [focus]  或  /compact --force [focus]
-            // --force:即便 oldGroups 空(history 全在保护区)也强行把早期消息降级压一次。
+            // /compact 默认强制压缩(force=true)，不受阈值/保护区限制
+            // 语法:/compact [focus] 或 /compact --no-force [focus] (显式关闭强制)
             const rest = line.slice('/compact'.length).trim();
-            let force = false;
+            let force = true; // 默认强制
             let focus;
-            if (rest === '--force')
-                force = true;
-            else if (rest.startsWith('--force ')) {
-                force = true;
-                focus = rest.slice('--force '.length).trim() || undefined;
+            if (rest === '--no-force')
+                force = false;
+            else if (rest.startsWith('--no-force ')) {
+                force = false;
+                focus = rest.slice('--no-force '.length).trim() || undefined;
             }
             else if (rest)
                 focus = rest;

package/dist/tools/builtins/edit-file.js

@@ -13,37 +13,91 @@ function conflict(path, details) {
 }
 export const editFileTool = {
     name: 'edit_file',
-    description: 'Replace one exact string in a file transactionally. expected_hash is required and must be copied from a fresh read_file artifact header. If the file changes after that read, the edit is rejected without writing.',
+    description: `Replace content in a file transactionally. Supports two modes:
+
+**String replacement mode (default):** Provide old_string that occurs exactly once in the file. The old_string must be copied verbatim from a fresh read_file output — do NOT reconstruct from memory, summaries, or grep output, as these lose whitespace/indentation details. Common failure modes: trailing whitespace, tabs vs spaces, indentation changes, line-ending mismatches (CRLF vs LF).
+
+**Line-range mode:** Provide line_start and line_end (1-based, inclusive) instead of old_string. Use this when the exact text is hard to reproduce or when replacing a large block.
+
+expected_hash is required (sha256 from read_file artifact header) and must match the current file hash. If the file changed after your read, the edit is rejected. Recovery: call read_file again on the same path and copy both the new hash and exact text.
+
+**When to use which mode:**
+- String replacement: small, unique text fragments (function signatures, config keys, error messages)
+- Line-range: large blocks, repeated patterns, or when whitespace precision is critical
+
+**Anti-patterns (will fail):**
+- old_string reconstructed from memory or a summary
+- old_string copied from a previous tool call that may be stale
+- old_string that appears multiple times (add more context to make it unique)
+- expected_hash from a different file or an old read_file call`,
     risk: 'confirm',
     parameters: {
         type: 'object',
         properties: {
-            path: { type: 'string' },
-            old_string: { type: 'string', description: 'The original text; must occur exactly once.' },
-            new_string: { type: 'string', description: 'Replacement text.' },
-            expected_hash: { type: 'string', description: 'sha256 hash from the latest read_file artifact header.' },
+            path: { type: 'string', description: 'Absolute file path.' },
+            old_string: { type: 'string', description: 'String replacement mode: the exact text to replace (must occur once). Mutually exclusive with line_start/line_end.' },
+            new_string: { type: 'string', description: 'The replacement text.' },
+            line_start: { type: 'integer', description: 'Line-range mode: start line (1-based, inclusive). Mutually exclusive with old_string.' },
+            line_end: { type: 'integer', description: 'Line-range mode: end line (1-based, inclusive). Mutually exclusive with old_string.' },
+            expected_hash: { type: 'string', description: 'sha256 hash from the latest read_file artifact header (sha256:<64 hex>).' },
         },
-        required: ['path', 'old_string', 'new_string', 'expected_hash'],
+        required: ['path', 'new_string', 'expected_hash'],
     },
     async execute(args, ctx) {
         const file = String(args.path);
-        const oldString = String(args.old_string);
         const newString = String(args.new_string);
         const expectedHash = normalizeContentHash(String(args.expected_hash));
         if (!expectedHash)
             return conflict(file, 'expected_hash 必须是 sha256:<64 hex>。');
+        const hasOldString = args.old_string !== undefined;
+        const hasLineStart = args.line_start !== undefined;
+        const hasLineEnd = args.line_end !== undefined;
+        // 参数互斥检查
+        if (hasOldString && (hasLineStart || hasLineEnd)) {
+            return conflict(file, 'old_string 和 line_start/line_end 互斥，请选择一种模式。');
+        }
+        if (!hasOldString && (!hasLineStart || !hasLineEnd)) {
+            return conflict(file, '必须提供 old_string 或同时提供 line_start 和 line_end。');
+        }
         const data = await readFile(jailResolve(file), 'utf8');
         const normalized = data.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-        const oldNormalized = oldString.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
         const newNormalized = newString.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-        const count = normalized.split(oldNormalized).length - 1;
-        if (count === 0) {
-            return conflict(file, 'old_string 未找到；请重新 read_file 并复制最新内容。');
+        let updated;
+        if (hasOldString) {
+            // String replacement mode
+            const oldString = String(args.old_string);
+            const oldNormalized = oldString.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+            const count = normalized.split(oldNormalized).length - 1;
+            if (count === 0) {
+                return conflict(file, 'old_string 未找到；请重新 read_file 并复制最新内容。');
+            }
+            if (count > 1) {
+                return conflict(file, `old_string 出现 ${count} 次；请增加上下文使其唯一。`);
+            }
+            updated = normalized.replace(oldNormalized, () => newNormalized);
         }
-        if (count > 1) {
-            return conflict(file, `old_string 出现 ${count} 次；请增加上下文使其唯一。`);
+        else {
+            // Line-range mode
+            const lineStart = Number(args.line_start);
+            const lineEnd = Number(args.line_end);
+            if (!Number.isInteger(lineStart) || !Number.isInteger(lineEnd)) {
+                return conflict(file, 'line_start 和 line_end 必须是整数。');
+            }
+            if (lineStart < 1 || lineEnd < lineStart) {
+                return conflict(file, `无效的 line range: line_start=${lineStart}, line_end=${lineEnd}。要求 line_start >= 1 且 line_end >= line_start。`);
+            }
+            const lines = normalized.split('\n');
+            if (lineEnd > lines.length) {
+                return conflict(file, `line_end=${lineEnd} 超出文件范围 (共 ${lines.length} 行)。`);
+            }
+            // 替换指定行范围（1-based 转 0-based）
+            const startIndex = lineStart - 1;
+            const endIndex = lineEnd - 1;
+            const newLines = newNormalized.split('\n');
+            // 替换 lines[startIndex..endIndex] 为 newLines
+            lines.splice(startIndex, endIndex - startIndex + 1, ...newLines);
+            updated = lines.join('\n');
         }
-        const updated = normalized.replace(oldNormalized, () => newNormalized);
         const replacement = data.includes('\r\n') ? updated.replace(/\n/g, '\r\n') : updated;
         const result = await commitChangeSet(createChangeSet([{
                 path: file,

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "mocode-ai",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "终端编码 agent:LLM + tool-call 循环 + 流式输出(含思考)+ 16 个工具,接任意 OpenAI 兼容后端。",
   "type": "module",
   "bin": {
-    "mocode": "bin/mocode.js"
+    "mocode": "bin/mocode.js",
+    "mocode-agent-host": "bin/mocode-agent-host.js"
   },
   "files": [
     "dist",