@browserbasehq/stagehand 3.0.7-alpha-6a5496f17dbb716be1ee1aaa4e5ba9d8c723b30b → 3.0.7-alpha-e822f5a8898df9eb48ca32c321025f0c74b638f0

package/dist/index.d.ts

@@ -1533,63 +1533,32 @@ declare class Page {
      * on the top-level page target's session. Coordinates are relative to the
      * viewport origin (top-left). Does not scroll.
      */
-    click(x: number, y: number, options: {
-        button?: "left" | "right" | "middle";
-        clickCount?: number;
-        returnXpath: true;
-    }): Promise<string>;
     click(x: number, y: number, options?: {
         button?: "left" | "right" | "middle";
         clickCount?: number;
-        returnXpath?: false;
-    }): Promise<void>;
-    click(x: number, y: number, options: {
-        button?: "left" | "right" | "middle";
-        clickCount?: number;
-        returnXpath: boolean;
-    }): Promise<void | string>;
+        returnXpath?: boolean;
+    }): Promise<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;
+        returnXpath?: boolean;
     }): Promise<string>;
     scroll(x: number, y: number, deltaX: number, deltaY: number, options?: {
-        returnXpath?: false;
-    }): Promise<void>;
-    scroll(x: number, y: number, deltaX: number, deltaY: number, options: {
-        returnXpath: boolean;
-    }): Promise<void | string>;
+        returnXpath?: boolean;
+    }): Promise<string>;
     /**
      * Drag from (fromX, fromY) to (toX, toY) using mouse events.
      * Sends mouseMoved → mousePressed → mouseMoved (steps) → mouseReleased.
      */
