stagehand/server-v3 v3.7.3

What's Changed

• [docs]: add docs for setDomainPolicy by @seanmcguire12 in #2289
• fix: silence AI SDK "system message in messages" warning in act/extract/observe by @shrey150 in #2359
• [STG-2510] fix: source eval browser skill from packages/cli browse SKILL.md by @shrey150 in #2334
• chore(evals): add sonnet-5, gpt-5.6, and grok pricing to braintrust UI publisher by @miguelg719 in #2318
• feat: warn and add opt-out flag for browse CLI .env auto-loading by @shrey150 in #2361
• chore(docs): Replace “LLM model” wording in Stagehand docs by @Kylejeong2 in #2366
• feat(evals): add OdysseysBench agent benchmark by @miguelg719 in #2275
• chore: cut stagehand-server-v3 catchup release by @shrey150 in #2367

Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.7.0...stagehand-server-v3/v3.7.3

@browserbasehq/stagehand@3.7.0

Minor Changes

• #2283 871ca7e Thanks @seanmcguire12! - add context.setDomainPolicy({ allowedDomains: ["allowed.domain"] }) which allows users to define a set of domains that are accessible to stagehand

• #2274 f31980f Thanks @seanmcguire12! - add context.setDomainPolicy({blockedDomains: ["some.domain"]}) which allows users to define a list of domains that will be blocked by stagehand

Patch Changes

• #2305 cd1daad Thanks @shrey150! - Remove the noisy AI SDK "system message in messages" warning logged on every hybrid/DOM agent.execute() call.

• #2328 d287ff4 Thanks @miguelg719! - Allow modelName "auto" in the constructor and per-primitive model overrides when running through the Stagehand API

• #2294 3938590 Thanks @seanmcguire12! - automatically close popups that violate user defined domain policy

• #2298 892701a Thanks @seanmcguire12! - Fix CUA keypress actions to press key combinations as a single chord.

• #2345 21826c7 Thanks @monadoid! - Repair malformed UTF-16 snapshot text before it reaches model prompts.

• #2306 8dcef1b Thanks @seanmcguire12! - Use the screenshot provider's declared media type when sending CUA image payloads. The setScreenshotProvider callback now returns ScreenshotProviderResult ({ base64, mediaType }) instead of a bare base64 string.

• #2273 93a23d3 Thanks @miguelg719! - Add support for the new google/gemini-3.5-flash computer-use tools model

• #2278 022d68f Thanks @shrey150! - Fix TypeError: Converting circular structure to JSON when creating an agent with MCP integrations that include a Client instance (e.g. a local/stdio server from connectToMCPServer). The agent-creation log serialized the raw integrations array, and a live MCP Client is circular. It now logs a safe descriptor (URL strings kept, client instances summarized) so agent({ integrations: [client] }) works.

• #2288 bb5ffa6 Thanks @seanmcguire12! - clean up cdp session event handlers on target detach

browse@0.9.0

Minor Changes

• #2246 303ab2c Thanks @shrey150! - browse screenshot now writes a file by default instead of printing base64 to stdout. Bare invocations save to screenshot-<yyyymmdd-hhmmss>.<type> in the current directory (with a collision counter instead of overwriting) and print { "saved": "<path>" }. A new --base64 flag preserves the legacy behavior of printing { "base64": "..." } to stdout; it is mutually exclusive with --path. --path behavior is unchanged.

  Note for scripts that parsed the bare-invocation base64 output: pass --base64 to keep the old stdout contract.

Patch Changes

• #2250 8b83bb7 Thanks @shrey150! - Fix browse skills add on Windows and bound the unbounded installer stages.

  • Quote the npx command and arguments when spawning through cmd.exe (shell: true for .cmd/.bat shims), so the default C:\Program Files\nodejs\npx.cmd path and install paths with spaces (e.g. C:\Users\First Last\...) no longer split at the space and fail with "'C:\Program' is not recognized".
  • Kill the npx skills add child after a 180s deadline (SIGTERM, then SIGKILL) and fail with a clear message and a distinct skill_install_timeout telemetry result code instead of hanging forever.
  • Bound the catalog and skill-file fetches with a 10s abort timeout, preserving the existing catalog-unavailable fallback semantics when a fetch hangs.

@browserbasehq/stagehand@3.6.0

Minor Changes

• #2178 c49a3fc Thanks @seanmcguire12! - add support for WebMCP

Patch Changes

