@browserbasehq/orca 3.0.0-preview.1 → 3.0.0-preview.3

package/package.json

@@ -1,37 +1,10 @@
 {
   "name": "@browserbasehq/orca",
-  "version": "3.0.0-preview.1",
+  "version": "3.0.0-preview.3",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": {
-    "evals": "./dist/evals/cli.js"
-  },
-  "scripts": {
-    "example": "pnpm --filter @browserbasehq/stagehand-examples run start",
-    "format": "prettier --write .",
-    "prettier": "prettier --check .",
-    "prettier:fix": "prettier --write .",
-    "eslint": "eslint .",
-    "cache:clear": "rm -rf .cache",
-    "docs": "pnpm --filter @browserbasehq/stagehand-docs run dev",
-    "evals": "tsx scripts/run-evals.ts",
-    "evals:legacy": "tsx scripts/run-evals.ts",
-    "e2e": "pnpm run build && cd evals/deterministic && playwright test --config=e2e.playwright.config.ts",
-    "e2e:bb": "pnpm run build && cd evals/deterministic && playwright test --config=bb.playwright.config.ts",
-    "e2e:local": "pnpm run build && cd evals/deterministic && playwright test --config=local.playwright.config.ts",
-    "build-v3-dom-scripts": "tsx lib/v3/dom/genDomScripts.ts",
-    "build-types": "tsc --emitDeclarationOnly --outDir dist",
-    "build-js": "tsup --entry.index lib/v3/index.ts --dts",
-    "build:cli": "tsup evals/cli.ts --outDir dist/evals --format cjs && cp evals/evals.config.json dist/evals/ && chmod +x dist/evals/cli.js && npm link",
-    "build": "pnpm run lint && pnpm run gen-version && pnpm run build-v3-dom-scripts && pnpm run build-js && pnpm run build-types",
-    "gen-version": "tsx scripts/gen-version.ts",
-    "prepare": "pnpm run build",
-    "lint": "pnpm run prettier:fix && pnpm run eslint",
-    "release": "pnpm run build && changeset publish",
-    "release-canary": "pnpm run build && changeset version --snapshot && changeset publish --tag alpha"
-  },
   "files": [
     "dist/index.js",
     "dist/index.d.ts",
@@ -39,43 +12,15 @@
     "dist/types",
     "dist/stagehand.config.d.ts"
   ],
-  "keywords": [],
+  "keywords": [
+    "ai",
+    "browser",
+    "automation",
+    "web-scraping",
+    "testing"
+  ],
   "author": "Browserbase",
   "license": "MIT",
