minimal-agent 0.6.1 → 0.6.3

package/src/main.js

@@ -5,16 +5,28 @@ import { existsSync, mkdirSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { resolve } from 'node:path';
 const require = createRequire(import.meta.url);
-const pkg = require('../package.json');
+const pkg = (() => {
+    try {
+        return require('../package.json');
+    }
+    catch {
+        return {
+            version: typeof __GREEN_BUILD_VERSION__ === 'string'
+                ? __GREEN_BUILD_VERSION__
+                : '0.0.0',
+        };
+    }
+})();
 import { extractCwdArg } from './bootstrap/cwdArg.js';
 import { initWorkingDir, getWorkingDir } from './bootstrap/workingDir.js';
 import { applyToolKeysToEnv, loadProviderLayered } from './config.js';
-import { loadContext } from './context/persistContext.js';
+import { clearContext, loadContext } from './context/persistContext.js';
 import { migrateLegacyContext } from './context/sessionPath.js';
 import { buildFullSystemPrompt } from './prompts/system.js';
 import { ALL_TOOLS } from './tools/index.js';
 import { Root } from './ui/Root.js';
 import { runPrintMode } from './cli/print.js';
+import { runStreamJsonMode } from './cli/streamJson.js';
 import { extractFlagValue } from './cli/args.js';
 // re-export：对外保持「main.tsx 提供 extractFlagValue」的语义；实现住在 cli/args.ts，
 // 这样单测可零副作用 import（main.tsx 顶层 main() 自调用会启动整个 app，不可被测试 import）。
@@ -48,12 +60,23 @@ async function main() {
         console.log(`minimal-agent v${pkg.version}`);
         return;
     }
+    // --clear：清空当前工作目录的会话（归档 + 清空）后退出。供 webchat 的 /new 调用。
+    //   无需 provider；上面 -d/--cwd 已 chdir + initWorkingDir，clearContext() 作用于该目录。
+    if (args.includes('--clear')) {
+        await clearContext();
+        return;
+    }
     const isPrintMode = args.includes('-p') || args.includes('--print');
     if (isPrintMode) {
         // 先把输出格式解析出来——provider 缺失分支也要按 json 契约给信号。
         // 只接受 'text' | 'json'，其它值（含拼错）一律回落 'text'（向后兼容）。
         const rawFormat = extractFlagValue(args, ['--output-format']);
-        const outputFormat = rawFormat === 'json' ? 'json' : 'text';
+        // text（默认，逐字节向后兼容）/ json（一行结局契约）/ stream-json（逐行 LoopEvent，webchat broker 用）
+        const outputFormat = rawFormat === 'json'
+            ? 'json'
+            : rawFormat === 'stream-json'
+                ? 'stream-json'
+                : 'text';
         // --max-turns：parseInt，非法（NaN）→ undefined（走 loop 默认 50）
         const rawMaxTurns = extractFlagValue(args, ['--max-turns']);
         const parsedMaxTurns = rawMaxTurns !== undefined ? Number.parseInt(rawMaxTurns, 10) : Number.NaN;
@@ -74,6 +97,10 @@ async function main() {
                     error: 'provider config not found',
                 }));
             }
+            else if (outputFormat === 'stream-json') {
+                // stream-json：吐一行 error 事件（webchat 前端识别为致命错误）
+                console.log(JSON.stringify({ type: 'error', error: 'provider config not found', code: 'llm_error' }));
+            }
             process.stderr.write(`\n未找到 provider 配置。\n\n` +
                 `请二选一：\n` +
                 `  1. 设置环境变量 MINIMAL_AGENT_BASE_URL / MINIMAL_AGENT_API_KEY / MINIMAL_AGENT_MODEL\n` +
@@ -82,6 +109,14 @@ async function main() {
         }
         const initialHistory = await buildInitialHistory();
         const verbose = args.includes('--verbose') || args.includes('-v');
+        // stream-json 走独立流式模式（webchat broker / 网关用）；text/json 仍走原 runPrintMode（契约不变）。
+        if (outputFormat === 'stream-json') {
+            await runStreamJsonMode(provider, args, initialHistory, {
+                maxTurns,
+                compact: args.includes('--compact'),
+            });
+            return;
+        }
         await runPrintMode(provider, args, initialHistory, { verbose, outputFormat, maxTurns });
         return;
     }
@@ -120,9 +155,12 @@ minimal-agent - 轻量级 AI 编程助手
   -v, --verbose      显示详细输出（工具调用、压缩信息）
   -d, --cwd <dir>    指定工作目录（不存在自动创建）；启动时 chdir 到这里，
                      上下文文件、工具相对路径、.env 加载都以此为基准
