@browserbridge/bbx 1.0.0 → 1.0.1

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

@@ -3,7 +3,11 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { APP_NAME, getManifestInstallDir, SUPPORTED_BROWSERS } from '../../native-host/src/config.js';
+import {
+  APP_NAME,
+  getManifestInstallDir,
+  SUPPORTED_BROWSERS,
+} from '../../native-host/src/config.js';
 import { resolveDefaultExtensionId } from '../../native-host/src/install-manifest.js';
 import { methodNeedsTab } from './cli-helpers.js';
 import { BridgeClient } from './client.js';
@@ -65,7 +69,7 @@ export async function requestBridge(client, method, params = {}, options = {}) {
     method,
     params,
     tabId: methodNeedsTab(method) ? (options.tabId ?? null) : null,
-    meta: withRequestMeta(options.source, options.tokenBudget)
+    meta: withRequestMeta(options.source, options.tokenBudget),
   });
 }
 
@@ -81,9 +85,14 @@ export async function resolveRef(client, refOrSelector, tabId = null, source) {
     return refOrSelector;
   }
 
-  const response = await requestBridge(client, 'dom.query', {
-    selector: refOrSelector
-  }, { tabId, source });
+  const response = await requestBridge(
+    client,
+    'dom.query',
+    {
+      selector: refOrSelector,
+    },
+    { tabId, source }
+  );
 
   if (!response.ok) {
     throw new Error(response.error.message);
@@ -184,9 +193,7 @@ export async function checkBrowserManifests() {
  */
 export async function getDoctorReport(options = {}) {
   const manifest = await (options.loadManifest || loadInstalledManifest)();
-  const allowedOrigins = Array.isArray(manifest?.allowed_origins)
-    ? manifest.allowed_origins
-    : [];
+  const allowedOrigins = Array.isArray(manifest?.allowed_origins) ? manifest.allowed_origins : [];
   const manifestInstalled = Boolean(manifest);
   const defaultExtensionId = options.defaultExtensionIdInfo || resolveDefaultExtensionId();
 
@@ -208,7 +215,7 @@ export async function getDoctorReport(options = {}) {
     routeReason: 'access_disabled',
     issues: [],
     nextSteps: [],
-    browserManifests
+    browserManifests,
   };
 
   try {
@@ -217,7 +224,8 @@ 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,
@@ -227,10 +235,13 @@ export async function getDoctorReport(options = {}) {
       report.daemonReachable = result.daemon === 'ok';
       report.extensionConnected = result.extensionConnected === true;
       report.accessEnabled = result.access?.enabled === true;
-      report.enabledWindowId = typeof result.access?.windowId === 'number' ? result.access.windowId : null;
-      report.routeTabId = typeof result.access?.routeTabId === 'number' ? result.access.routeTabId : null;
+      report.enabledWindowId =
+        typeof result.access?.windowId === 'number' ? result.access.windowId : null;
+      report.routeTabId =
+        typeof result.access?.routeTabId === 'number' ? result.access.routeTabId : null;
       report.routeReady = result.access?.routeReady === true;
-      report.routeReason = typeof result.access?.reason === 'string' ? result.access.reason : 'access_disabled';
+      report.routeReason =
+        typeof result.access?.reason === 'string' ? result.access.reason : 'access_disabled';
     });
   } catch {
     report.daemonReachable = false;
@@ -241,13 +252,17 @@ export async function getDoctorReport(options = {}) {
 
   if (!report.manifestInstalled) {
     report.issues.push('native_host_manifest_missing');
-    report.nextSteps.push(defaultExtensionId.extensionId
-      ? 'Run `bbx install` (or `bbx install --all` for all browsers) to install the native host manifest.'
-      : 'Run `bbx install <extension-id>` (or `bbx install --all`) to install the native host manifest.');
+    report.nextSteps.push(
+      defaultExtensionId.extensionId
+        ? 'Run `bbx install` (or `bbx install --all` for all browsers) to install the native host manifest.'
+        : 'Run `bbx install <extension-id>` (or `bbx install --all`) to install the native host manifest.'
+    );
   } else if (browsersWithoutManifest.length > 0) {
     report.issues.push('native_host_manifest_partial');
     const missing = browsersWithoutManifest.map((b) => b.browser).join(', ');
-    report.nextSteps.push(`Manifests missing for: ${missing}. Run \`bbx install --all\` to install for all supported browsers.`);
+    report.nextSteps.push(
+      `Manifests missing for: ${missing}. Run \`bbx install --all\` to install for all supported browsers.`
+    );
   }
   if (!report.daemonReachable) {
     report.issues.push('daemon_offline');
@@ -255,14 +270,20 @@ export async function getDoctorReport(options = {}) {
   }
   if (report.daemonReachable && !report.extensionConnected) {
     report.issues.push('extension_disconnected');
-    report.nextSteps.push('Open Chrome and make sure the Browser Bridge extension is installed and active.');
+    report.nextSteps.push(
+      'Open Chrome and make sure the Browser Bridge extension is installed and active.'
+    );
   }
   if (report.daemonReachable && report.extensionConnected && !report.accessEnabled) {
     report.issues.push('access_disabled');
-    report.nextSteps.push('If a Browser Bridge call returns ACCESS_DENIED, stop requesting access. Ask the user to click Enable for the needed window, then tell you when that window is ready.');
+    report.nextSteps.push(
+      'If a Browser Bridge call returns ACCESS_DENIED, stop requesting access. Ask the user to click Enable for the needed window, then tell you when that window is ready.'
+    );
   } else if (report.daemonReachable && report.extensionConnected && !report.routeReady) {
     report.issues.push(report.routeReason || 'no_routable_active_tab');
-    report.nextSteps.push('Switch to a supported page in the enabled window, or use an explicit tabId override.');
+    report.nextSteps.push(
+      'Switch to a supported page in the enabled window, or use an explicit tabId override.'
+    );
   }
 
   return report;

package/packages/agent-client/src/setup-status.js

@@ -77,13 +77,9 @@ export async function collectSetupStatus(options = {}) {
   const access = options.access || fs.promises.access.bind(fs.promises);
   const readFile = options.readFile || fs.promises.readFile.bind(fs.promises);
   const detectedMcpClients = new Set(detectMcpClients(options.mcpDetectors));
-  const detectedSkillTargets = new Set(
-    detectSkillTargets(options.skillDetectors),
-  );
+  const detectedSkillTargets = new Set(detectSkillTargets(options.skillDetectors));
   for (const clientName of detectedMcpClients) {
-    if (
-      SUPPORTED_TARGETS.includes(/** @type {SupportedTarget} */ (clientName))
-    ) {
+    if (SUPPORTED_TARGETS.includes(/** @type {SupportedTarget} */ (clientName))) {
       detectedSkillTargets.add(/** @type {SupportedTarget} */ (clientName));
     }
   }
@@ -96,7 +92,7 @@ export async function collectSetupStatus(options = {}) {
         detected: detectedMcpClients.has(clientName),
         readFile,
       });
-    }),
+    })
   );
   const skillTargets = await Promise.all(
     SUPPORTED_TARGETS.map(async (target) => {
@@ -107,7 +103,7 @@ export async function collectSetupStatus(options = {}) {
         access,
         readFile,
       });
-    }),
+    })
   );
 
   return {
@@ -138,12 +134,8 @@ async function collectMcpClientStatus(clientName, options) {
   });
   const entries = await Promise.all(
     configPaths.map(async (configPath) => {
-      return readBrowserBridgeMcpEntry(
-        clientName,
-        configPath,
-        options.readFile,
-      );
-    }),
+      return readBrowserBridgeMcpEntry(clientName, configPath, options.readFile);
+    })
   );
   const preferredEntry =
     entries.find((entry) => entry.configured) ||
