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

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

@@ -0,0 +1,161 @@
+import * as PublicApi from "./types/public/index.js";
+import { V3 } from "./v3.js";
+import { LLMClient } from "./llm/LLMClient.js";
+import { AgentProvider } from "./agent/AgentProvider.js";
+import { validateZodSchema, isRunningInBun, toGeminiSchema, getZodType, transformSchema, injectUrls, loadApiKeyFromEnv, trimTrailingTextNode, jsonSchemaToZod } from "../utils.js";
+import { toJsonSchema } from "./zodCompat.js";
+import { V3Evaluator } from "../v3Evaluator.js";
+import { tool } from "ai";
+import { getAISDKLanguageModel } from "./llm/LLMProvider.js";
+import { __internalCreateInMemoryAgentCacheHandle } from "./cache/serverAgentCache.js";
+export { V3 } from "./v3.js";
+export { V3 as Stagehand } from "./v3.js";
+export * from "./types/public/index.js";
+export { AnnotatedScreenshotText, LLMClient } from "./llm/LLMClient.js";
+export { AgentProvider, modelToAgentProviderMap, } from "./agent/AgentProvider.js";
+export type { AgentTools, AgentToolTypesMap, AgentUITools, AgentToolCall, AgentToolResult, } from "./agent/tools/index.js";
+export { validateZodSchema, isRunningInBun, toGeminiSchema, getZodType, transformSchema, injectUrls, providerEnvVarMap, loadApiKeyFromEnv, trimTrailingTextNode, jsonSchemaToZod, } from "../utils.js";
+export { isZod4Schema, isZod3Schema, toJsonSchema } from "./zodCompat.js";
+export { connectToMCPServer } from "./mcp/connection.js";
+export { V3Evaluator } from "../v3Evaluator.js";
+export { tool } from "ai";
+export { getAISDKLanguageModel } from "./llm/LLMProvider.js";
+export { __internalCreateInMemoryAgentCacheHandle } from "./cache/serverAgentCache.js";
+export { maybeRunShutdownSupervisorFromArgv as __internalMaybeRunShutdownSupervisorFromArgv } from "./shutdown/supervisor.js";
+export type { ServerAgentCacheHandle } from "./cache/serverAgentCache.js";
+export type { ChatMessage, ChatMessageContent, ChatMessageImageContent, ChatMessageTextContent, ChatCompletionOptions, LLMResponse, CreateChatCompletionOptions, LLMUsage, LLMParsedResponse, } from "./llm/LLMClient.js";
+export type { StagehandZodSchema, StagehandZodObject, InferStagehandSchema, JsonSchemaDocument, } from "./zodCompat.js";
+export type { JsonSchema, JsonSchemaProperty } from "../utils.js";
+declare const StagehandDefault: {
+    V3: typeof V3;
+    Stagehand: typeof V3;
+    AnnotatedScreenshotText: string;
+    LLMClient: typeof LLMClient;
+    AgentProvider: typeof AgentProvider;
+    modelToAgentProviderMap: Record<string, PublicApi.AgentType>;
+    validateZodSchema: typeof validateZodSchema;
+    isRunningInBun: typeof isRunningInBun;
+    toGeminiSchema: typeof toGeminiSchema;
+    getZodType: typeof getZodType;
+    transformSchema: typeof transformSchema;
+    injectUrls: typeof injectUrls;
+    providerEnvVarMap: Partial<Record<string, string | string[]>>;
+    loadApiKeyFromEnv: typeof loadApiKeyFromEnv;
+    trimTrailingTextNode: typeof trimTrailingTextNode;
+    jsonSchemaToZod: typeof jsonSchemaToZod;
+    isZod4Schema: (schema: import("./zodCompat.js").StagehandZodSchema) => schema is import("zod").ZodType & {
+        _zod: unknown;
+    };
+    isZod3Schema: (schema: import("./zodCompat.js").StagehandZodSchema) => schema is import("zod/v3").ZodTypeAny;
+    toJsonSchema: typeof toJsonSchema;
+    connectToMCPServer: (serverConfig: string | URL | import("./mcp/connection.js").StdioServerConfig | import("./mcp/connection.js").ConnectToMCPServerOptions) => Promise<import("@modelcontextprotocol/sdk/client/index.js").Client>;
+    V3Evaluator: typeof V3Evaluator;
+    tool: typeof tool;
+    getAISDKLanguageModel: typeof getAISDKLanguageModel;
+    __internalCreateInMemoryAgentCacheHandle: typeof __internalCreateInMemoryAgentCacheHandle;
+    __internalMaybeRunShutdownSupervisorFromArgv: (argv?: readonly string[]) => boolean;
+    Api: typeof PublicApi.Api;
+    AISdkClient: typeof PublicApi.AISdkClient;
+    CustomOpenAIClient: typeof PublicApi.CustomOpenAIClient;
+    AVAILABLE_CUA_MODELS: readonly ["openai/computer-use-preview", "openai/computer-use-preview-2025-03-11", "anthropic/claude-opus-4-5-20251101", "anthropic/claude-opus-4-6", "anthropic/claude-sonnet-4-6", "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", "google/gemini-3-flash-preview", "google/gemini-3-pro-preview", "microsoft/fara-7b"];
+    StagehandAPIError: typeof PublicApi.StagehandAPIError;
+    StagehandAPIUnauthorizedError: typeof PublicApi.StagehandAPIUnauthorizedError;
+    StagehandHttpError: typeof PublicApi.StagehandHttpError;
+    StagehandServerError: typeof PublicApi.StagehandServerError;
+    StagehandResponseBodyError: typeof PublicApi.StagehandResponseBodyError;
+    StagehandResponseParseError: typeof PublicApi.StagehandResponseParseError;
+    LOG_LEVEL_NAMES: Record<PublicApi.LogLevel, string>;
+    defaultExtractSchema: import("zod").ZodObject<{
+        extraction: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    pageTextSchema: import("zod").ZodObject<{
+        pageText: import("zod").ZodString;
+    }, import("zod/v4/core").$strip>;
+    V3FunctionName: typeof PublicApi.V3FunctionName;
+    localBrowserLaunchOptionsSchema: import("zod").ZodObject<{
+        args: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        executablePath: import("zod").ZodOptional<import("zod").ZodString>;
+        port: import("zod").ZodOptional<import("zod").ZodNumber>;
+        userDataDir: import("zod").ZodOptional<import("zod").ZodString>;
+        preserveUserDataDir: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        headless: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        devtools: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        chromiumSandbox: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        ignoreDefaultArgs: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodBoolean, import("zod").ZodArray<import("zod").ZodString>]>>;
+        proxy: import("zod").ZodOptional<import("zod").ZodObject<{
+            server: import("zod").ZodString;
+            bypass: import("zod").ZodOptional<import("zod").ZodString>;
+            username: import("zod").ZodOptional<import("zod").ZodString>;
+            password: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+        locale: import("zod").ZodOptional<import("zod").ZodString>;
+        viewport: import("zod").ZodOptional<import("zod").ZodObject<{
+            width: import("zod").ZodNumber;
+            height: import("zod").ZodNumber;
+        }, import("zod/v4/core").$strip>>;
+        deviceScaleFactor: import("zod").ZodOptional<import("zod").ZodNumber>;
+        hasTouch: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        ignoreHTTPSErrors: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        cdpUrl: import("zod").ZodOptional<import("zod").ZodString>;
+        cdpHeaders: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+        connectTimeoutMs: import("zod").ZodOptional<import("zod").ZodNumber>;
+        downloadsPath: import("zod").ZodOptional<import("zod").ZodString>;
+        acceptDownloads: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strict>;
+    ConsoleMessage: typeof PublicApi.ConsoleMessage;
+    Response: typeof PublicApi.Response;
+    StagehandError: typeof PublicApi.StagehandError;
+    StagehandDefaultError: typeof PublicApi.StagehandDefaultError;
+    StagehandEnvironmentError: typeof PublicApi.StagehandEnvironmentError;
+    MissingEnvironmentVariableError: typeof PublicApi.MissingEnvironmentVariableError;
+    UnsupportedModelError: typeof PublicApi.UnsupportedModelError;
+    UnsupportedModelProviderError: typeof PublicApi.UnsupportedModelProviderError;
+    UnsupportedAISDKModelProviderError: typeof PublicApi.UnsupportedAISDKModelProviderError;
+    InvalidAISDKModelFormatError: typeof PublicApi.InvalidAISDKModelFormatError;
+    StagehandNotInitializedError: typeof PublicApi.StagehandNotInitializedError;
+    BrowserbaseSessionNotFoundError: typeof PublicApi.BrowserbaseSessionNotFoundError;
+    CaptchaTimeoutError: typeof PublicApi.CaptchaTimeoutError;
+    MissingLLMConfigurationError: typeof PublicApi.MissingLLMConfigurationError;
+    HandlerNotInitializedError: typeof PublicApi.HandlerNotInitializedError;
+    StagehandInvalidArgumentError: typeof PublicApi.StagehandInvalidArgumentError;
+    CookieValidationError: typeof PublicApi.CookieValidationError;
+    CookieSetError: typeof PublicApi.CookieSetError;
+    StagehandElementNotFoundError: typeof PublicApi.StagehandElementNotFoundError;
+    AgentScreenshotProviderError: typeof PublicApi.AgentScreenshotProviderError;
+    StagehandMissingArgumentError: typeof PublicApi.StagehandMissingArgumentError;
+    CreateChatCompletionResponseError: typeof PublicApi.CreateChatCompletionResponseError;
+    StagehandEvalError: typeof PublicApi.StagehandEvalError;
+    StagehandDomProcessError: typeof PublicApi.StagehandDomProcessError;
+    StagehandLocatorError: typeof PublicApi.StagehandLocatorError;
+    StagehandClickError: typeof PublicApi.StagehandClickError;
+    LLMResponseError: typeof PublicApi.LLMResponseError;
+    StagehandIframeError: typeof PublicApi.StagehandIframeError;
+    ContentFrameNotFoundError: typeof PublicApi.ContentFrameNotFoundError;
+    XPathResolutionError: typeof PublicApi.XPathResolutionError;
+    ExperimentalApiConflictError: typeof PublicApi.ExperimentalApiConflictError;
+    ExperimentalNotConfiguredError: typeof PublicApi.ExperimentalNotConfiguredError;
+    CuaModelRequiredError: typeof PublicApi.CuaModelRequiredError;
+    ZodSchemaValidationError: typeof PublicApi.ZodSchemaValidationError;
+    StagehandInitError: typeof PublicApi.StagehandInitError;
+    MCPConnectionError: typeof PublicApi.MCPConnectionError;
+    StagehandShadowRootMissingError: typeof PublicApi.StagehandShadowRootMissingError;
+    StagehandShadowSegmentEmptyError: typeof PublicApi.StagehandShadowSegmentEmptyError;
+    StagehandShadowSegmentNotFoundError: typeof PublicApi.StagehandShadowSegmentNotFoundError;
+    ElementNotVisibleError: typeof PublicApi.ElementNotVisibleError;
+    ResponseBodyError: typeof PublicApi.ResponseBodyError;
+    ResponseParseError: typeof PublicApi.ResponseParseError;
+    TimeoutError: typeof PublicApi.TimeoutError;
+    ActTimeoutError: typeof PublicApi.ActTimeoutError;
+    ExtractTimeoutError: typeof PublicApi.ExtractTimeoutError;
+    ObserveTimeoutError: typeof PublicApi.ObserveTimeoutError;
+    PageNotFoundError: typeof PublicApi.PageNotFoundError;
+    ConnectionTimeoutError: typeof PublicApi.ConnectionTimeoutError;
+    StreamingCallbacksInNonStreamingModeError: typeof PublicApi.StreamingCallbacksInNonStreamingModeError;
+    AgentAbortError: typeof PublicApi.AgentAbortError;
+    StagehandClosedError: typeof PublicApi.StagehandClosedError;
+    CdpConnectionClosedError: typeof PublicApi.CdpConnectionClosedError;
+    StagehandSetExtraHTTPHeadersError: typeof PublicApi.StagehandSetExtraHTTPHeadersError;
+    StagehandSnapshotError: typeof PublicApi.StagehandSnapshotError;
+    UnderstudyCommandException: typeof PublicApi.UnderstudyCommandException;
+};
+export default StagehandDefault;

package/dist/esm/lib/v3/index.js

@@ -0,0 +1,55 @@
+import * as PublicApi from "./types/public/index.js";
+import { V3 } from "./v3.js";
+import { AnnotatedScreenshotText, LLMClient } from "./llm/LLMClient.js";
+import { AgentProvider, modelToAgentProviderMap, } from "./agent/AgentProvider.js";
+import { validateZodSchema, isRunningInBun, toGeminiSchema, getZodType, transformSchema, injectUrls, providerEnvVarMap, loadApiKeyFromEnv, trimTrailingTextNode, jsonSchemaToZod, } from "../utils.js";
+import { isZod4Schema, isZod3Schema, toJsonSchema } from "./zodCompat.js";
+import { connectToMCPServer } from "./mcp/connection.js";
+import { V3Evaluator } from "../v3Evaluator.js";
+import { tool } from "ai";
+import { getAISDKLanguageModel } from "./llm/LLMProvider.js";
+import { __internalCreateInMemoryAgentCacheHandle } from "./cache/serverAgentCache.js";
+import { maybeRunShutdownSupervisorFromArgv } from "./shutdown/supervisor.js";
+export { V3 } from "./v3.js";
+export { V3 as Stagehand } from "./v3.js";
+export * from "./types/public/index.js";
+export { AnnotatedScreenshotText, LLMClient } from "./llm/LLMClient.js";
+export { AgentProvider, modelToAgentProviderMap, } from "./agent/AgentProvider.js";
+export { validateZodSchema, isRunningInBun, toGeminiSchema, getZodType, transformSchema, injectUrls, providerEnvVarMap, loadApiKeyFromEnv, trimTrailingTextNode, jsonSchemaToZod, } from "../utils.js";
+export { isZod4Schema, isZod3Schema, toJsonSchema } from "./zodCompat.js";
+export { connectToMCPServer } from "./mcp/connection.js";
+export { V3Evaluator } from "../v3Evaluator.js";
+export { tool } from "ai";
+export { getAISDKLanguageModel } from "./llm/LLMProvider.js";
+export { __internalCreateInMemoryAgentCacheHandle } from "./cache/serverAgentCache.js";
+export { maybeRunShutdownSupervisorFromArgv as __internalMaybeRunShutdownSupervisorFromArgv } from "./shutdown/supervisor.js";
+const StagehandDefault = {
+    ...PublicApi,
+    V3,
+    Stagehand: V3,
+    AnnotatedScreenshotText,
+    LLMClient,
+    AgentProvider,
+    modelToAgentProviderMap,
+    validateZodSchema,
+    isRunningInBun,
+    toGeminiSchema,
+    getZodType,
+    transformSchema,
+    injectUrls,
+    providerEnvVarMap,
+    loadApiKeyFromEnv,
+    trimTrailingTextNode,
+    jsonSchemaToZod,
+    isZod4Schema,
+    isZod3Schema,
+    toJsonSchema,
+    connectToMCPServer,
+    V3Evaluator,
+    tool,
+    getAISDKLanguageModel,
+    __internalCreateInMemoryAgentCacheHandle,
+    __internalMaybeRunShutdownSupervisorFromArgv: maybeRunShutdownSupervisorFromArgv,
+};
+export default StagehandDefault;
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/v3/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wCAAwC,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AAE9E,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC;AAE1C,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,EACL,aAAa,EACb,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AASlC,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,UAAU,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wCAAwC,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,kCAAkC,IAAI,4CAA4C,EAAE,MAAM,0BAA0B,CAAC;AAwB9H,MAAM,gBAAgB,GAAG;IACvB,GAAG,SAAS;IACZ,EAAE;IACF,SAAS,EAAE,EAAE;IACb,uBAAuB;IACvB,SAAS;IACT,aAAa;IACb,uBAAuB;IACvB,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,UAAU;IACV,eAAe;IACf,UAAU;IACV,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;IACpB,eAAe;IACf,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,WAAW;IACX,IAAI;IACJ,qBAAqB;IACrB,wCAAwC;IACxC,4CAA4C,EAC1C,kCAAkC;CACrC,CAAC;AAEF,eAAe,gBAAgB,CAAC","sourcesContent":["import * as PublicApi from \"./types/public/index.js\";\nimport { V3 } from \"./v3.js\";\nimport { AnnotatedScreenshotText, LLMClient } from \"./llm/LLMClient.js\";\nimport {\n  AgentProvider,\n  modelToAgentProviderMap,\n} from \"./agent/AgentProvider.js\";\nimport {\n  validateZodSchema,\n  isRunningInBun,\n  toGeminiSchema,\n  getZodType,\n  transformSchema,\n  injectUrls,\n  providerEnvVarMap,\n  loadApiKeyFromEnv,\n  trimTrailingTextNode,\n  jsonSchemaToZod,\n} from \"../utils.js\";\nimport { isZod4Schema, isZod3Schema, toJsonSchema } from \"./zodCompat.js\";\nimport { connectToMCPServer } from \"./mcp/connection.js\";\nimport { V3Evaluator } from \"../v3Evaluator.js\";\nimport { tool } from \"ai\";\nimport { getAISDKLanguageModel } from \"./llm/LLMProvider.js\";\nimport { __internalCreateInMemoryAgentCacheHandle } from \"./cache/serverAgentCache.js\";\nimport { maybeRunShutdownSupervisorFromArgv } from \"./shutdown/supervisor.js\";\n\nexport { V3 } from \"./v3.js\";\nexport { V3 as Stagehand } from \"./v3.js\";\n\nexport * from \"./types/public/index.js\";\nexport { AnnotatedScreenshotText, LLMClient } from \"./llm/LLMClient.js\";\n\nexport {\n  AgentProvider,\n  modelToAgentProviderMap,\n} from \"./agent/AgentProvider.js\";\nexport type {\n  AgentTools,\n  AgentToolTypesMap,\n  AgentUITools,\n  AgentToolCall,\n  AgentToolResult,\n} from \"./agent/tools/index.js\";\n\nexport {\n  validateZodSchema,\n  isRunningInBun,\n  toGeminiSchema,\n  getZodType,\n  transformSchema,\n  injectUrls,\n  providerEnvVarMap,\n  loadApiKeyFromEnv,\n  trimTrailingTextNode,\n  jsonSchemaToZod,\n} from \"../utils.js\";\nexport { isZod4Schema, isZod3Schema, toJsonSchema } from \"./zodCompat.js\";\n\nexport { connectToMCPServer } from \"./mcp/connection.js\";\nexport { V3Evaluator } from \"../v3Evaluator.js\";\nexport { tool } from \"ai\";\nexport { getAISDKLanguageModel } from \"./llm/LLMProvider.js\";\nexport { __internalCreateInMemoryAgentCacheHandle } from \"./cache/serverAgentCache.js\";\nexport { maybeRunShutdownSupervisorFromArgv as __internalMaybeRunShutdownSupervisorFromArgv } from \"./shutdown/supervisor.js\";\nexport type { ServerAgentCacheHandle } from \"./cache/serverAgentCache.js\";\n\nexport type {\n  ChatMessage,\n  ChatMessageContent,\n  ChatMessageImageContent,\n  ChatMessageTextContent,\n  ChatCompletionOptions,\n  LLMResponse,\n  CreateChatCompletionOptions,\n  LLMUsage,\n  LLMParsedResponse,\n} from \"./llm/LLMClient.js\";\n\nexport type {\n  StagehandZodSchema,\n  StagehandZodObject,\n  InferStagehandSchema,\n  JsonSchemaDocument,\n} from \"./zodCompat.js\";\n\nexport type { JsonSchema, JsonSchemaProperty } from \"../utils.js\";\n\nconst StagehandDefault = {\n  ...PublicApi,\n  V3,\n  Stagehand: V3,\n  AnnotatedScreenshotText,\n  LLMClient,\n  AgentProvider,\n  modelToAgentProviderMap,\n  validateZodSchema,\n  isRunningInBun,\n  toGeminiSchema,\n  getZodType,\n  transformSchema,\n  injectUrls,\n  providerEnvVarMap,\n  loadApiKeyFromEnv,\n  trimTrailingTextNode,\n  jsonSchemaToZod,\n  isZod4Schema,\n  isZod3Schema,\n  toJsonSchema,\n  connectToMCPServer,\n  V3Evaluator,\n  tool,\n  getAISDKLanguageModel,\n  __internalCreateInMemoryAgentCacheHandle,\n  __internalMaybeRunShutdownSupervisorFromArgv:\n    maybeRunShutdownSupervisorFromArgv,\n};\n\nexport default StagehandDefault;\n"]}

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

