browse 0.11.1 → 0.11.2

package/README.md

@@ -240,10 +240,16 @@ browse cloud extensions delete <extension-id>
 # Fetch & Search APIs
 browse cloud fetch <url>                          # markdown by default
 browse cloud search <query>
+# Requires the Search API upgrade to be deployed:
+browse cloud search "browserbase docs" --provider parallel --mode fast
+browse cloud search "browser automation research" --provider parallel --mode advanced
+browse cloud search "browserbase docs" --provider exa
 ```
 
 `browse cloud fetch` returns markdown-formatted page content by default. Use `--format raw` for the original response body, or `--format json --schema <schema>` for structured extraction.
 
+`browse cloud search` accepts `--provider parallel|exa` and `--mode fast|advanced`. Parallel supports both modes; Exa does not accept a mode. Omitted flags are left out of the request so the API chooses its default provider and the provider chooses its default tier. Use `fast` for lower latency and cost, or `advanced` for deeper results.
+
 ## Functions
 
 Browserbase [Functions](https://docs.browserbase.com/platform/runtime/overview) let you deploy browser agents and automation scripts directly onto Browserbase's infrastructure. Build locally, test instantly, and deploy as APIs.

package/dist/commands/cloud/search.js

@@ -4,10 +4,13 @@ import { apiCommonFlags, toApiOptions } from "../../lib/cloud/flags.js";
 import { BrowseCommand } from "../../base.js";
 import { outputFormatFlags, outputTable, resolveOutputFormat, } from "../../lib/output.js";
 export default class Search extends BrowseCommand {
-    static description = "Search the web using the Browserbase Search API.";
+    static description = "Search the web using the Browserbase Search API.\n\nProvider and mode selection requires the Search API upgrade and is unavailable until that upgrade is deployed.";
     static examples = [
         `browse cloud search "best restaurants in SF"`,
         `browse cloud search "web scraping tools" --num-results 5`,
+        `browse cloud search "browserbase docs" --provider parallel --mode fast`,
+        `browse cloud search "browser automation research" --provider parallel --mode advanced`,
+        `browse cloud search "browserbase docs" --provider exa`,
         `browse cloud search "browserbase docs" --json`,
         `browse cloud search "browserbase docs" --output results.json`,
     ];
@@ -23,6 +26,14 @@ export default class Search extends BrowseCommand {
             min: 1,
             max: 25,
         }),
+        provider: Flags.string({
+            description: "Search provider. Omit to use the API default.",
+            options: ["parallel", "exa"],
+        }),
+        mode: Flags.string({
+            description: "Search tier (Parallel only). Omit to use the provider's default tier.",
+            options: ["fast", "advanced"],
+        }),
         output: Flags.string({
             description: "Write the search results as JSON to a file.",
             helpValue: "<output>",
@@ -34,7 +45,12 @@ export default class Search extends BrowseCommand {
         const result = await requestBrowserbaseJson(toApiOptions(flags), "/v1/search", {
             method: "POST",
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ query: args.query, numResults }),
+            body: JSON.stringify({
+                query: args.query,
+                numResults,
+                provider: flags.provider,
+                mode: flags.mode,
+            }),
         });
         const outputFormat = resolveOutputFormat(flags);
         if (flags.output) {

package/oclif.manifest.json

@@ -2968,10 +2968,13 @@
           "required": true
         }
       },
-      "description": "Search the web using the Browserbase Search API.",
+      "description": "Search the web using the Browserbase Search API.\n\nProvider and mode selection requires the Search API upgrade and is unavailable until that upgrade is deployed.",
       "examples": [
         "browse cloud search \"best restaurants in SF\"",
         "browse cloud search \"web scraping tools\" --num-results 5",
+        "browse cloud search \"browserbase docs\" --provider parallel --mode fast",
+        "browse cloud search \"browser automation research\" --provider parallel --mode advanced",
+        "browse cloud search \"browserbase docs\" --provider exa",
         "browse cloud search \"browserbase docs\" --json",
         "browse cloud search \"browserbase docs\" --output results.json"
       ],
@@ -3024,6 +3027,28 @@
           "multiple": false,
           "type": "option"
         },
+        "provider": {
+          "description": "Search provider. Omit to use the API default.",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "parallel",
+            "exa"
+          ],
+          "type": "option"
+        },
+        "mode": {
+          "description": "Search tier (Parallel only). Omit to use the provider's default tier.",
+          "name": "mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "fast",
+            "advanced"
+          ],
+          "type": "option"
+        },
         "output": {
           "description": "Write the search results as JSON to a file.",
           "name": "output",
@@ -3285,13 +3310,25 @@
         "publish.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": {
@@ -3382,11 +3419,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",
@@ -3395,17 +3455,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": {
@@ -3496,11 +3577,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",
@@ -3509,17 +3622,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": {
@@ -3614,7 +3738,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:on",
+      "id": "mouse:hover",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3623,17 +3747,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": {
@@ -3728,7 +3873,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "network:path",
+      "id": "mouse:scroll",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -3737,38 +3882,241 @@
       "relativePath": [
         "dist",
         "commands",
-        "network",
-        "path.js"
+        "mouse",
+        "scroll.js"
       ]
     },
-    "mouse:click": {
+    "skills:add": {
       "aliases": [],
       "args": {
-        "x": {
-          "description": "Viewport x coordinate.",
-          "name": "x",
-          "required": true
-        },
-        "y": {
-          "description": "Viewport y coordinate.",
-          "name": "y",
+        "skill": {
+          "description": "Skill id in the form <domain>/<task>.",
+          "name": "skill",
+          "required": false
+        }
+      },
+      "description": "Install a browser automation skill.",
+      "examples": [
+        "browse skills add yelp.com/extract-reviews",
+        "browse skills add mcdonalds.order.online/order-delivery-42q71n"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:add",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "add.js"
+      ]
+    },
+    "skills:find": {
+      "aliases": [],
+      "args": {
+        "query": {
+          "description": "Skill slug or search query.",
+          "name": "query",
           "required": true
         }
       },
-      "description": "Click raw viewport coordinates in the active page.",
+      "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
       "examples": [
-        "browse mouse click 240 320",
-        "browse mouse click 240 320 --button right",
-        "browse mouse click 240 320 --click-count 2"
+        "browse skills find yelp",
+        "browse skills find reviews",
+        "browse skills find yelp.com/extract-reviews",
+        "browse skills find travel --limit 5",
+        "browse skills find \"restaurant reviews\" --json"
       ],
       "flags": {
-        "auto-connect": {
-          "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
-          "name": "auto-connect",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "cdp": {
+        "format": {
+          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "helpValue": "<format>",
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        },
+        "json": {
+          "description": "Print raw JSON output.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wide": {
+          "description": "Show full table values without truncation.",
+          "name": "wide",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Show all matching skills in table output.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum matching skills to show in table output.",
+          "name": "limit",
+          "default": 25,
+          "hasDynamicHelp": false,
+          "helpValue": "<count>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:find",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "find.js"
+      ]
+    },
+    "skills:install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install the bundled browse CLI skill.",
+      "examples": [
+        "browse skills install"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:install",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "install.js"
+      ]
+    },
+    "skills:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List Browse.sh catalog skills.",
+      "examples": [
+        "browse skills list",
+        "browse skills list --limit 10",
+        "browse skills list --all",
+        "browse skills list --json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "helpValue": "<format>",
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        },
+        "json": {
+          "description": "Print raw JSON output.",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "wide": {
+          "description": "Show full table values without truncation.",
+          "name": "wide",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "all": {
+          "description": "Show all returned skills in table output.",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Maximum skills to show in table output.",
+          "name": "limit",
+          "default": 25,
+          "hasDynamicHelp": false,
+          "helpValue": "<count>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:list",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "list.js"
+      ]
+    },
+    "skills:show": {
+      "aliases": [],
+      "args": {},
+      "description": "Print the bundled browse skill (usage patterns, workflows, gotchas) to stdout. Run before using browse in an agent.",
+      "examples": [
+        "browse skills show"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "skills:show",
+      "pluginAlias": "browse",
+      "pluginName": "browse",
+      "pluginType": "core",
+      "strict": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "skills",
+        "show.js"
+      ]
+    },
+    "network:clear": {
+      "aliases": [],
+      "args": {},
+      "description": "Clear captured network request directories for the active browser session.",
+      "examples": [
+        "browse network clear",
+        "browse network clear --session research"
+      ],
+      "flags": {
+        "auto-connect": {
+          "description": "Auto-discover and attach to a local browser with remote debugging enabled.",
+          "name": "auto-connect",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "cdp": {
           "description": "Attach directly to a CDP endpoint. Accepts a port, http(s) URL, or ws(s) URL.",
           "name": "cdp",
           "hasDynamicHelp": false,
@@ -3850,34 +4198,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",
@@ -3886,38 +4211,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": {
@@ -4008,43 +4312,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",
@@ -4053,28 +4325,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": {
@@ -4169,7 +4430,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:hover",
+      "id": "network:on",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4178,38 +4439,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": {
@@ -4304,222 +4544,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "mouse:scroll",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "mouse",
-        "scroll.js"
-      ]
-    },
-    "skills:add": {
-      "aliases": [],
-      "args": {
-        "skill": {
-          "description": "Skill id in the form <domain>/<task>.",
-          "name": "skill",
-          "required": false
-        }
-      },
-      "description": "Install a browser automation skill.",
-      "examples": [
-        "browse skills add yelp.com/extract-reviews",
-        "browse skills add mcdonalds.order.online/order-delivery-42q71n"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:add",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "add.js"
-      ]
-    },
-    "skills:find": {
-      "aliases": [],
-      "args": {
-        "query": {
-          "description": "Skill slug or search query.",
-          "name": "query",
-          "required": true
-        }
-      },
-      "description": "Find Browse.sh catalog skills by slug, domain, title, description, category, alias, or tag.",
-      "examples": [
-        "browse skills find yelp",
-        "browse skills find reviews",
-        "browse skills find yelp.com/extract-reviews",
-        "browse skills find travel --limit 5",
-        "browse skills find \"restaurant reviews\" --json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "helpValue": "<format>",
-          "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
-          "type": "option"
-        },
-        "json": {
-          "description": "Print raw JSON output.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wide": {
-          "description": "Show full table values without truncation.",
-          "name": "wide",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Show all matching skills in table output.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum matching skills to show in table output.",
-          "name": "limit",
-          "default": 25,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:find",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "find.js"
-      ]
-    },
-    "skills:install": {
-      "aliases": [],
-      "args": {},
-      "description": "Install the bundled browse CLI skill.",
-      "examples": [
-        "browse skills install"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:install",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "install.js"
-      ]
-    },
-    "skills:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List Browse.sh catalog skills.",
-      "examples": [
-        "browse skills list",
-        "browse skills list --limit 10",
-        "browse skills list --all",
-        "browse skills list --json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format. Defaults to table in a terminal and JSON when piped.",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "helpValue": "<format>",
-          "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
-          "type": "option"
-        },
-        "json": {
-          "description": "Print raw JSON output.",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "wide": {
-          "description": "Show full table values without truncation.",
-          "name": "wide",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Show all returned skills in table output.",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Maximum skills to show in table output.",
-          "name": "limit",
-          "default": 25,
-          "hasDynamicHelp": false,
-          "helpValue": "<count>",
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:list",
-      "pluginAlias": "browse",
-      "pluginName": "browse",
-      "pluginType": "core",
-      "strict": true,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "skills",
-        "list.js"
-      ]
-    },
-    "skills:show": {
-      "aliases": [],
-      "args": {},
-      "description": "Print the bundled browse skill (usage patterns, workflows, gotchas) to stdout. Run before using browse in an agent.",
-      "examples": [
-        "browse skills show"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "skills:show",
+      "id": "network:path",
       "pluginAlias": "browse",
       "pluginName": "browse",
       "pluginType": "core",
@@ -4528,8 +4553,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "show.js"
+        "network",
+        "path.js"
       ]
     },
     "tab:close": {
@@ -6903,5 +6928,5 @@
       ]
     }
   },
-  "version": "0.11.1"
+  "version": "0.11.2"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browse",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "Unified Browserbase CLI for browser automation and cloud APIs.",
   "type": "module",
   "private": false,
@@ -110,7 +110,7 @@
     "tsx": "^4.20.6",
     "ws": "^8.18.3",
     "zod": "^4.2.1",
-    "@browserbasehq/stagehand": "4.1.0"
+    "@browserbasehq/stagehand": "4.2.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -125,7 +125,7 @@
     "prettier": "3.5.3",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.59.3",
-    "vitest": "^4.1.9"
+    "vitest": "4.1.11"
   },
   "scripts": {
     "build": "node -e \"const fs = require('fs'); fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('oclif.manifest.json', { force: true })\" && tsc -p tsconfig.json && pnpm manifest",

package/skills/browse/SKILL.md

@@ -241,6 +241,9 @@ browse cloud extensions get <extension-id>
 browse cloud extensions delete <extension-id>
 browse cloud fetch https://example.com
 browse cloud search "browser automation"
+browse cloud search "browserbase docs" --provider parallel --mode fast
+browse cloud search "browser automation research" --provider parallel --mode advanced
+browse cloud search "browserbase docs" --provider exa
 ```
 
 For remote sessions with context persistence:
@@ -264,6 +267,8 @@ Use `--verified` when the task needs Browserbase Verified browser mode. To drive
 
 Use `browse cloud fetch` when the user needs a simple HTTP fetch without browser interaction. It returns markdown-formatted page content by default; pass `--format raw` for the original response body or `--format json --schema <schema>` for structured extraction. Use `browse cloud search` when the user asks for web search results.
 
+Search accepts `--provider parallel|exa` and `--mode fast|advanced`. Provider and mode selection requires the Search API upgrade and is unavailable until that upgrade is deployed. Parallel supports both modes; omit `--mode` with Exa. Leave either flag unset to let the API choose the default provider or the provider choose its default tier. `fast` favors lower latency and cost; `advanced` favors deeper results.
+
 ## Browserbase Functions
 
 Use `browse functions` to create, develop, publish, and invoke Browserbase Functions: