@agent-infra/browser 0.0.1

package/dist/base-browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-browser.mjs","sources":["webpack://@agent-infra/browser/./src/base-browser.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n/*\n * Copyright (c) 2025 Bytedance, Inc. and its affiliates.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport * as puppeteer from 'puppeteer-core';\nimport { Logger, defaultLogger } from '@agent-infra/logger';\nimport {\n  BrowserInterface,\n  EvaluateOnNewPageOptions,\n  LaunchOptions,\n  Page,\n} from './types';\n\n/**\n * Configuration options for the BaseBrowser class\n * @interface BaseBrowserOptions\n * @property {Logger} [logger] - Custom logger instance to use for browser logging\n */\nexport interface BaseBrowserOptions {\n  logger?: Logger;\n}\n\n/**\n * Abstract base class that implements common browser automation functionality\n * Provides a foundation for specific browser implementations with shared capabilities\n * @abstract\n * @implements {BrowserInterface}\n */\nexport abstract class BaseBrowser implements BrowserInterface {\n  /**\n   * The underlying Puppeteer browser instance\n   * @protected\n   */\n  protected browser: puppeteer.Browser | null = null;\n\n  /**\n   * Logger instance for browser-related logging\n   * @protected\n   */\n  protected logger: Logger;\n\n  /**\n   * Reference to the currently active browser page\n   * @protected\n   */\n  protected activePage: Page | null = null;\n\n  /**\n   * Creates an instance of BaseBrowser\n   * @param {BaseBrowserOptions} [options] - Configuration options\n   */\n  constructor(options?: BaseBrowserOptions) {\n    this.logger = options?.logger ?? defaultLogger;\n    this.logger.info('Browser Options:', options);\n  }\n\n  /**\n   * Get the underlying Puppeteer browser instance\n   * @throws Error if browser is not launched\n\n   * @returns {puppeteer.Browser} Puppeteer browser instance\n   */\n  getBrowser(): puppeteer.Browser {\n    if (!this.browser) {\n      throw new Error('Browser not launched');\n    }\n    return this.browser;\n  }\n\n  /**\n   * Sets up listeners for browser page events\n   * Tracks page creation and updates active page reference\n   * @protected\n   */\n  protected async setupPageListener() {\n    if (!this.browser) return;\n\n    this.browser.on('targetcreated', async (target) => {\n      const page = await target.page();\n      if (page) {\n        this.logger.info('New page created:', await page.url());\n        this.activePage = page;\n\n        page.once('close', () => {\n          if (this.activePage === page) {\n            this.activePage = null;\n          }\n        });\n\n        page.once('error', () => {\n          if (this.activePage === page) {\n            this.activePage = null;\n          }\n        });\n      }\n    });\n  }\n\n  /**\n   * Launches the browser with specified options\n   * @abstract\n   * @param {LaunchOptions} [options] - Browser launch configuration options\n   * @returns {Promise<void>} Promise that resolves when browser is launched\n   */\n  abstract launch(options?: LaunchOptions): Promise<void>;\n\n  /**\n   * Closes the browser instance and cleans up resources\n   * @returns {Promise<void>} Promise that resolves when browser is closed\n   * @throws {Error} If browser fails to close properly\n   */\n  async close(): Promise<void> {\n    this.logger.info('Closing browser');\n    try {\n      await this.browser?.close();\n      this.browser = null;\n      this.logger.success('Browser closed successfully');\n    } catch (error) {\n      this.logger.error('Failed to close browser:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Creates a new page, navigates to the specified URL, executes a function in the page context, and returns the result\n   * This method is inspired and modified from https://github.com/egoist/local-web-search/blob/04608ed09aa103e2fff6402c72ca12edfb692d19/src/browser.ts#L74\n   * @template T - Type of parameters passed to the page function\n   * @template R - Return type of the page function\n   * @param {EvaluateOnNewPageOptions<T, R>} options - Configuration options for the page evaluation\n   * @returns {Promise<R | null>} Promise resolving to the result of the page function or null\n   * @throws {Error} If page creation or evaluation fails\n   */\n  async evaluateOnNewPage<T extends any[], R>(\n    options: EvaluateOnNewPageOptions<T, R>,\n  ): Promise<R | null> {\n    const {\n      url,\n      pageFunction,\n      pageFunctionParams,\n      beforePageLoad,\n      afterPageLoad,\n      beforeSendResult,\n      waitForOptions,\n    } = options;\n    const page = await this.browser!.newPage();\n    try {\n      await beforePageLoad?.(page);\n      await page.goto(url, {\n        waitUntil: 'networkidle2',\n        ...waitForOptions,\n      });\n      await afterPageLoad?.(page);\n      const _window = await page.evaluateHandle(() => window);\n      const result = await page.evaluate(\n        pageFunction,\n        _window,\n        ...pageFunctionParams,\n      );\n      await beforeSendResult?.(page, result);\n      await _window.dispose();\n      await page.close();\n      return result;\n    } catch (error) {\n      await page.close();\n      throw error;\n    }\n  }\n\n  /**\n   * Creates a new browser page\n   * @returns {Promise<Page>} Promise resolving to the newly created page\n   * @throws {Error} If browser is not launched or page creation fails\n   */\n  async createPage(): Promise<Page> {\n    if (!this.browser) {\n      this.logger.error('No active browser');\n      throw new Error('Browser not launched');\n    }\n    const page = await this.browser.newPage();\n    return page;\n  }\n\n  /**\n   * Gets the currently active page or finds an active page if none is currently tracked\n   * If no active pages exist, creates a new page\n   * @returns {Promise<Page>} Promise resolving to the active page\n   * @throws {Error} If browser is not launched or no active page can be found/created\n   */\n  async getActivePage(): Promise<Page> {\n    if (!this.browser) {\n      throw new Error('Browser not launched');\n    }\n\n    // If activePage exists and is still available, return directly\n    if (this.activePage) {\n      try {\n        // Verify that the page is still available\n        await this.activePage.evaluate(() => document.readyState);\n        return this.activePage;\n      } catch (e) {\n        this.logger.warn('Active page no longer available:', e);\n        this.activePage = null;\n      }\n    }\n\n    // Get all pages and find the last active page\n    const pages = await this.browser.pages();\n\n    if (pages.length === 0) {\n      this.activePage = await this.createPage();\n      return this.activePage;\n    }\n\n    // Find the last responding page\n    for (let i = pages.length - 1; i >= 0; i--) {\n      const page = pages[i];\n      try {\n        await page.evaluate(() => document.readyState);\n        this.activePage = page;\n        return page;\n      } catch (e) {\n        continue;\n      }\n    }\n\n    throw new Error('No active page found');\n  }\n}\n"],"names":["BaseBrowser","Error","target","page","_this_browser","error","options","url","pageFunction","pageFunctionParams","beforePageLoad","afterPageLoad","beforeSendResult","waitForOptions","_window","window","result","document","e","pages","i","defaultLogger"],"mappings":"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"}

