@browserbasehq/stagehand 2.5.5 → 2.5.6

package/dist/index.d.ts

@@ -314,6 +314,9 @@ interface ObserveOptions {
      * @deprecated The `onlyVisible` parameter has no effect in this version of Stagehand and will be removed in later versions.
      */
     onlyVisible?: boolean;
+    /**
+     * @deprecated The `drawOverlay` parameter has no effect in this version of Stagehand and will be removed in later versions.
+     */
     drawOverlay?: boolean;
     iframes?: boolean;
     frameId?: string;

package/dist/index.js

@@ -494,7 +494,7 @@ var StagehandFunctionName = /* @__PURE__ */ ((StagehandFunctionName2) => {
 })(StagehandFunctionName || {});
 
 // lib/version.ts
-var STAGEHAND_VERSION = "2.5.5";
+var STAGEHAND_VERSION = "2.5.6";
 
 // types/stagehandErrors.ts
 var StagehandError = class extends Error {
@@ -2161,57 +2161,6 @@ function validateZodSchema(schema, data) {
   }
   throw new ZodSchemaValidationError(data, result.error.format());
 }
-function drawObserveOverlay(page, results) {
-  return __async(this, null, function* () {
-    const xpathList = results.map((result) => result.selector);
-    const validXpaths = xpathList.filter((xpath) => xpath !== "xpath=");
-    yield page.evaluate((selectors2) => {
-      selectors2.forEach((selector) => {
-        let element;
-        if (selector.startsWith("xpath=")) {
-          const xpath = selector.substring(6);
-          element = document.evaluate(
-            xpath,
-            document,
-            null,
-            XPathResult.FIRST_ORDERED_NODE_TYPE,
-            null
-          ).singleNodeValue;
-        } else {
-          element = document.querySelector(selector);
-        }
-        if (element instanceof HTMLElement) {
-          const overlay = document.createElement("div");
-          overlay.setAttribute("stagehandObserve", "true");
-          const rect = element.getBoundingClientRect();
-          overlay.style.position = "absolute";
-          overlay.style.left = rect.left + "px";
-          overlay.style.top = rect.top + "px";
-          overlay.style.width = rect.width + "px";
-          overlay.style.height = rect.height + "px";
-          overlay.style.backgroundColor = "rgba(255, 255, 0, 0.3)";
-          overlay.style.pointerEvents = "none";
-          overlay.style.zIndex = "10000";
-          document.body.appendChild(overlay);
-        }
-      });
-    }, validXpaths);
-  });
-}
-function clearOverlays(page) {
-  return __async(this, null, function* () {
-    yield page.evaluate(() => {
-      const elements = document.querySelectorAll('[stagehandObserve="true"]');
-      elements.forEach((el) => {
-        const parent = el.parentNode;
-        while (el.firstChild) {
-          parent == null ? void 0 : parent.insertBefore(el.firstChild, el);
-        }
-        parent == null ? void 0 : parent.removeChild(el);
-      });
-    });
-  });
-}
 function isRunningInBun() {
   return typeof process !== "undefined" && typeof process.versions !== "undefined" && "bun" in process.versions;
 }
@@ -3709,6 +3658,13 @@ var StagehandObserveHandler = class {
           level: 1
         });
       }
+      if (drawOverlay !== void 0) {
+        this.logger({
+          category: "observation",
+          message: "Warning: the drawOverlay parameter has been deprecated and this parameter is now a no-op.",
+          level: 1
+        });
+      }
       yield this.stagehandPage._waitForSettledDom();
       this.logger({
         category: "observation",
@@ -3836,9 +3792,6 @@ var StagehandObserveHandler = class {
           }
         }
       });
-      if (drawOverlay) {
-        yield drawObserveOverlay(this.stagehandPage.page, elementsWithSelectors);
-      }
       return elementsWithSelectors;
     });
   }
@@ -4389,7 +4342,6 @@ var StagehandPage = class _StagehandPage {
         if (!this.actHandler) {
           throw new HandlerNotInitializedError("Act");
         }
-        yield clearOverlays(this.page);
         if (typeof actionOrOptions === "object" && actionOrOptions !== null) {
           if ("selector" in actionOrOptions && "method" in actionOrOptions) {
             const observeResult = actionOrOptions;
@@ -4468,7 +4420,6 @@ var StagehandPage = class _StagehandPage {
         if (!this.extractHandler) {
           throw new HandlerNotInitializedError("Extract");
         }
-        yield clearOverlays(this.page);
         if (!instructionOrOptions) {
           let result2;
           if (this.api) {
@@ -4571,7 +4522,6 @@ var StagehandPage = class _StagehandPage {
         if (!this.observeHandler) {
           throw new HandlerNotInitializedError("Observe");
         }
-        yield clearOverlays(this.page);
         const options = typeof instructionOrOptions === "string" ? { instruction: instructionOrOptions } : instructionOrOptions || {};
         const {
           instruction,

package/dist/lib/handlers/observeHandler.d.ts

@@ -25,6 +25,9 @@ export declare class StagehandObserveHandler {
          * @deprecated The `onlyVisible` parameter has no effect in this version of Stagehand and will be removed in later versions.
          */
         onlyVisible?: boolean;
+        /**
+         * @deprecated The `drawOverlay` parameter has no effect in this version of Stagehand and will be removed in later versions.
+         */
         drawOverlay?: boolean;
         fromAct?: boolean;
         iframes?: boolean;

package/dist/lib/utils.d.ts

@@ -1,12 +1,9 @@
 import { Schema } from "@google/genai";
 import { z, ZodTypeAny } from "zod/v3";
-import { ObserveResult, Page } from ".";
 import { LogLine } from "../types/log";
 import { ModelProvider } from "../types/model";
 import { ZodPathSegments } from "../types/stagehand";
 export declare function validateZodSchema(schema: z.ZodTypeAny, data: unknown): boolean;
-export declare function drawObserveOverlay(page: Page, results: ObserveResult[]): Promise<void>;
-export declare function clearOverlays(page: Page): Promise<void>;
 /**
  * Detects if the code is running in the Bun runtime environment.
  * @returns {boolean} True if running in Bun, false otherwise.

package/dist/lib/version.d.ts

@@ -2,4 +2,4 @@
  * AUTO-GENERATED — DO NOT EDIT BY HAND
  *  Run `pnpm run gen-version` to refresh.
  */
-export declare const STAGEHAND_VERSION: "2.5.5";
+export declare const STAGEHAND_VERSION: "2.5.6";

package/dist/types/stagehand.d.ts

@@ -150,6 +150,9 @@ export interface ObserveOptions {
      * @deprecated The `onlyVisible` parameter has no effect in this version of Stagehand and will be removed in later versions.
      */
     onlyVisible?: boolean;
+    /**
+     * @deprecated The `drawOverlay` parameter has no effect in this version of Stagehand and will be removed in later versions.
+     */
     drawOverlay?: boolean;
     iframes?: boolean;
     frameId?: string;

package/package.json

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