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

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

@@ -97,6 +97,7 @@ const logger_js_2 = require("./logger.js");
 const cleanupLocal_js_1 = require("./shutdown/cleanupLocal.js");
 const supervisorClient_js_1 = require("./shutdown/supervisorClient.js");
 const utils_js_2 = require("./mcp/utils.js");
+const agent_js_1 = require("./types/private/agent.js");
 const index_js_1 = require("./types/public/index.js");
 const context_js_1 = require("./understudy/context.js");
 const modelUtils_js_2 = require("../modelUtils.js");
@@ -551,6 +552,11 @@ let V3 = (() => {
             this.overrideLlmClients.set(cacheKey, client);
             return client;
         }
+        resolveDefaultAgentMode(model) {
+            const modelName = (0, modelUtils_js_1.extractModelName)(model) ?? this.modelName;
+            const matchedPattern = agent_js_1.HYBRID_CAPABLE_MODEL_PATTERNS.find((pattern) => modelName.includes(pattern));
+            return matchedPattern ? "hybrid" : "dom";
+        }
         beginAgentReplayRecording() {
             this.agentCache.beginRecording();
         }
@@ -1135,6 +1141,7 @@ let V3 = (() => {
                     model: options?.model,
                     timeout: options?.timeout,
                     selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     page,
                 };
                 let result;
@@ -1157,6 +1164,7 @@ let V3 = (() => {
                 this.addToHistory("extract", {
                     instruction,
                     selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     timeout: options?.timeout,
                     schema: historySchemaDescriptor,
                 }, result);
@@ -1186,6 +1194,7 @@ let V3 = (() => {
                     variables: options?.variables,
                     timeout: options?.timeout,
                     selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     page: page,
                 };
                 let results;
@@ -1204,6 +1213,8 @@ let V3 = (() => {
                 this.addToHistory("observe", {
                     instruction,
                     variables: options?.variables,
+                    selector: options?.selector,
+                    ignoreSelectors: options?.ignoreSelectors,
                     timeout: options?.timeout,
                 }, results);
                 return results;
@@ -1456,14 +1467,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 (0, utils_js_2.resolveTools)(options.integrations, options.tools)
                 : (options?.tools ?? {});
@@ -1471,7 +1474,8 @@ let V3 = (() => {
                 ? this.resolveLlmClient(options.model)
                 : this.llmClient;
             const resolvedExecutionModel = options?.executionModel ?? options?.model;
-            const handler = new v3AgentHandler_js_1.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_js_1.V3AgentHandler(this, this.logger, agentLlmClient, resolvedExecutionModel, options?.systemPrompt, tools, resolvedMode, this.isCaptchaAutoSolveEnabled);
             const resolvedOptions = typeof instructionOrOptions === "string"
                 ? {
                     instruction: instructionOrOptions,
@@ -1510,10 +1514,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({
@@ -1523,13 +1525,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: (0, modelUtils_js_1.extractModelName)(options?.model) ?? this.llmClient.modelName,
                         type: "string",