NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3130 most downloaded on PyPI
Browserbase's SDK for building browser agents
Latest stable
4.4.0
Last release 11 days ago
10 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Rarely documented
notes for 13 of 53 stable releases
Nothing withdrawn
no release was ever pulled
1 years old
154 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published t
This PR was opened by the Changesets
release GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.
#3305
aeb1ba0
Thanks @miguelg719! - add
browser.disconnect(), which closes an attached Stagehand instance and
the connection to a browser without closing the browser or releasing its
Browserbase session (Browserbase still ends sessions without keepAlive
on disconnect). browser.close() after disconnect() now throws
(connect again to close the browser), a launched local browser receives
Browser.close before it is terminated, browser handles expose cdpUrl
(cdp_url in Python) for local browsers, and connected reports
whether the handle still has a live connection
#3325
d59afde
Thanks @miguelg719! - Add an extension
watchdog for lost SDK clients
#3339
44d99df
Thanks @seanmcguire12! - Adopt
cross-origin iframes that were already loaded when Stagehand attached,
or that are nested inside another cross-origin iframe, so snapshots and
actions can reach them.
#3330
dc8eb40
Thanks @seanmcguire12! - bump zod to
4.6.6
#3340
edb76b0
Thanks @akeimach! - Fix act, observe and
extract with Claude Opus 5.5 by bumping @ai-sdk/anthropic and ai in
the extension.
#3387
066e875
Thanks @seanmcguire12! - fixed
domain policy bypasses involving URLs with credentials, background
requests, and speculative page loads
#3383
1e50db6
Thanks @seanmcguire12! - skip
variable substitution for drag-and-drop arguments in act().
#3388
18b96f2
Thanks @seanmcguire12! - fix issue
where calling act() prevents cross-origin iframes from loading
#3330
dc8eb40
Thanks @seanmcguire12! - bump zod to
4.6.6
#3350
b7a4b89
Thanks @miguelg719! - Save run
screenshots only as PNG or JPEG files, under ./stagehand-artifacts by
default
Updated dependencies
[44d99df,
dc8eb40,
edb76b0,
066e875,
1e50db6,
aeb1ba0,
18b96f2,
d59afde]:
d59afde#3339
44d99df
Thanks @seanmcguire12! - Adopt
cross-origin iframes that were already loaded when Stagehand attached,
or that are nested inside another cross-origin iframe, so snapshots and
actions can reach them.
#3330
dc8eb40
Thanks @seanmcguire12! - bump zod to
4.6.6
#3340
edb76b0
Thanks @akeimach! - Fix act, observe and
extract with Claude Opus 5.5 by bumping @ai-sdk/anthropic and ai in
the extension.
#3387
066e875
Thanks @seanmcguire12! - fixed
domain policy bypasses involving URLs with credentials, background
requests, and speculative page loads
#3383
1e50db6
Thanks @seanmcguire12! - skip
variable substitution for drag-and-drop arguments in act().
#3388
18b96f2
Thanks @seanmcguire12! - fix issue
where calling act() prevents cross-origin iframes from loading
#3305
aeb1ba0
Thanks @miguelg719! - add
browser.disconnect(), which closes an attached Stagehand instance and
the connection to a browser without closing the browser or releasing its
Browserbase session (Browserbase still ends sessions without keepAlive
on disconnect). browser.close() after disconnect() now throws
(connect again to close the browser), a launched local browser receives
Browser.close before it is terminated, browser handles expose cdpUrl
(cdp_url in Python) for local browsers, and connected reports
whether the handle still has a live connection
#3325
d59afde
Thanks @miguelg719! - Add an extension
watchdog for lost SDK clients
#3339
44d99df
Thanks @seanmcguire12! - Adopt
cross-origin iframes that were already loaded when Stagehand attached,
or that are nested inside another cross-origin iframe, so snapshots and
actions can reach them.
#3330
dc8eb40
Thanks @seanmcguire12! - bump zod to
4.6.6
#3340
edb76b0
Thanks @akeimach! - Fix act, observe and
extract with Claude Opus 5.5 by bumping @ai-sdk/anthropic and ai in
the extension.
#3387
066e875
Thanks @seanmcguire12! - fixed
domain policy bypasses involving URLs with credentials, background
requests, and speculative page loads
#3383
1e50db6
Thanks @seanmcguire12! - skip
variable substitution for drag-and-drop arguments in act().
#3388
18b96f2
Thanks @seanmcguire12! - fix issue
where calling act() prevents cross-origin iframes from loading
44d99df,dc8eb40,edb76b0,066e875,1e50db6,aeb1ba0,18b96f2,d59afde]:
@browserbasehq/stagehand-integrations-example-claude-code-facade@4.0.7
44d99df,dc8eb40,edb76b0,066e875,1e50db6,aeb1ba0,18b96f2,d59afde]:
44d99df,dc8eb40,edb76b0,066e875,1e50db6,aeb1ba0,18b96f2,d59afde]:
44d99df,dc8eb40,edb76b0,066e875,1e50db6,aeb1ba0,18b96f2,d59afde]:
44d99df,dc8eb40,edb76b0,066e875,1e50db6,aeb1ba0,18b96f2,d59afde]:
dc8eb40Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The two “⭐ Star this repo” links in README.md point to https://github.com/browserbase/stagehand/stargazers , which returns 404 . GitHub no longer serv
The two “⭐ Star this repo” links in README.md point to
https://github.com/browserbase/stagehand/stargazers, which returns
404. GitHub no longer serves the /stargazers page for any
repository — verified against vercel/next.js/stargazers and
microsoft/vscode/stargazers, which 404 the same way, while repository
home pages still return 200.
In README.md (2 lines):
.../stagehand/stargazers →https://github.com/browserbase/stagehandThe repository home page is where the Star button lives, so the links
keep their intent.
curl -L https://github.com/browserbase/stagehand/stargazers → 404;Note: this PR was prepared with the assistance of an automated agent.
Fixes the two "⭐ Star this repo" links in the README by pointing them to
the repository home page instead of the /stargazers URL, which returns
a 404 (GitHub no longer serves the stargazers page for any repo).
Written for commit 602cca2.
Summary will update on new commits.
Co-authored-by: leom1919 leom1919@users.noreply.github.com
calling act() could prevent Stagehand from seeing and interacting with newly loaded cross-origin iframes because its network-settling helper overwrote
act() could prevent Stagehand from seeing and interactingFixes an issue where calling act() could prevent Stagehand from seeing
and interacting with newly loaded cross-origin iframes. The
network-settling helper in actHandlerUtils.ts was overwriting the
browser's auto-attach configuration, which broke attachment management
owned by BrowserContext.
Target.setAutoAttach call; BrowserContextact() remain visible in snapshots and support subsequent actions.Written for commit c00a683.
Summary will update on new commits.
act does not need to substitute variables on self-heal for dragAndDrop()
dragAndDrop()dragAndDrop() needs are selectorsdragAndDrop()Fixes variable substitution in act() so drag-and-drop arguments keep
their literal selector values instead of being treated as text
templates.
substituteVariablesInArguments for dragAndDrop actions whileWritten for commit 32e7744.
Summary will update on new commits.
bumps archiver dependency to 8.x.x
archiver dependency to 8.x.xdeepmerge dependencyBumps archiver to 8.x in the browse package and removes the unused
deepmerge dependency. archiver 8 no longer exports a default
function, so publish.ts now uses the TarArchive class, and
@types/archiver is bumped to match.
Written for commit 5d8ea53.
Summary will update on new commits.
ported the cli specific eslint rules into oxlint
Migrates packages/cli linting from ESLint to oxlint so the CLI uses
the same linter as the monorepo.
no-restricted-syntax selectors) into customrules/oxlint/, adding newstagehand/no-dynamic-code and stagehand/no-legacy-octal rules toeval, dynamic Function construction, and legacyeslint/eslint:fix scripts with oxlint/oxlint:fix,eslint.config.mjs, and removes ESLint devDependencies and ~666Written for commit ab83ea5.
Summary will update on new commits.
opentelemetry-api==1.44.0 -> opentelemetry-api==1.45.1
bumps the following deps:
opentelemetry-api==1.44.0 -> opentelemetry-api==1.45.1black==26.5.1 -> black==26.10.1pyasn1==0.6.4 -> pyasn1==0.6.5Bumps three Python dependencies in the lockfile to pick up patch and
minor releases.
black 26.5.1 → 26.10.1opentelemetry-api 1.44.0 → 1.45.1pyasn1 0.6.4 → 0.6.5Written for commit 26fc2d3.
Summary will update on new commits.
Bumps oxfmt from 0.57.0 to 0.76.0 to pull in a patched tinypool (2.2.0), fixing the security vulnerability GHSA-5gmw-xhrv-c9v3 in the transitive depen…
Bumps oxfmt from 0.57.0 to 0.76.0 to pull in a patched tinypool (2.2.0),
fixing the security vulnerability GHSA-5gmw-xhrv-c9v3 in the transitive
dependency.
Bumping oxfmt also applies updated formatting rules, so several test
files across the docs, evals, extension, and sdk-ts packages get
reformatted. No test logic changes.
Written for commit 4cb35cc.
Summary will update on new commits.
the release job does not need to do a full workspace install
Narrows the Python release workflow install so it only installs what the
release actually needs instead of doing a full workspace install.
just _install-python-release, which installs the extension,stagehand environment.run/exec in theWritten for commit f488248.
Summary will update on new commits.
we do not need this workflow anymore
Removes the preview PR label workflow that built unreleased
TypeScript, Python, and extension artifacts for pull requests, along
with its build scripts, manifest contract, tests, and verification
tooling. The workflow is no longer needed, so the related
CONTRIBUTING.md section and justfile recipe are also removed, and
the Python workspace comment no longer references preview builds.
Written for commit 52710db.
Summary will update on new commits.
to make managing dependencies across the monorepo easier
just cmds, ci/release tooling now use root workspaceMigrates all Python projects to a root uv workspace with a single shared
uv.lock and .venv, making dependency management across the monorepo
consistent.
just commands, CI path filters, and release tooling now run againststagehand==4.1.0 dependency to>=4.3.0,<5), and Deepagents projects drop the<3.14 Python cap and the managed example's websockets override.Migration
just install from the repository root; it uses pnpm install --frozen-lockfile and uv sync --all-packages --locked, replacinguv sync --locked calls.Written for commit 164e286.
Summary will update on new commits.
fix(integrations): save facade screenshot artifacts only as images in…
fix(integrations): save facade screenshot artifacts only as images in…
The extension used @ai-sdk/anthropic 4.0.8 which predates opus 5.5. For structured output, it sent a forced tool call ( tool_choice: { type: "any" } )
Fixes #3337
The extension used @ai-sdk/anthropic 4.0.8 which predates opus 5.5.
For structured output, it sent a forced tool call (tool_choice: { type: "any" }), which opus 5.5 rejected. Because of this, act, observe
and extract were also failing.
@ai-sdk/anthropic to ^4.0.90. This version uses nativeai to ^7.0.155. It must use the same @ai-sdk/provider version@ai-sdk/anthropic to 4.0.26 in mastra-sdk to match the@ai-sdk/provider version that @mastra/core usesBumps @ai-sdk/anthropic and ai in the extension so it works with
Claude Opus 5.5, fixing act, observe, and extract failures for
that model.
tool_choice: { type: "any" })NativeMastraModel type to accept both OpenAI@ai-sdk/provider versions.Written for commit a91cae9.
Summary will update on new commits.
[fix]: adopt pre-existing and nested cross-origin iframes ( #3262 ) ( #3 …
if the sdk process dies without disconnect() / close() (crash, SIGKILL , dropped connection), nothing tells the browser: a local chrome stagehand laun
if the sdk process dies without disconnect() / close() (crash,
SIGKILL, dropped connection), nothing tells the browser: a local
chrome stagehand launched keeps running, and the extension stays
initialized, so reconnecting fails with "A Stagehand instance is already
initialized". builds on #3305 & adopts the mechanism from
service-watchdog
Target.targetDestroyed over its own connection, with no heartbeat orkeepAlive getsBrowser.close; anything else keeps running, and the extension releaseskeepAlive policy and a new client can attachdisconnect() detaches (disarms the watchdog) before closing; if thetype: "other");SIGKILL/SIGINT matrix (ownedSIGKILL of the host, a keepAlive: false session is COMPLETEDkeepAlive: true session stays RUNNING & acceptsconnect() + Stagehand.create()Co-authored-by: Sean McGuire seanmcguire1@outlook.com
fix(evals): authenticate the local code-execution bridge
fix(evals): authenticate the local code-execution bridge (#3156)
removed creawi integration src, removed its corresponding docs changes, added redirects to the main integrations page for both v4 & v3 docs respective
Removes the CrewAI integration, which is stale, along with its source,
docs, and logo. Redirects all CrewAI doc URLs from v3, v4, and legacy
/integrations/crew-ai paths to the main integrations overview, and
removes CrewAI mentions from the README and integration tables.
Written for commit 8d64f2e.
Summary will update on new commits.
to keep dependencies aligned across the monorepo
Migrates TypeScript cookbooks to the monorepo workspace catalog so their
dependencies stay aligned with the rest of the repo, and removes the Go
cookbook ports.
@browserbasehq/stagehand from the workspacejust cookbook <slug> instead of per-folder installs.pnpm-workspace.yaml and turbo.json gain the cookbook packages soWritten for commit 157d893.
Summary will update on new commits.
The DeepWiki badge uses a relative image URL that breaks in published package READMEs because the package does not include the root media directory. U
The DeepWiki badge uses a relative image URL that breaks in published
package READMEs because the package does not include the root media
directory. Use the absolute raw GitHub asset URL, matching the other
badges and the approach in #3066. The DeepWiki destination and badge
dimensions stay the same.
Validation: git diff --check passed; confirmed the SDK package README
inherits the root README; the replacement URL returns HTTP 200 with
image/svg+xml.
Fixes the DeepWiki badge in the published package README so it renders
correctly instead of showing a broken image.
The badge used a relative image URL (./media/deepwiki.svg) that fails
in the published package because the root media directory isn't
included. Replaced it with the absolute raw GitHub asset URL to match
the other badges, keeping the same destination and dimensions.
Written for commit 4e29a79.
Summary will update on new commits.
bumps catalog zod version which bumps zod in the extension, ts sdk, cli, and eve integration
Bumps zod to 4.6.6 across the monorepo via the pnpm catalog, upgrading
the TS SDK, extension, CLI, integrations, and eve. This also makes the
generated V4 protocol schema compatible with the new zod version.
catalog: reference.$defs; the standalone default extract schema now uses astagehand.v4.json emits two union types as type arraysanyOf blocks.Written for commit 6e1420c.
Summary will update on new commits.
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published t
This PR was opened by the Changesets
release GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.
#3267
cb9a1d1
Thanks @seanmcguire12! - add
extension archive getter
#3253
6bf4146
Thanks @seanmcguire12! - add
optional extensionCdpUrl to localBrowser.connect to allow
configuring the in-browser CDP url
#3263
ecb2a6b
Thanks @seanmcguire12! - add
headers to localBrowser.connect so CDP gateways can be authenticated
without credentials in the URL
#3183
901eb27
Thanks @supremeboxlogos! - Add
page.waitForFunction() to wait until a predicate in the page returns a
truthy value.
#3229
c6b6f27
Thanks @seanmcguire12! - skip
caching for request bodies larger than 25 MB.
#3198
10418f9
Thanks @seanmcguire12! - enable
WebMCP by default for local chromium versions newer than 157
#3210
1c40ba7
Thanks @seanmcguire12! - Require
client transport for Browserbase Model Gateway and cache requests.
#3209
17de6ea
Thanks @seanmcguire12! - Route
Browserbase Model Gateway and cache requests through the connected SDK.
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
1c40ba7#3208
4a7c637
Thanks @seanmcguire12! - Support
routing Browserbase Model Gateway and cache requests through the
connected SDK.
#3183
901eb27
Thanks @supremeboxlogos! - Add the
page.wait_for_function method.
#3208
4a7c637
Thanks @seanmcguire12! - Support
routing Browserbase Model Gateway and cache requests through the
connected SDK.
#3183
901eb27
Thanks @supremeboxlogos! - Add the
page.wait_for_function method.
#3229
c6b6f27
Thanks @seanmcguire12! - skip
caching for request bodies larger than 25 MB.
#3257
113ad81
Thanks @seanmcguire12! - honour a
changed extension CDP WS URL when creating a new Stagehand instance
after closing the previous one
#3210
1c40ba7
Thanks @seanmcguire12! - Require
client transport for Browserbase Model Gateway and cache requests.
#3267
cb9a1d1
Thanks @seanmcguire12! - add
extension archive getter
#3265
a31e2da
Thanks @seanmcguire12! - add
Headers to LocalBrowserConnectOptions so CDP gateways can be
authenticated without credentials in the URL
#3254
9eac212
Thanks @seanmcguire12! - add
optional ExtensionCDPURL to LocalBrowserConnectOptions to allow
configuring the in-browser CDP url.
#3183
901eb27
Thanks @supremeboxlogos! - Add
Page.WaitForFunction to wait until a predicate in the page returns a
truthy value.
#3229
c6b6f27
Thanks @seanmcguire12! - skip
caching for request bodies larger than 25 MB.
#3198
10418f9
Thanks @seanmcguire12! - enable
WebMCP by default for local chromium versions newer than 157
#3210
1c40ba7
Thanks @seanmcguire12! - Require
client transport for Browserbase Model Gateway and cache requests.
#3209
17de6ea
Thanks @seanmcguire12! - Route
Browserbase Model Gateway and cache requests through the connected SDK.
#3260
2859fd5
Thanks @seanmcguire12! - add
headers to local_browser.connect so CDP gateways can be
authenticated without credentials in the URL
#3267
cb9a1d1
Thanks @seanmcguire12! - add
extension archive getter
#3252
21e0363
Thanks @seanmcguire12! - add
extension_cdp_url to local_browser.connect for clients that reach
Chrome through a proxy the extension cannot use
#3183
901eb27
Thanks @supremeboxlogos! - Add
page.wait_for_function() to wait until a predicate in the page returns
a truthy value.
#3229
c6b6f27
Thanks @seanmcguire12! - skip
caching for request bodies larger than 25 MB.
#3198
10418f9
Thanks @seanmcguire12! - enable
WebMCP by default for local chromium versions newer than 157
#3210
1c40ba7
Thanks @seanmcguire12! - Require
client transport for Browserbase Model Gateway and cache requests.
#3209
17de6ea
Thanks @seanmcguire12! - Route
Browserbase Model Gateway and cache requests through the connected SDK.
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
@browserbasehq/stagehand-integrations-example-claude-code-facade@4.0.6
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
c6b6f27,cb9a1d1,10418f9,1c40ba7,17de6ea,6bf4146,ecb2a6b,901eb27]:
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
adds docs for getExtensionArchive() , get_extension_archive() , ExtensionArchive()
getExtensionArchive(), get_extension_archive(),ExtensionArchive()Documents the new extension ZIP export helpers and updates the
deployment guide to use them instead of the hardcoded node_modules
path.
getExtensionArchive(), get_extension_archive(), andExtensionArchive(), including upload and local Chrome installationstagehand-extension.zip viaWritten for commit fd9b57b.
Summary will update on new commits.
Expose browser-side predicate waiting consistently across Stagehand SDKs, without transport polling.
Expose browser-side predicate waiting consistently across Stagehand
SDKs, without transport polling.
This is PR2 of 2, stacked directly on #3179
(amel/wait-for-function-extension). Polling, navigation recovery, and
cleanup live in the parent; merge it first using the repository’s
stacked-PR handoff rules.
page.wait_for_function and connect the extensionwaitForFunction(expression, arg?, options?), Pythonwait_for_function(expression, *, arg, polling, timeout), and GoWaitForFunction. As in Playwright, an expression that evaluates to aarg.toString, constructor, and hasOwnProperty keys intimeout to bound a wait. An omitted or zero timeout alsoReviewed with the requested Thermo-Nuclear Code Quality Review skill,
including an independent cross-review of SDK boundaries. No SDK polling
loops, duplicated serializer, broad generator abstraction, or new
1,000-line file crossing.
git diff --checkCo-authored-by: miguel miguelg71921@gmail.com
adds documentation for headers passed into localBrowser.connect()
localBrowser.connect()Adds documentation for passing authentication headers to
localBrowser.connect() (TypeScript and Python) and
ConnectLocalBrowser (Go).
Written for commit 0a68a53.
Summary will update on new commits.
adds an extension cdp url example in browser configuration page
Documents the extensionCdpUrl browser option in the configuration page
with TypeScript, Python, and Go examples, showing how to give the
extension its own CDP WebSocket URL when the client connects through a
proxy or gateway. The examples use a token-based gateway URL, and the
docs also cover validation rules and the fallback behavior when the
option is omitted.
Written for commit 60b0380.
Summary will update on new commits.
to address comments on earlier PRs in this stack
to address comments on earlier PRs in this stack
payload_too_large & skips the later write; antimeout, keeping read_failed forAligns Browserbase HTTP transport behavior across the Go, Python, and
TypeScript SDKs so header validation, connection handling, cancellation,
and cache error semantics are consistent. Malformed request headers now
fail before HTTP dispatch instead of surfacing as retryable network
failures, and client Browserbase init params now require browser
metadata and reject api_key and api_url since the browser handle's
connection supplies those.
What changed
x-bb-api-key, and forgateway.responses also x-bb-session-id and a defaultAuthorization.payload_too_large; an independently oversized writetimeout rather than read_failed.Written for commit 1900e78.
Summary will update on new commits.
Contrib 3219 feat(evals): JSON answer format and Deep Agents bump ( #3 …
Contrib 3219 feat(evals): JSON answer format and Deep Agents bump (#3…
The docs checks on #3197 and #3199 failed because the OpenAI Toolset guide has TypeScript and Python examples but no Go SDK. The rule required all thr
The docs checks on #3197 and #3199 failed because the OpenAI Toolset
guide has TypeScript and Python examples but no Go SDK. The rule
required all three Stagehand SDK languages on every page, with a one-off
exception for Claude's toolset.
Allow pages under v4/integrations/ to use the SDK languages documented
on that page. Keep all three languages required for core guides and
references. Validate each tab group directly to preserve consistent
language choices and reject duplicate tabs, while allowing repeated
single-language groups.
Validation: all 45 docs unit tests pass, including seven language-policy
cases; targeted lint, formatting, and whitespace checks pass. Local
tests used the existing installed Vitest 4.1.9; CI uses the locked
dependencies.
Fixes the docs language-policy test so integration guides no longer
require SDK snippets they don't cover.
v4/integrations/ now only require the SDKWritten for commit a186be0.
Summary will update on new commits.
chromium versions newer than 157 require enable-features=WebMCP
enable-features=WebMCPAdds the WebMCP flag to the default local Chrome launch flags across
all SDKs so WebMCP works on Chromium versions newer than 157.
--enable-features=WebMCPTesting,DevToolsWebMCPSupport to--enable-features=WebMCP,WebMCPTesting,DevToolsWebMCPSupport inWritten for commit c75f0d9.
Summary will update on new commits.
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published t
This PR was opened by the Changesets
release GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.
bfeda48]:
bfeda48bfeda48]:
bfeda48@browserbasehq/stagehand-integrations-example-claude-code-facade@4.0.5
bfeda48]:
bfeda48]:
bfeda48]:
bfeda48]:
bfeda48bfeda48bfeda48Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Nothing published for this version
[Claimed #3155 ] fix: accept new model IDs without a Stagehand release…
[Claimed #3155] fix: accept new model IDs without a Stagehand release…
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published t
This PR was opened by the Changesets
release GitHub action. When
you're ready to do a release, you can merge this and the packages will
be published to npm automatically. If you're not ready to do a release
yet, that's fine, whenever you add more changesets to main, this PR will
be updated.
a237c77run, snapshot,screenshot.#3115
7abca76
Thanks @seanmcguire12! - update the
Eve peer dependency to ^0.71.2 to use upstream security fixes. Requires
Eve 0.71.2 or later within the 0.71.x release line.
Updated dependencies
[34edfa3,
a837acf,
4da1a21,
5802f59,
819db28,
0210688,
666b6fa,
f3543d3,
f2060a6,
1562d35,
7d8dcef,
476658b,
70f4e91]:
#3030
34edfa3
Thanks @supremeboxlogos! - Export
browser pages as PDF bytes in TypeScript, Python, and Go, with
configurable print settings and timeouts, and optional local file saving
in TypeScript and Python.
#3118
a837acf
Thanks @miguelg719! - Add
clientOptions to browserbase.launch() and browserbase.connect().
Thanks to @pr1m8 for the original proposal
that motivated this feature.
#3083
666b6fa
Thanks @seanmcguire12! - expose a
timeout option for page.snapshot() across all sdks, defaulting to 20
seconds.
set it to 0 for unlimited execution. one budget covers the whole
snapshot capture.
#3140
f2060a6
Thanks @seanmcguire12! -
automatically discover Stagehand extensions when connecting to browsers.
deprecate & ignore extension IDs passed into .connect().
#2916
476658b
Thanks @seanmcguire12! - add page
level hooks for webmcp tools added and webmcp tools removed events.
#3045
4da1a21
Thanks @github-actions! - Keep
telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
#2893
5802f59
Thanks @miguelg719! - Bound
experimental batch and RPC deadlines so callers can stop waiting without
replaying actions or accepting late capture state.
#2894
819db28
Thanks @miguelg719! - Add configurable
bounded CDP heartbeats and sanitized disconnect diagnostics with cleanup
on shutdown.
#2892
0210688
Thanks @miguelg719! - Release a newly
created Browserbase session when initial attachment fails, and support
upload retries
#2978
f3543d3
Thanks @seanmcguire12! - Fix locator
failures when entering loading iframes, and correctly target iframe
elements when an XPath ends at the iframe.
#3033
1562d35
Thanks @seanmcguire12! - add
per-call locator timeouts across TypeScript, Python, & Go. one timeout
covers frame readiness, element lookup, & execution, including typing
delays & highlight duration. the default is 20 seconds. setting timeout
to 0 disables it.
#3146
7d8dcef
Thanks @seanmcguire12! - Make
selector waits include frame readiness in their timeout, support
unlimited waits with timeout: 0, and clean up observers when the wait
ends.
#3052
70f4e91
Thanks @seanmcguire12! - Match
native XPath semantics for text() predicates when a shadow root routes
locators through the composed-tree parser
#3030
34edfa3
Thanks @supremeboxlogos! - Export
browser pages as PDF bytes in TypeScript, Python, and Go, with
configurable print settings and timeouts, and optional local file saving
in TypeScript and Python.
#3083
666b6fa
Thanks @seanmcguire12! - expose a
timeout option for page.snapshot() across all sdks, defaulting to 20
seconds.
set it to 0 for unlimited execution. one budget covers the whole
snapshot capture.
#2916
476658b
Thanks @seanmcguire12! - add page
level hooks for webmcp tools added and webmcp tools removed events.
#3045
4da1a21
Thanks @github-actions! - Keep
telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
#2896
7919934
Thanks @miguelg719! - Snapshot
references remain valid across same-origin and out-of-process frame
captures
#2978
f3543d3
Thanks @seanmcguire12! - Fix locator
failures when entering loading iframes, and correctly target iframe
elements when an XPath ends at the iframe.
#3033
1562d35
Thanks @seanmcguire12! - add
per-call locator timeouts across TypeScript, Python, & Go. one timeout
covers frame readiness, element lookup, & execution, including typing
delays & highlight duration. the default is 20 seconds. setting timeout
to 0 disables it.
#3146
7d8dcef
Thanks @seanmcguire12! - Make
selector waits include frame readiness in their timeout, support
unlimited waits with timeout: 0, and clean up observers when the wait
ends.
#3052
70f4e91
Thanks @seanmcguire12! - Match
native XPath semantics for text() predicates when a shadow root routes
locators through the composed-tree parser
#3030
34edfa3
Thanks @supremeboxlogos! - Export
browser pages as PDF bytes in TypeScript, Python, and Go, with
configurable print settings and timeouts, and optional local file saving
in TypeScript and Python.
#3083
666b6fa
Thanks @seanmcguire12! - expose a
timeout option for page.snapshot() across all sdks, defaulting to 20
seconds.
set it to 0 for unlimited execution. one budget covers the whole
snapshot capture.
#2916
476658b
Thanks @seanmcguire12! - add page
level hooks for webmcp tools added and webmcp tools removed events.
#3045
4da1a21
Thanks @github-actions! - Keep
telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
#3033
1562d35
Thanks @seanmcguire12! - add
per-call locator timeouts across TypeScript, Python, & Go. one timeout
covers frame readiness, element lookup, & execution, including typing
delays & highlight duration. the default is 20 seconds. setting timeout
to 0 disables it.
#3030
34edfa3
Thanks @supremeboxlogos! - Export
browser pages as PDF bytes in TypeScript, Python, and Go, with
configurable print settings and timeouts, and optional local file saving
in TypeScript and Python.
#3123
100e201
Thanks @miguelg719! - Add
ClientOptions to LaunchBrowserbase and ConnectBrowserbase.
#3083
666b6fa
Thanks @seanmcguire12! - expose a
timeout option for page.snapshot() across all sdks, defaulting to 20
seconds.
set it to 0 for unlimited execution. one budget covers the whole
snapshot capture.
#3140
f2060a6
Thanks @seanmcguire12! -
automatically discover Stagehand extensions when connecting to browsers.
deprecate & ignore extension IDs passed into .connect().
#2916
476658b
Thanks @seanmcguire12! - add page
level hooks for webmcp tools added and webmcp tools removed events.
#3045
4da1a21
Thanks @github-actions! - Keep
telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
#2896
7919934
Thanks @miguelg719! - Snapshot
references remain valid across same-origin and out-of-process frame
captures
#2978
f3543d3
Thanks @seanmcguire12! - Fix locator
failures when entering loading iframes, and correctly target iframe
elements when an XPath ends at the iframe.
#3033
1562d35
Thanks @seanmcguire12! - add
per-call locator timeouts across TypeScript, Python, & Go. one timeout
covers frame readiness, element lookup, & execution, including typing
delays & highlight duration. the default is 20 seconds. setting timeout
to 0 disables it.
#3146
7d8dcef
Thanks @seanmcguire12! - Make
selector waits include frame readiness in their timeout, support
unlimited waits with timeout: 0, and clean up observers when the wait
ends.
#3052
70f4e91
Thanks @seanmcguire12! - Match
native XPath semantics for text() predicates when a shadow root routes
locators through the composed-tree parser
#3030
34edfa3
Thanks @supremeboxlogos! - Export
browser pages as PDF bytes in TypeScript, Python, and Go, with
configurable print settings and timeouts, and optional local file saving
in TypeScript and Python.
#3118
a837acf
Thanks @miguelg719! - Add
client_options to browserbase.launch() and browserbase.connect().
#3083
666b6fa
Thanks @seanmcguire12! - expose a
timeout option for page.snapshot() across all sdks, defaulting to 20
seconds.
set it to 0 for unlimited execution. one budget covers the whole
snapshot capture.
#3140
f2060a6
Thanks @seanmcguire12! -
automatically discover Stagehand extensions when connecting to browsers.
deprecate & ignore extension IDs passed into .connect().
#2916
476658b
Thanks @seanmcguire12! - add page
level hooks for webmcp tools added and webmcp tools removed events.
#3045
4da1a21
Thanks @github-actions! - Keep
telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
#2978
f3543d3
Thanks @seanmcguire12! - Fix locator
failures when entering loading iframes, and correctly target iframe
elements when an XPath ends at the iframe.
#3033
1562d35
Thanks @seanmcguire12! - add
per-call locator timeouts across TypeScript, Python, & Go. one timeout
covers frame readiness, element lookup, & execution, including typing
delays & highlight duration. the default is 20 seconds. setting timeout
to 0 disables it.
#3146
7d8dcef
Thanks @seanmcguire12! - Make
selector waits include frame readiness in their timeout, support
unlimited waits with timeout: 0, and clean up observers when the wait
ends.
#3052
70f4e91
Thanks @seanmcguire12! - Match
native XPath semantics for text() predicates when a shadow root routes
locators through the composed-tree parser
34edfa3,a837acf,4da1a21,5802f59,819db28,0210688,666b6fa,f3543d3,f2060a6,1562d35,7d8dcef,476658b,70f4e91]:
@browserbasehq/stagehand-integrations-example-claude-code-facade@4.0.4
34edfa3,a837acf,4da1a21,5802f59,819db28,0210688,666b6fa,f3543d3,f2060a6,1562d35,7d8dcef,476658b,70f4e91]:
34edfa3,a837acf,4da1a21,5802f59,819db28,0210688,666b6fa,f3543d3,f2060a6,1562d35,7d8dcef,476658b,70f4e91]:
34edfa3,a837acf,4da1a21,5802f59,819db28,0210688,666b6fa,f3543d3,f2060a6,1562d35,7d8dcef,476658b,70f4e91]:
34edfa3,a837acf,4da1a21,5802f59,819db28,0210688,666b6fa,f3543d3,f2060a6,1562d35,7d8dcef,476658b,70f4e91]:
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Miguel 36487034+miguelg719@users.noreply.github.com
waitForSelector() did not include frame resolution or locator world readiness in its timeout. time spent preparing or retrying the browser wait was no
waitForSelector() did not include frame resolution or locator world
readiness in its timeout. time spent preparing or retrying the browser
wait was not deducted from its timeout. the browser helper also turned
zero into a fresh 30-second wait, & could keep watching the page after
the caller timed out.
0 unlimited throughoutunderstudy/waitForSelector.test.ts checks the default, finite, &tests/wait-for-selector.test.ts checks all four element states,waitForSelector.test.ts adds a held iframeFixes waitForSelector() so frame resolution, locator-world readiness,
and the element wait share one timeout, and timeout: 0 now means
unlimited instead of a fresh 30-second wait.
Bug Fixes
timeout: 0 is unlimited while the default remains 30 seconds, and0.Written for commit bcd7eeb.
Summary will update on new commits.
added docs for onToolsAdded() & onToolsRemoved() hooks
onToolsAdded() & onToolsRemoved() hooksAdds reference documentation for the onToolsAdded and onToolsRemoved
hooks for TypeScript, Python, and Go, and removes the docs test
exception that previously skipped coverage for these hooks.
page.onToolsAdded() andpage.onToolsRemoved().onToolsAdded()page/on-tools-added and page/on-tools-removed from theWritten for commit a692e4d.
Summary will update on new commits.
unspecified type was causing TS to infer it incorrectly
Fixes a TypeScript type inference issue in the docs SDK reference test
by explicitly typing the sdkSlugs set as Set<string>.
Written for commit 71688c1.
Summary will update on new commits.
[fix]: discover extension automatically & deprecate extension id para…
[fix]: discover extension automatically & deprecate extension id para…
GitHub Pages has been unreliable for the eval sites, so they now also deploy to Vercel at https://stagehand-eval-sites.vercel.app/ . This PR swaps the
GitHub Pages has been unreliable for the eval sites, so they now also
deploy to Vercel at https://stagehand-eval-sites.vercel.app/. This PR
swaps the host. Paths are unchanged:
https://browserbase.github.io/stagehand-eval-sites/sites/<name>/…
https://stagehand-eval-sites.vercel.app/sites/<name>/…
What changed (76 files)
browserbase.github.io/stagehand-eval-sites/ URL across evalsgit grep 'github\.io/stagehand-eval-sites' matches onlyget_url.ts.packages/evals/core/tasks/page-info/get_url.ts stored the host as anget_url.ts, each file matches main once the host is normalizedVerified against the Vercel host
sites/ are byte-identical to Pages (sha256) with/sites/x to /sites/x/, as onsites/ areseanmcguire12.github.io, stillRelated: browserbase/stagehand-eval-sites#80 (Vercel config) and
browserbase/stagehand-eval-sites#81 (self-links made relative, so the
ionwave URL assertion holds on either host).
GitHub Pages stays up, so older commits and published examples keep
working. To roll back, revert this PR.
Points eval sites at Vercel instead of GitHub Pages because Pages has
been unreliable. The host changes from
https://browserbase.github.io/stagehand-eval-sites/ to
https://stagehand-eval-sites.vercel.app/; paths under sites/ are
unchanged.
Details
get_url.ts now accepts both the old and new hosts, and lines areWritten for commit 0f51333.
Summary will update on new commits.
Merge order: browserbase/stagehand-eval-sites#81 must be merged and
live on Vercel before this PR. act/ionwave clicks a link on that page
and asserts the Vercel URL. Without #81, the link still points to GitHub
Pages and the eval fails on every model.
Disables Browserbase proxies in CI eval runs so tests use direct browser connections instead of proxied ones.
Disables Browserbase proxies in CI eval runs so tests use direct browser
connections instead of proxied ones.
Written for commit acd3b5b.
Summary will update on new commits.
Replace the externally hosted DeepWiki badge with a repository-local SVG.
The external badge endpoint returns HTTP 429 with a Vercel challenge,
consistent with the broken image in the README. Hosting the badge
locally removes that external dependency.
Replaces the externally hosted DeepWiki badge in the README with a
repository-local SVG at media/deepwiki.svg, since the hosted endpoint
returns HTTP 429 with a Vercel challenge that broke the image. The new
badge is styled to match the neighboring 32px badges, keeps the same
DeepWiki destination, and passes git diff --check and SVG XML parsing.
Written for commit c143ac1.
Summary will update on new commits.
feat(sdk-go): add Browserbase ClientOptions to launch and connect ( #3 …
feat(sdk-go): add Browserbase ClientOptions to launch and connect (#3…
Mirrored from external contributor PR #3105 after approval by @miguelg719 .
Mirrored from external contributor PR #3105 after approval by
@miguelg719.
Original author: @alanagoyal
Original PR: #3105
Approved source head SHA: b48795840bce28f4c26f48b35183bb035a1ea519
@alanagoyal, please continue any follow-up discussion on this mirrored
PR. When the external PR gets new commits, this same internal PR will be
marked stale until the latest external commit is approved and refreshed
here.
this is a first step toward #2841. today, turning a bug report into a
pinned fixture takes a manually built mirror. this adds a small recorder
so a page state can be saved locally and used in an extract() or
observe() regression.
fixture:record in packages/evals: pass a url, outputindex.html plus a manifest with the source url, capture time,before: reproduce against the live site or build a mirror by hand.
after: run setup to reach the relevant state, record it, and write an
assertion against the saved page.
this is scoped to static observations. it doesn't replay application
behavior, generate assertions, or migrate the old live-site tasks
mentioned in the issue, which aren't on current v4 main.
proposed follow ups:
stagehand.observe()the schema check validates one historical transport regression; the
synthetic checkout checks dom fidelity for the supported patterns above.
neither claims general site fidelity or model reasoning quality.
local checks:
just install, just build, just fmt, just check, and just test passed--concurrency=1 and the final just test passed usingAdds a static observation task recorder in packages/evals so
extract() and observe() regressions can run against a saved local
page instead of the live site.
task:record takes a URL, output directory, and optional Playwrightindex.html plus a manifest with source URL,observe() fidelityWritten for commit 503c421.
Summary will update on new commits.
Co-authored-by: alanagoyal alanaan@gmail.com
Co-authored-by: miguel miguelg71921@gmail.com
there is no golang sdk that applies here, so we can ignore the test that checks for a golang tab
Adjusts the SDK reference test so the Claude CUA toolset page no longer
requires a Go snippet, since that toolset has no Go SDK.
Written for commit 61e8e79.
Summary will update on new commits.
Add a Claude Toolset integration guide to the Stagehand v4 docs.
Add a Claude Toolset integration guide to the Stagehand v4 docs.
Developers need setup instructions for connecting Claude to local Chrome
or Browserbase through the published Stagehand Claude SDK packages.
npx --yes mint@4.2.788 validate: passed.npx --yes mint@4.2.788 broken-links --check-anchors --check-redirects --check-snippets: passed.npx --yes mint@4.2.788 a11y --skip-contrast: passed.git diff --check: passed.Adds a Claude Toolset integration guide to the Stagehand v4 docs,
covering setup for the published stagehand-claude-sdk packages in
TypeScript and Python.
Written for commit 82243b2.
Summary will update on new commits.
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>
[chore]: bump various transitive JS deps across monorepo
[chore]: bump various transitive JS deps across monorepo (#3115)
Mirrored from external contributor PR #2789 after approval by @charlypoly .
Mirrored from external contributor PR #2789 after approval by
@charlypoly.
Original author: @antonvishal
Original PR: #2789
Approved source head SHA: 5d32c83ec49a1d1dfb1ce40d42a74593196635bc
@antonvishal, please continue any follow-up discussion on this mirrored
PR. When the external PR gets new commits, this same internal PR will be
marked stale until the latest external commit is approved and refreshed
here.
Humans and coding agents need browser workflows they can understand,
reuse, and combine into new jobs.
These cookbooks are meant to be building blocks.
packages/cookbooks.Adds a Cookbooks tab to the docs with five runnable browser workflow
examples (persisted login, paginated catalog export, files to bucket,
form submission approval, and an AI SDK research agent), each with an
agent prompt, setup instructions, and source code. Reorganizes the
existing example projects under packages/examples/showcase so
cookbooks get their own directory, and updates the justfile,
.gitignore, and code ownership accordingly. The new just cookbook
command runs any cookbook from the repo root.
Migration
just cookbook runs cookbooks that previously lived underpackages/examples; the old just cookbook <slug> path for showcasejust showcase-script..env files for showcase examples now live inpackages/examples/showcase/.env instead of packages/examples/.env.saas-pricing-monitor example script was removed as part of theWritten for commit 40562dc.
Summary will update on new commits.
Co-authored-by: Vishal Anton vishalanton@appexert.com
Co-authored-by: VIshal Anton 166398166+antonvishal@users.noreply.github.com
Co-authored-by: Charly Poly charly@browserbase.com
Co-authored-by: Claude Opus 5.5 noreply@anthropic.com
Co-authored-by: Cursor cursoragent@cursor.com
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Nothing published for this version
chore(python): add keywords and classifiers for Pypi discoverability …
chore(python): add keywords and classifiers for Pypi discoverability …
Top-of-stack child of #2906 ( evals/consolidation-17-gemini-cua ). Review against that immediate parent, not main .
Top-of-stack child of #2906 (evals/consolidation-17-gemini-cua).
Review against that immediate parent, not main.
Port the remaining focused Codex/Stagehand facade hardening from the
experimental
Codex worktree without replacing the consolidation stack's newer shared
runtime.
This remains the existing Codex SDK harness with the Stagehand facade,
not a new
native OpenAI computer-use adapter. Preserve the parent's terminal
session-loss
semantics, shared facade API, HardBench dataset, verifier and usage
contracts.
The older experimental state/nodeRepl/reset surface and reconnect
implementation
are not copied wholesale into the newer shared runtime. The original
dirty
worktree remains untouched.
git diff --check passes.Logging remains opt-in. Logs/error artifacts may contain sensitive
model/page
content despite best-effort redaction and must be reviewed before
sharing.
Unexpected-server detection aborts observed calls; it is not a security
sandbox.
Keychain-only login is not copied into isolated profiles.
Hardens Codex facade runs with isolated HOME/CODEX_HOME profiles,
opt-in tool logging, and evidence keyed to tool-call IDs so unmatched or
unrelated calls no longer misplace screenshots.
New Features
STAGEHAND_CODEX_DIAGNOSTICS_DIR or EVAL_CODEX_DIAGNOSTICS_DIR; aHOME/CODEX_HOME creation between the SDK example@browserbasehq/stagehand-integrations-codex-sdk; only file-basedauth.json is copied, never plugins, config, stray CODEX_* env, orBug Fixes
Written for commit bdc69f2.
Summary will update on new commits.
Current open stack: #2893 → #2894 → #2902 → #2903 → #2889 → #2904 →
#2905 → #2906 → #2907.
Adds Amel Bajramovic to the contributors list in the README Acknowledgements section.
Adds Amel Bajramovic to the
contributors list in the README Acknowledgements section.
feat(eve): publish native Browserbase extension with session cleanup …
feat(eve): publish native Browserbase extension with session cleanup …
Browse 0.10.0 uploaded successfully in the Release workflow , but the following tag step saw a temporary npm 404 and returned unpublished . The job fi
Browse 0.10.0 uploaded successfully in the Release
workflow,
but the following tag step saw a temporary npm 404 and returned
unpublished. The job finished green without pushing the release tag.
Push the validated local tag that Changesets creates after a successful
upload without requiring immediate registry visibility. When no local
tag exists, retain the registry check and original version-bump commit
guard for recovery.
Validation: reproduced the failure with a real HTTP server returning 404
and a bare Git remote, then verified the fix; all 67 release tests,
tooling typecheck, targeted lint/format, and diff checks pass. The diff
changes only the helper and its existing regression test.
The current browse@0.10.0 tag has been repaired separately to the
exact commit verified in npm provenance. No npm upload or package
version change is part of this PR.
Fixes the release workflow so an existing local Browse tag is pushed
without waiting for npm registry reads to converge. Previously a
temporary 404 from npm during propagation made the tag step return
unpublished, finishing green without creating the release tag. When no
local tag exists, the registry check and the version-bump-commit guard
still run as before.
Written for commit 345a953.
Summary will update on new commits.
page.snapshot() had no timeout param, nor did some of its internal helpers. the helpers that it calls are also called by other functions in the codeba
page.snapshot() had no timeout param, nor did some of its internal
helpers. the helpers that it calls are also called by other functions in
the codebase that require timeout handling. this PR wires the progress
object through the shared downstream helpers, and also exposes a user
facing timeout param in page.snapshot()
0 keeps snapshots unlimited.capture.test.ts checks public & inherited deadlines, unlimiteddomTree.test.ts & a11yTree.test.ts check that expired reads cannotfocusSelectors.test.ts checks that both selector lookup pathsAdds an optional timeout param to page.snapshot() so callers can
bound the entire snapshot operation. Omitted timeouts now default to 20
seconds instead of running unlimited.
timeout in the TypeScript, Python, and Go SDKs; passing 0Written for commit 4054cdb.
Summary will update on new commits.
ci: restore Browse alphas for CLI changes
ci: restore Browse alphas for CLI changes (#3082)
docs(examples): add packages/examples/ for stagehand.dev/showcase (…
docs(examples): add packages/examples/ for stagehand.dev/showcase (…
[feat]: evals welcome — animated onboarding on the agent benchmarks…
[feat]: evals welcome — animated onboarding on the agent benchmarks…
[fix]: enforce screenshot & pdf deadlines across downstream steps…
[fix]: enforce screenshot & pdf deadlines across downstream steps…
One column per month.