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

package/dist/lib/v3/dom/piercer.entry.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/dom/piercer.runtime.d.ts

@@ -1,25 +0,0 @@
-export interface V3ShadowPatchOptions {
-    debug?: boolean;
-    tagExisting?: boolean;
-}
-export interface StagehandV3Backdoor {
-    /** Closed shadow-root accessors */
-    getClosedRoot(host: Element): ShadowRoot | undefined;
-    /** Stats + quick health check */
-    stats(): {
-        installed: true;
-        url: string;
-        isTop: boolean;
-        open: number;
-        closed: number;
-    };
-    /** Simple composed-tree resolver (axis '/', '//' and trailing [n] only; no iframe hops) */
-    resolveSimpleXPath(xp: string): Element | null;
-}
-declare global {
-    interface Window {
-        __stagehandV3Injected?: boolean;
-        __stagehandV3__?: StagehandV3Backdoor;
-    }
-}
-export declare function installV3ShadowPiercer(opts?: V3ShadowPatchOptions): void;

package/dist/lib/v3/handlers/actHandler.d.ts

@@ -1,18 +0,0 @@
-import { ActHandlerParams, V3FunctionName } from "@/lib/v3/types";
-import { LLMClient } from "../llm/LLMClient";
-import { AvailableModel, ClientOptions } from "../types/model";
-import type { Page } from "../understudy/page";
-import type { Action, ActResult } from "../types/stagehand";
-export declare class ActHandler {
-    private readonly llmClient;
-    private readonly defaultModelName;
-    private readonly defaultClientOptions;
-    private readonly systemPrompt;
-    private readonly logInferenceToFile;
-    private readonly selfHeal;
-    private readonly onMetrics?;
-    private readonly defaultDomSettleTimeoutMs?;
-    constructor(llmClient: LLMClient, defaultModelName: AvailableModel, defaultClientOptions: ClientOptions, systemPrompt?: string, logInferenceToFile?: boolean, selfHeal?: boolean, onMetrics?: (functionName: V3FunctionName, promptTokens: number, completionTokens: number, inferenceTimeMs: number) => void, defaultDomSettleTimeoutMs?: number);
-    act(params: ActHandlerParams): Promise<ActResult>;
-    actFromObserveResult(action: Action, page: Page, domSettleTimeoutMs?: number): Promise<ActResult>;
-}

package/dist/lib/v3/handlers/extractHandler.d.ts

@@ -1,29 +0,0 @@
-import { z, ZodTypeAny } from "zod/v3";
-import { ExtractHandlerParams, V3FunctionName } from "@/lib/v3/types";
-import { LLMClient } from "../llm/LLMClient";
-import { AvailableModel, ClientOptions } from "../types/model";
-import { ZodPathSegments } from "../types/stagehand";
-/**
- * Scans the provided Zod schema for any `z.string().url()` fields and
- * replaces them with `z.number()`.
- *
- * @param schema - The Zod object schema to transform.
- * @returns A tuple containing:
- *   1. The transformed schema (or the original schema if no changes were needed).
- *   2. An array of {@link ZodPathSegments} objects representing all the replaced URL fields,
- *      with each path segment showing where in the schema the replacement occurred.
- */
-export declare function transformUrlStringsToNumericIds<T extends ZodTypeAny>(schema: T): [T, ZodPathSegments[]];
-export declare class ExtractHandler {
-    private readonly llmClient;
-    private readonly defaultModelName;
-    private readonly defaultClientOptions;
-    private readonly systemPrompt;
-    private readonly logInferenceToFile;
-    private readonly experimental;
-    private readonly onMetrics?;
-    constructor(llmClient: LLMClient, defaultModelName: AvailableModel, defaultClientOptions: ClientOptions, systemPrompt?: string, logInferenceToFile?: boolean, experimental?: boolean, onMetrics?: (functionName: V3FunctionName, promptTokens: number, completionTokens: number, inferenceTimeMs: number) => void);
-    extract<T extends ZodTypeAny>(params: ExtractHandlerParams<T>): Promise<z.infer<T> | {
-        pageText: string;
-    }>;
-}

package/dist/lib/v3/handlers/handlerUtils/actHandlerUtils.d.ts

