@btraut/browser-bridge 0.4.3 → 0.5.0

package/CHANGELOG.md

@@ -4,6 +4,48 @@ All notable changes to this project will be documented in this file.
 
 The format is based on "Keep a Changelog", and this project adheres to Semantic Versioning.
 
+## [Unreleased]
+
+### Added
+
+_TBD_
+
+### Fixed
+
+_TBD_
+
+### Changed
+
+_TBD_
+
+## [0.5.0] - 2026-02-09
+
+### Added
+
+- `PERMISSION_REQUIRED` error code for soft site-permissions gating.
+- `PERMISSION_DENIED` error code for explicit user declines in the site-permissions prompt.
+- `PERMISSION_PROMPT_TIMEOUT` error code for when a site-permissions approval prompt times out while waiting for user input.
+- Soft site-permissions allowlist with a permission prompt window and an options page to review/revoke approved sites.
+- Extension toolbar menu (Settings/About) for easier discovery of site permissions.
+
+### Fixed
+
+- Increase the default Core client timeout (CLI + MCP) so extension permission prompts do not time out prematurely.
+- CLI: classify aborted Core requests as `TIMEOUT` (with timeout details) instead of a generic `INTERNAL` error.
+- Increase the site-permissions prompt popup size to avoid clipping controls.
+- Make permission-decline failures more actionable for agent clients by returning `PERMISSION_DENIED` with next-step guidance.
+- Fix extension popup/options buttons by loading UI scripts as modules; simplify the popup styling (no gradients/ALL CAPS) and replace About ellipsis with an external-link icon.
+- Fix a small extension popup bottom-clipping issue; add a subtle header icon for personality without gradients.
+- Match the options page list drop shadow to the popup menu styling, and reduce shadow intensity.
+- Options page: make Undo revoke more robust by verifying the allowlist restore.
+
+### Changed
+
+- When `tab_id` is omitted in drive commands, Browser Bridge now creates (and reuses) a dedicated Chrome window/tab so agent activity stays separate from the user's current window.
+- The dedicated agent tab is grouped under a `🌉 Browser Bridge` tab group when created.
+- Approved sites options page: switch to a settings-style list with right-aligned revoke actions and an Undo toast.
+- Increase the default site-permissions prompt wait to 30 seconds.
+
 ## [0.4.3] - 2026-02-07
 
 ### Fixed

package/README.md

@@ -76,6 +76,12 @@ npm run build
 3. Open Chrome and navigate to `chrome://extensions`.
 4. Enable **Developer mode**, click **Load unpacked**, and select the extension folder (the folder with `manifest.json`).
 
+Notes:
+
+- Browser Bridge enforces a per-site allowlist for `drive.*` actions. The first time it acts on a new site, you'll see a permission prompt.
+- You can review and revoke approved sites via the extension options page (Extensions menu -> Browser Bridge -> Extension options).
+- If you click **Decline**, the command fails with `PERMISSION_DENIED` (non-retryable). If you don't respond in time, you'll see `PERMISSION_PROMPT_TIMEOUT` (retryable once after the user allows).
+
 ## Quickstart
 
 1. Install the extension.

package/dist/api.js

@@ -252,6 +252,13 @@ var errorStatus = (code) => {
   switch (code) {
     case "INVALID_ARGUMENT":
       return 400;
+    case "UNAUTHORIZED":
+      return 401;
+    case "FORBIDDEN":
+    case "PERMISSION_REQUIRED":
+    case "PERMISSION_PROMPT_TIMEOUT":
+    case "PERMISSION_DENIED":
+      return 403;
     case "SESSION_NOT_FOUND":
     case "TAB_NOT_FOUND":
     case "LOCATOR_NOT_FOUND":
@@ -2842,6 +2849,9 @@ var ErrorCodeSchema = import_zod.z.enum([
   "FAILED_PRECONDITION",
   "UNAUTHORIZED",
   "FORBIDDEN",
+  "PERMISSION_REQUIRED",
+  "PERMISSION_DENIED",
+  "PERMISSION_PROMPT_TIMEOUT",
   "CONFLICT",
   "TIMEOUT",
   "CANCELLED",
@@ -4548,7 +4558,7 @@ var startCoreServer = (options = {}) => {
 // packages/mcp-adapter/src/core-client.ts
 var DEFAULT_HOST = "127.0.0.1";
 var DEFAULT_PORT = 3210;
-var DEFAULT_TIMEOUT_MS = 4e3;
+var DEFAULT_TIMEOUT_MS = 3e4;
 var resolveHost = (host) => {
   const candidate = host?.trim() || process.env.BROWSER_BRIDGE_CORE_HOST || process.env.BROWSER_VISION_CORE_HOST;
   if (candidate && candidate.length > 0) {
@@ -4831,7 +4841,7 @@ var TOOL_DEFINITIONS = [
     name: "drive.scroll",
     config: {
       title: "Drive Scroll",
-      description: "Scroll the active tab.",
+      description: "Scroll the default tab (agent window/tab unless tab_id is provided).",
       inputSchema: DriveScrollInputSchema,
       outputSchema: envelope(DriveScrollOutputSchema),
       corePath: "/drive/scroll"