@browserbridge/bbx 1.0.1 → 1.2.0

package/packages/protocol/src/payload-cost.js

@@ -22,7 +22,9 @@ export function getUtf8ByteLength(value) {
   if (!value) {
     return 0;
   }
-  return textEncoder.encode(value).length;
+  return typeof Buffer !== 'undefined'
+    ? Buffer.byteLength(value, 'utf8')
+    : textEncoder.encode(value).length;
 }
 
 /**
@@ -45,14 +47,25 @@ export function estimateSerializedPayloadCost(serialized) {
 }
 
 /**
- * Estimate cost for a JSON-serializable payload.
+ * Serialize a JSON payload for transport-oriented cost estimation.
  *
  * @param {unknown} value
- * @returns {PayloadCost}
+ * @returns {string}
  */
-export function estimateJsonPayloadCost(value) {
+export function serializeJsonPayload(value) {
   if (typeof value === 'undefined') {
-    return estimateSerializedPayloadCost('');
+    return '';
   }
-  return estimateSerializedPayloadCost(JSON.stringify(value) ?? '');
+  return JSON.stringify(value) ?? '';
+}
+
+/**
+ * Estimate cost for a JSON-serializable payload.
+ *
+ * @param {unknown} value
+ * @param {string} [serialized]
+ * @returns {PayloadCost}
+ */
+export function estimateJsonPayloadCost(value, serialized = serializeJsonPayload(value)) {
+  return estimateSerializedPayloadCost(serialized);
 }

package/packages/protocol/src/protocol.js

@@ -19,7 +19,7 @@ import {
   DEFAULT_WAIT_TIMEOUT_MS,
 } from './defaults.js';
 import { BridgeError, ERROR_CODES, getErrorRecovery } from './errors.js';
-import { BRIDGE_METHODS, createBridgeMethodGroups } from './registry.js';
+import { BRIDGE_METHODS, METHOD_SET, createBridgeMethodGroups } from './registry.js';
 
 /** @typedef {import('./types.js').AccessibilityTreeParams} AccessibilityTreeParams */
 /** @typedef {import('./types.js').BridgeFailureResponse} BridgeFailureResponse */
@@ -28,6 +28,7 @@ import { BRIDGE_METHODS, createBridgeMethodGroups } from './registry.js';
 /** @typedef {import('./types.js').BridgeRequest} BridgeRequest */
 /** @typedef {import('./types.js').BridgeSuccessResponse} BridgeSuccessResponse */
 /** @typedef {import('./types.js').CheckedActionParams} CheckedActionParams */
+/** @typedef {import('./types.js').CdpDispatchKeyEventParams} CdpDispatchKeyEventParams */
 /** @typedef {import('./types.js').ConsoleParams} ConsoleParams */
 /** @typedef {import('./types.js').DomQueryParams} DomQueryParams */
 /** @typedef {import('./types.js').DragParams} DragParams */
@@ -41,6 +42,7 @@ import { BRIDGE_METHODS, createBridgeMethodGroups } from './registry.js';
 /** @typedef {import('./types.js').NetworkParams} NetworkParams */
 /** @typedef {import('./types.js').NormalizedAccessibilityTreeParams} NormalizedAccessibilityTreeParams */
 /** @typedef {import('./types.js').NormalizedCheckedAction} NormalizedCheckedAction */
+/** @typedef {import('./types.js').NormalizedCdpDispatchKeyEventParams} NormalizedCdpDispatchKeyEventParams */
 /** @typedef {import('./types.js').NormalizedConsoleParams} NormalizedConsoleParams */
 /** @typedef {import('./types.js').NormalizedDomQuery} NormalizedDomQuery */
 /** @typedef {import('./types.js').NormalizedDragParams} NormalizedDragParams */
@@ -182,7 +184,7 @@ export function validateBridgeRequest(request) {
 
   if (
     typeof candidate.method !== 'string' ||
-    !METHODS.includes(/** @type {BridgeMethod} */ (candidate.method))
+    !METHOD_SET.has(/** @type {BridgeMethod} */ (candidate.method))
   ) {
     throw new BridgeError(
       ERROR_CODES.INVALID_REQUEST,
@@ -190,6 +192,13 @@ export function validateBridgeRequest(request) {
     );
   }
 
+  if (
+    candidate.meta != null &&
+    (typeof candidate.meta !== 'object' || Array.isArray(candidate.meta))
+  ) {
+    throw new BridgeError(ERROR_CODES.INVALID_REQUEST, 'Request meta must be an object.');
+  }
+
   const meta =
     candidate.meta && typeof candidate.meta === 'object'
       ? /** @type {Record<string, unknown>} */ (candidate.meta)
@@ -202,14 +211,17 @@ export function validateBridgeRequest(request) {
   }
   const parsedTabId = Number(candidate.tab_id);
 
+  const method = /** @type {BridgeMethod} */ (candidate.method);
+  const params =
+    candidate.params && typeof candidate.params === 'object'
+      ? /** @type {Record<string, unknown>} */ (candidate.params)
+      : {};
+
   return {
     id: candidate.id,
-    method: /** @type {BridgeMethod} */ (candidate.method),
+    method,
     tab_id: Number.isFinite(parsedTabId) && parsedTabId > 0 ? parsedTabId : null,
-    params:
-      candidate.params && typeof candidate.params === 'object'
-        ? /** @type {Record<string, unknown>} */ (candidate.params)
-        : {},
+    params: normalizeRequestParams(method, params),
     meta: {
       ...meta,
       protocol_version:
@@ -220,6 +232,82 @@ export function validateBridgeRequest(request) {
   };
 }
 
+/**
+ * Normalize request params early so malformed payloads fail at the shared
+ * protocol boundary before daemon or extension dispatch.
+ *
+ * @param {BridgeMethod} method
+ * @param {Record<string, unknown>} params
+ * @returns {Record<string, unknown>}
+ */
+function normalizeRequestParams(method, params) {
+  switch (method) {
+    case 'dom.query':
+      return normalizeDomQuery(params);
+    case 'page.evaluate':
+      return normalizeEvaluateParams(params);
+    case 'page.get_console':
+      return normalizeConsoleParams(params);
+    case 'page.wait_for_load_state':
+      return normalizeWaitForLoadStateParams(params);
+    case 'page.get_storage':
+      return normalizeStorageParams(params);
+    case 'page.get_text':
+      return normalizePageTextParams(params);
+    case 'page.get_network':
+      return normalizeNetworkParams(params);
+    case 'navigation.navigate':
+    case 'navigation.reload':
+    case 'navigation.go_back':
+    case 'navigation.go_forward':
+      return normalizeNavigationAction(params);
+    case 'dom.wait_for':
+      return normalizeWaitForParams(params);
+    case 'dom.find_by_text':
+      return normalizeFindByTextParams(params);
+    case 'dom.find_by_role':
+      return normalizeFindByRoleParams(params);
+    case 'dom.get_html':
+      return normalizeGetHtmlParams(params);
+    case 'dom.get_accessibility_tree':
+      return normalizeAccessibilityTreeParams(params);
+    case 'styles.get_computed':
+    case 'styles.get_matched_rules':
+      return normalizeStyleQuery(params);
+    case 'viewport.scroll':
+      return normalizeViewportAction(params);
+    case 'viewport.resize':
+      return normalizeViewportResizeParams(params);
+    case 'input.click':
+    case 'input.focus':
+    case 'input.type':
+    case 'input.press_key':
+      return normalizeInputAction(params);
+    case 'cdp.dispatch_key_event':
+      return normalizeCdpDispatchKeyEventParams(params);
+    case 'input.set_checked':
+      return normalizeCheckedAction(params);
+    case 'input.select_option':
+      return normalizeSelectAction(params);
+    case 'input.hover':
+      return normalizeHoverParams(params);
+    case 'input.drag':
+      return normalizeDragParams(params);
+    case 'patch.apply_styles':
+    case 'patch.apply_dom':
+    case 'patch.list':
+    case 'patch.rollback':
+    case 'patch.commit_session_baseline':
+      return normalizePatchOperation(params);
+    case 'tabs.create':
+      return normalizeTabCreateParams(params);
+    case 'tabs.close':
+      return normalizeTabCloseParams(params);
+    default:
+      return params;
+  }
+}
+
 /**
  * @param {DomQueryParams} [params={}]
  * @returns {NormalizedDomQuery}
@@ -293,6 +381,54 @@ export function normalizeInputAction(params = {}) {
   };
 }
 
+/**
+ * @param {CdpDispatchKeyEventParams} [params={}]
+ * @returns {NormalizedCdpDispatchKeyEventParams}
+ */
+export function normalizeCdpDispatchKeyEventParams(params = {}) {
+  if (typeof params.key !== 'string' || !params.key.trim()) {
+    throw new BridgeError(ERROR_CODES.INVALID_REQUEST, 'key must be a non-empty string.');
+  }
+
+  if (
+    params.modifiers != null &&
+    typeof params.modifiers !== 'number' &&
+    !Array.isArray(params.modifiers)
+  ) {
+    throw new BridgeError(
+      ERROR_CODES.INVALID_REQUEST,
+      'modifiers must be an array of Alt, Control, Meta, Shift or a bitmask 0-15.'
+    );
+  }
+
+  if (
+    typeof params.modifiers === 'number' &&
+    (!Number.isInteger(params.modifiers) || params.modifiers < 0 || params.modifiers > 15)
+  ) {
+    throw new BridgeError(
+      ERROR_CODES.INVALID_REQUEST,
+      'modifiers must be an array of Alt, Control, Meta, Shift or a bitmask 0-15.'
+    );
+  }
+
+  if (Array.isArray(params.modifiers)) {
+    for (const modifier of params.modifiers) {
+      if (typeof modifier !== 'string' || !['Alt', 'Control', 'Meta', 'Shift'].includes(modifier)) {
+        throw new BridgeError(
+          ERROR_CODES.INVALID_REQUEST,
+          'modifiers must contain only Alt, Control, Meta, or Shift.'
+        );
+      }
+    }
+  }
+
+  return {
+    key: params.key,
+    code: typeof params.code === 'string' ? params.code.trim() : '',
+    modifiers: params.modifiers ?? [],
+  };
+}
+
 /**
  * @param {CheckedActionParams} [params={}]
  * @returns {NormalizedCheckedAction}

package/packages/protocol/src/registry.js

@@ -78,9 +78,11 @@ const BRIDGE_METHOD_DESCRIPTIONS = Object.freeze({
   'cdp.get_dom_snapshot': 'Read a CDP DOM snapshot.',
   'cdp.get_box_model': 'Read a CDP box model for a node.',
   'cdp.get_computed_styles_for_node': 'Read CDP computed styles for a node.',
+  'cdp.dispatch_key_event': 'Dispatch a key press through Chrome DevTools Protocol input.',
   'performance.get_metrics': 'Read browser performance metrics.',
   'log.tail': 'Tail recent bridge log entries.',
   'health.ping': 'Check daemon, extension, and access-routing health.',
+  'daemon.metrics': 'Daemon health and performance metrics.',
 });
 
 /**
@@ -123,6 +125,7 @@ export const BRIDGE_METHOD_REGISTRY = Object.freeze({
   ),
   'log.tail': createRegistryEntry('log.tail', 'system', false, [], 'trivial'),
   'health.ping': createRegistryEntry('health.ping', 'system', false, [], 'trivial'),
+  'daemon.metrics': createRegistryEntry('daemon.metrics', 'system', false, [], 'trivial'),
   // tabs — trivial
   'tabs.list': createRegistryEntry('tabs.list', 'tabs', false, [], 'trivial'),
   'tabs.create': createRegistryEntry('tabs.create', 'tabs', false, ['url', 'active'], 'trivial'),
@@ -424,6 +427,13 @@ export const BRIDGE_METHOD_REGISTRY = Object.freeze({
     ['elementRef'],
     'high'
   ),
+  'cdp.dispatch_key_event': createRegistryEntry(
+    'cdp.dispatch_key_event',
+    'cdp',
+    true,
+    ['key', 'code', 'modifiers'],
+    'moderate'
+  ),
   // performance — moderate (debugger-backed)
   'performance.get_metrics': createRegistryEntry(
     'performance.get_metrics',
@@ -439,6 +449,9 @@ export const BRIDGE_METHODS = Object.freeze(
   /** @type {import('./types.js').BridgeMethod[]} */ (Object.keys(BRIDGE_METHOD_REGISTRY))
 );
 
+/** @type {ReadonlySet<import('./types.js').BridgeMethod>} */
+export const METHOD_SET = new Set(BRIDGE_METHODS);
+
 /**
  * @returns {Record<string, import('./types.js').BridgeMethod[]>}
  */

package/packages/protocol/src/summary.js

@@ -1,6 +1,6 @@
 // @ts-check
 
-import { estimateJsonPayloadCost, getCostClass } from './index.js';
+import { estimateSerializedPayloadCost, getCostClass, serializeJsonPayload } from './index.js';
 
 /** @typedef {import('./types.js').BridgeResponse} BridgeResponse */
 /** @typedef {import('./types.js').BridgeMethod} SummaryMethod */
@@ -99,15 +99,21 @@ const ACTION_SUMMARIES = {
  * @returns {AnnotatedBridgeSummary}
  */
 export function annotateBridgeSummary(summary, response) {
-  const transportBytes =
+  const metaTransportBytes =
     getNumericMetaField(response.meta, 'transport_bytes') ??
-    getNumericMetaField(response.meta, 'response_bytes') ??
-    estimateJsonPayloadCost(response.ok ? response.result : { error: response.error }).bytes;
-  const transportTokens =
+    getNumericMetaField(response.meta, 'response_bytes');
+  const metaTransportTokens =
     getNumericMetaField(response.meta, 'transport_approx_tokens') ??
-    getNumericMetaField(response.meta, 'approx_tokens') ??
-    estimateJsonPayloadCost(response.ok ? response.result : { error: response.error }).approxTokens;
-  const summaryCost = estimateJsonPayloadCost(summary);
+    getNumericMetaField(response.meta, 'approx_tokens');
+  const transportCost =
+    metaTransportBytes == null || metaTransportTokens == null
+      ? estimateSerializedPayloadCost(
+          serializeJsonPayload(response.ok ? response.result : { error: response.error })
+        )
+      : null;
+  const transportBytes = metaTransportBytes ?? transportCost?.bytes ?? 0;
+  const transportTokens = metaTransportTokens ?? transportCost?.approxTokens ?? 0;
+  const summaryCost = estimateSerializedPayloadCost(serializeJsonPayload(summary));
 
   return {
     ...summary,
@@ -659,13 +665,12 @@ export function summarizeBridgeResponse(response, method) {
  */
 export function summarizeBatchResponseItem({ method, tabId, response, durationMs }) {
   const summary = annotateBridgeSummary(summarizeBridgeResponse(response, method), response);
-  const cost = estimateJsonPayloadCost(response.ok ? response.result : { error: response.error });
   return {
     method,
     tabId,
     ...summary,
     durationMs,
-    approxTokens: cost.approxTokens,
+    approxTokens: summary.transportTokens,
     meta: response.meta,
     error: response.ok ? null : response.error,
     response: response.ok ? response.result : null,
@@ -756,6 +761,9 @@ function summarizeErrorHint(code) {
   if (code === 'ELEMENT_STALE') {
     return 'Re-query the current page after navigation or DOM updates.';
   }
+  if (code === 'RESULT_TRUNCATED') {
+    return 'Narrow the query or raise the relevant budget if more detail is required.';
+  }
   return '';
 }
 

package/packages/protocol/src/types.js

@@ -7,7 +7,7 @@ export {};
  */
 
 /**
- * @typedef {'page.read' | 'page.evaluate' | 'dom.read' | 'styles.read' | 'layout.read' | 'viewport.control' | 'navigation.control' | 'screenshot.partial' | 'patch.dom' | 'patch.styles' | 'cdp.dom_snapshot' | 'cdp.box_model' | 'cdp.styles' | 'automation.input' | 'tabs.manage' | 'performance.read' | 'network.read'} Capability
+ * @typedef {'page.read' | 'page.evaluate' | 'dom.read' | 'styles.read' | 'layout.read' | 'viewport.control' | 'navigation.control' | 'screenshot.partial' | 'patch.dom' | 'patch.styles' | 'cdp.dom_snapshot' | 'cdp.box_model' | 'cdp.styles' | 'cdp.input' | 'automation.input' | 'tabs.manage' | 'performance.read' | 'network.read'} Capability
  */
 
 /**
@@ -15,7 +15,7 @@ export {};
  */
 
 /**
- * @typedef {'access.request' | 'tabs.list' | 'tabs.create' | 'tabs.close' | 'skill.get_runtime_context' | 'setup.get_status' | 'setup.install' | 'page.get_state' | 'page.evaluate' | 'page.get_console' | 'page.wait_for_load_state' | 'page.get_storage' | 'page.get_text' | 'page.get_network' | 'navigation.navigate' | 'navigation.reload' | 'navigation.go_back' | 'navigation.go_forward' | 'dom.query' | 'dom.describe' | 'dom.get_text' | 'dom.get_attributes' | 'dom.wait_for' | 'dom.find_by_text' | 'dom.find_by_role' | 'dom.get_html' | 'dom.get_accessibility_tree' | 'layout.get_box_model' | 'layout.hit_test' | 'styles.get_computed' | 'styles.get_matched_rules' | 'viewport.scroll' | 'viewport.resize' | 'input.click' | 'input.focus' | 'input.type' | 'input.press_key' | 'input.set_checked' | 'input.select_option' | 'input.hover' | 'input.drag' | 'input.scroll_into_view' | 'screenshot.capture_region' | 'screenshot.capture_element' | 'screenshot.capture_full_page' | 'patch.apply_styles' | 'patch.apply_dom' | 'patch.list' | 'patch.rollback' | 'patch.commit_session_baseline' | 'cdp.get_document' | 'cdp.get_dom_snapshot' | 'cdp.get_box_model' | 'cdp.get_computed_styles_for_node' | 'performance.get_metrics' | 'log.tail' | 'health.ping'} BridgeMethod
+ * @typedef {'access.request' | 'tabs.list' | 'tabs.create' | 'tabs.close' | 'skill.get_runtime_context' | 'setup.get_status' | 'setup.install' | 'page.get_state' | 'page.evaluate' | 'page.get_console' | 'page.wait_for_load_state' | 'page.get_storage' | 'page.get_text' | 'page.get_network' | 'navigation.navigate' | 'navigation.reload' | 'navigation.go_back' | 'navigation.go_forward' | 'dom.query' | 'dom.describe' | 'dom.get_text' | 'dom.get_attributes' | 'dom.wait_for' | 'dom.find_by_text' | 'dom.find_by_role' | 'dom.get_html' | 'dom.get_accessibility_tree' | 'layout.get_box_model' | 'layout.hit_test' | 'styles.get_computed' | 'styles.get_matched_rules' | 'viewport.scroll' | 'viewport.resize' | 'input.click' | 'input.focus' | 'input.type' | 'input.press_key' | 'input.set_checked' | 'input.select_option' | 'input.hover' | 'input.drag' | 'input.scroll_into_view' | 'screenshot.capture_region' | 'screenshot.capture_element' | 'screenshot.capture_full_page' | 'patch.apply_styles' | 'patch.apply_dom' | 'patch.list' | 'patch.rollback' | 'patch.commit_session_baseline' | 'cdp.get_document' | 'cdp.get_dom_snapshot' | 'cdp.get_box_model' | 'cdp.get_computed_styles_for_node' | 'cdp.dispatch_key_event' | 'performance.get_metrics' | 'log.tail' | 'health.ping' | 'daemon.metrics'} BridgeMethod
  */
 
 /**
@@ -52,11 +52,20 @@ export {};
  * }} BridgeRequest
  */
 
+/**
+ * @typedef {{
+ *   hint: string,
+ *   retry?: boolean,
+ *   retryAfterMs?: number
+ * }} BridgeRecovery
+ */
+
 /**
  * @typedef {{
  *   code: ErrorCode,
  *   message: string,
- *   details: unknown
+ *   details: unknown,
+ *   recovery?: BridgeRecovery
  * }} BridgeFailure
  */
 
@@ -187,6 +196,22 @@ export {};
  * }} NormalizedInputAction
  */
 
+/**
+ * @typedef {{
+ *   key?: string,
+ *   code?: string,
+ *   modifiers?: string[] | number
+ * }} CdpDispatchKeyEventParams
+ */
+
+/**
+ * @typedef {{
+ *   key: string,
+ *   code: string,
+ *   modifiers: string[] | number
+ * }} NormalizedCdpDispatchKeyEventParams
+ */
+
 /**
  * @typedef {{
  *   target?: InputTarget,

package/skills/browser-bridge/SKILL.md

@@ -69,6 +69,7 @@ bbx click <ref> [button]             # click element
 bbx focus <ref>                      # focus element
 bbx type <ref> <text...>             # type into element
 bbx press-key <key> [ref]            # send key event
+bbx cdp-press-key --tab <id> Escape  # CDP key event without foreground focus
 bbx hover <ref>                      # hover over element
 bbx call input.scroll_into_view '{"target":{"elementRef":"el_123"}}' # ensure target is visible
 bbx patch-style <ref> prop=val...    # apply style patch
@@ -202,7 +203,7 @@ bbx page-text 2000                                  # extract page content
 | Find        | `dom.find_by_text`, `dom.find_by_role`, `dom.wait_for`, `dom.get_accessibility_tree`                                                                |
 | Page State  | `page.get_console`, `page.get_storage`, `page.get_text`, `page.wait_for_load_state`, `page.evaluate` (debugger-backed)                              |
 | Network     | `page.get_network`                                                                                                                                  |
-| Interact    | `input.click`, `input.type`, `input.focus`, `input.press_key`, `input.hover`, `input.drag`, `input.scroll_into_view`                                |
+| Interact    | `input.click`, `input.type`, `input.focus`, `input.press_key`, `cdp.dispatch_key_event`, `input.hover`, `input.drag`, `input.scroll_into_view`       |
 | Tabs        | `tabs.list` (preferred), `tabs.create` (avoid unless necessary), `tabs.close`                                                                       |
 | Patch       | `patch.apply_styles`, `patch.apply_dom`, `patch.rollback`                                                                                           |
 | Navigate    | `navigation.navigate`, `viewport.scroll`, `viewport.resize`                                                                                         |

package/skills/browser-bridge/references/interaction.md

@@ -8,6 +8,7 @@
 | `input.focus`            | `focus <ref>`                         | Focus an element                                            |
 | `input.type`             | `type <ref> <text>`                   | Type into input/textarea/contenteditable                    |
 | `input.press_key`        | `press-key <key> [ref]`               | Send keyboard key (Enter, Backspace, etc.)                  |
+| `cdp.dispatch_key_event` | `cdp-press-key --tab <id> <key>`      | CDP keyDown/keyUp without focusing the target tab           |
 | `input.set_checked`      | `call input.set_checked '{...}'`      | Toggle checkbox/radio                                       |
 | `input.select_option`    | `call input.select_option '{...}'`    | Select native `<select>` by value/label/index               |
 | `input.hover`            | `hover <ref>`                         | Trigger CSS `:hover` state (mouseenter/mouseover/mousemove) |

package/skills/browser-bridge/references/protocol.md

@@ -88,6 +88,7 @@ The table below includes the legacy capability bucket for each method so agents
 | 55  | `cdp.get_dom_snapshot`             | Yes  | CDP  | cdp         | `cdp.dom_snapshot`   | DevTools DOM snapshot                                                   |
 | 56  | `cdp.get_box_model`                | Yes  | CDP  | cdp         | `cdp.box_model`      | DevTools-backed element geometry                                        |
 | 57  | `cdp.get_computed_styles_for_node` | Yes  | CDP  | cdp         | `cdp.styles`         | DevTools-backed computed styles                                         |
+| 58  | `cdp.dispatch_key_event`           | Yes  | CDP  | cdp         | `cdp.input`          | DevTools keyDown/keyUp without foreground focus                         |
 
 ## CLI
 
@@ -98,7 +99,7 @@ bbx call --tab 123 <method> '{...}'         # explicit tab target inside enabled
 bbx batch '[{"method":"...","params":{}}]'  # parallel calls
 ```
 
-**Convenience shortcuts:** `access-request`, `dom-query`, `describe`, `text`, `styles`, `box`, `click`, `focus`, `type`, `press-key`, `patch-style`, `patch-text`, `patches`, `rollback`, `screenshot`, `eval`, `console`, `wait`, `find`, `find-role`, `html`, `hover`, `navigate`, `storage`, `tab-create`, `tab-close`, `page-text`, `network`, `a11y-tree`, `perf`, `resize`, `reload`, `back`, `forward`, `attrs`, `matched-rules`
+**Convenience shortcuts:** `access-request`, `dom-query`, `describe`, `text`, `styles`, `box`, `click`, `focus`, `type`, `press-key`, `cdp-press-key`, `patch-style`, `patch-text`, `patches`, `rollback`, `screenshot`, `eval`, `console`, `wait`, `find`, `find-role`, `html`, `hover`, `navigate`, `storage`, `tab-create`, `tab-close`, `page-text`, `network`, `a11y-tree`, `perf`, `resize`, `reload`, `back`, `forward`, `attrs`, `matched-rules`
 
 Newer bridge methods such as `input.scroll_into_view` and `screenshot.capture_full_page` currently use the raw path: `bbx call <method> '{...}'`.
 

package/CHANGELOG.md

@@ -1,55 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-but this file is maintained as a cumulative feature log rather than a sequence
-of tagged releases.
-
-## [Unreleased]
-
-### Added
-
-- **Core platform:** Browser Bridge as a local bridge between coding agents and
-  a real Chrome tab, preserving the existing browser state instead of starting
-  from a clean automation session. This includes the Chrome extension, native
-  messaging host, long-lived daemon, shared protocol package, agent client, and
-  MCP server.
-- **Browser inspection:** Structured DOM inspection for subtree queries,
-  element description, text, HTML, attributes, semantic search by text or ARIA
-  role, wait conditions, and accessibility-tree reads.
-- **Page and runtime reads:** Page state, storage, visible page text, console
-  output, network activity, performance metrics, and targeted JavaScript
-  evaluation when structured reads are insufficient.
-- **Layout and styling reads:** Computed styles, matched CSS rules, box model
-  data, hit testing, scrolling, and viewport resizing.
-- **Browser control:** Clicking, typing, focusing, hovering, keyboard input,
-  form controls, drag-and-drop, tab management, and page navigation.
-- **Capture and DevTools fallback:** Partial screenshots, DOM snapshots, and
-  CDP-backed geometry and style reads for cases where standard DOM inspection is
-  not enough.
-- **Live patching:** Reversible style and DOM patching, plus patch listing,
-  rollback, and session-baseline commit support so fixes can be proven in the
-  browser before being moved into source.
-- **CLI integration:** The `bbx` CLI with raw RPC access, shortcut commands,
-  batch execution, diagnostics, and runtime skill/context helpers.
-- **MCP integration:** The `bbx-mcp` server so MCP-capable agents can use
-  Browser Bridge through native tool calls.
-- **Agent setup flows:** Managed MCP and skill installation for Codex, Claude
-  Code, Cursor, GitHub Copilot, OpenCode, Antigravity, Windsurf, and generic
-  `.agents` setups.
-- **Documentation and skills:** Agent-facing skill packaging plus quick-start,
-  API, publishing, capability-matrix, contributor, and workflow documentation.
-- **Validation and release tooling:** Automated tests across the protocol,
-  native host, agent client, MCP server, and extension, plus linting, coverage
-  checks, extension packaging validation, and release verification steps.
-- **Access model and routing:** Explicit per-window enablement with active-tab
-  default routing instead of ambient browser-wide access.
-- **Protocol and efficiency model:** Structured, token-efficient browser reads
-  with shared protocol types, normalization, error codes, recovery hints, and
-  budget presets.
-- **Runtime hardening:** Setup readiness checks, health and diagnostic flows,
-  socket and config permission hardening, protocol negotiation, reconnect
-  behavior, and disconnected-client handling.
-- **Typing expectations:** Strict JSDoc-backed typing across the JavaScript
-  codebase with repository-wide `npm run typecheck` validation.

package/assets/logo.svg

@@ -1,65 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="78.190598mm"
-   height="81.232712mm"
-   viewBox="0 0 78.190598 81.232712"
-   version="1.1"
-   id="svg1"
-   xml:space="preserve"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg"><sodipodi:namedview
-     id="namedview1"
-     pagecolor="#ffffff"
-     bordercolor="#000000"
-     borderopacity="0.25"
-     inkscape:showpageshadow="2"
-     inkscape:pageopacity="0.0"
-     inkscape:pagecheckerboard="0"
-     inkscape:deskcolor="#d1d1d1"
-     inkscape:document-units="mm"><inkscape:page
-       x="0"
-       y="0"
-       width="78.190598"
-       height="81.232712"
-       id="page2"
-       margin="0"
-       bleed="0" /></sodipodi:namedview><defs
-     id="defs1" /><g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(-42.680867,-100)"><g
-       id="g2"><path
-         id="rect2-6"
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.221409"
-         d="m -20.02,163.43555 -21.040492,2.4e-4 a 16.5,16.5 0 0 1 -1.090567,14.99993 l 22.283145,-8e-5 A 16.5,16.5 0 0 1 -20.02,163.43555 Z"
-         transform="rotate(-40.047795)" /><path
-         id="rect2"
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.221409"
-         d="m 136.94552,-47.53585 a 16.5,16.5 0 0 1 1.66989,10.051485 16.5,16.5 0 0 1 -1.57039,4.948831 l 22.89662,-6.5e-5 a 16.5,16.5 0 0 1 -2.02368,-10.697809 16.5,16.5 0 0 1 1.26306,-4.302113 z"
-         transform="rotate(81.447977)" /><path
-         id="rect2-6-4"
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.221409"
-         d="m 110.73366,76.358885 a 16.5,16.5 0 0 1 1.19568,2.379247 16.5,16.5 0 0 1 -0.096,12.620524 l 21.61171,9e-6 a 16.5,16.5 0 0 1 -0.2602,-0.606591 16.5,16.5 0 0 1 0.97427,-14.393019 z"
-         transform="rotate(22.050959)" /><circle
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.424555"
-         id="path1-0-7"
-         cx="66.236229"
-         cy="166.23273"
-         r="15"
-         inkscape:transform-center-x="-0.58870168"
-         inkscape:transform-center-y="1.4717542" /><circle
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.424555"
-         id="path1"
-         cx="57.68087"
-         cy="115.00001"
-         r="15" /><circle
-         style="fill:#d34a1e;fill-opacity:1;stroke:none;stroke-width:0.424555"
-         id="path1-0"
-         cx="105.87147"
-         cy="134.11552"
-         r="15" /></g></g></svg>