@browserbridge/bbx 1.0.0 → 1.0.1

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

@@ -4,7 +4,12 @@ import { EventEmitter, once } from 'node:events';
 import net from 'node:net';
 import { randomUUID } from 'node:crypto';
 
-import { createRequest, DEFAULT_CLIENT_REQUEST_TIMEOUT_MS, PROTOCOL_VERSION, parseJsonLines } from '../../protocol/src/index.js';
+import {
+  createRequest,
+  DEFAULT_CLIENT_REQUEST_TIMEOUT_MS,
+  PROTOCOL_VERSION,
+  parseJsonLines,
+} from '../../protocol/src/index.js';
 import { getSocketPath } from '../../native-host/src/config.js';
 
 /** @typedef {import('../../protocol/src/types.js').BridgeResponse} BridgeResponse */
@@ -55,7 +60,7 @@ export class BridgeClient extends EventEmitter {
     socketPath = getSocketPath(),
     clientId = `agent_${randomUUID()}`,
     defaultTimeoutMs = DEFAULT_CLIENT_REQUEST_TIMEOUT_MS,
-    autoReconnect = false
+    autoReconnect = false,
   } = {}) {
     super();
     this.socketPath = socketPath;
@@ -128,7 +133,9 @@ export class BridgeClient extends EventEmitter {
       // 'close' fires after 'error'; reconnect is triggered there.
     });
 
