@browserbridge/bbx 1.7.5 → 1.7.6

package/packages/agent-client/src/runtime.js

@@ -433,8 +433,7 @@ export async function getDoctorReport(options = {}) {
       if (!response.ok) {
         throw new Error(response.error.message);
       }
-      const result =
-        /** @type {{ daemon?: string, extensionConnected?: boolean, access?: {
+      const result = /** @type {{ daemon?: string, extensionConnected?: boolean, access?: {
         enabled?: boolean,
         windowId?: number | null,
         routeTabId?: number | null,

package/packages/native-host/src/auth-token.js

@@ -60,7 +60,7 @@ export async function readBridgeAuthTokenOverride(options = {}) {
 }
 
 /**
- * @param {{ tokenPath?: string, readFile?: typeof fs.promises.readFile }} [options={}]
+ * @param {{ env?: NodeJS.ProcessEnv, tokenPath?: string, readFile?: typeof fs.promises.readFile }} [options={}]
  * @returns {Promise<string | null>}
  */
 export async function readBridgeAuthToken(options = {}) {

package/packages/native-host/src/config.js

@@ -3,6 +3,7 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { createHash } from 'node:crypto';
 
 export const APP_NAME = 'com.browserbridge.browser_bridge';
 export const BRIDGE_HOME_ENV = 'BROWSER_BRIDGE_HOME';
@@ -62,15 +63,19 @@ export function getBridgeDir(env = process.env) {
  * connect to. On Windows we use a Named Pipe by default because Node's AF_UNIX
  * support fails with EACCES on listen() under recent Node + Windows 11
  * combinations, while Named Pipes are the historical and reliable Windows IPC
- * mechanism. An explicit bridge-home override keeps the legacy socket path so
- * callers can opt into custom test or compatibility setups.
+ * mechanism. Custom bridge homes use a stable suffix so isolated daemon and
+ * test setups do not contend for the default pipe.
  *
  * @param {NodeJS.ProcessEnv} [env=process.env]
  * @returns {string}
  */
 export function getSocketPath(env = process.env) {
-  if (os.platform() === 'win32' && !env[BRIDGE_HOME_ENV]) {
-    return `\\\\.\\pipe\\${APP_NAME}`;
+  if (os.platform() === 'win32') {
+    const bridgeHome = env[BRIDGE_HOME_ENV];
+    const suffix = bridgeHome
+      ? `-${createHash('sha256').update(bridgeHome.toLowerCase()).digest('hex').slice(0, 16)}`
+      : '';
+    return `\\\\.\\pipe\\${APP_NAME}${suffix}`;
   }
   return path.join(getBridgeDir(env), 'bridge.sock');
 }

package/packages/native-host/src/daemon-process.js

@@ -407,10 +407,17 @@ async function restartBridgeDaemonAfterStop(stopResult, options = {}) {
     throw new Error('Timed out waiting for Browser Bridge daemon to start.');
   }
 
+  let pid = await readPidFn(pidPath);
+  if (pid === null) {
+    // The daemon starts listening immediately before it persists its PID.
+    await sleepFn(pollIntervalMs);
+    pid = await readPidFn(pidPath);
+  }
+
   return {
     ...stopResult,
     pidPath,
-    pid: await readPidFn(pidPath),
+    pid,
   };
 }
 

package/packages/protocol/src/capabilities.js

@@ -1,122 +1,45 @@
 // @ts-check
 
+import { CAPABILITIES, DEFAULT_CAPABILITIES } from './capability-values.js';
+import { BRIDGE_METHODS, BRIDGE_METHOD_REGISTRY } from './registry.js';
+
 /** @typedef {import('./types.js').BridgeMethod} CapabilityMethod */
 /** @typedef {import('./types.js').Capability} Capability */
 
-export const CAPABILITIES = Object.freeze({
-  PAGE_READ: 'page.read',
-  PAGE_EVALUATE: 'page.evaluate',
-  DOM_READ: 'dom.read',
-  STYLES_READ: 'styles.read',
-  LAYOUT_READ: 'layout.read',
-  VIEWPORT_CONTROL: 'viewport.control',
-  NAVIGATION_CONTROL: 'navigation.control',
-  SCREENSHOT_PARTIAL: 'screenshot.partial',
-  PATCH_DOM: 'patch.dom',
-  PATCH_STYLES: 'patch.styles',
-  CDP_DOM_SNAPSHOT: 'cdp.dom_snapshot',
-  CDP_BOX_MODEL: 'cdp.box_model',
-  CDP_STYLES: 'cdp.styles',
-  CDP_INPUT: 'cdp.input',
-  AUTOMATION_INPUT: 'automation.input',
-  TABS_MANAGE: 'tabs.manage',
-  PERFORMANCE_READ: 'performance.read',
-  NETWORK_READ: 'network.read',
-  NETWORK_INTERCEPT: 'network.intercept',
-});
+export { CAPABILITIES, DEFAULT_CAPABILITIES };
+
+/** @type {readonly CapabilityMethod[]} */
+const LEGACY_METHOD_CAPABILITY_PREFIX = [
+  'access.request',
+  'tabs.list',
+  'tabs.create',
+  'tabs.close',
+  'tabs.activate',
+  'skill.get_runtime_context',
+  'setup.get_status',
+  'setup.install',
+];
+
+/** @type {readonly CapabilityMethod[]} */
+const LEGACY_METHOD_CAPABILITY_SUFFIX = ['log.tail', 'health.ping', 'daemon.metrics'];
 
-export const DEFAULT_CAPABILITIES = Object.freeze([
-  CAPABILITIES.PAGE_READ,
-  CAPABILITIES.PAGE_EVALUATE,
-  CAPABILITIES.DOM_READ,
-  CAPABILITIES.STYLES_READ,
-  CAPABILITIES.LAYOUT_READ,
-  CAPABILITIES.VIEWPORT_CONTROL,
-  CAPABILITIES.NAVIGATION_CONTROL,
-  CAPABILITIES.SCREENSHOT_PARTIAL,
-  CAPABILITIES.PATCH_DOM,
-  CAPABILITIES.PATCH_STYLES,
-  CAPABILITIES.AUTOMATION_INPUT,
-  CAPABILITIES.CDP_DOM_SNAPSHOT,
-  CAPABILITIES.CDP_BOX_MODEL,
-  CAPABILITIES.CDP_STYLES,
-  CAPABILITIES.CDP_INPUT,
-  CAPABILITIES.TABS_MANAGE,
-  CAPABILITIES.PERFORMANCE_READ,
-  CAPABILITIES.NETWORK_READ,
-  CAPABILITIES.NETWORK_INTERCEPT,
+const LEGACY_POSITIONED_METHODS = new Set([
+  ...LEGACY_METHOD_CAPABILITY_PREFIX,
+  ...LEGACY_METHOD_CAPABILITY_SUFFIX,
 ]);
 
 /** @type {Readonly<Record<CapabilityMethod, Capability | null>>} */
-export const METHOD_CAPABILITIES = Object.freeze({
-  'access.request': null,
-  'tabs.list': null,
-  'tabs.create': CAPABILITIES.TABS_MANAGE,
-  'tabs.close': CAPABILITIES.TABS_MANAGE,
-  'tabs.activate': CAPABILITIES.TABS_MANAGE,
-  'skill.get_runtime_context': null,
-  'setup.get_status': null,
-  'setup.install': null,
-  'page.get_state': CAPABILITIES.PAGE_READ,
-  'page.evaluate': CAPABILITIES.PAGE_EVALUATE,
-  'page.get_console': CAPABILITIES.PAGE_READ,
-  'page.wait_for_load_state': CAPABILITIES.PAGE_READ,
-  'page.get_storage': CAPABILITIES.PAGE_READ,
-  'page.get_text': CAPABILITIES.PAGE_READ,
-  'page.get_network': CAPABILITIES.NETWORK_READ,
-  // Interception mutates traffic (block/forge responses) - distinct from
-  // passive network reads so hosts can gate it independently.
-  'network.intercept.add': CAPABILITIES.NETWORK_INTERCEPT,
-  'network.intercept.remove': CAPABILITIES.NETWORK_INTERCEPT,
-  'network.intercept.list': CAPABILITIES.NETWORK_INTERCEPT,
-  'network.intercept.clear': CAPABILITIES.NETWORK_INTERCEPT,
-  'navigation.navigate': CAPABILITIES.NAVIGATION_CONTROL,
-  'navigation.reload': CAPABILITIES.NAVIGATION_CONTROL,
-  'navigation.go_back': CAPABILITIES.NAVIGATION_CONTROL,
-  'navigation.go_forward': CAPABILITIES.NAVIGATION_CONTROL,
-  'dom.query': CAPABILITIES.DOM_READ,
-  'dom.describe': CAPABILITIES.DOM_READ,
-  'dom.get_text': CAPABILITIES.DOM_READ,
-  'dom.get_attributes': CAPABILITIES.DOM_READ,
-  'dom.wait_for': CAPABILITIES.DOM_READ,
-  'dom.find_by_text': CAPABILITIES.DOM_READ,
-  'dom.find_by_role': CAPABILITIES.DOM_READ,
-  'dom.get_html': CAPABILITIES.DOM_READ,
-  'dom.get_accessibility_tree': CAPABILITIES.DOM_READ,
-  'layout.get_box_model': CAPABILITIES.LAYOUT_READ,
-  'layout.hit_test': CAPABILITIES.LAYOUT_READ,
-  'styles.get_computed': CAPABILITIES.STYLES_READ,
-  'styles.get_matched_rules': CAPABILITIES.STYLES_READ,
-  'viewport.scroll': CAPABILITIES.VIEWPORT_CONTROL,
-  'viewport.resize': CAPABILITIES.VIEWPORT_CONTROL,
-  'input.click': CAPABILITIES.AUTOMATION_INPUT,
-  'input.focus': CAPABILITIES.AUTOMATION_INPUT,
-  'input.type': CAPABILITIES.AUTOMATION_INPUT,
-  'input.fill': CAPABILITIES.AUTOMATION_INPUT,
-  'input.press_key': CAPABILITIES.AUTOMATION_INPUT,
-  'input.set_checked': CAPABILITIES.AUTOMATION_INPUT,
-  'input.select_option': CAPABILITIES.AUTOMATION_INPUT,
-  'input.hover': CAPABILITIES.AUTOMATION_INPUT,
-  'input.drag': CAPABILITIES.AUTOMATION_INPUT,
-  'input.scroll_into_view': CAPABILITIES.AUTOMATION_INPUT,
-  'screenshot.capture_region': CAPABILITIES.SCREENSHOT_PARTIAL,
-  'screenshot.capture_element': CAPABILITIES.SCREENSHOT_PARTIAL,
-  'screenshot.capture_full_page': CAPABILITIES.SCREENSHOT_PARTIAL,
-  'patch.apply_styles': CAPABILITIES.PATCH_STYLES,
-  'patch.apply_dom': CAPABILITIES.PATCH_DOM,
-  'patch.list': CAPABILITIES.PATCH_DOM,
-  'patch.rollback': CAPABILITIES.PATCH_DOM,
-  'patch.commit_session_baseline': CAPABILITIES.PATCH_DOM,
-  'cdp.get_document': CAPABILITIES.CDP_DOM_SNAPSHOT,
-  'cdp.get_dom_snapshot': CAPABILITIES.CDP_DOM_SNAPSHOT,
-  'cdp.get_box_model': CAPABILITIES.CDP_BOX_MODEL,
-  'cdp.get_computed_styles_for_node': CAPABILITIES.CDP_STYLES,
-  'cdp.dispatch_key_event': CAPABILITIES.CDP_INPUT,
-  'performance.get_metrics': CAPABILITIES.PERFORMANCE_READ,
-  'log.tail': null,
-  'health.ping': null,
-  'daemon.metrics': null,
-});
+export const METHOD_CAPABILITIES = Object.freeze(
+  /** @type {Record<CapabilityMethod, Capability | null>} */ (
+    Object.fromEntries(
+      [
+        ...LEGACY_METHOD_CAPABILITY_PREFIX,
+        ...BRIDGE_METHODS.filter((method) => !LEGACY_POSITIONED_METHODS.has(method)),
+        ...LEGACY_METHOD_CAPABILITY_SUFFIX,
+      ].map((method) => [method, BRIDGE_METHOD_REGISTRY[method].capability])
+    )
+  )
+);
 
 /**
  * @param {unknown} value

package/packages/protocol/src/capability-values.js

@@ -0,0 +1,45 @@
+// @ts-check
+
+export const CAPABILITIES = Object.freeze({
+  PAGE_READ: 'page.read',
+  PAGE_EVALUATE: 'page.evaluate',
+  DOM_READ: 'dom.read',
+  STYLES_READ: 'styles.read',
+  LAYOUT_READ: 'layout.read',
+  VIEWPORT_CONTROL: 'viewport.control',
+  NAVIGATION_CONTROL: 'navigation.control',
+  SCREENSHOT_PARTIAL: 'screenshot.partial',
+  PATCH_DOM: 'patch.dom',
+  PATCH_STYLES: 'patch.styles',
+  CDP_DOM_SNAPSHOT: 'cdp.dom_snapshot',
+  CDP_BOX_MODEL: 'cdp.box_model',
+  CDP_STYLES: 'cdp.styles',
+  CDP_INPUT: 'cdp.input',
+  AUTOMATION_INPUT: 'automation.input',
+  TABS_MANAGE: 'tabs.manage',
+  PERFORMANCE_READ: 'performance.read',
+  NETWORK_READ: 'network.read',
+  NETWORK_INTERCEPT: 'network.intercept',
+});
+
+export const DEFAULT_CAPABILITIES = Object.freeze([
+  CAPABILITIES.PAGE_READ,
+  CAPABILITIES.PAGE_EVALUATE,
+  CAPABILITIES.DOM_READ,
+  CAPABILITIES.STYLES_READ,
+  CAPABILITIES.LAYOUT_READ,
+  CAPABILITIES.VIEWPORT_CONTROL,
+  CAPABILITIES.NAVIGATION_CONTROL,
+  CAPABILITIES.SCREENSHOT_PARTIAL,
+  CAPABILITIES.PATCH_DOM,
+  CAPABILITIES.PATCH_STYLES,
+  CAPABILITIES.AUTOMATION_INPUT,
+  CAPABILITIES.CDP_DOM_SNAPSHOT,
+  CAPABILITIES.CDP_BOX_MODEL,
+  CAPABILITIES.CDP_STYLES,
+  CAPABILITIES.CDP_INPUT,
+  CAPABILITIES.TABS_MANAGE,
+  CAPABILITIES.PERFORMANCE_READ,
+  CAPABILITIES.NETWORK_READ,
+  CAPABILITIES.NETWORK_INTERCEPT,
+]);

package/packages/protocol/src/defaults.js

@@ -1,5 +1,7 @@
 // @ts-check
 
+import { BRIDGE_METHODS, BRIDGE_METHOD_REGISTRY } from './registry.js';
+
 /**
  * Shared Browser Bridge defaults used by the protocol, MCP layer, and runtime
  * guidance. Keep this as the source of truth for default limits and presets.
@@ -70,8 +72,8 @@ export const BUDGET_PRESETS = Object.freeze({
   deep: { maxNodes: 100, maxDepth: 8, textBudget: 2000, tokenBudget: 4000 },
 });
 
-/** @type {ReadonlySet<string>} */
-export const DEBUGGER_BACKED_METHODS = new Set([
+/** @type {readonly import('./types.js').BridgeMethod[]} */
+const LEGACY_DEBUGGER_BACKED_METHOD_ORDER = [
   'page.evaluate',
   'dom.get_accessibility_tree',
   'viewport.resize',
@@ -88,6 +90,19 @@ export const DEBUGGER_BACKED_METHODS = new Set([
   'cdp.get_box_model',
   'cdp.get_computed_styles_for_node',
   'cdp.dispatch_key_event',
+];
+
+const LEGACY_DEBUGGER_BACKED_METHODS = new Set(LEGACY_DEBUGGER_BACKED_METHOD_ORDER);
+
+/** @type {ReadonlySet<string>} */
+export const DEBUGGER_BACKED_METHODS = new Set([
+  ...LEGACY_DEBUGGER_BACKED_METHOD_ORDER.filter(
+    (method) => BRIDGE_METHOD_REGISTRY[method].debuggerBacked
+  ),
+  ...BRIDGE_METHODS.filter(
+    (method) =>
+      BRIDGE_METHOD_REGISTRY[method].debuggerBacked && !LEGACY_DEBUGGER_BACKED_METHODS.has(method)
+  ),
 ]);
 
 /**