Version Packages

[github-actions]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@browserbasehq/stagehand@3.1.0

Minor Changes

• #1681 e3db9aa Thanks @tkattkat! - Add cookie management APIs: context.addCookies(), context.clearCookies(), & context.cookies()

• #1672 b65756e Thanks @seanmcguire12! - add boolean keepAlive parameter to allow for configuring whether the browser should be closed when stagehand.close() is called.

• #1708 176d420 Thanks @seanmcguire12! - add context.setExtraHTTPHeaders()

• #1611 8a3c066 Thanks @monadoid! - Using mode enum instead of old cua boolean in openapi spec

Patch Changes

• #1683 7584f3e Thanks @seanmcguire12! - fix: include shadow DOM in .count() & .nth() & support xpath predicates

• #1644 1e1c9c1 Thanks @monadoid! - Fix unhandled CDP detaches by returning the original sendCDP promise

• #1729 6bef890 Thanks @shrey150! - fix: support Claude 4.6 (Opus and Sonnet) in CUA mode by using the correct computer_20251124 tool version and computer-use-2025-11-24 beta header

• #1647 ffd4b33 Thanks @tkattkat! - Fix [Agent] - Address bug causing issues with continuing a conversation from past messages in dom mode

• #1614 677bff5 Thanks @miguelg719! - Enforce - regex validation on act/observe for elementId

• #1580 65ff464 Thanks @tkattkat! - Add unified variables support across act and agent with a single VariableValue type

• #1666 101bcf2 Thanks @Kylejeong2! - add support for codex models

• #1728 0a94301 Thanks @seanmcguire12! - handle potential race condition on .close() when using the Stagehand API

• #1664 b27c04d Thanks @seanmcguire12! - fixes issue with context.addInitScript() where scripts were not being applied to out of process iframes (OOPIFs), and popup pages with same process iframes (SPIFs)

• #1632 afbd08b Thanks @pirate! - Remove automatic .env loading via dotenv.

  If your app relies on .env files, install dotenv and load it explicitly in your code:

  import dotenv from "dotenv";
  dotenv.config({ path: ".env" });

• #1624 0e8d569 Thanks @seanmcguire12! - fix issue where screenshot masks were not being applied to dialog elements

• #1596 ff0f979 Thanks @tkattkat! - Update usage/metrics handling in agent

• #1631 2d89d2b Thanks @miguelg719! - Add right and middle click support to act and observe

• #1692 06de50f Thanks @shrey150! - fix: skip piercer injection for chrome-extension:// and other non-HTML targets

• #1613 aa4d981 Thanks @miguelg719! - SupportedUnderstudyAction Enum validation for 'method' on act/observe inference

• #1652 18b1e3b Thanks @miguelg719! - Add support for gemini 3 flash and pro in hybrid/cua agent

• #1706 957d82b Thanks @chrisreadsf! - Add GLM to prompt-based JSON fallback for models without native structured output support

• #1633 22e371a Thanks @tkattkat! - Add warning when incorrect models are used with agents hybrid mode

• #1673 d29b91f Thanks @miguelg719! - Add multi-region support for Stagehand API with region-specific endpoints

• #1695 7b4f817 Thanks @tkattkat! - Fix: zod bug when pinning zod to v3 and using structured output in agent

• #1609 3f9ca4d Thanks @miguelg719! - Add SupportedUnderstudyActions to observe system prompt

• #1642 3673369 Thanks @seanmcguire12! - fix issue where scripts added via context.addInitScripts() were not being injected into new pages that were opened via popups (eg, clicking a link that opens a new page) and/or calling context.newPage(url)

• #1705 ae533e4 Thanks @seanmcguire12! - include error cause in UnderstudyCommandException

• #1636 ea33052 Thanks @miguelg719! - Include executionModel on the AgentConfigSchema

• #1679 5764ede Thanks @shrey150! - fix issue where locator.count() was not working with xpaths that have attribute predicates

• #1646 f09b184 Thanks @miguelg719! - Add user-agent to CDP connections

• #1637 a7d29de Thanks @miguelg719! - Improve error and warning message for legacy model format

• #1685 d334399 Thanks @tkattkat! - Bump ai sdk & google provider version

• #1662 44416da Thanks @seanmcguire12! - fix issue where locator.fill() was not working on elements that require direct value setting

• #1612 bdd8b4e Thanks @seanmcguire12! - fix issue where screenshot mask was only being applied to the first element that the locator resolved to. masks now apply to all matching elements.

@browserbasehq/stagehand-server@3.6.0

Minor Changes

• #1611 8a3c066 Thanks @monadoid! - Using mode enum instead of old cua boolean in openapi spec

Patch Changes

• #1604 4753078 Thanks @miguelg719! - Enable bedrock

• #1636 ea33052 Thanks @miguelg719! - Include executionModel on the AgentConfigSchema

• #1602 22a0502 Thanks @miguelg719! - Include vertex as a supported provider

• Updated dependencies [7584f3e, 1e1c9c1, 6bef890, ffd4b33, 677bff5, 65ff464, 101bcf2, 0a94301, b27c04d, afbd08b, e3db9aa, 0e8d569, ff0f979, 2d89d2b, 06de50f, aa4d981, 18b1e3b, 957d82b, b65756e, 22e371a, d29b91f, 7b4f817, 176d420, 3f9ca4d, 8a3c066, 3673369, ae533e4, ea33052, 5764ede, f09b184, a7d29de, d334399, 44416da, bdd8b4e]:

  • @browserbasehq/stagehand@3.1.0

@browserbasehq/stagehand-evals@1.1.8

Patch Changes

• Updated dependencies [7584f3e, 1e1c9c1, 6bef890, ffd4b33, 677bff5, 65ff464, 101bcf2, 0a94301, b27c04d, afbd08b, e3db9aa, 0e8d569, ff0f979, 2d89d2b, 06de50f, aa4d981, 18b1e3b, 957d82b, b65756e, 22e371a, d29b91f, 7b4f817, 176d420, 3f9ca4d, 8a3c066, 3673369, ae533e4, ea33052, 5764ede, f09b184, a7d29de, d334399, 44416da, bdd8b4e]:
  • @browserbasehq/stagehand@3.1.0