@mastra/mcp-docs-server 1.1.40-alpha.3 → 1.1.40-alpha.7

package/.docs/docs/agents/guardrails.md

@@ -246,7 +246,7 @@ costGuard.onViolation = ({ processorId, message, detail }) => {
 
 // Log moderation violations
 const moderation = new ModerationProcessor({
-  model: 'openai/gpt-5-nano',
+  model: '__OPENAI_MODEL_NANO__',
   strategy: 'block',
 })
 
@@ -360,7 +360,7 @@ See [workflows as processors](https://mastra.ai/docs/agents/processors) for more
 Guardrail processors don't need your primary model. Use a small, fast model for classification tasks:
 
 ```typescript
-const GUARDRAIL_MODEL = 'openai/gpt-5-nano'
+const GUARDRAIL_MODEL = '__OPENAI_MODEL_NANO__'
 
 new ModerationProcessor({ model: GUARDRAIL_MODEL })
 new PIIDetector({ model: GUARDRAIL_MODEL })

package/.docs/docs/agents/processors.md

@@ -97,9 +97,9 @@ const agent = new Agent({
   instructions: '...',
   inputProcessors: [
     new TokenLimiter(4000),
-    new ModerationProcessor({ model: 'openai/gpt-4.1-nano' }),
+    new ModerationProcessor({ model: 'openai/gpt-5-nano' }),
   ],
-  outputProcessors: [new ModerationProcessor({ model: 'openai/gpt-4.1-nano' })],
+  outputProcessors: [new ModerationProcessor({ model: 'openai/gpt-5-nano' })],
   errorProcessors: [new PrefillErrorHandler()],
 })
 ```

package/.docs/docs/agents/signals.md

@@ -141,6 +141,44 @@ The model receives the custom signal as context like this:
 
 Use XML-safe signal type names and attribute names. Signal type names and attribute names can contain letters, numbers, underscores, periods, and hyphens. They must start with a letter or underscore.
 
+## Delivery attributes
+
+Use `ifActive.attributes` and `ifIdle.attributes` to tag a signal with context that depends on whether the agent is active or idle at delivery time. Mastra resolves the correct branch when the signal is accepted.
+
+```typescript
+agent.sendSignal(
+  {
+    type: 'user-message',
+    contents: 'Also cover the edge cases.',
+    attributes: { source: 'chat' },
+  },
+  {
+    resourceId: 'user_123',
+    threadId: 'thread_456',
+    ifActive: { attributes: { delivery: 'while-active' } },
+    ifIdle: { attributes: { delivery: 'message' } },
+  },
+)
+```
+
+When the agent is working, the model sees:
+
+```xml
+<user-message source="chat" delivery="while-active">Also cover the edge cases.</user-message>
+```
+
+When the agent is idle:
+
+```xml
+<user-message source="chat" delivery="message">Also cover the edge cases.</user-message>
+```
+
+Top-level `attributes` always apply. The selected branch's `attributes` are merged into them at delivery time. The `ifActive.attributes` branch merges when the signal is delivered to a running agent loop. The `ifIdle.attributes` branch merges when the signal wakes an idle thread. If the selected branch or its `attributes` field is `undefined`, no extra attributes are added.
+
+Delivery attributes work with any signal type and can carry any key-value pairs. The `delivery` name shown above is not a special Mastra API field. It is a custom attribute name used for this example; you can use any attribute names that fit your application.
+
+> **Note:** Visit [Agent.sendSignal() reference](https://mastra.ai/reference/agents/agent) for the full signal input and options types.
+
 ## Use the client SDK
 
 The JavaScript client exposes the same thread signal APIs. Use `subscribeToThread()` before `sendSignal()` so the client can render the stream that wakes from, or receives, the signal.

package/.docs/docs/evals/datasets/running-experiments.md

@@ -104,7 +104,7 @@ const summary = await dataset.startExperiment({
 ```typescript
 import { createAnswerRelevancyScorer } from '@mastra/evals/scorers/prebuilt'
 
-const relevancy = createAnswerRelevancyScorer({ model: 'openai/gpt-5-mini' })
+const relevancy = createAnswerRelevancyScorer({ model: '__OPENAI_MODEL_MINI__' })
 
 const summary = await dataset.startExperiment({
   name: 'with-scorer-instances',

package/.docs/docs/evals/overview.md

@@ -57,11 +57,11 @@ import { createAnswerRelevancyScorer, createToxicityScorer } from '@mastra/evals
 export const evaluatedAgent = new Agent({
   scorers: {
     relevancy: {
-      scorer: createAnswerRelevancyScorer({ model: 'openai/gpt-5-mini' }),
+      scorer: createAnswerRelevancyScorer({ model: '__OPENAI_MODEL_MINI__' }),
       sampling: { type: 'ratio', rate: 0.5 },
     },
     safety: {
-      scorer: createToxicityScorer({ model: 'openai/gpt-5-mini' }),
+      scorer: createToxicityScorer({ model: '__OPENAI_MODEL_MINI__' }),
       sampling: { type: 'ratio', rate: 1 },
     },
   },

package/.docs/docs/mcp/mcp-apps.md

@@ -93,7 +93,7 @@ export const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
   instructions: 'You have access to interactive UI tools.',
-  model: 'openai/gpt-5-mini',
+  model: '__OPENAI_MODEL_MINI__',
   tools: { calculatorTool },
 })
 ```
@@ -125,7 +125,7 @@ const mcpClient = new MCPClient({
 const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
-  model: 'openai/gpt-5-mini',
+  model: '__OPENAI_MODEL_MINI__',
   tools: await mcpClient.listTools(),
 })
 
@@ -270,7 +270,7 @@ const mcpClient = new MCPClient({
 const myAgent = new Agent({
   id: 'my-agent',
   name: 'My Agent',
-  model: 'openai/gpt-5-mini',
+  model: '__OPENAI_MODEL_MINI__',
   tools: await mcpClient.listTools(),
 })
 

package/.docs/docs/memory/multi-user-threads.md

@@ -65,7 +65,7 @@ const memory = new Memory({
 export const collabAgent = new Agent({
   id: 'collab',
   name: 'CollabAgent',
-  model: 'openai/gpt-5.4-mini',
+  model: '__OPENAI_MODEL_MINI__',
   memory,
   instructions: `
 You are a collaborative document assistant. Multiple users talk to you in the SAME thread.

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

@@ -316,7 +316,7 @@ const memory = new Memory({
             // Faster, cheaper models for smaller inputs; stronger models for larger contexts
             5_000: 'openrouter/mistralai/ministral-8b-2512',
             20_000: 'openrouter/mistralai/mistral-small-2603',
-            40_000: 'openai/gpt-5.4-mini',
+            40_000: 'openai/gpt-5-mini',
             1_000_000: 'google/gemini-3.1-flash-lite-preview',
           },
         }),
@@ -324,7 +324,7 @@ const memory = new Memory({
       reflection: {
         model: new ModelByInputTokens({
           upTo: {
-            20_000: 'openai/gpt-5.4-mini',
+            20_000: 'openai/gpt-5-mini',
             100_000: 'google/gemini-2.5-flash',
           },
         }),

package/.docs/docs/memory/storage.md

@@ -179,7 +179,7 @@ export const agent = new Agent({
   memory: new Memory({
     options: {
       generateTitle: {
-        model: 'openai/gpt-5-mini',
+        model: '__OPENAI_MODEL_MINI__',
         instructions: 'Generate a 1 word title',
       },
     },

package/.docs/docs/rag/retrieval.md

@@ -472,7 +472,10 @@ const initialResults = await pgVector.query({
 })
 
 // Create a relevance scorer
-const relevanceProvider = new MastraAgentRelevanceScorer('relevance-scorer', 'openai/gpt-5.4')
+const relevanceProvider = new MastraAgentRelevanceScorer(
+  'relevance-scorer',
+  'openai/gpt-5.4',
+)
 
 // Re-rank the results
 const rerankedResults = await rerank({

package/.docs/docs/workspace/filesystem.md

@@ -115,7 +115,7 @@ const workspace = new Workspace({
 
 const agent = new Agent({
   id: 'multi-role-agent',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   workspace,
 })
 ```

package/.docs/models/gateways/openrouter.md

@@ -72,7 +72,6 @@ ANTHROPIC_API_KEY=ant-...
 | `arcee-ai/coder-large`                                          |
 | `arcee-ai/maestro-reasoning`                                    |
 | `arcee-ai/spotlight`                                            |
-| `arcee-ai/trinity-large-preview`                                |
 | `arcee-ai/trinity-large-thinking`                               |
 | `arcee-ai/trinity-large-thinking:free`                          |
 | `arcee-ai/trinity-mini`                                         |
@@ -350,6 +349,7 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3.6-flash`                                            |
 | `qwen/qwen3.6-max-preview`                                      |
 | `qwen/qwen3.6-plus`                                             |
+| `qwen/qwen3.7-max`                                              |
 | `rekaai/reka-edge`                                              |
 | `rekaai/reka-flash-3`                                           |
 | `relace/relace-apply-3`                                         |

package/.docs/models/gateways/vercel.md

@@ -1,6 +1,6 @@
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 239 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 243 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -59,6 +59,7 @@ ANTHROPIC_API_KEY=ant-...
 | `alibaba/qwen3.5-plus`                         |
 | `alibaba/qwen3.6-27b`                          |
 | `alibaba/qwen3.6-plus`                         |
+| `alibaba/qwen3.7-max`                          |
 | `amazon/nova-2-lite`                           |
 | `amazon/nova-lite`                             |
 | `amazon/nova-micro`                            |
@@ -116,6 +117,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.1-flash-lite`                 |
 | `google/gemini-3.1-flash-lite-preview`         |
 | `google/gemini-3.1-pro-preview`                |
+| `google/gemini-3.5-flash`                      |
 | `google/gemini-embedding-001`                  |
 | `google/gemini-embedding-2`                    |
 | `google/gemma-4-26b-a4b-it`                    |
@@ -163,6 +165,7 @@ ANTHROPIC_API_KEY=ant-...
 | `mistral/mistral-embed`                        |
 | `mistral/mistral-large-3`                      |
 | `mistral/mistral-medium`                       |
+| `mistral/mistral-medium-3.5`                   |
 | `mistral/mistral-nemo`                         |
 | `mistral/mistral-small`                        |
 | `mistral/mixtral-8x22b-instruct`               |
@@ -254,6 +257,7 @@ ANTHROPIC_API_KEY=ant-...
 | `xai/grok-4.20-reasoning`                      |
 | `xai/grok-4.20-reasoning-beta`                 |
 | `xai/grok-4.3`                                 |
+| `xai/grok-build-0.1`                           |
 | `xai/grok-imagine-image`                       |
 | `xai/grok-imagine-image-pro`                   |
 | `xiaomi/mimo-v2-flash`                         |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4209 models from 122 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4243 models from 124 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/alibaba.md

@@ -1,6 +1,6 @@
 # ![Alibaba logo](https://models.dev/logos/alibaba.svg)Alibaba
 
-Access 48 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
+Access 49 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
 
 Learn more in the [Alibaba documentation](https://www.alibabacloud.com/help/en/model-studio/models).
 
@@ -81,6 +81,7 @@ for await (const chunk of stream) {
 | `alibaba/qwen3.6-35b-a3b`                    | 262K    |       |           |       |       |       | $0.25      | $1          |
 | `alibaba/qwen3.6-max-preview`                | 262K    |       |           |       |       |       | $1         | $8          |
 | `alibaba/qwen3.6-plus`                       | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `alibaba/qwen3.7-max`                        | 1.0M    |       |           |       |       |       | $3         | $8          |
 | `alibaba/qwq-plus`                           | 131K    |       |           |       |       |       | $0.80      | $2          |
 
 ## Advanced configuration

package/.docs/models/providers/crof.md

@@ -0,0 +1,91 @@
+# ![CrofAI logo](https://models.dev/logos/crof.svg)CrofAI
+
+Access 21 CrofAI models through Mastra's model router. Authentication is handled automatically using the `CROF_API_KEY` environment variable.
+
+Learn more in the [CrofAI documentation](https://crof.ai/docs).
+
+```bash
+CROF_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: "crof/deepseek-v3.2"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [CrofAI documentation](https://crof.ai/docs) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `crof/deepseek-v3.2`             | 164K    |       |           |       |       |       | $0.28      | $0.38       |
+| `crof/deepseek-v4-flash`         | 1.0M    |       |           |       |       |       | $0.12      | $0.21       |
+| `crof/deepseek-v4-pro`           | 1.0M    |       |           |       |       |       | $0.40      | $0.85       |
+| `crof/deepseek-v4-pro-precision` | 1.0M    |       |           |       |       |       | $1         | $3          |
+| `crof/gemma-4-31b-it`            | 262K    |       |           |       |       |       | $0.10      | $0.30       |
+| `crof/glm-4.7`                   | 203K    |       |           |       |       |       | $0.25      | $1          |
+| `crof/glm-4.7-flash`             | 200K    |       |           |       |       |       | $0.04      | $0.30       |
+| `crof/glm-5`                     | 203K    |       |           |       |       |       | $0.48      | $2          |
+| `crof/glm-5.1`                   | 203K    |       |           |       |       |       | $0.45      | $2          |
+| `crof/glm-5.1-precision`         | 203K    |       |           |       |       |       | $0.75      | $3          |
+| `crof/greg`                      | 229K    |       |           |       |       |       | $0.10      | $0.20       |
+| `crof/kimi-k2.5`                 | 262K    |       |           |       |       |       | $0.35      | $2          |
+| `crof/kimi-k2.5-lightning`       | 131K    |       |           |       |       |       | $1         | $3          |
+| `crof/kimi-k2.6`                 | 262K    |       |           |       |       |       | $0.50      | $2          |
+| `crof/kimi-k2.6-precision`       | 262K    |       |           |       |       |       | $0.55      | $3          |
+| `crof/mimo-v2.5-pro`             | 1.0M    |       |           |       |       |       | $0.50      | $2          |
+| `crof/mimo-v2.5-pro-precision`   | 1.0M    |       |           |       |       |       | $0.80      | $3          |
+| `crof/minimax-m2.5`              | 205K    |       |           |       |       |       | $0.11      | $0.95       |
+| `crof/qwen3.5-397b-a17b`         | 262K    |       |           |       |       |       | $0.35      | $2          |
+| `crof/qwen3.5-9b`                | 262K    |       |           |       |       |       | $0.04      | $0.15       |
+| `crof/qwen3.6-27b`               | 262K    |       |           |       |       |       | $0.20      | $2          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://crof.ai/v1",
+    id: "crof/deepseek-v3.2",
+    apiKey: process.env.CROF_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
+      ? "crof/qwen3.6-27b"
+      : "crof/deepseek-v3.2";
+  }
+});
+```

package/.docs/models/providers/inceptron.md

@@ -0,0 +1,74 @@
+# ![Inceptron logo](https://models.dev/logos/inceptron.svg)Inceptron
+
+Access 4 Inceptron models through Mastra's model router. Authentication is handled automatically using the `INCEPTRON_API_KEY` environment variable.
+
+Learn more in the [Inceptron documentation](https://docs.inceptron.io).
+
+```bash
+INCEPTRON_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: "inceptron/MiniMaxAI/MiniMax-M2.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 [Inceptron documentation](https://docs.inceptron.io) for details.
+
+## Models
+
+| Model                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `inceptron/MiniMaxAI/MiniMax-M2.5`            | 197K    |       |           |       |       |       | $0.24      | $0.90       |
+| `inceptron/moonshotai/Kimi-K2.6`              | 262K    |       |           |       |       |       | $0.78      | $4          |
+| `inceptron/nvidia/llama-3.3-70b-instruct-fp8` | 131K    |       |           |       |       |       | $0.12      | $0.38       |
+| `inceptron/zai-org/GLM-5.1-FP8`               | 203K    |       |           |       |       |       | $1         | $4          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.inceptron.io/v1",
+    id: "inceptron/MiniMaxAI/MiniMax-M2.5",
+    apiKey: process.env.INCEPTRON_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
+      ? "inceptron/zai-org/GLM-5.1-FP8"
+      : "inceptron/MiniMaxAI/MiniMax-M2.5";
+  }
+});
+```

package/.docs/models/providers/llmgateway.md

@@ -1,6 +1,6 @@
 # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
 
-Access 183 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
+Access 187 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
 
 Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
 
@@ -68,6 +68,7 @@ for await (const chunk of stream) {
 | `llmgateway/gemini-3.1-flash-lite`             | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/gemini-3.1-flash-lite-preview`     | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/gemini-3.1-pro-preview`            | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `llmgateway/gemini-3.5-flash`                  | 1.0M    |       |           |       |       |       | $2         | $9          |
 | `llmgateway/gemini-pro-latest`                 | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `llmgateway/gemma-2-27b-it-together`           | 8K      |       |           |       |       |       | $0.08      | $0.08       |
 | `llmgateway/gemma-3-1b-it`                     | 1.0M    |       |           |       |       |       | $0.08      | $0.30       |
@@ -124,6 +125,8 @@ for await (const chunk of stream) {
 | `llmgateway/grok-4-1-fast-reasoning`           | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `llmgateway/grok-4-20-beta-0309-non-reasoning` | 2.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-20-beta-0309-reasoning`     | 2.0M    |       |           |       |       |       | $1         | $3          |
+| `llmgateway/grok-4-20-non-reasoning`           | 2.0M    |       |           |       |       |       | $1         | $3          |
+| `llmgateway/grok-4-20-reasoning`               | 2.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-3`                          | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-fast-reasoning`             | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `llmgateway/hermes-2-pro-llama-3-8b`           | 8K      |       |           |       |       |       | $0.14      | $0.14       |
@@ -209,6 +212,7 @@ for await (const chunk of stream) {
 | `llmgateway/qwen3.6-max-preview`               | 262K    |       |           |       |       |       | $1         | $8          |
 | `llmgateway/qwen3.6-plus`                      | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `llmgateway/qwen35-397b-a17b`                  | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `llmgateway/qwen37-max`                        | 1.0M    |       |           |       |       |       | $3         | $8          |
 | `llmgateway/qwq-plus`                          | 131K    |       |           |       |       |       | $0.80      | $2          |
 | `llmgateway/seed-1-6-250615`                   | 256K    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/seed-1-6-250915`                   | 256K    |       |           |       |       |       | $0.25      | $2          |

package/.docs/models/providers.md

@@ -29,6 +29,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)
 - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
+- [CrofAI](https://mastra.ai/models/providers/crof)
 - [D.Run (China)](https://mastra.ai/models/providers/drun)
 - [Databricks](https://mastra.ai/models/providers/databricks)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
@@ -47,6 +48,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Hugging Face](https://mastra.ai/models/providers/huggingface)
 - [iFlow](https://mastra.ai/models/providers/iflowcn)
 - [Inception](https://mastra.ai/models/providers/inception)
+- [Inceptron](https://mastra.ai/models/providers/inceptron)
 - [Inference](https://mastra.ai/models/providers/inference)
 - [IO.NET](https://mastra.ai/models/providers/io-net)
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)

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

@@ -39,7 +39,7 @@ Use stagehand_extract to get data from pages.`,
 
 **projectId** (`string`): Browserbase project ID. Required when env is 'BROWSERBASE'.
 
-**model** (`string | ModelConfiguration`): Model configuration for AI operations. Can be a string like 'openai/gpt-5.4' or an object with modelName, apiKey, and baseURL. (Default: `'openai/gpt-5.4'`)
+**model** (`string | ModelConfiguration`): Model configuration for AI operations. Can be a string like '\_\_GATEWAY\_OPENAI\_MODEL\_\_' or an object with modelName, apiKey, and baseURL. (Default: `'openai/gpt-5.4'`)
 
 **selfHeal** (`boolean`): Enable self-healing selectors. When enabled, Stagehand uses AI to find elements even when initial selectors fail. (Default: `true`)
 

package/.docs/reference/evals/noise-sensitivity.md

@@ -547,7 +547,7 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 async function compareModelRobustness() {
   const models = [
     { name: 'GPT-5.4', model: 'openai/gpt-5.4' },
-    { name: 'GPT-5.4-mini', model: 'openai/gpt-5.4-mini' },
+    { name: 'GPT-5.4-mini', model: 'openai/gpt-5-mini' },
     { name: 'Claude', model: 'anthropic/claude-opus-4-6' },
   ]
 

package/.docs/reference/harness/harness-class.md

@@ -656,7 +656,7 @@ const modelId = harness.getReflectorModelId()
 Switch the observer model. Persists the setting to thread metadata and emits an `om_model_changed` event.
 
 ```typescript
-await harness.switchObserverModel({ modelId: 'anthropic/claude-haiku-3.5' })
+await harness.switchObserverModel({ modelId: 'anthropic/claude-haiku-4-5' })
 ```
 
 #### `switchReflectorModel({ modelId })`
@@ -664,7 +664,7 @@ await harness.switchObserverModel({ modelId: 'anthropic/claude-haiku-3.5' })
 Switch the reflector model. Persists the setting to thread metadata and emits an `om_model_changed` event.
 
 ```typescript
-await harness.switchReflectorModel({ modelId: 'anthropic/claude-haiku-3.5' })
+await harness.switchReflectorModel({ modelId: 'anthropic/claude-haiku-4-5' })
 ```
 
 #### `getObservationThreshold()`
@@ -702,7 +702,10 @@ Set the subagent model ID. Pass an `agentType` to set a per-type override, or om
 await harness.setSubagentModelId({ modelId: 'anthropic/claude-sonnet-4-6' })
 
 // Set per-type model
-await harness.setSubagentModelId({ modelId: 'anthropic/claude-haiku-3.5', agentType: 'explore' })
+await harness.setSubagentModelId({
+  modelId: 'anthropic/claude-haiku-4-5',
+  agentType: 'explore',
+})
 ```
 
 ### Forked subagents

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

@@ -674,7 +674,7 @@ import { ModelByInputTokens } from '@mastra/memory'
 const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
-    40_000: 'openai/gpt-5.4-mini', // Stronger for medium inputs
+    40_000: 'openai/gpt-5-mini', // Stronger for medium inputs
     1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
   },
 })

package/.docs/reference/observability/tracing/exporters/sentry.md

@@ -146,6 +146,7 @@ The exporter sets these standard OpenTelemetry attributes:
 
 - `sentry.origin`: `auto.ai.mastra` (identifies spans from Mastra)
 - `ai.span.type`: Mastra span type
+- `gen_ai.conversation.id`: Chat thread identifier, set from `metadata.threadId` to group spans in Sentry's Conversations view
 
 **MODEL\_GENERATION spans:**
 

package/.docs/reference/processors/cost-guard-processor.md

@@ -56,7 +56,7 @@ costGuard.onViolation = ({ detail }) => {
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-5-nano',
+  model: '__OPENAI_MODEL_NANO__',
   processors: {
     input: [costGuard],
   },

package/.docs/reference/processors/processor-interface.md

@@ -318,7 +318,7 @@ processInputStep?<TTripwireMetadata = unknown>(
 
 The object form can return any combination of these properties:
 
-**model** (`LanguageModelV2 | string`): Change the model for this step. Can be a model instance or router ID like 'openai/gpt-5.4'.
+**model** (`LanguageModelV2 | string`): Change the model for this step. Can be a model instance or router ID like '\_\_GATEWAY\_OPENAI\_MODEL\_\_'.
 
 **toolChoice** (`ToolChoice`): Change tool selection behavior for this step.
 

package/.docs/reference/processors/regex-filter-processor.md

@@ -49,7 +49,7 @@ import { RegexFilterProcessor } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-5-nano',
+  model: '__OPENAI_MODEL_NANO__',
   processors: {
     input: [
       new RegexFilterProcessor({

package/.docs/reference/processors/skill-search-processor.md

@@ -74,7 +74,7 @@ const agent = new Agent({
   name: 'skill-agent',
   instructions:
     'You are a helpful assistant. Use search_skills to find relevant skills, then load_skill to load their instructions.',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   workspace,
   inputProcessors: [skillSearch],
 })

package/.docs/reference/server/nestjs-adapter.md

@@ -114,7 +114,7 @@ import { Mastra } from '@mastra/core/mastra'
             greeter: {
               name: 'greeter',
               description: 'Greets the user',
-              model: config.get('MASTRA_MODEL', 'openai/gpt-4o-mini'),
+              model: config.get('MASTRA_MODEL', '__OPENAI_MODEL_MINI__'),
             },
           },
         }),

package/.docs/reference/storage/dsql.md

@@ -241,7 +241,7 @@ export const dsqlAgent = new Agent({
   name: 'DSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.1',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new DSQLStore({
       id: 'dsql-agent-storage',

package/.docs/reference/storage/redis.md

@@ -181,7 +181,7 @@ export const redisAgent = new Agent({
   name: 'Redis Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-4o',
+  model: 'openai/gpt-5.4',
   memory: new Memory({
     storage: new RedisStore({
       id: 'redis-agent-storage',

package/.docs/reference/workspace/google-drive-filesystem.md

@@ -49,7 +49,7 @@ const workspace = new Workspace({
 const agent = new Agent({
   id: 'drive-agent',
   name: 'Drive Agent',
-  model: 'openai/gpt-4o-mini',
+  model: '__OPENAI_MODEL_MINI__',
   workspace,
 })
 ```

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.1.40-alpha.6
+
+### Patch Changes
+
+- Updated dependencies [[`ac442a4`](https://github.com/mastra-ai/mastra/commit/ac442a42fda0354ac2bcea772bf6691cb3e9dbb3), [`1e5c067`](https://github.com/mastra-ai/mastra/commit/1e5c067d2e20a781af670578180d1ee249806d41), [`008baaf`](https://github.com/mastra-ai/mastra/commit/008baafd8d851f831407045aebead5a2e3342eff), [`8116436`](https://github.com/mastra-ai/mastra/commit/81164363eb225d774e41ff27da6a5ea611406688), [`c27c4b9`](https://github.com/mastra-ai/mastra/commit/c27c4b9f137df5414fca4e45896aceccff6b0ed5), [`08b3b59`](https://github.com/mastra-ai/mastra/commit/08b3b590dd960dee6c9a6e39272f8927d803db6e)]:
+  - @mastra/core@1.37.0-alpha.3
+
+## 1.1.40-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`df1947a`](https://github.com/mastra-ai/mastra/commit/df1947affa40f742067542251fac7ca759492ef4), [`ee59b74`](https://github.com/mastra-ai/mastra/commit/ee59b743ce73ad11784b4d9c6fbba8568edee1c8), [`a97b1a0`](https://github.com/mastra-ai/mastra/commit/a97b1a0abaed83946c3519d1e0f680d0815b8a67)]:
+  - @mastra/core@1.37.0-alpha.2
+
 ## 1.1.40-alpha.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.40-alpha.3",
+  "version": "1.1.40-alpha.7",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.37.0-alpha.1",
+    "@mastra/core": "1.37.0-alpha.3",
     "@mastra/mcp": "^1.8.0"
   },
   "devDependencies": {
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
-    "@internal/lint": "0.0.97",
     "@internal/types-builder": "0.0.72",
-    "@mastra/core": "1.37.0-alpha.1"
+    "@internal/lint": "0.0.97",
+    "@mastra/core": "1.37.0-alpha.3"
   },
   "homepage": "https://mastra.ai",
   "repository": {