@mastra/mcp-docs-server 1.2.7-alpha.12 → 1.2.7-alpha.4

package/.docs/models/providers/meta.md

@@ -1,101 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# ![Meta logo](https://models.dev/logos/meta.svg)Meta
-
-Access 1 Meta model through Mastra's model router. Authentication is handled automatically using the `META_MODEL_API_KEY` environment variable.
-
-Learn more in the [Meta documentation](https://dev.meta.ai/docs).
-
-```bash
-META_MODEL_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: "meta/muse-spark-1.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 [Meta documentation](https://dev.meta.ai/docs) for details.
-
-## Models
-
-| Model                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `meta/muse-spark-1.1` | 1.0M    |       |           |       |       |       | $1         | $4          |
-
-## Advanced configuration
-
-### Custom headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.meta.ai/v1",
-    id: "meta/muse-spark-1.1",
-    apiKey: process.env.META_MODEL_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
-      ? "meta/muse-spark-1.1"
-      : "meta/muse-spark-1.1";
-  }
-});
-```
-
-## 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
-```

package/.docs/models/providers/model-oracle-ai.md

@@ -1,87 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# ![Model Oracle AI logo](https://models.dev/logos/model-oracle-ai.svg)Model Oracle AI
-
-Access 15 Model Oracle AI models through Mastra's model router. Authentication is handled automatically using the `MODEL_ORACLE_API_KEY` environment variable.
-
-Learn more in the [Model Oracle AI documentation](https://modeloracle.com/setup/).
-
-```bash
-MODEL_ORACLE_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: "model-oracle-ai/auto"
-});
-
-// 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 [Model Oracle AI documentation](https://modeloracle.com/setup/) for details.
-
-## Models
-
-| Model                              | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `model-oracle-ai/auto`             | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/claude-fable-5`   | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/claude-haiku-4.5` | 200K    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/claude-opus-4.8`  | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/claude-sonnet-5`  | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/deepseek-v4-pro`  | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/glm-5.2`          | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-4.1`          | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-4.1-mini`     | 1.0M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-5`            | 400K    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-5.4`          | 1.1M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-5.4-mini`     | 400K    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-5.4-nano`     | 400K    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/gpt-5.5`          | 1.1M    |       |           |       |       |       | —          | —           |
-| `model-oracle-ai/o4-mini`          | 200K    |       |           |       |       |       | —          | —           |
-
-## Advanced configuration
-
-### Custom headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.modeloracle.com/api/v1",
-    id: "model-oracle-ai/auto",
-    apiKey: process.env.MODEL_ORACLE_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
-      ? "model-oracle-ai/o4-mini"
-      : "model-oracle-ai/auto";
-  }
-});
-```

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