package/dist/browser-finder.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The following code is modified based on
+ * https://github.com/egoist/local-web-search/blob/main/src/find-browser.ts
+ *
+ * MIT Licensed
+ * Copyright (c) 2025 ChatWise (https://chatwise.app) <kevin@chatwise.app>
+ * https://github.com/egoist/local-web-search/blob/main/LICENSE
+ */
+import { Logger } from '@agent-infra/logger';
+/**
+ * Class responsible for finding and managing browser installations
+ * Detects installed browsers and their profiles across different platforms
+ */
+export declare class BrowserFinder {
+    /**
+     * Logger instance for diagnostic output
+     * @private
+     */
+    private logger;
+    /**
+     * Creates a new BrowserFinder instance
+     * @param {Logger} [logger] - Optional custom logger
+     */
+    constructor(logger?: Logger);
+    /**
+     * Getter that returns the list of supported browsers with their platform-specific paths
+     * @returns {Browser[]} Array of browser configurations
+     * @private
+     */
+    private get browsers();
+    /**
+     * Find a specific browser or the first available browser
+     * @param {string} [name] - Optional browser name to find
+     * @returns {{ executable: string; userDataDir: string }} Browser executable and user data paths
+     * @throws {Error} If no supported browser is found or the platform is unsupported
+     */
+    findBrowser(name?: string): {
+        executable: string;
+        userDataDir: string;
+    };
+    /**
+     * Get browser profiles for a specific browser
+     * Reads the Local State file to extract profile information
+     * @param {string} [browserName] - Optional browser name to get profiles for
+     * @returns {Array<{ displayName: string; path: string }>} Array of profile objects with display names and paths
+     */
+    getBrowserProfiles(browserName?: string): Array<{
+        displayName: string;
+        path: string;
+    }>;
+    /**
+     * Legacy method for backwards compatibility
+     * Finds Chrome browser executable path
+     * @deprecated Use findBrowser instead
+     * @returns {string | null} Chrome executable path or null if not found
+     */
+    findChrome(): string | null;
+}
+//# sourceMappingURL=browser-finder.d.ts.map

package/dist/browser-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder.d.ts","sourceRoot":"","sources":["../src/browser-finder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AAsC5D;;;GAGG;AACH,qBAAa,aAAa;IACxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,MAAM,CAAC,EAAE,MAAM;IAI3B;;;;OAIG;IACH,OAAO,KAAK,QAAQ,GAiDnB;IAED;;;;;OAKG;IACH,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACrB;IAuCD;;;;;OAKG;IACH,kBAAkB,CAChB,WAAW,CAAC,EAAE,MAAM,GACnB,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB/C;;;;;OAKG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;CAQ5B"}

package/dist/browser-finder.js

@@ -0,0 +1,148 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    BrowserFinder: ()=>BrowserFinder
+});
+const external_fs_namespaceObject = require("fs");
+const external_path_namespaceObject = require("path");
+const external_os_namespaceObject = require("os");
+const logger_namespaceObject = require("@agent-infra/logger");
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class BrowserFinder {
+    get browsers() {
+        const HOME_DIR = external_os_namespaceObject.homedir();
+        const LOCAL_APP_DATA = process.env.LOCALAPPDATA;
+        return [
+            {
+                name: 'Chromium',
+                executable: {
+                    win32: 'C:\\Program Files\\Chromium\\Application\\chrome.exe',
+                    darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',
+                    linux: '/usr/bin/chromium'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Chromium\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Chromium`,
+                    linux: `${HOME_DIR}/.config/chromium`
+                }
+            },
+            {
+                name: 'Google Chrome',
+                executable: {
+                    win32: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+                    darwin: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+                    linux: '/usr/bin/google-chrome'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,
+                    linux: `${HOME_DIR}/.config/google-chrome`
+                }
+            },
+            {
+                name: 'Google Chrome Canary',
+                executable: {
+                    win32: 'C:\\Program Files\\Google\\Chrome Canary\\Application\\chrome.exe',
+                    darwin: '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+                    linux: '/usr/bin/google-chrome-canary'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome Canary\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,
+                    linux: `${HOME_DIR}/.config/google-chrome-canary`
+                }
+            }
+        ];
+    }
+    findBrowser(name) {
+        const platform = process.platform;
+        this.logger.info('Finding browser on platform:', platform);
+        if ('darwin' !== platform && 'win32' !== platform && 'linux' !== platform) {
+            const error = new Error(`Unsupported platform: ${platform}`);
+            this.logger.error(error.message);
+            throw error;
+        }
+        const browser = name ? this.browsers.find((b)=>b.name === name && external_fs_namespaceObject.existsSync(b.executable[platform])) : this.browsers.find((b)=>external_fs_namespaceObject.existsSync(b.executable[platform]));
+        this.logger.log('browser', browser);
+        if (!browser) {
+            const error = name ? new Error(`Cannot find browser: ${name}`) : new Error('Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.');
+            this.logger.error(error.message);
+            throw error;
+        }
+        const result = {
+            executable: browser.executable[platform],
+            userDataDir: browser.userDataDir[platform]
+        };
+        this.logger.success(`Found browser: ${browser.name}`);
+        this.logger.info('Browser details:', result);
+        return result;
+    }
+    getBrowserProfiles(browserName) {
+        const browser = this.findBrowser(browserName);
+        try {
+            const localState = JSON.parse(external_fs_namespaceObject.readFileSync(external_path_namespaceObject.join(browser.userDataDir, 'Local State'), 'utf8'));
+            const profileInfo = localState.profile.info_cache;
+            return Object.entries(profileInfo).map(([profileName, info])=>({
+                    displayName: info.name,
+                    path: external_path_namespaceObject.join(browser.userDataDir, profileName)
+                }));
+        } catch (error) {
+            return [];
+        }
+    }
+    findChrome() {
+        try {
+            const { executable } = this.findBrowser('Google Chrome');
+            return executable;
+        } catch  {
+            return null;
+        }
+    }
+    constructor(logger){
+        _define_property(this, "logger", void 0);
+        this.logger = logger ?? logger_namespaceObject.defaultLogger;
+    }
+}
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=browser-finder.js.map

package/dist/browser-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder.js","sources":["webpack://@agent-infra/browser/./src/browser-finder.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/egoist/local-web-search/blob/main/src/find-browser.ts\n *\n * MIT Licensed\n * Copyright (c) 2025 ChatWise (https://chatwise.app) <kevin@chatwise.app>\n * https://github.com/egoist/local-web-search/blob/main/LICENSE\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { Logger, defaultLogger } from '@agent-infra/logger';\n\n/**\n * Interface defining browser locations and configurations\n * Contains paths and settings for different operating systems\n * @interface Browser\n */\ninterface Browser {\n  /**\n   * Browser name identifier\n   */\n  name: string;\n\n  /**\n   * Executable paths by platform\n   * @property {string} win32 - Windows executable path\n   * @property {string} darwin - macOS executable path\n   * @property {string} linux - Linux executable path\n   */\n  executable: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n\n  /**\n   * User data directory paths by platform\n   * @property {string} win32 - Windows user data directory\n   * @property {string} darwin - macOS user data directory\n   * @property {string} linux - Linux user data directory\n   */\n  userDataDir: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n}\n\n/**\n * Class responsible for finding and managing browser installations\n * Detects installed browsers and their profiles across different platforms\n */\nexport class BrowserFinder {\n  /**\n   * Logger instance for diagnostic output\n   * @private\n   */\n  private logger: Logger;\n\n  /**\n   * Creates a new BrowserFinder instance\n   * @param {Logger} [logger] - Optional custom logger\n   */\n  constructor(logger?: Logger) {\n    this.logger = logger ?? defaultLogger;\n  }\n\n  /**\n   * Getter that returns the list of supported browsers with their platform-specific paths\n   * @returns {Browser[]} Array of browser configurations\n   * @private\n   */\n  private get browsers(): Browser[] {\n    // Get HOME_DIR inside the getter to ensure it's always current\n    const HOME_DIR = os.homedir();\n    const LOCAL_APP_DATA = process.env.LOCALAPPDATA;\n\n    return [\n      {\n        name: 'Chromium',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Chromium\\\\Application\\\\chrome.exe',\n          darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',\n          linux: '/usr/bin/chromium',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Chromium\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Chromium`,\n          linux: `${HOME_DIR}/.config/chromium`,\n        },\n      },\n      {\n        name: 'Google Chrome',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n          linux: '/usr/bin/google-chrome',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,\n          linux: `${HOME_DIR}/.config/google-chrome`,\n        },\n      },\n      {\n        name: 'Google Chrome Canary',\n        executable: {\n          win32:\n            'C:\\\\Program Files\\\\Google\\\\Chrome Canary\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n          linux: '/usr/bin/google-chrome-canary',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome Canary\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,\n          linux: `${HOME_DIR}/.config/google-chrome-canary`,\n        },\n      },\n    ];\n  }\n\n  /**\n   * Find a specific browser or the first available browser\n   * @param {string} [name] - Optional browser name to find\n   * @returns {{ executable: string; userDataDir: string }} Browser executable and user data paths\n   * @throws {Error} If no supported browser is found or the platform is unsupported\n   */\n  findBrowser(name?: string): {\n    executable: string;\n    userDataDir: string;\n  } {\n    const platform = process.platform;\n    this.logger.info('Finding browser on platform:', platform);\n\n    if (platform !== 'darwin' && platform !== 'win32' && platform !== 'linux') {\n      const error = new Error(`Unsupported platform: ${platform}`);\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const browser = name\n      ? this.browsers.find(\n          (b) => b.name === name && fs.existsSync(b.executable[platform]),\n        )\n      : this.browsers.find((b) => fs.existsSync(b.executable[platform]));\n\n    this.logger.log('browser', browser);\n\n    if (!browser) {\n      const error = name\n        ? new Error(`Cannot find browser: ${name}`)\n        : new Error(\n            'Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.',\n          );\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const result = {\n      executable: browser.executable[platform],\n      userDataDir: browser.userDataDir[platform],\n    };\n\n    this.logger.success(`Found browser: ${browser.name}`);\n    this.logger.info('Browser details:', result);\n\n    return result;\n  }\n\n  /**\n   * Get browser profiles for a specific browser\n   * Reads the Local State file to extract profile information\n   * @param {string} [browserName] - Optional browser name to get profiles for\n   * @returns {Array<{ displayName: string; path: string }>} Array of profile objects with display names and paths\n   */\n  getBrowserProfiles(\n    browserName?: string,\n  ): Array<{ displayName: string; path: string }> {\n    const browser = this.findBrowser(browserName);\n\n    try {\n      const localState = JSON.parse(\n        fs.readFileSync(path.join(browser.userDataDir, 'Local State'), 'utf8'),\n      );\n      const profileInfo = localState.profile.info_cache;\n\n      return Object.entries(profileInfo).map(\n        ([profileName, info]: [string, any]) => ({\n          displayName: info.name,\n          path: path.join(browser.userDataDir, profileName),\n        }),\n      );\n    } catch (error) {\n      return [];\n    }\n  }\n\n  /**\n   * Legacy method for backwards compatibility\n   * Finds Chrome browser executable path\n   * @deprecated Use findBrowser instead\n   * @returns {string | null} Chrome executable path or null if not found\n   */\n  findChrome(): string | null {\n    try {\n      const { executable } = this.findBrowser('Google Chrome');\n      return executable;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["BrowserFinder","HOME_DIR","os","LOCAL_APP_DATA","process","name","platform","error","Error","browser","b","fs","result","browserName","localState","JSON","path","profileInfo","Object","profileName","info","executable","logger","defaultLogger"],"mappings":"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"}

package/dist/browser-finder.mjs

@@ -0,0 +1,116 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+import * as __WEBPACK_EXTERNAL_MODULE_fs__ from "fs";
+import * as __WEBPACK_EXTERNAL_MODULE_path__ from "path";
+import * as __WEBPACK_EXTERNAL_MODULE_os__ from "os";
+import * as __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__ from "@agent-infra/logger";
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class BrowserFinder {
+    get browsers() {
+        const HOME_DIR = __WEBPACK_EXTERNAL_MODULE_os__.homedir();
+        const LOCAL_APP_DATA = process.env.LOCALAPPDATA;
+        return [
+            {
+                name: 'Chromium',
+                executable: {
+                    win32: 'C:\\Program Files\\Chromium\\Application\\chrome.exe',
+                    darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',
+                    linux: '/usr/bin/chromium'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Chromium\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Chromium`,
+                    linux: `${HOME_DIR}/.config/chromium`
+                }
+            },
+            {
+                name: 'Google Chrome',
+                executable: {
+                    win32: 'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+                    darwin: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+                    linux: '/usr/bin/google-chrome'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,
+                    linux: `${HOME_DIR}/.config/google-chrome`
+                }
+            },
+            {
+                name: 'Google Chrome Canary',
+                executable: {
+                    win32: 'C:\\Program Files\\Google\\Chrome Canary\\Application\\chrome.exe',
+                    darwin: '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+                    linux: '/usr/bin/google-chrome-canary'
+                },
+                userDataDir: {
+                    win32: `${LOCAL_APP_DATA}\\Google\\Chrome Canary\\User Data`,
+                    darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,
+                    linux: `${HOME_DIR}/.config/google-chrome-canary`
+                }
+            }
+        ];
+    }
+    findBrowser(name) {
+        const platform = process.platform;
+        this.logger.info('Finding browser on platform:', platform);
+        if ('darwin' !== platform && 'win32' !== platform && 'linux' !== platform) {
+            const error = new Error(`Unsupported platform: ${platform}`);
+            this.logger.error(error.message);
+            throw error;
+        }
+        const browser = name ? this.browsers.find((b)=>b.name === name && __WEBPACK_EXTERNAL_MODULE_fs__.existsSync(b.executable[platform])) : this.browsers.find((b)=>__WEBPACK_EXTERNAL_MODULE_fs__.existsSync(b.executable[platform]));
+        this.logger.log('browser', browser);
+        if (!browser) {
+            const error = name ? new Error(`Cannot find browser: ${name}`) : new Error('Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.');
+            this.logger.error(error.message);
+            throw error;
+        }
+        const result = {
+            executable: browser.executable[platform],
+            userDataDir: browser.userDataDir[platform]
+        };
+        this.logger.success(`Found browser: ${browser.name}`);
+        this.logger.info('Browser details:', result);
+        return result;
+    }
+    getBrowserProfiles(browserName) {
+        const browser = this.findBrowser(browserName);
+        try {
+            const localState = JSON.parse(__WEBPACK_EXTERNAL_MODULE_fs__.readFileSync(__WEBPACK_EXTERNAL_MODULE_path__.join(browser.userDataDir, 'Local State'), 'utf8'));
+            const profileInfo = localState.profile.info_cache;
+            return Object.entries(profileInfo).map(([profileName, info])=>({
+                    displayName: info.name,
+                    path: __WEBPACK_EXTERNAL_MODULE_path__.join(browser.userDataDir, profileName)
+                }));
+        } catch (error) {
+            return [];
+        }
+    }
+    findChrome() {
+        try {
+            const { executable } = this.findBrowser('Google Chrome');
+            return executable;
+        } catch  {
+            return null;
+        }
+    }
+    constructor(logger){
+        _define_property(this, "logger", void 0);
+        this.logger = logger ?? __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__.defaultLogger;
+    }
+}
+export { BrowserFinder };
+
+//# sourceMappingURL=browser-finder.mjs.map

package/dist/browser-finder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder.mjs","sources":["webpack://@agent-infra/browser/./src/browser-finder.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/egoist/local-web-search/blob/main/src/find-browser.ts\n *\n * MIT Licensed\n * Copyright (c) 2025 ChatWise (https://chatwise.app) <kevin@chatwise.app>\n * https://github.com/egoist/local-web-search/blob/main/LICENSE\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as os from 'os';\nimport { Logger, defaultLogger } from '@agent-infra/logger';\n\n/**\n * Interface defining browser locations and configurations\n * Contains paths and settings for different operating systems\n * @interface Browser\n */\ninterface Browser {\n  /**\n   * Browser name identifier\n   */\n  name: string;\n\n  /**\n   * Executable paths by platform\n   * @property {string} win32 - Windows executable path\n   * @property {string} darwin - macOS executable path\n   * @property {string} linux - Linux executable path\n   */\n  executable: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n\n  /**\n   * User data directory paths by platform\n   * @property {string} win32 - Windows user data directory\n   * @property {string} darwin - macOS user data directory\n   * @property {string} linux - Linux user data directory\n   */\n  userDataDir: {\n    win32: string;\n    darwin: string;\n    linux: string;\n  };\n}\n\n/**\n * Class responsible for finding and managing browser installations\n * Detects installed browsers and their profiles across different platforms\n */\nexport class BrowserFinder {\n  /**\n   * Logger instance for diagnostic output\n   * @private\n   */\n  private logger: Logger;\n\n  /**\n   * Creates a new BrowserFinder instance\n   * @param {Logger} [logger] - Optional custom logger\n   */\n  constructor(logger?: Logger) {\n    this.logger = logger ?? defaultLogger;\n  }\n\n  /**\n   * Getter that returns the list of supported browsers with their platform-specific paths\n   * @returns {Browser[]} Array of browser configurations\n   * @private\n   */\n  private get browsers(): Browser[] {\n    // Get HOME_DIR inside the getter to ensure it's always current\n    const HOME_DIR = os.homedir();\n    const LOCAL_APP_DATA = process.env.LOCALAPPDATA;\n\n    return [\n      {\n        name: 'Chromium',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Chromium\\\\Application\\\\chrome.exe',\n          darwin: '/Applications/Chromium.app/Contents/MacOS/Chromium',\n          linux: '/usr/bin/chromium',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Chromium\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Chromium`,\n          linux: `${HOME_DIR}/.config/chromium`,\n        },\n      },\n      {\n        name: 'Google Chrome',\n        executable: {\n          win32: 'C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',\n          linux: '/usr/bin/google-chrome',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome`,\n          linux: `${HOME_DIR}/.config/google-chrome`,\n        },\n      },\n      {\n        name: 'Google Chrome Canary',\n        executable: {\n          win32:\n            'C:\\\\Program Files\\\\Google\\\\Chrome Canary\\\\Application\\\\chrome.exe',\n          darwin:\n            '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',\n          linux: '/usr/bin/google-chrome-canary',\n        },\n        userDataDir: {\n          win32: `${LOCAL_APP_DATA}\\\\Google\\\\Chrome Canary\\\\User Data`,\n          darwin: `${HOME_DIR}/Library/Application Support/Google/Chrome Canary`,\n          linux: `${HOME_DIR}/.config/google-chrome-canary`,\n        },\n      },\n    ];\n  }\n\n  /**\n   * Find a specific browser or the first available browser\n   * @param {string} [name] - Optional browser name to find\n   * @returns {{ executable: string; userDataDir: string }} Browser executable and user data paths\n   * @throws {Error} If no supported browser is found or the platform is unsupported\n   */\n  findBrowser(name?: string): {\n    executable: string;\n    userDataDir: string;\n  } {\n    const platform = process.platform;\n    this.logger.info('Finding browser on platform:', platform);\n\n    if (platform !== 'darwin' && platform !== 'win32' && platform !== 'linux') {\n      const error = new Error(`Unsupported platform: ${platform}`);\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const browser = name\n      ? this.browsers.find(\n          (b) => b.name === name && fs.existsSync(b.executable[platform]),\n        )\n      : this.browsers.find((b) => fs.existsSync(b.executable[platform]));\n\n    this.logger.log('browser', browser);\n\n    if (!browser) {\n      const error = name\n        ? new Error(`Cannot find browser: ${name}`)\n        : new Error(\n            'Cannot find a supported browser on your system. Please install Chrome, Edge, or Brave.',\n          );\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    const result = {\n      executable: browser.executable[platform],\n      userDataDir: browser.userDataDir[platform],\n    };\n\n    this.logger.success(`Found browser: ${browser.name}`);\n    this.logger.info('Browser details:', result);\n\n    return result;\n  }\n\n  /**\n   * Get browser profiles for a specific browser\n   * Reads the Local State file to extract profile information\n   * @param {string} [browserName] - Optional browser name to get profiles for\n   * @returns {Array<{ displayName: string; path: string }>} Array of profile objects with display names and paths\n   */\n  getBrowserProfiles(\n    browserName?: string,\n  ): Array<{ displayName: string; path: string }> {\n    const browser = this.findBrowser(browserName);\n\n    try {\n      const localState = JSON.parse(\n        fs.readFileSync(path.join(browser.userDataDir, 'Local State'), 'utf8'),\n      );\n      const profileInfo = localState.profile.info_cache;\n\n      return Object.entries(profileInfo).map(\n        ([profileName, info]: [string, any]) => ({\n          displayName: info.name,\n          path: path.join(browser.userDataDir, profileName),\n        }),\n      );\n    } catch (error) {\n      return [];\n    }\n  }\n\n  /**\n   * Legacy method for backwards compatibility\n   * Finds Chrome browser executable path\n   * @deprecated Use findBrowser instead\n   * @returns {string | null} Chrome executable path or null if not found\n   */\n  findChrome(): string | null {\n    try {\n      const { executable } = this.findBrowser('Google Chrome');\n      return executable;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"names":["BrowserFinder","HOME_DIR","os","LOCAL_APP_DATA","process","name","platform","error","Error","browser","b","fs","result","browserName","localState","JSON","path","profileInfo","Object","profileName","info","executable","logger","defaultLogger"],"mappings":"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"}

package/dist/browser-finder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-finder.test.d.ts.map

package/dist/browser-finder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder.test.d.ts","sourceRoot":"","sources":["../src/browser-finder.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @agent-infra/browser
+ * A browser automation library based on puppeteer-core
+ *
+ * Main exports:
+ * - types: Type definitions for browser interfaces
+ * - BrowserFinder: Utility to detect and locate installed browsers
+ * - LocalBrowser: Control locally installed browsers
+ * - RemoteBrowser: Connect to remote browser instances
+ * - BaseBrowser: Abstract base class for browser implementations
+ */
+export * from './types';
+export * from './browser-finder';
+export * from './local-browser';
+export * from './remote-browser';
+export * from './base-browser';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,101 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+"use strict";
+var __webpack_modules__ = {
+    "./base-browser": function(module) {
+        module.exports = require("./base-browser.js");
+    },
+    "./browser-finder": function(module) {
+        module.exports = require("./browser-finder.js");
+    },
+    "./local-browser": function(module) {
+        module.exports = require("./local-browser.js");
+    },
+    "./remote-browser": function(module) {
+        module.exports = require("./remote-browser.js");
+    },
+    "./types": function(module) {
+        module.exports = require("./types.js");
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    var _types__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("./types");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _types__WEBPACK_IMPORTED_MODULE_0__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _types__WEBPACK_IMPORTED_MODULE_0__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _browser_finder__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__("./browser-finder");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _browser_finder__WEBPACK_IMPORTED_MODULE_1__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _browser_finder__WEBPACK_IMPORTED_MODULE_1__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _local_browser__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__("./local-browser");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _local_browser__WEBPACK_IMPORTED_MODULE_2__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _local_browser__WEBPACK_IMPORTED_MODULE_2__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _remote_browser__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__("./remote-browser");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _remote_browser__WEBPACK_IMPORTED_MODULE_3__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _remote_browser__WEBPACK_IMPORTED_MODULE_3__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+    var _base_browser__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__("./base-browser");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _base_browser__WEBPACK_IMPORTED_MODULE_4__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _base_browser__WEBPACK_IMPORTED_MODULE_4__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+})();
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
+});

package/dist/index.mjs

@@ -0,0 +1,9 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+export * from "./types.mjs";
+export * from "./browser-finder.mjs";
+export * from "./local-browser.mjs";
+export * from "./remote-browser.mjs";
+export * from "./base-browser.mjs";

package/dist/local-browser.d.ts

@@ -0,0 +1,23 @@
+import { LaunchOptions } from './types';
+import { BaseBrowser } from './base-browser';
+/**
+ * LocalBrowser class for controlling locally installed browsers
+ * Extends the BaseBrowser with functionality specific to managing local browser instances
+ * @extends BaseBrowser
+ */
+export declare class LocalBrowser extends BaseBrowser {
+    /**
+     * Browser finder instance to detect and locate installed browsers
+     * @private
+     */
+    private browserFinder;
+    /**
+     * Launches a local browser instance with specified options
+     * Automatically detects installed browsers if no executable path is provided
+     * @param {LaunchOptions} options - Configuration options for launching the browser
+     * @returns {Promise<void>} Promise that resolves when the browser is successfully launched
+     * @throws {Error} If the browser cannot be launched
+     */
+    launch(options?: LaunchOptions): Promise<void>;
+}
+//# sourceMappingURL=local-browser.d.ts.map

package/dist/local-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-browser.d.ts","sourceRoot":"","sources":["../src/local-browser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CA2DzD"}