@agent-infra/browser 0.0.1

package/dist/local-browser.js

@@ -0,0 +1,110 @@
+/**
+* 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__, {
+    LocalBrowser: ()=>LocalBrowser
+});
+const external_puppeteer_core_namespaceObject = require("puppeteer-core");
+const external_browser_finder_js_namespaceObject = require("./browser-finder.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 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,
+            headless: (null == options ? void 0 : options.headless) ?? false,
+            defaultViewport: {
+                width: viewportWidth,
+                height: viewportHeight
+            },
+            args: [
+                '--no-sandbox',
+                '--mute-audio',
+                '--disable-gpu',
+                '--disable-http2',
+                '--disable-blink-features=AutomationControlled',
+                '--disable-infobars',
+                '--disable-background-timer-throttling',
+                '--disable-popup-blocking',
+                '--disable-backgrounding-occluded-windows',
+                '--disable-renderer-backgrounding',
+                '--disable-window-activation',
+                '--disable-focus-on-load',
+                '--no-default-browser-check',
+                '--disable-web-security',
+                '--disable-features=IsolateOrigins,site-per-process',
+                '--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),
+            ignoreDefaultArgs: [
+                '--enable-automation'
+            ],
+            timeout: options.timeout ?? 0,
+            downloadBehavior: {
+                policy: 'deny'
+            }
+        };
+        this.logger.info('Launch options:', puppeteerLaunchOptions);
+        try {
+            this.browser = await external_puppeteer_core_namespaceObject.launch(puppeteerLaunchOptions);
+            await this.setupPageListener();
+            this.logger.success('Browser launched successfully');
+        } catch (error) {
+            this.logger.error('Failed to launch browser:', error);
+            throw error;
+        }
+    }
+    constructor(...args){
+        super(...args), _define_property(this, "browserFinder", new external_browser_finder_js_namespaceObject.BrowserFinder());
+    }
+}
+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=local-browser.js.map

package/dist/local-browser.js.map

@@ -0,0 +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"}

package/dist/local-browser.mjs

@@ -0,0 +1,78 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+import * as __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__ from "puppeteer-core";
+import * as __WEBPACK_EXTERNAL_MODULE__browser_finder_mjs_e776194b__ from "./browser-finder.mjs";
+import * as __WEBPACK_EXTERNAL_MODULE__base_browser_mjs_64d751a3__ from "./base-browser.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 LocalBrowser extends __WEBPACK_EXTERNAL_MODULE__base_browser_mjs_64d751a3__.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 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,
+            headless: (null == options ? void 0 : options.headless) ?? false,
+            defaultViewport: {
+                width: viewportWidth,
+                height: viewportHeight
+            },
+            args: [
+                '--no-sandbox',
+                '--mute-audio',
+                '--disable-gpu',
+                '--disable-http2',
+                '--disable-blink-features=AutomationControlled',
+                '--disable-infobars',
+                '--disable-background-timer-throttling',
+                '--disable-popup-blocking',
+                '--disable-backgrounding-occluded-windows',
+                '--disable-renderer-backgrounding',
+                '--disable-window-activation',
+                '--disable-focus-on-load',
+                '--no-default-browser-check',
+                '--disable-web-security',
+                '--disable-features=IsolateOrigins,site-per-process',
+                '--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),
+            ignoreDefaultArgs: [
+                '--enable-automation'
+            ],
+            timeout: options.timeout ?? 0,
+            downloadBehavior: {
+                policy: 'deny'
+            }
+        };
+        this.logger.info('Launch options:', puppeteerLaunchOptions);
+        try {
+            this.browser = await __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__.launch(puppeteerLaunchOptions);
+            await this.setupPageListener();
+            this.logger.success('Browser launched successfully');
+        } catch (error) {
+            this.logger.error('Failed to launch browser:', error);
+            throw error;
+        }
+    }
+    constructor(...args){
+        super(...args), _define_property(this, "browserFinder", new __WEBPACK_EXTERNAL_MODULE__browser_finder_mjs_e776194b__.BrowserFinder());
+    }
+}
+export { LocalBrowser };
+
+//# sourceMappingURL=local-browser.mjs.map

package/dist/local-browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-browser.mjs","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,uDAAAA,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,oDAAAA,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,yDAAAA,aAAaA;;AAoE3C"}

package/dist/remote-browser.d.ts

@@ -0,0 +1,49 @@
+import { BaseBrowser, BaseBrowserOptions } from './base-browser';
+import { LaunchOptions } from './types';
+/**
+ * Configuration options for RemoteBrowser
+ * @extends BaseBrowserOptions
+ * @interface RemoteBrowserOptions
+ * @property {string} [wsEndpoint] - WebSocket endpoint URL for direct connection
+ * @property {string} [host] - Remote host address (default: 'localhost')
+ * @property {number} [port] - Remote debugging port (default: 9222)
+ */
+export interface RemoteBrowserOptions extends BaseBrowserOptions {
+    wsEndpoint?: string;
+    host?: string;
+    port?: number;
+}
+/**
+ * RemoteBrowser class for connecting to remote browser instances
+ *
+ * Currently, this RemoteBrowser is not production ready,
+ * mainly because it still relies on `puppeteer-core`,
+ * which can only run on Node.js.
+ *
+ * At the same time, Chrome instances built with
+ * `--remote-debugging-address` on Linux have security risks
+ *
+ * @see https://issues.chromium.org/issues/41487252
+ * @see https://issues.chromium.org/issues/40261787
+ * @see https://github.com/pyppeteer/pyppeteer/pull/379
+ * @see https://stackoverflow.com/questions/72760355/chrome-remote-debugging-not-working-computer-to-computer
+ *
+ * @extends BaseBrowser
+ */
+export declare class RemoteBrowser extends BaseBrowser {
+    private options?;
+    /**
+     * Creates a new RemoteBrowser instance
+     * @param {RemoteBrowserOptions} [options] - Configuration options for remote browser connection
+     */
+    constructor(options?: RemoteBrowserOptions | undefined);
+    /**
+     * Connects to a remote browser instance using WebSocket
+     * If no WebSocket endpoint is provided, attempts to discover it using the DevTools Protocol
+     * @param {LaunchOptions} [options] - Launch configuration options
+     * @returns {Promise<void>} Promise that resolves when connected to the remote browser
+     * @throws {Error} If connection to the remote browser fails
+     */
+    launch(options?: LaunchOptions): Promise<void>;
+}
+//# sourceMappingURL=remote-browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser.d.ts","sourceRoot":"","sources":["../src/remote-browser.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAKhC,OAAO,CAAC,OAAO,CAAC;IAJ5B;;;OAGG;gBACiB,OAAO,CAAC,EAAE,oBAAoB,YAAA;IAIlD;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BrD"}

