@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-headers

package/dist/cjs/lib/v3/types/public/model.d.ts

@@ -0,0 +1,67 @@
+import type { ClientOptions as AnthropicClientOptionsBase } from "@anthropic-ai/sdk";
+import type { GoogleVertexProviderSettings as GoogleVertexProviderSettingsBase } from "@ai-sdk/google-vertex";
+import type { LanguageModelV2 } from "@ai-sdk/provider";
+import type { ClientOptions as OpenAIClientOptionsBase } from "openai";
+import type { AgentProviderType } from "./agent.js";
+export type OpenAIClientOptions = Pick<OpenAIClientOptionsBase, "baseURL" | "apiKey">;
+export type AnthropicClientOptions = Pick<AnthropicClientOptionsBase, "baseURL" | "apiKey">;
+export interface GoogleServiceAccountCredentials {
+    type?: string;
+    project_id?: string;
+    private_key_id?: string;
+    private_key?: string;
+    client_email?: string;
+    client_id?: string;
+    auth_uri?: string;
+    token_uri?: string;
+    auth_provider_x509_cert_url?: string;
+    client_x509_cert_url?: string;
+    universe_domain?: string;
+}
+export type GoogleVertexProviderSettings = Pick<GoogleVertexProviderSettingsBase, "project" | "location" | "headers"> & {
+    googleAuthOptions?: {
+        credentials?: GoogleServiceAccountCredentials;
+    };
+};
+export type AnthropicJsonSchemaObject = {
+    definitions?: {
+        MySchema?: {
+            properties?: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+    properties?: Record<string, unknown>;
+    required?: string[];
+} & Record<string, unknown>;
+export interface LLMTool {
+    type: "function";
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export type AISDKProvider = (modelName: string) => LanguageModelV2;
+export type AISDKCustomProvider = (options: ClientOptions) => AISDKProvider;
+export type AvailableModel = "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "o4-mini" | "o3" | "o3-mini" | "o1" | "o1-mini" | "gpt-4o" | "gpt-4o-mini" | "gpt-4o-2024-08-06" | "gpt-4.5-preview" | "o1-preview" | "cerebras-llama-3.3-70b" | "cerebras-llama-3.1-8b" | "groq-llama-3.3-70b-versatile" | "groq-llama-3.3-70b-specdec" | "gemini-1.5-flash" | "gemini-1.5-pro" | "gemini-1.5-flash-8b" | "gemini-2.0-flash-lite" | "gemini-2.0-flash" | "gemini-2.5-flash-preview-04-17" | "gemini-2.5-pro-preview-03-25" | string;
+export type ModelProvider = "openai" | "anthropic" | "cerebras" | "groq" | "google" | "aisdk";
+export type ClientOptions = (OpenAIClientOptions | AnthropicClientOptions | GoogleVertexProviderSettings) & {
+    apiKey?: string;
+    provider?: AgentProviderType;
+    baseURL?: string;
+    /** OpenAI organization ID */
+    organization?: string;
+    /** Delay between agent actions in ms */
+    waitBetweenActions?: number;
+    /** Anthropic thinking budget for extended thinking */
+    thinkingBudget?: number;
+    /** Environment type for CUA agents (browser, mac, windows, ubuntu) */
+    environment?: string;
+    /** Max images for Microsoft FARA agent */
+    maxImages?: number;
+    /** Temperature for model inference */
+    temperature?: number;
+    /** Custom headers sent with every request to the provider */
+    headers?: Record<string, string>;
+};
+export type ModelConfiguration = AvailableModel | (ClientOptions & {
+    modelName: AvailableModel;
+});

package/dist/cjs/lib/v3/types/public/model.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model.js.map

package/dist/cjs/lib/v3/types/public/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { ClientOptions as AnthropicClientOptionsBase } from \"@anthropic-ai/sdk\";\nimport type { GoogleVertexProviderSettings as GoogleVertexProviderSettingsBase } from \"@ai-sdk/google-vertex\";\nimport type { LanguageModelV2 } from \"@ai-sdk/provider\";\nimport type { ClientOptions as OpenAIClientOptionsBase } from \"openai\";\nimport type { AgentProviderType } from \"./agent.js\";\n\nexport type OpenAIClientOptions = Pick<\n  OpenAIClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport type AnthropicClientOptions = Pick<\n  AnthropicClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport interface GoogleServiceAccountCredentials {\n  type?: string;\n  project_id?: string;\n  private_key_id?: string;\n  private_key?: string;\n  client_email?: string;\n  client_id?: string;\n  auth_uri?: string;\n  token_uri?: string;\n  auth_provider_x509_cert_url?: string;\n  client_x509_cert_url?: string;\n  universe_domain?: string;\n}\n\nexport type GoogleVertexProviderSettings = Pick<\n  GoogleVertexProviderSettingsBase,\n  \"project\" | \"location\" | \"headers\"\n> & {\n  googleAuthOptions?: {\n    credentials?: GoogleServiceAccountCredentials;\n  };\n};\n\nexport type AnthropicJsonSchemaObject = {\n  definitions?: {\n    MySchema?: {\n      properties?: Record<string, unknown>;\n      required?: string[];\n    };\n  };\n  properties?: Record<string, unknown>;\n  required?: string[];\n} & Record<string, unknown>;\n\nexport interface LLMTool {\n  type: \"function\";\n  name: string;\n  description: string;\n  parameters: Record<string, unknown>;\n}\n\nexport type AISDKProvider = (modelName: string) => LanguageModelV2;\n// Represents a function that takes options (like apiKey) and returns an AISDKProvider\nexport type AISDKCustomProvider = (options: ClientOptions) => AISDKProvider;\n\nexport type AvailableModel =\n  | \"gpt-4.1\"\n  | \"gpt-4.1-mini\"\n  | \"gpt-4.1-nano\"\n  | \"o4-mini\"\n  | \"o3\"\n  | \"o3-mini\"\n  | \"o1\"\n  | \"o1-mini\"\n  | \"gpt-4o\"\n  | \"gpt-4o-mini\"\n  | \"gpt-4o-2024-08-06\"\n  | \"gpt-4.5-preview\"\n  | \"o1-preview\"\n  | \"cerebras-llama-3.3-70b\"\n  | \"cerebras-llama-3.1-8b\"\n  | \"groq-llama-3.3-70b-versatile\"\n  | \"groq-llama-3.3-70b-specdec\"\n  | \"gemini-1.5-flash\"\n  | \"gemini-1.5-pro\"\n  | \"gemini-1.5-flash-8b\"\n  | \"gemini-2.0-flash-lite\"\n  | \"gemini-2.0-flash\"\n  | \"gemini-2.5-flash-preview-04-17\"\n  | \"gemini-2.5-pro-preview-03-25\"\n  | string;\n\nexport type ModelProvider =\n  | \"openai\"\n  | \"anthropic\"\n  | \"cerebras\"\n  | \"groq\"\n  | \"google\"\n  | \"aisdk\";\n\nexport type ClientOptions = (\n  | OpenAIClientOptions\n  | AnthropicClientOptions\n  | GoogleVertexProviderSettings\n) & {\n  apiKey?: string;\n  provider?: AgentProviderType;\n  baseURL?: string;\n  /** OpenAI organization ID */\n  organization?: string;\n  /** Delay between agent actions in ms */\n  waitBetweenActions?: number;\n  /** Anthropic thinking budget for extended thinking */\n  thinkingBudget?: number;\n  /** Environment type for CUA agents (browser, mac, windows, ubuntu) */\n  environment?: string;\n  /** Max images for Microsoft FARA agent */\n  maxImages?: number;\n  /** Temperature for model inference */\n  temperature?: number;\n  /** Custom headers sent with every request to the provider */\n  headers?: Record<string, string>;\n};\n\nexport type ModelConfiguration =\n  | AvailableModel\n  | (ClientOptions & { modelName: AvailableModel });\n"]}

package/dist/cjs/lib/v3/types/public/options.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { LLMClient } from "../../llm/LLMClient.js";
+import { ModelConfiguration } from "./model.js";
+import { LogLine } from "./logs.js";
+import { type BrowserbaseSessionCreateParams, LocalBrowserLaunchOptionsSchema } from "./api.js";
+export type V3Env = "LOCAL" | "BROWSERBASE";
+export declare const localBrowserLaunchOptionsSchema: z.ZodObject<{
+    args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    executablePath: z.ZodOptional<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    userDataDir: z.ZodOptional<z.ZodString>;
+    preserveUserDataDir: z.ZodOptional<z.ZodBoolean>;
+    headless: z.ZodOptional<z.ZodBoolean>;
+    devtools: z.ZodOptional<z.ZodBoolean>;
+    chromiumSandbox: z.ZodOptional<z.ZodBoolean>;
+    ignoreDefaultArgs: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    proxy: z.ZodOptional<z.ZodObject<{
+        server: z.ZodString;
+        bypass: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        password: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    locale: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    deviceScaleFactor: z.ZodOptional<z.ZodNumber>;
+    hasTouch: z.ZodOptional<z.ZodBoolean>;
+    ignoreHTTPSErrors: z.ZodOptional<z.ZodBoolean>;
+    cdpUrl: z.ZodOptional<z.ZodString>;
+    cdpHeaders: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    connectTimeoutMs: z.ZodOptional<z.ZodNumber>;
+    downloadsPath: z.ZodOptional<z.ZodString>;
+    acceptDownloads: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type LocalBrowserLaunchOptions = z.infer<typeof LocalBrowserLaunchOptionsSchema>;
+/** Constructor options for V3 */
+export interface V3Options {
+    env: V3Env;
+    apiKey?: string;
+    projectId?: string;
+    /**
+     * Optional: fine-tune Browserbase session creation or resume an existing session.
+     */
+    browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;
+    browserbaseSessionID?: string;
+    /**
+     * Controls browser keepalive behavior. When set, it overrides any value in
+     * browserbaseSessionCreateParams.keepAlive.
+     */
+    keepAlive?: boolean;
+    localBrowserLaunchOptions?: LocalBrowserLaunchOptions;
+    model?: ModelConfiguration;
+    llmClient?: LLMClient;
+    systemPrompt?: string;
+    logInferenceToFile?: boolean;
+    experimental?: boolean;
+    verbose?: 0 | 1 | 2;
+    selfHeal?: boolean;
+    waitForCaptchaSolves?: boolean;
+    actTimeoutMs?: number;
+    /** Disable pino logging backend (useful for tests or minimal environments). */
+    disablePino?: boolean;
+    /** Optional external logger hook for integrating with host apps. */
+    logger?: (line: LogLine) => void;
+    /** Directory used to persist cached actions for act(). */
+    cacheDir?: string;
+    domSettleTimeout?: number;
+    disableAPI?: boolean;
+    /**
+     * When true, enables server-side caching for API requests.
+     * When false, disables server-side caching.
+     * Defaults to true (caching enabled).
+     * Can be overridden per-method in act(), extract(), and observe() options.
+     */
+    serverCache?: boolean;
+}

package/dist/cjs/lib/v3/types/public/options.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localBrowserLaunchOptionsSchema = void 0;
+const api_js_1 = require("./api.js");
+// Re-export for backwards compatibility (camelCase alias)
+exports.localBrowserLaunchOptionsSchema = api_js_1.LocalBrowserLaunchOptionsSchema;
+//# sourceMappingURL=options.js.map

package/dist/cjs/lib/v3/types/public/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/options.ts"],"names":[],"mappings":";;;AAIA,qCAGkB;AAIlB,0DAA0D;AAC7C,QAAA,+BAA+B,GAAG,wCAA+B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { LLMClient } from \"../../llm/LLMClient.js\";\nimport { ModelConfiguration } from \"./model.js\";\nimport { LogLine } from \"./logs.js\";\nimport {\n  type BrowserbaseSessionCreateParams,\n  LocalBrowserLaunchOptionsSchema,\n} from \"./api.js\";\n\nexport type V3Env = \"LOCAL\" | \"BROWSERBASE\";\n\n// Re-export for backwards compatibility (camelCase alias)\nexport const localBrowserLaunchOptionsSchema = LocalBrowserLaunchOptionsSchema;\n\nexport type LocalBrowserLaunchOptions = z.infer<\n  typeof LocalBrowserLaunchOptionsSchema\n>;\n\n/** Constructor options for V3 */\nexport interface V3Options {\n  env: V3Env;\n  // Browserbase (required when env = \"BROWSERBASE\")\n  apiKey?: string;\n  projectId?: string;\n  /**\n   * Optional: fine-tune Browserbase session creation or resume an existing session.\n   */\n  browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;\n  browserbaseSessionID?: string;\n  /**\n   * Controls browser keepalive behavior. When set, it overrides any value in\n   * browserbaseSessionCreateParams.keepAlive.\n   */\n  keepAlive?: boolean;\n\n  // Local Chromium (optional)\n  localBrowserLaunchOptions?: LocalBrowserLaunchOptions;\n\n  model?: ModelConfiguration;\n  llmClient?: LLMClient; // allow user to pass their own\n  systemPrompt?: string;\n  logInferenceToFile?: boolean;\n  experimental?: boolean;\n  verbose?: 0 | 1 | 2;\n  selfHeal?: boolean;\n  // V2 compatibility fields - only included because the server imports this type and supports V2\n  waitForCaptchaSolves?: boolean;\n  actTimeoutMs?: number;\n  /** Disable pino logging backend (useful for tests or minimal environments). */\n  disablePino?: boolean;\n  /** Optional external logger hook for integrating with host apps. */\n  logger?: (line: LogLine) => void;\n  /** Directory used to persist cached actions for act(). */\n  cacheDir?: string;\n  domSettleTimeout?: number;\n  disableAPI?: boolean;\n  /**\n   * When true, enables server-side caching for API requests.\n   * When false, disables server-side caching.\n   * Defaults to true (caching enabled).\n   * Can be overridden per-method in act(), extract(), and observe() options.\n   */\n  serverCache?: boolean;\n}\n"]}

package/dist/cjs/lib/v3/types/public/page.d.ts

@@ -0,0 +1,18 @@
+import { Page } from "../../understudy/page.js";
+import { Page as PlaywrightPage } from "playwright-core";
+import { Page as PatchrightPage } from "patchright-core";
+import { Page as PuppeteerPage } from "puppeteer-core";
+export type { PlaywrightPage, PatchrightPage, PuppeteerPage, Page };
+export type AnyPage = PlaywrightPage | PuppeteerPage | PatchrightPage | Page;
+export { ConsoleMessage } from "../../understudy/consoleMessage.js";
+export type { ConsoleListener } from "../../understudy/consoleMessage.js";
+export type LoadState = "load" | "domcontentloaded" | "networkidle";
+export { Response } from "../../understudy/response.js";
+export type SnapshotResult = {
+    formattedTree: string;
+    xpathMap: Record<string, string>;
+    urlMap: Record<string, string>;
+};
+export type PageSnapshotOptions = {
+    includeIframes?: boolean;
+};

package/dist/cjs/lib/v3/types/public/page.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Response = exports.ConsoleMessage = void 0;
+var consoleMessage_js_1 = require("../../understudy/consoleMessage.js");
+Object.defineProperty(exports, "ConsoleMessage", { enumerable: true, get: function () { return consoleMessage_js_1.ConsoleMessage; } });
+var response_js_1 = require("../../understudy/response.js");
+Object.defineProperty(exports, "Response", { enumerable: true, get: function () { return response_js_1.Response; } });
+//# sourceMappingURL=page.js.map

package/dist/cjs/lib/v3/types/public/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/page.ts"],"names":[],"mappings":";;;AAQA,wEAAoE;AAA3D,mHAAA,cAAc,OAAA;AAIvB,4DAAwD;AAA/C,uGAAA,QAAQ,OAAA","sourcesContent":["import { Page } from \"../../understudy/page.js\";\nimport { Page as PlaywrightPage } from \"playwright-core\";\nimport { Page as PatchrightPage } from \"patchright-core\";\nimport { Page as PuppeteerPage } from \"puppeteer-core\";\n\nexport type { PlaywrightPage, PatchrightPage, PuppeteerPage, Page };\nexport type AnyPage = PlaywrightPage | PuppeteerPage | PatchrightPage | Page;\n\nexport { ConsoleMessage } from \"../../understudy/consoleMessage.js\";\nexport type { ConsoleListener } from \"../../understudy/consoleMessage.js\";\n\nexport type LoadState = \"load\" | \"domcontentloaded\" | \"networkidle\";\nexport { Response } from \"../../understudy/response.js\";\n\nexport type SnapshotResult = {\n  formattedTree: string;\n  xpathMap: Record<string, string>;\n  urlMap: Record<string, string>;\n};\n\nexport type PageSnapshotOptions = {\n  includeIframes?: boolean;\n};\n"]}

