#2080 21c78b3 Thanks @miguelg719! - Add variables support to v3 agentExecute API schema and remove experimental requirement
#2077 f437f73 Thanks @monadoid! - Fix frame registry handling for OOPIF pages
#2098 a783b99 Thanks @seanmcguire12! - bump transitive deps to patched versions
#2089 8d2f354 Thanks @shrey150! - Strengthen observe prompts so LLMs return complete encoded element IDs.
#2047 a87c1fc Thanks @tkattkat! - Set default agent mode to hybrid with auto routing to dom for non compatible models
#2101 26e6c96 Thanks @seanmcguire12! - move playwright-core, puppeteer-core, patchright-core from optional dependencies to peer dependencies
#2068 1d176c4 Thanks @filip-michalsky! - Remove the default temperature setting from v3 agent AI SDK calls so reasoning models that do not support temperature run without provider warnings.
#2040 1fa9613 Thanks @monadoid! - Prefer STAGEHAND_API_URL for Stagehand API overrides while retaining STAGEHAND_BASE_URL as a deprecated fallback.
#2065 9ff70dd Thanks @miguelg719! - Add support for CUA models: openai/gpt-5.4-mini, openai/gpt-5.5, and anthropic/claude-haiku-4-5
#2039 7640381 Thanks @monadoid! - Deprecate Browserbase project ID configuration.

May 8, 2026

stagehand/server-v3 v3.6.8

↗

stagehand-server-v3/v3.6.8

What's Changed

[chore]: bump various transitive deps across monorepo by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/2098

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server-v3/v3.6.7...stagehand-server-v3/v3.6.8

May 7, 2026

stagehand/server-v3 v3.6.7

↗

stagehand-server-v3/v3.6.7

What's Changed

[feat]: add ignoreSelectors to observe() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/2096
Default SEA binary server-v3 to only bind to localhost by @pirate in https://github.com/browserbase/stagehand/pull/2091

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server-v3/v3.6.6...stagehand-server-v3/v3.6.7

stagehand/server-v3 v3.6.6

↗

stagehand-server-v3/v3.6.6

What's Changed

