dane-ai-mastra[bot]
d60ba71be0
chore: version - exit prerelease mode
2026-11-12 21:12:29 +00:00
Ward Peeters
b2ce66cef8
chore: run lint-staged for root files and the 16 packages without a config ( #29898 )
...
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-11-10 14:08:55 +01:00
dane-ai-mastra[bot]
6e8dfcb83f
chore: version - exit prerelease mode
2026-11-03 23:45:58 +00:00
dane-ai-mastra[bot]
77076a1012
chore: version - exit prerelease mode
2026-10-30 23:02:25 +00:00
dane-ai-mastra[bot]
2e62b365e4
chore: version packages (alpha) ( #28869 )
2026-10-29 20:09:33 +01:00
mastra-platform[bot]
ec3ba11dad
fix(stagehand): notice when Chrome is killed outside Mastra ( #28794 )
...
## Summary
If Chrome is killed outside Mastra (for example with `kill`, a crash, or
the OS ending it), the Stagehand provider never noticed. The browser
status stayed `ready`. The profile also kept `SingletonLock`,
`SingletonSocket` and `SingletonCookie`, and `Default/Preferences` kept
`exit_type: Crashed`.
The cause is that `setupCloseListener` only listened for
`Target.targetDestroyed`. When Chrome is killed, the CDP websocket dies
before any target event arrives. The only signal left is Stagehand's
`CdpConnection.onTransportClosed`.
This PR adds that listener and sends it through the existing disconnect
handler, which already ignores repeat calls. The transport also closes
when Mastra closes Stagehand itself, so the listener skips closes that
Mastra started. Stagehand reacts to a lost transport by calling `close({
force: true })`, and that call still counts as a disconnect.
Fixes #28791
## Proof
- Real Chrome 156 on Linux, `profile-lifecycle.test.ts`:
- Before the fix, `main` fails both profile configs of `manual close —
process exits, cleans up` (2 failed, 8 passed). Lock files are left
behind.
- With the fix, 10 pass and 2 are skipped.
- Full Stagehand suite with real Chrome: 124 passed, 2 skipped.
- New unit tests run in CI without Chrome:
- "treats Chrome killed outside Mastra as a disconnect": the status
becomes `closed` and the close reason is `user`.
- "does not treat its own close as an external disconnect".
- Revert checks:
- Removing the listener fails both new tests.
- Removing the own-close skip fails the second test.
- Treating `close({ force: true })` as our own close fails the first
test.
- `tsc --noEmit` is clean and oxlint reports no issues.
## Unverified
- macOS and Windows.
- Whether headed Chrome still shows the "restore pages" prompt. Only
`exit_type` was checked.
- Browserbase and `cdpUrl` sessions: a dropped connection now also marks
the browser `closed`. No local process is signalled, because remote PIDs
are never stored.
## Risk: low
The change is limited to the Stagehand close listener and reuses the
existing disconnect path. Closes that Mastra starts are unchanged.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
<!-- coderabbit-ai-generated:v1 -->
## ELI5
If Chrome stops unexpectedly, Mastra can now notice and mark the browser
as closed. This lets its existing cleanup run instead of leaving the
browser looking ready.
## Changes
- Stagehand now listens for CDP transport closure and routes it through
the existing disconnect handler.
- Intentional non-forced closes do not trigger external-disconnect
handling. A transport close after a forced close can still trigger it.
- Added unit tests for external transport closure and for transport
closure during Mastra’s own close.
- Split Stagehand tests into unit and end-to-end Vitest projects. The
end-to-end project includes only `*.e2e.test.ts` files.
- Added a changeset for `@mastra/stagehand`.
## Validation
The PR author reports 10 passes and 2 skips for the Linux real-Chrome
profile lifecycle tests, and 124 passes and 2 skips for the full
real-Chrome Stagehand suite. The author also reports that `tsc --noEmit`
and oxlint completed without issues.
macOS and Windows were not verified. The headed Chrome restore-pages
prompt was not checked. Browserbase and `cdpUrl` sessions were not
verified.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: mastra-platform[bot] <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-29 10:45:21 -07:00
dane-ai-mastra[bot]
4f12792ed1
chore: version packages (alpha) ( #28722 )
...
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-29 08:37:01 -07:00
mastra-platform[bot]
422910cb67
fix(browser): stop stale launcher logs and orphaned Chrome from breaking browser relaunch ( #28675 )
...
> Opened by @user_01KNA8J74D4RF84RXSDRX26BS9
> Opened by @user_01KNA8J74D4RF84RXSDRX26BS9
## Summary
Fixes #28664
Once the Stagehand browser had run on a profile, every later launch on
that profile could fail with `ECONNREFUSED 127.0.0.1:<port>`. Killing
Chrome didn't fix it. The only fix was deleting the profile, which also
wipes saved logins.
**Primary cause:** chrome-launcher opens `<profile>/chrome-err.log` in
append mode. It finds the DevTools port by taking the *first* `DevTools
listening on ws://…:<port>/` match in the whole file. On a reused
profile, that match is the port from the earliest launch, which is dead
by now. (Diagnosis and real-Chrome repro by @NikAiyer.)
**Secondary cause:** Mastra Code never closed the Chrome it launched. It
didn't on exit, on relaunch, or when `/browser` replaced or disabled it.
A leftover Chrome could keep holding the profile.
**Changes:**
- **`@mastra/core`** (minor, new API):
- Before launching on a local profile, a new `prepareLocalProfile()`
step checks the profile's Chrome lock.
- A stale lock is removed.
- A live holder throws the new exported `BrowserProfileInUseError`,
which names the profile and the PID.
- A live local PID that hasn't started listening on the socket yet
(Chrome creates the lock first) gets up to 3s before its lock counts as
stale.
- Only after that check passes does it delete `chrome-err.log` and
`chrome-out.log`.
- The step is skipped on Windows and for remote browsers.
- Close and disconnect only remove the lock when no Chrome is listening,
so a late close can't delete the lock of a browser that took the profile
meanwhile.
- New `MastraBrowser.retire()` closes a browser for good, so later
`ensureReady()` and `launch()` calls throw.
- New `MastraBrowser.killProcesses()` SIGKILLs the browser's process
groups.
- **`@mastra/stagehand`**: thread-scoped browsers also run
`prepareLocalProfile()` before each thread's Chrome starts, when the
installed core has it. The core peer range stays `>=1.80.0-0`; on 1.80.0
Stagehand behaves as before instead of throwing.
- **`mastracode`**:
- It retires the active browser on exit, on relaunch, and when
`/browser` replaces or disables it. If the retire fails or takes longer
than 5s, it kills the browser's processes.
- A generation guard stops a `/browser` call that lost a race from
attaching its browser or saving settings.
## Proof
- Core `browser.test.ts`: 36/36 pass. Each of these fails when its fix
is removed:
- relaunch reading the second port
- stale logs cleared before `doLaunch()`
- stale lock and live holder handling, including a SIGKILLed holder that
left its socket behind (`ECONNREFUSED`)
- a live holder that starts listening 300ms after locking is treated as
holding the profile
- a late close leaving the new holder's lock alone
- retire blocking a relaunch that is already waiting in `ensureReady()`
- `killProcesses()` is tested against a real detached process group.
- Stagehand unit tests: 70/70 pass. The thread-scope profile-prep test
and the "core without `prepareLocalProfile()`" test each fail without
their change.
- `mastracode/tui` `/browser` and lifecycle tests: 56/56 pass. The race,
close-order and kill-on-hang tests each fail when their fix is removed.
- @NikAiyer ran real Chrome on macOS at `0204188b ` and `ff7acb14 `,
including the real `~/.mastracode/browser-profile-stagehand` profile:
open → close → reopen works and keeps saved cookies; released Mastra
Code fails it with `ECONNREFUSED`.
- `tsc --noEmit` is clean for core, stagehand and mastracode/tui. oxlint
and the peer-dep validator are clean.
## Unverified
- Lock behaviour on Windows and Linux. Real Chrome was only run on
macOS.
- The 3s startup window has not been run against real Chrome.
- Two Stagehand `manual close` e2e cases fail on `hasLockFiles`. They
fail the same way on base.
- A lock from a different hostname is treated as stale.
## Risk
**Low.** Only two launcher log files are deleted, and only when we're
about to launch Chrome on that profile and no live browser holds it.
Lock files are removed only when nothing accepts connections on the
singleton socket. Remote browsers are untouched. Retiring and killing
only affect browsers Mastra Code is replacing or shutting down.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
<!-- coderabbit-ai-generated:v1 -->
## ELI5
Old Chrome files or a Chrome process that still uses a browser profile
can stop a new browser from starting. This change removes stale files,
reports when a profile is still in use, and closes browsers that Mastra
Code replaces or shuts down.
## What changed
- Before launching with a local profile, core checks for a live Chrome
lock. On non-Windows systems, it removes stale lock files and clears
Chrome launcher logs without deleting the profile. If a browser is using
the profile, it throws `BrowserProfileInUseError` with the profile path
and available process details. Core waits up to three seconds for a live
local lock holder to start listening.
- `MastraBrowser.retire()` closes a browser and prevents it from
launching again. `killProcesses()` force-stops tracked browser processes
where supported. Core uses these APIs during close and retirement.
- Stagehand prepares local profiles before thread-scoped browser
creation. It does not prepare profiles for Browserbase or CDP
connections. The Stagehand peer dependency requires `@mastra/core
>=1.81.0-0`; the code-sdk changeset also requires core 1.81.0 or later.
- Mastra Code closes browsers on shutdown, replacement, and disable.
Generation checks prevent superseded commands from attaching a browser
or saving settings. Replacements wait for earlier closes. If retirement
fails or takes more than five seconds, Mastra Code calls
`killProcesses()`.
- Tests cover profile-lock recovery, profile reuse, browser retirement
and process cleanup, Stagehand thread-scoped preparation, and
overlapping browser commands.
## Validation
The PR reports 36/36 core browser tests, 70/70 Stagehand unit tests, and
56/56 Mastra Code TUI browser and lifecycle tests passing. It also
reports clean TypeScript, oxlint, and peer-dependency checks, plus
real-Chrome testing on macOS. Windows and Linux lock behavior and the
three-second startup window were not verified with real Chrome. Two
Stagehand manual-close end-to-end cases fail on this branch and on the
base branch.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: mastra-platform[bot] <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-28 21:20:15 -07:00
mastra-platform[bot]
1be23784ae
Revert Stagehand v4 bump in @mastra/stagehand ( #28778 )
...
## Summary
Reverts #28586 , which moved `@mastra/stagehand` from
`@browserbasehq/stagehand` `^3.7.3` to `^4.3.0` without changing any
code. Stagehand v4 removed `new Stagehand(...)` and `init()`, and
`stagehand-browser.ts` still calls both, so the provider can't open a
browser on v4. The full v4 migration is tracked in #24221 .
The revert also deletes #28586 's changeset, so the bump stays out of the
next release. Already-published versions are unaffected:
`@mastra/stagehand@0.3.7` (latest) and `0.3.7-alpha.1` both depend on
`^3.7.3`.
The lockfile was regenerated with `pnpm install --lockfile-only` and not
hand-merged, because main's lockfile has changed since #28586 .
## Proof
- `browser/stagehand` unit tests on main (v4): 20 failed / 96 passed.
With this revert (v3.7.3): 108 passed. The only 8 failures are e2e
`profile-lifecycle` tests that need `CHROME_PATH`, which this sandbox
doesn't have.
- `tsc --noEmit` in `browser/stagehand`: clean.
- The lockfile contains no `@browserbasehq/stagehand@4` entries.
## Unverified
- The real-Chrome e2e suite was not run, because no Chrome is available
in the sandbox.
## Risk: low
This restores the dependency version and lockfile entries that shipped
in 0.3.7.
Co-authored-by: mastra-platform[bot] <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-28 19:39:11 -07:00
Caleb Barnes
780ef82390
feat(browser): add setCookies() to every browser provider ( #28631 )
...
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-28 18:29:19 -07:00
Caleb Barnes
cd1fcad126
feat(agent-browser): save browser screenshots into the workspace ( #28636 )
...
## Summary
`browser_screenshot` returns the image to the model, but never as a
file. When an agent wanted to share or attach a screenshot, it had no
file to point at, so agents worked around it by installing their own
browser in the sandbox just to capture a PNG.
`browser_screenshot` now takes an optional `path`. With it, the PNG is
also written to that path in the agent's workspace (missing folders are
created), and the tool result says where it was saved. If it can't be
saved (for example, the agent has no workspace), the screenshot is still
returned and the result says why.
## Test plan
- New `screenshot.test.ts` uses a real `Workspace` with a
`LocalFilesystem`: the PNG lands at the given path with folders created,
the model is told where the file went, nothing is written without
`path`, and when there's no workspace or the write fails the model still
gets the image plus the reason. Removing the feature fails the save
tests; dropping the image on a failed save fails both failure tests.
- `browser_screenshot` reference docs list the new `path` option.
- `@mastra/agent-browser` suite: 14 files, 233 tests pass.
- In a Factory session, the agent called `browser_screenshot` with a
path and attached the saved file to Slack, with no browser install in
the sandbox.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
<!-- coderabbit-ai-generated:v1 -->
## ELI5
`browser_screenshot` can now save a screenshot as a PNG in the agent’s
workspace. If it cannot save the file, it still returns the screenshot
and explains why.
## Changes
- Added an optional, non-empty `path` parameter to `browser_screenshot`.
- When `path` is set and the screenshot includes image data, the tool
resolves the workspace filesystem for the request when available. It
falls back to the static filesystem for compatibility.
- The tool creates missing folders and checks workspace write settings
before saving. It passes `{ path, overwrite: true }` to those checks.
- On success, the tool reports the saved path. If saving is unavailable
or fails, it reports the reason and still returns the image.
- Updated the reference documentation and added tests for saving,
filesystem resolution, no-path behavior, write restrictions, and error
handling.
Test execution results and review finding counts were not provided.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
---------
Co-authored-by: CalebBarnes <CalebBarnes@users.noreply.github.com>
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-28 15:56:04 -07:00
Dane - AI (Mastra)
58bcad2677
chore(deps): update dependency @browserbasehq/stagehand to v4 ( #28586 )
...
This PR contains the following updates:
| Package | Type | Update | Change |
|---|---|---|---|
| [@browserbasehq/stagehand](https://stagehand.dev )
([source](https://redirect.github.com/browserbase/stagehand/tree/HEAD/packages/sdk-ts ))
| dependencies | major | [`^3.7.3` →
`^4.3.0`](https://renovatebot.com/diffs/npm/@browserbasehq%2fstagehand/3.7.3/4.3.0 )
|
---
> [!WARNING]
> Some dependencies could not be looked up. Check the [Dependency
Dashboard](../issues/9505) for more information.
---
### Release Notes
<details>
<summary>browserbase/stagehand
(@​browserbasehq/stagehand)</summary>
###
[`v4.3.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-430 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.2.1...@browserbasehq/stagehand@4.3.0 )
##### Minor Changes
-
[#​3267](https://redirect.github.com/browserbase/stagehand/pull/3267 )
[`cb9a1d1`](cb9a1d178f )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add extension archive getter
-
[#​3253](https://redirect.github.com/browserbase/stagehand/pull/3253 )
[`6bf4146`](6bf4146508 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add optional `extensionCdpUrl` to `localBrowser.connect` to allow
configuring the in-browser CDP url
-
[#​3263](https://redirect.github.com/browserbase/stagehand/pull/3263 )
[`ecb2a6b`](ecb2a6b55c )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add `headers` to `localBrowser.connect` so CDP gateways can be
authenticated without credentials in the URL
-
[#​3183](https://redirect.github.com/browserbase/stagehand/pull/3183 )
[`901eb27`](901eb27642 )
Thanks
[@​supremeboxlogos](https://redirect.github.com/supremeboxlogos )!
- Add `page.waitForFunction()` to wait until a predicate in the page
returns a truthy value.
##### Patch Changes
-
[#​3229](https://redirect.github.com/browserbase/stagehand/pull/3229 )
[`c6b6f27`](c6b6f278c8 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
skip caching for request bodies larger than 25 MB.
-
[#​3198](https://redirect.github.com/browserbase/stagehand/pull/3198 )
[`10418f9`](10418f9883 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
enable WebMCP by default for local chromium versions newer than 157
-
[#​3210](https://redirect.github.com/browserbase/stagehand/pull/3210 )
[`1c40ba7`](1c40ba7176 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Require client transport for Browserbase Model Gateway and cache
requests.
-
[#​3209](https://redirect.github.com/browserbase/stagehand/pull/3209 )
[`17de6ea`](17de6eaac2 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Route Browserbase Model Gateway and cache requests through the connected
SDK.
###
[`v4.2.1`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-421 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.2.0...@browserbasehq/stagehand@4.2.1 )
##### Patch Changes
-
[#​3157](https://redirect.github.com/browserbase/stagehand/pull/3157 )
[`bfeda48`](bfeda48235 )
Thanks
[@​github-actions](https://redirect.github.com/apps/github-actions )!
- Accept new model IDs for supported providers without a Stagehand
release. Reject empty or whitespace-containing IDs and let providers
report model availability.
###
[`v4.2.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-420 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.1.0...@browserbasehq/stagehand@4.2.0 )
##### Minor Changes
-
[#​3030](https://redirect.github.com/browserbase/stagehand/pull/3030 )
[`34edfa3`](34edfa38d6 )
Thanks
[@​supremeboxlogos](https://redirect.github.com/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](https://redirect.github.com/browserbase/stagehand/pull/3118 )
[`a837acf`](a837acfe3f )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add `clientOptions` to `browserbase.launch()` and
`browserbase.connect()`. Thanks to
[@​pr1m8](https://redirect.github.com/pr1m8 ) for the original
proposal that motivated this feature.
-
[#​3083](https://redirect.github.com/browserbase/stagehand/pull/3083 )
[`666b6fa`](666b6fa32b )
Thanks
[@​seanmcguire12](https://redirect.github.com/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](https://redirect.github.com/browserbase/stagehand/pull/3140 )
[`f2060a6`](f2060a689d )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
automatically discover Stagehand extensions when connecting to browsers.
deprecate & ignore extension IDs passed into .connect().
-
[#​2916](https://redirect.github.com/browserbase/stagehand/pull/2916 )
[`476658b`](476658b595 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add page level hooks for webmcp tools added and webmcp tools removed
events.
##### Patch Changes
-
[#​3045](https://redirect.github.com/browserbase/stagehand/pull/3045 )
[`4da1a21`](4da1a21398 )
Thanks
[@​github-actions](https://redirect.github.com/apps/github-actions )!
- Keep telemetry disabled unless an OTLP traces endpoint is explicitly
configured.
-
[#​2893](https://redirect.github.com/browserbase/stagehand/pull/2893 )
[`5802f59`](5802f59ab6 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Bound experimental batch and RPC deadlines so callers can stop waiting
without replaying actions or accepting late capture state.
-
[#​2894](https://redirect.github.com/browserbase/stagehand/pull/2894 )
[`819db28`](819db2896e )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add configurable bounded CDP heartbeats and sanitized disconnect
diagnostics with cleanup on shutdown.
-
[#​2892](https://redirect.github.com/browserbase/stagehand/pull/2892 )
[`0210688`](0210688866 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Release a newly created Browserbase session when initial attachment
fails, and support upload retries
-
[#​2978](https://redirect.github.com/browserbase/stagehand/pull/2978 )
[`f3543d3`](f3543d321e )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Fix locator failures when entering loading iframes, and correctly target
iframe elements when an XPath ends at the iframe.
-
[#​3033](https://redirect.github.com/browserbase/stagehand/pull/3033 )
[`1562d35`](1562d35062 )
Thanks
[@​seanmcguire12](https://redirect.github.com/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](https://redirect.github.com/browserbase/stagehand/pull/3146 )
[`7d8dcef`](7d8dcef876 )
Thanks
[@​seanmcguire12](https://redirect.github.com/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](https://redirect.github.com/browserbase/stagehand/pull/3052 )
[`70f4e91`](70f4e91f19 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Match native XPath semantics for `text()` predicates when a shadow root
routes locators through the composed-tree parser
###
[`v4.1.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-410 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.0.3...@browserbasehq/stagehand@4.1.0 )
##### Minor Changes
-
[#​2828](https://redirect.github.com/browserbase/stagehand/pull/2828 )
[`e2c8946`](e2c8946eef )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Expose Browserbase Search and Fetch through the Stagehand browserbase
facade in TypeScript, Python, and Go.
##### Patch Changes
-
[#​2827](https://redirect.github.com/browserbase/stagehand/pull/2827 )
[`6555e81`](6555e81e83 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
make browser.close() and browser.context.close() always terminate the
browser regardless of keepAlive.
-
[#​2878](https://redirect.github.com/browserbase/stagehand/pull/2878 )
[`50146e4`](50146e426b )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
support discovering and invoking WebMCP tools in out-of-process iframes
(OOPIFs)
-
[#​2912](https://redirect.github.com/browserbase/stagehand/pull/2912 )
[`67a4668`](67a46682bf )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Fail fast on protocol compatibility errors
-
[#​2790](https://redirect.github.com/browserbase/stagehand/pull/2790 )
[`1011177`](1011177a31 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
fail fast on browserbase.connect() when extension is not present
-
[#​2818](https://redirect.github.com/browserbase/stagehand/pull/2818 )
[`341433a`](341433acac )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
make stagehand.close() preserve the browser and allow another Stagehand
instance to attach later
-
[#​2754](https://redirect.github.com/browserbase/stagehand/pull/2754 )
[`a21633d`](a21633d539 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! -
remove the redundant image type from page screenshot protocol responses.
###
[`v4.0.3`](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.0.2...@browserbasehq/stagehand@4.0.3 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.0.2...@browserbasehq/stagehand@4.0.3 )
###
[`v4.0.2`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-402 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.0.1...@browserbasehq/stagehand@4.0.2 )
##### Patch Changes
-
[#​2752](https://redirect.github.com/browserbase/stagehand/pull/2752 )
[`c0a2734`](c0a2734c46 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! - Allow
SDK clients to reattach to an initialized Stagehand extension runtime.
###
[`v4.0.1`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-401 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@4.0.0...@browserbasehq/stagehand@4.0.1 )
##### Patch Changes
-
[#​2666](https://redirect.github.com/browserbase/stagehand/pull/2666 )
[`00fc44c`](00fc44c2bd )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Allow overriding the extension asset locations via
`STAGEHAND_EXTENSION_ARCHIVE_PATH` and
`STAGEHAND_EXTENSION_DIRECTORY_PATH`
-
[#​2691](https://redirect.github.com/browserbase/stagehand/pull/2691 )
[`7e09557`](7e09557a6d )
Thanks [@​shrey150](https://redirect.github.com/shrey150 )! - Track
the Stagehand SDK version in Browserbase session metadata.
###
[`v4.0.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#TypeScript-SDK-400 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.7.3...@browserbasehq/stagehand@4.0.0 )
##### Major Changes
- Rebuilt Stagehand around its v4 browser protocol and TypeScript SDK.
Stagehand is now a protocol-first monorepo with TypeScript, Python, and
Go SDKs over a shared core.
Check the [migration guide](https://docs.stagehand.dev/v4/migrations/v3 )
for upgrading from v3.
</details>
---
### Configuration
📅 **Schedule**: (UTC)
- Branch creation
- "before 6am every weekday"
- Automerge
- At any time (no schedule defined)
🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.
♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.
🔕 **Ignore**: Close this PR and you won't be reminded about this update
again.
---
- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box
---
This PR has been generated by [Mend Renovate
CLI](https://redirect.github.com/renovatebot/renovate ).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4xODguMCIsInVwZGF0ZWRJblZlciI6IjQ0LjE4OC4wIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJhdXRvbWF0aW9uIl19-->
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-10-28 19:25:37 +00:00
dane-ai-mastra[bot]
6a191d46dc
chore: version - exit prerelease mode
2026-10-28 13:15:52 +00:00
Damien Schneider
976fde7416
refactor(lint): enable no-else-return at root ( #28601 )
...
Enables `no-else-return: error` in the root Oxlint config and removes
186 redundant `else` branches across 111 source/test files. Existing
rule defaults are retained.
Reviewed every code diff for behavior preservation. An independent
TypeScript AST comparison confirms that changes are limited to removing
`else` after returning branches, with the same expressions, statement
order, return values, and `try`/`catch`/`finally` boundaries. All
181,158 identifier occurrences retain their bindings. The recorder
replay path keeps an explicit block: flattening it would shadow the
earlier request `body` with the response `body` and introduce a
temporal-dead-zone error.
Extends the existing monorepo optimized-dependency test to assert that a
raw TypeScript workspace package, including its enum and transitive
dependency, still executes in the production bundle.
Validation: the root rule-only scan passes on 15,273 files with zero
diagnostics; formatting and `git diff --check` pass. Schema
compatibility tests: 1,060 passed, 9 skipped. Recorder runtime tests: 21
passed. The core selection initially passed 3,513 tests; rerunning the
suites requiring local server/cache access passed 185 tests, with one
remaining cache-file assertion also reproduced on unchanged `main`.
Remaining validation limits: four asset-download cases cannot reach
`placehold.co`; the changed-file lint run reports six import-order
errors reproduced on unchanged files from `main`. Deployer unit tests
and the monorepo test could not run because this checkout lacks required
package dependencies (`fs-extra`/workspace links and `get-port`,
respectively). These limits are left visible for CI. No changeset is
included because this is a behavior-preserving lint cleanup.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
<!-- coderabbit-ai-generated:v1 -->
## ELI5
This PR makes the code easier to read by removing `else` branches that
are not needed after a return. It also enables a rule that catches those
branches and adds a test for loading a raw TypeScript workspace package
in a production bundle.
## Summary
- Enables Oxlint’s `no-else-return` rule at error severity and removes
186 redundant `else` branches across 111 files.
- Extends the monorepo optimized-dependencies test to check a raw
TypeScript workspace package, its enum, and a transitive dependency.
- Updates the deployer’s transpile-package path pattern.
- In workflow event processing, a truthy branch index with no matching
child now falls through to publish a skipped-step end event. Previously,
this case published no event.
- Keeps the recorder replay block explicit to avoid request/response
`body` shadowing and a temporal-dead-zone error.
## Validation
Reported checks passed: the rule-only scan across 15,273 files,
formatting, `git diff --check`, schema compatibility tests (1,060
passed, 9 skipped), recorder runtime tests (21 passed), and an initial
core test selection (3,513 passed).
Some test limits remain. Four asset-download cases could not reach
`placehold.co`. Changed-file lint reported six import-order errors that
also occur on unchanged files from `main`. Deployer unit tests and the
monorepo test could not run because dependencies were unavailable. On
rerun, suites requiring local server/cache access had 185 passes; one
cache-file assertion also reproduced on unchanged `main`.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-10-28 12:30:27 +01:00
dane-ai-mastra[bot]
2c646b53d0
chore: version packages (alpha) ( #28399 )
...
This PR was opened by the [Changesets
release](https://github.com/changesets/action ) GitHub action. When
you're ready to do a release, you can merge this and publish to npm
yourself or [setup this action to publish
automatically](https://github.com/changesets/action#with-publishing ). 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.
⚠️ ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
`main` is currently in **pre mode** so this branch has prereleases
rather than normal releases. If you want to exit prereleases, run
`changeset pre exit` on `main`.
⚠️ ⚠️ ⚠️ ⚠️ ⚠️ ⚠️
# Releases
> The changelog information of each package has been omitted from this
message, as the content exceeds the size limit.
## @mastra/factory@0.25.0-alpha.5
## @mastra/langsmith@1.4.0-alpha.2
## @mastra/connect@1.2.0-alpha.2
## @mastra/core@1.80.0-alpha.4
## @mastra/playground-ui@66.0.0-alpha.4
## @mastra/acp@0.4.4-alpha.0
## @mastra/claude@0.3.4-alpha.0
## @mastra/cursor@0.3.4-alpha.0
## @mastra/openai@1.1.4-alpha.0
## @mastra/auth-auth0@1.2.6-alpha.0
## @mastra/auth-better-auth@1.1.9-alpha.0
## @mastra/auth-clerk@1.3.2-alpha.0
## @mastra/auth-cloud@1.2.8-alpha.0
## @mastra/auth-firebase@1.1.5-alpha.0
## @mastra/auth-google@0.1.7-alpha.0
## @mastra/auth-neon@0.3.5-alpha.0
## @mastra/auth-okta@0.2.6-alpha.0
## @mastra/auth-studio@1.3.11-alpha.1
## @mastra/auth-supabase@1.1.6-alpha.0
## @mastra/auth-workos@1.6.8-alpha.0
## @mastra/agent-browser@0.5.5-alpha.0
## @mastra/browser-viewer@0.2.6-alpha.0
## @mastra/browser-firecrawl@0.2.5-alpha.1
## @mastra/stagehand@0.3.7-alpha.1
## @mastra/discord@1.3.2-alpha.0
## @mastra/slack@1.8.0-alpha.1
## @mastra/teams@0.1.3-alpha.0
## @mastra/telegram@0.2.4-alpha.0
## @mastra/client-js@1.57.0-alpha.4
## @mastra/react@1.13.0-alpha.4
## @mastra/isolated-vm@0.1.4-alpha.0
## @mastra/quickjs@0.1.5-alpha.0
## @mastra/deployer-cloud@1.80.0-alpha.4
## @mastra/deployer-cloudflare@1.2.39-alpha.1
## @mastra/deployer-netlify@1.2.39-alpha.1
## @mastra/deployer-sandbox@0.3.24-alpha.1
## @mastra/deployer-vercel@1.2.39-alpha.1
## @mastra/voyageai@0.4.3-alpha.0
## @mastra/longmemeval@1.1.39-alpha.4
## @mastra/livekit@0.5.2-alpha.0
## @mastra/opencode@0.1.39-alpha.4
## @mastra/parallel@0.1.4-alpha.0
## create-factory@0.3.1-alpha.4
## @mastra/code-sdk@1.15.1-alpha.5
## mastracode@0.48.1-alpha.4
## @mastra/arize@1.3.27-alpha.2
## @mastra/arthur@0.4.27-alpha.2
## @mastra/braintrust@1.3.24-alpha.2
## @mastra/datadog@1.4.19-alpha.2
## @mastra/deepeval@0.1.21-alpha.2
## @mastra/laminar@1.3.29-alpha.2
## @mastra/langfuse@1.6.3-alpha.2
## @mastra/observability@1.21.1-alpha.2
## @mastra/otel-bridge@1.5.19-alpha.2
## @mastra/otel-exporter@1.4.10-alpha.2
## @mastra/posthog@1.4.4-alpha.2
## @mastra/sentry@1.2.29-alpha.2
## @mastra/agent-builder@1.1.31-alpha.2
## @mastra/auth@1.1.5-alpha.0
## mastra@1.36.0-alpha.4
## @mastra/codemod@1.1.8-alpha.0
## create-mastra@1.36.0-alpha.4
## @mastra/deployer@1.80.0-alpha.4
## @mastra/editor@0.16.5-alpha.2
## @mastra/evals@1.10.9-alpha.0
## @mastra/fastembed@1.3.5-alpha.2
## @mastra/loggers@1.3.10-alpha.1
## @mastra/mcp@2.6.0-alpha.1
## @mastra/mcp-docs-server@1.3.10-alpha.7
## @mastra/mcp-registry-registry@1.1.7-alpha.0
## @mastra/memory@1.39.1-alpha.2
## @mastra/rag@2.7.1-alpha.0
## @mastra/schema-compat@1.3.17-alpha.0
## @mastra/server@1.80.0-alpha.4
## @mastra/google-cloud-pubsub@1.1.5-alpha.1
## @mastra/redis-streams@0.6.5-alpha.1
## @mastra/valkey-streams@0.5.7-alpha.1
## @mastra/elysia@0.1.20-alpha.4
## @mastra/express@1.5.24-alpha.4
## @mastra/fastify@1.5.24-alpha.4
## @mastra/hono@1.7.22-alpha.4
## @mastra/koa@1.7.24-alpha.4
## @mastra/nestjs@0.2.39-alpha.4
## @mastra/next@0.2.38-alpha.4
## @mastra/server-adapters-test-suite@0.1.4-alpha.2
## @mastra/tanstack-start@0.2.38-alpha.4
## @mastra/astra@1.1.3-alpha.0
## @mastra/azure-ai-search@0.1.2-alpha.1
## @mastra/chroma@1.1.5-alpha.0
## @mastra/clickhouse@1.27.0-alpha.1
## @mastra/cloudflare@1.7.6-alpha.0
## @mastra/cloudflare-d1@1.4.5-alpha.1
## @mastra/convex@1.7.6-alpha.0
## @mastra/couchbase@1.1.4-alpha.1
## @mastra/dsql@1.5.5-alpha.0
## @mastra/duckdb@1.16.0-alpha.1
## @mastra/dynamodb@1.4.5-alpha.1
## @mastra/elasticsearch@1.4.6-alpha.1
## @mastra/lance@1.5.2-alpha.1
## @mastra/libsql@1.27.1-alpha.0
## @mastra/mongodb@1.24.1-alpha.1
## @mastra/mssql@1.10.6-alpha.0
## @mastra/mysql@0.14.1-alpha.0
## @mastra/opensearch@1.1.4-alpha.1
## @mastra/oracledb@0.5.5-alpha.0
## @mastra/pg@1.33.0-alpha.2
## @mastra/pinecone@1.1.3-alpha.0
## @mastra/qdrant@1.1.6-alpha.0
## @mastra/redis@1.4.12-alpha.1
## @mastra/s3vectors@1.1.5-alpha.0
## @mastra/spanner@1.10.1-alpha.1
## @mastra/turbopuffer@1.2.3-alpha.0
## @mastra/turso@0.1.18-alpha.0
## @mastra/upstash@1.5.5-alpha.1
## @mastra/valkey@0.2.8-alpha.1
## @mastra/vectorize@1.1.4-alpha.0
## @mastra/weaviate@0.1.4-alpha.0
## @mastra/voice-aws-nova-sonic@0.2.6-alpha.0
## @mastra/voice-azure@0.12.3-alpha.0
## @mastra/voice-cloudflare@0.13.4-alpha.0
## @mastra/voice-deepgram@0.13.3-alpha.0
## @mastra/voice-elevenlabs@0.13.3-alpha.0
## @mastra/voice-gladia@0.13.3-alpha.0
## @mastra/voice-google@0.14.4-alpha.0
## @mastra/voice-google-gemini-live@0.14.18-alpha.0
## @mastra/voice-inworld@0.4.6-alpha.0
## @mastra/voice-mistral@0.1.3-alpha.0
## @mastra/voice-modelslab@0.2.3-alpha.0
## @mastra/voice-murf@0.13.3-alpha.0
## @mastra/voice-openai@0.13.4-alpha.0
## @mastra/voice-openai-realtime@0.14.8-alpha.0
## @mastra/voice-playai@0.13.3-alpha.0
## @mastra/voice-sarvam@1.1.4-alpha.0
## @mastra/voice-speechify@0.14.3-alpha.0
## @mastra/voice-xai-realtime@0.2.17-alpha.0
## @mastra/inngest@1.10.8-alpha.3
## @mastra/temporal@0.4.18-alpha.4
## @mastra/agentcore@0.5.3-alpha.0
## @mastra/agentfs@0.2.3-alpha.0
## @mastra/apple-container@0.5.2-alpha.0
## @mastra/archil@0.3.2-alpha.0
## @mastra/azure@0.3.3-alpha.1
## @mastra/blaxel@0.10.2-alpha.0
## @mastra/cloudflare-sandbox@0.5.4-alpha.0
## @mastra/daytona@0.11.4-alpha.0
## @mastra/docker@0.12.1-alpha.0
## @mastra/e2b@0.15.1-alpha.1
## @mastra/e2b-desktop@0.1.10-alpha.1
## @mastra/files-sdk@0.3.3-alpha.0
## @mastra/gcs@0.3.5-alpha.1
## @mastra/google-drive@0.2.4-alpha.0
## @mastra/mesa@0.3.3-alpha.0
## @mastra/modal@0.7.3-alpha.0
## @mastra/platform-workspace@1.10.0-alpha.1
## @mastra/railway@0.10.2-alpha.1
## @mastra/s3@0.6.5-alpha.1
## @mastra/sprites@0.1.2-alpha.0
## @mastra/vercel@1.6.2-alpha.0
## @internal/playground@1.36.0-alpha.4
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-26 13:49:15 -07:00
Damien Schneider
0f82b38ed4
refactor(lint): flatten lone if statements in else branches ( #28431 )
...
Enable `no-lonely-if` in the shared Oxlint config and flatten 38 lone
`if` statements in `else` blocks across 35 files. For example, `else {
if (condition) { ... } }` becomes `else if (condition) { ... }`.
Conditions, evaluation order, statements, comments, and local bindings
are preserved. No package filters or lint exceptions are added.
Strengthen the existing monorepo test to execute another named export
from an optimized dependency. Comparisons of TypeScript syntax, emitted
JavaScript, raw template text, comments, and local bindings pass for all
35 migrated files after normalizing only the redundant else blocks. The
rule clears all 15,094 scanned files.
[CI lint and formatting
pass](https://github.com/mastra-ai/mastra/actions/runs/40344286057/job/121647174331 )
for `36ca4471f9 `. All 634 focused tests, four package typechecks (core,
playground, connect, and deployer), 57 packaged build tasks, and two
selected published-package monorepo E2E cases pass. The broader local
lint run hit a Tailwind design-system precomputation timeout; CI lint
succeeds. Live vendor and external-database suites were not run locally.
[DuckDB CI has two existing capability-list assertion
failures](https://github.com/mastra-ai/mastra/actions/runs/40344286246/job/121649643109 ):
its implementation advertises `span-aggregate`, while the expected lists
omit it. The failures reproduce locally, and the relevant implementation
and tests are unchanged from the base commit.
This maintenance PR intentionally contains no changeset and requests no
package releases. The missing-changeset check may fail.
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
<!-- coderabbit-ai-generated:v1 -->
## ELI5
This PR turns on a lint rule that asks for simpler branching in code. It
updates the affected code and adds a leap-year check to an existing
test.
## Changes
- Enables Oxlint’s `no-lonely-if` rule in the shared configuration.
- Flattens 38 lone `if` statements across 35 files. The PR description
reports that the changes preserve behavior.
- Extends the optimized-dependency monorepo test to check `isLeapYear`.
## Validation
- The PR description reports that CI lint and formatting pass.
- It also reports 634 focused tests, four package typechecks, 57
packaged build tasks, and two selected monorepo E2E cases pass.
- The PR description notes two existing DuckDB CI capability-list
assertion failures. It reports that the related implementation and tests
are unchanged from the base commit.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-10-26 18:44:48 +01:00
Ward Peeters
ce5d4731ee
chore(deps): update dependencies across the monorepo ( #28417 )
...
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-26 16:59:30 +01:00
dane-ai-mastra[bot]
dacb190944
chore: version packages (alpha) ( #28009 )
...
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-10-23 13:57:18 +02:00
Dane - AI (Mastra)
40a522c142
chore(deps): update build tools ( #27997 )
2026-10-22 14:33:21 +02:00
Ward Peeters
6338514d87
fix: repair test failures surfaced by the full release-PR test run ( #28116 )
...
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-22 13:15:26 +02:00
Dane - AI (Mastra)
1812ec9fa7
chore(deps): update browser automation ( #27996 )
...
> [!NOTE]
> This PR body was truncated due to platform limits.
This PR contains the following updates:
| Package | Type | Update | Change | Pending |
|---|---|---|---|---|
| [@browserbasehq/stagehand](https://stagehand.dev )
([source](https://redirect.github.com/browserbase/stagehand/tree/HEAD/packages/sdk-ts ))
| dependencies | minor | [`^3.2.1` →
`^3.7.3`](https://renovatebot.com/diffs/npm/@browserbasehq%2fstagehand/3.3.0/3.7.3 )
| |
| [agent-browser](https://agent-browser.dev )
([source](https://redirect.github.com/vercel-labs/agent-browser )) |
devDependencies | minor | [`0.19.0` →
`0.39.1`](https://renovatebot.com/diffs/npm/agent-browser/0.19.0/0.39.1 )
| |
| [agent-browser](https://agent-browser.dev )
([source](https://redirect.github.com/vercel-labs/agent-browser )) |
dependencies | minor | [`0.19.0` →
`0.39.1`](https://renovatebot.com/diffs/npm/agent-browser/0.19.0/0.39.1 )
| |
| [firecrawl](https://redirect.github.com/firecrawl/firecrawl ) |
dependencies | minor | [`^4.18.4` →
`^4.46.0`](https://renovatebot.com/diffs/npm/firecrawl/4.25.1/4.46.0 ) |
`4.50.0` (+5) |
---
> [!WARNING]
> Some dependencies could not be looked up. Check the [Dependency
Dashboard](../issues/9505) for more information.
---
### Release Notes
<details>
<summary>browserbase/stagehand
(@​browserbasehq/stagehand)</summary>
###
[`v3.7.3`](https://redirect.github.com/browserbase/stagehand/releases/tag/%40browserbasehq/stagehand%403.7.3 )
##### Patch Changes
-
[#​2842](https://redirect.github.com/browserbase/stagehand/pull/2842 )
[`f86e609`](f86e609b93 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
update the MCP SDK to v1.30 and refresh supporting dependency versions
-
[#​2836](https://redirect.github.com/browserbase/stagehand/pull/2836 )
[`94a0ee4`](94a0ee4e19 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
fix cross-frame xpaths building logic for coordinates inside of iframes.
###
[`v3.7.1`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#371 )
##### Patch Changes
-
[#​2359](https://redirect.github.com/browserbase/stagehand/pull/2359 )
[`2cd1edf`](2cd1edf49e )
Thanks [@​shrey150](https://redirect.github.com/shrey150 )! -
Remove the noisy AI SDK "system message in messages" warning from
`act()`, `extract()`, and `observe()` (including when the agent's own
tools call them internally).
-
[#​2347](https://redirect.github.com/browserbase/stagehand/pull/2347 )
[`84197d8`](84197d8cba )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Allow OpenAI-compatible models to select the Chat Completions API with
`openaiEndpointFormat: "chat"`
###
[`v3.7.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#370 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.6.0...@browserbasehq/stagehand@3.7.0 )
##### Minor Changes
-
[#​2283](https://redirect.github.com/browserbase/stagehand/pull/2283 )
[`871ca7e`](871ca7e305 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add `context.setDomainPolicy({ allowedDomains: ["allowed.domain"] })`
which allows users to define a set of domains that are accessible to
stagehand
-
[#​2274](https://redirect.github.com/browserbase/stagehand/pull/2274 )
[`f31980f`](f31980f37a )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add `context.setDomainPolicy({blockedDomains: ["some.domain"]})` which
allows users to define a list of domains that will be blocked by
stagehand
##### Patch Changes
-
[#​2305](https://redirect.github.com/browserbase/stagehand/pull/2305 )
[`cd1daad`](cd1daad7f7 )
Thanks [@​shrey150](https://redirect.github.com/shrey150 )! -
Remove the noisy AI SDK "system message in messages" warning logged on
every hybrid/DOM `agent.execute()` call.
-
[#​2328](https://redirect.github.com/browserbase/stagehand/pull/2328 )
[`d287ff4`](d287ff4d2c )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Allow modelName "auto" in the constructor and per-primitive model
overrides when running through the Stagehand API
-
[#​2294](https://redirect.github.com/browserbase/stagehand/pull/2294 )
[`3938590`](39385906b3 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
automatically close popups that violate user defined domain policy
-
[#​2298](https://redirect.github.com/browserbase/stagehand/pull/2298 )
[`892701a`](892701a30f )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Fix CUA `keypress` actions to press key combinations as a single chord.
-
[#​2345](https://redirect.github.com/browserbase/stagehand/pull/2345 )
[`21826c7`](21826c75ce )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! -
Repair malformed UTF-16 snapshot text before it reaches model prompts.
-
[#​2306](https://redirect.github.com/browserbase/stagehand/pull/2306 )
[`8dcef1b`](8dcef1b491 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Use the screenshot provider's declared media type when sending CUA image
payloads. The `setScreenshotProvider` callback now returns
`ScreenshotProviderResult` (`{ base64, mediaType }`) instead of a bare
base64 string.
-
[#​2273](https://redirect.github.com/browserbase/stagehand/pull/2273 )
[`93a23d3`](93a23d3adf )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add support for the new `google/gemini-3.5-flash` computer-use tools
model
-
[#​2278](https://redirect.github.com/browserbase/stagehand/pull/2278 )
[`022d68f`](022d68fc81 )
Thanks [@​shrey150](https://redirect.github.com/shrey150 )! - Fix
`TypeError: Converting circular structure to JSON` when creating an
agent with MCP `integrations` that include a `Client` instance (e.g. a
local/stdio server from `connectToMCPServer`). The agent-creation log
serialized the raw `integrations` array, and a live MCP `Client` is
circular. It now logs a safe descriptor (URL strings kept, client
instances summarized) so `agent({ integrations: [client] })` works.
-
[#​2288](https://redirect.github.com/browserbase/stagehand/pull/2288 )
[`bb5ffa6`](bb5ffa6f49 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
clean up cdp session event handlers on target detach
###
[`v3.6.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#360 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.5.0...@browserbasehq/stagehand@3.6.0 )
##### Minor Changes
-
[#​2178](https://redirect.github.com/browserbase/stagehand/pull/2178 )
[`c49a3fc`](c49a3fc47a )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add support for WebMCP
##### Patch Changes
-
[#​2217](https://redirect.github.com/browserbase/stagehand/pull/2217 )
[`147e310`](147e310b12 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! - Add
Azure OpenAI Microsoft Entra ID model auth support.
-
[#​2231](https://redirect.github.com/browserbase/stagehand/pull/2231 )
[`cf3603d`](cf3603d1c1 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add claude-fable-5 support: native structured outputs via the
[@​ai-sdk/anthropic](https://redirect.github.com/ai-sdk/anthropic )
bump, adaptive thinking (including the new "xhigh" effort) on the agent
path, the API's built-in server-side refusal fallback to
claude-opus-4-8, and auto tool choice for the final done call on models
that reject forced tool use.
-
[#​2233](https://redirect.github.com/browserbase/stagehand/pull/2233 )
[`8d7d414`](8d7d414c70 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Normalize URLs in `ActCache` key derivation by sorting query parameters
before hashing. Semantically equivalent URLs that differ only in
parameter order (e.g. `?utm_source=email&id=42` vs
`?id=42&utm_source=email`) now hit the cache instead of silently
missing. Fragments and duplicate keys are preserved.
-
[#​2229](https://redirect.github.com/browserbase/stagehand/pull/2229 )
[`fd42e65`](fd42e65bb8 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
launch local browser with
--enable-features=WebMCPTesting,DevToolsWebMCPSupport by default
-
[#​2220](https://redirect.github.com/browserbase/stagehand/pull/2220 )
[`a64c6b7`](a64c6b74cf )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! - Fix
Stagehand-generated shadow-root XPath resolution so deterministic
actions can target elements inside web components.
-
[#​2132](https://redirect.github.com/browserbase/stagehand/pull/2132 )
[`ed3e566`](ed3e56636e )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add canonical verifier evidence normalization for screenshots and text
signals without requiring image dependencies in core installs.
-
[#​2133](https://redirect.github.com/browserbase/stagehand/pull/2133 )
[`840aac8`](840aac8bfc )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add the rubric-based verifier engine with normalized public rubric
output and bounded failure-step parsing.
###
[`v3.5.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#350 )
[Compare
Source](https://redirect.github.com/browserbase/stagehand/compare/@browserbasehq/stagehand@3.4.0...@browserbasehq/stagehand@3.5.0 )
##### Minor Changes
-
[#​2149](https://redirect.github.com/browserbase/stagehand/pull/2149 )
[`6e75725`](6e75725b39 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Added a `screenshot` option to `extract()` that sends the current
viewport screenshot with the a11y tree for extraction.
-
[#​2127](https://redirect.github.com/browserbase/stagehand/pull/2127 )
[`78bcde8`](78bcde88e2 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
Add `ignoreDefaultArgs` option to selectively remove chrome-launcher's
built-in default flags (e.g. `--disable-extensions`) when running
locally
-
[#​2160](https://redirect.github.com/browserbase/stagehand/pull/2160 )
[`49575d6`](49575d62f5 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! -
Forward constructor and request model configuration when initializing
API-backed sessions.
-
[#​2171](https://redirect.github.com/browserbase/stagehand/pull/2171 )
[`dc1445d`](dc1445df80 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add native clipboard API
##### Patch Changes
-
[#​2146](https://redirect.github.com/browserbase/stagehand/pull/2146 )
[`3a53ed4`](3a53ed4ea9 )
Thanks
[@​shriyatheunicorn](https://redirect.github.com/shriyatheunicorn )!
- Pass local browser launch options through when attaching over CDP so
explicit viewport settings are respected.
-
[#​2107](https://redirect.github.com/browserbase/stagehand/pull/2107 )
[`8fc16d2`](8fc16d2e18 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Fix Anthropic CUA `triple_click` action mapping.
-
[#​2118](https://redirect.github.com/browserbase/stagehand/pull/2118 )
[`3e95a87`](3e95a8722a )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! - Add
Vertex auth parameters to the core and server API schemas.
-
[#​2126](https://redirect.github.com/browserbase/stagehand/pull/2126 )
[`ebbdcd3`](ebbdcd33cb )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
fix(core): import ToolSet from ai public export
-
[#​2120](https://redirect.github.com/browserbase/stagehand/pull/2120 )
[`12703a6`](12703a6659 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Fix structuredOutputMode for newer Anthropic models
-
[#​2170](https://redirect.github.com/browserbase/stagehand/pull/2170 )
[`1db5f1c`](1db5f1c193 )
Thanks [@​Kylejeong2](https://redirect.github.com/Kylejeong2 )! -
Add Claude Opus 4.8 to the supported CUA model whitelist.
-
[#​2116](https://redirect.github.com/browserbase/stagehand/pull/2116 )
[`cb586a1`](cb586a14e4 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
include "\[selected]" or "\[checked]" state in snapshot
-
[#​2129](https://redirect.github.com/browserbase/stagehand/pull/2129 )
[`765861c`](765861c04c )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add a backend-selectable v3 evaluator facade while preserving the legacy
evaluator path.
-
[#​2157](https://redirect.github.com/browserbase/stagehand/pull/2157 )
[`2cd60a3`](2cd60a34b0 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add verifier trajectory, rubric, and evaluation-result types with
normalized public naming.
-
[#​2131](https://redirect.github.com/browserbase/stagehand/pull/2131 )
[`e102a89`](e102a89c90 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Capture verifier trajectory evidence from agent evidence callbacks for
offline scoring.
###
[`v3.4.0`](https://redirect.github.com/browserbase/stagehand/blob/HEAD/CHANGELOG.md#340 )
##### Minor Changes
-
[#​2084](https://redirect.github.com/browserbase/stagehand/pull/2084 )
[`0641d44`](0641d44a84 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add ignoreSelectors param to extract()
-
[#​2096](https://redirect.github.com/browserbase/stagehand/pull/2096 )
[`a11603d`](a11603d09d )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
add ignoreSelectors to observe()
##### Patch Changes
-
[#​2080](https://redirect.github.com/browserbase/stagehand/pull/2080 )
[`21c78b3`](21c78b3a50 )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add variables support to v3 agentExecute API schema and remove
experimental requirement
-
[#​2077](https://redirect.github.com/browserbase/stagehand/pull/2077 )
[`f437f73`](f437f738d2 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! - Fix
frame registry handling for OOPIF pages
-
[#​2098](https://redirect.github.com/browserbase/stagehand/pull/2098 )
[`a783b99`](a783b99fb9 )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
bump transitive deps to patched versions
-
[#​2089](https://redirect.github.com/browserbase/stagehand/pull/2089 )
[`8d2f354`](8d2f354142 )
Thanks [@​shrey150](https://redirect.github.com/shrey150 )! -
Strengthen observe prompts so LLMs return complete encoded element IDs.
-
[#​2047](https://redirect.github.com/browserbase/stagehand/pull/2047 )
[`a87c1fc`](a87c1fc435 )
Thanks [@​tkattkat](https://redirect.github.com/tkattkat )! - Set
default agent mode to hybrid with auto routing to dom for non compatible
models
-
[#​2101](https://redirect.github.com/browserbase/stagehand/pull/2101 )
[`26e6c96`](26e6c960ca )
Thanks
[@​seanmcguire12](https://redirect.github.com/seanmcguire12 )! -
move playwright-core, puppeteer-core, patchright-core from optional
dependencies to peer dependencies
-
[#​2068](https://redirect.github.com/browserbase/stagehand/pull/2068 )
[`1d176c4`](1d176c466e )
Thanks
[@​filip-michalsky](https://redirect.github.com/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](https://redirect.github.com/browserbase/stagehand/pull/2040 )
[`1fa9613`](1fa96130ab )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! -
Prefer `STAGEHAND_API_URL` for Stagehand API overrides while retaining
`STAGEHAND_BASE_URL` as a deprecated fallback.
-
[#​2065](https://redirect.github.com/browserbase/stagehand/pull/2065 )
[`9ff70dd`](9ff70dd26c )
Thanks [@​miguelg719](https://redirect.github.com/miguelg719 )! -
Add support for CUA models: openai/gpt-5.4-mini, openai/gpt-5.5, and
anthropic/claude-haiku-4-5
-
[#​2039](https://redirect.github.com/browserbase/stagehand/pull/2039 )
[`7640381`](76403819b8 )
Thanks [@​monadoid](https://redirect.github.com/monadoid )! -
Deprecate Browserbase project ID configuration.
</details>
<details>
<summary>vercel-labs/agent-browser (agent-browser)</summary>
###
[`v0.39.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0391 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.39.0...v0.39.1 )
<!-- release:start -->
##### Bug Fixes
- Fixed **duplicate command execution after a lost daemon response** so
mutating and launch commands are no longer retried after any request
bytes have been sent. CLI JSON and MCP responses report
`outcome_unknown` so callers can inspect the result before retrying;
read-only commands and failures before sending retain their retries
([#​2085](https://redirect.github.com/vercel-labs/agent-browser/issues/2085 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​rotemb-wond](https://redirect.github.com/rotemb-wond )
<!-- release:end -->
###
[`v0.39.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0390 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.38.2...v0.39.0 )
##### New Features
- Added an experimental **Obscura engine** (`--engine obscura`),
launched and cleaned up locally like Chrome with bounded startup and
CLI/MCP support. Obscura still has accessibility and rendering gaps, so
review the engine page before choosing it
([#​1876](https://redirect.github.com/vercel-labs/agent-browser/issues/1876 ))
- Added **private CA trust for CLI HTTPS requests** so `read`,
`install`, `upgrade` and `doctor` work behind TLS inspection.
`--ca-cert` now applies to them on every platform, the new
`--use-system-ca` uses the operating system trust store, and
`SSL_CERT_FILE` is a fallback. Certificate verification always stays on
([#​2006](https://redirect.github.com/vercel-labs/agent-browser/issues/2006 ))
##### Bug Fixes
- Fixed **selector-scoped snapshots** (`snapshot -s`) so elements under
ignored wrappers are no longer printed twice and shadow root content of
a selected custom element is no longer dropped
([#​2043](https://redirect.github.com/vercel-labs/agent-browser/issues/2043 ))
- Fixed **`--auto-connect`** to wait up to 30s while Chrome 144+ shows
the remote-debugging prompt, so it no longer opens repeated prompts or
fails with "No running Chrome instance found"
([#​2026](https://redirect.github.com/vercel-labs/agent-browser/issues/2026 ))
- Fixed **daemon responsiveness during long commands** so it keeps
accepting connections, including `close`, while a command holds the
state lock, and a SIGTERM sent in that window is no longer lost
([#​2059](https://redirect.github.com/vercel-labs/agent-browser/issues/2059 ))
##### Documentation
- Migrated the **docs site** to Geistdocs
([#​1887](https://redirect.github.com/vercel-labs/agent-browser/issues/1887 ))
##### Contributors
- [@​NamanSatish](https://redirect.github.com/NamanSatish )
- [@​Railly](https://redirect.github.com/Railly )
- [@​SGavrl](https://redirect.github.com/SGavrl )
- [@​SUSINDRAREDDY](https://redirect.github.com/SUSINDRAREDDY )
- [@​godtail](https://redirect.github.com/godtail )
- [@​jadenfix](https://redirect.github.com/jadenfix )
- [@​niieani](https://redirect.github.com/niieani )
###
[`v0.38.2`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0382 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.38.1...v0.38.2 )
##### Bug Fixes
- Fixed **auth vault login** to pick usable controls when hidden
duplicates exist, and to bind credential entry to the selected field so
replaced fields or redirected focus are rejected before submitting
([#​2014](https://redirect.github.com/vercel-labs/agent-browser/issues/2014 ))
- Fixed **chat mode** to allow `webmcp`, `skills`, and other top-level
browser commands, so the model uses page WebMCP tools instead of falling
back to `eval`
([#​2015](https://redirect.github.com/vercel-labs/agent-browser/issues/2015 ))
- Fixed **Kernel profiles** so `KERNEL_PROFILE_NAME` sessions send the
profile as an object instead of failing with a 400, and added
`KERNEL_PROFILE_SAVE_CHANGES` to opt into saving changes back
([#​2004](https://redirect.github.com/vercel-labs/agent-browser/issues/2004 ))
- Fixed **Chrome freezing after launch** by draining its stderr for the
browser's lifetime, so a full log pipe no longer blocks the browser
([#​2003](https://redirect.github.com/vercel-labs/agent-browser/issues/2003 ))
- Fixed **Browser Use** by switching to Cloud V4, which creates,
attaches to, and stops the same browser with bounded timeouts
([#​1879](https://redirect.github.com/vercel-labs/agent-browser/issues/1879 ))
- Fixed **Vercel Sandbox shared memory detection** by measuring
`/dev/shm` capacity and adding `--disable-dev-shm-usage` below 256 MiB,
so Chrome no longer terminates renderers on the undersized mount
([#​1890](https://redirect.github.com/vercel-labs/agent-browser/issues/1890 ))
##### Improvements
- Upgraded the **eve integration** from eve 0.47.3 to 0.57.0, so apps on
eve 0.50 and later build again
([#​1945](https://redirect.github.com/vercel-labs/agent-browser/issues/1945 ))
##### Documentation
- Updated the **contact sheet example** with the loading-flash demo
output
([#​1871](https://redirect.github.com/vercel-labs/agent-browser/issues/1871 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​benjamincanac](https://redirect.github.com/benjamincanac )
- [@​boatri](https://redirect.github.com/boatri )
- [@​luxleader](https://redirect.github.com/luxleader )
- [@​petehunt](https://redirect.github.com/petehunt )
-
[@​robertjamesprior](https://redirect.github.com/robertjamesprior )
- [@​simonellefsen](https://redirect.github.com/simonellefsen )
- [@​zyz619963502zyz](https://redirect.github.com/zyz619963502zyz )
###
[`v0.38.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0381 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.38.0...v0.38.1 )
##### Bug Fixes
- Fixed **recording cursor and mouse movement timing** so cursor
rendering stays synchronized with page content during drags and timed
mouse moves
([#​1869](https://redirect.github.com/vercel-labs/agent-browser/issues/1869 ))
##### Documentation
- Added Vercel Labs product and project status badges to the README
([#​1868](https://redirect.github.com/vercel-labs/agent-browser/issues/1868 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
###
[`v0.38.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0380 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.37.1...v0.38.0 )
##### New Features
- Added **conditional screenshots** with `screenshot --if-changed` to
skip unchanged captures and `--threshold <0-1>` to tolerate small pixel
differences. Screenshot history is scoped to each tab and capture mode,
and unchanged captures omit the image path to save tokens
([#​1813](https://redirect.github.com/vercel-labs/agent-browser/issues/1813 ))
- Added **automatic snapshot deltas** with `snapshot --delta`, which
returns a full baseline followed by an unchanged revision or compact
structural changes. Use `--full` to refresh the baseline
([#​1811](https://redirect.github.com/vercel-labs/agent-browser/issues/1811 ))
- Added **persistent snapshot refs** for surviving DOM elements across
same-document changes. Replaced elements and navigated pages or iframes
invalidate their refs without recycling identifiers
([#​1812](https://redirect.github.com/vercel-labs/agent-browser/issues/1812 ))
- Added **human-like pointer movement** with session `--input-mode`,
per-action `--human` for clicks and drags, and reproducible curved
`mouse move` paths
([#​1810](https://redirect.github.com/vercel-labs/agent-browser/issues/1810 ))
- Added **recording presentation tools**: `--cursor` renders an animated
pointer and click ripple, while `--contact-sheet` saves a timestamped
PNG summary of visual changes
([#​1807](https://redirect.github.com/vercel-labs/agent-browser/issues/1807 ),
[#​1808](https://redirect.github.com/vercel-labs/agent-browser/issues/1808 ))
- Added **stateful auth vault login** with `auth login --no-navigate`,
which fills an already prepared login page after verifying its origin
against the credential URL
([#​1771](https://redirect.github.com/vercel-labs/agent-browser/issues/1771 ))
- Added **WebMCP catalog updates** to normal browser responses. Concise,
content-bounded summaries appear on initial discovery and catalog
changes, while full schemas remain opt-in
([#​1842](https://redirect.github.com/vercel-labs/agent-browser/issues/1842 ))
##### Improvements
- Improved **recording frame timing** by holding the latest Chrome frame
between repaints so the output duration follows the requested frame rate
([#​1806](https://redirect.github.com/vercel-labs/agent-browser/issues/1806 ))
##### Bug Fixes
- Fixed **CDP transport recovery and shutdown** so malformed transport
messages do not strand unrelated commands and failed initialization
disconnects cleanly
([#​1739](https://redirect.github.com/vercel-labs/agent-browser/issues/1739 ))
- Fixed **dropdown label matching** to normalize whitespace, including
non-breaking spaces, when selecting options by visible label
([#​1736](https://redirect.github.com/vercel-labs/agent-browser/issues/1736 ))
##### Documentation
- Clarified **reliable browser wait strategies** by recommending
page-specific selectors, text, URLs, or JavaScript conditions and
reserving `networkidle` for pages known to become quiet
([#​1834](https://redirect.github.com/vercel-labs/agent-browser/issues/1834 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
- [@​mauricioantolin](https://redirect.github.com/mauricioantolin )
- [@​mecampbellsoup](https://redirect.github.com/mecampbellsoup )
- [@​evrenverse](https://redirect.github.com/evrenverse )
- [@​judegao](https://redirect.github.com/judegao )
- [@​petehunt](https://redirect.github.com/petehunt )
###
[`v0.37.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0371 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.37.0...v0.37.1 )
##### Bug Fixes
- Fixed **Windows headless Chrome desktop artifacts** by isolating owned
headless Chrome on a private desktop and ensuring its process tree is
cleaned up when the daemon exits or is forcibly terminated. Headed and
externally connected browsers retain their existing desktop behavior
([#​1498](https://redirect.github.com/vercel-labs/agent-browser/issues/1498 ),
[#​1820](https://redirect.github.com/vercel-labs/agent-browser/issues/1820 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.37.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0370 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.36.0...v0.37.0 )
##### New Features
- Added **higher-quality video recording**: `record start` and `record
restart` now capture the current active page at 30 fps by default,
support `--fps 1-60`, use `Page.startScreencast` for smoother motion,
and preserve wall-clock timing. WebM and MP4 output are documented, and
`doctor` reports the ffmpeg recording dependencies
([#​1763](https://redirect.github.com/vercel-labs/agent-browser/issues/1763 ),
[#​1776](https://redirect.github.com/vercel-labs/agent-browser/issues/1776 ),
[#​1778](https://redirect.github.com/vercel-labs/agent-browser/issues/1778 ))
- Added **WebMCP availability output** so navigation responses advertise
when a page exposes allowed WebMCP tools, including availability
metadata for CLI, JSON, and MCP clients
([#​1760](https://redirect.github.com/vercel-labs/agent-browser/issues/1760 ))
- Added **session setup inheritance for new tabs**. Tabs opened with
`tab new` or through page clicks now inherit the active session's
headers, credentials, user agent, locale, timezone, geolocation, offline
mode, routes, color scheme, and init scripts before their first
navigation
([#​1777](https://redirect.github.com/vercel-labs/agent-browser/issues/1777 ))
##### Bug Fixes
- Fixed **recording startup validation** so missing ffmpeg,
extensionless output paths, and invalid recording options fail before
browser or recording state changes. Failed replacements preserve the
active take, and ffmpeg errors now include useful diagnostics
([#​1778](https://redirect.github.com/vercel-labs/agent-browser/issues/1778 ))
- Fixed **recording navigation state** so URL navigation during
recording clears stale element refs, frame scope, and page WebMCP state
like normal navigation
([#​1776](https://redirect.github.com/vercel-labs/agent-browser/issues/1776 ))
##### Contributors
- [@​jamesvclements](https://redirect.github.com/jamesvclements )
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
###
[`v0.36.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0360 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.35.2...v0.36.0 )
##### New Features
- Added experimental **WebMCP support** for discovering and invoking
tools provided by the current page, including frame-aware tool
selection, detached results, cancellation, bounded metadata and output
handling, and an opt-in MCP tool profile. WebMCP is enabled by default
for locally managed Chrome and can be disabled with `--no-webmcp` or
`AGENT_BROWSER_NO_WEBMCP`.
- Added a **WebMCP generation skill** that helps agents expose existing
page workflows as validated page tools while recording safety
constraints, deterministic checks, and fallback behavior.
##### Improvements
- Updated the **eve integration** to 0.47.3 and raised its compatibility
floor to 0.39.1.
- Updated **brace-expansion dependency resolutions** across the project
lockfiles.
##### Bug Fixes
- Removed the obsolete **Lightpanda session timeout** argument so
launches use the current supported server options.
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
- [@​anupamme](https://redirect.github.com/anupamme )
- [@​arrufat](https://redirect.github.com/arrufat )
###
[`v0.35.2`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0352 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.35.1...v0.35.2 )
##### Security
- Hardened **dashboard origin validation and reverse-proxy access** with
same-origin provenance enforcement that defends against DNS rebinding,
form/header smuggling, and cross-origin requests. Reverse-proxied
origins now require exact HTTPS allowlisting and generated token
authentication, while tokenless IPv4 and IPv6 loopback access remains
supported. Dashboard options are validated strictly, and CLI and MCP
lifecycle behavior is aligned
([#​1738](https://redirect.github.com/vercel-labs/agent-browser/issues/1738 ))
##### Bug Fixes
- Fixed **root remote CDP WebSocket URLs with query strings** to insert
the required slash before the query while preserving the encoded query
([#​1735](https://redirect.github.com/vercel-labs/agent-browser/issues/1735 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
###
[`v0.35.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0351 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.35.0...v0.35.1 )
##### Bug Fixes
- Fixed **Windows ARM64 launcher selection** to prefer a native ARM64
executable when present and fall back to the published x64 executable
through Windows emulation when it is not
([#​1725](https://redirect.github.com/vercel-labs/agent-browser/issues/1725 ))
- Fixed **stream URL tracking** to emit active main-frame URL updates
for full-document, History API, and fragment navigation, while rebinding
correctly after active-tab changes and ignoring child-frame or
background-tab navigation
([#​1682](https://redirect.github.com/vercel-labs/agent-browser/issues/1682 ))
- Fixed **snapshot diff element references** by resetting ref numbering
for each diff, invalidating refs across URL navigations, and preserving
the previous refs when a diff fails
([#​1719](https://redirect.github.com/vercel-labs/agent-browser/issues/1719 ))
##### Improvements
- Updated **Rust dependencies** to `rustls-webpki` 0.103.13 and
`quinn-proto` 0.11.17
([#​1723](https://redirect.github.com/vercel-labs/agent-browser/issues/1723 ),
[#​1720](https://redirect.github.com/vercel-labs/agent-browser/issues/1720 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
- [@​Angelmmiguel](https://redirect.github.com/Angelmmiguel )
- [@​anupamme](https://redirect.github.com/anupamme )
-
[@​nexxusbruno-ship-it](https://redirect.github.com/nexxusbruno-ship-it )
###
[`v0.35.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0350 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.34.0...v0.35.0 )
##### New Features
- Added **private proxy CA trust for locally launched Chromium on
Linux**. Use `--ca-cert <path>`, `AGENT_BROWSER_CA_CERT`, or `caCert` in
config and MCP to import a PEM bundle or DER certificate into an
isolated NSS trust store without disabling hostname, validity, or
unrelated-authority verification. The effective CA persists across
commands in a running session, equivalent certificate content reuses
Chromium, and `--no-ca-cert` explicitly clears retained trust.
Unsupported launch modes and conflicting CA options return actionable
errors
([#​1669](https://redirect.github.com/vercel-labs/agent-browser/issues/1669 ))
##### Improvements
- Added a bundled **protected Vercel deployments skill** that guides
agents through short-lived Trusted Sources OIDC authentication,
authorized automation bypasses, and explicit human handoffs for
dashboard-only configuration
([#​1705](https://redirect.github.com/vercel-labs/agent-browser/issues/1705 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​ctate](https://redirect.github.com/ctate )
- [@​bilby91](https://redirect.github.com/bilby91 )
###
[`v0.34.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0340 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.33.2...v0.34.0 )
##### New Features
- Added **persistent session-to-tab binding for shared Chrome
sessions**. Named sessions connected through `--cdp` or `--auto-connect`
now remember their CDP target across commands and daemon restarts, and
CDP target ids can be used directly as tab references. Start each
session with `--pin-tab` to make the binding strict, so a tab closed
externally returns a stable `tab_gone` error instead of silently
adopting a neighboring tab. JSON output includes `data.targetId` and an
optional sanitized `data.lastUrl`; batch exposes the same recovery data
under `result`
([#​1589](https://redirect.github.com/vercel-labs/agent-browser/issues/1589 ))
##### Improvements
- Added a **Remote Agent Browser provider guide** covering Vercel
authentication, disposable and stable sessions, custom VCR images,
snapshots, and live-view URLs
([#​1648](https://redirect.github.com/vercel-labs/agent-browser/issues/1648 ))
##### Bug Fixes
- Fixed **parallel sessions sharing one Chrome hijacking each other's
tabs**. Event-discovered targets no longer steal a pinned session's
active tab, re-attach restores the persisted target instead of selecting
index 0, and preliminary plus existing-daemon `--cdp` and
`--auto-connect` paths preserve explicit pin enable and disable. Agent
skill guidance now requires a named `--session` before the first command
([#​1589](https://redirect.github.com/vercel-labs/agent-browser/issues/1589 ))
- Fixed **`agent-browser doctor` hanging on Chrome version detection**.
Windows reads the version from the executable resource table without
spawning Chrome; other platforms bound the version subprocess with a
deadline, kill, and reap so inherited output handles cannot block
forever or leave an orphan browser
([#​1641](https://redirect.github.com/vercel-labs/agent-browser/issues/1641 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​huozhi](https://redirect.github.com/huozhi )
- [@​soichisumi](https://redirect.github.com/soichisumi )
- [@​dandaka](https://redirect.github.com/dandaka )
- [@​mvanhorn](https://redirect.github.com/mvanhorn )
###
[`v0.33.2`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0332 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.33.1...v0.33.2 )
##### New Features
- Added **input priority and per-client delivery settings** to the
stream server: each WebSocket connection now splits into a reader task
and a writer loop, so clicks and keystrokes dispatch to the browser
without queueing behind a frame write. Adds a per-client
`{"type":"config","maxFps":N}` cap (1 to 120, `0` uncapped) and opt-in
ack pacing via `{"type":"config","pacing":"ack"}` with
`{"type":"ack","seq":N}`, which keeps one frame in flight so a stalled
client never drains a backlog. Both settings can also be declared on the
connection URL (`?pacing=ack&maxFps=10`), the only way to cover the
opening frame. Every frame now carries a monotonic `seq`
([#​1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594 ))
- Added **configurable stream encoding**: frames were hardcoded to jpeg
quality 80 at the session viewport, so frame rate was the only bandwidth
lever. `AGENT_BROWSER_STREAM_QUALITY`, `AGENT_BROWSER_STREAM_MAX_WIDTH`
and `AGENT_BROWSER_STREAM_MAX_HEIGHT` are read once per daemon and cut
bytes without dropping frames: on a busy page at 1280x720, quality 20
takes a frame from 54 KB to 25 KB, and quality 20 at 640x360 takes it to
9 KB, frame rate unchanged in both. Width and height default to the
session viewport, so a larger viewport is never downscaled unless both
are set
([#​1626](https://redirect.github.com/vercel-labs/agent-browser/issues/1626 ))
##### Behavior Changes
- **Frame delivery is now latest-wins.** The stream server holds only
the newest frame and reads it at send time, so frames produced while an
earlier one is still being written are skipped. A client that assumed it
received every frame from the WebSocket now receives fewer. Nothing in
this repo consumes the stream that way, since `record` captures through
CDP and the dashboard is a viewer, so this affects external consumers
only
([#​1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594 ))
- **`metadata.timestamp` now carries a real value.** It was always 0,
because CDP sends the capture time as a float in seconds and the code
read it as an integer. It is now epoch milliseconds, so a client can
measure how stale the frame it is drawing is. A client that treated 0 as
unknown is unaffected
([#​1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594 ))
##### Bug Fixes
- Fixed **keyboard input over the stream**, which worked in none of the
three shapes the docs publish: an absent `key`, `code`, or `text`
reached CDP as an explicit null, which rejects the whole command, so
every key release and every non-printable key was silently dropped, the
dashboard's own payloads included
([#​1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594 ))
- Fixed **click latency behind mouse movement**: input dispatch awaited
Chrome's reply before reading the next message, so a click sat one round
trip behind every queued mouse move. After a 300-event sweep a click
landed 2471ms late; it now lands in 6ms
([#​1627](https://redirect.github.com/vercel-labs/agent-browser/issues/1627 ))
- Fixed **`stream disable`** returning while a slow client's input
reader was still running
([#​1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​kevingatera](https://redirect.github.com/kevingatera )
- [@​WebCloud](https://redirect.github.com/WebCloud )
###
[`v0.33.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0331 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.33.0...v0.33.1 )
##### Behavior Changes
- The daemon now ships a **default idle timeout of 1 hour**: after an
hour with no commands or dashboard input it saves configured restore
state, closes the browser, and exits, so integrations that die without
calling `close` no longer leak the daemon and its Chrome tree
indefinitely. Sessions without `--restore` or another restore key
discard transient browser state and open tabs when they shut down. Set
`AGENT_BROWSER_IDLE_TIMEOUT_MS=0` to restore the old always-persist
behavior, or any other value to tune it. Dashboard mouse, keyboard, and
touch input reset the timer. The default never closes headed browsers,
including Safari and iOS WebDriver sessions, or user-attached browsers
that may be in direct human use. Provider-owned cloud browsers remain
eligible for cleanup, and an explicitly configured timeout applies to
all browsers, as before
([#​1605](https://redirect.github.com/vercel-labs/agent-browser/issues/1605 ))
##### Bug Fixes
- Fixed **tab recovery and selection** to avoid daemon hangs on Memory
Saver-discarded tabs by selecting a live renderer on CDP connect,
reviving tabs on switch or after close, treating dialog-blocked tabs as
live, preserving refs on rejected operations, and surfacing recovery
state across CLI, JSON, and MCP output
([#​1543](https://redirect.github.com/vercel-labs/agent-browser/issues/1543 ))
- Fixed **a11y selector errors** to report invalid CSS selectors cleanly
instead of exposing raw browser evaluation stack traces in text and JSON
output
([#​1604](https://redirect.github.com/vercel-labs/agent-browser/issues/1604 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​Railly](https://redirect.github.com/Railly )
- [@​joelhooks](https://redirect.github.com/joelhooks )
- [@​jadenfix](https://redirect.github.com/jadenfix )
###
[`v0.33.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0330 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.32.4...v0.33.0 )
##### New Features
- Added **axe-core accessibility audits** with `agent-browser a11y
[url]`, WCAG tag filtering, selector scoping, iframe-aware text and JSON
results, an embedded offline and CSP-safe audit engine, and a matching
MCP tool
([#​1596](https://redirect.github.com/vercel-labs/agent-browser/issues/1596 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.32.4`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0324 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.32.3...v0.32.4 )
##### Bug Fixes
- Fixed **find role** to match implicit ARIA roles and browser-computed
accessible names through the accessibility tree, so semantic elements
like `<h2>` (heading) and `<ul>` (list) resolve, with case-insensitive
substring name matching that mirrors Playwright's `getByRole`
([#​1552](https://redirect.github.com/vercel-labs/agent-browser/issues/1552 ))
- Fixed **element-not-found errors** to preserve the locator detail
(selector, role, name, or index) instead of flattening every miss into
one generic message, and aligned the advertised `find` actions with the
set the dispatcher actually accepts
([#​1553](https://redirect.github.com/vercel-labs/agent-browser/issues/1553 ))
##### Contributors
- [@​Railly](https://redirect.github.com/Railly )
- [@​cooleryu](https://redirect.github.com/cooleryu )
###
[`v0.32.3`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0323 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.32.2...v0.32.3 )
##### New Features
- Added **HAR response body capture** with text bodies embedded by
default and configurable `all`, `text`, and `none` content modes across
the CLI and MCP surfaces
([#​1578](https://redirect.github.com/vercel-labs/agent-browser/issues/1578 ))
- Added a **derive-client skill** for recording browser traffic and
generating reusable API clients from HAR request and response data
([#​1578](https://redirect.github.com/vercel-labs/agent-browser/issues/1578 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.32.2`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0322 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.32.1...v0.32.2 )
##### Improvements
- Updated **eve extension packaging** for eve 0.25.1, adopting the new
source and dist extension manifest format, updating the eve example to
stable AI SDK releases, and keeping extension tests aligned with eve's
scoped config registry
([#​1570](https://redirect.github.com/vercel-labs/agent-browser/issues/1570 ))
##### Contributors
- [@​AndrewBarba](https://redirect.github.com/AndrewBarba )
###
[`v0.32.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0321 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.32.0...v0.32.1 )
##### Improvements
- Widened **eve compatibility** for `@agent-browser/eve` to accept eve
0.23 and future major releases without peer-resolution warnings
([#​1563](https://redirect.github.com/vercel-labs/agent-browser/issues/1563 ))
##### Documentation
- Standardized **eve branding** to use lowercase styling across the
docs, examples, package readmes, and release notes
([#​1557](https://redirect.github.com/vercel-labs/agent-browser/issues/1557 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.32.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0320 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.31.2...v0.32.0 )
##### New Features
- **eve extension** - Added `@agent-browser/eve`, an eve extension that
mounts the agent-browser tool set with namespaced browser tools, sandbox
bootstrap helpers, docs, examples, CI, and release packaging
([#​1547](https://redirect.github.com/vercel-labs/agent-browser/issues/1547 ))
##### Security
- Hardened **domain allowlists** by blocking WebRTC bypasses, applying
network containment across launch modes, workers, popups, restored
state, and reused daemon sessions, rejecting unsafe startup arguments,
and adding Chrome regression coverage
([#​1546](https://redirect.github.com/vercel-labs/agent-browser/issues/1546 ))
##### Bug Fixes
- Fixed **completed-page waits** so load and DOMContentLoaded waits
resolve immediately when the current document is already ready, with
structured eve wait timeout handling and focused coverage
([#​1554](https://redirect.github.com/vercel-labs/agent-browser/issues/1554 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
- [@​dnukumamras](https://redirect.github.com/dnukumamras )
###
[`v0.31.2`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0312 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.31.1...v0.31.2 )
##### New Features
- **WebGPU launch preset** - Added `--webgpu` across the CLI, config,
environment, and MCP surfaces, with hardware backends on macOS and
Windows, software Vulkan on Linux, automatic Xvfb for displayless headed
sessions, and a `doctor --webgpu` render and screenshot probe
([#​1529](https://redirect.github.com/vercel-labs/agent-browser/issues/1529 ))
##### Improvements
- Added periodic **restore-state autosaves** while the browser remains
open, preserving recent state after a browser window is closed by hand
and capturing background page changes while honoring the restore save
policy. The interval is configurable with
`AGENT_BROWSER_AUTOSAVE_INTERVAL_MS`
([#​1509](https://redirect.github.com/vercel-labs/agent-browser/issues/1509 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.31.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0311 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.31.0...v0.31.1 )
##### Bug Fixes
- Fixed the **React renderer** so it picks the react-dom renderer
instead of hardcoding renderer id 1, which prevented reading an empty
tree on Next.js 16.3 Turbopack
([#​1491](https://redirect.github.com/vercel-labs/agent-browser/issues/1491 ))
##### Contributors
- [@​gaojude](https://redirect.github.com/gaojude )
###
[`v0.31.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0310 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.30.1...v0.31.0 )
##### New Features
- **Restore workflow** - Added `--restore`, `--restore-save`, restore
validation flags, worktree-scoped `session id`, `session info`, and
`--namespace` so agent runs can use stable, isolated, automatically
restored browser state without managing state files by hand
([#​1486](https://redirect.github.com/vercel-labs/agent-browser/issues/1486 ))
##### Improvements
- Hardened **session lifecycle handling** with explicit daemon and
browser compatibility checks, lifecycle status output, MCP support for
restore options, and safer auto-save behavior that avoids overwriting
good state after a failed restore or failed validation
([#​1486](https://redirect.github.com/vercel-labs/agent-browser/issues/1486 ))
##### Bug Fixes
- Fixed **restore lifecycle edge cases** around switching restore keys
with a live browser, daemon configuration startup races, launch mode
validation, and clearing restore failures after an explicit state load
([#​1486](https://redirect.github.com/vercel-labs/agent-browser/issues/1486 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.30.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0301 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.30.0...v0.30.1 )
##### Bug Fixes
- Fixed **URL waits** so `wait --url` and `waitforurl` honor glob
patterns such as `**/dashboard` against the full active URL
([#​1483](https://redirect.github.com/vercel-labs/agent-browser/issues/1483 ))
##### Contributors
- [@​gaearon](https://redirect.github.com/gaearon )
###
[`v0.30.0`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0300 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.29.1...v0.30.0 )
##### New Features
- **Read command** - Added `agent-browser read [url]` and the matching
MCP tool for agent-readable text extraction. URL reads prefer Markdown,
try `.md` and nearby `llms.txt` docs, support outlines, filters, raw and
JSON output, headers, and domain/output safeguards; omitting the URL
reads the rendered active tab DOM with current browser state
([#​1480](https://redirect.github.com/vercel-labs/agent-browser/issues/1480 ))
##### Contributors
- [@​ctate](https://redirect.github.com/ctate )
###
[`v0.29.1`](https://redirect.github.com/vercel-labs/agent-browser/blob/HEAD/CHANGELOG.md#0291 )
[Compare
Source](https://redirect.github.com/vercel-labs/agent-browser/compare/v0.29.0...v0.29.1 )
##### Improvements
- Defaulted **sandbox system dependency installs** so the eve and Vercel
sandbox helpers install Chromi
> [!IMPORTANT]
> ✂ PR body was truncated to here.
</details>
---
### Configuration
📅 **Schedule**: (UTC)
- Branch creation
- "before 6am every weekday"
- Automerge
- At any time (no schedule defined)
🚦 **Automerge**: Disabled by config. Please merge this manually once you
are satisfied.
♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.
👻 **Immortal**: This PR will be recreated if closed unmerged. Get
[config
help](https://redirect.github.com/renovatebot/renovate/discussions ) if
that's undesired.
---
- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box
---
This PR has been generated by [Mend Renovate
CLI](https://redirect.github.com/renovatebot/renovate ).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0NC4xNzUuMSIsInVwZGF0ZWRJblZlciI6IjQ0LjE3NS4xIiwidGFyZ2V0QnJhbmNoIjoibWFpbiIsImxhYmVscyI6WyJhdXRvbWF0aW9uIl19-->
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-10-21 13:16:09 +00:00
dane-ai-mastra[bot]
4c22623ea3
chore: version - exit prerelease mode
2026-10-21 11:26:39 +00:00
Max Katz
9a423dae48
refactor(lint): replace ESLint with type-aware oxlint ( #27476 )
2026-10-18 10:38:35 -07:00
dane-ai-mastra[bot]
a15924e709
chore: version packages
2026-10-16 04:04:12 +00:00
dane-ai-mastra[bot]
fe516094f5
chore: version - exit prerelease mode
2026-10-15 21:33:45 +00:00
Abhi Aiyer
fa25997b95
test: remove copy-paste duplicate tests and fix mislabeled ones ( #27122 )
...
## Summary
Some tests had the same body as another test in the same file but a
different name. A few were plain copy-paste duplicates. Others were
named after behavior they never set up, so that behavior wasn't being
tested.
**Removed (exact duplicates of a test in the same file):** agent-browser
`close`, Linear `agent-tools`, factory `workspace` (private-session
refusal), playground-ui `filter-spans-keeping-ancestors`, server
`system` (cmsEnabled false), client-js `listThreadMessages` default,
workflow `request-context-schema`, OM async config, `model.test.ts`
"rate limiting"/"step change logging" tests that checked nothing, and 4
`aisdk` variants in `model.loop.e2e.test.ts` (they sent the same
requests as the `mastra` ones).
**Fixed so they test what they're named after:**
- `model.test.ts`: two tool tests that checked nothing are replaced by
one that asserts tools reach the provider as function definitions.
- language-detector / moderation / prompt-injection-detector: "default"
tests now assert the defaults appear in the prompt sent to the model,
not just `.id`.
- trailing-assistant-guard: now covers `structuredOutput` that is
present but has no schema.
- storageWithInit: the default test really leaves `disableInit` unset.
- client-js observability: the "string dates" test now actually passes
strings.
- turbopuffer: the "$and operator" test now uses explicit `$and`.
- keyboard shortcuts: the page-mount-order test now mounts the page
after the global binding.
Tests only; no runtime changes.
## Test plan
- [x] Affected suites pass in core, memory, server, client-js,
playground-ui, agent-browser, factory (Linear)
- [x] Prettier clean; turbopuffer/client-js typecheck clean for touched
files
- Note: `factory/src/workspace.test.ts` "loads every checkout's
AGENTS.md…" also fails on main; unrelated
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## ELI5
This PR removes tests that repeat other tests or do not check what their
names say they check. It also fixes several tests so they check the
intended behavior more directly.
## Summary
- Removed duplicate or ineffective tests across core, memory, server,
client-js, playground-ui, agent-browser, and Factory.
- Updated tool tests to verify provider function definitions, and
updated processor tests to inspect prompts for default language and
detection categories.
- Corrected test inputs for structured output, storage initialization,
string dates, explicit `$and` clauses, and keyboard shortcut mount
order.
- No runtime changes are reported.
## Test status
The PR reports that affected suites pass in core, memory, server,
client-js, playground-ui, agent-browser, and Factory (Linear). It also
reports clean Prettier and typechecks for the touched turbopuffer and
client-js files.
The PR notes that `factory/src/workspace.test.ts` fails on `main`
because it loads every checkout's `AGENTS.md`; the failure is reported
as unrelated.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Co-authored-by: mastracode <284800079+mastra-platform[bot]@users.noreply.github.com>
2026-10-14 19:41:42 -07:00
dane-ai-mastra[bot]
f88217d19b
chore: version - exit prerelease mode
2026-10-14 05:19:31 +00:00
dane-ai-mastra[bot]
81299c921d
chore: version - exit prerelease mode
2026-10-11 16:59:51 +00:00
dane-ai-mastra[bot]
b10b70fd77
chore: version - exit prerelease mode
2026-10-07 08:40:03 +00:00
dane-ai-mastra[bot]
b21e46e19b
chore: version - exit prerelease mode
2026-10-01 18:04:32 +00:00
dane-ai-mastra[bot]
8b35a6c1d6
chore: version - exit prerelease mode
2026-10-01 08:22:20 +00:00
dane-ai-mastra[bot]
5306a14346
chore: version - exit prerelease mode
2026-09-29 23:50:38 +00:00
dane-ai-mastra[bot]
6721bffd7e
chore: version - exit prerelease mode
2026-09-24 23:17:52 +00:00
dane-ai-mastra[bot]
6d36499758
chore: version - exit prerelease mode
2026-09-24 12:50:16 +00:00
dane-ai-mastra[bot]
a436d6c513
chore: version - exit prerelease mode
2026-09-23 09:15:38 +00:00
dane-ai-mastra[bot]
429d7b9f93
chore: version - exit prerelease mode
2026-09-22 10:43:03 +00:00
dane-ai-mastra[bot]
d696deb43e
chore: version packages
2026-09-16 16:06:16 +00:00
Lennart
5085475c0d
fix: reduce dependency footprint across core and integrations ( #23998 )
2026-09-16 11:38:54 +02:00
Lennart
acfb794929
fix(ci): discover omitted Vitest projects in root test runs ( #23965 )
2026-09-15 12:19:24 +02:00
dane-ai-mastra[bot]
871bdaa595
chore: version - exit prerelease mode
2026-09-15 09:04:59 +00:00
dane-ai-mastra[bot]
cfc365b486
chore: version packages
2026-09-11 16:09:00 +00:00
mastra-platform[bot]
a0aa698427
fix(browser): stop killing host processes with remote browser PIDs over CDP ( #23599 )
2026-09-11 07:16:39 -07:00
dane-ai-mastra[bot]
cbd18af524
chore: version - exit prerelease mode
2026-09-10 16:48:00 +00:00
dane-ai-mastra[bot]
4eda447b76
chore: version - exit prerelease mode
2026-09-09 05:42:50 +00:00
dane-ai-mastra[bot]
c19a93b095
chore: version - exit prerelease mode
2026-09-03 04:02:53 +00:00
dane-ai-mastra[bot]
e6de774069
chore: version packages
2026-09-02 16:20:22 +00:00
Lennart
e983f74987
chore(*): Update/unify/add READMEs ( #22858 )
...
Co-authored-by: Mastra Code (openai/gpt-5.6-sol) <noreply@mastra.ai>
2026-09-02 14:36:59 +02:00
dane-ai-mastra[bot]
fc968c8a9b
chore: version packages
2026-09-01 16:28:50 +00:00
Lennart
28ce924276
chore(*): Remove CHANGELOG.md from npm files ( #22737 )
2026-09-01 10:47:20 +02:00
dane-ai-mastra[bot]
64d151c6e0
chore: version packages
2026-08-30 16:04:31 +00:00