@crawlee/stagehand 3.15.4-beta.39

package/internals/stagehand-crawler.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StagehandCrawler = void 0;
+exports.createStagehandRouter = createStagehandRouter;
+const tslib_1 = require("tslib");
+const browser_1 = require("@crawlee/browser");
+const ow_1 = tslib_1.__importDefault(require("ow"));
+const stagehand_launcher_1 = require("./stagehand-launcher");
+const stagehand_utils_1 = require("./utils/stagehand-utils");
+/**
+ * StagehandCrawler provides AI-powered web crawling using Browserbase's Stagehand library.
+ *
+ * It extends {@apilink BrowserCrawler} and adds natural language interaction capabilities:
+ * - `page.act()` - Perform actions using natural language
+ * - `page.extract()` - Extract structured data with AI
+ * - `page.observe()` - Get AI-suggested actions
+ * - `page.agent()` - Create autonomous agents for complex workflows
+ *
+ * The crawler automatically applies anti-blocking features including browser fingerprinting,
+ * making it suitable for crawling sites with bot protection like Cloudflare.
+ *
+ * @example
+ * ```typescript
+ * import { StagehandCrawler } from '@crawlee/stagehand';
+ * import { z } from 'zod';
+ *
+ * const crawler = new StagehandCrawler({
+ *   stagehandOptions: {
+ *     env: 'LOCAL',
+ *     model: 'openai/gpt-4.1-mini',
+ *     verbose: 1,
+ *   },
+ *   maxConcurrency: 3,
+ *   async requestHandler({ page, request, log }) {
+ *     log.info(`Crawling ${request.url}`);
+ *
+ *     // Use AI to interact with the page
+ *     await page.act('Click the Products link');
+ *     await page.act('Scroll to load more items');
+ *
+ *     // Extract structured data
+ *     const products = await page.extract(
+ *       'Get all product names and prices',
+ *       z.object({
+ *         items: z.array(z.object({
+ *           name: z.string(),
+ *           price: z.number(),
+ *         })),
+ *       })
+ *     );
+ *
+ *     log.info(`Found ${products.items.length} products`);
+ *   },
+ * });
+ *
+ * await crawler.run(['https://example.com']);
+ * ```
+ */
+class StagehandCrawler extends browser_1.BrowserCrawler {
+    /**
+     * 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
+        (0, ow_1.default)(options, 'StagehandCrawlerOptions', ow_1.default.object.exactShape(StagehandCrawler.optionsShape));
+        // Create launcher with Stagehand plugin
+        const launcher = new stagehand_launcher_1.StagehandLauncher({
+            ...launchContext,
+            stagehandOptions,
+        }, config);
+        // 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
+        });
+    }
+    /**
+     * 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
+     *
+     * 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.
+     */
+    async _runRequestHandler(crawlingContext) {
+        // Store the original handler (could be this.requestHandler or this.router)
+        const originalHandler = this.userProvidedRequestHandler;
+        // 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);
+        }
+        finally {
+            // Restore original handler
+            this.userProvidedRequestHandler = originalHandler;
+        }
+    }
+    /**
+     * Navigation handler for Stagehand crawler.
+     * Uses standard Playwright navigation.
+     */
+    async _navigationHandler(crawlingContext, gotoOptions) {
+        // Use standard page.goto for navigation
+        return crawlingContext.page.goto(crawlingContext.request.url, gotoOptions);
+    }
+}
+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,
+    }
+});
+/**
+ * Creates a new router for StagehandCrawler with type-safe route handlers.
+ *
+ * @param options - Router options
+ * @returns Configured router instance
+ *
+ * @example
+ * ```typescript
+ * const router = createStagehandRouter();
+ *
+ * router.addHandler('product', async ({ page, request, log }) => {
+ *   log.info(`Processing product: ${request.url}`);
+ *   const data = await page.extract('Get product info', schema);
+ * });
+ *
+ * router.addDefaultHandler(async ({ page, enqueueLinks }) => {
+ *   await enqueueLinks({ globs: ['https://example.com/products/*'] });
+ * });
+ *
+ * const crawler = new StagehandCrawler({
+ *   requestHandler: router,
+ * });
+ * ```
+ */
+function createStagehandRouter(routes) {
+    return browser_1.Router.create(routes);
+}
+//# sourceMappingURL=stagehand-crawler.js.map