-  "devDependencies": {
-    "@changesets/changelog-github": "^0.5.0",
-    "@changesets/cli": "^2.27.9",
-    "@eslint/js": "^9.16.0",
-    "@langchain/core": "^0.3.40",
-    "@langchain/openai": "^0.4.4",
-    "playwright-core": "^1.54.1",
-    "puppeteer-core": "^22.8.0",
-    "chrome-launcher": "^1.2.0",
-    "patchright-core": "^1.55.2",
-    "@playwright/test": "^1.42.1",
-    "@types/adm-zip": "^0.5.7",
-    "@types/cheerio": "^0.22.35",
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.11.30",
-    "@types/ws": "^8.5.13",
-    "adm-zip": "^0.5.16",
-    "autoevals": "^0.0.64",
-    "braintrust": "^0.0.171",
-    "chalk": "^5.4.1",
-    "cheerio": "^1.0.0",
-    "chromium-bidi": "^0.10.0",
-    "esbuild": "^0.21.4",
-    "eslint": "^9.16.0",
-    "express": "^4.21.0",
-    "globals": "^15.13.0",
-    "multer": "^1.4.5-lts.1",
-    "prettier": "^3.2.5",
-    "string-comparison": "^1.3.0",
-    "tsup": "^8.2.1",
-    "tsx": "^4.10.5",
-    "typescript": "^5.2.2",
-    "typescript-eslint": "^8.17.0"
-  },
   "peerDependencies": {
     "deepmerge": "^4.3.1",
     "dotenv": "^16.4.5",
@@ -84,7 +29,8 @@
   "dependencies": {
     "@anthropic-ai/sdk": "0.39.0",
     "@browserbasehq/sdk": "^2.4.0",
-    "@google/genai": "^0.8.0",
+    "@google/genai": "^1.22.0",
+    "@langchain/openai": "^0.4.4",
     "@modelcontextprotocol/sdk": "^1.17.2",
     "ai": "^4.3.9",
     "devtools-protocol": "^0.0.1464554",
@@ -108,23 +54,38 @@
     "@ai-sdk/perplexity": "^1.1.7",
     "@ai-sdk/togetherai": "^0.2.6",
     "@ai-sdk/xai": "^1.2.15",
+    "@langchain/core": "^0.3.40",
+    "playwright-core": "^1.54.1",
+    "puppeteer-core": "^22.8.0",
+    "chrome-launcher": "^1.2.0",
+    "patchright-core": "^1.55.2",
     "ollama-ai-provider": "^1.2.0"
   },
-  "directories": {
-    "doc": "docs",
-    "example": "examples",
-    "lib": "lib"
+  "devDependencies": {
+    "@playwright/test": "^1.42.1",
+    "typescript": "^5.2.2",
+    "tsup": "^8.2.1",
+    "tsx": "^4.10.5",
+    "prettier": "^3.2.5",
+    "eslint": "^9.16.0"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/browserbase/stagehand.git"
+    "url": "git+https://github.com/browserbase/stagehand.git",
+    "directory": "packages/core"
   },
   "bugs": {
     "url": "https://github.com/browserbase/stagehand/issues"
   },
   "homepage": "https://stagehand.dev",
-  "overrides": {
-    "whatwg-url": "^14.0.0"
-  },
-  "packageManager": "pnpm@9.15.0+sha512.76e2379760a4328ec4415815bcd6628dee727af3779aaa4c914e3944156c4299921a89f976381ee107d41f12cfa4b66681ca9c718f0668fa0831ed4c6d8ba56c"
-}
+  "scripts": {
+    "gen-version": "tsx scripts/gen-version.ts",
+    "build-dom-scripts": "tsx lib/v3/dom/genDomScripts.ts && tsx lib/v3/dom/genLocatorScripts.ts",
+    "build-js": "tsup --entry.index lib/v3/index.ts --dts",
+    "typecheck": "tsc --noEmit",
+    "build": "pnpm run gen-version && pnpm run build-dom-scripts && pnpm run build-js && pnpm run typecheck",
+    "example": "node --import tsx -e \"const args=process.argv.slice(1).filter(a=>a!=='--'); const [p]=args; const n=(p||'example').replace(/^\\.\\//,'').replace(/\\.ts$/i,''); import(new URL(require('node:path').resolve('examples', n + '.ts'), 'file:'));\" --",
+    "lint": "cd ../.. && prettier --check packages/core && cd packages/core && eslint .",
+    "format": "prettier --write ."
+  }
+}

package/README.md