remove experimental requirement on agent variables (#2079) by @miguelg719 in https://github.com/browserbase/stagehand/pull/2080
remove default temp by @filip-michalsky in https://github.com/browserbase/stagehand/pull/2076
[STG-1935] fix: strengthen observe element ID prompting by @shrey150 in https://github.com/browserbase/stagehand/pull/2089
[chore]: commit updated spec by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/2095
STG-1806 Make model API key optional in OpenAPI by @monadoid in https://github.com/browserbase/stagehand/pull/2094

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server-v3/v3.6.5...stagehand-server-v3/v3.6.6

May 6, 2026

stagehand/server-v3 v3.6.5

↗

stagehand-server-v3/v3.6.5

What's Changed

fix: preserve OOPIF frame registry parent edge by @monadoid in https://github.com/browserbase/stagehand/pull/2077
remove hardcoded agent temp by @filip-michalsky in https://github.com/browserbase/stagehand/pull/2068
[feat]: add ignoreSelectors to extract() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/2084
Manual eval dispatch workflow by @miguelg719 in https://github.com/browserbase/stagehand/pull/2085
[STG-1808] Deprecate Browserbase project ID by @monadoid in https://github.com/browserbase/stagehand/pull/2039

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server-v3/v3.6.4...stagehand-server-v3/v3.6.5

May 4, 2026

stagehand/server-v3 v3.6.4

↗

stagehand-server-v3/v3.6.4

What's Changed

[chore] update supported CUA models (#2064) by @miguelg719 in https://github.com/browserbase/stagehand/pull/2065
default agent to hybrid mode by @tkattkat in https://github.com/browserbase/stagehand/pull/2047
Evals v2 by @miguelg719 in https://github.com/browserbase/stagehand/pull/2011
Remove old trace by @miguelg719 in https://github.com/browserbase/stagehand/pull/2075
[STG-1808] Use STAGEHAND_API_URL for Stagehand API client by @monadoid in https://github.com/browserbase/stagehand/pull/2040

Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/browse-cli@0.6.0...stagehand-server-v3/v3.6.4

Apr 27, 2026

@browserbasehq/browse-cli@0.6.0

↗

Minor Changes

#1935 666baf1 Thanks @shrey150! - Add global flags for commonly used Browserbase session parameters (--proxies, --advanced-stealth, --solve-captchas, --region, --keep-alive, --session-timeout, --block-ads). These flags configure the Browserbase session in remote mode.

Patch Changes

#1905 a4ca430 Thanks @derekmeegan! - Add browse cdp <url|port> command to attach to any CDP target and stream DevTools protocol events as NDJSON. Supports --domain filtering, --pretty mode for human-readable output, and clean piping to files or jq.
#1906 34598b9 Thanks @derekmeegan! - Add browse upload <selector> <files...> command for uploading files to <input type="file"> elements. Supports single and multiple file uploads, works with both local and remote Browserbase sessions.
#2056 e87f167 Thanks @derekmeegan! - browse cdp now also calls Page.setLifecycleEventsEnabled whenever the Page domain is enabled, so consumers receive Page.lifecycleEvent notifications (init, commit, DOMContentLoaded, load, firstPaint, firstContentfulPaint, networkAlmostIdle, networkIdle, etc.) in addition to Page.frameNavigated. --pretty mode formats lifecycle events with the milestone name. No effect on consumers that pass --domain without Page.
#2049 ed4db53 Thanks @shrey150! - Use the exact DevToolsActivePort websocket path for local auto-connect and bare-port CDP attach to avoid extra remote debugging probes before the real browser connection.

Mar 31, 2026

stagehand/server-v3 v3.6.3

↗

stagehand-server-v3/v3.6.3

What's Changed

Include LLM headers in ModelConfig by @miguelg719 in https://github.com/browserbase/stagehand/pull/1874
Fix schema parsing bug for Pydantic .model_json_schema() by @miguelg719 in https://github.com/browserbase/stagehand/pull/1873
feat(cli): add browse-cli metadata to Browserbase sessions by @shrey150 in https://github.com/browserbase/stagehand/pull/1890
STG-1669: fix(cli): clear cached state when browser connection dies by @shrey150 in https://github.com/browserbase/stagehand/pull/1887
STG-1672: Add --connect flag to browse CLI for existing Browserbase sessions by @shrey150 in https://github.com/browserbase/stagehand/pull/1889
chore: Decouple browse-cli release cycle from stagehand core by @shrey150 in https://github.com/browserbase/stagehand/pull/1885
[STG-1702] fix: pass GITHUB_TOKEN to changeset version step in release-cli workflow by @shrey150 in https://github.com/browserbase/stagehand/pull/1893
Fix OpenAI cua agent by @tkattkat in https://github.com/browserbase/stagehand/pull/1899
[v4]: add method arg to /click route stub by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1884
STG-1614: add v4 llm stubs and internal schemas by @monadoid in https://github.com/browserbase/stagehand/pull/1881
[v4]: update /scroll route stub by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1875
[v4]: add /elementInfo route stub by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1877
[v4]: more page route stubs for locator functions by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1882
STG-1668: browse env local auto-discovers existing Chrome via CDP by @shrey150 in https://github.com/browserbase/stagehand/pull/1886
[fix]: handle mapping timeout -> timeoutMs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1901
STG-1671: chore: add prettier pre-commit hook via husky + lint-staged by @shrey150 in https://github.com/browserbase/stagehand/pull/1888
Recover server-v4 drizzle stack onto main by @monadoid in https://github.com/browserbase/stagehand/pull/1917
chore: switch browse-cli to merge-first release flow by @shrey150 in https://github.com/browserbase/stagehand/pull/1921
Release @browserbasehq/browse-cli@0.4.0 by @github-actions[bot] in https://github.com/browserbase/stagehand/pull/1925
[fix]: harden act variables prompt by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1922
[fix]: attach to manually-created new tabs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1924
[STG-1733] fix: use valid metadata key for browse-cli sessions by @derekmeegan in https://github.com/browserbase/stagehand/pull/1911
Release @browserbasehq/browse-cli@0.4.1 by @github-actions[bot] in https://github.com/browserbase/stagehand/pull/1932
[STG-1739] fix: browse-cli releases publish under alpha instead of latest by @shrey150 in https://github.com/browserbase/stagehand/pull/1934
Add support for LLM middleware by @tkattkat in https://github.com/browserbase/stagehand/pull/1872
[Claimed #1844] Refactor model ID checks for GPT 5.x model family by @github-actions[bot] in https://github.com/browserbase/stagehand/pull/1852
Add browse get markdown command by @derekmeegan in https://github.com/browserbase/stagehand/pull/1907
fix: pass through server-v3 operation errors by @monadoid in https://github.com/browserbase/stagehand/pull/1937
fix: compute server release versions from tags by @monadoid in https://github.com/browserbase/stagehand/pull/1938
fix: trigger server release workflows on workflow changes by @monadoid in https://github.com/browserbase/stagehand/pull/1939
fix: resolve server release versions from remote tags by @monadoid in https://github.com/browserbase/stagehand/pull/1940
fix shell parsing in server release workflows by @monadoid in https://github.com/browserbase/stagehand/pull/1941

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server-v3/v3.6.2...stagehand-server-v3/v3.6.3

Mar 24, 2026

stagehand/server-v3 v3.6.2

↗

stagehand-server-v3/v3.6.2

Mar 18, 2026

@browserbasehq/stagehand@3.2.0

↗

Minor Changes

#1779 2f43ffa Thanks @shrey150! - feat: add cdpHeaders option to localBrowserLaunchOptions for passing custom HTTP headers when connecting to an existing browser via CDP URL
#1834 63ee247 Thanks @tkattkat! - Update stagehand agents search tool
#1774 521a10e Thanks @seanmcguire12! - add new page.setExtraHTTPHeaders() method

Patch Changes

#1759 505e8c6 Thanks @shrey150! - Add bedrock to the provider enum in model configuration schemas and regenerate OpenAPI spec.
#1814 7dc35f5 Thanks @tkattkat! - Change usage of openai provider in agent to default to store:false
#1846 335cf47 Thanks @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 6ba0a1d Thanks @shrey150! - Expose headers in GoogleVertexProviderSettings so model configs can pass custom provider headers (for example X-Goog-Priority) without TypeScript errors.
#1847 4ff3bb8 Thanks @miguelg719! - Enable FlowLogger on BROWSERBASE_FLOW_LOGS=1
#1752 c27054b Thanks @derekmeegan! - fix: pause Browserbase agents while captcha solving is active and improve CUA recovery after the solve completes
#1800 2abf5b9 Thanks @shrey150! - Make projectId optional for Browserbase sessions — only BROWSERBASE_API_KEY is required
#1766 7817fcc Thanks @tkattkat! - Add configurable timeout to tools in agent
#1749 7390508 Thanks @pirate! - When connecting to a browser session that has zero open tabs, Stagehand now automatically creates an initial about:blank tab so the connection can continue.
#1761 611f43a Thanks @seanmcguire12! - fix issue where handlePossibleNavigation was producing unnecessary error logs on clicks that trigger page close
#1817 2402a3c Thanks @tkattkat! - Add support for passing custom headers in clientOptions

@browserbasehq/browse-cli@0.2.0

↗

Minor Changes

#1816 687d54a Thanks @shrey150! - Add --context-id and --persist flags to browse open for loading and persisting Browserbase Contexts across sessions
#1793 e38c13b Thanks @shrey150! - Initial release of browse CLI - browser automation for AI agents

Patch Changes

#1806 f8c7738 Thanks @shrey150! - Fix browse env showing stale mode after browse env remote
Updated dependencies [505e8c6, 2f43ffa, 63ee247, 7dc35f5, 335cf47, 6ba0a1d, 4ff3bb8, c27054b, 2abf5b9, 7817fcc, 7390508, 611f43a, 521a10e, 2402a3c]:
- @browserbasehq/stagehand@3.2.0

Mar 10, 2026

stagehand/server-v3 v3.6.1

↗

stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

What's Changed

[fix]: rm legacy handlePossibleNavigation() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1761
[docs]: add docs for context.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1762
[STG-1458] server cache docs by @sameelarif in https://github.com/browserbase/stagehand/pull/1753
chore: remove retired Claude 3.5 and 3.7 Sonnet models by @shrey150 in https://github.com/browserbase/stagehand/pull/1775
fix: expose Vertex headers in public model config types by @shrey150 in https://github.com/browserbase/stagehand/pull/1764
[STG-1482] Update caching docs: split into Browserbase Cache and Local Cache sections by @derekmeegan in https://github.com/browserbase/stagehand/pull/1770
Solve init script race with Debugger.resume at frame init script injection time by @pirate in https://github.com/browserbase/stagehand/pull/1719
[feat]: add page.setExtraHTTPHeaders() by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1774
[feat]: add cdpHeaders option for custom CDP connection headers by @shrey150 in https://github.com/browserbase/stagehand/pull/1779
fix: evals CLI link and preserve config by @miguelg719 in https://github.com/browserbase/stagehand/pull/1755
[fix]: skip CI jobs requiring secrets on fork PRs by @shrey150 in https://github.com/browserbase/stagehand/pull/1780
Allow outside contributors to run CI with secrets when approved by @pirate in https://github.com/browserbase/stagehand/pull/1782
Revert "Allow outside contributors to run CI with secrets when approved" by @pirate in https://github.com/browserbase/stagehand/pull/1786
Revert "[fix]: skip CI jobs requiring secrets on fork PRs" by @pirate in https://github.com/browserbase/stagehand/pull/1787
[feat]: add configurable timeout to agent tools by @tkattkat in https://github.com/browserbase/stagehand/pull/1766
Add missing cdpHeaders field to v3 server openapi spec by @pirate in https://github.com/browserbase/stagehand/pull/1797
[STG-1536] Split packages/stagehand/server into separate server-v3 and server-v4 dirs by @pirate in https://github.com/browserbase/stagehand/pull/1796
[feat]: add browse CLI package by @shrey150 in https://github.com/browserbase/stagehand/pull/1793
fix(CI): fix changeset reference to stale server package name blocking CI by @pirate in https://github.com/browserbase/stagehand/pull/1801

Full Changelog: https://github.com/browserbase/stagehand/compare/stagehand-server/v3.6.1...stagehand-server-v3/v3.6.1

Feb 25, 2026

stagehand/server v3.6.1

↗

stagehand-server/v3.6.1

What's Changed

[docs]: add docs for cookie handling by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/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 https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/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 https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/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 https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/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 https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/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 https://github.com/browserbase/stagehand/pull/1748
[docs]: add keepAlive docs by @seanmcguire12 in https://github.com/browserbase/stagehand/pull/1747
[STG-1450] Fix Session init failing when no pages are open, falls back to opening about:blank by @pirate in https://github.com/browserbase/stagehand/pull/1749
STG-1307: set Sonatype portal for Java/Kotlin by @monadoid in https://github.com/browserbase/stagehand/pull/1757
[fix]: Add bedrock to provider enum in Zod schemas and OpenAPI spec by @shrey150 in https://github.com/browserbase/stagehand/pull/1759

Full Changelog: https://github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.1.0...stagehand-server/v3.6.1

Feb 24, 2026

@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
#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" });
```

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 <number>-<number> 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)
#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
#1697 aac9a19 Thanks @shrey150! - fix: support <frame> elements in XPath frame boundary detection so act() works on legacy <frameset> pages
#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
#1581 49ead1e Thanks @sameelarif! - Server-side caching is now available.

When running env: "BROWSERBASE", Stagehand automatically caches act(), extract(), and observe() 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: false on the Stagehand instance or per individual call. Check out the browserbase blog for more details.
#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)
#1735 c465e87 Thanks @monadoid! - Supports request header authentication with connectToMCPServer
#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.