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

package/dist/index.d.ts

@@ -1,16 +1,17 @@
-import { ZodType, z, ZodTypeAny, ZodError } from 'zod/v3';
+import { ZodType, z, ZodError, ZodTypeAny } from 'zod/v3';
 import { ClientOptions as ClientOptions$2 } from '@anthropic-ai/sdk';
-import { LanguageModel, generateObject, generateText, streamText, streamObject, experimental_generateImage, embed, embedMany, experimental_transcribe, experimental_generateSpeech, ToolSet } from 'ai';
+import { LanguageModelV2 } from '@ai-sdk/provider';
 import { ClientOptions as ClientOptions$1 } from 'openai';
-import { Client, ClientOptions as ClientOptions$3 } from '@modelcontextprotocol/sdk/client/index.js';
+import { generateObject, generateText, streamText, streamObject, experimental_generateImage, embed, embedMany, experimental_transcribe, experimental_generateSpeech, ToolSet } from 'ai';
+import { Protocol } from 'devtools-protocol';
+import { Buffer as Buffer$1 } from 'buffer';
 import { Page as Page$1 } from 'playwright-core';
 export { Page as PlaywrightPage } from 'playwright-core';
-import { Page as Page$2 } from 'puppeteer-core';
-export { Page as PuppeteerPage } from 'puppeteer-core';
 import { Page as Page$3 } from 'patchright-core';
 export { Page as PatchrightPage } from 'patchright-core';
-import { Protocol } from 'devtools-protocol';
-import { Buffer as Buffer$1 } from 'buffer';
+import { Page as Page$2 } from 'puppeteer-core';
+export { Page as PuppeteerPage } from 'puppeteer-core';
+import { Client, ClientOptions as ClientOptions$3 } from '@modelcontextprotocol/sdk/client/index.js';
 import Browserbase from '@browserbasehq/sdk';
 import { ToolSet as ToolSet$1 } from 'ai/dist';
 import { Schema } from '@google/genai';
@@ -31,7 +32,7 @@ interface LLMTool {
     description: string;
     parameters: Record<string, unknown>;
 }
-type AISDKProvider = (modelName: string) => LanguageModel;
+type AISDKProvider = (modelName: string) => LanguageModelV2;
 type AISDKCustomProvider = (options: {
     apiKey: string;
 }) => AISDKProvider;
@@ -104,7 +105,7 @@ interface ChatCompletionOptions {
     };
     tools?: LLMTool[];
     tool_choice?: "auto" | "none" | "required";
