@crawlee/stagehand 3.18.0 → 4.0.0-beta.100

package/README.md

@@ -1,23 +1,23 @@
 <h1 align="center">
     <a href="https://crawlee.dev">
         <picture>
-          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/apify/crawlee/master/website/static/img/crawlee-dark.svg?sanitize=true">
-          <img alt="Crawlee" src="https://raw.githubusercontent.com/apify/crawlee/master/website/static/img/crawlee-light.svg?sanitize=true" width="500">
+          <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/apify/crawlee/master/website/static/img/crawlee-dark.svg?sanitize=true" />
+          <img alt="Crawlee" src="https://raw.githubusercontent.com/apify/crawlee/master/website/static/img/crawlee-light.svg?sanitize=true" width="500" />
         </picture>
     </a>
-    <br>
+    <br />
     <small>A web scraping and browser automation library</small>
 </h1>
 
-<p align=center>
-    <a href="https://trendshift.io/repositories/5179" target="_blank"><img src="https://trendshift.io/api/badge/repositories/5179" alt="apify%2Fcrawlee | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<p align="center">
+    <a href="https://trendshift.io/repositories/5179" target="_blank"><img src="https://trendshift.io/api/badge/repositories/5179" alt="apify%2Fcrawlee | Trendshift" width="250" height="55"/></a>
 </p>
 
-<p align=center>
-    <a href="https://www.npmjs.com/package/@crawlee/core" rel="nofollow"><img src="https://img.shields.io/npm/v/@crawlee/core.svg" alt="NPM latest version" data-canonical-src="https://img.shields.io/npm/v/@crawlee/core/next.svg" style="max-width: 100%;"></a>
-    <a href="https://www.npmjs.com/package/@crawlee/core" rel="nofollow"><img src="https://img.shields.io/npm/dm/@crawlee/core.svg" alt="Downloads" data-canonical-src="https://img.shields.io/npm/dm/@crawlee/core.svg" style="max-width: 100%;"></a>
-    <a href="https://discord.gg/jyEM2PRvMU" rel="nofollow"><img src="https://img.shields.io/discord/801163717915574323?label=discord" alt="Chat on discord" data-canonical-src="https://img.shields.io/discord/801163717915574323?label=discord" style="max-width: 100%;"></a>
-    <a href="https://github.com/apify/crawlee/actions/workflows/test-ci.yml"><img src="https://github.com/apify/crawlee/actions/workflows/test-ci.yml/badge.svg?branch=master" alt="Build Status" style="max-width: 100%;"></a>
+<p align="center">
+    <a href="https://www.npmjs.com/package/@crawlee/core" rel="nofollow"><img src="https://img.shields.io/npm/v/@crawlee/core.svg" alt="NPM latest version" data-canonical-src="https://img.shields.io/npm/v/@crawlee/core/next.svg" /></a>
+    <a href="https://www.npmjs.com/package/@crawlee/core" rel="nofollow"><img src="https://img.shields.io/npm/dm/@crawlee/core.svg" alt="Downloads" data-canonical-src="https://img.shields.io/npm/dm/@crawlee/core.svg" /></a>
+    <a href="https://discord.gg/jyEM2PRvMU" rel="nofollow"><img src="https://img.shields.io/discord/801163717915574323?label=discord" alt="Chat on discord" data-canonical-src="https://img.shields.io/discord/801163717915574323?label=discord" /></a>
+    <a href="https://github.com/apify/crawlee/actions/workflows/test-ci.yml"><img src="https://github.com/apify/crawlee/actions/workflows/test-ci.yml/badge.svg?branch=master" alt="Build Status" /></a>
 </p>
 
 Crawlee covers your crawling and scraping end-to-end and **helps you build reliable scrapers. Fast.**

package/index.d.ts

@@ -50,7 +50,7 @@
  * @module @crawlee/stagehand
  */
 export * from '@crawlee/browser';
-export { StagehandCrawler, createStagehandRouter, } from './internals/stagehand-crawler';
+export { StagehandCrawler, createStagehandRouter } from './internals/stagehand-crawler';
 export type { StagehandOptions, StagehandPage, StagehandCrawlingContext, StagehandHook, StagehandRequestHandler, StagehandGotoOptions, StagehandCrawlerOptions, } from './internals/stagehand-crawler';
 export type { StagehandLaunchContext } from './internals/stagehand-launcher';
 export * as stagehandUtils from './internals/utils/stagehand-utils';

package/index.mjs

@@ -2,25 +2,33 @@ import mod from "./index.js";
 
 export default mod;
 export const API_PROCESSED_REQUESTS_DELAY_MILLIS = mod.API_PROCESSED_REQUESTS_DELAY_MILLIS;
+export const ApifyLogAdapter = mod.ApifyLogAdapter;
 export const AutoscaledPool = mod.AutoscaledPool;
-export const BASIC_CRAWLER_TIMEOUT_BUFFER_SECS = mod.BASIC_CRAWLER_TIMEOUT_BUFFER_SECS;
 export const BLOCKED_STATUS_CODES = mod.BLOCKED_STATUS_CODES;
+export const BaseCrawleeLogger = mod.BaseCrawleeLogger;
 export const BasicCrawler = mod.BasicCrawler;
 export const BrowserCrawler = mod.BrowserCrawler;
 export const BrowserLauncher = mod.BrowserLauncher;
