@browserbasehq/stagehand 1.1.0 → 1.1.1

package/README.md

@@ -137,7 +137,7 @@ This constructor is used to create an instance of Stagehand.
     - `1`: SDK-level logging
     - `2`: LLM-client level logging (most granular)
   - `debugDom`: a `boolean` that draws bounding boxes around elements presented to the LLM during automation.
-  - `domSettleTimeoutMs`: an `integer` that specifies the timeout in milliseconds for waiting for the DOM to settle. Defaults to 30000 (30 seconds).
+  - `domSettleTimeoutMs`: an `integer` that specifies the timeout in milliseconds for waiting for the DOM to settle. It can be overriden in individual function calls if needed. Defaults to 30000 (30 seconds).
   - `enableCaching`: a `boolean` that enables caching of LLM responses. When set to `true`, the LLM requests will be cached on disk and reused for identical requests. Defaults to `false`.
 
 - **Returns:**
@@ -179,6 +179,7 @@ This constructor is used to create an instance of Stagehand.
   - `action`: a `string` describing the action to perform, e.g., `"search for 'x'"`.
   - `modelName`: (optional) an `AvailableModel` string to specify the model to use.
   - `useVision`: (optional) a `boolean` or `"fallback"` to determine if vision-based processing should be used. Defaults to `"fallback"`.
+  - `domSettleTimeoutMs`: (optional) an `integer` that specifies the timeout in milliseconds for waiting for the DOM to settle. If not set, defaults to the timeout value specified during initialization.
 
 - **Returns:**
 
@@ -201,6 +202,7 @@ This constructor is used to create an instance of Stagehand.
   - `instruction`: a `string` providing instructions for extraction.
   - `schema`: a `z.AnyZodObject` defining the structure of the data to extract.
   - `modelName`: (optional) an `AvailableModel` string to specify the model to use.
+  - `domSettleTimeoutMs`: (optional) an `integer` that specifies the timeout in milliseconds for waiting for the DOM to settle. If not set, defaults to the timeout value specified during initialization.
 
 - **Returns:**
 
@@ -229,6 +231,7 @@ If you are looking for a specific element, you can also pass in an instruction t
 
   - `instruction`: a `string` providing instructions for the observation.
   - `useVision`: (optional) a `boolean` or `"fallback"` to determine if vision-based processing should be used. Defaults to `"fallback"`.
+  - `domSettleTimeoutMs`: (optional) an `integer` that specifies the timeout in milliseconds for waiting for the DOM to settle. If not set, defaults to the timeout value specified during initialization.
 
 - **Returns:**
 

package/dist/index.d.ts

@@ -115,24 +115,27 @@ declare class Stagehand {
     private _extract;
     private _observe;
     private _act;
-    act({ action, modelName, useVision, }: {
+    act({ action, modelName, useVision, domSettleTimeoutMs, }: {
         action: string;
         modelName?: AvailableModel;
         useVision?: "fallback" | boolean;
+        domSettleTimeoutMs?: number;
     }): Promise<{
         success: boolean;
         message: string;
         action: string;
     }>;
-    extract<T extends z.AnyZodObject>({ instruction, schema, modelName, }: {
+    extract<T extends z.AnyZodObject>({ instruction, schema, modelName, domSettleTimeoutMs, }: {
         instruction: string;
         schema: T;
         modelName?: AvailableModel;
+        domSettleTimeoutMs?: number;
     }): Promise<z.infer<T>>;
     observe(options?: {
         instruction?: string;
         modelName?: AvailableModel;
         useVision?: boolean;
+        domSettleTimeoutMs?: number;
     }): Promise<{
         selector: string;
         description: string;

package/dist/index.js

@@ -1513,7 +1513,7 @@ var Stagehand = class {
     this.verbose = verbose != null ? verbose : 0;
     this.debugDom = debugDom != null ? debugDom : false;
     this.defaultModelName = "gpt-4o";
-    this.domSettleTimeoutMs = domSettleTimeoutMs != null ? domSettleTimeoutMs : 6e4;
+    this.domSettleTimeoutMs = domSettleTimeoutMs != null ? domSettleTimeoutMs : 3e4;
     this.headless = headless != null ? headless : false;
     this.browserBaseSessionCreateParams = browserBaseSessionCreateParams;
     this.browserbaseResumeSessionID = browserbaseResumeSessionID;
@@ -1747,14 +1747,15 @@ Trace: ${e.stack}`,
       content = {},
       chunksSeen = [],
       modelName,
-      requestId
+      requestId,
+      domSettleTimeoutMs
     }) {
       this.log({
         category: "extraction",
         message: `starting extraction '${instruction}'`,
         level: 1
       });
-      yield this._waitForSettledDom();
+      yield this._waitForSettledDom(domSettleTimeoutMs);
       yield this.startDomDebug();
       const { outputString, chunk, chunks } = yield this.page.evaluate(
         (chunksSeen2) => window.processDom(chunksSeen2 != null ? chunksSeen2 : []),
@@ -1802,14 +1803,15 @@ Trace: ${e.stack}`,
           message: `continuing extraction, progress: '${newProgress}'`,
           level: 1
         });
-        yield this._waitForSettledDom();
+        yield this._waitForSettledDom(domSettleTimeoutMs);
         return this._extract({
           instruction,
           schema,
           progress: newProgress,
           content: output,
           chunksSeen,
-          modelName
+          modelName,
+          domSettleTimeoutMs
         });
       }
     });
@@ -1820,7 +1822,8 @@ Trace: ${e.stack}`,
       useVision,
       fullPage,
       modelName,
-      requestId
+      requestId,
+      domSettleTimeoutMs
     }) {
       if (!instruction) {
         instruction = `Find elements that can be used for any future actions in the page. These may be navigation links, related pages, section/subsection links, buttons, or other interactive elements. Be comprehensive: if there are multiple elements that may be relevant for future actions, return all of them.`;
@@ -1831,7 +1834,7 @@ Trace: ${e.stack}`,
         message: `starting observation: ${instruction}`,
         level: 1
       });
