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