-    this.socket.write(`${JSON.stringify({ type: 'register', role: 'agent', clientId: this.clientId })}\n`);
+    this.socket.write(
+      `${JSON.stringify({ type: 'register', role: 'agent', clientId: this.clientId })}\n`
+    );
     await new Promise((resolve, reject) => {
       const timeoutId = setTimeout(() => {
         this.waiting.delete('registered');
@@ -137,13 +144,13 @@ export class BridgeClient extends EventEmitter {
       this.waiting.set('registered', {
         resolve,
         reject,
-        timeoutId
+        timeoutId,
       });
     });
 
     try {
       const healthResponse = await this.request({
-        method: 'health.ping'
+        method: 'health.ping',
       });
       if (healthResponse.ok) {
         this.protocolCompatibility = BridgeClient.checkProtocolVersion(
@@ -167,9 +174,17 @@ export class BridgeClient extends EventEmitter {
    * }} options
    * @returns {Promise<BridgeResponse>}
    */
-  async request({ method, params = {}, tabId = null, meta = {}, timeoutMs = this.defaultTimeoutMs }) {
+  async request({
+    method,
+    params = {},
+    tabId = null,
+    meta = {},
+    timeoutMs = this.defaultTimeoutMs,
+  }) {
     if (!this.socket || this.socket.destroyed || !this.socket.writable) {
-      const err = /** @type {Error & { code: string }} */ (new Error('BridgeClient is not connected.'));
+      const err = /** @type {Error & { code: string }} */ (
+        new Error('BridgeClient is not connected.')
+      );
       err.code = 'ENOTCONN';
       throw err;
     }
@@ -179,7 +194,7 @@ export class BridgeClient extends EventEmitter {
       method,
       params,
       tabId,
-      meta
+      meta,
     });
 
     const responsePromise = new Promise((resolve, reject) => {
@@ -191,14 +206,16 @@ export class BridgeClient extends EventEmitter {
       this.waiting.set(request.id, {
         resolve,
         reject,
-        timeoutId
+        timeoutId,
       });
     });
 
     if (!this.socket.write(`${JSON.stringify({ type: 'agent.request', request })}\n`)) {
       await Promise.race([
         once(this.socket, 'drain'),
-        once(this.socket, 'close').then(() => { throw new Error('Bridge socket closed while writing.'); })
+        once(this.socket, 'close').then(() => {
+          throw new Error('Bridge socket closed while writing.');
+        }),
       ]);
     }
     const response = /** @type {BridgeResponse} */ (await responsePromise);
@@ -275,7 +292,11 @@ export class BridgeClient extends EventEmitter {
       ? healthResult.supported_versions
       : [];
     if (remoteVersions.length === 0) {
-      return { compatible: true, localVersion: PROTOCOL_VERSION, remoteVersions };
+      return {
+        compatible: true,
+        localVersion: PROTOCOL_VERSION,
+        remoteVersions,
+      };
     }
     const compatible = remoteVersions.includes(PROTOCOL_VERSION);
     return {
@@ -284,11 +305,10 @@ export class BridgeClient extends EventEmitter {
       remoteVersions,
       ...(!compatible && {
         warning:
-          typeof healthResult?.migration_hint === 'string' &&
-          healthResult.migration_hint
+          typeof healthResult?.migration_hint === 'string' && healthResult.migration_hint
             ? healthResult.migration_hint
-            : `Protocol mismatch: client speaks ${PROTOCOL_VERSION} but remote supports [${remoteVersions.join(', ')}]. Update the ${remoteVersions[0] > PROTOCOL_VERSION ? 'client (npm)' : 'extension'} to match.`
-      })
+            : `Protocol mismatch: client speaks ${PROTOCOL_VERSION} but remote supports [${remoteVersions.join(', ')}]. Update the ${remoteVersions[0] > PROTOCOL_VERSION ? 'client (npm)' : 'extension'} to match.`,
+      }),
     };
   }
 
@@ -316,8 +336,8 @@ export class BridgeClient extends EventEmitter {
       ...response,
       meta: {
         ...response.meta,
-        protocol_warning: this.protocolWarning
-      }
+        protocol_warning: this.protocolWarning,
+      },
     };
   }
 }

package/packages/agent-client/src/command-registry.js

@@ -27,21 +27,20 @@ function createShortcutCommand(method, usage, build, options = {}) {
   return {
     method,
     usage,
-    description: options.description ?? BRIDGE_METHOD_REGISTRY[method].description.replace(/\.$/, ''),
+    description:
+      options.description ?? BRIDGE_METHOD_REGISTRY[method].description.replace(/\.$/, ''),
     build,
     ...(options.resolve ? { resolve: true } : {}),
-    ...(options.printMethod ? { printMethod: options.printMethod } : {})
+    ...(options.printMethod ? { printMethod: options.printMethod } : {}),
   };
 }
 
 /** @type {Record<string, ShortcutCommand>} */
 export const SHORTCUT_COMMANDS = {
   'access-request': createShortcutCommand('access.request', 'bbx access-request', () => ({})),
-  'dom-query': createShortcutCommand(
-    'dom.query',
-    'bbx dom-query [selector]',
-    (r) => ({ selector: r[0] || 'body' })
-  ),
+  'dom-query': createShortcutCommand('dom.query', 'bbx dom-query [selector]', (r) => ({
+    selector: r[0] || 'body',
+  })),
   describe: createShortcutCommand(
     'dom.describe',
     'bbx describe <ref|selector>',
@@ -51,7 +50,10 @@ export const SHORTCUT_COMMANDS = {
   text: createShortcutCommand(
     'dom.get_text',
     'bbx text <ref|selector> [budget]',
-    (r, ref) => ({ elementRef: ref, textBudget: r[1] ? parseIntArg(r[1], 'budget') : undefined }),
+    (r, ref) => ({
+      elementRef: ref,
+      textBudget: r[1] ? parseIntArg(r[1], 'budget') : undefined,
+    }),
     { resolve: true, printMethod: 'dom.get_text' }
   ),
   styles: createShortcutCommand(
@@ -93,27 +95,34 @@ export const SHORTCUT_COMMANDS = {
   html: createShortcutCommand(
     'dom.get_html',
     'bbx html <ref|selector> [maxLen]',
-    (r, ref) => ({ elementRef: ref, maxLength: r[1] ? parseIntArg(r[1], 'maxLen') : undefined }),
+    (r, ref) => ({
+      elementRef: ref,
+      maxLength: r[1] ? parseIntArg(r[1], 'maxLen') : undefined,
+    }),
     { resolve: true }
   ),
   'patch-style': createShortcutCommand(
     'patch.apply_styles',
     'bbx patch-style <ref|sel> prop=val',
-    (r, ref) => ({ target: { elementRef: ref }, declarations: parsePropertyAssignments(r.slice(1)) }),
+    (r, ref) => ({
+      target: { elementRef: ref },
+      declarations: parsePropertyAssignments(r.slice(1)),
+    }),
     { resolve: true }
   ),
   'patch-text': createShortcutCommand(
     'patch.apply_dom',
     'bbx patch-text <ref|sel> <text...>',
-    (r, ref) => ({ target: { elementRef: ref }, operation: 'set_text', value: r.slice(1).join(' ') }),
+    (r, ref) => ({
+      target: { elementRef: ref },
+      operation: 'set_text',
+      value: r.slice(1).join(' '),
+    }),
     { resolve: true, description: 'Apply a reversible DOM text patch' }
   ),
-  patches: createShortcutCommand(
-    'patch.list',
-    'bbx patches',
-    () => ({}),
-    { printMethod: 'patch.list' }
-  ),
+  patches: createShortcutCommand('patch.list', 'bbx patches', () => ({}), {
+    printMethod: 'patch.list',
+  }),
   rollback: createShortcutCommand('patch.rollback', 'bbx rollback <patchId>', (r) => {
     if (!r[0]) throw new Error('Usage: rollback <patchId>');
     return { patchId: r[0] };
@@ -122,11 +131,17 @@ export const SHORTCUT_COMMANDS = {
     'page.get_console',
     'bbx console [level]',
     (r) => ({ level: r[0] || 'all', clear: false }),
-    { printMethod: 'page.get_console', description: 'Read buffered console output (log|warn|error|all)' }
+    {
+      printMethod: 'page.get_console',
+      description: 'Read buffered console output (log|warn|error|all)',
+    }
   ),
   wait: createShortcutCommand('dom.wait_for', 'bbx wait <selector> [timeoutMs]', (r) => {
     if (!r[0]) throw new Error('Usage: wait <selector> [timeoutMs]');
-    return { selector: r[0], timeoutMs: r[1] ? parseIntArg(r[1], 'timeoutMs') : 5000 };
+    return {
+      selector: r[0],
+      timeoutMs: r[1] ? parseIntArg(r[1], 'timeoutMs') : 5000,
+    };
   }),
   find: createShortcutCommand(
     'dom.find_by_text',
@@ -138,19 +153,23 @@ export const SHORTCUT_COMMANDS = {
     },
     { printMethod: 'dom.find_by_text' }
   ),
-  'find-role': createShortcutCommand('dom.find_by_role', 'bbx find-role <role> [name]', (r) => {
-    if (!r[0]) throw new Error('Usage: find-role <role> [name]');
-    return { role: r[0], name: r.slice(1).join(' ') || undefined };
-  }, { printMethod: 'dom.find_by_role' }),
+  'find-role': createShortcutCommand(
+    'dom.find_by_role',
+    'bbx find-role <role> [name]',
+    (r) => {
+      if (!r[0]) throw new Error('Usage: find-role <role> [name]');
+      return { role: r[0], name: r.slice(1).join(' ') || undefined };
+    },
+    { printMethod: 'dom.find_by_role' }
+  ),
   navigate: createShortcutCommand('navigation.navigate', 'bbx navigate <url>', (r) => {
     if (!r[0]) throw new Error('Usage: navigate <url>');
     return { url: r[0] };
   }),
-  storage: createShortcutCommand(
-    'page.get_storage',
-    'bbx storage [local|session] [keys]',
-    (r) => ({ type: r[0] === 'session' ? 'session' : 'local', keys: r.slice(1).length ? r.slice(1) : undefined })
-  ),
+  storage: createShortcutCommand('page.get_storage', 'bbx storage [local|session] [keys]', (r) => ({
+    type: r[0] === 'session' ? 'session' : 'local',
+    keys: r.slice(1).length ? r.slice(1) : undefined,
+  })),
   'page-text': createShortcutCommand(
     'page.get_text',
     'bbx page-text [textBudget]',
@@ -161,21 +180,33 @@ export const SHORTCUT_COMMANDS = {
     'page.get_network',
     'bbx network [limit]',
     (r) => ({ limit: r[0] ? parseIntArg(r[0], 'limit') : undefined }),
-    { printMethod: 'page.get_network', description: 'Read buffered network requests (fetch/XHR)' }
+    {
+      printMethod: 'page.get_network',
+      description: 'Read buffered network requests (fetch/XHR)',
+    }
   ),
   'a11y-tree': createShortcutCommand(
     'dom.get_accessibility_tree',
     'bbx a11y-tree [maxNodes] [maxDepth]',
-    (r) => ({ maxNodes: r[0] ? parseIntArg(r[0], 'maxNodes') : undefined, maxDepth: r[1] ? parseIntArg(r[1], 'maxDepth') : undefined })
+    (r) => ({
+      maxNodes: r[0] ? parseIntArg(r[0], 'maxNodes') : undefined,
+      maxDepth: r[1] ? parseIntArg(r[1], 'maxDepth') : undefined,
+    })
   ),
   perf: createShortcutCommand('performance.get_metrics', 'bbx perf', () => ({})),
   scroll: createShortcutCommand('viewport.scroll', 'bbx scroll <top> [left]', (r) => {
     if (!r[0] && !r[1]) throw new Error('Usage: scroll <top> [left]');
-    return { top: r[0] ? parseIntArg(r[0], 'top') : undefined, left: r[1] ? parseIntArg(r[1], 'left') : undefined };
+    return {
+      top: r[0] ? parseIntArg(r[0], 'top') : undefined,
+      left: r[1] ? parseIntArg(r[1], 'left') : undefined,
+    };
   }),
   resize: createShortcutCommand('viewport.resize', 'bbx resize <width> <height>', (r) => {
     if (!r[0] || !r[1]) throw new Error('Usage: resize <width> <height>');
-    return { width: parseIntArg(r[0], 'width'), height: parseIntArg(r[1], 'height') };
+    return {
+      width: parseIntArg(r[0], 'width'),
+      height: parseIntArg(r[1], 'height'),
+    };
   }),
   reload: createShortcutCommand('navigation.reload', 'bbx reload', () => ({})),
   back: createShortcutCommand('navigation.go_back', 'bbx back', () => ({})),
@@ -191,7 +222,7 @@ export const SHORTCUT_COMMANDS = {
     'bbx matched-rules <ref|selector>',
     (_r, ref) => ({ elementRef: ref }),
     { resolve: true, printMethod: 'styles.get_matched_rules' }
-  )
+  ),
 };
 
 /** @type {Readonly<Record<string, BridgeMethod>>} */
@@ -207,7 +238,7 @@ export const CLI_METHOD_BINDINGS = Object.freeze({
   ...Object.fromEntries(BRIDGE_METHODS.map((method) => [method, method])),
   'press-key': 'input.press_key',
   screenshot: 'screenshot.capture_element',
-  eval: 'page.evaluate'
+  eval: 'page.evaluate',
 });
 
 /** @type {ReadonlyArray<{ title: string, lines: readonly string[] }>} */
@@ -228,18 +259,18 @@ export const CLI_HELP_SECTIONS = Object.freeze([
       'bbx tab-create [url]                                               Create a new tab',
       'bbx tab-close <tabId>                                              Close a tab',
       'bbx skill                                                          Runtime budget presets and method groups',
-      'bbx mcp serve                                                      Start Browser Bridge as an MCP stdio server'
-    ]
+      'bbx mcp serve                                                      Start Browser Bridge as an MCP stdio server',
+    ],
   },
   {
     title: 'Generic RPC',
     lines: [
       'bbx call [--tab <tabId>] <method> [paramsJson|-]                   Call any bridge method (- reads JSON from stdin)',
       'bbx <method> [--tab <tabId>] [paramsJson|-]                        Direct alias for exact bridge methods such as page.get_state',
-      'bbx batch \'[{method,params,tabId?},...]\'                           Parallel method calls',
+      "bbx batch '[{method,params,tabId?},...]'                           Parallel method calls",
       'Advanced bridge params stay available through `bbx call`, even when shortcuts expose only the common case.',
-      'For open-ended investigation, start with `bbx batch` on `page.get_state`, `dom.query`, and `page.get_text` before any screenshot or CDP call.'
-    ]
+      'For open-ended investigation, start with `bbx batch` on `page.get_state`, `dom.query`, and `page.get_text` before any screenshot or CDP call.',
+    ],
   },
   {
     title: 'Inspect',
@@ -253,19 +284,21 @@ export const CLI_HELP_SECTIONS = Object.freeze([
         'attrs',
         'matched-rules',
         'box',
-        'a11y-tree'
-      ].map((command) => `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`)
-    ]
+        'a11y-tree',
+      ].map(
+        (command) =>
+          `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`
+      ),
+    ],
   },
   {
     title: 'Find',
     lines: [
-      ...[
-        'find',
-        'find-role',
-        'wait'
-      ].map((command) => `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`)
-    ]
+      ...['find', 'find-role', 'wait'].map(
+        (command) =>
+          `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`
+      ),
+    ],
   },
   {
     title: 'Page',
@@ -282,37 +315,36 @@ export const CLI_HELP_SECTIONS = Object.freeze([
         'forward',
         'perf',
         'scroll',
-        'resize'
-      ].map((command) => `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`)
-    ]
+        'resize',
+      ].map(
+        (command) =>
+          `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`
+      ),
+    ],
   },
   {
     title: 'Interact',
     lines: [
-      ...[
-        'click',
-        'focus',
-        'type',
-        'hover'
-      ].map((command) => `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`),
-      'bbx press-key <key> [ref|selector]                                 Send key event'
-    ]
+      ...['click', 'focus', 'type', 'hover'].map(
+        (command) =>
+          `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`
+      ),
+      'bbx press-key <key> [ref|selector]                                 Send key event',
+    ],
   },
   {
     title: 'Patch',
     lines: [
-      ...[
-        'patch-style',
-        'patch-text',
-        'patches',
-        'rollback'
-      ].map((command) => `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`)
-    ]
+      ...['patch-style', 'patch-text', 'patches', 'rollback'].map(
+        (command) =>
+          `${SHORTCUT_COMMANDS[command].usage.padEnd(64)} ${SHORTCUT_COMMANDS[command].description}`
+      ),
+    ],
   },
   {
     title: 'Capture',
     lines: [
-      'bbx screenshot <ref|selector> [path]                               Capture partial element screenshot'
-    ]
-  }
+      'bbx screenshot <ref|selector> [path]                               Capture partial element screenshot',
+    ],
+  },
 ]);

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

