@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-preview.1

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

@@ -1,3 +1,13 @@
+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";
@@ -16,3 +26,136 @@ 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/cjs/lib/v3/index.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__internalMaybeRunShutdownSupervisorFromArgv = exports.__internalCreateInMemoryAgentCacheHandle = exports.getAISDKLanguageModel = exports.tool = exports.V3Evaluator = exports.connectToMCPServer = exports.toJsonSchema = exports.isZod3Schema = exports.isZod4Schema = exports.jsonSchemaToZod = exports.trimTrailingTextNode = exports.loadApiKeyFromEnv = exports.providerEnvVarMap = exports.injectUrls = exports.transformSchema = exports.getZodType = exports.toGeminiSchema = exports.isRunningInBun = exports.validateZodSchema = exports.modelToAgentProviderMap = exports.AgentProvider = exports.LLMClient = exports.AnnotatedScreenshotText = exports.Stagehand = exports.V3 = void 0;
+const PublicApi = __importStar(require("./types/public/index.js"));
+const v3_js_1 = require("./v3.js");
+const LLMClient_js_1 = require("./llm/LLMClient.js");
+const AgentProvider_js_1 = require("./agent/AgentProvider.js");
+const utils_js_1 = require("../utils.js");
+const zodCompat_js_1 = require("./zodCompat.js");
+const connection_js_1 = require("./mcp/connection.js");
+const v3Evaluator_js_1 = require("../v3Evaluator.js");
+const ai_1 = require("ai");
+const LLMProvider_js_1 = require("./llm/LLMProvider.js");
+const serverAgentCache_js_1 = require("./cache/serverAgentCache.js");
+const supervisor_js_1 = require("./shutdown/supervisor.js");
+var v3_js_2 = require("./v3.js");
+Object.defineProperty(exports, "V3", { enumerable: true, get: function () { return v3_js_2.V3; } });
+var v3_js_3 = require("./v3.js");
+Object.defineProperty(exports, "Stagehand", { enumerable: true, get: function () { return v3_js_3.V3; } });
+__exportStar(require("./types/public/index.js"), exports);
+var LLMClient_js_2 = require("./llm/LLMClient.js");
+Object.defineProperty(exports, "AnnotatedScreenshotText", { enumerable: true, get: function () { return LLMClient_js_2.AnnotatedScreenshotText; } });
+Object.defineProperty(exports, "LLMClient", { enumerable: true, get: function () { return LLMClient_js_2.LLMClient; } });
+var AgentProvider_js_2 = require("./agent/AgentProvider.js");
+Object.defineProperty(exports, "AgentProvider", { enumerable: true, get: function () { return AgentProvider_js_2.AgentProvider; } });
+Object.defineProperty(exports, "modelToAgentProviderMap", { enumerable: true, get: function () { return AgentProvider_js_2.modelToAgentProviderMap; } });
+var utils_js_2 = require("../utils.js");
+Object.defineProperty(exports, "validateZodSchema", { enumerable: true, get: function () { return utils_js_2.validateZodSchema; } });
+Object.defineProperty(exports, "isRunningInBun", { enumerable: true, get: function () { return utils_js_2.isRunningInBun; } });
+Object.defineProperty(exports, "toGeminiSchema", { enumerable: true, get: function () { return utils_js_2.toGeminiSchema; } });
+Object.defineProperty(exports, "getZodType", { enumerable: true, get: function () { return utils_js_2.getZodType; } });
+Object.defineProperty(exports, "transformSchema", { enumerable: true, get: function () { return utils_js_2.transformSchema; } });
+Object.defineProperty(exports, "injectUrls", { enumerable: true, get: function () { return utils_js_2.injectUrls; } });
+Object.defineProperty(exports, "providerEnvVarMap", { enumerable: true, get: function () { return utils_js_2.providerEnvVarMap; } });
+Object.defineProperty(exports, "loadApiKeyFromEnv", { enumerable: true, get: function () { return utils_js_2.loadApiKeyFromEnv; } });
+Object.defineProperty(exports, "trimTrailingTextNode", { enumerable: true, get: function () { return utils_js_2.trimTrailingTextNode; } });
+Object.defineProperty(exports, "jsonSchemaToZod", { enumerable: true, get: function () { return utils_js_2.jsonSchemaToZod; } });
+var zodCompat_js_2 = require("./zodCompat.js");
+Object.defineProperty(exports, "isZod4Schema", { enumerable: true, get: function () { return zodCompat_js_2.isZod4Schema; } });
+Object.defineProperty(exports, "isZod3Schema", { enumerable: true, get: function () { return zodCompat_js_2.isZod3Schema; } });
+Object.defineProperty(exports, "toJsonSchema", { enumerable: true, get: function () { return zodCompat_js_2.toJsonSchema; } });
+var connection_js_2 = require("./mcp/connection.js");
+Object.defineProperty(exports, "connectToMCPServer", { enumerable: true, get: function () { return connection_js_2.connectToMCPServer; } });
+var v3Evaluator_js_2 = require("../v3Evaluator.js");
+Object.defineProperty(exports, "V3Evaluator", { enumerable: true, get: function () { return v3Evaluator_js_2.V3Evaluator; } });
+var ai_2 = require("ai");
+Object.defineProperty(exports, "tool", { enumerable: true, get: function () { return ai_2.tool; } });
+var LLMProvider_js_2 = require("./llm/LLMProvider.js");
+Object.defineProperty(exports, "getAISDKLanguageModel", { enumerable: true, get: function () { return LLMProvider_js_2.getAISDKLanguageModel; } });
+var serverAgentCache_js_2 = require("./cache/serverAgentCache.js");
+Object.defineProperty(exports, "__internalCreateInMemoryAgentCacheHandle", { enumerable: true, get: function () { return serverAgentCache_js_2.__internalCreateInMemoryAgentCacheHandle; } });
+var supervisor_js_2 = require("./shutdown/supervisor.js");
+Object.defineProperty(exports, "__internalMaybeRunShutdownSupervisorFromArgv", { enumerable: true, get: function () { return supervisor_js_2.maybeRunShutdownSupervisorFromArgv; } });
+const StagehandDefault = {
+    ...PublicApi,
+    V3: v3_js_1.V3,
+    Stagehand: v3_js_1.V3,
+    AnnotatedScreenshotText: LLMClient_js_1.AnnotatedScreenshotText,
+    LLMClient: LLMClient_js_1.LLMClient,
+    AgentProvider: AgentProvider_js_1.AgentProvider,
+    modelToAgentProviderMap: AgentProvider_js_1.modelToAgentProviderMap,
+    validateZodSchema: utils_js_1.validateZodSchema,
+    isRunningInBun: utils_js_1.isRunningInBun,
+    toGeminiSchema: utils_js_1.toGeminiSchema,
+    getZodType: utils_js_1.getZodType,
+    transformSchema: utils_js_1.transformSchema,
+    injectUrls: utils_js_1.injectUrls,
+    providerEnvVarMap: utils_js_1.providerEnvVarMap,
+    loadApiKeyFromEnv: utils_js_1.loadApiKeyFromEnv,
+    trimTrailingTextNode: utils_js_1.trimTrailingTextNode,
+    jsonSchemaToZod: utils_js_1.jsonSchemaToZod,
+    isZod4Schema: zodCompat_js_1.isZod4Schema,
+    isZod3Schema: zodCompat_js_1.isZod3Schema,
+    toJsonSchema: zodCompat_js_1.toJsonSchema,
+    connectToMCPServer: connection_js_1.connectToMCPServer,
+    V3Evaluator: v3Evaluator_js_1.V3Evaluator,
+    tool: ai_1.tool,
+    getAISDKLanguageModel: LLMProvider_js_1.getAISDKLanguageModel,
+    __internalCreateInMemoryAgentCacheHandle: serverAgentCache_js_1.__internalCreateInMemoryAgentCacheHandle,
+    __internalMaybeRunShutdownSupervisorFromArgv: supervisor_js_1.maybeRunShutdownSupervisorFromArgv,
+};
+exports.default = StagehandDefault;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/v3/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mEAAqD;AACrD,mCAA6B;AAC7B,qDAAwE;AACxE,+DAGkC;AAClC,0CAWqB;AACrB,iDAA0E;AAC1E,uDAAyD;AACzD,sDAAgD;AAChD,2BAA0B;AAC1B,yDAA6D;AAC7D,qEAAuF;AACvF,4DAA8E;AAE9E,iCAA6B;AAApB,2FAAA,EAAE,OAAA;AACX,iCAA0C;AAAjC,kGAAA,EAAE,OAAa;AAExB,0DAAwC;AACxC,mDAAwE;AAA/D,uHAAA,uBAAuB,OAAA;AAAE,yGAAA,SAAS,OAAA;AAE3C,6DAGkC;AAFhC,iHAAA,aAAa,OAAA;AACb,2HAAA,uBAAuB,OAAA;AAUzB,wCAWqB;AAVnB,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,0GAAA,cAAc,OAAA;AACd,sGAAA,UAAU,OAAA;AACV,2GAAA,eAAe,OAAA;AACf,sGAAA,UAAU,OAAA;AACV,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AACpB,2GAAA,eAAe,OAAA;AAEjB,+CAA0E;AAAjE,4GAAA,YAAY,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,4GAAA,YAAY,OAAA;AAEjD,qDAAyD;AAAhD,mHAAA,kBAAkB,OAAA;AAC3B,oDAAgD;AAAvC,6GAAA,WAAW,OAAA;AACpB,yBAA0B;AAAjB,0FAAA,IAAI,OAAA;AACb,uDAA6D;AAApD,uHAAA,qBAAqB,OAAA;AAC9B,mEAAuF;AAA9E,+IAAA,wCAAwC,OAAA;AACjD,0DAA8H;AAArH,6IAAA,kCAAkC,OAAgD;AAwB3F,MAAM,gBAAgB,GAAG;IACvB,GAAG,SAAS;IACZ,EAAE,EAAF,UAAE;IACF,SAAS,EAAE,UAAE;IACb,uBAAuB,EAAvB,sCAAuB;IACvB,SAAS,EAAT,wBAAS;IACT,aAAa,EAAb,gCAAa;IACb,uBAAuB,EAAvB,0CAAuB;IACvB,iBAAiB,EAAjB,4BAAiB;IACjB,cAAc,EAAd,yBAAc;IACd,cAAc,EAAd,yBAAc;IACd,UAAU,EAAV,qBAAU;IACV,eAAe,EAAf,0BAAe;IACf,UAAU,EAAV,qBAAU;IACV,iBAAiB,EAAjB,4BAAiB;IACjB,iBAAiB,EAAjB,4BAAiB;IACjB,oBAAoB,EAApB,+BAAoB;IACpB,eAAe,EAAf,0BAAe;IACf,YAAY,EAAZ,2BAAY;IACZ,YAAY,EAAZ,2BAAY;IACZ,YAAY,EAAZ,2BAAY;IACZ,kBAAkB,EAAlB,kCAAkB;IAClB,WAAW,EAAX,4BAAW;IACX,IAAI,EAAJ,SAAI;IACJ,qBAAqB,EAArB,sCAAqB;IACrB,wCAAwC,EAAxC,8DAAwC;IACxC,4CAA4C,EAC1C,kDAAkC;CACrC,CAAC;AAEF,kBAAe,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/cjs/lib/v3/launch/browserbase.d.ts

