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

2025-07-01 - Mastra Release

Agents

• Make sure the asynchronous title generation process is properly awaited, preventing failures if the process closes before title generation completes. #5538

CLI / Playground

• Fix create-mastra Gemini selection #5458
• Make playground use workflow stream instead of the watch method for improved workflow handling. #5491
• Start end-to-end tests for the playground using Playwright. #5110
• Fix issue in the playground by ensuring the correct suspend schema is displayed for nested workflows. #5558
• Fix 'epipe' issue on Windows by ensuring the same Node.js version is used, improving pipe support and addressing a related bug (#5186). #5578

Playground UI

• Fix display of custom chat thread titles in the UI, fixing a regression where they were previously removed. #5525
• Visualizations for the sleep, sleepUntil, and waitForEvent functions. #5579
• Add Model settings to be shared between cloud and playground, and adds an onSave callback to enable saving settings in the cloud. #5526

Memory

• Support for specifying a custom language model when generating titles in the Memory module, allowing users to override the default model set on the agent. [TIER2] #5472
• The message-list to display memory assistant messages separately instead of combining them, and adjusts the AgentNetwork display to support this new message format. #5514
• The code by removing persistence capabilities from model settings, limiting storage to localStorage only. #5582
• Private methods in the Memory class to protected, enabling them to be overridden in subclasses. #5564
• Error handling in MessageList by providing clear, actionable error messages when users pass messages with undefined or null content, replacing vague prompts to open a GitHub issue. #5590

Networks

• Fix ssues with AgentNetwork UI message display and saving during loopStream, ensuring agent call results are properly shown and stored after refresh. #5474
• Improving the prompting mechanism to enable better decision-making. #5523

Observability

• Fixes for custom transports and the pinoLogger component. #5498
• Fix issue where trace durations were not displaying correctly. #5535

Storage

• Make Database connection objects public in PostgresStore and PgVector classes, enabling direct database operations, connection monitoring, and enhanced test coverage for these new capabilities. #5466

MCP Course

• Fix transactions tool in the course module to use CSV format. #5530

Tools

• Make tools bundling process compatible with Cloudflare Workers by treating '#tools' as an external dependency, improving module exports, and adding a plugin for correct import resolution. #5531
• Fix ClientTools to stream the tool-result part #5580
• @mastra/core to filter out tool invocations that do not produce results, addressing issue #5016. #5566

Voice

• Fix audioData sending process to convert int16 data to base64 format, addressing issue #5516. #5576

Workflows

• Fix bug by ensuring the correct step ID is used for nested workflow steps in watch-v2. #5496
• The workflow graph to display resume data on each step, enhancing workflow visualization. #5497
• Execute() function now automatically receives a runCount parameter, enabling easier tracking of iteration counts in loop constructs like dountil, dowhile, and foreach. #5177
• Fix issue where workflow results were not being displayed. #5533
• Add .cancel() method to workflow runs, enabling workflows to be programmatically cancelled. [IMPORTANT] #5534
• Fixes a bug where exposing nested workflows at the top level caused Inngest to throw a duplicate function ID error due to workflows being registered multiple times. #5581
• Edit starter template workflow to use the existing agent instead of creating a new one, promoting best practices and reflecting recent changes to example additions. #5529

2025-06-24 - Mastra Release

Agents

• Fix the return type of the getAgentsHandler function. #5201
• Fix bug where telemetry settings were ignored when calling Agent.generate with experimental_object, ensuring telemetry preferences are now respected in this code path. #5202
• Fix build failures by removing duplicate error domains caused by a bad merge and also deletes the unused 'UNKNOWN' error domain. #5226
• The core to pass the runId to onFinish and onStepFinish callbacks, enabling direct evaluation of tool-call and tool-result events during agent execution. #5299
• Add the request's AbortController signal to the Agent's generate and stream methods to enable request cancellation support. #5428
• Add automatic client tool calling #5445
• And resolves issues related to streaming functionality. #5452

Client SDK - JS

• Fix handling of runtimeContext for text/plain request bodies in the mastra server and ensures the client SDK sends application/json for POST and PUT requests. #5231
• Client-side execution of clientTools in the clientSDK agent's generate and stream functions. #5305

Developer Tools & UI

• Fix OpenAPI routes that are always displayed by fixing a bug that previously prevented them from showing. #5208
• Improve dynamic form handling to better support various schemas. #5230
• Remove 'recharts' and 'ramada' libraries from the project. #5339
• Fix icon display issue by standardizing agent identification to use only the part before the dot (e.g., 'openai'), ensuring consistent handling regardless of response type. #5443

Course

• Adds a new lesson 4 focused on workflows. #5311

Misc

• Mastra class and core evaluations to wrap errors with Mastra Errors for improved error handling. #4838

MCP

• Fix MCP server and client to throw mastra errors, improving error tracking during build and runtime. #5116
• Schema compatibility issues related to Claude. #5301
• Adds support for structured output schemas to both MCPServer and MCPClient. #5235
• Add Elicitation capabilities to both MCPClient and MCPServer, provides an example of its usage, and fixes multi-client session handling on the server. #5310
• Object.passthrough schemas for compatibility with some MCP servers, except when using OpenAI reasoning models, improving interoperability at the cost of potential performance issues. #5442

Memory

• Add updateMessages API and message metadata support to memory and storage modules, implementing the feature for PGStore and LibSQLStore adapters. #5188
• Fix issue where tool call messages were incorrectly sent as the first message in LLM context, which caused errors with some providers, by ensuring the first message is not a tool call. #5218
• Add working memory tests to improve or modify its behavior. #5225
• Add Per-resource working memory across multiple @mastra packages, including feature implementation, storage adapter support, tests, documentation, and manual verification. [IMPORTANT] #5221
• Fix issues with working memory by removing duplicate tool calls and redundant LLM prompts, preventing double requests and potential infinite loops when working memory is enabled. #5358

Storage

• Issues with PGStorage and other storage adapters to ensure semantic recall and lastMessages can be used together and that disabling lastMessages works as intended across all adapters. #5215
• All stores to throw mastra errors, improving error tracking during builds and runtime. #5092
• A bug in MongoDB storage by ensuring eval results are parsed so they display correctly in the playground UI. #5298
• Fix MongoDB trace queries by correctly handling wildcard searches with regular expressions and adjusting attribute access for both BSON and stringified data formats. #5303
• Fix implementation of paginated message retrieval for PgStore and LibSQLStore and adds corresponding tests. #5355
• All storage adapters to upsert messages in saveMessages, preventing duplicate message errors caused by ID constraints. #5286

Workflows

• Add to waitForEvent for a specific event before proceeding. #5080
• Type-safe variable mapping, enhancing type safety and reliability in variable handling. #5210
• Fix issue with workflow watch streaming to ensure correct functionality. #5239
• Add new bail function to allow workflows to exit a step early and updates the return types of suspend() and bail() to any for improved developer ergonomics. [IMPORTANT] #5414
• CreateRun in favor of a new async createRunAsync() method that stores a pending workflow state, adds warnings for deprecated usage, and updates related tests and documentation. [IMPORTANT] #5422

Networks

• vNext AgentNetwork! [IMPORTANT] #5292

Observability

• Fix telemetry installation in development by using a custom loader to source @openlemetry packages from mastra. #5234

RAG

• Add type definitions for metadata filters used with vector databases. #5306

Deployer

• Fix issues with the Netlify and Vercel deployers for both CLI and Git integrations. #5425

CLI / Playground

• Fix a bug where the final output was not displayed on the playground for previously suspended steps. #5207

Tools

• Add runtimeContext variables in createVectorQueryTool. #5295

2025-06-17 - Mastra Release

Agents

• Improve typings in agent stream by separating concerns, introduces experimental output handling, and generates typings for improved type flow and structure. #4483
• Add thread metadata to agent.stream() and agent.generate(), restructures their arguments for clarity and future extensibility, and deprecates the old argument format for backward compatibility. #5108
• The type definition for stream event unions, ensuring correct event type handling. #5086
• A bug by ensuring the resourceId is passed to the __stream function for accurate debug logging and error information. #5119
• Fix issue introduced in a recent MessageList refactor by allowing any input message format to be passed to the generate title function in @mastra/core, restoring compatibility with previous input types. #5136
• Dynamic default LLM options, allowing context messages to be set by default in the playground for improved usability. #5184

CLI / Playground

• Reorganize code by moving the evals fetching logic from the playground-ui package to the playground package. #4568
• Move workflow fetch logic from the playground-ui package to the playground package. #5075
• Support for importing modules without file extensions, such as 'lodash/fp/get', in development mode and includes a changeset. #5107
• Improve CLI by providing more descriptive error messages to help developers understand and resolve issues more easily. #5128
• Fix playground agent's streaming functionality by adding a transfer encoding header for dynamic content and includes a changeset. #5132
• Add Workflow-related hooks to the playground directory for better code organization. #5133

Deno Support WIP

• Deno support by using globalThis for compatibility. #5103

Deployer

• Fix Vercel deployment process to use Vercel's build output for deploying functions and adds a changeset. #5179
• Allow deployer package to throw Mastra Errors during application build and bundling, enabling better error categorization in the cloud. #4883

RAG

• LaTeX support to the getSeparatorsForLanguage method, enabling correct chunking of LaTeX documents and fixing errors when using the 'latex' strategy in MDocument.chunk(). #4882

MCP

• Multiple fixes to resolve MCP server and client connection issues over streamable HTTP. #5088
• Improve MCP connection handling. #5089
• Add MCP Bar, including its description and URL, to the MCP Registry Registry documentation. #5099
• Duck typing for agent checks after bundling, ensuring agents are correctly recognized even when not instances of the Agent class. #5193
• Add client connection logic for MCP. #5197

Memory

• Update thread's updatedAt timestamp is automatically refreshed whenever new messages are saved, providing accurate conversation ordering and activity tracking across all storage providers without breaking existing APIs. #4814
• Structured memory. #5091 [IMPORTANT]
• Fix regression in the deprecated fetchMemory API by restoring message return logic and adds tests to prevent future issues. #5140
• Fix compatibility issue with PostgreSQL 15 by adding explicit aliases to all subqueries in the FROM clause when retrieving messages, ensuring proper memory retrieval when the scope is resource. #5182
• Fix return value and type for the fetch memory function in the core module. #5192

Observability

• Add logging to help identify circular dependencies. #5185

Storage

• Fix and quote table and schema names in PostgreSQL, ensuring that camelCase and uppercase index names are preserved correctly. #5148
• Fix bug caused by a bad import by correcting the dynamic 'crypto' require in Upstash. #5181

Tools

• Add logic to the tools glob pattern to only include JavaScript and TypeScript files, preventing unintended bundling of other file types. #5125
• Make sure all tool exports are analyzed, even if they are unused, to guarantee complete export coverage and fixes issue #5149. #5180

Voice

• Support for the Gladia speech-to-text service as a new feature. #4459 [IMPORTANT]
• Voice handlers to use the async agent.getVoice() method instead of the deprecated agent.voice getter, ensuring compatibility with dynamic (function-based) agent instructions and adds comprehensive tests for this scenario. #5070

Workflows

• New .sleep() and .sleepUntil() methods to the Workflow, enabling workflows to pause execution for a specified duration or until a specific time. #5063 [IMPORTANT]
• Fixes a TypeScript type inference bug in the workflow.parallel method that caused compilation errors for consecutive parallel workflow executions, without affecting runtime behavior. #4658
• Add correct typings within workflow-related code. #5084
• Add workflow retrieval logic to fetch workflows from an agent if they are not found on the Mastra instance. #5083
• Add a new API for polling workflow execution results and includes corresponding test updates. #5061
• Fix the final result of a workflow, as referenced in issue #3788. #5105
• Add tests and updates documentation for the 'dountil' workflow's suspend-resume functionality. #5127
• An issue where the runtime context was showing as undefined even when it was correctly passed from the frontend. #5130

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]

