Releases: browserbase/stagehand
stagehand/server-v3 v3.6.3
What's Changed
- Include LLM headers in ModelConfig by @miguelg719 in #1874
- Fix schema parsing bug for Pydantic
.model_json_schema()by @miguelg719 in #1873 - feat(cli): add browse-cli metadata to Browserbase sessions by @shrey150 in #1890
- STG-1669: fix(cli): clear cached state when browser connection dies by @shrey150 in #1887
- STG-1672: Add --connect flag to browse CLI for existing Browserbase sessions by @shrey150 in #1889
- chore: Decouple browse-cli release cycle from stagehand core by @shrey150 in #1885
- [STG-1702] fix: pass GITHUB_TOKEN to changeset version step in release-cli workflow by @shrey150 in #1893
- Fix OpenAI cua agent by @tkattkat in #1899
- [v4]: add
methodarg to/clickroute stub by @seanmcguire12 in #1884 - STG-1614: add v4 llm stubs and internal schemas by @monadoid in #1881
- [v4]: update
/scrollroute stub by @seanmcguire12 in #1875 - [v4]: add
/elementInforoute stub by @seanmcguire12 in #1877 - [v4]: more page route stubs for locator functions by @seanmcguire12 in #1882
- STG-1668: browse env local auto-discovers existing Chrome via CDP by @shrey150 in #1886
- [fix]: handle mapping
timeout->timeoutMsby @seanmcguire12 in #1901 - STG-1671: chore: add prettier pre-commit hook via husky + lint-staged by @shrey150 in #1888
- Recover server-v4 drizzle stack onto main by @monadoid in #1917
- chore: switch browse-cli to merge-first release flow by @shrey150 in #1921
- Release @browserbasehq/browse-cli@0.4.0 by @github-actions[bot] in #1925
- [fix]: harden act variables prompt by @seanmcguire12 in #1922
- [fix]: attach to manually-created new tabs by @seanmcguire12 in #1924
- [STG-1733] fix: use valid metadata key for browse-cli sessions by @derekmeegan in #1911
- Release @browserbasehq/browse-cli@0.4.1 by @github-actions[bot] in #1932
- [STG-1739] fix: browse-cli releases publish under alpha instead of latest by @shrey150 in #1934
- Add support for LLM middleware by @tkattkat in #1872
- [Claimed #1844] Refactor model ID checks for GPT 5.x model family by @github-actions[bot] in #1852
- Add
browse get markdowncommand by @derekmeegan in #1907 - fix: pass through server-v3 operation errors by @monadoid in #1937
- fix: compute server release versions from tags by @monadoid in #1938
- fix: trigger server release workflows on workflow changes by @monadoid in #1939
- fix: resolve server release versions from remote tags by @monadoid in #1940
- fix shell parsing in server release workflows by @monadoid in #1941
Full Changelog: stagehand-server-v3/v3.6.2...stagehand-server-v3/v3.6.3
stagehand/server-v3 v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in #1865
- variables for observe by @filip-michalsky in #1808
- docs: update docs theme to fix our previous sunset theme by @Kylejeong2 in #1879
- Add explicit SSE event names for local v3 streaming by @monadoid in #1858
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.2.0...stagehand-server-v3/v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in #1865
- variables for observe by @filip-michalsky in #1808
- docs: update docs theme to fix our previous sunset theme by @Kylejeong2 in #1879
- Add explicit SSE event names for local v3 streaming by @monadoid in #1858
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.2.0...stagehand-server-v3/v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in #1865
- variables for observe by @filip-michalsky in #1808
- docs: update docs theme to fix our previous sunset theme by @Kylejeong2 in #1879
- Add explicit SSE event names for local v3 streaming by @monadoid in #1858
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.2.0...stagehand-server-v3/v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in #1865
- variables for observe by @filip-michalsky in #1808
- docs: update docs theme to fix our previous sunset theme by @Kylejeong2 in #1879
- Add explicit SSE event names for local v3 streaming by @monadoid in #1858
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.2.0...stagehand-server-v3/v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in #1865
- variables for observe by @filip-michalsky in #1808
- docs: update docs theme to fix our previous sunset theme by @Kylejeong2 in #1879
- Add explicit SSE event names for local v3 streaming by @monadoid in #1858
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.2.0...stagehand-server-v3/v3.6.2
What's Changed
- [docs]: add docs for
page.setExtraHTTPHeaders()by @seanmcguire12 in #1842 - Revert unintentional test commit by @miguelg719 in #1850
- [feat]: apply
toolTimeoutarg to more tools by @seanmcguire12 in #1843 - Revert broken finished SSE yield config by @monadoid in #1856
- remove unnecssary value param from fillform tool in dom mode by @tkattkat in #1811
- group v4 routes with fastify plugins by @monadoid in #1851
- [fix]: add
useSearch&toolTimeoutto stainless types by @seanmcguire12 in #1854 - [v4]: unify selector type by @seanmcguire12 in #1860
- [v4]: add index to selector schemas by @seanmcguire12 in #1861
- [v4]: rm redundant routes by @seanmcguire12 in #1862
- [v4]: update stubs to return selector obj by @seanmcguire12 in https://github.com/browserbase/sta...
@browserbasehq/stagehand@3.2.0
Minor Changes
-
#1779
2f43ffaThanks @shrey150! - feat: addcdpHeadersoption tolocalBrowserLaunchOptionsfor passing custom HTTP headers when connecting to an existing browser via CDP URL -
#1834
63ee247Thanks @tkattkat! - Update stagehand agents search tool -
#1774
521a10eThanks @seanmcguire12! - add new page.setExtraHTTPHeaders() method
Patch Changes
-
#1759
505e8c6Thanks @shrey150! - Add bedrock to the provider enum in model configuration schemas and regenerate OpenAPI spec. -
#1814
7dc35f5Thanks @tkattkat! - Change usage of openai provider in agent to default to store:false -
#1846
335cf47Thanks @aq17! - Fix streaming finished event being silently dropped. The final SSE event containing the result payload (success status, message, actions, usage, and messages) was previously discarded instead of being yielded to the caller. -
#1764
6ba0a1dThanks @shrey150! - ExposeheadersinGoogleVertexProviderSettingsso model configs can pass custom provider headers (for exampleX-Goog-Priority) without TypeScript errors. -
#1847
4ff3bb8Thanks @miguelg719! - Enable FlowLogger on BROWSERBASE_FLOW_LOGS=1 -
#1752
c27054bThanks @derekmeegan! - fix: pause Browserbase agents while captcha solving is active and improve CUA recovery after the solve completes -
#1800
2abf5b9Thanks @shrey150! - Make projectId optional for Browserbase sessions — only BROWSERBASE_API_KEY is required -
#1766
7817fccThanks @tkattkat! - Add configurable timeout to tools in agent -
#1749
7390508Thanks @pirate! - When connecting to a browser session that has zero open tabs, Stagehand now automatically creates an initialabout:blanktab so the connection can continue. -
#1761
611f43aThanks @seanmcguire12! - fix issue where handlePossibleNavigation was producing unnecessary error logs on clicks that trigger page close -
#1817
2402a3cThanks @tkattkat! - Add support for passing custom headers in clientOptions
@browserbasehq/browse-cli@0.2.0
stagehand/server-v3 v3.6.1
What's Changed
- [fix]: rm legacy
handlePossibleNavigation()by @seanmcguire12 in #1761 - [docs]: add docs for
context.setExtraHTTPHeaders()by @seanmcguire12 in #1762 - [STG-1458] server cache docs by @sameelarif in #1753
- chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in #1775
- fix: expose Vertex headers in public model config types by @shrey150 in #1764
- [STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in #1770
- Solve init script race with Debugger.resume at frame init script injection time by @pirate in #1719
- [feat]: add
page.setExtraHTTPHeaders()by @seanmcguire12 in #1774 - [feat]: add
cdpHeadersoption for custom CDP connection headers by @shrey150 in #1779 - fix: evals CLI link and preserve config by @miguelg719 in #1755
- [fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in #1780
- Allow outside contributors to run CI with secrets when approved by @pirate in #1782
- Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in #1786
- Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in #1787
- [feat]: add configurable timeout to agent tools by @tkattkat in #1766
- Add missing cdpHeaders field to v3 server openapi spec by @pirate in #1797
- [STG-1536] Split
packages/stagehand/serverinto separate server-v3 and server-v4 dirs by @pirate in #1796 - [feat]: add browse CLI package by @shrey150 in #1793
- fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in #1801
Full Changelog: stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1
What's Changed
- [fix]: rm legacy
handlePossibleNavigation()by @seanmcguire12 in #1761 - [docs]: add docs for
context.setExtraHTTPHeaders()by @seanmcguire12 in #1762 - [STG-1458] server cache docs by @sameelarif in #1753
- chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in #1775
- fix: expose Vertex headers in public model config types by @shrey150 in #1764
- [STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in #1770
- Solve init script race with Debugger.resume at frame init script injection time by @pirate in #1719
- [feat]: add
page.setExtraHTTPHeaders()by @seanmcguire12 in #1774 - [feat]: add
cdpHeadersoption for custom CDP connection headers by @shrey150 in #1779 - fix: evals CLI link and preserve config by @miguelg719 in #1755
- [fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in #1780
- Allow outside contributors to run CI with secrets when approved by @pirate in #1782
- Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in #1786
- Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in #1787
- [feat]: add configurable timeout to agent tools by @tkattkat in #1766
- Add missing cdpHeaders field to v3 server openapi spec by @pirate in #1797
- [STG-1536] Split
packages/stagehand/serverinto separate server-v3 and server-v4 dirs by @pirate in #1796 - [feat]: add browse CLI package by @shrey150 in #1793
- fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in #1801
Full Changelog: stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1
What's Changed
- [fix]: rm legacy
handlePossibleNavigation()by @seanmcguire12 in #1761 - [docs]: add docs for
context.setExtraHTTPHeaders()by @seanmcguire12 in #1762 - [STG-1458] server cache docs by @sameelarif in #1753
- chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in #1775
- fix: expose Vertex headers in public model config types by @shrey150 in #1764
- [STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in #1770
- Solve init script race with Debugger.resume at frame init script injection time by @pirate in #1719
- [feat]: add
page.setExtraHTTPHeaders()by @seanmcguire12 in #1774 - [feat]: add
cdpHeadersoption for custom CDP connection headers by @shrey150 in #1779 - fix: evals CLI link and preserve config by @miguelg719 in #1755
- [fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in #1780
- Allow outside contributors to run CI with secrets when approved by @pirate in #1782
- Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in #1786
- Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in #1787
- [feat]: add configurable timeout to agent tools by @tkattkat in #1766
- Add missing cdpHeaders field to v3 server openapi spec by @pirate in #1797
- [STG-1536] Split
packages/stagehand/serverinto separate server-v3 and server-v4 dirs by @pirate in #1796 - [feat]: add browse CLI package by @shrey150 in #1793
- fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in #1801
Full Changelog: stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1
What's Changed
- [fix]: rm legacy
handlePossibleNavigation()by @seanmcguire12 in #1761 - [docs]: add docs for
context.setExtraHTTPHeaders()by @seanmcguire12 in #1762 - [STG-1458] server cache docs by @sameelarif in #1753
- chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in #1775
- fix: expose Vertex headers in public model config types by @shrey150 in #1764
- [STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in #1770
- Solve init script race with Debugger.resume at frame init script injection time by @pirate in #1719
- [feat]: add
page.setExtraHTTPHeaders()by @seanmcguire12 in #1774 - [feat]: add
cdpHeadersoption for custom CDP connection headers by @shrey150 in #1779 - fix: evals CLI link and preserve config by @miguelg719 in #1755
- [fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in #1780
- Allow outside contributors to run CI with secrets when approved by @pirate in #1782
- Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in #1786
- Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in #1787
- [feat]: add configurable timeout to agent tools by @tkattkat in #1766
- Add missing cdpHeaders field to v3 server openapi spec by @pirate in #1797
- [STG-1536] Split
packages/stagehand/serverinto separate server-v3 and server-v4 dirs by @pirate in #1796 - [feat]: add browse CLI package by @shrey150 in #1793
- fix(CI): fix changeset reference to s...
stagehand/server v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
What's Changed
- [docs]: add docs for cookie handling by @seanmcguire12 in #1748
- [docs]: add
keepAlivedocs by @seanmcguire12 in #1747 - [STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in #1749
- STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in #1757
- [fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in #1759
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1
@browserbasehq/stagehand@3.1.0
Minor Changes
-
#1681
e3db9aaThanks @tkattkat! - Add cookie management APIs:context.addCookies(),context.clearCookies(), &context.cookies() -
#1672
b65756eThanks @seanmcguire12! - add boolean keepAlive parameter to allow for configuring whether the browser should be closed when stagehand.close() is called. -
#1708
176d420Thanks @seanmcguire12! - add context.setExtraHTTPHeaders() -
#1611
8a3c066Thanks @monadoid! - Usingmodeenum instead of oldcuaboolean in openapi spec -
#1632
afbd08bThanks @pirate! - Remove automatic.envloading viadotenv.If your app relies on
.envfiles, installdotenvand load it explicitly in your code:import dotenv from "dotenv"; dotenv.config({ path: ".env" });
Patch Changes
-
#1683
7584f3eThanks @seanmcguire12! - fix: include shadow DOM in .count() & .nth() & support xpath predicates -
#1644
1e1c9c1Thanks @monadoid! - Fix unhandled CDP detaches by returning the original sendCDP promise -
#1729
6bef890Thanks @shrey150! - fix: support Claude 4.6 (Opus and Sonnet) in CUA mode by using the correctcomputer_20251124tool version andcomputer-use-2025-11-24beta header -
#1647
ffd4b33Thanks @tkattkat! - Fix [Agent] - Address bug causing issues with continuing a conversation from past messages in dom mode -
#1614
677bff5Thanks @miguelg719! - Enforce - regex validation on act/observe for elementId -
#1580
65ff464Thanks @tkattkat! - Add unified variables support across act and agent with a single VariableValue type -
#1666
101bcf2Thanks @Kylejeong2! - add support for codex models -
#1728
0a94301Thanks @seanmcguire12! - handle potential race condition on.close()when using the Stagehand API -
#1664
b27c04dThanks @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) -
#1624
0e8d569Thanks @seanmcguire12! - fix issue where screenshot masks were not being applied to dialog elements -
#1596
ff0f979Thanks @tkattkat! - Update usage/metrics handling in agent -
#1631
2d89d2bThanks @miguelg719! - Add right and middle click support to act and observe -
#1697
aac9a19Thanks @shrey150! - fix: support<frame>elements in XPath frame boundary detection soact()works on legacy<frameset>pages -
#1692
06de50fThanks @shrey150! - fix: skip piercer injection for chrome-extension:// and other non-HTML targets -
#1613
aa4d981Thanks @miguelg719! - SupportedUnderstudyAction Enum validation for 'method' on act/observe inference -
#1652
18b1e3bThanks @miguelg719! - Add support for gemini 3 flash and pro in hybrid/cua agent -
#1706
957d82bThanks @chrisreadsf! - Add GLM to prompt-based JSON fallback for models without native structured output support -
#1633
22e371aThanks @tkattkat! - Add warning when incorrect models are used with agents hybrid mode -
#1673
d29b91fThanks @miguelg719! - Add multi-region support for Stagehand API with region-specific endpoints -
#1695
7b4f817Thanks @tkattkat! - Fix: zod bug when pinning zod to v3 and using structured output in agent -
#1609
3f9ca4dThanks @miguelg719! - Add SupportedUnderstudyActions to observe system prompt -
#1581
49ead1eThanks @sameelarif! - Server-side caching is now available.When running
env: "BROWSERBASE", Stagehand automatically cachesact(),extract(), andobserve()results server-side — repeated calls with the same inputs return instantly without consuming LLM tokens.Caching is enabled by default and can be disabled via
serverCache: falseon the Stagehand instance or per individual call. Check out the browserbase blog for more details. -
#1642
3673369Thanks @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) -
#1735
c465e87Thanks @monadoid! - Supports request header authentication with connectToMCPServer -
#1705
ae533e4Thanks @seanmcguire12! - include error cause in UnderstudyCommandException -
#1636
ea33052Thanks [@miguelg719](http...
@browserbasehq/stagehand@2.5.8
Patch Changes
- #1710
df76207Thanks @seanmcguire12! - handle target closed errors on rapidly opening/closing popups
stagehand/server v3.6.0
What's Changed
- Fix SEA release workflow for Windows by @miguelg719 in #1603
- Enable bedrock provider on server by @miguelg719 in #1604
- [docs]: add docs for
page.snapshot()by @seanmcguire12 in #1589 - [docs]: add docs for
page.waitForSelector()by @seanmcguire12 in #1605 - [docs]: add docs for local browser port option by @seanmcguire12 in #1606
- Add SupportedUnderstudyActions to observe system prompt by @miguelg719 in #1609
- Using 'mode' enum instead of old 'cua' boolean by @monadoid in #1611
- Update stale observe evals by @miguelg719 in #1615
- [fix]:
maskparam inpage.screenshot()only applied to first node by @seanmcguire12 in #1612 - [chore]: strengthen regex validation on
act,observeforelementIdby @miguelg719 in #1614 - add auto-bedrock support based on bedrock/provider.model-name by @pirate in #1617
- [chore]: pull stringified JS into TS file by @seanmcguire12 in #1622
- SupportedUnderstudyAction Enum validation for 'method' on act/observe by @miguelg719 in #1613
- Fix issues in stainless.yml by @pirate in #1638
- add warning when models are used with hybrid mode that will not perf… by @tkattkat in #1633
- [fix]: screenshot mask not working on
<dialog>elements by @seanmcguire12 in #1624 - Add right/middle click support on act and observe by @miguelg719 in #1631
- Add executionModel serialization to api client by @miguelg719 in #1636
- Fix deprecation warning for old model format (#1625) by @miguelg719 in #1637
- Add replay to docs by @monadoid in #1643
- Removed MCP from readme for now by @monadoid in #1639
- fix(cdp): avoid unhandled detach by returning original sendCDP promise by @monadoid in #1644
- [fix]: ctx
addInitScripton popup pages by @seanmcguire12 in #1642 - [chore]: rm docs changeset by @seanmcguire12 in #1648
- Fix [Agent] : message processing bug by @tkattkat in #1647
- Add support for gemini 3 on cua/hybrid agent by @miguelg719 in #1652
- [docs]: fix userDataDir example for Browserbase sessions by @shrey150 in #1654
- fix(ci): handle new tags in server release workflow (#1660) by @miguelg719 in #1661
- Add user-agent by @miguelg719 in #1646
Full Changelog: stagehand-server/v3.5.1...stagehand-server/v3.6.0
What's Changed
- Fix SEA release workflow for Windows by @miguelg719 in #1603
- Enable bedrock provider on server by @miguelg719 in #1604
- [docs]: add docs for
page.snapshot()by @seanmcguire12 in #1589 - [docs]: add docs for
page.waitForSelector()by @seanmcguire12 in #1605 - [docs]: add docs for local browser port option by @seanmcguire12 in #1606
- Add SupportedUnderstudyActions to observe system prompt by @miguelg719 in #1609
- Using 'mode' enum instead of old 'cua' boolean by @monadoid in #1611
- Update stale observe evals by @miguelg719 in #1615
- [fix]:
maskparam inpage.screenshot()only applied to first node by @seanmcguire12 in #1612 - [chore]: strengthen regex validation on
act,observeforelementIdby @miguelg719 in #1614 - add auto-bedrock support based on bedrock/provider.model-name by @pirate in #1617
- [chore]: pull stringified JS into TS file by @seanmcguire12 in #1622
- SupportedUnderstudyAction Enum validation for 'method' on act/observe by @miguelg719 in #1613
- Fix issues in stainless.yml by @pirate in #1638
- add warning when models are used with hybrid mode that will not perf… by @tkattkat in #1633
- [fix]: screenshot mask not working on
<dialog>elements by @seanmcguire12 in #1624 - Add right/middle click support on act and observe by @miguelg719 in #1631
- Add executionModel serialization to api client by @miguelg719 in #1636
- Fix deprecation warning for old model format (#1625) by @miguelg719 in #1637
- Add replay to docs by @monadoid in #1643
- Removed MCP from readme for now by @monadoid in #1639
- fix(cdp): avoid unhandled detach by returning original sendCDP promise by @monadoid in #1644
- [fix]: ctx
addInitScripton popup pages by @seanmcguire12 in #1642 - [chore]: rm docs changeset by @seanmcguire12 in #1648
- Fix [Agent] : message processing bug by @tkattkat in #1647
- Add support for gemini 3 on cua/hybrid agent by @miguelg719 in #1652
- [docs]: fix userDataDir example for Browserbase sessions by @shrey150 in #1654
- fix(ci): handle new tags in server release workflow (#1660) by @miguelg719 in #1661
- Add user-agent by @miguelg719 in #1646
Full Changelog: stagehand-server/v3.5.1...stagehand-server/v3.6.0
What's Changed
- Fix SEA release workflow for Windows by @miguelg719 in #1603
- Enable bedrock provider on server by @miguelg719 in #1604
- [docs]: add docs for
page.snapshot()by @seanmcguire12 in #1589 - [docs]: add docs for
page.waitForSelector()by @seanmcguire12 in #1605 - [docs]: add docs for local browser port option by @seanmcguire12 in #1606
- Add SupportedUnderstudyActions to observe system prompt by @miguelg719 in #1609
- Using 'mode' enum instead of old 'cua' boolean by @monadoid in #1611
- Update stale observe evals by @miguelg719 in #1615
- [fix]:
maskparam inpage.screenshot()only applied to first node by @seanmcguire12 in #1612 - [chore]: strengthen regex validation on
act,observeforelementIdby @miguelg719 in #1614 - add auto-bedrock support based on bedrock/provider.model-name by @pirate in #1617
- [chore]: pull stringified JS into TS file by @seanmcguire12 in #1622
- SupportedUnderstudyAction Enum validation for 'method' on act/observe by @miguelg719 in #1613
- Fix issues in stainless.yml by @pirate in #1638
- add warning when models are used with hybrid mode that will not perf… by @tkattkat in #1633
- [fix]: screenshot mask not working on
<dialog>elements by @seanmcguire12 in #1624 - Add right/middle click support on act and observe by @miguelg719 in #1631
- Add executionModel serialization to api client by @miguelg719 in #1636
- Fix deprecation warning for old model format (#1625) by @miguelg719 in #1637
- Add replay to docs by @monadoid in #1643
- Removed MCP from readme for now by @monadoid in #1639
- fix(cdp): avoid unhandled detach by returning original sendCDP promise by @monadoid in #1644
- [fix]: ctx
addInitScripton popup pages by @seanmcguire12 in #1642 - [chore]: rm docs changeset by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/...
stagehand/server v3.5.1
What's Changed
- [chore]: add stricter linting rules by @seanmcguire12 in #1597
- improve agent usage metrics by @tkattkat in #1596
- Fix deprecated cua: true syntax in v3 migration guide by @aq17 in #1601
- Logging agent output to file example by @monadoid in #1599
- Add support for vertex on stagehand server by @miguelg719 in #1602
New Contributors
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.0.8...stagehand-server/v3.5.1
What's Changed
- [chore]: add stricter linting rules by @seanmcguire12 in #1597
- improve agent usage metrics by @tkattkat in #1596
- Fix deprecated cua: true syntax in v3 migration guide by @aq17 in #1601
- Logging agent output to file example by @monadoid in #1599
- Add support for vertex on stagehand server by @miguelg719 in #1602
New Contributors
Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.0.8...stagehand-server/v3.5.1