2025-07-22 - Mastra Release

Templates [IMPORTANT]

• The examples index page on the website to correct the links and their order. #5968
• Support for using external GitHub repositories as sources for templates. #6024
• Improve sync process to use the description from package.json when picking a template description. #6037
• A new browsing-agent template to the /templates folder. #6044
• All agent and workflow files to ensure they are current and consistent. #6047
• The docs-chat template to reference Kepler, a realistic SDK for querying planetary information, instead of the generic planets.json file. #6054
• A pdf-to-question template to the /templates folder. #6063
• A CSV questions template to the /templates folder. #6071
• A text-to-SQL template to the /templates folder. #6048
• All agents and workflow files to ensure they are synchronized with the latest template. #6045

CLI

• Add 'sourcemap' option to the mastra bundler configuration, enabling source map generation in build outputs, not just in development. #5949
• Ensure environment variables from .env files are correctly loaded and accessible in the running process when using the CLI dev command by spreading loadedEnv into process.env. #6052
• A fallback mechanism for extracted mastra options during the bundling process. #6068

Playground UI

• A light background color to visually distinguish step statuses in the interface. #6035
• Unifying tab components and styling across the playground and export for cloud, introducing a shared EntityHeader and removing redundant code. #6041
• Refactored and modularized the AgentMetadata component for shared use with Cloud, replacing the old AgentInformation component and aligning the UI with Cloud and Figma designs. #6064
• Memory features added to the playground, including semantic recall and configurable options. #6080 [IMPORTANT]
• Fix bug that was preventing the date picker from working properly. #6100
• Fix agent chat stop button in the playground so that it properly aborts chat requests when clicked. #6114
• The code to share the chat thread navigation component between agent, networks, and cloud sections. #6102
• TraceView to be shareable between workflows and agents, exports it for cloud usage, and adds pagination to address issue #5754. #6031
• Code to separate data fetching logic from a shared component due to differences in how cloud resolves data. #6034

Server

• Organize route logic into namespace-specific files and introduces a new bodyLimitOptions type, improving code structure and maintainability. #5941

Evals

• A minor typo in the relevancy reason prompt. #6099

Agents

• The 'No Object Generated' error when using agent.generate with experimental_output and clientTool. #6096
• Error handling in the streamvnext component of the core module. #6157
• 'streamVNext', a new streaming protocol that enables unified, nested streaming and usage tracking for all Mastra primitives—including agents, tools, and workflows—improving flexibility and transparency over the previous protocol. [#5965] [IMPORTANT]

Memory

• Fix message-list logic to ensure message parts are merged and saved in the correct order and to the correct message source, particularly when tool call parts are updated with their results. #6062
• The ability to configure agent memory using the runtime context and adds related tests. #5966
• A bug by removing an unnecessary reassignment of the private field Mastra.prototype.#vectors. #6023
• The message-list logic to prevent saving duplicate parts when savePerStep is true by ensuring new parts are only added if they are not already present or are updated. #6025
• The memory saveMessagesHandler to correctly upsert messages using the incoming ID and ensures errors are returned when resource or thread IDs are missing, instead of failing silently. #6162

Auth [TIER2]

• The dev playground now bypasses authentication and authorization for local development by detecting specific headers and referers, enabling easier testing when auth is enabled. #6053
• The authorization middleware to require authentication only for protected routes, allowing public routes to be accessed without authentication. #5970

Client SDK

• The content-type header is only set for POST/PUT requests when a request body is present #6077. #6078
• Alias createRun method to createRunAsync in the client-js library to align it with the Mastra Workflow class, addressing issue #5996. #6110
• New eval scores methods added to the ClientJS library. #6148

Deployer

• Dependency resolution for directory imports by updating the custom resolver to handle directory paths (e.g., resolving 'pkg/dir' to 'pkg/dir/index.js') and adds date-fns as a test case. #5961
• Undo disabling of dependency installation for the Cloudflare deployer build, as the solution did not resolve the underlying deployment issues. #6033
• Fix CloudflareDeployer by removing the scope, auth, and cloudflare client properties, updates the tagWorker method to direct users to the Cloudflare dashboard, and cleans up unused imports. #6095
• Fix Cloudflare deployment issues by updating the deployer to pass all environment variables during installation and adds a changeset documenting the change. #6094
• Fix issue with tool importing in the deployer component. #6105
• Add Eval Scores functionality to the deployer routes. #6137

Evals [IMPORTANT]

• A scores schema, implements an InMemoryStore, sets up related domains, performs code cleanup, and fixes a build error. #6108
• Abstract methods for scorers to the codebase. #6111
• The Scorer API for the PG system. #6117
• The Cloudflare scorers API. #6125
• The scorer API for libsql. #6126
• A Scorer interface, updates naming conventions, and adds base tests. #6130
• Code and LLM-based scoring functionality. #6132
• Mastra server API scores. #6135
• Scorers, introducing new functionality to the project. #6134
• Scorer hooks that can be triggered for agents and workflows. #6149
• Fix an issue where scorer input values were hardcoded, ensuring that input values are now displayed correctly for both workflow steps and agents. #6166

Networks

• A bug by correcting the response type in the network loop. #6069
  (#5965)

Observability

• Fix Telemetry from starting when disabled, updates the dev bundler, and refactors arguments to use objects for improved future maintainability. #6076

RAG

• An issue where 'SET LOCAL' was not correctly setting 'hnsw.ef_search' and 'probes' by wrapping the PgVector query method in a transaction and adding rollback on error. #6118

Storage [TIER2]

• A new MSSQL memory provider to Mastra, enabling support for Microsoft SQL Server as a backend for memory storage, along with implementation, tests, and updated documentation. #5849
• Paginated message retrieval for thread messages by implementing a new paginated endpoint on the server and deployer, and updating client-js to support it. #5945
• A new MongoDBConnector by implementing the ConnectorHandler interface, enhancing database handling and performance. #5059
• A bug in Upstash storage where getWorkflowRuns did not return all workflows when the namespace parameter was missing. #4456
• A scorers storage API for LanceDB. #6113
• A Scorers storage API using MongoDB as the backend. #6119
• A scorer API for DynamoDB, adding new functionality to support scoring operations with the database. #6120
• Support for ClickHouse as a new feature. #6122
• MongoDBVector query performance by pre-filtering on properties before vector search and fixes a bug with multi-property filters. #6107
• The @mastra/core dependency to version 0.11.0 for all stores and fixes a bug related to initializing the libsql client with an auth token. #6168

Tools

• Fix code by extracting the tools import from createHonoServer, allowing tools to be passed via the options parameter instead. #5944
• The #tools import to ensure compatibility after recent codebase rework. #6143

Workflows

• Support for streaming large data to improve handling of large payloads. #5972
• Ensure the workflowId is passed through relevant components or functions. #6131
• New methods to retrieve workflows and agents using their true IDs. #6133
• Workflow status reporting, unifies change detection logic, standardizes workflow triggers, and enhances linting coverage for secret and E2E test workflows. #6144
• A bug where consecutive nested workflows that both suspend would incorrectly attempt to resume instead of start, by ensuring resume data is only passed to workflows that were actually suspended. #6127