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

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>;
-}

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

@@ -1,40 +0,0 @@
-import Browserbase from "@browserbasehq/sdk";
-import { LogLine } from "./log";
-export interface StagehandAPIConstructorParams {
-    apiKey: string;
-    projectId: string;
-    logger: (message: LogLine) => void;
-}
-export interface ExecuteActionParams {
-    method: "act" | "extract" | "observe" | "navigate" | "end" | "agentExecute";
-    args?: unknown;
-    params?: unknown;
-}
-export interface StartSessionParams {
-    modelName: string;
-    modelApiKey: string;
-    domSettleTimeoutMs: number;
-    verbose: number;
-    debugDom: boolean;
-    systemPrompt?: string;
-    browserbaseSessionCreateParams?: Omit<Browserbase.Sessions.SessionCreateParams, "projectId"> & {
-        projectId?: string;
-    };
-    selfHeal?: boolean;
-    waitForCaptchaSolves?: boolean;
-    actionTimeoutMs?: number;
-    browserbaseSessionID?: string;
-}
-export interface StartSessionResult {
-    sessionId: string;
-    available?: boolean;
-}
-export interface SuccessResponse<T> {
-    success: true;
-    data: T;
-}
-export interface ErrorResponse {
-    success: false;
-    message: string;
-}
-export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;

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

@@ -1,71 +0,0 @@
-import type { AgentResult } from "@/lib/v3/types/agent";
-import type { Action } from "@/lib/v3/types/stagehand";
-import type { LoadState } from "@/lib/v3/types";
-export interface CachedActEntry {
-    version: 1;
-    instruction: string;
-    url: string;
-    variables: Record<string, string>;
-    actions: Action[];
-    actionDescription?: string;
-    message?: string;
-}
-export type AgentReplayStep = AgentReplayActStep | AgentReplayFillFormStep | AgentReplayGotoStep | AgentReplayScrollStep | AgentReplayWaitStep | AgentReplayNavBackStep | {
-    type: string;
-    [key: string]: unknown;
-};
-export interface AgentReplayActStep {
-    type: "act";
-    instruction: string;
-    actions?: Action[];
-    actionDescription?: string;
-    message?: string;
-    timeout?: number;
-}
-export interface AgentReplayFillFormStep {
-    type: "fillForm";
-    fields?: Array<{
-        action: string;
-        value: string;
-    }>;
-    observeResults?: Action[];
-    actions?: Action[];
-}
-export interface AgentReplayGotoStep {
-    type: "goto";
-    url: string;
-    waitUntil?: LoadState;
-}
-export interface AgentReplayScrollStep {
-    type: "scroll";
-    deltaX?: number;
-    deltaY?: number;
-    anchor?: {
-        x: number;
-        y: number;
-    };
-}
-export interface AgentReplayWaitStep {
-    type: "wait";
-    timeMs: number;
-}
-export interface AgentReplayNavBackStep {
-    type: "navback";
-    waitUntil?: LoadState;
-}
-export interface SanitizedAgentExecuteOptions {
-    maxSteps?: number;
-    autoScreenshot?: boolean;
-    waitBetweenActions?: number;
-    context?: string;
-}
-export interface CachedAgentEntry {
-    version: 1;
-    instruction: string;
-    startUrl: string;
-    options: SanitizedAgentExecuteOptions;
-    configSignature: string;
-    steps: AgentReplayStep[];
-    result: AgentResult;
-    timestamp: string;
-}

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

@@ -1,2 +0,0 @@
-export type EncodedId = `${number}-${number}`;
-export declare const ID_PATTERN: RegExp;

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

