@crawlee/stagehand 4.0.0-beta.210 → 4.0.0-beta.212

package/internals/stagehand-controller.d.ts

@@ -29,20 +29,6 @@ export declare class StagehandController extends BrowserController<BrowserType,
      * We use Playwright's browser API directly since we connected via CDP.
      */
     protected _newPage(_contextOptions?: unknown): Promise<Page>;
-    /**
-     * Waits until Stagehand knows about the page, so that `act()`/`extract()`/`observe()` can resolve it.
-     *
-     * Stagehand only learns about pages from CDP `Target.attachedToTarget` events on its own connection,
-     * and it maps them by main frame id. We create pages through a separate `connectOverCDP()` handle, so
-     * `context.newPage()` resolves before Stagehand has processed that event — the page is unresolvable for
-     * a short window, and the AI methods fail with 'Failed to resolve V3 Page from Playwright page'.
-     * Stagehand's own `newPage()` polls for the same reason.
-     */
-    private waitForStagehandToRegisterPage;
-    /**
-     * Reads the page's main frame id, which is the key Stagehand resolves pages by.
-     */
-    private getMainFrameId;
     /**
      * Normalizes proxy options for Playwright.
      */

package/internals/stagehand-controller.js

@@ -54,7 +54,7 @@ class StagehandController extends browser_pool_1.BrowserController {
                 this.registerPageClosed(page);
             });
             try {
-                await this.waitForStagehandToRegisterPage(page);
+                await this.#waitForStagehandToRegisterPage(page);
             }
             catch (error) {
                 await page.close().catch(() => { });
@@ -77,9 +77,9 @@ class StagehandController extends browser_pool_1.BrowserController {
      * a short window, and the AI methods fail with 'Failed to resolve V3 Page from Playwright page'.
      * Stagehand's own `newPage()` polls for the same reason.
      */
-    async waitForStagehandToRegisterPage(page, timeoutMs = 10_000) {
+    async #waitForStagehandToRegisterPage(page, timeoutMs = 10_000) {
         const stagehand = this.getStagehand();
-        const mainFrameId = await this.getMainFrameId(page);
+        const mainFrameId = await this.#getMainFrameId(page);
         const deadline = Date.now() + timeoutMs;
         while (Date.now() < deadline) {
             if (stagehand.context.resolvePageByMainFrameId(mainFrameId)) {
@@ -94,7 +94,7 @@ class StagehandController extends browser_pool_1.BrowserController {
     /**
      * Reads the page's main frame id, which is the key Stagehand resolves pages by.
      */
-    async getMainFrameId(page) {
+    async #getMainFrameId(page) {
         const cdpSession = await page.context().newCDPSession(page);
         try {
             const { frameTree } = await cdpSession.send('Page.getFrameTree');

package/internals/stagehand-crawler.d.ts

@@ -440,20 +440,6 @@ export declare class StagehandCrawler<ContextExtension = Dictionary<never>, Exte
      * @param options - Crawler configuration options
      */
     constructor(options?: StagehandCrawlerOptions<ContextExtension, ExtendedContext, Routes, StatisticStateExtension>);
-    /**
-     * Resolves the {@link StagehandController} that owns the given page, or
-     * `undefined` when the pool does not expose controllers (e.g. a custom
-     * {@link IBrowserPool} implementation).
-     *
-     * Stagehand needs direct controller access to reach the `Stagehand`
-     * instance bound to the page's browser, which is why it reaches past the
-     * {@link IBrowserPool} abstraction here.
-     */
-    private getBrowserControllerByPage;
-    /**
-     * Enhance the page with Stagehand AI methods.
-     */
-    private setUpStagehand;
     /**
      * Navigation handler for Stagehand crawler.
      * Uses standard Playwright navigation.

package/internals/stagehand-crawler.js

@@ -107,7 +107,7 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
         });
     }
     #buildContextPipeline() {
-        return this.buildContextPipeline().compose(this.setUpStagehand.bind(this));
+        return this.buildContextPipeline().compose(this.#setUpStagehand.bind(this));
     }
     /**
      * Resolves the {@link StagehandController} that owns the given page, or
@@ -118,7 +118,7 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
      * instance bound to the page's browser, which is why it reaches past the
      * {@link IBrowserPool} abstraction here.
      */
-    getBrowserControllerByPage(page) {
+    #getBrowserControllerByPage(page) {
         if ('getBrowserControllerByPage' in this.browserPool) {
             return this.browserPool.getBrowserControllerByPage(page);
         }
@@ -127,8 +127,8 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
     /**
      * Enhance the page with Stagehand AI methods.
      */
-    async setUpStagehand(crawlingContext) {
-        const controller = this.getBrowserControllerByPage(crawlingContext.page);
+    async #setUpStagehand(crawlingContext) {
+        const controller = this.#getBrowserControllerByPage(crawlingContext.page);
         if (!controller) {
             throw new Error('Could not resolve StagehandController for page — is the browser pool configured correctly?');
         }

package/internals/stagehand-plugin.d.ts

@@ -32,10 +32,6 @@ export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOp
      * Launches a browser using Stagehand and connects Playwright to it via CDP.
      */
     protected _launch(launchContext: LaunchContext<BrowserType>): Promise<PlaywrightBrowser>;
-    /**
-     * Cleans up Stagehand instance when browser disconnects.
-     */
-    private cleanupStagehand;
     /**
      * Creates a controller for the Stagehand browser.
      */
@@ -48,8 +44,4 @@ export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOp
      * Determines if this is a Chromium-based browser.
      */
     protected isChromiumBasedBrowser(): boolean;
-    /**
-     * Augments launch errors with helpful context.
-     */
-    private augmentLaunchError;
 }

package/internals/stagehand-plugin.js

@@ -79,7 +79,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
             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,7 +96,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     /**
      * Cleans up Stagehand instance when browser disconnects.
      */
-    async cleanupStagehand(browser) {
+    async #cleanupStagehand(browser) {
         const stagehand = this.#stagehandInstances.get(browser);
         if (stagehand) {
             try {
@@ -139,7 +139,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     /**
      * 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 = '';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/stagehand",
-    "version": "4.0.0-beta.210",
+    "version": "4.0.0-beta.212",
     "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": "^1.0.1",
-        "@crawlee/browser": "4.0.0-beta.210",
-        "@crawlee/browser-pool": "4.0.0-beta.210",
-        "@crawlee/core": "4.0.0-beta.210",
-        "@crawlee/types": "4.0.0-beta.210",
-        "@crawlee/utils": "4.0.0-beta.210",
+        "@crawlee/browser": "4.0.0-beta.212",
+        "@crawlee/browser-pool": "4.0.0-beta.212",
+        "@crawlee/core": "4.0.0-beta.212",
+        "@crawlee/types": "4.0.0-beta.212",
+        "@crawlee/utils": "4.0.0-beta.212",
         "tslib": "^2.8.1",
         "zod": "^4.5.4"
     },
@@ -88,5 +88,5 @@
             }
         }
     },
-    "gitHead": "037dff5d651d88e96749cc79d17bc6d1e154f4e1"
+    "gitHead": "171a63a5d7f2a6d74cbce58479204ac20d30b87e"
 }