@@ -0,0 +1,7 @@
+import Browserbase from "@browserbasehq/sdk";
+import type { BrowserbaseSessionCreateParams } from "../types/public/api.js";
+export declare function createBrowserbaseSession(apiKey: string, projectId?: string, params?: BrowserbaseSessionCreateParams, resumeSessionId?: string): Promise<{
+    ws: string;
+    sessionId: string;
+    bb: Browserbase;
+}>;

package/dist/esm/lib/v3/launch/browserbase.js

@@ -0,0 +1,41 @@
+import Browserbase from "@browserbasehq/sdk";
+import { BrowserbaseSessionNotFoundError, StagehandInitError, } from "../types/public/sdkErrors.js";
+import { getEnvTimeoutMs, withTimeout } from "../timeoutConfig.js";
+export async function createBrowserbaseSession(apiKey, projectId, params, resumeSessionId) {
+    const bb = new Browserbase({ apiKey });
+    const sessionCreateTimeoutMs = getEnvTimeoutMs("BROWSERBASE_SESSION_CREATE_MAX_MS");
+    // Resume an existing session if provided
+    if (resumeSessionId) {
+        const existing = (await withTimeout(bb.sessions.retrieve(resumeSessionId), sessionCreateTimeoutMs, "Browserbase session retrieve"));
+        if (!existing?.id) {
+            throw new BrowserbaseSessionNotFoundError();
+        }
+        const ws = existing.connectUrl;
+        if (!ws) {
+            throw new StagehandInitError(`Browserbase session resume missing connectUrl for ${resumeSessionId}`);
+        }
+        return { ws, sessionId: resumeSessionId, bb };
+    }
+    // Create a new session with optional overrides and a default viewport
+    const { projectId: overrideProjectId, browserSettings, userMetadata, ...rest } = params ?? {};
+    // satisfies check ensures our BrowserbaseSessionCreateParamsSchema stays in sync with SDK
+    const resolvedProjectId = overrideProjectId ?? projectId;
+    const createPayload = {
+        ...(resolvedProjectId ? { projectId: resolvedProjectId } : {}),
+        ...rest,
+        browserSettings: {
+            ...(browserSettings ?? {}),
+            viewport: browserSettings?.viewport ?? { width: 1288, height: 711 },
+        },
+        userMetadata: {
+            ...(userMetadata ?? {}),
+            stagehand: "true",
+        },
+    };
+    const created = (await withTimeout(bb.sessions.create(createPayload), sessionCreateTimeoutMs, "Browserbase session create"));
+    if (!created?.connectUrl || !created?.id) {
+        throw new StagehandInitError("Browserbase session creation returned an unexpected shape.");
+    }
+    return { ws: created.connectUrl, sessionId: created.id, bb };
+}
+//# sourceMappingURL=browserbase.js.map

