agy-mcp-bridge 0.1.31 → 0.1.32

package/dist/src/agents/codex.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { isQuotaError, isStrongQuotaError } from './quota.js';
-import { startProcess, terminateOwned } from '../antigravity/process.js';
+import { captureOutput } from './probe.js';
 const CAPABILITIES = ['code', 'review', 'test', 'research', 'long-run'];
 const REQUIRED_FLAGS = ['--json', '--sandbox', '--cd', '--output-last-message', '--ephemeral', '--skip-git-repo-check'];
 const MAX_RESULT_BYTES = 1024 * 1024;
@@ -86,20 +86,6 @@ export function codexAdapter(command, options = {}) {
 export function codexAgent(command, status, options = {}) {
     return { adapter: codexAdapter(command, options), status, enabled: true, prefixArgs: command.prefixArgs };
 }
-async function capture(command, args, cwd, extraEnvPassthrough) {
-    return new Promise((resolve, reject) => {
-        const child = startProcess(command.executable, [...command.prefixArgs, ...args], cwd, { extraEnvPassthrough });
-        let text = '';
-        let exceeded = false;
-        const timer = setTimeout(() => { exceeded = true; void terminateOwned(child).catch(reject); }, 10000);
-        const append = (chunk) => { if (text.length < 32768)
-            text += chunk.toString().slice(0, 32768 - text.length); };
-        child.stdout.on('data', append);
-        child.stderr.on('data', append);
-        child.once('error', error => { clearTimeout(timer); reject(error); });
-        child.once('close', code => { clearTimeout(timer); exceeded ? reject(new Error('Codex inspection timed out')) : resolve({ code, text }); });
-    });
-}
 /** Non-interactive `codex exec` support is the only contract this adapter relies on. */
 export async function detectCodex(command, options = {}) {
     const cwd = options.cwd ?? process.cwd();
@@ -108,8 +94,8 @@ export async function detectCodex(command, options = {}) {
         id: 'codex', label: 'Codex', available, version, executable: command.source, capabilities: CAPABILITIES, warnings
     });
     try {
-        const version = await capture(command, ['--version'], cwd, extra);
-        const help = await capture(command, ['exec', '--help'], cwd, extra);
+        const version = await captureOutput('Codex', command, ['--version'], cwd, extra);
+        const help = await captureOutput('Codex', command, ['exec', '--help'], cwd, extra);
         const versionText = version.text.trim().split(/\r?\n/)[0] ?? '';
         const parsed = /codex-cli\s+([^\s]+)/i.exec(versionText)?.[1] ?? (versionText || null);
         const missing = REQUIRED_FLAGS.filter(flag => !new RegExp(`(?:^|\\s)${flag.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(?=\\s|,|$)`).test(help.text));

package/dist/src/agents/opencode.js

@@ -1,4 +1,4 @@
-import { startProcess, terminateOwned } from '../antigravity/process.js';
+import { captureOutput } from './probe.js';
 import { isQuotaError } from './quota.js';
 export const CAPABILITIES = ['code', 'review', 'test', 'research', 'long-run'];
 // Verified against opencode v2.2.5: `opencode run` reads the message from stdin and, with `--format json`, writes one JSON event per line.
@@ -120,20 +120,6 @@ export function opencodeAdapter(command, options = {}) {
 export function opencodeAgent(command, status, options = {}) {
     return { adapter: opencodeAdapter(command, options), status, enabled: true, prefixArgs: command.prefixArgs };
 }
-function capture(command, args, cwd, extraEnvPassthrough) {
-    return new Promise((resolve, reject) => {
-        const child = startProcess(command.executable, [...command.prefixArgs, ...args], cwd, { extraEnvPassthrough });
-        let text = '';
-        let exceeded = false;
-        const timer = setTimeout(() => { exceeded = true; void terminateOwned(child).catch(reject); }, 10000);
-        const append = (chunk) => { if (text.length < 32768)
-            text += chunk.toString().slice(0, 32768 - text.length); };
-        child.stdout.on('data', append);
-        child.stderr.on('data', append);
-        child.once('error', error => { clearTimeout(timer); reject(error); });
-        child.once('close', code => { clearTimeout(timer); exceeded ? reject(new Error('OpenCode inspection timed out')) : resolve({ code, text }); });
-    });
-}
 /** Non-interactive `opencode run --format json` is the only contract this adapter relies on. */
 export async function detectOpenCode(command, opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
@@ -142,8 +128,8 @@ export async function detectOpenCode(command, opts = {}) {
         id: 'opencode', label: 'OpenCode', available, version, executable: command.executable, capabilities: CAPABILITIES, warnings
     });
     try {
-        const version = await capture(command, ['--version'], cwd, extra);
-        const help = await capture(command, ['run', '--help'], cwd, extra);
+        const version = await captureOutput('OpenCode', command, ['--version'], cwd, extra);
+        const help = await captureOutput('OpenCode', command, ['run', '--help'], cwd, extra);
         const parsed = version.text.trim().split(/\r?\n/)[0]?.replace(/^opencode\s+/i, '').replace(/^v/i, '') || null;
         if (version.code !== 0)
             return status(false, null, ['opencode --version failed']);

package/dist/src/agents/probe.js

@@ -0,0 +1,20 @@
+import { startProcess, terminateOwned } from '../antigravity/process.js';
+/**
+ * Runs an agent CLI once to read its output (`--version`, `<subcommand> --help`) while it is being inspected. Bounded in time (10 s) and in
+ * size (32 KiB of combined stdout and stderr), and the process is killed with its tree when the time runs out. `label` names the CLI in the error.
+ */
+export function captureOutput(label, command, args, cwd, extraEnvPassthrough) {
+    return new Promise((resolve, reject) => {
+        const child = startProcess(command.executable, [...command.prefixArgs, ...args], cwd, { extraEnvPassthrough });
+        let text = '';
+        let exceeded = false;
+        const timer = setTimeout(() => { exceeded = true; void terminateOwned(child).catch(reject); }, 10000);
+        const append = (chunk) => { if (text.length < 32768)
+            text += chunk.toString().slice(0, 32768 - text.length); };
+        child.stdout.on('data', append);
+        child.stderr.on('data', append);
+        child.once('error', error => { clearTimeout(timer); reject(error); });
+        child.once('close', code => { clearTimeout(timer); exceeded ? reject(new Error(`${label} inspection timed out`)) : resolve({ code, text }); });
+    });
+}
+//# sourceMappingURL=probe.js.map

package/dist/src/agents/registry.js

@@ -54,23 +54,30 @@ export async function createAgentRegistry(config, antigravity) {
         askForApproval: settings.codex_ask_for_approval
     }));
     const opencodeEnabled = enabled.includes('opencode');
-    let opencodeStatus = {
+    const autoApproveWarning = (id) => `Agent "${id}" is configured to auto-approve permissions (opencode_auto_approve): tasks run with opencode --auto`;
+    // The OpenCode CLI is probed when the `opencode` agent is enabled, and also when an enabled opencode profile relies on it:
+    // OpenCode is opt-in, so a profile declared without `enabled` must not end up unavailable because the base agent is off.
+    const profileUsesOpencode = Object.entries(settings.profiles ?? {}).some(([id, profile]) => profile.adapter === 'opencode' && !profile.executable && (enabled.includes(id) || !settings.enabled));
+    let opencodeProbe = {
         id: 'opencode', label: 'OpenCode', available: false, version: null, executable: null,
         capabilities: CAPABILITIES, warnings: ['Disabled in the bridge config']
     };
     let opencodeCommand = { executable: 'opencode', prefixArgs: [], source: 'opencode' };
-    if (opencodeEnabled) {
+    if (opencodeEnabled || profileUsesOpencode) {
         try {
             opencodeCommand = await resolveCommand(settings.opencode_executable ?? 'opencode');
-            opencodeStatus = await detectOpenCode(opencodeCommand, { cwd: process.cwd(), extraEnvPassthrough: config.extra_env_passthrough });
+            opencodeProbe = await detectOpenCode(opencodeCommand, { cwd: process.cwd(), extraEnvPassthrough: config.extra_env_passthrough });
         }
         catch (error) {
-            opencodeStatus = { ...opencodeStatus, warnings: [`OpenCode CLI not found: ${error instanceof Error ? error.message : 'unknown error'}`] };
+            opencodeProbe = { ...opencodeProbe, warnings: [`OpenCode CLI not found: ${error instanceof Error ? error.message : 'unknown error'}`] };
         }
     }
-    const opencodeAutoWarning = 'Agent "opencode" is configured to auto-approve permissions (opencode_auto_approve): tasks run with opencode --auto';
+    // The base agent is only available when it was asked for; the probe above may exist just for a profile.
+    let opencodeStatus = opencodeEnabled
+        ? opencodeProbe
+        : { ...opencodeProbe, available: false, warnings: ['Disabled in the bridge config'] };
     if (opencodeEnabled && settings.opencode_auto_approve)
-        opencodeStatus = { ...opencodeStatus, warnings: [...opencodeStatus.warnings, opencodeAutoWarning] };
+        opencodeStatus = { ...opencodeStatus, warnings: [...opencodeStatus.warnings, autoApproveWarning('opencode')] };
     agents.push(opencodeAgent(opencodeCommand, opencodeStatus, {
         model: settings.opencode_model,
         autoApprove: settings.opencode_auto_approve
@@ -79,7 +86,7 @@ export async function createAgentRegistry(config, antigravity) {
         for (const [profileId, profile] of Object.entries(settings.profiles)) {
             const isProfileEnabled = enabled.includes(profileId) || (!settings.enabled && true);
             const adapterType = profile.adapter;
-            const label = profile.label ?? (adapterType === 'codex' ? `Codex (${profileId})` : `Antigravity (${profileId})`);
+            const label = profile.label ?? `${{ codex: 'Codex', antigravity: 'Antigravity', opencode: 'OpenCode' }[adapterType]} (${profileId})`;
             const profileWarnings = [];
             if (!isProfileEnabled)
                 profileWarnings.push('Disabled in the bridge config');
@@ -148,8 +155,8 @@ export async function createAgentRegistry(config, antigravity) {
             else if (adapterType === 'opencode') {
                 let cmd = opencodeCommand.executable;
                 let prefixArgs = opencodeCommand.prefixArgs;
-                let available = opencodeStatus.available;
-                let version = opencodeStatus.version;
+                let available = opencodeProbe.available;
+                let version = opencodeProbe.version;
                 if (profile.executable) {
                     try {
                         const resolved = await resolveCommand(profile.executable);
@@ -170,7 +177,7 @@ export async function createAgentRegistry(config, antigravity) {
                     version: version || null, executable: cmd || null,
                     capabilities: CAPABILITIES,
                     warnings: isProfileEnabled
-                        ? [...opencodeStatus.warnings.filter(w => !w.includes('Disabled') && w !== opencodeAutoWarning), ...profileWarnings, ...(settings.opencode_auto_approve ? [opencodeAutoWarning.replace('"opencode"', `"${profileId}"`)] : [])]
+                        ? [...(profile.executable ? [] : opencodeProbe.warnings.filter(w => !w.includes('Disabled'))), ...profileWarnings, ...(settings.opencode_auto_approve ? [autoApproveWarning(profileId)] : [])]
                         : profileWarnings
                 };
                 agents.push({

package/dist/src/cli.js

@@ -10,7 +10,7 @@ import { addSessionWorkspaces } from './config.js';
 import { recoverExecutionLock } from './tasks/execution-lock.js';
 import { renderSetup } from './setup.js';
 import { DEFAULT_TOOL_TIMEOUT_SECONDS, codexConfigPath, planCodexConfig, readCodexConfig, writeCodexConfig } from './codex-config.js';
-import { freebuffConfigPath, planFreebuffConfig, readFreebuffConfig, writeFreebuffConfig } from './freebuff-config.js';
+import { freebuffConfigPath, isTransientInstall, planFreebuffConfig, readFreebuffConfig, writeFreebuffConfig } from './freebuff-config.js';
 import { readWait } from './wait-setting.js';
 import { configuredPort } from './http.js';
 import { offerSkillInstall, offerSkillUpdate } from './onboarding.js';
@@ -217,6 +217,8 @@ async function setup(args) {
         return;
     }
     const clients = target === 'both' ? ['codex', 'claude'] : [target];
+    if (target === 'freebuff' && isTransientInstall(paths.packageRoot))
+        console.error(`Note: this copy of ${BIN} runs from a temporary npx cache, so the stdio command printed below stops working once npm clears it. Install it globally (npm install -g ${pkg.name}) and print it again before using it.`);
     console.log(renderSetup({ clients, mcpUrl, shells: shell, bin: BIN, waitSeconds: readWait(paths.stateDirectory) ?? undefined, stdio: stdioCommand() }));
 }
 /** The command a stdio client must run for THIS installation: the interpreter and the packaged stdio entry, both absolute. */
@@ -225,6 +227,11 @@ export function stdioCommand() {
 }
 /** Shows exactly what would change in Freebuff's .agents/mcp.json and writes it only after a yes (or --yes). */
 async function applyFreebuffSetup(project, yes) {
+    if (isTransientInstall(paths.packageRoot)) {
+        console.error(`Not changed: this copy of ${BIN} runs from a temporary npx cache (${paths.packageRoot}), which npm can delete, so Freebuff's config would point at a path that stops working. Install it first: npm install -g ${pkg.name}, then run ${BIN} setup freebuff --apply again.`);
+        process.exitCode = 1;
+        return;
+    }
     if (project !== undefined) {
         const info = await stat(project).catch(() => null);
         if (!info?.isDirectory())

package/dist/src/freebuff-config.js

@@ -10,6 +10,11 @@ import path from 'node:path';
  * diff stays readable. The caller shows the plan and asks before anything is written, and a backup is made first.
  */
 export const SERVER_KEY = 'antigravity';
+/**
+ * `npx` unpacks a package into a cache directory (`.../_npx/<hash>/node_modules/...`) that npm may delete at any time. An
+ * absolute path into it must not be written into a client's persistent config: it works today and breaks silently later.
+ */
+export const isTransientInstall = (packageRoot) => /[\\/]_npx[\\/]/.test(packageRoot);
 /** `~/.agents/mcp.json`, or `<project>/.agents/mcp.json`: Freebuff reads the file nearest to where it runs. */
 export const freebuffConfigPath = (options = {}) => path.join(options.project ?? options.home ?? os.homedir(), '.agents', 'mcp.json');
 /** The indent the file already uses, so re-serializing it does not reformat the servers someone else wrote. */

package/docs/OPENCODE-INTEGRATION-PLAN.md

@@ -5,6 +5,24 @@
 
 Không thay đổi hành vi hiện tại của antigravity và codex. OpenCode nằm trong **Phase 3** theo `docs/MULTI-AGENT-PLAN.md`.
 
+## Đã làm khác thiết kế ban đầu (đọc mục này trước các mục 1–3)
+
+Các mục 1–3 bên dưới là bản thiết kế viết trước khi có code, giữ lại để biết lý do. Nơi nào mâu thuẫn với bảng này thì **bảng này đúng** (đã đối chiếu với `opencode` v2.2.5 và với code):
+
+| Thiết kế ban đầu | Thực tế |
+|---|---|
+| `opencode` vào `DEFAULT_ENABLED` | **Mặc định tắt**; chỉ chạy khi `agents.enabled` liệt kê. Profile OpenCode khai báo mà bỏ `agents.enabled` vẫn được kiểm tra CLI và báo lý do nếu không dùng được |
+| `opencode run <prompt>` qua argv | `opencode run --standalone --format json`, prompt qua **stdin** (argv bị giới hạn độ dài, và prompt bắt đầu bằng `-` bị đọc thành cờ) |
+| không nhắc service nền | **`--standalone` bắt buộc**: mặc định `opencode run` giao việc cho service nền dùng chung của OpenCode Desktop, hủy task không dừng agent và shell của agent nằm ngoài cây process mà bridge dọn (đo ở `docs/HANDOFF.md` mục 7) |
+| `OPENCODE_HOME` tách tài khoản | Biến này **không có tác dụng**; dùng `XDG_DATA_HOME` / `XDG_CONFIG_HOME` trong `profile.env` |
+| model `gpt-5` | Dạng `provider/model` (xem `opencode models`), ví dụ `opencode/big-pickle` |
+| `parseResult` đọc JSON đơn hoặc text thường | Đọc luồng JSONL: sự kiện `text` cuối là câu trả lời, `step_finish` cho lượt và token, `error` là thất bại |
+| `autonomy: "full"` có thể thêm `--auto` | **Không bao giờ**: `autonomy` do client chọn và chỉ là chỉ dẫn. `--auto` chỉ bật bằng `agents.opencode_auto_approve` trong config của chủ máy, và hiện trong cảnh báo của `agents_list` |
+| không có giới hạn log | `compactLine` bỏ `step_start` và rút `tool_use` về tên tool và trạng thái, để luồng JSON không vượt giới hạn output |
+| quyền mặc định không bàn tới | OpenCode **chạy lệnh shell và sửa file mà không hỏi** kể cả không có `--auto` (đo trên v2.2.5): mô hình quyền của nó lỏng hơn mặc định của `agy` và Codex `workspace-write`. Bật nó trong `agents.enabled` là chấp nhận điều đó |
+
+Mục 3 ("Câu hỏi cần trả lời") đã được trả lời bằng bảng trên; không còn câu hỏi mở.
+
 ---
 
 ## 1. Khai báo kỹ thuật

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-mcp-bridge",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "Local loopback HTTP MCP bridge that delegates bounded coding tasks to multiple agent CLIs (Antigravity, Codex) with optional parallel git worktrees",
   "license": "MIT",
   "keywords": [