package/internals/stagehand-crawler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-crawler.js","sourceRoot":"","sources":["../../src/internals/stagehand-crawler.ts"],"names":[],"mappings":";;;AA+eA,sDAKC;;AA9dD,8CAAyE;AAEzE,oDAAoB;AAMpB,6DAAyD;AAEzD,6DAAmE;AA2RnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAa,gBAAiB,SAAQ,wBAIrC;IAOG;;;;OAIG;IACH,YACI,UAAmC,EAAE,EACnB,SAAS,uBAAa,CAAC,eAAe,EAAE;QAE1D,MAAM,EACF,gBAAgB,GAAG,EAAE,EACrB,aAAa,GAAG,EAAE,EAClB,kBAAkB,GAAG,EAAE,EACvB,GAAG,qBAAqB,EAC3B,GAAG,OAAO,CAAC;QAEZ,mBAAmB;QACnB,IAAA,YAAE,EAAC,OAAO,EAAE,yBAAyB,EAAE,YAAE,CAAC,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;QAE5F,wCAAwC;QACxC,MAAM,QAAQ,GAAG,IAAI,sCAAiB,CAClC;YACI,GAAG,aAAa;YAChB,gBAAgB;SACnB,EACD,MAAM,CACT,CAAC;QAEF,6EAA6E;QAC7E,KAAK,CACD;YACI,GAAG,qBAAqB;YACxB,aAAa;YACb,kBAAkB,EAAE;gBAChB,GAAG,kBAAkB;gBACrB,cAAc,EAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;gBAChD,qDAAqD;gBACrD,eAAe,EAAE,kBAAkB,CAAC,eAAe,IAAI,IAAI;aAC9D;SACJ,EACD,MAAM,CACT,CAAC;QAlCF;;;;mBAAkB,MAAM;WAAkC;IAmC9D,CAAC;IAED;;;;;;;;;;;;OAYG;IACgB,KAAK,CAAC,kBAAkB,CAAC,eAAyC;QACjF,2EAA2E;QAC3E,MAAM,eAAe,GAAG,IAAI,CAAC,0BAA2B,CAAC;QAEzD,kFAAkF;QAClF,IAAI,CAAC,0BAA0B,GAAG,KAAK,EAAE,GAAQ,EAAE,EAAE;YACjD,yCAAyC;YACzC,MAAM,SAAS,GAAI,GAAG,CAAC,iBAAyC,CAAC,YAAY,EAAE,CAAC;YAChF,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;YAE1B,kEAAkE;YAClE,GAAG,CAAC,IAAI,GAAG,IAAA,0CAAwB,EAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAkB,CAAC;YAE1E,iCAAiC;YACjC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC,CAAC;QAEF,IAAI,CAAC;YACD,+EAA+E;YAC/E,MAAM,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACpD,CAAC;gBAAS,CAAC;YACP,2BAA2B;YAC3B,IAAI,CAAC,0BAA0B,GAAG,eAAe,CAAC;QACtD,CAAC;IACL,CAAC;IAED;;;OAGG;IACgB,KAAK,CAAC,kBAAkB,CACvC,eAAyC,EACzC,WAAiC;QAEjC,wCAAwC;QACxC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/E,CAAC;;AAxGL,4CAyGC;AApG6B;;;;WAAe;QACrC,GAAG,wBAAc,CAAC,YAAY;QAC9B,gBAAgB,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;QACpC,kBAAkB,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;KACzC;EAJqC,CAIpC;AAkGN;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,qBAAqB,CAGnC,MAAwC;IACtC,OAAO,gBAAM,CAAC,MAAM,CAAU,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/internals/stagehand-launcher.d.ts

