@browserbridge/bbx 1.0.0 → 1.1.0

package/manifest.json

@@ -1,52 +0,0 @@
-{
-  "manifest_version": 3,
-  "minimum_chrome_version": "114",
-  "name": "Browser Bridge",
-  "version": "1.0.0",
-  "description": "Local bridge between your coding agent and browser. Structured access to DOM, styles, console, network, and reversible patches.",
-  "icons": {
-    "16": "packages/extension/assets/icon-16.png",
-    "32": "packages/extension/assets/icon-32.png",
-    "48": "packages/extension/assets/icon-48.png",
-    "128": "packages/extension/assets/icon-128.png"
-  },
-  "permissions": [
-    "activeTab",
-    "alarms",
-    "debugger",
-    "nativeMessaging",
-    "scripting",
-    "sidePanel",
-    "storage",
-    "tabs",
-    "offscreen"
-  ],
-  "host_permissions": [
-    "<all_urls>"
-  ],
-  "background": {
-    "service_worker": "packages/extension/src/background.js",
-    "type": "module"
-  },
-  "action": {
-    "default_title": "Browser Bridge",
-    "default_popup": "packages/extension/ui/popup.html",
-    "default_icon": {
-      "16": "packages/extension/assets/icon-16.png",
-      "32": "packages/extension/assets/icon-32.png"
-    }
-  },
-  "side_panel": {
-    "default_path": "packages/extension/ui/sidepanel.html"
-  },
-  "web_accessible_resources": [
-    {
-      "resources": [
-        "packages/extension/ui/ui.css"
-      ],
-      "matches": [
-        "<all_urls>"
-      ]
-    }
-  ]
-}

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

