@mastra/mcp-docs-server 1.2.3-alpha.1 → 1.2.3-alpha.12

package/.docs/docs/agent-builder/memory.md

@@ -25,9 +25,11 @@ Observational memory lets the agent learn long-lived facts from past conversatio
 
 ## Observational memory model
 
-Observational memory runs an Observer and Reflector model on top of every conversation. The default model is `google/gemini-2.5-flash`, which requires a `GOOGLE_API_KEY` environment variable in any environment where the Builder agent will run. Mastra also falls back to `GOOGLE_GENERATIVE_AI_API_KEY`.
+Observational memory runs an Observer and Reflector model on top of every conversation. For Agent Builder agents, the default model is `openai/gpt-5-mini`, which requires an `OPENAI_API_KEY` environment variable in any environment where the Builder agent will run.
 
-To use a different model, set `observationalMemory.model` to any model ID supported by the Mastra model router (and provide the matching provider credentials):
+> **Note:** This default applies only to agents created through the Agent Builder. Core (non-builder) agents configured with `observationalMemory: true` keep the framework default `google/gemini-2.5-flash` (which uses `GOOGLE_API_KEY`, falling back to `GOOGLE_GENERATIVE_AI_API_KEY`).
+
+To use a different model, set `observationalMemory.model` to any model ID supported by the Mastra model router (and provide the matching provider credentials). An explicit model always wins over the Builder default:
 
 ```typescript
 new MastraEditor({

package/.docs/docs/agent-controller/overview.md

@@ -18,7 +18,7 @@ The AgentController gives you the runtime pieces to ship interactive agent appli
 - **Let users pick the right model for each step.** Per-mode [model management](https://mastra.ai/reference/agent-controller/agent-controller-class) switches models at runtime and tracks usage, which powers copilot UIs where users trade speed for capability.
 - **Delegate focused work to child agents.** [Subagents](https://mastra.ai/docs/agent-controller/subagents) run subtasks with constrained tools and can fork the parent conversation, so a research mode can spin off web search or code review without polluting the main thread.
 - **Drive a live UI from agent activity.** The [event system](https://mastra.ai/docs/agent-controller/session) emits typed events and coalesced display snapshots, so your TUI or web app reflects message updates, mode changes, and pending approvals in real time.
-- **Run long-lived autonomous agents.** Structured task lists, heartbeat handlers, and observational memory keep background task runners on track and let them learn across threads.
+- **Run long-lived autonomous agents.** Structured task lists, interval handlers, and observational memory keep background task runners on track and let them learn across threads.
 
 ## When to use the AgentController
 

package/.docs/docs/agents/agent-approval.md

@@ -357,6 +357,44 @@ For automatic tool resumption to work:
 
 Both approaches work with the same tool definitions. Automatic resumption triggers only when suspended tools exist in the message history and the user sends a new message on the same thread.
 
+## Resuming after a restart
+
+The examples above hold on to `stream.runId` between suspension and approval. That works while the process stays alive, but in production the approval often arrives later — after a page refresh, a server restart, or on a different server instance behind a load balancer.
+
+Use [`listSuspendedRuns()`](https://mastra.ai/reference/agents/listSuspendedRuns) to rediscover the pending run for a conversation from storage:
+
+```typescript
+// In the request handler that receives the user's decision
+const { runs } = await agent.listSuspendedRuns({
+  threadId: 'thread-123',
+  resourceId: 'user-456',
+})
+
+const run = runs[0]
+const toolCall = run?.toolCalls[0]
+
+if (run && toolCall) {
+  let stream
+  if (toolCall.requiresApproval) {
+    // Suspended by requireApproval — approve or decline the tool call
+    stream = await agent.approveToolCall({ runId: run.runId, toolCallId: toolCall.toolCallId })
+  } else {
+    // Suspended by suspend() — resume with the data the tool asked for
+    console.log('Tool asked:', toolCall.suspendPayload)
+    stream = await agent.resumeStream({ name: 'San Francisco' }, { runId: run.runId })
+  }
+  for await (const chunk of stream.textStream) process.stdout.write(chunk)
+}
+```
+
+Each returned run includes the suspended tool calls (`toolCallId`, `toolName`, `args`, and `requiresApproval`). Approval suspensions (`requiresApproval: true`) are answered with `approveToolCall()` / `declineToolCall()`, while `suspend()`-based suspensions carry their `suspendPayload` and expect `resumeStream()` with resume data — so you can rebuild the right UI for either flow without keeping any state in memory.
+
+`sendToolApproval()` uses the same storage-backed discovery automatically: when no active run is found in memory for the thread, it looks up the suspended run in storage before failing. If several suspended runs match the thread, pass a `toolCallId` to disambiguate.
+
+The same discovery is available over HTTP as `GET /agents/:agentId/suspended-runs` and in the client SDK as [`agent.listSuspendedRuns()`](https://mastra.ai/reference/client-js/agents), so browser-based approval UIs can rediscover pending runs directly.
+
+> **Note:** Suspended runs only survive restarts when your Mastra instance is configured with a persistent [storage provider](https://mastra.ai/docs/memory/storage). The default in-memory store loses snapshots when the process exits.
+
 ## Tool approval: Supervisor agents
 
 A [supervisor agent](https://mastra.ai/docs/agents/supervisor-agents) coordinates multiple subagents using `.stream()` or `.generate()`. When a subagent calls a tool that requires approval, the request propagates up through the delegation chain and surfaces at the supervisor level:

package/.docs/docs/agents/heartbeats.md

@@ -0,0 +1,211 @@
+# Heartbeats
+
+**Added in:** `@mastra/core@1.46.0`
+
+> **Beta:** This feature is in alpha. Breaking changes may occur without a major version bump until the API is stable.
+
+A heartbeat runs an agent on a cron schedule. On each fire, Mastra sends a prompt to the agent, either as a [signal](https://mastra.ai/docs/agents/signals) into a thread or as a threadless `agent.generate()` run. Use heartbeats for recurring agent work such as daily summaries, periodic checks, or scheduled nudges into a conversation.
+
+Heartbeats are persisted, so they survive restarts and redeploys. Manage them at runtime through `mastra.heartbeats`, the canonical create, read, update, and delete (CRUD) surface.
+
+## Prerequisites
+
+Heartbeats require a [storage](https://mastra.ai/docs/memory/storage) adapter that implements the schedules domain, for example `@mastra/libsql`. Without one, `mastra.heartbeats.create()` throws.
+
+## Quickstart
+
+The following heartbeat runs the `pinger` agent every hour. It has no thread, so each fire is an isolated `agent.generate()` run.
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { Agent } from '@mastra/core/agent'
+import { LibSQLStore } from '@mastra/libsql'
+
+const pinger = new Agent({
+  id: 'pinger',
+  name: 'Pinger',
+  instructions: 'Report the current system status in one sentence.',
+  model: 'openai/gpt-5.5',
+})
+
+const mastra = new Mastra({
+  agents: { pinger },
+  storage: new LibSQLStore({ url: 'file:./mastra.db' }),
+})
+
+await mastra.heartbeats.create({
+  agentId: 'pinger',
+  cron: '0 * * * *',
+  prompt: 'Give me a status update.',
+})
+```
+
+Mastra starts the scheduler the first time a heartbeat is created, then fires the agent on the cron you specify.
+
+## Cadence
+
+Heartbeats fire on a cron expression. The `cron` field accepts a standard 5-, 6-, or 7-part cron expression, and it's validated when you create or update the heartbeat.
+
+Croner nicknames also work, for example `@hourly`, `@daily`, `@weekly`, `@monthly`, and `@midnight`. For day-and-time combinations, write the cron field directly:
+
+```typescript
+// Every weekday at 9am
+await mastra.heartbeats.create({
+  agentId: 'pinger',
+  cron: '0 9 * * 1-5',
+  prompt: 'Start-of-day check.',
+})
+```
+
+Set `timezone` to an IANA timezone, for example `America/New_York`, so fire times don't depend on the host's locale. When omitted, the cron resolves against the host's local timezone.
+
+For more readable cron construction, you can use a userland builder such as [`cron-time-generator`](https://www.npmjs.com/package/cron-time-generator) and pass its output to `cron`.
+
+## Threadless and threaded heartbeats
+
+A heartbeat fires in one of two modes, decided by whether you pass a `threadId`.
+
+### Threadless
+
+Without a `threadId`, each fire is an isolated `agent.generate()` run. Nothing is written to a conversation thread. This is the simplest mode and suits status checks, reports, and other work that doesn't need conversation context.
+
+### Threaded
+
+With a `threadId`, the heartbeat sends a [signal](https://mastra.ai/docs/agents/signals) into that thread, so the prompt joins the agent's conversation. Threaded heartbeats require a `resourceId` alongside the `threadId`.
+
+```typescript
+await mastra.heartbeats.create({
+  agentId: 'pinger',
+  cron: '0 9 * * *',
+  prompt: 'Summarize anything new since yesterday.',
+  threadId: 'thread-123',
+  resourceId: 'user-456',
+})
+```
+
+Threaded heartbeats accept extra fields that control how the signal behaves. They mirror the options [`agent.sendSignal`](https://mastra.ai/docs/agents/signals) accepts and stay JSON-serializable so they persist with the schedule.
+
+- `signalType`: the [signal type](https://mastra.ai/docs/agents/signals) to send, for example `notification` or `system-reminder`. Defaults to `notification`.
+- `tagName`: the XML tag the signal renders as. Defaults to `heartbeat`, so a fire surfaces to the agent as `<heartbeat>…</heartbeat>`.
+- `attributes`: values rendered onto the signal's XML tag.
+- `ifActive`: behavior when the thread is already streaming, as `{ behavior, attributes }`. `behavior` is one of `deliver`, `persist`, or `discard`.
+- `ifIdle`: behavior when the thread is idle, as `{ behavior, attributes, streamOptions }`. `behavior` is one of `wake`, `persist`, or `discard`. `streamOptions.requestContext` is applied to the woken run.
+
+These fields require a `threadId`. Passing them on a threadless heartbeat throws.
+
+```typescript
+await mastra.heartbeats.create({
+  agentId: 'pinger',
+  cron: '0 9 * * *',
+  prompt: 'Summarize anything new since yesterday.',
+  threadId: 'thread-123',
+  resourceId: 'user-456',
+  tagName: 'check-in', // renders as <check-in>…</check-in>
+  attributes: { source: 'cron' },
+  ifActive: { behavior: 'discard' }, // skip if the thread is mid-stream
+  ifIdle: {
+    behavior: 'wake', // wake the agent if the thread is idle
+    streamOptions: { requestContext: { locale: 'en-US' } },
+  },
+})
+```
+
+`providerOptions` are merged into the signal payload on every fire and apply to both threaded and threadless heartbeats.
+
+## Managing heartbeats
+
+Use `mastra.heartbeats` for all heartbeat operations. To scope to a single agent, pass `agentId` to `create` or `list`.
+
+```typescript
+// Create
+const hb = await mastra.heartbeats.create({
+  agentId: 'pinger',
+  cron: '0 * * * *',
+  prompt: 'Status check.',
+})
+
+// Read
+await mastra.heartbeats.get(hb.id)
+await mastra.heartbeats.list({ agentId: 'pinger' })
+
+// Update — changing cron or timezone recomputes the next fire time
+await mastra.heartbeats.update(hb.id, { cron: '*/30 * * * *' })
+
+// Pause and resume
+await mastra.heartbeats.pause(hb.id)
+await mastra.heartbeats.resume(hb.id)
+
+// Fire once now, off-schedule
+await mastra.heartbeats.run(hb.id)
+
+// Delete
+await mastra.heartbeats.delete(hb.id)
+```
+
+A few rules worth knowing:
+
+- `pause` and `resume` are durable and idempotent. A paused heartbeat survives restarts, and `resume` recomputes the next fire time from now rather than firing backlogged runs.
+- `run` fires the heartbeat once immediately without affecting its schedule.
+- `list` filters by `agentId`, `threadId`, `resourceId`, and `name`.
+
+### Custom IDs
+
+By default `create` generates a random `hb_<uuid>` id. Pass `id` to choose a stable one, for example when you want a predictable handle to look up, update, or delete later:
+
+```typescript
+await mastra.heartbeats.create({
+  id: 'nightly-summary',
+  agentId: 'pinger',
+  cron: '0 9 * * *',
+  prompt: 'Summarize anything new since yesterday.',
+})
+// stored as `hb_nightly-summary`
+```
+
+The id is normalized to `hb_<slug>`: the `hb_` prefix is added if missing and the rest is slugified. Creating a heartbeat with an id that already exists throws, so use `update` to change an existing one.
+
+### From the client
+
+The same operations are available from `@mastra/client-js` over the server routes, so you can manage heartbeats from a separate process or a UI.
+
+## Lifecycle hooks
+
+Hooks let you run code at key points in a heartbeat's lifecycle, for example to compute fire-time parameters or react to the outcome. Configure them on the `Mastra` constructor under `heartbeat`. The hooks are a single flat bundle that runs for every agent's heartbeats; each hook context carries the firing `agentId`, so branch on it when you need per-agent behavior. Hooks live at the `Mastra` level so they apply to both code-defined and stored agents.
+
+```typescript
+const mastra = new Mastra({
+  agents: { pinger },
+  storage: new LibSQLStore({ url: 'file:./mastra.db' }),
+  heartbeat: {
+    prepare: async ({ agentId, heartbeat, trigger }) => {
+      // Return overrides, null to skip this fire, or undefined for defaults
+      return { prompt: `Status as of ${trigger.firedAt.toISOString()}` }
+    },
+    onFinish: async ({ agentId, outcome, runId }) => {
+      // Runs on any non-error, non-abort outcome
+    },
+    onError: async ({ agentId, phase, error }) => {
+      // Runs when prepare, the signal, or the agent run threw
+    },
+    onAbort: async ({ agentId, runId }) => {
+      // Runs when the run was aborted mid-stream
+    },
+  },
+})
+```
+
+The hooks are:
+
+- `prepare`: runs before the fire. Return an object to override fire-time parameters such as `prompt` or `threadId`, `null` to skip the fire, or `undefined` to use the stored defaults.
+- `onFinish`: runs once per trigger that reached a non-error, non-abort terminal state.
+- `onError`: runs when `prepare`, the signal, or the agent run threw.
+- `onAbort`: runs when the run was aborted mid-stream.
+
+Every hook context includes `agentId` (the agent the heartbeat fired for) alongside `heartbeat` and `trigger`.
+
+Hook exceptions are caught and logged. They never re-route the worker or trigger another hook.
+
+## Related
+
+- [Signals](https://mastra.ai/docs/agents/signals): the delivery mechanism behind threaded heartbeats.
+- [Scheduled workflows](https://mastra.ai/docs/workflows/scheduled-workflows): run a workflow, rather than an agent, on a cron schedule.

package/.docs/docs/agents/signals.md

@@ -322,6 +322,29 @@ Use `createNotificationInboxTool()` to give agents one tool for inbox actions in
 
 `sendNotificationSignal()` requires a storage domain with `notifications` support. Use `sendSignal({ type: 'notification' })` only for lower-level notification-shaped context that should bypass inbox storage.
 
+## Distributed and serverless deployments
+
+Signals coordinate runs through a pub/sub backend. When a signal arrives on a backend that implements `LeaseProvider`, Mastra acquires a lease on the target thread so a single process owns the conversation at a time, then either wakes the agent or routes the input into the running loop. Backends without leasing fall back to a no-op that always grants ownership, which is fine in a single process but not across instances.
+
+The default in-memory pub/sub can't cross instance boundaries. On serverless platforms like Vercel, or any multi-instance deployment, a follow-up signal can land on a different instance than the one running the agent. Without a shared pub/sub, that instance can't reach the active run and starts its own, leaving the original run untouched and the thread processed twice.
+
+Configure a shared pub/sub backed by Redis Streams on the `Mastra` instance so leases and signals coordinate across instances:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { RedisStreamsPubSub } from '@mastra/redis-streams'
+
+export const mastra = new Mastra({
+  agents: { agent },
+  pubsub: new RedisStreamsPubSub({
+    url: process.env.REDIS_URL,
+    keyPrefix: 'mastra:my-app',
+  }),
+})
+```
+
+`RedisStreamsPubSub` implements both the event delivery contract and distributed leasing, so a single backend handles cross-instance signal delivery and lease ownership. Vercel's one-click Redis integration and Upstash Redis both work well. For more on when a distributed pub/sub is needed, see the [PubSub guide](https://mastra.ai/docs/server/pubsub) and the [`RedisStreamsPubSub` reference](https://mastra.ai/reference/pubsub/redis-streams).
+
 ## Compatibility and APIs
 
 ### Compatibility
@@ -404,4 +427,5 @@ Use heartbeats together with client-side reconnect logic. Heartbeats reduce idle
 - [`client.getAgent().sendSignal()`](https://mastra.ai/reference/client-js/agents)
 - [Server agent routes](https://mastra.ai/reference/server/routes)
 - [`client.getAgent().subscribeToThread()`](https://mastra.ai/reference/client-js/agents)
-- [`client.getAgent().sendToolApproval()`](https://mastra.ai/reference/client-js/agents)
+- [`client.getAgent().sendToolApproval()`](https://mastra.ai/reference/client-js/agents)
+- [`RedisStreamsPubSub`](https://mastra.ai/reference/pubsub/redis-streams)

package/.docs/docs/observability/integrations/exporters/otel.md

@@ -1,6 +1,6 @@
 # OpenTelemetry exporter
 
-The OpenTelemetry (OTEL) exporter sends your traces and logs to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, MLflow, Dash0, Traceloop, Laminar, and more.
+The OpenTelemetry (OTEL) exporter sends your traces and logs to any OTEL-compatible observability platform using standardized [OpenTelemetry Semantic Conventions for GenAI](https://opentelemetry.io/docs/specs/semconv/gen-ai/). This ensures broad compatibility with platforms like Datadog, New Relic, SigNoz, MLflow, Latitude, Dash0, Traceloop, Laminar, and more.
 
 > **Looking for bidirectional OTEL integration?:** If you have existing OpenTelemetry instrumentation and want Mastra traces to inherit context from active OTEL spans, see the [OpenTelemetry Bridge](https://mastra.ai/docs/observability/integrations/bridges/otel) instead.
 
@@ -8,7 +8,7 @@ The OpenTelemetry (OTEL) exporter sends your traces and logs to any OTEL-compati
 
 Each provider requires specific protocol packages. Install the base exporter plus the protocol package for your provider:
 
-### For HTTP/Protobuf Providers (SigNoz, New Relic, Laminar, MLflow)
+### For HTTP/Protobuf Providers (SigNoz, New Relic, Laminar, MLflow, Latitude)
 
 **npm**:
 
@@ -118,6 +118,27 @@ new OtelExporter({
 })
 ```
 
+### Latitude
+
+[Latitude](https://latitude.so) is an open-source LLM observability and evaluation platform that ingests OTLP traces. Use the `custom` provider with HTTP/Protobuf, pointing at Latitude's ingestion endpoint and authenticating with your API key and project slug:
+
+```typescript
+new OtelExporter({
+  provider: {
+    custom: {
+      endpoint: 'https://ingest.latitude.so/v1/traces',
+      protocol: 'http/protobuf',
+      headers: {
+        Authorization: `Bearer ${process.env.LATITUDE_API_KEY}`,
+        'X-Latitude-Project': process.env.LATITUDE_PROJECT,
+      },
+    },
+  },
+})
+```
+
+Sign up at [console.latitude.so](https://console.latitude.so/login), or self-host and point the endpoint at your own ingestion host.
+
 ### Dash0
 
 [Dash0](https://www.dash0.com/) provides real-time observability with automatic insights.

package/.docs/docs/observability/metrics/overview.md

@@ -8,9 +8,9 @@ Three categories of metrics are emitted automatically:
 - **Token usage metrics**: Input and output token counts broken down by type (text, cache, audio, image, reasoning).
 - **Cost estimation**: Estimated cost per model call based on an embedded pricing registry.
 
-> **Note:** Metrics require an OLAP-capable store for observability. Relational databases like PostgreSQL, LibSQL, etc. aren't supported for metrics. In-memory storage resets on restart.
+> **Note:** Metrics require an analytics-capable store for observability. Most relational databases (LibSQL, MSSQL) aren't supported for metrics. In-memory storage resets on restart.
 >
-> For local development, use [DuckDB](https://duckdb.org/) through `@mastra/duckdb`. For production, use [ClickHouse](https://clickhouse.com/) through `@mastra/clickhouse`.
+> For local development, use [DuckDB](https://duckdb.org/) through `@mastra/duckdb`. For production, use [ClickHouse](https://clickhouse.com/) through `@mastra/clickhouse`. `PostgresStoreVNext` with the observability domain enabled also supports metrics, but always provide a time range to avoid full partition scans.
 >
 > Google Cloud Spanner supports metrics, but it's not recommended for heavy metrics workloads. The Spanner adapter disables metrics by default because metrics are write-heavy and scan-heavy. Set `disableMetrics: false` only for light workloads, or route metrics to an OLAP store.
 

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 337 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 336 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -61,7 +61,6 @@ ANTHROPIC_API_KEY=ant-...
 | `anthropic/claude-opus-4.1`                                     |
 | `anthropic/claude-opus-4.5`                                     |
 | `anthropic/claude-opus-4.6`                                     |
-| `anthropic/claude-opus-4.6-fast`                                |
 | `anthropic/claude-opus-4.7`                                     |
 | `anthropic/claude-opus-4.7-fast`                                |
 | `anthropic/claude-opus-4.8`                                     |

package/.docs/models/gateways/vercel.md

@@ -1,6 +1,6 @@
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 293 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 294 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -72,6 +72,7 @@ ANTHROPIC_API_KEY=ant-...
 | `amazon/nova-micro`                      |
 | `amazon/nova-pro`                        |
 | `amazon/titan-embed-text-v2`             |
+| `anthropic/claude-3.5-haiku`             |
 | `anthropic/claude-haiku-4.5`             |
 | `anthropic/claude-opus-4`                |
 | `anthropic/claude-opus-4.1`              |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4548 models from 134 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4482 models from 135 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/anthropic.md

@@ -1,6 +1,6 @@
 # ![Anthropic logo](https://models.dev/logos/anthropic.svg)Anthropic
 
-Access 18 Anthropic models through Mastra's model router. Authentication is handled automatically using the `ANTHROPIC_API_KEY` environment variable.
+Access 17 Anthropic models through Mastra's model router. Authentication is handled automatically using the `ANTHROPIC_API_KEY` environment variable.
 
 Learn more in the [Anthropic documentation](https://docs.anthropic.com/en/docs/about-claude/models).
 
@@ -15,7 +15,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "anthropic/claude-3-5-haiku-latest"
+  model: "anthropic/claude-fable-5"
 });
 
 // Generate a response
@@ -32,7 +32,6 @@ for await (const chunk of stream) {
 
 | Model                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | -------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `anthropic/claude-3-5-haiku-latest`    | 200K    |       |           |       |       |       | $0.80      | $4          |
 | `anthropic/claude-fable-5`             | 1.0M    |       |           |       |       |       | $10        | $50         |
 | `anthropic/claude-haiku-4-5`           | 200K    |       |           |       |       |       | $1         | $5          |
 | `anthropic/claude-haiku-4-5-20251001`  | 200K    |       |           |       |       |       | $1         | $5          |
@@ -60,7 +59,7 @@ const agent = new Agent({
   id: "custom-agent",
   name: "custom-agent",
   model: {
-    id: "anthropic/claude-3-5-haiku-latest",
+    id: "anthropic/claude-fable-5",
     apiKey: process.env.ANTHROPIC_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -79,7 +78,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "anthropic/claude-sonnet-4-6"
-      : "anthropic/claude-3-5-haiku-latest";
+      : "anthropic/claude-fable-5";
   }
 });
 ```

package/.docs/models/providers/chutes.md

@@ -1,6 +1,6 @@
 # ![Chutes logo](https://models.dev/logos/chutes.svg)Chutes
 
-Access 39 Chutes models through Mastra's model router. Authentication is handled automatically using the `CHUTES_API_KEY` environment variable.
+Access 13 Chutes models through Mastra's model router. Authentication is handled automatically using the `CHUTES_API_KEY` environment variable.
 
 Learn more in the [Chutes documentation](https://llm.chutes.ai).
 
@@ -32,47 +32,21 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `chutes/deepseek-ai/DeepSeek-R1-0528-TEE`              | 164K    |       |           |       |       |       | $0.45      | $2          |
-| `chutes/deepseek-ai/DeepSeek-R1-Distill-Llama-70B`     | 131K    |       |           |       |       |       | $0.03      | $0.11       |
-| `chutes/deepseek-ai/DeepSeek-V3-0324-TEE`              | 164K    |       |           |       |       |       | $0.25      | $1          |
-| `chutes/deepseek-ai/DeepSeek-V3.1-TEE`                 | 164K    |       |           |       |       |       | $0.27      | $1          |
-| `chutes/deepseek-ai/DeepSeek-V3.2-TEE`                 | 131K    |       |           |       |       |       | $0.28      | $0.42       |
-| `chutes/google/gemma-4-31B-turbo-TEE`                  | 131K    |       |           |       |       |       | $0.13      | $0.38       |
-| `chutes/MiniMaxAI/MiniMax-M2.5-TEE`                    | 197K    |       |           |       |       |       | $0.15      | $1          |
-| `chutes/moonshotai/Kimi-K2.5-TEE`                      | 262K    |       |           |       |       |       | $0.44      | $2          |
-| `chutes/moonshotai/Kimi-K2.6-TEE`                      | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `chutes/NousResearch/DeepHermes-3-Mistral-24B-Preview` | 33K     |       |           |       |       |       | $0.02      | $0.10       |
-| `chutes/NousResearch/Hermes-4-14B`                     | 41K     |       |           |       |       |       | $0.01      | $0.05       |
-| `chutes/openai/gpt-oss-120b-TEE`                       | 131K    |       |           |       |       |       | $0.09      | $0.36       |
-| `chutes/Qwen/Qwen2.5-72B-Instruct`                     | 33K     |       |           |       |       |       | $0.30      | $1          |
-| `chutes/Qwen/Qwen2.5-Coder-32B-Instruct`               | 33K     |       |           |       |       |       | $0.03      | $0.11       |
-| `chutes/Qwen/Qwen2.5-VL-32B-Instruct`                  | 16K     |       |           |       |       |       | $0.05      | $0.22       |
-| `chutes/Qwen/Qwen3-235B-A22B-Instruct-2507-TEE`        | 262K    |       |           |       |       |       | $0.10      | $0.60       |
-| `chutes/Qwen/Qwen3-235B-A22B-Thinking-2507`            | 262K    |       |           |       |       |       | $0.11      | $0.60       |
-| `chutes/Qwen/Qwen3-30B-A3B`                            | 41K     |       |           |       |       |       | $0.06      | $0.22       |
-| `chutes/Qwen/Qwen3-32B-TEE`                            | 41K     |       |           |       |       |       | $0.08      | $0.24       |
-| `chutes/Qwen/Qwen3-Coder-Next-TEE`                     | 262K    |       |           |       |       |       | $0.12      | $0.75       |
-| `chutes/Qwen/Qwen3-Next-80B-A3B-Instruct`              | 262K    |       |           |       |       |       | $0.10      | $0.80       |
-| `chutes/Qwen/Qwen3.5-397B-A17B-TEE`                    | 262K    |       |           |       |       |       | $0.39      | $2          |
-| `chutes/Qwen/Qwen3.6-27B-TEE`                          | 262K    |       |           |       |       |       | $0.20      | $2          |
-| `chutes/Qwen/Qwen3Guard-Gen-0.6B`                      | 33K     |       |           |       |       |       | $0.01      | $0.01       |
-| `chutes/rednote-hilab/dots.ocr`                        | 131K    |       |           |       |       |       | $0.01      | $0.01       |
-| `chutes/tngtech/DeepSeek-TNG-R1T2-Chimera-TEE`         | 164K    |       |           |       |       |       | $0.30      | $1          |
-| `chutes/unsloth/gemma-3-12b-it`                        | 131K    |       |           |       |       |       | $0.03      | $0.10       |
-| `chutes/unsloth/gemma-3-27b-it`                        | 128K    |       |           |       |       |       | $0.03      | $0.11       |
-| `chutes/unsloth/gemma-3-4b-it`                         | 96K     |       |           |       |       |       | $0.01      | $0.03       |
-| `chutes/unsloth/Llama-3.2-1B-Instruct`                 | 16K     |       |           |       |       |       | $0.01      | $0.01       |
-| `chutes/unsloth/Llama-3.2-3B-Instruct`                 | 16K     |       |           |       |       |       | $0.01      | $0.01       |
-| `chutes/unsloth/Mistral-Nemo-Instruct-2407`            | 131K    |       |           |       |       |       | $0.02      | $0.04       |
-| `chutes/XiaomiMiMo/MiMo-V2-Flash-TEE`                  | 262K    |       |           |       |       |       | $0.09      | $0.29       |
-| `chutes/zai-org/GLM-4.6V`                              | 131K    |       |           |       |       |       | $0.30      | $0.90       |
-| `chutes/zai-org/GLM-4.7-FP8`                           | 203K    |       |           |       |       |       | $0.30      | $1          |
-| `chutes/zai-org/GLM-4.7-TEE`                           | 203K    |       |           |       |       |       | $0.39      | $2          |
-| `chutes/zai-org/GLM-5-TEE`                             | 203K    |       |           |       |       |       | $0.95      | $3          |
-| `chutes/zai-org/GLM-5-Turbo`                           | 203K    |       |           |       |       |       | $0.49      | $2          |
-| `chutes/zai-org/GLM-5.1-TEE`                           | 203K    |       |           |       |       |       | $1         | $4          |
+| Model                                           | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `chutes/deepseek-ai/DeepSeek-V3.2-TEE`          | 131K    |       |           |       |       |       | $1         | $1          |
+| `chutes/google/gemma-4-31B-turbo-TEE`           | 131K    |       |           |       |       |       | $0.12      | $0.37       |
+| `chutes/MiniMaxAI/MiniMax-M2.5-TEE`             | 197K    |       |           |       |       |       | $0.15      | $1          |
+| `chutes/moonshotai/Kimi-K2.5-TEE`               | 262K    |       |           |       |       |       | $0.44      | $2          |
+| `chutes/moonshotai/Kimi-K2.6-TEE`               | 262K    |       |           |       |       |       | $0.66      | $4          |
+| `chutes/Qwen/Qwen3-235B-A22B-Thinking-2507-TEE` | 262K    |       |           |       |       |       | $0.30      | $1          |
+| `chutes/Qwen/Qwen3-32B-TEE`                     | 41K     |       |           |       |       |       | $0.10      | $0.42       |
+| `chutes/Qwen/Qwen3.5-397B-A17B-TEE`             | 262K    |       |           |       |       |       | $0.45      | $3          |
+| `chutes/Qwen/Qwen3.6-27B-TEE`                   | 262K    |       |           |       |       |       | $0.30      | $2          |
+| `chutes/unsloth/Mistral-Nemo-Instruct-2407-TEE` | 131K    |       |           |       |       |       | $0.02      | $0.10       |
+| `chutes/zai-org/GLM-5-TEE`                      | 203K    |       |           |       |       |       | $0.95      | $3          |
+| `chutes/zai-org/GLM-5.1-TEE`                    | 203K    |       |           |       |       |       | $0.98      | $3          |
+| `chutes/zai-org/GLM-5.2-TEE`                    | 1.0M    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration
 
@@ -102,7 +76,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "chutes/zai-org/GLM-5.1-TEE"
+      ? "chutes/zai-org/GLM-5.2-TEE"
       : "chutes/MiniMaxAI/MiniMax-M2.5-TEE";
   }
 });

package/.docs/models/providers/deepinfra.md

@@ -1,6 +1,6 @@
 # ![Deep Infra logo](https://models.dev/logos/deepinfra.svg)Deep Infra
 
-Access 25 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
+Access 26 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
 
 Learn more in the [Deep Infra documentation](https://deepinfra.com/models).
 
@@ -57,6 +57,7 @@ for await (const chunk of stream) {
 | `deepinfra/zai-org/GLM-4.7-Flash`                             | 203K    |       |           |       |       |       | $0.06      | $0.40       |
 | `deepinfra/zai-org/GLM-5`                                     | 203K    |       |           |       |       |       | $0.60      | $2          |
 | `deepinfra/zai-org/GLM-5.1`                                   | 203K    |       |           |       |       |       | $1         | $4          |
+| `deepinfra/zai-org/GLM-5.2`                                   | 1.0M    |       |           |       |       |       | $0.95      | $3          |
 
 ## Advanced configuration
 
@@ -85,7 +86,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "deepinfra/zai-org/GLM-5.1"
+      ? "deepinfra/zai-org/GLM-5.2"
       : "deepinfra/MiniMaxAI/MiniMax-M2.5";
   }
 });

package/.docs/models/providers/friendli.md

@@ -1,6 +1,6 @@
 # ![Friendli logo](https://models.dev/logos/friendli.svg)Friendli
 
-Access 9 Friendli models through Mastra's model router. Authentication is handled automatically using the `FRIENDLI_TOKEN` environment variable.
+Access 7 Friendli models through Mastra's model router. Authentication is handled automatically using the `FRIENDLI_TOKEN` environment variable.
 
 Learn more in the [Friendli documentation](https://friendli.ai/docs/guides/serverless_endpoints/introduction).
 
@@ -36,8 +36,6 @@ for await (const chunk of stream) {
 | --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `friendli/deepseek-ai/DeepSeek-V3.2`          | 164K    |       |           |       |       |       | $0.50      | $2          |
 | `friendli/google/gemma-4-31B-it`              | 262K    |       |           |       |       |       | $0.14      | $0.40       |
-| `friendli/meta-llama/Llama-3.1-8B-Instruct`   | 131K    |       |           |       |       |       | $0.10      | $0.10       |
-| `friendli/meta-llama/Llama-3.3-70B-Instruct`  | 131K    |       |           |       |       |       | $0.60      | $0.60       |
 | `friendli/MiniMaxAI/MiniMax-M2.5`             | 197K    |       |           |       |       |       | $0.30      | $1          |
 | `friendli/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K    |       |           |       |       |       | $0.20      | $0.80       |
 | `friendli/zai-org/GLM-5`                      | 203K    |       |           |       |       |       | $1         | $3          |