@@ -0,0 +1,80 @@
+import type { BrowserLaunchContext } from '@crawlee/browser';
+import { BrowserLauncher, Configuration } from '@crawlee/browser';
+import type { BrowserType, LaunchOptions } from 'playwright';
+import type { StagehandOptions } from './stagehand-crawler';
+import { StagehandPlugin } from './stagehand-plugin';
+/**
+ * Launch context for Stagehand crawler with AI-specific options.
+ */
+export interface StagehandLaunchContext extends BrowserLaunchContext<LaunchOptions, BrowserType> {
+    /**
+     * Playwright launch options.
+     * These will be passed to Stagehand's localBrowserLaunchOptions after fingerprinting is applied.
+     */
+    launchOptions?: LaunchOptions & Parameters<BrowserType['launchPersistentContext']>[1];
+    /**
+     * Stagehand-specific configuration for AI operations.
+     */
+    stagehandOptions?: StagehandOptions;
+    /**
+     * URL to a HTTP proxy server. It must define the port number,
+     * and it may also contain proxy username and password.
+     *
+     * Example: `http://bob:pass123@proxy.example.com:1234`.
+     */
+    proxyUrl?: string;
+    /**
+     * If `true` and `executablePath` is not set,
+     * Playwright will launch full Google Chrome browser available on the machine
+     * rather than the bundled Chromium.
+     * @default false
+     */
+    useChrome?: boolean;
+    /**
+     * With this option selected, all pages will be opened in a new incognito browser context.
+     * @default false
+     */
+    useIncognitoPages?: boolean;
+    /**
+     * Sets the User Data Directory path.
+     * The user data directory contains profile data such as history, bookmarks, and cookies.
+     */
+    userDataDir?: string;
+    /**
+     * By default this function uses `require("playwright").chromium`.
+     * If you want to use a different browser you can pass it by this property.
+     */
+    launcher?: BrowserType;
+}
+/**
+ * StagehandLauncher is based on BrowserLauncher and creates StagehandPlugin instances.
+ * It manages the lifecycle of Stagehand browsers with fingerprinting and anti-blocking features.
+ *
+ * @ignore
+ */
+export declare class StagehandLauncher extends BrowserLauncher<StagehandPlugin> {
+    readonly config: Configuration;
+    protected static optionsShape: {
+        launcher: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        launchContextOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        stagehandOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        proxyUrl: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
+        useChrome: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        useIncognitoPages: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        browserPerProxy: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        experimentalContainers: import("ow").BooleanPredicate & import("ow").BasePredicate<boolean | undefined>;
+        userDataDir: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
+        launchOptions: import("ow").ObjectPredicate<object> & import("ow").BasePredicate<object | undefined>;
+        userAgent: import("ow").StringPredicate & import("ow").BasePredicate<string | undefined>;
+    };
+    private readonly stagehandOptions;
+    /**
+     * All StagehandLauncher parameters are passed via the launchContext object.
+     */
+    constructor(launchContext?: StagehandLaunchContext, config?: Configuration);
+    /**
+     * Creates a new StagehandPlugin instance with resolved options.
+     */
+    createBrowserPlugin(): StagehandPlugin;
+}
+//# sourceMappingURL=stagehand-launcher.d.ts.map

package/internals/stagehand-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-launcher.d.ts","sourceRoot":"","sources":["../../src/internals/stagehand-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB,CAAC,aAAa,EAAE,WAAW,CAAC;IAC5F;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtF;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,eAAe,CAAC,eAAe,CAAC;aAe7C,MAAM;IAd5B,iBAA0B,YAAY;;;;;;;;;;;;MAKpC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD;;OAEG;gBAEC,aAAa,GAAE,sBAA2B,EACxB,MAAM,gBAAkC;IAoC9D;;OAEG;IACM,mBAAmB,IAAI,eAAe;CAQlD"}

