@crawlee/stagehand 4.0.0-beta.105 → 4.0.0-beta.107

package/internals/stagehand-controller.d.ts

@@ -18,8 +18,7 @@ import type { StagehandPlugin } from './stagehand-plugin';
  * @ignore
  */
 export declare class StagehandController extends BrowserController<BrowserType, LaunchOptions, PlaywrightBrowser> {
-    private stagehand;
-    private readonly stagehandInstances;
+    #private;
     constructor(browserPlugin: StagehandPlugin, stagehandInstances: WeakMap<PlaywrightBrowser, Stagehand>);
     /**
      * Gets the Stagehand instance associated with this controller's browser.

package/internals/stagehand-controller.js

@@ -18,23 +18,23 @@ const utils_1 = require("@crawlee/utils");
  * @ignore
  */
 class StagehandController extends browser_pool_1.BrowserController {
-    stagehand = null;
-    stagehandInstances;
+    #stagehand = null;
+    #stagehandInstances;
     constructor(browserPlugin, stagehandInstances) {
         super(browserPlugin);
-        this.stagehandInstances = stagehandInstances;
+        this.#stagehandInstances = stagehandInstances;
     }
     /**
      * Gets the Stagehand instance associated with this controller's browser.
      */
     getStagehand() {
-        if (!this.stagehand) {
-            this.stagehand = this.stagehandInstances.get(this.browser);
-            if (!this.stagehand) {
+        if (!this.#stagehand) {
+            this.#stagehand = this.#stagehandInstances.get(this.browser);
+            if (!this.#stagehand) {
                 throw new Error('Stagehand instance not found for browser');
             }
         }
-        return this.stagehand;
+        return this.#stagehand;
     }
     /**
      * Creates a new page using the browser's default context.

package/internals/stagehand-crawler.d.ts

@@ -433,7 +433,7 @@ export declare class StagehandCrawler<ContextExtension = Dictionary<never>, Exte
      * Navigation handler for Stagehand crawler.
      * Uses standard Playwright navigation.
      */
-    protected _navigationHandler(crawlingContext: StagehandCrawlingContext, gotoOptions: StagehandGotoOptions): Promise<Response | null>;
+    protected navigationHandler(crawlingContext: StagehandCrawlingContext, gotoOptions: StagehandGotoOptions): Promise<Response | null>;
 }
 /**
  * Creates a new router for StagehandCrawler with type-safe route handlers.

package/internals/stagehand-crawler.js

@@ -123,7 +123,7 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
      * Navigation handler for Stagehand crawler.
      * Uses standard Playwright navigation.
      */
-    async _navigationHandler(crawlingContext, gotoOptions) {
+    async navigationHandler(crawlingContext, gotoOptions) {
         // Use standard page.goto for navigation
         return crawlingContext.page.goto(crawlingContext.request.url, gotoOptions);
     }

package/internals/stagehand-launcher.d.ts

@@ -54,6 +54,7 @@ export interface StagehandLaunchContext extends BrowserLaunchContext<LaunchOptio
  * @ignore
  */
 export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin> {
+    #private;
     readonly configuration: Configuration;
     protected static optionsShape: {
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -79,7 +80,6 @@ export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin>
 // @ts-ignore optional peer dependency or compatibility with es2022
         userAgent: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
     };
-    private readonly stagehandOptions;
     /**
      * All StagehandLauncher parameters are passed via the launchContext object.
      */

package/internals/stagehand-launcher.js

@@ -19,7 +19,7 @@ class StagehandLauncher extends browser_1.BrowserLauncher {
         launchContextOptions: ow_1.default.optional.object,
         stagehandOptions: ow_1.default.optional.object,
     };
-    stagehandOptions;
+    #stagehandOptions;
     /**
      * All StagehandLauncher parameters are passed via the launchContext object.
      */
@@ -37,7 +37,7 @@ class StagehandLauncher extends browser_1.BrowserLauncher {
             launcher,
         }, configuration);
         this.configuration = configuration;
-        this.stagehandOptions = {
+        this.#stagehandOptions = {
             env: 'LOCAL',
             model: 'openai/gpt-4.1-mini',
             ...stagehandOptions,
@@ -52,7 +52,7 @@ class StagehandLauncher extends browser_1.BrowserLauncher {
             ...this.otherLaunchContextProps,
             proxyUrl: this.proxyUrl,
             launchOptions: this.createLaunchOptions(),
-            stagehandOptions: this.stagehandOptions, // Set AFTER to override any unresolved options
+            stagehandOptions: this.#stagehandOptions, // Set AFTER to override any unresolved options
         });
     }
 }

package/internals/stagehand-plugin.d.ts

@@ -27,8 +27,8 @@ export interface StagehandPluginOptions extends BrowserPluginOptions<LaunchOptio
  * - Some fingerprinting options may not be fully applied (Stagehand controls browser launch)
  */
 export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOptions, PlaywrightBrowser> {
+    #private;
     readonly stagehandOptions: StagehandOptions;
-    private readonly stagehandInstances;
     constructor(library: BrowserType, options?: StagehandPluginOptions);
     /**
      * Launches a browser using Stagehand and connects Playwright to it via CDP.
@@ -37,7 +37,7 @@ export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOp
     /**
      * Cleans up Stagehand instance when browser disconnects.
      */
-    private _cleanupStagehand;
+    private cleanupStagehand;
     /**
      * Creates a controller for the Stagehand browser.
      */
@@ -45,15 +45,15 @@ export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOp
     /**
      * Adds proxy configuration to launch options.
      */
-    protected _addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
+    protected addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
     /**
      * Determines if this is a Chromium-based browser.
      */
-    protected _isChromiumBasedBrowser(): boolean;
+    protected isChromiumBasedBrowser(): boolean;
     /**
      * Augments launch errors with helpful context.
      */
-    private _augmentLaunchError;
+    private augmentLaunchError;
     /**
      * Gets the Stagehand instance for a given browser.
      */

package/internals/stagehand-plugin.js

@@ -22,7 +22,7 @@ const stagehand_controller_1 = require("./stagehand-controller");
  */
 class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     stagehandOptions;
-    stagehandInstances = new WeakMap();
+    #stagehandInstances = new WeakMap();
     constructor(library, options = {}) {
         super(library, options);
         this.stagehandOptions = options.stagehandOptions ?? {};
@@ -76,10 +76,10 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
             }
             const browser = await playwright_1.chromium.connectOverCDP(cdpUrl);
             // Store the Stagehand instance for AI operations
-            this.stagehandInstances.set(browser, stagehand);
+            this.#stagehandInstances.set(browser, stagehand);
             // Handle browser disconnection - cleanup both Stagehand and anonymized proxy
             browser.on('disconnected', async () => {
-                await this._cleanupStagehand(browser);
+                await this.cleanupStagehand(browser);
                 await closeAnonymizedProxy();
             });
             return browser;
@@ -88,7 +88,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
             // Clean up on failure
             await stagehand.close().catch(() => { });
             await closeAnonymizedProxy();
-            const augmentedError = this._augmentLaunchError(error, launchContext);
+            const augmentedError = this.augmentLaunchError(error, launchContext);
             core_1.serviceLocator.getLogger().error('Stagehand browser launch failed', { message: augmentedError.message });
             throw augmentedError;
         }
@@ -96,8 +96,8 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     /**
      * Cleans up Stagehand instance when browser disconnects.
      */
-    async _cleanupStagehand(browser) {
-        const stagehand = this.stagehandInstances.get(browser);
+    async cleanupStagehand(browser) {
+        const stagehand = this.#stagehandInstances.get(browser);
         if (stagehand) {
             try {
                 await stagehand.close();
@@ -105,19 +105,19 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
             catch {
                 // Ignore cleanup errors
             }
-            this.stagehandInstances.delete(browser);
+            this.#stagehandInstances.delete(browser);
         }
     }
     /**
      * Creates a controller for the Stagehand browser.
      */
     createController() {
-        return new stagehand_controller_1.StagehandController(this, this.stagehandInstances);
+        return new stagehand_controller_1.StagehandController(this, this.#stagehandInstances);
     }
     /**
      * Adds proxy configuration to launch options.
      */
-    async _addProxyToLaunchOptions(launchContext) {
+    async addProxyToLaunchOptions(launchContext) {
         launchContext.launchOptions ??= {};
         const { launchOptions, proxyUrl } = launchContext;
         if (proxyUrl) {
@@ -132,14 +132,14 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     /**
      * Determines if this is a Chromium-based browser.
      */
-    _isChromiumBasedBrowser() {
+    isChromiumBasedBrowser() {
         const name = this.library?.name?.();
         return name === 'chromium';
     }
     /**
      * Augments launch errors with helpful context.
      */
-    _augmentLaunchError(error, launchContext) {
+    augmentLaunchError(error, launchContext) {
         const message = error instanceof Error ? error.message : String(error);
         const model = this.stagehandOptions.model;
         let helpText = '';
@@ -163,7 +163,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
      * Gets the Stagehand instance for a given browser.
      */
     getStagehandForBrowser(browser) {
-        return this.stagehandInstances.get(browser);
+        return this.#stagehandInstances.get(browser);
     }
 }
 exports.StagehandPlugin = StagehandPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/stagehand",
-    "version": "4.0.0-beta.105",
+    "version": "4.0.0-beta.107",
     "description": "AI-powered web crawling with Stagehand integration for Crawlee - enables natural language browser automation with act(), extract(), and observe() methods.",
     "engines": {
         "node": ">=22.0.0"
@@ -57,11 +57,11 @@
     },
     "dependencies": {
         "@apify/timeout": "^0.4.4",
-        "@crawlee/browser": "4.0.0-beta.105",
-        "@crawlee/browser-pool": "4.0.0-beta.105",
-        "@crawlee/core": "4.0.0-beta.105",
-        "@crawlee/types": "4.0.0-beta.105",
-        "@crawlee/utils": "4.0.0-beta.105",
+        "@crawlee/browser": "4.0.0-beta.107",
+        "@crawlee/browser-pool": "4.0.0-beta.107",
+        "@crawlee/core": "4.0.0-beta.107",
+        "@crawlee/types": "4.0.0-beta.107",
+        "@crawlee/utils": "4.0.0-beta.107",
         "ow": "^2.0.0",
         "tslib": "^2.8.1"
     },
@@ -93,5 +93,5 @@
             }
         }
     },
-    "gitHead": "26073a822c7699ac487931383a39192bc3daae7a"
+    "gitHead": "5a3cb6242d0ae261df93c5e03cfebbb9b736e6b7"
 }