package/dist/esm/lib/v3/launch/browserbase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserbase.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/browserbase.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,SAAkB,EAClB,MAAuC,EACvC,eAAwB;IAExB,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,MAAM,sBAAsB,GAAG,eAAe,CAC5C,mCAAmC,CACpC,CAAC;IAEF,yCAAyC;IACzC,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,CAAC,MAAM,WAAW,CACjC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EACrC,sBAAsB,EACtB,8BAA8B,CAC/B,CAIA,CAAC;QACF,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,+BAA+B,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC;QAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,kBAAkB,CAC1B,qDAAqD,eAAe,EAAE,CACvE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;IAChD,CAAC;IAED,sEAAsE;IACtE,MAAM,EACJ,SAAS,EAAE,iBAAiB,EAC5B,eAAe,EACf,YAAY,EACZ,GAAG,IAAI,EACR,GAAG,MAAM,IAAI,EAAE,CAAC;IAEjB,0FAA0F;IAC1F,MAAM,iBAAiB,GAAG,iBAAiB,IAAI,SAAS,CAAC;IACzD,MAAM,aAAa,GAAG;QACpB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,IAAI;QACP,eAAe,EAAE;YACf,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;YAC1B,QAAQ,EAAE,eAAe,EAAE,QAAQ,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;SACpE;QACD,YAAY,EAAE;YACZ,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;YACvB,SAAS,EAAE,MAAM;SAClB;KACiD,CAAC;IAErD,MAAM,OAAO,GAAG,CAAC,MAAM,WAAW,CAChC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EACjC,sBAAsB,EACtB,4BAA4B,CAC7B,CAAkD,CAAC;IAEpD,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAC1B,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;AAC/D,CAAC","sourcesContent":["import Browserbase from \"@browserbasehq/sdk\";\nimport {\n  BrowserbaseSessionNotFoundError,\n  StagehandInitError,\n} from \"../types/public/sdkErrors.js\";\nimport type { BrowserbaseSessionCreateParams } from \"../types/public/api.js\";\nimport { getEnvTimeoutMs, withTimeout } from \"../timeoutConfig.js\";\n\nexport async function createBrowserbaseSession(\n  apiKey: string,\n  projectId?: string,\n  params?: BrowserbaseSessionCreateParams,\n  resumeSessionId?: string,\n): Promise<{ ws: string; sessionId: string; bb: Browserbase }> {\n  const bb = new Browserbase({ apiKey });\n  const sessionCreateTimeoutMs = getEnvTimeoutMs(\n    \"BROWSERBASE_SESSION_CREATE_MAX_MS\",\n  );\n\n  // Resume an existing session if provided\n  if (resumeSessionId) {\n    const existing = (await withTimeout(\n      bb.sessions.retrieve(resumeSessionId),\n      sessionCreateTimeoutMs,\n      \"Browserbase session retrieve\",\n    )) as unknown as {\n      id: string;\n      connectUrl?: string;\n      status?: string;\n    };\n    if (!existing?.id) {\n      throw new BrowserbaseSessionNotFoundError();\n    }\n\n    const ws = existing.connectUrl;\n    if (!ws) {\n      throw new StagehandInitError(\n        `Browserbase session resume missing connectUrl for ${resumeSessionId}`,\n      );\n    }\n    return { ws, sessionId: resumeSessionId, bb };\n  }\n\n  // Create a new session with optional overrides and a default viewport\n  const {\n    projectId: overrideProjectId,\n    browserSettings,\n    userMetadata,\n    ...rest\n  } = params ?? {};\n\n  // satisfies check ensures our BrowserbaseSessionCreateParamsSchema stays in sync with SDK\n  const resolvedProjectId = overrideProjectId ?? projectId;\n  const createPayload = {\n    ...(resolvedProjectId ? { projectId: resolvedProjectId } : {}),\n    ...rest,\n    browserSettings: {\n      ...(browserSettings ?? {}),\n      viewport: browserSettings?.viewport ?? { width: 1288, height: 711 },\n    },\n    userMetadata: {\n      ...(userMetadata ?? {}),\n      stagehand: \"true\",\n    },\n  } satisfies Browserbase.Sessions.SessionCreateParams;\n\n  const created = (await withTimeout(\n    bb.sessions.create(createPayload),\n    sessionCreateTimeoutMs,\n    \"Browserbase session create\",\n  )) as unknown as { id: string; connectUrl: string };\n\n  if (!created?.connectUrl || !created?.id) {\n    throw new StagehandInitError(\n      \"Browserbase session creation returned an unexpected shape.\",\n    );\n  }\n\n  return { ws: created.connectUrl, sessionId: created.id, bb };\n}\n"]}

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

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

