GitHub Releases

Highlights

Trusted “system actor” execution for workflows, tools, memory, and agents

You can now run server-side/background work (cron jobs...

Workspace sandbox can now be a resolver function for per-request routing, enabling multi-tenant deployments with isolated working directories and permissions. A new sandboxCacheKey option keeps background process tools attached to the same sandbox across follow-up requests. The stream() and resumeStream() methods now support untilIdle (boolean or { maxIdleMs }) to keep streams open across background-task continuations, with the same option available on server endpoints and client SDKs; dedicated streamUntilIdle() methods and /stream-until-idle endpoints are deprecated.

Added support for routing embeddings through the Gateway using mastra/provider/model identifiers, enabling ModelRouterEmbeddingModel to accept Gateway-prefixed model IDs like mastra/GATEWAY_OPENAI_EMBEDDING_MODEL.

New record-first notification signals add a thread-scoped inbox with agent.sendNotificationSignal(), priority-aware delivery, due-notification dispatch, and low-priority rollups, persisted across Postgres, MongoDB, and LibSQL backends. Processors can now publish replayable state lanes via computeStateSignal() and external producers can update them with agent.sendStateSignal(), enabling efficient snapshot/delta state history. @mastra/react adds a fully type-safe MessageFactory for per-part rendering with strongly-typed status slots, while @mastra/core/stream exports canonical IsTaskCompletePayload and TripwirePayload types for consistent UI typing.

Highlights

OAuth ToolProviders runtime for stored agents (connections + toolkit-scoped tool resolution)

Mastra now includes the v1 ToolProv...

Highlights

Stored Entity HTTP APIs (Agents/Skills/Workspaces) + Builder/Registry Introspection

@mastra/server adds a full HTTP surface fo...

Highlights

Google Cloud Spanner Storage Adapter (@mastra/spanner@1.0.0)

New first-party storage backend for Google Cloud Spanner (GoogleS...

New FGA route policy coverage controls add guardrails for protected routes with built-in resource route metadata resolution and resolver hooks, and a favorites storage domain lets users favorite agents and skills with visibility and favorite count fields. Implemented across PostgreSQL, LibSQL, MongoDB, and ClickHouse adapters. Token estimation for large file parts in observational memory is improved, and fixes address workspace PATCH undefined overwrites, scheduled workflow schedule application, and a circular ESM import crash in @mastra/core/workflows.

New @mastra/acp package lets you run ACP-compatible coding agents as Mastra tools or lightweight subagents with incremental streaming support in supervisors, workflows, and the Inngest adapter. New @mastra/voice-xai-realtime adds realtime voice integration for xAI Grok Voice Agent API. Agents now support optional metadata for client-side filtering and cloning, enterprise entry points for admin model policies and RBAC enhancements, improved file handling in workspace.read_file with native media parts, and a lightweight trace listing API for observability.

Mastra now supports push delivery for workflow events via PubSubs and HTTP endpoints, enabling brokers like GCP Pub/Sub and SNS to deliver events without a pull worker. A new opt-in ResponseCache input processor skips redundant model calls by replaying cached responses per step. Agents can accept contextual signals mid-run and clients can subscribe to thread activity for reliable follow-ups during streaming responses. Breaking changes include Inngest v4 requirement, paginated list methods now requiring orderBy, and removal of some Playground UI exports.

Highlights

Fine-Grained Authorization (FGA) across Mastra (core + server adapters + MCP)

Mastra now supports relationship-based, resource-l...

Highlights

Platform Channels Framework (Core + Server + Client)

A new channels architecture adds ChannelProvider, a dedicated `ChannelsSt...

Highlights

Durable Agents + Resumable Streams (crash/disconnect resilient execution)

New DurableAgent support lets agent streams resume a...

Highlights

Per-user resource scoping in server auth (secure by default)

Server auth now supports mapUserToResourceId, automatically mappi...

Highlights

Azure Blob Storage workspace + blob store (@mastra/azure)

New @mastra/azure adds an Azure Blob Storage WorkspaceFilesystem...

Highlights

Background Tasks (Async Tool Execution + APIs + Storage Support)

Agents can now dispatch slow tool calls as background tasks whi...

Highlights

Modal Cloud Sandbox Provider (@mastra/modal)

New @mastra/modal adds a Modal-backed ModalSandbox for running workspace comm...

Highlights

CLI-Driven Browser Automation + Screencasts

@mastra/core and the new @mastra/browser-viewer package add end-to-end browser...

Highlights

End-to-end RAG Tracing + New RAG/Graph Span Types

RAG ingestion and query operations are now visible in Mastra tracing with new ...

Highlights

Smarter Model Selection for Observational Memory

@mastra/memory now lets you route observer and reflector calls to different...