@@ -1,18 +0,0 @@
-import { Frame } from "../../understudy/frame";
-import { Locator } from "../../understudy/locator";
-import type { Page } from "../../understudy/page";
-export declare class UnderstudyCommandException extends Error {
-    constructor(message: string);
-}
-export interface UnderstudyMethodHandlerContext {
-    method: string;
-    locator: Locator;
-    xpath: string;
-    args: ReadonlyArray<string>;
-    frame: Frame;
-    page: Page;
-    initialUrl: string;
-    domSettleTimeoutMs?: number;
-}
-export declare function performUnderstudyMethod(page: Page, frame: Frame, method: string, rawXPath: string, args: ReadonlyArray<unknown>, domSettleTimeoutMs?: number): Promise<void>;
-export declare function selectOption(ctx: UnderstudyMethodHandlerContext): Promise<void>;

package/dist/lib/v3/handlers/observeHandler.d.ts

@@ -1,15 +0,0 @@
-import { ObserveHandlerParams, V3FunctionName } from "@/lib/v3/types";
-import { AvailableModel, ClientOptions } from "../types/model";
-import { LLMClient } from "../llm/LLMClient";
-import { Action } from "../types/stagehand";
-export declare class ObserveHandler {
-    private readonly llmClient;
-    private readonly defaultModelName;
-    private readonly defaultClientOptions;
-    private readonly systemPrompt;
-    private readonly logInferenceToFile;
-    private readonly experimental;
-    private readonly onMetrics?;
-    constructor(llmClient: LLMClient, defaultModelName: AvailableModel, defaultClientOptions: ClientOptions, systemPrompt?: string, logInferenceToFile?: boolean, experimental?: boolean, onMetrics?: (functionName: V3FunctionName, promptTokens: number, completionTokens: number, inferenceTimeMs: number) => void);
-    observe(params: ObserveHandlerParams): Promise<Action[]>;
-}

package/dist/lib/v3/handlers/v3AgentHandler.d.ts

@@ -1,17 +0,0 @@
-import { AgentExecuteOptions, AgentResult } from "../types/agent";
-import { LogLine } from "../types/log";
-import { LLMClient } from "../llm/LLMClient";
-import { ToolSet } from "ai";
-import { V3 } from "@/lib/v3/v3";
-export declare class V3AgentHandler {
-    private v3;
-    private logger;
-    private llmClient;
-    private executionModel?;
-    private systemInstructions?;
-    private mcpTools?;
-    constructor(v3: V3, logger: (message: LogLine) => void, llmClient: LLMClient, executionModel?: string, systemInstructions?: string, mcpTools?: ToolSet);
-    execute(instructionOrOptions: string | AgentExecuteOptions): Promise<AgentResult>;
-    private buildSystemPrompt;
-    private createTools;
-}

package/dist/lib/v3/handlers/v3CuaAgentHandler.d.ts

@@ -1,26 +0,0 @@
-import { AgentExecuteOptions, AgentHandlerOptions, AgentResult } from "../types/agent";
-import { LogLine } from "../types/log";
-import { V3 } from "@/lib/v3/v3";
-import { ToolSet } from "ai";
-export declare class V3CuaAgentHandler {
-    private v3;
-    private agent;
-    private provider;
-    private logger;
-    private agentClient;
-    private options;
-    constructor(v3: V3, logger: (message: LogLine) => void, options: AgentHandlerOptions, tools?: ToolSet);
-    private setupAgentClient;
-    execute(optionsOrInstruction: AgentExecuteOptions | string): Promise<AgentResult>;
-    private executeAction;
-    private ensureXPath;
-    private describePointerAction;
-    private describeTypeAction;
-    private describeDragAction;
-    private buildInstructionFallback;
-    private recordCuaActStep;
-    private updateClientViewport;
-    private updateClientUrl;
-    captureAndSendScreenshot(): Promise<unknown>;
-    private injectCursor;
-}

package/dist/lib/v3/index.d.ts

@@ -1,10 +0,0 @@
-export { V3 } from "./v3";
-export { V3 as Stagehand } from "./v3";
-export * from "./types/agent";
-export * from "./types/model";
-export * from "./types/log";
-export * from "./types/stagehand";
-export * from "./types/stagehandApiErrors";
-export * from "./types/stagehandErrors";
-export * from "./llm/LLMClient";
-export { connectToMCPServer } from "../v3/mcp/connection";

package/dist/lib/v3/launch/browserbase.d.ts

@@ -1,8 +0,0 @@
-import Browserbase from "@browserbasehq/sdk";
-export declare function createBrowserbaseSession(apiKey: string, projectId: string, params?: Omit<Browserbase.Sessions.SessionCreateParams, "projectId"> & {
-    projectId?: string;
-}, resumeSessionId?: string): Promise<{
-    ws: string;
-    sessionId: string;
-    bb: Browserbase;
-}>;

package/dist/lib/v3/launch/local.d.ts

@@ -1,13 +0,0 @@
-import { LaunchedChrome } from "chrome-launcher";
-interface LaunchLocalOptions {
-    chromePath?: string;
-    chromeFlags?: string[];
-    headless?: boolean;
-    userDataDir?: string;
-    connectTimeoutMs?: number;
-}
-export declare function launchLocalChrome(opts: LaunchLocalOptions): Promise<{
-    ws: string;
-    chrome: LaunchedChrome;
-}>;
-export {};

package/dist/lib/v3/llm/AnthropicClient.d.ts

@@ -1,16 +0,0 @@
-import { ClientOptions } from "@anthropic-ai/sdk";
-import { LogLine } from "../types/log";
-import { AvailableModel } from "../types/model";
-import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient";
-export declare class AnthropicClient extends LLMClient {
-    type: "anthropic";
-    private client;
-    clientOptions: ClientOptions;
-    constructor({ modelName, clientOptions, userProvidedInstructions, }: {
-        logger: (message: LogLine) => void;
-        modelName: AvailableModel;
-        clientOptions?: ClientOptions;
-        userProvidedInstructions?: string;
-    });
-    createChatCompletion<T = LLMResponse>({ options, retries, logger, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/llm/CerebrasClient.d.ts

@@ -1,17 +0,0 @@
-import type { ClientOptions } from "openai";
-import { LogLine } from "../types/log";
-import { AvailableModel } from "../types/model";
-import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient";
-export declare class CerebrasClient extends LLMClient {
-    type: "cerebras";
-    private client;
-    clientOptions: ClientOptions;
-    hasVision: boolean;
-    constructor({ modelName, clientOptions, userProvidedInstructions, }: {
-        logger: (message: LogLine) => void;
-        modelName: AvailableModel;
-        clientOptions?: ClientOptions;
-        userProvidedInstructions?: string;
-    });
-    createChatCompletion<T = LLMResponse>({ options, retries, logger, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/llm/GoogleClient.d.ts

@@ -1,19 +0,0 @@
-import { LogLine } from "../types/log";
-import { AvailableModel, ClientOptions } from "../types/model";
-import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient";
-export declare class GoogleClient extends LLMClient {
-    type: "google";
-    private client;
-    clientOptions: ClientOptions;
-    hasVision: boolean;
-    private logger;
-    constructor({ logger, // Added logger based on other clients
-    modelName, clientOptions, }: {
-        logger: (message: LogLine) => void;
-        modelName: AvailableModel;
-        clientOptions?: ClientOptions;
-    });
-    private formatMessages;
-    private formatTools;
-    createChatCompletion<T = LLMResponse>({ options, logger, retries, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/llm/GroqClient.d.ts

@@ -1,17 +0,0 @@
-import type { ClientOptions } from "openai";
-import { LogLine } from "../types/log";
-import { AvailableModel } from "../types/model";
-import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient";
-export declare class GroqClient extends LLMClient {
-    type: "groq";
-    private client;
-    clientOptions: ClientOptions;
-    hasVision: boolean;
-    constructor({ modelName, clientOptions, userProvidedInstructions, }: {
-        logger: (message: LogLine) => void;
-        modelName: AvailableModel;
-        clientOptions?: ClientOptions;
-        userProvidedInstructions?: string;
-    });
-    createChatCompletion<T = LLMResponse>({ options, retries, logger, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/llm/LLMClient.d.ts

@@ -1,99 +0,0 @@
-import { LLMTool } from "../types/llm";
-import { embed, embedMany, experimental_generateImage, experimental_generateSpeech, experimental_transcribe, generateObject, generateText, LanguageModel, streamObject, streamText } from "ai";
-import { ZodType } from "zod/v3";
-import { LogLine } from "../types/log";
-import { AvailableModel, ClientOptions } from "../types/model";
-export interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: ChatMessageContent;
-}
-export type ChatMessageContent = string | (ChatMessageImageContent | ChatMessageTextContent)[];
-export interface ChatMessageImageContent {
-    type: string;
-    image_url?: {
-        url: string;
-    };
-    text?: string;
-    source?: {
-        type: string;
-        media_type: string;
-        data: string;
-    };
-}
-export interface ChatMessageTextContent {
-    type: string;
-    text: string;
-}
-export declare const AnnotatedScreenshotText = "This is a screenshot of the current page state with the elements annotated on it. Each element id is annotated with a number to the top left of it. Duplicate annotations at the same location are under each other vertically.";
-export interface ChatCompletionOptions {
-    messages: ChatMessage[];
-    temperature?: number;
-    top_p?: number;
-    frequency_penalty?: number;
-    presence_penalty?: number;
-    image?: {
-        buffer: Buffer;
-        description?: string;
-    };
-    response_model?: {
-        name: string;
-        schema: ZodType;
-    };
-    tools?: LLMTool[];
-    tool_choice?: "auto" | "none" | "required";
-    maxTokens?: number;
-    requestId?: string;
-}
-export type LLMResponse = {
-    id: string;
-    object: string;
-    created: number;
-    model: string;
-    choices: {
-        index: number;
-        message: {
-            role: string;
-            content: string | null;
-            tool_calls: {
-                id: string;
-                type: string;
-                function: {
-                    name: string;
-                    arguments: string;
-                };
-            }[];
-        };
-        finish_reason: string;
-    }[];
-    usage: {
-        prompt_tokens: number;
-        completion_tokens: number;
-        total_tokens: number;
-    };
-};
-export interface CreateChatCompletionOptions {
-    options: ChatCompletionOptions;
-    logger: (message: LogLine) => void;
-    retries?: number;
-}
-export declare abstract class LLMClient {
-    type: "openai" | "anthropic" | "cerebras" | "groq" | (string & {});
-    modelName: AvailableModel | (string & {});
-    hasVision: boolean;
-    clientOptions: ClientOptions;
-    userProvidedInstructions?: string;
-    constructor(modelName: AvailableModel, userProvidedInstructions?: string);
-    abstract createChatCompletion<T = LLMResponse & {
-        usage?: LLMResponse["usage"];
-    }>(options: CreateChatCompletionOptions): Promise<T>;
-    generateObject: typeof generateObject;
-    generateText: typeof generateText;
-    streamText: typeof streamText;
-    streamObject: typeof streamObject;
-    generateImage: typeof experimental_generateImage;
-    embed: typeof embed;
-    embedMany: typeof embedMany;
-    transcribe: typeof experimental_transcribe;
-    generateSpeech: typeof experimental_generateSpeech;
-    getLanguageModel?(): LanguageModel;
-}

package/dist/lib/v3/llm/LLMProvider.d.ts

@@ -1,10 +0,0 @@
-import { LogLine } from "../types/log";
-import { AvailableModel, ClientOptions, ModelProvider } from "../types/model";
-import { LLMClient } from "./LLMClient";
-export declare function getAISDKLanguageModel(subProvider: string, subModelName: string, apiKey?: string, baseURL?: string): import("ai/dist").LanguageModelV1;
-export declare class LLMProvider {
-    private logger;
-    constructor(logger: (message: LogLine) => void);
-    getClient(modelName: AvailableModel, clientOptions?: ClientOptions): LLMClient;
-    static getModelProvider(modelName: AvailableModel): ModelProvider;
-}

package/dist/lib/v3/llm/OpenAIClient.d.ts

@@ -1,15 +0,0 @@
-import { ClientOptions } from "openai";
-import { LogLine } from "../types/log";
-import { AvailableModel } from "../types/model";
-import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient";
-export declare class OpenAIClient extends LLMClient {
-    type: "openai";
-    private client;
-    clientOptions: ClientOptions;
-    constructor({ modelName, clientOptions, }: {
-        logger: (message: LogLine) => void;
-        modelName: AvailableModel;
-        clientOptions?: ClientOptions;
-    });
-    createChatCompletion<T = LLMResponse>({ options: optionsInitial, logger, retries, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/llm/aisdk.d.ts

@@ -1,15 +0,0 @@
-import { LanguageModel } from "ai";
-import { ChatCompletion } from "openai/resources";
-import { LogLine } from "../types/log";
-import { CreateChatCompletionOptions, LLMClient } from "./LLMClient";
-export declare class AISdkClient extends LLMClient {
-    type: "aisdk";
-    private model;
-    private logger?;
-    constructor({ model, logger, }: {
-        model: LanguageModel;
-        logger?: (message: LogLine) => void;
-    });
-    getLanguageModel(): LanguageModel;
-    createChatCompletion<T = ChatCompletion>({ options, }: CreateChatCompletionOptions): Promise<T>;
-}

package/dist/lib/v3/logger.d.ts

@@ -1,48 +0,0 @@
-import type { LogLine } from "./types/log";
-/**
- * Stagehand V3 Logging
- *
- * Design goals:
- * - Provide a single global logging sink (Pino or console) for general output.
- * - Support concurrent V3 instances by routing logs to an instance-bound external logger
- *   (e.g., Braintrust EvalLogger) without cross-talk.
- * - Keep the public API simple: per-instance binding happens via V3, not here.
- *
- * How it works:
- * - initV3Logger(): initializes the global logger backend (Pino if enabled, otherwise a
- *   lightweight console logger). No external logger is bound globally.
- * - bindInstanceLogger()/unbindInstanceLogger(): registers an external logger callback per
- *   instance id for use by v3Logger.
- * - withInstanceLogContext(): establishes a context so v3Logger can route logs to the
- *   correct instance's external logger during that call tree.
- * - v3Logger(): preferred entrypoint for emitting structured logs from V3 internals and handlers.
- *   It routes to the instance logger when available, or falls back to the global backend.
- */
-type Verbosity = 0 | 1 | 2;
-type MinimalLogger = {
-    log: (line: LogLine) => void;
-    setVerbosity: (v: Verbosity) => void;
-    error: (msg: string, data?: Record<string, unknown>) => void;
-    info: (msg: string, data?: Record<string, unknown>) => void;
-    debug: (msg: string, data?: Record<string, unknown>) => void;
-};
-export declare function bindInstanceLogger(instanceId: string, logger: (line: LogLine) => void): void;
-export declare function unbindInstanceLogger(instanceId: string): void;
-export declare function withInstanceLogContext<T>(instanceId: string, fn: () => T): T;
-/**
- * Initialize the global V3 logger backend.
- * - When disablePino is false (default), uses the Stagehand Pino logger for rich console output.
- * - When disablePino is true, uses a lightweight console logger that respects verbosity.
- *
- * Note: This function never binds an external logger globally. Use bindInstanceLogger()
- * with withInstanceLogContext() for per-instance routing.
- */
-export declare function initV3Logger(opts?: {
-    verbose?: Verbosity;
-    disablePino?: boolean;
-    pretty?: boolean;
-}): Promise<void>;
-export declare function getV3Logger(): MinimalLogger;
-export declare function v3Logger(line: LogLine): void;
-export declare function setV3Verbosity(v: Verbosity): void;
-export {};

package/dist/lib/v3/mcp/connection.d.ts

@@ -1,11 +0,0 @@
-import { Client, ClientOptions } from "@modelcontextprotocol/sdk/client/index.js";
-export interface ConnectToMCPServerOptions {
-    serverUrl: string | URL;
-    clientOptions?: ClientOptions;
-}
-export interface StdioServerConfig {
-    command: string;
-    args?: string[];
-    env?: Record<string, string>;
-}
-export declare const connectToMCPServer: (serverConfig: string | URL | StdioServerConfig | ConnectToMCPServerOptions) => Promise<Client>;

package/dist/lib/v3/mcp/utils.d.ts

@@ -1,3 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/dist/esm/client";
-import { ToolSet } from "ai/dist";
-export declare const resolveTools: (clients: (Client | string)[], userTools: ToolSet) => Promise<ToolSet>;

package/dist/lib/v3/tests/default-page-tracking.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/tests/downloads.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/tests/perform-understudy-method.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/tests/shadow-iframe.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/tests/timeouts.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/tests/v3.bb.config.d.ts

@@ -1,4 +0,0 @@
-import type { V3Options } from "@/lib/v3/types";
-export declare const v3BBTestConfig: V3Options;
-export declare function getV3BBTestConfig(overrides?: Partial<V3Options>): V3Options;
-export default getV3BBTestConfig;

package/dist/lib/v3/tests/v3.config.d.ts

@@ -1,4 +0,0 @@
-import type { V3Options } from "@/lib/v3/types";
-export declare const v3TestConfig: V3Options;
-export declare function getV3TestConfig(overrides?: Partial<V3Options>): V3Options;
-export default getV3TestConfig;

package/dist/lib/v3/tests/v3.playwright.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("@playwright/test").PlaywrightTestConfig<{}, {}>;
-export default _default;

package/dist/lib/v3/tests/xpath-for-location-deep.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/v3/types/act.d.ts

@@ -1,10 +0,0 @@
-export declare enum SupportedPlaywrightAction {
-    CLICK = "click",
-    FILL = "fill",
-    TYPE = "type",
-    PRESS = "press",
-    SCROLL = "scrollTo",
-    NEXT_CHUNK = "nextChunk",
-    PREV_CHUNK = "prevChunk",
-    SELECT_OPTION_FROM_DROPDOWN = "selectOptionFromDropdown"
-}

package/dist/lib/v3/types/agent.d.ts

@@ -1,132 +0,0 @@
-import { LogLine } from "./log";
-export interface AgentAction {
-    type: string;
-    reasoning?: string;
-    taskCompleted?: boolean;
-    action?: string;
-    timeMs?: number;
-    pageText?: string;
-    pageUrl?: string;
-    instruction?: string;
-    [key: string]: unknown;
-}
-export interface AgentResult {
-    success: boolean;
-    message: string;
-    actions: AgentAction[];
-    completed: boolean;
-    metadata?: Record<string, unknown>;
-    usage?: {
-        input_tokens: number;
-        output_tokens: number;
-        inference_time_ms: number;
-    };
-}
-export interface AgentOptions {
-    maxSteps?: number;
-    autoScreenshot?: boolean;
-    waitBetweenActions?: number;
-    context?: string;
-}
-export interface AgentExecuteOptions extends AgentOptions {
-    instruction: string;
-}
-export type AgentProviderType = "openai" | "anthropic";
-export interface AgentClientOptions {
-    apiKey: string;
-    organization?: string;
-    baseURL?: string;
-    defaultMaxSteps?: number;
-    [key: string]: unknown;
-}
-export type AgentType = "openai" | "anthropic";
-export interface AgentExecutionOptions {
-    options: AgentExecuteOptions;
-    logger: (message: LogLine) => void;
-    retries?: number;
-}
-export interface AgentHandlerOptions {
-    modelName: string;
-    clientOptions?: Record<string, unknown>;
-    userProvidedInstructions?: string;
-    agentType: AgentType;
-    experimental?: boolean;
-}
-export interface ActionExecutionResult {
-    success: boolean;
-    error?: string;
-    data?: unknown;
-}
-export interface ToolUseItem extends ResponseItem {
-    type: "tool_use";
-    id: string;
-    name: string;
-    input: Record<string, unknown>;
-}
-export interface AnthropicMessage {
-    role: string;
-    content: string | Array<AnthropicContentBlock>;
-}
-export interface AnthropicContentBlock {
-    type: string;
-    [key: string]: unknown;
-}
-export interface AnthropicTextBlock extends AnthropicContentBlock {
-    type: "text";
-    text: string;
-}
-export interface AnthropicToolResult {
-    type: "tool_result";
-    tool_use_id: string;
-    content: string | Array<AnthropicContentBlock>;
-}
-export interface ResponseItem {
-    type: string;
-    id: string;
-    [key: string]: unknown;
-}
-export interface ComputerCallItem extends ResponseItem {
-    type: "computer_call";
-    call_id: string;
-    action: {
-        type: string;
-        [key: string]: unknown;
-    };
-    pending_safety_checks?: Array<{
-        id: string;
-        code: string;
-        message: string;
-    }>;
-}
-export interface FunctionCallItem extends ResponseItem {
-    type: "function_call";
-    call_id: string;
-    name: string;
-    arguments: string;
-}
-export type ResponseInputItem = {
-    role: string;
-    content: string;
-} | {
-    type: "computer_call_output";
-    call_id: string;
-    output: {
-        type: "input_image";
-        image_url: string;
-        current_url?: string;
-        error?: string;
-        [key: string]: unknown;
-    } | string;
-    acknowledged_safety_checks?: Array<{
-        id: string;
-        code: string;
-        message: string;
-    }>;
-} | {
-    type: "function_call_output";
-    call_id: string;
-    output: string;
-};
-export interface AgentInstance {
-    execute: (instructionOrOptions: string | AgentExecuteOptions) => Promise<AgentResult>;
-}