@@ -1,459 +0,0 @@
-// @ts-check
-
-import {
-  ERROR_CODES,
-  estimateJsonPayloadCost,
-  getMethodCapability,
-  getCostClass,
-  getUtf8ByteLength,
-  isDebuggerBackedMethod,
-} from '../../protocol/src/index.js';
-
-/** @typedef {import('../../protocol/src/types.js').BridgeResponse} BridgeResponse */
-/** @typedef {import('../../protocol/src/types.js').Capability} Capability */
-/** @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'
-]);
-
-/**
- * @param {chrome.tabs.Tab} tab
- * @param {string} method
- * @returns {{ method: string, tabId: number | null, windowId: number | null, url: string, title: string, status: string }}
- */
-export function summarizeTabResult(tab, method) {
-  return {
-    method,
-    tabId: typeof tab.id === 'number' ? tab.id : null,
-    windowId: typeof tab.windowId === 'number' ? tab.windowId : null,
-    url: tab.url ?? '',
-    title: tab.title ?? '',
-    status: tab.status ?? 'unknown'
-  };
-}
-
-/**
- * @param {unknown} prop
- * @returns {string}
- */
-export function axValue(prop) {
-  if (!prop || typeof prop !== 'object') return '';
-  const val = /** @type {{ value?: unknown }} */ (prop).value;
-  return typeof val === 'string' ? val : '';
-}
-
-/**
- * @param {unknown} prop
- * @returns {boolean}
- */
-export function axBool(prop) {
-  if (!prop || typeof prop !== 'object') return false;
-  return /** @type {{ value?: unknown }} */ (prop).value === true;
-}
-
-/**
- * @param {unknown} prop
- * @returns {string | null}
- */
-export function axTristateValue(prop) {
-  if (!prop || typeof prop !== 'object') return null;
-  const val = /** @type {{ value?: unknown }} */ (prop).value;
-  if (val === 'true' || val === true) return 'true';
-  if (val === 'false' || val === false) return 'false';
-  if (val === 'mixed') return 'mixed';
-  return null;
-}
-
-/**
- * @param {Record<string, unknown>} node
- * @returns {{ nodeId: string, role: string, name: string, description: string, value: string, focused: boolean, required: boolean, checked: string | null, disabled: boolean, interactive: boolean, childIds: string[] }}
- */
-export function simplifyAXNode(node) {
-  const role = axValue(node.role);
-  return {
-    nodeId: String(node.nodeId ?? ''),
-    role,
-    name: axValue(node.name),
-    description: axValue(node.description),
-    value: axValue(node.value),
-    focused: axBool(node.focused),
-    required: axBool(node.required),
-    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) : []
-  };
-}
-
-/**
- * @param {string} method
- * @returns {boolean}
- */
-export function shouldLogAction(method) {
-  return ![
-    'health.ping',
-    'log.tail',
-    'skill.get_runtime_context',
-    'setup.get_status',
-    'setup.install',
-    'tabs.list'
-  ].includes(method);
-}
-
-/**
- * Treat page exceptions as part of the error stream so filtered reads return
- * runtime failures alongside explicit `console.error` calls.
- *
- * @param {string} requestedLevel
- * @param {string} entryLevel
- * @returns {boolean}
- */
-export function matchesConsoleLevel(requestedLevel, entryLevel) {
-  if (requestedLevel === entryLevel) {
-    return true;
-  }
-  if (requestedLevel === 'error') {
-    return entryLevel === 'exception' || entryLevel === 'rejection';
-  }
-  return false;
-}
-
-/**
- * @param {BridgeResponse} response
- * @returns {string}
- */
-export function summarizeActionResult(response) {
-  if (!response.ok) {
-    return response.error.message;
-  }
-
-  const result = response.result && typeof response.result === 'object'
-    ? /** @type {Record<string, unknown>} */ (response.result)
-    : {};
-
-  if (typeof result.patchId === 'string') {
-    return `Patch ${result.patchId} applied.`;
-  }
-
-  if (Array.isArray(result.nodes)) {
-    return `${result.nodes.length} node(s) returned.`;
-  }
-
-  if (typeof result.image === 'string') {
-    return 'Partial screenshot captured.';
-  }
-
-  return 'Completed successfully.';
-}
-
-/**
- * Estimate approximate token cost from a bridge response.
- *
- * @param {BridgeResponse} response
- * @returns {{
- *   responseBytes: number,
- *   approxTokens: number,
- *   textBytes: number,
- *   textApproxTokens: number,
- *   imageApproxTokens: number,
- *   imageBytes: number,
- *   hasScreenshot: boolean,
- *   nodeCount: number | null
- * }}
- */
-export function estimateResponseTokens(response) {
-  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 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 textEstimate = estimateJsonPayloadCost(textPayload);
-  const imageTransportBytes = Math.max(0, responseBytes - textEstimate.bytes);
-  const imageBytes = hasScreenshot && result != null
-    ? estimateInlineImageBytes(result.image)
-    : 0;
-
-  return {
-    responseBytes,
-    approxTokens: estimate.approxTokens,
-    textBytes: textEstimate.bytes,
-    textApproxTokens: textEstimate.approxTokens,
-    imageApproxTokens: imageTransportBytes === 0 ? 0 : Math.ceil(imageTransportBytes / 4),
-    imageBytes,
-    hasScreenshot,
-    nodeCount,
-  };
-}
-
-/**
- * @param {string} method
- * @param {BridgeResponse} response
- * @returns {{
- *   responseBytes: number,
- *   approxTokens: number,
- *   textBytes: number,
- *   textApproxTokens: number,
- *   imageApproxTokens: number,
- *   imageBytes: number,
- *   hasScreenshot: boolean,
- *   nodeCount: number | null,
- *   costClass: 'cheap' | 'moderate' | 'heavy' | 'extreme',
- *   textCostClass: 'cheap' | 'moderate' | 'heavy' | 'extreme',
- *   debuggerBacked: boolean
- * }}
- */
-export function getResponseDiagnostics(method, response) {
-  const estimate = estimateResponseTokens(response);
-  return {
-    ...estimate,
-    costClass: getCostClass(estimate.approxTokens),
-    textCostClass: getCostClass(estimate.textApproxTokens),
-    debuggerBacked: isDebuggerBackedMethod(method),
-  };
-}
-
-/**
- * Keep screenshot metadata while excluding the large inline image payload from
- * token-oriented UI estimates.
- *
- * @param {Record<string, unknown>} result
- * @returns {Record<string, unknown>}
- */
-function omitScreenshotImage(result) {
-  const textPayload = { ...result };
-  delete textPayload.image;
-  return textPayload;
-}
-
-/**
- * Estimate decoded image bytes for data URLs so the UI can show image size
- * without pretending the base64 blob is text-token traffic.
- *
- * @param {unknown} image
- * @returns {number}
- */
-function estimateInlineImageBytes(image) {
-  if (typeof image !== 'string' || image.length === 0) {
-    return 0;
-  }
-
-  const match = /^data:[^;]+;base64,([A-Za-z0-9+/=\s]+)$/u.exec(image);
-  if (!match) {
-    return getUtf8ByteLength(image);
-  }
-
-  const base64 = match[1].replace(/\s+/gu, '');
-  if (base64.length === 0) {
-    return 0;
-  }
-
-  const padding = base64.endsWith('==')
-    ? 2
-    : base64.endsWith('=')
-      ? 1
-      : 0;
-  return Math.max(0, Math.floor((base64.length * 3) / 4) - padding);
-}
-
-/**
- * Deterministically trim oversized success payloads to fit within an
- * approximate token budget. This prefers shrinking large strings and slicing
- * top-level result arrays before falling back to a compact continuation payload.
- *
- * @param {string} method
- * @param {BridgeResponse} response
- * @param {number | null | undefined} tokenBudget
- * @returns {BridgeResponse}
- */
-export function enforceTokenBudget(method, response, tokenBudget) {
-  if (!response.ok || typeof tokenBudget !== 'number' || !Number.isFinite(tokenBudget) || tokenBudget <= 0) {
-    return response;
-  }
-
-  const maxBytes = Math.max(128, Math.floor(tokenBudget * 4));
-  const responseBytes = estimateJsonPayloadCost(response.result).bytes;
-  if (responseBytes <= maxBytes) {
-    return {
-      ...response,
-      meta: {
-        ...response.meta,
-        budget_applied: false,
-        budget_truncated: false,
-        continuation_hint: null,
-      },
-    };
-  }
-
-  const cloned = cloneJsonValue(response.result);
-  let truncated = false;
-  let iterations = 0;
-  const MAX_BUDGET_ITERATIONS = 100;
-  while (estimateJsonPayloadCost(cloned).bytes > maxBytes && shrinkForBudget(cloned) && iterations < MAX_BUDGET_ITERATIONS) {
-    truncated = true;
-    iterations += 1;
-  }
-
-  let result = cloned;
-  if (estimateJsonPayloadCost(result).bytes > maxBytes) {
-    result = {
-      truncated: true,
-      continuationHint: `Retry ${method} with a larger token budget or tighter params.`,
-    };
-    truncated = true;
-  }
-
-  return {
-    ...response,
-    result,
-    meta: {
-      ...response.meta,
-      budget_applied: true,
-      budget_truncated: truncated,
-      continuation_hint: truncated
-        ? `Retry ${method} with a larger token budget or tighter params.`
-        : null,
-    },
-  };
-}
-
-/**
- * @param {unknown} value
- * @returns {any}
- */
-function cloneJsonValue(value) {
-  return value == null ? value : JSON.parse(JSON.stringify(value));
-}
-
-/**
- * @param {any} value
- * @returns {boolean}
- */
-function shrinkForBudget(value) {
-  if (!value || typeof value !== 'object') {
-    return false;
-  }
-
-  if (Array.isArray(value)) {
-    if (value.length > 1) {
-      const nextLength = Math.max(1, Math.floor(value.length * 0.75));
-      value.splice(nextLength);
-      return true;
-    }
-    return value.length === 1 ? shrinkForBudget(value[0]) : false;
-  }
-
-  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`;
-      if (typeof value.truncated !== 'boolean') {
-        value.truncated = true;
-      }
-      return true;
-    }
-  }
-
-  for (const key of ['nodes', 'entries', 'tabs', 'patches']) {
-    if (Array.isArray(value[key]) && value[key].length > 1) {
-      const originalLength = value[key].length;
-      const nextLength = Math.max(1, Math.floor(originalLength * 0.75));
-      value[key].splice(nextLength);
-      if (typeof value.count !== 'number') {
-        value.count = originalLength;
-      }
-      if (typeof value.total !== 'number') {
-        value.total = originalLength;
-      }
-      value.truncated = true;
-      return true;
-    }
-  }
-
-  for (const entry of Object.values(value)) {
-    if (shrinkForBudget(entry)) {
-      if (typeof value.truncated !== 'boolean') {
-        value.truncated = true;
-      }
-      return true;
-    }
-  }
-
-  const keys = Object.keys(value);
-  if (keys.length > 2) {
-    delete value[keys[keys.length - 1]];
-    value.truncated = true;
-    return true;
-  }
-
-  return false;
-}
-
-/**
- * @param {unknown} error
- * @returns {string}
- */
-export function getErrorMessage(error) {
-  if (typeof error === 'string') {
-    return error;
-  }
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return 'Unexpected extension error.';
-}
-
-/**
- * @param {string} message
- * @returns {string}
- */
-export function normalizeRuntimeErrorMessage(message) {
-  return /^No tab with id[: ]/i.test(message)
-    ? ERROR_CODES.TAB_MISMATCH
-    : message;
-}
-
-/**
- * @param {{ x?: number, y?: number, width?: number, height?: number, scale?: number }} [rect={}]
- * @returns {{ x: number, y: number, width: number, height: number }}
- */
-export function normalizeCropRect(rect = {}) {
-  const scale = Number(rect.scale) || 1;
-  return {
-    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))
-  };
-}
-
-/**
- * @param {string} url
- * @returns {string}
- */
-export function safeOrigin(url) {
-  try {
-    return new URL(url).origin;
-  } catch {
-    return '';
-  }
-}
-
-/**
- * @param {string} method
- * @returns {Capability | null}
- */
-export function inferCapability(method) {
-  return getMethodCapability(/** @type {import('../../protocol/src/types.js').BridgeMethod} */ (method));
-}

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

@@ -1,91 +0,0 @@
-// @ts-check
-
-import { ERROR_CODES } from '../../protocol/src/index.js';
-
-/**
- * @typedef {{
- *   tabId: number,
- *   windowId: number,
- *   title: string,
- *   url: string
- * }} ResolvedTabTarget
- */
-
-/**
- * @param {string} url
- * @returns {boolean}
- */
-export function isRestrictedAutomationUrl(url) {
-  return /^(about:|chrome:|chrome-extension:|chrome-search:|devtools:|edge:|brave:|moz-extension:|view-source:)/i.test(url);
-}
-
-/**
- * @param {number | null | undefined} requestTabId
- * @param {chrome.tabs.Tab | null | undefined} explicitTab
- * @param {chrome.tabs.Tab | null | undefined} activeTab
- * @returns {chrome.tabs.Tab | null}
- */
-export function selectRequestTabCandidate(requestTabId, explicitTab, activeTab) {
-  if (typeof requestTabId === 'number' && Number.isFinite(requestTabId)) {
-    return explicitTab ?? null;
-  }
-  return activeTab ?? null;
-}
-
-/**
- * @param {chrome.tabs.Tab | null | undefined} tab
- * @param {number} enabledWindowId
- * @param {{ requireScriptable?: boolean }} [options]
- * @returns {ResolvedTabTarget}
- */
-export function resolveWindowScopedTab(tab, enabledWindowId, options = {}) {
-  const requireScriptable = options.requireScriptable !== false;
-  if (
-    typeof tab?.id !== 'number'
-    || !Number.isFinite(tab.id)
-    || typeof tab.windowId !== 'number'
-  ) {
-    throw new Error(ERROR_CODES.TAB_MISMATCH);
-  }
-  if (tab.windowId !== enabledWindowId) {
-    throw new Error(ERROR_CODES.ACCESS_DENIED);
-  }
-  if (typeof tab.url !== 'string' || !tab.url) {
-    throw new Error(ERROR_CODES.TAB_MISMATCH);
-  }
-  if (requireScriptable && isRestrictedAutomationUrl(tab.url)) {
-    throw new Error(ERROR_CODES.ACCESS_DENIED);
-  }
-
-  return {
-    tabId: tab.id,
-    windowId: tab.windowId,
-    title: tab.title ?? '',
-    url: tab.url
-  };
-}
-
-/**
- * @param {chrome.tabs.Tab | null | undefined} tab
- * @returns {ResolvedTabTarget | null}
- */
-export function normalizeRequestedAccessTab(tab) {
-  if (
-    typeof tab?.id !== 'number'
-    || !Number.isFinite(tab.id)
-    || typeof tab.windowId !== 'number'
-    || typeof tab.url !== 'string'
-    || !tab.url
-  ) {
-    return null;
-  }
-  if (isRestrictedAutomationUrl(tab.url)) {
-    return null;
-  }
-  return {
-    tabId: tab.id,
-    windowId: tab.windowId,
-    title: tab.title ?? '',
-    url: tab.url
-  };
-}