package/internals/stagehand-launcher.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StagehandLauncher = void 0;
+const tslib_1 = require("tslib");
+const browser_1 = require("@crawlee/browser");
+const ow_1 = tslib_1.__importDefault(require("ow"));
+const stagehand_plugin_1 = require("./stagehand-plugin");
+/**
+ * StagehandLauncher is based on BrowserLauncher and creates StagehandPlugin instances.
+ * It manages the lifecycle of Stagehand browsers with fingerprinting and anti-blocking features.
+ *
+ * @ignore
+ */
+class StagehandLauncher extends browser_1.BrowserLauncher {
+    /**
+     * All StagehandLauncher parameters are passed via the launchContext object.
+     */
+    constructor(launchContext = {}, config = browser_1.Configuration.getGlobalConfig()) {
+        (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;
+        // Call super first before initializing properties
+        super({
+            ...rest,
+            launchOptions: {
+                ...launchOptions,
+                executablePath: getDefaultExecutablePath(launchContext, config),
+            },
+            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
+        });
+        this.stagehandOptions = {
+            env: 'LOCAL',
+            model: 'openai/gpt-4.1-mini',
+            ...stagehandOptions,
+        };
+        this.Plugin = stagehand_plugin_1.StagehandPlugin;
+    }
+    /**
+     * Creates a new StagehandPlugin instance with resolved options.
+     */
+    createBrowserPlugin() {
+        return new stagehand_plugin_1.StagehandPlugin(this.launcher, {
+            ...this.otherLaunchContextProps,
+            proxyUrl: this.proxyUrl,
+            launchOptions: this.createLaunchOptions(),
+            stagehandOptions: this.stagehandOptions, // Set AFTER to override any unresolved options
+        });
+    }
+}
+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');
+    const { launchOptions = {} } = launchContext;
+    if (launchOptions.executablePath) {
+        return launchOptions.executablePath;
+    }
+    if (launchContext.useChrome) {
+        return undefined;
+    }
+    if (pathFromPlaywrightImage) {
+        return pathFromPlaywrightImage;
+    }
+    return undefined;
+}
+//# sourceMappingURL=stagehand-launcher.js.map

package/internals/stagehand-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-launcher.js","sourceRoot":"","sources":["../../src/internals/stagehand-launcher.ts"],"names":[],"mappings":";;;;AACA,8CAAkE;AAClE,oDAAoB;AAIpB,yDAAqD;AAoDrD;;;;;GAKG;AACH,MAAa,iBAAkB,SAAQ,yBAAgC;IAUnE;;OAEG;IACH,YACI,gBAAwC,EAAE,EACxB,SAAS,uBAAa,CAAC,eAAe,EAAE;QAE1D,IAAA,YAAE,EAAC,aAAa,EAAE,wBAAwB,EAAE,YAAE,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC;QAElG,MAAM,EACF,QAAQ,GAAG,yBAAe,CAAC,sBAAsB,CAC7C,YAAY,EACZ,+BAA+B,CAClC,CAAC,QAAQ,EACV,gBAAgB,GAAG,EAAE,GACxB,GAAG,aAAa,CAAC;QAElB,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,aAAa,CAAC;QAEtD,kDAAkD;QAClD,KAAK,CACD;YACI,GAAG,IAAI;YACP,aAAa,EAAE;gBACX,GAAG,aAAa;gBAChB,cAAc,EAAE,wBAAwB,CAAC,aAAa,EAAE,MAAM,CAAC;aAClE;YACD,QAAQ;SACX,EACD,MAAM,CACT,CAAC;QAzBF;;;;mBAAkB,MAAM;WAAkC;QAP7C;;;;;WAAmC;QAkChD,IAAI,CAAC,gBAAgB,GAAG;YACpB,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,qBAAqB;YAC5B,GAAG,gBAAgB;SACtB,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,kCAAe,CAAC;IAClC,CAAC;IAED;;OAEG;IACM,mBAAmB;QACxB,OAAO,IAAI,kCAAe,CAAC,IAAI,CAAC,QAAuB,EAAE;YACrD,GAAG,IAAI,CAAC,uBAAuB;YAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,mBAAmB,EAAE;YACzC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,+CAA+C;SAC3F,CAAC,CAAC;IACP,CAAC;;AA7DL,8CA8DC;AA7D6B;;;;WAAe;QACrC,GAAG,yBAAe,CAAC,YAAY;QAC/B,QAAQ,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;QAC5B,oBAAoB,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;QACxC,gBAAgB,EAAE,YAAE,CAAC,QAAQ,CAAC,MAAM;KACvC;EALqC,CAKpC;AA0DN;;;GAGG;AACH,SAAS,wBAAwB,CAAC,aAAqC,EAAE,MAAqB;IAC1F,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjE,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,aAAa,CAAC;IAE7C,IAAI,aAAa,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,cAAc,CAAC;IACxC,CAAC;IAED,IAAI,aAAa,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,IAAI,uBAAuB,EAAE,CAAC;QAC1B,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/internals/stagehand-plugin.d.ts