@@ -1,71 +0,0 @@
-import { z } from "zod/v3";
-import type { AvailableModel } from "../types/model";
-import type { LogLine } from "../types/log";
-import type { AgentInstance } from "../types/agent";
-import type { EvalCase } from "braintrust";
-import type { V3 } from "@/lib/v3/v3";
-import { EvalLogger } from "@/evals/logger";
-export type StagehandInitResult = {
-    v3?: V3;
-    v3Agent?: AgentInstance;
-    logger: EvalLogger;
-    debugUrl: string;
-    sessionUrl: string;
-    modelName: AvailableModel;
-    agent: AgentInstance;
-};
-export type EvalFunction = (taskInput: StagehandInitResult & {
-    input: EvalInput;
-}) => Promise<{
-    _success: boolean;
-    logs: LogLine[];
-    debugUrl: string;
-    sessionUrl: string;
-    error?: unknown;
-}>;
-export declare const EvalCategorySchema: z.ZodEnum<["observe", "act", "combination", "extract", "experimental", "targeted_extract", "regression", "regression_llm_providers", "llm_clients", "agent", "external_agent_benchmarks"]>;
-export type EvalCategory = z.infer<typeof EvalCategorySchema>;
-export interface EvalInput {
-    name: string;
-    modelName: AvailableModel;
-    params?: Record<string, unknown>;
-}
-export interface Testcase extends EvalCase<EvalInput, unknown, {
-    model: AvailableModel;
-    test: string;
-    categories?: string[];
-}> {
-    input: EvalInput;
-    name: string;
-    tags: string[];
-    metadata: {
-        model: AvailableModel;
-        test: string;
-        categories?: string[];
-    };
-    expected: unknown;
-}
-export interface SummaryResult {
-    input: EvalInput;
-    output: {
-        _success: boolean;
-    };
-    name: string;
-    score: number;
-}
-export interface EvalArgs<TInput, TOutput, TExpected> {
-    input: TInput;
-    output: TOutput;
-    expected: TExpected;
-    metadata?: {
-        model: AvailableModel;
-        test: string;
-    };
-}
-export interface EvalResult {
-    name: string;
-    score: number;
-}
-export type LogLineEval = LogLine & {
-    parsedAuxiliary?: string | object;
-};

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

@@ -1,40 +0,0 @@
-export 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;
-};
-export 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
- */
-export 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;
-}

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

@@ -1,11 +0,0 @@
-import { LanguageModel } from "ai";
-export interface LLMTool {
-    type: "function";
-    name: string;
-    description: string;
-    parameters: Record<string, unknown>;
-}
-export type AISDKProvider = (modelName: string) => LanguageModel;
-export type AISDKCustomProvider = (options: {
-    apiKey: string;
-}) => AISDKProvider;

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

@@ -1,23 +0,0 @@
-export type LogLevel = 0 | 1 | 2;
-/**
- * Mapping between numeric log levels and their names
- *
- * 0 - error/warn - Critical issues or important warnings
- * 1 - info - Standard information messages
- * 2 - debug - Detailed information for debugging
- */
-export declare const LOG_LEVEL_NAMES: Record<LogLevel, string>;
-export type LogLine = {
-    id?: string;
-    category?: string;
-    message: string;
-    level?: LogLevel;
-    timestamp?: string;
-    auxiliary?: {
-        [key: string]: {
-            value: string;
-            type: "object" | "string" | "html" | "integer" | "float" | "boolean";
-        };
-    };
-};
-export type Logger = (logLine: LogLine) => void;

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

@@ -1,20 +0,0 @@
-import type { ClientOptions as AnthropicClientOptions } from "@anthropic-ai/sdk";
-import type { ClientOptions as OpenAIClientOptions } from "openai";
-import { z } from "zod/v3";
-export declare const AvailableModelSchema: z.ZodEnum<["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", "claude-3-5-sonnet-latest", "claude-3-5-sonnet-20241022", "claude-3-5-sonnet-20240620", "claude-3-7-sonnet-latest", "claude-3-7-sonnet-20250219", "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"]>;
-export type AvailableModel = z.infer<typeof AvailableModelSchema> | string;
-export type ModelProvider = "openai" | "anthropic" | "cerebras" | "groq" | "google" | "aisdk";
-export type ClientOptions = OpenAIClientOptions | AnthropicClientOptions;
-export type ModelConfiguration = AvailableModel | (ClientOptions & {
-    modelName: AvailableModel;
-});
-export interface AnthropicJsonSchemaObject {
-    definitions?: {
-        MySchema?: {
-            properties?: Record<string, unknown>;
-            required?: string[];
-        };
-    };
-    properties?: Record<string, unknown>;
-    required?: string[];
-}

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