CLI / Playground

• 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

Client SDK - JS

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

Core Platform

• 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

MCP

• 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

Memory

• 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]

Observability

• 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

Storage

• 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

Tools

• 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]

Workflows

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

2025-06-03 - Mastra Release

Agents

• Fix issue where getTask was undefined by ensuring the correct agent ID is used. #4548
• Fix bug by adding runtime context to the generateTitle function and updates related tests. #4543

CLI / Playground

• Distinct icons for agent and workflow tools in the MCP server to visually differentiate them from regular tools. #4490
• The backdrop blur, reduces dialog animation duration, tidies up font sizes, and improves the search user experience. #4518
• The agent list scrolling issue by adding overflow and height to the container and setting a background for the fixed table header. #4604
• PDF and TXT file support for multi-modal functionality. #4607
• Fix issue where using the --default flag with the create command incorrectly triggered the interactive prompt, ensuring the prompt is skipped as intended. #4618
• Add 'mastra start', a CLI command to run built Mastra applications in production mode, along with corresponding reference documentation and a changeset. #4379
• Ensure playground UI passes authentication headers from its components to the mastra client, enabling proper operation in cloud environments that use authentication middleware. #4528
• Fix issue where disabling telemetry in the playground was not working and removes an unnecessary Vite environment variable conversion. #4545
• Move the traces fetch logic from the playground-ui component to the main playground module. #4569
• Move the workflow runs list from the playground package to the playground-ui package. #4605

Client SDK - JS

• Fix issue by adding checks for Node.js built-in modules during dynamic imports. #4549
• Parameter serialization in clientTools by converting zod schema handling to use JSON schema, aligning it with output parameter processing. #4560

Auth

• An abstract MastraAuthProvider class that serves as a base for authentication providers to be implemented by each adapter. #4582 [IMPORTANT]
• A base authentication class for Mastra using JWT. #4583 [IMPORTANT]
• Supabase. #4585 [IMPORTANT]
• Firebase#4586 [IMPORTANT]
• Auth0 #4587
• WorkOS. #4588[IMPORTANT]
• Clerk #4589

Server

• Issues with the mastra development server restarts. #4567
• An issue that prevented access to the playground UI when authentication was enabled by implementing protected authentication in Mastra. #4581

Deployer

• The ability to register server middleware after Mastra has been initialized. #4511
• Issues with handling non-scoped packages in the mastra build process. #4521
• An error log that occurs during the mastra build process. #4612

AGUI

• Remove unnecessary server log from the new mastra project. #4506
• A new feature allowing users to set a runtimeContext in AGUI when using CopilotKit, and updates the documentation accordingly. #4501 [TIER2]
• Support for typing the runtimeContext in CopilotKit, allowing developers to specify its type when setting it. #4535

MCP

• The OpenAPI JSON specification for the MCP server API. #4538
• The MCP Docs Server to utilize the MCPServer component. #4493

Memory

• Fix SQLITE_BUSY errors by adding retry logic, configurable retry settings, improved SQLite DB locking configurations, and a test to ensure reliable concurrent access. #4491
• In-memory message storage to support both CoreMessages and UIMessages using a flexible translation layer, preserving essential UI data and enabling compatibility with AI SDK v5. #4436 [IMPORTANT]
• The contextual recall metric to no longer require answer precision, addressing issue #4439, and includes related test and documentation updates. #4441
• Support Image attachments in the playground by updating message handling to use string representations, adjusts the playground to use core messages, and restores the thread messages endpoint to its previous behavior. #4558 [IMPORTANT]

Observability

• Trace display issues for agents by refactoring the trace context logic, ensuring traces are only provided after data fetching, and limiting TraceProvider usage to the playground UI. #4534
• An issue where telemetry metadata was not properly sent when using agent.stream with experimental_output, ensuring all custom telemetry fields are now correctly transmitted. #4613
• A strongly-typed MastraError class and helper utilities to standardize error handling in @mastra/core/error. #4622

RAG

• Support for database-specific configuration in createVectorQueryTool for RAG, allowing both static and runtime overrides, and updates documentation to reflect these changes. #4552 [TIER2]

Storage

• Fix issue with listing Cloudflare KV namespaces by adding pagination support to ensure all namespaces are retrieved, not just the first 20. #4510
• Type errors in the MessageList for the @mastra/dynamodb adapter to ensure backwards compatibility, following up on a previous PR, with plans to review other storage adapters as well. #4527
• Fix to prevent errors from being thrown when storage is unavailable. #4537
• The serialized step graph to the runs snapshot in storage as a new feature. #4547
• Backward compatibility logic to all storage adapters for public storage APIs to address typecheck issues introduced by recent changes to UIMessages handling. #4530 [TIER2]
• All remaining instances of the deprecated PgVector constructor to the new object-based syntax in documentation and fixture files, ensuring full compatibility with the latest API and eliminating deprecation warnings. #4562
• The LibSQL storage to automatically refresh a thread's updatedAt timestamp whenever new messages are saved, ensuring accurate thread activity tracking and improved data consistency. #4559
• DynamoDB type issues #4620

Tools

• RuntimeContext support to tools and agents in workflow steps, updates related documentation, and includes bug fixes and test updates. #4539 [TIER2]
• Fix tool accessor logic in the tool handler to resolve an issue. #4611
• Fix Issues related to tool access. #4623

Voice

• A helper method to check if voice listening is enabled, exposes it via a new server endpoint, and introduces a corresponding getListener method in the AgentVoice client SDK. #4522

Workflows

• Minor UI improvements for workflow conditions, including adding swagger endpoint links to the header, small style modifications, and a reusable action bar for nodes. #4495
• Directly link and preselect traces from a workflow step when clicking on it. #4496 [IMPORTANT]
• The ability to display step statuses for nested workflows in Mastra. #4505 [IMPORTANT]
• Add runId parameter to the step execute function, refactors related code, and updates tests to fix issue #4260. #4541
• The workflow viewer to use the stepgraph returned in the snapshot when viewing a workflow. #4555 [IMPORTANT]
• The type safety of the workflow DI runtimeContext's get method by restricting key arguments to defined values and accurately narrowing the return type based on the provided key. #3930
• The workflow stream chunk type and adds an extended stream event type. #4596
• An issue with the Inngest base URL configuration. #4606

2025-05-27 - Mastra Release

AGUI

• AGUIAdapter was not sending result messages, resolving errors during mastra's streaming of tool calls. #4398
• Fix getAGUI function to return abstract agents instead of concrete implementations. #4405

Agents

• A bug to ensure tool messages are properly sent to the frontend by improving message conversion. #4427

Playground

