@agent-infra/browser 0.0.2 → 0.1.0

package/dist/browser-finder/firefox-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder/firefox-paths.js","sources":["webpack://@agent-infra/browser/./src/browser-finder/firefox-paths.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/shirshak55/edge-paths/blob/master/index.ts\n *\n * MIT Licensed\n * Copyright (c) 2020 Shirshak\n * https://github.com/shirshak55/edge-paths/blob/master/LICENSE\n */\nimport { existsSync } from 'fs';\nimport { sep, join } from 'path';\nimport which from 'which';\n\nconst platform = process.platform;\n\nfunction getFirefoxOnLinux(name: 'firefox'): string | null {\n  try {\n    const path = which.sync(name);\n    return path;\n  } catch (e) {}\n\n  return null;\n}\n\nfunction getFirefoxOnWindows(\n  name: 'Mozilla Firefox' | 'Firefox Developer Edition' | 'Firefox Nightly',\n): string | null {\n  const suffix = `${sep}${name}${sep}firefox.exe`;\n\n  const prefixes = [\n    process.env.LOCALAPPDATA,\n    process.env.PROGRAMFILES,\n    process.env['PROGRAMFILES(X86)'],\n  ].filter(Boolean);\n\n  for (const prefix of prefixes) {\n    const firefoxPath = join(prefix!, suffix);\n    if (existsSync(firefoxPath)) {\n      return firefoxPath;\n    }\n  }\n\n  return null;\n}\n\nfunction getFireFoxOnDarwin(\n  name: 'Firefox' | 'Firefox Developer Edition' | 'Firefox Nightly',\n): string | null {\n  const suffix = `/Applications/${name}.app/Contents/MacOS/firefox`;\n  const prefixes = ['', process.env.HOME].filter((item) => item !== undefined);\n\n  for (const prefix of prefixes) {\n    const firefoxPath = join(prefix, suffix);\n    if (existsSync(firefoxPath)) {\n      return firefoxPath;\n    }\n  }\n\n  return null;\n}\n\nconst firefoxPaths = {\n  firefox: {\n    linux: () => getFirefoxOnLinux('firefox'), // stable/beta/dev/nightly use same 'firefox' app name\n    darwin: () => getFireFoxOnDarwin('Firefox'),\n    win32: () => getFirefoxOnWindows('Mozilla Firefox'),\n  },\n  // beta and stable use same file path\n  dev: {\n    darwin: () => getFireFoxOnDarwin('Firefox Developer Edition'),\n    win32: () => getFirefoxOnWindows('Firefox Developer Edition'),\n  },\n  nightly: {\n    darwin: () => getFireFoxOnDarwin('Firefox Nightly'),\n    win32: () => getFirefoxOnWindows('Firefox Nightly'),\n  },\n};\n\nfunction getFirefoxPath() {\n  const firefox = firefoxPaths.firefox;\n\n  if (platform && Object.keys(firefox).includes(platform)) {\n    const pth = firefox[platform as keyof typeof firefox]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nfunction getFirefoxDevPath() {\n  const dev = firefoxPaths.dev;\n\n  if (platform && Object.keys(dev).includes(platform)) {\n    const pth = dev[platform as keyof typeof dev]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nfunction getFirefoxNightlyPath() {\n  const nightly = firefoxPaths.nightly;\n\n  if (platform && Object.keys(nightly).includes(platform)) {\n    const pth = nightly[platform as keyof typeof nightly]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nexport function getAnyFirefoxStable(): string {\n  const firefox = getFirefoxPath();\n  if (firefox) {\n    return firefox;\n  }\n\n  const dev = getFirefoxDevPath();\n  if (dev) {\n    return dev;\n  }\n\n  const canary = getFirefoxNightlyPath();\n  if (canary) {\n    return canary;\n  }\n\n  const error = new Error('Unable to find any firefox browser.');\n  error.name = 'FirefoxPathsError';\n  throw error;\n}\n"],"names":["platform","process","getFirefoxOnLinux","name","path","which","e","getFirefoxOnWindows","suffix","sep","prefixes","Boolean","prefix","firefoxPath","join","existsSync","getFireFoxOnDarwin","item","undefined","firefoxPaths","getFirefoxPath","firefox","Object","pth","getFirefoxDevPath","dev","getFirefoxNightlyPath","nightly","getAnyFirefoxStable","canary","error","Error"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,MAAMA,WAAWC,QAAQ,QAAQ;AAEjC,SAASC,kBAAkBC,IAAe;IACxC,IAAI;QACF,MAAMC,OAAOC,yBAAAA,IAAU,CAACF;QACxB,OAAOC;IACT,EAAE,OAAOE,GAAG,CAAC;IAEb,OAAO;AACT;AAEA,SAASC,oBACPJ,IAAyE;IAEzE,MAAMK,SAAS,GAAGC,8BAAAA,GAAGA,GAAGN,OAAOM,8BAAAA,GAAGA,CAAC,WAAW,CAAC;IAE/C,MAAMC,WAAW;QACfT,QAAQ,GAAG,CAAC,YAAY;QACxBA,QAAQ,GAAG,CAAC,YAAY;QACxBA,QAAQ,GAAG,CAAC,oBAAoB;KACjC,CAAC,MAAM,CAACU;IAET,KAAK,MAAMC,UAAUF,SAAU;QAC7B,MAAMG,cAAcC,AAAAA,IAAAA,8BAAAA,IAAAA,AAAAA,EAAKF,QAASJ;QAClC,IAAIO,AAAAA,IAAAA,4BAAAA,UAAAA,AAAAA,EAAWF,cACb,OAAOA;IAEX;IAEA,OAAO;AACT;AAEA,SAASG,mBACPb,IAAiE;IAEjE,MAAMK,SAAS,CAAC,cAAc,EAAEL,KAAK,2BAA2B,CAAC;IACjE,MAAMO,WAAW;QAAC;QAAIT,QAAQ,GAAG,CAAC,IAAI;KAAC,CAAC,MAAM,CAAC,CAACgB,OAASA,AAASC,KAAAA,MAATD;IAEzD,KAAK,MAAML,UAAUF,SAAU;QAC7B,MAAMG,cAAcC,AAAAA,IAAAA,8BAAAA,IAAAA,AAAAA,EAAKF,QAAQJ;QACjC,IAAIO,AAAAA,IAAAA,4BAAAA,UAAAA,AAAAA,EAAWF,cACb,OAAOA;IAEX;IAEA,OAAO;AACT;AAEA,MAAMM,eAAe;IACnB,SAAS;QACP,OAAO,IAAMjB,kBAAkB;QAC/B,QAAQ,IAAMc,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;IAEA,KAAK;QACH,QAAQ,IAAMS,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;IACA,SAAS;QACP,QAAQ,IAAMS,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;AACF;AAEA,SAASa;IACP,MAAMC,UAAUF,aAAa,OAAO;IAEpC,IAAInB,YAAYsB,OAAO,IAAI,CAACD,SAAS,QAAQ,CAACrB,WAAW;QACvD,MAAMuB,MAAMF,OAAO,CAACrB,SAAiC;QACrD,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEA,SAASC;IACP,MAAMC,MAAMN,aAAa,GAAG;IAE5B,IAAInB,YAAYsB,OAAO,IAAI,CAACG,KAAK,QAAQ,CAACzB,WAAW;QACnD,MAAMuB,MAAME,GAAG,CAACzB,SAA6B;QAC7C,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEA,SAASG;IACP,MAAMC,UAAUR,aAAa,OAAO;IAEpC,IAAInB,YAAYsB,OAAO,IAAI,CAACK,SAAS,QAAQ,CAAC3B,WAAW;QACvD,MAAMuB,MAAMI,OAAO,CAAC3B,SAAiC;QACrD,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEO,SAASK;IACd,MAAMP,UAAUD;IAChB,IAAIC,SACF,OAAOA;IAGT,MAAMI,MAAMD;IACZ,IAAIC,KACF,OAAOA;IAGT,MAAMI,SAASH;IACf,IAAIG,QACF,OAAOA;IAGT,MAAMC,QAAQ,IAAIC,MAAM;IACxBD,MAAM,IAAI,GAAG;IACb,MAAMA;AACR"}

