0
Fork 0
mirror of https://github.com/mastra-ai/mastra.git synced 2026-11-17 08:44:46 +00:00
Commit graph

76 commits

Author SHA1 Message Date
dane-ai-mastra[bot]
77076a1012 chore: version - exit prerelease mode 2026-10-30 23:02:25 +00: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
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[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
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)
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
(@&#8203;browserbasehq/stagehand)</summary>

###
[`v3.7.3`](https://redirect.github.com/browserbase/stagehand/releases/tag/%40browserbasehq/stagehand%403.7.3)

##### Patch Changes

-
[#&#8203;2842](https://redirect.github.com/browserbase/stagehand/pull/2842)
[`f86e609`](f86e609b93)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
update the MCP SDK to v1.30 and refresh supporting dependency versions

-
[#&#8203;2836](https://redirect.github.com/browserbase/stagehand/pull/2836)
[`94a0ee4`](94a0ee4e19)
Thanks
[@&#8203;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

-
[#&#8203;2359](https://redirect.github.com/browserbase/stagehand/pull/2359)
[`2cd1edf`](2cd1edf49e)
Thanks [@&#8203;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).

-
[#&#8203;2347](https://redirect.github.com/browserbase/stagehand/pull/2347)
[`84197d8`](84197d8cba)
Thanks [@&#8203;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

-
[#&#8203;2283](https://redirect.github.com/browserbase/stagehand/pull/2283)
[`871ca7e`](871ca7e305)
Thanks
[@&#8203;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

-
[#&#8203;2274](https://redirect.github.com/browserbase/stagehand/pull/2274)
[`f31980f`](f31980f37a)
Thanks
[@&#8203;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

-
[#&#8203;2305](https://redirect.github.com/browserbase/stagehand/pull/2305)
[`cd1daad`](cd1daad7f7)
Thanks [@&#8203;shrey150](https://redirect.github.com/shrey150)! -
Remove the noisy AI SDK "system message in messages" warning logged on
every hybrid/DOM `agent.execute()` call.

-
[#&#8203;2328](https://redirect.github.com/browserbase/stagehand/pull/2328)
[`d287ff4`](d287ff4d2c)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Allow modelName "auto" in the constructor and per-primitive model
overrides when running through the Stagehand API

-
[#&#8203;2294](https://redirect.github.com/browserbase/stagehand/pull/2294)
[`3938590`](39385906b3)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
automatically close popups that violate user defined domain policy

-
[#&#8203;2298](https://redirect.github.com/browserbase/stagehand/pull/2298)
[`892701a`](892701a30f)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
Fix CUA `keypress` actions to press key combinations as a single chord.

-
[#&#8203;2345](https://redirect.github.com/browserbase/stagehand/pull/2345)
[`21826c7`](21826c75ce)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! -
Repair malformed UTF-16 snapshot text before it reaches model prompts.

-
[#&#8203;2306](https://redirect.github.com/browserbase/stagehand/pull/2306)
[`8dcef1b`](8dcef1b491)
Thanks
[@&#8203;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.

-
[#&#8203;2273](https://redirect.github.com/browserbase/stagehand/pull/2273)
[`93a23d3`](93a23d3adf)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add support for the new `google/gemini-3.5-flash` computer-use tools
model

-
[#&#8203;2278](https://redirect.github.com/browserbase/stagehand/pull/2278)
[`022d68f`](022d68fc81)
Thanks [@&#8203;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.

-
[#&#8203;2288](https://redirect.github.com/browserbase/stagehand/pull/2288)
[`bb5ffa6`](bb5ffa6f49)
Thanks
[@&#8203;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

-
[#&#8203;2178](https://redirect.github.com/browserbase/stagehand/pull/2178)
[`c49a3fc`](c49a3fc47a)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
add support for WebMCP

##### Patch Changes

-
[#&#8203;2217](https://redirect.github.com/browserbase/stagehand/pull/2217)
[`147e310`](147e310b12)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! - Add
Azure OpenAI Microsoft Entra ID model auth support.

-
[#&#8203;2231](https://redirect.github.com/browserbase/stagehand/pull/2231)
[`cf3603d`](cf3603d1c1)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add claude-fable-5 support: native structured outputs via the
[@&#8203;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.

-
[#&#8203;2233](https://redirect.github.com/browserbase/stagehand/pull/2233)
[`8d7d414`](8d7d414c70)
Thanks
[@&#8203;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.

-
[#&#8203;2229](https://redirect.github.com/browserbase/stagehand/pull/2229)
[`fd42e65`](fd42e65bb8)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
launch local browser with
--enable-features=WebMCPTesting,DevToolsWebMCPSupport by default

-
[#&#8203;2220](https://redirect.github.com/browserbase/stagehand/pull/2220)
[`a64c6b7`](a64c6b74cf)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! - Fix
Stagehand-generated shadow-root XPath resolution so deterministic
actions can target elements inside web components.

-
[#&#8203;2132](https://redirect.github.com/browserbase/stagehand/pull/2132)
[`ed3e566`](ed3e56636e)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add canonical verifier evidence normalization for screenshots and text
signals without requiring image dependencies in core installs.

-
[#&#8203;2133](https://redirect.github.com/browserbase/stagehand/pull/2133)
[`840aac8`](840aac8bfc)
Thanks [@&#8203;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

-
[#&#8203;2149](https://redirect.github.com/browserbase/stagehand/pull/2149)
[`6e75725`](6e75725b39)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Added a `screenshot` option to `extract()` that sends the current
viewport screenshot with the a11y tree for extraction.

-
[#&#8203;2127](https://redirect.github.com/browserbase/stagehand/pull/2127)
[`78bcde8`](78bcde88e2)
Thanks
[@&#8203;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

-
[#&#8203;2160](https://redirect.github.com/browserbase/stagehand/pull/2160)
[`49575d6`](49575d62f5)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! -
Forward constructor and request model configuration when initializing
API-backed sessions.

-
[#&#8203;2171](https://redirect.github.com/browserbase/stagehand/pull/2171)
[`dc1445d`](dc1445df80)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
add native clipboard API

##### Patch Changes

-
[#&#8203;2146](https://redirect.github.com/browserbase/stagehand/pull/2146)
[`3a53ed4`](3a53ed4ea9)
Thanks
[@&#8203;shriyatheunicorn](https://redirect.github.com/shriyatheunicorn)!
- Pass local browser launch options through when attaching over CDP so
explicit viewport settings are respected.

-
[#&#8203;2107](https://redirect.github.com/browserbase/stagehand/pull/2107)
[`8fc16d2`](8fc16d2e18)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Fix Anthropic CUA `triple_click` action mapping.

-
[#&#8203;2118](https://redirect.github.com/browserbase/stagehand/pull/2118)
[`3e95a87`](3e95a8722a)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! - Add
Vertex auth parameters to the core and server API schemas.

-
[#&#8203;2126](https://redirect.github.com/browserbase/stagehand/pull/2126)
[`ebbdcd3`](ebbdcd33cb)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
fix(core): import ToolSet from ai public export

-
[#&#8203;2120](https://redirect.github.com/browserbase/stagehand/pull/2120)
[`12703a6`](12703a6659)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Fix structuredOutputMode for newer Anthropic models

-
[#&#8203;2170](https://redirect.github.com/browserbase/stagehand/pull/2170)
[`1db5f1c`](1db5f1c193)
Thanks [@&#8203;Kylejeong2](https://redirect.github.com/Kylejeong2)! -
Add Claude Opus 4.8 to the supported CUA model whitelist.

-
[#&#8203;2116](https://redirect.github.com/browserbase/stagehand/pull/2116)
[`cb586a1`](cb586a14e4)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
include "\[selected]" or "\[checked]" state in snapshot

-
[#&#8203;2129](https://redirect.github.com/browserbase/stagehand/pull/2129)
[`765861c`](765861c04c)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add a backend-selectable v3 evaluator facade while preserving the legacy
evaluator path.

-
[#&#8203;2157](https://redirect.github.com/browserbase/stagehand/pull/2157)
[`2cd60a3`](2cd60a34b0)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add verifier trajectory, rubric, and evaluation-result types with
normalized public naming.

-
[#&#8203;2131](https://redirect.github.com/browserbase/stagehand/pull/2131)
[`e102a89`](e102a89c90)
Thanks [@&#8203;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

-
[#&#8203;2084](https://redirect.github.com/browserbase/stagehand/pull/2084)
[`0641d44`](0641d44a84)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
add ignoreSelectors param to extract()

-
[#&#8203;2096](https://redirect.github.com/browserbase/stagehand/pull/2096)
[`a11603d`](a11603d09d)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
add ignoreSelectors to observe()

##### Patch Changes

-
[#&#8203;2080](https://redirect.github.com/browserbase/stagehand/pull/2080)
[`21c78b3`](21c78b3a50)
Thanks [@&#8203;miguelg719](https://redirect.github.com/miguelg719)! -
Add variables support to v3 agentExecute API schema and remove
experimental requirement

-
[#&#8203;2077](https://redirect.github.com/browserbase/stagehand/pull/2077)
[`f437f73`](f437f738d2)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! - Fix
frame registry handling for OOPIF pages

-
[#&#8203;2098](https://redirect.github.com/browserbase/stagehand/pull/2098)
[`a783b99`](a783b99fb9)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
bump transitive deps to patched versions

-
[#&#8203;2089](https://redirect.github.com/browserbase/stagehand/pull/2089)
[`8d2f354`](8d2f354142)
Thanks [@&#8203;shrey150](https://redirect.github.com/shrey150)! -
Strengthen observe prompts so LLMs return complete encoded element IDs.

-
[#&#8203;2047](https://redirect.github.com/browserbase/stagehand/pull/2047)
[`a87c1fc`](a87c1fc435)
Thanks [@&#8203;tkattkat](https://redirect.github.com/tkattkat)! - Set
default agent mode to hybrid with auto routing to dom for non compatible
models

-
[#&#8203;2101](https://redirect.github.com/browserbase/stagehand/pull/2101)
[`26e6c96`](26e6c960ca)
Thanks
[@&#8203;seanmcguire12](https://redirect.github.com/seanmcguire12)! -
move playwright-core, puppeteer-core, patchright-core from optional
dependencies to peer dependencies

-
[#&#8203;2068](https://redirect.github.com/browserbase/stagehand/pull/2068)
[`1d176c4`](1d176c466e)
Thanks
[@&#8203;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.

-
[#&#8203;2040](https://redirect.github.com/browserbase/stagehand/pull/2040)
[`1fa9613`](1fa96130ab)
Thanks [@&#8203;monadoid](https://redirect.github.com/monadoid)! -
Prefer `STAGEHAND_API_URL` for Stagehand API overrides while retaining
`STAGEHAND_BASE_URL` as a deprecated fallback.

-
[#&#8203;2065](https://redirect.github.com/browserbase/stagehand/pull/2065)
[`9ff70dd`](9ff70dd26c)
Thanks [@&#8203;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

-
[#&#8203;2039](https://redirect.github.com/browserbase/stagehand/pull/2039)
[`7640381`](76403819b8)
Thanks [@&#8203;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
([#&#8203;2085](https://redirect.github.com/vercel-labs/agent-browser/issues/2085))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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"
([#&#8203;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
([#&#8203;2059](https://redirect.github.com/vercel-labs/agent-browser/issues/2059))

##### Documentation

- Migrated the **docs site** to Geistdocs
([#&#8203;1887](https://redirect.github.com/vercel-labs/agent-browser/issues/1887))

##### Contributors

- [@&#8203;NamanSatish](https://redirect.github.com/NamanSatish)
- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;SGavrl](https://redirect.github.com/SGavrl)
- [@&#8203;SUSINDRAREDDY](https://redirect.github.com/SUSINDRAREDDY)
- [@&#8203;godtail](https://redirect.github.com/godtail)
- [@&#8203;jadenfix](https://redirect.github.com/jadenfix)
- [@&#8203;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
([#&#8203;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`
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1945](https://redirect.github.com/vercel-labs/agent-browser/issues/1945))

##### Documentation

- Updated the **contact sheet example** with the loading-flash demo
output
([#&#8203;1871](https://redirect.github.com/vercel-labs/agent-browser/issues/1871))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;benjamincanac](https://redirect.github.com/benjamincanac)
- [@&#8203;boatri](https://redirect.github.com/boatri)
- [@&#8203;luxleader](https://redirect.github.com/luxleader)
- [@&#8203;petehunt](https://redirect.github.com/petehunt)
-
[@&#8203;robertjamesprior](https://redirect.github.com/robertjamesprior)
- [@&#8203;simonellefsen](https://redirect.github.com/simonellefsen)
- [@&#8203;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
([#&#8203;1869](https://redirect.github.com/vercel-labs/agent-browser/issues/1869))

##### Documentation

- Added Vercel Labs product and project status badges to the README
([#&#8203;1868](https://redirect.github.com/vercel-labs/agent-browser/issues/1868))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1807](https://redirect.github.com/vercel-labs/agent-browser/issues/1807),
[#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1834](https://redirect.github.com/vercel-labs/agent-browser/issues/1834))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;mauricioantolin](https://redirect.github.com/mauricioantolin)
- [@&#8203;mecampbellsoup](https://redirect.github.com/mecampbellsoup)
- [@&#8203;evrenverse](https://redirect.github.com/evrenverse)
- [@&#8203;judegao](https://redirect.github.com/judegao)
- [@&#8203;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
([#&#8203;1498](https://redirect.github.com/vercel-labs/agent-browser/issues/1498),
[#&#8203;1820](https://redirect.github.com/vercel-labs/agent-browser/issues/1820))

##### Contributors

- [@&#8203;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
([#&#8203;1763](https://redirect.github.com/vercel-labs/agent-browser/issues/1763),
[#&#8203;1776](https://redirect.github.com/vercel-labs/agent-browser/issues/1776),
[#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1776](https://redirect.github.com/vercel-labs/agent-browser/issues/1776))

##### Contributors

- [@&#8203;jamesvclements](https://redirect.github.com/jamesvclements)
- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;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

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;anupamme](https://redirect.github.com/anupamme)
- [@&#8203;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
([#&#8203;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
([#&#8203;1735](https://redirect.github.com/vercel-labs/agent-browser/issues/1735))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1723](https://redirect.github.com/vercel-labs/agent-browser/issues/1723),
[#&#8203;1720](https://redirect.github.com/vercel-labs/agent-browser/issues/1720))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;Angelmmiguel](https://redirect.github.com/Angelmmiguel)
- [@&#8203;anupamme](https://redirect.github.com/anupamme)
-
[@&#8203;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
([#&#8203;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
([#&#8203;1705](https://redirect.github.com/vercel-labs/agent-browser/issues/1705))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;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`
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1641](https://redirect.github.com/vercel-labs/agent-browser/issues/1641))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;huozhi](https://redirect.github.com/huozhi)
- [@&#8203;soichisumi](https://redirect.github.com/soichisumi)
- [@&#8203;dandaka](https://redirect.github.com/dandaka)
- [@&#8203;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`
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1594](https://redirect.github.com/vercel-labs/agent-browser/issues/1594))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;kevingatera](https://redirect.github.com/kevingatera)
- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1604](https://redirect.github.com/vercel-labs/agent-browser/issues/1604))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;joelhooks](https://redirect.github.com/joelhooks)
- [@&#8203;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
([#&#8203;1596](https://redirect.github.com/vercel-labs/agent-browser/issues/1596))

##### Contributors

- [@&#8203;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`
([#&#8203;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
([#&#8203;1553](https://redirect.github.com/vercel-labs/agent-browser/issues/1553))

##### Contributors

- [@&#8203;Railly](https://redirect.github.com/Railly)
- [@&#8203;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
([#&#8203;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
([#&#8203;1578](https://redirect.github.com/vercel-labs/agent-browser/issues/1578))

##### Contributors

- [@&#8203;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
([#&#8203;1570](https://redirect.github.com/vercel-labs/agent-browser/issues/1570))

##### Contributors

- [@&#8203;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
([#&#8203;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
([#&#8203;1557](https://redirect.github.com/vercel-labs/agent-browser/issues/1557))

##### Contributors

- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1554](https://redirect.github.com/vercel-labs/agent-browser/issues/1554))

##### Contributors

- [@&#8203;ctate](https://redirect.github.com/ctate)
- [@&#8203;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
([#&#8203;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`
([#&#8203;1509](https://redirect.github.com/vercel-labs/agent-browser/issues/1509))

##### Contributors

- [@&#8203;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
([#&#8203;1491](https://redirect.github.com/vercel-labs/agent-browser/issues/1491))

##### Contributors

- [@&#8203;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
([#&#8203;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
([#&#8203;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
([#&#8203;1486](https://redirect.github.com/vercel-labs/agent-browser/issues/1486))

##### Contributors

- [@&#8203;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
([#&#8203;1483](https://redirect.github.com/vercel-labs/agent-browser/issues/1483))

##### Contributors

- [@&#8203;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
([#&#8203;1480](https://redirect.github.com/vercel-labs/agent-browser/issues/1480))

##### Contributors

- [@&#8203;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
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]
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]
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]
387c6b7f5a chore: version - exit prerelease mode 2026-08-12 04:41:36 +00:00
dane-ai-mastra[bot]
1f965d27a6
chore: version packages (alpha) (#21011)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-08-08 08:17:16 -07:00
Abhi Aiyer
f59032a736
Make the browser viewport configurable (#21010)
Co-authored-by: Mastra Code (anthropic/claude-opus-5) <noreply@mastra.ai>
2026-08-07 23:58:30 -07:00
dane-ai-mastra[bot]
ca935ef6de chore: version - exit prerelease mode 2026-08-05 20:21:53 +00:00
dane-ai-mastra[bot]
b9325cca10 chore: version packages 2026-08-05 16:33:25 +00:00
Hariom Sharma
cd1f0cc071
feat(agent-browser): support cdpHeaders for authenticated CDP connections (#20606)
Co-authored-by: Ward Peeters <ward@coding-tech.com>
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
2026-08-05 09:28:13 -07:00
Ward Peeters
d271d37f30
chore: migrate package builds to tsdown (#19829)
Co-authored-by: Mastra Code (openai/gpt-5.5) <noreply@mastra.ai>
2026-07-28 12:32:21 +02:00
Ward Peeters
bdeaef58f0
chore: migrate linting to oxlint (#20173)
Co-authored-by: GitHub Action <action@github.com>
Co-authored-by: Mastra Code (openai/gpt-5.6-sol) <noreply@mastra.ai>
2026-07-25 01:04:02 +02:00
Ward Peeters
3a507cbd42
chore: migrate repository formatting to oxfmt (#19807)
Co-authored-by: Mastra Code (openai/gpt-5.5) <noreply@mastra.ai>
2026-07-24 16:18:33 +02:00
Dane - AI (Mastra)
b2c54efe0f
chore(deps): update playwright monorepo to ^1.61.1 (#19785)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-07-20 23:49:14 +02:00
Dane - AI (Mastra)
a4620cae04
chore(deps): update formatting & linting (#19388)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: wardpeet <ward@coding-tech.com>
2026-07-20 16:13:28 +02:00
Dane - AI (Mastra)
0532405a28
chore(deps): update build tools (#18043) 2026-07-14 23:01:34 +02:00
dane-ai-mastra[bot]
cf9ef51cc7 chore: version - exit prerelease mode 2026-07-06 17:19:52 +00:00
dane-ai-mastra[bot]
bed7a5e0ed chore: version packages 2026-07-03 16:31:05 +00:00
Masato Yoshioka
81e1ad440f
fix(agent-browser): prevent unhandled rejection from dangling navigation wait (#18870)
## Description

Fixes #18868

`AgentBrowser.click` / `press` / `select` start the `waitUntil`
navigation wait **before** awaiting the action, and no rejection handler
is attached to the navigation promise until `await navigation` is
reached:

```ts
const navigation = input.waitUntil ? page.waitForNavigation({ waitUntil: input.waitUntil, timeout }) : undefined;
await locator.click({ ... });  // ← while this is pending, `navigation` has no handler
await navigation;
```

Because the navigation wait and the action **share the same `timeout`**
and the navigation timer starts first, any action that is slow or
blocked long enough to time out lets the navigation rejection fire first
— while `await navigation` has not been reached. The rejection is
unhandled and, with Node's default behavior, **kills the entire
process** (in our case a `mastra dev` server hosting all agents went
down mid-request), even though the tool call itself returned a graceful
error object.

## Fix

Attach a noop handler right after starting the navigation wait in all
three sites (`click`, `press`, `select`):

```ts
const navigation = input.waitUntil ? page.waitForNavigation({ waitUntil: input.waitUntil, timeout }) : undefined;
navigation?.catch(() => {});
```

The rejection is always observed, and `await navigation` still surfaces
the original error through the existing try/catch, so error behavior of
the tools is unchanged.

## Testing

- Added a regression test that drives `click` with `waitUntil` while the
navigation wait rejects before the click settles, asserting no
`unhandledRejection` escapes.
- Verified the test **fails without the fix** (unhandled rejection
observed) and **passes with it**.
- Note: the test replaces the `waitForNavigation` mock with a plain
function for this case — vitest attaches handlers to promises returned
from `vi.fn()` mocks (for `mock.settledResults`), which would mask the
unhandled rejection.
- Full package suite: `browser/agent-browser` — 12 files / 221 tests
pass.
- `tsc --noEmit` and `eslint` clean for the package.
- Also reproduced the original crash outside tests with a real browser
(link covered by an overlay + `waitUntil: 'domcontentloaded'`): the tool
returned `element_blocked` gracefully while the dangling navigation
rejection escaped as an unhandled rejection.

## Changeset

Added a `patch` changeset for `@mastra/agent-browser`.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## ELI5
When the browser tool does a **click**, **press**, or **select**, it
also waits for the page navigation to finish. This fix ensures that if
navigation fails first, the error is still “caught” so Node won’t
crash—while the tool still returns the normal failure result.

## Summary
- Refactored `click`, `press`, and `select` to use a shared
`startNavigationWait(...)` helper that immediately attaches a noop
`navigation?.catch(() => {})` right after creating the
`waitForNavigation` promise.
- Kept the existing behavior of awaiting the navigation promise after
the DOM action, preserving the usual tool error surface.
- Added regression tests for **click**, **press**, and **select** that
simulate a “dangling navigation wait” (navigation rejects while the
action is still pending) and assert no `unhandledRejection` escapes.
- Added a Changesets entry for a patch release of
`@mastra/agent-browser`.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: Ehindero Israel <ehindero@Ehinderos-MacBook-Pro.local>
2026-07-03 13:23:59 +01:00
dane-ai-mastra[bot]
7a8a8243bb chore: version - exit prerelease mode 2026-06-19 05:35:11 +00:00
dane-ai-mastra[bot]
faae1eb9e0
chore: version packages (alpha) (#18159)
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/acp@0.3.0-alpha.0


## @mastra/claude@0.3.0-alpha.0


## @mastra/cursor@0.3.0-alpha.0


## @mastra/openai@1.1.0-alpha.0


## @mastra/auth-auth0@1.2.0-alpha.0


## @mastra/auth-better-auth@1.1.0-alpha.0


## @mastra/auth-clerk@1.2.0-alpha.0


## @mastra/auth-cloud@1.2.0-alpha.0


## @mastra/auth-firebase@1.1.0-alpha.0


## @mastra/auth-neon@0.3.0-alpha.0


## @mastra/auth-okta@0.1.0-alpha.0


## @mastra/auth-studio@1.3.0-alpha.0


## @mastra/auth-supabase@1.1.0-alpha.0


## @mastra/auth-workos@1.6.0-alpha.0


## @mastra/agent-browser@0.4.0-alpha.0


## @mastra/browser-viewer@0.2.0-alpha.0


## @mastra/browser-firecrawl@0.2.0-alpha.0


## @mastra/stagehand@0.3.0-alpha.0


## @mastra/slack@1.4.0-alpha.0


## @mastra/ai-sdk@1.5.0-alpha.0


## @mastra/client-js@1.26.0-alpha.0


## @mastra/react@1.1.0-alpha.0


## @mastra/deployer-cloud@1.45.0-alpha.0


## @mastra/deployer-cloudflare@1.2.0-alpha.0


## @mastra/deployer-netlify@1.2.0-alpha.0


## @mastra/deployer-vercel@1.2.0-alpha.0


## @mastra/voyageai@0.2.0-alpha.0


## @mastra/longmemeval@1.1.0-alpha.0


## @mastra/brightdata@0.3.0-alpha.0


## @mastra/opencode@0.1.0-alpha.0


## @mastra/perplexity@0.2.0-alpha.0


## @mastra/tavily@1.1.0-alpha.0


## mastracode@0.24.0-alpha.0


## @mastra/arize@1.3.0-alpha.0


## @mastra/arthur@0.4.0-alpha.0


## @mastra/braintrust@1.2.0-alpha.0


## @mastra/datadog@1.3.0-alpha.0


## @mastra/laminar@1.3.0-alpha.0


## @mastra/langfuse@1.4.0-alpha.0


## @mastra/langsmith@1.3.0-alpha.0


## @mastra/observability@1.15.0-alpha.0


## @mastra/otel-bridge@1.3.0-alpha.0


## @mastra/otel-exporter@1.3.0-alpha.0


## @mastra/posthog@1.1.0-alpha.0


## @mastra/sentry@1.2.0-alpha.0


## @mastra/agent-builder@1.1.0-alpha.0


## @mastra/auth@1.1.0-alpha.0


## mastra@1.15.0-alpha.0


## @mastra/codemod@1.1.0-alpha.0


## @mastra/core@1.45.0-alpha.0


## create-mastra@1.15.0-alpha.0


## @mastra/deployer@1.45.0-alpha.0


## @mastra/editor@0.13.0-alpha.0


## @mastra/evals@1.4.0-alpha.0


## @mastra/fastembed@1.2.0-alpha.0


## @mastra/loggers@1.2.0-alpha.0


## @mastra/mcp@1.11.0-alpha.0


## @mastra/mcp-docs-server@1.2.0-alpha.0


## @mastra/mcp-registry-registry@1.1.0-alpha.0


## @mastra/memory@1.21.0-alpha.0


## @mastra/playground-ui@35.0.0-alpha.0


## @mastra/rag@2.3.0-alpha.0


## @mastra/schema-compat@1.3.0-alpha.0


## @mastra/server@1.45.0-alpha.0


## @mastra/google-cloud-pubsub@1.1.0-alpha.0


## @mastra/redis-streams@0.1.0-alpha.0


## @mastra/express@1.4.0-alpha.0


## @mastra/fastify@1.4.0-alpha.0


## @mastra/hono@1.5.0-alpha.0


## @mastra/koa@1.6.0-alpha.0


## @mastra/nestjs@0.2.0-alpha.0


## @mastra/github-signals@0.2.0-alpha.0


## @mastra/astra@1.1.0-alpha.0


## @mastra/chroma@1.1.0-alpha.0


## @mastra/clickhouse@1.11.0-alpha.0


## @mastra/cloudflare@1.5.0-alpha.0


## @mastra/cloudflare-d1@1.1.0-alpha.0


## @mastra/convex@1.3.0-alpha.0


## @mastra/couchbase@1.1.0-alpha.0


## @mastra/dsql@1.1.0-alpha.0


## @mastra/duckdb@1.5.0-alpha.0


## @mastra/dynamodb@1.1.0-alpha.0


## @mastra/elasticsearch@1.3.0-alpha.0


## @mastra/lance@1.1.0-alpha.0


## @mastra/libsql@1.14.0-alpha.0


## @mastra/mongodb@1.10.0-alpha.0


## @mastra/mssql@1.4.0-alpha.0


## @mastra/mysql@0.2.0-alpha.0


## @mastra/opensearch@1.1.0-alpha.0


## @mastra/pg@1.14.0-alpha.0


## @mastra/pinecone@1.1.0-alpha.0


## @mastra/qdrant@1.1.0-alpha.0


## @mastra/redis@1.2.0-alpha.0


## @mastra/s3vectors@1.1.0-alpha.0


## @mastra/spanner@1.2.0-alpha.0


## @mastra/turbopuffer@1.1.0-alpha.0


## @mastra/upstash@1.2.0-alpha.0


## @mastra/vectorize@1.1.0-alpha.0


## @mastra/voice-aws-nova-sonic@0.2.0-alpha.0


## @mastra/voice-azure@0.12.0-alpha.0


## @mastra/voice-cloudflare@0.13.0-alpha.0


## @mastra/voice-deepgram@0.13.0-alpha.0


## @mastra/voice-elevenlabs@0.13.0-alpha.0


## @mastra/voice-gladia@0.13.0-alpha.0


## @mastra/voice-google@0.13.0-alpha.0


## @mastra/voice-google-gemini-live@0.13.0-alpha.0


## @mastra/voice-inworld@0.4.0-alpha.0


## @mastra/voice-modelslab@0.2.0-alpha.0


## @mastra/voice-murf@0.13.0-alpha.0


## @mastra/voice-openai@0.13.0-alpha.0


## @mastra/voice-openai-realtime@0.13.0-alpha.0


## @mastra/voice-playai@0.13.0-alpha.0


## @mastra/voice-sarvam@1.1.0-alpha.0


## @mastra/voice-speechify@0.13.0-alpha.0


## @mastra/voice-xai-realtime@0.2.0-alpha.0


## @mastra/inngest@1.6.0-alpha.0


## @mastra/temporal@0.2.0-alpha.0


## @mastra/agentcore@0.3.0-alpha.0


## @mastra/agentfs@0.2.0-alpha.0


## @mastra/azure@0.3.0-alpha.0


## @mastra/blaxel@0.5.0-alpha.0


## @mastra/daytona@0.5.0-alpha.0


## @mastra/docker@0.4.0-alpha.0


## @mastra/e2b@0.4.0-alpha.0


## @mastra/files-sdk@0.3.0-alpha.0


## @mastra/gcs@0.3.0-alpha.0


## @mastra/google-drive@0.2.0-alpha.0


## @mastra/modal@0.3.0-alpha.0


## @mastra/railway@0.2.0-alpha.0


## @mastra/s3@0.6.0-alpha.0


## @mastra/vercel@1.1.0-alpha.0


## @observability/test-utils@0.1.0-alpha.0


## @internal/core@0.1.0-alpha.0


## @internal/playground@1.15.0-alpha.0

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-06-18 21:19:03 -07:00
dane-ai-mastra[bot]
17f01b5d9d chore: version - exit prerelease mode 2026-06-18 14:09:51 +00:00
dane-ai-mastra[bot]
ad3243ab43
chore: version packages (alpha) (#18057)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Abhi Aiyer <abhiaiyer91@gmail.com>
2026-06-17 17:40:24 +02:00
Abhi Aiyer
3af9738ce7
fix: bump all 31 packages past tombstoned versions (easy-day-js) (#18069)
Co-authored-by: Mastra Code (alibaba-token-plan/qwen3.7-max) <noreply@mastra.ai>
2026-06-17 12:32:50 +02:00
dane-ai-mastra[bot]
90585396ea chore: version - exit prerelease mode 2026-06-17 04:24:24 +00:00
Dane - AI (Mastra)
a27d561d37
chore(deps): update build tools (#17657) 2026-06-15 13:37:09 +02:00
Daniel Lew
81fe587275
feat(browser): add opt-in recording tools (#17028)
Co-authored-by: Mastra Code (anthropic/claude-opus-4-7) <noreply@mastra.ai>
2026-06-12 16:31:55 -04:00
dane-ai-mastra[bot]
331559f184 chore: version - exit prerelease mode 2026-06-12 02:05:27 +00:00
Dane - AI (Mastra)
871a7984a9
chore(deps): update playwright monorepo to ^1.60.0 (#17851) 2026-06-11 14:50:28 -07:00
dane-ai-mastra[bot]
0d73b75025
chore: version packages (alpha) (#17644)
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
## @mastra/core@1.42.0-alpha.1

### Minor Changes

- Added agent and workspace tool hooks for applications that need to run
logic before and after tool calls execute. Mastra Code now uses agent
hooks so hook handlers run for built-in workspace tools as well as
dynamic tools.
([#17637](https://github.com/mastra-ai/mastra/pull/17637))

  **Example**

  ```ts
  const agent = new Agent({
    name: 'Support Agent',
    instructions: 'Help users.',
    model,
    hooks: {
      beforeToolCall: ({ toolName, input }) => {
        console.log(`Running ${toolName}`, input);
      },
      afterToolCall: ({ toolName, output, error }) => {
        console.log(`Finished ${toolName}`, { output, error });
      },
    },
  });

  const workspace = new Workspace({
    tools: {
      hooks: {
        beforeToolCall: ({ toolName, workspaceToolName, input }) => {
console.log(`Running ${toolName} from ${workspaceToolName}`, input);
        },
      },
    },
  });
  ```

### Patch Changes

- Plan due notification dispatches per thread from a single due snapshot
so high-priority notifications that already emitted summaries are
delivered in full before lower-priority notifications or summaries can
wake the same thread. `Agent.sendNotificationSignal` also accepts an
array of notification inputs so related notifications can be evaluated
against the same initial thread state before any delivery wakes the
thread. ([#17590](https://github.com/mastra-ai/mastra/pull/17590))

- Fixed medium-priority notification summaries so they wake idle agent
threads when they are ready to deliver.
([#17590](https://github.com/mastra-ai/mastra/pull/17590))

- Fixed browser state signals so they no longer show 'Browser is closed'
before the browser is used. Added attribution for browser closes and
active URL changes when the agent or user caused them.
([#17631](https://github.com/mastra-ai/mastra/pull/17631))
## @mastra/agent-browser@0.3.1-alpha.0

### Patch Changes

- Fixed browser state reporting to identify when the agent or user
closed the browser or changed the active URL.
([#17631](https://github.com/mastra-ai/mastra/pull/17631))

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/client-js@1.24.0-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/react@0.5.3-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/client-js@1.24.0-alpha.1
## @mastra/deployer-cloud@1.42.0-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/deployer@1.42.0-alpha.1
## @mastra/longmemeval@1.0.49-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/opencode@0.0.46-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## mastracode@0.22.3-alpha.1

### Patch Changes

- Increased TUI chat scroll buffer from 200/100 to 5000/3000 components,
so you can scroll back much further in conversation history
([#17633](https://github.com/mastra-ai/mastra/pull/17633))

- Fixed state signal placement in streamed MastraCode output.
([#17631](https://github.com/mastra-ai/mastra/pull/17631))

- Fixed the GitHub PR badge in MastraCode so it animates only while
GitHub polling is actively running, instead of restarting whenever the
agent processes a user message.
([#17590](https://github.com/mastra-ai/mastra/pull/17590))

- Added agent and workspace tool hooks for applications that need to run
logic before and after tool calls execute. Mastra Code now uses agent
hooks so hook handlers run for built-in workspace tools as well as
dynamic tools.
([#17637](https://github.com/mastra-ai/mastra/pull/17637))

  **Example**

  ```ts
  const agent = new Agent({
    name: 'Support Agent',
    instructions: 'Help users.',
    model,
    hooks: {
      beforeToolCall: ({ toolName, input }) => {
        console.log(`Running ${toolName}`, input);
      },
      afterToolCall: ({ toolName, output, error }) => {
        console.log(`Finished ${toolName}`, { output, error });
      },
    },
  });

  const workspace = new Workspace({
    tools: {
      hooks: {
        beforeToolCall: ({ toolName, workspaceToolName, input }) => {
console.log(`Running ${toolName} from ${workspaceToolName}`, input);
        },
      },
    },
  });
  ```

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda),
[`f2ab060`](f2ab060162)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/github-signals@0.1.1-alpha.0
  - @mastra/agent-browser@0.3.1-alpha.0
## mastra@1.12.3-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/deployer@1.42.0-alpha.1
## @mastra/deployer@1.42.0-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/mcp-docs-server@1.1.46-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/playground-ui@33.0.0-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/client-js@1.24.0-alpha.1
  - @mastra/react@0.5.3-alpha.1
## @mastra/server@1.42.0-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/express@1.3.30-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/fastify@1.3.30-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/hono@1.4.25-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/koa@1.5.13-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/nestjs@0.1.14-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/server@1.42.0-alpha.1
## @mastra/github-signals@0.1.1-alpha.0

### Patch Changes

- Gate GitHub signal notifications behind author permission checks to
guard against prompt injection from random commenters. Only comments
from users with write access (admin, maintain, write) trigger
notifications. Bot comments are opt-in via an allowlist that defaults to
CodeRabbit and Devin, with `ignoredBots` still available as an explicit
blocklist. Unauthorized latest comments are excluded before notification
classification so noisy bot edits do not render in notification metadata
or mask the latest authorized comment. Scheduled polls now include
comments and detect latest-comment timestamp changes so comment
notifications are not lost behind stale or unchanged thread hashes.
Comment activity notifications render the latest authorized comment
author and excerpt as high-priority GitHub signal updates.
([#17590](https://github.com/mastra-ai/mastra/pull/17590))

  New options on `GithubSignalsOptions`:
- `authorizedPermissions` — permission levels that authorize human
commenters (default: `['admin', 'maintain', 'write']`)
- `authorizedBots` — bot logins authorized to trigger notifications
(default: `['coderabbitai[bot]', 'devin-ai-integration[bot]']`)
- `ignoredBots` — bot logins whose comments should NOT trigger
notifications, even if authorized
- `permissionResolver` — injectable resolver for looking up collaborator
permissions (default: `gh api`)

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
## @mastra/temporal@0.1.13-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/deployer@1.42.0-alpha.1
## create-mastra@1.12.3-alpha.1


## @internal/playground@1.12.3-alpha.1

### Patch Changes

- Updated dependencies
[[`2bccba4`](2bccba4c03),
[`2bccba4`](2bccba4c03),
[`f2ab060`](f2ab060162),
[`5d302c8`](5d302c8eda)]:
  - @mastra/core@1.42.0-alpha.1
  - @mastra/client-js@1.24.0-alpha.1
  - @mastra/react@0.5.3-alpha.1
  - @mastra/playground-ui@33.0.0-alpha.1

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-06-06 09:16:55 -07:00
devin-ai-integration[bot]
f2ab060162
fix(core): suppress spurious "Browser is closed" state signal and add close reasons (#17631)
## Description

Two fixes to the browser state signal:

1. **Suppress "Browser is closed" when the agent never used the
browser** — if there's no previous state signal (browser was never
reported as open) and the browser is currently closed, the signal is
suppressed entirely. This prevents confusing messages when an agent has
a browser configured but the user/agent hasn't actually used it.

2. **Add `closeReason` to differentiate why the browser closed** — new
optional field on `BrowserContext` with values `'agent' | 'user' |
'process_restart' | 'error'`. The formatted state signal message changes
based on the reason:
- `process_restart` → "The session process restarted, which closed the
browser."
   - `user` → "The user closed the browser."
   - `error` → "Browser closed unexpectedly due to an error."
   - `agent`/default → "Browser is closed."

The `closeReason: 'error'` is now set in `agent.ts` when
`getBrowserState()` throws. Other reasons (`process_restart`, `user`)
can be set by callers that have that context (e.g. the session runtime
or viewer registry).

## Related issue(s)

Fixes the issue discussed in Slack where the state signal showed
"Browser is closed" even when the agent hadn't used the browser at all.

## Type of change

- [x] Bug fix (non-breaking change that fixes an issue)
- [x] New feature (non-breaking change that adds functionality)

## Checklist

- [x] I have linked the related issue(s) in the description above
- [x] I have made corresponding changes to the documentation (if
applicable)
- [x] I have added tests that prove my fix is effective or that my
feature works
- [ ] I have addressed all Coderabbit comments on this PR

Link to Devin session:
https://app.devin.ai/sessions/34fece46417c4d0cb01a1a73e3871126
Requested by: @TylerBarnes

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## ELI5

The PR prevents a misleading "Browser is closed" message when the agent
never opened the browser and attaches a short reason for why a browser
closed (agent, user, process restart, or error) so state messages are
accurate and useful.

## Changes Summary

### Core Changes

- Suppress spurious closed signals
- computeStateSignal() no longer emits a plain "Browser is closed" state
when the thread has never previously reported the browser open; closed
signals are only emitted when there is a meaningful prior open-state in
the thread history.
  - Adds logic to avoid emitting ambiguous "bare closed" deltas.

- Close reason tracking and messaging
- BrowserContext / persisted BrowserState gains optional closeReason?:
'agent' | 'user' | 'process_restart' | 'error'.
- computeStateSignal preserves or infers closeReason and uses it to
format messages:
- process_restart → "The session process restarted, which closed the
browser."
    - user → "The user closed the browser."
    - error → "Browser closed unexpectedly due to an error."
    - agent/default → "Browser is closed."
- Delta formatting for open: false uses the closeReason text instead of
a generic closed message.

- Agent error-handling
- packages/core/src/agent/agent.ts: when getBrowserState() throws, the
resolver returns { isOpen: false, closeReason: 'error' } so exceptions
are attributed to 'error'.

### Browser / Agent-Browser Changes

- AgentBrowser
- Tracks per-thread (and default) close reasons and agent-driven
active-URL changes.
- Persists thread-aware closed state including tracked closeReason and
activeUrlChangeSource.
- Clears tracking maps on launch; closeThreadSession override saves
thread-specific last state.
- getBrowserState(threadId) routes through thread-aware logic to include
closeReason/activeUrlChangeSource.

- Close tool
- createCloseTool records agent-initiated closeReason ('agent')
(thread-aware) before closing.

- Navigation tools
- goto/back/new/switch record agent-driven URL changes so
activeUrlChangeSource can be attributed correctly.

### Persistence & Thread Manager

- Thread-manager persistence schema updated to include optional
closeReason and activeUrlChangeSource.
- updateBrowserState now shallow-copies incoming state and preserves
extra fields (so closeReason/activeUrlChangeSource are not dropped).

### Mastracode / UI Streaming Fix

- Anchors streamed state_signal components before the active assistant
text component so later assistant text updates do not push the signal
down the chat stream.
- Adds a TUI regression test ensuring the state signal is inserted and
the streamed assistant text renders correctly.

### Tests & Docs

- Extensive tests added/updated:
- computeStateSignal tests expanded to cover suppression when browser
was never opened, open-from-remembered-closed with active URL
propagation, close reason attribution (process_restart, user, error),
activeUrlChangeSource attribution (agent vs user), and suppression when
only source metadata toggles.
- agent-browser tests verify preservation and correct inheritance of
closeReason and activeUrlChangeSource behavior.
  - mastracode TUI tests added to verify anchored state signal behavior.
- Changesets updated to document patch releases for `@mastra/core`,
`@mastra/agent-browser`, and `mastracode`.
- Minor CI/test/ESLint adjustments included.

### API / Interface Changes

- Interface updates:
- BrowserContext / BrowserState: added closeReason?: 'agent' | 'user' |
'process_restart' | 'error'
  - BrowserState: added activeUrlChangeSource?: 'agent' | 'user'
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: tyler <tylerdbarnes@gmail.com>
Co-authored-by: Mastra Code (openai/gpt-5.5) <noreply@mastra.ai>
2026-06-05 19:28:09 -07:00