@@ -16,8 +16,7 @@ const platform = process.platform;
  */
 function getVsCodeUserDataDir() {
   if (platform === 'win32') {
-    const appData =
-      process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+    const appData = process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
     return path.join(appData, 'Code');
   }
   if (platform === 'linux') {
@@ -58,11 +57,9 @@ function commandExists(cmd) {
 function detectCopilot() {
   if (fsExists(path.join(getVsCodeUserDataDir(), 'User'))) return true;
   if (fsExists(path.join(home, '.vscode'))) return true;
-  if (platform === 'darwin')
-    return fsExists('/Applications/Visual Studio Code.app');
+  if (platform === 'darwin') return fsExists('/Applications/Visual Studio Code.app');
   if (platform === 'win32') {
-    const localAppData =
-      process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
+    const localAppData = process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
     return fsExists(path.join(localAppData, 'Programs', 'Microsoft VS Code'));
   }
   return commandExists('code');

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

@@ -29,9 +29,7 @@ const targetAliases = /** @type {const} */ ({
 
 const packageManifest = loadPackageManifest();
 const managedPackageName =
-  typeof packageManifest.name === 'string'
-    ? packageManifest.name
-    : '@browserbridge/bbx';
+  typeof packageManifest.name === 'string' ? packageManifest.name : '@browserbridge/bbx';
 const managedPackageVersion =
   typeof packageManifest.version === 'string' ? packageManifest.version : null;
 const copilotBrowserBridgeNote = [
@@ -91,9 +89,7 @@ export function parseInstallAgentArgs(args, cwd = process.cwd()) {
     if (arg === '--agents' || arg === '--agent') {
       const value = args[index + 1];
       if (!value) {
-        throw new Error(
-          'Usage: install-skill [targets|all] [--project <path>]',
-        );
+        throw new Error('Usage: install-skill [targets|all] [--project <path>]');
       }
       targets = parseTargetList(value);
       index += 1;
@@ -113,9 +109,7 @@ export function parseInstallAgentArgs(args, cwd = process.cwd()) {
     if (arg === '--project') {
       const value = args[index + 1];
       if (!value) {
-        throw new Error(
-          'Usage: install-skill [targets|all] [--project <path>] [--global]',
-        );
+        throw new Error('Usage: install-skill [targets|all] [--project <path>] [--global]');
       }
       projectPath = path.resolve(cwd, value);
       isGlobal = false;
@@ -204,7 +198,7 @@ export async function installMcpClientSetup(clients, options) {
         global: options.global,
         cwd: options.projectPath,
         stdout: options.stdout,
-      }),
+      })
     );
   }
 
@@ -289,7 +283,7 @@ function parseTargetList(raw) {
     );
     if (!canonical) {
       throw new Error(
-        `Unknown install-skill target "${value}". Supported targets: ${supportedTargets.join(', ')}, all. Aliases: openai -> codex, google -> antigravity.`,
+        `Unknown install-skill target "${value}". Supported targets: ${supportedTargets.join(', ')}, all. Aliases: openai -> codex, google -> antigravity.`
       );
     }
     parsed.add(canonical);
@@ -380,7 +374,7 @@ export function formatManagedSkillSentinel(skillName) {
       version: managedPackageVersion,
     },
     null,
-    2,
+    2
   )}\n`;
 }
 
@@ -414,10 +408,7 @@ export function parseManagedSkillSentinel(raw) {
  * @param {string | null} [currentVersion=managedPackageVersion]
  * @returns {boolean}
  */
-export function isManagedVersionOutdated(
-  installedVersion,
-  currentVersion = managedPackageVersion,
-) {
+export function isManagedVersionOutdated(installedVersion, currentVersion = managedPackageVersion) {
   if (!currentVersion) {
     return false;
   }
@@ -439,19 +430,13 @@ async function installManagedSkill(skillName, target, targetDir) {
   const targetExists = await pathExists(targetDir);
 
   if (targetExists && !(await pathExists(sentinelPath))) {
-    throw new Error(
-      `Refusing to overwrite unmanaged skill directory: ${targetDir}`,
-    );
+    throw new Error(`Refusing to overwrite unmanaged skill directory: ${targetDir}`);
   }
 
   await fs.promises.rm(targetDir, { recursive: true, force: true });
   await copyDir(sourceDir, targetDir);
   await applyManagedSkillPatches(skillName, target, targetDir);
-  await fs.promises.writeFile(
-    sentinelPath,
-    formatManagedSkillSentinel(skillName),
-    'utf8',
-  );
+  await fs.promises.writeFile(sentinelPath, formatManagedSkillSentinel(skillName), 'utf8');
 }
 
 /**
@@ -532,9 +517,7 @@ async function applyManagedSkillPatches(skillName, target, targetDir) {
  */
 function loadPackageManifest() {
   try {
-    return JSON.parse(
-      fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'),
-    );
+    return JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
   } catch {
     return {};
   }

package/packages/agent-client/src/mcp-config.js

@@ -48,8 +48,7 @@ const BROWSER_BRIDGE_SERVER_NAME = 'browser-bridge';
 function getVsCodeUserDataDir() {
   const home = os.homedir();
   if (process.platform === 'win32') {
-    const appData =
-      process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+    const appData = process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
     return path.join(appData, 'Code');
   }
   if (process.platform === 'linux') {
@@ -79,9 +78,7 @@ function getLegacyCopilotVsCodeConfigPath() {
  * @returns {{ key: string, includeType: boolean, legacyKeys?: string[], keepEmptyBlock?: boolean }}
  */
 export function getMcpConfigShape(clientName) {
-  return (
-    MCP_CONFIG_SHAPES[clientName] ?? { key: 'mcpServers', includeType: false }
-  );
+  return MCP_CONFIG_SHAPES[clientName] ?? { key: 'mcpServers', includeType: false };
 }
 
 /**
@@ -143,9 +140,7 @@ export function buildMcpConfig(clientName) {
   }
   const serverConfig = createBaseServerConfig(clientName);
   const shape = getMcpConfigShape(clientName);
-  const entry = shape.includeType
-    ? { type: 'stdio', ...serverConfig }
-    : serverConfig;
+  const entry = shape.includeType ? { type: 'stdio', ...serverConfig } : serverConfig;
   return { [shape.key]: { [BROWSER_BRIDGE_SERVER_NAME]: entry } };
 }
 
@@ -169,10 +164,7 @@ export function formatMcpConfig(clientName) {
  * @param {{ global: boolean, cwd?: string }} options
  * @returns {string}
  */
-export function getMcpConfigPath(
-  clientName,
-  { global: isGlobal, cwd = process.cwd() },
-) {
+export function getMcpConfigPath(clientName, { global: isGlobal, cwd = process.cwd() }) {
   const home = os.homedir();
 
   if (!isGlobal) {
@@ -252,7 +244,9 @@ export async function getMcpConfigPaths(clientName, options) {
     const entries = await readdir(profilesDir, { withFileTypes: true });
     const profilePaths = entries
       .filter((/** @type {import('node:fs').Dirent} */ entry) => entry.isDirectory())
-      .map((/** @type {import('node:fs').Dirent} */ entry) => path.join(profilesDir, entry.name, 'mcp.json'));
+      .map((/** @type {import('node:fs').Dirent} */ entry) =>
+        path.join(profilesDir, entry.name, 'mcp.json')
+      );
     for (const profilePath of profilePaths) {
       if (!paths.includes(profilePath)) {
         paths.push(profilePath);
@@ -533,11 +527,7 @@ async function installJsonMcpConfig(clientName, configPath, stdout) {
   }
 
   await fs.promises.mkdir(path.dirname(configPath), { recursive: true });
-  await fs.promises.writeFile(
-    configPath,
-    `${JSON.stringify(merged, null, 2)}\n`,
-    'utf8',
-  );
+  await fs.promises.writeFile(configPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
   stdout.write(`Wrote ${configPath}\n`);
 }
 
@@ -600,11 +590,7 @@ async function removeJsonMcpConfig(clientName, configPath, stdout) {
   }
 
   await fs.promises.mkdir(path.dirname(configPath), { recursive: true });
-  await fs.promises.writeFile(
-    configPath,
-    `${JSON.stringify(merged, null, 2)}\n`,
-    'utf8',
-  );
+  await fs.promises.writeFile(configPath, `${JSON.stringify(merged, null, 2)}\n`, 'utf8');
   stdout.write(`Removed ${configPath}\n`);
   return true;
 }
@@ -647,16 +633,11 @@ export function parseInstalledMcpConfig(clientName, raw) {
     const parsed = JSON.parse(raw);
     const block =
       parsed && typeof parsed === 'object' && !Array.isArray(parsed)
-        ? getMergedJsonMcpBlock(
-          /** @type {Record<string, unknown>} */ (parsed),
-          clientName,
-        )
+        ? getMergedJsonMcpBlock(/** @type {Record<string, unknown>} */ (parsed), clientName)
         : {};
     return {
       configured: Boolean(
-        block &&
-        typeof block === 'object' &&
-        Object.hasOwn(block, BROWSER_BRIDGE_SERVER_NAME),
+        block && typeof block === 'object' && Object.hasOwn(block, BROWSER_BRIDGE_SERVER_NAME)
       ),
     };
   } catch {