Releases Index
Mastra

Mastra

$npx @buildinternet/releases get mastra
Recently Shipped9 releases · updated Oct 12, 2026

Recently shipped span-level trace queries, token and cost aggregation across observability stores, and self-embedding vector stores for semantic recall.

Observability queries went span-level and cost-aware. storage.querySpans() and client.querySpans() find individual completed spans with filters, cursors, previews, and model cost — "every failed tool_call in the last hour" without locating traces first. aggregateTraces() gained token and cost measures with coverage and currency handling in the ClickHouse, DuckDB, and Postgres stores. Servers also advertise observabilityStorageCapabilities so Studio calls only what a store supports.

Agents now recover from provider failures by default. Three error processors repair history before retrying, disableable via errorProcessorDefaults: false. Streaming emits a tool-call-resumed chunk through @mastra/ai-sdk and @mastra/react, so UIs clear pending approvals before the result lands, and tools can read the full conversation via context.agent.getMessages().

Semantic recall dropped the client embedder. Vector stores that generate their own embeddings, MongoDB among them, work directly. Recall pages before and after a matched observation group, and getObservationalMemoryHistory gained group filtering, sort order, and recordId lookup.

Classifiers, per-request model routing, and live channels remain core. Register classifiers on new Mastra({ classifiers }) and use them as typed workflow steps; ClassifierProcessor fails closed by default. ModelSelectionProcessor picks the best or cheapest model per run. Channel connections resolve at runtime, so platform changes appear without redeploy. @mastra/connect added Google Docs, Drive, and Sheets toolsets.

Also shipped: @mastra/mcp@2.0.0 on the stateless 2026-07-28 MCP revision, plus @mastra/azure-ai-search and @mastra/weaviate vector stores.

@mastra/core@1.78.0

Highlights

Agent Scopes (multi-tenant identity + safer memory/thread routing)

Agents now support scopes (<type>:<value>) passed per call, configured on the agent, or injected by trusted middleware via MASTRA_SCOPES_KEY; Mastra merges all three. Memory can derive…

Read more ↗
@mastra/core@1.77.0

Highlights

Factory Sandbox Provider Contract + New Providers (Docker/E2B/Platform)

Mastra Factory now has a first-class FactorySandbox contract for sandbox providers, enabling tunable settings schemas, repository templates, and prebuilt environment builds. New…

Read more ↗
@mastra/core@1.76.0

Highlights

Durable agent run ownership + storage-level run fencing

Crash recovery is now safe across multiple instances: runs are claimed by the execution driving them, recovery skips live-claimed runs (or can force take over), and storage adapters can enforce…

Read more ↗
@mastra/core@1.75.0

Highlights

Span Query API (list completed spans across traces)

New core/server/client support lets you query individual completed spans (with filters, cursors, previews, and model cost) via storage.querySpans() / client.querySpans() / `POST…

Read more ↗
@mastra/core@1.72.0

Highlights

Live channel resolvers (no-redeploy channel connections)

Mastra({ channels }) now accepts a resolver function (via channels() in @mastra/connect) so channel connections added/removed on Mastra Platform appear on a running server without redeploy; use…

Read more ↗

ClassifierProcessor fails closed by default; classifiers as workflow steps

BreakingThis release7 featuresNew capabilities3 enhancementsImprovements to existing featuresAI-tallied from the release notes
@mastra/core@1.69.0

Classifiers are now registerable on Mastra with a management API and usable as typed workflow steps, while the new ClassifierProcessor enforces classifier policies on agent input, output, and streaming and fails closed by default (opt in to prior fail-open with errorStrategy: 'warn'). Tools can adopt long-running native background operations via context.background.adopt(), @mastra/connect 0.3.0 adds ten generated SaaS tool providers, and Inngest workflows accept a retries option for durable runs.

Read more ↗
@mastra/core@1.68.0

Highlights

MCP v2 (2026-07-28) server architecture in @mastra/mcp@2.0.0

@mastra/mcp is now rebuilt on the MCP 2026-07-28 revision: no initialize handshake/session headers, and tools that need input use first-class suspend/resume (context.suspend() +…

Read more ↗
@mastra/core@1.67.0

Highlights

Studio Workflow Builder Backend (persisted workflows)

A new Studio Workflow Builder backend can be enabled via the workflowBuilder editor option, adding an editor-owned agent that authors persisted workflow definitions plus new server endpoints (`GET…

