stagehand-server/v3.1.3

browserbase/stagehandstagehand-server/v3.1.3Dec 24, 2025by github-actions[bot]

AI Summary

Introduces the core Hybrid CUA + DOM mode functionality, refactors snapshot logic into submodules, and improves agent lifecycle and testing infrastructure.

Key Highlights

  • Add Agent.execute Hybrid CUA + DOM mode
  • Kill CUA agent on stagehand.close
  • Add hover method to page
  • Refactor snapshot logic into submodules

New Features

  • [Feature] Add Agent.execute Hybrid CUA + DOM mode
  • Add hover method
  • Clean up page methods
  • Add cua to mode
  • Add media resolution high to gemini 3 hybrid agent

Full Release Notes

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

## New Contributors
* @ziruihao made their first contribution in https://github.com/browserbase/stagehand/pull/1409

**Full Changelog**: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.0.6...stagehand-server/v3.1.3