2025-05-13 - Mastra Release
Agents
- Preserve existing thread metadata when the generateTitle flag is set. #4160
- Integrates workflows into agents. #4199 [IMPORTANT]
- Fix recursion issue in the codebase. #4205
- Fix bug where the zodSchema shape could cause runtime errors when loading toolsets from SSE MCPs, ensuring safer schema handling. #4207
- Fix agent listen #4150. #4218
- Workflow support to the agent server handlers. #4223
Workflows
- Fix resume workflow when throwing 'workflow run not found' error. #4170
- An issue where the watch workflow was not streaming responses back in the legacy workflow. #4185
CLI / Playground
- The playground to set the runtime context for agents, tools, and workflows. #4146 IMPORTANT]
- 'instructions' API feature changed to be available only in the playground. #4204
Client SDK - JS
- Fix bug in the client-js by specifying $refStrategy: 'none' when calling zodToJsonSchema to prevent provider errors with shared zod schemas. #4149
- Support for custom message ID generation via
experimental_generateMessageId
in core, and removes it from client-js types due to its non-serializable nature. #4191 - Add limit query option to the client-js getMessages function, allowing control over the number of messages retrieved. #4222
Deployer
- Support for passing MCP servers to the mastra class, introduces new API endpoints for posting messages and SSE capabilities to MCP servers, and maintains compatibility with deprecated MCP specifications. #4131[IMPORTANT]
- Add Mastra Linting to code and updates related documentation. #4179
Developer Tools & UI
- The post-create instructions in the create command now display the correct package manager command based on the user's environment, improving accuracy and user experience. #4153
- Fix documentation search UI and fixes errors related to multiple tool calls in AGUI chat. #4183
- Add Node.js engine specification to the create-mastra project's package.json file. #4214
A2A
- Support for Google's A2A (Agent-to-Agent) protocol in Mastra. #4033 [IMPORTANT]
MCP
- A new getResources() method to the MCPClient class, enabling clients to retrieve resources from connected MCP servers, updates documentation and tests, and maintains backward compatibility. #4181 [IMPORTANT]
- Documentation for the Klavis AI MCP registry. #4201
- Ensure that handlers in MCP can only be registered once, preventing duplicate registrations. #4215
- Utilize streamSSE for improved server-sent event handling. #4187
- Fix MCPClient and MCPServer to handle complex JSON schemas by using the zod-from-json-schema library for in-memory schema conversion, resolving serialization issues with non-serializable schema parts. #4220
- Support for passing runtime context to the logger in MCPClient tool calls and includes tests to ensure context isolation between calls and servers. #4230
Observability
- Fix handling of 'from date' and 'to date' in traces. #4210
- Fix Partitioning by 'createdAt' in ClickHouse tables to align with best practices and avoid creating a new partition for each timestamp. #4129
Storage
- Fix describeIndex function in PGVector to correctly handle custom schemas by checking index existence using both index name and schema instead of just the table name. #4193
- Deprecate updateIndexById and deleteIndexById methods in favor of using updateVector and deleteVector. #4192