@mastra/mcp-docs-server 1.2.14 → 1.2.15-alpha.10

package/.docs/models/providers/openai.md

@@ -11,22 +11,22 @@ OPENAI_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from '@mastra/core/agent'
+import { Agent } from "@mastra/core/agent";
 
 const agent = new Agent({
-  id: 'my-agent',
-  name: 'My Agent',
-  instructions: 'You are a helpful assistant',
-  model: 'openai/chatgpt-image-latest',
-})
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "openai/chatgpt-image-latest"
+});
 
 // Generate a response
-const response = await agent.generate('Hello!')
+const response = await agent.generate("Hello!");
 
 // Stream a response
-const stream = await agent.stream('Tell me a story')
+const stream = await agent.stream("Tell me a story");
 for await (const chunk of stream) {
-  console.log(chunk)
+  console.log(chunk);
 }
 ```
 
@@ -78,29 +78,31 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: 'custom-agent',
-  name: 'custom-agent',
+  id: "custom-agent",
+  name: "custom-agent",
   model: {
-    id: 'openai/chatgpt-image-latest',
+    id: "openai/chatgpt-image-latest",
     apiKey: process.env.OPENAI_API_KEY,
     headers: {
-      'X-Custom-Header': 'value',
-    },
-  },
-})
+      "X-Custom-Header": "value"
+    }
+  }
+});
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: 'dynamic-agent',
-  name: 'Dynamic Agent',
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === 'complex'
-    return useAdvanced ? 'openai/text-embedding-ada-002' : 'openai/chatgpt-image-latest'
-  },
-})
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "openai/text-embedding-ada-002"
+      : "openai/chatgpt-image-latest";
+  }
+});
 ```
 
 ## Provider Options
