@browserbasehq/orca 3.1.0-patch.2 → 3.1.0-patch.3

package/dist/cjs/index.js

@@ -4,7 +4,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
 var __typeError = (msg) => {
   throw TypeError(msg);
 };
@@ -104,7 +104,7 @@ var init_version = __esm({
 });
 
 // packages/core/lib/v3/types/public/sdkErrors.ts
-var StagehandError, StagehandDefaultError, StagehandEnvironmentError, MissingEnvironmentVariableError, UnsupportedModelError, UnsupportedModelProviderError, UnsupportedAISDKModelProviderError, InvalidAISDKModelFormatError, StagehandNotInitializedError, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, MissingLLMConfigurationError, HandlerNotInitializedError, StagehandInvalidArgumentError, StagehandElementNotFoundError, AgentScreenshotProviderError, StagehandMissingArgumentError, CreateChatCompletionResponseError, StagehandEvalError, StagehandDomProcessError, StagehandLocatorError, StagehandClickError, LLMResponseError, StagehandIframeError, ContentFrameNotFoundError, XPathResolutionError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, CuaModelRequiredError, ZodSchemaValidationError, StagehandInitError, MCPConnectionError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, ElementNotVisibleError, ResponseBodyError, ResponseParseError, TimeoutError, ActTimeoutError, ExtractTimeoutError, ObserveTimeoutError, PageNotFoundError, ConnectionTimeoutError, StreamingCallbacksInNonStreamingModeError, AgentAbortError, StagehandClosedError, StagehandSnapshotError;
+var StagehandError, StagehandDefaultError, StagehandEnvironmentError, MissingEnvironmentVariableError, UnsupportedModelError, UnsupportedModelProviderError, UnsupportedAISDKModelProviderError, InvalidAISDKModelFormatError, StagehandNotInitializedError, BrowserbaseSessionNotFoundError, CaptchaTimeoutError, MissingLLMConfigurationError, HandlerNotInitializedError, StagehandInvalidArgumentError, StagehandElementNotFoundError, AgentScreenshotProviderError, StagehandMissingArgumentError, CreateChatCompletionResponseError, StagehandEvalError, StagehandDomProcessError, StagehandLocatorError, StagehandClickError, LLMResponseError, StagehandIframeError, ContentFrameNotFoundError, XPathResolutionError, ExperimentalApiConflictError, ExperimentalNotConfiguredError, CuaModelRequiredError, ZodSchemaValidationError, StagehandInitError, MCPConnectionError, StagehandShadowRootMissingError, StagehandShadowSegmentEmptyError, StagehandShadowSegmentNotFoundError, ElementNotVisibleError, ResponseBodyError, ResponseParseError, TimeoutError, ActTimeoutError, ExtractTimeoutError, ObserveTimeoutError, PageNotFoundError, ConnectionTimeoutError, StreamingCallbacksInNonStreamingModeError, AgentAbortError, StagehandClosedError, StagehandSnapshotError, UnderstudyCommandException;
 var init_sdkErrors = __esm({
   "packages/core/lib/v3/types/public/sdkErrors.ts"() {
     init_version();
@@ -282,16 +282,16 @@ For a complete list of supported models and providers, see: https://docs.stageha
     ExperimentalApiConflictError = class extends StagehandError {
       constructor() {
         super(
-          "`experimental` mode cannot be used together with the Stagehand API. To use experimental features, set experimental: true, and useApi: false in the stagehand constructor. To use the Stagehand API, set experimental: false and useApi: true in the stagehand constructor. "
+          "`experimental` mode cannot be used together with the Stagehand API. To use experimental features, set experimental: true and disableAPI: true in the stagehand constructor. To use the Stagehand API, set experimental: false and disableAPI: false (or omit it) in the stagehand constructor."
         );
       }
     };
     ExperimentalNotConfiguredError = class extends StagehandError {
       constructor(featureName) {
-        super(`Feature "${featureName}" is an experimental feature, and cannot be configured when useAPI: true. 
-    Please set experimental: true and useAPI: false in the stagehand constructor to use this feature. 
-    If you wish to use the Stagehand API, please ensure ${featureName} is not defined in your function call, 
-    and set experimental: false, useAPI: true in the Stagehand constructor. `);
+        super(`Feature "${featureName}" is an experimental feature, and cannot be configured when disableAPI: false.
+    Please set experimental: true and disableAPI: true in the stagehand constructor to use this feature.
+    If you wish to use the Stagehand API, please ensure ${featureName} is not defined in your function call,
+    and set experimental: false, disableAPI: false (or omit it) in the Stagehand constructor.`);
       }
     };
     CuaModelRequiredError = class extends StagehandError {
@@ -427,6 +427,12 @@ ${JSON.stringify(issues, null, 2)}`);
         super(`error taking snapshot${suffix}`, cause);
       }
     };
+    UnderstudyCommandException = class extends StagehandError {
+      constructor(message, cause) {
+        super(message, cause);
+        this.name = "UnderstudyCommandException";
+      }
+    };
   }
 });
 
@@ -656,6 +662,7 @@ function toGeminiSchema(zodSchema) {
         normalizedSchema
       );
     }
+    // Standalone transforms and any unknown types fall through to default
     default:
       return decorateGeminiSchema(
         {
@@ -1062,6 +1069,27 @@ var init_utils = __esm({
   }
 });
 
+// packages/core/lib/v3/types/public/agent.ts
+var AVAILABLE_CUA_MODELS;
+var init_agent = __esm({
+  "packages/core/lib/v3/types/public/agent.ts"() {
+    AVAILABLE_CUA_MODELS = [
+      "openai/computer-use-preview",
+      "openai/computer-use-preview-2025-03-11",
+      "anthropic/claude-3-7-sonnet-latest",
+      "anthropic/claude-opus-4-5-20251101",
+      "anthropic/claude-opus-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"
+    ];
+  }
+});
+
 // packages/core/lib/v3/logger.ts
 function bindInstanceLogger(instanceId, logger) {
   instanceLoggers.set(instanceId, logger);
@@ -5063,27 +5091,6 @@ var init_LLMClient = __esm({
   }
 });
 
-// packages/core/lib/v3/types/public/agent.ts
-var AVAILABLE_CUA_MODELS;
-var init_agent = __esm({
-  "packages/core/lib/v3/types/public/agent.ts"() {
-    AVAILABLE_CUA_MODELS = [
-      "openai/computer-use-preview",
-      "openai/computer-use-preview-2025-03-11",
-      "anthropic/claude-3-7-sonnet-latest",
-      "anthropic/claude-opus-4-5-20251101",
-      "anthropic/claude-opus-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"
-    ];
-  }
-});
-
 // packages/core/lib/v3/types/public/api.ts
 var api_exports = {};
 __export(api_exports, {
@@ -5109,6 +5116,7 @@ __export(api_exports, {
   BrowserbaseFingerprintScreenSchema: () => BrowserbaseFingerprintScreenSchema,
   BrowserbaseProxyConfigSchema: () => BrowserbaseProxyConfigSchema,
   BrowserbaseProxyGeolocationSchema: () => BrowserbaseProxyGeolocationSchema,
+  BrowserbaseRegionSchema: () => BrowserbaseRegionSchema,
   BrowserbaseSessionCreateParamsSchema: () => BrowserbaseSessionCreateParamsSchema,
   BrowserbaseViewportSchema: () => BrowserbaseViewportSchema,
   ErrorResponseSchema: () => ErrorResponseSchema,
@@ -5151,7 +5159,7 @@ __export(api_exports, {
   openApiLinks: () => openApiLinks,
   openApiSecuritySchemes: () => openApiSecuritySchemes
 });
-var import_v4, LocalBrowserLaunchOptionsSchema, ModelConfigObjectSchema, ModelConfigSchema, ActionSchema, SessionIdParamsSchema, BrowserConfigSchema, SessionHeadersSchema, wrapResponse, ErrorResponseSchema, BrowserbaseViewportSchema, BrowserbaseFingerprintScreenSchema, BrowserbaseFingerprintSchema, BrowserbaseContextSchema, BrowserbaseBrowserSettingsSchema, BrowserbaseProxyGeolocationSchema, BrowserbaseProxyConfigSchema, ExternalProxyConfigSchema, ProxyConfigSchema, BrowserbaseSessionCreateParamsSchema, SessionStartRequestSchema, SessionStartResultSchema, SessionStartResponseSchema, SessionEndRequestSchema, SessionEndResultSchema, SessionEndResponseSchema, ActOptionsSchema, ActRequestSchema, ActResultDataSchema, ActResultSchema, ActResponseSchema, ExtractOptionsSchema, ExtractRequestSchema, ExtractResultSchema, ExtractResponseSchema, ObserveOptionsSchema, ObserveRequestSchema, ObserveResultSchema, ObserveResponseSchema, AgentConfigSchema, AgentActionSchema, AgentUsageSchema, AgentResultDataSchema, AgentCacheEntrySchema, AgentExecuteOptionsSchema, AgentExecuteRequestSchema, AgentExecuteResultSchema, AgentExecuteResponseSchema, NavigateOptionsSchema, NavigateRequestSchema, NavigateResultSchema, NavigateResponseSchema, TokenUsageSchema, ReplayActionSchema, ReplayPageSchema, ReplayResultSchema, ReplayResponseSchema, StreamEventStatusSchema, StreamEventTypeSchema, StreamEventSystemDataSchema, StreamEventLogDataSchema, StreamEventSchema, openApiSecuritySchemes, openApiLinks, Operations;
+var import_v4, LocalBrowserLaunchOptionsSchema, ModelConfigObjectSchema, ModelConfigSchema, ActionSchema, SessionIdParamsSchema, BrowserConfigSchema, SessionHeadersSchema, wrapResponse, ErrorResponseSchema, BrowserbaseViewportSchema, BrowserbaseFingerprintScreenSchema, BrowserbaseFingerprintSchema, BrowserbaseContextSchema, BrowserbaseBrowserSettingsSchema, BrowserbaseProxyGeolocationSchema, BrowserbaseProxyConfigSchema, ExternalProxyConfigSchema, ProxyConfigSchema, BrowserbaseRegionSchema, BrowserbaseSessionCreateParamsSchema, SessionStartRequestSchema, SessionStartResultSchema, SessionStartResponseSchema, SessionEndRequestSchema, SessionEndResultSchema, SessionEndResponseSchema, ActOptionsSchema, ActRequestSchema, ActResultDataSchema, ActResultSchema, ActResponseSchema, ExtractOptionsSchema, ExtractRequestSchema, ExtractResultSchema, ExtractResponseSchema, ObserveOptionsSchema, ObserveRequestSchema, ObserveResultSchema, ObserveResponseSchema, AgentConfigSchema, AgentActionSchema, AgentUsageSchema, AgentResultDataSchema, AgentCacheEntrySchema, AgentExecuteOptionsSchema, AgentExecuteRequestSchema, AgentExecuteResultSchema, AgentExecuteResponseSchema, NavigateOptionsSchema, NavigateRequestSchema, NavigateResultSchema, NavigateResponseSchema, TokenUsageSchema, ReplayActionSchema, ReplayPageSchema, ReplayResultSchema, ReplayResponseSchema, StreamEventStatusSchema, StreamEventTypeSchema, StreamEventSystemDataSchema, StreamEventLogDataSchema, StreamEventSchema, openApiSecuritySchemes, openApiLinks, Operations;
 var init_api = __esm({
   "packages/core/lib/v3/types/public/api.ts"() {
     import_v4 = require("zod/v4");
@@ -5314,13 +5322,14 @@ var init_api = __esm({
       BrowserbaseProxyConfigSchema,
       ExternalProxyConfigSchema
     ]).meta({ id: "ProxyConfig" });
+    BrowserbaseRegionSchema = import_v4.z.enum(["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"]).meta({ id: "BrowserbaseRegion" });
     BrowserbaseSessionCreateParamsSchema = import_v4.z.object({
       projectId: import_v4.z.string().optional(),
       browserSettings: BrowserbaseBrowserSettingsSchema.optional(),
       extensionId: import_v4.z.string().optional(),
       keepAlive: import_v4.z.boolean().optional(),
       proxies: import_v4.z.union([import_v4.z.boolean(), import_v4.z.array(ProxyConfigSchema)]).optional(),
-      region: import_v4.z.enum(["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"]).optional(),
+      region: BrowserbaseRegionSchema.optional(),
       timeout: import_v4.z.number().optional(),
       userMetadata: import_v4.z.record(import_v4.z.string(), import_v4.z.unknown()).optional()
     }).meta({ id: "BrowserbaseSessionCreateParams" });
@@ -9631,6 +9640,7 @@ var init_page2 = __esm({
       normalizeModifierKey(key) {
         const lower = key.toLowerCase();
         switch (lower) {
+          // Modifier keys
           case "cmd":
           case "command":
           case "controlormeta":
@@ -9648,6 +9658,7 @@ var init_page2 = __esm({
             return "Shift";
           case "meta":
             return "Meta";
+          // Action keys
           case "enter":
           case "return":
             return "Enter";
@@ -9664,6 +9675,7 @@ var init_page2 = __esm({
           case "delete":
           case "del":
             return "Delete";
+          // Arrow keys
           case "left":
           case "arrowleft":
             return "ArrowLeft";
@@ -9676,6 +9688,7 @@ var init_page2 = __esm({
           case "down":
           case "arrowdown":
             return "ArrowDown";
+          // Navigation keys
           case "home":
             return "Home";
           case "end":
@@ -9925,8 +9938,8 @@ var init_page2 = __esm({
 });
 
 // packages/core/lib/v3/index.ts
-var v3_exports = {};
-__export(v3_exports, {
+var index_exports = {};
+__export(index_exports, {
   AISdkClient: () => AISdkClient2,
   AVAILABLE_CUA_MODELS: () => AVAILABLE_CUA_MODELS,
   ActTimeoutError: () => ActTimeoutError,
@@ -9987,6 +10000,7 @@ __export(v3_exports, {
   StagehandSnapshotError: () => StagehandSnapshotError,
   StreamingCallbacksInNonStreamingModeError: () => StreamingCallbacksInNonStreamingModeError,
   TimeoutError: () => TimeoutError,
+  UnderstudyCommandException: () => UnderstudyCommandException,
   UnsupportedAISDKModelProviderError: () => UnsupportedAISDKModelProviderError,
   UnsupportedModelError: () => UnsupportedModelError,
   UnsupportedModelProviderError: () => UnsupportedModelProviderError,
@@ -10018,7 +10032,7 @@ __export(v3_exports, {
   trimTrailingTextNode: () => trimTrailingTextNode,
   validateZodSchema: () => validateZodSchema
 });
-module.exports = __toCommonJS(v3_exports);
+module.exports = __toCommonJS(index_exports);
 
 // packages/core/lib/v3/v3.ts
 var import_events = require("events");
@@ -10030,6 +10044,44 @@ var import_uuid6 = require("uuid");
 init_zodCompat();
 init_utils();
 
+// packages/core/lib/modelUtils.ts
+init_agent();
+function extractModelName(model) {
+  if (!model) return void 0;
+  return typeof model === "string" ? model : model.modelName;
+}
+function splitModelName(model) {
+  const firstSlashIndex = model.indexOf("/");
+  const provider = model.substring(0, firstSlashIndex);
+  const modelName = model.substring(firstSlashIndex + 1);
+  return { provider, modelName };
+}
+function resolveModel(model) {
+  const modelString = extractModelName(model);
+  const clientOptions = typeof model === "string" ? {} : (() => {
+    const { modelName: _, ...rest } = model;
+    return rest;
+  })();
+  const hasExplicitProvider = clientOptions.provider !== void 0;
+  let provider;
+  let parsedModelName;
+  if (hasExplicitProvider) {
+    provider = clientOptions.provider;
+    parsedModelName = modelString;
+  } else {
+    const split = splitModelName(modelString);
+    provider = split.provider;
+    parsedModelName = split.modelName;
+  }
+  const isCua = hasExplicitProvider || AVAILABLE_CUA_MODELS.includes(modelString);
+  return {
+    provider,
+    modelName: parsedModelName,
+    clientOptions,
+    isCua
+  };
+}
+
 // packages/core/lib/logger.ts
 var import_pino = __toESM(require("pino"), 1);
 var levelMapping = {
@@ -12093,12 +12145,6 @@ init_deepLocator();
 init_logger();
 init_flowLogger();
 init_sdkErrors();
-var UnderstudyCommandException = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "UnderstudyCommandException";
-  }
-};
 function normalizeRootXPath(input) {
   const s = String(input ?? "").trim();
   if (s === "/") return "/html";
@@ -12181,7 +12227,10 @@ async function performUnderstudyMethod(page, frame, method, rawXPath, args, domS
         args: { value: JSON.stringify(args), type: "object" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    if (e instanceof UnderstudyCommandException) {
+      throw e;
+    }
+    throw new UnderstudyCommandException(msg, e);
   } finally {
     SessionFileLogger.logUnderstudyActionCompleted();
   }
@@ -12210,17 +12259,19 @@ async function selectOption(ctx) {
     const text = args[0]?.toString() || "";
     await locator.selectOption(text);
   } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    const stack = e instanceof Error ? e.stack : void 0;
     v3Logger({
       category: "action",
       message: "error selecting option",
       level: 0,
       auxiliary: {
-        error: { value: e.message, type: "string" },
-        trace: { value: e.stack, type: "string" },
+        error: { value: msg, type: "string" },
+        trace: { value: stack ?? "", type: "string" },
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(e.message);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function scrollIntoView(ctx) {
@@ -12259,7 +12310,8 @@ async function scrollByPixelOffset(ctx) {
     const { x, y } = await locator.centroid();
     await page.scroll(x, y, dx, dy);
   } catch (e) {
-    throw new UnderstudyCommandException(e.message);
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function wheelScroll(ctx) {
@@ -12295,7 +12347,7 @@ async function fillOrType(ctx) {
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function typeText(ctx) {
@@ -12313,7 +12365,7 @@ async function typeText(ctx) {
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function pressKey(ctx) {
@@ -12342,7 +12394,7 @@ async function pressKey(ctx) {
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function clickElement(ctx) {
@@ -12378,7 +12430,7 @@ async function doubleClick(ctx) {
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function dragAndDrop(ctx) {
@@ -12442,7 +12494,7 @@ async function dragAndDrop(ctx) {
         to: { value: toXPath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(msg);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function scrollToNextChunk(ctx) {
@@ -12515,17 +12567,19 @@ async function hover(ctx) {
   try {
     await locator.hover();
   } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    const stack = e instanceof Error ? e.stack : void 0;
     v3Logger({
       category: "action",
       message: "error attempting to hover",
       level: 0,
       auxiliary: {
-        error: { value: e.message, type: "string" },
-        trace: { value: e.stack, type: "string" },
+        error: { value: msg, type: "string" },
+        trace: { value: stack ?? "", type: "string" },
         xpath: { value: xpath, type: "string" }
       }
     });
-    throw new UnderstudyCommandException(e.message);
+    throw new UnderstudyCommandException(msg, e);
   }
 }
 async function getFrameUrl(frame) {
@@ -19483,9 +19537,12 @@ var AISdkClient = class extends LLMClient {
     const isGPT5 = this.model.modelId.includes("gpt-5");
     const isCodex = this.model.modelId.includes("codex");
     const usesLowReasoningEffort = (this.model.modelId.includes("gpt-5.1") || this.model.modelId.includes("gpt-5.2")) && !isCodex;
-    const isDeepSeek = this.model.modelId.includes("deepseek");
     const isKimi = this.model.modelId.includes("kimi");
     const temperature = isKimi ? 1 : options.temperature;
+    const PROMPT_JSON_FALLBACK_PATTERNS = ["deepseek", "kimi", "glm"];
+    const needsPromptJsonFallback = PROMPT_JSON_FALLBACK_PATTERNS.some(
+      (p) => this.model.modelId.includes(p)
+    );
     if (options.response_model) {
       const llmRequestId2 = (0, import_uuid5.v7)();
       const promptPreview2 = formatLlmPromptPreview(options.messages, {
@@ -19497,7 +19554,7 @@ var AISdkClient = class extends LLMClient {
         operation: "generateObject",
         prompt: promptPreview2
       });
-      if (isDeepSeek || isKimi) {
+      if (needsPromptJsonFallback) {
         const parsedSchema = JSON.stringify(
           toJsonSchema(options.response_model.schema)
         );
@@ -21377,7 +21434,8 @@ function startShutdownSupervisor(config2, opts) {
   }
   const child = (0, import_node_child_process.spawn)(resolved.command, resolved.args, {
     // stdin is the parent lifeline.
-    stdio: ["pipe", "ignore", "ignore"],
+    // Preserve supervisor stderr so crash-cleanup debug lines are visible.
+    stdio: ["pipe", "ignore", "inherit"],
     detached: true
   });
   child.on("error", (error) => {
@@ -22225,11 +22283,11 @@ var V3Context = class _V3Context {
         if (!owner) {
           for (const p of this.pagesByTarget.values()) {
             const tree = p.asProtocolFrameTree(p.mainFrameId());
-            const has = function find(n) {
+            const has = (function find(n) {
               if (n.frame.id === childMainId) return true;
               for (const c of n.childFrames ?? []) if (find(c)) return true;
               return false;
-            }(tree);
+            })(tree);
             if (has) {
               owner = p;
               break;
@@ -22407,52 +22465,29 @@ var V3Context = class _V3Context {
   }
 };
 
-// packages/core/lib/modelUtils.ts
-init_agent();
-function splitModelName(model) {
-  const firstSlashIndex = model.indexOf("/");
-  const provider = model.substring(0, firstSlashIndex);
-  const modelName = model.substring(firstSlashIndex + 1);
-  return { provider, modelName };
-}
-function resolveModel(model) {
-  const modelString = typeof model === "string" ? model : model.modelName;
-  const clientOptions = typeof model === "string" ? {} : (() => {
-    const { modelName: _, ...rest } = model;
-    return rest;
-  })();
-  const hasExplicitProvider = clientOptions.provider !== void 0;
-  let provider;
-  let parsedModelName;
-  if (hasExplicitProvider) {
-    provider = clientOptions.provider;
-    parsedModelName = modelString;
-  } else {
-    const split = splitModelName(modelString);
-    provider = split.provider;
-    parsedModelName = split.modelName;
-  }
-  const isCua = hasExplicitProvider || AVAILABLE_CUA_MODELS.includes(modelString);
-  return {
-    provider,
-    modelName: parsedModelName,
-    clientOptions,
-    isCua
-  };
-}
-
 // packages/core/lib/v3/api.ts
 var import_fetch_cookie = __toESM(require("fetch-cookie"), 1);
 init_utils();
 init_version();
 init_public();
 init_zodCompat();
+var REGION_API_URLS = {
+  "us-west-2": "https://api.stagehand.browserbase.com",
+  "us-east-1": "https://api.use1.stagehand.browserbase.com",
+  "eu-central-1": "https://api.euc1.stagehand.browserbase.com",
+  "ap-southeast-1": "https://api.apse1.stagehand.browserbase.com"
+};
+function getApiUrlForRegion(region) {
+  const baseUrl = REGION_API_URLS[region] ?? REGION_API_URLS["us-west-2"];
+  return `${baseUrl}/v1`;
+}
 var StagehandAPIClient = class {
   apiKey;
   projectId;
   sessionId;
   modelApiKey;
   modelProvider;
+  region;
   logger;
   fetchWithCookies;
   lastFinishedEventData = null;
@@ -22479,10 +22514,7 @@ var StagehandAPIClient = class {
     }
     this.modelApiKey = modelApiKey;
     this.modelProvider = modelName?.includes("/") ? modelName.split("/")[0] : void 0;
-    const region = browserbaseSessionCreateParams?.region;
-    if (region && region !== "us-west-2") {
-      return { sessionId: browserbaseSessionID ?? null, available: false };
-    }
+    this.region = browserbaseSessionCreateParams?.region;
     this.logger({
       category: "init",
       message: "Creating new browserbase session...",
@@ -22897,16 +22929,20 @@ var StagehandAPIClient = class {
     if (options.method === "POST" && options.body) {
       defaultHeaders["Content-Type"] = "application/json";
     }
-    const response = await this.fetchWithCookies(
-      `${process.env.STAGEHAND_API_URL ?? "https://api.stagehand.browserbase.com/v1"}${path7}`,
-      {
-        ...options,
-        headers: {
-          ...defaultHeaders,
-          ...options.headers
-        }
+    let baseUrl;
+    if (process.env.STAGEHAND_API_URL) {
+      const envUrl = process.env.STAGEHAND_API_URL.replace(/\/+$/, "");
+      baseUrl = envUrl.endsWith("/v1") ? envUrl : `${envUrl}/v1`;
+    } else {
+      baseUrl = getApiUrlForRegion(this.region);
+    }
+    const response = await this.fetchWithCookies(`${baseUrl}${path7}`, {
+      ...options,
+      headers: {
+        ...defaultHeaders,
+        ...options.headers
       }
-    );
+    });
     return response;
   }
 };
@@ -24156,11 +24192,12 @@ var _V3 = class _V3 {
     }
     const tools = options?.integrations ? await resolveTools(options.integrations, options.tools) : options?.tools ?? {};
     const agentLlmClient = options?.model ? this.resolveLlmClient(options.model) : this.llmClient;
+    const resolvedExecutionModel = options?.executionModel ?? options?.model;
     const handler = new V3AgentHandler(
       this,
       this.logger,
       agentLlmClient,
-      typeof options?.executionModel === "string" ? options.executionModel : options?.executionModel?.modelName,
+      resolvedExecutionModel,
       options?.systemPrompt,
       tools,
       options?.mode
@@ -24211,7 +24248,10 @@ var _V3 = class _V3 {
       auxiliary: {
         cua: { value: isCuaMode ? "true" : "false", type: "boolean" },
         mode: { value: options?.mode ?? "dom", type: "string" },
-        model: options?.model ? typeof options?.model === "string" ? { value: options.model, type: "string" } : { value: options.model.modelName, type: "string" } : { value: this.llmClient.modelName, type: "string" },
+        model: {
+          value: extractModelName(options?.model) ?? this.llmClient.modelName,
+          type: "string"
+        },
         systemPrompt: { value: options?.systemPrompt ?? "", type: "string" },
         tools: { value: JSON.stringify(options?.tools ?? {}), type: "object" },
         ...options?.integrations && {
@@ -24740,6 +24780,7 @@ var PID_POLL_INTERVAL_MS = 500;
 var config = null;
 var cleanupPromise = null;
 var started = false;
+var localPidKnownGone = false;
 var exit = (code = 0) => {
   try {
     process.exit(code);
@@ -24779,26 +24820,43 @@ var startPidPolling = (pid) => {
   pidPollTimer = setInterval(() => {
     try {
       process.kill(pid, 0);
-    } catch {
-      if (pidPollTimer) {
-        clearInterval(pidPollTimer);
-        pidPollTimer = null;
-      }
-      void runCleanup().finally(() => exit(0));
+      return;
+    } catch (error) {
+      const err = error;
+      if (err.code !== "ESRCH") return;
+    }
+    localPidKnownGone = true;
+    if (pidPollTimer) {
+      clearInterval(pidPollTimer);
+      pidPollTimer = null;
     }
+    void runCleanup("Browser process exited").finally(() => exit(0));
   }, PID_POLL_INTERVAL_MS);
 };
-var cleanupLocal = async (cfg) => {
+var cleanupLocal = async (cfg, reason) => {
+  const deletingUserDataDir = Boolean(
+    cfg.createdTempProfile && !cfg.preserveUserDataDir && cfg.userDataDir
+  );
   await cleanupLocalBrowser({
-    killChrome: cfg.pid ? () => politeKill(cfg.pid) : void 0,
+    // If polling already observed ESRCH, avoid a follow-up PID kill.
+    // The PID could be reused by a different process before cleanup runs.
+    killChrome: cfg.pid && !localPidKnownGone ? () => {
+      console.error(
+        `[shutdown-supervisor] Shutting down Chrome pid=${cfg.pid} (reason=${reason}, deletingUserDataDir=${deletingUserDataDir})`
+      );
+      return politeKill(cfg.pid);
+    } : void 0,
     userDataDir: cfg.userDataDir,
     createdTempProfile: cfg.createdTempProfile,
     preserveUserDataDir: cfg.preserveUserDataDir
   });
 };
-var cleanupBrowserbase = async (cfg) => {
+var cleanupBrowserbase = async (cfg, reason) => {
   if (!cfg.apiKey || !cfg.projectId || !cfg.sessionId) return;
   try {
+    console.error(
+      `[shutdown-supervisor] Ending Browserbase session ${cfg.sessionId} (reason=${reason})`
+    );
     const bb = new import_sdk4.default({ apiKey: cfg.apiKey });
     await bb.sessions.update(cfg.sessionId, {
       status: "REQUEST_RELEASE",
@@ -24807,17 +24865,17 @@ var cleanupBrowserbase = async (cfg) => {
   } catch {
   }
 };
-var runCleanup = () => {
+var runCleanup = (reason) => {
   if (!cleanupPromise) {
     cleanupPromise = (async () => {
       const cfg = config;
       if (!cfg) return;
       if (cfg.kind === "LOCAL") {
-        await cleanupLocal(cfg);
+        await cleanupLocal(cfg, reason);
         return;
       }
       if (cfg.kind === "STAGEHAND_API") {
-        await cleanupBrowserbase(cfg);
+        await cleanupBrowserbase(cfg, reason);
       }
     })();
   }
@@ -24825,12 +24883,13 @@ var runCleanup = () => {
 };
 var applyConfig = (nextConfig) => {
   config = nextConfig;
+  localPidKnownGone = false;
   if (config.kind === "LOCAL" && config.pid) {
     startPidPolling(config.pid);
   }
 };
-var onLifelineClosed = () => {
-  void runCleanup().finally(() => exit(0));
+var onLifelineClosed = (reason) => {
+  void runCleanup(reason).finally(() => exit(0));
 };
 var parseConfigFromArgv = (argv = process.argv.slice(2)) => {
   const prefix = "--supervisor-config=";
@@ -24848,9 +24907,18 @@ var runShutdownSupervisor = (initialConfig) => {
   applyConfig(initialConfig);
   try {
     process.stdin.resume();
-    process.stdin.on("end", onLifelineClosed);
-    process.stdin.on("close", onLifelineClosed);
-    process.stdin.on("error", onLifelineClosed);
+    process.stdin.on(
+      "end",
+      () => onLifelineClosed("Stagehand process completed")
+    );
+    process.stdin.on(
+      "close",
+      () => onLifelineClosed("Stagehand process completed")
+    );
+    process.stdin.on(
+      "error",
+      () => onLifelineClosed("Stagehand process crashed or was killed")
+    );
   } catch {
   }
 };
@@ -24922,6 +24990,7 @@ var maybeRunShutdownSupervisorFromArgv = (argv = process.argv.slice(2)) => {
   StagehandSnapshotError,
   StreamingCallbacksInNonStreamingModeError,
   TimeoutError,
+  UnderstudyCommandException,
   UnsupportedAISDKModelProviderError,
   UnsupportedModelError,
   UnsupportedModelProviderError,