• #2217 147e310 Thanks @monadoid! - Add Azure OpenAI Microsoft Entra ID model auth support.

• #2231 cf3603d Thanks @miguelg719! - Add claude-fable-5 support: native structured outputs via the @ai-sdk/anthropic bump, adaptive thinking (including the new "xhigh" effort) on the agent path, the API's built-in server-side refusal fallback to claude-opus-4-8, and auto tool choice for the final done call on models that reject forced tool use.

• #2233 8d7d414 Thanks @seanmcguire12! - Normalize URLs in ActCache key derivation by sorting query parameters before hashing. Semantically equivalent URLs that differ only in parameter order (e.g. ?utm_source=email&id=42 vs ?id=42&utm_source=email) now hit the cache instead of silently missing. Fragments and duplicate keys are preserved.

• #2229 fd42e65 Thanks @seanmcguire12! - launch local browser with --enable-features=WebMCPTesting,DevToolsWebMCPSupport by default

• #2220 a64c6b7 Thanks @monadoid! - Fix Stagehand-generated shadow-root XPath resolution so deterministic actions can target elements inside web components.

• #2132 ed3e566 Thanks @miguelg719! - Add canonical verifier evidence normalization for screenshots and text signals without requiring image dependencies in core installs.

• #2133 840aac8 Thanks @miguelg719! - Add the rubric-based verifier engine with normalized public rubric output and bounded failure-step parsing.

@browserbasehq/stagehand@2.5.9

@browserbasehq/stagehand

2.5.8

Patch Changes

• #1710 df76207 Thanks @seanmcguire12! - handle target closed errors on rapidly opening/closing popups

2.5.7

Patch Changes

• #1593 159f6d3 Thanks @tkattkat! - Update extract tool

2.5.6

Patch Changes

• #1396 b7bc0b6 Thanks @seanmcguire12! - deprecate drawOverlay parameter in observe

2.5.5

Patch Changes

• #1389 575226f Thanks @seanmcguire12! - Retry DOM.getDocument on max depth exceeded with exponential backoff

• #1386 dbffb75 Thanks @seanmcguire12! - Remove deprecated internal usage of page.evaluate

2.5.4

Patch Changes

• #1368 fb74c90 Thanks @miguelg719! - Version bump to 2.5.4

2.5.3

Patch Changes

• #1275 a372b3c Thanks @miguelg719! - Remove process exit on signal handler

• #1143 fc06d40 Thanks @seanmcguire12! - add logger param to external aisdk client

• #1137 2dbac99 Thanks @miguelg719! - Add haiku 4.5 computer use support

• #1116 b419fc3 Thanks @tkattkat! - patch stagehand agent api support

• #1362 f26333e Thanks @seanmcguire12! - use CDP to find scrollable nodes instead of injected JS

• #1125 cbff109 Thanks @tkattkat! - update cua agents key & system prompt handling

• #1363 223e158 Thanks @seanmcguire12! - add causedBy to StagehandDefaultError

• #1123 f426ba5 Thanks @tkattkat! - Add pageUrl & timestamp to agent actions

• #1365 2f71b02 Thanks @seanmcguire12! - export getAccessibilityTree()

• #1366 e098b0d Thanks @miguelg719! - Update finding scrollable nodes using CDP

2.5.2

Patch Changes

• #1114 c0fbc51 Thanks @seanmcguire12! - configure default viewport when running on browserbase

2.5.1

Patch Changes

• #1082 8c0fd01 Thanks @tkattkat! - Pass stagehand object to agent instead of stagehand page

• #1104 a1ad06c Thanks @miguelg719! - Fix logging for stagehand agent

• #1066 9daa584 Thanks @tkattkat! - Add playwright arguments to agent execute response

• #1077 7f38b3a Thanks @tkattkat! - adds support for stagehand agent in the api

• #1032 bf2d0e7 Thanks @miguelg719! - Fix for zod peer dependency support

• #1014 6966201 Thanks @tkattkat! - Replace operator handler with base of new agent

• #1089 536f366 Thanks @miguelg719! - Fixed info logs on api session create

• #1103 889cb6c Thanks @tkattkat! - patch custom tool support in anthropic cua client

• #1056 6a002b2 Thanks @chrisreadsf! - remove need for duplicate project id if already passed to Stagehand

• #1090 8ff5c5a Thanks @miguelg719! - Improve failed act error logs

• #1014 6966201 Thanks @tkattkat! - replace operator agent with scaffold for new stagehand agent

