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

package/.docs/reference/editor/mastra-editor.md

@@ -39,6 +39,54 @@ export const mastra = new Mastra({
 
 **blobStores** (`Record<string, BlobStoreProvider>`): Blob storage providers for binary data (for example, S3). Falls back to the Mastra storage blob store if no provider is specified. (Default: `{}`)
 
+**browsers** (`Record<string, BrowserProvider>`): Browser providers for agent browser access (for example, Stagehand). No built-ins — required when \`builder.features.agent.browser\` is enabled. See the BrowserProvider reference for the provider interface. (Default: `{}`)
+
+**builder** (`AgentBuilderOptions`): Agent Builder configuration. See the AgentBuilderOptions reference. Omit or set \`enabled: false\` to disable the Builder.
+
+**source** (`'code' | 'db'`): Where agent overrides are stored. With 'db', overrides live in the configured storage backend and Studio shows the save and publish flow. With 'code', overrides live as per-agent JSON files on disk (routed through a local FilesystemStore) and Studio shows filesystem actions. See the Editor overview for the difference. (Default: `'db'`)
+
+**codePath** (`string`): Directory used by the 'code' source for per-agent JSON files. Ignored when source is not 'code'. (Default: `'./mastra/editor/'`)
+
+### Provider interfaces
+
+Each provider field above takes a record keyed by provider id. See the per-provider reference pages for the implementation shape:
+
+- [ProcessorProvider](https://mastra.ai/reference/editor/processor-provider)
+- [FilesystemProvider](https://mastra.ai/reference/editor/filesystem-provider)
+- [SandboxProvider](https://mastra.ai/reference/editor/sandbox-provider)
+- [BlobStoreProvider](https://mastra.ai/reference/editor/blob-store-provider)
+- [BrowserProvider](https://mastra.ai/reference/editor/browser-provider)
+
+## Agent Builder
+
+The `builder` field enables the [Agent Builder](https://mastra.ai/docs/agent-builder/overview), a browser-based UI for creating and editing stored agents. See:
+
+- [Agent Builder overview](https://mastra.ai/docs/agent-builder/overview) — concepts and getting started.
+- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options) — full options schema.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — admin-pinned defaults for new agents.
+- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models) — model allowlist and default model.
+
+### Registering the Builder agent
+
+The Builder UI runs against an agent created by the `createBuilderAgent()` factory from `@mastra/editor/ee`. Import the factory, invoke it, and register the returned agent under `agents` on your Mastra instance:
+
+```typescript
+import { Mastra } from '@mastra/core'
+import { MastraEditor } from '@mastra/editor'
+import { createBuilderAgent } from '@mastra/editor/ee'
+
+export const mastra = new Mastra({
+  agents: { builderAgent: createBuilderAgent() },
+  editor: new MastraEditor({
+    builder: { enabled: true },
+  }),
+})
+```
+
+The key name (`builderAgent`) is conventional — any key works. The `@mastra/editor/ee` subpath is gated by the Mastra Enterprise Edition license at runtime.
+
+See the [Agent Builder overview](https://mastra.ai/docs/agent-builder/overview) for the full setup checklist.
+
 ## Namespaces
 
 The editor exposes namespaces for managing different entity types. Access them from any Mastra instance with `mastra.getEditor()` and call the CRUD methods directly in application code, or rely on the Mastra server routes that use them under the hood.
@@ -165,4 +213,16 @@ Returns all registered sandbox providers.
 
 #### `getBlobStoreProviders()`
 
-Returns all registered blob store providers.
+Returns all registered blob store providers.
+
+### Source
+
+#### `getSource()`
+
+Returns the configured source (`'code'` or `'db'`), or `undefined` when the editor was constructed without an explicit `source`.
+
+```typescript
+const source = mastra.getEditor()?.getSource()
+```
+
+Returns: `'code' | 'db' | undefined`

package/.docs/reference/editor/processor-provider.md

@@ -0,0 +1,64 @@
+# ProcessorProvider
+
+`ProcessorProvider` is the interface a package implements to register a configurable processor with [`MastraEditor`](https://mastra.ai/reference/editor/mastra-editor). Processor providers serve two purposes:
+
+1. **Discovery** — the UI uses `info`, `configSchema`, and `availablePhases` to render configuration forms.
+2. **Runtime** — the editor calls `createProcessor(config)` during agent hydration to instantiate processors from stored configuration.
+
+Providers are supplied via `MastraEditorConfig.processorProviders`.
+
+## Usage example
+
+```typescript
+import { MastraEditor } from '@mastra/editor'
+import { moderationProcessorProvider } from '@mastra/processors/moderation'
+
+new MastraEditor({
+  processorProviders: {
+    moderation: moderationProcessorProvider,
+  },
+})
+```
+
+## Properties
+
+**info** (`ProcessorProviderInfo`): Metadata about the provider.
+
+**info.id** (`string`): Unique identifier (for example, \`"moderation"\`, \`"token-limiter"\`).
+
+**info.name** (`string`): Human-readable name.
+
+**info.description** (`string`): Short description of the provider.
+
+**configSchema** (`ZodSchema`): Zod schema describing the configuration this provider accepts. Used by the UI to render a form. The validated config object is passed to \`createProcessor()\`.
+
+**availablePhases** (`ProcessorPhase[]`): Phases this provider's processors support. One or more of \`'processInput'\`, \`'processInputStep'\`, \`'processOutputStream'\`, \`'processOutputResult'\`, \`'processOutputStep'\`.
+
+**createProcessor** (`(config: Record<string, unknown>) => Processor`): Create a \`Processor\` instance from the validated configuration. Called during agent hydration to resolve stored processor configs into live instances.
+
+## Implementing a provider
+
+```typescript
+import type { ProcessorProvider } from '@mastra/core/processor-provider'
+import { z } from 'zod'
+import { MyProcessor } from './my-processor-impl'
+
+export const myProcessorProvider: ProcessorProvider = {
+  info: {
+    id: 'my-processor',
+    name: 'My Processor',
+    description: 'Filters output for sensitive content.',
+  },
+  configSchema: z.object({
+    threshold: z.number().min(0).max(1),
+  }),
+  availablePhases: ['processOutputStream', 'processOutputResult'],
+  createProcessor(config) {
+    return new MyProcessor(config as { threshold: number })
+  },
+}
+```
+
+## Related
+
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry.

package/.docs/reference/editor/sandbox-provider.md

@@ -0,0 +1,61 @@
+# SandboxProvider
+
+`SandboxProvider` is the interface a package implements to register a sandbox with [`MastraEditor`](https://mastra.ai/reference/editor/mastra-editor). The editor calls `createSandbox(config)` at workspace hydration time, using the `provider` id from the stored [`StorageWorkspaceRef`](https://mastra.ai/reference/editor/storage-workspace-ref) sandbox config as the lookup key.
+
+The built-in `local` sandbox provider is auto-registered. External providers (for example, E2B) are supplied via `MastraEditorConfig.sandboxes`.
+
+## Usage example
+
+```typescript
+import { MastraEditor } from '@mastra/editor'
+import { e2bSandboxProvider } from '@mastra/e2b'
+
+new MastraEditor({
+  sandboxes: {
+    [e2bSandboxProvider.id]: e2bSandboxProvider,
+  },
+})
+```
+
+## Properties
+
+**id** (`string`): Unique provider identifier (for example, \`"local"\`, \`"e2b"\`). Must match \`StorageSandboxConfig.provider\` on every stored workspace that uses this provider.
+
+**name** (`string`): Human-readable name for UI display.
+
+**description** (`string`): Short description shown in the workspace sandbox picker.
+
+**configSchema** (`Record<string, unknown>`): JSON Schema describing provider-specific configuration. Used by the UI to render config forms.
+
+**createSandbox** (`(config: TConfig) => WorkspaceSandbox | Promise<WorkspaceSandbox>`): Create a runtime \`WorkspaceSandbox\` instance from the stored config. Called at workspace hydration time.
+
+## Implementing a provider
+
+```typescript
+import type { SandboxProvider, WorkspaceSandbox } from '@mastra/core/editor'
+
+export const mySandboxProvider: SandboxProvider<{ apiKey: string }> = {
+  id: 'my-sandbox',
+  name: 'My Sandbox',
+  description: 'Cloud sandbox for command execution.',
+  configSchema: {
+    type: 'object',
+    required: ['apiKey'],
+    properties: {
+      apiKey: { type: 'string' },
+    },
+  },
+  async createSandbox(config): Promise<WorkspaceSandbox> {
+    return createMySandbox({ apiKey: config.apiKey })
+  },
+}
+```
+
+Once registered, admins can reference the provider from an inline workspace config or a stored [`StorageWorkspaceRef`](https://mastra.ai/reference/editor/storage-workspace-ref).
+
+## Related
+
+- [Workspace](https://mastra.ai/docs/agent-builder/workspace) — concept and worked examples.
+- [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref) — stored configuration consumed by `createSandbox`.
+- [FilesystemProvider](https://mastra.ai/reference/editor/filesystem-provider) — sibling provider for file access.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry.

package/.docs/reference/editor/storage-browser-ref.md

@@ -0,0 +1,80 @@
+# StorageBrowserRef
+
+`StorageBrowserRef` is the inline browser configuration attached to a stored agent. The `provider` id is resolved at hydration time against the [`BrowserProvider`](https://mastra.ai/reference/editor/browser-provider) registered on [`MastraEditor.browsers`](https://mastra.ai/reference/editor/mastra-editor).
+
+It is the type used by [`BuilderAgentDefaults.browser`](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) and by stored agent records.
+
+## Usage example
+
+```typescript
+import { MastraEditor } from '@mastra/editor'
+import { stagehandBrowserProvider } from '@mastra/stagehand'
+
+new MastraEditor({
+  browsers: { [stagehandBrowserProvider.id]: stagehandBrowserProvider },
+  builder: {
+    enabled: true,
+    configuration: {
+      agent: {
+        browser: {
+          type: 'inline',
+          config: {
+            provider: 'stagehand',
+            headless: true,
+            viewport: { width: 1280, height: 720 },
+          },
+        },
+      },
+    },
+  },
+})
+```
+
+## Type
+
+```typescript
+type StorageBrowserRef = { type: 'inline'; config: StorageBrowserConfig }
+```
+
+There is no `{ type: 'id' }` variant for browsers — they are always inlined.
+
+## Properties
+
+**type** (`'inline'`): Discriminant. Must be the literal \`"inline"\`.
+
+**config** (`StorageBrowserConfig`): Provider id and per-instance browser configuration. See the section below.
+
+## `StorageBrowserConfig`
+
+The shape embedded under `config`. Defined in `@mastra/core/storage`.
+
+**provider** (`string`): Provider identifier (for example, \`"stagehand"\`). Must match a \`BrowserProvider.id\` registered on \`MastraEditor.browsers\`. There are no built-in providers.
+
+**headless** (`boolean`): Run the browser in headless mode (no visible UI). (Default: `true`)
+
+**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. Controls window size and how pages render.
+
+**timeout** (`number`): Default timeout in milliseconds for browser operations. (Default: `10000`)
+
+**screencast** (`ScreencastOptions`): Screencast options for streaming browser frames to the UI.
+
+**screencast.format** (`'jpeg' | 'png'`): Image format.
+
+**screencast.quality** (`number`): JPEG quality 0–100.
+
+**screencast.maxWidth** (`number`): Max width in pixels.
+
+**screencast.maxHeight** (`number`): Max height in pixels.
+
+**screencast.everyNthFrame** (`number`): Capture every Nth frame.
+
+## Hydration
+
+`StorageBrowserRef` is resolved lazily on `mastra.editor.agent.getById()`. The editor looks up `config.provider` on `MastraEditor.browsers` and calls `provider.createBrowser(config)`. If the provider is not registered, the editor logs a warning and returns `undefined` — the agent still loads, but without a browser.
+
+## Related
+
+- [Browser](https://mastra.ai/docs/agent-builder/browser) — concept and worked examples.
+- [BrowserProvider](https://mastra.ai/reference/editor/browser-provider) — implementer-facing provider interface.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — where this type is pinned as the Builder default.
+- [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref) — sibling reference type for workspace configuration.

package/.docs/reference/editor/storage-workspace-ref.md

@@ -0,0 +1,93 @@
+# StorageWorkspaceRef
+
+`StorageWorkspaceRef` is the discriminated union used to attach a workspace to a stored agent. It either points at a workspace registered on the Mastra runtime by ID, or embeds a workspace snapshot inline.
+
+It is the type used by [`BuilderAgentDefaults.workspace`](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) and by stored agent records.
+
+## Usage example
+
+```typescript
+import { MastraEditor } from '@mastra/editor'
+
+// Variant 1 — reference a runtime workspace by id
+new MastraEditor({
+  builder: {
+    enabled: true,
+    configuration: {
+      agent: {
+        workspace: { type: 'id', workspaceId: 'builder-workspace' },
+      },
+    },
+  },
+})
+
+// Variant 2 — inline a workspace snapshot
+new MastraEditor({
+  builder: {
+    enabled: true,
+    configuration: {
+      agent: {
+        workspace: {
+          type: 'inline',
+          config: {
+            name: 'inline-builder-workspace',
+            filesystem: {
+              provider: 'local',
+              config: { basePath: './agent-files' },
+            },
+          },
+        },
+      },
+    },
+  },
+})
+```
+
+## Variants
+
+**{ type: 'id'; workspaceId: string }** (`IdRef`): Reference a workspace registered on the Mastra runtime via \`new Mastra({ workspace })\` or \`mastra.addWorkspace()\`. The id is the join key between admin config, stored agent record, and hydration.
+
+**{ type: 'id'; workspaceId: string }.type** (`'id'`): Discriminant. Must be the literal \`"id"\`.
+
+**{ type: 'id'; workspaceId: string }.workspaceId** (`string`): Id of a workspace registered on the Mastra runtime. Used by the Builder to snapshot, persist, and later hydrate the workspace.
+
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }** (`InlineRef`): Embed a workspace snapshot directly. The Builder derives a deterministic id of the form \`inline-\<sha256(config)\[:12]>\` and persists the snapshot, so identical inline configs are deduplicated across agents.
+
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.type** (`'inline'`): Discriminant. Must be the literal \`"inline"\`.
+
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.config** (`StorageWorkspaceSnapshotType`): Serialized workspace configuration (filesystem, sandbox, mounts, search, skills, tools). See the \`StorageWorkspaceSnapshotType\` section below for the field list.
+
+## `StorageWorkspaceSnapshotType`
+
+The shape embedded under `{ type: 'inline', config }`. Defined in `@mastra/core/storage`.
+
+**name** (`string`): Display name of the workspace.
+
+**description** (`string`): Purpose description shown in the workspace listing.
+
+**filesystem** (`StorageFilesystemConfig`): Primary filesystem configuration. \`provider\` must match an id registered on \`MastraEditor.filesystems\` (built-in: \`local\`).
+
+**sandbox** (`StorageSandboxConfig`): Sandbox configuration. \`provider\` must match an id registered on \`MastraEditor.sandboxes\` (built-in: \`local\`).
+
+**mounts** (`Record<string, StorageFilesystemConfig>`): Additional filesystems mounted on the workspace, keyed by mount path.
+
+**search** (`StorageSearchConfig`): Search configuration (vector provider, embedder, BM25 settings).
+
+**skills** (`string[]`): Skill entity IDs assigned to this workspace.
+
+**tools** (`StorageWorkspaceToolsConfig`): Workspace tool configuration (allowlists, defaults).
+
+**autoSync** (`boolean`): Auto-sync between filesystem and sandbox. (Default: `false`)
+
+**operationTimeout** (`number`): Timeout for individual operations in milliseconds.
+
+## Hydration
+
+`StorageWorkspaceRef` is resolved lazily on `mastra.editor.agent.getById()`, not on `list()`. The editor looks up filesystem and sandbox providers on `MastraEditor.filesystems` / `MastraEditor.sandboxes` and materializes a runtime `Workspace`. Missing providers surface as a warning and the workspace is omitted.
+
+## Related
+
+- [Workspace](https://mastra.ai/docs/agent-builder/workspace) — concept and worked examples.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — where this type is pinned as the Builder default.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — registers filesystem and sandbox providers.
+- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref) — sibling reference type for browser configuration.

package/.docs/reference/evals/answer-relevancy.md

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

package/.docs/reference/evals/answer-similarity.md

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

package/.docs/reference/evals/bias.md

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

package/.docs/reference/evals/context-precision.md

@@ -98,7 +98,7 @@ MAP = (1.0 + 0.67) / 2 = 0.835 ≈ **0.83**
 
 ```typescript
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       // Extract context dynamically based on the query
@@ -117,7 +117,7 @@ const scorer = createContextPrecisionScorer({
 
 ```typescript
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       // Simulate retrieved documents from vector database
@@ -142,7 +142,7 @@ import { createContextPrecisionScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       // Extract context from agent's retrieved documents

package/.docs/reference/evals/context-relevance.md

@@ -119,7 +119,7 @@ import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 // Stricter penalty configuration
 const strictScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'Einstein won the Nobel Prize for photoelectric effect',
@@ -137,7 +137,7 @@ const strictScorer = createContextRelevanceScorerLLM({
 
 // Lenient penalty configuration
 const lenientScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'Einstein won the Nobel Prize for photoelectric effect',
@@ -183,7 +183,7 @@ console.log('Lenient penalties:', lenientResult.score) // Higher score, less pen
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       // Extract context based on the query
@@ -207,7 +207,7 @@ const scorer = createContextRelevanceScorerLLM({
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: ['Relevant information...', 'Supporting details...'],
     scale: 100, // Scale scores from 0-100 instead of 0-1
@@ -221,7 +221,7 @@ const scorer = createContextRelevanceScorerLLM({
 
 ```typescript
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       const query = input?.inputMessages?.[0]?.content || ''
@@ -248,7 +248,7 @@ This example shows excellent context relevance where all context directly suppor
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'Einstein won the Nobel Prize for his discovery of the photoelectric effect in 1921.',
@@ -295,7 +295,7 @@ This example shows moderate relevance with some context being irrelevant or unus
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'Solar eclipses occur when the Moon blocks the Sun.',
@@ -337,7 +337,7 @@ console.log(result)
 
 // With custom penalty configuration
 const customScorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'Solar eclipses occur when the Moon blocks the Sun.',
@@ -384,7 +384,7 @@ This example shows poor context relevance with mostly irrelevant information:
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'The Great Barrier Reef is located in Australia.',
@@ -432,7 +432,7 @@ Extract context dynamically based on the run input:
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       // Extract query from input
@@ -475,7 +475,7 @@ Integrate with RAG pipelines to evaluate retrieved context:
 import { createContextRelevanceScorerLLM } from '@mastra/evals'
 
 const scorer = createContextRelevanceScorerLLM({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     contextExtractor: (input, output) => {
       // Extract from RAG retrieval results

package/.docs/reference/evals/create-scorer.md

@@ -49,6 +49,8 @@ const scorer = createScorer({
 
 **judge.instructions** (`string`): System prompt/instructions for the LLM.
 
+**judge.jsonPromptInjection** (`boolean`): When true, inject the JSON schema into the prompt instead of using the provider's native \`response\_format\` API. Set this for models that don't support native structured output (e.g. some Groq Llama models) to avoid a wasted 400 call.
+
 **type** (`string`): Type specification for input/output. Use 'agent' for automatic agent types. For custom types, use the generic approach instead.
 
 **prepareRun** (`(run: ScorerRun) => ScorerRun | Promise<ScorerRun>`): Transform the scorer run data before the pipeline executes. Use this to filter messages, limit context size, or drop fields the scorer doesn't need. The \[\`filterRun()\`]\(/reference/evals/filter-run) utility creates this function from declarative options. Can be async.

package/.docs/reference/evals/faithfulness.md

@@ -79,7 +79,7 @@ import { myAgent } from './agent'
 
 // Context is typically populated from agent tool calls or RAG retrieval
 const scorer = createFaithfulnessScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const result = await runEvals({

package/.docs/reference/evals/hallucination.md

@@ -104,7 +104,7 @@ Use static context when you have known ground truth to compare against:
 import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: [
       'The first iPhone was announced on January 9, 2007.',
@@ -124,7 +124,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { extractToolResults } from '@mastra/evals/scorers'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     getContext: ({ run, step }) => {
       // Extract tool results as context
@@ -145,7 +145,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { extractToolResults } from '@mastra/evals/scorers'
 
 const hallucinationScorer = createHallucinationScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     getContext: ({ run }) => {
       const toolResults = extractToolResults(run.output)
@@ -156,7 +156,7 @@ const hallucinationScorer = createHallucinationScorer({
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   instructions: 'You are a helpful assistant.',
   evals: {
     scorers: [hallucinationScorer],
@@ -172,7 +172,7 @@ import { createHallucinationScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
 const scorer = createHallucinationScorer({
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   options: {
     context: ['Known fact 1', 'Known fact 2'],
   },