package/dist/remote-browser.js

@@ -0,0 +1,85 @@
+/**
+* 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__, {
+    RemoteBrowser: ()=>RemoteBrowser
+});
+const external_puppeteer_core_namespaceObject = require("puppeteer-core");
+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 RemoteBrowser extends external_base_browser_js_namespaceObject.BaseBrowser {
+    async launch(options) {
+        var _this_options;
+        this.logger.info('Browser Launch options:', options);
+        let browserWSEndpoint = null === (_this_options = this.options) || void 0 === _this_options ? void 0 : _this_options.wsEndpoint;
+        if (!browserWSEndpoint) {
+            var _this_options1, _this_options2;
+            const host = (null === (_this_options1 = this.options) || void 0 === _this_options1 ? void 0 : _this_options1.host) || 'localhost';
+            const port = (null === (_this_options2 = this.options) || void 0 === _this_options2 ? void 0 : _this_options2.port) || 9222;
+            const response = await fetch(`http://${host}:${port}/json/version`);
+            const { webSocketDebuggerUrl } = await response.json();
+            browserWSEndpoint = webSocketDebuggerUrl;
+        }
+        this.logger.info('Using WebSocket endpoint:', browserWSEndpoint);
+        const puppeteerConnectOptions = {
+            browserWSEndpoint,
+            defaultViewport: (null == options ? void 0 : options.defaultViewport) ?? {
+                width: 1280,
+                height: 800
+            }
+        };
+        try {
+            this.browser = await external_puppeteer_core_namespaceObject.connect(puppeteerConnectOptions);
+            await this.setupPageListener();
+            this.logger.success('Connected to remote browser successfully');
+        } catch (error) {
+            this.logger.error('Failed to connect to remote browser:', error);
+            throw error;
+        }
+    }
+    constructor(options){
+        super(options), _define_property(this, "options", void 0), this.options = options;
+    }
+}
+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=remote-browser.js.map

package/dist/remote-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser.js","sources":["webpack://@agent-infra/browser/./src/remote-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 { BaseBrowser, BaseBrowserOptions } from './base-browser';\nimport { LaunchOptions } from './types';\n\n/**\n * Configuration options for RemoteBrowser\n * @extends BaseBrowserOptions\n * @interface RemoteBrowserOptions\n * @property {string} [wsEndpoint] - WebSocket endpoint URL for direct connection\n * @property {string} [host] - Remote host address (default: 'localhost')\n * @property {number} [port] - Remote debugging port (default: 9222)\n */\nexport interface RemoteBrowserOptions extends BaseBrowserOptions {\n  wsEndpoint?: string;\n  host?: string;\n  port?: number;\n}\n\n/**\n * RemoteBrowser class for connecting to remote browser instances\n *\n * Currently, this RemoteBrowser is not production ready,\n * mainly because it still relies on `puppeteer-core`,\n * which can only run on Node.js.\n *\n * At the same time, Chrome instances built with\n * `--remote-debugging-address` on Linux have security risks\n *\n * @see https://issues.chromium.org/issues/41487252\n * @see https://issues.chromium.org/issues/40261787\n * @see https://github.com/pyppeteer/pyppeteer/pull/379\n * @see https://stackoverflow.com/questions/72760355/chrome-remote-debugging-not-working-computer-to-computer\n *\n * @extends BaseBrowser\n */\nexport class RemoteBrowser extends BaseBrowser {\n  /**\n   * Creates a new RemoteBrowser instance\n   * @param {RemoteBrowserOptions} [options] - Configuration options for remote browser connection\n   */\n  constructor(private options?: RemoteBrowserOptions) {\n    super(options);\n  }\n\n  /**\n   * Connects to a remote browser instance using WebSocket\n   * If no WebSocket endpoint is provided, attempts to discover it using the DevTools Protocol\n   * @param {LaunchOptions} [options] - Launch configuration options\n   * @returns {Promise<void>} Promise that resolves when connected to the remote browser\n   * @throws {Error} If connection to the remote browser fails\n   */\n  async launch(options?: LaunchOptions): Promise<void> {\n    this.logger.info('Browser Launch options:', options);\n\n    let browserWSEndpoint = this.options?.wsEndpoint;\n\n    if (!browserWSEndpoint) {\n      const host = this.options?.host || 'localhost';\n      const port = this.options?.port || 9222;\n      const response = await fetch(`http://${host}:${port}/json/version`);\n      const { webSocketDebuggerUrl } = await response.json();\n      browserWSEndpoint = webSocketDebuggerUrl;\n    }\n\n    this.logger.info('Using WebSocket endpoint:', browserWSEndpoint);\n\n    const puppeteerConnectOptions: puppeteer.ConnectOptions = {\n      browserWSEndpoint,\n      defaultViewport: options?.defaultViewport ?? { width: 1280, height: 800 },\n    };\n\n    try {\n      this.browser = await puppeteer.connect(puppeteerConnectOptions);\n      await this.setupPageListener();\n      this.logger.success('Connected to remote browser successfully');\n    } catch (error) {\n      this.logger.error('Failed to connect to remote browser:', error);\n      throw error;\n    }\n  }\n}\n"],"names":["RemoteBrowser","BaseBrowser","options","_this_options","browserWSEndpoint","_this_options1","_this_options2","host","port","response","fetch","webSocketDebuggerUrl","puppeteerConnectOptions","puppeteer","error"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGC;;;;;;;;;;AAoCM,MAAMA,sBAAsBC,yCAAAA,WAAWA;IAgB5C,MAAM,OAAOC,OAAuB,EAAiB;YAG3BC;QAFxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2BD;QAE5C,IAAIE,oBAAoB,AAAY,SAAZD,CAAAA,gBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,gBAAAA,KAAAA,IAAAA,cAAc,UAAU;QAEhD,IAAI,CAACC,mBAAmB;gBACTC,gBACAC;YADb,MAAMC,OAAOF,AAAAA,CAAY,SAAZA,CAAAA,iBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,iBAAAA,KAAAA,IAAAA,eAAc,IAAI,AAAD,KAAK;YACnC,MAAMG,OAAOF,AAAAA,CAAY,SAAZA,CAAAA,iBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,iBAAAA,KAAAA,IAAAA,eAAc,IAAI,AAAD,KAAK;YACnC,MAAMG,WAAW,MAAMC,MAAM,CAAC,OAAO,EAAEH,KAAK,CAAC,EAAEC,KAAK,aAAa,CAAC;YAClE,MAAM,EAAEG,oBAAoB,EAAE,GAAG,MAAMF,SAAS,IAAI;YACpDL,oBAAoBO;QACtB;QAEA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6BP;QAE9C,MAAMQ,0BAAoD;YACxDR;YACA,iBAAiBF,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,eAAe,AAAD,KAAK;gBAAE,OAAO;gBAAM,QAAQ;YAAI;QAC1E;QAEA,IAAI;YACF,IAAI,CAAC,OAAO,GAAG,MAAMW,wCAAAA,OAAiB,CAACD;YACvC,MAAM,IAAI,CAAC,iBAAiB;YAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACtB,EAAE,OAAOE,OAAO;YACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwCA;YAC1D,MAAMA;QACR;IACF;IAvCA,YAAoBZ,OAA8B,CAAE;QAClD,KAAK,CAACA,UAAAA,iBAAAA,IAAAA,EAAAA,WAAAA,KAAAA,IAAAA,IAAAA,CADYA,OAAO,GAAPA;IAEpB;AAsCF"}