@@ -108,13 +110,13 @@ const agent = new Agent({
 OpenAI supports the following provider-specific options via the `providerOptions` parameter:
 
 ```typescript
-const response = await agent.generate('Hello!', {
+const response = await agent.generate("Hello!", {
   providerOptions: {
     openai: {
       // See available options in the table below
-    },
-  },
-})
+    }
+  }
+});
 ```
 
 ### Available Options

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

@@ -36,7 +36,7 @@ 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.14      | $0.28       |
+| `opencode-go/deepseek-v4-flash` | 1.0M    |       |           |       |       |       | $0.07      | $0.14       |
 | `opencode-go/deepseek-v4-pro`   | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `opencode-go/glm-5.1`           | 203K    |       |           |       |       |       | $1         | $4          |
 | `opencode-go/glm-5.2`           | 1.0M    |       |           |       |       |       | $1         | $4          |

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

@@ -2,7 +2,7 @@
 
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 86 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 87 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).
 
@@ -39,7 +39,6 @@ for await (const chunk of stream) {
 | `opencode/big-pickle`             | 200K    |       |           |       |       |       | —          | —           |
 | `opencode/claude-fable-5`         | 1.0M    |       |           |       |       |       | $10        | $50         |
 | `opencode/claude-haiku-4-5`       | 200K    |       |           |       |       |       | $1         | $5          |
-| `opencode/claude-opus-4-1`        | 200K    |       |           |       |       |       | $15        | $75         |
 | `opencode/claude-opus-4-5`        | 200K    |       |           |       |       |       | $5         | $25         |
 | `opencode/claude-opus-4-6`        | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `opencode/claude-opus-4-7`        | 1.0M    |       |           |       |       |       | $5         | $25         |
@@ -87,7 +86,7 @@ for await (const chunk of stream) {
 | `opencode/kimi-k2.7-code`         | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `opencode/kimi-k3`                | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `opencode/laguna-s-2.1-free`      | 256K    |       |           |       |       |       | —          | —           |
-| `opencode/ling-3.0-flash-free`    | 262K    |       |           |       |       |       | —          | —           |
+| `opencode/ling-3.0-tiny-free`     | 262K    |       |           |       |       |       | —          | —           |
 | `opencode/longcat-2.0-free`       | 1.0M    |       |           |       |       |       | —          | —           |
 | `opencode/mimo-v2.5-free`         | 200K    |       |           |       |       |       | —          | —           |
 | `opencode/minimax-m2.5`           | 205K    |       |           |       |       |       | $0.30      | $1          |

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

@@ -11,22 +11,22 @@ PERPLEXITY_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from '@mastra/core/agent'
+import { Agent } from "@mastra/core/agent";
 
 const agent = new Agent({
-  id: 'my-agent',
-  name: 'My Agent',
-  instructions: 'You are a helpful assistant',
-  model: 'perplexity-agent/anthropic/claude-haiku-4-5',
-})
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "perplexity-agent/anthropic/claude-haiku-4-5"
+});
 
 // Generate a response
-const response = await agent.generate('Hello!')
+const response = await agent.generate("Hello!");
 
 // Stream a response
-const stream = await agent.stream('Tell me a story')
+const stream = await agent.stream("Tell me a story");
 for await (const chunk of stream) {
-  console.log(chunk)
+  console.log(chunk);
 }
 ```
 
@@ -63,32 +63,32 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: 'custom-agent',
-  name: 'custom-agent',
+  id: "custom-agent",
+  name: "custom-agent",
   model: {
-    url: 'https://api.perplexity.ai/v1',
-    id: 'perplexity-agent/anthropic/claude-haiku-4-5',
+    url: "https://api.perplexity.ai/v1",
+    id: "perplexity-agent/anthropic/claude-haiku-4-5",
     apiKey: process.env.PERPLEXITY_API_KEY,
     headers: {
-      'X-Custom-Header': 'value',
-    },
-  },
-})
+      "X-Custom-Header": "value"
+    }
+  }
+});
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: 'dynamic-agent',
-  name: 'Dynamic Agent',
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === 'complex'
+    const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? 'perplexity-agent/xai/grok-4-1-fast-non-reasoning'
-      : 'perplexity-agent/anthropic/claude-haiku-4-5'
-  },
-})
+      ? "perplexity-agent/xai/grok-4-1-fast-non-reasoning"
+      : "perplexity-agent/anthropic/claude-haiku-4-5";
+  }
+});
 ```
 
 ## Direct provider installation

package/.docs/models/providers/pioneer.md

@@ -2,7 +2,7 @@
 
 # ![Pioneer logo](https://models.dev/logos/pioneer.svg)Pioneer
 
-Access 76 Pioneer models through Mastra's model router. Authentication is handled automatically using the `PIONEER_API_KEY` environment variable.
+Access 102 Pioneer models through Mastra's model router. Authentication is handled automatically using the `PIONEER_API_KEY` environment variable.
 
 Learn more in the [Pioneer documentation](https://agent.pioneer.ai/llms.txt).
 
@@ -36,16 +36,23 @@ for await (const chunk of stream) {
 
 | Model                                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `pioneer/claude-3-7-sonnet-latest`                      | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `pioneer/claude-fable-5`                                | 1.0M    |       |           |       |       |       | $11        | $55         |
 | `pioneer/claude-haiku-4-5`                              | 200K    |       |           |       |       |       | $1         | $5          |
 | `pioneer/claude-opus-4-1`                               | 200K    |       |           |       |       |       | $15        | $75         |
 | `pioneer/claude-opus-4-5`                               | 200K    |       |           |       |       |       | $5         | $25         |
 | `pioneer/claude-opus-4-6`                               | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `pioneer/claude-opus-4-7`                               | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `pioneer/claude-opus-4-8`                               | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `pioneer/claude-opus-5`                                 | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `pioneer/claude-sonnet-4-5`                             | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `pioneer/claude-sonnet-4-6`                             | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `pioneer/claude-sonnet-5`                               | 1.0M    |       |           |       |       |       | $2         | $10         |
+| `pioneer/deepseek-ai/DeepSeek-V3`                       | 164K    |       |           |       |       |       | $0.27      | $1          |
+| `pioneer/deepseek-ai/DeepSeek-V3.1`                     | 164K    |       |           |       |       |       | $0.56      | $2          |
 | `pioneer/deepseek-ai/DeepSeek-V4-Flash`                 | 1.0M    |       |           |       |       |       | $0.10      | $0.20       |
 | `pioneer/deepseek-ai/DeepSeek-V4-Pro`                   | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
+| `pioneer/devstral-2`                                    | 256K    |       |           |       |       |       | $0.40      | $2          |
 | `pioneer/fastino/gliguard-LLMGuardrails-300M`           | 8K      |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/fastino/gliner2-base-v1`                       | 8K      |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/fastino/gliner2-large-v1`                      | 8K      |       |           |       |       |       | $0.15      | $0.15       |
@@ -53,8 +60,11 @@ for await (const chunk of stream) {
 | `pioneer/fastino/gliner2-multi-v1`                      | 8K      |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/fastino/gliner2-privacy-filter-PII-multi`      | 8K      |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/gemini-3-flash`                                | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `pioneer/gemini-3.1-flash-lite`                         | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `pioneer/gemini-3.1-pro`                                | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `pioneer/gemini-3.5-flash`                              | 1.0M    |       |           |       |       |       | $2         | $9          |
+| `pioneer/gemini-3.5-flash-lite`                         | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `pioneer/gemini-3.6-flash`                              | 1.0M    |       |           |       |       |       | $2         | $8          |
 | `pioneer/google/diffusiongemma-26B-A4B-it`              | 262K    |       |           |       |       |       | $0.50      | $0.50       |
 | `pioneer/google/gemma-3-4b-pt`                          | 33K     |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/google/gemma-4-12B-it`                         | 33K     |       |           |       |       |       | $0.25      | $0.25       |
@@ -74,27 +84,43 @@ for await (const chunk of stream) {
 | `pioneer/gpt-5.4-mini`                                  | 400K    |       |           |       |       |       | $0.75      | $5          |
 | `pioneer/gpt-5.4-nano`                                  | 1.0M    |       |           |       |       |       | $0.20      | $1          |
 | `pioneer/gpt-5.5`                                       | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `pioneer/gpt-5.6-luna`                                  | 1.1M    |       |           |       |       |       | $1         | $6          |
+| `pioneer/gpt-5.6-sol`                                   | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `pioneer/gpt-5.6-terra`                                 | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `pioneer/grok-4.5`                                      | 500K    |       |           |       |       |       | $2         | $6          |
 | `pioneer/HuggingFaceTB/SmolLM3-3B-Base`                 | 33K     |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/LiquidAI/LFM2-24B-A2B`                         | 33K     |       |           |       |       |       | $0.03      | $0.12       |
 | `pioneer/meta-llama/Llama-3.1-8B-Instruct`              | 131K    |       |           |       |       |       | $0.20      | $0.20       |
+| `pioneer/meta-llama/Llama-3.2-1B`                       | 131K    |       |           |       |       |       | $0.10      | $0.10       |
 | `pioneer/meta-llama/Llama-3.2-1B-Instruct`              | 131K    |       |           |       |       |       | $0.10      | $0.20       |
+| `pioneer/meta-llama/Llama-3.2-3B`                       | 131K    |       |           |       |       |       | $0.10      | $0.10       |
 | `pioneer/meta-llama/Llama-3.2-3B-Instruct`              | 131K    |       |           |       |       |       | $0.10      | $0.34       |
 | `pioneer/meta-llama/Llama-3.3-70B-Instruct`             | 131K    |       |           |       |       |       | $0.90      | $0.90       |
+| `pioneer/meta/muse-spark-1.1`                           | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `pioneer/MiniMaxAI/MiniMax-M2.7`                        | 205K    |       |           |       |       |       | $0.28      | $1          |
 | `pioneer/MiniMaxAI/MiniMax-M3`                          | 1.0M    |       |           |       |       |       | $0.30      | $1          |
+| `pioneer/mistral-large-3`                               | 256K    |       |           |       |       |       | $0.50      | $2          |
 | `pioneer/mistral-medium-3.5`                            | 262K    |       |           |       |       |       | $2         | $8          |
+| `pioneer/mistralai/Codestral-22B-v0.1`                  | 128K    |       |           |       |       |       | $0.30      | $0.90       |
+| `pioneer/mistralai/Magistral-Small-2506`                | 128K    |       |           |       |       |       | $0.50      | $2          |
+| `pioneer/mistralai/Ministral-8B-Instruct-2410`          | 128K    |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/mistralai/Mistral-7B-Instruct-v0.3`            | 33K     |       |           |       |       |       | $0.20      | $0.20       |
 | `pioneer/mistralai/Mistral-Nemo-Instruct-2407`          | 131K    |       |           |       |       |       | $0.02      | $0.03       |
 | `pioneer/mistralai/Mistral-Small-4-119B-2603`           | 262K    |       |           |       |       |       | $0.15      | $0.60       |
+| `pioneer/mistralai/Pixtral-12B-2409`                    | 128K    |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/moonshotai/Kimi-K2.6`                          | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `pioneer/moonshotai/Kimi-K2.7-Code`                     | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `pioneer/moonshotai/Kimi-K3`                            | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `pioneer/nvidia/NVIDIA-Nemotron-3-Nano-30B-A3B-BF16`    | 262K    |       |           |       |       |       | $0.05      | $0.20       |
 | `pioneer/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8`  | 1.0M    |       |           |       |       |       | $0.09      | $0.45       |
 | `pioneer/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16` | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `pioneer/openai/gpt-oss-120b`                           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `pioneer/openai/gpt-oss-20b`                            | 131K    |       |           |       |       |       | $0.07      | $0.30       |
 | `pioneer/pioneer/auto`                                  | 1.0M    |       |           |       |       |       | —          | —           |
+| `pioneer/poolside/laguna-s-2.1`                         | 1.0M    |       |           |       |       |       | $0.10      | $0.20       |
+| `pioneer/Qwen/Qwen2.5-Coder-0.5B`                       | 33K     |       |           |       |       |       | $0.10      | $0.10       |
 | `pioneer/Qwen/Qwen3-1.7B-Base`                          | 33K     |       |           |       |       |       | $0.10      | $0.10       |
+| `pioneer/Qwen/Qwen3-235B-A22B-Instruct-2507`            | 262K    |       |           |       |       |       | $1         | $1          |
 | `pioneer/Qwen/Qwen3-32B`                                | 131K    |       |           |       |       |       | $0.90      | $0.90       |
 | `pioneer/Qwen/Qwen3-4B-Base`                            | 33K     |       |           |       |       |       | $0.15      | $0.15       |
 | `pioneer/Qwen/Qwen3-4B-Instruct-2507`                   | 262K    |       |           |       |       |       | $0.20      | $0.20       |

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

@@ -2,7 +2,7 @@
 
 # ![Regolo AI logo](https://models.dev/logos/regolo-ai.svg)Regolo AI
 
-Access 13 Regolo AI models through Mastra's model router. Authentication is handled automatically using the `REGOLO_API_KEY` environment variable.
+Access 18 Regolo AI models through Mastra's model router. Authentication is handled automatically using the `REGOLO_API_KEY` environment variable.
 
 Learn more in the [Regolo AI documentation](https://docs.regolo.ai/).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "regolo-ai/gpt-oss-120b"
+  model: "regolo-ai/apertus-70b"
 });
 
 // Generate a response
@@ -34,21 +34,26 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                              | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `regolo-ai/gpt-oss-120b`           | 128K    |       |           |       |       |       | $1         | $4          |
-| `regolo-ai/gpt-oss-20b`            | 128K    |       |           |       |       |       | $0.40      | $2          |
-| `regolo-ai/llama-3.1-8b-instruct`  | 120K    |       |           |       |       |       | $0.05      | $0.25       |
-| `regolo-ai/llama-3.3-70b-instruct` | 128K    |       |           |       |       |       | $0.60      | $3          |
-| `regolo-ai/minimax-m2.5`           | 190K    |       |           |       |       |       | $0.80      | $4          |
-| `regolo-ai/mistral-small-4-119b`   | 256K    |       |           |       |       |       | $0.75      | $3          |
-| `regolo-ai/mistral-small3.2`       | 120K    |       |           |       |       |       | $0.50      | $2          |
-| `regolo-ai/qwen-image`             | 8K      |       |           |       |       |       | $0.50      | $2          |
-| `regolo-ai/qwen3-coder-next`       | 262K    |       |           |       |       |       | $0.30      | $1          |
-| `regolo-ai/qwen3-embedding-8b`     | 33K     |       |           |       |       |       | $0.10      | $0.10       |
-| `regolo-ai/qwen3-reranker-4b`      | 33K     |       |           |       |       |       | $0.12      | $0.12       |
-| `regolo-ai/qwen3.5-122b`           | 262K    |       |           |       |       |       | $0.90      | $4          |
-| `regolo-ai/qwen3.5-9b`             | 262K    |       |           |       |       |       | $0.15      | $0.60       |
+| Model                               | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `regolo-ai/apertus-70b`             | 30K     |       |           |       |       |       | $0.46      | $2          |
+| `regolo-ai/brick-complexity-pro`    | 100K    |       |           |       |       |       | $0.12      | $0.46       |
+| `regolo-ai/brick-v1-beta`           | 100K    |       |           |       |       |       | —          | —           |
+| `regolo-ai/deepseek-ocr-2`          | 4K      |       |           |       |       |       | —          | —           |
+| `regolo-ai/faster-whisper-large-v3` | 448     |       |           |       |       |       | —          | —           |
+| `regolo-ai/gemma4-31b`              | 100K    |       |           |       |       |       | $0.46      | $2          |
+| `regolo-ai/glm5.2`                  | 96K     |       |           |       |       |       | $2         | $6          |
+| `regolo-ai/gpt-oss-120b`            | 128K    |       |           |       |       |       | $1         | $4          |
+| `regolo-ai/gpt-oss-20b`             | 128K    |       |           |       |       |       | $0.40      | $2          |
+| `regolo-ai/llama-3.3-70b-instruct`  | 128K    |       |           |       |       |       | $0.60      | $3          |
+| `regolo-ai/mistral-small-4-119b`    | 256K    |       |           |       |       |       | $0.75      | $3          |
+| `regolo-ai/qwen-image`              | 8K      |       |           |       |       |       | $0.50      | $2          |
+| `regolo-ai/qwen3-coder-next`        | 262K    |       |           |       |       |       | $0.30      | $1          |
+| `regolo-ai/qwen3-embedding-8b`      | 33K     |       |           |       |       |       | $0.10      | $0.10       |
+| `regolo-ai/qwen3-reranker-4b`       | 33K     |       |           |       |       |       | $0.12      | $0.12       |
+| `regolo-ai/qwen3.5-122b`            | 262K    |       |           |       |       |       | $0.90      | $4          |
+| `regolo-ai/qwen3.5-9b`              | 262K    |       |           |       |       |       | $0.15      | $0.60       |
+| `regolo-ai/qwen3.6-27b`             | 120K    |       |           |       |       |       | $0.58      | $2          |
 
 ## Advanced configuration
 
@@ -60,7 +65,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.regolo.ai/v1",
-    id: "regolo-ai/gpt-oss-120b",
+    id: "regolo-ai/apertus-70b",
     apiKey: process.env.REGOLO_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -78,8 +83,8 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "regolo-ai/qwen3.5-9b"
-      : "regolo-ai/gpt-oss-120b";
+      ? "regolo-ai/qwen3.6-27b"
+      : "regolo-ai/apertus-70b";
   }
 });
 ```

package/.docs/models/providers/upstage.md

@@ -2,7 +2,7 @@
 
 # ![Upstage logo](https://models.dev/logos/upstage.svg)Upstage
 
-Access 3 Upstage models through Mastra's model router. Authentication is handled automatically using the `UPSTAGE_API_KEY` environment variable.
+Access 4 Upstage models through Mastra's model router. Authentication is handled automatically using the `UPSTAGE_API_KEY` environment variable.
 
 Learn more in the [Upstage documentation](https://developers.upstage.ai).
 
@@ -39,6 +39,7 @@ for await (const chunk of stream) {
 | `upstage/solar-mini` | 33K     |       |           |       |       |       | $0.15      | $0.15       |
 | `upstage/solar-pro2` | 66K     |       |           |       |       |       | $0.25      | $0.25       |
 | `upstage/solar-pro3` | 131K    |       |           |       |       |       | $0.25      | $0.25       |
+| `upstage/solar-pro4` | 524K    |       |           |       |       |       | $0.30      | $1          |
 
 ## Advanced configuration
 
@@ -68,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "upstage/solar-pro3"
+      ? "upstage/solar-pro4"
       : "upstage/solar-mini";
   }
 });

package/.docs/models/providers/vivgrid.md

@@ -2,7 +2,7 @@
 
 # ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
 
-Access 17 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
+Access 19 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
 
 Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
 
@@ -37,6 +37,7 @@ for await (const chunk of stream) {
 | Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `vivgrid/deepseek-v3.2`                 | 128K    |       |           |       |       |       | $0.28      | $0.42       |
+| `vivgrid/deepseek-v4-flash`             | 1.0M    |       |           |       |       |       | $0.15      | $0.30       |
 | `vivgrid/deepseek-v4-pro`               | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
 | `vivgrid/gemini-3.1-flash-lite-preview` | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
@@ -53,6 +54,7 @@ for await (const chunk of stream) {
 | `vivgrid/gpt-5.6-luna`                  | 1.1M    |       |           |       |       |       | $1         | $6          |
 | `vivgrid/gpt-5.6-sol`                   | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `vivgrid/gpt-5.6-terra`                 | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `vivgrid/kimi-k3`                       | 1.0M    |       |           |       |       |       | $3         | $15         |
 
 ## Advanced configuration
 
@@ -82,7 +84,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "vivgrid/gpt-5.6-terra"
+      ? "vivgrid/kimi-k3"
       : "vivgrid/deepseek-v3.2";
   }
 });

package/.docs/models/providers/wandb.md

@@ -39,7 +39,7 @@ for await (const chunk of stream) {
 | `wandb/deepseek-ai/DeepSeek-V3.1`                    | 161K    |       |           |       |       |       | $0.55      | $2          |
 | `wandb/deepseek-ai/DeepSeek-V4-Flash`                | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
 | `wandb/deepseek-ai/DeepSeek-V4-Flash-0731`           | 262K    |       |           |       |       |       | $0.13      | $0.28       |
-| `wandb/deepseek-ai/DeepSeek-V4-Pro`                  | 1.0M    |       |           |       |       |       | $2         | $3          |
+| `wandb/deepseek-ai/DeepSeek-V4-Pro`                  | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `wandb/google/gemma-4-31B-it`                        | 262K    |       |           |       |       |       | $0.10      | $0.34       |
 | `wandb/ibm-granite/granite-4.1-8b`                   | 131K    |       |           |       |       |       | $0.05      | $0.10       |
 | `wandb/JetBrains/Mellum2-12B-A2.5B-Instruct`         | 131K    |       |           |       |       |       | $0.05      | $0.10       |

package/.docs/reference/agents/channels.md

@@ -102,7 +102,9 @@ const agent = new Agent({
 
 **streaming** (`boolean | { updateIntervalMs?: number }`): Stream agent text deltas to the channel as the agent generates them instead of buffering and posting once per step. Requires the underlying adapter to support post-and-edit streaming. Slack defaults to true; other adapters default to false. (Default: `false (true for Slack)`)
 
-**toolDisplay** (`'cards' | 'text' | 'timeline' | 'grouped' | 'hidden' | ToolDisplayFn`): How tool calls are rendered in the channel. "cards" posts per-tool running/result cards as rich Block Kit. "text" posts the same lifecycle as plain text (no Block Kit). "timeline" and "grouped" stream tool state as inline task\_update chunks (requires streaming: true; Slack only today — other adapters may render a placeholder). "hidden" executes tools silently. Pass a function to render tool events yourself; return { kind: "post", message } for a discrete post/edit, { kind: "stream", chunk } to push into the active streaming widget, or undefined to skip rendering that event. Approve/deny prompts always render as a separate card regardless of mode. (Default: `'cards' ('grouped' for Slack)`)
+**textFormat** (`'markdown' | 'plain'`): Dialect for the agent's final reply text. 'markdown' (the default) posts replies as markdown: adapters with native markdown rendering (Slack) render it directly, others convert it to their platform format. 'plain' posts replies as literal plain text, restoring the pre-markdown behavior for agents prompted to emit a platform dialect such as Slack mrkdwn. Applies to final reply text only; tool cards, error messages, and tripwire notices are unaffected. Native streaming is always markdown regardless of this setting. (Default: `'markdown'`)
+
+**toolDisplay** (`'cards' | 'text' | 'timeline' | 'grouped' | 'hidden' | ToolDisplayFn`): How tool calls are rendered in the channel. "cards" posts per-tool running/result cards as rich Block Kit. "text" posts the same lifecycle as plain text (no Block Kit). "timeline" and "grouped" stream tool state as inline task\_update chunks (requires streaming: true; Slack only today — other adapters may render a placeholder). "hidden" executes tools silently. Pass a function to render tool events yourself; return { kind: "post", message } for a discrete post/edit, { kind: "stream", chunk } to push into the streaming widget, or undefined to skip rendering that event. Add openIfEmpty: false to a stream result when its chunk should only apply to an active streaming session. Approve/deny prompts always render as a separate card regardless of mode. (Default: `'cards' ('grouped' for Slack)`)
 
 **typingStatus** (`boolean | ((chunk: AgentChunkType, ctx: TypingStatusContext) => string | false | null | undefined | void)`): Control the platform typing indicator. true uses built-in defaults (is typing… on text, is calling {tool}… on tool-call, is waiting for approval… on tool-call-approval). false suppresses typing entirely — useful when a live streaming widget (e.g. toolDisplay: "grouped" in Slack) already conveys progress. Pass a function to set custom status copy per chunk; return a string to set the status, or false/null/undefined to leave it unchanged. Compose with defaultTypingStatus (exported from @mastra/core/channels) to fall back to defaults for chunks you don't handle. (Default: `true`)
 
@@ -116,6 +118,25 @@ const agent = new Agent({
 
 Pass a function to `toolDisplay` for fully custom rendering. The function receives a `ToolDisplayEvent` (`running` / `result` / `error` / `approval`) and a `ToolDisplayContext` (`{ mode, platform }`); return `{ kind: 'post', message }` for a discrete post/edit, `{ kind: 'stream', chunk }` to push into the active streaming widget, or `undefined` to skip rendering that event.
 
+By default, a stream result opens a streaming session when none is active. Set `openIfEmpty: false` when the chunk only applies to an existing session. Mastra skips the chunk when no session is active. Static channels ignore this option and keep their existing plain-text fallback behavior.
+
+```typescript
+toolDisplay: event => {
+  if (event.kind !== 'running') return undefined
+
+  return {
+    kind: 'stream',
+    chunk: {
+      type: 'task_update',
+      id: event.toolCallId,
+      title: event.displayName,
+      status: 'in_progress',
+    },
+    openIfEmpty: false,
+  }
+}
+```
+
 Approve/deny prompts (`requireApproval`) always render as a separate card regardless of mode, because inline task entries can't carry interactive buttons.
 
 ```typescript