@@ -0,0 +1,63 @@
+import type { Stagehand } from '@browserbasehq/stagehand';
+import type { BrowserController, BrowserPluginOptions, LaunchContext } from '@crawlee/browser-pool';
+import { BrowserPlugin } from '@crawlee/browser-pool';
+import type { Browser as PlaywrightBrowser, BrowserType, LaunchOptions } from 'playwright';
+import type { StagehandOptions } from './stagehand-crawler';
+/**
+ * Options for StagehandPlugin initialization.
+ */
+export interface StagehandPluginOptions extends BrowserPluginOptions<LaunchOptions> {
+    /**
+     * Stagehand-specific configuration options.
+     */
+    stagehandOptions?: StagehandOptions;
+}
+/**
+ * StagehandPlugin integrates Stagehand with Crawlee's BrowserPool.
+ *
+ * Architecture:
+ * - Stagehand launches and manages the browser
+ * - We connect Playwright to the same browser via CDP to get a compatible handle
+ * - AI operations (extract, act, observe) pass the specific page via the `page` option
+ *   for correct concurrent page support
+ *
+ * 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;
+    private readonly stagehandInstances;
+    constructor(library: BrowserType, options?: StagehandPluginOptions);
+    /**
+     * 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.
+     */
+    protected _createController(): BrowserController<BrowserType, LaunchOptions, PlaywrightBrowser>;
+    /**
+     * Adds proxy configuration to launch options.
+     */
+    protected _addProxyToLaunchOptions(launchContext: LaunchContext<BrowserType>): Promise<void>;
+    /**
+     * Determines if this is a Chromium-based browser.
+     */
+    protected _isChromiumBasedBrowser(): boolean;
+    /**
+     * Augments launch errors with helpful context.
+     */
+    private _augmentLaunchError;
+    /**
+     * Gets the Stagehand instance for a given browser.
+     */
+    getStagehandForBrowser(browser: PlaywrightBrowser): Stagehand | undefined;
+}
+//# sourceMappingURL=stagehand-plugin.d.ts.map

package/internals/stagehand-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-plugin.d.ts","sourceRoot":"","sources":["../../src/internals/stagehand-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAuB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,IAAI,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB,CAAC,aAAa,CAAC;IAC/E;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,SAAQ,aAAa,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,CAAC;IAC7F,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAwD;gBAE/E,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,sBAA2B;IAKtE;;OAEG;cACa,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6E9F;;OAEG;YACW,iBAAiB;IAY/B;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,iBAAiB,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,CAAC;IAI/F;;OAEG;cACa,wBAAwB,CAAC,aAAa,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlG;;OAEG;IACH,SAAS,CAAC,uBAAuB,IAAI,OAAO;IAK5C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,GAAG,SAAS;CAG5E"}