• Fix the playground to support undefined values for the temperature and topP model settings. #4406
• Add empty state UI components for agents, workflows, and MCP servers to improve user experience when no data is present. #4417
• Add a multimodal playground experiment, enabling image and speech recognition features behind a feature flag. #4423
• Add empty state UI designs for the agents network and tools sections to improve user experience. #4449
• Make sure playground uses the agent's defaultStreamOptions and defaultGenerateOptions for improved configuration management. #4460
• Fix zoom functionality on the workflow graph for improved user experience. #4475
• The ability to display mapping configuration directly on the graph in Mastra Playground. #4486
• Improve user experience and interface for the default workflow node. #4450
• Add runs list feature to the workflows interface. #4482

Deployer

• Add Verdaccio package registry. #4393
• Support for specifying custom bundle externals in the mastra instance by introducing a bundler config option and updating the bundler to read the external option from this config. #4376
• Handling errors, attempting automatic restarts, and exiting if necessary. #4420
• Fix Cloudflare deployer by adding D1 and KV namespace bindings, updates KV table mapping for compatibility, and fixes workflow deployment issues by removing randomUUID from buildExecutionGraph. #4430

General

• Add script to automatically publish all latest packages as the latest alpha version after a stable release. #4470

Evals

• Add runtimeContext to evals. #4422

MCP

• Agents can be passed directly into MCPServer to automatically create agent tools, updates related documentation, and adds support for passing MCPServers into the Mastra class. #4412 [IMPORTANT]
• Full resource specification support to both MCPClient and MCPServer, including new resource-related notifications, client-server request APIs, comprehensive tests, example agent updates, and reference documentation improvements. #4388
• Passing workflow instances into the MCP server as tools, updates documentation, and adds tests for the new feature. #4434
• Fix issues with the MCP server routes to improve their functionality or correctness. #4468
• The mcp-docs-server to log additional information when non-existent paths are accessed, replacing error throws with enhanced logging. #4485

Memory

• The threadId, title, and metadata properties optional in CreateMemoryThreadParams to align with the documented API specification. #4336

Observability

• Fix OpenTelemetry dependencies for the cloud exporter. #4390

RAG

• Fix markdown chunking to ensure headers are correctly stripped from the output. #4385
• Fix RAG tool type definitions to resolve TypeScript type errors and enforces stricter typing for the execute property in vector-query and graph-rag tools. #4411

Storage

• Support for using MongoDB as a storage backend. #3841
• Upstash storage to use redis.scan instead of redis.keys for better handling of large key sets and adds a batchInsert feature. #4389
• Support for passing options to MongoDBStore, similar to how options are passed in the Vector case. #4414
• An issue where the getWorkflowRuns and getWorkflowRunById functions returned 'Invalid Date' for the createdAt and updatedAt columns. #4416
• That the Storage.init method is automatically called on all setters to guarantee proper initialization. #4477

Tools

• Update the default tools path for discovery in both the dev server and build processes to ensure all tools in the tools folder are detected. #4421
• Support for injecting runtime context parameters into the vector-query and graph-rag tools, allowing users to customize fields like indexName, vectorStoreName, topK, and filter at runtime without modifying the tools or prompts. #4433

Workflows

• Fix a bug that caused duplication of items in array results within workflows. #4399
• Update workflow configuration in the weather-agent template. #4397
• Improve documentation for workflows in the reference tab. #4407
• Streaming support for workflows by introducing a new 'stream' function that provides a readable stream interface for workflow execution, similar to the client-js watch SDK, and includes related test updates. #4232 [IMPORTANT]
• Improve workflow run response by including detailed step information and error stacks in the returned workflow state, providing more visibility into each step's status, payload, output, and errors. #4432

2025-05-21 - Mastra Release

This release introduces several breaking changes. For more information on breaking changes please refer to this blog post

Workflows

• Type corrections for the getInitData function to improve type safety and accuracy. #4323
• New type for vNext workflow run. #4236 -Fix type issues in inngest workflows. #4249
• Fix workflow run process to improve its structure and clarity. #4335
• A description field to the vnext workflow response. #4337
• Fix display and clarity of workflow run step results, improving their presentation and usability. #4338
• BREAKING change by renaming 'vnext' to 'workflow' and the previous 'workflow' to 'legacy workflow', along with related test updates. #4358

Memory

• Fix agent messages containing working memory references were not saved to the database by filtering out those references instead of skipping the messages entirely. #4303
• Add new MessageList class that unifies and converts various message types (UIMessage, Message, CoreMessage, Memory) into a consistent storage format, laying the groundwork for future integration with agents and support for AI SDK v5 UIMessages. #4287
• BREAKING CHANGES to the Memory module by removing default store/vector/embedder fallbacks, inheriting storage from the Mastra instance if set, updating memory defaults, and revising related documentation and samples. #4309

Storage

• Validation and parameterization across clickhouse, cloudflare-d1, postgres, and libsql to enhance SQL injection protection. #4244
• BREAKING CHANGE: The use of positional arguments in all public vector store functions, requiring object parameters instead for consistency ahead of a full deprecation on May 20th, 2025. #4284
• A new DynamoDB storage backend for Mastra using a single-table design with ElectroDB, supporting all core operations and optimized for serverless environments. #4013
• BREAKING CHANGE to all vector stores by removing positional arguments from public functions and constructors, replacing deleteIndexById and updateIndexById with deleteVector and updateVector, and cleaning up deprecated variables and tests. #4347
• BREAKING CHANGE The direct libsql dependency from @mastra/core, eliminating built-in LibSQL storage implementations and requiring users to explicitly install and configure @mastra/libsql for LibSQL storage support. #4368

MCP

• New list and get routes for MCP servers according to the latest spec, introduces server versioning and optional parameters for backwards compatibility, allows custom server IDs, and includes comprehensive test coverage for the new features. #4243
• An issue where all input fields were incorrectly coerced to required in MCP and core modules, ensuring optional arguments remain optional and preventing breakage in many MCP servers. #4341
• The documentation for Apify and adds corresponding tests. #4366
• The MCP Servers list page and adds a new MCP server details page to the Playground. #4377

CLI / Playground