package/.docs/reference/agents/generate.md

@@ -56,7 +56,7 @@ const result = await agent.generate('message for agent')
 
 **options.delegation** (`DelegationConfig`): Configuration for subagent delegation. Use this to control and monitor when the agent delegates tasks to other agents, including the ability to modify, reject delegations, and provide feedback to guide the supervisor.
 
-**options.delegation.onDelegationStart** (`(context: DelegationStartContext) => DelegationStartResult | void | Promise<DelegationStartResult | void>`): Called before delegating to a subagent. Use this to modify the delegation parameters or reject the delegation entirely.
+**options.delegation.onDelegationStart** (`(context: DelegationStartContext) => DelegationStartResult | void | Promise<DelegationStartResult | void>`): Called before delegating to a subagent. Use this to modify the delegation parameters, reject the delegation entirely, or mutate context.requestContext to add entries to the subagent run's request context.
 
 **options.delegation.onDelegationComplete** (`(context: DelegationCompleteContext) => { feedback?: string } | void | Promise<{ feedback?: string } | void>`): Called after a subagent delegation completes. The context includes a bail() method to stop further execution, and you can return { feedback } to guide the supervisor's next action. Feedback is saved to supervisor memory as an assistant message.
 

package/.docs/reference/ai-sdk/chat-route.md