package/internals/stagehand-plugin.js

@@ -0,0 +1,181 @@
+"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");
+// 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.
+ *
+ * Architecture:
+ * - Stagehand launches and manages the browser
+ * - We connect Playwright to the same browser via CDP to get a compatible handle
+ * - AI operations (extract, act, observe) pass the specific page via the `page` option
+ *   for correct concurrent page support
+ *
+ * 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 {
+    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 ?? {};
+    }
+    /**
+     * Launches a browser using Stagehand and connects Playwright to it via CDP.
+     */
+    async _launch(launchContext) {
+        const { launchOptions = {}, proxyUrl } = launchContext;
+        // Import Stagehand dynamically to avoid peer dependency issues
+        const { Stagehand } = await import('@browserbasehq/stagehand');
+        const isLocal = this.stagehandOptions.env === 'LOCAL' || !this.stagehandOptions.env;
+        // Use anonymizeProxy to handle proxy authentication transparently
+        const [anonymizedProxyUrl, closeAnonymizedProxy] = await (0, browser_pool_1.anonymizeProxySugar)(proxyUrl);
+        // Build model configuration
+        // For LOCAL env, we merge apiKey into the model config since Stagehand expects it there
+        let modelConfig = this.stagehandOptions.model;
+        if (isLocal && this.stagehandOptions.apiKey) {
+            const modelName = typeof modelConfig === 'string' ? modelConfig : modelConfig?.modelName;
+            modelConfig = {
+                ...(typeof modelConfig === 'object' ? modelConfig : {}),
+                ...(modelName ? { modelName } : {}),
+                apiKey: this.stagehandOptions.apiKey,
+            };
+        }
+        // Build Stagehand configuration by spreading our options and adding launch options
+        const stagehandConfig = {
+            ...this.stagehandOptions,
+            env: this.stagehandOptions.env ?? 'LOCAL',
+            model: modelConfig,
+            localBrowserLaunchOptions: isLocal
+                ? {
+                    headless: launchOptions.headless,
+                    args: launchOptions.args,
+                    executablePath: launchOptions.executablePath,
+                    proxy: anonymizedProxyUrl ? { server: anonymizedProxyUrl } : launchOptions.proxy,
+                    viewport: launchOptions.viewport,
+                }
+                : undefined,
+        };
+        const stagehand = new Stagehand(stagehandConfig);
+        try {
+            // Initialize Stagehand (launches browser)
+            await stagehand.init();
+            // Get CDP URL and connect Playwright to the same browser
+            const cdpUrl = stagehand.connectURL();
+            if (!cdpUrl) {
+                throw new Error('Failed to get CDP URL from Stagehand');
+            }
+            const browser = await playwright_1.chromium.connectOverCDP(cdpUrl);
+            // Store the Stagehand instance for AI operations
+            this.stagehandInstances.set(browser, stagehand);
+            // Handle browser disconnection - cleanup both Stagehand and anonymized proxy
+            browser.on('disconnected', async () => {
+                await this._cleanupStagehand(browser);
+                await closeAnonymizedProxy();
+            });
+            return browser;
+        }
+        catch (error) {
+            // Clean up on failure
+            await stagehand.close().catch(() => { });
+            await closeAnonymizedProxy();
+            const augmentedError = this._augmentLaunchError(error, launchContext);
+            log_1.default.error('Stagehand browser launch failed', { message: augmentedError.message });
+            throw augmentedError;
+        }
+    }
+    /**
+     * Cleans up Stagehand instance when browser disconnects.
+     */
+    async _cleanupStagehand(browser) {
+        const stagehand = this.stagehandInstances.get(browser);
+        if (stagehand) {
+            try {
+                await stagehand.close();
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            this.stagehandInstances.delete(browser);
+        }
+    }
+    /**
+     * Creates a controller for the Stagehand browser.
+     */
+    _createController() {
+        return new stagehand_controller_1.StagehandController(this, this.stagehandInstances);
+    }
+    /**
+     * Adds proxy configuration to launch options.
+     */
+    async _addProxyToLaunchOptions(launchContext) {
+        launchContext.launchOptions ?? (launchContext.launchOptions = {});
+        const { launchOptions, proxyUrl } = launchContext;
+        if (proxyUrl) {
+            const url = new URL(proxyUrl);
+            launchOptions.proxy = {
+                server: url.origin,
+                username: decodeURIComponent(url.username),
+                password: decodeURIComponent(url.password),
+            };
+        }
+    }
+    /**
+     * Determines if this is a Chromium-based browser.
+     */
+    _isChromiumBasedBrowser() {
+        const name = this.library?.name?.();
+        return name === 'chromium';
+    }
+    /**
+     * Augments launch errors with helpful context.
+     */
+    _augmentLaunchError(error, launchContext) {
+        const message = error instanceof Error ? error.message : String(error);
+        const model = this.stagehandOptions.model;
+        let helpText = '';
+        if (typeof model === 'string') {
+            const modelStr = model.toLowerCase();
+            if (modelStr.startsWith('openai/')) {
+                helpText += '\nNote: OpenAI models require apiKey option or OPENAI_API_KEY environment variable.';
+            }
+            else if (modelStr.startsWith('anthropic/')) {
+                helpText += '\nNote: Anthropic models require apiKey option or ANTHROPIC_API_KEY environment variable.';
+            }
+            else if (modelStr.startsWith('google/')) {
+                helpText += '\nNote: Google models require apiKey option or GOOGLE_API_KEY environment variable.';
+            }
+        }
+        return new Error(`Stagehand browser launch failed: ${message}\n` +
+            `Executable path: ${launchContext.launchOptions?.executablePath ?? 'default'}\n` +
+            `Model: ${model}${helpText}`, { cause: error });
+    }
+    /**
+     * Gets the Stagehand instance for a given browser.
+     */
+    getStagehandForBrowser(browser) {
+        return this.stagehandInstances.get(browser);
+    }
+}
+exports.StagehandPlugin = StagehandPlugin;
+//# sourceMappingURL=stagehand-plugin.js.map