• #1107 3ccf335 Thanks @seanmcguire12! - fix: url extraction not working inside an array

• #1102 a99aa48 Thanks @miguelg719! - Add current page and date context to agent

• #1110 dda52f1 Thanks @miguelg719! - Add support for new Gemini Computer Use models

2.5.0

Minor Changes

• #981 8244ab2 Thanks @sameelarif! - Added support for stagehand.agent to interact with MCP servers as well as custom tools to be passed in. For more information, reference the MCP integrations documentation

Patch Changes

• #959 09b5e1e Thanks @filip-michalsky! - add webvoyager evals

• #1049 e3734b9 Thanks @miguelg719! - Support local MCP server connections

• #1025 be85b19 Thanks @tkattkat! - add support for custom baseUrl within openai provider

• #1040 88d1565 Thanks @miguelg719! - Allow OpenAI CUA to ta...

stagehand/server-v3 v3.7.2

What's Changed

• docs: add Anthropic Managed Agents browser guide by @ziruihao in #2199
• [STG-2188] docs(cli): document full browse command surface + fix license badge by @shrey150 in #2198
• [chore]: use allowlist for published files by @seanmcguire12 in #2214
• [chore]: enable branch installs by @seanmcguire12 in #2215
• test: cover disabling --site-per-process default (#2202) by @seanmcguire12 in #2218
• [docs]: add docs for ignoreDefaultArgs by @seanmcguire12 in #2222
• [STG-2090] Add Azure Entra model auth support by @monadoid in #2217

Full Changelog: https://github.com/browserbase/stagehand/compare/browse@0.8.3...stagehand-server-v3/v3.7.2

browse@0.8.3

Patch Changes

• #2192 e7d3b55 Thanks @shrey150! - Lead-with-local onboarding: the missing-API-key error on cloud commands now tells users that local browser automation needs no key and points them to browse open <url> --local. The remote-mode driver error is clearer about when a key is required versus when local mode works without one.

@browserbasehq/stagehand@3.5.0

Minor Changes

• #2149 6e75725 Thanks @miguelg719! - Added a screenshot option to extract() that sends the current viewport screenshot with the a11y tree for extraction.

• #2127 78bcde8 Thanks @seanmcguire12! - Add ignoreDefaultArgs option to selectively remove chrome-launcher's built-in default flags (e.g. --disable-extensions) when running locally

• #2160 49575d6 Thanks @monadoid! - Forward constructor and request model configuration when initializing API-backed sessions.

• #2171 dc1445d Thanks @seanmcguire12! - add native clipboard API

Patch Changes

• #2146 3a53ed4 Thanks @shriyatheunicorn! - Pass local browser launch options through when attaching over CDP so explicit viewport settings are respected.

• #2107 8fc16d2 Thanks @miguelg719! - Fix Anthropic CUA triple_click action mapping.

• #2118 3e95a87 Thanks @monadoid! - Add Vertex auth parameters to the core and server API schemas.

• #2126 ebbdcd3 Thanks @seanmcguire12! - fix(core): import ToolSet from ai public export

• #2120 12703a6 Thanks @miguelg719! - Fix structuredOutputMode for newer Anthropic models

• #2170 1db5f1c Thanks @Kylejeong2! - Add Claude Opus 4.8 to the supported CUA model whitelist.

• #2116 cb586a1 Thanks @seanmcguire12! - include "[selected]" or "[checked]" state in snapshot

• #2129 765861c Thanks @miguelg719! - Add a backend-selectable v3 evaluator facade while preserving the legacy evaluator path.

• #2157 2cd60a3 Thanks @miguelg719! - Add verifier trajectory, rubric, and evaluation-result types with normalized public naming.

• #2131 e102a89 Thanks @miguelg719! - Capture verifier trajectory evidence from agent evidence callbacks for offline scoring.

@browserbasehq/browse-cli@0.6.1

Patch Changes

• Updated dependencies [3a53ed4, 6e75725, 8fc16d2, 78bcde8, 3e95a87, ebbdcd3, 12703a6, 1db5f1c, cb586a1, 765861c, 2cd60a3, e102a89, 49575d6, dc1445d]:
  • @browserbasehq/stagehand@3.5.0

stagehand/server-v3 v3.7.1

What's Changed

• STG-1746 Add SEA --version flag by @monadoid in #2167

Full Changelog: stagehand-server-v3/v3.7.0...stagehand-server-v3/v3.7.1