agy-mcp-bridge 0.1.7 → 0.1.8

package/dist/src/cli.js

@@ -12,7 +12,7 @@ import { renderSetup } from './setup.js';
 import { configuredPort } from './http.js';
 import { offerSkillInstall, offerSkillUpdate } from './onboarding.js';
 import { addWorkspace, listWorkspaces, removeWorkspace, resolveWorkspaceDirectory } from './workspace-config.js';
-import { checkForUpdate, compareVersions, fetchLatest, isGlobalInstall, isSnoozed, readPackageInfo, runGlobalInstall, snooze, updateCheckEnabled } from './update.js';
+import { checkForUpdate, compareVersions, fetchLatest, installFailureHint, isGlobalInstall, isSnoozed, readPackageInfo, runGlobalInstall, snooze, updateCheckEnabled } from './update.js';
 const BIN = 'agy-mcp-bridge';
 const pkg = readPackageInfo();
 const configFile = process.env.ANTIGRAVITY_BRIDGE_CONFIG ?? paths.configFile;
@@ -88,6 +88,9 @@ async function offerUpdate(info) {
         process.exit(0);
     }
     console.error(`[update] Installation failed (see npm output above). Starting the current version ${info.current}.`);
+    const hint = installFailureHint(pkg.name);
+    if (hint)
+        console.error(`[update] ${hint}`);
 }
 async function start(args) {
     const directories = [];
@@ -156,6 +159,11 @@ async function updateCommand(args) {
     const status = runGlobalInstall(pkg.name, latest);
     if (status === 0)
         console.log(`Updated to ${latest}. Restart a running server (Ctrl+C, then ${BIN}) to use it.`);
+    else {
+        const hint = installFailureHint(pkg.name);
+        if (hint)
+            console.error(hint);
+    }
     process.exitCode = status;
 }
 function setup(args) {

package/dist/src/paths.js

@@ -1,8 +1,13 @@
-import { homedir } from 'node:os';
+import { homedir, tmpdir } from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 /** Read-only assets shipped with the code (ui/, skills/, package.json). Two levels above dist/src. */
 export const packageRoot = fileURLToPath(new URL('../../', import.meta.url));
+/**
+ * Working directory for helper processes (`agy --version`, `--help`, `models`). Never the package directory: on Windows a process keeps its
+ * working directory open, so a helper (or anything it leaves running) there would make `npm install -g` fail with EBUSY.
+ */
+export const helperDirectory = () => tmpdir();
 /** Per-user, writable, survives package updates (an update replaces the whole install directory). */
 export function userDataDirectory(env = process.env, platform = process.platform, home = homedir()) {
     if (platform === 'win32')

package/dist/src/runtime.js

@@ -1,5 +1,5 @@
 import { loadConfig, sessionOnlyWorkspaces } from './config.js';
-import { paths } from './paths.js';
+import { helperDirectory, paths } from './paths.js';
 import { findExecutable, inspectCli, startProcess } from './antigravity/process.js';
 import { TaskManager } from './tasks/manager.js';
 import { recoverExecutionLock } from './tasks/execution-lock.js';
@@ -7,7 +7,7 @@ export async function createRuntime() {
     const config = await loadConfig();
     let cli = { version: 'unavailable', executable: '', supported: false, warnings: [] };
     try {
-        cli = await inspectCli(await findExecutable(config.executable), paths.packageRoot, (executable, args, cwd) => startProcess(executable, args, cwd, { extraEnvPassthrough: config.extra_env_passthrough }), config.prompt_transport === 'stdin');
+        cli = await inspectCli(await findExecutable(config.executable), helperDirectory(), (executable, args, cwd) => startProcess(executable, args, cwd, { extraEnvPassthrough: config.extra_env_passthrough }), config.prompt_transport === 'stdin');
     }
     catch {
         console.error('[bridge] CLI unavailable or inspection failed');

package/dist/src/tasks/manager.js

@@ -8,7 +8,7 @@ import { redact } from '../security/redact.js';
 import { delegationState } from '../delegation.js';
 import { startProcess, terminateOwned } from '../antigravity/process.js';
 import { invocationFor, finalEnvelope } from '../antigravity/invocation.js';
-import { packageRoot } from '../paths.js';
+import { helperDirectory } from '../paths.js';
 import { lowerLevel, permissionFlags, permissionState } from '../permissions.js';
 import { listModels, readModel } from '../models.js';
 import { pidAlive, recoverExecutionLock } from './execution-lock.js';
@@ -326,7 +326,7 @@ export class TaskManager {
     }
     /** Models offered by the installed Antigravity CLI (read on demand, never at startup). */
     availableModels() {
-        return this.runtime.models ? this.runtime.models() : listModels(this.runtime.executable, packageRoot, this.config.extra_env_passthrough);
+        return this.runtime.models ? this.runtime.models() : listModels(this.runtime.executable, helperDirectory(), this.config.extra_env_passthrough);
     }
     currentModel() { return readModel(this.runtime.stateDirectory); }
     /** Full record for the web UI: the request, the exact prompt shape sent to the CLI (redacted), and the task with logs. */

package/dist/src/update.js

@@ -139,6 +139,12 @@ export async function isGlobalInstall(root = paths.packageRoot) {
     }
 }
 export const installArgs = (name, version) => ['install', '-g', `${name}@${version}`];
+/** Shown after a failed global install. On Windows the usual cause is something still holding the install folder (EBUSY). */
+export function installFailureHint(name, platform = process.platform) {
+    return platform === 'win32'
+        ? `If npm reported EBUSY, something still uses the install folder: stop every running ${name} (Ctrl+C) and close Codex / Claude Code sessions connected to it, then run "npm install -g ${name}@latest" in a new terminal. Restarting the computer also releases the folder.`
+        : null;
+}
 /** Runs `npm install -g <name>@<version>` in the foreground. Only called after the owner agreed or typed the update command. */
 export function runGlobalInstall(name, version) {
     if (!VERSION.test(version))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agy-mcp-bridge",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Local authenticated HTTP MCP bridge that lets Codex and Claude Code delegate bounded coding tasks to the Antigravity CLI (agy)",
   "license": "MIT",
   "keywords": [