2025-06-10 - Mastra Release

Agents

Improve agent structured output processing in core to use the @mastra/schema-compat utility, enabling support for any schema type (not just zod objects) in streamObject and generateObject. #4829 [IMPORTANT]

Improve Playground layout by simplifying container height management, improving sidebar width responsiveness, enhancing chat title readability, equalizing chat/info column widths, and refining the chat container's scrolling behavior for a cleaner and more user-friendly UI. #4524
The dev server retry logic only triggers when the server is actually running and resets the retry count on code changes. #4694
Dynamic port selection to the development server, allowing it to automatically use the next available port if the default is already in use and not explicitly set. #4672
Fix issue with the development command. #4756
Modify placeholder text on runtime context to only be applied within the instructions playground, addressing issue #4500. #4846
Introduce --env flag for the 'mastra dev' and 'mastra build' commands. #4841
Fix workflow user experience by displaying the final output in the dynamic form's aside bar. #4665
Reusable MainContentLayout and MainContentContent components to structure main content with multiple layout variants and includes a temporary dev tool for visual debugging. #4670

SDK to infer object types from output and experimental_output, aligning its behavior with the overloading approach used in mastra/core Agent. #4233

Fix up the MastraError class by removing an accidental log, allowing the domain to be passed as a string, and enabling exception tracking for runtime monitoring in Cloud environments. #4755
Improve thread title generation process to avoid sending full file or image URLs, reducing token usage now that UIMessages are stored. #4828
A bug related to the generation of dynamic ports. #4842
Paginated functions to the MastraStorage class to support handling paginated data. #4864
The handling of 'runtimeContext' from the request body to the middleware layer. #4847
Fix @mastra/core dependency from instrumentation.js by installing it locally in the build directory, addressing issue #4503. #4844

Support for MCP prompts to both MCPServer and MCPClient. #4566
Drop use of @latest from the docs server and scaffolding to resolve npx caching issues that were causing server startup failures. #4825
The MCP server URL to include versioning ('v1') and improves documentation with additional details and a callout to the Mastra adapter in the Ampersand AI SDK. #4794
Fix mastra MCP tool to allow direct use of npx for cursor and windsurf commands on Windows, removing the need for the previous 'cmd /c' workaround. #4758

Fix inaccurate token limiter estimations in @mastra/memory, resolving a failing test caused by recent MessageList changes. #4762
A configuration option to the @mastra/memory module enabling semantic recall to retrieve memories across threads for the same resource. #4845 [IMPORTANT]

Basic filtering capabilities to logs and updates related tests. #4706
Pagination support for logs in the system. #4768
Telemetry (PostHog) from starting on Brave browsers by detecting the presence of the navigator.brave object. #4839

Pagination support to several storage APIs and introduces a new paginated getEvals method while beginning deprecation of getEvalsByAgentName. #4652 [TIER2]
Pagination support to several storage API methods and introduces a new paginated 'getEvals' method while beginning to deprecate 'getEvalsByAgentName'. #4631 [TIER2]
Add code to use the new paginated API for PostgreSQL-related functionality. #4791
The @mastra/mongodb package by adding a missing format to MongoDB that was accidentally omitted when MessageList was introduced. #4827
LanceDB by implementing MastraVector and MastraStorage interfaces, adds comprehensive unit tests, updates documentation, and includes a changeset. #3324 [TIER3]
An alterTable function to storage adapters for easier schema changes, updates storage adapter tests for consistency, and ensures messages are deleted when threads are removed. #4769 [TIER2]
Upstash to use new paginated APIs while preserving and deprecating the old non-paginated APIs. #4861
An issue with workflow snapshot persistence in DynamoDB by replacing create() with upsert() to allow updates, and adds a test to verify updating existing snapshots. #4790
The message deduplication logic for libsql and PostgreSQL when using selectBy. #4866

An issue by displaying tool import errors when the server starts. #4673
Relocates tool compatibility logic into a new @mastra/schema-compat package, generalizes terminology, exposes a schema compatibility function, updates tool schema conversion to use the new package, and adds tests. #4557 [IMPORTANT]

Fix a UI crash in the new workflow experience by safely handling primitive outputs and displaying them in a text field. #4667