@@ -1,6 +1,6 @@
 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<{
+export declare function createBrowserbaseSession(apiKey: string, projectId?: string, params?: BrowserbaseSessionCreateParams, resumeSessionId?: string): Promise<{
     ws: string;
     sessionId: string;
     bb: Browserbase;

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

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowserbaseSession = createBrowserbaseSession;
+const sdk_1 = __importDefault(require("@browserbasehq/sdk"));
+const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
+const timeoutConfig_js_1 = require("../timeoutConfig.js");
+async function createBrowserbaseSession(apiKey, projectId, params, resumeSessionId) {
+    const bb = new sdk_1.default({ apiKey });
+    const sessionCreateTimeoutMs = (0, timeoutConfig_js_1.getEnvTimeoutMs)("BROWSERBASE_SESSION_CREATE_MAX_MS");
+    // Resume an existing session if provided
+    if (resumeSessionId) {
+        const existing = (await (0, timeoutConfig_js_1.withTimeout)(bb.sessions.retrieve(resumeSessionId), sessionCreateTimeoutMs, "Browserbase session retrieve"));
+        if (!existing?.id) {
+            throw new sdkErrors_js_1.BrowserbaseSessionNotFoundError();
+        }
+        const ws = existing.connectUrl;
+        if (!ws) {
+            throw new sdkErrors_js_1.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 (0, timeoutConfig_js_1.withTimeout)(bb.sessions.create(createPayload), sessionCreateTimeoutMs, "Browserbase session create"));
+    if (!created?.connectUrl || !created?.id) {
+        throw new sdkErrors_js_1.StagehandInitError("Browserbase session creation returned an unexpected shape.");
+    }
+    return { ws: created.connectUrl, sessionId: created.id, bb };
+}
+//# sourceMappingURL=browserbase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browserbase.js","sourceRoot":"","sources":["../../../../../lib/v3/launch/browserbase.ts"],"names":[],"mappings":";;;;;AAQA,4DAuEC;AA/ED,6DAA6C;AAC7C,+DAGsC;AAEtC,0DAAmE;AAE5D,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,SAAkB,EAClB,MAAuC,EACvC,eAAwB;IAExB,MAAM,EAAE,GAAG,IAAI,aAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,MAAM,sBAAsB,GAAG,IAAA,kCAAe,EAC5C,mCAAmC,CACpC,CAAC;IAEF,yCAAyC;IACzC,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAA,8BAAW,EACjC,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,8CAA+B,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC;QAC/B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,iCAAkB,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,IAAA,8BAAW,EAChC,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,iCAAkB,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/cjs/lib/v3/launch/local.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchLocalChrome = launchLocalChrome;
+const chrome_launcher_1 = require("chrome-launcher");
+const ws_1 = __importDefault(require("ws"));
+const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
+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 (0, chrome_launcher_1.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 sdkErrors_js_1.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 sdkErrors_js_1.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 ws_1.default(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/cjs/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"]}