Read more ↗

Advanced trace queries; observability feedback/scores deletion

This release8 featuresNew capabilities2 enhancementsImprovements to existing features3 fixesBug fixesAI-tallied from the release notes
@mastra/core@1.66.0

Trace querying gains rich predicates for same-span properties (model/provider, duration, outcome, identity, lineage), portable top-level metadata.* filters, and richer feedback/scores filters across Postgres, ClickHouse, and DuckDB. Observability storage adds idempotent batch deleteFeedback() and deleteScores() with matching DELETE /api/observability routes and client methods, plus a deploy-scoped Cloud worker provisioning manifest and first-chunk streaming timeout.

Read more ↗
@mastra/core@1.65.0

Highlights

Advanced Trace Querying (Core Contract + Server Endpoints + Storage Implementations)

Mastra now has a strict, portable “advanced trace query” contract (bounded time ranges, recursive predicates, thread grouping, deterministic cursor pagination) plus an…

Read more ↗
@mastra/core@1.64.0

Highlights

Reusable Sandbox Templates + Warm Repo Checkouts (E2B & Platform)

New reusable template APIs in @mastra/platform-workspace plus @mastra/e2b repo templates let sandboxes start from a pre-cloned, pre-built repository image (with background rebuilds and…

Read more ↗

Trace-correlated logging via new logger adapter; worker health gating

Breaking (minor)This release3 featuresNew capabilities2 enhancementsImprovements to existing features5 fixesBug fixesAI-tallied from the release notes
@mastra/core@1.63.0

AdaptableLogger contract standardizes trace correlation by injecting trace_id/span_id into native log records during traced operations, with loggerOptions controlling correlation and export. PinoLogger implements the adapter. Deployment worker runtime now exposes a /health endpoint (503 during startup, 200 once ready). Also fixed worker schedule discovery, resume robustness with falsy payloads, and broken click-through from Studio. Removed several @mastra/playground-ui DataList API options.

Read more ↗
@mastra/core@1.62.0

Highlights

New storage backends: Elasticsearch + Valkey (GLIDE)

@mastra/elasticsearch adds an ElasticSearchStore that can power memory, workflow snapshots, scores, and semantic recall from a single Elasticsearch cluster, while new @mastra/valkey and…

Read more ↗

External orchestrators gain experiment APIs; resume now conflict-safe

This release6 featuresNew capabilities2 enhancementsImprovements to existing features4 fixesBug fixesAI-tallied from the release notes
@mastra/core@1.61.0

New dataset experiment APIs let external orchestrators own the experiment loop while Mastra stays the system of record, with server-side run, external result submission, and idempotent finalization. Concurrent workflow resume() calls are now atomic — losers get WORKFLOW_RESUME_ALREADY_CLAIMED and HTTP 409. Also added graceful shutdown controls for generated servers, automatic while-active message delivery in sessions, and a multi-turn LLM judge scorer.

Read more ↗
@mastra/core@1.60.0

Highlights

Durable execution for Agents API (no deploy required)

Stored agents created via the Agents API can now run with durable: true, enabling durable execution (with configurable loop settings) without shipping new code, and inheriting cache/pubsub from your…

Read more ↗

CostGuard becomes TokenCostControl; auto-runs now opt-in

BreakingThis release5 featuresNew capabilities4 enhancementsImprovements to existing features7 fixesBug fixesAI-tallied from the release notes
@mastra/core@1.59.0

CostGuardProcessor is renamed to TokenCostControl with new budgeting options (warnAtPercent, per-request maxCost, user/organization/session scopes, per-model breakdowns). Automatic agent runs are now opt-in per Factory on upgrade, and external-parent traces now appear as trace roots in Studio. Also adds Agent.listActiveThreadRuns() and indexed redaction tokens.

Read more ↗