machine-bridge-mcp 0.13.0 → 0.14.0

package/src/local/cli.mjs

@@ -10,7 +10,7 @@ import { runStdioServer } from "./stdio.mjs";
 import { assertCanonicalFullPolicy, DEFAULT_POLICY_PROFILE, DEFAULT_POLICY_REVISION, POLICY_PROFILES, normalizePolicy, policyProfile, toolsForPolicy } from "./tools.mjs";
 import { classifyOperationalError, createLogger, normalizeLogLevel, sanitizeLogText } from "./log.mjs";
 import { activeManagedJobs, inspectResourceFile, loadManagedJobPlan, ManagedJobManager, publicResourceRegistry, validateResourceName } from "./managed-jobs.mjs";
-import { runWrangler } from "./shell.mjs";
+import { run, runWrangler } from "./shell.mjs";
 import { generateRegisteredSshKey } from "./resource-operations.mjs";
 import { runFullAccessTest } from "./full-access-test.mjs";
 import { readBoundedRegularFileSync } from "./secure-file.mjs";
@@ -1124,6 +1124,10 @@ async function doctorCommand(args) {
   const workspace = await chooseWorkspace(args, { promptOnFirstRun: false, save: false, allowPositional: true });
   const checks = [];
   checks.push({ name: "node", ok: isSupportedNodeVersion(), detail: process.version });
+  const npmCommand = npmVersionCommand();
+  const npm = await run(npmCommand.file, npmCommand.args, { capture: true, allowFailure: true, timeoutMs: 10_000 });
+  const npmDetail = sanitizeLines(npm.stdout || npm.stderr);
+  checks.push({ name: "npm", ok: npm.code === 0 && isSupportedNpmVersion(npmDetail), detail: npmDetail || "unavailable" });
   const wrangler = await runWrangler(["--version"], { capture: true, allowFailure: true });
   checks.push({ name: "wrangler", ok: wrangler.code === 0, detail: (wrangler.stdout || wrangler.stderr).trim() });
   const whoami = await runWrangler(["whoami"], { capture: true, allowFailure: true });
@@ -1557,10 +1561,22 @@ function validateWorkerName(value) {
 }
 
 export function isSupportedNodeVersion(version = process.versions.node) {
-  const major = Number(String(version || "").split(".")[0]);
+  const major = Number(String(version || "").replace(/^v/, "").split(".")[0]);
   return Number.isInteger(major) && major >= 26;
 }
 
+export function isSupportedNpmVersion(version) {
+  const major = Number(String(version || "").trim().replace(/^v/, "").split(".")[0]);
+  return Number.isInteger(major) && major >= 12;
+}
+
+export function npmVersionCommand(platform = process.platform, comspec = process.env.ComSpec) {
+  if (platform === "win32") {
+    return { file: comspec || "cmd.exe", args: ["/d", "/s", "/c", "npm --version"] };
+  }
+  return { file: "npm", args: ["--version"] };
+}
+
 function assertNodeVersion() {
   if (!isSupportedNodeVersion()) throw new Error(`Node.js >=26 is required; current ${process.version}`);
 }
@@ -1568,8 +1584,10 @@ function assertNodeVersion() {
 function usage() {
   console.log(`machine-bridge-mcp
 
+Installation (run from a package-free temporary directory; Node.js >=26):
+  npx --yes npm@12.0.1 install --global --omit=optional --allow-scripts=esbuild,workerd,sharp,fsevents machine-bridge-mcp@latest && machine-mcp
+
 Usage:
-  npm install -g --omit=optional --allow-scripts=esbuild,workerd,sharp,fsevents machine-bridge-mcp@latest && machine-mcp
   npx machine-bridge-mcp@latest                  # no global install; autostart may rely on npm cache
   ./mbm                                          # from source checkout
   .\\mbm.cmd                                      # from source checkout on Windows cmd

package/src/local/runtime.mjs

@@ -46,6 +46,8 @@ const RUNTIME_TOOL_HANDLERS = Object.freeze({
   browser_status: (runtime, _args, context) => runtime.browserBridgeManager.status(context),
   pair_browser_extension: (runtime, args, context) => runtime.browserBridgeManager.pair(args, context),
   browser_list_tabs: (runtime, args, context) => runtime.browserBridgeManager.listTabs(args, context),
+  browser_manage_tabs: (runtime, args, context) => runtime.browserBridgeManager.manageTabs(args, context),
+  browser_wait: (runtime, args, context) => runtime.browserBridgeManager.wait(args, context),
   browser_get_source: (runtime, args, context) => runtime.browserBridgeManager.getSource(args, context),
   browser_inspect_page: (runtime, args, context) => runtime.browserBridgeManager.inspectPage(args, context),
   browser_action: (runtime, args, context) => runtime.browserBridgeManager.act(args, context),

package/src/shared/tool-catalog.json

@@ -385,6 +385,55 @@
       }
     }
   },
+  {
+    "name": "browser_manage_tabs",
+    "title": "Manage browser tabs",
+    "description": "Create, activate, or close tabs in the paired existing browser profile.",
+    "availability": "full",
+    "annotations": {
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true
+    },
+    "inputSchema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "action": {
+          "type": "string",
+          "enum": [
+            "new",
+            "activate",
+            "close"
+          ]
+        },
+        "tab_id": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Required for activate and close."
+        },
+        "url": {
+          "type": "string",
+          "maxLength": 32768,
+          "description": "Optional absolute http, https, or file URL for a new tab."
+        },
+        "active": {
+          "type": "boolean",
+          "default": true
+        },
+        "timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 120,
+          "default": 30
+        }
+      },
+      "required": [
+        "action"
+      ]
+    }
+  },
   {
     "name": "browser_get_source",
     "title": "Read browser page source",
@@ -473,10 +522,115 @@
       }
     }
   },
+  {
+    "name": "browser_wait",
+    "title": "Wait for browser state",
+    "description": "Wait until all supplied URL, load, text, and element-state conditions are satisfied in an existing browser tab.",
+    "availability": "full",
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": true
+    },
+    "inputSchema": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tab_id": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "frame_id": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "selector": {
+          "type": "object",
+          "properties": {
+            "ref": {
+              "type": "string",
+              "maxLength": 100,
+              "description": "Stable element reference returned by browser_inspect_page for the same document and frame."
+            },
+            "css": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "id": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "name": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "label": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "text": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "role": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "placeholder": {
+              "type": "string",
+              "maxLength": 2000
+            },
+            "index": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 10000
+            }
+          },
+          "additionalProperties": false
+        },
+        "state": {
+          "type": "string",
+          "enum": [
+            "attached",
+            "detached",
+            "visible",
+            "hidden",
+            "enabled",
+            "editable",
+            "checked",
+            "unchecked"
+          ],
+          "description": "Element state to wait for. Defaults to visible only when selector is supplied."
+        },
+        "text": {
+          "type": "string",
+          "maxLength": 4000
+        },
+        "url_contains": {
+          "type": "string",
+          "maxLength": 32768
+        },
+        "load_state": {
+          "type": "string",
+          "enum": [
+            "domcontentloaded",
+            "complete"
+          ]
+        },
+        "timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 120,
+          "default": 30
+        }
+      }
+    }
+  },
   {
     "name": "browser_action",
     "title": "Operate browser page",
-    "description": "Perform one structured navigation or DOM action in the user's existing browser tab without accepting arbitrary JavaScript.",
+    "description": "Perform one structured navigation or page action in the user's existing browser tab, with automatic actionability waits and optional fixed DevTools input, without accepting arbitrary JavaScript.",
     "availability": "full",
     "annotations": {
       "readOnlyHint": false,
@@ -506,12 +660,21 @@
             "submit",
             "reload",
             "back",
-            "forward"
+            "forward",
+            "double_click",
+            "hover",
+            "type_text",
+            "scroll_into_view"
           ]
         },
         "selector": {
           "type": "object",
           "properties": {
+            "ref": {
+              "type": "string",
+              "maxLength": 100,
+              "description": "Stable element reference returned by browser_inspect_page for the same document and frame."
+            },
             "css": {
               "type": "string",
               "maxLength": 2000
@@ -582,6 +745,22 @@
         "frame_id": {
           "type": "integer",
           "minimum": 0
+        },
+        "input_mode": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "trusted",
+            "dom"
+          ],
+          "default": "auto",
+          "description": "Use fixed DevTools Input commands when possible, require them, or use DOM events only."
+        },
+        "element_timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60,
+          "default": 10
         }
       },
       "required": [
@@ -618,6 +797,11 @@
               "selector": {
                 "type": "object",
                 "properties": {
+                  "ref": {
+                    "type": "string",
+                    "maxLength": 100,
+                    "description": "Stable element reference returned by browser_inspect_page for the same document and frame."
+                  },
                   "css": {
                     "type": "string",
                     "maxLength": 2000
@@ -691,6 +875,11 @@
         "submit_selector": {
           "type": "object",
           "properties": {
+            "ref": {
+              "type": "string",
+              "maxLength": 100,
+              "description": "Stable element reference returned by browser_inspect_page for the same document and frame."
+            },
             "css": {
               "type": "string",
               "maxLength": 2000
@@ -745,6 +934,12 @@
         "frame_id": {
           "type": "integer",
           "minimum": 0
+        },
+        "element_timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60,
+          "default": 10
         }
       },
       "required": [
@@ -815,6 +1010,11 @@
         "selector": {
           "type": "object",
           "properties": {
+            "ref": {
+              "type": "string",
+              "maxLength": 100,
+              "description": "Stable element reference returned by browser_inspect_page for the same document and frame."
+            },
             "css": {
               "type": "string",
               "maxLength": 2000
@@ -885,6 +1085,12 @@
         "frame_id": {
           "type": "integer",
           "minimum": 0
+        },
+        "element_timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 60,
+          "default": 10
         }
       },
       "required": [

package/src/worker/index.ts

@@ -3,7 +3,7 @@ import toolCatalog from "../shared/tool-catalog.json";
 import serverMetadata from "../shared/server-metadata.json";
 
 const SERVER_NAME = String(serverMetadata.name);
-const SERVER_VERSION = "0.13.0";
+const SERVER_VERSION = "0.14.0";
 const MCP_PROTOCOL_VERSION = String(serverMetadata.protocolVersion);
 const MCP_SUPPORTED_PROTOCOL_VERSIONS = serverMetadata.supportedProtocolVersions.map((value) => String(value));
 const JSONRPC_VERSION = "2.0";
@@ -817,6 +817,7 @@ export class BridgeRoom extends DurableObject<BridgeEnv> {
       client.last_used_at = now;
 
       const code = randomToken("mcp_code");
+      const redirectLocation = authorizationRedirectLocation(redirectUri, code, state);
       store.codes[code] = {
         client_id: clientId,
         redirect_uri: redirectUri,
@@ -829,9 +830,7 @@ export class BridgeRoom extends DurableObject<BridgeEnv> {
       pruneRecordByExpiry(store.codes, MAX_OAUTH_CODES);
       await this.ctx.storage.put("oauth", store);
 
-      const params = new URLSearchParams({ code });
-      if (state) params.set("state", state);
-      return oauthRedirect(`${redirectUri}${redirectUri.includes("?") ? "&" : "?"}${params.toString()}`);
+      return oauthRedirect(redirectLocation);
     });
   }
 
@@ -996,11 +995,11 @@ function methodNotAllowed(allow: string): Response {
   });
 }
 
-function oauthRedirect(location: string): Response {
+function oauthRedirect(location: URL): Response {
   return new Response(null, {
-    status: 302,
+    status: 303,
     headers: {
-      location,
+      location: location.href,
       "cache-control": "no-store",
       "referrer-policy": "no-referrer",
       "x-content-type-options": "nosniff",
@@ -1008,6 +1007,13 @@ function oauthRedirect(location: string): Response {
   });
 }
 
+function authorizationRedirectLocation(redirectUri: string, code: string, state: string): URL {
+  const location = new URL(redirectUri);
+  location.searchParams.append("code", code);
+  if (state) location.searchParams.append("state", state);
+  return location;
+}
+
 function isFreshDaemonCandidate(connectedAt: string): boolean {
   const timestamp = Date.parse(connectedAt);
   if (!Number.isFinite(timestamp)) return false;
@@ -1187,7 +1193,7 @@ function daemonToolTimeoutMs(name: string, args: Record<string, unknown>): numbe
   const configurable = new Set([
     "exec_command", "run_process", "run_local_command", "open_local_application",
     "inspect_local_application", "operate_local_application", "browser_list_tabs",
-    "browser_get_source", "browser_inspect_page", "browser_action", "browser_fill_form",
+    "browser_manage_tabs", "browser_wait", "browser_get_source", "browser_inspect_page", "browser_action", "browser_fill_form",
     "browser_screenshot", "browser_upload_files",
   ]);
   if (!configurable.has(name)) return 60_000;