-    maxTokens?: number;
+    maxOutputTokens?: number;
     requestId?: string;
 }
 type LLMResponse = {
@@ -158,7 +159,7 @@ declare abstract class LLMClient {
     embedMany: typeof embedMany;
     transcribe: typeof experimental_transcribe;
     generateSpeech: typeof experimental_generateSpeech;
-    getLanguageModel?(): LanguageModel;
+    getLanguageModel?(): LanguageModelV2;
 }
 
 /**
@@ -401,9 +402,9 @@ declare class Locator {
     scrollTo(percent: number | string): Promise<void>;
     /**
      * Fill an input/textarea/contenteditable element.
-     * - Sets the value/text directly in DOM.
-     * - Dispatches `input` and `change` events to mimic user input.
-     * - Releases the underlying `objectId` afterwards to avoid leaks.
+     * Mirrors Playwright semantics: the DOM helper either applies the native
+     * value setter (for special input types) or asks us to type text via the CDP
+     * Input domain after focusing/selecting.
      */
     fill(value: string): Promise<void>;
     /**
@@ -591,6 +592,7 @@ declare class Page {
     private readonly pageId;
     /** Cached current URL for synchronous page.url() */
     private _currentUrl;
+    private readonly networkManager;
     private constructor();
     private cursorEnabled;
     private ensureCursorScript;
@@ -629,6 +631,8 @@ declare class Page {
     frameForId(frameId: string): Frame;
     /** Expose a session by id (used by snapshot to resolve session id -> session) */
     getSessionById(id: string): CDPSessionLike | undefined;
+    registerSessionForNetwork(session: CDPSessionLike): void;
+    unregisterSessionForNetwork(sessionId: string | undefined): void;
     targetId(): string;
     /** Seed the cached URL before navigation events converge. */
     seedCurrentUrl(url: string | undefined | null): void;
@@ -794,12 +798,35 @@ declare class Page {
         withMistakes?: boolean;
     }): Promise<void>;
     /**
-     * Press a single key (keyDown then keyUp). For printable characters,
-     * uses the text path on keyDown; for named keys, sets key/code/VK.
+     * Press a single key or key combination (keyDown then keyUp).
+     * For printable characters, uses the text path on keyDown; for named keys, sets key/code/VK.
+     * Supports key combinations with modifiers like "Cmd+A", "Ctrl+C", "Shift+Tab", etc.
      */
     keyPress(key: string, options?: {
         delay?: number;
     }): Promise<void>;
+    private _pressedModifiers;
+    /** Press a key down without releasing it */
+    private keyDown;
+    /** Release a pressed key */
+    private keyUp;
+    /** Normalize modifier key names to match CDP expectations */
+    private normalizeModifierKey;
+    /**
+     * Get the map of named keys with their properties
+     */
+    private getNamedKeys;
+    /**
+     * Minimal description for printable keys (letters/digits/space) to provide code and VK.
+     * Used when non-Shift modifiers are pressed to avoid sending text while keeping accelerator info.
+     */
+    private describePrintableKey;
+    private isMacOS;
+    /**
+     * Return Chromium mac editing commands (without trailing ':') for a given code like 'KeyA'
+     * Only used on macOS to trigger system editing shortcuts (e.g., selectAll, copy, paste...).
+     */
+    private macCommandsFor;
     /**
      * Create an isolated world for the **current** main frame and return its context id.
      */
@@ -810,7 +837,66 @@ declare class Page {
      * - Event path listens at the session level and compares incoming `frameId`
      *   to `mainFrameId()` **at event time** to follow root swaps.
      */
-    private waitForMainLoadState;
+    waitForMainLoadState(state: LoadState, timeoutMs?: number): Promise<void>;
+}
+
+/**
+ * Represents a path through a Zod schema from the root object down to a
+ * particular field. The `segments` array describes the chain of keys/indices.
+ *
+ * - **String** segments indicate object property names.
+ * - **Number** segments indicate array indices.
+ *
+ * For example, `["users", 0, "homepage"]` might describe reaching
+ * the `homepage` field in `schema.users[0].homepage`.
+ */
+interface ZodPathSegments {
+    /**
+     * The ordered list of keys/indices leading from the schema root
+     * to the targeted field.
+     */
+    segments: Array<string | number>;
+}
+
+type EvaluateOptions = {
+    /** The question to ask about the task state */
+    question: string;
+    /** The answer to the question */
+    answer?: string;
+    /** Whether to take a screenshot of the task state, or array of screenshots to evaluate */
+    screenshot?: boolean | Buffer[];
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 250 */
+    screenshotDelayMs?: number;
+    /** The agent's reasoning/thought process for completing the task */
+    agentReasoning?: string;
+};
+type BatchAskOptions = {
+    /** Array of questions with optional answers */
+    questions: Array<{
+        question: string;
+        answer?: string;
+    }>;
+    /** Whether to take a screenshot of the task state */
+    screenshot?: boolean;
+    /** Custom system prompt for the evaluator */
+    systemPrompt?: string;
+    /** Delay in milliseconds before taking the screenshot @default 1000 */
+    screenshotDelayMs?: number;
+};
+/**
+ * Result of an evaluation
+ */
+interface EvaluationResult {
+    /**
+     * The evaluation result ('YES', 'NO', or 'INVALID' if parsing failed or value was unexpected)
+     */
+    evaluation: "YES" | "NO" | "INVALID";
+    /**
+     * The reasoning behind the evaluation
+     */
+    reasoning: string;
 }
 
 interface AgentAction {
@@ -839,13 +925,14 @@ interface AgentResult {
 interface AgentExecuteOptions {
     instruction: string;
     maxSteps?: number;
-    highlightCursor?: boolean;
     page?: Page$1 | Page$2 | Page$3 | Page;
+    highlightCursor?: boolean;
 }
 type AgentType = "openai" | "anthropic" | "google";
-type AvailableCuaModel = "openai/computer-use-preview" | "openai/computer-use-preview-2025-03-11" | "anthropic/claude-3-7-sonnet-latest" | "anthropic/claude-sonnet-4-20250514" | "anthropic/claude-sonnet-4-5-20250929" | "google/gemini-2.5-computer-use-preview-10-2025";
-interface AgentExecutionOptions {
-    options: AgentExecuteOptions;
+declare const AVAILABLE_CUA_MODELS: readonly ["openai/computer-use-preview", "openai/computer-use-preview-2025-03-11", "anthropic/claude-3-7-sonnet-latest", "anthropic/claude-haiku-4-5-20251001", "anthropic/claude-sonnet-4-20250514", "anthropic/claude-sonnet-4-5-20250929", "google/gemini-2.5-computer-use-preview-10-2025"];
+type AvailableCuaModel = (typeof AVAILABLE_CUA_MODELS)[number];
+interface AgentExecutionOptions<TOptions extends AgentExecuteOptions = AgentExecuteOptions> {
+    options: TOptions;
     logger: (message: LogLine) => void;
     retries?: number;
 }
@@ -937,7 +1024,7 @@ type AgentProviderType = AgentType;
 type AgentModelConfig<TModelName extends string = string> = {
     modelName: TModelName;
 } & Record<string, unknown>;
-type SharedAgentConfigFields = {
+type AgentConfig = {
     /**
      * Custom system prompt to provide to the agent. Overrides the default system prompt.
      */
@@ -950,12 +1037,10 @@ type SharedAgentConfigFields = {
      * Tools passed to the agent client
      */
     tools?: ToolSet;
-};
-type StandardAgentConfig = SharedAgentConfigFields & {
     /**
      * Indicates CUA is disabled for this configuration
      */
-    cua?: false;
+    cua?: boolean;
     /**
      * The model to use for agent functionality
      */
@@ -965,26 +1050,27 @@ type StandardAgentConfig = SharedAgentConfigFields & {
      * If not specified, inherits from the main model configuration.
      * Format: "provider/model" (e.g., "openai/gpt-4o-mini", "google/gemini-2.0-flash-exp")
      */
-    executionModel?: string;
+    executionModel?: string | AgentModelConfig<string>;
 };
-type CuaAgentConfig = SharedAgentConfigFields & {
-    /**
-     * Indicates CUA is enabled for this configuration
-     */
-    cua: true;
-    /**
-     * The model to use for agent functionality when CUA is enabled
-     */
-    model: AvailableCuaModel | AgentModelConfig<AvailableCuaModel>;
-    /**
-     * Execution models are not supported when CUA is enabled
-     */
-    executionModel?: never;
-};
-/**
- * Configuration for agent functionality
- */
-type AgentConfig = StandardAgentConfig | CuaAgentConfig;
+
+declare class StagehandAPIError extends Error {
+    constructor(message: string);
+}
+declare class StagehandAPIUnauthorizedError extends StagehandAPIError {
+    constructor(message?: string);
+}
+declare class StagehandHttpError extends StagehandAPIError {
+    constructor(message: string);
+}
+declare class StagehandServerError extends StagehandAPIError {
+    constructor(message: string);
+}
+declare class StagehandResponseBodyError extends StagehandAPIError {
+    constructor();
+}
+declare class StagehandResponseParseError extends StagehandAPIError {
+    constructor(message: string);
+}
 
 interface ActOptions {
     model?: ModelConfiguration;
@@ -1044,75 +1130,6 @@ declare enum V3FunctionName {
     AGENT = "AGENT"
 }
 
-interface CachedActEntry {
-    version: 1;
-    instruction: string;
-    url: string;
-    variables: Record<string, string>;
-    actions: Action[];
-    actionDescription?: string;
-    message?: string;
-}
-type AgentReplayStep = AgentReplayActStep | AgentReplayFillFormStep | AgentReplayGotoStep | AgentReplayScrollStep | AgentReplayWaitStep | AgentReplayNavBackStep | {
-    type: string;
-    [key: string]: unknown;
-};
-interface AgentReplayActStep {
-    type: "act";
-    instruction: string;
-    actions?: Action[];
-    actionDescription?: string;
-    message?: string;
-    timeout?: number;
-}
-interface AgentReplayFillFormStep {
-    type: "fillForm";
-    fields?: Array<{
-        action: string;
-        value: string;
-    }>;
-    observeResults?: Action[];
-    actions?: Action[];
-}
-interface AgentReplayGotoStep {
-    type: "goto";
-    url: string;
-    waitUntil?: LoadState;
-}
-interface AgentReplayScrollStep {
-    type: "scroll";
-    deltaX?: number;
-    deltaY?: number;
-    anchor?: {
-        x: number;
-        y: number;
-    };
-}
-interface AgentReplayWaitStep {
-    type: "wait";
-    timeMs: number;
-}
-interface AgentReplayNavBackStep {
-    type: "navback";
-    waitUntil?: LoadState;
-}
-interface SanitizedAgentExecuteOptions {
-    maxSteps?: number;
-    autoScreenshot?: boolean;
-    waitBetweenActions?: number;
-    context?: string;
-}
-interface CachedAgentEntry {
-    version: 1;
-    instruction: string;
-    startUrl: string;
-    options: SanitizedAgentExecuteOptions;
-    configSignature: string;
-    steps: AgentReplayStep[];
-    result: AgentResult;
-    timestamp: string;
-}
-
 interface V3Metrics {
     actPromptTokens: number;
     actCompletionTokens: number;
@@ -1187,13 +1204,115 @@ interface V3Options {
     disablePino?: boolean;
     /** Optional external logger hook for integrating with host apps. */
     logger?: (line: LogLine) => void;
-    /** Show a visual cursor overlay that follows our mouse events. */
-    includeCursor?: boolean;
     /** Directory used to persist cached actions for act(). */
     cacheDir?: string;
     domSettleTimeout?: number;
 }
 
+declare class StagehandError extends Error {
+    constructor(message: string);
+}
+declare class StagehandDefaultError extends StagehandError {
+    constructor(error?: unknown);
+}
+declare class StagehandEnvironmentError extends StagehandError {
+    constructor(currentEnvironment: string, requiredEnvironment: string, feature: string);
+}
+declare class MissingEnvironmentVariableError extends StagehandError {
+    constructor(missingEnvironmentVariable: string, feature: string);
+}
+declare class UnsupportedModelError extends StagehandError {
+    constructor(supportedModels: string[], feature?: string);
+}
+declare class UnsupportedModelProviderError extends StagehandError {
+    constructor(supportedProviders: string[], feature?: string);
+}
+declare class UnsupportedAISDKModelProviderError extends StagehandError {
+    constructor(provider: string, supportedProviders: string[]);
+}
+declare class InvalidAISDKModelFormatError extends StagehandError {
+    constructor(modelName: string);
+}
+declare class StagehandNotInitializedError extends StagehandError {
+    constructor(prop: string);
+}
+declare class BrowserbaseSessionNotFoundError extends StagehandError {
+    constructor();
+}
+declare class CaptchaTimeoutError extends StagehandError {
+    constructor();
+}
+declare class MissingLLMConfigurationError extends StagehandError {
+    constructor();
+}
+declare class HandlerNotInitializedError extends StagehandError {
+    constructor(handlerType: string);
+}
+declare class StagehandInvalidArgumentError extends StagehandError {
+    constructor(message: string);
+}
+declare class StagehandElementNotFoundError extends StagehandError {
+    constructor(xpaths: string[]);
+}
+declare class AgentScreenshotProviderError extends StagehandError {
+    constructor(message: string);
+}
+declare class StagehandMissingArgumentError extends StagehandError {
+    constructor(message: string);
+}
+declare class CreateChatCompletionResponseError extends StagehandError {
+    constructor(message: string);
+}
+declare class StagehandEvalError extends StagehandError {
+    constructor(message: string);
+}
+declare class StagehandDomProcessError extends StagehandError {
+    constructor(message: string);
+}
+declare class StagehandClickError extends StagehandError {
+    constructor(message: string, selector: string);
+}
+declare class LLMResponseError extends StagehandError {
+    constructor(primitive: string, message: string);
+}
+declare class StagehandIframeError extends StagehandError {
+    constructor(frameUrl: string, message: string);
+}
+declare class ContentFrameNotFoundError extends StagehandError {
+    constructor(selector: string);
+}
+declare class XPathResolutionError extends StagehandError {
+    constructor(xpath: string);
+}
+declare class ExperimentalApiConflictError extends StagehandError {
+    constructor();
+}
+declare class ExperimentalNotConfiguredError extends StagehandError {
+    constructor(featureName: string);
+}
+declare class ZodSchemaValidationError extends Error {
+    readonly received: unknown;
+    readonly issues: ReturnType<ZodError["format"]>;
+    constructor(received: unknown, issues: ReturnType<ZodError["format"]>);
+}
+declare class StagehandInitError extends StagehandError {
+    constructor(message: string);
+}
+declare class MCPConnectionError extends StagehandError {
+    readonly serverUrl: string;
+    readonly originalError: unknown;
+    constructor(serverUrl: string, originalError: unknown);
+}
+declare class StagehandShadowRootMissingError extends StagehandError {
+    constructor(detail?: string);
+}
+declare class StagehandShadowSegmentEmptyError extends StagehandError {
+    constructor();
+}
+declare class StagehandShadowSegmentNotFoundError extends StagehandError {
+    constructor(segment: string, hint?: string);
+}
+
 /**
  * V3Context
  *
@@ -1207,7 +1326,6 @@ interface V3Options {
  */
 declare class V3Context {
     readonly conn: CdpConnection;
-    private readonly includeCursor;
     private readonly env;
     private constructor();
     private readonly _piercerInstalled;
@@ -1227,7 +1345,6 @@ declare class V3Context {
      * Create a Context for a given CDP websocket URL and bootstrap target wiring.
      */
     static create(wsUrl: string, opts?: {
-        includeCursor?: boolean;
         env?: "LOCAL" | "BROWSERBASE";
     }): Promise<V3Context>;
     /**
@@ -1315,6 +1432,50 @@ declare class V3Context {
     awaitActivePage(timeoutMs?: number): Promise<Page>;
 }
 
+type AgentReplayStep = AgentReplayActStep | AgentReplayFillFormStep | AgentReplayGotoStep | AgentReplayScrollStep | AgentReplayWaitStep | AgentReplayNavBackStep | {
+    type: string;
+    [key: string]: unknown;
+};
+interface AgentReplayActStep {
+    type: "act";
+    instruction: string;
+    actions?: Action[];
+    actionDescription?: string;
+    message?: string;
+    timeout?: number;
+}
+interface AgentReplayFillFormStep {
+    type: "fillForm";
+    fields?: Array<{
+        action: string;
+        value: string;
+    }>;
+    observeResults?: Action[];
+    actions?: Action[];
+}
+interface AgentReplayGotoStep {
+    type: "goto";
+    url: string;
+    waitUntil?: LoadState;
+}
+interface AgentReplayScrollStep {
+    type: "scroll";
+    deltaX?: number;
+    deltaY?: number;
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
+interface AgentReplayWaitStep {
+    type: "wait";
+    timeMs: number;
+}
+interface AgentReplayNavBackStep {
+    type: "navback";
+    waitUntil?: LoadState;
+}
+
 /**
  * V3
  *
@@ -1354,15 +1515,15 @@ declare class V3 {
     private readonly instanceId;
     private static _processGuardsInstalled;
     private static _instances;
-    private cacheDir?;
-    private _agentReplayRecording;
+    private cacheStorage;
+    private actCache;
+    private agentCache;
     v3Metrics: V3Metrics;
     /**
      * Async property for metrics so callers can `await v3.metrics`.
      * Returning a Promise future-proofs async aggregation/storage.
      */
     get metrics(): Promise<V3Metrics>;
-    private cloneForCache;
     private resolveLlmClient;
     private beginAgentReplayRecording;
     private endAgentReplayRecording;
@@ -1437,30 +1598,9 @@ declare class V3 {
     private isPlaywrightPage;
     private isPatchrightPage;
     private isPuppeteerPage;
+    /** Resolve an external page reference or fall back to the active V3 page. */
+    private resolvePage;
     private normalizeToV3Page;
-    private buildActCacheKey;
-    private safeGetPageUrl;
-    private readActCacheEntry;
-    private writeActCacheEntry;
-    private sanitizeAgentExecuteOptions;
-    private createLlmClientOverride;
-    private inferProviderFromModelName;
-    private extractAgentModel;
-    private serializeAgentModelForCache;
-    private buildAgentCacheSignature;
-    private buildAgentCacheKey;
-    private readAgentCacheEntry;
-    private writeAgentCacheEntry;
-    private replayAgentCacheEntry;
-    private executeAgentReplayStep;
-    private replayAgentActStep;
-    private replayAgentFillFormStep;
-    private replayAgentGotoStep;
-    private replayAgentScrollStep;
-    private replayAgentWaitStep;
-    private replayAgentNavBackStep;
-    private replayCachedActions;
-    private runWithActTimeout;
     /**
      * Create a v3 agent instance (AISDK tool-based) with execute().
      * Mirrors the v2 Stagehand.agent() tool mode (no CUA provider here).
@@ -1470,129 +1610,6 @@ declare class V3 {
     };
 }
 
-declare class StagehandAPIError extends Error {
-    constructor(message: string);
-}
-declare class StagehandAPIUnauthorizedError extends StagehandAPIError {
-    constructor(message?: string);
-}
-declare class StagehandHttpError extends StagehandAPIError {
-    constructor(message: string);
-}
-declare class StagehandServerError extends StagehandAPIError {
-    constructor(message: string);
-}
-declare class StagehandResponseBodyError extends StagehandAPIError {
-    constructor();
-}
-declare class StagehandResponseParseError extends StagehandAPIError {
-    constructor(message: string);
-}
-
-declare class StagehandError extends Error {
-    constructor(message: string);
-}
-declare class StagehandDefaultError extends StagehandError {
-    constructor(error?: unknown);
-}
-declare class StagehandEnvironmentError extends StagehandError {
-    constructor(currentEnvironment: string, requiredEnvironment: string, feature: string);
-}
-declare class MissingEnvironmentVariableError extends StagehandError {
-    constructor(missingEnvironmentVariable: string, feature: string);
-}
-declare class UnsupportedModelError extends StagehandError {
-    constructor(supportedModels: string[], feature?: string);
-}
-declare class UnsupportedModelProviderError extends StagehandError {
-    constructor(supportedProviders: string[], feature?: string);
-}
-declare class UnsupportedAISDKModelProviderError extends StagehandError {
-    constructor(provider: string, supportedProviders: string[]);
-}
-declare class InvalidAISDKModelFormatError extends StagehandError {
-    constructor(modelName: string);
-}
-declare class StagehandNotInitializedError extends StagehandError {
-    constructor(prop: string);
-}
-declare class BrowserbaseSessionNotFoundError extends StagehandError {
-    constructor();
-}
-declare class CaptchaTimeoutError extends StagehandError {
-    constructor();
-}
-declare class MissingLLMConfigurationError extends StagehandError {
-    constructor();
-}
-declare class HandlerNotInitializedError extends StagehandError {
-    constructor(handlerType: string);
-}
-declare class StagehandInvalidArgumentError extends StagehandError {
-    constructor(message: string);
-}
-declare class StagehandElementNotFoundError extends StagehandError {
-    constructor(xpaths: string[]);
-}
-declare class AgentScreenshotProviderError extends StagehandError {
-    constructor(message: string);
-}
-declare class StagehandMissingArgumentError extends StagehandError {
-    constructor(message: string);
-}
-declare class CreateChatCompletionResponseError extends StagehandError {
-    constructor(message: string);
-}
-declare class StagehandEvalError extends StagehandError {
-    constructor(message: string);
-}
-declare class StagehandDomProcessError extends StagehandError {
-    constructor(message: string);
-}
-declare class StagehandClickError extends StagehandError {
-    constructor(message: string, selector: string);
-}
-declare class LLMResponseError extends StagehandError {
-    constructor(primitive: string, message: string);
-}
-declare class StagehandIframeError extends StagehandError {
-    constructor(frameUrl: string, message: string);
-}
-declare class ContentFrameNotFoundError extends StagehandError {
-    constructor(selector: string);
-}
-declare class XPathResolutionError extends StagehandError {
-    constructor(xpath: string);
-}
-declare class ExperimentalApiConflictError extends StagehandError {
-    constructor();
-}
-declare class ExperimentalNotConfiguredError extends StagehandError {
-    constructor(featureName: string);
-}
-declare class ZodSchemaValidationError extends Error {
-    readonly received: unknown;
-    readonly issues: ReturnType<ZodError["format"]>;
-    constructor(received: unknown, issues: ReturnType<ZodError["format"]>);
-}
-declare class StagehandInitError extends StagehandError {
-    constructor(message: string);
-}
-declare class MCPConnectionError extends StagehandError {
-    readonly serverUrl: string;
-    readonly originalError: unknown;
-    constructor(serverUrl: string, originalError: unknown);
-}
-declare class StagehandShadowRootMissingError extends StagehandError {
-    constructor(detail?: string);
-}
-declare class StagehandShadowSegmentEmptyError extends StagehandError {
-    constructor();
-}
-declare class StagehandShadowSegmentNotFoundError extends StagehandError {
-    constructor(segment: string, hint?: string);
-}
-
 /**
  * Abstract base class for agent clients
  * This provides a common interface for all agent implementations
@@ -1627,24 +1644,6 @@ declare class AgentProvider {
     static getAgentProvider(modelName: string): AgentProviderType;
 }
 
-/**
- * Represents a path through a Zod schema from the root object down to a
- * particular field. The `segments` array describes the chain of keys/indices.
- *
- * - **String** segments indicate object property names.
- * - **Number** segments indicate array indices.
- *
- * For example, `["users", 0, "homepage"]` might describe reaching
- * the `homepage` field in `schema.users[0].homepage`.
- */
-interface ZodPathSegments {
-    /**
-     * The ordered list of keys/indices leading from the schema root
-     * to the targeted field.
-     */
-    segments: Array<string | number>;
-}
-
 declare function validateZodSchema(schema: z.ZodTypeAny, data: unknown): boolean;
 /**
  * Detects if the code is running in the Bun runtime environment.
@@ -1717,47 +1716,6 @@ interface StdioServerConfig {
 }
 declare const connectToMCPServer: (serverConfig: string | URL | StdioServerConfig | ConnectToMCPServerOptions) => Promise<Client>;
 
-type EvaluateOptions = {
-    /** The question to ask about the task state */
-    question: string;
-    /** The answer to the question */
-    answer?: string;
-    /** Whether to take a screenshot of the task state, or array of screenshots to evaluate */
-    screenshot?: boolean | Buffer[];
-    /** Custom system prompt for the evaluator */
-    systemPrompt?: string;
-    /** Delay in milliseconds before taking the screenshot @default 250 */
-    screenshotDelayMs?: number;
-    /** The agent's reasoning/thought process for completing the task */
-    agentReasoning?: string;
-};
-type BatchAskOptions = {
-    /** Array of questions with optional answers */
-    questions: Array<{
-        question: string;
-        answer?: string;
-    }>;
-    /** Whether to take a screenshot of the task state */
-    screenshot?: boolean;
-    /** Custom system prompt for the evaluator */
-    systemPrompt?: string;
-    /** Delay in milliseconds before taking the screenshot @default 1000 */
-    screenshotDelayMs?: number;
-};
-/**
- * Result of an evaluation
- */
-interface EvaluationResult {
-    /**
-     * The evaluation result ('YES', 'NO', or 'INVALID' if parsing failed or value was unexpected)
-     */
-    evaluation: "YES" | "NO" | "INVALID";
-    /**
-     * The reasoning behind the evaluation
-     */
-    reasoning: string;
-}
-
 /**
  * V3Evaluator mirrors Evaluator but operates on a V3 instance instead of Stagehand.
  * It uses the V3 page/screenshot APIs and constructs an LLM client to run
@@ -1776,4 +1734,4 @@ declare class V3Evaluator {
     private _evaluateWithMultipleScreenshots;
 }
 
-export { type AISDKCustomProvider, type AISDKProvider, type ActOptions, type ActResult, type Action, type ActionExecutionResult, type AgentAction, type AgentConfig, type AgentExecuteOptions, type AgentExecutionOptions, type AgentHandlerOptions, type AgentInstance, type AgentModelConfig, AgentProvider, type AgentProviderType, type AgentReplayActStep, type AgentReplayFillFormStep, type AgentReplayGotoStep, type AgentReplayNavBackStep, type AgentReplayScrollStep, type AgentReplayStep, type AgentReplayWaitStep, type AgentResult, AgentScreenshotProviderError, type AgentType, AnnotatedScreenshotText, type AnthropicContentBlock, type AnthropicJsonSchemaObject, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResult, type AnyPage, type AvailableCuaModel, type AvailableModel, BrowserbaseSessionNotFoundError, type CachedActEntry, type CachedAgentEntry, CaptchaTimeoutError, type ChatCompletionOptions, type ChatMessage, type ChatMessageContent, type ChatMessageImageContent, type ChatMessageTextContent, type ClientOptions, type ComputerCallItem, ContentFrameNotFoundError, type CreateChatCompletionOptions, CreateChatCompletionResponseError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, type ExtractOptions, type ExtractResult, type FunctionCallItem, HandlerNotInitializedError, type HistoryEntry, InvalidAISDKModelFormatError, type JsonSchema, type JsonSchemaProperty, LLMClient, type LLMResponse, LLMResponseError, type LLMTool, LOG_LEVEL_NAMES, type LoadState, type LocalBrowserLaunchOptions, type LogLevel, type LogLine, type Logger, MCPConnectionError, MissingEnvironmentVariableError, MissingLLMConfigurationError, type ModelConfiguration, type ModelProvider, type ObserveOptions, type ResponseInputItem, type ResponseItem, type SanitizedAgentExecuteOptions, V3 as Stagehand, StagehandAPIError, StagehandAPIUnauthorizedError, StagehandClickError, StagehandDefaultError, StagehandDomProcessError, StagehandElementNotFoundError, StagehandEnvironmentError, StagehandError, StagehandEvalError, StagehandHttpError, StagehandIframeError, StagehandInitError, StagehandInvalidArgumentError, StagehandMissingArgumentError, StagehandNotInitializedError, StagehandResponseBodyError, StagehandResponseParseError, StagehandServerError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, type ToolUseItem, UnsupportedAISDKModelProviderError, UnsupportedModelError, UnsupportedModelProviderError, V3, type V3Env, V3Evaluator, V3FunctionName, type V3Metrics, type V3Options, XPathResolutionError, ZodSchemaValidationError, connectToMCPServer, defaultExtractSchema, getZodType, injectUrls, isRunningInBun, jsonSchemaToZod, loadApiKeyFromEnv, modelToAgentProviderMap, pageTextSchema, providerEnvVarMap, toGeminiSchema, transformSchema, trimTrailingTextNode, validateZodSchema };
+export { type AISDKCustomProvider, type AISDKProvider, AVAILABLE_CUA_MODELS, type ActOptions, type ActResult, type Action, type ActionExecutionResult, type AgentAction, type AgentConfig, type AgentExecuteOptions, type AgentExecutionOptions, type AgentHandlerOptions, type AgentInstance, type AgentModelConfig, AgentProvider, type AgentProviderType, type AgentResult, AgentScreenshotProviderError, type AgentType, AnnotatedScreenshotText, type AnthropicContentBlock, type AnthropicJsonSchemaObject, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResult, type AnyPage, type AvailableCuaModel, type AvailableModel, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, type ChatCompletionOptions, type ChatMessage, type ChatMessageContent, type ChatMessageImageContent, type ChatMessageTextContent, type ClientOptions, type ComputerCallItem, ContentFrameNotFoundError, type CreateChatCompletionOptions, CreateChatCompletionResponseError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, type ExtractOptions, type ExtractResult, type FunctionCallItem, HandlerNotInitializedError, type HistoryEntry, InvalidAISDKModelFormatError, type JsonSchema, type JsonSchemaProperty, LLMClient, type LLMResponse, LLMResponseError, type LLMTool, LOG_LEVEL_NAMES, type LoadState, type LocalBrowserLaunchOptions, type LogLevel, type LogLine, type Logger, MCPConnectionError, MissingEnvironmentVariableError, MissingLLMConfigurationError, type ModelConfiguration, type ModelProvider, type ObserveOptions, type ResponseInputItem, type ResponseItem, V3 as Stagehand, StagehandAPIError, StagehandAPIUnauthorizedError, StagehandClickError, StagehandDefaultError, StagehandDomProcessError, StagehandElementNotFoundError, StagehandEnvironmentError, StagehandError, StagehandEvalError, StagehandHttpError, StagehandIframeError, StagehandInitError, StagehandInvalidArgumentError, StagehandMissingArgumentError, StagehandNotInitializedError, StagehandResponseBodyError, StagehandResponseParseError, StagehandServerError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, type ToolUseItem, UnsupportedAISDKModelProviderError, UnsupportedModelError, UnsupportedModelProviderError, V3, type V3Env, V3Evaluator, V3FunctionName, type V3Metrics, type V3Options, XPathResolutionError, ZodSchemaValidationError, connectToMCPServer, defaultExtractSchema, getZodType, injectUrls, isRunningInBun, jsonSchemaToZod, loadApiKeyFromEnv, modelToAgentProviderMap, pageTextSchema, providerEnvVarMap, toGeminiSchema, transformSchema, trimTrailingTextNode, validateZodSchema };