-      yield this._waitForSettledDom();
+      yield this._waitForSettledDom(domSettleTimeoutMs);
       yield this.startDomDebug();
       let { outputString, selectorMap } = yield this.page.evaluate(
         (fullPage2) => fullPage2 ? window.processAllOfDom() : window.processDom([]),
@@ -1891,7 +1894,8 @@ Trace: ${e.stack}`,
       useVision,
       verifierUseVision,
       retries = 0,
-      requestId
+      requestId,
+      domSettleTimeoutMs
     }) {
       var _a;
       const model = modelName != null ? modelName : this.defaultModelName;
@@ -1909,7 +1913,7 @@ Trace: ${e.stack}`,
         message: `Running / Continuing action: ${action} on page: ${this.page.url()}`,
         level: 2
       });
-      yield this._waitForSettledDom();
+      yield this._waitForSettledDom(domSettleTimeoutMs);
       yield this.startDomDebug();
       this.log({
         category: "action",
@@ -1975,7 +1979,8 @@ Trace: ${e.stack}`,
             modelName,
             useVision,
             verifierUseVision,
-            requestId
+            requestId,
+            domSettleTimeoutMs
           });
         } else if (useVision === "fallback") {
           this.log({
@@ -1991,7 +1996,8 @@ Trace: ${e.stack}`,
             modelName,
             useVision: true,
             verifierUseVision,
-            requestId
+            requestId,
+            domSettleTimeoutMs
           });
         } else {
           if (this.enableCaching) {
@@ -2054,7 +2060,8 @@ Trace: ${e.stack}`,
                 verifierUseVision,
                 retries: retries + 1,
                 chunksSeen,
-                requestId
+                requestId,
+                domSettleTimeoutMs
               });
             }
           }
@@ -2084,7 +2091,8 @@ Trace: ${e.stack}`,
                 verifierUseVision,
                 retries: retries + 1,
                 chunksSeen,
-                requestId
+                requestId,
+                domSettleTimeoutMs
               });
             }
           }
@@ -2108,7 +2116,8 @@ Trace: ${e.stack}`,
                 verifierUseVision,
                 retries: retries + 1,
                 chunksSeen,
-                requestId
+                requestId,
+                domSettleTimeoutMs
               });
             }
           }
@@ -2138,7 +2147,8 @@ Trace: ${e.stack}`,
                 verifierUseVision,
                 retries: retries + 1,
                 chunksSeen,
-                requestId
+                requestId,
+                domSettleTimeoutMs
               });
             }
           }
@@ -2168,7 +2178,7 @@ Trace: ${e.stack}`,
               yield newOpenedTab.close();
               yield this.page.goto(newOpenedTab.url());
               yield this.page.waitForLoadState("domcontentloaded");
-              yield this._waitForSettledDom();
+              yield this._waitForSettledDom(domSettleTimeoutMs);
             }
             yield Promise.race([
               this.page.waitForLoadState("networkidle"),
@@ -2302,7 +2312,8 @@ Trace: ${e.stack}`,
             chunksSeen,
             useVision,
             verifierUseVision,
-            requestId
+            requestId,
+            domSettleTimeoutMs
           });
         } else {
           this.log({
@@ -2333,7 +2344,8 @@ Trace: ${error.stack}`,
             verifierUseVision,
             retries: retries + 1,
             chunksSeen,
-            requestId
+            requestId,
+            domSettleTimeoutMs
           });
         }
         yield this._recordAction(action, "");
@@ -2352,7 +2364,8 @@ Trace: ${error.stack}`,
     return __async(this, arguments, function* ({
       action,
       modelName,
-      useVision = "fallback"
+      useVision = "fallback",
+      domSettleTimeoutMs
     }) {
       useVision = useVision != null ? useVision : "fallback";
       const requestId = Math.random().toString(36).substring(2);
@@ -2366,7 +2379,8 @@ Trace: ${error.stack}`,
         chunksSeen: [],
         useVision,
         verifierUseVision: useVision !== false,
-        requestId
+        requestId,
+        domSettleTimeoutMs
       }).catch((e) => {
         this.logger({
           category: "act",
@@ -2388,7 +2402,8 @@ Trace: ${e.stack}`
     return __async(this, arguments, function* ({
       instruction,
       schema,
-      modelName
+      modelName,
+      domSettleTimeoutMs
     }) {
       const requestId = Math.random().toString(36).substring(2);
       this.logger({
@@ -2399,7 +2414,8 @@ Trace: ${e.stack}`
         instruction,
         schema,
         modelName,
-        requestId
+        requestId,
+        domSettleTimeoutMs
       }).catch((e) => {
         this.logger({
           category: "extract",
@@ -2426,7 +2442,8 @@ Trace: ${e.stack}`
         modelName: options == null ? void 0 : options.modelName,
         useVision: (_b = options == null ? void 0 : options.useVision) != null ? _b : false,
         fullPage: false,
-        requestId
+        requestId,
+        domSettleTimeoutMs: options == null ? void 0 : options.domSettleTimeoutMs
       }).catch((e) => {
         this.logger({
           category: "observe",

package/package.json

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