stagehand/server v3.2.0

What's Changed

• [Feature] exclude tools from agent by @tkattkat in #1440
• [feat]: add support for safety confirmation callback for OpenAI + Google CUA by @shrey150 in #1473
• [fix]: refresh agent cache on action failure by @seanmcguire12 in #1472
• Version Packages by @github-actions[bot] in #1414

Full Changelog: stagehand-server/v3.1.3...stagehand-server/v3.2.0

@browserbasehq/[email protected]

Patch Changes

• #1461 0f3991e Thanks @tkattkat! - Move hybrid mode out of experimental

• #1433 e0e22e0 Thanks @tkattkat! - Put hybrid mode behind experimental

• #1456 f261051 Thanks @shrey150! - Invoke page.hover for agent move action

• #1473 e021674 Thanks @shrey150! - Add safety confirmation support for OpenAI + Google CUA

• #1399 6a5496f Thanks @tkattkat! - Ensure cua agent is killed when stagehand.close is called

• #1436 fea1700 Thanks @miguelg719! - Fix auto-load key for act/extract/observe parametrized models on api

• #1439 5b288d9 Thanks @tkattkat! - Remove base64 from agent actions array ( still present in messages object )

• #1408 e822f5a Thanks @seanmcguire12! - allow for act() cache hit when variable values change

• #1472 638efc7 Thanks @seanmcguire12! - fix: agent cache not refreshed on action failure

• #1424 a890f16 Thanks @seanmcguire12! - fix: "Error: -32000 Failed to convert response to JSON: CBOR: stack limit exceeded"

• #1418 934f492 Thanks @miguelg719! - Cleanup handlers and bus listeners on close

• #1430 bd2db92 Thanks @shrey150! - Fix CUA model coordinate translation

• #1465 51e0170 Thanks @miguelg719! - Add media resolution high provider option to gemini 3 hybrid agent

• #1431 05f5580 Thanks @tkattkat! - Update the cache handling for agent

• #1432 f56a9c2 Thanks @tkattkat! - Deprecate cua: true in favor of mode: "cua"

• #1406 b40ae11 Thanks @tkattkat! - Add support for hovering with coordinates ( page.hover )

• #1407 0d2b398 Thanks @tkattkat! - Clean up page methods

• #1412 cd01f29 Thanks @seanmcguire12! - fix: load GOOGLE_API_KEY from .env

• #1462 a734fca Thanks @shrey150! - fix: correctly pass userDataDir to chrome launcher

• #1466 b342acf Thanks @seanmcguire12! - move playwright to optional dependencies

• #1440 2987cd1 Thanks @tkattkat! - [Feature] support excluding tools from agent

• #1455 dfab1d5 Thanks @seanmcguire12! - update aisdk client to better enforce structured output with deepseek models

• #1428 4d71162 Thanks @tkattkat! - Add "hybrid" mode to stagehand agent

stagehand/server v3.1.3

What's Changed

• update agent docs by @tkattkat in #1411
• fix: load GOOGLE_API_KEY from env by @seanmcguire12 in #1412
• [docs]: update act reference with preferred model name formatting by @ziruihao in #1409
• [docs] add link to Discord by @shrey150 in #1416
• Update screenshot collector by @tkattkat in #1373
• Add more agent evals to evals cli by @tkattkat in #1422
• Add hover method by @tkattkat in #1406
• [Evals] task error handling and memory cleanup by @miguelg719 in #1419
• Clean up handlers and remove bus listeners on v3.close() by @miguelg719 in #1418
• kill cua agent on stagehand.close by @tkattkat in #1399
• clean up page methods by @tkattkat in #1407
• allow act cache hit when variable values change by @seanmcguire12 in #1408
• update screenshot collector stop method by @tkattkat in #1425
• [fix]: handle CBOR stack limit errors by @seanmcguire12 in #1424
• [chore]: rm inlined JS from snapshot.ts by @seanmcguire12 in #1427
• [Feature] Add Agent.execute Hybrid CUA + DOM mode by @tkattkat in #1428
• [chore]: split up snapshot logic into submodules by @seanmcguire12 in #1429
• [Evals] Disable screenshot collector interval by default by @miguelg719 in #1421
• Fix parametrized 'model' api key auto-loading by @miguelg719 in #1436
• update agent cache handling by @tkattkat in #1431
• move hybrid mode behind experimental by @tkattkat in #1433
• Add cua to mode by @tkattkat in #1432
• [test]: add unit tests for xpath utils & tree format utils by @seanmcguire12 in #1441
• fix: CUA coordinating scaling issue by @shrey150 in #1430
• [test]: add tests for synchronous DOM node helpers by @seanmcguire12 in #1443
• [test]: add tests for ax tree post-processing by @seanmcguire12 in #1446
• remove base64 from agent actions array by @tkattkat in #1439
• [test]: add tests DOM session builders by @seanmcguire12 in #1448
• [test]: add tests for frame merging & prefix computation by @seanmcguire12 in #1452
• [test]: add tests for ax tree fetching & object ID resolvers by @seanmcguire12 in #1451
• [test]: add tests for focus selector utils by @seanmcguire12 in #1447
• Add Stainless CI for SDK codegen by @monadoid in #1450
• Invoke page.hover on agent move action by @shrey150 in #1456
• [STG-1053] [server] Use fastify-zod-openapi + zod v4 for openapi generation by @monadoid in #1420
• Pushing stagehand-server to github releases with changesets, instead of using github artifacts by @monadoid in #1457
• add deepseek specific prompting in aisdk by @seanmcguire12 in #1455
• Add code to publish binaries on release by @monadoid in #1459
• Add media resolution high to gemini 3 hybrid agent by @miguelg719 in #1465
• Moved server binary build into release.yaml by @monadoid in #1467
• fix: correctly pass in userDataDir to chrome launcher by @shrey150 in #1462
• Gate release creation on package.json version changes on main, instead of Changesets publishedPackages. by @monadoid in #1469
• No longer using changesets for stagehand-server - manually bumping package.json version number by @monadoid in #1470
• remove experimental flag on hybrid mode by @tkattkat in #1461
• [chore]: move playwright to optional deps by @seanmcguire12 in #1466
• [test]: add tests for top level snapshot functions by @seanmcguire12 in #1471
• server binary fixes by @monadoid in #1474
• bump server package version by @monadoid in #1475
• bump server package version & fix gen:openapi script for windows by @monadoid in #1476

