Stagehand Updates & Release Notes

What's Changed

• Add screenshot option to Extract by @miguelg719 in #2149
• feat(verifier): add evaluator backend facade by @miguelg719 in #2129
• Workflow: publish eval results by @miguelg719 in #2093
• fix[evals] remove braintrust api key requirement (#2145) by @miguelg719 in #2153
• Delete packages/server-v4 entirely for now by @pirate in #2151
• feat(verifier): add verifier evaluator shell and types by @miguelg719 in #2157
• feat(verifier): record agent trajectories by @miguelg719 in #2131
• Fix SDK API reference parameter labels by @monadoid in #2164
• [chore]: update lockfile by @seanmcguire12 in #2168
• [chore]: bump ws dep by @seanmcguire12 in #2169
• [STG-1756] forward Vertex model config by @monadoid in #2160

Full Changelog: stagehand-server-v3/v3.6.10...stagehand-server-v3/v3.7.0

What's Changed

Version Packages by @github-actions[bot] in #2067

[chore]: bump mcp sdk & fastify by @seanmcguire12 in #2106

Evals TUI tree traversal by @miguelg719 in #2100

[docs]: add docs for ignoreSelectors by @seanmcguire12 in #2097

[docs]: add ignoreSelectors to docs for extract() by @seanmcguire12 in #2088

[fix] Anthropic CUA triple_click mapping (#2104) by @miguelg719 in #2107

[evals] Onboarding flow by @miguelg719 in #2103

Updated readme for evals package by @miguelg719 in #2112

[chore]: bump more deps by @seanmcguire12 in #2114

[chore]: bump mintlify version by @seanmcguire12 in #2115

[fix]: include native selector state into snapshot by @seanmcguire12 in #2116

Pin github action/workflow versions by @miguelg719 in #2121

Fix structuredOutputMode for newer Anthropic models by @miguelg719 in #2120

[chore]: omit test files from published package by @seanmcguire12 in #2122

[chore]: rm deepmerge from peer deps by @seanmcguire12 in #2124

[chore]: rm langchain deps by @seanmcguire12 in #2123

[fix]: import ToolSet from ai public export by @seanmcguire12 in #2126

[feat]: forward ignoreDefaultArgs to chrome-launcher by @seanmcguire12 in #2127

[chore]: rm cli release workflow by @seanmcguire12 in #2143

Pass local launch options when attaching over CDP by @shriyatheunicorn in #2146

[STG-1756] add Vertex auth params to Stagehand spec by @monadoid in #2118

New Contributors

@shriyatheunicorn made their first contribution in #2146

Full Changelog: stagehand-server-v3/v3.6.9...stagehand-server-v3/v3.6.10

Minor Changes

• #2084 0641d44 Thanks @seanmcguire12! - add ignoreSelectors param to extract()
• #2096 a11603d Thanks @seanmcguire12! - add ignoreSelectors to observe()

Patch Changes

• #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.

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.

Prepare the next browse-cli release by versioning the package on main.

What this PR does:

• bumps packages/cli/package.json to 0.5.0
• updates the browse-cli changelog
• consumes the pending browse-cli changesets

After this PR merges, the Release workflow on main will publish
@browserbasehq/[email protected] from that exact commit using pnpm pack + npm publish --provenance.

Summary by cubic

Publish @browserbasehq/[email protected], defaulting browse env local
to an isolated browser and adding --auto-connect to opt into attaching
to an existing debuggable Chrome; explicit CDP attach via browse env local <port|url> remains unchanged.

Migration

If you previously relied on auto-attach, run: browse env local --auto-connect.

Written for commit 795c005.

Summary will update on new commits. Review in
cubic

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

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 method arg to /click route stub by @seanmcguire12 in #1884
• STG-1614: add v4 llm stubs and internal schemas by @monadoid in #1881
• [v4]: update /scroll route stub by @seanmcguire12 in #1875
• [v4]: add /elementInfo route 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 -> timeoutMs by @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/[email protected] 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/[email protected] 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 markdown command 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

Prepare the next browse-cli release by versioning the package on main.

What this PR does:

bumps packages/cli/package.json to 0.4.2

updates the browse-cli changelog

consumes the pending browse-cli changesets

After this PR merges, the Release workflow on main will publish
@browserbasehq/[email protected] from that exact commit using pnpm pack + npm publish --provenance.

Summary by cubic

Publish @browserbasehq/browse-cli 0.4.2 by bumping the version and
updating the changelog. This release adds a command to convert page HTML
to Markdown.

New Features

Add browse get markdown [selector] to convert page HTML to Markdown.

Defaults to body; supports an optional selector; preserves links,
tables, and code blocks via node-html-markdown.

Written for commit eb2b85f.

Summary will update on new commits. Review in
cubic

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

What's Changed

• [docs]: add docs for page.setExtraHTTPHeaders() by @seanmcguire12 in #1842
• Revert unintentional test commit by @miguelg719 in #1850
• [feat]: apply toolTimeout arg 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 & toolTimeout to 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/[email protected]/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 toolTimeout arg 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 & toolTimeout to 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/[email protected]/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 toolTimeout arg 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 & toolTimeout to 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/[email protected]/v3.6.2