@mastra/mcp-docs-server 1.2.26-alpha.1 → 1.2.26-alpha.14

package/.docs/integrations/agentic-ui/ai-sdk-ui.md

@@ -1362,6 +1362,11 @@ export function NestedAgentChat() {
                 <div key={index} className="nested-agent">
                   <strong>Nested Agent: {id}</strong>
                   {data.text && <p>{data.text}</p>}
+                  {data.toolErrors?.map(toolError => (
+                    <p key={toolError.toolCallId} className="nested-agent-error">
+                      {toolError.toolName} failed: {toolError.errorText}
+                    </p>
+                  ))}
                 </div>
               )
             }
@@ -1388,6 +1393,8 @@ Key points:
 - Piping `fullStream` to `context.writer` creates `data-tool-agent` parts
 - Read `data-tool-agent-step` when you need the full payload for the nested step that finished
 - The `AgentDataPart` has `id` (on the part) and `data.text` (the current nested-agent text snapshot)
+- A tool that throws inside the nested agent is reported in `data.toolErrors`, each entry `{ toolCallId, toolName, args?, errorText, providerExecuted? }`. `errorText` is a JSON-safe string, so the failure survives serialization to the client instead of arriving as `{}`
+- `toolErrors` resets at each nested step boundary, like `toolCalls` and `toolResults`. For a finished step, read it from `data-tool-agent-step` (`data.step.toolErrors`) or from `data.steps[]` on the final snapshot
 - The tool still returns its own output after the stream completes
 
 For a complete implementation, see the [tool-nested-streams example](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/tool-nested-streams.tsx) in UI Dojo.

package/.docs/integrations/file-storage/amazon-s3.md

@@ -111,7 +111,13 @@ const filesystem = new S3Filesystem({
 })
 ```
 
-Provider functions only apply to `S3Filesystem` API calls. When mounting the filesystem into an E2B sandbox, mount configuration only supports static `accessKeyId`, `secretAccessKey`, and `sessionToken` values, so credential refresh must be handled outside the mount.
+Provider functions only apply to `S3Filesystem` API calls. When mounting the filesystem into an E2B or Daytona sandbox, mount configuration only supports static `accessKeyId`, `secretAccessKey`, and `sessionToken` values, so credential refresh must be handled outside the mount. See [temporary credentials in Daytona](https://mastra.ai/integrations/sandboxes/daytona) for mount lifetime and isolation requirements.
+
+### Prefix-scoped permissions
+
+When `prefix` is set, initialization calls `ListObjectsV2` with the normalized prefix, including its trailing `/`, and `MaxKeys: 1`. Credentials must permit listing that prefix. Without a prefix, initialization uses `HeadBucket`. These checks verify access, not whether a directory exists.
+
+The prefix limits which keys the filesystem addresses; it isn't an authorization boundary. For isolation, use credentials whose storage-provider policy restricts access to that prefix. Keep parent credentials on your backend. Read and write permissions alone aren't sufficient for prefixed filesystem initialization.
 
 ### Cloudflare R2
 

package/.docs/integrations/file-storage/archil.md

@@ -4,7 +4,7 @@
 
 # Archil
 
-Stores files on [Archil](https://docs.archil.com) elastic, serverless disks. Combines an S3-compatible object API for fast reads/writes with `exec()` for POSIX shell operations and `grep()` for parallel server-side search. For interface details, see [WorkspaceFilesystem Interface](https://mastra.ai/reference/workspace/filesystem).
+Stores files on [Archil](https://docs.archil.com) elastic, serverless disks. Combines an S3-compatible object API for fast reads/writes with `exec()` for POSIX shell operations and `diskGrep()` for parallel server-side search. For interface details, see [WorkspaceFilesystem Interface](https://mastra.ai/reference/workspace/filesystem).
 
 ## Installation
 
@@ -173,12 +173,12 @@ const result = await filesystem.exec('ls -la /data')
 // { exitCode: 0, stdout: '...', stderr: '' }
 ```
 
-#### `grep(options)`
+#### `diskGrep(options)`
 
 Run a parallel server-side search across files on the disk.
 
 ```typescript
-const results = await filesystem.grep({
+const results = await filesystem.diskGrep({
   directory: '/logs',
   pattern: 'ERROR',
   recursive: true,

package/.docs/integrations/frameworks/electron.md

@@ -430,7 +430,7 @@ export default function App(): React.JSX.Element {
 }
 ```
 
-This connects [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) to the `/chat/weather-agent` endpoint, sending propmts there and streaming the response back in chunks.
+This connects [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat) to the `/chat/weather-agent` endpoint, sending prompts there and streaming the response back in chunks.
 
 ## Test your agent
 

package/.docs/integrations/observability/langfuse.md