package/dist/remote-browser.mjs

@@ -0,0 +1,53 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+import * as __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__ from "puppeteer-core";
+import * as __WEBPACK_EXTERNAL_MODULE__base_browser_mjs_64d751a3__ from "./base-browser.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 RemoteBrowser extends __WEBPACK_EXTERNAL_MODULE__base_browser_mjs_64d751a3__.BaseBrowser {
+    async launch(options) {
+        var _this_options;
+        this.logger.info('Browser Launch options:', options);
+        let browserWSEndpoint = null === (_this_options = this.options) || void 0 === _this_options ? void 0 : _this_options.wsEndpoint;
+        if (!browserWSEndpoint) {
+            var _this_options1, _this_options2;
+            const host = (null === (_this_options1 = this.options) || void 0 === _this_options1 ? void 0 : _this_options1.host) || 'localhost';
+            const port = (null === (_this_options2 = this.options) || void 0 === _this_options2 ? void 0 : _this_options2.port) || 9222;
+            const response = await fetch(`http://${host}:${port}/json/version`);
+            const { webSocketDebuggerUrl } = await response.json();
+            browserWSEndpoint = webSocketDebuggerUrl;
+        }
+        this.logger.info('Using WebSocket endpoint:', browserWSEndpoint);
+        const puppeteerConnectOptions = {
+            browserWSEndpoint,
+            defaultViewport: (null == options ? void 0 : options.defaultViewport) ?? {
+                width: 1280,
+                height: 800
+            }
+        };
+        try {
+            this.browser = await __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__.connect(puppeteerConnectOptions);
+            await this.setupPageListener();
+            this.logger.success('Connected to remote browser successfully');
+        } catch (error) {
+            this.logger.error('Failed to connect to remote browser:', error);
+            throw error;
+        }
+    }
+    constructor(options){
+        super(options), _define_property(this, "options", void 0), this.options = options;
+    }
+}
+export { RemoteBrowser };
+
+//# sourceMappingURL=remote-browser.mjs.map

