@browserbasehq/[email protected]

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

@browserbasehq/[email protected]

Patch Changes

• #1012 9e8c173 Thanks @miguelg719! - Fix disabling api validation whenever a customLLM client is provided

@browserbasehq/[email protected]

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

@browserbasehq/[email protected]

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

@browserbasehq/[email protected]

Patch Changes

• #856 8a43c5a Thanks @seanmcguire12! - set download behaviour by default

• #857 890ffcc Thanks @miguelg719! - return "not-supported" for elements inside the shadow-dom

• #844 64c1072 Thanks @seanmcguire12! - don't automatically close tabs

• #860 b077d3f Thanks @miguelg719! - Set default schema on extract options with no schema

• #842 8bcb5d7 Thanks @seanmcguire12! - improved handling for OS level dropdowns

• #846 7bf10c5 Thanks @miguelg719! - Filter attaching to target worker / shared_worker

@browserbasehq/[email protected]

Minor Changes

• #819 6a18c1e Thanks @seanmcguire12! - try playwright click and fall back to JS click event

Patch Changes

• #826 124e0d3 Thanks @seanmcguire12! - fix issue where we are unable to take actions on text nodes

• #818 1660751 Thanks @miguelg719! - Added CUA support for Claude 4 models

• #821 cadac9d Thanks @seanmcguire12! - use playwright instead of playwright test

• #832 759da55 Thanks @miguelg719! - Fix _refreshPageFromAPI to use parametrized apiKey

• #810 a175a51 Thanks @miguelg719! - Update logos

• #822 8527a80 Thanks @miguelg719! - Add model with date tag for OpenAI CUA

• #833 55fca2f Thanks @seanmcguire12! - adjust stagehandLogger.warn() level to be 1 instead of 0

@browserbasehq/[email protected]

Patch Changes

• #796 12a99b3 Thanks @miguelg719! - Added a experimental flag to enable the newest and most experimental features

• #807 2451797 Thanks @seanmcguire12! - include version number in StagehandDefaultError message

• #803 1d631a5 Thanks @miguelg719! - Enable session affinity for cache optimization

• #804 9c398bb Thanks @seanmcguire12! - update operatorResponseSchema based on new openai spec

• #786 c19ad7f Thanks @miguelg719! - Handle reroute to account for rollout

@browserbasehq/[email protected]

Minor Changes

• #737 6ef6073 Thanks @seanmcguire12! - deprecate useTextExtract and remove functionality

Patch Changes

• #741 5680d25 Thanks @seanmcguire12! - use safeparse for zod validation

• #783 4de92a8 Thanks @miguelg719! - Fix the readme logo link

@browserbasehq/[email protected]

Patch Changes

• #721 be8652e Thanks @miguelg719! - Fix stagehand.close() functionality to include calling browser.close()

• #724 6b413b7 Thanks @seanmcguire12! - rm refine step in extract

• #712 7eafbd9 Thanks @seanmcguire12! - deprecated onlyVisible param and remove its functionality

• #725 1b50aa6 Thanks @seanmcguire12! - dont overwrite .describe() when user defines a zod schema with z.string().url().describe()

• #717 f2b7f1f Thanks @seanmcguire12! - don't publish uncompiled ts to npm

• #719 c8d672f Thanks @seanmcguire12! - fix Invalid schema for response_format error when extracting links

• #722 bebf204 Thanks @seanmcguire12! - replace NBSP with regular space & remove special characters from dom+a11y tree

• #714 37d6810 Thanks @miguelg719! - Fix the native AI SDK client implementation to optionally take in an API key

v2.2.0

Minor Changes

• #655 8814af9 Thanks @seanmcguire12! - extract links

• #675 35c55eb Thanks @tkattkat! - Added Gemini 2.5 Flash to Google supported models

• #668 5c6d2cf Thanks @miguelg719! - Added a new class - Stagehand Evaluator - that wraps around a Stagehand object to determine whether a task is successful or not. Currently used for agent evals

Patch Changes

• #706 18ac6fb Thanks @seanmcguire12! - remove unused fillInVariables fn

• #692 6b95248 Thanks @miguelg719! - Updated the list of OpenAI models (4.1, o3...)

• #688 7d81b3c Thanks @seanmcguire12! - wrap page.evaluate to make sure we have injected browser side scripts before calling them

• #664 b5ca00a Thanks @miguelg719! - remove unnecessary log

• #683 8f0f97b Thanks @seanmcguire12! - use javsacript click instead of playwright

• #705 346ef5d Thanks @miguelg719! - Fixed removing a hanging observation map that is no longer used

• #698 c145bc1 Thanks @sameelarif! - Fixing LLM client support to natively integrate with AI SDK

• #687 edd6d3f Thanks @miguelg719! - Fixed the schema input for Gemini's response model

• #678 5ec43d8 Thanks @seanmcguire12! - allow form filling when form is not top-most element

• #694 b8cc164 Thanks @seanmcguire12! - add telemetry for cua agents to stagehand.metrics

• #699 d9f4243 Thanks @seanmcguire12! - rm deprecated primitives from stagehand object

• #710 9f4ab76 Thanks @seanmcguire12! - support targeted extract for domExtract

• #677 bc5a731 Thanks @miguelg719! - Fixes a redundant unnecessary log