New Contributors

• @ziruihao made their first contribution in #1409

Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/[email protected]/v3.1.3

@browserbasehq/[email protected]

Patch Changes

• #1388 605ed6b Thanks @miguelg719! - Fix multiple click event dispatches on CDP and Anthropic CUA handling (double clicks)

• #1400 34e7e5b Thanks @seanmcguire12! - don't write base64 encoded screenshots to disk when caching agent actions

• #1345 943d2d7 Thanks @tkattkat! - Add support for aborting / stopping an agent run & continuing an agent run using messages from prior runs

• #1334 0e95cd2 Thanks @tkattkat! - Add support for google vertex provider

• #1410 d4237e4 Thanks @seanmcguire12! - fix: include extract in stagehand.history()

• #1315 86975e7 Thanks @tkattkat! - Add streaming support to agent through stream:true in the agent config

• #1304 d5e119b Thanks @miguelg719! - Add support for Microsoft's Fara-7B

• #1346 4e051b2 Thanks @seanmcguire12! - fix: don't attach to targets twice

• #1327 6b5a3c9 Thanks @miguelg719! - Informed error parsing from api

• #1335 bb85ad9 Thanks @seanmcguire12! - add support for page.addInitScript()

• #1331 88d28cc Thanks @seanmcguire12! - fix: page.evaluate() now works with scripts injected via context.addInitScript()

• #1316 45bcef0 Thanks @tkattkat! - Add support for callbacks in stagehand agent

• #1374 6aa9d45 Thanks @miguelg719! - Fix key action mapping in Anthropic CUA

• #1330 d382084 Thanks @seanmcguire12! - fix: make act, extract, and observe respect user defined timeout param

• #1336 1df08cc Thanks @tkattkat! - Patch agent on api

• #1358 2b56600 Thanks @tkattkat! - Add support for 4.5 opus in cua agent

@browserbasehq/[email protected]

Patch Changes

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

@browserbasehq/[email protected]

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

@browserbasehq/[email protected]

Patch Changes

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

@browserbasehq/[email protected]

Patch Changes

• #1273 ab51232 Thanks @seanmcguire12! - fix: trigger shadow root rerender in OOPIFs by cloning & replacing instead of reloading

• #1268 c76ade0 Thanks @tkattkat! - Expose reasoning, and cached input tokens in stagehand metrics

• #1267 ffb5e5d Thanks @seanmcguire12! - fix: file uploads failing on Browserbase

• #1269 772e735 Thanks @tkattkat! - Add example using playwright screen recording

@browserbasehq/[email protected]

Patch Changes

• #1245 a224b33 Thanks @seanmcguire12! - allow act() to call hover()

• #1234 6fc9de2 Thanks @miguelg719! - Add a page.sendCDP method

• #1233 4935be7 Thanks @seanmcguire12! - extend page.screenshot() options to mirror playwright

• #1232 bdd76fc Thanks @seanmcguire12! - export Page type

• #1229 7ea18a4 Thanks @tkattkat! - Adjust extract tool + expose extract response in agent result

• #1239 d4de014 Thanks @miguelg719! - Fix stagehand.metrics on api mode

• #1241 2d1b573 Thanks @miguelg719! - Return response on page.goto api mode

• #1253 5556041 Thanks @seanmcguire12! - fix missing page issue when connecting to existing browser

• #1235 7e4b43e Thanks @seanmcguire12! - make page.goto() return a Response object

• #1254 7e72adf Thanks @sameelarif! - Added custom error types to allow for a smoother debugging experience.

• #1227 9bf09d0 Thanks @miguelg719! - Fix readme's media links and add instructions for installing from a branch

• #1257 92d32ea Thanks @tkattkat! - Add support for a custom baseUrl with google cua client

• #1230 ebcf3a1 Thanks @seanmcguire12! - add stagehand.browserbaseSessionID getter

• #1262 c29a4f2 Thanks @miguelg719! - Remove error throwing when api and experimental are both set

• #1223 6d21efa Thanks @miguelg719! - Disable api mode when using custom LLM clients

• #1228 525ef0c Thanks @Kylejeong2! - update slack link in docs

• #1226 9ddb872 Thanks @seanmcguire12! - add support for page.on('console') events

@browserbasehq/[email protected]

Patch Changes

• #1207 55da8c6 Thanks @miguelg719! - Fix broken links to quickstart docs

• #1200 0a5ee63 Thanks @seanmcguire12! - log info when scope narrowing selector fails

• #1205 ee76881 Thanks @miguelg719! - Update README.md, add Changelog for v3

• #1209 9e95add Thanks @seanmcguire12! - fix circular import in exported aisdk example client

• #1211 98e212b Thanks @miguelg719! - Add an example for passing custom tools to agent

• #1206 d5ecbfc Thanks @miguelg719! - Export example AISdkClient properly from the stagehand package