Mastra Changelog 2025-06-06

It’s been a packed week at Mastra. We’re at the AI Engineer’s World Fair giving away fresh copies of Principles of Building AI Agents, 2nd edition. We also released a new course. Let’s dig in…

Mastra 101

We released the first ever MCP-based, IDE-native course: Mastra 101.

Now you can learn all about agents, workflows, MCP, etc., all through your agentic code editor — no videos, books, websites, or apps needed.

Just hook up the Mastra MCP docs server to your code editor and type Start Mastra course to get going.

More instructions and details here.

Mastra Auth

We released Mastra Auth with support for Auth0, WorkOS, Clerk, Firebase, and Superbase.

The new @mastra/auth package implements JWT authentication with core utilities and provider classes.

We also introduces an abstract MastraAuthProvider class. This class establishes a foundation for implementing custom authentication providers and managing protected routes.

Workflows

We introduced a handful of improvements to workflow this week:

• You can now display the step status for a multi-step nested workflows (#4505).
• You can directly link and preselect traces from a workflow step by clicking on it (#4496).

We are hopeful these upgrades will make it easier to design, debug, and iterate on complex workflows.

Memory

There are two big memory updates this week.

First, we fixed image handling in the playground. Now your agents can interpret and engage with image data. This fix was handled by modifying how attachments and messages are processed and ensuring proper display of images retrieved from memory.

Second, we refactored our message processing logic to make it easier to store richer internal representations of messages. We then output that representation into UIMessage format. This change lays the groundwork for AI SDK V5 support.

Other updates

• We added RuntimeContext support to tools and agents in workflow steps (#4539).
• We released a new feature that allows users to set a runtimeContext in AGUI when using CopilotKit. The feature also updates the documentation accordingly (#4501).
• We now support database-specific configuration in createVectorQueryTool for RAG, allowing both static and runtime overrides (#4552).
• We built-in backward compatibility logic to all storage adapters for public storage APIs. This addresses typecheck issues introduced by recent changes to UIMessages handling (#4530).

Find the full release log here.