@crawlee/stagehand 4.0.0-beta.223 → 4.0.0-beta.225

package/index.d.ts

@@ -51,8 +51,8 @@
  */
 export * from '@crawlee/browser';
 export { StagehandCrawler, createStagehandRouter } from './internals/stagehand-crawler';
-export { stagehandBrowserPool, remoteStagehandBrowserPool } from './internals/stagehand-browser-pool';
-export type { StagehandBrowserPool, StagehandBrowserPoolOptions, RemoteStagehandBrowserPoolOptions, } from './internals/stagehand-browser-pool';
+export { stagehandBrowserPool } from './internals/stagehand-browser-pool';
+export type { StagehandBrowserPool, StagehandBrowserPoolOptions } from './internals/stagehand-browser-pool';
 export type { StagehandOptions, StagehandPage, StagehandCrawlingContext, StagehandHook, StagehandGotoOptions, StagehandCrawlerOptions, } from './internals/stagehand-crawler';
 export type { StagehandLaunchContext } from './internals/stagehand-launcher';
 export type { ActOptions, ActResult, Action, AgentConfig, ExtractOptions, ModelConfiguration, ObserveOptions, Stagehand, } from '@browserbasehq/stagehand';

package/index.js

@@ -51,7 +51,7 @@
  * @module @crawlee/stagehand
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.remoteStagehandBrowserPool = exports.stagehandBrowserPool = exports.createStagehandRouter = exports.StagehandCrawler = void 0;
+exports.stagehandBrowserPool = exports.createStagehandRouter = exports.StagehandCrawler = void 0;
 const tslib_1 = require("tslib");
 // Re-export everything from @crawlee/browser for convenience
 tslib_1.__exportStar(require("@crawlee/browser"), exports);
@@ -62,4 +62,3 @@ Object.defineProperty(exports, "createStagehandRouter", { enumerable: true, get:
 // Export the browser pool factories, which are how a pool with non-default options reaches the crawler
 var stagehand_browser_pool_1 = require("./internals/stagehand-browser-pool");
 Object.defineProperty(exports, "stagehandBrowserPool", { enumerable: true, get: function () { return stagehand_browser_pool_1.stagehandBrowserPool; } });
-Object.defineProperty(exports, "remoteStagehandBrowserPool", { enumerable: true, get: function () { return stagehand_browser_pool_1.remoteStagehandBrowserPool; } });

package/index.mjs

@@ -123,7 +123,6 @@ export const parseValue = mod.parseValue;
 export const purgeDefaultStorages = mod.purgeDefaultStorages;
 export const rejectOperationInTransaction = mod.rejectOperationInTransaction;
 export const remainingNavigationWindowMillis = mod.remainingNavigationWindowMillis;
-export const remoteStagehandBrowserPool = mod.remoteStagehandBrowserPool;
 export const resolveBaseUrlForEnqueueLinksFiltering = mod.resolveBaseUrlForEnqueueLinksFiltering;
 export const serializeArray = mod.serializeArray;
 export const serializeValue = mod.serializeValue;

package/internals/stagehand-browser-pool.d.ts

@@ -1,5 +1,5 @@
 import type { Configuration } from '@crawlee/browser';
-import type { BrowserPool, BrowserPoolHooks, BrowserPoolOptions, RemoteBrowserPool, RemoteBrowserPoolOptions } from '@crawlee/browser-pool';
+import type { BrowserPool, BrowserPoolHooks, BrowserPoolOptions } from '@crawlee/browser-pool';
 // @ts-ignore optional peer dependency or compatibility with es2022
 import type { Page } from 'playwright';
 import type { StagehandOptions } from './stagehand-crawler';
@@ -22,8 +22,6 @@ export interface StagehandBrowserPoolOptions extends Omit<BrowserPoolOptions, 'b
     /** Configuration to read the browser defaults from. Defaults to the global configuration. */
     configuration?: Configuration;
 }
-export interface RemoteStagehandBrowserPoolOptions extends Pick<StagehandBrowserPoolOptions, 'launchContext' | 'stagehandOptions' | 'headless' | 'configuration'>, Omit<RemoteBrowserPoolOptions, 'browserPlugins'> {
-}
 /**
  * Builds a {@link BrowserPool} of Stagehand browsers to pass to a {@link StagehandCrawler} as its
  * {@link BrowserCrawlerOptions.browserPool|`browserPool`}.
@@ -50,14 +48,3 @@ export interface RemoteStagehandBrowserPoolOptions extends Pick<StagehandBrowser
  * @category Browser management
  */
 export declare function stagehandBrowserPool(options?: StagehandBrowserPoolOptions): StagehandBrowserPool;
-/**
- * The {@link RemoteBrowserPool} counterpart of {@link stagehandBrowserPool}: connects to a remote browser
- * service with a Stagehand plugin derived from `launchContext` and `stagehandOptions`.
- *
- * A {@link StagehandCrawler} accepts the same connection details directly via
- * {@link BrowserCrawlerOptions.remoteBrowser|`remoteBrowser`}; reach for this factory when you also need to
- * tune the wrapping pool, or to share one remote pool between crawlers.
- *
- * @category Browser management
- */
-export declare function remoteStagehandBrowserPool(options: RemoteStagehandBrowserPoolOptions): RemoteBrowserPool<Page>;

package/internals/stagehand-browser-pool.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stagehandBrowserPool = stagehandBrowserPool;
-exports.remoteStagehandBrowserPool = remoteStagehandBrowserPool;
 const stagehand_launcher_1 = require("./stagehand-launcher");
 /**
  * Builds a {@link BrowserPool} of Stagehand browsers to pass to a {@link StagehandCrawler} as its
@@ -32,20 +31,6 @@ function stagehandBrowserPool(options = {}) {
     const { launchContext, stagehandOptions, headless, configuration, ...poolOptions } = options;
     return stagehandLauncher(launchContext, stagehandOptions, headless, configuration).createBrowserPool(poolOptions);
 }
-/**
- * The {@link RemoteBrowserPool} counterpart of {@link stagehandBrowserPool}: connects to a remote browser
- * service with a Stagehand plugin derived from `launchContext` and `stagehandOptions`.
- *
- * A {@link StagehandCrawler} accepts the same connection details directly via
- * {@link BrowserCrawlerOptions.remoteBrowser|`remoteBrowser`}; reach for this factory when you also need to
- * tune the wrapping pool, or to share one remote pool between crawlers.
- *
- * @category Browser management
- */
-function remoteStagehandBrowserPool(options) {
-    const { launchContext, stagehandOptions, headless, configuration, ...remoteOptions } = options;
-    return stagehandLauncher(launchContext, stagehandOptions, headless, configuration).createRemoteBrowserPool(remoteOptions);
-}
 function stagehandLauncher(launchContext = {}, stagehandOptions = {}, headless, configuration) {
     return new stagehand_launcher_1.StagehandLauncher({
         ...launchContext,

package/internals/stagehand-crawler.js

@@ -89,20 +89,19 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
             configuration,
             // The pool serves plain Playwright pages - a page only becomes a `StagehandPage` further down the
             // pipeline, once `setUpStagehand` enhances it - so its page type is narrower than the crawler's.
-            browserPoolBuilder: (remoteBrowser) => (remoteBrowser
-                ? (0, stagehand_browser_pool_1.remoteStagehandBrowserPool)({
-                    ...remoteBrowser,
+            browserPoolBuilder: (remoteBrowser) => {
+                // Stagehand manages its own browser (local or Browserbase), so a Crawlee-level remote connection
+                // would be silently ignored.
+                if (remoteBrowser) {
+                    throw new Error('StagehandCrawler does not support `remoteBrowser`. Use `stagehandOptions.env: "BROWSERBASE"` instead.');
+                }
+                return (0, stagehand_browser_pool_1.stagehandBrowserPool)({
                     launchContext,
                     stagehandOptions,
                     headless,
                     configuration,
-                })
-                : (0, stagehand_browser_pool_1.stagehandBrowserPool)({
-                    launchContext,
-                    stagehandOptions,
-                    headless,
-                    configuration,
-                })),
+                });
+            },
             contextPipelineBuilder: () => this.#buildContextPipeline(),
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@crawlee/stagehand",
-    "version": "4.0.0-beta.223",
+    "version": "4.0.0-beta.225",
     "description": "AI-powered web crawling with Stagehand integration for Crawlee - enables natural language browser automation with act(), extract(), and observe() methods.",
     "engines": {
         "node": ">=22.13.0"
@@ -56,11 +56,11 @@
         "access": "public"
     },
     "dependencies": {
-        "@crawlee/browser": "4.0.0-beta.223",
-        "@crawlee/browser-pool": "4.0.0-beta.223",
-        "@crawlee/core": "4.0.0-beta.223",
-        "@crawlee/types": "4.0.0-beta.223",
-        "@crawlee/utils": "4.0.0-beta.223",
+        "@crawlee/browser": "4.0.0-beta.225",
+        "@crawlee/browser-pool": "4.0.0-beta.225",
+        "@crawlee/core": "4.0.0-beta.225",
+        "@crawlee/types": "4.0.0-beta.225",
+        "@crawlee/utils": "4.0.0-beta.225",
         "tslib": "^2.8.1",
         "zod": "^4.5.4"
     },
@@ -87,5 +87,5 @@
             }
         }
     },
-    "gitHead": "cfcbcbebeabd9ca2dfd7a17afe559db16307250d"
+    "gitHead": "5d71fa0f785d7dc5736d95bdf5f4ec907e5a1c42"
 }