browse 0.11.2 → 0.11.3

package/README.md

@@ -29,6 +29,8 @@ npm install -g browse
 
 ## Quick start
 
+Requires Node.js 22.18+.
+
 ```bash
 npm install -g browse
 

package/bin/run.js

@@ -1,5 +1,16 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { config as loadDotenvConfig } from "dotenv";
+import satisfies from "semver/functions/satisfies.js";
+
+const require = createRequire(import.meta.url);
+const { engines } = require("../package.json");
+if (!satisfies(process.versions.node, engines.node)) {
+  console.error(
+    `[browse] Node.js ${engines.node} is required; found ${process.versions.node}. Upgrade Node.js and rerun browse.`,
+  );
+  process.exit(1);
+}
 
 // `BROWSE_LOAD_DOTENV` controls whether `browse` auto-loads a `.env` file
 // from the current working directory. This is deprecated: a future release

package/oclif.manifest.json

@@ -3310,25 +3310,13 @@
         "publish.js"
       ]
     },
-    "mouse:click": {
+    "network:clear": {
       "aliases": [],
-      "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
-        }
-      },
-      "description": "Click raw viewport coordinates in the active page.",
+      "args": {},
+      "description": "Clear captured network request directories for the active browser session.",
       "examples": [
-        "browse mouse click 240 320",
-        "browse mouse click 240 320 --button right",
-        "browse mouse click 240 320 --click-count 2"
+        "browse network clear",
+        "browse network clear --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3419,34 +3407,11 @@
           "name": "verified",
           "allowNo": false,
           "type": "boolean"
-        },
-        "button": {
-          "description": "Mouse button to use.",
-          "name": "button",
-          "default": "left",
-          "hasDynamicHelp": false,
-          "helpValue": "<button>",
-          "multiple": false,
-          "options": [
-            "left",
-            "middle",
-            "right"
-          ],
-          "type": "option"
-        },
-        "click-count": {
-          "description": "Number of clicks to send.",
-          "name": "click-count",
-          "default": 1,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:click",
+      "id": "network:clear",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3455,38 +3420,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "click.js"
+        "network",
+        "clear.js"
       ]
     },
-    "mouse:drag": {
+    "network:off": {
       "aliases": [],
-      "args": {
-        "fromX": {
-          "description": "Starting viewport x coordinate.",
-          "name": "fromX",
-          "required": true
-        },
-        "fromY": {
-          "description": "Starting viewport y coordinate.",
-          "name": "fromY",
-          "required": true
-        },
-        "toX": {
-          "description": "Ending viewport x coordinate.",
-          "name": "toX",
-          "required": true
-        },
-        "toY": {
-          "description": "Ending viewport y coordinate.",
-          "name": "toY",
-          "required": true
-        }
-      },
-      "description": "Drag from one raw viewport coordinate to another.",
+      "args": {},
+      "description": "Disable network capture for the active browser session.",
       "examples": [
-        "browse mouse drag 100 100 400 400",
-        "browse mouse drag 100 100 400 400 --steps 20 --delay 10"
+        "browse network off",
+        "browse network off --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3577,43 +3521,11 @@
           "name": "verified",
           "allowNo": false,
           "type": "boolean"
-        },
-        "button": {
-          "description": "Mouse button to use.",
-          "name": "button",
-          "default": "left",
-          "hasDynamicHelp": false,
-          "helpValue": "<button>",
-          "multiple": false,
-          "options": [
-            "left",
-            "middle",
-            "right"
-          ],
-          "type": "option"
-        },
-        "delay": {
-          "description": "Delay between drag steps in milliseconds.",
-          "name": "delay",
-          "default": 0,
-          "hasDynamicHelp": false,
-          "helpValue": "<ms>",
-          "multiple": false,
-          "type": "option"
-        },
-        "steps": {
-          "description": "Number of intermediate drag steps.",
-          "name": "steps",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "helpValue": "<steps>",
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:drag",
+      "id": "network:off",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3622,28 +3534,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "drag.js"
+        "network",
+        "off.js"
       ]
     },
-    "mouse:hover": {
+    "network:on": {
       "aliases": [],
-      "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
-        }
-      },
-      "description": "Move the mouse to raw viewport coordinates in the active page.",
+      "args": {},
+      "description": "Enable network capture for the active browser session.",
       "examples": [
-        "browse mouse hover 240 320",
-        "browse mouse hover 240 320 --session research"
+        "browse network on",
+        "browse network on --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3738,7 +3639,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:hover",
+      "id": "network:on",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3747,38 +3648,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "hover.js"
+        "network",
+        "on.js"
       ]
     },
-    "mouse:scroll": {
+    "network:path": {
       "aliases": [],
-      "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
-          "required": true
-        },
-        "deltaX": {
-          "description": "Horizontal scroll delta.",
-          "name": "deltaX",
-          "required": true
-        },
-        "deltaY": {
-          "description": "Vertical scroll delta.",
-          "name": "deltaY",
-          "required": true
-        }
-      },
-      "description": "Scroll from raw viewport coordinates in the active page.",
+      "args": {},
+      "description": "Print the network capture directory for the active browser session.",
       "examples": [
-        "browse mouse scroll 400 500 0 600",
-        "browse mouse scroll 400 500 0 -600"
+        "browse network path",
+        "browse network path --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -3873,7 +3753,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:scroll",
+      "id": "network:path",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3882,8 +3762,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "mouse",
-        "scroll.js"
+        "network",
+        "path.js"
       ]
     },
     "skills:add": {
@@ -4101,13 +3981,25 @@
         "show.js"
       ]
     },
-    "network:clear": {
+    "mouse:click": {
       "aliases": [],
-      "args": {},
-      "description": "Clear captured network request directories for the active browser session.",
+      "args": {
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
+          "required": true
+        },
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
+        }
+      },
+      "description": "Click raw viewport coordinates in the active page.",
       "examples": [
-        "browse network clear",
-        "browse network clear --session research"
+        "browse mouse click 240 320",
+        "browse mouse click 240 320 --button right",
+        "browse mouse click 240 320 --click-count 2"
       ],
       "flags": {
         "auto-connect": {
@@ -4198,11 +4090,34 @@
           "name": "verified",
           "allowNo": false,
           "type": "boolean"
+        },
+        "button": {
+          "description": "Mouse button to use.",
+          "name": "button",
+          "default": "left",
+          "hasDynamicHelp": false,
+          "helpValue": "<button>",
+          "multiple": false,
+          "options": [
+            "left",
+            "middle",
+            "right"
+          ],
+          "type": "option"
+        },
+        "click-count": {
+          "description": "Number of clicks to send.",
+          "name": "click-count",
+          "default": 1,
+          "hasDynamicHelp": false,
+          "helpValue": "<count>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:clear",
+      "id": "mouse:click",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4211,17 +4126,38 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "clear.js"
+        "mouse",
+        "click.js"
       ]
     },
-    "network:off": {
+    "mouse:drag": {
       "aliases": [],
-      "args": {},
-      "description": "Disable network capture for the active browser session.",
+      "args": {
+        "fromX": {
+          "description": "Starting viewport x coordinate.",
+          "name": "fromX",
+          "required": true
+        },
+        "fromY": {
+          "description": "Starting viewport y coordinate.",
+          "name": "fromY",
+          "required": true
+        },
+        "toX": {
+          "description": "Ending viewport x coordinate.",
+          "name": "toX",
+          "required": true
+        },
+        "toY": {
+          "description": "Ending viewport y coordinate.",
+          "name": "toY",
+          "required": true
+        }
+      },
+      "description": "Drag from one raw viewport coordinate to another.",
       "examples": [
-        "browse network off",
-        "browse network off --session research"
+        "browse mouse drag 100 100 400 400",
+        "browse mouse drag 100 100 400 400 --steps 20 --delay 10"
       ],
       "flags": {
         "auto-connect": {
@@ -4312,11 +4248,43 @@
           "name": "verified",
           "allowNo": false,
           "type": "boolean"
+        },
+        "button": {
+          "description": "Mouse button to use.",
+          "name": "button",
+          "default": "left",
+          "hasDynamicHelp": false,
+          "helpValue": "<button>",
+          "multiple": false,
+          "options": [
+            "left",
+            "middle",
+            "right"
+          ],
+          "type": "option"
+        },
+        "delay": {
+          "description": "Delay between drag steps in milliseconds.",
+          "name": "delay",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "helpValue": "<ms>",
+          "multiple": false,
+          "type": "option"
+        },
+        "steps": {
+          "description": "Number of intermediate drag steps.",
+          "name": "steps",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "helpValue": "<steps>",
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:off",
+      "id": "mouse:drag",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4325,17 +4293,28 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "off.js"
+        "mouse",
+        "drag.js"
       ]
     },
-    "network:on": {
+    "mouse:hover": {
       "aliases": [],
-      "args": {},
-      "description": "Enable network capture for the active browser session.",
+      "args": {
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
+          "required": true
+        },
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
+        }
+      },
+      "description": "Move the mouse to raw viewport coordinates in the active page.",
       "examples": [
-        "browse network on",
-        "browse network on --session research"
+        "browse mouse hover 240 320",
+        "browse mouse hover 240 320 --session research"
       ],
       "flags": {
         "auto-connect": {
@@ -4430,7 +4409,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:on",
+      "id": "mouse:hover",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4439,17 +4418,38 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "on.js"
+        "mouse",
+        "hover.js"
       ]
     },
-    "network:path": {
+    "mouse:scroll": {
       "aliases": [],
-      "args": {},
-      "description": "Print the network capture directory for the active browser session.",
+      "args": {
+        "x": {
+          "description": "Viewport x coordinate.",
+          "name": "x",
+          "required": true
+        },
+        "y": {
+          "description": "Viewport y coordinate.",
+          "name": "y",
+          "required": true
+        },
+        "deltaX": {
+          "description": "Horizontal scroll delta.",
+          "name": "deltaX",
+          "required": true
+        },
+        "deltaY": {
+          "description": "Vertical scroll delta.",
+          "name": "deltaY",
+          "required": true
+        }
+      },
+      "description": "Scroll from raw viewport coordinates in the active page.",
       "examples": [
-        "browse network path",
-        "browse network path --session research"
+        "browse mouse scroll 400 500 0 600",
+        "browse mouse scroll 400 500 0 -600"
       ],
       "flags": {
         "auto-connect": {
@@ -4544,7 +4544,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:path",
+      "id": "mouse:scroll",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4553,8 +4553,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "path.js"
+        "mouse",
+        "scroll.js"
       ]
     },
     "tab:close": {
@@ -6928,5 +6928,5 @@
       ]
     }
   },
-  "version": "0.11.2"
+  "version": "0.11.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browse",
-  "version": "0.11.2",
+  "version": "0.11.3",
   "description": "Unified Browserbase CLI for browser automation and cloud APIs.",
   "type": "module",
   "private": false,
@@ -90,7 +90,7 @@
   },
   "homepage": "https://github.com/browserbase/stagehand/tree/main/packages/cli#readme",
   "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=22.18.0"
   },
   "dependencies": {
     "@browserbasehq/sdk": "^2.14.0",
@@ -110,7 +110,7 @@
     "tsx": "^4.20.6",
     "ws": "^8.18.3",
     "zod": "^4.2.1",
-    "@browserbasehq/stagehand": "4.2.1"
+    "@browserbasehq/stagehand": "4.3.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",