• Handling broken images in the playground. #3509
• Playground agent settings are preserved across page refreshes. #4227
• Support for browsing, inspecting, and executing tools on mastra MCP Servers directly from the playground UI, including new backend routes to enable these features. #4279
• Fix CORS issues in playground development by adding a proxy to route API requests to the mastra server. #4274
• Improve the user experience and interface of the agents' right sidebar in the playground. #4267
• Fix UI by changing the empty state design for threads. #4288
• Add runtime context page and add formatting, copy-to-clipboard functionality, syntax highlighting, and a documentation link. #4293
• Add tools page UI and adds a search bar for improved usability. #4298
• Fix insufficient spacing in the tool list on the agent page. #4301
• Fix sidebar's user interface for improved usability and appearance. #4334
• Fix issue where the runtime context was not handling overflow scrolling correctly. #4348
• Add missing x-mastra-dev-playground headers to the local tracing exporter and related components. #4357
• Adjust UI to display the agent, workflow, or tool ID next to the copy button for easier identification and copying. #4361
• Make tools not used by agents still discoverable in the playground. #4364
• Fix informational message at the bottom of the screen when memory is not enabled. #4372

Client SDK - JS

• Add the telemetry option to the client SDK's streamParams configuration. #4247
• Omit non-serializable options from agent stream and generate operations, ensuring only serializable data is included. #4250
• Fix trailing slash from the mastraClient baseUrl to standardize URL formatting. #4268
• MastraClient to accept plain objects as runtimeContext. #4272

Core

• @mastra/core to peerDependencies to help deduplicate versions, requiring users to include it in their projects and introducing a breaking change. #3488
• Agent async onFinish and onFinishStep callbacks are properly awaited in the streaming flow, preventing the stream from closing before these callbacks complete and allowing all intended data to be sent. #4148
• Updated Prettier configuration and fixes code formatting issues to ensure lint checks pass. #4189
• Make 'nodemailer' as an external dependency to the mastra bundler. #4295

Server/Deployer

• Add 'all' endpoint to the server route. #4108
• The Vercel deployer can properly handle POST, PUT, DELETE, and OPTIONS HTTP requests. #4275
• Add Mastra server fallback hostname to undefined when not set. #4229

Observability

• Fix traces waterfall visualization to replace the previous stacked progress bars. #4206
• UPGRADED OpenTelemetry JS SDK to version 2.x and excludes additional redundant telemetry storage traces. #4294
• BREAKING CHANGE: Pino logging out of @mastra/core into @mastra/loggers and replaces it in the core with a simpler ConsoleLogger. #4339

RAG

• Fix parsing error related to the fastembed token #4209. #4246
• Add 'sources' array field to the output schema of the vector query and graph RAG tools, enabling users to retrieve detailed results for each query. #4302
• Fix TypeScript error by allowing the return types of createVectorQueryTool and createGraphRAGTool to be correctly inferred, resolving issues with exactOptionalPropertyTypes. #4307
• Fix floating point precision errors in rerank weight summation by using big.js to ensure weights add up exactly to 1. #4322

Tools

• Fix Tool compatibility issues by properly handling ZodOptional and removing unsupported ZodAny types for OpenAI reasoning models. #4306

Auth

• An experimental authentication and authorization system with configurable token verification, rule-based access control, and example usage, along with unit tests and default utilities. #4342

Getting Started

• Ensure create-mastra script to ensure it matches version tags exactly, preventing incorrect matches such as defaulting to the alpha tag when the core version has not been updated. #4256

AGUI

• Move AGUI component from the client side to the server side. #4241

Voice

• Support for passing a runtime context to the OpenAI realtime voice API, enabling tools to access contextual data during realtime sessions. #4305

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

Tools

• Fixes tool compatibility to handle both Zod and JSON schemas and cases where no schema is provided. #4188
• Handle jsonSchema implementations on Vercel tools. #4200

2025-05-08 - Mastra Release

CLI / Playground

• A new '--mcp' option to the mastra project setup command. #4072
• Fix default value handling for number fields in the playground's autoform component. #4119
• Fix tool calls would disappear from the streaming UI during sessions. #4145

Workflows

• The ability to view inner nested workflows within multi-layered nested vNext workflows by updating the serializedStepGraph to return only serializedStepFlow for steps created from a workflow. #4115
• Alpha version of the Inngest runtime, including modifications to the default execution engine to enhance extensibility for the Inngest implementation. #4066
• Error handling by providing a clear, self-explanatory error message when a workflow's execution flow is not defined, and updates related tests. #4141
• Fixes and improvements in using Inngest playground. #4143

Client SDK - JS

• Agent runtimeContext in Client SDK, and adds server-side parsing and related updates. #4117
• AGUI text component fix. #4151
• Copilot Kit. #4127

Server

• A new feature that allows overriding the server body size limit. #4137

Memory

• Fix naming scheme for embedding indexes and adds duplicate index creation checks across various vector stores. #4107
• Message persistence to store all user messages, refactors assistant response extraction to handle both text and structured outputs, and simplifies the getResponseMessages function to accept a direct messages array. #4155

Observability

• Fix setBaggage implementation for tracing to use createBaggage, resolving an issue with Sentry tracing where baggage was not properly defined. #4128
• Fix excessive logging and telemetry updates when retrieving the LLM component for agents by filtering out logger and telemetry settings during this process. #4133

Storage

• Add OpenSearch as a new vector storage backend for Mastra, supporting multiple similarity metrics, metadata filtering, and robust error handling, with full unit and integration test coverage. #2964

Tools

• A tool schema compatibility layer to standardize tool behavior across different model providers by removing incompatible schema properties and appending necessary instructions, ensuring consistent tool usage regardless of the underlying model. #4027

2025-05-06 - Mastra Release

Agents

• Ensure empty assistant messages after tool use are preserved in conversation flows, preventing errors caused by their removal. #3832
• The display of agent name initials on empty threads to show initials like "WA" for "Weather Agent" instead of just the first letter. #3991

Workflows

• Additional test cases to verify Mastra class access within step execution functions. #3980
• A serializedStepGraph to resolve a circular structure error in the code. #3982
• Parameters to filter workflow runs in both workflows and vNextWorkflows, including fromDate and toDate options for telemetry. #4006
• CommonJS imports in the vnext workflow. #4069
• Functionality to collect traces for the vnext version. #4076
• The getWorkflowRunById API to the vNext workflows core and server handlers. #4097
• GetWorkflowRunById in vnext to retrieve a run from this.#runs if it is not found in storage #4101
• The vnext workflow test to improve the project's testing process. #4103
• Dynamic input mappings, enabling more flexible and configurable input handling in the system. #4095