package/dist/cjs/lib/v3/types/public/screenshotTypes.d.ts

@@ -0,0 +1,25 @@
+import type { Locator } from "../../understudy/locator.js";
+export type ScreenshotAnimationsOption = "disabled" | "allow";
+export type ScreenshotCaretOption = "hide" | "initial";
+export type ScreenshotScaleOption = "css" | "device";
+export interface ScreenshotClip {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ScreenshotOptions {
+    animations?: ScreenshotAnimationsOption;
+    caret?: ScreenshotCaretOption;
+    clip?: ScreenshotClip;
+    fullPage?: boolean;
+    mask?: Locator[];
+    maskColor?: string;
+    omitBackground?: boolean;
+    path?: string;
+    quality?: number;
+    scale?: ScreenshotScaleOption;
+    style?: string;
+    timeout?: number;
+    type?: "png" | "jpeg";
+}

package/dist/cjs/lib/v3/types/public/screenshotTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=screenshotTypes.js.map

package/dist/cjs/lib/v3/types/public/screenshotTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshotTypes.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/screenshotTypes.ts"],"names":[],"mappings":"","sourcesContent":["import type { Locator } from \"../../understudy/locator.js\";\n\nexport type ScreenshotAnimationsOption = \"disabled\" | \"allow\";\nexport type ScreenshotCaretOption = \"hide\" | \"initial\";\nexport type ScreenshotScaleOption = \"css\" | \"device\";\n\nexport interface ScreenshotClip {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n}\n\nexport interface ScreenshotOptions {\n  animations?: ScreenshotAnimationsOption;\n  caret?: ScreenshotCaretOption;\n  clip?: ScreenshotClip;\n  fullPage?: boolean;\n  mask?: Locator[];\n  maskColor?: string;\n  omitBackground?: boolean;\n  path?: string;\n  quality?: number;\n  scale?: ScreenshotScaleOption;\n  style?: string;\n  timeout?: number;\n  type?: \"png\" | \"jpeg\";\n}\n"]}

