- December 2025
- No date parsed from source.
- Detected by Releasebot:Dec 25, 2025
1.13.1
Patch Changes
- #509 a7d345e Thanks @miguelg719 ! - Bun runs will now throw a more informed error
- December 2025
- No date parsed from source.
- Detected by Releasebot:Dec 25, 2025
- Modified by Releasebot:Jan 6, 2026
1.13.0
New updates improve observability and configuration with parameterized Stagehand offloading and LocalBrowserLaunchOptions. Iframes now appear in observe results, captcha solving can be enabled with waitForCaptchaSolves, and API payload fixes plus accessibility refinements ship.
Minor Changes
- #486 33f2b3f Thanks @sameelarif ! - [Unreleased] Parameterized offloading Stagehand method calls to the Stagehand API. In the future, this will allow for better observability and debugging experience.
- #494 9ba4b0b Thanks @pkiv ! - Added LocalBrowserLaunchOptions to provide comprehensive configuration options for local browser instances. Deprecated the top-level headless option in favor of using localBrowserLaunchOptions.headless
- #500 a683fab Thanks @miguelg719 ! - Including Iframes in ObserveResults. This appends any iframe(s) found in the page to the end of observe results on any observe call.
- #504 577662e Thanks @sameelarif ! - Enabled support for Browserbase captcha solving after page navigations. This can be enabled with the new constructor parameter: waitForCaptchaSolves.
- #496 28ca9fb Thanks @sameelarif ! - Fixed browserbaseSessionCreateParams not being passed in to the API initialization payload.
Patch Changes
- #459 62a29ee Thanks @seanmcguire12 ! - create a11y + dom hybrid input for observe
- #463 e40bf6f Thanks @seanmcguire12 ! - include 'Scrollable' annotations in a11y-dom hybrid
- #480 4c07c44 Thanks @miguelg719 ! - Adding a fallback try on actFromObserveResult to use the description from observe and call regular act.
- #487 2c855cf Thanks @seanmcguire12 ! - update refine extraction prompt to ensure correct schema is used
- #497 945ed04 Thanks @kamath ! - add gpt 4o november snapshot
- December 2025
- No date parsed from source.
- Detected by Releasebot:Dec 28, 2025
- Modified by Releasebot:Jan 20, 2026
1.12.0
Minor Changes
- #426 bbbcee7 Thanks @miguelg719 ! - Observe got a major upgrade. Now it will return a suggested playwright method with any necessary arguments for the generated candidate elements. It also includes a major speedup when using a11y tree processing for context.
- #452 16837ec Thanks @kamath ! - add o3-mini to availablemodel
- #441 1032d7d Thanks @seanmcguire12 ! - allow act to accept observe output
- December 2025
- No date parsed from source.
- Detected by Releasebot:Dec 28, 2025
1.11.0
Minor Changes
- #428 5efeb5a Thanks @seanmcguire12 ! - temporarily remove vision
- December 2025
- No date parsed from source.
- Detected by Releasebot:Dec 28, 2025
1.10.1
Patch Changes
- #422 a2878d0 Thanks @miguelg719 ! - Fixing a build type error for async functions being called inside evaulate for observeHandler.
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
3.0.0
Speed boost 20-40% across act, extract, and observe with automatic caching and multi‑browser support. Built‑in primitives like page, locator, frameLocator and deepLocator, bun compatibility, and streamlined schemas. Targeted extract across iframes and shadow roots; migration guide advised.
Major Changes
- Removes internal Playwright dependency
- A generous 20-40% speed increase across act, extract, & observe calls
- Compatibility with Playwright, Puppeteer, and Patchright
- Automatic action caching (agent, stagehand.act). Go from CUA → deterministic scripts w/o inference
- A suite of non AI primitives:
- page
- locator (built in closed mode shadow root traversal, with xpaths & css selectors)
- frameLocator
- deepLocator (crosses iframes & shadow roots)
- bun compatibility
- Simplified extract schemas
- CSS selector support (id-based support coming soon)
- Targeted extract and observe across iframes & shadow roots
- More intuitive type names (observeResult is now action, act accepts an instruction string instead of an action string, solidified ModelConfiguration)
Check the migration guide for more information
Original source Report a problem - November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.5.0
New release adds stagehand.agent support for MCP servers and custom tools, plus patches for webvoyager evals, local MCP server connections, configurable base URLs for OpenAI provider and CUA, and GPT-5 support in the operator agent.
Minor Changes
- #981 8244ab2 Thanks @sameelarif ! - Added support for stagehand.agent to interact with MCP servers as well as custom tools to be passed in. For more information, reference the MCP integrations documentation
Patch Changes
- #959 09b5e1e Thanks @filip-michalsky ! - add webvoyager evals
- #1049 e3734b9 Thanks @miguelg719 ! - Support local MCP server connections
- #1025 be85b19 Thanks @tkattkat ! - add support for custom baseUrl within openai provider
- #1040 88d1565 Thanks @miguelg719 ! - Allow OpenAI CUA to take in an optional baseURL
- #1046 ab5d6ed Thanks @tkattkat ! - Add support for gpt-5 in operator agent
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.4
Patch Changes
- #1012 9e8c173 Thanks @miguelg719 ! - Fix disabling api validation whenever a customLLM client is provided
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.3
Patch notes announce GPT-5 API format changes and experimental shadow DOM support. It also fixes iframe behavior, improves image handling in the evaluator, and adds more stagehand evals. These are shipped product changes.
Patch Changes
- #951 f45afdc Thanks @miguelg719 ! - Patch GPT-5 new api format
- #954 261bba4 Thanks @seanmcguire12 ! - add support for shadow DOMs (open & closed mode) when experimental: true
- #944 8de7bd8 Thanks @seanmcguire12 ! - Bump zod version compatibility and add pathing spec
- #919 3d80421 Thanks @seanmcguire12 ! - enable scrolling inside of iframes
- #963 0ead63d Thanks @tkattkat ! - Properly handle images in evaluator + clean up response parsing logic
- #961 8422828 Thanks @tkattkat ! - Add more evals for stagehand agent
- #946 b769206 Thanks @seanmcguire12 ! - fix: unable to act on/get content from some same process iframes
- #962 72d2683 Thanks @seanmcguire12 ! - handle namespaced elements in xpath build step
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.2
Patch notes showcase safety and stability fixes across the API and UI, including type safety, tab handling, iframe/xpath bug fixes, and SDK version reporting. Cleanup of old images and obsolete methods also included.
Patch Changes
- #865 6b4e6e3 Thanks @seanmcguire12 ! - improve type safety for trimTrailingTextNode
- #897 e77d018 Thanks @miguelg719 ! - Fix selfHeal to remember intially received arguments
- #920 c20adb9 Thanks @seanmcguire12 ! - fix: tab handling on API
- #882 b86df93 Thanks @seanmcguire12 ! - remove elements that don't have xpaths from observe response
- #905 023c2c2 Thanks @tkattkat ! - Delete old images from anthropic cua client
- #925 8c28647 Thanks @miguelg719 ! - Remove _refreshPageFromApi()
- #887 87e09c6 Thanks @seanmcguire12 ! - fix: allow xpaths with prepended 'xpath=' for targeted extract
- #864 a611115 Thanks @miguelg719 ! - Temporarily patch custom clients serialization error on api
- #881 69913fe Thanks @miguelg719 ! - Pass sdk version number to API for debugging
- #913 b1b83a1 Thanks @seanmcguire12 ! - move iframe out of 'experimental'
- #891 be8497c Thanks @seanmcguire12 ! - fix: nested iframe xpath bug
- #883 98704c9 Thanks @seanmcguire12 ! - add timeout for JS click
- #907 04978bd Thanks @seanmcguire12 ! - store mapping of CDP frame ID -> page