What's Changed

• Removed x-language and x-sdk-version from openapi spec by @monadoid in #1515
• Using provider/model syntax in modelName examples within openapi spec by @monadoid in #1526
• Update docs for canonical by @tkattkat in #1519
• Update version number for new 3.4.0 release by @monadoid in #1529

Full Changelog: stagehand-server/v3.3.0...stagehand-server/v3.4.0

What's Changed

• Hybrid mode docs by @tkattkat in #1454
• Update agent message handling by @tkattkat in #1478
• add waitForTimeout to page by @tkattkat in #1481
• Update agent to only calculate xpath when caching is enabled by @tkattkat in #1480
• Screenshot after actions by @tkattkat in #1483
• Improve agent logging by @tkattkat in #1486
• update docs for new methods & return types by @tkattkat in #1488
• Replace Slack references with Discord by @shrey150 in #1492
• [chore]: fix bid postings eval by @seanmcguire12 in #1499
• [fix]: use correct model on cache replay failure by @seanmcguire12 in #1498
• export tool function & type by @tkattkat in #1495
• /end endpoint returns empty object by @monadoid in #1500
• Added optional param to force empty object by @monadoid in #1506
• Fix ollama support with AI SDK by @shrey150 in #1504
• Fix ControlOrMeta key normalization in keyPress by @shrey150 in #1511
• update flaky evals by @tkattkat in #1507
• docs: add BROWSERBASE_CONFIG_DIR file-based session logging by @shrey150 in #1508
• Update close tool + add output to agent result by @tkattkat in #1505
• [feat]: add support for page.waitForSelector() by @seanmcguire12 in #1509
• [feat]: add page.snapshot() by @seanmcguire12 in #1518
• Disable swagger docs in prod by @monadoid in #1520

Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/[email protected]/v3.3.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

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

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

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

Patch Changes

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

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

Patch Changes

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

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