@@ -216,7 +216,7 @@ const tracingOptions = {
 
 This example produces `langfuse.trace.metadata.customerId` and `langfuse.trace.metadata.tier`.
 
-Metadata on the root span is also forwarded. Mastra sets `runId` and `resourceId` on every agent and workflow root span, and you can add your own keys through `tracingOptions.metadata`. The exporter forwards each of these root span keys to `langfuse.trace.metadata.<key>`. Keys that map to a dedicated Langfuse field (`userId`, `sessionId`, `threadId`, `traceName`, and `version`) are not duplicated as trace metadata. Metadata on child spans stays on the observation and never changes the trace.
+Metadata on the root span is also forwarded. Mastra sets `runId` and `resourceId` on every agent and workflow root span, and you can add your own keys through `tracingOptions.metadata`. The exporter forwards each of these root span keys to `langfuse.trace.metadata.<key>`. Keys that map to a dedicated Langfuse field (`userId`, `sessionId`, `threadId`, `traceName`, and `version`) are not duplicated as trace metadata. Other metadata on child spans stays on the observation. Dedicated fields such as session IDs follow their own mapping rules.
 
 Notes:
 
@@ -225,6 +225,16 @@ Notes:
 - Keys under `langfuse` take precedence over root span metadata with the same name.
 - Values are sent as strings, because Langfuse maps trace metadata attributes as strings. Numbers, booleans, and objects are serialized with JSON. Langfuse Cloud restores them to their original types on ingestion.
 
+## Conversation sessions
+
+The exporter maps span metadata to Langfuse sessions using `sessionId`, or `threadId` when `sessionId` is absent or `null`. An explicit empty `sessionId` suppresses this fallback and sends no session ID.
+
+For [Observational Memory](https://mastra.ai/docs/memory/observational-memory), the Langfuse exporter keeps observer and reflector spans in the caller's session, even when child spans arrive before their parents. An explicit `sessionId`, including an empty string, takes precedence. Otherwise, the exporter uses the original caller thread carried by Observational Memory before falling back to the span's own `threadId`. Observational Memory captures that caller identity from the caller span's non-empty `threadId`, or the original request's thread ID. Nested observation preserves the outer caller identity.
+
+This thread-to-session fallback is specific to Langfuse. Observational Memory doesn't synthesize generic `sessionId` metadata from a thread ID for other exporters.
+
+Internal observer and reflector execution threads remain separate. Multi-thread observation uses the invoking caller's session, not the first thread in the batch. This session behavior applies regardless of the `bufferOnIdle` setting and doesn't change buffering or span parentage.
+
 ## Prompt linking
 
 You can link LLM generations to prompts stored in [Langfuse Prompt Management](https://langfuse.com/docs/prompt-management). It enables version tracking and metrics for your prompts.

package/.docs/integrations/sandboxes/cloudflare-sandbox.md

@@ -82,6 +82,8 @@ const result = await workspace.sandbox?.executeCommand?.('npm', ['test'], {
 
 Relative paths are resolved under `/workspace`. Absolute paths must also resolve within `/workspace`. Each file is sent as its own bridge request, and the bridge caps a single file at 32 MiB.
 
+The Cloudflare sandbox cannot set per-file permissions, so a `writeFiles` call that includes a `mode` is rejected rather than silently ignored.
+
 ```typescript
 await workspace.sandbox?.writeFiles?.([
   { path: 'src/index.ts', content: "console.log('hello')\n" },
@@ -89,6 +91,31 @@ await workspace.sandbox?.writeFiles?.([
 ])
 ```
 
+## Read files
+
+Read a single file back from `/workspace` as raw bytes. Relative paths resolve under `/workspace`, and absolute paths must also resolve within it.
+
+```typescript
+const bytes = await workspace.sandbox?.readFile?.('src/index.ts')
+const source = new TextDecoder().decode(bytes)
+```
+
+## Persist and restore the workspace
+
+`persistWorkspace()` archives `/workspace` and returns the raw tar bytes; `hydrateWorkspace()` restores it from those bytes. Store the archive between sessions to resume work after a container sleeps or is recreated.
+
+```typescript
+// Back up before the container can sleep
+const archive = await workspace.sandbox?.persistWorkspace?.({ excludes: ['node_modules'] })
+await myStorage.put('workspace-backup', archive)
+
+// Later, on a fresh or reconnected sandbox
+const archive = await myStorage.get('workspace-backup')
+await workspace.sandbox?.hydrateWorkspace?.(archive)
+```
+
+For bucket mounts and execution sessions, use the corresponding `CloudflareSandboxBridgeClient` methods (`mountBucket`, `unmountBucket`, `createSession`, `deleteSession`) directly.
+
 ## Constructor parameters
 
 **baseUrl** (`string`): URL of the deployed Cloudflare Sandbox Bridge Worker.
@@ -117,4 +144,4 @@ await workspace.sandbox?.writeFiles?.([
 
 ## Limitations
 
-The provider supports command execution, streamed output, and file writes. It doesn't currently expose the bridge's bucket mounts, sessions, PTY terminals, or workspace persistence routes, and it doesn't support background process management, stdin, snapshots, or port URLs.
+The provider surfaces command execution, streamed output, file reads and writes, and workspace persistence directly on the sandbox. Bucket mounts and sessions are available on the bridge client (`CloudflareSandboxBridgeClient`) but not on the `CloudflareSandbox` surface. PTY terminals are not exposed, and the provider doesn't support background process management, stdin, snapshots, or port URLs.

package/.docs/integrations/sandboxes/daytona.md

@@ -200,6 +200,39 @@ const workspace = new Workspace({
 
 When the workspace starts, the filesystems are automatically mounted at the specified paths. Code running in the sandbox can then access files at `/s3-data` and `/gcs-data` as if they were local directories.
 
+#### Temporary S3 credentials
+
+Pass all three credential values to `S3Filesystem` when using temporary credentials. Daytona forwards the session token to s3fs:
+
+```typescript
+import { Workspace } from '@mastra/core/workspace'
+import { DaytonaSandbox } from '@mastra/daytona'
+import { S3Filesystem } from '@mastra/s3'
+
+const workspace = new Workspace({
+  mounts: {
+    '/s3-data': new S3Filesystem({
+      bucket: process.env.S3_BUCKET!,
+      region: process.env.S3_REGION ?? 'us-east-1',
+      endpoint: process.env.S3_ENDPOINT,
+      prefix: 'resource-123/thread-456/',
+      accessKeyId: process.env.SCOPED_S3_ACCESS_KEY_ID!,
+      secretAccessKey: process.env.SCOPED_S3_SECRET_ACCESS_KEY!,
+      sessionToken: process.env.SCOPED_S3_SESSION_TOKEN!,
+    }),
+  },
+  sandbox: new DaytonaSandbox({ language: 'python', ephemeral: true }),
+})
+```
+
+Before starting the workspace, obtain credentials from your storage provider that authorize only the intended prefix. Credential issuance is provider-specific; Mastra doesn't mint or restrict credentials. A `prefix` selects a directory but doesn't enforce authorization. Authenticate each request, authorize its resource and thread, and use separate sandboxes for separate security scopes.
+
+Temporary credentials are loaded when the mount starts and aren't automatically refreshed. Host-side credential provider functions don't refresh the mount. Keep runs within the credential lifetime and create a new sandbox with fresh credentials for later runs. Reconnecting to a sandbox doesn't renew its credentials.
+
+Credentials are uploaded into owner-only files inside private directories. After launching s3fs, Daytona removes the temporary-credential staging file and directory. The daemon retains the credentials in its environment, which sandbox code running as the same user or root can still read. Never supply broader credentials than the sandbox needs. Mounts using long-lived credentials retain their password files while s3fs needs them. Unmount and reconnect cleanup remove those files after verifying that the daemon has exited. If a daemon is still active, including after a mount is moved aside, or its status can't be checked, the files are retained and a warning is logged. Cleanup on a later unmount of the same path retries removal; deleting the sandbox removes any remaining files.
+
+Prefixed filesystems require permission to list their prefix during initialization. With s3fs, a prefixed mount may also require a zero-byte object at the exact `<prefix>/` key. Provision that directory marker before mounting. After launching s3fs, Daytona checks the mounted directory's metadata without listing its contents, with a 15-second timeout and forced termination after another 5 seconds. A failed check reports a mount failure. Cleanup attempts to unmount the failed mount, moving a stuck mount aside if necessary to free the original path for retry. Moved stale mounts may remain until sandbox deletion. This startup check doesn't guarantee read or write access to individual files or ongoing daemon health; verify a read and write through the mounted path.
+
 #### Via `sandbox.mount()`
 
 Mount manually at any point after the sandbox has started:

package/.docs/integrations/sandboxes/docker.md

@@ -162,6 +162,19 @@ const sandbox = new DockerSandbox({
 })
 ```
 
+## Write files
+
+Upload multiple files in one call with `writeFiles`. Relative paths resolve under the working directory. Set an optional per-file `mode` to control POSIX permissions; it must be an integer between `0o001` and `0o777`. When `mode` is omitted, new files are created with `0644`.
+
+```typescript
+await sandbox.writeFiles([
+  { path: 'src/index.js', content: "console.log('hello')\n" },
+  { path: 'run.sh', content: '#!/bin/sh\n', mode: 0o755 },
+])
+```
+
+Docker is the only built-in sandbox that applies an explicit `mode`. Providers that cannot honor per-file permissions (Vercel, E2B, Daytona, Cloudflare) reject a `writeFiles` call that includes a `mode` instead of silently dropping it.
+
 ## Bind mounts
 
 Mount host directories into the container using the `volumes` option:

package/.docs/integrations/voice/livekit.md

@@ -205,6 +205,28 @@ export default createLiveKitWorker({
 
 `configuration.stt` works the same way for per-call transcription, for example a different transcription model or language per tenant. The greeting has a matching per-call form: `configuration.greeting.text` accepts a resolver with the same call context, so one worker can open with each tenant's own phrasing.
 
+### Per-call turn detection
+
+LiveKit's `TurnDetector` classes read the job's inference executor when constructed, so they can only be created inside a LiveKit job, not at module scope where the worker options live. To use one, set the `configuration.turnDetection` resolver. It runs once per call with the same call context as `configuration.stt` and returns anything the top-level `turnDetection` option accepts. Return `undefined` to fall back to the top-level option.
+
+```typescript
+import { turnDetector } from '@livekit/agents-plugin-livekit'
+
+export default createLiveKitWorker({
+  mastra,
+  agent: 'support',
+  stt: 'deepgram/nova-3',
+  tts: 'cartesia/sonic-3',
+  turnDetection: 'multilingual',
+  configuration: {
+    // Constructed inside the job, where the inference executor is available.
+    turnDetection: () => new turnDetector.MultilingualModel(0.2),
+  },
+})
+```
+
+The semantic model's inference runners must be registered before the agent server boots, so when this resolver is set the worker imports `@livekit/agents-plugin-livekit` up front. Keep the top-level `turnDetection` set to `'multilingual'` or `'english'` to pre-register only that model; otherwise both stay available.
+
 ### Memory and threads
 
 When the resolved Mastra agent has memory configured, each call becomes one memory thread:
@@ -539,7 +561,7 @@ if (process.argv[1] === fileURLToPath(import.meta.url)) {
 
 **vad** (`VAD | 'silero' | false`): Voice activity detection. 'silero' loads the Silero VAD from @livekit/agents-plugin-silero during prewarm. Pass an instance to bring your own, or false to disable. (Default: `'silero'`)
 
-**turnDetection** (`'multilingual' | 'english' | TurnDetectionMode`): End-of-turn detection. 'multilingual' and 'english' load LiveKit's semantic turn detector from @livekit/agents-plugin-livekit. Other values such as 'vad', 'stt', or 'manual' pass through.
+**turnDetection** (`'multilingual' | 'english' | TurnDetectionMode`): End-of-turn detection. 'multilingual' and 'english' load LiveKit's semantic turn detector from @livekit/agents-plugin-livekit. Other values such as 'vad', 'stt', or 'manual' pass through. To construct a TurnDetector instance per call, set the configuration.turnDetection resolver — it takes precedence, with this option as the fallback.
 
 **turnHandling** (`Partial<TurnHandlingOptions>`): Turn handling tuning: endpointing delays, interruption sensitivity, preemptive generation. The worker disables preemptiveGeneration unless set here — each preemptive attempt re-runs the Mastra agent and persists partial user and assistant messages unless memory.options.readOnly is set.
 
@@ -551,7 +573,7 @@ if (process.argv[1] === fileURLToPath(import.meta.url)) {
 
 **onTurnComplete** (`(ctx: VoiceTurnCompleteContext) => void | Promise<void>`): Called once per turn after the reply finished streaming to text-to-speech. Runs off the audio path and is not awaited. The context carries the produced reply (text, toolCalls, interrupted, usage) and the resolved memory mapping.
 
-**configuration** (`LiveKitWorkerConfiguration`): Grouped conversation and compliance configuration: the opening greeting and AI disclosure, consent requirements, agent-initiated hang-up, and per-call STT/TTS selection.
+**configuration** (`LiveKitWorkerConfiguration`): Grouped conversation and compliance configuration: the opening greeting and AI disclosure, consent requirements, agent-initiated hang-up, and per-call STT/TTS/turn detection selection.
 
 **configuration.greeting** (`GreetingConfiguration`): The opening greeting and AI disclosure: text (a fixed string or a per-call resolver for per-tenant greetings), allowInterruptions, awaitPlayout, persist, and periodic re-disclosure via repeatEvery and repeatText.
 
@@ -563,6 +585,8 @@ if (process.argv[1] === fileURLToPath(import.meta.url)) {
 
 **configuration.tts** (`(context: VoiceCallContext) => TTS | string | undefined`): Per-call text-to-speech: a resolver invoked once per call (post-connect) with { metadata, requestContext, roomName, ctx }, returning anything the top-level tts option accepts — one voice or language per tenant. Return undefined to fall back to the top-level tts. Cache plugin instances across calls.
 
+**configuration.turnDetection** (`(context: VoiceCallContext) => TurnDetectionMode | undefined`): Per-call end-of-turn detection: a resolver invoked once per call (post-connect, inside the LiveKit job) with { metadata, requestContext, roomName, ctx }, returning anything the top-level turnDetection option accepts. Use it to construct LiveKit TurnDetector instances, which need the job's inference executor. Return undefined to fall back to the top-level turnDetection.
+
 **greeting** (`string`): Static greeting spoken when the session starts. Deprecated: prefer configuration.greeting.text.
 
 **persistGreeting** (`boolean`): Save the spoken greeting to the memory thread as an assistant message, making the saved thread a faithful call transcript. Only applies when a greeting is set and memory is enabled. Deprecated: prefer configuration.greeting.persist. (Default: `true`)

package/.docs/integrations/voice/openai.md

@@ -232,6 +232,16 @@ Disconnects from the OpenAI Realtime session and cleans up resources. Should be
 
 Returns: `void`
 
+#### `sendEvent()`
+
+Sends a raw client event to the OpenAI Realtime session. Use this for session control that has no dedicated method, such as adding conversation items. Events sent before the session is created are queued and sent once it is.
+
+**type** (`string`): OpenAI Realtime client event type, such as conversation.item.create.
+
+**data** (`Record<string, unknown>`): Event payload sent alongside the type. (Default: `{}`)
+
+Returns: `void`
+
 #### `getSpeakers()`
 
 Returns a list of available voice speakers.
@@ -270,17 +280,19 @@ The OpenAIRealtimeVoice class emits the following events:
 
 #### OpenAI Realtime Events
 
-You can also listen to [OpenAI Realtime utility events](https://github.com/openai/openai-realtime-api-beta#reference-client-utility-events) by prefixing with 'openAIRealtime:':
-
-**openAIRealtime:conversation.created** (`event`): Emitted when a new conversation is created.
+Every server event received from the OpenAI Realtime API is also emitted with the `openAIRealtime:` prefix, using the [OpenAI server event type](https://platform.openai.com/docs/api-reference/realtime-server-events) as the suffix. The callback receives the complete event payload.
 
-**openAIRealtime:conversation.interrupted** (`event`): Emitted when a conversation is interrupted.
+```typescript
+voice.on('openAIRealtime:rate_limits.updated', event => {
+  console.log(event.rate_limits)
+})
+```
 
-**openAIRealtime:conversation.updated** (`event`): Emitted when a conversation is updated.
+#### Socket Events
 
-**openAIRealtime:conversation.item.appended** (`event`): Emitted when an item is appended to the conversation.
+**open** (`event`): Emitted when the WebSocket connection to OpenAI opens.
 
-**openAIRealtime:conversation.item.completed** (`event`): Emitted when an item in the conversation is completed.
+**close** (`event`): Emitted when the WebSocket connection closes, including when OpenAI closes it. Callback receives { code: number, reason: string }.
 
 ### Available voices
 

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

@@ -79,6 +79,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Impossibl](https://mastra.ai/models/providers/impossibl)                                      | `impossibl/*`              | `IMPOSSIBL_API_KEY`                                                                                   |
 | [Inception](https://mastra.ai/models/providers/inception)                                      | `inception/*`              | `INCEPTION_API_KEY`                                                                                   |
 | [Inceptron](https://mastra.ai/models/providers/inceptron)                                      | `inceptron/*`              | `INCEPTRON_API_KEY`                                                                                   |
+| [Infer by Flow7](https://mastra.ai/models/providers/infer)                                     | `infer/*`                  | `INFER_API_KEY`                                                                                       |
 | [Inference](https://mastra.ai/models/providers/inference)                                      | `inference/*`              | `INFERENCE_API_KEY`                                                                                   |
 | [InferX](https://mastra.ai/models/providers/inferx)                                            | `inferx/*`                 | `INFERX_API_KEY`                                                                                      |
 | [Infomaniak](https://mastra.ai/models/providers/infomaniak)                                    | `infomaniak/*`             | `INFOMANIAK_PRODUCT_ID`, `INFOMANIAK_API_KEY`                                                         |
@@ -102,6 +103,7 @@ List of required environment variables for each model provider and gateway suppo
 | [LucidQuery](https://mastra.ai/models/providers/lucidquery)                                    | `lucidquery/*`             | `LUCIDQUERY_API_KEY`                                                                                  |
 | [Lynkr](https://mastra.ai/models/providers/lynkr)                                              | `lynkr/*`                  | `LYNKR_API_KEY`                                                                                       |
 | [Meganova](https://mastra.ai/models/providers/meganova)                                        | `meganova/*`               | `MEGANOVA_API_KEY`                                                                                    |
+| [Melious](https://mastra.ai/models/providers/melious)                                          | `melious/*`                | `MELIOUS_API_KEY`                                                                                     |
 | [Meta](https://mastra.ai/models/providers/meta)                                                | `meta/*`                   | `META_MODEL_API_KEY`                                                                                  |
 | [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)                             | `minimax/*`                | `MINIMAX_API_KEY`                                                                                     |
 | [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)                        | `minimax-cn/*`             | `MINIMAX_API_KEY`                                                                                     |
@@ -182,11 +184,13 @@ List of required environment variables for each model provider and gateway suppo
 | [UnoRouter](https://mastra.ai/models/providers/unorouter)                                      | `unorouter/*`              | `UNOROUTER_API_KEY`                                                                                   |
 | [Upstage](https://mastra.ai/models/providers/upstage)                                          | `upstage/*`                | `UPSTAGE_API_KEY`                                                                                     |
 | [Vancine](https://mastra.ai/models/providers/vancine)                                          | `vancine/*`                | `VANCINE_API_KEY`                                                                                     |
+| [Vispark](https://mastra.ai/models/providers/vispark)                                          | `vispark/*`                | `VISPARK_LAB_API_KEY`                                                                                 |
 | [Vivgrid](https://mastra.ai/models/providers/vivgrid)                                          | `vivgrid/*`                | `VIVGRID_API_KEY`                                                                                     |
 | [Volcengine Ark](https://mastra.ai/models/providers/volcengine)                                | `volcengine/*`             | `ARK_API_KEY`                                                                                         |
 | [Volcengine Ark Coding Plan](https://mastra.ai/models/providers/volcengine-coding-plan)        | `volcengine-coding-plan/*` | `ARK_CODING_PLAN_API_KEY`                                                                             |
 | [Vultr](https://mastra.ai/models/providers/vultr)                                              | `vultr/*`                  | `VULTR_API_KEY`                                                                                       |
 | [Wafer](https://mastra.ai/models/providers/wafer.ai)                                           | `wafer.ai/*`               | `WAFER_API_KEY`                                                                                       |
+| [Wallaby](https://mastra.ai/models/providers/wallaby)                                          | `wallaby/*`                | `WALLABY_API_KEY`                                                                                     |
 | [Weights & Biases](https://mastra.ai/models/providers/wandb)                                   | `wandb/*`                  | `WANDB_API_KEY`                                                                                       |
 | [xAI](https://mastra.ai/models/providers/xai)                                                  | `xai/*`                    | `XAI_API_KEY`                                                                                         |
 | [Xiaomi](https://mastra.ai/models/providers/xiaomi)                                            | `xiaomi/*`                 | `XIAOMI_API_KEY`                                                                                      |

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 182 models through Mastra's model router.
+Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 187 models through Mastra's model router.
 
 Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
 
@@ -67,6 +67,7 @@ ANTHROPIC_API_KEY=ant-...
 | `deepseek/deepseek-v3.1`                         |
 | `deepseek/deepseek-v3.2`                         |
 | `deepseek/deepseek-v4-flash`                     |
+| `deepseek/deepseek-v4-flash-0423`                |
 | `deepseek/deepseek-v4-flash-0731`                |
 | `deepseek/deepseek-v4-flash-0731-fast`           |
 | `deepseek/deepseek-v4-pro`                       |
@@ -94,6 +95,9 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-embedding-001`                    |
 | `google/gemini-flash-latest`                     |
 | `google/gemini-flash-lite-latest`                |
+| `google/gemma-3-12b-it`                          |
+| `google/gemma-3-27b-it`                          |
+| `google/gemma-3-4b-it`                           |
 | `google/gemma-4-26b-a4b-it`                      |
 | `google/gemma-4-31b-it`                          |
 | `meta/llama-3.1-70b-instruct`                    |
@@ -160,6 +164,7 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-oss-120b`                            |
 | `openai/gpt-oss-20b`                             |
 | `openai/gpt-oss-safeguard-120b`                  |
+| `openai/gpt-oss-safeguard-20b`                   |
 | `openai/o1`                                      |
 | `openai/o3`                                      |
 | `openai/o3-mini`                                 |

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 252 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 257 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -117,6 +117,8 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/o3`                                                           |
 | `openai/o3-mini`                                                      |
 | `openai/o4-mini`                                                      |
+| `openrouter/~deepseek/deepseek-flash-latest`                          |
+| `openrouter/~deepseek/deepseek-pro-latest`                            |
 | `openrouter/~deepseek/deepseek-v4-flash-latest`                       |
 | `openrouter/~moonshotai/kimi-latest`                                  |
 | `openrouter/~x-ai/grok-latest`                                        |
@@ -161,7 +163,10 @@ ANTHROPIC_API_KEY=ant-...
 | `openrouter/inclusionai/ling-3.0-flash-fin`                           |
 | `openrouter/inclusionai/ling-3.0-flash-fin:free`                      |
 | `openrouter/inclusionai/ling-3.0-flash-sante:free`                    |
+| `openrouter/inclusionai/ling-3.0-flash-vl`                            |
 | `openrouter/inclusionai/ling-3.0-flash-vl:free`                       |
+| `openrouter/inference-net/schematron-v2-small`                        |
+| `openrouter/inference-net/schematron-v2-turbo`                        |
 | `openrouter/mancer/weaver`                                            |
 | `openrouter/meta-llama/llama-3.1-70b-instruct`                        |
 | `openrouter/meta-llama/llama-3.1-8b-instruct`                         |

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 359 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 367 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -42,12 +42,17 @@ ANTHROPIC_API_KEY=ant-...
 | `~anthropic/claude-haiku-latest`                           |
 | `~anthropic/claude-opus-latest`                            |
 | `~anthropic/claude-sonnet-latest`                          |
+| `~deepseek/deepseek-flash-latest`                          |
+| `~deepseek/deepseek-pro-latest`                            |
 | `~deepseek/deepseek-v4-flash-latest`                       |
 | `~google/gemini-flash-latest`                              |
 | `~google/gemini-pro-latest`                                |
 | `~moonshotai/kimi-latest`                                  |
-| `~openai/gpt-latest`                                       |
+| `~openai/gpt-astra-latest`                                 |
+| `~openai/gpt-luna-latest`                                  |
 | `~openai/gpt-mini-latest`                                  |
+| `~openai/gpt-sol-latest`                                   |
+| `~openai/gpt-terra-latest`                                 |
 | `~x-ai/grok-latest`                                        |
 | `~z-ai/glm-flash-latest`                                   |
 | `~z-ai/glm-latest`                                         |
@@ -112,7 +117,6 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-2.5-flash-lite`                             |
 | `google/gemini-2.5-pro`                                    |
 | `google/gemini-2.5-pro-preview`                            |
-| `google/gemini-2.5-pro-preview-05-06`                      |
 | `google/gemini-3-flash-preview`                            |
 | `google/gemini-3-pro-image`                                |
 | `google/gemini-3-pro-image-preview`                        |
@@ -147,7 +151,10 @@ ANTHROPIC_API_KEY=ant-...
 | `inclusionai/ling-3.0-flash-fin`                           |
 | `inclusionai/ling-3.0-flash-fin:free`                      |
 | `inclusionai/ling-3.0-flash-sante:free`                    |
+| `inclusionai/ling-3.0-flash-vl`                            |
 | `inclusionai/ling-3.0-flash-vl:free`                       |
+| `inference-net/schematron-v2-small`                        |
+| `inference-net/schematron-v2-turbo`                        |
 | `kwaipilot/kat-coder-pro-v2`                               |
 | `kwaipilot/kat-coder-pro-v2.5`                             |
 | `liquid/lfm-2.5-2.6b:free`                                 |
@@ -226,7 +233,6 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-3.5-turbo-instruct`                            |
 | `openai/gpt-4`                                             |
 | `openai/gpt-4-turbo`                                       |
-| `openai/gpt-4-turbo-preview`                               |
 | `openai/gpt-4.1`                                           |
 | `openai/gpt-4.1-mini`                                      |
 | `openai/gpt-4.1-nano`                                      |
@@ -350,7 +356,9 @@ ANTHROPIC_API_KEY=ant-...
 | `rekaai/reka-flash-3`                                      |
 | `relace/relace-apply-3`                                    |
 | `relace/relace-search`                                     |
+| `sakana/fugu-max`                                          |
 | `sakana/fugu-ultra`                                        |
+| `sakana/fugu-ultra-v2`                                     |
 | `sakana/sakana-namazu`                                     |
 | `sao10k/l3-lunaris-8b`                                     |
 | `sao10k/l3.1-euryale-70b`                                  |

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 372 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 376 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -69,7 +69,6 @@ ANTHROPIC_API_KEY=ant-...
 | `alibaba/qwen3.8-2.4t-a95b`              |
 | `alibaba/qwen3.8-27b`                    |
 | `alibaba/qwen3.8-flash`                  |
-| `alibaba/qwen3.8-flash-next`             |
 | `alibaba/qwen3.8-max`                    |
 | `alibaba/qwen3.8-max-0902`               |
 | `alibaba/wan-v2.5-t2v-preview`           |
@@ -117,6 +116,7 @@ ANTHROPIC_API_KEY=ant-...
 | `bfl/flux-pro-1.1-ultra`                 |
 | `bytedance/seed-1.6`                     |
 | `bytedance/seed-1.8`                     |
+| `bytedance/seed-2.1-turbo`               |
 | `bytedance/seedance-2.0`                 |
 | `bytedance/seedance-2.0-fast`            |
 | `bytedance/seedance-2.0-mini`            |
@@ -190,6 +190,8 @@ ANTHROPIC_API_KEY=ant-...
 | `inclusionai/ling-3.0-flash-fin-free`    |
 | `inclusionai/ling-3.0-flash-sante`       |
 | `inclusionai/ling-3.0-flash-sante-free`  |
+| `inclusionai/ling-3.0-flash-vl`          |
+| `inclusionai/ling-3.0-flash-vl-free`     |
 | `interfaze/interfaze-beta`               |
 | `klingai/kling-v2.5-turbo-i2v`           |
 | `klingai/kling-v2.5-turbo-t2v`           |
@@ -349,7 +351,9 @@ ANTHROPIC_API_KEY=ant-...
 | `recraft/recraft-v4.1-pro`               |
 | `recraft/recraft-v4.1-utility`           |
 | `recraft/recraft-v4.1-utility-pro`       |
+| `sakana/fugu-max`                        |
 | `sakana/fugu-ultra`                      |
+| `sakana/fugu-ultra-v2`                   |
 | `sakana/namazu`                          |
 | `spacexai/grok-4.1-fast-non-reasoning`   |
 | `spacexai/grok-4.1-fast-reasoning`       |

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 7147 models from 200 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7315 models from 204 providers through a single API.
 
 ## Features
 

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

@@ -4,7 +4,7 @@
 
 # ![302.AI logo](https://models.dev/logos/302ai.svg)302.AI
 
-Access 116 302.AI models through Mastra's model router. Authentication is handled automatically using the `302AI_API_KEY` environment variable.
+Access 117 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).
 
@@ -55,6 +55,7 @@ for await (const chunk of stream) {
 | `302ai/claude-sonnet-4-6`                     | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `302ai/claude-sonnet-4-6-thinking`            | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `302ai/claude-sonnet-5`                       | 1.0M    |       |           |       |       |       | $2         | $10         |
+| `302ai/deepseek-flash`                        | 1.0M    |       |           |       |       |       | $0.15      | $0.60       |
 | `302ai/deepseek-v3.2`                         | 128K    |       |           |       |       |       | $0.29      | $0.43       |
 | `302ai/deepseek-v3.2-thinking`                | 128K    |       |           |       |       |       | $0.29      | $0.43       |
 | `302ai/doubao-seed-1-6-thinking-250715`       | 256K    |       |           |       |       |       | $0.12      | $1          |

package/.docs/models/providers/above.md

@@ -38,7 +38,7 @@ for await (const chunk of stream) {
 
 | Model                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `above/deepseek-v4-flash`            | 1.0M    |       |           |       |       |       | $0.24      | $0.73       |
+| `above/deepseek-v4-flash`            | 1.0M    |       |           |       |       |       | $0.17      | $0.66       |
 | `above/deepseek-v4-flash-vision-exp` | 1.0M    |       |           |       |       |       | $0.24      | $0.73       |
 | `above/deepseek-v4-pro`              | 1.0M    |       |           |       |       |       | $0.73      | $2          |
 | `above/glm-5.2`                      | 1.0M    |       |           |       |       |       | $2         | $5          |

package/.docs/models/providers/agentrouter.md

@@ -4,7 +4,7 @@
 
 # ![AgentRouter logo](https://models.dev/logos/agentrouter.svg)AgentRouter
 
-Access 3 AgentRouter models through Mastra's model router. Authentication is handled automatically using the `AGENTROUTER_API_KEY` environment variable.
+Access 5 AgentRouter models through Mastra's model router. Authentication is handled automatically using the `AGENTROUTER_API_KEY` environment variable.
 
 Learn more in the [AgentRouter documentation](https://agentrouter.org/docs/opencode.html).
 
@@ -36,11 +36,13 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ----------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `agentrouter/claude-opus-4-8` | 1.0M    |       |           |       |       |       | —          | —           |
-| `agentrouter/claude-opus-5`   | 1.0M    |       |           |       |       |       | —          | —           |
-| `agentrouter/gpt-5.6-sol`     | 1.1M    |       |           |       |       |       | —          | —           |
+| Model                           | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `agentrouter/claude-opus-4-8`   | 1.0M    |       |           |       |       |       | —          | —           |
+| `agentrouter/claude-opus-5`     | 1.0M    |       |           |       |       |       | —          | —           |
+| `agentrouter/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | —          | —           |
+| `agentrouter/glm-5.3`           | 1.0M    |       |           |       |       |       | —          | —           |
+| `agentrouter/gpt-5.6-sol`       | 1.1M    |       |           |       |       |       | —          | —           |
 
 Model availability, capabilities, context windows, and pricing are sourced from [models.dev](https://models.dev) and may change.
 

package/.docs/models/providers/aki-io.md

@@ -40,8 +40,8 @@ for await (const chunk of stream) {
 | ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `aki-io/deepseek-v4-flash-0731-284b` | 1.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `aki-io/gemma4-26b`                  | 256K    |       |           |       |       |       | $0.10      | $0.50       |
+| `aki-io/glm5.3-754b`                 | 524K    |       |           |       |       |       | $1         | $4          |
 | `aki-io/gpt-oss-120b`                | 128K    |       |           |       |       |       | $0.15      | $0.55       |
-| `aki-io/kimi-k2.7-code-1100b`        | 262K    |       |           |       |       |       | $0.86      | $3          |
 | `aki-io/mistral4-119b`               | 262K    |       |           |       |       |       | $0.20      | $0.60       |
 | `aki-io/qwen3.6-35b`                 | 256K    |       |           |       |       |       | $0.15      | $0.50       |
 | `aki-io/qwen3.8-27b`                 | 262K    |       |           |       |       |       | $0.30      | $2          |