package/internals/stagehand-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-plugin.js","sourceRoot":"","sources":["../../src/internals/stagehand-plugin.ts"],"names":[],"mappings":";;;;AAEA,wDAA2E;AAE3E,uGAAuG;AACvG,qDAAqD;AACrD,2CAAsC;AAEtC,6DAA6B;AAE7B,iEAA6D;AAa7D;;;;;;;;;;;;;;GAcG;AACH,MAAa,eAAgB,SAAQ,4BAA4D;IAI7F,YAAY,OAAoB,EAAE,UAAkC,EAAE;QAClE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAJnB;;;;;WAAmC;QAC3B;;;;mBAA4D,IAAI,OAAO,EAAE;WAAC;QAIvF,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAC3D,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,OAAO,CAAC,aAAyC;QAC7D,MAAM,EAAE,aAAa,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC;QAEvD,+DAA+D;QAC/D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAE/D,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC;QAEpF,kEAAkE;QAClE,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,GAAG,MAAM,IAAA,kCAAmB,EAAC,QAAQ,CAAC,CAAC;QAEvF,4BAA4B;QAC5B,wFAAwF;QACxF,IAAI,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAC9C,IAAI,OAAO,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC;YACzF,WAAW,GAAG;gBACV,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,MAAM,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM;aAChC,CAAC;QACb,CAAC;QAED,mFAAmF;QACnF,MAAM,eAAe,GAAc;YAC/B,GAAG,IAAI,CAAC,gBAAgB;YACxB,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,IAAI,OAAO;YACzC,KAAK,EAAE,WAAW;YAClB,yBAAyB,EAAE,OAAO;gBAC9B,CAAC,CAAC;oBACI,QAAQ,EAAE,aAAa,CAAC,QAAQ;oBAChC,IAAI,EAAE,aAAa,CAAC,IAAI;oBACxB,cAAc,EAAE,aAAa,CAAC,cAAc;oBAC5C,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK;oBAChF,QAAQ,EAAG,aAAyC,CAAC,QAGpD;iBACJ;gBACH,CAAC,CAAC,SAAS;SAClB,CAAC;QAEF,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;QAEjD,IAAI,CAAC;YACD,0CAA0C;YAC1C,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YAEvB,yDAAyD;YACzD,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;YAC5D,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,qBAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEtD,iDAAiD;YACjD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAEhD,6EAA6E;YAC7E,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;gBAClC,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBACtC,MAAM,oBAAoB,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,sBAAsB;YACtB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxC,MAAM,oBAAoB,EAAE,CAAC;YAE7B,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YACtE,aAAG,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,MAAM,cAAc,CAAC;QACzB,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,OAA0B;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC;gBACD,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACL,wBAAwB;YAC5B,CAAC;YACD,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;IACL,CAAC;IAED;;OAEG;IACO,iBAAiB;QACvB,OAAO,IAAI,0CAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAQ,CAAC;IACzE,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,wBAAwB,CAAC,aAAyC;QAC9E,aAAa,CAAC,aAAa,KAA3B,aAAa,CAAC,aAAa,GAAK,EAAE,EAAC;QAEnC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC;QAElD,IAAI,QAAQ,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE9B,aAAa,CAAC,KAAK,GAAG;gBAClB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAC1C,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;aAC7C,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACO,uBAAuB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO,IAAI,KAAK,UAAU,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,KAAc,EAAE,aAAyC;QACjF,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC;QAE1C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,QAAQ,IAAI,qFAAqF,CAAC;YACtG,CAAC;iBAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC3C,QAAQ,IAAI,2FAA2F,CAAC;YAC5G,CAAC;iBAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxC,QAAQ,IAAI,qFAAqF,CAAC;YACtG,CAAC;QACL,CAAC;QAED,OAAO,IAAI,KAAK,CACZ,oCAAoC,OAAO,IAAI;YAC3C,oBAAoB,aAAa,CAAC,aAAa,EAAE,cAAc,IAAI,SAAS,IAAI;YAChF,UAAU,KAAK,GAAG,QAAQ,EAAE,EAChC,EAAE,KAAK,EAAE,KAAK,EAAE,CACnB,CAAC;IACN,CAAC;IAED;;OAEG;IACH,sBAAsB,CAAC,OAA0B;QAC7C,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ;AA5KD,0CA4KC"}

