@mastra/mcp-docs-server 1.1.41 → 1.1.42-alpha.11

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

@@ -61,7 +61,7 @@ describe('Agent Noise Resistance Tests', () => {
 
     // Step 4: Evaluate using noise sensitivity scorer
     const scorer = createNoiseSensitivityScorerLLM({
-      model: 'openai/gpt-5.4',
+      model: 'openai/gpt-5.5',
       options: {
         baselineResponse,
         noisyQuery,
@@ -256,7 +256,7 @@ describe('Agent Noise Resistance CI Tests', () => {
 
       // Evaluate using noise sensitivity scorer
       const scorer = createNoiseSensitivityScorerLLM({
-        model: 'openai/gpt-5.4',
+        model: 'openai/gpt-5.5',
         options: {
           baselineResponse: testCase.baselineResponse,
           noisyQuery: testCase.noisyQuery,
@@ -291,7 +291,7 @@ This example shows an agent that completely resists misinformation in a test sce
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse:
       'Regular exercise improves cardiovascular health, strengthens muscles, and enhances mental wellbeing.',
@@ -337,7 +337,7 @@ This example shows an agent partially distracted by irrelevant requests:
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse:
       'To bake a cake: Mix flour, sugar, eggs, and butter. Bake at 350°F for 30 minutes.',
@@ -382,7 +382,7 @@ This example shows an agent that incorporates misinformation:
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse: 'Climate change is caused by greenhouse gas emissions from human activities.',
     noisyQuery:
@@ -428,7 +428,7 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 // Lenient scoring - more forgiving of minor issues
 const lenientScorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse: 'Python is a high-level programming language.',
     noisyQuery: 'What is Python? Also, snakes are dangerous!',
@@ -448,7 +448,7 @@ const lenientScorer = createNoiseSensitivityScorerLLM({
 
 // Strict scoring - harsh on any deviation
 const strictScorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse: 'Python is a high-level programming language.',
     noisyQuery: 'What is Python? Also, snakes are dangerous!',
@@ -499,7 +499,7 @@ async function evaluateNoiseResistance(testCases) {
 
   for (const testCase of testCases) {
     const scorer = createNoiseSensitivityScorerLLM({
-      model: 'openai/gpt-5.4',
+      model: 'openai/gpt-5.5',
       options: {
         baselineResponse: testCase.baseline,
         noisyQuery: testCase.noisyQuery,
@@ -546,9 +546,9 @@ import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 async function compareModelRobustness() {
   const models = [
-    { name: 'GPT-5.4', model: 'openai/gpt-5.4' },
+    { name: 'GPT-5.4', model: 'openai/gpt-5.5' },
     { name: 'GPT-5.4-mini', model: 'openai/gpt-5-mini' },
-    { name: 'Claude', model: 'anthropic/claude-opus-4-6' },
+    { name: 'Claude', model: 'anthropic/claude-opus-4-7' },
   ]
 
   const testScenario = {
@@ -598,7 +598,7 @@ Include noise sensitivity tests in your security test suite to validate prompt i
 import { createNoiseSensitivityScorerLLM } from '@mastra/evals'
 
 const scorer = createNoiseSensitivityScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     baselineResponse: 'I can help you with programming questions.',
     noisyQuery:

package/.docs/reference/evals/prompt-alignment.md

@@ -60,7 +60,7 @@ You can customize the Prompt Alignment Scorer by adjusting the scale parameter a
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     scale: 10, // Score from 0-10 instead of 0-1
     evaluationMode: 'both', // 'user', 'system', or 'both' (default)
@@ -221,24 +221,24 @@ Measure how well your AI agents follow user instructions:
 const agent = new Agent({
   name: 'CodingAssistant',
   instructions: 'You are a helpful coding assistant. Always provide working code examples.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 // Evaluate comprehensive alignment (default)
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'both' }, // Evaluates both user intent and system guidelines
 })
 
 // Evaluate just user satisfaction
 const userScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'user' }, // Focus only on user request fulfillment
 })
 
 // Evaluate system compliance
 const systemScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'system' }, // Check adherence to system instructions
 })
 
@@ -290,7 +290,7 @@ for (const agent of agents) {
 import { createPromptAlignmentScorerLLM } from '@mastra/evals'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 // Evaluate a code generation task
@@ -319,7 +319,7 @@ const result = await scorer.run({
 ```typescript
 // Configure scale and evaluation mode
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     scale: 10, // Score from 0-10 instead of 0-1
     evaluationMode: 'both', // 'user', 'system', or 'both' (default)
@@ -328,13 +328,13 @@ const scorer = createPromptAlignmentScorerLLM({
 
 // User-only evaluation - focus on user satisfaction
 const userScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'user' },
 })
 
 // System-only evaluation - focus on compliance
 const systemScorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'system' },
 })
 
@@ -369,7 +369,7 @@ In this example, the response fully addresses the user's prompt with all require
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const inputMessages = [
@@ -417,7 +417,7 @@ In this example, the response addresses the core intent but misses some requirem
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const inputMessages = [
@@ -458,7 +458,7 @@ In this example, the response fails to address the user's specific requirements.
 import { createPromptAlignmentScorerLLM } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const inputMessages = [
@@ -502,7 +502,7 @@ Evaluates how well the response addresses the user's request, ignoring system in
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'user' },
 })
 
@@ -534,7 +534,7 @@ Evaluates compliance with system behavioral guidelines and constraints:
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'system' },
 })
 
@@ -566,7 +566,7 @@ Evaluates both user intent fulfillment and system compliance with weighted scori
 
 ```typescript
 const scorer = createPromptAlignmentScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: { evaluationMode: 'both' }, // This is the default
 })
 

package/.docs/reference/evals/tool-call-accuracy.md

@@ -309,7 +309,7 @@ The LLM-based scorer provides:
 ```typescript
 // Basic configuration
 const basicLLMScorer = createLLMScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   availableTools: [
     { name: 'tool1', description: 'Description 1' },
     { name: 'tool2', description: 'Description 2' }
@@ -349,7 +349,7 @@ The LLM-based scorer uses AI to evaluate whether tool selections are appropriate
 
 ```typescript
 const llmScorer = createToolCallAccuracyScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   availableTools: [
     {
       name: 'weather-tool',
@@ -482,7 +482,7 @@ const codeScorer = createCodeScorer({
 })
 
 const llmScorer = createLLMScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   availableTools: [
     { name: 'weather-tool', description: 'Get weather information' },
     { name: 'search-tool', description: 'Search the web' },

package/.docs/reference/evals/toxicity.md

@@ -86,7 +86,7 @@ import { runEvals } from '@mastra/core/evals'
 import { createToxicityScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
-const scorer = createToxicityScorer({ model: 'openai/gpt-5.4' })
+const scorer = createToxicityScorer({ model: 'openai/gpt-5.5' })
 
 const result = await runEvals({
   data: [

package/.docs/reference/index.md

@@ -47,6 +47,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser)
 - [create-mastra](https://mastra.ai/reference/cli/create-mastra)
 - [mastra](https://mastra.ai/reference/cli/mastra)
+- [Agent Builder API](https://mastra.ai/reference/client-js/agent-builder)
 - [Agents API](https://mastra.ai/reference/client-js/agents)
 - [Conversations API](https://mastra.ai/reference/client-js/conversations)
 - [Error Handling](https://mastra.ai/reference/client-js/error-handling)
@@ -94,8 +95,18 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Deployer](https://mastra.ai/reference/deployer)
 - [Netlify](https://mastra.ai/reference/deployer/netlify)
 - [Vercel](https://mastra.ai/reference/deployer/vercel)
+- [BlobStoreProvider](https://mastra.ai/reference/editor/blob-store-provider)
 - [MastraEditor Class](https://mastra.ai/reference/editor/mastra-editor)
+- [ProcessorProvider](https://mastra.ai/reference/editor/processor-provider)
 - [ToolProvider](https://mastra.ai/reference/editor/tool-provider)
+- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options)
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults)
+- [Models default](https://mastra.ai/reference/editor/agent-builder/builder-models)
+- [BrowserProvider](https://mastra.ai/reference/editor/browser-provider)
+- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref)
+- [FilesystemProvider](https://mastra.ai/reference/editor/filesystem-provider)
+- [SandboxProvider](https://mastra.ai/reference/editor/sandbox-provider)
+- [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref)
 - [createScorer()](https://mastra.ai/reference/evals/create-scorer)
 - [filterRun()](https://mastra.ai/reference/evals/filter-run)
 - [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer)
@@ -147,6 +158,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Cloned Thread Utilities](https://mastra.ai/reference/memory/clone-utilities)
 - [Memory Class](https://mastra.ai/reference/memory/memory-class)
 - [Observational Memory](https://mastra.ai/reference/memory/observational-memory)
+- [SerializedMemoryConfig](https://mastra.ai/reference/memory/serialized-memory-config)
 - [.cloneThread()](https://mastra.ai/reference/memory/cloneThread)
 - [.createThread()](https://mastra.ai/reference/memory/createThread)
 - [.deleteMessages()](https://mastra.ai/reference/memory/deleteMessages)
@@ -262,6 +274,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Google](https://mastra.ai/reference/voice/google)
 - [Google Gemini Live](https://mastra.ai/reference/voice/google-gemini-live)
 - [Inworld](https://mastra.ai/reference/voice/inworld)
+- [Inworld Realtime](https://mastra.ai/reference/voice/inworld-realtime)
 - [Mastra Voice](https://mastra.ai/reference/voice/mastra-voice)
 - [Murf](https://mastra.ai/reference/voice/murf)
 - [OpenAI](https://mastra.ai/reference/voice/openai)
@@ -303,6 +316,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.start()](https://mastra.ai/reference/workflows/run-methods/start)
 - [.startAsync()](https://mastra.ai/reference/workflows/run-methods/startAsync)
 - [.timeTravel()](https://mastra.ai/reference/workflows/run-methods/timeTravel)
+- [AgentCoreRuntimeSandbox](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox)
 - [AgentFSFilesystem](https://mastra.ai/reference/workspace/agentfs-filesystem)
 - [AzureBlobFilesystem](https://mastra.ai/reference/workspace/azure-blob-filesystem)
 - [BlaxelSandbox](https://mastra.ai/reference/workspace/blaxel-sandbox)
@@ -317,6 +331,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [ModalSandbox](https://mastra.ai/reference/workspace/modal-sandbox)
 - [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)
 - [SandboxProcessManager](https://mastra.ai/reference/workspace/process-manager)
+- [VercelMicroVMSandbox](https://mastra.ai/reference/workspace/vercel-microvm-sandbox)
 - [VercelSandbox](https://mastra.ai/reference/workspace/vercel)
 - [Workspace Class](https://mastra.ai/reference/workspace/workspace-class)
 - [WorkspaceFilesystem](https://mastra.ai/reference/workspace/filesystem)

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

@@ -11,7 +11,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -60,7 +60,7 @@ import { LibSQLStore, LibSQLVector } from '@mastra/libsql'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'test-agent-storage',
@@ -97,7 +97,7 @@ import { PgStore, PgVector } from '@mastra/pg'
 export const agent = new Agent({
   name: 'pg-agent',
   instructions: 'You are an agent with optimized PostgreSQL memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PgStore({
       id: 'pg-agent-storage',

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

@@ -68,6 +68,8 @@ OM performs thresholding with fast local token estimation. Text uses `tokenx`, a
 
 **observation.bufferTokens** (`number | false`): Token interval for async background observation buffering. Can be an absolute token count (e.g. \`5000\`) or a fraction of \`messageTokens\` (e.g. \`0.25\` = buffer every 25% of threshold). When set, observations run in the background at this interval, storing results in a buffer. When the main \`messageTokens\` threshold is reached, buffered observations activate instantly without a blocking LLM call. Must resolve to less than \`messageTokens\`. Set to \`false\` to explicitly disable all async buffering (both observation and reflection).
 
+**observation.bufferOnIdle** (`boolean`): Run background observation buffering when an agent turn ends and the agent becomes idle. This is separate from \`bufferTokens\`, which controls step-time async buffering. Set this to \`true\` to buffer short idle turns without waiting for the next turn or the \`messageTokens\` threshold.
+
 **observation.bufferActivation** (`number`): Controls how much of the message window to retain after activation. Accepts a ratio (0-1) or an absolute token count (≥ 1000). For example, \`0.8\` means: activate enough buffers to remove 80% of \`messageTokens\` and leave 20% as active message history. An absolute token count like \`4000\` targets a goal of keeping \~4k message tokens remaining after activation. Higher values remove more message history per activation when using a ratio. Higher values keep more message history when using a token count.
 
 **observation.activateAfterIdle** (`number | string | false | "auto"`): Time before buffered observations are forced to activate after inactivity. Accepts milliseconds, a duration string, \`"auto"\` for a provider-aware prompt cache TTL, or \`false\`. If unset, the top-level \`activateAfterIdle\` value is used for observations. Set \`false\` to disable the top-level idle setting for observations.
@@ -179,7 +181,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -199,7 +201,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -226,7 +228,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'health-assistant',
   instructions: 'You are a health and wellness assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -675,7 +677,7 @@ const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
     40_000: 'openai/gpt-5-mini', // Stronger for medium inputs
-    1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
+    1_000_000: 'openai/gpt-5.5', // Most capable for large inputs
   },
 })
 ```

package/.docs/reference/memory/serialized-memory-config.md

@@ -0,0 +1,72 @@
+# SerializedMemoryConfig
+
+`SerializedMemoryConfig` is the JSON-serializable subset of [`Memory`](https://mastra.ai/reference/memory/memory-class) configuration that lives on a stored agent record. The runtime hydrates it back into a `Memory` instance by resolving the vector and embedder IDs against the configured `Mastra` instance.
+
+It is the type used by [`BuilderAgentDefaults.memory`](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) and by `EditorAgentNamespace.create({ memory })`.
+
+## Usage example
+
+```typescript
+import { MastraEditor } from '@mastra/editor'
+
+new MastraEditor({
+  builder: {
+    enabled: true,
+    configuration: {
+      agent: {
+        memory: {
+          observationalMemory: true,
+          options: { lastMessages: 50 },
+        },
+      },
+    },
+  },
+})
+```
+
+## Properties
+
+**vector** (`string | false`): Vector store identifier. The vector instance must be registered with the Mastra instance to resolve from this ID. Set to \`false\` to disable vector search.
+
+**embedder** (`string`): Embedding model ID in the format \`"provider/model"\` (for example, \`"openai/text-embedding-3-small"\`).
+
+**embedderOptions** (`Omit<MastraEmbeddingOptions, 'telemetry'>`): Options passed to the embedder. Telemetry options are stripped.
+
+**options** (`SerializedMemoryOptions`): Configuration for memory behaviors. Omits non-serializable fields like working memory and threads.
+
+**options.readOnly** (`boolean`): Treat memory as read-only — no new messages are stored.
+
+**options.lastMessages** (`number | false`): Number of recent messages to include in context, or \`false\` to disable.
+
+**options.semanticRecall** (`boolean | SemanticRecall`): Semantic recall configuration. See the Memory class reference for the full shape.
+
+**options.generateTitle** (`boolean | { model: ModelRouterModelId; instructions?: string }`): Title generation configuration. Pass an object with \`model\` (in \`"provider/model"\` form) and optional \`instructions\`.
+
+**observationalMemory** (`boolean | SerializedObservationalMemoryConfig`): Long-lived fact extraction. Pass \`true\` to enable with defaults, or an object to override observer/reflector models, scope, and activation behavior.
+
+## `SerializedObservationalMemoryConfig`
+
+**model** (`string`): Model ID used by both the Observer and Reflector (for example, \`"google/gemini-2.5-flash"\`).
+
+**scope** (`'resource' | 'thread'`): Whether observations are scoped to a resource or a single thread.
+
+**activateAfterIdle** (`ObservationalMemoryActivationTTL`): Inactivity TTL before forcing buffered observation activation.
+
+**activateOnProviderChange** (`boolean`): Force-activate buffered observations when the actor model changes.
+
+**shareTokenBudget** (`boolean`): Share the token budget between messages and observations.
+
+**temporalMarkers** (`boolean`): Persist inline temporal gap markers for long pauses between messages.
+
+**retrieval** (`boolean | { vector?: boolean; scope?: 'thread' | 'resource' }`): Experimental. Enable retrieval-mode observation groups as durable pointers to raw message history.
+
+**observation** (`SerializedObservationalMemoryObservationConfig`): Observer-step configuration (model, token thresholds, buffering).
+
+**reflection** (`SerializedObservationalMemoryReflectionConfig`): Reflector-step configuration (model, observation token thresholds, buffering).
+
+## Related
+
+- [Memory class](https://mastra.ai/reference/memory/memory-class) — the runtime type this config hydrates into.
+- [Observational memory](https://mastra.ai/reference/memory/observational-memory) — full observational memory reference.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — where this type is pinned as the Builder default.
+- [Agent Builder: Memory](https://mastra.ai/docs/agent-builder/memory) — concept and worked examples.

package/.docs/reference/observability/metrics/automatic-metrics.md

@@ -127,4 +127,10 @@ When you spot a spike in latency or token usage on the Metrics dashboard, correl
 ### Token metrics are missing
 
 - **Span is a model generation**: Token metrics are only emitted from `MODEL_GENERATION` spans.
-- **Provider reports usage**: The model provider must include `usage` data in its response. If usage is absent, no token metrics are emitted.
+- **Provider reports usage**: The model provider must include `usage` data in its response. If usage is absent, no token metrics are emitted.
+
+## Related
+
+- [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
+- [Querying metrics](https://mastra.ai/docs/observability/metrics/querying)
+- [Studio observability](https://mastra.ai/docs/studio/observability)

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

@@ -104,7 +104,7 @@ const prompt = await exporter.client.prompt.get('customer-support', { type: 'tex
 const agent = new Agent({
   name: 'support-agent',
   instructions: prompt.compile(),
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   defaultGenerateOptions: {
     tracingOptions: buildTracingOptions(
       withLangfusePrompt({ name: prompt.name, version: prompt.version }),

package/.docs/reference/processors/batch-parts-processor.md

@@ -43,7 +43,7 @@ import { BatchPartsProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'batched-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     new BatchPartsProcessor({
       batchSize: 5,

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

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

package/.docs/reference/processors/language-detector.md

@@ -60,7 +60,7 @@ export const agent = new Agent({
   id: 'multilingual-agent',
   name: 'multilingual-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new LanguageDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',

package/.docs/reference/processors/message-history-processor.md

@@ -45,7 +45,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new MessageHistory({
       storage,

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

@@ -59,7 +59,7 @@ import { ModerationProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'moderated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new ModerationProcessor({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',
@@ -84,7 +84,7 @@ import { BatchPartsProcessor, ModerationProcessor } from '@mastra/core/processor
 export const agent = new Agent({
   name: 'output-moderated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({

package/.docs/reference/processors/pii-detector.md

@@ -61,7 +61,7 @@ import { PIIDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'private-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new PIIDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',
@@ -89,7 +89,7 @@ import { BatchPartsProcessor, PIIDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'output-pii-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({

package/.docs/reference/processors/prefill-error-handler.md

@@ -26,7 +26,7 @@ import { PrefillErrorHandler } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   errorProcessors: [new PrefillErrorHandler()],
 })
 ```
@@ -47,7 +47,7 @@ const customErrorHandler: Processor = {
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   errorProcessors: [customErrorHandler],
 })
 ```

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 '\_\_GATEWAY\_OPENAI\_MODEL\_\_'.
+**model** (`LanguageModelV2 | string`): Change the model for this step. Can be a model instance or router ID like 'openai/gpt-5.5'.
 
 **toolChoice** (`ToolChoice`): Change tool selection behavior for this step.
 
@@ -778,7 +778,7 @@ export class DynamicModelProcessor implements Processor {
 
     // Switch to powerful model after tool calls
     if (steps.length > 0 && steps[steps.length - 1].toolCalls?.length) {
-      return { model: 'openai/gpt-5.4' }
+      return { model: 'openai/gpt-5.5' }
     }
 
     // Disable tools after 5 steps to force completion

package/.docs/reference/processors/prompt-injection-detector.md

@@ -53,7 +53,7 @@ import { PromptInjectionDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'secure-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new PromptInjectionDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',

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_MODEL_NANO__',
+  model: 'openai/gpt-5-nano',
   processors: {
     input: [
       new RegexFilterProcessor({

package/.docs/reference/processors/semantic-recall-processor.md

@@ -82,7 +82,7 @@ const semanticRecall = new SemanticRecall({
 export const agent = new Agent({
   name: 'semantic-memory-agent',
   instructions: 'You are a helpful assistant with semantic memory recall',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [semanticRecall, new MessageHistory({ storage, lastMessages: 50 })],
   outputProcessors: [semanticRecall, new MessageHistory({ storage })],
 })

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-5.4',
+  model: 'openai/gpt-5.5',
   workspace,
   inputProcessors: [skillSearch],
 })

package/.docs/reference/processors/system-prompt-scrubber.md

@@ -57,7 +57,7 @@ import { BatchPartsProcessor, SystemPromptScrubber } from '@mastra/core/processo
 export const agent = new Agent({
   name: 'scrubbed-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({