-  --output-format <fmt>  text（默认）= 纯文本答案；json = stdout 输出一行结构化
-                         结局契约（ok / result / stop_reason / num_turns / error）
+  --output-format <fmt>  text（默认）= 纯文本答案；json = 一行结局契约
+                         （ok / result / stop_reason / num_turns / error）；
+                         stream-json = 逐行 LoopEvent（webchat / 网关 broker 用）
   --max-turns <n>    最大工具循环轮数（防失控；缺省 50）
+  --clear            清空当前工作目录的会话（归档 + 清空）后退出
+  --compact          与 -p --output-format stream-json 连用：压缩当前会话
   -h, --help         显示帮助信息
 
 会话记忆:

package/src/plugins/pluginLoader.js

@@ -24,9 +24,28 @@
  * ============================================================
  */
 import { existsSync, statSync } from 'node:fs';
-import { join } from 'node:path';
+import { basename, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 const loaderCache = new Map();
+/**
+ * 内置插件静态注册表（仅绿色版 compile 入口 entry.compiled.tsx 会填充）。
+ *
+ * 背景：`bun --compile` 后，rich 插件的 plugin.ts 顺链 import 的框架 SDK
+ * （`../../../src/plugin-sdk.js`）已被焊进 exe、磁盘上不存在 → 动态 import
+ * 外部 plugin.ts 必抛错。绿色版改为在 compile 入口**静态 import** 内置插件
+ * （`src/plugins/builtinRegistry.ts`），让 bun 把执行器整树打进 exe，再经
+ * setBuiltinPluginApi 注册到这里；loadPluginApi 在磁盘加载缺失/失败时回退到此表。
+ *
+ * dev / npm 模式：entry.compiled 永不被 import → 此表恒为空 → 回退分支不触发
+ * → loadPluginApi 行为与改动前逐字节一致。
+ *
+ * key = 插件目录名（`plugins/<id>/` 的 `<id>`，等于 `basename(pluginRoot)`）。
+ */
+const builtinApis = new Map();
+/** 由绿色版 compile 入口调用，注册内置插件执行器。dev/npm 不会调用。 */
+export function setBuiltinPluginApi(key, api) {
+    builtinApis.set(key, api);
+}
 function isPluginApi(value) {
     if (!value || typeof value !== 'object')
         return false;
@@ -62,8 +81,24 @@ export async function loadPluginApi(pluginRoot) {
             // stat 失败静默，不影响加载
         }
     }
+    // 绿色版回退：磁盘加载缺失/失败时，按目录名查 exe 内静态注册表。
+    // dev/npm 注册表恒空 → 永远返回 null → 不改变下方任何分支的最终结果。
+    const builtinKey = basename(pluginRoot);
+    const builtinFallback = () => {
+        const api = builtinApis.get(builtinKey);
+        if (api) {
+            loaderCache.set(pluginRoot, api);
+            return api;
+        }
+        return null;
+    };
     const pluginEntry = jsExists ? jsPath : tsExists ? tsPath : undefined;
     if (!pluginEntry) {
+        // 磁盘无 plugin.js/.ts：绿色目录只铺声明式部分（plugin.json + commands/），
+        // 执行器在 exe 内注册表 → 这里命中。dev/npm 注册表空 → 维持原 null。
+        const fb = builtinFallback();
+        if (fb)
+            return fb;
         loaderCache.set(pluginRoot, null);
         return null;
     }
@@ -79,6 +114,11 @@ export async function loadPluginApi(pluginRoot) {
         return candidate;
     }
     catch (err) {
+        // 绿色版：磁盘铺了 plugin.js 但它顺链 import 的框架 SDK 在 exe 内、磁盘没有
+        // → import 抛错 → 回退到 exe 内注册表。dev/npm 注册表空 → 维持原 warn + null。
+        const fb = builtinFallback();
+        if (fb)
+            return fb;
         console.warn(`[minimal-agent] failed to load plugin entry at ${pluginRoot}: ${err instanceof Error ? err.message : String(err)}`);
         loaderCache.set(pluginRoot, null);
         return null;

package/src/plugins/transcript.js

@@ -26,7 +26,9 @@ import { randomUUID } from 'node:crypto';
 // 模块级状态：当前会话的 handle（lazy 初始化）
 let current = null;
 function transcriptDir() {
-    return join(homedir(), '.minimal-agent', 'transcripts');
+    // 优先使用环境变量（测试可覆盖；Docker/K8s 也常靠 ENV 定位 home），
+    // fallback 到 os.homedir()（生产环境缺 ENV 时用系统默认值）。
+    return join(process.env.HOME ?? process.env.USERPROFILE ?? homedir(), '.minimal-agent', 'transcripts');
 }
 function generateSessionId() {
     return `${Date.now().toString(36)}-${randomUUID().slice(0, 8)}`;

package/src/tools/bash/bash.js

@@ -50,6 +50,12 @@ import { scanDestructiveCommand } from './warnings.js';
 // ---------------- 0. 常量 ----------------
 const DEFAULT_TIMEOUT_MS = 120_000; // 2 min
 const MAX_TIMEOUT_MS = 600_000; // 10 min
+/**
+ * G1：stdout / stderr 即时缓冲上限（各自）。命令狂输出（如 cat 大文件 / yes）时，
+ * 在最终统一截断之前先把内存封顶，防 OOM。取最终展示截断阈值的 2 倍 —— 正常输出不受影响，
+ * 超大输出也只占有限内存（最终仍按 DEFAULT_MAX_RESULT_SIZE_CHARS 截断展示）。
+ */
+const MAX_STREAM_BUFFER_CHARS = DEFAULT_MAX_RESULT_SIZE_CHARS * 2;
 /**
  * 灾难性命令黑名单。
  * 命中任意一条就直接拒绝执行 —— 这层是"防猪队友"而不是真沙盒。
@@ -142,6 +148,27 @@ export function checkForbidden(command) {
     }
     return null;
 }
+/**
+ * 子进程环境变量：从 process.env 复制后**剥离 agent 自己的密钥**
+ * （`MINIMAL_AGENT_*` / `TAVILY_*`）。
+ *
+ * 动机（安全）：main.tsx 启动时会把 saved config 里的 key 注入 process.env。
+ * 若原样把 process.env 透传给 Bash 子进程，模型只要跑 `echo $MINIMAL_AGENT_API_KEY`
+ * 就能把 key（绿色版里是卖家预置的）读进 tool result、回传 LLM、甚至打到 -p stdout。
+ * 这些 env 是 agent 自身配置，子进程命令并不需要 —— 直接删掉，最小化泄露面。
+ * 其余变量（PATH / HOME / 用户自己 export 的）照常透传。
+ *
+ * 导出供测试断言。
+ */
+export function sanitizedChildEnv(base = process.env) {
+    const env = { ...base };
+    for (const key of Object.keys(env)) {
+        if (key.startsWith('MINIMAL_AGENT_') || key.startsWith('TAVILY_')) {
+            delete env[key];
+        }
+    }
+    return env;
+}
 // ---------------- 1. Zod 输入 schema ----------------
 const inputSchema = z.object({
     command: z
@@ -256,17 +283,20 @@ async function call(input, signal) {
                 shell: true,
                 cwd: getWorkingDir(),
                 signal: ac.signal,
-                env: process.env,
+                env: sanitizedChildEnv(),
                 windowsHide: true,
             });
             child.stdout?.setEncoding('utf8');
             child.stderr?.setEncoding('utf8');
             child.stdout?.on('data', (chunk) => {
-                stdout += chunk;
-                // 读到一半就超额时不强行 kill；最后再统一截断,避免日志噪声
+                // G1：即时封顶，防止狂输出命令在最终截断前撑爆内存（OOM）。不强行 kill，
+                // 让命令自己跑完或被 timeout 收走；超出上限的部分直接丢弃，最终仍按上限截断展示。
+                if (stdout.length < MAX_STREAM_BUFFER_CHARS)
+                    stdout += chunk;
             });
             child.stderr?.on('data', (chunk) => {
-                stderr += chunk;
+                if (stderr.length < MAX_STREAM_BUFFER_CHARS)
+                    stderr += chunk;
             });
             child.on('error', (e) => {
                 // signal abort 会先触发 error('AbortError')；把这种 case 转成正常分支

package/src/tools/grep/rgPath.js

@@ -26,6 +26,7 @@
 import { spawn } from 'node:child_process';
 import { chmodSync, existsSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { execSiblingDir } from '../../utils/greenRoot.js';
 import { findPackageRoot } from '../../utils/packageRoot.js';
 let cached;
 /**
@@ -53,6 +54,15 @@ async function detect() {
         ensureExecutable(vendored);
         return vendored;
     }
+    // ②.5 绿色版（bun --compile 单文件）：exe 同级 vendor/ripgrep/<arch>-<platform>/rg
+    //   compile 后 import.meta.url 是虚拟路径，findPackageRoot 失效（② 命不中），
+    //   绿色目录把 vendor/ 摆在可执行文件旁边，从这里捞回来。dev/npm 下 exe 同级
+    //   没有 vendor/ → existsSync 过滤掉 → 不影响 ②/③/④ 原有优先级。
+    const sibling = resolve(execSiblingDir(), 'vendor', 'ripgrep', subdir(), exeName());
+    if (existsSync(sibling)) {
+        ensureExecutable(sibling);
+        return sibling;
+    }
     // ③ PATH 上的 rg —— 直接试 spawn rg --version
     if (await trySpawn('rg'))
         return 'rg';

package/src/ui/hooks/useTokenUsage.js

@@ -15,11 +15,12 @@
  *  再额外传入版本号 prop 配合依赖即可。
  * ============================================================
  */
-import { AUTOCOMPACT_BUFFER_TOKENS } from '../../context/compact.js';
+import { getCompactThreshold } from '../../context/compact.js';
 import { countMessagesTokens } from '../../context/tokenCounter.js';
 export function useTokenUsage(messages, provider) {
     const tokens = countMessagesTokens(messages);
-    const threshold = Math.max(1000, provider.contextWindow - AUTOCOMPACT_BUFFER_TOKENS);
+    // 与 loop 实际触发同源（getCompactThreshold：按 contextWindow × compactRatio 比例 + 8K 下限）
+    const threshold = getCompactThreshold(provider);
     return {
         tokens,
         threshold,

package/src/utils/greenRoot.js

@@ -0,0 +1,33 @@
+/**
+ * ============================================================
+ *  src/utils/greenRoot.ts —— 绿色版(bun --compile 单文件)资源探测锚点
+ * ------------------------------------------------------------
+ *  问题：`bun build --compile` 把运行时 + 全部 JS 焊进单个可执行文件，
+ *  此时 `import.meta.url` 指向嵌入式虚拟路径（`/$bunfs/...`），磁盘上
+ *  既没有 package.json 也没有源码树 —— `findPackageRoot` 会抛错，靠它
+ *  定位的 `vendor/ripgrep/`、`skills/`、`plugins/`、`workflows/` 全失效。
+ *
+ *  方案：绿色版把这些外部资产与可执行文件**放在同一目录**，运行时用
+ *  `dirname(process.execPath)` 找回来（exe 同级）。
+ *
+ *  为什么 dev / npm 模式零影响：
+ *    - dev（`bun run src/main.tsx`）：execPath = bun 二进制，其同级目录
+ *      （如 `~/.bun/bin/`）没有 vendor/skills/plugins。
+ *    - npm 全局安装（`node dist/main.js`）：execPath = node 二进制，其
+ *      同级目录同样没有这些资源目录。
+ *    - 故调用方一律对返回值做 `existsSync` 过滤：dev/npm 下命不中 → 被
+ *      丢弃 → 行为与现状逐字节一致。只有真·绿色版（资产摆在 exe 旁边）
+ *      才会命中。因此这里**无条件返回** execPath 目录即可，无需判别
+ *      "是否 compiled"。
+ * ============================================================
+ */
+import { dirname } from 'node:path';
+/**
+ * 返回可执行文件所在目录（绿色版资产的同级锚点）。
+ *
+ * 调用方必须用 existsSync 过滤返回路径下的目标子目录 —— dev/npm 模式
+ * execPath 指向 node/bun 二进制，其同级没有资源目录，过滤后无副作用。
+ */
+export function execSiblingDir() {
+    return dirname(process.execPath);
+}

package/src/utils/resourcePaths.js

@@ -21,6 +21,7 @@
 import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { getWorkingDir } from '../bootstrap/workingDir.js';
+import { execSiblingDir } from './greenRoot.js';
 import { findPackageRoot } from './packageRoot.js';
 /**
  * 返回资源目录的搜索顺序数组（cwd 优先 + packageRoot fallback）。
@@ -35,6 +36,13 @@ export function getResourceSearchPaths(name, metaUrl) {
     if (existsSync(cwdPath)) {
         paths.push(cwdPath);
     }
+    // 绿色版（bun --compile 单文件）：exe 同级 <name>/ —— compile 后 findPackageRoot
+    // 失效，资源目录摆在可执行文件旁边从这里命中。dev/npm 下 exe 同级（node/bun
+    // 二进制所在目录）没有资源目录 → existsSync 过滤 → 数组与现状一致。
+    const sibPath = resolve(join(execSiblingDir(), name));
+    if (!paths.includes(sibPath) && existsSync(sibPath)) {
+        paths.push(sibPath);
+    }
     let pkgPath;
     try {
         pkgPath = resolve(join(findPackageRoot(metaUrl), name));
@@ -42,7 +50,7 @@ export function getResourceSearchPaths(name, metaUrl) {
     catch {
         return paths;
     }
-    if (pkgPath !== cwdPath && existsSync(pkgPath)) {
+    if (!paths.includes(pkgPath) && existsSync(pkgPath)) {
         paths.push(pkgPath);
     }
     return paths;