@crawlee/stagehand 4.0.0-beta.104 → 4.0.0-beta.106

package/index.mjs

@@ -53,7 +53,6 @@ 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 RequestManagerTandem = mod.RequestManagerTandem;
 export const RequestQueue = mod.RequestQueue;
@@ -75,13 +74,14 @@ export const StagehandCrawler = mod.StagehandCrawler;
 export const Statistics = mod.Statistics;
 export const StorageInstanceManager = mod.StorageInstanceManager;
 export const StorageStatsTracker = mod.StorageStatsTracker;
+export const StorageTransaction = mod.StorageTransaction;
 export const SystemStatus = mod.SystemStatus;
+export const activeStorageTransaction = mod.activeStorageTransaction;
 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 checkStorageAccess = mod.checkStorageAccess;
 export const coerceBoolean = mod.coerceBoolean;
 export const coerceNumber = mod.coerceNumber;
 export const constructGlobObjectsFromGlobs = mod.constructGlobObjectsFromGlobs;
@@ -95,6 +95,8 @@ export const createDualIterable = mod.createDualIterable;
 export const createRequestDebugInfo = mod.createRequestDebugInfo;
 export const createRequestOptions = mod.createRequestOptions;
 export const createStagehandRouter = mod.createStagehandRouter;
+export const createStorageTransaction = mod.createStorageTransaction;
+export const currentStorageTransaction = mod.currentStorageTransaction;
 export const defaultRoute = mod.defaultRoute;
 export const deserializeArray = mod.deserializeArray;
 export const enqueueLinks = mod.enqueueLinks;
@@ -110,14 +112,17 @@ export const inspectValue = mod.inspectValue;
 export const log = mod.log;
 export const mergeCookies = mod.mergeCookies;
 export const navigationDeadlineKey = mod.navigationDeadlineKey;
+export const operationRejectedInTransaction = mod.operationRejectedInTransaction;
 export const parseValue = mod.parseValue;
 export const purgeDefaultStorages = mod.purgeDefaultStorages;
+export const rejectOperationInTransaction = mod.rejectOperationInTransaction;
 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 snapshotValue = mod.snapshotValue;
 export const stagehandUtils = mod.stagehandUtils;
 export const toughCookieToBrowserPoolCookie = mod.toughCookieToBrowserPoolCookie;
 export const tryAbsoluteURL = mod.tryAbsoluteURL;
@@ -126,4 +131,5 @@ export const useState = mod.useState;
 export const validateGlobPattern = mod.validateGlobPattern;
 export const validateUserData = mod.validateUserData;
 export const validators = mod.validators;
-export const withCheckedStorageAccess = mod.withCheckedStorageAccess;
+export const withDirectStorageAccess = mod.withDirectStorageAccess;
+export const withStorageTransaction = mod.withStorageTransaction;

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

@@ -381,6 +381,8 @@ export declare class StagehandCrawler<ContextExtension = Dictionary<never>, Exte
         retryOnBlocked: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         respectRobotsTxtFile: import("ow").AnyPredicate<boolean | object>;
+// @ts-ignore optional peer dependency or compatibility with es2022
+        transactionalStorage: import("ow").BasePredicate<boolean | Partial<import("@crawlee/browser").StorageWritePolicy> | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
         onSkippedRequest: import("ow").Predicate<Function> & import("ow").BasePredicate<Function | undefined>;
 // @ts-ignore optional peer dependency or compatibility with es2022
@@ -431,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.104",
+    "version": "4.0.0-beta.106",
     "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.104",
-        "@crawlee/browser-pool": "4.0.0-beta.104",
-        "@crawlee/core": "4.0.0-beta.104",
-        "@crawlee/types": "4.0.0-beta.104",
-        "@crawlee/utils": "4.0.0-beta.104",
+        "@crawlee/browser": "4.0.0-beta.106",
+        "@crawlee/browser-pool": "4.0.0-beta.106",
+        "@crawlee/core": "4.0.0-beta.106",
+        "@crawlee/types": "4.0.0-beta.106",
+        "@crawlee/utils": "4.0.0-beta.106",
         "ow": "^2.0.0",
         "tslib": "^2.8.1"
     },
@@ -93,5 +93,5 @@
             }
         }
     },
-    "gitHead": "1c761e689e56ac06b67fc4f1dc091f693e024d12"
+    "gitHead": "c622f1fc65e65221ea245817c58ecc0ffb4a5cb0"
 }