Deployer

• Fails gracefully instead of breaking when tools cannot be imported on platforms like Cloudflare. #4099
• Fixes a bug by ensuring directories are properly traversed when generating vercel.json so that all files are included in the includedFiles array. #4102

Playground

• Refactored the playground UI to receive traces as props instead of fetching them internally, enabling traces to be provided from external sources like Clickhouse. #4004
• The playground UI to display span and trace durations with three significant digits for improved precision. #4017
• Cookie consent component to ensure it only loads with user consent. #4020
• The threads component to unify and synchronize the UI between the cloud and playground environments. #4022

Client SDK - JS

• Remove a custom header, fixing workflow JSON issues, and updating the AI SDK dependency in the JavaScript client library. #3984
• API for retrieving workflow runs. #3996
• Add AGUI client into the project. #4092 [IMPORTANT]

MCP

• Deprecation warning only appears when using the deprecated class, not its subclass. #3988
• MCP tool schema conversion by switching to 'json-schema-to-zod' for more accurate schema handling in the playground, resolving form field type issues and allowing tools without input fields to be submitted without arguments. #3998

Memory

• A deprecation warning for working memory text-streaming in the @mastra/memory and @mastra/core packages. #4012
• A warning to notify users that, starting May 20th, the Memory component will no longer have default storage unless inherited from the Mastra instance, in preparation for an upcoming breaking change. #4083
• The token estimation accuracy in @mastra/memory from 96% to 99% by fine-tuning the base token amount added to messages and tools, resulting in more precise estimates and more reliable tests. #4087
• Support for handling textpart message content when upserting vector embeddings into the memory_messages table. #4086

Observability

• New agent getter methods from telemetry to prevent them from being tracked. #4003

RAG

• The new @mastra/fastembed package to encapsulate the current default embedder, adds warnings for users of the old embedder, and updates documentation to reference the new package in preparation for an upcoming breaking change. #4093

Storage

• Couchbase as a supported vector store in Mastra, enabling vector search and embedding operations via the MastraVector interface. #3739
• Fix typescript errors related to the default proxy storage implementation. #4015

CLI

• A new CLI command, mastra lint, to add linting functionality to the project. #3994 [IMPORTANT]
• cookie consent component to ensure it only loads with user consent. #4020

Quality of life

• The end-to-end tests by migrating the monorepo test setup to use Verdaccio, enabling compatibility with multiple package managers. #3993
• An unnecessary console log that appeared when using the hallucination metric. #3997
• The PostHog dependency to the most recent working version to avoid issues caused by broken ESM exports in newer releases. #4029
• Type mismatches related to the new DynamicArgument wrapper for models, resolving build and test failures by ensuring correct typing when passing models to tools. #4030
• The ai-sdk useCompletion example to correctly use the prompt field from the request body instead of the messages field, improving documentation accuracy. #4098
• The ai-sdk useObject example to correctly utilize the request body, ensuring the documentation accurately demonstrates proper usage. #4100

2025-04-30 - Mastra Release

Agents

• Dynamic agent properties: instructions, model, and tools are determined at runtime based on the provided context. [BIG NEWS] #3883

Workflows

• Getting started with the improvements to the workflow system. #3771
• VNext workflows to return the full error object instead of just the error message, allowing users greater flexibility in handling errors programmatically. #3773
• Issues related to suspended paths. #3772
• Renaming 'container' to 'runtimecontext', adds a steps accessor for stepFlow, introduces getWorkflowRun, and adds vnext_getWorkflows to mastra core. #3784
• VNextWorkflows handlers and APIs to both the server and deployer components. #3791
• Issues related to watching from a different run instance. #3817
• The type inference for result values in the vNext version. #3840
• VNext to unset the currentStep variable when a workflow status change event occurs. #3842
• The vNext workflow trigger to use the resumeSchema, addressing a bug. #3853
• And cleans up issues related to the workflow watch functionality in the vNext branch. #3861
• Functionality to clone existing workflows while allowing the assignment of a new workflow ID. #3859
• The watch cleanup function is called when closing the watch stream controller to properly fix a related bug. #3867
• The documentation to fix the getWorkflow access in vNext examples. #3968

Server

• Fix tools endpoint in API #3778
• An issue in the server handler to ensure audio streams are correctly formatted for playback. #3789

Client SDK - JS

• vNext Workflow support in Client SDK. #3801

CLI

• The mastra CLI's non-interactive mode by adding a --dir option, enhancing the --no-example flag, and unifying project name input, along with related documentation updates. #3765
• Configuration for the Mastra server host, removes a related CLI flag, updates documentation, and includes a changeset. #3868
• A new CLI option to globally configure the cursor for the Mastra MCP docs server, enabling all cursor projects to access the MCP server. #3880

Observability

• Mastra Cloud Exporter: enabling trace data to be sent to Mastra Cloud from various deployment platforms including Vercel, Netlify, and Cloudflare. #3742
• API request logging from the local development server. #3780
• Span transformation for Mastra Cloud is now handled server-side, allowing updates without requiring users to update their package. #3828

Deployer

• Reduce Vercel bundle size by including only generated files from the output directory. #3819
• Fix Netlify deployer by ensuring that tools.mjs is written to the correct folder. #3822
• Fix Cloudflare deployer by removing the use of import.meta.url. #3821

Playground

• The traces UI by introducing a redesigned trace span interface. #3812
• Support for running vNext workflows in the playground as a new feature. #3820
• A bug where the triggerSchema default was not displaying correctly in the workflow UI. #3827
• The x-mastra-dev-playground header to all playground requests to address issue #3741. #3845
• Playground routing model settings for AgentNetworks, enabling configurable routing options in the playground interface. #3864
• Overflow scrolling to the agent traces table and allows passing a custom className to override default behaviors such as height. #3875
• Badges to visually indicate failure or successful traces. #3929
• An issue by adding a click handler to trace rows to improve interactivity. #3933
• Trace visibility and accuracy on smaller devices. #3981

MCP

