@mastra/mcp-docs-server 1.2.17-alpha.1 → 1.2.17-alpha.13

package/.docs/models/providers/opencode-go.md

@@ -2,7 +2,7 @@
 
 # ![OpenCode Go logo](https://models.dev/logos/opencode-go.svg)OpenCode Go
 
-Access 24 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 25 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Go documentation](https://opencode.ai/docs/zen).
 
@@ -36,10 +36,11 @@ for await (const chunk of stream) {
 
 | Model                           | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `opencode-go/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | $0.07      | $0.14       |
-| `opencode-go/deepseek-v4-pro`   | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
+| `opencode-go/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | $0.22      | $0.66       |
+| `opencode-go/deepseek-v4-pro`   | 1.0M    |       |           |       |       |       | $0.66      | $2          |
 | `opencode-go/glm-5.1`           | 203K    |       |           |       |       |       | $1         | $4          |
 | `opencode-go/glm-5.2`           | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `opencode-go/glm-5.3`           | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `opencode-go/gpt-5.6-luna`      | 1.1M    |       |           |       |       |       | $0.10      | $0.60       |
 | `opencode-go/grok-4.5`          | 500K    |       |           |       |       |       | $2         | $6          |
 | `opencode-go/hy3`               | 256K    |       |           |       |       |       | $0.14      | $0.58       |

package/.docs/models/providers/opencode.md

@@ -2,7 +2,7 @@
 
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 90 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 91 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
 
@@ -93,6 +93,7 @@ for await (const chunk of stream) {
 | `opencode/minimax-m2.5`                | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `opencode/minimax-m2.7`                | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `opencode/minimax-m3`                  | 512K    |       |           |       |       |       | $0.30      | $1          |
+| `opencode/muse-spark-1.2`              | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `opencode/nemotron-3-ultra-free`       | 1.0M    |       |           |       |       |       | —          | —           |
 | `opencode/nemotron-3.5-lightning-free` | 262K    |       |           |       |       |       | —          | —           |
 | `opencode/qwen3.5-plus`                | 262K    |       |           |       |       |       | $0.20      | $1          |

package/.docs/models/providers/perplexity-agent.md

@@ -2,7 +2,7 @@
 
 # ![Perplexity Agent logo](https://models.dev/logos/perplexity-agent.svg)Perplexity Agent
 
-Access 20 Perplexity Agent models through Mastra's model router. Authentication is handled automatically using the `PERPLEXITY_API_KEY` environment variable.
+Access 22 Perplexity Agent models through Mastra's model router. Authentication is handled automatically using the `PERPLEXITY_API_KEY` environment variable.
 
 Learn more in the [Perplexity Agent documentation](https://docs.perplexity.ai/docs/agent-api/models).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `perplexity-agent/anthropic/claude-opus-4-7`         | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `perplexity-agent/anthropic/claude-sonnet-4-5`       | 200K    |       |           |       |       |       | $3         | $15         |
 | `perplexity-agent/anthropic/claude-sonnet-4-6`       | 200K    |       |           |       |       |       | $3         | $15         |
+| `perplexity-agent/deepseek/deepseek-v4-flash-0731`   | 1.0M    |       |           |       |       |       | $0.13      | $0.26       |
 | `perplexity-agent/google/gemini-2.5-flash`           | 1.0M    |       |           |       |       |       | $0.30      | $3          |
 | `perplexity-agent/google/gemini-2.5-pro`             | 1.0M    |       |           |       |       |       | $1         | $10         |
 | `perplexity-agent/google/gemini-3-flash-preview`     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
@@ -56,6 +57,7 @@ for await (const chunk of stream) {
 | `perplexity-agent/openai/gpt-5.5`                    | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `perplexity-agent/perplexity/sonar`                  | 128K    |       |           |       |       |       | $0.25      | $3          |
 | `perplexity-agent/xai/grok-4-1-fast-non-reasoning`   | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `perplexity-agent/xai/grok-4.6`                      | 500K    |       |           |       |       |       | $2         | $6          |
 
 ## Advanced configuration
 
@@ -85,7 +87,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "perplexity-agent/xai/grok-4-1-fast-non-reasoning"
+      ? "perplexity-agent/xai/grok-4.6"
       : "perplexity-agent/anthropic/claude-haiku-4-5";
   }
 });

package/.docs/models/providers/qvac.md

@@ -0,0 +1,35 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![QVAC logo](https://models.dev/logos/qvac.svg)QVAC
+
+QVAC is available through the AI SDK. Install the provider package to use their models with Mastra.
+
+For detailed provider-specific documentation, see the [AI SDK QVAC provider docs](https://ai-sdk.dev/providers/community-providers/qvac).
+
+To use this provider with Mastra agents, see the [Agent Overview documentation](https://mastra.ai/docs/agents/overview).
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @qvac/ai-sdk-provider
+```
+
+**pnpm**:
+
+```bash
+pnpm add @qvac/ai-sdk-provider
+```
+
+**Yarn**:
+
+```bash
+yarn add @qvac/ai-sdk-provider
+```
+
+**Bun**:
+
+```bash
+bun add @qvac/ai-sdk-provider
+```

package/.docs/models/providers/requesty.md

@@ -60,12 +60,12 @@ for await (const chunk of stream) {
 | `requesty/deepseek-v4-flash-0731`    | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `requesty/deepseek-v4-flash-0731@eu` | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `requesty/gemini-2.5-flash@eu`       | 1.0M    |       |           |       |       |       | $0.30      | $3          |
-| `requesty/gemini-3.1-flash-lite@eu`  | 1.0M    |       |           |       |       |       | $0.25      | $2          |
+| `requesty/gemini-3.1-flash-lite@eu`  | 1.0M    |       |           |       |       |       | $0.28      | $2          |
 | `requesty/gemini-3.5-flash-lite`     | 1.0M    |       |           |       |       |       | $0.30      | $3          |
-| `requesty/gemini-3.5-flash@eu`       | 1.0M    |       |           |       |       |       | $2         | $9          |
+| `requesty/gemini-3.5-flash@eu`       | 1.0M    |       |           |       |       |       | $2         | $10         |
 | `requesty/gemini-3.6-flash`          | 1.0M    |       |           |       |       |       | $2         | $7          |
 | `requesty/gemini-3.7-flash`          | 1.0M    |       |           |       |       |       | $0.75      | $4          |
-| `requesty/gemini-3.7-flash@eu`       | 1.0M    |       |           |       |       |       | $0.75      | $4          |
+| `requesty/gemini-3.7-flash@eu`       | 1.0M    |       |           |       |       |       | $0.82      | $4          |
 | `requesty/glm-5.2`                   | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/glm-5.2@eu`                | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/gpt-4.1-mini@eu`           | 1.0M    |       |           |       |       |       | $0.44      | $2          |

package/.docs/models/providers/runinfra.md

@@ -0,0 +1,76 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![RunInfra logo](https://models.dev/logos/runinfra.svg)RunInfra
+
+Access 4 RunInfra models through Mastra's model router. Authentication is handled automatically using the `RUNINFRA_GATEWAY_KEY` environment variable.
+
+Learn more in the [RunInfra documentation](https://runinfra.ai/docs).
+
+```bash
+RUNINFRA_GATEWAY_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "runinfra/Inferact/Qwen3.8-2.4T-A95B-NVFP4"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [RunInfra documentation](https://runinfra.ai/docs) for details.
+
+## Models
+
+| Model                                                        | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `runinfra/deepseek-ai/DeepSeek-V4-Flash-0731`                | 1.0M    |       |           |       |       |       | $0.13      | $0.27       |
+| `runinfra/Inferact/Qwen3.8-2.4T-A95B-NVFP4`                  | 262K    |       |           |       |       |       | $2         | $6          |
+| `runinfra/nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16` | 262K    |       |           |       |       |       | $0.05      | $0.15       |
+| `runinfra/Qwen/Qwen3.8-27B`                                  | 262K    |       |           |       |       |       | $0.10      | $0.40       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.runinfra.ai/v1",
+    id: "runinfra/Inferact/Qwen3.8-2.4T-A95B-NVFP4",
+    apiKey: process.env.RUNINFRA_GATEWAY_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "runinfra/nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16"
+      : "runinfra/Inferact/Qwen3.8-2.4T-A95B-NVFP4";
+  }
+});
+```

package/.docs/models/providers/scnet-token-plan.md

@@ -0,0 +1,85 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![SCNet Token Plan logo](https://models.dev/logos/scnet-token-plan.svg)SCNet Token Plan
+
+Access 13 SCNet Token Plan models through Mastra's model router. Authentication is handled automatically using the `SCNET_API_KEY` environment variable.
+
+Learn more in the [SCNet Token Plan documentation](https://www.scnet.cn/ac/openapi/doc/2.0/moduleapi/plans/token-plan.html).
+
+```bash
+SCNET_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "scnet-token-plan/DeepSeek-V3.2"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [SCNet Token Plan documentation](https://www.scnet.cn/ac/openapi/doc/2.0/moduleapi/plans/token-plan.html) for details.
+
+## Models
+
+| Model                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `scnet-token-plan/DeepSeek-V3.2`     | 128K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/DeepSeek-V4-Flash` | 1.0M    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/GLM-5`             | 205K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/GLM-5.1`           | 200K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/GLM-5.2`           | 1.0M    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/Kimi-K2.5`         | 262K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/Kimi-K2.6`         | 262K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/Kimi-K2.7-Code`    | 262K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/Kimi-K3`           | 1.0M    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/MiMo-V2.5-Pro`     | 1.0M    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/MiniMax-M2.5`      | 205K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/MiniMax-M2.7`      | 205K    |       |           |       |       |       | —          | —           |
+| `scnet-token-plan/MiniMax-M3`        | 512K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.scnet.cn/api/llm/v1",
+    id: "scnet-token-plan/DeepSeek-V3.2",
+    apiKey: process.env.SCNET_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "scnet-token-plan/MiniMax-M3"
+      : "scnet-token-plan/DeepSeek-V3.2";
+  }
+});
+```

package/.docs/models/providers/togetherai.md

@@ -2,7 +2,7 @@
 
 # ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
 
-Access 35 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
+Access 36 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
 
 Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
 
@@ -37,6 +37,7 @@ for await (const chunk of stream) {
 | `togetherai/deepcogito/cogito-v2-1-671b`              | 164K    |       |           |       |       |       | $1         | $1          |
 | `togetherai/deepseek-ai/DeepSeek-V4-Flash-0731`       | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `togetherai/deepseek-ai/DeepSeek-V4-Pro`              | 512K    |       |           |       |       |       | $2         | $3          |
+| `togetherai/deepseek-ai/DeepSeek-V4-Pro-0813`         | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `togetherai/google/gemma-3n-E4B-it`                   | 33K     |       |           |       |       |       | $0.06      | $0.12       |
 | `togetherai/google/gemma-4-31B-it`                    | 262K    |       |           |       |       |       | $0.39      | $0.97       |
 | `togetherai/LiquidAI/LFM2-24B-A2B`                    | 33K     |       |           |       |       |       | $0.03      | $0.12       |

package/.docs/models/providers/umans-ai-coding-plan.md

@@ -2,7 +2,7 @@
 
 # ![Umans AI Coding Plan logo](https://models.dev/logos/umans-ai-coding-plan.svg)Umans AI Coding Plan
 
-Access 8 Umans AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_CODING_PLAN_API_KEY` environment variable.
+Access 9 Umans AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_CODING_PLAN_API_KEY` environment variable.
 
 Learn more in the [Umans AI Coding Plan documentation](https://app.umans.ai/offers/code/docs).
 
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
 | --------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `umans-ai-coding-plan/umans-coder`                  | 262K    |       |           |       |       |       | —          | —           |
 | `umans-ai-coding-plan/umans-deepseek-v4-flash-0731` | 1.0M    |       |           |       |       |       | —          | —           |
+| `umans-ai-coding-plan/umans-deepseek-v4-pro-0813`   | 1.0M    |       |           |       |       |       | —          | —           |
 | `umans-ai-coding-plan/umans-flash`                  | 262K    |       |           |       |       |       | —          | —           |
 | `umans-ai-coding-plan/umans-glm-5.1`                | 205K    |       |           |       |       |       | —          | —           |
 | `umans-ai-coding-plan/umans-glm-5.2`                | 406K    |       |           |       |       |       | —          | —           |

package/.docs/models/providers/umans-ai.md

@@ -2,7 +2,7 @@
 
 # ![Umans AI logo](https://models.dev/logos/umans-ai.svg)Umans AI
 
-Access 7 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.
+Access 8 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.
 
 Learn more in the [Umans AI documentation](https://app.umans.ai/offers/code/docs/orgs).
 
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
 | --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `umans-ai/umans-coder`                  | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `umans-ai/umans-deepseek-v4-flash-0731` | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `umans-ai/umans-deepseek-v4-pro-0813`   | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `umans-ai/umans-flash`                  | 262K    |       |           |       |       |       | $0.15      | $1          |
 | `umans-ai/umans-glm-5.1`                | 205K    |       |           |       |       |       | $1         | $4          |
 | `umans-ai/umans-glm-5.2`                | 406K    |       |           |       |       |       | $1         | $4          |

package/.docs/models/providers/xai.md

@@ -2,7 +2,7 @@
 
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
 
-Access 11 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
+Access 12 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
 
 Learn more in the [xAI documentation](https://docs.x.ai/docs/models).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `xai/grok-4.6`                     | 500K    |       |           |       |       |       | $2         | $6          |
 | `xai/grok-build-0.1`               | 256K    |       |           |       |       |       | $1         | $2          |
 | `xai/grok-imagine-image`           | 8K      |       |           |       |       |       | —          | —           |
+| `xai/grok-imagine-image-2.0`       | 8K      |       |           |       |       |       | —          | —           |
 | `xai/grok-imagine-image-quality`   | 8K      |       |           |       |       |       | —          | —           |
 | `xai/grok-imagine-video`           | 1K      |       |           |       |       |       | —          | —           |
 | `xai/grok-imagine-video-1.5`       | 1K      |       |           |       |       |       | —          | —           |

package/.docs/models/providers/zai-coding-plan.md

@@ -2,7 +2,7 @@
 
 # ![Z.AI Coding Plan logo](https://models.dev/logos/zai-coding-plan.svg)Z.AI Coding Plan
 
-Access 4 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 5 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Z.AI Coding Plan documentation](https://docs.z.ai/devpack/overview).
 
@@ -40,6 +40,7 @@ for await (const chunk of stream) {
 | `zai-coding-plan/glm-5-turbo`       | 200K    |       |           |       |       |       | —          | —           |
 | `zai-coding-plan/glm-5.2`           | 1.0M    |       |           |       |       |       | —          | —           |
 | `zai-coding-plan/glm-5.2-highspeed` | 1.0M    |       |           |       |       |       | —          | —           |
+| `zai-coding-plan/glm-5.3`           | 1.0M    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -69,7 +70,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zai-coding-plan/glm-5.2-highspeed"
+      ? "zai-coding-plan/glm-5.3"
       : "zai-coding-plan/glm-4.7";
   }
 });

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -2,7 +2,7 @@
 
 # ![Zhipu AI Coding Plan logo](https://models.dev/logos/zhipuai-coding-plan.svg)Zhipu AI Coding Plan
 
-Access 7 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 8 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Zhipu AI Coding Plan documentation](https://docs.bigmodel.cn/cn/coding-plan/overview).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `zhipuai-coding-plan/glm-5.1`           | 200K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-5.2`           | 1.0M    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-5.2-highspeed` | 1.0M    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5.3`           | 1.0M    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-5v-turbo`      | 200K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration

package/.docs/models/providers.md

@@ -24,6 +24,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Alibaba Token Plan](https://mastra.ai/models/providers/alibaba-token-plan)
 - [Alibaba Token Plan (China)](https://mastra.ai/models/providers/alibaba-token-plan-cn)
 - [Ambient](https://mastra.ai/models/providers/ambient)
+- [AMD](https://mastra.ai/models/providers/amd)
 - [AnyAPI](https://mastra.ai/models/providers/anyapi)
 - [Atomic Chat](https://mastra.ai/models/providers/atomic-chat)
 - [Auriko](https://mastra.ai/models/providers/auriko)
@@ -126,9 +127,11 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Regolo AI](https://mastra.ai/models/providers/regolo-ai)
 - [Requesty](https://mastra.ai/models/providers/requesty)
 - [routing.run](https://mastra.ai/models/providers/routing-run)
+- [RunInfra](https://mastra.ai/models/providers/runinfra)
 - [Sakana AI](https://mastra.ai/models/providers/sakana)
 - [Sarvam AI](https://mastra.ai/models/providers/sarvam)
 - [Scaleway](https://mastra.ai/models/providers/scaleway)
+- [SCNet Token Plan](https://mastra.ai/models/providers/scnet-token-plan)
 - [SCX.ai](https://mastra.ai/models/providers/scx)
 - [SiliconFlow](https://mastra.ai/models/providers/siliconflow)
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)

package/.docs/reference/agent-controller/agent-controller-class.md

@@ -196,6 +196,31 @@ const session = await controller.getSessionByResource('project-42', 'editor-wind
 
 Returns: `Promise<Session<TState> | undefined>`
 
+#### `onSessionCreated(listener, options?)`
+
+Subscribe to process-local notifications after `createSession()` materializes a new live session. Listener errors are isolated and don't prevent other listeners from running. Call the returned function to unsubscribe.
+
+By default listeners are fire-and-forget. Pass `{ blocking: true }` to make `createSession()` await the listener before resolving the new session, so the host can prepare session state before the caller can start a run. Blocking listeners run sequentially in registration order, before fire-and-forget listeners are notified. A blocking listener must not call `createSession()` for the same `(resourceId, scope)` pair. That call would await its own hydration and deadlock.
+
+```typescript
+const unsubscribe = controller.onSessionCreated(
+  async session => {
+    const settings = await loadSettings(session.identity.getResourceId())
+    if (settings) await session.state.set(settings)
+  },
+  { blocking: true },
+)
+
+// Default listeners stay fire-and-forget.
+controller.onSessionCreated(session => {
+  console.log(`Created ${session.identity.getResourceId()}`)
+})
+```
+
+Listeners run once per newly materialized session, not for cached sessions returned by later `createSession()` calls. They run only in the current process and aren't persisted events.
+
+Returns: `() => void`
+
 #### `onSessionDeleted(listener)`
 
 Subscribe to process-local notifications after `deleteSession()` tears down a live session. Listener errors are isolated and don't prevent other listeners from running. Call the returned function to unsubscribe.
@@ -472,5 +497,5 @@ await controller.stopIntervals()
 - [AgentController guide](https://mastra.ai/docs/harness/agent-controller)
 - [Session reference](https://mastra.ai/reference/agent-controller/session)
 - [Agents](https://mastra.ai/docs/agents/overview)
-- [Workspace](https://mastra.ai/docs/workspace/overview)
+- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
 - [Channels](https://mastra.ai/docs/capabilities/channels)

package/.docs/reference/browser/browser-viewer.md

@@ -229,4 +229,4 @@ browse skills install
 
 - [BrowserViewer guide](https://mastra.ai/integrations/browsers/browser-viewer): Setup and usage walkthrough
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class API reference
-- [Workspace overview](https://mastra.ai/docs/workspace/overview): Workspace configuration
+- [Sandbox](https://mastra.ai/docs/workspace/sandbox): Workspace configuration

package/.docs/reference/configuration.md

@@ -483,7 +483,7 @@ export const mastra = new Mastra({
 
 A Mastra workspace gives agents a persistent environment for storing files and executing commands. Agents inherit the global workspace on the `Mastra` class unless they have their own workspace configured.
 
-See the [Workspace documentation](https://mastra.ai/docs/workspace/overview) for implementation details.
+See the [Workspace documentation](https://mastra.ai/docs/workspace/sandbox) for implementation details.
 
 ```typescript
 import { Mastra } from '@mastra/core'

package/.docs/reference/core/removeWorkspace.md

@@ -24,5 +24,5 @@ When `destroy` is `true` and `workspace.destroy()` throws, the call rejects with
 
 ## Related
 
-- [Workspace overview](https://mastra.ai/docs/workspace/overview)
+- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
 - [Workspace class](https://mastra.ai/reference/workspace/workspace-class)

package/.docs/reference/datasets/addItem.md

@@ -18,6 +18,7 @@ const dataset = await mastra.datasets.get({ id: 'dataset-id' })
 const item = await dataset.addItem({
   input: { question: 'What is TypeScript?' },
   groundTruth: { answer: 'A typed superset of JavaScript' },
+  scorerIds: ['accuracy', 'relevancy'],
   metadata: { source: 'manual' },
 })
 
@@ -30,6 +31,8 @@ console.log(item.id)
 
 **groundTruth** (`unknown`): Expected output or ground truth for scoring.
 
+**scorerIds** (`string[]`): Scorer IDs that override dataset-attached scorers for this item. An empty array runs no scorers for the item. Omit this field to inherit the dataset scorer IDs.
+
 **metadata** (`Record<string, unknown>`): Arbitrary metadata for the item.
 
 ## Returns
@@ -46,6 +49,8 @@ console.log(item.id)
 
 **result.groundTruth** (`unknown`): Ground truth data.
 
+**result.scorerIds** (`string[]`): Scorer IDs selected for this item. An empty array is an explicit override that runs no scorers.
+
 **result.metadata** (`Record<string, unknown>`): Item metadata.
 
 **result.createdAt** (`Date`): When the item was created.

package/.docs/reference/datasets/addItems.md

@@ -17,8 +17,16 @@ const dataset = await mastra.datasets.get({ id: 'dataset-id' })
 
 const items = await dataset.addItems({
   items: [
-    { input: { question: 'What is AI?' }, groundTruth: { answer: 'Artificial Intelligence' } },
-    { input: { question: 'What is ML?' }, groundTruth: { answer: 'Machine Learning' } },
+    {
+      input: { question: 'What is AI?' },
+      groundTruth: { answer: 'Artificial Intelligence' },
+      scorerIds: ['accuracy'],
+    },
+    {
+      input: { question: 'What is ML?' },
+      groundTruth: { answer: 'Machine Learning' },
+      scorerIds: [],
+    },
     { input: { question: 'What is DL?' }, metadata: { category: 'deep-learning' } },
   ],
 })
@@ -34,6 +42,8 @@ console.log(`Added ${items.length} items`)
 
 **items.groundTruth** (`unknown`): Expected output or ground truth.
 
+**items.scorerIds** (`string[]`): Scorer IDs that override dataset-attached scorers for this item. An empty array runs no scorers for the item.
+
 **items.metadata** (`Record<string, unknown>`): Arbitrary metadata.
 
 ## Returns

package/.docs/reference/datasets/startExperiment.md

@@ -59,7 +59,7 @@ console.log(`Status: ${summary2.status}`)
 
 **targetId** (`string`): ID of the registered target. Use with targetType.
 
-**scorers** (`(MastraScorer | string)[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to evaluate each result. Accepts a flat array of MastraScorer instances or registered scorer IDs, or the same categorised config shape used by runEvals (AgentScorerConfig / WorkflowScorerConfig). Trajectory scorers (type: "trajectory") automatically receive a pre-extracted Trajectory as their output regardless of which form is used. For workflow targets, per-step scorers can be passed via scorers: { steps: { stepId: \[...] } } and run against each step's output; their results carry the originating stepId and keep targetScope: "span" (matching runEvals).
+**scorers** (`(MastraScorer | string)[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to evaluate each result. Accepts a flat array of MastraScorer instances or registered scorer IDs, or the same categorised config shape used by runEvals (AgentScorerConfig / WorkflowScorerConfig). When this option is provided, including as \[] or an empty categorized config, it overrides item-level and dataset-level scorer IDs for every item. When omitted, each item uses its own scorerIds when present, then falls back to the dataset scorer IDs. Sources aren't merged. Trajectory scorers (type: "trajectory") automatically receive a pre-extracted Trajectory as their output regardless of which form is used. Workflow step scorers are supported only through this run-level categorized configuration. Their results carry the originating stepId and keep targetScope: "span" (matching runEvals).
 
 **name** (`string`): Display name for the experiment.
 

package/.docs/reference/datasets/updateItem.md

@@ -19,6 +19,7 @@ const updated = await dataset.updateItem({
   itemId: 'item-id',
   input: { question: 'What is TypeScript?' },
   groundTruth: { answer: 'A typed superset of JavaScript' },
+  scorerIds: null,
   metadata: { reviewed: true },
 })
 ```
@@ -31,6 +32,8 @@ const updated = await dataset.updateItem({
 
 **groundTruth** (`unknown`): Updated ground truth.
 
+**scorerIds** (`string[] | null`): Scorer IDs that override dataset-attached scorers for this item. Use \[] to run no scorers, null to remove the override and restore dataset inheritance, or omit the field to preserve the current value.
+
 **metadata** (`Record<string, unknown>`): Updated metadata.
 
 ## Returns

package/.docs/reference/file-based-agents/workspace.md

@@ -4,9 +4,9 @@
 
 > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
 
-A [workspace](https://mastra.ai/docs/workspace/overview) gives an agent filesystem access and command execution. File-based agents get a default workspace automatically when discovered through `mastra dev` or `mastra build`, so they can read and write files and run shell commands without extra configuration.
+A [workspace](https://mastra.ai/docs/workspace/sandbox) assembles capabilities such as filesystem access and command execution. The configured backends determine which tools are available. File-based agents get a default workspace automatically when discovered through `mastra dev` or `mastra build`. This default includes filesystem access and command execution, so agents can read and write files and run shell commands without extra configuration.
 
-Use this page for the file-based convention. For workspace providers, tools, search, lifecycle, and sandbox details, see [Workspaces](https://mastra.ai/docs/workspace/overview).
+Use this page for the file-based convention. For workspace providers, tools, search, lifecycle, and sandbox details, see [Sandbox](https://mastra.ai/docs/workspace/sandbox).
 
 ## Default workspace
 
@@ -65,7 +65,7 @@ Customize the workspace when the default local directory isn't enough. Common re
 - Add workspace search with BM25 or vector search.
 - Share one workspace across multiple agents.
 
-For provider patterns and runtime behavior, see the [workspace overview](https://mastra.ai/docs/workspace/overview), [sandbox guide](https://mastra.ai/docs/workspace/sandbox), and [workspace search](https://mastra.ai/docs/workspace/search).
+For provider patterns and runtime behavior, see the [sandbox guide](https://mastra.ai/docs/workspace/sandbox) and [workspace search](https://mastra.ai/docs/workspace/search).
 
 ## Runtime boundary
 

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

@@ -57,6 +57,8 @@ OM performs thresholding with fast local token estimation. Text uses `tokenx`, a
 
 **observation.instruction** (`string`): Custom instruction appended to the Observer's system prompt. Use this to customize what the Observer focuses on, such as domain-specific preferences or priorities.
 
+**observation.continuationHints** (`boolean | { currentTask?: boolean; suggestedResponse?: boolean }`): Which continuation-hint sections the Observer emits. Pass false to disable both, or an object to disable them individually. Agents that drive their own control flow generally want { suggestedResponse: false } so memory does not compete for what the agent says next. A previously stored hint stops being injected into context once both observation and reflection disable its section.
+
 **observation.threadTitle** (`boolean`): When true, the Observer suggests short thread titles and updates the thread title when the conversation topic meaningfully changes. This is opt-in and defaults to disabled.
 
 **observation.extract** (`Extractor[]`): Custom values to extract after observation. Schema-less extractors are requested inline in the Observer output. Schema-backed extractors run as a follow-up structured output call and are stored in thread OM metadata.
@@ -97,6 +99,8 @@ OM performs thresholding with fast local token estimation. Text uses `tokenx`, a
 
 **reflection.instruction** (`string`): Custom instruction appended to the Reflector's system prompt. Use this to customize how the Reflector consolidates observations, such as prioritizing certain types of information.
 
+**reflection.continuationHints** (`boolean | { currentTask?: boolean; suggestedResponse?: boolean }`): Which continuation-hint sections the Reflector emits. Pass false to disable both, or an object to disable them individually. A previously stored hint stops being injected into context once both observation and reflection disable its section.
+
 **reflection.extract** (`Extractor[]`): Custom values to extract after reflection. Schema-less extractors are requested inline in the Reflector output. Schema-backed extractors run as a follow-up structured output call and are stored in thread OM metadata.
 
 **reflection.observationTokens** (`number`): Token count of observations that triggers reflection. When observation tokens exceed this threshold, the Reflector agent is called to condense them.

package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md

@@ -189,6 +189,8 @@ When an organization has exhausted its observability quota, the Mastra platform
 
 The probe timer doesn't keep the Node.js process alive, so short-lived and serverless processes exit normally while paused.
 
+Every request the exporter sends (batch uploads for all five signal types, plus the traces recovery probe) includes the `x-mastra-observability-capabilities: quota-pause-v1` header. This tells the platform that the client understands the quota-pause contract, so it can safely respond with `402` instead of silently dropping telemetry for older clients that would retry it.
+
 ### Endpoint routing
 
 - Base origins derive signal endpoints automatically