@@ -1,165 +0,0 @@
-<div id="toc" align="center" style="margin-bottom: 0;">
-  <ul style="list-style: none; margin: 0; padding: 0;">
-    <a href="https://stagehand.dev">
-      <picture>
-        <source media="(prefers-color-scheme: dark)" srcset="media/dark_logo.png" />
-        <img alt="Stagehand" src="media/light_logo.png" width="200" style="margin-right: 30px;" />
-      </picture>
-    </a>
-  </ul>
-</div>
-<p align="center">
-  <strong>The AI Browser Automation Framework</strong><br>
-  <a href="https://docs.stagehand.dev">Read the Docs</a>
-</p>
-
-<p align="center">
-  <a href="https://github.com/browserbase/stagehand/tree/main?tab=MIT-1-ov-file#MIT-1-ov-file">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="media/dark_license.svg" />
-      <img alt="MIT License" src="media/light_license.svg" />
-    </picture>
-  </a>
-  <a href="https://join.slack.com/t/stagehand-dev/shared_invite/zt-38khc8iv5-T2acb50_0OILUaX7lxeBOg">
-    <picture>
-      <source media="(prefers-color-scheme: dark)" srcset="media/dark_slack.svg" />
-      <img alt="Slack Community" src="media/light_slack.svg" />
-    </picture>
-  </a>
-</p>
-
-<p align="center">
-	<a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-</p>
-
-<p align="center">
-If you're looking for the Python implementation, you can find it 
-<a href="https://github.com/browserbase/stagehand-python"> here</a>
-</p>
-
-<div align="center" style="display: flex; align-items: center; justify-content: center; gap: 4px; margin-bottom: 0;">
-  <b>Vibe code</b>
-  <span style="font-size: 1.05em;"> Stagehand with </span>
-  <a href="https://director.ai" style="display: flex; align-items: center;">
-    <span>Director</span>
-  </a>
-  <span> </span>
-  <picture>
-    <img alt="Director" src="media/director_icon.svg" width="25" />
-  </picture>
-</div>
-
-## Why Stagehand?
-
-Most existing browser automation tools either require you to write low-level code in a framework like Selenium, Playwright, or Puppeteer, or use high-level agents that can be unpredictable in production. By letting developers choose what to write in code vs. natural language, Stagehand is the natural choice for browser automations in production.
-
-1. **Choose when to write code vs. natural language**: use AI when you want to navigate unfamiliar pages, and use code ([Playwright](https://playwright.dev/)) when you know exactly what you want to do.
-
-2. **Preview and cache actions**: Stagehand lets you preview AI actions before running them, and also helps you easily cache repeatable actions to save time and tokens.
-
-3. **Computer use models with one line of code**: Stagehand lets you integrate SOTA computer use models from OpenAI and Anthropic into the browser with one line of code.
-
-## Example
-
-Here's how to build a sample browser automation with Stagehand:
-
-<div align="center">
-  <div style="max-width:300px;">
-    <img src="/media/github_demo.gif" alt="See Stagehand in Action">
-  </div>
-</div>
-
-```typescript
-// Use Playwright functions on the page object
-const page = stagehand.page;
-await page.goto("https://github.com/browserbase");
-
-// Use act() to execute individual actions
-await page.act("click on the stagehand repo");
-
-// Use Computer Use agents for larger actions
-const agent = stagehand.agent({
-    provider: "openai",
-    model: "computer-use-preview",
-});
-await agent.execute("Get to the latest PR");
-
-// Use extract() to read data from the page
-const { author, title } = await page.extract({
-  instruction: "extract the author and title of the PR",
-  schema: z.object({
-    author: z.string().describe("The username of the PR author"),
-    title: z.string().describe("The title of the PR"),
-  }),
-});
-```
-
-## Documentation
-
-Visit [docs.stagehand.dev](https://docs.stagehand.dev) to view the full documentation.
-
-## Getting Started
-
-Start with Stagehand with one line of code, or check out our [Quickstart Guide](https://docs.stagehand.dev/get_started/quickstart) for more information:
-
-```bash
-npx create-browser-app
-```
-
-<div align="center">
-    <a href="https://www.loom.com/share/f5107f86d8c94fa0a8b4b1e89740f7a7">
-      <p>Watch Anirudh demo create-browser-app to create a Stagehand project!</p>
-    </a>
-    <a href="https://www.loom.com/share/f5107f86d8c94fa0a8b4b1e89740f7a7">
-      <img style="max-width:300px;" src="https://cdn.loom.com/sessions/thumbnails/f5107f86d8c94fa0a8b4b1e89740f7a7-ec3f428b6775ceeb-full-play.gif">
-    </a>
-  </div>
-
-### Build and Run from Source
-
-```bash
-git clone https://github.com/browserbase/stagehand.git
-cd stagehand
-pnpm install
-pnpm playwright install
-pnpm run build
-pnpm run example # run the blank script at ./examples/example.ts
-pnpm run example 2048 # run the 2048 example at ./examples/2048.ts
-pnpm run evals -man # see evaluation suite options
-```
-
-Stagehand is best when you have an API key for an LLM provider and Browserbase credentials. To add these to your project, run:
-
-```bash
-cp .env.example .env
-nano .env # Edit the .env file to add API keys
-```
-
-## Contributing
-
-> [!NOTE]  
-> We highly value contributions to Stagehand! For questions or support, please join our [Slack community](https://join.slack.com/t/stagehand-dev/shared_invite/zt-38khc8iv5-T2acb50_0OILUaX7lxeBOg).
-
-At a high level, we're focused on improving reliability, speed, and cost in that order of priority. If you're interested in contributing, we strongly recommend reaching out to [Miguel Gonzalez](https://x.com/miguel_gonzf) or [Paul Klein](https://x.com/pk_iv) in our [Slack community](https://join.slack.com/t/stagehand-dev/shared_invite/zt-38khc8iv5-T2acb50_0OILUaX7lxeBOg) before starting to ensure that your contribution aligns with our goals.
-
-For more information, please see our [Contributing Guide](https://docs.stagehand.dev/examples/contributing).
-
-## Acknowledgements
-
-This project heavily relies on [Playwright](https://playwright.dev/) as a resilient backbone to automate the web. It also would not be possible without the awesome techniques and discoveries made by [tarsier](https://github.com/reworkd/tarsier), [gemini-zod](https://github.com/jbeoris/gemini-zod), and [fuji-web](https://github.com/normal-computing/fuji-web).
-
-We'd like to thank the following people for their major contributions to Stagehand:
-- [Paul Klein](https://github.com/pkiv)
-- [Anirudh Kamath](https://github.com/kamath)
-- [Sean McGuire](https://github.com/seanmcguire12)
-- [Miguel Gonzalez](https://github.com/miguelg719)
-- [Sameel Arif](https://github.com/sameelarif)
-- [Filip Michalsky](https://github.com/filip-michalsky)
-- [Jeremy Press](https://x.com/jeremypress)
-- [Navid Pour](https://github.com/navidpour)
-
-## License
-
-Licensed under the MIT License.
-
-Copyright 2025 Browserbase, Inc.

package/dist/lib/StagehandContext.d.ts

@@ -1,25 +0,0 @@
-import type { BrowserContext as PlaywrightContext, Page as PlaywrightPage } from "playwright";
-import { Stagehand } from "./index";
-import { StagehandPage } from "./StagehandPage";
-import { EnhancedContext } from "../types/context";
-export declare class StagehandContext {
-    private readonly stagehand;
-    private readonly intContext;
-    private pageMap;
-    private activeStagehandPage;
-    private readonly frameIdMap;
-    private constructor();
-    private createStagehandPage;
-    static init(context: PlaywrightContext, stagehand: Stagehand): Promise<StagehandContext>;
-    get frameIdLookup(): ReadonlyMap<string, StagehandPage>;
-    registerFrameId(frameId: string, page: StagehandPage): void;
-    unregisterFrameId(frameId: string): void;
-    getStagehandPageByFrameId(frameId: string): StagehandPage | undefined;
-    get context(): EnhancedContext;
-    getStagehandPage(page: PlaywrightPage): Promise<StagehandPage>;
-    getStagehandPages(): Promise<StagehandPage[]>;
-    setActivePage(page: StagehandPage): void;
-    getActivePage(): StagehandPage | null;
-    private handleNewPlaywrightPage;
-    private attachFrameNavigatedListener;
-}

package/dist/lib/StagehandPage.d.ts

@@ -1,103 +0,0 @@
-import type { CDPSession, Page as PlaywrightPage, Frame } from "playwright";
-import { z } from "zod/v3";
-import { Page, defaultExtractSchema } from "../types/page";
-import { ExtractOptions, ExtractResult, ObserveOptions, ObserveResult } from "../types/stagehand";
-import { StagehandAPI } from "./api";
-import { ActOptions, ActResult, Stagehand } from "./index";
-import { LLMClient } from "./llm/LLMClient";
-import { StagehandContext } from "./StagehandContext";
-import { EncodedId, EnhancedContext } from "../types/context";
-export declare class StagehandPage {
-    private stagehand;
-    private rawPage;
-    private intPage;
-    private intContext;
-    private actHandler;
-    private extractHandler;
-    private observeHandler;
-    private llmClient;
-    private cdpClient;
-    private api;
-    private userProvidedInstructions?;
-    private waitForCaptchaSolves;
-    private initialized;
-    private readonly cdpClients;
-    private fidOrdinals;
-    private rootFrameId;
-    get frameId(): string;
-    updateRootFrameId(newId: string): void;
-    constructor(page: PlaywrightPage, stagehand: Stagehand, context: StagehandContext, llmClient: LLMClient, userProvidedInstructions?: string, api?: StagehandAPI, waitForCaptchaSolves?: boolean);
-    ordinalForFrameId(fid: string | undefined): number;
-    encodeWithFrameId(fid: string | undefined, backendId: number): EncodedId;
-    resetFrameOrdinals(): void;
-    private ensureStagehandScript;
-    /** Register the custom selector engine that pierces open/closed shadow roots. */
-    private ensureStagehandSelectorEngine;
-    /**
-     * Waits for a captcha to be solved when using Browserbase environment.
-     *
-     * @param timeoutMs - Optional timeout in milliseconds. If provided, the promise will reject if the captcha solving hasn't started within the given time.
-     * @throws StagehandEnvironmentError if called in a LOCAL environment
-     * @throws CaptchaTimeoutError if the timeout is reached before captcha solving starts
-     * @returns Promise that resolves when the captcha is solved
-     */
-    waitForCaptchaSolve(timeoutMs?: number): Promise<void>;
-    init(): Promise<StagehandPage>;
-    get page(): Page;
-    get context(): EnhancedContext;
-    /**
-     * `_waitForSettledDom` waits until the DOM is settled, and therefore is
-     * ready for actions to be taken.
-     *
-     * **Definition of "settled"**
-     *   • No in-flight network requests (except WebSocket / Server-Sent-Events).
-     *   • That idle state lasts for at least **500 ms** (the "quiet-window").
-     *
-     * **How it works**
-     *   1.  Subscribes to CDP Network and Page events for the main target and all
-     *       out-of-process iframes (via `Target.setAutoAttach { flatten:true }`).
-     *   2.  Every time `Network.requestWillBeSent` fires, the request ID is added
-     *       to an **`inflight`** `Set`.
-     *   3.  When the request finishes—`loadingFinished`, `loadingFailed`,
-     *       `requestServedFromCache`, or a *data:* response—the request ID is
-     *       removed.
-     *   4.  *Document* requests are also mapped **frameId → requestId**; when
-     *       `Page.frameStoppedLoading` fires the corresponding Document request is
-     *       removed immediately (covers iframes whose network events never close).
-     *   5.  A **stalled-request sweep timer** runs every 500 ms.  If a *Document*
-     *       request has been open for ≥ 2 s it is forcibly removed; this prevents
-     *       ad/analytics iframes from blocking the wait forever.
-     *   6.  When `inflight` becomes empty the helper starts a 500 ms timer.
-     *       If no new request appears before the timer fires, the promise
-     *       resolves → **DOM is considered settled**.
-     *   7.  A global guard (`timeoutMs` or `stagehand.domSettleTimeoutMs`,
-     *       default ≈ 30 s) ensures we always resolve; if it fires we log how many
-     *       requests were still outstanding.
-     *
-     * @param timeoutMs – Optional hard cap (ms).  Defaults to
-     *                    `this.stagehand.domSettleTimeoutMs`.
-     */
-    _waitForSettledDom(timeoutMs?: number): Promise<void>;
-    act(actionOrOptions: string | ActOptions | ObserveResult): Promise<ActResult>;
-    extract<T extends z.AnyZodObject = typeof defaultExtractSchema>(instructionOrOptions?: string | ExtractOptions<T>): Promise<ExtractResult<T>>;
-    observe(instructionOrOptions?: string | ObserveOptions): Promise<ObserveResult[]>;
-    /**
-     * Get or create a CDP session for the given target.
-     * @param target  The Page or (OOPIF) Frame you want to talk to.
-     */
-    getCDPClient(target?: PlaywrightPage | Frame): Promise<CDPSession>;
-    /**
-     * Send a CDP command to the chosen DevTools target.
-     *
-     * @param method  Any valid CDP method, e.g. `"DOM.getDocument"`.
-     * @param params  Command parameters (optional).
-     * @param target  A `Page` or OOPIF `Frame`. Defaults to the main page.
-     *
-     * @typeParam T  Expected result shape (defaults to `unknown`).
-     */
-    sendCDP<T = unknown>(method: string, params?: Record<string, unknown>, target?: PlaywrightPage | Frame): Promise<T>;
-    /** Enable a CDP domain (e.g. `"Network"` or `"DOM"`) on the chosen target. */
-    enableCDP(domain: string, target?: PlaywrightPage | Frame): Promise<void>;
-    /** Disable a CDP domain on the chosen target. */
-    disableCDP(domain: string, target?: PlaywrightPage | Frame): Promise<void>;
-}

package/dist/lib/a11y/utils.d.ts

@@ -1,144 +0,0 @@
-import { AccessibilityNode, TreeResult, BackendIdMaps, CombinedA11yResult, EncodedId } from "../../types/context";
-import { StagehandPage } from "../StagehandPage";
-import { LogLine } from "../../types/log";
-import { Frame } from "playwright";
-/**
- * Clean a string by removing private-use unicode characters, normalizing whitespace,
- * and trimming the result.
- *
- * @param input - The text to clean, potentially containing PUA and NBSP characters.
- * @returns A cleaned string with PUA characters removed, NBSP variants collapsed,
- *          consecutive spaces merged, and leading/trailing whitespace trimmed.
- */
-export declare function cleanText(input: string): string;
-/**
- * Generate a human-readable, indented outline of an accessibility node tree.
- *
- * @param node - The accessibility node to format, optionally with an encodedId.
- * @param level - The current depth level for indentation (used internally).
- * @returns A string representation of the node and its descendants, with one node per line.
- */
-export declare function formatSimplifiedTree(node: AccessibilityNode & {
-    encodedId?: EncodedId;
-}, level?: number): string;
-/**
- * Build mappings from CDP backendNodeIds to HTML tag names and relative XPaths.
- *
- * @param experimental - Whether to use experimental behaviour.
- * @param sp - The StagehandPage wrapper for Playwright and CDP calls.
- * @param targetFrame - Optional Playwright.Frame whose DOM subtree to map; defaults to main frame.
- * @returns A Promise resolving to BackendIdMaps containing tagNameMap and xpathMap.
- */
-export declare function buildBackendIdMaps(experimental: boolean, sp: StagehandPage, targetFrame?: Frame): Promise<BackendIdMaps>;
-/**
- * Convert a flat array of AccessibilityNodes into a cleaned, hierarchical tree.
- * Nodes are pruned, structural wrappers removed, and each kept node is stamped
- * with its EncodedId for later lookup or subtree injection.
- *
- * @param nodes - Raw flat list of AX nodes retrieved via CDP.
- * @param tagNameMap - Mapping of EncodedId to HTML tag names for structural decisions.
- * @param logger - Optional function for logging diagnostic messages.
- * @param xpathMap - Optional mapping of EncodedId to relative XPath for element lookup.
- * @returns A Promise resolving to a TreeResult with cleaned tree, simplified text outline,
- *          iframe list, URL map, and inherited xpathMap.
- */
-export declare function buildHierarchicalTree(nodes: AccessibilityNode[], tagNameMap: Record<EncodedId, string>, logger?: (l: LogLine) => void, xpathMap?: Record<EncodedId, string>): Promise<TreeResult>;
-/**
- * Resolve the CDP frame identifier for a Playwright Frame, handling same-process and OOPIF.
- *
- * @param sp - The StagehandPage instance for issuing CDP commands.
- * @param frame - The target Playwright.Frame; undefined or main frame yields undefined.
- * @returns A Promise resolving to the CDP frameId string, or undefined for main document.
- */
-export declare function getCDPFrameId(sp: StagehandPage, frame?: Frame): Promise<string | undefined>;
-/**
- * Retrieve and build a cleaned accessibility tree for a document or specific iframe.
- * Prunes, formats, and optionally filters by XPath, including scrollable role decoration.
- *
- * @param stagehandPage - The StagehandPage instance for Playwright and CDP interaction.
- * @param logger - Logging function for diagnostics and performance metrics.
- * @param selector - Optional XPath to filter the AX tree to a specific subtree.
- * @param targetFrame - Optional Playwright.Frame to scope the AX tree retrieval.
- * @returns A Promise resolving to a TreeResult with the hierarchical AX tree and related metadata.
- */
-export declare function getAccessibilityTree(experimental: boolean, stagehandPage: StagehandPage, logger: (log: LogLine) => void, selector?: string, targetFrame?: Frame): Promise<TreeResult>;
-/**
- * Get the backendNodeId of the iframe element that contains a given Playwright.Frame.
- *
- * @param sp - The StagehandPage instance for issuing CDP commands.
- * @param frame - The Playwright.Frame whose host iframe element to locate.
- * @returns A Promise resolving to the backendNodeId of the iframe element, or null if not applicable.
- */
-export declare function getFrameRootBackendNodeId(sp: StagehandPage, frame: Frame | undefined): Promise<number | null>;
-/**
- * Compute the absolute XPath for the iframe element hosting a given Playwright.Frame.
- *
- * @param frame - The Playwright.Frame whose iframe element to locate.
- * @returns A Promise resolving to the XPath of the iframe element, or "/" if no frame provided.
- */
-export declare function getFrameRootXpathWithShadow(frame: Frame | undefined): Promise<string>;
-export declare function getFrameRootXpath(frame: Frame | undefined): Promise<string>;
-/**
- * Inject simplified subtree outlines into the main frame outline for nested iframes.
- * Walks the main tree text, looks for EncodedId labels, and inserts matching subtrees.
- *
- * @param tree - The indented AX outline of the main frame.
- * @param idToTree - Map of EncodedId to subtree outlines for nested frames.
- * @returns A single combined text outline with iframe subtrees injected.
- */
-export declare function injectSubtrees(tree: string, idToTree: Map<EncodedId, string>): string;
-/**
- * Retrieve and merge accessibility trees for the main document and nested iframes.
- * Walks through frame chains if a root XPath is provided, then stitches subtree outlines.
- *
- * @param stagehandPage - The StagehandPage instance for Playwright and CDP interaction.
- * @param logger - Logging function for diagnostics and performance.
- * @param rootXPath - Optional absolute XPath to focus the crawl on a subtree across frames.
- * @returns A Promise resolving to CombinedA11yResult with combined tree text, xpath map, and URL map.
- */
-export declare function getAccessibilityTreeWithFrames(experimental: boolean, stagehandPage: StagehandPage, logger: (l: LogLine) => void, rootXPath?: string): Promise<CombinedA11yResult>;
-/**
- * `findScrollableElementIds` is a function that identifies elements in
- * the browser that are deemed "scrollable". At a high level, it does the
- * following:
- * - Calls the browser-side `window.getScrollableElementXpaths()` function,
- *   which returns a list of XPaths for scrollable containers.
- * - Iterates over the returned list of XPaths, locating each element in the DOM
- *   using `stagehandPage.sendCDP(...)`
- *     - During each iteration, we call `Runtime.evaluate` to run `document.evaluate(...)`
- *       with each XPath, obtaining a `RemoteObject` reference if it exists.
- *     - Then, for each valid object reference, we call `DOM.describeNode` to retrieve
- *       the element’s `backendNodeId`.
- * - Collects all resulting `backendNodeId`s in a Set and returns them.
- *
- * @param stagehandPage - A StagehandPage instance with built-in CDP helpers.
- * @returns A Promise that resolves to a Set of unique `backendNodeId`s corresponding
- *          to scrollable elements in the DOM.
- */
-export declare function findScrollableElementIds(stagehandPage: StagehandPage, targetFrame?: Frame): Promise<Set<number>>;
-/**
- * Resolve an XPath to a Chrome-DevTools-Protocol (CDP) remote-object ID.
- *
- * @param page     A StagehandPage (or Playwright.Page with .sendCDP)
- * @param xpath    An absolute or relative XPath
- * @returns        The remote objectId for the matched node, or null
- */
-export declare function resolveObjectIdForXPath(page: StagehandPage, xpath: string, targetFrame?: Frame): Promise<string | null>;
-/**
- * Resolve a chain of iframe frames from an absolute XPath, returning the frame sequence and inner XPath.
- *
- * This helper walks an XPath expression containing iframe steps (e.g., '/html/body/iframe[2]/...'),
- * descending into each matching iframe element to build a frame chain, and returns the leftover
- * XPath segment to evaluate within the context of the last iframe.
- *
- * @param sp - The StagehandPage instance for evaluating XPath and locating frames.
- * @param absPath - An absolute XPath expression starting with '/', potentially including iframe steps.
- * @returns An object containing:
- *   frames: Array of Frame objects representing each iframe in the chain.
- *   rest: The remaining XPath string to evaluate inside the final iframe.
- * @throws Error if an iframe cannot be found or the final XPath cannot be resolved.
- */
-export declare function resolveFrameChain(sp: StagehandPage, absPath: string): Promise<{
-    frames: Frame[];
-    rest: string;
-}>;

package/dist/lib/agent/AgentClient.d.ts

@@ -1,20 +0,0 @@
-import { AgentAction, AgentResult, AgentType, AgentExecutionOptions } from "@/types/agent";
-import { ToolSet } from "ai/dist";
-/**
- * Abstract base class for agent clients
- * This provides a common interface for all agent implementations
- */
-export declare abstract class AgentClient {
-    type: AgentType;
-    modelName: string;
-    clientOptions: Record<string, unknown>;
-    userProvidedInstructions?: string;
-    constructor(type: AgentType, modelName: string, userProvidedInstructions?: string);
-    abstract execute(options: AgentExecutionOptions): Promise<AgentResult>;
-    abstract captureScreenshot(options?: Record<string, unknown>): Promise<unknown>;
-    abstract setViewport(width: number, height: number): void;
-    abstract setCurrentUrl(url: string): void;
-    abstract setScreenshotProvider(provider: () => Promise<string>): void;
-    abstract setActionHandler(handler: (action: AgentAction) => Promise<void>): void;
-    abstract setTools(tools: ToolSet): void;
-}

package/dist/lib/agent/AgentProvider.d.ts

@@ -1,19 +0,0 @@
-import { AgentType } from "@/types/agent";
-import { LogLine } from "@/types/log";
-import { ToolSet } from "ai/dist";
-import { AgentClient } from "./AgentClient";
-export declare const modelToAgentProviderMap: Record<string, AgentType>;
-/**
- * Provider for agent clients
- * This class is responsible for creating the appropriate agent client
- * based on the provider type
- */
-export declare class AgentProvider {
-    private logger;
-    /**
-     * Create a new agent provider
-     */
-    constructor(logger: (message: LogLine) => void);
-    getClient(modelName: string, clientOptions?: Record<string, unknown>, userProvidedInstructions?: string, tools?: ToolSet): AgentClient;
-    static getAgentProvider(modelName: string): AgentType;
-}