+export const ClientLoadSignal = mod.ClientLoadSignal;
+export const ConcurrencySystem = mod.ConcurrencySystem;
 export const Configuration = mod.Configuration;
+export const ContextPipeline = mod.ContextPipeline;
+export const ContextPipelineCleanupError = mod.ContextPipelineCleanupError;
+export const ContextPipelineInitializationError = mod.ContextPipelineInitializationError;
+export const ContextPipelineInterruptedError = mod.ContextPipelineInterruptedError;
 export const CookieParseError = mod.CookieParseError;
-export const CrawlerExtension = mod.CrawlerExtension;
+export const CpuLoadSignal = mod.CpuLoadSignal;
 export const CriticalError = mod.CriticalError;
 export const DATASET_ITERATORS_DEFAULT_LIMIT = mod.DATASET_ITERATORS_DEFAULT_LIMIT;
+export const DEFAULT_CURRENT_HISTORY_SECS = mod.DEFAULT_CURRENT_HISTORY_SECS;
+export const DEFAULT_SNAPSHOT_HISTORY_SECS = mod.DEFAULT_SNAPSHOT_HISTORY_SECS;
 export const Dataset = mod.Dataset;
-export const EVENT_SESSION_RETIRED = mod.EVENT_SESSION_RETIRED;
 export const EnqueueStrategy = mod.EnqueueStrategy;
 export const ErrorSnapshotter = mod.ErrorSnapshotter;
 export const ErrorTracker = mod.ErrorTracker;
+export const EventLoopLoadSignal = mod.EventLoopLoadSignal;
 export const EventManager = mod.EventManager;
 export const EventType = mod.EventType;
-export const GotScrapingHttpClient = mod.GotScrapingHttpClient;
 export const KeyValueStore = mod.KeyValueStore;
 export const LocalEventManager = mod.LocalEventManager;
 export const Log = mod.Log;
@@ -31,74 +39,85 @@ export const LoggerText = mod.LoggerText;
 export const MAX_POOL_SIZE = mod.MAX_POOL_SIZE;
 export const MAX_QUERIES_FOR_CONSISTENCY = mod.MAX_QUERIES_FOR_CONSISTENCY;
 export const MemoryLoadSignal = mod.MemoryLoadSignal;
+export const MemoryStorageBackend = mod.MemoryStorageBackend;
 export const MissingRouteError = mod.MissingRouteError;
+export const MissingSessionError = mod.MissingSessionError;
+export const NavigationSkippedError = mod.NavigationSkippedError;
 export const NonRetryableError = mod.NonRetryableError;
+export const OwnedOrInjected = mod.OwnedOrInjected;
 export const PERSIST_STATE_KEY = mod.PERSIST_STATE_KEY;
 export const ProxyConfiguration = mod.ProxyConfiguration;
-export const PseudoUrl = mod.PseudoUrl;
 export const QUERY_HEAD_BUFFER = mod.QUERY_HEAD_BUFFER;
 export const QUERY_HEAD_MIN_LENGTH = mod.QUERY_HEAD_MIN_LENGTH;
 export const REQUESTS_PERSISTENCE_KEY = mod.REQUESTS_PERSISTENCE_KEY;
 export const RecoverableState = mod.RecoverableState;
 export const Request = mod.Request;
+export const RequestHandlerError = mod.RequestHandlerError;
 export const RequestHandlerResult = mod.RequestHandlerResult;
 export const RequestList = mod.RequestList;
-export const RequestListAdapter = mod.RequestListAdapter;
 export const RequestManagerTandem = mod.RequestManagerTandem;
-export const RequestProvider = mod.RequestProvider;
 export const RequestQueue = mod.RequestQueue;
-export const RequestQueueV1 = mod.RequestQueueV1;
-export const RequestQueueV2 = mod.RequestQueueV2;
 export const RequestState = mod.RequestState;
 export const RequestValidationError = mod.RequestValidationError;
 export const RetryRequestError = mod.RetryRequestError;
 export const Router = mod.Router;
 export const STATE_PERSISTENCE_KEY = mod.STATE_PERSISTENCE_KEY;
 export const STORAGE_CONSISTENCY_DELAY_MILLIS = mod.STORAGE_CONSISTENCY_DELAY_MILLIS;
+export const ServiceConflictError = mod.ServiceConflictError;
+export const ServiceLocator = mod.ServiceLocator;
 export const Session = mod.Session;
 export const SessionError = mod.SessionError;
 export const SessionPool = mod.SessionPool;
-export const SitemapRequestList = mod.SitemapRequestList;
+export const SitemapRequestLoader = mod.SitemapRequestLoader;
 export const SnapshotStore = mod.SnapshotStore;
 export const Snapshotter = mod.Snapshotter;
 export const StagehandCrawler = mod.StagehandCrawler;
 export const Statistics = mod.Statistics;
-export const StorageManager = mod.StorageManager;
+export const StorageInstanceManager = mod.StorageInstanceManager;
+export const StorageStatsTracker = mod.StorageStatsTracker;
 export const SystemStatus = mod.SystemStatus;
