Blog

Mastra Changelog 2025-05-07

vNext Workflows is fully launched 🎉

We officially switched over to vNext on May 6th, 2025. That means importing from @mastra/core/workflows will give you the vNext workflows.

If you’re using the legacy workflow system, and you want to upgrade Mastra versions but you’re not yet ready to switch over, you can use the legacy import and prefix, eg:

import { Step, Workflow } from '@mastra/core/workflows/legacy'
import { Mastra } from '@mastra/core/mastra'
const step1 = new Step(...)
const workflow = new Workflow(...).step(step1).commit();

const mastra = new Mastra({
  // registering legacy workflows
  legacy_workflows: {
    myWorkflow: workflow
  }
})

// accessing the workflow through the mastra class:
mastra.legacy_getWorkflow('myWorkflow')

Read the full blogpost to learn all about vNext. Full docs here.

AGUI integration

Mastra now works with AGUI clients. You can stream messages, trigger tool calls, and manage agents using a new adapter layer.

This makes it straightforward to plug Mastra agents into AGUI-powered frontends.

What's new:

  • Added an AGUIAdapter class for handling message streaming and tool invocations.

  • New getAGUI() helper for managing adapters.

  • Tests added for UUID generation and AGUI message conversion.

New: Comprehensive Linting for Mastra CLI

We’ve added a robust linting system to the Mastra CLI to help you catch configuration and dependency issues before they become problems.

The new linter includes rules for validating project setups and dependencies across different deployment platforms, making it easier to maintain healthy, production-ready projects.

That’s all for now. Find the full release notes here.

Happy building 🚀

Share

Stay up to date