@mastra/mcp-docs-server 1.1.26-alpha.6 → 1.1.26

package/.docs/docs/agents/structured-output.md

@@ -210,6 +210,28 @@ const response = await testAgent.generate('Tell me about TypeScript.', {
 })
 ```
 
+If you want that structuring model to also see the current conversation history, set `useAgent: true` alongside `model`. Mastra will reuse the parent agent with the separate structuring model and attach read-only memory context when a thread is available.
+
+```typescript
+const response = await testAgent.generate('Return my profile as structured data.', {
+  memory: {
+    thread: 'thread-123',
+    resource: 'user-123',
+  },
+  structuredOutput: {
+    schema: z.object({
+      favoriteColor: z.string(),
+      hometown: z.string(),
+      petName: z.string(),
+    }),
+    model: 'openai/gpt-5.4',
+    useAgent: true,
+  },
+})
+```
+
+Leave `useAgent` unset if you want the separate structuring model to work only from the current response and not inherit prior conversation memory.
+
 ### Multi-step approach with `prepareStep`
 
 For models that don't support tools and structured outputs together, you can use `prepareStep` to handle them in separate steps.

package/.docs/docs/agents/supervisor-agents.md

@@ -300,8 +300,26 @@ Success criteria:
 })
 ```
 
+## Sub-agent versioning
+
+When using the [editor](https://mastra.ai/docs/editor/overview), you can control which stored version of each sub-agent the supervisor uses at runtime. Set version overrides on the Mastra instance or per invocation:
+
+```typescript
+const result = await supervisor.generate('Research and write about AI safety', {
+  versions: {
+    agents: {
+      'research-agent': { status: 'published' },
+      'writing-agent': { versionId: 'draft-456' },
+    },
+  },
+})
+```
+
+Version overrides propagate automatically through delegation. See [Sub-agent versioning](https://mastra.ai/docs/editor/overview) for details on resolution order and server API usage.
+
 ## Related
 
+- [Sub-agent versioning](https://mastra.ai/docs/editor/overview)
 - [Guide: Research coordinator](https://mastra.ai/guides/guide/research-coordinator)
 - [Agent.stream() reference](https://mastra.ai/reference/streaming/agents/stream)
 - [Agent.generate() reference](https://mastra.ai/reference/agents/generate)

package/.docs/docs/editor/overview.md

@@ -214,6 +214,75 @@ curl http://localhost:4111/agents/support-agent?versionId=abc-123
 
 See the [Client SDK agents reference](https://mastra.ai/reference/client-js/agents) for API methods.
 
+### Sub-agent versioning
+
+When a [supervisor agent](https://mastra.ai/docs/agents/supervisor-agents) delegates to sub-agents, version overrides determine which stored version of each sub-agent to use instead of the code-defined default. This lets you iterate on sub-agent prompts and tools through the editor without redeploying the supervisor.
+
+Set version overrides at three levels, with later levels taking priority:
+
+1. **Mastra instance config** — global defaults that apply to every `generate()` and `stream()` call.
+2. **Per-invocation options** — overrides passed directly to `generate()` or `stream()`.
+3. **Server request body** — overrides sent in the `versions` field of an API request.
+
+Resolution order: **per-invocation > request body > Mastra instance defaults > code-defined agent**.
+
+#### Mastra instance config
+
+Set global defaults when creating the `Mastra` instance. Every supervisor call inherits these overrides:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraEditor } from '@mastra/editor'
+
+export const mastra = new Mastra({
+  agents: { supervisor, researchAgent, writerAgent },
+  editor: new MastraEditor(),
+  versions: {
+    agents: {
+      'research-agent': { status: 'published' },
+      'writer-agent': { versionId: 'abc-123' },
+    },
+  },
+})
+```
+
+#### Per-invocation overrides
+
+Override versions for a single call to `generate()` or `stream()`. These take priority over Mastra instance defaults:
+
+```typescript
+const result = await supervisor.generate('Research and write an article about AI safety', {
+  versions: {
+    agents: {
+      'research-agent': { versionId: 'draft-456' },
+    },
+  },
+})
+```
+
+#### Server request body
+
+When calling agents through the Mastra server, pass version overrides in the request body:
+
+```bash
+curl -X POST http://localhost:4111/agents/supervisor/generate \
+  -H "Content-Type: application/json" \
+  -d '{
+    "messages": [{ "role": "user", "content": "Research AI safety" }],
+    "versions": {
+      "agents": {
+        "research-agent": { "versionId": "draft-456" }
+      }
+    }
+  }'
+```
+
+#### How propagation works
+
+Version overrides propagate automatically through sub-agent delegation via `requestContext`. When a supervisor delegates to a sub-agent, the framework checks if a version override exists for that sub-agent's ID. If one is found, it resolves the stored version from the editor and uses it instead of the code-defined default.
+
+If version resolution fails (for example, when the editor is not configured or the version ID doesn't exist), the framework logs a warning and falls back to the code-defined agent.
+
 ## Next steps
 
 - Set up [prompts](https://mastra.ai/docs/editor/prompts) to build reusable instruction templates.

package/.docs/docs/memory/observational-memory.md

@@ -339,6 +339,7 @@ Reflection works similarly — the Reflector runs in the background when observa
 | `observation.bufferActivation` | `0.8`   | How aggressively to clear the message window on activation. `0.8` means remove enough messages to keep only 20% of `messageTokens` remaining. Lower values keep more message history.                                                                                                                                                  |
 | `observation.blockAfter`       | `1.2`   | Safety threshold as a multiplier of `messageTokens`. At `1.2`, synchronous observation is forced at 36k tokens (1.2 × 30k). Only matters if buffering can't keep up.                                                                                                                                                                   |
 | `activateAfterIdle`            | none    | Forces buffered observations and buffered reflections to activate after a period of inactivity, even if their token thresholds have not been reached yet. Accepts milliseconds or duration strings like `300_000`, `"5m"`, or `"1hr"`. Set this to your prompt cache TTL if you want activation to happen before the next cold prompt. |
+| `activateOnProviderChange`     | `false` | Forces buffered observations and reflections to activate when the next step uses a different `provider/model` than the one that produced the latest assistant step. Use this when switching providers or models would invalidate prompt cache reuse.                                                                                   |
 | `reflection.bufferActivation`  | `0.5`   | When to start background reflection. `0.5` means reflection begins when observations reach 50% of the `observationTokens` threshold.                                                                                                                                                                                                   |
 | `reflection.blockAfter`        | `1.2`   | Safety threshold for reflection, same logic as observation.                                                                                                                                                                                                                                                                            |
 
@@ -350,6 +351,7 @@ const memory = new Memory({
     observationalMemory: {
       model: 'google/gemini-2.5-flash',
       activateAfterIdle: '5m',
+      activateOnProviderChange: true,
     },
   },
 })
@@ -357,6 +359,8 @@ const memory = new Memory({
 
 With a 5-minute prompt cache TTL, this activates buffered context after 5 minutes of inactivity so the next uncached prompt uses observations and reflections instead of a larger raw message window. If you prefer, `300_000` works the same way.
 
+Changing model or providers mid-thread will invalidate the prompt cache. If your agent can switch between providers or models mid-thread, `activateOnProviderChange: true` forces buffered context to activate before the new provider runs. That avoids sending a large raw window to a provider that cannot reuse the previous prompt cache.
+
 ### Disabling
 
 To disable async buffering and use synchronous observation/reflection instead:

package/.docs/docs/memory/storage.md

@@ -34,6 +34,7 @@ Each provider page includes installation instructions, configuration parameters,
 - [PostgreSQL](https://mastra.ai/reference/storage/postgresql)
 - [MongoDB](https://mastra.ai/reference/storage/mongodb)
 - [Upstash](https://mastra.ai/reference/storage/upstash)
+- [Redis](https://mastra.ai/reference/storage/redis)
 - [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
 - [Cloudflare KV & Durable Objects](https://mastra.ai/reference/storage/cloudflare)
 - [Convex](https://mastra.ai/reference/storage/convex)

package/.docs/docs/observability/tracing/exporters/langfuse.md

@@ -122,6 +122,35 @@ new LangfuseExporter({
 })
 ```
 
+#### Batch Tuning for High-Volume Traces
+
+For self-hosted Langfuse deployments or streamed runs that produce many spans per second, you can tune the OTEL batch size and flush interval to reduce request pressure on the Langfuse ingestion endpoint:
+
+```typescript
+new LangfuseExporter({
+  publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
+  secretKey: process.env.LANGFUSE_SECRET_KEY!,
+  flushAt: 500, // Maximum spans per OTEL export batch
+  flushInterval: 20, // Maximum seconds between flushes
+})
+```
+
+To suppress high-volume span types entirely (for example `MODEL_CHUNK` spans from streamed responses), use the observability-level [`excludeSpanTypes` option](https://mastra.ai/reference/observability/tracing/span-filtering) rather than configuring the exporter:
+
+```typescript
+import { SpanType } from '@mastra/core/observability'
+
+new Observability({
+  configs: {
+    langfuse: {
+      serviceName: 'my-service',
+      exporters: [new LangfuseExporter()],
+      excludeSpanTypes: [SpanType.MODEL_CHUNK],
+    },
+  },
+})
+```
+
 ### Complete Configuration
 
 ```typescript
@@ -133,6 +162,8 @@ new LangfuseExporter({
   // Optional settings
   baseUrl: process.env.LANGFUSE_BASE_URL, // Default: https://cloud.langfuse.com
   realtime: process.env.NODE_ENV === 'development', // Dynamic mode selection
+  flushAt: 500, // Maximum spans per OTEL export batch
+  flushInterval: 20, // Maximum seconds between flushes
   logLevel: 'info', // Diagnostic logging: debug | info | warn | error
 
   // Langfuse-specific settings

package/.docs/guides/deployment/netlify.md

@@ -1,6 +1,6 @@
 # Deploy Mastra to Netlify
 
-Use `@mastra/deployer-netlify` to deploy your Mastra server as serverless functions on Netlify. The deployer bundles your code and generates a `.netlify` directory conforming to Netlify's [frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/#netlifyv1functions), ready to deploy.
+Use `@mastra/deployer-netlify` to deploy your Mastra server on Netlify. The deployer bundles your code and generates a `.netlify` directory conforming to Netlify's [Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/), ready to deploy. You can deploy as serverless functions (default) or as [edge functions](https://docs.netlify.com/build/edge-functions/overview/) for lower latency and longer execution times.
 
 > **Info:** This guide covers deploying the [Mastra server](https://mastra.ai/docs/server/mastra-server). If you're using a [server adapter](https://mastra.ai/docs/server/server-adapters) or [web framework](https://mastra.ai/docs/deployment/web-framework), deploy the way you normally would for that framework.
 
@@ -49,6 +49,21 @@ export const mastra = new Mastra({
 })
 ```
 
+To deploy as edge functions instead, pass `{ target: 'edge' }`:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { NetlifyDeployer } from '@mastra/deployer-netlify'
+
+export const mastra = new Mastra({
+  deployer: new NetlifyDeployer({
+    target: 'edge',
+  }),
+})
+```
+
+Edge functions run on Deno at the edge closest to your users. They have no hard execution timeout (only a CPU time limit), making them a better fit for longer-running AI workflows. See the [constructor options](https://mastra.ai/reference/deployer/netlify) for details.
+
 Create a `netlify.toml` file with the following contents in your project root:
 
 ```toml

package/.docs/guides/getting-started/next-js.md

@@ -4,10 +4,6 @@ In this guide, you'll build a tool-calling AI agent using Mastra, then connect i
 
 You'll use [AI SDK UI](https://ai-sdk.dev/docs/ai-sdk-ui/overview) and [AI Elements](https://ai-sdk.dev/elements) to create a beautiful, interactive chat experience.
 
-![Screenshot of a chat-style web app displaying a completed \"weatherTool\" tool call, answering \"What is the weather in London?\" with a JSON result. A message suggests offering activity ideas, and a text input field is at the bottom.](/assets/images/nextjs-quickstart-11fce4f78d172367bb97a14f132d701f.png)
-
-What you'll build: an agent that can call a weather tool, display the JSON result, stream a weather summary in the chat UI, and persist conversation history across reloads.
-
 ## Before you begin
 
 - You'll need an API key from a supported [model provider](https://mastra.ai/models). If you don't have a preference, use [OpenAI](https://mastra.ai/models/providers/openai).

package/.docs/guides/migrations/mastra-cloud.md

@@ -56,11 +56,136 @@ The Mastra platform replaces Mastra Cloud with separate Studio and Server produc
 
 ## Replace Mastra Cloud Store with a hosted database
 
-Mastra Cloud provided a managed LibSQL database. The Mastra platform does not host a database for you, so you need to point your storage at an externally hosted instance.
+Mastra Cloud provided a managed libSQL database, backed by [Turso](https://turso.tech). The Mastra platform does not host a database for you, so you need to point your storage at an externally hosted instance.
 
-If you were already using a hosted database ("bring your own"), no changes are needed. Make sure the connection string is set as an environment variable in the dashboard rather than hardcoded.
+If you were already using a hosted database ("bring your own"), no changes are needed. Ensure the connection string is set as an environment variable in the dashboard rather than hardcoded.
 
-If you were using `file:./mastra.db` with Cloud Store, please [contact support](mailto:support@mastra.ai) for a migration path to export and import your data.
+If you were using Cloud Store, follow the steps below to export your data and load it into a new libSQL database that you control.
+
+### Export your Cloud Store data
+
+There are two ways to export your Cloud Store data: a one-click download from the dashboard, or a manual dump via the Turso CLI.
+
+#### Option A — Export from the dashboard (recommended)
+
+Open your project in the [Mastra dashboard](https://projects.mastra.ai) and navigate to **Runtime → Settings → Storage**. Click the **Export Database** button. The dashboard generates a full `.sql` dump of your Cloud Store and downloads it directly to your Downloads folder.
+
+Once the download completes, convert the dump into a SQLite database file:
+
+```bash
+sqlite3 mydb.db < ~/Downloads/mastra-cloud-dump.sql
+```
+
+You now have a portable `mydb.db` file you can inspect locally, back up, or use as the source for the new database in the steps that follow.
+
+#### Option B — Export via the Turso CLI
+
+If you prefer to work from the command line, or need to script the export, you can dump the database directly using the [Turso CLI](https://docs.turso.tech/cli). This approach requires the database URL and an auth token, both surfaced in the dashboard.
+
+1. Retrieve your Cloud Store credentials from the dashboard.
+
+   Open your project in the [Mastra dashboard](https://projects.mastra.ai) and navigate to **Runtime → Settings → Env Variables**. For Cloud Store–backed projects, two variables are injected alongside your own:
+
+   - `MASTRA_STORAGE_URL`: A libSQL connection string (e.g. `libsql://<db-name>-<org>.turso.io`).
+   - `MASTRA_STORAGE_AUTH_TOKEN`: A read-capable auth token scoped to that database.
+
+   Each row supports the standard environment variable actions — show/hide via the eye toggle, Edit, Delete, and Copy Value. Use **Copy Value** to grab both values for the dump command below.
+
+   > **Note:** These variables only appear for projects that were provisioned with Cloud Store. If you brought your own database to Mastra Cloud, you already have these credentials and can skip ahead to [Point your Mastra app at the new database](#point-your-mastra-app-at-the-new-database).
+
+   > **Info:** If the variables are missing, the values do not decrypt, or the Turso CLI rejects the token, email <support@mastra.ai> from the address associated with your Mastra Cloud account and ask for the libSQL URL and auth token for the project you want to export. Include the project name/ID. Support can also run the dump on your behalf if CLI access is blocked on your network.
+
+2. Install the Turso CLI.
+
+   ```bash
+   brew install tursodatabase/tap/turso
+   ```
+
+   ```bash
+   curl -sSfL https://get.tur.so/install.sh | bash
+   ```
+
+   See the [Turso CLI introduction](https://docs.turso.tech/cli/introduction) for Windows and headless-install options.
+
+3. Export the database to a SQL dump.
+
+   Set the credentials provided by support (or use the dashboard values if you already copied them earlier) as environment variables, then dump the database to a local file. If you copied the URL from the dashboard, swap the `libsql://` scheme for `https://` — the Turso CLI expects the HTTPS form when passing the URL with an auth token.
+
+   ```bash
+   export MASTRA_STORAGE_URL="https://<db-name>-<org>.turso.io"
+   export MASTRA_STORAGE_AUTH_TOKEN="<token-from-dashboard-or-support>"
+
+   turso db shell "$MASTRA_STORAGE_URL?authToken=$MASTRA_STORAGE_AUTH_TOKEN" ".dump" > mastra-cloud-dump.sql
+   ```
+
+   > **Warning:** Embedding the auth token in the connection string is less secure than Turso's recommended pattern — the full URL (with token) can end up in shell history, process listings, and terminal logs. Turso officially recommends running `turso auth login` and then dumping by database name only: `turso db shell <database-name> ".dump" > mastra-cloud-dump.sql`. That flow requires the database to live in a Turso account you own, which is not the case for Cloud Store, so the env-var example above is provided as an alternative for this one-time export. If you prefer to avoid token interpolation entirely, ask support to run the dump on your behalf and send you the resulting SQL file.
+
+   The resulting `mastra-cloud-dump.sql` contains the full schema and data: thread and message history, workflow snapshots, traces, and eval scores. Store it somewhere safe before continuing.
+
+### Load the dump into a new libSQL database
+
+The dump is a standard SQL file and can be loaded into any libSQL-compatible database. The example below uses a new Turso-hosted database, which keeps the migration like-for-like and avoids schema translation.
+
+1. Authenticate the Turso CLI against your own Turso account.
+
+   ```bash
+   turso auth login
+   ```
+
+   If you do not have a Turso account, the CLI will prompt you to create one. See [Turso pricing](https://turso.tech/pricing) for plan details.
+
+2. Create a new database and load the dump in one step.
+
+   ```bash
+   turso db create mastra-migrated --from-dump ./mastra-cloud-dump.sql
+   ```
+
+   `--from-dump` restores a local SQLite/libSQL dump at create time, which is faster and safer than piping statements through `turso db shell` after the fact. Pick a region close to where your Mastra Server runs to minimize latency — list available regions with `turso db locations` and pass `--group <group-name>` if you manage multiple groups.
+
+   For multi-gigabyte dumps, add `--wait` so the CLI blocks until the database is fully available.
+
+3. Generate connection credentials for the new database.
+
+   ```bash
+   turso db show mastra-migrated --url
+   turso db tokens create mastra-migrated
+   ```
+
+   The first command prints the libSQL URL. The second prints an auth token. Both are needed by `LibSQLStore`.
+
+### Point your Mastra app at the new database
+
+Set the new credentials as environment variables, either locally in `.env` or in the Mastra platform dashboard:
+
+```bash
+TURSO_DATABASE_URL="libsql://mastra-migrated-<org>.turso.io"
+TURSO_AUTH_TOKEN="<token-from-turso-db-tokens-create>"
+```
+
+Configure `LibSQLStore` to read from those variables:
+
+```ts
+import { Mastra } from '@mastra/core/mastra'
+import { LibSQLStore } from '@mastra/libsql'
+
+export const mastra = new Mastra({
+  storage: new LibSQLStore({
+    id: 'libsql-storage',
+    url: process.env.TURSO_DATABASE_URL!,
+    authToken: process.env.TURSO_AUTH_TOKEN,
+  }),
+})
+```
+
+See the [libSQL storage reference](https://mastra.ai/reference/storage/libsql) for the full set of options.
+
+### Verify the migration
+
+Before decommissioning your Cloud project, confirm the new database serves the data your app expects.
+
+- Run `turso db shell mastra-migrated "SELECT name FROM sqlite_master WHERE type='table';"` to list tables. The output should include the Mastra-managed tables (e.g. `mastra_threads`, `mastra_messages`, `mastra_workflow_snapshot`, `mastra_traces`).
+- Run a row count against a known-populated table, for example `turso db shell mastra-migrated "SELECT COUNT(*) FROM mastra_messages;"`, and compare it to the same query against the Cloud Store URL.
+- Start your Mastra app against the new credentials and confirm that an existing thread or workflow run loads as expected in [Studio](https://mastra.ai/docs/studio/observability).
 
 ## Update observability configuration
 

package/.docs/models/gateways/netlify.md

@@ -13,7 +13,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "netlify/anthropic/claude-3-haiku-20240307"
+  model: "netlify/anthropic/claude-haiku-4-5"
 });
 ```
 
@@ -35,7 +35,6 @@ ANTHROPIC_API_KEY=ant-...
 
 | Model                                       |
 | ------------------------------------------- |
-| `anthropic/claude-3-haiku-20240307`         |
 | `anthropic/claude-haiku-4-5`                |
 | `anthropic/claude-haiku-4-5-20251001`       |
 | `anthropic/claude-opus-4-1-20250805`        |
@@ -43,6 +42,7 @@ ANTHROPIC_API_KEY=ant-...
 | `anthropic/claude-opus-4-5`                 |
 | `anthropic/claude-opus-4-5-20251101`        |
 | `anthropic/claude-opus-4-6`                 |
+| `anthropic/claude-opus-4-7`                 |
 | `anthropic/claude-sonnet-4-0`               |
 | `anthropic/claude-sonnet-4-20250514`        |
 | `anthropic/claude-sonnet-4-5`               |

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 170 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 172 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -41,6 +41,7 @@ ANTHROPIC_API_KEY=ant-...
 | `anthropic/claude-opus-4.1`                                     |
 | `anthropic/claude-opus-4.5`                                     |
 | `anthropic/claude-opus-4.6`                                     |
+| `anthropic/claude-opus-4.7`                                     |
 | `anthropic/claude-sonnet-4`                                     |
 | `anthropic/claude-sonnet-4.5`                                   |
 | `anthropic/claude-sonnet-4.6`                                   |
@@ -116,6 +117,7 @@ ANTHROPIC_API_KEY=ant-...
 | `moonshotai/kimi-k2-0905:exacto`                                |
 | `moonshotai/kimi-k2-thinking`                                   |
 | `moonshotai/kimi-k2.5`                                          |
+| `moonshotai/kimi-k2.6`                                          |
 | `nousresearch/hermes-3-llama-3.1-405b:free`                     |
 | `nousresearch/hermes-4-405b`                                    |
 | `nousresearch/hermes-4-70b`                                     |

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 231 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 234 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-...
 | `anthropic/claude-opus-4.1`                    |
 | `anthropic/claude-opus-4.5`                    |
 | `anthropic/claude-opus-4.6`                    |
+| `anthropic/claude-opus-4.7`                    |
 | `anthropic/claude-sonnet-4`                    |
 | `anthropic/claude-sonnet-4.5`                  |
 | `anthropic/claude-sonnet-4.6`                  |
@@ -119,6 +120,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/text-embedding-005`                    |
 | `google/text-multilingual-embedding-002`       |
 | `inception/mercury-2`                          |
+| `inception/mercury-coder-small`                |
 | `inception/mercury-edit-2`                     |
 | `kwaipilot/kat-coder-pro-v1`                   |
 | `kwaipilot/kat-coder-pro-v2`                   |
@@ -264,4 +266,5 @@ ANTHROPIC_API_KEY=ant-...
 | `zai/glm-4.7-flashx`                           |
 | `zai/glm-5`                                    |
 | `zai/glm-5-turbo`                              |
+| `zai/glm-5.1`                                  |
 | `zai/glm-5v-turbo`                             |

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 3599 models from 100 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3690 models from 104 providers through a single API.
 
 ## Features
 
@@ -228,6 +228,41 @@ Mastra tries your primary model first. If it encounters a 500 error, rate limit,
 
 Your users never experience the disruption - the response comes back with the same format, just from a different model. The error context is preserved as the system moves through your fallback chain, ensuring clean error propagation while maintaining streaming compatibility.
 
+### Per-model settings
+
+Each fallback entry can carry its own `modelSettings`, `providerOptions`, and `headers` — useful when models in the chain need different temperatures or provider-specific knobs to produce comparable output.
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+
+const agent = new Agent({
+  id: 'tuned-resilient',
+  name: 'Tuned Resilient Agent',
+  instructions: 'You are a helpful assistant.',
+  model: [
+    {
+      model: 'google/gemini-2.5-flash',
+      maxRetries: 2,
+      modelSettings: { temperature: 0.3 },
+      providerOptions: { google: { thinkingConfig: { thinkingBudget: 0 } } },
+    },
+    {
+      model: 'openai/gpt-5-mini',
+      maxRetries: 2,
+      modelSettings: { temperature: 0.7 },
+      providerOptions: { openai: { reasoningEffort: 'low' } },
+    },
+  ],
+});
+```
+
+**Precedence:**
+
+- `modelSettings` and `providerOptions`: per-fallback entry overrides call-time options, which override agent `defaultOptions`. `modelSettings` shallow-merges by key. `providerOptions` deep-merges recursively, so nested provider config (e.g. `google.thinkingConfig`) preserves sibling keys across layers.
+- `headers`: call-time `modelSettings.headers` overrides per-fallback `headers`, which overrides headers extracted from model-router models. Runtime headers (tracing, auth, tenancy) intentionally take precedence over model-level headers.
+
+Each field also accepts a function of `requestContext`, matching how dynamic models are resolved.
+
 ## Use local models with Mastra
 
 Mastra also supports local models like `gpt-oss`, `Qwen3`, `DeepSeek` and many more that you run on your own hardware. The application running your local model needs to provide an OpenAI-compatible API server for Mastra to connect to. We recommend using [LMStudio](https://lmstudio.ai/) (see [Running the LMStudio server](https://lmstudio.ai/docs/developer/core/server)).

package/.docs/models/providers/302ai.md

@@ -1,6 +1,6 @@
 # ![302.AI logo](https://models.dev/logos/302ai.svg)302.AI
 
-Access 64 302.AI models through Mastra's model router. Authentication is handled automatically using the `302AI_API_KEY` environment variable.
+Access 95 302.AI models through Mastra's model router. Authentication is handled automatically using the `302AI_API_KEY` environment variable.
 
 Learn more in the [302.AI documentation](https://doc.302.ai).
 
@@ -35,13 +35,25 @@ for await (const chunk of stream) {
 | Model                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `302ai/chatgpt-4o-latest`                     | 128K    |       |           |       |       |       | $5         | $15         |
+| `302ai/claude-3-5-haiku-20241022`             | 200K    |       |           |       |       |       | $0.80      | $4          |
+| `302ai/claude-3-5-haiku-latest`               | 200K    |       |           |       |       |       | $0.80      | $4          |
+| `302ai/claude-haiku-4-5`                      | 200K    |       |           |       |       |       | $1         | $5          |
 | `302ai/claude-haiku-4-5-20251001`             | 200K    |       |           |       |       |       | $1         | $5          |
 | `302ai/claude-opus-4-1-20250805`              | 200K    |       |           |       |       |       | $15        | $75         |
 | `302ai/claude-opus-4-1-20250805-thinking`     | 200K    |       |           |       |       |       | $15        | $75         |
+| `302ai/claude-opus-4-20250514`                | 200K    |       |           |       |       |       | $15        | $75         |
+| `302ai/claude-opus-4-5`                       | 200K    |       |           |       |       |       | $5         | $25         |
 | `302ai/claude-opus-4-5-20251101`              | 200K    |       |           |       |       |       | $5         | $25         |
 | `302ai/claude-opus-4-5-20251101-thinking`     | 200K    |       |           |       |       |       | $5         | $25         |
+| `302ai/claude-opus-4-6`                       | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `302ai/claude-opus-4-6-thinking`              | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `302ai/claude-opus-4-7`                       | 200K    |       |           |       |       |       | $5         | $25         |
+| `302ai/claude-sonnet-4-20250514`              | 200K    |       |           |       |       |       | $3         | $15         |
+| `302ai/claude-sonnet-4-5`                     | 200K    |       |           |       |       |       | $3         | $15         |
 | `302ai/claude-sonnet-4-5-20250929`            | 200K    |       |           |       |       |       | $3         | $15         |
 | `302ai/claude-sonnet-4-5-20250929-thinking`   | 200K    |       |           |       |       |       | $3         | $15         |
+| `302ai/claude-sonnet-4-6`                     | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `302ai/claude-sonnet-4-6-thinking`            | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `302ai/deepseek-chat`                         | 128K    |       |           |       |       |       | $0.29      | $0.43       |
 | `302ai/deepseek-reasoner`                     | 128K    |       |           |       |       |       | $0.29      | $0.43       |
 | `302ai/deepseek-v3.2`                         | 128K    |       |           |       |       |       | $0.29      | $0.43       |
@@ -60,11 +72,21 @@ for await (const chunk of stream) {
 | `302ai/gemini-3-flash-preview`                | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `302ai/gemini-3-pro-image-preview`            | 33K     |       |           |       |       |       | $2         | $120        |
 | `302ai/gemini-3-pro-preview`                  | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `302ai/gemini-3.1-flash-image-preview`        | 131K    |       |           |       |       |       | $0.50      | $60         |
 | `302ai/glm-4.5`                               | 128K    |       |           |       |       |       | $0.29      | $1          |
+| `302ai/glm-4.5-air`                           | 128K    |       |           |       |       |       | $0.11      | $0.29       |
+| `302ai/glm-4.5-airx`                          | 128K    |       |           |       |       |       | $0.57      | $2          |
+| `302ai/glm-4.5-x`                             | 128K    |       |           |       |       |       | $1         | $2          |
 | `302ai/glm-4.5v`                              | 64K     |       |           |       |       |       | $0.29      | $0.86       |
 | `302ai/glm-4.6`                               | 200K    |       |           |       |       |       | $0.29      | $1          |
 | `302ai/glm-4.6v`                              | 128K    |       |           |       |       |       | $0.14      | $0.43       |
 | `302ai/glm-4.7`                               | 200K    |       |           |       |       |       | $0.29      | $1          |
+| `302ai/glm-4.7-flashx`                        | 200K    |       |           |       |       |       | $0.07      | $0.43       |
+| `302ai/glm-5`                                 | 200K    |       |           |       |       |       | $0.60      | $3          |
+| `302ai/glm-5-turbo`                           | 200K    |       |           |       |       |       | $0.72      | $3          |
+| `302ai/glm-5.1`                               | 200K    |       |           |       |       |       | $0.86      | $4          |
+| `302ai/glm-5v-turbo`                          | 200K    |       |           |       |       |       | $0.72      | $3          |
+| `302ai/glm-for-coding`                        | 200K    |       |           |       |       |       | $0.09      | $0.34       |
 | `302ai/gpt-4.1`                               | 1.0M    |       |           |       |       |       | $2         | $8          |
 | `302ai/gpt-4.1-mini`                          | 1.0M    |       |           |       |       |       | $0.40      | $2          |
 | `302ai/gpt-4.1-nano`                          | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
@@ -77,17 +99,26 @@ for await (const chunk of stream) {
 | `302ai/gpt-5.1-chat-latest`                   | 128K    |       |           |       |       |       | $1         | $10         |
 | `302ai/gpt-5.2`                               | 400K    |       |           |       |       |       | $2         | $14         |
 | `302ai/gpt-5.2-chat-latest`                   | 128K    |       |           |       |       |       | $2         | $14         |
+| `302ai/gpt-5.4-mini`                          | 400K    |       |           |       |       |       | $0.75      | $5          |
+| `302ai/gpt-5.4-mini-2026-03-17`               | 400K    |       |           |       |       |       | $0.75      | $5          |
+| `302ai/gpt-5.4-nano`                          | 400K    |       |           |       |       |       | $0.20      | $1          |
+| `302ai/gpt-5.4-nano-2026-03-17`               | 400K    |       |           |       |       |       | $0.20      | $1          |
 | `302ai/grok-4-1-fast-non-reasoning`           | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `302ai/grok-4-1-fast-reasoning`               | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `302ai/grok-4-fast-non-reasoning`             | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `302ai/grok-4-fast-reasoning`                 | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `302ai/grok-4.1`                              | 200K    |       |           |       |       |       | $2         | $10         |
+| `302ai/grok-4.20-beta-0309-non-reasoning`     | 2.0M    |       |           |       |       |       | $2         | $6          |
+| `302ai/grok-4.20-beta-0309-reasoning`         | 2.0M    |       |           |       |       |       | $2         | $6          |
+| `302ai/grok-4.20-multi-agent-beta-0309`       | 2.0M    |       |           |       |       |       | $2         | $6          |
 | `302ai/kimi-k2-0905-preview`                  | 262K    |       |           |       |       |       | $0.63      | $3          |
 | `302ai/kimi-k2-thinking`                      | 262K    |       |           |       |       |       | $0.57      | $2          |
 | `302ai/kimi-k2-thinking-turbo`                | 262K    |       |           |       |       |       | $1         | $9          |
 | `302ai/MiniMax-M1`                            | 1.0M    |       |           |       |       |       | $0.13      | $1          |
 | `302ai/MiniMax-M2`                            | 1.0M    |       |           |       |       |       | $0.33      | $1          |
 | `302ai/MiniMax-M2.1`                          | 1.0M    |       |           |       |       |       | $0.30      | $1          |
+| `302ai/MiniMax-M2.7`                          | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `302ai/MiniMax-M2.7-highspeed`                | 205K    |       |           |       |       |       | $0.60      | $5          |
 | `302ai/ministral-14b-2512`                    | 128K    |       |           |       |       |       | $0.33      | $0.33       |
 | `302ai/mistral-large-2512`                    | 128K    |       |           |       |       |       | $1         | $3          |
 | `302ai/qwen-flash`                            | 1.0M    |       |           |       |       |       | $0.02      | $0.22       |

package/.docs/models/providers/alibaba-cn.md

@@ -1,6 +1,6 @@
 # ![Alibaba (China) logo](https://models.dev/logos/alibaba-cn.svg)Alibaba (China)
 
-Access 75 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
+Access 76 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
 
 Learn more in the [Alibaba (China) documentation](https://www.alibabacloud.com/help/en/model-studio/models).
 
@@ -46,6 +46,7 @@ for await (const chunk of stream) {
 | `alibaba-cn/deepseek-v3-1`                      | 131K    |       |           |       |       |       | $0.57      | $2          |
 | `alibaba-cn/deepseek-v3-2-exp`                  | 131K    |       |           |       |       |       | $0.29      | $0.43       |
 | `alibaba-cn/glm-5`                              | 203K    |       |           |       |       |       | $0.86      | $3          |
+| `alibaba-cn/glm-5.1`                            | 203K    |       |           |       |       |       | $0.87      | $3          |
 | `alibaba-cn/kimi-k2-thinking`                   | 262K    |       |           |       |       |       | $0.57      | $2          |
 | `alibaba-cn/kimi-k2.5`                          | 262K    |       |           |       |       |       | $0.57      | $2          |
 | `alibaba-cn/kimi/kimi-k2.5`                     | 262K    |       |           |       |       |       | $0.60      | $3          |