@@ -1,148 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# ![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.
-
-Learn more in the [Pioneer documentation](https://agent.pioneer.ai/llms.txt).
-
-```bash
-PIONEER_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: "pioneer/HuggingFaceTB/SmolLM3-3B-Base"
-});
-
-// 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 [Pioneer documentation](https://agent.pioneer.ai/llms.txt) for details.
-
-## Models
-
-| Model                                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `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-sonnet-4-5`                             | 1.0M    |       |           |       |       |       | $3         | $15         |
-| `pioneer/claude-sonnet-4-6`                             | 1.0M    |       |           |       |       |       | $3         | $15         |
-| `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/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       |
-| `pioneer/fastino/gliner2-multi-large-v1`                | 8K      |       |           |       |       |       | $0.15      | $0.15       |
-| `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-pro`                                | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `pioneer/gemini-3.5-flash`                              | 1.0M    |       |           |       |       |       | $2         | $9          |
-| `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       |
-| `pioneer/google/gemma-4-31B-it`                         | 33K     |       |           |       |       |       | $0.50      | $0.50       |
-| `pioneer/google/gemma-4-E2B-it`                         | 33K     |       |           |       |       |       | $0.10      | $0.10       |
-| `pioneer/google/gemma-4-E4B-it`                         | 33K     |       |           |       |       |       | $0.20      | $0.20       |
-| `pioneer/gpt-4.1`                                       | 1.0M    |       |           |       |       |       | $2         | $8          |
-| `pioneer/gpt-4.1-mini`                                  | 1.0M    |       |           |       |       |       | $0.40      | $2          |
-| `pioneer/gpt-4.1-nano`                                  | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
-| `pioneer/gpt-4o`                                        | 128K    |       |           |       |       |       | $3         | $10         |
-| `pioneer/gpt-4o-mini`                                   | 128K    |       |           |       |       |       | $0.15      | $0.60       |
-| `pioneer/gpt-5-mini`                                    | 400K    |       |           |       |       |       | $0.25      | $2          |
-| `pioneer/gpt-5-nano`                                    | 400K    |       |           |       |       |       | $0.05      | $0.40       |
-| `pioneer/gpt-5.1`                                       | 400K    |       |           |       |       |       | $1         | $10         |
-| `pioneer/gpt-5.3-codex`                                 | 400K    |       |           |       |       |       | $2         | $14         |
-| `pioneer/gpt-5.4`                                       | 1.1M    |       |           |       |       |       | $3         | $15         |
-| `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/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-Instruct`              | 131K    |       |           |       |       |       | $0.10      | $0.20       |
-| `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/MiniMaxAI/MiniMax-M2.7`                        | 205K    |       |           |       |       |       | $0.28      | $1          |
-| `pioneer/MiniMaxAI/MiniMax-M3`                          | 1.0M    |       |           |       |       |       | $0.30      | $1          |
-| `pioneer/mistral-medium-3.5`                            | 262K    |       |           |       |       |       | $2         | $8          |
-| `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/moonshotai/Kimi-K2.6`                          | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `pioneer/moonshotai/Kimi-K2.7-Code`                     | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `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/Qwen/Qwen3-1.7B-Base`                          | 33K     |       |           |       |       |       | $0.10      | $0.10       |
-| `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       |
-| `pioneer/Qwen/Qwen3-8B`                                 | 131K    |       |           |       |       |       | $0.20      | $0.20       |
-| `pioneer/Qwen/Qwen3.5-9B`                               | 33K     |       |           |       |       |       | $0.30      | $0.30       |
-| `pioneer/Qwen/Qwen3.6-27B`                              | 33K     |       |           |       |       |       | $0.60      | $0.60       |
-| `pioneer/Qwen/Qwen3.6-35B-A3B`                          | 262K    |       |           |       |       |       | $0.14      | $1          |
-| `pioneer/qwen3.6-flash`                                 | 1.0M    |       |           |       |       |       | $0.19      | $1          |
-| `pioneer/qwen3.6-max-preview`                           | 262K    |       |           |       |       |       | $1         | $6          |
-| `pioneer/qwen3.6-plus`                                  | 1.0M    |       |           |       |       |       | $0.33      | $2          |
-| `pioneer/qwen3.7-max`                                   | 1.0M    |       |           |       |       |       | $1         | $4          |
-| `pioneer/qwen3.7-plus`                                  | 1.0M    |       |           |       |       |       | $0.32      | $1          |
-| `pioneer/sakana/fugu-ultra`                             | 1.0M    |       |           |       |       |       | $5         | $30         |
-| `pioneer/XiaomiMiMo/MiMo-V2.5`                          | 1.1M    |       |           |       |       |       | $0.14      | $0.28       |
-| `pioneer/XiaomiMiMo/MiMo-V2.5-Pro`                      | 1.1M    |       |           |       |       |       | $0.43      | $0.87       |
-| `pioneer/zai-org/GLM-5.1`                               | 203K    |       |           |       |       |       | $0.98      | $3          |
-| `pioneer/zai-org/GLM-5.2`                               | 1.0M    |       |           |       |       |       | $1         | $4          |
-
-## Advanced configuration
-
-### Custom headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.pioneer.ai/v1",
-    id: "pioneer/HuggingFaceTB/SmolLM3-3B-Base",
-    apiKey: process.env.PIONEER_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
-      ? "pioneer/zai-org/GLM-5.2"
-      : "pioneer/HuggingFaceTB/SmolLM3-3B-Base";
-  }
-});
-```

package/.docs/models/providers/unorouter.md

@@ -1,95 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# ![UnoRouter logo](https://models.dev/logos/unorouter.svg)UnoRouter
-
-Access 23 UnoRouter models through Mastra's model router. Authentication is handled automatically using the `UNOROUTER_API_KEY` environment variable.
-
-Learn more in the [UnoRouter documentation](https://unorouter.com/models).
-
-```bash
-UNOROUTER_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: "unorouter/claude-haiku-4-5-20251001"
-});
-
-// 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 [UnoRouter documentation](https://unorouter.com/models) for details.
-
-## Models
-
-| Model                                       | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `unorouter/claude-haiku-4-5-20251001`       | 200K    |       |           |       |       |       | $1         | $6          |
-| `unorouter/claude-opus-4-8`                 | 1.0M    |       |           |       |       |       | $0.42      | $2          |
-| `unorouter/claude-sonnet-5`                 | 1.0M    |       |           |       |       |       | $1         | $7          |
-| `unorouter/deepseek-v4-flash`               | 1.0M    |       |           |       |       |       | $0.06      | $0.13       |
-| `unorouter/deepseek-v4-flash:free`          | 1.0M    |       |           |       |       |       | —          | —           |
-| `unorouter/deepseek-v4-pro`                 | 1.0M    |       |           |       |       |       | $0.90      | $2          |
-| `unorouter/deepseek-v4-pro:free`            | 1.0M    |       |           |       |       |       | —          | —           |
-| `unorouter/gemini-3.5-flash`                | 1.0M    |       |           |       |       |       | $0.19      | $1          |
-| `unorouter/gemma-4-31b-it:free`             | 262K    |       |           |       |       |       | —          | —           |
-| `unorouter/glm-4.5-flash:free`              | 131K    |       |           |       |       |       | —          | —           |
-| `unorouter/glm-5.2`                         | 1.0M    |       |           |       |       |       | $2         | $5          |
-| `unorouter/glm-5.2:free`                    | 1.0M    |       |           |       |       |       | —          | —           |
-| `unorouter/gpt-5.2`                         | 400K    |       |           |       |       |       | $1         | $8          |
-| `unorouter/gpt-5.4`                         | 1.1M    |       |           |       |       |       | $2         | $11         |
-| `unorouter/gpt-5.4:free`                    | 1.1M    |       |           |       |       |       | —          | —           |
-| `unorouter/gpt-5.5`                         | 1.1M    |       |           |       |       |       | $0.19      | $1          |
-| `unorouter/gpt-5.5:free`                    | 1.1M    |       |           |       |       |       | —          | —           |
-| `unorouter/kimi-k2.6`                       | 262K    |       |           |       |       |       | $1         | $5          |
-| `unorouter/minimax-m2.7`                    | 205K    |       |           |       |       |       | $0.82      | $3          |
-| `unorouter/minimax-m2.7:free`               | 205K    |       |           |       |       |       | —          | —           |
-| `unorouter/nemotron-3-ultra-550b-a55b:free` | 1.0M    |       |           |       |       |       | —          | —           |
-| `unorouter/qwen3.5-397b-a17b:free`          | 262K    |       |           |       |       |       | —          | —           |
-| `unorouter/step-3.7-flash:free`             | 256K    |       |           |       |       |       | —          | —           |
-
-## Advanced configuration
-
-### Custom headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "https://api.unorouter.com/v1",
-    id: "unorouter/claude-haiku-4-5-20251001",
-    apiKey: process.env.UNOROUTER_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
-      ? "unorouter/step-3.7-flash:free"
-      : "unorouter/claude-haiku-4-5-20251001";
-  }
-});
-```

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

@@ -1,97 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# config.ts
-
-An agent's `config.ts` sets its model and runtime options. Use it for options that belong to the [`Agent`](https://mastra.ai/reference/agents/agent) itself, while sibling files provide instructions, tools, skills, et cetera.
-
-## What belongs in `config.ts`
-
-`config.ts` is the required entry point for a file-based agent's model and runtime options. Put agent-level settings here when they don't need their own file, such as the model, description, default execution options, retry behavior, scorers, and display identity.
-
-Keep adjacent concerns in sibling files when you want file-based routing to merge them into the agent. For example, use `instructions.md` for the always-on prompt and `tools/` for model-callable actions.
-
-## Quickstart
-
-The following `config.ts` plus an `instructions.md` file creates a working file-based agent:
-
-```typescript
-import { agentConfig } from '@mastra/core/agent'
-
-export default agentConfig({
-  model: 'openai/gpt-5.5',
-})
-```
-
-```markdown
-You are a helpful weather assistant. Answer questions about current conditions and forecasts.
-```
-
-Mastra uses the `weather` directory name as the default agent `id` and `name`. The sibling `instructions.md` supplies the required instructions.
-
-## Set the model
-
-The `model` field is the only required field in `agentConfig()`. The build fails when an agent directory doesn't provide a model. Other capabilities either come from sibling files or have defaults.
-
-```typescript
-import { agentConfig } from '@mastra/core/agent'
-
-export default agentConfig({
-  model: 'openai/gpt-5.5',
-})
-```
-
-## Identity from the directory
-
-A file-based agent's `id` and `name` default to the directory name. For `src/mastra/agents/weather/`, Mastra registers the agent as `weather` unless you override those fields.
-
-Override `id` or `name` when the stable routing key and the display name should differ.
-
-```typescript
-import { agentConfig } from '@mastra/core/agent'
-
-export default agentConfig({
-  id: 'weather-assistant',
-  name: 'Weather Assistant',
-  model: 'openai/gpt-5.5',
-})
-```
-
-## Set runtime options
-
-`agentConfig()` accepts [`Agent` constructor options](https://mastra.ai/reference/agents/agent), except that `id`, `name`, and sibling-file fields can be supplied by the file-based convention. Use the Agent reference for the full option list.
-
-Please note:
-
-- File-based subagents require a non-empty `description` because the parent model uses it for delegation routing.
-- `defaultOptions`, `maxRetries`, `scorers`, and other Agent options can live in `config.ts` when they don't need their own file.
-
-## Where adjacent settings live
-
-Keep `config.ts` focused on runtime options. Use sibling files for concerns that benefit from their own location.
-
-| Setting      | File or folder                                                                  | Why it lives there                                                   |
-| ------------ | ------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| Instructions | [`instructions.md`](https://mastra.ai/reference/file-based-agents/instructions) | Keeps the always-on prompt readable as markdown                      |
-| Tools        | [`tools/`](https://mastra.ai/reference/file-based-agents/tools)                 | Gives each callable action its own typed module                      |
-| Skills       | [`skills/`](https://mastra.ai/reference/file-based-agents/skills)               | Keeps load-on-demand procedures separate from always-on instructions |
-| Memory       | [`memory.ts`](https://mastra.ai/reference/file-based-agents/memory)             | Configures persistent memory without crowding runtime options        |
-| Workspace    | [`workspace.ts`](https://mastra.ai/reference/file-based-agents/workspace)       | Configures files and sandbox behavior separately from model settings |
-| Processors   | [`processors/`](https://mastra.ai/reference/file-based-agents/processors)       | Separates input and output processing pipelines                      |
-| Subagents    | [`subagents/`](https://mastra.ai/reference/file-based-agents/subagents)         | Gives each specialist child agent its own directory                  |
-
-## Precedence
-
-`config.ts` merges with the agent's other files according to these rules:
-
-| Domain       | Source A                      | Source B                                                                        | Winner                                                  |
-| ------------ | ----------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------- |
-| Instructions | Dynamic `config.instructions` | [`instructions.md`](https://mastra.ai/reference/file-based-agents/instructions) | Dynamic `config.instructions`                           |
-| Instructions | Static `config.instructions`  | [`instructions.md`](https://mastra.ai/reference/file-based-agents/instructions) | `instructions.md`                                       |
-| Tools        | `config.tools`                | [`tools/`](https://mastra.ai/reference/file-based-agents/tools)                 | Both merge; `config.tools` wins on key collisions       |
-| Tools        | Function `config.tools`       | [`tools/`](https://mastra.ai/reference/file-based-agents/tools)                 | Function `config.tools`; discovered tools are ignored   |
-| Skills       | `config.skills`               | [`skills/`](https://mastra.ai/reference/file-based-agents/skills)               | Both merge; `config.skills` wins on name collisions     |
-| Skills       | Function `config.skills`      | [`skills/`](https://mastra.ai/reference/file-based-agents/skills)               | Function `config.skills`; discovered skills are ignored |
-| Memory       | `config.memory`               | [`memory.ts`](https://mastra.ai/reference/file-based-agents/memory)             | `config.memory`                                         |
-| Workspace    | `config.workspace`            | [`workspace.ts`](https://mastra.ai/reference/file-based-agents/workspace)       | `config.workspace`                                      |
-
-Missing both `instructions.md` and `config.instructions` fails the build. Missing both `config.memory` and `memory.ts` leaves the agent without memory.

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

@@ -1,54 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Instructions
-
-An agent's `instructions.md` holds its always-on system prompt: the model reads it on every turn. Use it to define the agent's identity, tone, role, and standing rules.
-
-Instructions are always in context, so keep them for stable behavior that applies to every request. Move anything conditional, large, or action-oriented out of `instructions.md` and into [`tools/`](https://mastra.ai/reference/file-based-agents/tools) or [`skills/`](https://mastra.ai/reference/file-based-agents/skills), which the model uses only when relevant.
-
-## Quickstart
-
-Add an `instructions.md` at the agent root. Whatever you write becomes the prompt, so the shortest version is a single sentence.
-
-```markdown
-You are a helpful weather assistant. Answer questions about current conditions and forecasts.
-```
-
-## What goes in instructions
-
-Effective instructions cover the parts of an agent's behavior that don't change between requests:
-
-- Role and identity
-- Tone and style
-- Standing rules
-- Output format
-
-Move conditional, large, or action-oriented guidance into [`tools/`](https://mastra.ai/reference/file-based-agents/tools) or [`skills/`](https://mastra.ai/reference/file-based-agents/skills), which the model uses only when relevant.
-
-## Dynamic instructions
-
-When the prompt needs to change per request, for example based on the current user or runtime context, set a dynamic `instructions` function in [`config.ts`](https://mastra.ai/reference/file-based-agents/config) instead of using `instructions.md`. A function `instructions` wins over `instructions.md`, so the static file is ignored when both are present.
-
-```typescript
-import { agentConfig } from '@mastra/core/agent'
-
-export default agentConfig({
-  model: 'openai/gpt-5.5',
-  instructions: ({ runtimeContext }) => {
-    const tier = runtimeContext.get('tier') ?? 'standard'
-    return `You are a support agent. Treat this as a ${tier}-tier customer.`
-  },
-})
-```
-
-## Build-time behavior
-
-Mastra reads `instructions.md` and inlines its contents into the generated code when the bundler builds your project. The deployed agent doesn't read the file at runtime, so changes to `instructions.md` take effect only after the next build.
-
-## Precedence with config
-
-Instructions can come from `instructions.md` or from the `instructions` field in [`config.ts`](https://mastra.ai/reference/file-based-agents/config):
-
-- A dynamic (function) `instructions` in `config.ts` wins over `instructions.md`.
-- Otherwise `instructions.md` wins over a static `instructions` string.
-- If neither is present, the build fails and names the agent directory.

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

@@ -1,26 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# Logger
-
-Mastra sets the project's [logger](https://mastra.ai/docs/observability/logging) from a `logger.ts` file directly under `src/mastra/`. The file default-exports a logger, which replaces the built-in `ConsoleLogger` used across agents, workflows, and other components.
-
-Use this page for the file-based convention. For log levels, transports, and provider details, see [logging](https://mastra.ai/docs/observability/logging).
-
-## Quickstart
-
-Create `src/mastra/logger.ts` and default-export a logger, such as [`PinoLogger`](https://mastra.ai/reference/logging/pino-logger):
-
-```typescript
-import { PinoLogger } from '@mastra/loggers'
-
-export default new PinoLogger({
-  name: 'Mastra',
-  level: 'info',
-})
-```
-
-Mastra registers the logger before storage, observability, and file-based agents, so those primitives log through this logger as they are wired up.
-
-## Precedence with code
-
-Code-registered logging wins over `logger.ts`. If you pass `logger` to `new Mastra({ logger })` in `src/mastra/index.ts` (or set `logger: false` to disable logging), `logger.ts` is ignored with a warning. Use `logger.ts` when one project-wide logger is enough; use code registration when setup depends on runtime wiring.