Mastra

Highlights

Multi-session Harness architecture (Session-first APIs)

Harness is now a pure factory/shared-resource owner: create isolated ses...

Fixed a WorkOS OAuth login failure caused by a missing PKCE verifier cookie. Agent signal drains now record pending signals through the canonical transcript path and rotate response message IDs consistently, preventing follow-up signal turns from attaching to the wrong assistant response. Also includes faster long-thread resume via optimized state signal restoration and redesigned Studio UI panels.

Highlights

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

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

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

CLI-Driven Browser Automation + Screencasts

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