package/dist/cjs/lib/v3/types/public/sdkErrors.d.ts

@@ -0,0 +1,168 @@
+import { ZodError } from "zod";
+export declare class StagehandError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+export declare class StagehandDefaultError extends StagehandError {
+    constructor(error?: unknown);
+}
+export declare class StagehandEnvironmentError extends StagehandError {
+    constructor(currentEnvironment: string, requiredEnvironment: string, feature: string);
+}
+export declare class MissingEnvironmentVariableError extends StagehandError {
+    constructor(missingEnvironmentVariable: string, feature: string);
+}
+export declare class UnsupportedModelError extends StagehandError {
+    constructor(supportedModels: string[], feature?: string);
+}
+export declare class UnsupportedModelProviderError extends StagehandError {
+    constructor(supportedProviders: string[], feature?: string);
+}
+export declare class UnsupportedAISDKModelProviderError extends StagehandError {
+    constructor(provider: string, supportedProviders: string[]);
+}
+export declare class InvalidAISDKModelFormatError extends StagehandError {
+    constructor(modelName: string);
+}
+export declare class StagehandNotInitializedError extends StagehandError {
+    constructor(prop: string);
+}
+export declare class BrowserbaseSessionNotFoundError extends StagehandError {
+    constructor();
+}
+export declare class CaptchaTimeoutError extends StagehandError {
+    constructor();
+}
+export declare class MissingLLMConfigurationError extends StagehandError {
+    constructor();
+}
+export declare class HandlerNotInitializedError extends StagehandError {
+    constructor(handlerType: string);
+}
+export declare class StagehandInvalidArgumentError extends StagehandError {
+    constructor(message: string);
+}
+export declare class CookieValidationError extends StagehandError {
+    constructor(message: string);
+}
+export declare class CookieSetError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StagehandElementNotFoundError extends StagehandError {
+    constructor(xpaths: string[]);
+}
+export declare class AgentScreenshotProviderError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StagehandMissingArgumentError extends StagehandError {
+    constructor(message: string);
+}
+export declare class CreateChatCompletionResponseError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StagehandEvalError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StagehandDomProcessError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StagehandLocatorError extends StagehandError {
+    constructor(action: string, selector: string, message: string);
+}
+export declare class StagehandClickError extends StagehandError {
+    constructor(message: string, selector: string);
+}
+export declare class LLMResponseError extends StagehandError {
+    constructor(primitive: string, message: string);
+}
+export declare class StagehandIframeError extends StagehandError {
+    constructor(frameUrl: string, message: string);
+}
+export declare class ContentFrameNotFoundError extends StagehandError {
+    constructor(selector: string);
+}
+export declare class XPathResolutionError extends StagehandError {
+    constructor(xpath: string);
+}
+export declare class ExperimentalApiConflictError extends StagehandError {
+    constructor();
+}
+export declare class ExperimentalNotConfiguredError extends StagehandError {
+    constructor(featureName: string);
+}
+export declare class CuaModelRequiredError extends StagehandError {
+    constructor(availableModels: readonly string[]);
+}
+export declare class ZodSchemaValidationError extends Error {
+    readonly received: unknown;
+    readonly issues: ReturnType<ZodError["format"]>;
+    constructor(received: unknown, issues: ReturnType<ZodError["format"]>);
+}
+export declare class StagehandInitError extends StagehandError {
+    constructor(message: string);
+}
+export declare class MCPConnectionError extends StagehandError {
+    readonly serverUrl: string;
+    readonly originalError: unknown;
+    constructor(serverUrl: string, originalError: unknown);
+}
+export declare class StagehandShadowRootMissingError extends StagehandError {
+    constructor(detail?: string);
+}
+export declare class StagehandShadowSegmentEmptyError extends StagehandError {
+    constructor();
+}
+export declare class StagehandShadowSegmentNotFoundError extends StagehandError {
+    constructor(segment: string, hint?: string);
+}
+export declare class ElementNotVisibleError extends StagehandError {
+    constructor(selector: string);
+}
+export declare class ResponseBodyError extends StagehandError {
+    constructor(message: string);
+}
+export declare class ResponseParseError extends StagehandError {
+    constructor(message: string);
+}
+export declare class TimeoutError extends StagehandError {
+    constructor(operation: string, timeoutMs: number);
+}
+export declare class ActTimeoutError extends TimeoutError {
+    constructor(timeoutMs: number);
+}
+export declare class ExtractTimeoutError extends TimeoutError {
+    constructor(timeoutMs: number);
+}
+export declare class ObserveTimeoutError extends TimeoutError {
+    constructor(timeoutMs: number);
+}
+export declare class PageNotFoundError extends StagehandError {
+    constructor(identifier: string);
+}
+export declare class ConnectionTimeoutError extends StagehandError {
+    constructor(message: string);
+}
+export declare class StreamingCallbacksInNonStreamingModeError extends StagehandError {
+    readonly invalidCallbacks: string[];
+    constructor(invalidCallbacks: string[]);
+}
+export declare class AgentAbortError extends StagehandError {
+    readonly reason: string;
+    constructor(reason?: string);
+}
+export declare class StagehandClosedError extends StagehandError {
+    constructor();
+}
+export declare class CdpConnectionClosedError extends StagehandError {
+    constructor(reason: string);
+}
+export declare class StagehandSetExtraHTTPHeadersError extends StagehandError {
+    readonly failures: string[];
+    constructor(failures: string[]);
+}
+export declare class StagehandSnapshotError extends StagehandError {
+    constructor(cause?: unknown);
+}
+export declare class UnderstudyCommandException extends StagehandError {
+    constructor(message: string, cause?: unknown);
+}