@browserbasehq/stagehand 3.0.7-alpha-05f5580937c3c157550e3c25ae6671f44f562211 → 3.0.7-alpha-f56a9c296d4ddce25a405358c66837f8ce4d679f

package/dist/index.d.ts

@@ -1953,8 +1953,9 @@ type AgentModelConfig<TModelName extends string = string> = {
  * Agent tool mode determines which set of tools are available to the agent.
  * - 'dom': Uses DOM-based tools (act, fillForm) - better for structured page interactions
  * - 'hybrid': Uses coordinate-based tools (click, type, dragAndDrop, etc.) - better for visual/screenshot-based interactions
+ * - 'cua': Uses Computer Use Agent (CUA) providers like Anthropic Claude or Google Gemini for screenshot-based automation
  */
-type AgentToolMode = "dom" | "hybrid";
+type AgentToolMode = "dom" | "hybrid" | "cua";
 type AgentConfig = {
     /**
      * Custom system prompt to provide to the agent. Overrides the default system prompt.
@@ -1969,7 +1970,8 @@ type AgentConfig = {
      */
     tools?: ToolSet;
     /**
-     * Indicates CUA is disabled for this configuration
+     * @deprecated Use `mode: "cua"` instead. This option will be removed in a future version.
+     * Enables Computer Use Agent (CUA) mode.
      */
     cua?: boolean;
     /**
@@ -1993,6 +1995,7 @@ type AgentConfig = {
      * - 'dom' (default): Uses DOM-based tools (act, fillForm) for structured interactions
      * - 'hybrid': Uses coordinate-based tools (click, type, dragAndDrop, clickAndHold, fillFormVision)
      *             for visual/screenshot-based interactions
+     * - 'cua': Uses Computer Use Agent (CUA) providers for screenshot-based automation
      */
     mode?: AgentToolMode;
 };

package/dist/index.js

@@ -179,7 +179,7 @@ var __forAwait = (obj, it, method) => (it = obj[__knownSymbol("asyncIterator")])
 var STAGEHAND_VERSION;
 var init_version = __esm({
   "lib/version.ts"() {
-    STAGEHAND_VERSION = "3.0.7-alpha-05f5580937c3c157550e3c25ae6671f44f562211";
+    STAGEHAND_VERSION = "3.0.7-alpha-f56a9c296d4ddce25a405358c66837f8ce4d679f";
   }
 });
 
@@ -28424,7 +28424,7 @@ var AgentCache = class {
     return sanitized;
   }
   buildConfigSignature(agentOptions) {
-    var _a4, _b, _c;
+    var _a4, _b;
     const toolKeys = (agentOptions == null ? void 0 : agentOptions.tools) ? Object.keys(agentOptions.tools).sort() : void 0;
     const integrationSignatures = (agentOptions == null ? void 0 : agentOptions.integrations) ? agentOptions.integrations.map(
       (integration) => typeof integration === "string" ? integration : "client"
@@ -28435,14 +28435,15 @@ var AgentCache = class {
     const serializedExecutionModel = this.serializeAgentModelForCache(
       agentOptions == null ? void 0 : agentOptions.executionModel
     );
+    const isCuaMode = (agentOptions == null ? void 0 : agentOptions.mode) === "cua" || (agentOptions == null ? void 0 : agentOptions.cua) === true;
     return JSON.stringify({
       v3Model: this.getBaseModelName(),
       systemPrompt: (_a4 = this.getSystemPrompt()) != null ? _a4 : "",
       agent: {
-        cua: (_b = agentOptions == null ? void 0 : agentOptions.cua) != null ? _b : false,
+        cua: isCuaMode,
         model: serializedModel != null ? serializedModel : null,
-        executionModel: (agentOptions == null ? void 0 : agentOptions.cua) ? null : serializedExecutionModel,
-        systemPrompt: (_c = agentOptions == null ? void 0 : agentOptions.systemPrompt) != null ? _c : null,
+        executionModel: isCuaMode ? null : serializedExecutionModel,
+        systemPrompt: (_b = agentOptions == null ? void 0 : agentOptions.systemPrompt) != null ? _b : null,
         toolKeys,
         integrations: integrationSignatures
       }
@@ -65497,7 +65498,8 @@ var StagehandAPIClient = class {
 init_sdkErrors();
 function validateExperimentalFeatures(options) {
   const { isExperimental, agentConfig, executeOptions, isStreaming } = options;
-  if (agentConfig == null ? void 0 : agentConfig.cua) {
+  const isCuaMode = (agentConfig == null ? void 0 : agentConfig.mode) === "cua" || (agentConfig == null ? void 0 : agentConfig.cua) === true;
+  if (isCuaMode) {
     const unsupportedFeatures = [];
     if (agentConfig == null ? void 0 : agentConfig.stream) {
       unsupportedFeatures.push("streaming");
@@ -65521,10 +65523,13 @@ function validateExperimentalFeatures(options) {
   if (hasIntegrations || hasTools) {
     features.push("MCP integrations and custom tools");
   }
-  if (!(agentConfig == null ? void 0 : agentConfig.cua) && (isStreaming || (agentConfig == null ? void 0 : agentConfig.stream))) {
+  if ((agentConfig == null ? void 0 : agentConfig.mode) === "hybrid") {
+    features.push("hybrid mode");
+  }
+  if (!isCuaMode && (isStreaming || (agentConfig == null ? void 0 : agentConfig.stream))) {
     features.push("streaming");
   }
-  if (executeOptions && !(agentConfig == null ? void 0 : agentConfig.cua)) {
+  if (executeOptions && !isCuaMode) {
     if (executeOptions.callbacks) {
       features.push("callbacks");
     }
@@ -66729,16 +66734,28 @@ var _V3 = class _V3 {
     });
   }
   agent(options) {
-    var _a4, _b, _c;
+    var _a4, _b, _c, _d2;
+    const isCuaMode = (options == null ? void 0 : options.mode) === "cua" || (options == null ? void 0 : options.cua) === true;
+    if ((options == null ? void 0 : options.cua) === true) {
+      this.logger({
+        category: "agent",
+        message: `[DEPRECATED] The "cua: true" option is deprecated. Use "mode: 'cua'" instead. This option will be removed in a future version.`,
+        level: 0
+      });
+      console.warn(
+        `[Stagehand] DEPRECATED: The "cua: true" option is deprecated. Use "mode: 'cua'" instead.`
+      );
+    }
     this.logger({
       category: "agent",
       message: `Creating v3 agent instance with options: ${JSON.stringify(options)}`,
       level: 1,
       auxiliary: __spreadValues({
-        cua: { value: (options == null ? void 0 : options.cua) ? "true" : "false", type: "boolean" },
+        cua: { value: isCuaMode ? "true" : "false", type: "boolean" },
+        mode: { value: (_a4 = options == null ? void 0 : options.mode) != null ? _a4 : "dom", type: "string" },
         model: (options == null ? void 0 : options.model) ? typeof (options == null ? void 0 : options.model) === "string" ? { value: options.model, type: "string" } : { value: options.model.modelName, type: "string" } : { value: this.llmClient.modelName, type: "string" },
-        systemPrompt: { value: (_a4 = options == null ? void 0 : options.systemPrompt) != null ? _a4 : "", type: "string" },
-        tools: { value: JSON.stringify((_b = options == null ? void 0 : options.tools) != null ? _b : {}), type: "object" }
+        systemPrompt: { value: (_b = options == null ? void 0 : options.systemPrompt) != null ? _b : "", type: "string" },
+        tools: { value: JSON.stringify((_c = options == null ? void 0 : options.tools) != null ? _c : {}), type: "object" }
       }, (options == null ? void 0 : options.integrations) && {
         integrations: {
           value: JSON.stringify(options.integrations),
@@ -66746,7 +66763,7 @@ var _V3 = class _V3 {
         }
       })
     });
-    if (options == null ? void 0 : options.cua) {
+    if (isCuaMode) {
       validateExperimentalFeatures({
         isExperimental: this.experimental,
         agentConfig: options
@@ -66848,7 +66865,7 @@ Do not ask follow up questions, the user will trust your judgement.`
       };
     }
     const agentConfigSignature = this.agentCache.buildConfigSignature(options);
-    const isStreaming = (_c = options == null ? void 0 : options.stream) != null ? _c : false;
+    const isStreaming = (_d2 = options == null ? void 0 : options.stream) != null ? _d2 : false;
     return {
       execute: (instructionOrOptions) => __async(this, null, function* () {
         return withInstanceLogContext(this.instanceId, () => __async(this, null, function* () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "3.0.7-alpha-05f5580937c3c157550e3c25ae6671f44f562211",
+  "version": "3.0.7-alpha-f56a9c296d4ddce25a405358c66837f8ce4d679f",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",