• Docker as a new MCP registry option to Mastra's MCP registry list. #3846
• Streamable HTTP MCP support to MastraMCPClient and MCPConfiguration, enabling session ID handling and maintaining backwards compatibility by falling back to SSE if SHTTP fails. [BIG NEWS] #3834
• Instance management and caching for MCPConfiguration by caching based on both id and servers, and disconnecting outdated instances to prevent memory leaks. #3759
• Array schema handling in Zod by defaulting to string type when type is missing, prevents errors when items are absent, adds comprehensive tests, and notes lack of 'allOf' support for future improvement. #3892
• A bug related to checking for the presence of constant value mappings. #3978

Storage

• MongoDBVector to add support for using MongoDB as a vector database. [BIG NEWS] #3823
• A pgPoolOptions parameter to the PgVector constructor, enabling custom database connection pool configurations such as SSL settings, and includes related tests. #3833
• Add the ability to retrieve workflow runs by ID and filter workflow runs by resourceID for storage providers. #3807
• Remove unnecessary function from the ClickHouse codebase. #3905
• Support for retrieving workflow runs and individual workflow run details for Cloudflare and Cloudflare D1. #3927
• Deprecation warnings for the PGVector constructor and for passing individual arguments to vectors. #3973

Memory

• Warnings to notify developers about upcoming breaking changes to memory defaults, displaying current and future options unless all are explicitly set, and updates project scaffolding to prevent unnecessary warnings in new projects. #3797

RAG

• Removes the need for an ingestion pipeline. #3798
• Remove llamaindex dependency and introduces local types for handling extraction and documents. #3811

Examples

• The voice agent examples by incorporating lessons from the voice workshop. #3794
• The Mastra examples documentation page to better align with the sidebar, improves organization, and sets the Rag section to auto-expand by default. #3803
• A typo and removes an unnecessary period in the showcase section documentation. #3962

CI / Tests

• Restores missing server unit tests, ensuring they are included in the CI process. #3790
• Previously unrun logging tests for @mastra/mcp and ensures they are executed in the CI pipeline. #3813
• An issue by ensuring that the 'dir' argument is always treated as an absolute path. #3824
• This PR re-enables Renovate after it was accidentally disabled, ensuring the configuration matches the desired setup. #3847
• The issue labeler to use a local version of dane instead of the global one. #3872
• The reliability of vector tests by skipping Astra, adding a unique index, and wrapping describe, list, and delete operations in try/catch blocks in vectorize. #3967
• A version rebump, likely updating dependency or package versions without introducing new features or bug fixes. #3975

2025-04-22 Mastra Release

BREAKING CHANGES

• We have renamed Container to RuntimeContext #3761

General

• CommonJS support in TypeScript for non-bundler environments, enabling easier migration of older projects to Mastra and adds end-to-end tests for these scenarios. #3613

MONOREPO SUPPORT

• Bundling issues with workspace packages that use native dependencies by detecting such packages among externals, creating tarballs for them, and referencing them locally in package.json to enable proper installation during deployment. #3602

CLI/Server

• Issues with nested import paths (such as firebase-admin/firestore) by making these imports external when bundling fails. #3452
• The bundler to respect the actual NODE_ENV environment variable during development while defaulting to production for standard builds, and adds comprehensive tests to ensure correct environment propagation. #3642 -Server configuration fixes #3669
• Mastra server.build configuration options for swaggerUI, openAPIDocs, and apiReqLogs. #3674

• The correct log level is used in 'mastra dev' by addressing an environment variable change that caused logs to default to 'WARN' instead of 'INFO'. #3758

Storage

• Replace __ functions with a Proxy, fixes a potential infinite loop in storage dev.entry, related bug fixes, code refactoring, and test updates. #3665
• The Postgres store configuration to use 'schemaName' for consistency with the vector implementation and adds validation to ensure connections are present, throwing an error if not. #3681
• Support for Cloudflare D1. #2932
• The $in, $nin, and $contains operators for PG and LibSQL to correctly handle arrays and substring matches, aligning their behavior with Mongo and Upstash. #3725

Memory

• All new messages are saved at least 1ms apart by adjusting createdAt timestamps, adds a function to correct previously misordered tool calls, and includes new tests. #3654
• The Memory module's chunkText function to use character-based chunking instead of tiktoken, improving startup performance while maintaining safe chunk sizes. #3627
• Message ordering in @mastra/core. #3672
• The logic for hiding working memory in messages changed to use a non-mutating update function instead of a mutating one. #3720
• A previous change to TokenLimiter caused new messages to be incorrectly inserted into the memory messages array. #3763

Deployer

• Build process include tools directory #3668

RAG

• Upgraded 'llamaindex' dependencies to newer versions. #3503
• Remove LlamaIndex extractors and replace them with custom Mastra extractors. #3647

Client SDK

• Fix memory thread creation. #3753
• Fix voice speak method. #3766

MCP

• Error messages to include the name of the MCP tool that failed, making it easier for consumers to identify the source of connection errors. #3664
• MCPServer Class, enabling users to create their own MCP server with custom tools. #3714

Voice

• The OpenAI realtime voice provider to emit tool call result events, enabling real-time feedback on tool execution outcomes. #3657
• Fix WebSocket connection issues in OpenAI Realtime #3671
• OpenAI realtime tool result. #3680
• Voice reference handling and tool-call-start functionality. #3683

Observability

• External dependencies specified in the telemetry configuration, such as those required by third-party exporters like Langfuse, are properly installed to prevent runner failures. #3762

Agent Network

• Add RuntimeContext to AgentNetwork. #3653
• Fix table layout issue in the Agent Network section of the Playground, aligning its design with recent updates made to the Agent and Workflow sections. #3744

2025-04-15 Mastra Release

This release was a grind. We addressed some overdue issues with our deployers. Hopefully this is a step in the right direction. We will continue doing right by the community and squash issues!

Deployer [IMPORTANT]

• cross-platform support and updates deployment documentation for Vercel, Netlify, Cloudflare. #3618
• Revamp the deployment experience for Mastra. #3581
• Deprecating the existing deploy command and introducing a new build deployer output. #3555

Memory

• Add 'createdAt' timestamp to UI messages during memory conversion to address missing timestamps in UI components. #3536
• The Memory instance to operate without a vector store or embedder by disabling semantic recall or setting the vector option to false, providing flexibility for users to opt-out of these features. #3529
• ensuring message content is only filtered if it's an array #3589