package/dist/remote-browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-browser.mjs","sources":["webpack://@agent-infra/browser/./src/remote-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 { BaseBrowser, BaseBrowserOptions } from './base-browser';\nimport { LaunchOptions } from './types';\n\n/**\n * Configuration options for RemoteBrowser\n * @extends BaseBrowserOptions\n * @interface RemoteBrowserOptions\n * @property {string} [wsEndpoint] - WebSocket endpoint URL for direct connection\n * @property {string} [host] - Remote host address (default: 'localhost')\n * @property {number} [port] - Remote debugging port (default: 9222)\n */\nexport interface RemoteBrowserOptions extends BaseBrowserOptions {\n  wsEndpoint?: string;\n  host?: string;\n  port?: number;\n}\n\n/**\n * RemoteBrowser class for connecting to remote browser instances\n *\n * Currently, this RemoteBrowser is not production ready,\n * mainly because it still relies on `puppeteer-core`,\n * which can only run on Node.js.\n *\n * At the same time, Chrome instances built with\n * `--remote-debugging-address` on Linux have security risks\n *\n * @see https://issues.chromium.org/issues/41487252\n * @see https://issues.chromium.org/issues/40261787\n * @see https://github.com/pyppeteer/pyppeteer/pull/379\n * @see https://stackoverflow.com/questions/72760355/chrome-remote-debugging-not-working-computer-to-computer\n *\n * @extends BaseBrowser\n */\nexport class RemoteBrowser extends BaseBrowser {\n  /**\n   * Creates a new RemoteBrowser instance\n   * @param {RemoteBrowserOptions} [options] - Configuration options for remote browser connection\n   */\n  constructor(private options?: RemoteBrowserOptions) {\n    super(options);\n  }\n\n  /**\n   * Connects to a remote browser instance using WebSocket\n   * If no WebSocket endpoint is provided, attempts to discover it using the DevTools Protocol\n   * @param {LaunchOptions} [options] - Launch configuration options\n   * @returns {Promise<void>} Promise that resolves when connected to the remote browser\n   * @throws {Error} If connection to the remote browser fails\n   */\n  async launch(options?: LaunchOptions): Promise<void> {\n    this.logger.info('Browser Launch options:', options);\n\n    let browserWSEndpoint = this.options?.wsEndpoint;\n\n    if (!browserWSEndpoint) {\n      const host = this.options?.host || 'localhost';\n      const port = this.options?.port || 9222;\n      const response = await fetch(`http://${host}:${port}/json/version`);\n      const { webSocketDebuggerUrl } = await response.json();\n      browserWSEndpoint = webSocketDebuggerUrl;\n    }\n\n    this.logger.info('Using WebSocket endpoint:', browserWSEndpoint);\n\n    const puppeteerConnectOptions: puppeteer.ConnectOptions = {\n      browserWSEndpoint,\n      defaultViewport: options?.defaultViewport ?? { width: 1280, height: 800 },\n    };\n\n    try {\n      this.browser = await puppeteer.connect(puppeteerConnectOptions);\n      await this.setupPageListener();\n      this.logger.success('Connected to remote browser successfully');\n    } catch (error) {\n      this.logger.error('Failed to connect to remote browser:', error);\n      throw error;\n    }\n  }\n}\n"],"names":["RemoteBrowser","BaseBrowser","options","_this_options","browserWSEndpoint","_this_options1","_this_options2","host","port","response","fetch","webSocketDebuggerUrl","puppeteerConnectOptions","puppeteer","error"],"mappings":";;;;;;AAGC;;;;;;;;;;AAoCM,MAAMA,sBAAsBC,uDAAAA,WAAWA;IAgB5C,MAAM,OAAOC,OAAuB,EAAiB;YAG3BC;QAFxB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2BD;QAE5C,IAAIE,oBAAoB,AAAY,SAAZD,CAAAA,gBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,gBAAAA,KAAAA,IAAAA,cAAc,UAAU;QAEhD,IAAI,CAACC,mBAAmB;gBACTC,gBACAC;YADb,MAAMC,OAAOF,AAAAA,CAAY,SAAZA,CAAAA,iBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,iBAAAA,KAAAA,IAAAA,eAAc,IAAI,AAAD,KAAK;YACnC,MAAMG,OAAOF,AAAAA,CAAY,SAAZA,CAAAA,iBAAAA,IAAI,CAAC,OAAO,AAAD,KAAXA,AAAAA,KAAAA,MAAAA,iBAAAA,KAAAA,IAAAA,eAAc,IAAI,AAAD,KAAK;YACnC,MAAMG,WAAW,MAAMC,MAAM,CAAC,OAAO,EAAEH,KAAK,CAAC,EAAEC,KAAK,aAAa,CAAC;YAClE,MAAM,EAAEG,oBAAoB,EAAE,GAAG,MAAMF,SAAS,IAAI;YACpDL,oBAAoBO;QACtB;QAEA,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6BP;QAE9C,MAAMQ,0BAAoD;YACxDR;YACA,iBAAiBF,AAAAA,CAAAA,QAAAA,UAAAA,KAAAA,IAAAA,QAAS,eAAe,AAAD,KAAK;gBAAE,OAAO;gBAAM,QAAQ;YAAI;QAC1E;QAEA,IAAI;YACF,IAAI,CAAC,OAAO,GAAG,MAAMW,oDAAAA,OAAiB,CAACD;YACvC,MAAM,IAAI,CAAC,iBAAiB;YAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACtB,EAAE,OAAOE,OAAO;YACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwCA;YAC1D,MAAMA;QACR;IACF;IAvCA,YAAoBZ,OAA8B,CAAE;QAClD,KAAK,CAACA,UAAAA,iBAAAA,IAAAA,EAAAA,WAAAA,KAAAA,IAAAA,IAAAA,CADYA,OAAO,GAAPA;IAEpB;AAsCF"}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+import { Page, WaitForOptions } from 'puppeteer-core';
+/**
+ * Options for launching a browser instance
+ * @interface LaunchOptions
+ */
+export interface LaunchOptions {
+    /**
+     * Whether to run browser in headless mode
+     * @default false
+     */
+    headless?: boolean;
+    /**
+     * Maximum time in milliseconds to wait for the browser to start
+     * @default 0 (no timeout)
+     */
+    timeout?: number;
+    /**
+     * The viewport dimensions
+     * @property {number} width - Viewport width in pixels
+     * @property {number} height - Viewport height in pixels
+     */
+    defaultViewport?: {
+        width: number;
+        height: number;
+    };
+    /**
+     * Path to a browser executable to use instead of the automatically detected one
+     * If not provided, the system will attempt to find an installed browser
+     */
+    executablePath?: string;
+    /**
+     * Path to a specific browser profile to use
+     * Allows using existing browser profiles with cookies, extensions, etc.
+     */
+    profilePath?: string;
+    /**
+     * Proxy server URL, e.g. 'http://proxy.example.com:8080'
+     * Used to route browser traffic through a proxy server
+     */
+    proxy?: string;
+}
+/**
+ * Options for evaluating JavaScript in a new page
+ * @template T - Array of parameters to pass to the page function
+ * @template R - Return type of the page function
+ * @interface EvaluateOnNewPageOptions
+ */
+export interface EvaluateOnNewPageOptions<T extends any[], R> {
+    /**
+     * URL to navigate to before evaluating the function
+     * The page will load this URL before executing the pageFunction
+     */
+    url: string;
+    /**
+     * Options for waiting for the page to load
+     */
+    waitForOptions?: WaitForOptions;
+    /**
+     * Function to be evaluated in the page context
+     * This function runs in the context of the browser page, not Node.js
+     * @param {Window} window - The window object of the page
+     * @param {...T} args - Additional arguments passed to the function
+     * @returns {R} Result of the function execution
+     */
+    pageFunction: (window: Window, ...args: T) => R;
+    /**
+     * Parameters to pass to the page function
+     * These values will be serialized and passed to the pageFunction
+     */
+    pageFunctionParams: T;
+    /**
+     * Optional function to execute before page navigation
+     * Useful for setting up page configuration before loading the URL
+     * @param {Page} page - Puppeteer page instance
+     * @returns {void | Promise<void>}
+     */
+    beforePageLoad?: (page: Page) => void | Promise<void>;
+    /**
+     * Optional function to execute after page navigation
+     * Useful for setting up page configuration after loading the URL
+     * @param {Page} page - Puppeteer page instance
+     * @returns {void | Promise<void>}
+     */
+    afterPageLoad?: (page: Page) => void | Promise<void>;
+    /**
+     * Optional function to process the result before returning
+     * Can be used to transform or validate the result from page evaluation
+     * @param {Page} page - Puppeteer page instance
+     * @param {R} result - Result from page function evaluation
+     * @returns {R | Promise<R>} Processed result
+     */
+    beforeSendResult?: (page: Page, result: R) => R | Promise<R>;
+}
+/**
+ * Core browser interface that all browser implementations must implement
+ * Defines the standard API for browser automation
+ * @interface BrowserInterface
+ */
+export interface BrowserInterface {
+    /**
+     * Launch a new browser instance
+     * @param {LaunchOptions} [options] - Launch configuration options
+     * @returns {Promise<void>} Promise resolving when browser is launched
+     */
+    launch(options?: LaunchOptions): Promise<void>;
+    /**
+     * Close the browser instance and all its pages
+     * @returns {Promise<void>} Promise resolving when browser is closed
+     */
+    close(): Promise<void>;
+    /**
+     * Create a new page in the browser
+     * @returns {Promise<Page>} Promise resolving to the new page instance
+     */
+    createPage(): Promise<Page>;
+    /**
+     * Evaluate a function in a new page context
+     * Creates a new page, navigates to URL, executes function, and returns result
+     * @template T - Array of parameters to pass to the page function
+     * @template R - Return type of the page function
+     * @param {EvaluateOnNewPageOptions<T, R>} options - Evaluation options
+     * @returns {Promise<R | null>} Promise resolving to the function result or null
+     */
+    evaluateOnNewPage<T extends any[], R>(options: EvaluateOnNewPageOptions<T, R>): Promise<R | null>;
+    /**
+     * Get the currently active page or create one if none exists
+     * @returns {Promise<Page>} Promise resolving to the active page instance
+     */
+    getActivePage(): Promise<Page>;
+}
+export { Page };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC;IAC1D;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IAEhD;;;OAGG;IACH,kBAAkB,EAAE,CAAC,CAAC;IAEtB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9D;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,EAAE,CAAC,EAClC,OAAO,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAErB;;;OAGG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,38 @@
+/**
+* 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__, {
+    Page: ()=>external_puppeteer_core_namespaceObject.Page
+});
+const external_puppeteer_core_namespaceObject = require("puppeteer-core");
+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/types.mjs

@@ -0,0 +1,7 @@
+/**
+* Copyright (c) 2025 Bytedance, Inc. and its affiliates.
+* SPDX-License-Identifier: Apache-2.0
+*/
+import * as __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__ from "puppeteer-core";
+var __webpack_exports__Page = __WEBPACK_EXTERNAL_MODULE_puppeteer_core_17481843__.Page;
+export { __webpack_exports__Page as Page };