@mastra/mcp-docs-server 1.1.40-alpha.5 → 1.1.40-alpha.9

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/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/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/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.8
+
+### Patch Changes
+
+- Updated dependencies [[`b7286f4`](https://github.com/mastra-ai/mastra/commit/b7286f4308267f5fd70e6bfee10dba9472640906), [`a481027`](https://github.com/mastra-ai/mastra/commit/a481027b549ba1018414990c8f045eaee7b9f413), [`801baa0`](https://github.com/mastra-ai/mastra/commit/801baa07cccdbaec1d00942a92bdc831111744a2), [`b3c3b18`](https://github.com/mastra-ai/mastra/commit/b3c3b189121489a3a51a8fd8204b569be9a89fe5)]:
+  - @mastra/core@1.37.0-alpha.4
+
+## 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.40-alpha.5",
+  "version": "1.1.40-alpha.9",
   "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.2",
+    "@mastra/core": "1.37.0-alpha.4",
     "@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",
-    "@mastra/core": "1.37.0-alpha.2",
-    "@internal/types-builder": "0.0.72"
+    "@internal/types-builder": "0.0.72",
+    "@mastra/core": "1.37.0-alpha.4",
+    "@internal/lint": "0.0.97"
   },
   "homepage": "https://mastra.ai",
   "repository": {