Storage

• @mastra/pg`, allowing custom schemas for storage and vector modules without affecting the main schema. #3463
• Add a helper function to check permissions for creating vector extensions in PostgreSQL. #3492
• Error logging for vector query and graph rag tool to provide more detailed error information. #3632
• Added error and debug logging to vector-query and graph-rag components. #3629
• An issue with traces not displaying in the playground by removing unnecessary wrapping in a traces object. #3572

Tools

• Add execution container for tools when called from the API or playground #3626. #3628
• Adds logging functionality to the MCP documentation server. #3530
• The MCP Registry Registry MCP Server to maintain the MCP Registry Registry meme. #3575
• Parallelization of MCP connections to enhance performance. #3592
• Configurable timeouts for MCPConfigurations, extending beyond the default 60 seconds. #3571

Workflows

• We will be releasing a new preview of Workflows vNext 2025-04-16. More details to follow. [IMPORTANT]
• Add a dynamic form using Zod schema for workflow input in the playground UI. #3607
• Various path changes, including memory document redirection and path fixes. #3546

Client SDK - JS

• Client-side tool calling functionality, prepping integration with CopilotKit. #3549

Playground

• Fix validation error preventing form submission when the trigger schema is an enum in the playground UI. #3616
• Allow users to toggle between stream and generate modes in the playground. #3576 -Restoring data display functionality. #3585
• Refactor headers across all pages to use the DS version, eliminating layout shifts and problematic styles. #3579
• A feature to bundle design tokens as both ESM and CJS in the playground UI to support Tailwind usage in the CLI/playground. #3577

Continuing bug fixes found in latest.

General

• Fix yarn workspace integration (#3519)

Docs

• Docs have been redesigned and implemented (#3109)

Playground

• show status UI on the playground for workflows without trigger schema (#3511)
• Correctly reset value maxSteps (#3515)

Mastra Server

• Fix infinite await loop in Mastra server entrypoints (#3513)

Storage/Vectors

• Add missing getTraces method to Cloudflare KV (#3499)

MCP

• Removed fastmcp from mcp-docs-server for more stability (#3496)

We made some mistakes with Agent maxSteps in the API and Playground.

Mastra Server

• Custom mastra server cors config (#3486)
• Set default max steps for generate (#3497)

Mastra Release - 2025-04-08

Today we release a new latest version of Mastra. There are several issues lurking we are trying to figure out around the clock right now.

Top issues:

• MCP rough edges, unable to connect, failures in IDEs (if you're around discord a lot you know)
• Memory default embedder "fastembedjs" breaks in certain execution environnments
• Deployers
• Improving Documentation on Memory and MCP/Tools

As for the release itself there is good stuff. Since this our first official release-channel comm, if you want to give feedback on how to better improve it, let me know!

To take advantage of this release please install all modules @latest.

Here's the changes

Getting Started

• Fix example workflow in getting started (#3473)

Playground

• Show "No Input" for empty workflow steps (#2696)
• Nested workflows rendering in dev playground (#3408)
• Leverage autoform for playground dynamic form (#3427)
• Fix workflow sidebar not expanding the output section (#3447)
• Cleanup playground dynamic form (#3449)
• Ability to configure llm settings from playground (#3454)
• Fix playground freezing when buffer is passed between steps (#3484)
• Add our new design system to the playground (#3482)
• Fix scroll issue on playground tools page (#3489)

CLI

• Fix CLI build command to use correct Mastra directory structure (#3435)
• Set disablegeoip to false in getsystemproperties (#3481)

Storage / Vectors

• Cloudflare kv support (#2642)
• Update error message for upsert operations (#3300)
• Clickhouse storage (#3351)
• Add missing ssl property postgres config (#3399)
• Clickhouse ttl configs (#3397)
• Support missing getEvalsByAgentName method in pg and upstash (#3415)
• Move to batch insert for memory management (#3422)
• Update storage initialization and add underscore methods (#3433)
• Check Vectorize index Existence (#3470)
• Update Chroma version and add specific tests (#3471)
• Add missing getTraces method to Upstash (#3472)

Memory

• Fix crash when parsing invalid JSON in memory messages (#3280)
• Add resourceId to memory metadata (#3266)
• Memory processors (#3304)
• Use markdown formatting instead of XML inside working memory tags (#3396)
• Fix memory semantic recall performance and bundle size (#3419)
• Add performance testing suite for memory (#3457)

Agents

• Add defaultGenerateOptions/defaultStreamOptions to Agent constructor (#3143)
• Fix fastembed (#3455) <- Still present on latest. NOT FIXED.

Workflows

• Fix hanging and excessive execution (#3253)
• Unify start and watch results (#3282)
• Accept unique id on step config (#3316)
• GetWorkflows API (#3350)
• Make runId optional for workflow startAsync api (#3405)
• Fix compound subscribers edge case (#3406)
• Loop Variables (#3414)
• Fix if-else execution (#3428)

Client SDK

• Update ai sdk to ^4.2.2 (#3244)
• Remove x-mastra-client-type custom header from mastraClient (#3469)

Mastra Server / Deployers

• Add missing triggerData to the openapi.json for the POST /api/workflow/{workflowId}/start endpoint (#3263)
• Decouple handlers from Hono (#3294)
• Mastra custom API Routes (#3308)
• Vercel deployer fix attempt (#3340) <-- (still present on latest)
• Support port and server timeouts (#3395)
• Make timeout 30s (#3422)
• Add Cloudflare Worker environment variable auto-population (#3439)
• Fix deployer server (#3468) <- Caused more issues (still present on latest)

Voice

• Update voice dependencies (#3261)
• Change listenProvider and speakProvider to input and output (#3343)
• Default agent voice (#3344)
• Voice method references (#3388)

Evals

• Modified evaluation to include output (#3353)

CI / Tests

• Update babel monorepo (#3225)
• Update tests to ensure collection is empty (#3313)
• Remove non-package from changeset (#3346)

Observability

• Exclude more methods from tracing (#3305)
• Add request id to traces (#3342)
• Disable instrumentation if inside web container (#3410)
• Fix tracing and add dual tracing support (#3453)
• Fix error on traces page (#3466)