Mastra Release - 2025-06-03

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

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

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

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

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

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

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

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]

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

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

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

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

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

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