+export const applyRequestTransform = mod.applyRequestTransform;
+export const assertJsonSerializable = mod.assertJsonSerializable;
+export const bindMethodsToServiceLocator = mod.bindMethodsToServiceLocator;
 export const browserCrawlerEnqueueLinks = mod.browserCrawlerEnqueueLinks;
 export const browserPoolCookieToToughCookie = mod.browserPoolCookieToToughCookie;
-export const checkAndSerialize = mod.checkAndSerialize;
 export const checkStorageAccess = mod.checkStorageAccess;
-export const chunkBySize = mod.chunkBySize;
+export const coerceBoolean = mod.coerceBoolean;
+export const coerceNumber = mod.coerceNumber;
 export const constructGlobObjectsFromGlobs = mod.constructGlobObjectsFromGlobs;
-export const constructRegExpObjectsFromPseudoUrls = mod.constructRegExpObjectsFromPseudoUrls;
 export const constructRegExpObjectsFromRegExps = mod.constructRegExpObjectsFromRegExps;
+export const constructUrlPatternObjects = mod.constructUrlPatternObjects;
 export const cookieStringToToughCookie = mod.cookieStringToToughCookie;
+export const crawleeConfigFields = mod.crawleeConfigFields;
 export const createBasicRouter = mod.createBasicRouter;
-export const createClientLoadSignal = mod.createClientLoadSignal;
-export const createCpuLoadSignal = mod.createCpuLoadSignal;
 export const createDeserialize = mod.createDeserialize;
-export const createEventLoopLoadSignal = mod.createEventLoopLoadSignal;
+export const createDualIterable = mod.createDualIterable;
+export const createRequestDebugInfo = mod.createRequestDebugInfo;
 export const createRequestOptions = mod.createRequestOptions;
-export const createRequests = mod.createRequests;
 export const createStagehandRouter = mod.createStagehandRouter;
 export const defaultRoute = mod.defaultRoute;
 export const deserializeArray = mod.deserializeArray;
 export const enqueueLinks = mod.enqueueLinks;
 export const evaluateLoadSignalSample = mod.evaluateLoadSignalSample;
 export const extractUrlsFromPage = mod.extractUrlsFromPage;
-export const filterRequestsByPatterns = mod.filterRequestsByPatterns;
+export const field = mod.field;
+export const filterRequestOptionsByPatterns = mod.filterRequestOptionsByPatterns;
 export const getCookiesFromResponse = mod.getCookiesFromResponse;
 export const getDefaultCookieExpirationDate = mod.getDefaultCookieExpirationDate;
+export const getObjectType = mod.getObjectType;
 export const getRequestId = mod.getRequestId;
-export const handleRequestTimeout = mod.handleRequestTimeout;
+export const inspectValue = mod.inspectValue;
 export const log = mod.log;
-export const maybeStringify = mod.maybeStringify;
 export const mergeCookies = mod.mergeCookies;
-export const processHttpRequestOptions = mod.processHttpRequestOptions;
+export const navigationDeadlineKey = mod.navigationDeadlineKey;
+export const parseValue = mod.parseValue;
 export const purgeDefaultStorages = mod.purgeDefaultStorages;
+export const remainingNavigationWindowMillis = mod.remainingNavigationWindowMillis;
 export const resolveBaseUrlForEnqueueLinksFiltering = mod.resolveBaseUrlForEnqueueLinksFiltering;
+export const resolveStorageIdentifier = mod.resolveStorageIdentifier;
 export const serializeArray = mod.serializeArray;
+export const serializeValue = mod.serializeValue;
+export const serviceLocator = mod.serviceLocator;
 export const stagehandUtils = mod.stagehandUtils;
 export const toughCookieToBrowserPoolCookie = mod.toughCookieToBrowserPoolCookie;
 export const tryAbsoluteURL = mod.tryAbsoluteURL;

package/internals/stagehand-controller.js

@@ -1,10 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StagehandController = void 0;
-const tslib_1 = require("tslib");
 const browser_pool_1 = require("@crawlee/browser-pool");
+const core_1 = require("@crawlee/core");
 const utils_1 = require("@crawlee/utils");