-    dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options: {
-        button?: "left" | "right" | "middle";
-        steps?: number;
-        delay?: number;
-        returnXpath: true;
-    }): Promise<[string, string]>;
     dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options?: {
         button?: "left" | "right" | "middle";
         steps?: number;
         delay?: number;
-        returnXpath?: false;
-    }): Promise<void>;
-    dragAndDrop(fromX: number, fromY: number, toX: number, toY: number, options: {
-        button?: "left" | "right" | "middle";
-        steps?: number;
-        delay?: number;
-        returnXpath: boolean;
-    }): Promise<void | [string, string]>;
+        returnXpath?: boolean;
+    }): Promise<[string, string]>;
     /**
      * Type a string by dispatching keyDown/keyUp events per character.
      * Focus must already be on the desired element. Uses CDP Input.dispatchKeyEvent

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-6a5496f17dbb716be1ee1aaa4e5ba9d8c723b30b";
+    STAGEHAND_VERSION = "3.0.7-alpha-e822f5a8898df9eb48ca32c321025f0c74b638f0";
   }
 });
 
@@ -26247,7 +26247,7 @@ var init_page = __esm({
               clickCount: i2
             });
           }
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       hover(x2, y, options) {
@@ -26292,7 +26292,7 @@ var init_page = __esm({
             y,
             button: "none"
           });
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       scroll(x2, y, deltaX, deltaY, options) {
@@ -26320,7 +26320,7 @@ var init_page = __esm({
             deltaX,
             deltaY
           });
-          if (options == null ? void 0 : options.returnXpath) return xpathResult != null ? xpathResult : "";
+          return xpathResult != null ? xpathResult : "";
         });
       }
       dragAndDrop(fromX, fromY, toX, toY, options) {
@@ -26394,7 +26394,7 @@ var init_page = __esm({
             buttons: buttonMask(button),
             clickCount: 1
           });
-          if (options == null ? void 0 : options.returnXpath) return [fromXpath != null ? fromXpath : "", toXpath != null ? toXpath : ""];
+          return [fromXpath != null ? fromXpath : "", toXpath != null ? toXpath : ""];
         });
       }
       type(text, options) {
@@ -27873,17 +27873,19 @@ var ActCache = class {
     return __async(this, null, function* () {
       if (!this.enabled) return null;
       const sanitizedInstruction = instruction.trim();
-      const sanitizedVariables = variables ? __spreadValues({}, variables) : {};
+      const sanitizedVariables = variables ? __spreadValues({}, variables) : void 0;
+      const variableKeys = sanitizedVariables ? Object.keys(sanitizedVariables).sort() : [];
       const pageUrl = yield safeGetPageUrl(page);
       const cacheKey = this.buildActCacheKey(
         sanitizedInstruction,
         pageUrl,
-        sanitizedVariables
+        variableKeys
       );
       return {
         instruction: sanitizedInstruction,
         cacheKey,
         pageUrl,
+        variableKeys,
         variables: sanitizedVariables
       };
     });
@@ -27913,6 +27915,22 @@ var ActCache = class {
       if (!Array.isArray(entry.actions) || entry.actions.length === 0) {
         return null;
       }
+      const entryVariableKeys = Array.isArray(entry.variableKeys) ? [...entry.variableKeys].sort() : [];
+      const contextVariableKeys = [...context.variableKeys];
+      if (!this.doVariableKeysMatch(entryVariableKeys, contextVariableKeys)) {
+        return null;
+      }
+      if (contextVariableKeys.length > 0 && (!context.variables || !this.hasAllVariableValues(contextVariableKeys, context.variables))) {
+        this.logger({
+          category: "cache",
+          message: "act cache miss: missing variables for replay",
+          level: 2,
+          auxiliary: {
+            instruction: { value: context.instruction, type: "string" }
+          }
+        });
+        return null;
+      }
       this.logger({
         category: "cache",
         message: "act cache hit",
@@ -27936,7 +27954,7 @@ var ActCache = class {
         version: 1,
         instruction: context.instruction,
         url: context.pageUrl,
-        variables: context.variables,
+        variableKeys: context.variableKeys,
         actions: (_a4 = result.actions) != null ? _a4 : [],
         actionDescription: result.actionDescription,
         message: result.message
@@ -27967,11 +27985,11 @@ var ActCache = class {
       });
     });
   }
-  buildActCacheKey(instruction, url, variables) {
+  buildActCacheKey(instruction, url, variableKeys) {
     const payload = JSON.stringify({
       instruction,
       url,
-      variables
+      variableKeys
     });
     return (0, import_crypto.createHash)("sha256").update(payload).digest("hex");
   }
@@ -27989,7 +28007,9 @@ var ActCache = class {
             action,
             page,
             this.domSettleTimeoutMs,
-            this.getDefaultLlmClient()
+            this.getDefaultLlmClient(),
+            void 0,
+            context.variables
           );
           actionResults.push(result);
           if (!result.success) {
@@ -28065,7 +28085,9 @@ var ActCache = class {
     return __async(this, null, function* () {
       const { error, path: path8 } = yield this.storage.writeJson(
         `${context.cacheKey}.json`,
-        entry
+        __spreadProps(__spreadValues({}, entry), {
+          variableKeys: context.variableKeys
+        })
       );
       if (error && path8) {
         this.logger({
@@ -28089,6 +28111,25 @@ var ActCache = class {
       });
     });
   }
+  doVariableKeysMatch(entryKeys, contextKeys) {
+    if (entryKeys.length !== contextKeys.length) {
+      return false;
+    }
+    for (let i2 = 0; i2 < entryKeys.length; i2 += 1) {
+      if (entryKeys[i2] !== contextKeys[i2]) {
+        return false;
+      }
+    }
+    return true;
+  }
+  hasAllVariableValues(variableKeys, variables) {
+    for (const key of variableKeys) {
+      if (!(key in variables)) {
+        return false;
+      }
+    }
+    return true;
+  }
   runWithTimeout(run, timeout) {
     return __async(this, null, function* () {
       if (!timeout) {
@@ -30074,7 +30115,6 @@ var ActHandler = class {
       domElements,
       xpathMap,
       llmClient,
-      variables,
       requireMethodAndArguments = true
     }) {
       const response = yield act({
@@ -30094,14 +30134,8 @@ var ActHandler = class {
       if (!normalized) {
         return { response };
       }
-      const action = __spreadProps(__spreadValues({}, normalized), {
-        arguments: substituteVariablesInArguments(
-          normalized.arguments,
-          variables
-        )
-      });
       return {
-        action,
+        action: __spreadValues({}, normalized),
         response
       };
     });
@@ -30135,8 +30169,7 @@ var ActHandler = class {
         instruction: actInstruction,
         domElements: combinedTree,
         xpathMap: combinedXpathMap,
-        llmClient,
-        variables
+        llmClient
       });
       if (!firstAction) {
         v3Logger({
@@ -30157,7 +30190,8 @@ var ActHandler = class {
         page,
         this.defaultDomSettleTimeoutMs,
         llmClient,
-        ensureTimeRemaining
+        ensureTimeRemaining,
+        variables
       );
       if ((actInferenceResponse == null ? void 0 : actInferenceResponse.twoStep) !== true) {
         return firstResult;
@@ -30184,8 +30218,7 @@ var ActHandler = class {
         instruction: stepTwoInstructions,
         domElements: diffedTree,
         xpathMap: combinedXpathMap2,
-        llmClient,
-        variables
+        llmClient
       });
       if (!secondAction) {
         return firstResult;
@@ -30196,7 +30229,8 @@ var ActHandler = class {
         page,
         this.defaultDomSettleTimeoutMs,
         llmClient,
-        ensureTimeRemaining
+        ensureTimeRemaining,
+        variables
       );
       return {
         success: firstResult.success && secondResult.success,
@@ -30209,9 +30243,9 @@ var ActHandler = class {
       };
     });
   }
-  takeDeterministicAction(action, page, domSettleTimeoutMs, llmClientOverride, ensureTimeRemaining) {
+  takeDeterministicAction(action, page, domSettleTimeoutMs, llmClientOverride, ensureTimeRemaining, variables) {
     return __async(this, null, function* () {
-      var _a4;
+      var _a4, _b;
       ensureTimeRemaining == null ? void 0 : ensureTimeRemaining();
       const settleTimeout = domSettleTimeoutMs != null ? domSettleTimeoutMs : this.defaultDomSettleTimeoutMs;
       const effectiveClient = llmClientOverride != null ? llmClientOverride : this.llmClient;
@@ -30232,7 +30266,8 @@ var ActHandler = class {
           actions: []
         };
       }
-      const args = Array.isArray(action.arguments) ? action.arguments : [];
+      const placeholderArgs = Array.isArray(action.arguments) ? [...action.arguments] : [];
+      const resolvedArgs = (_b = substituteVariablesInArguments(action.arguments, variables)) != null ? _b : [];
       try {
         ensureTimeRemaining == null ? void 0 : ensureTimeRemaining();
         yield performUnderstudyMethod(
@@ -30240,7 +30275,7 @@ var ActHandler = class {
           page.mainFrame(),
           method,
           action.selector,
-          args,
+          resolvedArgs,
           settleTimeout
         );
         return {
@@ -30252,7 +30287,7 @@ var ActHandler = class {
               selector: action.selector,
               description: action.description || `action (${method})`,
               method,
-              arguments: args
+              arguments: placeholderArgs
             }
           ]
         };
@@ -30312,7 +30347,7 @@ var ActHandler = class {
               page.mainFrame(),
               method,
               newSelector,
-              args,
+              resolvedArgs,
               settleTimeout
             );
             return {
@@ -30324,7 +30359,7 @@ var ActHandler = class {
                   selector: newSelector,
                   description: action.description || `action (${method})`,
                   method,
-                  arguments: args
+                  arguments: placeholderArgs
                 }
               ]
             };
@@ -65182,7 +65217,8 @@ var _V3 = class _V3 {
               v3Page,
               this.domSettleTimeoutMs,
               this.resolveLlmClient(options == null ? void 0 : options.model),
-              ensureTimeRemaining
+              ensureTimeRemaining,
+              options == null ? void 0 : options.variables
             );
           }
           this.addToHistory(

package/package.json

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