This week, alongside announcing our first ever Conference, we've shipped breaking changes to the Scorer API, critical fixes for message handling and parallel workflows, plus improvements to memory filtering and type safety across the board.
Release: @mastra/core@0.13.1
Let's dive in:
🎉 Announcing Our First Ever Conference: TypeScript AI
We're thrilled to announce TypeScript AI Conference—the first conference for TypeScript AI developers.
Join us in San Francisco on November 6th for a day of deep dives into the whole agent stack in your favorite language.
If you're shipping AI in TypeScript—whether it's your side hustle, your startup, or your 9-5—you're in the right room.
Sign up to know when tickets drop and be the first to get notified when registration opens.
Breaking: Scorer API Refactor
We've completely overhauled the Scorer API for better developer experience. The refactor includes renamed step methods for clarity, a switch to method chaining initialization patterns, and the removal of createLLMScorer
in favor of a more intuitive API. These changes affect scoring implementations across stores, evals, and playground components.
This is a breaking change that requires updates to existing scoring implementations.
Critical Fix: Message ID Collisions
We fixed a critical bug in v2 to v1 message conversion where splitting messages was causing ID collisions and loss of tool call history.
Each split message now receives a unique ID, properly preserving conversation context and tool invocation history. This ensures your agents maintain full context when handling complex multi-step tool interactions.
Workflow Execution Improvements
Parallel Execution Fix
We fixed a critical bug where parallel workflow blocks would complete even when only some steps were resumed. Parallel blocks now correctly wait for all steps to complete successfully before proceeding, preventing silent failures and data integrity issues.
Auto-Resume for Suspended Steps
The run.resume()
method now has an optional step parameter. Mastra automatically detects and resumes suspended workflow steps, making the API more intuitive and backwards-compatible.
Memory & Vector Store Enhancements
Improved Metadata Filtering
We've fixed metadata filtering across multiple vector stores. LibSQL now uses corrected JSON path syntax and adjusted default minScore to include all cosine similarity results. PostgreSQL's default minScore is set to -1 to include orthogonal vectors with cosine similarity of 0. MongoDB properly maps thread_id and resource_id to the metadata subdocument for accurate semantic recall.
PostgreSQL Schema Support
We added full schema support for PostgreSQL storage. Workflow snapshots and scores now correctly include schema names in table operations with unique constraints across schemas.
Type Safety & ESM Compatibility
We've introduced a unified types builder utility that ensures all TypeScript declaration files use proper .js
import extensions for ESM compatibility. This resolves type generation issues across the entire monorepo and improves build reliability.
AI Telemetry Framework
We shipped the initial framework for our new AI Telemetry system as a non-breaking feature. This lays the groundwork for better observability and monitoring of your AI applications.
Developer Experience Improvements
Working Memory Preview
We added a preview button to the working memory section of the playground, allowing users to open a modal and preview rendered markdown of their current content or changes.
Cloudflare Workers Support
We fixed AbortController usage in Cloudflare Workers by lazily initializing Run's AbortController. Mastra projects can now deploy without errors on the Cloudflare Workers platform.
MCP OAuth Support
HTTP-based MCP servers now support OAuth authentication with automatic token refresh through an authProvider
option.
For the complete list of changes and fixes, check out the full release notes.