package/dist/browser-finder/firefox-paths.mjs

@@ -0,0 +1,90 @@
+/**
+* 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_which__ from "which";
+const platform = process.platform;
+function getFirefoxOnLinux(name) {
+    try {
+        const path = __WEBPACK_EXTERNAL_MODULE_which__["default"].sync(name);
+        return path;
+    } catch (e) {}
+    return null;
+}
+function getFirefoxOnWindows(name) {
+    const suffix = `${__WEBPACK_EXTERNAL_MODULE_path__.sep}${name}${__WEBPACK_EXTERNAL_MODULE_path__.sep}firefox.exe`;
+    const prefixes = [
+        process.env.LOCALAPPDATA,
+        process.env.PROGRAMFILES,
+        process.env['PROGRAMFILES(X86)']
+    ].filter(Boolean);
+    for (const prefix of prefixes){
+        const firefoxPath = (0, __WEBPACK_EXTERNAL_MODULE_path__.join)(prefix, suffix);
+        if ((0, __WEBPACK_EXTERNAL_MODULE_fs__.existsSync)(firefoxPath)) return firefoxPath;
+    }
+    return null;
+}
+function getFireFoxOnDarwin(name) {
+    const suffix = `/Applications/${name}.app/Contents/MacOS/firefox`;
+    const prefixes = [
+        '',
+        process.env.HOME
+    ].filter((item)=>void 0 !== item);
+    for (const prefix of prefixes){
+        const firefoxPath = (0, __WEBPACK_EXTERNAL_MODULE_path__.join)(prefix, suffix);
+        if ((0, __WEBPACK_EXTERNAL_MODULE_fs__.existsSync)(firefoxPath)) return firefoxPath;
+    }
+    return null;
+}
+const firefoxPaths = {
+    firefox: {
+        linux: ()=>getFirefoxOnLinux('firefox'),
+        darwin: ()=>getFireFoxOnDarwin('Firefox'),
+        win32: ()=>getFirefoxOnWindows('Mozilla Firefox')
+    },
+    dev: {
+        darwin: ()=>getFireFoxOnDarwin('Firefox Developer Edition'),
+        win32: ()=>getFirefoxOnWindows('Firefox Developer Edition')
+    },
+    nightly: {
+        darwin: ()=>getFireFoxOnDarwin('Firefox Nightly'),
+        win32: ()=>getFirefoxOnWindows('Firefox Nightly')
+    }
+};
+function getFirefoxPath() {
+    const firefox = firefoxPaths.firefox;
+    if (platform && Object.keys(firefox).includes(platform)) {
+        const pth = firefox[platform]();
+        if (pth) return pth;
+    }
+}
+function getFirefoxDevPath() {
+    const dev = firefoxPaths.dev;
+    if (platform && Object.keys(dev).includes(platform)) {
+        const pth = dev[platform]();
+        if (pth) return pth;
+    }
+}
+function getFirefoxNightlyPath() {
+    const nightly = firefoxPaths.nightly;
+    if (platform && Object.keys(nightly).includes(platform)) {
+        const pth = nightly[platform]();
+        if (pth) return pth;
+    }
+}
+function getAnyFirefoxStable() {
+    const firefox = getFirefoxPath();
+    if (firefox) return firefox;
+    const dev = getFirefoxDevPath();
+    if (dev) return dev;
+    const canary = getFirefoxNightlyPath();
+    if (canary) return canary;
+    const error = new Error('Unable to find any firefox browser.');
+    error.name = 'FirefoxPathsError';
+    throw error;
+}
+export { getAnyFirefoxStable };
+
+//# sourceMappingURL=firefox-paths.mjs.map

package/dist/browser-finder/firefox-paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder/firefox-paths.mjs","sources":["webpack://@agent-infra/browser/./src/browser-finder/firefox-paths.ts"],"sourcesContent":["/**\n * The following code is modified based on\n * https://github.com/shirshak55/edge-paths/blob/master/index.ts\n *\n * MIT Licensed\n * Copyright (c) 2020 Shirshak\n * https://github.com/shirshak55/edge-paths/blob/master/LICENSE\n */\nimport { existsSync } from 'fs';\nimport { sep, join } from 'path';\nimport which from 'which';\n\nconst platform = process.platform;\n\nfunction getFirefoxOnLinux(name: 'firefox'): string | null {\n  try {\n    const path = which.sync(name);\n    return path;\n  } catch (e) {}\n\n  return null;\n}\n\nfunction getFirefoxOnWindows(\n  name: 'Mozilla Firefox' | 'Firefox Developer Edition' | 'Firefox Nightly',\n): string | null {\n  const suffix = `${sep}${name}${sep}firefox.exe`;\n\n  const prefixes = [\n    process.env.LOCALAPPDATA,\n    process.env.PROGRAMFILES,\n    process.env['PROGRAMFILES(X86)'],\n  ].filter(Boolean);\n\n  for (const prefix of prefixes) {\n    const firefoxPath = join(prefix!, suffix);\n    if (existsSync(firefoxPath)) {\n      return firefoxPath;\n    }\n  }\n\n  return null;\n}\n\nfunction getFireFoxOnDarwin(\n  name: 'Firefox' | 'Firefox Developer Edition' | 'Firefox Nightly',\n): string | null {\n  const suffix = `/Applications/${name}.app/Contents/MacOS/firefox`;\n  const prefixes = ['', process.env.HOME].filter((item) => item !== undefined);\n\n  for (const prefix of prefixes) {\n    const firefoxPath = join(prefix, suffix);\n    if (existsSync(firefoxPath)) {\n      return firefoxPath;\n    }\n  }\n\n  return null;\n}\n\nconst firefoxPaths = {\n  firefox: {\n    linux: () => getFirefoxOnLinux('firefox'), // stable/beta/dev/nightly use same 'firefox' app name\n    darwin: () => getFireFoxOnDarwin('Firefox'),\n    win32: () => getFirefoxOnWindows('Mozilla Firefox'),\n  },\n  // beta and stable use same file path\n  dev: {\n    darwin: () => getFireFoxOnDarwin('Firefox Developer Edition'),\n    win32: () => getFirefoxOnWindows('Firefox Developer Edition'),\n  },\n  nightly: {\n    darwin: () => getFireFoxOnDarwin('Firefox Nightly'),\n    win32: () => getFirefoxOnWindows('Firefox Nightly'),\n  },\n};\n\nfunction getFirefoxPath() {\n  const firefox = firefoxPaths.firefox;\n\n  if (platform && Object.keys(firefox).includes(platform)) {\n    const pth = firefox[platform as keyof typeof firefox]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nfunction getFirefoxDevPath() {\n  const dev = firefoxPaths.dev;\n\n  if (platform && Object.keys(dev).includes(platform)) {\n    const pth = dev[platform as keyof typeof dev]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nfunction getFirefoxNightlyPath() {\n  const nightly = firefoxPaths.nightly;\n\n  if (platform && Object.keys(nightly).includes(platform)) {\n    const pth = nightly[platform as keyof typeof nightly]();\n    if (pth) {\n      return pth;\n    }\n  }\n}\n\nexport function getAnyFirefoxStable(): string {\n  const firefox = getFirefoxPath();\n  if (firefox) {\n    return firefox;\n  }\n\n  const dev = getFirefoxDevPath();\n  if (dev) {\n    return dev;\n  }\n\n  const canary = getFirefoxNightlyPath();\n  if (canary) {\n    return canary;\n  }\n\n  const error = new Error('Unable to find any firefox browser.');\n  error.name = 'FirefoxPathsError';\n  throw error;\n}\n"],"names":["platform","process","getFirefoxOnLinux","name","path","which","e","getFirefoxOnWindows","suffix","sep","prefixes","Boolean","prefix","firefoxPath","join","existsSync","getFireFoxOnDarwin","item","undefined","firefoxPaths","getFirefoxPath","firefox","Object","pth","getFirefoxDevPath","dev","getFirefoxNightlyPath","nightly","getAnyFirefoxStable","canary","error","Error"],"mappings":";;;;;;;AAYA,MAAMA,WAAWC,QAAQ,QAAQ;AAEjC,SAASC,kBAAkBC,IAAe;IACxC,IAAI;QACF,MAAMC,OAAOC,iCAAAA,CAAAA,UAAAA,CAAAA,IAAU,CAACF;QACxB,OAAOC;IACT,EAAE,OAAOE,GAAG,CAAC;IAEb,OAAO;AACT;AAEA,SAASC,oBACPJ,IAAyE;IAEzE,MAAMK,SAAS,GAAGC,iCAAAA,GAAGA,GAAGN,OAAOM,iCAAAA,GAAGA,CAAC,WAAW,CAAC;IAE/C,MAAMC,WAAW;QACfT,QAAQ,GAAG,CAAC,YAAY;QACxBA,QAAQ,GAAG,CAAC,YAAY;QACxBA,QAAQ,GAAG,CAAC,oBAAoB;KACjC,CAAC,MAAM,CAACU;IAET,KAAK,MAAMC,UAAUF,SAAU;QAC7B,MAAMG,cAAcC,AAAAA,IAAAA,iCAAAA,IAAAA,AAAAA,EAAKF,QAASJ;QAClC,IAAIO,AAAAA,IAAAA,+BAAAA,UAAAA,AAAAA,EAAWF,cACb,OAAOA;IAEX;IAEA,OAAO;AACT;AAEA,SAASG,mBACPb,IAAiE;IAEjE,MAAMK,SAAS,CAAC,cAAc,EAAEL,KAAK,2BAA2B,CAAC;IACjE,MAAMO,WAAW;QAAC;QAAIT,QAAQ,GAAG,CAAC,IAAI;KAAC,CAAC,MAAM,CAAC,CAACgB,OAASA,AAASC,KAAAA,MAATD;IAEzD,KAAK,MAAML,UAAUF,SAAU;QAC7B,MAAMG,cAAcC,AAAAA,IAAAA,iCAAAA,IAAAA,AAAAA,EAAKF,QAAQJ;QACjC,IAAIO,AAAAA,IAAAA,+BAAAA,UAAAA,AAAAA,EAAWF,cACb,OAAOA;IAEX;IAEA,OAAO;AACT;AAEA,MAAMM,eAAe;IACnB,SAAS;QACP,OAAO,IAAMjB,kBAAkB;QAC/B,QAAQ,IAAMc,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;IAEA,KAAK;QACH,QAAQ,IAAMS,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;IACA,SAAS;QACP,QAAQ,IAAMS,mBAAmB;QACjC,OAAO,IAAMT,oBAAoB;IACnC;AACF;AAEA,SAASa;IACP,MAAMC,UAAUF,aAAa,OAAO;IAEpC,IAAInB,YAAYsB,OAAO,IAAI,CAACD,SAAS,QAAQ,CAACrB,WAAW;QACvD,MAAMuB,MAAMF,OAAO,CAACrB,SAAiC;QACrD,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEA,SAASC;IACP,MAAMC,MAAMN,aAAa,GAAG;IAE5B,IAAInB,YAAYsB,OAAO,IAAI,CAACG,KAAK,QAAQ,CAACzB,WAAW;QACnD,MAAMuB,MAAME,GAAG,CAACzB,SAA6B;QAC7C,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEA,SAASG;IACP,MAAMC,UAAUR,aAAa,OAAO;IAEpC,IAAInB,YAAYsB,OAAO,IAAI,CAACK,SAAS,QAAQ,CAAC3B,WAAW;QACvD,MAAMuB,MAAMI,OAAO,CAAC3B,SAAiC;QACrD,IAAIuB,KACF,OAAOA;IAEX;AACF;AAEO,SAASK;IACd,MAAMP,UAAUD;IAChB,IAAIC,SACF,OAAOA;IAGT,MAAMI,MAAMD;IACZ,IAAIC,KACF,OAAOA;IAGT,MAAMI,SAASH;IACf,IAAIG,QACF,OAAOA;IAGT,MAAMC,QAAQ,IAAIC,MAAM;IACxBD,MAAM,IAAI,GAAG;IACb,MAAMA;AACR"}

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

@@ -0,0 +1,15 @@
+import { Logger } from '@agent-infra/logger';
+import { BrowserType } from '../types';
+export declare class BrowserFinder {
+    private logger;
+    constructor(logger?: Logger);
+    findBrowser(name?: BrowserType): {
+        path: string;
+        type: BrowserType;
+    };
+    private findChrome;
+    private findEdge;
+    private findFirefox;
+    private findAnyBrowser;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser-finder/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AAM5D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAIpB,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE;IA2C3E,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,cAAc;CAgCvB"}

package/dist/browser-finder/index.js

@@ -0,0 +1,151 @@
+/**
+* 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 logger_namespaceObject = require("@agent-infra/logger");
+const external_edge_paths_namespaceObject = require("edge-paths");
+const external_chrome_paths_js_namespaceObject = require("./chrome-paths.js");
+const external_firefox_paths_js_namespaceObject = require("./firefox-paths.js");
+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 {
+    findBrowser(name) {
+        const platform = process.platform;
+        let browserPath;
+        let browserType;
+        this.logger.info('Find browser on platform:', platform);
+        if (![
+            'darwin',
+            'win32',
+            'linux'
+        ].includes(platform)) {
+            const error = new Error(`Unsupported platform: ${platform}`);
+            this.logger.error(error.message);
+            throw error;
+        }
+        switch(name){
+            case 'chrome':
+                browserPath = this.findChrome();
+                browserType = 'chrome';
+                break;
+            case 'edge':
+                browserPath = this.findEdge();
+                browserType = 'edge';
+                break;
+            case 'firefox':
+                browserPath = this.findFirefox();
+                browserType = 'firefox';
+                break;
+            default:
+                const value = this.findAnyBrowser();
+                browserPath = value.path;
+                browserType = value.type;
+                break;
+        }
+        this.logger.info('browserPath:', browserPath);
+        return {
+            path: browserPath,
+            type: browserType
+        };
+    }
+    findChrome() {
+        try {
+            return (0, external_chrome_paths_js_namespaceObject.getAnyChromeStable)();
+        } catch (e) {
+            this.logger.error('Find Chrome Error:', e);
+            throw e;
+        }
+    }
+    findEdge() {
+        try {
+            return (0, external_edge_paths_namespaceObject.getAnyEdgeStable)();
+        } catch (e) {
+            this.logger.error('Find Edge Error:', e);
+            throw e;
+        }
+    }
+    findFirefox() {
+        try {
+            return (0, external_firefox_paths_js_namespaceObject.getAnyFirefoxStable)();
+        } catch (e) {
+            this.logger.error('Find Firefox Error:', e);
+            throw e;
+        }
+    }
+    findAnyBrowser() {
+        try {
+            return {
+                path: (0, external_chrome_paths_js_namespaceObject.getAnyChromeStable)(),
+                type: 'chrome'
+            };
+        } catch (e) {
+            this.logger.warn('Find Chrome Error:', e);
+        }
+        try {
+            return {
+                path: (0, external_edge_paths_namespaceObject.getAnyEdgeStable)(),
+                type: 'edge'
+            };
+        } catch (e) {
+            this.logger.warn('Find Edge Error:', e);
+        }
+        try {
+            return {
+                path: (0, external_firefox_paths_js_namespaceObject.getAnyFirefoxStable)(),
+                type: 'firefox'
+            };
+        } catch (e) {
+            this.logger.warn('Find Firefox Error:', e);
+        }
+        const error = new Error('Unable to find any browser.');
+        error.name = 'BrowserPathsError';
+        throw error;
+    }
+    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=index.js.map

package/dist/browser-finder/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder/index.js","sources":["webpack://@agent-infra/browser/./src/browser-finder/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2025 Bytedance, Inc. and its affiliates.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { Logger, defaultLogger } from '@agent-infra/logger';\n\nimport { getAnyEdgeStable } from 'edge-paths';\nimport { getAnyChromeStable } from './chrome-paths';\nimport { getAnyFirefoxStable } from './firefox-paths';\n\nimport { BrowserType } from '../types';\n\nexport class BrowserFinder {\n  private logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.logger = logger ?? defaultLogger;\n  }\n\n  public findBrowser(name?: BrowserType): { path: string; type: BrowserType } {\n    const platform = process.platform;\n    let browserPath: string;\n    let browserType: BrowserType;\n\n    this.logger.info('Find browser on platform:', platform);\n\n    if (!['darwin', 'win32', 'linux'].includes(platform)) {\n      const error = new Error(`Unsupported platform: ${platform}`);\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    switch (name) {\n      case 'chrome':\n        browserPath = this.findChrome();\n        browserType = 'chrome';\n        break;\n      case 'edge':\n        // https://learn.microsoft.com/en-us/microsoft-edge/puppeteer/\n        browserPath = this.findEdge();\n        browserType = 'edge';\n        break;\n      case 'firefox':\n        // https://pptr.dev/webdriver-bidi/#automate-with-chrome-and-firefox\n        browserPath = this.findFirefox();\n        browserType = 'firefox';\n        break;\n      default:\n        const value = this.findAnyBrowser();\n        browserPath = value.path;\n        browserType = value.type;\n        break;\n    }\n\n    this.logger.info('browserPath:', browserPath);\n\n    return {\n      path: browserPath,\n      type: browserType,\n    };\n  }\n\n  private findChrome(): string {\n    try {\n      return getAnyChromeStable();\n    } catch (e) {\n      this.logger.error('Find Chrome Error:', e);\n      throw e;\n    }\n  }\n\n  private findEdge(): string {\n    try {\n      return getAnyEdgeStable();\n    } catch (e) {\n      this.logger.error('Find Edge Error:', e);\n      throw e;\n    }\n  }\n\n  private findFirefox(): string {\n    try {\n      return getAnyFirefoxStable();\n    } catch (e) {\n      this.logger.error('Find Firefox Error:', e);\n      throw e;\n    }\n  }\n\n  private findAnyBrowser(): { path: string; type: BrowserType } {\n    try {\n      return {\n        path: getAnyChromeStable(),\n        type: 'chrome',\n      };\n    } catch (e) {\n      this.logger.warn('Find Chrome Error:', e);\n    }\n\n    try {\n      return {\n        path: getAnyEdgeStable(),\n        type: 'edge',\n      };\n    } catch (e) {\n      this.logger.warn('Find Edge Error:', e);\n    }\n\n    try {\n      return {\n        path: getAnyFirefoxStable(),\n        type: 'firefox',\n      };\n    } catch (e) {\n      this.logger.warn('Find Firefox Error:', e);\n    }\n\n    const error = new Error('Unable to find any browser.');\n    error.name = 'BrowserPathsError';\n    throw error;\n  }\n}\n"],"names":["BrowserFinder","name","platform","process","browserPath","browserType","error","Error","value","getAnyChromeStable","e","getAnyEdgeStable","getAnyFirefoxStable","logger","defaultLogger"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGC;;;;;;;;;;AASM,MAAMA;IAOJ,YAAYC,IAAkB,EAAuC;QAC1E,MAAMC,WAAWC,QAAQ,QAAQ;QACjC,IAAIC;QACJ,IAAIC;QAEJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6BH;QAE9C,IAAI,CAAC;YAAC;YAAU;YAAS;SAAQ,CAAC,QAAQ,CAACA,WAAW;YACpD,MAAMI,QAAQ,IAAIC,MAAM,CAAC,sBAAsB,EAAEL,UAAU;YAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAACI,MAAM,OAAO;YAC/B,MAAMA;QACR;QAEA,OAAQL;YACN,KAAK;gBACHG,cAAc,IAAI,CAAC,UAAU;gBAC7BC,cAAc;gBACd;YACF,KAAK;gBAEHD,cAAc,IAAI,CAAC,QAAQ;gBAC3BC,cAAc;gBACd;YACF,KAAK;gBAEHD,cAAc,IAAI,CAAC,WAAW;gBAC9BC,cAAc;gBACd;YACF;gBACE,MAAMG,QAAQ,IAAI,CAAC,cAAc;gBACjCJ,cAAcI,MAAM,IAAI;gBACxBH,cAAcG,MAAM,IAAI;gBACxB;QACJ;QAEA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgBJ;QAEjC,OAAO;YACL,MAAMA;YACN,MAAMC;QACR;IACF;IAEQ,aAAqB;QAC3B,IAAI;YACF,OAAOI,AAAAA,IAAAA,yCAAAA,kBAAAA,AAAAA;QACT,EAAE,OAAOC,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsBA;YACxC,MAAMA;QACR;IACF;IAEQ,WAAmB;QACzB,IAAI;YACF,OAAOC,AAAAA,IAAAA,oCAAAA,gBAAAA,AAAAA;QACT,EAAE,OAAOD,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoBA;YACtC,MAAMA;QACR;IACF;IAEQ,cAAsB;QAC5B,IAAI;YACF,OAAOE,AAAAA,IAAAA,0CAAAA,mBAAAA,AAAAA;QACT,EAAE,OAAOF,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuBA;YACzC,MAAMA;QACR;IACF;IAEQ,iBAAsD;QAC5D,IAAI;YACF,OAAO;gBACL,MAAMD,AAAAA,IAAAA,yCAAAA,kBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOC,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsBA;QACzC;QAEA,IAAI;YACF,OAAO;gBACL,MAAMC,AAAAA,IAAAA,oCAAAA,gBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOD,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoBA;QACvC;QAEA,IAAI;YACF,OAAO;gBACL,MAAME,AAAAA,IAAAA,0CAAAA,mBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOF,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuBA;QAC1C;QAEA,MAAMJ,QAAQ,IAAIC,MAAM;QACxBD,MAAM,IAAI,GAAG;QACb,MAAMA;IACR;IAzGA,YAAYO,MAAe,CAAE;QAF7B,uBAAQ,UAAR;QAGE,IAAI,CAAC,MAAM,GAAGA,UAAUC,uBAAAA,aAAaA;IACvC;AAwGF"}

package/dist/browser-finder/index.mjs

@@ -0,0 +1,119 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+import * as __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__ from "@agent-infra/logger";
+import * as __WEBPACK_EXTERNAL_MODULE_edge_paths_335d45e8__ from "edge-paths";
+import * as __WEBPACK_EXTERNAL_MODULE__chrome_paths_mjs_6a8bf971__ from "./chrome-paths.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__firefox_paths_mjs_7d752188__ from "./firefox-paths.mjs";
+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 {
+    findBrowser(name) {
+        const platform = process.platform;
+        let browserPath;
+        let browserType;
+        this.logger.info('Find browser on platform:', platform);
+        if (![
+            'darwin',
+            'win32',
+            'linux'
+        ].includes(platform)) {
+            const error = new Error(`Unsupported platform: ${platform}`);
+            this.logger.error(error.message);
+            throw error;
+        }
+        switch(name){
+            case 'chrome':
+                browserPath = this.findChrome();
+                browserType = 'chrome';
+                break;
+            case 'edge':
+                browserPath = this.findEdge();
+                browserType = 'edge';
+                break;
+            case 'firefox':
+                browserPath = this.findFirefox();
+                browserType = 'firefox';
+                break;
+            default:
+                const value = this.findAnyBrowser();
+                browserPath = value.path;
+                browserType = value.type;
+                break;
+        }
+        this.logger.info('browserPath:', browserPath);
+        return {
+            path: browserPath,
+            type: browserType
+        };
+    }
+    findChrome() {
+        try {
+            return (0, __WEBPACK_EXTERNAL_MODULE__chrome_paths_mjs_6a8bf971__.getAnyChromeStable)();
+        } catch (e) {
+            this.logger.error('Find Chrome Error:', e);
+            throw e;
+        }
+    }
+    findEdge() {
+        try {
+            return (0, __WEBPACK_EXTERNAL_MODULE_edge_paths_335d45e8__.getAnyEdgeStable)();
+        } catch (e) {
+            this.logger.error('Find Edge Error:', e);
+            throw e;
+        }
+    }
+    findFirefox() {
+        try {
+            return (0, __WEBPACK_EXTERNAL_MODULE__firefox_paths_mjs_7d752188__.getAnyFirefoxStable)();
+        } catch (e) {
+            this.logger.error('Find Firefox Error:', e);
+            throw e;
+        }
+    }
+    findAnyBrowser() {
+        try {
+            return {
+                path: (0, __WEBPACK_EXTERNAL_MODULE__chrome_paths_mjs_6a8bf971__.getAnyChromeStable)(),
+                type: 'chrome'
+            };
+        } catch (e) {
+            this.logger.warn('Find Chrome Error:', e);
+        }
+        try {
+            return {
+                path: (0, __WEBPACK_EXTERNAL_MODULE_edge_paths_335d45e8__.getAnyEdgeStable)(),
+                type: 'edge'
+            };
+        } catch (e) {
+            this.logger.warn('Find Edge Error:', e);
+        }
+        try {
+            return {
+                path: (0, __WEBPACK_EXTERNAL_MODULE__firefox_paths_mjs_7d752188__.getAnyFirefoxStable)(),
+                type: 'firefox'
+            };
+        } catch (e) {
+            this.logger.warn('Find Firefox Error:', e);
+        }
+        const error = new Error('Unable to find any browser.');
+        error.name = 'BrowserPathsError';
+        throw error;
+    }
+    constructor(logger){
+        _define_property(this, "logger", void 0);
+        this.logger = logger ?? __WEBPACK_EXTERNAL_MODULE__agent_infra_logger_ddae3da2__.defaultLogger;
+    }
+}
+export { BrowserFinder };
+
+//# sourceMappingURL=index.mjs.map

package/dist/browser-finder/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-finder/index.mjs","sources":["webpack://@agent-infra/browser/./src/browser-finder/index.ts"],"sourcesContent":["/*\n * Copyright (c) 2025 Bytedance, Inc. and its affiliates.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { Logger, defaultLogger } from '@agent-infra/logger';\n\nimport { getAnyEdgeStable } from 'edge-paths';\nimport { getAnyChromeStable } from './chrome-paths';\nimport { getAnyFirefoxStable } from './firefox-paths';\n\nimport { BrowserType } from '../types';\n\nexport class BrowserFinder {\n  private logger: Logger;\n\n  constructor(logger?: Logger) {\n    this.logger = logger ?? defaultLogger;\n  }\n\n  public findBrowser(name?: BrowserType): { path: string; type: BrowserType } {\n    const platform = process.platform;\n    let browserPath: string;\n    let browserType: BrowserType;\n\n    this.logger.info('Find browser on platform:', platform);\n\n    if (!['darwin', 'win32', 'linux'].includes(platform)) {\n      const error = new Error(`Unsupported platform: ${platform}`);\n      this.logger.error(error.message);\n      throw error;\n    }\n\n    switch (name) {\n      case 'chrome':\n        browserPath = this.findChrome();\n        browserType = 'chrome';\n        break;\n      case 'edge':\n        // https://learn.microsoft.com/en-us/microsoft-edge/puppeteer/\n        browserPath = this.findEdge();\n        browserType = 'edge';\n        break;\n      case 'firefox':\n        // https://pptr.dev/webdriver-bidi/#automate-with-chrome-and-firefox\n        browserPath = this.findFirefox();\n        browserType = 'firefox';\n        break;\n      default:\n        const value = this.findAnyBrowser();\n        browserPath = value.path;\n        browserType = value.type;\n        break;\n    }\n\n    this.logger.info('browserPath:', browserPath);\n\n    return {\n      path: browserPath,\n      type: browserType,\n    };\n  }\n\n  private findChrome(): string {\n    try {\n      return getAnyChromeStable();\n    } catch (e) {\n      this.logger.error('Find Chrome Error:', e);\n      throw e;\n    }\n  }\n\n  private findEdge(): string {\n    try {\n      return getAnyEdgeStable();\n    } catch (e) {\n      this.logger.error('Find Edge Error:', e);\n      throw e;\n    }\n  }\n\n  private findFirefox(): string {\n    try {\n      return getAnyFirefoxStable();\n    } catch (e) {\n      this.logger.error('Find Firefox Error:', e);\n      throw e;\n    }\n  }\n\n  private findAnyBrowser(): { path: string; type: BrowserType } {\n    try {\n      return {\n        path: getAnyChromeStable(),\n        type: 'chrome',\n      };\n    } catch (e) {\n      this.logger.warn('Find Chrome Error:', e);\n    }\n\n    try {\n      return {\n        path: getAnyEdgeStable(),\n        type: 'edge',\n      };\n    } catch (e) {\n      this.logger.warn('Find Edge Error:', e);\n    }\n\n    try {\n      return {\n        path: getAnyFirefoxStable(),\n        type: 'firefox',\n      };\n    } catch (e) {\n      this.logger.warn('Find Firefox Error:', e);\n    }\n\n    const error = new Error('Unable to find any browser.');\n    error.name = 'BrowserPathsError';\n    throw error;\n  }\n}\n"],"names":["BrowserFinder","name","platform","process","browserPath","browserType","error","Error","value","getAnyChromeStable","e","getAnyEdgeStable","getAnyFirefoxStable","logger","defaultLogger"],"mappings":";;;;;;;;AAGC;;;;;;;;;;AASM,MAAMA;IAOJ,YAAYC,IAAkB,EAAuC;QAC1E,MAAMC,WAAWC,QAAQ,QAAQ;QACjC,IAAIC;QACJ,IAAIC;QAEJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6BH;QAE9C,IAAI,CAAC;YAAC;YAAU;YAAS;SAAQ,CAAC,QAAQ,CAACA,WAAW;YACpD,MAAMI,QAAQ,IAAIC,MAAM,CAAC,sBAAsB,EAAEL,UAAU;YAC3D,IAAI,CAAC,MAAM,CAAC,KAAK,CAACI,MAAM,OAAO;YAC/B,MAAMA;QACR;QAEA,OAAQL;YACN,KAAK;gBACHG,cAAc,IAAI,CAAC,UAAU;gBAC7BC,cAAc;gBACd;YACF,KAAK;gBAEHD,cAAc,IAAI,CAAC,QAAQ;gBAC3BC,cAAc;gBACd;YACF,KAAK;gBAEHD,cAAc,IAAI,CAAC,WAAW;gBAC9BC,cAAc;gBACd;YACF;gBACE,MAAMG,QAAQ,IAAI,CAAC,cAAc;gBACjCJ,cAAcI,MAAM,IAAI;gBACxBH,cAAcG,MAAM,IAAI;gBACxB;QACJ;QAEA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgBJ;QAEjC,OAAO;YACL,MAAMA;YACN,MAAMC;QACR;IACF;IAEQ,aAAqB;QAC3B,IAAI;YACF,OAAOI,AAAAA,IAAAA,uDAAAA,kBAAAA,AAAAA;QACT,EAAE,OAAOC,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsBA;YACxC,MAAMA;QACR;IACF;IAEQ,WAAmB;QACzB,IAAI;YACF,OAAOC,AAAAA,IAAAA,gDAAAA,gBAAAA,AAAAA;QACT,EAAE,OAAOD,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoBA;YACtC,MAAMA;QACR;IACF;IAEQ,cAAsB;QAC5B,IAAI;YACF,OAAOE,AAAAA,IAAAA,wDAAAA,mBAAAA,AAAAA;QACT,EAAE,OAAOF,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuBA;YACzC,MAAMA;QACR;IACF;IAEQ,iBAAsD;QAC5D,IAAI;YACF,OAAO;gBACL,MAAMD,AAAAA,IAAAA,uDAAAA,kBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOC,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsBA;QACzC;QAEA,IAAI;YACF,OAAO;gBACL,MAAMC,AAAAA,IAAAA,gDAAAA,gBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOD,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoBA;QACvC;QAEA,IAAI;YACF,OAAO;gBACL,MAAME,AAAAA,IAAAA,wDAAAA,mBAAAA,AAAAA;gBACN,MAAM;YACR;QACF,EAAE,OAAOF,GAAG;YACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,uBAAuBA;QAC1C;QAEA,MAAMJ,QAAQ,IAAIC,MAAM;QACxBD,MAAM,IAAI,GAAG;QACb,MAAMA;IACR;IAzGA,YAAYO,MAAe,CAAE;QAF7B,uBAAQ,UAAR;QAGE,IAAI,CAAC,MAAM,GAAGA,UAAUC,yDAAAA,aAAaA;IACvC;AAwGF"}

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

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

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

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

package/dist/index.js

@@ -8,7 +8,7 @@ var __webpack_modules__ = {
         module.exports = require("./base-browser.js");
     },
     "./browser-finder": function(module) {
-        module.exports = require("./browser-finder.js");
+        module.exports = require("./browser-finder/index.js");
     },
     "./local-browser": function(module) {
         module.exports = require("./local-browser.js");

package/dist/index.mjs

@@ -3,7 +3,7 @@
 * SPDX-License-Identifier: Apache-2.0
 */
 export * from "./types.mjs";
-export * from "./browser-finder.mjs";
+export * from "./browser-finder/index.mjs";
 export * from "./local-browser.mjs";
 export * from "./remote-browser.mjs";
 export * from "./base-browser.mjs";

package/dist/local-browser.d.ts

@@ -1,16 +1,11 @@
-import { LaunchOptions } from './types';
 import { BaseBrowser } from './base-browser';
+import type { LaunchOptions } from './types';
 /**
  * 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
@@ -19,5 +14,6 @@ export declare class LocalBrowser extends BaseBrowser {
      * @throws {Error} If the browser cannot be launched
      */
     launch(options?: LaunchOptions): Promise<void>;
+    private getBrowserInfo;
 }
 //# sourceMappingURL=local-browser.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"local-browser.d.ts","sourceRoot":"","sources":["../src/local-browser.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmFxD,OAAO,CAAC,cAAc;CAsCvB"}

package/dist/local-browser.js

@@ -31,32 +31,27 @@ __webpack_require__.d(__webpack_exports__, {
     LocalBrowser: ()=>LocalBrowser
 });
 const external_puppeteer_core_namespaceObject = require("puppeteer-core");
-const external_browser_finder_js_namespaceObject = require("./browser-finder.js");
+const index_js_namespaceObject = require("./browser-finder/index.js");
 const external_base_browser_js_namespaceObject = require("./base-browser.js");
-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 LocalBrowser extends external_base_browser_js_namespaceObject.BaseBrowser {
     async launch(options = {}) {
         var _options_defaultViewport, _options_defaultViewport1;
         this.logger.info('Launching browser with options:', options);
-        const executablePath = (null == options ? void 0 : options.executablePath) || this.browserFinder.findBrowser().executable;
-        this.logger.info('Using executable path:', executablePath);
+        const { path, type } = this.getBrowserInfo(options);
         const viewportWidth = (null == options ? void 0 : null === (_options_defaultViewport = options.defaultViewport) || void 0 === _options_defaultViewport ? void 0 : _options_defaultViewport.width) ?? 1280;
         const viewportHeight = (null == options ? void 0 : null === (_options_defaultViewport1 = options.defaultViewport) || void 0 === _options_defaultViewport1 ? void 0 : _options_defaultViewport1.height) ?? 800;
         const puppeteerLaunchOptions = {
-            executablePath,
+            browser: type,
+            executablePath: path,
+            dumpio: (null == options ? void 0 : options.dumpio) ?? false,
             headless: (null == options ? void 0 : options.headless) ?? false,
             defaultViewport: {
                 width: viewportWidth,
-                height: viewportHeight
+                height: viewportHeight,
+                deviceScaleFactor: 0
+            },
+            ...options.userDataDir && {
+                userDataDir: options.userDataDir
             },
             args: [
                 '--no-sandbox',
@@ -77,8 +72,15 @@ class LocalBrowser extends external_base_browser_js_namespaceObject.BaseBrowser
                 '--disable-site-isolation-trials',
                 `--window-size=${viewportWidth},${viewportHeight + 90}`,
                 (null == options ? void 0 : options.proxy) ? `--proxy-server=${options.proxy}` : '',
-                (null == options ? void 0 : options.profilePath) ? `--profile-directory=${options.profilePath}` : ''
-            ].filter(Boolean),
+                (null == options ? void 0 : options.proxyBypassList) ? `--proxy-bypass-list=${options.proxyBypassList}` : '',
+                (null == options ? void 0 : options.profilePath) ? `--profile-directory=${options.profilePath}` : '',
+                ...options.args ?? []
+            ].filter((item)=>{
+                if ('firefox' === type) {
+                    if ('--disable-features=IsolateOrigins,site-per-process' === item || item === `--window-size=${viewportWidth},${viewportHeight + 90}`) return false;
+                }
+                return !!item;
+            }),
             ignoreDefaultArgs: [
                 '--enable-automation'
             ],
@@ -97,8 +99,29 @@ class LocalBrowser extends external_base_browser_js_namespaceObject.BaseBrowser
             throw error;
         }
     }
-    constructor(...args){
-        super(...args), _define_property(this, "browserFinder", new external_browser_finder_js_namespaceObject.BrowserFinder());
+    getBrowserInfo(options = {}) {
+        const map = {
+            chrome: 'chrome',
+            edge: 'chrome',
+            firefox: 'firefox'
+        };
+        let browserPath = options.executablePath;
+        let browserType = options.browserType && map[options.browserType];
+        if (browserPath) {
+            if (!browserType) {
+                const lowercasePath = browserPath.toLowerCase();
+                browserType = lowercasePath.includes('chrome') ? 'chrome' : lowercasePath.includes('edge') ? 'chrome' : lowercasePath.includes('firefox') ? 'firefox' : 'chrome';
+            }
+        } else {
+            const browserInfo = new index_js_namespaceObject.BrowserFinder(this.logger).findBrowser();
+            browserPath = browserInfo.path;
+            browserType = map[browserInfo.type];
+        }
+        this.logger.info('Using executable path:', browserPath);
+        return {
+            path: browserPath,
+            type: browserType
+        };
     }
 }
 var __webpack_export_target__ = exports;

package/dist/local-browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-browser.js","sources":["webpack://@agent-infra/browser/./src/local-browser.ts"],"sourcesContent":["/*\n * Copyright (c) 2025 Bytedance, Inc. and its affiliates.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport * as puppeteer from 'puppeteer-core';\nimport { LaunchOptions } from './types';\nimport { BrowserFinder } from './browser-finder';\nimport { BaseBrowser } from './base-browser';\n\n/**\n * LocalBrowser class for controlling locally installed browsers\n * Extends the BaseBrowser with functionality specific to managing local browser instances\n * @extends BaseBrowser\n */\nexport class LocalBrowser extends BaseBrowser {\n  /**\n   * Browser finder instance to detect and locate installed browsers\n   * @private\n   */\n  private browserFinder = new BrowserFinder();\n\n  /**\n   * Launches a local browser instance with specified options\n   * Automatically detects installed browsers if no executable path is provided\n   * @param {LaunchOptions} options - Configuration options for launching the browser\n   * @returns {Promise<void>} Promise that resolves when the browser is successfully launched\n   * @throws {Error} If the browser cannot be launched\n   */\n  async launch(options: LaunchOptions = {}): Promise<void> {\n    this.logger.info('Launching browser with options:', options);\n\n    const executablePath =\n      options?.executablePath || this.browserFinder.findBrowser().executable;\n\n    this.logger.info('Using executable path:', executablePath);\n\n    const viewportWidth = options?.defaultViewport?.width ?? 1280;\n    const viewportHeight = options?.defaultViewport?.height ?? 800;\n\n    const puppeteerLaunchOptions: puppeteer.LaunchOptions = {\n      executablePath,\n      headless: options?.headless ?? false,\n      defaultViewport: {\n        width: viewportWidth,\n        height: viewportHeight,\n      },\n      args: [\n        '--no-sandbox',\n        '--mute-audio',\n        '--disable-gpu',\n        '--disable-http2',\n        '--disable-blink-features=AutomationControlled',\n        '--disable-infobars',\n        '--disable-background-timer-throttling',\n        '--disable-popup-blocking',\n        '--disable-backgrounding-occluded-windows',\n        '--disable-renderer-backgrounding',\n        '--disable-window-activation',\n        '--disable-focus-on-load',\n        '--no-default-browser-check', // disable default browser check\n        '--disable-web-security', // disable CORS\n        '--disable-features=IsolateOrigins,site-per-process',\n        '--disable-site-isolation-trials',\n        `--window-size=${viewportWidth},${viewportHeight + 90}`,\n        options?.proxy ? `--proxy-server=${options.proxy}` : '',\n        options?.profilePath\n          ? `--profile-directory=${options.profilePath}`\n          : '',\n      ].filter(Boolean),\n      ignoreDefaultArgs: ['--enable-automation'],\n      timeout: options.timeout ?? 0,\n      downloadBehavior: {\n        policy: 'deny',\n      },\n    };\n\n    this.logger.info('Launch options:', puppeteerLaunchOptions);\n\n    try {\n      this.browser = await puppeteer.launch(puppeteerLaunchOptions);\n      await this.setupPageListener();\n      this.logger.success('Browser launched successfully');\n    } catch (error) {\n      this.logger.error('Failed to launch browser:', error);\n      throw error;\n    }\n  }\n}\n"],"names":["LocalBrowser","BaseBrowser","options","_options_defaultViewport","_options_defaultViewport1","executablePath","viewportWidth","viewportHeight","puppeteerLaunchOptions","Boolean","puppeteer","error","BrowserFinder"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGC;;;;;;;;;;AAWM,MAAMA,qBAAqBC,yCAAAA,WAAWA;IAc3C,MAAM,OAAOC,UAAyB,CAAC,CAAC,EAAiB;YAQjCC,0BACCC;QARvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmCF;QAEpD,MAAMG,iBACJH,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,cAAc,AAAD,KAAK,IAAI,CAAC,aAAa,CAAC,WAAW,GAAG,UAAU;QAExE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0BG;QAE3C,MAAMC,gBAAgBH,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,AAAwB,SAAxBA,CAAAA,2BAAAA,QAAS,eAAe,AAAD,KAAvBA,AAAAA,KAAAA,MAAAA,2BAAAA,KAAAA,IAAAA,yBAA0B,KAAK,AAAD,KAAK;QACzD,MAAMI,iBAAiBH,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,AAAwB,SAAxBA,CAAAA,4BAAAA,QAAS,eAAe,AAAD,KAAvBA,AAAAA,KAAAA,MAAAA,4BAAAA,KAAAA,IAAAA,0BAA0B,MAAM,AAAD,KAAK;QAE3D,MAAMI,yBAAkD;YACtDH;YACA,UAAUH,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,QAAQ,AAAD,KAAK;YAC/B,iBAAiB;gBACf,OAAOI;gBACP,QAAQC;YACV;YACA,MAAM;gBACJ;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA;gBACA,CAAC,cAAc,EAAED,cAAc,CAAC,EAAEC,iBAAiB,IAAI;gBACvDL,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,KAAK,AAAD,IAAI,CAAC,eAAe,EAAEA,QAAQ,KAAK,EAAE,GAAG;gBACrDA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,WAAW,AAAD,IACf,CAAC,oBAAoB,EAAEA,QAAQ,WAAW,EAAE,GAC5C;aACL,CAAC,MAAM,CAACO;YACT,mBAAmB;gBAAC;aAAsB;YAC1C,SAASP,QAAQ,OAAO,IAAI;YAC5B,kBAAkB;gBAChB,QAAQ;YACV;QACF;QAEA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmBM;QAEpC,IAAI;YACF,IAAI,CAAC,OAAO,GAAG,MAAME,wCAAAA,MAAgB,CAACF;YACtC,MAAM,IAAI,CAAC,iBAAiB;YAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACtB,EAAE,OAAOG,OAAO;YACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6BA;YAC/C,MAAMA;QACR;IACF;;QAxEK,gBAKL,uBAAQ,iBAAgB,IAAIC,2CAAAA,aAAaA;;AAoE3C"}
+{"version":3,"file":"local-browser.js","sources":["webpack://@agent-infra/browser/./src/local-browser.ts"],"sourcesContent":["/*\n * Copyright (c) 2025 Bytedance, Inc. and its affiliates.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport * as puppeteer from 'puppeteer-core';\nimport { BrowserFinder } from './browser-finder';\nimport { BaseBrowser } from './base-browser';\n\nimport type { BrowserType, LaunchOptions } from './types';\n\n/**\n * LocalBrowser class for controlling locally installed browsers\n * Extends the BaseBrowser with functionality specific to managing local browser instances\n * @extends BaseBrowser\n */\nexport class LocalBrowser extends BaseBrowser {\n  /**\n   * Launches a local browser instance with specified options\n   * Automatically detects installed browsers if no executable path is provided\n   * @param {LaunchOptions} options - Configuration options for launching the browser\n   * @returns {Promise<void>} Promise that resolves when the browser is successfully launched\n   * @throws {Error} If the browser cannot be launched\n   */\n  async launch(options: LaunchOptions = {}): Promise<void> {\n    this.logger.info('Launching browser with options:', options);\n\n    const { path, type } = this.getBrowserInfo(options);\n    const viewportWidth = options?.defaultViewport?.width ?? 1280;\n    const viewportHeight = options?.defaultViewport?.height ?? 800;\n\n    const puppeteerLaunchOptions: puppeteer.LaunchOptions = {\n      browser: type,\n      executablePath: path,\n      dumpio: options?.dumpio ?? false,\n      headless: options?.headless ?? false,\n      defaultViewport: {\n        width: viewportWidth,\n        height: viewportHeight,\n        // Setting this value to 0 will reset this value to the system default.\n        // This parameter combined with `captureBeyondViewport: false`, will resolve the screenshot blinking issue.\n        deviceScaleFactor: 0,\n      },\n      ...(options.userDataDir && {\n        userDataDir: options.userDataDir,\n      }),\n      args: [\n        '--no-sandbox',\n        '--mute-audio',\n        '--disable-gpu',\n        '--disable-http2',\n        '--disable-blink-features=AutomationControlled',\n        '--disable-infobars',\n        '--disable-background-timer-throttling',\n        '--disable-popup-blocking',\n        '--disable-backgrounding-occluded-windows',\n        '--disable-renderer-backgrounding',\n        '--disable-window-activation',\n        '--disable-focus-on-load',\n        '--no-default-browser-check', // disable default browser check\n        '--disable-web-security', // disable CORS\n        '--disable-features=IsolateOrigins,site-per-process',\n        '--disable-site-isolation-trials',\n        `--window-size=${viewportWidth},${viewportHeight + 90}`,\n        options?.proxy ? `--proxy-server=${options.proxy}` : '',\n        options?.proxyBypassList\n          ? `--proxy-bypass-list=${options.proxyBypassList}`\n          : '',\n        options?.profilePath\n          ? `--profile-directory=${options.profilePath}`\n          : '',\n        ...(options.args ?? []),\n      ].filter((item) => {\n        if (type === 'firefox') {\n          // firefox not support rules\n          if (\n            item === '--disable-features=IsolateOrigins,site-per-process' ||\n            item === `--window-size=${viewportWidth},${viewportHeight + 90}`\n          ) {\n            return false;\n          }\n\n          return !!item;\n        }\n\n        // chrome/edge\n        return !!item;\n      }),\n      ignoreDefaultArgs: ['--enable-automation'],\n      timeout: options.timeout ?? 0,\n      downloadBehavior: {\n        policy: 'deny',\n      },\n    };\n\n    this.logger.info('Launch options:', puppeteerLaunchOptions);\n\n    try {\n      this.browser = await puppeteer.launch(puppeteerLaunchOptions);\n      await this.setupPageListener();\n      this.logger.success('Browser launched successfully');\n    } catch (error) {\n      this.logger.error('Failed to launch browser:', error);\n      throw error;\n    }\n  }\n\n  private getBrowserInfo(options: LaunchOptions = {}) {\n    // pptr only support 'chrome' and 'firefox'\n    const map: Record<BrowserType, Exclude<BrowserType, 'edge'>> = {\n      chrome: 'chrome',\n      edge: 'chrome',\n      firefox: 'firefox',\n    };\n\n    let browserPath = options.executablePath;\n    let browserType = options.browserType && map[options.browserType];\n\n    if (!browserPath) {\n      const browserInfo = new BrowserFinder(this.logger).findBrowser();\n      browserPath = browserInfo.path;\n      browserType = map[browserInfo.type];\n    } else {\n      if (!browserType) {\n        const lowercasePath = browserPath.toLowerCase();\n\n        if (lowercasePath.includes('chrome')) {\n          browserType = 'chrome';\n        } else if (lowercasePath.includes('edge')) {\n          browserType = 'chrome'; // pptr only support 'chrome' and 'firefox'\n        } else if (lowercasePath.includes('firefox')) {\n          browserType = 'firefox';\n        } else {\n          browserType = 'chrome';\n        }\n      }\n    }\n\n    this.logger.info('Using executable path:', browserPath);\n\n    return {\n      path: browserPath,\n      type: browserType,\n    };\n  }\n}\n"],"names":["LocalBrowser","BaseBrowser","options","_options_defaultViewport","_options_defaultViewport1","path","type","viewportWidth","viewportHeight","puppeteerLaunchOptions","item","puppeteer","error","map","browserPath","browserType","lowercasePath","browserInfo","BrowserFinder"],"mappings":"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"}