@@ -69,6 +69,8 @@ export const mastra = new Mastra({
 
 **sendSources** (`boolean`): Whether to include source citations in the stream. (Default: `false`)
 
+**heartbeatMs** (`number`): Interval in milliseconds for SSE heartbeats that keep connections active through infrastructure with idle timeouts.
+
 ## Additional configuration
 
 You can use [`prepareSendMessagesRequest`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#transport.default-chat-transport.prepare-send-messages-request) to customize the request sent to the chat route, for example to pass additional configuration to the agent:

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

@@ -32,7 +32,7 @@ then interact with elements using their refs (e.g., @e5).`,
 
 **headless** (`boolean`): Whether to run the browser in headless mode (no visible UI). (Default: `true`)
 
-**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. (Default: `{ width: 1280, height: 720 }`)
+**viewport** (`{ width: number; height: number } | 'window'`): Browser viewport dimensions, or 'window' to match the real browser window instead of a fixed size. (Default: `{ width: 1280, height: 720 }`)
 
 **timeout** (`number`): Default timeout in milliseconds for browser operations. (Default: `30000`)
 

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

@@ -35,7 +35,7 @@ export const browserAgent = new Agent({
 
 **headless** (`boolean`): Whether to run the browser in headless mode (no visible UI). (Default: `true`)
 
-**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. Controls the size of the browser window. (Default: `{ width: 1280, height: 720 }`)
+**viewport** (`{ width: number; height: number } | 'window'`): Browser viewport dimensions. Controls the size of the browser window. Set to 'window' to match the real browser window instead of a fixed size, supported by the agent-browser provider and by Stagehand when connecting over CDP. (Default: `{ width: 1280, height: 720 }`)
 
 **timeout** (`number`): Default timeout in milliseconds. Each provider defines its own semantics and default. See the provider reference for details.
 

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

@@ -33,7 +33,7 @@ Use stagehand_extract to get data from pages.`,
 
 **headless** (`boolean`): Whether to run the browser in headless mode. (Default: `true`)
 
-**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. (Default: `{ width: 1280, height: 720 }`)
+**viewport** (`{ width: number; height: number } | 'window'`): Browser viewport dimensions. 'window' matches the real browser window and only applies when connecting over CDP; a locally launched browser falls back to the default size. (Default: `{ width: 1280, height: 720 }`)
 
 **env** (`'LOCAL' | 'BROWSERBASE'`): Environment to run the browser in. Use 'BROWSERBASE' for cloud execution. (Default: `'LOCAL'`)
 

package/.docs/reference/channels/slack-provider.md

@@ -53,6 +53,8 @@ await slack.configure({
 
 **streaming** (`StreamingConfig | false`): Stream agent text deltas to Slack as they're generated. Pass { updateIntervalMs } to customize the post-and-edit interval, or false to buffer text until step-finish. Disabling streaming restricts toolDisplay to static modes. (Default: `true`)
 
+**textFormat** (`'markdown' | 'plain'`): Dialect for the agent's final reply text, forwarded to the Slack adapter. 'markdown' (the default) posts replies as markdown so Slack renders bold text, links, and tables natively. 'plain' posts literal plain text, the escape hatch for agents prompted to emit Slack mrkdwn. Applies to buffered replies (streaming: false) and the streaming fallback; native streaming is always markdown. (Default: `'markdown'`)
+
 **toolDisplay** (`ToolDisplay`): How tool calls are rendered in Slack: 'cards', 'text', 'timeline', 'grouped', 'hidden', or a function. 'hidden' suppresses tool call/result rendering entirely. 'timeline' and 'grouped' require streaming. With streaming: false, only static modes are available and the default is 'cards'. (Default: `'grouped'`)
 
 **typingStatus** (`boolean | TypingStatusFn`): Show a typing indicator while the agent works. Set false to disable, or pass a function to return custom status text per stream chunk (return undefined to fall back to the default for that chunk). (Default: `true`)

package/.docs/reference/client-js/observability.md

@@ -41,6 +41,28 @@ console.log(`Total pages: ${traces.pagination.totalPages}`)
 const completeTrace = await mastraClient.getTrace(traces.spans[0].traceId)
 ```
 
+## Listing traces for a list view
+
+`listTracesLight()` returns the same rows as a trace list, without the `input`, `output` and `attributes` payloads. Each row carries a short `inputPreview` string instead, so a list can render a preview column without transferring the whole prompt.
+
+Prefer it whenever you are rendering many traces at once, and fetch the full record only when a row is opened:
+
+```typescript
+const list = await mastraClient.listTracesLight({
+  pagination: { page: 0, perPage: 25 },
+  filters: { entityType: 'agent' },
+})
+
+for (const span of list.spans) {
+  console.log(span.name, span.inputPreview)
+}
+
+// Fetch the full payload only for the trace the user selects
+const selected = await mastraClient.getTrace(list.spans[0].traceId)
+```
+
+It accepts the same filtering, ordering and delta-polling arguments as `listTraces()`. Use `listTraces()` when you actually need the full span payloads.
+
 ## Scoring traces
 
 Score specific traces using registered scorers for evaluation: