Highlights

1.0 Beta is ready!

We've worked hard on a 1.0 beta version to signal that Mastra is ready for prime time and there will not be any breaking changes in the near future. Please visit the migration guide to get started.

Improved support for files in models

We added the ability not to download images or any supported files by the model, and instead send the raw URL so it can handle it on its own. This improves the speed of the LLM call.

Mistral

Added improved support for Mistral by using the ai-sdk provider under the hood instead of the openai compat provider.

Changelog

@mastra/ai-sdk

• Fix bad dane change in 0.x workflowRoute (#10090)

• Improve ai-sdk transformers, handle custom data from agent sub workflow, sug agent tools (#10026)

• Extend the workflow route to accept optional runId and resourceId parameters, allowing clients to specify custom identifiers when creating workflow runs. These parameters are now properly validated in the OpenAPI schema and passed through to the createRun method.

  Also updates the OpenAPI schema to include previously undocumented
  resumeData and step fields. (#10034)

@mastra/client-js

• Fix clientTools execution in client js (#9880)

@mastra/core

• Integrates the native Mistral AI SDK provider (@ai-sdk/mistral) to replace the current OpenAI-compatible endpoint implementation for Mistral models. (#9789)

• Fix: Don't download unsupported media (#9209)

• Use a shared getAllToolPaths() method from the bundler to discover tool paths. (#9204)

• Add an additional check to determine whether the model natively supports specific file types. Only download the file if the model does not support it natively. (#9790)

• Fix agent network iteration counter bug causing infinite loops

  The iteration counter in agent networks was stuck at 0 due to a faulty ternary operator that treated 0 as falsy. This prevented maxSteps from working correctly, causing infinite loops when the routing agent kept selecting primitives instead of returning "none".

  Changes:

• Fixed iteration counter logic in loop/network/index.ts from (inputData.iteration ? inputData.iteration : -1) + 1 to (inputData.iteration ?? -1) + 1

• Changed initial iteration value from 0 to -1 so first iteration correctly starts at 0

• Added checkIterations() helper to validate iteration counting in all network tests

  Fixes #9314 (#9762)

• Exposes requiresAuth to custom api routes (#9952)

• Fix agent network working memory tool routing. Memory tools are now included in routing agent instructions but excluded from its direct tool calls, allowing the routing agent to properly route to tool execution steps for memory updates. (#9428)

• Fixes assets not being downloaded when available (#10079)

@mastra/deployer

• Added /health endpoint for service monitoring (#9142)
• Use a shared getAllToolPaths() method from the bundler to discover tool paths. (#9204)

@mastra/deployer-cloud

• Use a shared getAllToolPaths() method from the bundler to discover tool paths. (#9204)

@mastra/evals

• Remove difflib (#9756)

@mastra/mssql

• Prevents double stringification for MSSQL jsonb columns by reusing incoming strings that already contain valid JSON while still stringifying other inputs as needed. (#9901)

mastra

• Add warning to mastra dev and mastra build about upcoming stable release of v1.0.0. (#9524)
• Use a shared getAllToolPaths() method from the bundler to discover tool paths. (#9204)