@browserbasehq/orca 3.2.1-preview.2 → 3.4.0-preview.0

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

@@ -57,6 +57,7 @@ import { bindInstanceLogger, unbindInstanceLogger, withInstanceLogContext, } fro
 import { cleanupLocalBrowser } from "./shutdown/cleanupLocal.js";
 import { startShutdownSupervisor } from "./shutdown/supervisorClient.js";
 import { resolveTools } from "./mcp/utils.js";
+import { HYBRID_CAPABLE_MODEL_PATTERNS } from "./types/private/agent.js";
 import { AVAILABLE_CUA_MODELS, defaultExtractSchema, V3FunctionName, CuaModelRequiredError, StagehandInvalidArgumentError, StagehandNotInitializedError, MissingEnvironmentVariableError, StagehandInitError, } from "./types/public/index.js";
 import { V3Context } from "./understudy/context.js";
 import { resolveModel } from "../modelUtils.js";
@@ -511,6 +512,11 @@ let V3 = (() => {
             this.overrideLlmClients.set(cacheKey, client);
             return client;
         }
+        resolveDefaultAgentMode(model) {
+            const modelName = extractModelName(model) ?? this.modelName;
+            const matchedPattern = HYBRID_CAPABLE_MODEL_PATTERNS.find((pattern) => modelName.includes(pattern));
+            return matchedPattern ? "hybrid" : "dom";
+        }
         beginAgentReplayRecording() {
             this.agentCache.beginRecording();
         }
@@ -1095,6 +1101,7 @@ let V3 = (() => {
                     model: options?.model,
                     timeout: options?.timeout,
                     selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     page,
                 };
                 let result;
@@ -1117,6 +1124,7 @@ let V3 = (() => {
                 this.addToHistory("extract", {
                     instruction,
                     selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     timeout: options?.timeout,
                     schema: historySchemaDescriptor,
                 }, result);
@@ -1416,14 +1424,6 @@ let V3 = (() => {
          */
         async prepareAgentExecution(options, instructionOrOptions, agentConfigSignature) {
             // Note: experimental validation is done at the call site before this method
-            // Warn if mode is not explicitly set (defaults to "dom")
-            if (options?.mode === undefined) {
-                this.logger({
-                    category: "agent",
-                    message: "Using agent in default DOM mode (legacy). Agent will default to 'hybrid' on an upcoming release for improved performance.\n  → https://docs.stagehand.dev/v3/basics/agent\n",
-                    level: 0,
-                });
-            }
             const tools = options?.integrations
                 ? await resolveTools(options.integrations, options.tools)
                 : (options?.tools ?? {});
@@ -1431,7 +1431,8 @@ let V3 = (() => {
                 ? this.resolveLlmClient(options.model)
                 : this.llmClient;
             const resolvedExecutionModel = options?.executionModel ?? options?.model;
-            const handler = new V3AgentHandler(this, this.logger, agentLlmClient, resolvedExecutionModel, options?.systemPrompt, tools, options?.mode, this.isCaptchaAutoSolveEnabled);
+            const resolvedMode = options?.mode ?? this.resolveDefaultAgentMode(options?.model);
+            const handler = new V3AgentHandler(this, this.logger, agentLlmClient, resolvedExecutionModel, options?.systemPrompt, tools, resolvedMode, this.isCaptchaAutoSolveEnabled);
             const resolvedOptions = typeof instructionOrOptions === "string"
                 ? {
                     instruction: instructionOrOptions,
@@ -1470,10 +1471,8 @@ let V3 = (() => {
             };
         }
         agent(options) {
-            // Determine if CUA mode is enabled (via mode: "cua" or deprecated cua: true)
-            const isCuaMode = options?.mode !== undefined
-                ? options.mode === "cua"
-                : options?.cua === true;
+            const isCuaMode = options?.mode === "cua" ||
+                (options?.mode === undefined && options?.cua === true);
             // Emit deprecation warning for cua: true
             if (options?.cua === true) {
                 this.logger({
@@ -1483,13 +1482,15 @@ let V3 = (() => {
                 });
                 console.warn('[Stagehand] DEPRECATED: The "cua: true" option is deprecated. Use "mode: \'cua\'" instead.');
             }
+            const loggedMode = options?.mode ??
+                (isCuaMode ? "cua" : this.resolveDefaultAgentMode(options?.model));
             this.logger({
                 category: "agent",
                 message: "Creating v3 agent instance",
                 level: 1,
                 auxiliary: {
                     cua: { value: isCuaMode ? "true" : "false", type: "boolean" },
-                    mode: { value: options?.mode ?? "dom", type: "string" },
+                    mode: { value: loggedMode, type: "string" },
                     model: {
                         value: extractModelName(options?.model) ?? this.llmClient.modelName,
                         type: "string",