package/dist/esm/lib/v3/launch/local.js

@@ -0,0 +1,98 @@
+import { launch } from "chrome-launcher";
+import WebSocket from "ws";
+import { ConnectionTimeoutError } from "../types/public/sdkErrors.js";
+export async function launchLocalChrome(opts) {
+    const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;
+    const deadlineMs = Date.now() + connectTimeoutMs;
+    const connectionPollInterval = 250;
+    const maxConnectionRetries = Math.max(1, Math.ceil(connectTimeoutMs / connectionPollInterval));
+    const headless = opts.headless ?? false;
+    const chromeFlags = [
+        headless ? "--headless=new" : undefined,
+        "--remote-allow-origins=*",
+        "--no-first-run",
+        "--no-default-browser-check",
+        "--disable-dev-shm-usage",
+        "--site-per-process",
+        ...(opts.chromeFlags ?? []),
+    ].filter((f) => typeof f === "string");
+    const chrome = await launch({
+        chromePath: opts.chromePath,
+        chromeFlags,
+        port: opts.port,
+        userDataDir: opts.userDataDir,
+        handleSIGINT: opts.handleSIGINT,
+        connectionPollInterval,
+        maxConnectionRetries,
+    });
+    const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);
+    await waitForWebSocketReady(ws, deadlineMs);
+    return { ws, chrome };
+}
+async function waitForWebSocketDebuggerUrl(port, deadlineMs) {
+    let lastErrMsg = "";
+    while (Date.now() < deadlineMs) {
+        try {
+            const resp = await fetch(`http://127.0.0.1:${port}/json/version`);
+            if (resp.ok) {
+                const json = (await resp.json());
+                const url = json
+                    .webSocketDebuggerUrl;
+                if (typeof url === "string")
+                    return url;
+            }
+            else {
+                lastErrMsg = `${resp.status} ${resp.statusText}`;
+            }
+        }
+        catch (err) {
+            lastErrMsg = err instanceof Error ? err.message : String(err);
+        }
+        await new Promise((r) => setTimeout(r, 250));
+    }
+    throw new ConnectionTimeoutError(`Timed out waiting for /json/version on port ${port} ${lastErrMsg ? ` (last error: ${lastErrMsg})` : ""}`);
+}
+async function waitForWebSocketReady(wsUrl, deadlineMs) {
+    let lastErrMsg = "";
+    while (Date.now() < deadlineMs) {
+        const remainingMs = Math.max(200, deadlineMs - Date.now());
+        try {
+            await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));
+            return;
+        }
+        catch (error) {
+            lastErrMsg = error instanceof Error ? error.message : String(error);
+            await new Promise((r) => setTimeout(r, 100));
+        }
+    }
+    throw new ConnectionTimeoutError(`Timed out waiting for CDP websocket to accept connections at ${wsUrl}${lastErrMsg ? ` (last error: ${lastErrMsg})` : ""}`);
+}
+function probeWebSocket(wsUrl, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(wsUrl);
+        let settled = false;
+        const finish = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            try {
+                ws.terminate();
+            }
+            catch {
+                // best-effort cleanup
+            }
+            if (error) {
+                reject(error);
+                return;
+            }
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));
+        }, timeoutMs);
+        ws.once("open", () => finish());
+        ws.once("error", (error) => finish(error));
+    });
+}
+//# sourceMappingURL=local.js.map

