@mastra/mcp-docs-server 1.1.5 → 1.1.6-alpha.0

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

@@ -0,0 +1,154 @@
+# ![NovitaAI logo](https://models.dev/logos/novita-ai.svg)NovitaAI
+
+Access 84 NovitaAI models through Mastra's model router. Authentication is handled automatically using the `NOVITA_API_KEY` environment variable.
+
+Learn more in the [NovitaAI documentation](https://novita.ai/docs/guides/introduction).
+
+```bash
+NOVITA_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: "novita-ai/baichuan/baichuan-m2-32b"
+});
+
+// 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);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [NovitaAI documentation](https://novita.ai/docs/guides/introduction) for details.
+
+## Models
+
+| Model                                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `novita-ai/baichuan/baichuan-m2-32b`                          | 131K    |       |           |       |       |       | $0.07      | $0.07       |
+| `novita-ai/baidu/ernie-4.5-21B-a3b`                           | 120K    |       |           |       |       |       | $0.07      | $0.28       |
+| `novita-ai/baidu/ernie-4.5-21B-a3b-thinking`                  | 131K    |       |           |       |       |       | $0.07      | $0.28       |
+| `novita-ai/baidu/ernie-4.5-300b-a47b-paddle`                  | 123K    |       |           |       |       |       | $0.28      | $1          |
+| `novita-ai/baidu/ernie-4.5-vl-28b-a3b`                        | 30K     |       |           |       |       |       | $1         | $6          |
+| `novita-ai/baidu/ernie-4.5-vl-28b-a3b-thinking`               | 131K    |       |           |       |       |       | $0.39      | $0.39       |
+| `novita-ai/baidu/ernie-4.5-vl-424b-a47b`                      | 123K    |       |           |       |       |       | $0.42      | $1          |
+| `novita-ai/deepseek/deepseek-ocr`                             | 8K      |       |           |       |       |       | $0.03      | $0.03       |
+| `novita-ai/deepseek/deepseek-ocr-2`                           | 8K      |       |           |       |       |       | $0.03      | $0.03       |
+| `novita-ai/deepseek/deepseek-prover-v2-671b`                  | 160K    |       |           |       |       |       | $0.70      | $3          |
+| `novita-ai/deepseek/deepseek-r1-0528`                         | 164K    |       |           |       |       |       | $0.70      | $3          |
+| `novita-ai/deepseek/deepseek-r1-0528-qwen3-8b`                | 128K    |       |           |       |       |       | $0.06      | $0.09       |
+| `novita-ai/deepseek/deepseek-r1-distill-llama-70b`            | 8K      |       |           |       |       |       | $0.80      | $0.80       |
+| `novita-ai/deepseek/deepseek-r1-turbo`                        | 64K     |       |           |       |       |       | $0.70      | $3          |
+| `novita-ai/deepseek/deepseek-v3-0324`                         | 164K    |       |           |       |       |       | $0.27      | $1          |
+| `novita-ai/deepseek/deepseek-v3-turbo`                        | 64K     |       |           |       |       |       | $0.40      | $1          |
+| `novita-ai/deepseek/deepseek-v3.1`                            | 131K    |       |           |       |       |       | $0.27      | $1          |
+| `novita-ai/deepseek/deepseek-v3.1-terminus`                   | 131K    |       |           |       |       |       | $0.27      | $1          |
+| `novita-ai/deepseek/deepseek-v3.2`                            | 164K    |       |           |       |       |       | $0.27      | $0.40       |
+| `novita-ai/deepseek/deepseek-v3.2-exp`                        | 164K    |       |           |       |       |       | $0.27      | $0.41       |
+| `novita-ai/google/gemma-3-27b-it`                             | 98K     |       |           |       |       |       | $0.12      | $0.20       |
+| `novita-ai/gryphe/mythomax-l2-13b`                            | 4K      |       |           |       |       |       | $0.09      | $0.09       |
+| `novita-ai/kwaipilot/kat-coder`                               | 256K    |       |           |       |       |       | —          | —           |
+| `novita-ai/kwaipilot/kat-coder-pro`                           | 256K    |       |           |       |       |       | $0.30      | $1          |
+| `novita-ai/meta-llama/llama-3-70b-instruct`                   | 8K      |       |           |       |       |       | $0.51      | $0.74       |
+| `novita-ai/meta-llama/llama-3-8b-instruct`                    | 8K      |       |           |       |       |       | $0.04      | $0.04       |
+| `novita-ai/meta-llama/llama-3.1-8b-instruct`                  | 16K     |       |           |       |       |       | $0.02      | $0.05       |
+| `novita-ai/meta-llama/llama-3.3-70b-instruct`                 | 131K    |       |           |       |       |       | $0.14      | $0.40       |
+| `novita-ai/meta-llama/llama-4-maverick-17b-128e-instruct-fp8` | 1.0M    |       |           |       |       |       | $0.27      | $0.85       |
+| `novita-ai/meta-llama/llama-4-scout-17b-16e-instruct`         | 131K    |       |           |       |       |       | $0.18      | $0.59       |
+| `novita-ai/microsoft/wizardlm-2-8x22b`                        | 66K     |       |           |       |       |       | $0.62      | $0.62       |
+| `novita-ai/minimax/minimax-m2`                                | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `novita-ai/minimax/minimax-m2.1`                              | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `novita-ai/minimax/minimax-m2.5`                              | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `novita-ai/minimaxai/minimax-m1-80k`                          | 1.0M    |       |           |       |       |       | $0.55      | $2          |
+| `novita-ai/mistralai/mistral-nemo`                            | 60K     |       |           |       |       |       | $0.04      | $0.17       |
+| `novita-ai/moonshotai/kimi-k2-0905`                           | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `novita-ai/moonshotai/kimi-k2-instruct`                       | 131K    |       |           |       |       |       | $0.57      | $2          |
+| `novita-ai/moonshotai/kimi-k2-thinking`                       | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `novita-ai/moonshotai/kimi-k2.5`                              | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `novita-ai/nousresearch/hermes-2-pro-llama-3-8b`              | 8K      |       |           |       |       |       | $0.14      | $0.14       |
+| `novita-ai/openai/gpt-oss-120b`                               | 131K    |       |           |       |       |       | $0.05      | $0.25       |
+| `novita-ai/openai/gpt-oss-20b`                                | 131K    |       |           |       |       |       | $0.04      | $0.15       |
+| `novita-ai/paddlepaddle/paddleocr-vl`                         | 16K     |       |           |       |       |       | $0.02      | $0.02       |
+| `novita-ai/qwen/qwen-2.5-72b-instruct`                        | 32K     |       |           |       |       |       | $0.38      | $0.40       |
+| `novita-ai/qwen/qwen-mt-plus`                                 | 16K     |       |           |       |       |       | $0.25      | $0.75       |
+| `novita-ai/qwen/qwen2.5-7b-instruct`                          | 32K     |       |           |       |       |       | $0.07      | $0.07       |
+| `novita-ai/qwen/qwen2.5-vl-72b-instruct`                      | 33K     |       |           |       |       |       | $0.80      | $0.80       |
+| `novita-ai/qwen/qwen3-235b-a22b-fp8`                          | 41K     |       |           |       |       |       | $0.20      | $0.80       |
+| `novita-ai/qwen/qwen3-235b-a22b-instruct-2507`                | 131K    |       |           |       |       |       | $0.09      | $0.58       |
+| `novita-ai/qwen/qwen3-235b-a22b-thinking-2507`                | 131K    |       |           |       |       |       | $0.30      | $3          |
+| `novita-ai/qwen/qwen3-30b-a3b-fp8`                            | 41K     |       |           |       |       |       | $0.09      | $0.45       |
+| `novita-ai/qwen/qwen3-32b-fp8`                                | 41K     |       |           |       |       |       | $0.10      | $0.45       |
+| `novita-ai/qwen/qwen3-4b-fp8`                                 | 128K    |       |           |       |       |       | $0.03      | $0.03       |
+| `novita-ai/qwen/qwen3-8b-fp8`                                 | 128K    |       |           |       |       |       | $0.04      | $0.14       |
+| `novita-ai/qwen/qwen3-coder-30b-a3b-instruct`                 | 160K    |       |           |       |       |       | $0.07      | $0.27       |
+| `novita-ai/qwen/qwen3-coder-480b-a35b-instruct`               | 262K    |       |           |       |       |       | $0.30      | $1          |
+| `novita-ai/qwen/qwen3-coder-next`                             | 262K    |       |           |       |       |       | $0.20      | $2          |
+| `novita-ai/qwen/qwen3-max`                                    | 262K    |       |           |       |       |       | $2         | $8          |
+| `novita-ai/qwen/qwen3-next-80b-a3b-instruct`                  | 131K    |       |           |       |       |       | $0.15      | $2          |
+| `novita-ai/qwen/qwen3-next-80b-a3b-thinking`                  | 131K    |       |           |       |       |       | $0.15      | $2          |
+| `novita-ai/qwen/qwen3-omni-30b-a3b-instruct`                  | 66K     |       |           |       |       |       | $0.25      | $0.97       |
+| `novita-ai/qwen/qwen3-omni-30b-a3b-thinking`                  | 66K     |       |           |       |       |       | $0.25      | $0.97       |
+| `novita-ai/qwen/qwen3-vl-235b-a22b-instruct`                  | 131K    |       |           |       |       |       | $0.30      | $2          |
+| `novita-ai/qwen/qwen3-vl-235b-a22b-thinking`                  | 131K    |       |           |       |       |       | $0.98      | $4          |
+| `novita-ai/qwen/qwen3-vl-30b-a3b-instruct`                    | 131K    |       |           |       |       |       | $0.20      | $0.70       |
+| `novita-ai/qwen/qwen3-vl-30b-a3b-thinking`                    | 131K    |       |           |       |       |       | $0.20      | $1          |
+| `novita-ai/qwen/qwen3-vl-8b-instruct`                         | 131K    |       |           |       |       |       | $0.08      | $0.50       |
+| `novita-ai/qwen/qwen3.5-397b-a17b`                            | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `novita-ai/sao10k/l3-70b-euryale-v2.1`                        | 8K      |       |           |       |       |       | $1         | $1          |
+| `novita-ai/sao10k/l3-8b-lunaris`                              | 8K      |       |           |       |       |       | $0.05      | $0.05       |
+| `novita-ai/sao10k/L3-8B-Stheno-v3.2`                          | 8K      |       |           |       |       |       | $0.05      | $0.05       |
+| `novita-ai/sao10k/l31-70b-euryale-v2.2`                       | 8K      |       |           |       |       |       | $1         | $1          |
+| `novita-ai/skywork/r1v4-lite`                                 | 262K    |       |           |       |       |       | $0.20      | $0.60       |
+| `novita-ai/xiaomimimo/mimo-v2-flash`                          | 262K    |       |           |       |       |       | $0.10      | $0.30       |
+| `novita-ai/zai-org/autoglm-phone-9b-multilingual`             | 66K     |       |           |       |       |       | $0.04      | $0.14       |
+| `novita-ai/zai-org/glm-4.5`                                   | 131K    |       |           |       |       |       | $0.60      | $2          |
+| `novita-ai/zai-org/glm-4.5-air`                               | 131K    |       |           |       |       |       | $0.13      | $0.85       |
+| `novita-ai/zai-org/glm-4.5v`                                  | 66K     |       |           |       |       |       | $0.60      | $2          |
+| `novita-ai/zai-org/glm-4.6`                                   | 205K    |       |           |       |       |       | $0.55      | $2          |
+| `novita-ai/zai-org/glm-4.6v`                                  | 131K    |       |           |       |       |       | $0.30      | $0.90       |
+| `novita-ai/zai-org/glm-4.7`                                   | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `novita-ai/zai-org/glm-4.7-flash`                             | 200K    |       |           |       |       |       | $0.07      | $0.40       |
+| `novita-ai/zai-org/glm-5`                                     | 203K    |       |           |       |       |       | $1         | $3          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.novita.ai/openai",
+    id: "novita-ai/baichuan/baichuan-m2-32b",
+    apiKey: process.env.NOVITA_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
+      ? "novita-ai/zai-org/glm-5"
+      : "novita-ai/baichuan/baichuan-m2-32b";
+  }
+});
+```

package/.docs/models/providers/nvidia.md

@@ -0,0 +1,141 @@
+# ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
+
+Access 71 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
+
+Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
+
+```bash
+NVIDIA_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: "nvidia/black-forest-labs/flux.1-dev"
+});
+
+// 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);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Nvidia documentation](https://docs.api.nvidia.com/nim/) for details.
+
+## Models
+
+| Model                                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `nvidia/black-forest-labs/flux.1-dev`                  | 4K      |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-coder-6.7b-instruct`      | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-r1`                       | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-r1-0528`                  | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-v3.1`                     | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-v3.1-terminus`            | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/deepseek-ai/deepseek-v3.2`                     | 164K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/codegemma-1.1-7b`                       | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/codegemma-7b`                           | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-2-27b-it`                         | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-2-2b-it`                          | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-3-12b-it`                         | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-3-1b-it`                          | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-3-27b-it`                         | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-3n-e2b-it`                        | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/google/gemma-3n-e4b-it`                        | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/codellama-70b`                            | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-3.1-405b-instruct`                  | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-3.1-70b-instruct`                   | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-3.2-11b-vision-instruct`            | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-3.2-1b-instruct`                    | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-3.3-70b-instruct`                   | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-4-maverick-17b-128e-instruct`       | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama-4-scout-17b-16e-instruct`           | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama3-70b-instruct`                      | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/meta/llama3-8b-instruct`                       | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3-medium-128k-instruct`          | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3-medium-4k-instruct`            | 4K      |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3-small-128k-instruct`           | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3-small-8k-instruct`             | 8K      |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3-vision-128k-instruct`          | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3.5-moe-instruct`                | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-3.5-vision-instruct`             | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/microsoft/phi-4-mini-instruct`                 | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/minimaxai/minimax-m2`                          | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/minimaxai/minimax-m2.1`                        | 205K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/codestral-22b-instruct-v0.1`         | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/devstral-2-123b-instruct-2512`       | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/mamba-codestral-7b-v0.1`             | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/ministral-14b-instruct-2512`         | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/mistral-large-2-instruct`            | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/mistral-large-3-675b-instruct-2512`  | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/mistralai/mistral-small-3.1-24b-instruct-2503` | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/moonshotai/kimi-k2-instruct`                   | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/moonshotai/kimi-k2-instruct-0905`              | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/moonshotai/kimi-k2-thinking`                   | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/moonshotai/kimi-k2.5`                          | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/cosmos-nemotron-34b`                    | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-3.1-nemotron-51b-instruct`        | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-3.1-nemotron-70b-instruct`        | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-3.1-nemotron-ultra-253b-v1`       | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-3.3-nemotron-super-49b-v1`        | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-3.3-nemotron-super-49b-v1.5`      | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama-embed-nemotron-8b`                | 33K     |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/llama3-chatqa-1.5-70b`                  | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/nemoretriever-ocr-v1`                   | —       |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/nemotron-3-nano-30b-a3b`                | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/nemotron-4-340b-instruct`               | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/nvidia-nemotron-nano-9b-v2`             | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/nvidia/parakeet-tdt-0.6b-v2`                   | —       |       |           |       |       |       | —          | —           |
+| `nvidia/openai/gpt-oss-120b`                           | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/openai/whisper-large-v3`                       | —       |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen2.5-coder-32b-instruct`               | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen2.5-coder-7b-instruct`                | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen3-235b-a22b`                          | 131K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen3-coder-480b-a35b-instruct`           | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen3-next-80b-a3b-instruct`              | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwen3-next-80b-a3b-thinking`              | 262K    |       |           |       |       |       | —          | —           |
+| `nvidia/qwen/qwq-32b`                                  | 128K    |       |           |       |       |       | —          | —           |
+| `nvidia/z-ai/glm4.7`                                   | 205K    |       |           |       |       |       | —          | —           |
+| `nvidia/z-ai/glm5`                                     | 203K    |       |           |       |       |       | —          | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://integrate.api.nvidia.com/v1",
+    id: "nvidia/black-forest-labs/flux.1-dev",
+    apiKey: process.env.NVIDIA_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
+      ? "nvidia/z-ai/glm5"
+      : "nvidia/black-forest-labs/flux.1-dev";
+  }
+});
+```

package/.docs/models/providers/ollama-cloud.md

@@ -0,0 +1,103 @@
+# ![Ollama Cloud logo](https://models.dev/logos/ollama-cloud.svg)Ollama Cloud
+
+Access 33 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the `OLLAMA_API_KEY` environment variable.
+
+Learn more in the [Ollama Cloud documentation](https://docs.ollama.com/cloud).
+
+```bash
+OLLAMA_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: "ollama-cloud/cogito-2.1:671b"
+});
+
+// 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);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Ollama Cloud documentation](https://docs.ollama.com/cloud) for details.
+
+## Models
+
+| Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `ollama-cloud/cogito-2.1:671b`        | 164K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/deepseek-v3.1:671b`     | 164K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/deepseek-v3.2`          | 164K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/devstral-2:123b`        | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/devstral-small-2:24b`   | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gemini-3-flash-preview` | 1.0M    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gemini-3-pro-preview`   | 1.0M    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gemma3:12b`             | 131K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gemma3:27b`             | 131K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gemma3:4b`              | 131K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/glm-4.6`                | 203K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/glm-4.7`                | 203K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/glm-5`                  | 203K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gpt-oss:120b`           | 131K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/gpt-oss:20b`            | 131K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/kimi-k2-thinking`       | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/kimi-k2:1t`             | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/kimi-k2.5`              | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/minimax-m2`             | 205K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/minimax-m2.1`           | 205K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/minimax-m2.5`           | 205K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/ministral-3:14b`        | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/ministral-3:3b`         | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/ministral-3:8b`         | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/mistral-large-3:675b`   | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/nemotron-3-nano:30b`    | 1.0M    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3-coder-next`       | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3-coder:480b`       | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3-next:80b`         | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3-vl:235b`          | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3-vl:235b-instruct` | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/qwen3.5:397b`           | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/rnj-1:8b`               | 33K     |       |           |       |       |       | —          | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://ollama.com/v1",
+    id: "ollama-cloud/cogito-2.1:671b",
+    apiKey: process.env.OLLAMA_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
+      ? "ollama-cloud/rnj-1:8b"
+      : "ollama-cloud/cogito-2.1:671b";
+  }
+});
+```

package/.docs/models/providers/ollama.md

@@ -0,0 +1,33 @@
+# ![Ollama logo](https://models.dev/logos/ollama.svg)Ollama
+
+Ollama 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 Ollama provider docs](https://ai-sdk.dev/providers/community-providers/ollama).
+
+To use this provider with Mastra agents, see the [Agent Overview documentation](https://mastra.ai/docs/agents/overview).
+
+## Installation
+
+**npm**:
+
+```bash
+npm install ollama-ai-provider-v2
+```
+
+**pnpm**:
+
+```bash
+pnpm add ollama-ai-provider-v2
+```
+
+**Yarn**:
+
+```bash
+yarn add ollama-ai-provider-v2
+```
+
+**Bun**:
+
+```bash
+bun add ollama-ai-provider-v2
+```

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

@@ -0,0 +1,193 @@
+# ![OpenAI logo](https://models.dev/logos/openai.svg)OpenAI
+
+Access 42 OpenAI models through Mastra's model router. Authentication is handled automatically using the `OPENAI_API_KEY` environment variable.
+
+Learn more in the [OpenAI documentation](https://platform.openai.com/docs/models).
+
+```bash
+OPENAI_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: "openai/codex-mini-latest"
+});
+
+// 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);
+}
+```
+
+## Models
+
+| Model                           | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `openai/codex-mini-latest`      | 200K    |       |           |       |       |       | $2         | $6          |
+| `openai/gpt-3.5-turbo`          | 16K     |       |           |       |       |       | $0.50      | $2          |
+| `openai/gpt-4`                  | 8K      |       |           |       |       |       | $30        | $60         |
+| `openai/gpt-4-turbo`            | 128K    |       |           |       |       |       | $10        | $30         |
+| `openai/gpt-4.1`                | 1.0M    |       |           |       |       |       | $2         | $8          |
+| `openai/gpt-4.1-mini`           | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+| `openai/gpt-4.1-nano`           | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `openai/gpt-4o`                 | 128K    |       |           |       |       |       | $3         | $10         |
+| `openai/gpt-4o-2024-05-13`      | 128K    |       |           |       |       |       | $5         | $15         |
+| `openai/gpt-4o-2024-08-06`      | 128K    |       |           |       |       |       | $3         | $10         |
+| `openai/gpt-4o-2024-11-20`      | 128K    |       |           |       |       |       | $3         | $10         |
+| `openai/gpt-4o-mini`            | 128K    |       |           |       |       |       | $0.15      | $0.60       |
+| `openai/gpt-5`                  | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5-chat-latest`      | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5-codex`            | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5-mini`             | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `openai/gpt-5-nano`             | 400K    |       |           |       |       |       | $0.05      | $0.40       |
+| `openai/gpt-5-pro`              | 400K    |       |           |       |       |       | $15        | $120        |
+| `openai/gpt-5.1`                | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5.1-chat-latest`    | 128K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5.1-codex`          | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5.1-codex-max`      | 400K    |       |           |       |       |       | $1         | $10         |
+| `openai/gpt-5.1-codex-mini`     | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `openai/gpt-5.2`                | 400K    |       |           |       |       |       | $2         | $14         |
+| `openai/gpt-5.2-chat-latest`    | 128K    |       |           |       |       |       | $2         | $14         |
+| `openai/gpt-5.2-codex`          | 400K    |       |           |       |       |       | $2         | $14         |
+| `openai/gpt-5.2-pro`            | 400K    |       |           |       |       |       | $21        | $168        |
+| `openai/gpt-5.3-codex`          | 400K    |       |           |       |       |       | $2         | $14         |
+| `openai/gpt-5.3-codex-spark`    | 128K    |       |           |       |       |       | $2         | $14         |
+| `openai/o1`                     | 200K    |       |           |       |       |       | $15        | $60         |
+| `openai/o1-mini`                | 128K    |       |           |       |       |       | $1         | $4          |
+| `openai/o1-preview`             | 128K    |       |           |       |       |       | $15        | $60         |
+| `openai/o1-pro`                 | 200K    |       |           |       |       |       | $150       | $600        |
+| `openai/o3`                     | 200K    |       |           |       |       |       | $2         | $8          |
+| `openai/o3-deep-research`       | 200K    |       |           |       |       |       | $10        | $40         |
+| `openai/o3-mini`                | 200K    |       |           |       |       |       | $1         | $4          |
+| `openai/o3-pro`                 | 200K    |       |           |       |       |       | $20        | $80         |
+| `openai/o4-mini`                | 200K    |       |           |       |       |       | $1         | $4          |
+| `openai/o4-mini-deep-research`  | 200K    |       |           |       |       |       | $2         | $8          |
+| `openai/text-embedding-3-large` | 8K      |       |           |       |       |       | $0.13      | —           |
+| `openai/text-embedding-3-small` | 8K      |       |           |       |       |       | $0.02      | —           |
+| `openai/text-embedding-ada-002` | 8K      |       |           |       |       |       | $0.10      | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    id: "openai/codex-mini-latest",
+    apiKey: process.env.OPENAI_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
+      ? "openai/text-embedding-ada-002"
+      : "openai/codex-mini-latest";
+  }
+});
+```
+
+## Provider Options
+
+OpenAI supports the following provider-specific options via the `providerOptions` parameter:
+
+```typescript
+const response = await agent.generate("Hello!", {
+  providerOptions: {
+    openai: {
+      // See available options in the table below
+    }
+  }
+});
+```
+
+### Available Options
+
+**conversation?:** (`string | null | undefined`)
+
+**include?:** (`("file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
+
+**instructions?:** (`string | null | undefined`)
+
+**logprobs?:** (`number | boolean | undefined`)
+
+**maxToolCalls?:** (`number | null | undefined`)
+
+**metadata?:** (`any`)
+
+**parallelToolCalls?:** (`boolean | null | undefined`)
+
+**previousResponseId?:** (`string | null | undefined`)
+
+**promptCacheKey?:** (`string | null | undefined`)
+
+**promptCacheRetention?:** (`"in_memory" | "24h" | null | undefined`)
+
+**reasoningEffort?:** (`string | null | undefined`)
+
+**reasoningSummary?:** (`string | null | undefined`)
+
+**safetyIdentifier?:** (`string | null | undefined`)
+
+**serviceTier?:** (`"default" | "auto" | "flex" | "priority" | null | undefined`)
+
+**store?:** (`boolean | null | undefined`): Controls whether OpenAI stores your API requests for model training. Required to be "false" if your organization has zero data retention enabled. See: https\://platform.openai.com/docs/guides/your-data#zero-data-retention
+
+**strictJsonSchema?:** (`boolean | null | undefined`)
+
+**textVerbosity?:** (`"low" | "medium" | "high" | null | undefined`)
+
+**truncation?:** (`"auto" | "disabled" | null | undefined`)
+
+**user?:** (`string | null | undefined`)
+
+## Direct Provider Installation
+
+This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/openai) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/openai
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/openai
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/openai
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/openai
+```
+
+For detailed provider-specific documentation, see the [AI SDK OpenAI provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/openai).