@mastra/mcp-docs-server 1.3.7-alpha.5 → 1.3.7-alpha.9

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

@@ -133,6 +133,24 @@ const session = await controller.createSession({
 
 Use [`session.thread.create()`](https://mastra.ai/reference/agent-controller/session) and [`session.thread.switch()`](https://mastra.ai/reference/agent-controller/session) to move one live Session between conversations.
 
+### Transfer thread ownership
+
+Each new thread stores its durable owner in `metadata.ownerId` and its original creator in `metadata.createdBy`. Both default to the Session host's `ownerId`. `createdBy` doesn't change when ownership transfers.
+
+Read the active thread's owner and transfer it through `session.thread`:
+
+```typescript
+const currentOwnerId = await session.thread.getOwner()
+
+await session.thread.transferOwnership({
+  toOwnerId: 'user-456',
+})
+```
+
+Transfers are serialized within one process. Hosts that require a durable cross-process compare-and-set should commit it in their own storage first, then call `transferOwnership()` to mirror the owner onto the active thread.
+
+Every run snapshots the thread owner when it starts. Tools and other dynamic runtime code can read that value from `AgentControllerRequestContext.threadOwnerId`. If ownership changes during a run, the active run keeps the old snapshot and the next run receives the new owner. `context.session.ownerId` remains the identity of the process-local Session host.
+
 ### List stored messages from the client
 
 Use the Agent Controller client to page through a thread's stored messages. Passing an options object returns the messages with pagination metadata:

package/.docs/docs/harness/durable-agents.md

@@ -364,6 +364,18 @@ Enforcement of the claim depends on the workflows store. When the store supports
 - `InMemoryStore` from `@mastra/core/storage`
 - `@mastra/pg`
 - `@mastra/libsql` and `@mastra/turso`
+- `@mastra/mysql`
+- `@mastra/mssql`
+- `@mastra/oracledb`
+- `@mastra/spanner`
+- `@mastra/dsql`
+- `@mastra/cloudflare-d1`
+- `@mastra/cloudflare`, with `CloudflareDOStorage`
+- `@mastra/convex`
+- `@mastra/mongodb`, on a replica set or sharded cluster
+- `@mastra/dynamodb`
+
+On Convex, run fencing runs in the Mastra server functions you deploy. Redeploy your Convex functions after upgrading `@mastra/convex`. Until you do, durable agent runs fail with an error asking you to redeploy, while other writes keep working.
 
 Stores that support run fencing keep one claim record per run, plus one memory fence record per run with memory. Stores with retention support prune them with the `workflows.runOwnership` and `memory.runFences` [retention keys](https://mastra.ai/reference/storage/retention). A run's first generation comes from the store's clock, so a run that reuses a `runId` after its records were pruned still outranks the fences and stream events of its earlier executions.
 

package/.docs/docs/mastra-platform/api.md

@@ -179,6 +179,94 @@ The API returns `401` for invalid credentials, `403` for organization authorizat
 
 Hosted observability doesn't provide a feedback creation route. Export feedback from the application as described in [Export feedback to Mastra Platform](https://mastra.ai/docs/observability/feedback).
 
+## Metrics API
+
+The Metrics API queries metrics exported to Mastra Platform Observability. Because the API is unversioned, backwards compatibility isn't guaranteed. Rate limits, retention, and ingestion-to-query freshness aren't published contracts.
+
+The endpoints share their query parameters, request bodies, and response types with the Mastra runtime metric routes. See the [metric queries reference](https://mastra.ai/reference/observability/metrics/queries) for the full contract, including [shared filters](https://mastra.ai/reference/observability/metrics/queries), [analytics methods](https://mastra.ai/reference/observability/metrics/queries), and [metric discovery](https://mastra.ai/reference/observability/metrics/queries).
+
+Use the root URL for your environment's data-residency region:
+
+| Region         | Root URL                                               |
+| -------------- | ------------------------------------------------------ |
+| United States  | `https://observability.mastra.ai/api/observability`    |
+| European Union | `https://observability.eu.mastra.ai/api/observability` |
+
+Telemetry stays in its residency region. Querying the other region returns no records for the environment. See [Observability co-location](https://mastra.ai/docs/mastra-platform/regions) for the environment-to-region mapping.
+
+### Authentication and project scope
+
+Every request requires a platform access token. Create one in [Mastra Platform](https://projects.mastra.ai), or use the token written to `.env` during Platform setup.
+
+Include `X-Mastra-Project-Id` to limit results to one project. If you omit it, the query covers metrics in every project available to the token's organization.
+
+```bash
+curl -sS "https://observability.mastra.ai/api/observability/discovery/metric-names?prefix=mastra_model_" \
+  -H "Authorization: Bearer $MASTRA_PLATFORM_ACCESS_TOKEN" \
+  -H "X-Mastra-Project-Id: $MASTRA_PROJECT_ID" | jq
+```
+
+Use an organization-scoped Platform access token. Gateway inference keys such as `mk_*` keys aren't accepted. Queries remain constrained to the token's organization even when you supply a project ID.
+
+### Endpoints
+
+| Method | Endpoint                         | Description                             |
+| ------ | -------------------------------- | --------------------------------------- |
+| GET    | `/metrics`                       | List raw metric records                 |
+| POST   | `/metrics/aggregate`             | Return one aggregate value              |
+| POST   | `/metrics/breakdown`             | Group metrics by dimensions             |
+| POST   | `/metrics/timeseries`            | Bucket metrics by interval              |
+| POST   | `/metrics/percentiles`           | Return percentile series for one metric |
+| GET    | `/discovery/metric-names`        | List metric names                       |
+| GET    | `/discovery/metric-label-keys`   | List label keys for a metric            |
+| GET    | `/discovery/metric-label-values` | List values for a metric label key      |
+
+The list and discovery endpoints take their arguments as query parameters. See [`listMetrics(args)`](https://mastra.ai/reference/observability/metrics/queries) and [metric discovery](https://mastra.ai/reference/observability/metrics/queries) in the metric queries reference for the parameters each one accepts.
+
+Analytics endpoints accept the same JSON request bodies and return types as the [metric queries reference](https://mastra.ai/reference/observability/metrics/queries), including `name`, `aggregation`, `filters`, `groupBy`, `interval`, `percentiles`, `comparePeriod`, `limit`, `orderDirection`, and `distinctColumn`.
+
+```bash
+curl -sS "https://observability.mastra.ai/api/observability/metrics/aggregate" \
+  -X POST \
+  -H "Authorization: Bearer $MASTRA_PLATFORM_ACCESS_TOKEN" \
+  -H "X-Mastra-Project-Id: $MASTRA_PROJECT_ID" \
+  -H "Content-Type: application/json" \
+  --data '{"name":["mastra_model_total_input_tokens","mastra_model_total_output_tokens"],"aggregation":"sum","filters":{"timestamp":{"start":"2026-09-13T00:00:00Z","end":"2026-10-13T00:00:00Z"}},"comparePeriod":"previous_period"}' | jq
+```
+
+`filters.timestamp` is optional. If you omit `start` and `end`, the query covers all retained data. `comparePeriod` requires both `start` and `end`. Without them, the previous-period fields are `null`.
+
+The API returns `401` for invalid credentials, `403` for organization authorization failures, and `400` for malformed query arguments or JSON bodies.
+
+#### `MastraClient`
+
+`MastraClient` from `@mastra/client-js` exposes the analytics and discovery methods. Set `baseUrl` to the region's host without the `/api/observability` path:
+
+```typescript
+import { MastraClient } from '@mastra/client-js'
+
+const mastraClient = new MastraClient({
+  baseUrl: 'https://observability.mastra.ai',
+  headers: {
+    Authorization: `Bearer ${process.env.MASTRA_PLATFORM_ACCESS_TOKEN}`,
+    'X-Mastra-Project-Id': process.env.MASTRA_PROJECT_ID!,
+  },
+})
+
+const result = await mastraClient.getMetricAggregate({
+  name: ['mastra_model_total_input_tokens', 'mastra_model_total_output_tokens'],
+  aggregation: 'sum',
+})
+```
+
+#### CLI
+
+The [`mastra api metric`](https://mastra.ai/reference/cli/mastra) commands target the United States endpoint by default. Pass `--url` to query the European Union region:
+
+```bash
+mastra api --url https://observability.eu.mastra.ai metric aggregate '<json>'
+```
+
 ## Gateway proxy endpoints
 
 Visit the [Gateway documentation](https://gateway.mastra.ai/docs) for more details.

package/.docs/docs/mastra-platform/observability.md

@@ -168,6 +168,8 @@ The CLI can infer platform credentials from your project environment. See the [`
 
 You can query exported feedback over HTTP. See the [Feedback API](https://mastra.ai/docs/mastra-platform/api) for its current status, regional endpoints, authentication, project scoping, and supported query parameters such as `traceId` and `environment`.
 
+You can query exported metrics over HTTP, with `MastraClient`, or with `mastra api metric`. See the [Metrics API](https://mastra.ai/docs/mastra-platform/api) for regional endpoints, authentication, project scoping, and supported endpoints.
+
 ## Import existing traces
 
 Use `mastra traces import` to move existing trace history from a supported observability provider into an existing Mastra Platform project. The command reads and validates complete traces at the source, converts them into Mastra spans, then uses a shared workflow for preparation, upload, resume, and verification.

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

@@ -10,7 +10,7 @@ Mastra emits:
 
 - **Duration metrics** for agent runs, workflows, tools, model calls, and processors
 - **Token usage metrics** for model input and output, including detailed token categories when the provider reports them
-- **Cost estimates** calculated from token usage, provider, model, and model prices from [models.dev](https://models.dev)
+- **Cost estimates** calculated from token usage, provider, model, and model prices from [models.dev](https://models.dev) or from a [custom gateway](https://mastra.ai/models/gateways/custom-gateways)
 
 Metrics retain trace correlation context, so you can investigate a change in a chart by finding the related span. See the [Automatic metrics reference](https://mastra.ai/reference/observability/metrics/automatic-metrics) for metric names, labels, and cost fields.
 

package/.docs/docs/server/request-context.md

@@ -284,11 +284,11 @@ requestContext.set(MASTRA_RESOURCE_ID_KEY, user.id)
 requestContext.set(MASTRA_THREAD_ID_KEY, threadId)
 ```
 
-| Key                         | Purpose                                                                                                                                                                                                                                 |
-| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `MASTRA_RESOURCE_ID_KEY`    | Forces all memory operations to use this resource ID. The server validates that accessed threads belong to this resource and returns 403 if not.                                                                                        |
-| `MASTRA_THREAD_ID_KEY`      | Forces thread operations to use this thread ID, overriding client-provided values                                                                                                                                                       |
-| `MASTRA_MESSAGE_AUTHOR_KEY` | Names who sent a user message as `{ id, name?, avatarUrl? }`. Agent-controller sessions copy it onto every message the request sends as `providerMetadata.mastra.author`, so a thread shared by several people can show who wrote what. |
+| Key                         | Purpose                                                                                                                                                                                                                                                                   |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MASTRA_RESOURCE_ID_KEY`    | Forces all memory operations to use this resource ID. The server validates that accessed threads belong to this resource and returns 403 if not.                                                                                                                          |
+| `MASTRA_THREAD_ID_KEY`      | Forces thread operations to use this thread ID, overriding client-provided values                                                                                                                                                                                         |
+| `MASTRA_MESSAGE_AUTHOR_KEY` | Names who sent a user message as `{ id, name?, avatarUrl? }`. Agent-controller sessions persist it at `content.metadata.signal.author` and mirror it to `providerMetadata.mastra.author` for compatibility, so a thread shared by several people can show who wrote what. |
 
 These keys are used to implement user isolation in multi-tenant applications. See [Authorization middleware](https://mastra.ai/docs/server/middleware) for usage examples.
 

package/.docs/docs/studio/overview.md

@@ -117,7 +117,7 @@ See [datasets overview](https://mastra.ai/docs/evals/datasets) for the full API
 
 ### Experiments
 
-Run all items in a dataset against an agent, workflow, or scorer and collect the results in one place. Select a target, optionally attach scorers, and trigger the experiment. The results view shows each item's input, output, status, and individual score breakdowns. Compare two experiments side by side to measure the impact of prompt, model, or code changes.
+Run all items in a dataset against an agent, workflow, or scorer and collect the results in one place. Select a target, optionally attach scorers, and trigger the experiment. The results view shows each item's input, output, status, and individual score breakdowns. Compare two to ten experiments side by side against a baseline to measure the impact of prompt, model, or code changes.
 
 See [datasets overview](https://mastra.ai/docs/evals/datasets) for setup details.
 

package/.docs/integrations/observability/opentelemetry.md

@@ -766,7 +766,7 @@ No Mastra exporters are required when using the bridge. Traces are sent via your
 
 #### Forwarding logs (optional)
 
-The bridge also forwards Mastra log events to the globally registered OTEL `LoggerProvider`. To wire up logs alongside traces, register a `logRecordProcessor` on `NodeSDK`:
+The bridge also forwards Mastra log events to the globally registered OTEL `LoggerProvider`. To wire up logs alongside traces, register a log record processor on `NodeSDK`:
 
 ```typescript
 import { NodeSDK } from '@opentelemetry/sdk-node'
@@ -775,11 +775,13 @@ import { BatchLogRecordProcessor } from '@opentelemetry/sdk-logs'
 
 const sdk = new NodeSDK({
   // ...trace config as usual
-  logRecordProcessor: new BatchLogRecordProcessor(
-    new OTLPLogExporter({
-      url: process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT || 'http://localhost:4318/v1/logs',
+  logRecordProcessors: [
+    new BatchLogRecordProcessor({
+      exporter: new OTLPLogExporter({
+        url: process.env.OTEL_EXPORTER_OTLP_LOGS_ENDPOINT || 'http://localhost:4318/v1/logs',
+      }),
     }),
-  ),
+  ],
 })
 ```
 
@@ -795,6 +797,10 @@ Use the `--import` flag to ensure instrumentation loads before your application:
 tsx --import ./instrumentation.ts ./src/index.ts
 ```
 
+#### Flushing before exit
+
+Mastra's `flush()` and `shutdown()` ask the registered OTEL providers to flush, but a `BatchSpanProcessor` can still hold a batch it has already started exporting. In serverless or short-lived processes, also `await sdk.shutdown()` after Mastra's flush, so no spans are left in your OTEL SDK when the process exits. The provider's own `forceFlush()` is not enough: it does not wait for a batch the exporter is already sending.
+
 ### Semantic conventions
 
 The `OtelBridge` exports Mastra spans using [OpenTelemetry Semantic Conventions for GenAI v1.38.0](https://github.com/open-telemetry/semantic-conventions/tree/v1.38.0/docs/gen-ai). This includes standardized span names (`chat {model}`, `execute_tool {tool_name}`, etc.) and attributes (`gen_ai.usage.input_tokens`, `gen_ai.request.model`, etc.).

package/.docs/integrations/sandboxes/e2b.md

@@ -402,23 +402,18 @@ Setup commands that need their own credentials — a registry token, a private i
 
 ### Per-session sandboxes
 
-Hosts that construct one sandbox per session, such as Mastra Factory's `sandbox` config, combine the pieces above in a small callback: sandbox identity is the session id (id-keyed getOrCreate — the sandbox pauses on E2B's idle timeout and resumes by id), and the repo template comes from `createRepoTemplate`. The host's session context carries everything the template needs, so it can be passed straight through:
+Hosts that construct one sandbox per session, such as Mastra Factory's `sandbox` config, use `E2BFactorySandbox`: sandbox identity is the session id (id-keyed getOrCreate, so the sandbox pauses on E2B's idle timeout and resumes by id), the repo template comes from `createRepoTemplate` over the session's repositories, and the project's `cpuCount` and `memoryMb` settings flow into the template. See the [FactorySandbox reference](https://mastra.ai/reference/workspace/factory-sandbox).
 
 ```typescript
 import { MastraFactory } from '@mastra/factory'
-import { E2BSandbox, createRepoTemplate } from '@mastra/e2b'
+import { E2BFactorySandbox } from '@mastra/e2b'
 
 new MastraFactory({
-  sandbox: ctx =>
-    new E2BSandbox({
-      id: ctx.sessionId,
-      // Undefined for a session with no repository.
-      template: createRepoTemplate(ctx),
-    }),
+  sandbox: new E2BFactorySandbox({ apiKey: process.env.E2B_API_KEY }),
 })
 ```
 
-Factory attaches its own session setup to the sandbox it gets back, so the callback doesn't wire up a start hook.
+The bare callback form, `sandbox: ctx => new E2BSandbox({ id: ctx.sessionId, template: createRepoTemplate(ctx) })`, is also supported: factory sees it as a custom provider with no settings to tune. Either way, factory attaches its own session setup to the sandbox it gets back.
 
 ## Using with Code Mode
 

package/.docs/models/environment-variables.md

@@ -15,6 +15,7 @@ List of required environment variables for each model provider and gateway suppo
 | [AgentRouter](https://mastra.ai/models/providers/agentrouter)                                | `agentrouter/*`            | `AGENTROUTER_API_KEY`                                                                                 |
 | [Agnes AI](https://mastra.ai/models/providers/agnes)                                         | `agnes/*`                  | `AGNES_API_KEY`                                                                                       |
 | [AI-ROUTER](https://mastra.ai/models/providers/ai-router)                                    | `ai-router/*`              | `AI_ROUTER_API_KEY`                                                                                   |
+| [AI/ML API](https://mastra.ai/models/providers/aimlapi)                                      | `aimlapi/*`                | `AIMLAPI_API_KEY`                                                                                     |
 | [ai&](https://mastra.ai/models/providers/aiand)                                              | `aiand/*`                  | `AIAND_API_KEY`                                                                                       |
 | [AI21 Labs](https://mastra.ai/models/providers/ai21)                                         | `ai21/*`                   | `AI21_API_KEY`                                                                                        |
 | [ainetcafe](https://mastra.ai/models/providers/ainetcafe)                                    | `ainetcafe/*`              | `AINETCAFE_API_KEY`                                                                                   |

package/.docs/models/gateways/custom-gateways.md

@@ -371,6 +371,28 @@ interface ProviderConfig {
   url?: string;                    // Optional API base URL
   apiKeyHeader?: string;           // Optional custom auth header
   docUrl?: string;                 // Optional documentation URL
+  pricing?: Record<string, ModelPricing>; // Optional prices per model ID
+}
+```
+
+### Model pricing
+
+models.dev does not list private deployments, so their calls have no cost in [metrics](https://mastra.ai/docs/observability/metrics/overview). Add a `pricing` entry per model to give them one. Prices are in USD per 1 million tokens and use the same keys as a model's `cost` on [models.dev](https://models.dev): `input`, `output`, `cache_read`, `cache_write`, `reasoning`, `input_audio`, and `output_audio`. `@mastra/observability` reads these prices on the first call to a model it can't price, which also picks up gateways added later with `addGateway()`. Under `mastra dev`, or with `MASTRA_AUTO_REFRESH_PRICING=true`, it also reads them when Mastra starts, so the first call is priced too. models.dev prices take precedence. A gateway price is used only when models.dev has none for that provider and model ID, and then it applies to every call with those IDs, including direct calls. Give a reseller its own provider ID when its rates must stay separate from direct calls. A gateway whose `fetchProviders()` fails is logged and retried about once an hour. Set `MASTRA_OFFLINE=true` to skip loading them. The same shape as models.dev also means you can add `tiers` for long-context pricing.
+
+```typescript
+async fetchProviders(): Promise<Record<string, ProviderConfig>> {
+  return {
+    'my-provider': {
+      name: 'My Provider',
+      models: ['model-1'],
+      apiKeyEnvVar: 'MY_API_KEY',
+      gateway: 'private',
+      url: 'https://api.myprovider.com/v1',
+      pricing: {
+        'model-1': { input: 0.5, output: 1.5, cache_read: 0.05 },
+      },
+    },
+  };
 }
 ```
 

package/.docs/models/gateways/merge-gateway.md

@@ -4,7 +4,7 @@
 
 # ![Merge Gateway logo](https://models.dev/logos/merge-gateway.svg)Merge Gateway
 
-Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 199 models through Mastra's model router.
+Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 203 models through Mastra's model router.
 
 Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
 
@@ -96,6 +96,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.6-flash`                        |
 | `google/gemini-3.7-flash`                        |
 | `google/gemini-3.8-flash`                        |
+| `google/gemini-4-argon`                          |
 | `google/gemini-embedding-001`                    |
 | `google/gemini-embedding-2`                      |
 | `google/gemini-flash-latest`                     |
@@ -189,11 +190,13 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3-coder-next`                          |
 | `qwen/qwen3-coder-plus`                          |
 | `qwen/qwen3-max`                                 |
+| `qwen/qwen3-max-preview`                         |
 | `qwen/qwen3-next-80b-a3b-instruct`               |
 | `qwen/qwen3-next-80b-a3b-thinking`               |
 | `qwen/qwen3-vl-235b-a22b-instruct`               |
 | `qwen/qwen3-vl-235b-a22b-thinking`               |
 | `qwen/qwen3-vl-30b-a3b-instruct`                 |
+| `qwen/qwen3-vl-flash`                            |
 | `qwen/qwen3-vl-plus`                             |
 | `qwen/qwen3.5-122b-a10b`                         |
 | `qwen/qwen3.5-27b`                               |
@@ -212,6 +215,7 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3.8-2.4t-a95b`                         |
 | `qwen/qwen3.8-flash`                             |
 | `qwen/qwen3.8-max`                               |
+| `sakana/fugu-max`                                |
 | `sakana/fugu-ultra`                              |
 | `sakana/sakana-namazu`                           |
 | `thinkingmachines/inkling`                       |

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

@@ -4,7 +4,7 @@
 
 # Netlify
 
-Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 274 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 275 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -72,6 +72,7 @@ ANTHROPIC_API_KEY=ant-...
 | `gemini/gemini-3.6-flash`                                             |
 | `gemini/gemini-3.7-flash`                                             |
 | `gemini/gemini-3.8-flash`                                             |
+| `gemini/gemini-4-argon`                                               |
 | `gemini/gemini-flash-latest`                                          |
 | `gemini/gemini-flash-lite-latest`                                     |
 | `gemini/gemini-nano-banana-2.1`                                       |
@@ -136,7 +137,6 @@ ANTHROPIC_API_KEY=ant-...
 | `openrouter/~z-ai/glm-flash-latest`                                   |
 | `openrouter/~z-ai/glm-latest`                                         |
 | `openrouter/anthracite-org/magnum-v4-72b`                             |
-| `openrouter/apodex/apodex-1.1-mini:free`                              |
 | `openrouter/bytedance-seed/seed-1.6`                                  |
 | `openrouter/bytedance-seed/seed-1.6-flash`                            |
 | `openrouter/bytedance-seed/seed-2-1-turbo`                            |
@@ -169,12 +169,11 @@ ANTHROPIC_API_KEY=ant-...
 | `openrouter/inception/mercury-2`                                      |
 | `openrouter/inception/mercury-2.5`                                    |
 | `openrouter/inclusionai/ling-3.0-flash`                               |
-| `openrouter/inclusionai/ling-3.0-flash-fin`                           |
-| `openrouter/inclusionai/ling-3.0-flash-sante`                         |
 | `openrouter/inclusionai/ling-3.0-flash-vl`                            |
 | `openrouter/inclusionai/ling-3.1-flash`                               |
 | `openrouter/inference-net/schematron-v2-small`                        |
 | `openrouter/inference-net/schematron-v2-turbo`                        |
+| `openrouter/liquid/lfm-2.5-24b-a2b`                                   |
 | `openrouter/mancer/weaver`                                            |
 | `openrouter/meta-llama/llama-3.1-70b-instruct`                        |
 | `openrouter/meta-llama/llama-3.1-8b-instruct`                         |
@@ -272,6 +271,8 @@ ANTHROPIC_API_KEY=ant-...
 | `openrouter/sao10k/l3-lunaris-8b`                                     |
 | `openrouter/sao10k/l3.1-euryale-70b`                                  |
 | `openrouter/sao10k/l3.3-euryale-70b`                                  |
+| `openrouter/scaledown/extract`                                        |
+| `openrouter/scaledown/summarize`                                      |
 | `openrouter/stepfun/step-3.7-flash`                                   |
 | `openrouter/tencent/hy-mt2-1.8b`                                      |
 | `openrouter/tencent/hy-mt2-30b-a3b`                                   |

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

@@ -4,7 +4,7 @@
 
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 380 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 382 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -84,7 +84,6 @@ ANTHROPIC_API_KEY=ant-...
 | `anthropic/claude-sonnet-4.6`                              |
 | `anthropic/claude-sonnet-5`                                |
 | `anthropic/claude-sonnet-5.5`                              |
-| `apodex/apodex-1.1-mini:free`                              |
 | `arcee-ai/trinity-large-thinking`                          |
 | `bytedance-seed/seed-1.6`                                  |
 | `bytedance-seed/seed-1.6-flash`                            |
@@ -136,6 +135,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.6-flash`                                  |
 | `google/gemini-3.7-flash`                                  |
 | `google/gemini-3.8-flash`                                  |
+| `google/gemini-4-argon`                                    |
 | `google/gemini-nano-banana-2.1`                            |
 | `google/gemma-2-27b-it`                                    |
 | `google/gemma-3-12b-it`                                    |
@@ -153,13 +153,12 @@ ANTHROPIC_API_KEY=ant-...
 | `inception/mercury-2`                                      |
 | `inception/mercury-2.5`                                    |
 | `inclusionai/ling-3.0-flash`                               |
-| `inclusionai/ling-3.0-flash-fin`                           |
-| `inclusionai/ling-3.0-flash-sante`                         |
 | `inclusionai/ling-3.0-flash-vl`                            |
 | `inclusionai/ling-3.1-flash`                               |
 | `inference-net/schematron-v2-small`                        |
 | `inference-net/schematron-v2-turbo`                        |
 | `liquid/lfm-2.5-2.6b:free`                                 |
+| `liquid/lfm-2.5-24b-a2b`                                   |
 | `mancer/weaver`                                            |
 | `meituan/longcat-2.0`                                      |
 | `meta-llama/llama-3.1-70b-instruct`                        |
@@ -366,6 +365,8 @@ ANTHROPIC_API_KEY=ant-...
 | `sao10k/l3-lunaris-8b`                                     |
 | `sao10k/l3.1-euryale-70b`                                  |
 | `sao10k/l3.3-euryale-70b`                                  |
+| `scaledown/extract`                                        |
+| `scaledown/summarize`                                      |
 | `stepfun/step-3.5-flash`                                   |
 | `stepfun/step-3.7-flash`                                   |
 | `stepfun/step-5-preview`                                   |
@@ -385,6 +386,7 @@ ANTHROPIC_API_KEY=ant-...
 | `thinkingmachines/inkling:free`                            |
 | `unbiased/pareto`                                          |
 | `unbiased/pareto-26.10-preview`                            |
+| `unbiased/pareto-26.9`                                     |
 | `undi95/remm-slerp-l2-13b`                                 |
 | `upstage/solar-mini4`                                      |
 | `upstage/solar-pro-3`                                      |

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

@@ -4,7 +4,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 402 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 407 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -146,6 +146,7 @@ ANTHROPIC_API_KEY=ant-...
 | `deepseek/deepseek-v4.1-flash`             |
 | `deepseek/deepseek-v4.1-flash-fast`        |
 | `fireworks/ember-1`                        |
+| `fish-audio/drama-3`                       |
 | `fish-audio/s1`                            |
 | `fish-audio/s2-pro`                        |
 | `fish-audio/s2.1-pro`                      |
@@ -172,6 +173,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.8-flash-tts`              |
 | `google/gemini-3.8-live`                   |
 | `google/gemini-3.8-live-extended-thinking` |
+| `google/gemini-4-argon`                    |
 | `google/gemini-embedding-001`              |
 | `google/gemini-embedding-2`                |
 | `google/gemini-nano-banana-2.1`            |
@@ -194,7 +196,6 @@ ANTHROPIC_API_KEY=ant-...
 | `inclusionai/ling-3.0-flash-sante`         |
 | `inclusionai/ling-3.0-flash-vl`            |
 | `inclusionai/ling-3.1-flash`               |
-| `inclusionai/ling-3.1-flash-free`          |
 | `inference-net/schematron-v2-small`        |
 | `inference-net/schematron-v2-turbo`        |
 | `interfaze/interfaze-beta`                 |
@@ -206,6 +207,7 @@ ANTHROPIC_API_KEY=ant-...
 | `klingai/kling-v3.0-i2v`                   |
 | `klingai/kling-v3.0-motion-control`        |
 | `klingai/kling-v3.0-t2v`                   |
+| `liquid/lfm2.5-24b-a2b`                    |
 | `meituan/longcat-2.5-preview`              |
 | `meta/llama-3.1-70b`                       |
 | `meta/llama-3.1-8b`                        |
@@ -220,6 +222,8 @@ ANTHROPIC_API_KEY=ant-...
 | `meta/muse-spark-1.3`                      |
 | `meta/muse-spark-1.3-contributor`          |
 | `meta/muse-wonder-1.0`                     |
+| `microsoft/mai-image-2.6`                  |
+| `microsoft/mai-image-2.6-flash`            |
 | `microsoft/mai-transcribe-2`               |
 | `microsoft/mai-transcribe-2-streaming`     |
 | `microsoft/mai-voice-2`                    |
@@ -261,6 +265,7 @@ ANTHROPIC_API_KEY=ant-...
 | `nvidia/nemotron-3-super-120b-a12b`        |
 | `nvidia/nemotron-3-ultra-550b-a55b`        |
 | `nvidia/nemotron-3.5-lightning`            |
+| `nvidia/nemotron-3.5-lightning-free`       |
 | `nvidia/nemotron-nano-12b-v2-vl`           |
 | `nvidia/nemotron-nano-9b-v2`               |
 | `openai/gpt-3.5-turbo`                     |

package/.docs/models/index.md

@@ -4,7 +4,7 @@
 
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7910 models from 215 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 8147 models from 216 providers through a single API.
 
 ## Features
 
@@ -383,6 +383,7 @@ Every provider below works with the model router as `provider/model`. Read the p
 - [AgentRouter](https://mastra.ai/models/providers/agentrouter)
 - [Agnes AI](https://mastra.ai/models/providers/agnes)
 - [AI-ROUTER](https://mastra.ai/models/providers/ai-router)
+- [AI/ML API](https://mastra.ai/models/providers/aimlapi)
 - [ai&](https://mastra.ai/models/providers/aiand)
 - [AI21 Labs](https://mastra.ai/models/providers/ai21)
 - [ainetcafe](https://mastra.ai/models/providers/ainetcafe)