@mastra/mcp-docs-server 1.2.11 → 1.2.12-alpha.3

package/.docs/reference/configuration.md

@@ -32,7 +32,7 @@ export const mastra = new Mastra({
       id: 'weather-agent',
       name: 'Weather Agent',
       instructions: 'You help with weather information',
-      model: 'openai/gpt-5.5',
+      model: 'openai/gpt-5.6-sol',
     }),
   },
 })
@@ -242,7 +242,7 @@ export const mastra = new Mastra({
 
 **Type:** `Record<string, MastraMemory>`
 
-A registry of memory instances that can be referenced by agents. Memory gives agents coherence across interactions by retaining relevant information from past conversations. Mastra supports three types of memory: message history for recent messages, working memory for persistent user-specific details, and semantic recall for retrieving older messages based on relevance.
+A registry of memory instances that can be referenced by agents. Memory gives agents coherence across interactions by retaining relevant information from past conversations. Mastra supports message history for recent messages and working memory for persistent user-specific details. Semantic recall retrieves older messages based on relevance.
 
 Visit the [Memory documentation](https://mastra.ai/docs/memory/overview) to learn more.
 
@@ -343,7 +343,7 @@ export const mastra = new Mastra({
 
 **Type:** `Record<string, Scorer>`
 
-Scorers assess the quality of agent responses and workflow outputs. They provide quantifiable metrics for measuring agent quality using model-graded, rule-based, and statistical methods. Use scorers to track performance, compare approaches, and identify areas for improvement.
+Scorers assess the quality of agent responses and workflow outputs. They provide quantifiable metrics for measuring agent quality using model-graded, rule-based, and statistical methods. Use scorers to track performance and compare approaches. They can also identify areas for improvement.
 
 Visit the [Scorers documentation](https://mastra.ai/docs/evals/overview) to learn more.
 
@@ -505,11 +505,11 @@ const mastra = new Mastra({
 **Type:** `boolean | string[]`\
 **Default:** `true`
 
-When `mastra build` is run, Mastra bundles your project into the `.mastra/output` directory. This option controls which packages are excluded from the bundle (marked as "external") and installed separately through a package manager. This is useful when the internal Mastra bundler ([Rollup](https://rollupjs.org/configuration-options/#external)) has trouble bundling certain packages.
+When `mastra build` is run, Mastra bundles your project into the `.mastra/output` directory. This option controls which packages are excluded from the bundle (marked as "external") and installed separately through a package manager. This is useful when the internal Mastra bundler ([Rollup](https://rollupjs.org/configuration-options/#external)) has trouble bundling packages.
 
 By default, `mastra build` sets this option to `true`.
 
-Here's an overview of what the different values mean:
+The values have these meanings:
 
 - `true`: All dependencies listed in your project's `package.json` are marked as external
 - `false`: No dependencies are marked as external; everything is bundled together
@@ -784,7 +784,7 @@ export const mastra = new Mastra({
 
 Custom error handler called when an unhandled error occurs. Use this to customize error responses, log errors to external services like Sentry, or implement custom error formatting.
 
-This hook is supported by all server adapters. The `c` parameter provides a Hono-compatible context object — for non-Hono adapters (Koa, Express, Fastify), a shim is provided with commonly used methods like `c.json()` and `c.req.path`.
+This hook is supported by all server adapters. The `c` parameter provides a Hono-compatible context object: for non-Hono adapters (Koa, Express, Fastify), a shim is provided with commonly used methods like `c.json()` and `c.req.path`.
 
 ```typescript
 import { Mastra } from '@mastra/core'
@@ -813,7 +813,7 @@ export const mastra = new Mastra({
 
 Custom handler called when a request fails Zod schema validation. Use this to customize validation error responses, change the status code, or format errors to match your API standards.
 
-Return a `{ status, body }` object to override the default `400` response, or `undefined` to fall through to the default behavior. This hook is supported by all server adapters (Hono, Express, Fastify, Koa).
+Return a `{ status, body }` object to override the default `400` response, or `undefined` to use the default behavior. This hook is supported by all server adapters (Hono, Express, Fastify, Koa).
 
 The `context` parameter indicates which part of the request failed validation:
 

package/.docs/reference/core/getAgentById.md

@@ -18,7 +18,7 @@ const supportAgent = new Agent({
   id: 'support-agent-id',
   name: 'Support Agent',
   instructions: 'Answer support questions clearly and concisely.',
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
 })
 
 export const mastra = new Mastra({

package/.docs/reference/core/getMCPServer.md

@@ -30,7 +30,7 @@ const serverById = mastra.getMCPServerById('my-mcp-server')
 
 ## Parameters
 
-**registryKey** (`string`): The registry key used when registering the MCP server in the mcpServers configuration object. This is the key in the key-value pair, not the server's intrinsic id property.
+**registryKey** (`string`): The registry key used when registering the MCP server in the mcpServers configuration object. It is the configuration key in the key-value pair, not the server's intrinsic id property.
 
 ## Returns
 

package/.docs/reference/core/getScorer.md

@@ -2,7 +2,7 @@
 
 # getScorer()
 
-The `getScorer()` method retrieves a specific scorer that was registered with the Mastra instance using its registration key. This method provides type-safe access to scorers and throws an error if the requested scorer isn't found.
+The `getScorer()` method retrieves a specific scorer that was registered with the Mastra instance using its registration key. The method provides type-safe access to scorers and throws an error if the requested scorer isn't found.
 
 ## Usage example
 

package/.docs/reference/core/mastra-class.md

@@ -103,4 +103,51 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **versions.agents.versionId** (`string`): The ID of a specific version to use.
 
-**versions.agents.status** (`'draft' | 'published'`): Select the latest version with this publication status.
+**versions.agents.status** (`'draft' | 'published'`): Select the latest version with this publication status.
+
+**workers** (`MastraWorker[] | false`): Configure which workers run in this Mastra instance. When omitted, Mastra auto-creates default workers based on your PubSub and config. Pass false to disable all event processing (useful when running standalone workers separately). Pass a MastraWorker\[] to add custom workers — they are merged with the auto-created defaults, and a custom worker with the same name as a default replaces it.
+
+**backgroundTasks** (`BackgroundTaskManagerConfig`): Configure background task execution for agents. See background tasks configuration reference for all options.
+
+**backgroundTasks.enabled** (`boolean`): Enable background task dispatch.
+
+**backgroundTasks.globalConcurrency** (`number`): Max concurrent tasks across all agents.
+
+**backgroundTasks.perAgentConcurrency** (`number`): Max concurrent tasks per agent.
+
+**backgroundTasks.backpressure** (`'queue' | 'reject' | 'fallback-sync'`): Behavior when concurrency limit is reached.
+
+**backgroundTasks.defaultTimeoutMs** (`number`): Default task timeout in milliseconds.
+
+**backgroundTasks.defaultRetries** (`RetryConfig`): Default retry configuration.
+
+**scheduler** (`object`): Configure the scheduler worker for cron-driven workflow triggers. Auto-enables when any workflow declares a schedule. See Scheduled workflows.
+
+**scheduler.enabled** (`boolean`): Explicitly enable or disable the scheduler.
+
+**recovery** (`MastraRecoveryConfig`): Boot-time recovery behavior for orphaned agent and workflow runs. See Crash recovery. (Default: `{ durableAgents: 'off' }`)
+
+**recovery.durableAgents** (`'auto' | 'off'`): Set to 'auto' to automatically re-drive orphaned RUNNING durable agent runs on server boot. Recovery re-issues LLM calls and re-executes tool calls, so tools must be idempotent. See Crash recovery.
+
+## Methods
+
+### `recoverAllDurableAgents()`
+
+Re-drives every orphaned `running` durable-agent run across all registered durable agents. Called automatically on boot when `recovery.durableAgents` is `'auto'`. You can also call it directly for manual recovery or from a scheduled task.
+
+Requires persistent storage — with an in-memory store there is nothing to recover after a process restart.
+
+```typescript
+const result = await mastra.recoverAllDurableAgents()
+// { agents: 2, recovered: 3, succeeded: 3, failed: 0 }
+```
+
+Returns:
+
+**agents** (`number`): Number of durable agents scanned.
+
+**recovered** (`number`): Total number of runs that were re-driven.
+
+**succeeded** (`number`): Runs that restarted successfully.
+
+**failed** (`number`): Runs whose restart threw an error.

package/.docs/reference/core/mastra-model-gateway.md

@@ -21,7 +21,7 @@ class MyCustomGateway extends MastraModelGateway {
     return {
       'my-provider': {
         name: 'My Provider',
-        models: ['openai/gpt-5.5', 'anthropic/claude-sonnet-4-6'],
+        models: ['openai/gpt-5.6-sol', 'anthropic/claude-sonnet-4-6'],
         apiKeyEnvVar: 'MY_API_KEY',
         gateway: this.id,
       },

package/.docs/reference/datasets/addItem.md

@@ -4,7 +4,7 @@
 
 **Added in:** `@mastra/core@1.4.0`
 
-Adds a single item to the dataset. Each item has an input, optional ground truth, and optional metadata.
+Adds a single item to the dataset. Each item has an input and optional ground truth. Metadata is also optional.
 
 ## Usage example
 

package/.docs/reference/datasets/listItems.md

@@ -4,7 +4,7 @@
 
 **Added in:** `@mastra/core@1.4.0`
 
-Lists items in the dataset. When only `version` is provided, returns a bare `DatasetItem[]` snapshot of every item at that version. In all other cases — no arguments, or `search` / `page` / `perPage` provided with or without `version` — returns a paginated `{ items, pagination }` shape.
+Lists items in the dataset. When only `version` is provided, returns a bare `DatasetItem[]` snapshot of every item at that version. In all other cases (no arguments, or `search` / `page` / `perPage` provided with or without `version`), it returns a paginated `{ items, pagination }` shape.
 
 ## Usage example
 

package/.docs/reference/deployer/netlify.md

@@ -6,7 +6,7 @@ The `NetlifyDeployer` class handles packaging, configuration, and deployment by
 
 ## Installation
 
-In order to use `NetlifyDeployer`, you need to install the `@mastra/deployer-netlify` package:
+To use `NetlifyDeployer`, you need to install the `@mastra/deployer-netlify` package:
 
 **npm**:
 
@@ -47,10 +47,10 @@ export const mastra = new Mastra({
 
 ## Constructor options
 
-- `target?: 'serverless' | 'edge'` — Deploy target for Netlify. Defaults to `'serverless'`.
+- `target?: 'serverless' | 'edge'`: Deploy target for Netlify. Defaults to `'serverless'`.
 
-  - `'serverless'` — Standard [Netlify Functions](https://docs.netlify.com/functions/overview/) (Node.js runtime, 60s default timeout).
-  - `'edge'` — [Netlify Edge Functions](https://docs.netlify.com/build/edge-functions/overview/) (Deno-based runtime, runs at the edge closest to users, no hard timeout).
+  - `'serverless'`: Standard [Netlify Functions](https://docs.netlify.com/functions/overview/) (Node.js runtime, 60s default timeout).
+  - `'edge'`: [Netlify Edge Functions](https://docs.netlify.com/build/edge-functions/overview/) (Deno-based runtime, runs at the edge closest to users, without a fixed timeout).
 
 ### Edge functions example
 

package/.docs/reference/deployer/vercel.md

@@ -49,10 +49,10 @@ export const mastra = new Mastra({
 
 The deployer accepts the following options:
 
-- `studio?: boolean` — Deploy [Studio](https://mastra.ai/docs/studio/overview) alongside your API as static assets served from Vercel's Edge CDN. Defaults to `false`.
-- `maxDuration?: number` — Function execution timeout (in seconds)
-- `memory?: number` — Function memory (in MB)
-- `regions?: string[]` — Regions to deploy the function (e.g. `['sfo1','iad1']`)
+- `studio?: boolean`: Deploy [Studio](https://mastra.ai/docs/studio/overview) alongside your API as static assets served from Vercel's Edge CDN. Defaults to `false`.
+- `maxDuration?: number`: Function execution timeout (in seconds)
+- `memory?: number`: Function memory (in MB)
+- `regions?: string[]`: Regions to deploy the function (e.g. `['sfo1','iad1']`)
 
 The `maxDuration`, `memory`, and `regions` options are merged into `.vercel/output/functions/index.func/.vc-config.json` while preserving default fields (`handler`, `launcherType`, `runtime`, `shouldAddHelpers`).
 
@@ -78,9 +78,9 @@ After running `mastra build`, the deployer generates a `.vercel/output` director
 
 The output contains:
 
-- **config.json** — Routing configuration that directs requests to the appropriate handler
-- **functions/** — Your Mastra server bundled as a serverless function
-- **static/** — Studio SPA assets (only when `studio: true`)
+- **config.json**: Routing configuration that directs requests to the appropriate handler
+- **functions/**: Your Mastra server bundled as a serverless function
+- **static/**: Studio SPA assets (only when `studio: true`)
 
 Without studio:
 

package/.docs/reference/editor/agent-builder/agent-builder-options.md

@@ -70,7 +70,7 @@ new MastraEditor({
 
 ## Related
 
-- [Configuration](https://mastra.ai/docs/agent-builder/configuration) — concept and worked examples.
-- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — full schema for `configuration.agent`.
-- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models) — model allowlist and default model.
-- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — the parent surface that hosts `builder`.
+- [Configuration](https://mastra.ai/docs/agent-builder/configuration): Concept and worked examples.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults): Full schema for `configuration.agent`.
+- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models): Model allowlist and default model.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): The parent surface that hosts `builder`.

package/.docs/reference/editor/agent-builder/builder-agent-defaults.md

@@ -71,9 +71,9 @@ new MastraEditor({
 
 ## Related
 
-- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options) — the parent options object.
-- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models) — admin-facing model allowlist and default.
-- [SerializedMemoryConfig](https://mastra.ai/reference/memory/serialized-memory-config) — memory shape for new agents.
-- [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref) — workspace reference shape.
-- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref) — browser reference shape.
-- [Configuration](https://mastra.ai/docs/agent-builder/configuration) — concept and worked examples.
+- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options): The parent options object.
+- [builder.configuration.agent.models](https://mastra.ai/reference/editor/agent-builder/builder-models): Admin-facing model allowlist and default.
+- [SerializedMemoryConfig](https://mastra.ai/reference/memory/serialized-memory-config): Memory shape for new agents.
+- [StorageWorkspaceRef](https://mastra.ai/reference/editor/storage-workspace-ref): Workspace reference shape.
+- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref): Browser reference shape.
+- [Configuration](https://mastra.ai/docs/agent-builder/configuration): Concept and worked examples.

package/.docs/reference/editor/agent-builder/builder-models.md

@@ -61,6 +61,6 @@ Mastra validates the admin policy at server boot. Violations surface as warnings
 
 ## Related
 
-- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults) — parent object containing `models`.
-- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options) — the top-level Builder options.
-- [Model policy](https://mastra.ai/docs/agent-builder/model-policy) — concept and worked examples.
+- [BuilderAgentDefaults](https://mastra.ai/reference/editor/agent-builder/builder-agent-defaults): Parent object containing `models`.
+- [AgentBuilderOptions](https://mastra.ai/reference/editor/agent-builder/agent-builder-options): The top-level Builder options.
+- [Model policy](https://mastra.ai/docs/agent-builder/model-policy): Concept and worked examples.

package/.docs/reference/editor/blob-store-provider.md

@@ -58,4 +58,4 @@ When no `providerId` is passed to `MastraEditor.resolveBlobStore()`, the editor
 
 ## Related
 
-- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry and `resolveBlobStore()` method.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry and `resolveBlobStore()` method.

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

@@ -72,6 +72,6 @@ new MastraEditor({
 
 ## Related
 
-- [Browser](https://mastra.ai/docs/agent-builder/browser) — concept and worked examples.
-- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref) — stored configuration consumed by `createBrowser`.
-- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry.
+- [Browser](https://mastra.ai/docs/agent-builder/browser): Concept and worked examples.
+- [StorageBrowserRef](https://mastra.ai/reference/editor/storage-browser-ref): Stored configuration consumed by `createBrowser`.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry.

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

@@ -58,7 +58,7 @@ Once registered, admins can reference the provider from an inline workspace conf
 
 ## 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 `createFilesystem`.
-- [SandboxProvider](https://mastra.ai/reference/editor/sandbox-provider) — sibling provider for command execution.
-- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry.
+- [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 `createFilesystem`.
+- [SandboxProvider](https://mastra.ai/reference/editor/sandbox-provider): Sibling provider for command execution.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry.

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

@@ -61,10 +61,10 @@ Each provider field above takes a record keyed by provider id. See the per-provi
 
 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.
+- [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
 
@@ -83,7 +83,7 @@ export const mastra = new Mastra({
 })
 ```
 
-The key name (`builderAgent`) is conventional — any key works. The `@mastra/editor/ee` subpath is gated by the Mastra Enterprise Edition license at runtime.
+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.
 

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

@@ -4,8 +4,8 @@
 
 `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.
+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`.
 
@@ -63,4 +63,4 @@ export const myProcessorProvider: ProcessorProvider = {
 
 ## Related
 
-- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor) — provider registry.
+- [MastraEditor class](https://mastra.ai/reference/editor/mastra-editor): Provider registry.

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

@@ -57,7 +57,7 @@ Once registered, admins can reference the provider from an inline workspace conf
 
 ## 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.
+- [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

@@ -38,7 +38,7 @@ new MastraEditor({
 type StorageBrowserRef = { type: 'inline'; config: StorageBrowserConfig }
 ```
 
-A `{ type: 'id' }` variant for browsers isn't available — they're always inlined.
+A `{ type: 'id' }` variant for browsers isn't available: they're always inlined.
 
 ## Properties
 
@@ -72,11 +72,11 @@ The shape embedded under `config`. Defined in `@mastra/core/storage`.
 
 ## 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 isn't registered, the editor logs a warning and returns `undefined` — the agent still loads, but without a browser.
+`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 isn't 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.
+- [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

@@ -89,7 +89,7 @@ The shape embedded under `{ type: 'inline', config }`. Defined in `@mastra/core/
 
 ## 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.
+- [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/editor/tool-provider.md

@@ -2,7 +2,7 @@
 
 # ToolProvider
 
-The `ToolProvider` interface defines how the editor discovers and resolves integration tools from external platforms. Mastra ships with two built-in implementations: `ComposioToolProvider` and `ArcadeToolProvider`.
+The `ToolProvider` interface defines how the editor discovers and resolves integration tools from external platforms. Mastra includes two built-in implementations: `ComposioToolProvider` and `ArcadeToolProvider`.
 
 See [Tools](https://mastra.ai/docs/editor/tools) for a guide on setting up tool providers.
 

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

@@ -39,7 +39,7 @@ The scorer evaluates relevancy through query-answer alignment, considering compl
 ### Scoring Process
 
 1. **Statement Preprocess:**
-   - Breaks output into meaningful statements while preserving context.
+   - Breaks output into useful statements while preserving context.
 
 2. **Relevance Analysis:**
 
@@ -57,9 +57,9 @@ The scorer evaluates relevancy through query-answer alignment, considering compl
 A relevancy score between 0 and 1:
 
 - **1.0**: The response fully answers the query with relevant and focused information.
-- **0.7–0.9**: The response mostly answers the query but may include minor unrelated content.
-- **0.4–0.6**: The response partially answers the query, mixing relevant and unrelated information.
-- **0.1–0.3**: The response includes minimal relevant content and largely misses the intent of the query.
+- **0.7 to 0.9**: The response mostly answers the query but may include minor unrelated content.
+- **0.4 to 0.6**: The response partially answers the query, mixing relevant and unrelated information.
+- **0.1 to 0.3**: The response includes minimal relevant content and largely misses the intent of the query.
 - **0.0**: The response is entirely unrelated and doesn't answer the query.
 
 ## Example
@@ -71,7 +71,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.5' })
+const scorer = createAnswerRelevancyScorer({ model: 'openai/gpt-5.6-sol' })
 
 const result = await runEvals({
   data: [

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

@@ -64,7 +64,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.5' })
+const scorer = createAnswerSimilarityScorer({ model: 'openai/gpt-5.6-sol' })
 
 const result = await runEvals({
   data: [

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

@@ -70,9 +70,9 @@ Final score: `(biased_opinions / total_opinions) * scale`
 A bias score between 0 and 1:
 
 - **1.0**: Contains explicit discriminatory or stereotypical statements.
-- **0.7–0.9**: Includes strong prejudiced assumptions or generalizations.
-- **0.4–0.6**: Mixes reasonable points with subtle bias or stereotypes.
-- **0.1–0.3**: Mostly neutral with minor biased language or assumptions.
+- **0.7 to 0.9**: Includes strong prejudiced assumptions or generalizations.
+- **0.4 to 0.6**: Mixes reasonable points with subtle bias or stereotypes.
+- **0.1 to 0.3**: Mostly neutral with minor biased language or assumptions.
 - **0.0**: Completely objective and free from bias.
 
 ## Example
@@ -84,7 +84,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.5' })
+const scorer = createBiasScorer({ model: 'openai/gpt-5.6-sol' })
 
 const result = await runEvals({
   data: [

package/.docs/reference/evals/checks.md

@@ -2,7 +2,7 @@
 
 # Quick Checks
 
-Quick Checks are zero-LLM, composable micro-scorers for common assertions. They plug into the existing `scorers: [...]` array anywhere scorers are used — in `runEvals`, live scoring, experiments, and Studio.
+Quick Checks are zero-LLM, composable micro-scorers for common assertions. They plug into the existing `scorers: [...]` array anywhere scorers are used: in `runEvals`, live scoring, experiments, and Studio.
 
 Internally they're standard `createScorer()` instances, so they have the same observability, storage, and pipeline integration as any other scorer.
 
@@ -76,7 +76,7 @@ Returns: `1` if equal, `0` otherwise.
 
 ### `checks.matches(pattern, options?)`
 
-Scores 1 if the output matches the given regular expression.
+Scores 1 if the output matches the regular expression.
 
 ```typescript
 checks.matches(/\d+°[FC]/)
@@ -137,7 +137,7 @@ Returns: `1` if the tool wasn't called, `0` otherwise.
 
 ### `checks.toolOrder(expectedOrder)`
 
-Scores 1 if the tools were called in the specified order. Uses relaxed matching — other tool calls between the expected tools are allowed.
+Scores 1 if the tools were called in the specified order. Uses relaxed matching. Other tool calls between the expected tools are allowed.
 
 ```typescript
 checks.toolOrder(['search', 'summarize', 'respond'])

package/.docs/reference/evals/completeness.md

@@ -40,7 +40,7 @@ The scorer extracts and analyzes several types of elements:
 - Nouns: Key objects, concepts, and entities
 - Verbs: Actions and states (converted to infinitive form)
 - Topics: Main subjects and themes
-- Terms: Individual significant words
+- Terms: Individual substantial words
 
 The extraction process includes:
 
@@ -83,10 +83,10 @@ Final score: `(covered_elements / total_input_elements) * scale`
 
 A completeness score between 0 and 1:
 
-- **1.0**: Thoroughly addresses all aspects of the query with comprehensive detail.
-- **0.7–0.9**: Covers most important aspects with good detail, minor gaps.
-- **0.4–0.6**: Addresses some key points but missing important aspects or lacking detail.
-- **0.1–0.3**: Only partially addresses the query with significant gaps.
+- **1.0**: Thoroughly addresses all aspects of the query with detailed detail.
+- **0.7 to 0.9**: Covers most important aspects with good detail, minor gaps.
+- **0.4 to 0.6**: Addresses some key points but missing important aspects or lacking detail.
+- **0.1 to 0.3**: Only partially addresses the query with substantial gaps.
 - **0.0**: Fails to address the query or provides irrelevant information.
 
 ## Example

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

@@ -89,11 +89,11 @@ To add this scorer to an agent, see the [Scorers overview](https://mastra.ai/doc
 
 A similarity score between 0 and 1:
 
-- **1.0**: Perfect match – content is nearly identical.
-- **0.7–0.9**: High similarity – minor differences in word choice or structure.
-- **0.4–0.6**: Moderate similarity – general overlap with noticeable variation.
-- **0.1–0.3**: Low similarity – few common elements or shared meaning.
-- **0.0**: No similarity – completely different content.
+- **1.0**: Perfect match, content is nearly identical.
+- **0.7 to 0.9**: High similarity, minor differences in word choice or structure.
+- **0.4 to 0.6**: Moderate similarity, general overlap with noticeable variation.
+- **0.1 to 0.3**: Low similarity, few common elements or shared meaning.
+- **0.0**: No similarity, completely different content.
 
 ## Related
 

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

@@ -28,7 +28,7 @@ Use when optimizing context selection for:
 
 **options** (`ContextPrecisionMetricOptions`): Configuration options for the scorer
 
-**Note**: Either `context` or `contextExtractor` must be provided. If both are provided, `contextExtractor` takes precedence.
+Either `context` or `contextExtractor` must be provided. If both are provided, `contextExtractor` takes precedence.
 
 ## `.run()` returns
 
@@ -85,7 +85,7 @@ Use results to:
 
 ### Example Calculation
 
-Given context: `[relevant, irrelevant, relevant, irrelevant]`
+context: `[relevant, irrelevant, relevant, irrelevant]`
 
 - Position 0: Relevant → Precision = 1/1 = 1.0
 - Position 1: Skip (irrelevant)
@@ -100,7 +100,7 @@ MAP = (1.0 + 0.67) / 2 = 0.835 ≈ **0.83**
 
 ```typescript
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract context dynamically based on the query
@@ -119,7 +119,7 @@ const scorer = createContextPrecisionScorer({
 
 ```typescript
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     context: [
       // Simulate retrieved documents from vector database
@@ -144,7 +144,7 @@ import { createContextPrecisionScorer } from '@mastra/evals/scorers/prebuilt'
 import { myAgent } from './agent'
 
 const scorer = createContextPrecisionScorer({
-  model: 'openai/gpt-5.5',
+  model: 'openai/gpt-5.6-sol',
   options: {
     contextExtractor: (input, output) => {
       // Extract context from agent's retrieved documents