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

package/.docs/models/providers/deepinfra.md

@@ -1,112 +0,0 @@
-# ![Deep Infra logo](https://models.dev/logos/deepinfra.svg)Deep Infra
-
-Access 15 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
-
-Learn more in the [Deep Infra documentation](https://deepinfra.com/models).
-
-```bash
-DEEPINFRA_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: "deepinfra/MiniMaxAI/MiniMax-M2"
-});
-
-// 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 |
-| ----------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `deepinfra/anthropic/claude-3-7-sonnet-latest`        | 200K    |       |           |       |       |       | $3         | $17         |
-| `deepinfra/anthropic/claude-4-opus`                   | 200K    |       |           |       |       |       | $17        | $83         |
-| `deepinfra/deepseek-ai/DeepSeek-R1-0528`              | 164K    |       |           |       |       |       | $0.50      | $2          |
-| `deepinfra/deepseek-ai/DeepSeek-V3.2`                 | 164K    |       |           |       |       |       | $0.26      | $0.38       |
-| `deepinfra/MiniMaxAI/MiniMax-M2`                      | 262K    |       |           |       |       |       | $0.25      | $1          |
-| `deepinfra/MiniMaxAI/MiniMax-M2.1`                    | 197K    |       |           |       |       |       | $0.28      | $1          |
-| `deepinfra/moonshotai/Kimi-K2-Instruct`               | 131K    |       |           |       |       |       | $0.50      | $2          |
-| `deepinfra/moonshotai/Kimi-K2-Thinking`               | 131K    |       |           |       |       |       | $0.47      | $2          |
-| `deepinfra/moonshotai/Kimi-K2.5`                      | 262K    |       |           |       |       |       | $0.50      | $3          |
-| `deepinfra/openai/gpt-oss-120b`                       | 131K    |       |           |       |       |       | $0.05      | $0.24       |
-| `deepinfra/openai/gpt-oss-20b`                        | 131K    |       |           |       |       |       | $0.03      | $0.14       |
-| `deepinfra/Qwen/Qwen3-Coder-480B-A35B-Instruct`       | 262K    |       |           |       |       |       | $0.40      | $2          |
-| `deepinfra/Qwen/Qwen3-Coder-480B-A35B-Instruct-Turbo` | 262K    |       |           |       |       |       | $0.30      | $1          |
-| `deepinfra/zai-org/GLM-4.7`                           | 203K    |       |           |       |       |       | $0.43      | $2          |
-| `deepinfra/zai-org/GLM-4.7-Flash`                     | 203K    |       |           |       |       |       | $0.06      | $0.40       |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    id: "deepinfra/MiniMaxAI/MiniMax-M2",
-    apiKey: process.env.DEEPINFRA_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
-      ? "deepinfra/zai-org/GLM-4.7-Flash"
-      : "deepinfra/MiniMaxAI/MiniMax-M2";
-  }
-});
-```
-
-## 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/deepinfra) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/deepinfra
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/deepinfra
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/deepinfra
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/deepinfra
-```
-
-For detailed provider-specific documentation, see the [AI SDK Deep Infra provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/deepinfra).

package/.docs/models/providers/deepseek.md

@@ -1,88 +0,0 @@
-# ![DeepSeek logo](https://models.dev/logos/deepseek.svg)DeepSeek
-
-Access 2 DeepSeek models through Mastra's model router. Authentication is handled automatically using the `DEEPSEEK_API_KEY` environment variable.
-
-Learn more in the [DeepSeek documentation](https://platform.deepseek.com).
-
-```bash
-DEEPSEEK_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: "deepseek/deepseek-chat"
-});
-
-// 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 |
-| ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `deepseek/deepseek-chat`     | 128K    |       |           |       |       |       | $0.28      | $0.42       |
-| `deepseek/deepseek-reasoner` | 128K    |       |           |       |       |       | $0.28      | $0.42       |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.deepseek.com",
-    id: "deepseek/deepseek-chat",
-    apiKey: process.env.DEEPSEEK_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
-      ? "deepseek/deepseek-reasoner"
-      : "deepseek/deepseek-chat";
-  }
-});
-```
-
-## Provider Options
-
-DeepSeek supports the following provider-specific options via the `providerOptions` parameter:
-
-```typescript
-const response = await agent.generate("Hello!", {
-  providerOptions: {
-    deepseek: {
-      // See available options in the table below
-    }
-  }
-});
-```
-
-### Available Options
-
-**thinking?:** (`{ type?: "enabled" | "disabled" | undefined; } | undefined`)

package/.docs/models/providers/fastrouter.md

@@ -1,84 +0,0 @@
-# ![FastRouter logo](https://models.dev/logos/fastrouter.svg)FastRouter
-
-Access 14 FastRouter models through Mastra's model router. Authentication is handled automatically using the `FASTROUTER_API_KEY` environment variable.
-
-Learn more in the [FastRouter documentation](https://fastrouter.ai/models).
-
-```bash
-FASTROUTER_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: "fastrouter/anthropic/claude-opus-4.1"
-});
-
-// 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 [FastRouter documentation](https://fastrouter.ai/models) for details.
-
-## Models
-
-| Model                                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `fastrouter/anthropic/claude-opus-4.1`                 | 200K    |       |           |       |       |       | $15        | $75         |
-| `fastrouter/anthropic/claude-sonnet-4`                 | 200K    |       |           |       |       |       | $3         | $15         |
-| `fastrouter/deepseek-ai/deepseek-r1-distill-llama-70b` | 131K    |       |           |       |       |       | $0.03      | $0.14       |
-| `fastrouter/google/gemini-2.5-flash`                   | 1.0M    |       |           |       |       |       | $0.30      | $3          |
-| `fastrouter/google/gemini-2.5-pro`                     | 1.0M    |       |           |       |       |       | $1         | $10         |
-| `fastrouter/moonshotai/kimi-k2`                        | 131K    |       |           |       |       |       | $0.55      | $2          |
-| `fastrouter/openai/gpt-4.1`                            | 1.0M    |       |           |       |       |       | $2         | $8          |
-| `fastrouter/openai/gpt-5`                              | 400K    |       |           |       |       |       | $1         | $10         |
-| `fastrouter/openai/gpt-5-mini`                         | 400K    |       |           |       |       |       | $0.25      | $2          |
-| `fastrouter/openai/gpt-5-nano`                         | 400K    |       |           |       |       |       | $0.05      | $0.40       |
-| `fastrouter/openai/gpt-oss-120b`                       | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `fastrouter/openai/gpt-oss-20b`                        | 131K    |       |           |       |       |       | $0.05      | $0.20       |
-| `fastrouter/qwen/qwen3-coder`                          | 262K    |       |           |       |       |       | $0.30      | $1          |
-| `fastrouter/x-ai/grok-4`                               | 256K    |       |           |       |       |       | $3         | $15         |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://go.fastrouter.ai/api/v1",
-    id: "fastrouter/anthropic/claude-opus-4.1",
-    apiKey: process.env.FASTROUTER_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
-      ? "fastrouter/x-ai/grok-4"
-      : "fastrouter/anthropic/claude-opus-4.1";
-  }
-});
-```

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

@@ -1,89 +0,0 @@
-# ![Fireworks AI logo](https://models.dev/logos/fireworks-ai.svg)Fireworks AI
-
-Access 19 Fireworks AI models through Mastra's model router. Authentication is handled automatically using the `FIREWORKS_API_KEY` environment variable.
-
-Learn more in the [Fireworks AI documentation](https://fireworks.ai/docs/).
-
-```bash
-FIREWORKS_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: "fireworks-ai/accounts/fireworks/models/deepseek-r1-0528"
-});
-
-// 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 [Fireworks AI documentation](https://fireworks.ai/docs/) for details.
-
-## Models
-
-| Model                                                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ----------------------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `fireworks-ai/accounts/fireworks/models/deepseek-r1-0528`               | 160K    |       |           |       |       |       | $3         | $8          |
-| `fireworks-ai/accounts/fireworks/models/deepseek-v3-0324`               | 160K    |       |           |       |       |       | $0.90      | $0.90       |
-| `fireworks-ai/accounts/fireworks/models/deepseek-v3p1`                  | 164K    |       |           |       |       |       | $0.56      | $2          |
-| `fireworks-ai/accounts/fireworks/models/deepseek-v3p2`                  | 160K    |       |           |       |       |       | $0.56      | $2          |
-| `fireworks-ai/accounts/fireworks/models/glm-4p5`                        | 131K    |       |           |       |       |       | $0.55      | $2          |
-| `fireworks-ai/accounts/fireworks/models/glm-4p5-air`                    | 131K    |       |           |       |       |       | $0.22      | $0.88       |
-| `fireworks-ai/accounts/fireworks/models/glm-4p6`                        | 198K    |       |           |       |       |       | $0.55      | $2          |
-| `fireworks-ai/accounts/fireworks/models/glm-4p7`                        | 198K    |       |           |       |       |       | $0.60      | $2          |
-| `fireworks-ai/accounts/fireworks/models/glm-5`                          | 203K    |       |           |       |       |       | $1         | $3          |
-| `fireworks-ai/accounts/fireworks/models/gpt-oss-120b`                   | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `fireworks-ai/accounts/fireworks/models/gpt-oss-20b`                    | 131K    |       |           |       |       |       | $0.05      | $0.20       |
-| `fireworks-ai/accounts/fireworks/models/kimi-k2-instruct`               | 128K    |       |           |       |       |       | $1         | $3          |
-| `fireworks-ai/accounts/fireworks/models/kimi-k2-thinking`               | 256K    |       |           |       |       |       | $0.60      | $3          |
-| `fireworks-ai/accounts/fireworks/models/kimi-k2p5`                      | 256K    |       |           |       |       |       | $0.60      | $3          |
-| `fireworks-ai/accounts/fireworks/models/minimax-m2`                     | 192K    |       |           |       |       |       | $0.30      | $1          |
-| `fireworks-ai/accounts/fireworks/models/minimax-m2p1`                   | 200K    |       |           |       |       |       | $0.30      | $1          |
-| `fireworks-ai/accounts/fireworks/models/minimax-m2p5`                   | 197K    |       |           |       |       |       | $0.30      | $1          |
-| `fireworks-ai/accounts/fireworks/models/qwen3-235b-a22b`                | 128K    |       |           |       |       |       | $0.22      | $0.88       |
-| `fireworks-ai/accounts/fireworks/models/qwen3-coder-480b-a35b-instruct` | 256K    |       |           |       |       |       | $0.45      | $2          |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.fireworks.ai/inference/v1/",
-    id: "fireworks-ai/accounts/fireworks/models/deepseek-r1-0528",
-    apiKey: process.env.FIREWORKS_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
-      ? "fireworks-ai/accounts/fireworks/models/qwen3-coder-480b-a35b-instruct"
-      : "fireworks-ai/accounts/fireworks/models/deepseek-r1-0528";
-  }
-});
-```

package/.docs/models/providers/firmware.md

@@ -1,85 +0,0 @@
-# ![Firmware logo](https://models.dev/logos/firmware.svg)Firmware
-
-Access 15 Firmware models through Mastra's model router. Authentication is handled automatically using the `FIRMWARE_API_KEY` environment variable.
-
-Learn more in the [Firmware documentation](https://docs.firmware.ai).
-
-```bash
-FIRMWARE_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: "firmware/claude-haiku-4-5"
-});
-
-// 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 [Firmware documentation](https://docs.firmware.ai) for details.
-
-## Models
-
-| Model                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `firmware/claude-haiku-4-5`       | 200K    |       |           |       |       |       | $1         | $5          |
-| `firmware/claude-opus-4-5`        | 200K    |       |           |       |       |       | $5         | $25         |
-| `firmware/claude-opus-4-6`        | 200K    |       |           |       |       |       | $5         | $25         |
-| `firmware/claude-sonnet-4-5`      | 200K    |       |           |       |       |       | $3         | $15         |
-| `firmware/gemini-2.5-flash`       | 1.0M    |       |           |       |       |       | $0.30      | $3          |
-| `firmware/gemini-2.5-pro`         | 1.0M    |       |           |       |       |       | $1         | $10         |
-| `firmware/gemini-3-flash-preview` | 1.0M    |       |           |       |       |       | $0.50      | $3          |
-| `firmware/gemini-3-pro-preview`   | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `firmware/gpt-4o`                 | 128K    |       |           |       |       |       | $3         | $10         |
-| `firmware/gpt-5`                  | 400K    |       |           |       |       |       | $1         | $10         |
-| `firmware/gpt-5-mini`             | 400K    |       |           |       |       |       | $0.25      | $2          |
-| `firmware/gpt-5-nano`             | 400K    |       |           |       |       |       | $0.05      | $0.40       |
-| `firmware/gpt-5.2`                | 400K    |       |           |       |       |       | $2         | $14         |
-| `firmware/gpt-oss-120b`           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `firmware/gpt-oss-20b`            | 131K    |       |           |       |       |       | $0.07      | $0.20       |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://app.firmware.ai/api/v1",
-    id: "firmware/claude-haiku-4-5",
-    apiKey: process.env.FIRMWARE_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
-      ? "firmware/gpt-oss-20b"
-      : "firmware/claude-haiku-4-5";
-  }
-});
-```

package/.docs/models/providers/friendli.md

@@ -1,78 +0,0 @@
-# ![Friendli logo](https://models.dev/logos/friendli.svg)Friendli
-
-Access 8 Friendli models through Mastra's model router. Authentication is handled automatically using the `FRIENDLI_TOKEN` environment variable.
-
-Learn more in the [Friendli documentation](https://friendli.ai/docs/guides/serverless_endpoints/introduction).
-
-```bash
-FRIENDLI_TOKEN=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: "friendli/LGAI-EXAONE/EXAONE-4.0.1-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 [Friendli documentation](https://friendli.ai/docs/guides/serverless_endpoints/introduction) for details.
-
-## Models
-
-| Model                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `friendli/LGAI-EXAONE/EXAONE-4.0.1-32B`       | 131K    |       |           |       |       |       | $0.60      | $1          |
-| `friendli/LGAI-EXAONE/K-EXAONE-236B-A23B`     | 262K    |       |           |       |       |       | —          | —           |
-| `friendli/meta-llama/Llama-3.1-8B-Instruct`   | 131K    |       |           |       |       |       | $0.10      | $0.10       |
-| `friendli/meta-llama/Llama-3.3-70B-Instruct`  | 131K    |       |           |       |       |       | $0.60      | $0.60       |
-| `friendli/MiniMaxAI/MiniMax-M2.1`             | 197K    |       |           |       |       |       | $0.30      | $1          |
-| `friendli/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K    |       |           |       |       |       | $0.20      | $0.80       |
-| `friendli/zai-org/GLM-4.7`                    | 203K    |       |           |       |       |       | —          | —           |
-| `friendli/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.friendli.ai/serverless/v1",
-    id: "friendli/LGAI-EXAONE/EXAONE-4.0.1-32B",
-    apiKey: process.env.FRIENDLI_TOKEN,
-    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
-      ? "friendli/zai-org/GLM-5"
-      : "friendli/LGAI-EXAONE/EXAONE-4.0.1-32B";
-  }
-});
-```

package/.docs/models/providers/github-models.md

@@ -1,125 +0,0 @@
-# ![GitHub Models logo](https://models.dev/logos/github-models.svg)GitHub Models
-
-Access 55 GitHub Models models through Mastra's model router. Authentication is handled automatically using the `GITHUB_TOKEN` environment variable.
-
-Learn more in the [GitHub Models documentation](https://docs.github.com/en/github-models).
-
-```bash
-GITHUB_TOKEN=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: "github-models/ai21-labs/ai21-jamba-1.5-large"
-});
-
-// 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 [GitHub Models documentation](https://docs.github.com/en/github-models) for details.
-
-## Models
-
-| Model                                                       | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ----------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `github-models/ai21-labs/ai21-jamba-1.5-large`              | 256K    |       |           |       |       |       | —          | —           |
-| `github-models/ai21-labs/ai21-jamba-1.5-mini`               | 256K    |       |           |       |       |       | —          | —           |
-| `github-models/cohere/cohere-command-a`                     | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/cohere/cohere-command-r`                     | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/cohere/cohere-command-r-08-2024`             | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/cohere/cohere-command-r-plus`                | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/cohere/cohere-command-r-plus-08-2024`        | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/core42/jais-30b-chat`                        | 8K      |       |           |       |       |       | —          | —           |
-| `github-models/deepseek/deepseek-r1`                        | 66K     |       |           |       |       |       | —          | —           |
-| `github-models/deepseek/deepseek-r1-0528`                   | 66K     |       |           |       |       |       | —          | —           |
-| `github-models/deepseek/deepseek-v3-0324`                   | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/llama-3.2-11b-vision-instruct`          | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/llama-3.2-90b-vision-instruct`          | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/llama-3.3-70b-instruct`                 | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/llama-4-maverick-17b-128e-instruct-fp8` | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/llama-4-scout-17b-16e-instruct`         | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/meta-llama-3-70b-instruct`              | 8K      |       |           |       |       |       | —          | —           |
-| `github-models/meta/meta-llama-3-8b-instruct`               | 8K      |       |           |       |       |       | —          | —           |
-| `github-models/meta/meta-llama-3.1-405b-instruct`           | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/meta-llama-3.1-70b-instruct`            | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/meta/meta-llama-3.1-8b-instruct`             | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/mai-ds-r1`                         | 66K     |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-medium-128k-instruct`        | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-medium-4k-instruct`          | 4K      |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-mini-128k-instruct`          | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-mini-4k-instruct`            | 4K      |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-small-128k-instruct`         | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3-small-8k-instruct`           | 8K      |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3.5-mini-instruct`             | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3.5-moe-instruct`              | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-3.5-vision-instruct`           | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-4`                             | 16K     |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-4-mini-instruct`               | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-4-mini-reasoning`              | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-4-multimodal-instruct`         | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/microsoft/phi-4-reasoning`                   | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/codestral-2501`                   | 32K     |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/ministral-3b`                     | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/mistral-large-2411`               | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/mistral-medium-2505`              | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/mistral-nemo`                     | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/mistral-ai/mistral-small-2503`               | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/gpt-4.1`                              | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/gpt-4.1-mini`                         | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/gpt-4.1-nano`                         | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/gpt-4o`                               | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/gpt-4o-mini`                          | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o1`                                   | 200K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o1-mini`                              | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o1-preview`                           | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o3`                                   | 200K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o3-mini`                              | 200K    |       |           |       |       |       | —          | —           |
-| `github-models/openai/o4-mini`                              | 200K    |       |           |       |       |       | —          | —           |
-| `github-models/xai/grok-3`                                  | 128K    |       |           |       |       |       | —          | —           |
-| `github-models/xai/grok-3-mini`                             | 128K    |       |           |       |       |       | —          | —           |
-
-## Advanced Configuration
-
-### Custom Headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://models.github.ai/inference",
-    id: "github-models/ai21-labs/ai21-jamba-1.5-large",
-    apiKey: process.env.GITHUB_TOKEN,
-    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
-      ? "github-models/xai/grok-3-mini"
-      : "github-models/ai21-labs/ai21-jamba-1.5-large";
-  }
-});
-```