-const log_1 = tslib_1.__importDefault(require("@apify/log"));
 /**
  * StagehandController manages the lifecycle of a Stagehand-controlled browser for Crawlee's BrowserPool.
  *
@@ -19,20 +18,10 @@ const log_1 = tslib_1.__importDefault(require("@apify/log"));
  * @ignore
  */
 class StagehandController extends browser_pool_1.BrowserController {
+    stagehand = null;
+    stagehandInstances;
     constructor(browserPlugin, stagehandInstances) {
         super(browserPlugin);
-        Object.defineProperty(this, "stagehand", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "stagehandInstances", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.stagehandInstances = stagehandInstances;
     }
     /**
@@ -88,7 +77,7 @@ 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 = 10000) {
+    async waitForStagehandToRegisterPage(page, timeoutMs = 10_000) {
         const stagehand = this.getStagehand();
         const mainFrameId = await this.getMainFrameId(page);
         const deadline = Date.now() + timeoutMs;
@@ -170,7 +159,7 @@ class StagehandController extends browser_pool_1.BrowserController {
             await stagehand.close();
         }
         catch (error) {
-            log_1.default.error('Error closing Stagehand', { error });
+            core_1.serviceLocator.getLogger().error('Error closing Stagehand', { error });
         }
     }
     /**

package/internals/stagehand-crawler.d.ts

@@ -1,11 +1,10 @@
 import type { Action, ActOptions, ActResult, AgentConfig, ExtractOptions, LLMClient, ModelConfiguration, NonStreamingAgentInstance, ObserveOptions, Stagehand, StreamingAgentInstance } from '@browserbasehq/stagehand';
-import type { BrowserCrawlerOptions, BrowserCrawlingContext, BrowserHook, BrowserRequestHandler, GetUserDataFromRequest, LoadedContext, RouterHandler, RouterRoutes, RouteSchemas, RoutesFromSchemas } from '@crawlee/browser';
-import { BrowserCrawler, Configuration } from '@crawlee/browser';
+import type { BrowserCrawlerOptions, BrowserCrawlingContext, BrowserHook, ContextPipeline, CrawlingContext, GetUserDataFromRequest, LoadedContext, RequestHandler, RouterHandler, RouterRoutes, RouteSchemas, RoutesFromSchemas } from '@crawlee/browser';
+import { BrowserCrawler } from '@crawlee/browser';
 import type { Dictionary } from '@crawlee/types';
 // @ts-ignore optional peer dependency or compatibility with es2022
 import type { LaunchOptions, Page, Response } from 'playwright';
 import type { z } from 'zod';
-import type { StagehandController } from './stagehand-controller';
 import type { StagehandLaunchContext } from './stagehand-launcher';
 import type { StagehandPlugin } from './stagehand-plugin';
 /**
@@ -133,7 +132,7 @@ export interface StagehandPage extends Page {
      * );
      * ```
      */
-    extract<T>(instruction: string, schema: z.ZodSchema<T>, options?: Omit<ExtractOptions, 'page'>): Promise<T>;
+    extract<T>(instruction: string, schema: z.ZodType<T>, options?: Omit<ExtractOptions, 'page'>): Promise<T>;
     /**
      * Observe the page and get AI-suggested actions.
      *
@@ -169,7 +168,11 @@ export interface StagehandPage extends Page {
 /**
  * Crawling context for StagehandCrawler with enhanced page object.
  */
-export interface StagehandCrawlingContext<UserData extends Dictionary = Dictionary> extends BrowserCrawlingContext<StagehandCrawler, StagehandPage, Response, StagehandController, UserData> {
+/**
+ * Goto options for StagehandCrawler navigation.
+ */
+export type StagehandGotoOptions = NonNullable<Parameters<Page['goto']>[1]>;
+export interface StagehandCrawlingContext<UserData extends Dictionary = Dictionary> extends BrowserCrawlingContext<StagehandPage, Response, UserData, StagehandGotoOptions> {
     /**
      * Enhanced Playwright page with Stagehand AI methods.
      * Use page.act(), page.extract(), page.observe(), page.agent() for AI-powered operations.
@@ -184,23 +187,19 @@ export interface StagehandCrawlingContext<UserData extends Dictionary = Dictiona
 /**
  * Hook function for StagehandCrawler.
  */
-export interface StagehandHook extends BrowserHook<StagehandCrawlingContext, StagehandGotoOptions> {
+export interface StagehandHook extends BrowserHook<StagehandCrawlingContext> {
 }
 /**
  * Request handler for StagehandCrawler.
  */
-export interface StagehandRequestHandler extends BrowserRequestHandler<LoadedContext<StagehandCrawlingContext>> {
+export interface StagehandRequestHandler extends RequestHandler<LoadedContext<StagehandCrawlingContext>> {
 }
-/**
- * Goto options for StagehandCrawler navigation.
- */
-export type StagehandGotoOptions = Dictionary & Parameters<Page['goto']>[1];
 /**
  * Options for StagehandCrawler.
  */
-export interface StagehandCrawlerOptions extends BrowserCrawlerOptions<StagehandCrawlingContext, {
+export interface StagehandCrawlerOptions<ContextExtension = Dictionary<never>, ExtendedContext extends StagehandCrawlingContext = StagehandCrawlingContext & ContextExtension, Routes extends Record<keyof Routes, Dictionary> = Record<string, GetUserDataFromRequest<StagehandCrawlingContext['request']>>> extends BrowserCrawlerOptions<StagehandPage, Response, StagehandCrawlingContext, ContextExtension, ExtendedContext, {
     browserPlugins: [StagehandPlugin];
-}> {
+}, Routes> {
     /**
      * Stagehand-specific configuration options.
      * These options configure the AI behavior and Browserbase integration.
@@ -216,7 +215,6 @@ export interface StagehandCrawlerOptions extends BrowserCrawlerOptions<Stagehand
      * The function receives the {@link StagehandCrawlingContext} as an argument, where:
      * - `request` is an instance of the {@link Request} object with details about the URL to open, HTTP method etc.
      * - `page` is an enhanced Playwright [`Page`](https://playwright.dev/docs/api/class-page) with AI methods
-     * - `browserController` is an instance of {@link StagehandController}
      * - `response` is the main resource response as returned by `page.goto(request.url)`
      * - `stagehand` is the Stagehand instance for advanced control
      *
@@ -255,11 +253,7 @@ export interface StagehandCrawlerOptions extends BrowserCrawlerOptions<Stagehand
      * }
      * ```
      */
-    requestHandler?: StagehandRequestHandler;
-    /**
-     * Function called when request handling fails after all retries.
-     */
-    failedRequestHandler?: StagehandRequestHandler;
+    requestHandler?: RouterHandler<ExtendedContext, Routes> | RequestHandler<ExtendedContext>;
     /**
      * Async functions that are sequentially evaluated before the navigation.
      */
@@ -318,17 +312,14 @@ export interface StagehandCrawlerOptions extends BrowserCrawlerOptions<Stagehand
  * await crawler.run(['https://example.com']);
  * ```
  */
-export declare class StagehandCrawler extends BrowserCrawler<{
+export declare class StagehandCrawler<ContextExtension = Dictionary<never>, ExtendedContext extends StagehandCrawlingContext = StagehandCrawlingContext & ContextExtension, Routes extends Record<keyof Routes, Dictionary> = Record<string, GetUserDataFromRequest<StagehandCrawlingContext['request']>>> extends BrowserCrawler<StagehandPage, Response, {
     browserPlugins: [StagehandPlugin];
-}, LaunchOptions, StagehandCrawlingContext> {
-    readonly config: Configuration;
+}, LaunchOptions, StagehandCrawlingContext, ContextExtension, ExtendedContext, Routes> {
     protected static optionsShape: {
 // @ts-ignore optional peer dependency or compatibility with es2022
-        stagehandOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        browserPoolOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        stagehandOptions: import("ow", { with: { "resolution-mode": "import" } }).ObjectPredicate<object> & import("ow", { with: { "resolution-mode": "import" } }).BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        handlePageFunction: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
+        browserPoolOptions: import("ow", { with: { "resolution-mode": "import" } }).ObjectPredicate<object> & import("ow", { with: { "resolution-mode": "import" } }).BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         navigationTimeoutSecs: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -340,51 +331,53 @@ export declare class StagehandCrawler extends BrowserCrawler<{
 // @ts-ignore optional peer dependency or compatibility with es2022
         headless: import("ow").AnyPredicate<string | boolean>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        sessionPoolOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        browserPool: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        persistCookiesPerSession: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        remoteBrowser: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        useSessionPool: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        saveResponseCookies: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         proxyConfiguration: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        ignoreShadowRoots: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        contextPipelineBuilder: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        ignoreIframes: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        extendContext: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         requestList: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         requestQueue: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         requestHandler: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        handleRequestFunction: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         requestHandlerTimeoutSecs: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        handleRequestTimeoutSecs: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         errorHandler: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         failedRequestHandler: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        handleFailedRequestFunction: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         maxRequestRetries: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         sameDomainDelaySecs: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        maxSessionRotations: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         maxRequestsPerCrawl: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         maxCrawlDepth: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        autoscaledPoolOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        taskLoopOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        concurrencySystem: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        sessionPool: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         statusMessageLoggingInterval: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         statusMessageCallback: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        additionalHttpErrorStatusCodes: import("ow").ArrayPredicate<number>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        ignoreHttpErrorStatusCodes: import("ow").ArrayPredicate<number>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        blockedStatusCodes: import("ow").ArrayPredicate<number>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         retryOnBlocked: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -393,6 +386,14 @@ export declare class StagehandCrawler extends BrowserCrawler<{
         onSkippedRequest: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         httpClient: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        configuration: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        storageBackend: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        eventManager: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        logger: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         minConcurrency: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -401,36 +402,32 @@ export declare class StagehandCrawler extends BrowserCrawler<{
         maxRequestsPerMinute: import("ow").NumberPredicate & import("ow").BasePredicate<number | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         keepAlive: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        log: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        experiments: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         statisticsOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        id: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
     };
-    /** Set while `_runRequestHandler` has swapped `userProvidedRequestHandler` for its page-enhancing wrapper. */
-    private unwrappedRequestHandler?;
-    protected get userRequestHandler(): BrowserRequestHandler<StagehandCrawlingContext>;
     /**
      * Creates a new instance of StagehandCrawler.
      *
      * @param options - Crawler configuration options
      */
-    constructor(options?: StagehandCrawlerOptions, config?: Configuration);
+    constructor(options?: StagehandCrawlerOptions<ContextExtension, ExtendedContext, Routes>);
+    protected buildContextPipeline(): ContextPipeline<CrawlingContext, StagehandCrawlingContext>;
     /**
-     * Overrides the request handler to enhance the page with Stagehand AI methods.
+     * 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).
      *
-     * The pattern here is:
-     * 1. Store the original userProvidedRequestHandler
-     * 2. Replace it with a wrapper that enhances the page first
-     * 3. Call super (which creates page/browserController, then calls our wrapper)
-     * 4. Our wrapper enhances the page and calls the original handler
-     * 5. Restore the original handler
-     *
-     * This is similar to how PlaywrightCrawler adds utility methods via registerUtilsToContext,
-     * but we need to actually transform the page object to add Stagehand AI methods.
+     * 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.
      */
-    protected _runRequestHandler(crawlingContext: StagehandCrawlingContext): Promise<void>;
+    private setUpStagehand;
     /**
      * Navigation handler for Stagehand crawler.
      * Uses standard Playwright navigation.
@@ -453,7 +450,7 @@ export declare class StagehandCrawler extends BrowserCrawler<{
  * });
  *
  * router.addDefaultHandler(async ({ page, enqueueLinks }) => {
- *   await enqueueLinks({ globs: ['https://example.com/products/*'] });
+ *   await enqueueLinks({ include: ['https://example.com/products/*'] });
  * });
  *
  * const crawler = new StagehandCrawler({

package/internals/stagehand-crawler.js

@@ -57,86 +57,67 @@ const stagehand_utils_1 = require("./utils/stagehand-utils");
  * ```
  */
 class StagehandCrawler extends browser_1.BrowserCrawler {
-    get userRequestHandler() {
-        return this.unwrappedRequestHandler ?? super.userRequestHandler;
-    }
+    static optionsShape = {
+        ...browser_1.BrowserCrawler.optionsShape,
+        stagehandOptions: ow_1.default.optional.object,
+        browserPoolOptions: ow_1.default.optional.object,
+    };
     /**
      * Creates a new instance of StagehandCrawler.
      *
      * @param options - Crawler configuration options
      */
-    constructor(options = {}, config = browser_1.Configuration.getGlobalConfig()) {
-        const { stagehandOptions = {}, launchContext = {}, browserPoolOptions = {}, ...browserCrawlerOptions } = options;
-        // Validate options
+    constructor(options = {}) {
         (0, ow_1.default)(options, 'StagehandCrawlerOptions', ow_1.default.object.exactShape(StagehandCrawler.optionsShape));
+        const { stagehandOptions = {}, launchContext = {}, contextPipelineBuilder, ...browserCrawlerOptions } = options;
+        const browserPoolOptions = {
+            ...options.browserPoolOptions,
+        };
         // Create launcher with Stagehand plugin
         const launcher = new stagehand_launcher_1.StagehandLauncher({
             ...launchContext,
             stagehandOptions,
-        }, config);
+        });
+        browserPoolOptions.browserPlugins = [launcher.createBrowserPlugin()];
         // Initialize BrowserCrawler with Stagehand plugin and fingerprinting enabled
         super({
             ...browserCrawlerOptions,
             launchContext,
-            browserPoolOptions: {
-                ...browserPoolOptions,
-                browserPlugins: [launcher.createBrowserPlugin()],
-                // Enable fingerprinting by default for anti-blocking
-                useFingerprints: browserPoolOptions.useFingerprints ?? true,
-            },
-        }, config);
-        Object.defineProperty(this, "config", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: config
-        });
-        /** Set while `_runRequestHandler` has swapped `userProvidedRequestHandler` for its page-enhancing wrapper. */
-        Object.defineProperty(this, "unwrappedRequestHandler", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
+            browserPoolOptions,
+            contextPipelineBuilder: contextPipelineBuilder ?? (() => this.buildContextPipeline()),
         });
     }
+    buildContextPipeline() {
+        return super.buildContextPipeline().compose({ action: this.setUpStagehand.bind(this) });
+    }
     /**
-     * Overrides the request handler to enhance the page with Stagehand AI methods.
-     *
-     * The pattern here is:
-     * 1. Store the original userProvidedRequestHandler
-     * 2. Replace it with a wrapper that enhances the page first
-     * 3. Call super (which creates page/browserController, then calls our wrapper)
-     * 4. Our wrapper enhances the page and calls the original handler
-     * 5. Restore the original handler
+     * 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).
      *
-     * This is similar to how PlaywrightCrawler adds utility methods via registerUtilsToContext,
-     * but we need to actually transform the page object to add Stagehand AI methods.
+     * 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.
      */
-    async _runRequestHandler(crawlingContext) {
-        // Store the original handler (could be this.requestHandler or this.router)
-        const originalHandler = this.userProvidedRequestHandler;
-        // Keep `userRequestHandler` pointing at the unwrapped handler: the swap below is live while the user's
-        // handler runs, which is exactly when `context.addRequests`/`enqueueLinks` resolve router metadata.
-        this.unwrappedRequestHandler = originalHandler;
-        // Replace with a wrapper that enhances the page before calling the user's handler
-        this.userProvidedRequestHandler = async (ctx) => {
-            // Get Stagehand instance from controller
-            const stagehand = ctx.browserController.getStagehand();
-            ctx.stagehand = stagehand;
-            // Enhance page with AI methods (page.act(), page.extract(), etc.)
-            ctx.page = (0, stagehand_utils_1.enhancePageWithStagehand)(ctx.page, stagehand);
-            // Call the original user handler
-            return originalHandler(ctx);
-        };
-        try {
-            // Call parent - this creates the page and eventually calls our wrapped handler
-            await super._runRequestHandler(crawlingContext);
+    getBrowserControllerByPage(page) {
+        if ('getBrowserControllerByPage' in this.browserPool) {
+            return this.browserPool.getBrowserControllerByPage(page);
         }
-        finally {
-            // Restore original handler
-            this.userProvidedRequestHandler = originalHandler;
-            this.unwrappedRequestHandler = undefined;
+        return undefined;
+    }
+    /**
+     * Enhance the page with Stagehand AI methods.
+     */
+    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?');
         }
+        const stagehand = controller.getStagehand();
+        return {
+            stagehand,
+            page: (0, stagehand_utils_1.enhancePageWithStagehand)(crawlingContext.page, stagehand),
+        };
     }
     /**
      * Navigation handler for Stagehand crawler.
@@ -148,16 +129,6 @@ class StagehandCrawler extends browser_1.BrowserCrawler {
     }
 }
 exports.StagehandCrawler = StagehandCrawler;
-Object.defineProperty(StagehandCrawler, "optionsShape", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: {
-        ...browser_1.BrowserCrawler.optionsShape,
-        stagehandOptions: ow_1.default.optional.object,
-        browserPoolOptions: ow_1.default.optional.object,
-    }
-});
 function createStagehandRouter(routesOrSchemas) {
     return browser_1.Router.create(routesOrSchemas);
 }

package/internals/stagehand-launcher.d.ts

@@ -54,14 +54,14 @@ export interface StagehandLaunchContext extends BrowserLaunchContext<LaunchOptio
  * @ignore
  */
 export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin> {
-    readonly config: Configuration;
+    readonly configuration: Configuration;
     protected static optionsShape: {
 // @ts-ignore optional peer dependency or compatibility with es2022
-        launcher: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        launcher: import("ow", { with: { "resolution-mode": "import" } }).ObjectPredicate<object> & import("ow", { with: { "resolution-mode": "import" } }).BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        launchContextOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        launchContextOptions: import("ow", { with: { "resolution-mode": "import" } }).ObjectPredicate<object> & import("ow", { with: { "resolution-mode": "import" } }).BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
-        stagehandOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        stagehandOptions: import("ow", { with: { "resolution-mode": "import" } }).ObjectPredicate<object> & import("ow", { with: { "resolution-mode": "import" } }).BasePredicate<object | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         proxyUrl: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -70,8 +70,6 @@ export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin>
         useIncognitoPages: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         browserPerProxy: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
-// @ts-ignore optional peer dependency or compatibility with es2022
-        experimentalContainers: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         ignoreProxyCertificate: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -85,7 +83,7 @@ export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin>
     /**
      * All StagehandLauncher parameters are passed via the launchContext object.
      */
-    constructor(launchContext?: StagehandLaunchContext, config?: Configuration);
+    constructor(launchContext?: StagehandLaunchContext, configuration?: Configuration);
     /**
      * Creates a new StagehandPlugin instance with resolved options.
      */

package/internals/stagehand-launcher.js

@@ -12,10 +12,18 @@ const stagehand_plugin_1 = require("./stagehand-plugin");
  * @ignore
  */
 class StagehandLauncher extends browser_1.BrowserLauncher {
+    configuration;
+    static optionsShape = {
+        ...browser_1.BrowserLauncher.optionsShape,
+        launcher: ow_1.default.optional.object,
+        launchContextOptions: ow_1.default.optional.object,
+        stagehandOptions: ow_1.default.optional.object,
+    };
+    stagehandOptions;
     /**
      * All StagehandLauncher parameters are passed via the launchContext object.
      */
-    constructor(launchContext = {}, config = browser_1.Configuration.getGlobalConfig()) {
+    constructor(launchContext = {}, configuration = browser_1.Configuration.getGlobalConfiguration()) {
         (0, ow_1.default)(launchContext, 'StagehandLaunchContext', ow_1.default.object.exactShape(StagehandLauncher.optionsShape));
         const { launcher = browser_1.BrowserLauncher.requireLauncherOrThrow('playwright', 'apify/actor-node-playwright-*').chromium, stagehandOptions = {}, } = launchContext;
         const { launchOptions = {}, ...rest } = launchContext;
@@ -24,22 +32,11 @@ class StagehandLauncher extends browser_1.BrowserLauncher {
             ...rest,
             launchOptions: {
                 ...launchOptions,
-                executablePath: getDefaultExecutablePath(launchContext, config),
+                executablePath: getDefaultExecutablePath(launchContext, configuration),
             },
             launcher,
-        }, config);
-        Object.defineProperty(this, "config", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: config
-        });
-        Object.defineProperty(this, "stagehandOptions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+        }, configuration);
+        this.configuration = configuration;
         this.stagehandOptions = {
             env: 'LOCAL',
             model: 'openai/gpt-4.1-mini',
@@ -60,23 +57,12 @@ class StagehandLauncher extends browser_1.BrowserLauncher {
     }
 }
 exports.StagehandLauncher = StagehandLauncher;
-Object.defineProperty(StagehandLauncher, "optionsShape", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: {
-        ...browser_1.BrowserLauncher.optionsShape,
-        launcher: ow_1.default.optional.object,
-        launchContextOptions: ow_1.default.optional.object,
-        stagehandOptions: ow_1.default.optional.object,
-    }
-});
 /**
  * Gets the default executable path for the browser.
  * @ignore
  */
-function getDefaultExecutablePath(launchContext, config) {
-    const pathFromPlaywrightImage = config.get('defaultBrowserPath');
+function getDefaultExecutablePath(launchContext, configuration) {
+    const pathFromPlaywrightImage = configuration.defaultBrowserPath;
     const { launchOptions = {} } = launchContext;
     if (launchOptions.executablePath) {
         return launchOptions.executablePath;

package/internals/stagehand-plugin.d.ts

@@ -25,8 +25,6 @@ export interface StagehandPluginOptions extends BrowserPluginOptions<LaunchOptio
  * Limitations:
  * - Only Chromium is supported (Stagehand uses CDP)
  * - Some fingerprinting options may not be fully applied (Stagehand controls browser launch)
- *
- * @ignore
  */
 export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOptions, PlaywrightBrowser> {
     readonly stagehandOptions: StagehandOptions;
@@ -43,7 +41,7 @@ export declare class StagehandPlugin extends BrowserPlugin<BrowserType, LaunchOp
     /**
      * Creates a controller for the Stagehand browser.
      */
-    protected _createController(): BrowserController<BrowserType, LaunchOptions, PlaywrightBrowser>;
+    createController(): BrowserController<BrowserType, LaunchOptions, PlaywrightBrowser>;
     /**
      * Adds proxy configuration to launch options.
      */

package/internals/stagehand-plugin.js

@@ -1,12 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StagehandPlugin = void 0;
-const tslib_1 = require("tslib");
 const browser_pool_1 = require("@crawlee/browser-pool");
+const core_1 = require("@crawlee/core");
 // Stagehand is built on CDP (Chrome DevTools Protocol), which only works with Chromium-based browsers.
 // Firefox and WebKit are not supported by Stagehand.
 const playwright_1 = require("playwright");
-const log_1 = tslib_1.__importDefault(require("@apify/log"));
 const stagehand_controller_1 = require("./stagehand-controller");
 /**
  * StagehandPlugin integrates Stagehand with Crawlee's BrowserPool.
@@ -20,24 +19,12 @@ const stagehand_controller_1 = require("./stagehand-controller");
  * Limitations:
  * - Only Chromium is supported (Stagehand uses CDP)
  * - Some fingerprinting options may not be fully applied (Stagehand controls browser launch)
- *
- * @ignore
  */
 class StagehandPlugin extends browser_pool_1.BrowserPlugin {
+    stagehandOptions;
+    stagehandInstances = new WeakMap();
     constructor(library, options = {}) {
         super(library, options);
-        Object.defineProperty(this, "stagehandOptions", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "stagehandInstances", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new WeakMap()
-        });
         this.stagehandOptions = options.stagehandOptions ?? {};
     }
     /**
@@ -102,7 +89,7 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
             await stagehand.close().catch(() => { });
             await closeAnonymizedProxy();
             const augmentedError = this._augmentLaunchError(error, launchContext);
-            log_1.default.error('Stagehand browser launch failed', { message: augmentedError.message });
+            core_1.serviceLocator.getLogger().error('Stagehand browser launch failed', { message: augmentedError.message });
             throw augmentedError;
         }
     }
@@ -124,14 +111,14 @@ class StagehandPlugin extends browser_pool_1.BrowserPlugin {
     /**
      * Creates a controller for the Stagehand browser.
      */
-    _createController() {
+    createController() {
         return new stagehand_controller_1.StagehandController(this, this.stagehandInstances);
     }
     /**
      * Adds proxy configuration to launch options.
      */
     async _addProxyToLaunchOptions(launchContext) {
-        launchContext.launchOptions ?? (launchContext.launchOptions = {});
+        launchContext.launchOptions ??= {};
         const { launchOptions, proxyUrl } = launchContext;
         if (proxyUrl) {
             const url = new URL(proxyUrl);

package/package.json

@@ -1,9 +1,9 @@
 {
     "name": "@crawlee/stagehand",
-    "version": "3.18.0",
+    "version": "4.0.0-beta.100",
     "description": "AI-powered web crawling with Stagehand integration for Crawlee - enables natural language browser automation with act(), extract(), and observe() methods.",
     "engines": {
-        "node": ">=16.0.0"
+        "node": ">=22.0.0"
     },
     "main": "./index.js",
     "module": "./index.mjs",
@@ -47,7 +47,7 @@
     },
     "homepage": "https://crawlee.dev",
     "scripts": {
-        "build": "yarn clean && yarn compile && yarn copy",
+        "build": "pnpm clean && pnpm compile && pnpm copy",
         "clean": "rimraf ./dist",
         "compile": "tsc -p tsconfig.build.json && gen-esm-wrapper ./index.js ./index.mjs",
         "copy": "tsx ../../scripts/copy.ts"
@@ -56,15 +56,14 @@
         "access": "public"
     },
     "dependencies": {
-        "@apify/log": "^2.4.0",
-        "@apify/timeout": "^0.4.0",
-        "@crawlee/browser": "3.18.0",
-        "@crawlee/browser-pool": "3.18.0",
-        "@crawlee/core": "3.18.0",
-        "@crawlee/types": "3.18.0",
-        "@crawlee/utils": "3.18.0",
-        "ow": "^0.28.1",
-        "tslib": "^2.4.0"
+        "@apify/timeout": "^0.4.4",
+        "@crawlee/browser": "4.0.0-beta.100",
+        "@crawlee/browser-pool": "4.0.0-beta.100",
+        "@crawlee/core": "4.0.0-beta.100",
+        "@crawlee/types": "4.0.0-beta.100",
+        "@crawlee/utils": "4.0.0-beta.100",
+        "ow": "^2.0.0",
+        "tslib": "^2.8.1"
     },
     "peerDependencies": {
         "@browserbasehq/stagehand": "^3.0.0",
@@ -94,5 +93,5 @@
             }
         }
     },
-    "gitHead": "49c115e1ce3b3fbf2bef61f16bffeadfdcf5bd19"
+    "gitHead": "109b4c2097f7b9a26bfe761b3c9969dd626f8e38"
 }