package/internals/utils/stagehand-utils.d.ts

@@ -0,0 +1,25 @@
+import type { Stagehand } from '@browserbasehq/stagehand';
+import type { Page } from 'playwright';
+import type { StagehandPage } from '../stagehand-crawler';
+/**
+ * Enhances a Playwright Page with Stagehand AI methods.
+ * Adds page.act(), page.extract(), page.observe(), and page.agent() methods.
+ *
+ * The key feature is that each AI method passes the specific page to Stagehand,
+ * allowing multiple pages to use AI operations concurrently without interference.
+ *
+ * @param page - The Playwright page to enhance
+ * @param stagehand - The Stagehand instance to bind methods from
+ * @returns The enhanced page with AI methods
+ *
+ * @example
+ * ```typescript
+ * const enhancedPage = enhancePageWithStagehand(page, stagehand);
+ * await enhancedPage.act('Click the button');
+ * const data = await enhancedPage.extract('Get title', schema);
+ * ```
+ *
+ * @ignore
+ */
+export declare function enhancePageWithStagehand(page: Page, stagehand: Stagehand): StagehandPage;
+//# sourceMappingURL=stagehand-utils.d.ts.map

package/internals/utils/stagehand-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stagehand-utils.d.ts","sourceRoot":"","sources":["../../../src/internals/utils/stagehand-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2D,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACnH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAgC1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,GAAG,aAAa,CA2ExF"}