2025-07-08 Mastra Release
Licensing
Mastra is now licensed under Apache-2.0!!!
CLI/Playground
- Multi-modal playground is ready! [IMPORTANT]. #5605
- Fix issue where the playground's tools endpoint did not include the x-mastra-dev-header. #5638
- Support for the --inspect flag to 'mastra dev' to enable debugging, along with related documentation and a changeset. #5680
- Add 'Send Event' functionality to workflows. #5657
- Fix issue where resetting model settings did not persist the changes to local storage. #5750
Client SDK - JS
- Add support for an abortSignal option to the client SDK, updates documentation, and includes a changeset. #5686
MCP [TIER2]
- Support for handling ZodNull schemas with Google Gemini models, reducing errors and improving compatibility, especially with Gemini Pro. #5755
- Automatically handle structuredObject values and corrects the execute function's return type, enabling tools to be written consistently for both MCP and non-MCP contexts. #5757
- Add support for JSON Schema's $defs and $ref properties by integrating json-schema-ref-parser, enabling proper transformation to Zod schemas. #5761
Memory
- Fix bug in @mastra/core where per-resource working memory queries would fail if the resourceId was not provided. #5617
- Add SaveQueueManager to incrementally and reliably persist message parts during streaming and generation by batching and debouncing saves, reducing data loss risk and preventing race conditions. [IMPORTANT] #5599
RAG [IMPORTANT]
- ZeroEntropy relevance provider and other improvements to @mastra/rag. #5762
Storage
- Support for configuring CloudflareD1Store with a custom D1 client implementation via a new D1ClientConfig option, enabling integration with custom HTTP endpoints while maintaining backward compatibility. #5666 [TIER2]
Mastra Server
- Pass additional request handler context ('extra') to tool execution, allowing tools to access more request-specific information during execution. #5511
Workflows
- Support for passing a function that returns the sleep duration or date to the sleep() and sleepUntil() methods. #5623 [TIER2]
- Add stepId to the error log output for workflow executeStep operations. #5634
- Workflow execution to use createRunAsync [#5521. #5630
- Support for JSON input in workflows. #5675
- Add delay mechanism for workflow retries. #5749
- Throw an error when attempting to resume a workflow run or step that was never started or suspended. #5744