package/dist/esm/lib/v3/launch/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/local.ts"],"names":[],"mappings":"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","sourcesContent":["import { launch, LaunchedChrome } from \"chrome-launcher\";\nimport WebSocket from \"ws\";\nimport { ConnectionTimeoutError } from \"../types/public/sdkErrors.js\";\n\ninterface LaunchLocalOptions {\n  chromePath?: string;\n  chromeFlags?: string[];\n  headless?: boolean;\n  userDataDir?: string;\n  port?: number;\n  connectTimeoutMs?: number;\n  handleSIGINT?: boolean;\n}\n\nexport async function launchLocalChrome(\n  opts: LaunchLocalOptions,\n): Promise<{ ws: string; chrome: LaunchedChrome }> {\n  const connectTimeoutMs = opts.connectTimeoutMs ?? 15_000;\n  const deadlineMs = Date.now() + connectTimeoutMs;\n  const connectionPollInterval = 250;\n  const maxConnectionRetries = Math.max(\n    1,\n    Math.ceil(connectTimeoutMs / connectionPollInterval),\n  );\n  const headless = opts.headless ?? false;\n  const chromeFlags = [\n    headless ? \"--headless=new\" : undefined,\n    \"--remote-allow-origins=*\",\n    \"--no-first-run\",\n    \"--no-default-browser-check\",\n    \"--disable-dev-shm-usage\",\n    \"--site-per-process\",\n    ...(opts.chromeFlags ?? []),\n  ].filter((f): f is string => typeof f === \"string\");\n\n  const chrome = await launch({\n    chromePath: opts.chromePath,\n    chromeFlags,\n    port: opts.port,\n    userDataDir: opts.userDataDir,\n    handleSIGINT: opts.handleSIGINT,\n    connectionPollInterval,\n    maxConnectionRetries,\n  });\n\n  const ws = await waitForWebSocketDebuggerUrl(chrome.port, deadlineMs);\n  await waitForWebSocketReady(ws, deadlineMs);\n\n  return { ws, chrome };\n}\n\nasync function waitForWebSocketDebuggerUrl(\n  port: number,\n  deadlineMs: number,\n): Promise<string> {\n  let lastErrMsg = \"\";\n\n  while (Date.now() < deadlineMs) {\n    try {\n      const resp = await fetch(`http://127.0.0.1:${port}/json/version`);\n      if (resp.ok) {\n        const json = (await resp.json()) as unknown;\n        const url = (json as { webSocketDebuggerUrl?: string })\n          .webSocketDebuggerUrl;\n        if (typeof url === \"string\") return url;\n      } else {\n        lastErrMsg = `${resp.status} ${resp.statusText}`;\n      }\n    } catch (err) {\n      lastErrMsg = err instanceof Error ? err.message : String(err);\n    }\n    await new Promise((r) => setTimeout(r, 250));\n  }\n\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for /json/version on port ${port} ${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nasync function waitForWebSocketReady(\n  wsUrl: string,\n  deadlineMs: number,\n): Promise<void> {\n  let lastErrMsg = \"\";\n  while (Date.now() < deadlineMs) {\n    const remainingMs = Math.max(200, deadlineMs - Date.now());\n    try {\n      await probeWebSocket(wsUrl, Math.min(2_000, remainingMs));\n      return;\n    } catch (error) {\n      lastErrMsg = error instanceof Error ? error.message : String(error);\n      await new Promise((r) => setTimeout(r, 100));\n    }\n  }\n  throw new ConnectionTimeoutError(\n    `Timed out waiting for CDP websocket to accept connections at ${wsUrl}${\n      lastErrMsg ? ` (last error: ${lastErrMsg})` : \"\"\n    }`,\n  );\n}\n\nfunction probeWebSocket(wsUrl: string, timeoutMs: number): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const ws = new WebSocket(wsUrl);\n    let settled = false;\n    const finish = (error?: unknown) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.terminate();\n      } catch {\n        // best-effort cleanup\n      }\n      if (error) {\n        reject(error);\n        return;\n      }\n      resolve();\n    };\n    const timer = setTimeout(() => {\n      finish(new Error(`websocket probe timeout after ${timeoutMs}ms`));\n    }, timeoutMs);\n\n    ws.once(\"open\", () => finish());\n    ws.once(\"error\", (error) => finish(error));\n  });\n}\n"]}

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

@@ -0,0 +1,16 @@
+import { ClientOptions } from "@anthropic-ai/sdk";
+import { LogLine } from "../types/public/logs.js";
+import { AvailableModel } from "../types/public/model.js";
+import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient.js";
+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>;
+}