@@ -188,20 +180,17 @@ async function collectSkillTargetStatus(target, options) {
         skillName,
         sentinelFilename,
         options.access,
-        options.readFile,
+        options.readFile
       );
-    }),
+    })
   );
   const skillByName = new Map(skills.map((skill) => [skill.name, skill]));
   const coreSkill = skillByName.get(coreSkillName) || null;
   const coreInstalled = Boolean(coreSkill?.exists);
   const coreManaged = Boolean(coreSkill?.exists && coreSkill.managed);
-  const installedVersion = getInstalledSkillBundleVersion(
-    coreSkill ? [coreSkill] : [],
-  );
+  const installedVersion = getInstalledSkillBundleVersion(coreSkill ? [coreSkill] : []);
   const updateAvailable =
-    coreManaged &&
-    isManagedVersionOutdated(coreSkill?.version || null, currentVersion);
+    coreManaged && isManagedVersionOutdated(coreSkill?.version || null, currentVersion);
 
   return {
     key: target,
@@ -230,15 +219,13 @@ async function collectInstalledSkillStatus(
   skillName,
   sentinelFilename,
   access,
-  readFile,
+  readFile
 ) {
   const skillPath = path.join(basePath, skillName);
   const exists = await pathExists(skillPath, access);
   const sentinelPath = path.join(skillPath, sentinelFilename);
   const managed = exists && (await pathExists(sentinelPath, access));
-  const version = managed
-    ? await readManagedSkillVersion(sentinelPath, readFile)
-    : null;
+  const version = managed ? await readManagedSkillVersion(sentinelPath, readFile) : null;
 
   return {
     name: skillName,
@@ -261,9 +248,7 @@ function getInstalledSkillBundleVersion(skills) {
   if (!first || typeof first.version !== 'string') {
     return null;
   }
-  return skills.every((skill) => skill.version === first.version)
-    ? first.version
-    : null;
+  return skills.every((skill) => skill.version === first.version) ? first.version : null;
 }
 
 /**

package/packages/extension/src/background-helpers.js

@@ -14,9 +14,22 @@ import {
 /** @typedef {import('../../protocol/src/types.js').ErrorCode} ErrorCode */
 
 const INTERACTIVE_AX_ROLES = new Set([
-  'button', 'link', 'textbox', 'checkbox', 'radio', 'combobox',
-  'listbox', 'menuitem', 'tab', 'switch', 'slider', 'spinbutton',
-  'searchbox', 'menuitemcheckbox', 'menuitemradio', 'option'
+  'button',
+  'link',
+  'textbox',
+  'checkbox',
+  'radio',
+  'combobox',
+  'listbox',
+  'menuitem',
+  'tab',
+  'switch',
+  'slider',
+  'spinbutton',
+  'searchbox',
+  'menuitemcheckbox',
+  'menuitemradio',
+  'option',
 ]);
 
 /**
@@ -31,7 +44,7 @@ export function summarizeTabResult(tab, method) {
     windowId: typeof tab.windowId === 'number' ? tab.windowId : null,
     url: tab.url ?? '',
     title: tab.title ?? '',
-    status: tab.status ?? 'unknown'
+    status: tab.status ?? 'unknown',
   };
 }
 
@@ -84,7 +97,7 @@ export function simplifyAXNode(node) {
     checked: axTristateValue(node.checked),
     disabled: axBool(node.disabled),
     interactive: INTERACTIVE_AX_ROLES.has(role) || axBool(node.focusable),
-    childIds: Array.isArray(node.childIds) ? node.childIds.map(String) : []
+    childIds: Array.isArray(node.childIds) ? node.childIds.map(String) : [],
   };
 }
 
@@ -99,7 +112,7 @@ export function shouldLogAction(method) {
     'skill.get_runtime_context',
     'setup.get_status',
     'setup.install',
-    'tabs.list'
+    'tabs.list',
   ].includes(method);
 }
 
@@ -130,9 +143,10 @@ export function summarizeActionResult(response) {
     return response.error.message;
   }
 
-  const result = response.result && typeof response.result === 'object'
-    ? /** @type {Record<string, unknown>} */ (response.result)
-    : {};
+  const result =
+    response.result && typeof response.result === 'object'
+      ? /** @type {Record<string, unknown>} */ (response.result)
+      : {};
 
   if (typeof result.patchId === 'string') {
     return `Patch ${result.patchId} applied.`;
@@ -165,24 +179,19 @@ export function summarizeActionResult(response) {
  * }}
  */
 export function estimateResponseTokens(response) {
-  const payload = response.ok
-    ? response.result
-    : { error: response.error };
+  const payload = response.ok ? response.result : { error: response.error };
   const estimate = estimateJsonPayloadCost(payload);
   const responseBytes = estimate.bytes;
-  const result = response.ok && response.result && typeof response.result === 'object'
-    ? /** @type {Record<string, unknown>} */ (response.result)
-    : null;
+  const result =
+    response.ok && response.result && typeof response.result === 'object'
+      ? /** @type {Record<string, unknown>} */ (response.result)
+      : null;
   const hasScreenshot = result != null && typeof result.image === 'string';
   const nodeCount = result != null && Array.isArray(result.nodes) ? result.nodes.length : null;
-  const textPayload = hasScreenshot && result != null
-    ? omitScreenshotImage(result)
-    : payload;
+  const textPayload = hasScreenshot && result != null ? omitScreenshotImage(result) : payload;
   const textEstimate = estimateJsonPayloadCost(textPayload);
   const imageTransportBytes = Math.max(0, responseBytes - textEstimate.bytes);
-  const imageBytes = hasScreenshot && result != null
-    ? estimateInlineImageBytes(result.image)
-    : 0;
+  const imageBytes = hasScreenshot && result != null ? estimateInlineImageBytes(result.image) : 0;
 
   return {
     responseBytes,
@@ -258,11 +267,7 @@ function estimateInlineImageBytes(image) {
     return 0;
   }
 
-  const padding = base64.endsWith('==')
-    ? 2
-    : base64.endsWith('=')
-      ? 1
-      : 0;
+  const padding = base64.endsWith('==') ? 2 : base64.endsWith('=') ? 1 : 0;
   return Math.max(0, Math.floor((base64.length * 3) / 4) - padding);
 }
 
@@ -277,7 +282,12 @@ function estimateInlineImageBytes(image) {
  * @returns {BridgeResponse}
  */
 export function enforceTokenBudget(method, response, tokenBudget) {
-  if (!response.ok || typeof tokenBudget !== 'number' || !Number.isFinite(tokenBudget) || tokenBudget <= 0) {
+  if (
+    !response.ok ||
+    typeof tokenBudget !== 'number' ||
+    !Number.isFinite(tokenBudget) ||
+    tokenBudget <= 0
+  ) {
     return response;
   }
 
@@ -299,7 +309,11 @@ export function enforceTokenBudget(method, response, tokenBudget) {
   let truncated = false;
   let iterations = 0;
   const MAX_BUDGET_ITERATIONS = 100;
-  while (estimateJsonPayloadCost(cloned).bytes > maxBytes && shrinkForBudget(cloned) && iterations < MAX_BUDGET_ITERATIONS) {
+  while (
+    estimateJsonPayloadCost(cloned).bytes > maxBytes &&
+    shrinkForBudget(cloned) &&
+    iterations < MAX_BUDGET_ITERATIONS
+  ) {
     truncated = true;
     iterations += 1;
   }
@@ -355,9 +369,10 @@ function shrinkForBudget(value) {
 
   for (const key of ['image', 'html', 'text', 'value']) {
     if (typeof value[key] === 'string' && value[key].length > 64) {
-      value[key] = key === 'image'
-        ? '[omitted image over token budget]'
-        : `${value[key].slice(0, Math.max(32, Math.floor(value[key].length * 0.75) - 1))}\u2026`;
+      value[key] =
+        key === 'image'
+          ? '[omitted image over token budget]'
+          : `${value[key].slice(0, Math.max(32, Math.floor(value[key].length * 0.75) - 1))}\u2026`;
       if (typeof value.truncated !== 'boolean') {
         value.truncated = true;
       }
@@ -419,9 +434,7 @@ export function getErrorMessage(error) {
  * @returns {string}
  */
 export function normalizeRuntimeErrorMessage(message) {
-  return /^No tab with id[: ]/i.test(message)
-    ? ERROR_CODES.TAB_MISMATCH
-    : message;
+  return /^No tab with id[: ]/i.test(message) ? ERROR_CODES.TAB_MISMATCH : message;
 }
 
 /**
@@ -434,7 +447,7 @@ export function normalizeCropRect(rect = {}) {
     x: Math.max(0, Math.round((rect.x || 0) * scale)),
     y: Math.max(0, Math.round((rect.y || 0) * scale)),
     width: Math.max(1, Math.round((rect.width || 1) * scale)),
-    height: Math.max(1, Math.round((rect.height || 1) * scale))
+    height: Math.max(1, Math.round((rect.height || 1) * scale)),
   };
 }
 
@@ -455,5 +468,7 @@ export function safeOrigin(url) {
  * @returns {Capability | null}
  */
 export function inferCapability(method) {
-  return getMethodCapability(/** @type {import('../../protocol/src/types.js').BridgeMethod} */ (method));
+  return getMethodCapability(
+    /** @type {import('../../protocol/src/types.js').BridgeMethod} */ (method)
+  );
 }

package/packages/extension/src/background-routing.js

@@ -16,7 +16,9 @@ import { ERROR_CODES } from '../../protocol/src/index.js';
  * @returns {boolean}
  */
 export function isRestrictedAutomationUrl(url) {
-  return /^(about:|chrome:|chrome-extension:|chrome-search:|devtools:|edge:|brave:|moz-extension:|view-source:)/i.test(url);
+  return /^(about:|chrome:|chrome-extension:|chrome-search:|devtools:|edge:|brave:|moz-extension:|view-source:)/i.test(
+    url
+  );
 }
 
 /**
@@ -40,11 +42,7 @@ export function selectRequestTabCandidate(requestTabId, explicitTab, activeTab)
  */
 export function resolveWindowScopedTab(tab, enabledWindowId, options = {}) {
   const requireScriptable = options.requireScriptable !== false;
-  if (
-    typeof tab?.id !== 'number'
-    || !Number.isFinite(tab.id)
-    || typeof tab.windowId !== 'number'
-  ) {
+  if (typeof tab?.id !== 'number' || !Number.isFinite(tab.id) || typeof tab.windowId !== 'number') {
     throw new Error(ERROR_CODES.TAB_MISMATCH);
   }
   if (tab.windowId !== enabledWindowId) {
@@ -61,7 +59,7 @@ export function resolveWindowScopedTab(tab, enabledWindowId, options = {}) {
     tabId: tab.id,
     windowId: tab.windowId,
     title: tab.title ?? '',
-    url: tab.url
+    url: tab.url,
   };
 }
 
@@ -71,11 +69,11 @@ export function resolveWindowScopedTab(tab, enabledWindowId, options = {}) {
  */
 export function normalizeRequestedAccessTab(tab) {
   if (
-    typeof tab?.id !== 'number'
-    || !Number.isFinite(tab.id)
-    || typeof tab.windowId !== 'number'
-    || typeof tab.url !== 'string'
-    || !tab.url
+    typeof tab?.id !== 'number' ||
+    !Number.isFinite(tab.id) ||
+    typeof tab.windowId !== 'number' ||
+    typeof tab.url !== 'string' ||
+    !tab.url
   ) {
     return null;
   }
@@ -86,6 +84,6 @@ export function normalizeRequestedAccessTab(tab) {
     tabId: tab.id,
     windowId: tab.windowId,
     title: tab.title ?? '',
-    url: tab.url
+    url: tab.url,
   };
 }