@@ -1,6 +0,0 @@
-export interface GotoOptions {
-    timeout?: number;
-    waitUntil?: "load" | "domcontentloaded" | "networkidle" | "commit";
-    referer?: string;
-    frameId?: string;
-}

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

@@ -1,113 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/dist/esm/client";
-import { ToolSet } from "ai";
-import { z } from "zod/v3";
-import { AgentProviderType } from "./agent";
-import { ModelConfiguration } from "./model";
-export interface ActOptions {
-    action: string;
-    model?: ModelConfiguration;
-    variables?: Record<string, string>;
-    domSettleTimeoutMs?: number;
-    timeoutMs?: number;
-    iframes?: boolean;
-    frameId?: string;
-}
-export interface ActResult {
-    success: boolean;
-    message: string;
-    actionDescription: string;
-    actions: Action[];
-}
-export interface ExtractOptions<T extends z.AnyZodObject> {
-    instruction?: string;
-    schema?: T;
-    model?: ModelConfiguration;
-    domSettleTimeoutMs?: number;
-    /**
-     * @deprecated The `useTextExtract` parameter has no effect in this version of Stagehand and will be removed in later versions.
-     */
-    useTextExtract?: boolean;
-    selector?: string;
-    iframes?: boolean;
-    frameId?: string;
-}
-export type ExtractResult<T extends z.AnyZodObject> = z.infer<T>;
-export interface ObserveOptions {
-    instruction?: string;
-    model?: ModelConfiguration;
-    domSettleTimeoutMs?: number;
-    returnAction?: boolean;
-    selector?: string;
-    /**
-     * @deprecated The `onlyVisible` parameter has no effect in this version of Stagehand and will be removed in later versions.
-     */
-    onlyVisible?: boolean;
-    drawOverlay?: boolean;
-    iframes?: boolean;
-    frameId?: string;
-}
-export interface Action {
-    selector: string;
-    description: string;
-    backendNodeId?: number;
-    method?: string;
-    arguments?: string[];
-}
-/**
- * Configuration for agent functionality
- */
-export interface AgentConfig {
-    /**
-     * The provider to use for agent functionality
-     */
-    provider?: AgentProviderType;
-    /**
-     * The model to use for agent functionality
-     */
-    model?: string;
-    /**
-     * The model to use for tool execution (observe/act calls within agent tools).
-     * 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;
-    /**
-     * Custom instructions to provide to the agent
-     */
-    instructions?: string;
-    /**
-     * Additional options to pass to the agent client
-     */
-    options?: Record<string, unknown>;
-    /**
-     * MCP integrations - Array of Client objects
-     */
-    integrations?: (Client | string)[];
-    /**
-     * Tools passed to the agent client
-     */
-    tools?: ToolSet;
-}
-export interface HistoryEntry {
-    method: "act" | "extract" | "observe" | "navigate";
-    parameters: unknown;
-    result: unknown;
-    timestamp: string;
-}
-/**
- * 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`.
- */
-export interface ZodPathSegments {
-    /**
-     * The ordered list of keys/indices leading from the schema root
-     * to the targeted field.
-     */
-    segments: Array<string | number>;
-}

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

@@ -1,18 +0,0 @@
-export declare class StagehandAPIError extends Error {
-    constructor(message: string);
-}
-export declare class StagehandAPIUnauthorizedError extends StagehandAPIError {
-    constructor(message?: string);
-}
-export declare class StagehandHttpError extends StagehandAPIError {
-    constructor(message: string);
-}
-export declare class StagehandServerError extends StagehandAPIError {
-    constructor(message: string);
-}
-export declare class StagehandResponseBodyError extends StagehandAPIError {
-    constructor();
-}
-export declare class StagehandResponseParseError extends StagehandAPIError {
-    constructor(message: string);
-}

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

@@ -1,104 +0,0 @@
-import { ZodError } from "zod/v3";
-export declare class StagehandError extends Error {
-    constructor(message: string);
-}
-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 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 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 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);
-}