@browserbasehq/stagehand 3.0.7-alpha-cadd192066c8aa5d19bb4d5daa630ed5981b5d7e → 3.0.7-alpha-b40ae11391af49c3581fce27faa1b7483fc4a169

package/dist/index.d.ts

@@ -1545,6 +1545,17 @@ declare class Page {
         clickCount?: number;
         returnXpath: boolean;
     }): Promise<void | string>;
+    /**
+     * Hover at absolute page coordinates (CSS pixels).
+     * Dispatches mouseMoved via CDP Input domain on the top-level page target's
+     * session.
+     */
+    hover(x: number, y: number, options: {
+        returnXpath: true;
+    }): Promise<string>;
+    hover(x: number, y: number, options?: {
+        returnXpath?: false;
+    }): Promise<void>;
     scroll(x: number, y: number, deltaX: number, deltaY: number, options: {
         returnXpath: true;
     }): Promise<string>;

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-cadd192066c8aa5d19bb4d5daa630ed5981b5d7e";
+    STAGEHAND_VERSION = "3.0.7-alpha-b40ae11391af49c3581fce27faa1b7483fc4a169";
   }
 });
 
@@ -25212,7 +25212,7 @@ var page_exports = {};
 __export(page_exports, {
   Page: () => Page
 });
-var import_fs7, LIFECYCLE_NAME, _keyPress_dec, _type_dec, _dragAndDrop_dec, _scroll_dec, _click_dec, _evaluate_dec, _waitForLoadState_dec, _screenshot_dec, _goForward_dec, _goBack_dec, _reload_dec, _goto_dec, _close_dec, _init, _Page, Page;
+var import_fs7, LIFECYCLE_NAME, _keyPress_dec, _type_dec, _dragAndDrop_dec, _scroll_dec, _hover_dec, _click_dec, _evaluate_dec, _waitForLoadState_dec, _screenshot_dec, _goForward_dec, _goBack_dec, _reload_dec, _goto_dec, _close_dec, _init, _Page, Page;
 var init_page = __esm({
   "lib/v3/understudy/page.ts"() {
     import_fs7 = require("fs");
@@ -25237,7 +25237,7 @@ var init_page = __esm({
       domcontentloaded: "DOMContentLoaded",
       networkidle: "networkIdle"
     };
-    _close_dec = [logAction("Page.close")], _goto_dec = [logAction("Page.goto")], _reload_dec = [logAction("Page.reload")], _goBack_dec = [logAction("Page.goBack")], _goForward_dec = [logAction("Page.goForward")], _screenshot_dec = [logAction("Page.screenshot")], _waitForLoadState_dec = [logAction("Page.waitForLoadState")], _evaluate_dec = [logAction("Page.evaluate")], _click_dec = [logAction("Page.click")], _scroll_dec = [logAction("Page.scroll")], _dragAndDrop_dec = [logAction("Page.dragAndDrop")], _type_dec = [logAction("Page.type")], _keyPress_dec = [logAction("Page.keyPress")];
+    _close_dec = [logAction("Page.close")], _goto_dec = [logAction("Page.goto")], _reload_dec = [logAction("Page.reload")], _goBack_dec = [logAction("Page.goBack")], _goForward_dec = [logAction("Page.goForward")], _screenshot_dec = [logAction("Page.screenshot")], _waitForLoadState_dec = [logAction("Page.waitForLoadState")], _evaluate_dec = [logAction("Page.evaluate")], _click_dec = [logAction("Page.click")], _hover_dec = [logAction("Page.hover")], _scroll_dec = [logAction("Page.scroll")], _dragAndDrop_dec = [logAction("Page.dragAndDrop")], _type_dec = [logAction("Page.type")], _keyPress_dec = [logAction("Page.keyPress")];
     _Page = class _Page {
       constructor(conn, mainSession, _targetId, mainFrameId, apiClient, browserIsRemote = false) {
         this.conn = conn;
@@ -26245,6 +26245,51 @@ var init_page = __esm({
           if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
         });
       }
+      hover(x2, y, options) {
+        return __async(this, null, function* () {
+          let xpathResult;
+          if (options == null ? void 0 : options.returnXpath) {
+            try {
+              const hit = yield resolveXpathForLocation(this, x2, y);
+              if (hit) {
+                v3Logger({
+                  category: "page",
+                  message: "hover resolved hit",
+                  level: 2,
+                  auxiliary: {
+                    frameId: { value: String(hit.frameId), type: "string" },
+                    backendNodeId: {
+                      value: String(hit.backendNodeId),
+                      type: "string"
+                    },
+                    x: { value: String(x2), type: "integer" },
+                    y: { value: String(y), type: "integer" }
+                  }
+                });
+                xpathResult = hit.absoluteXPath;
+              }
+            } catch (e2) {
+              v3Logger({
+                category: "page",
+                message: "Failed to resolve xpath for hover",
+                level: 2,
+                auxiliary: {
+                  x: { value: String(x2), type: "integer" },
+                  y: { value: String(y), type: "integer" }
+                }
+              });
+            }
+          }
+          yield this.updateCursor(x2, y);
+          yield this.mainSession.send("Input.dispatchMouseEvent", {
+            type: "mouseMoved",
+            x: x2,
+            y,
+            button: "none"
+          });
+          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+        });
+      }
       scroll(x2, y, deltaX, deltaY, options) {
         return __async(this, null, function* () {
           let xpathResult;
@@ -26776,6 +26821,7 @@ var init_page = __esm({
     __decorateElement(_init, 1, "waitForLoadState", _waitForLoadState_dec, _Page);
     __decorateElement(_init, 1, "evaluate", _evaluate_dec, _Page);
     __decorateElement(_init, 1, "click", _click_dec, _Page);
+    __decorateElement(_init, 1, "hover", _hover_dec, _Page);
     __decorateElement(_init, 1, "scroll", _scroll_dec, _Page);
     __decorateElement(_init, 1, "dragAndDrop", _dragAndDrop_dec, _Page);
     __decorateElement(_init, 1, "type", _type_dec, _Page);

package/package.json

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