@mastra/mcp-docs-server 1.1.8 → 1.1.9-alpha.0

package/.docs/reference/agents/getDefaultGenerateOptions.md

@@ -2,7 +2,7 @@
 
 > **Warning:** **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](https://mastra.ai/reference/agents/getDefaultOptions) method instead.
 
-Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they are functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they're functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDefaultOptions.md

@@ -1,6 +1,6 @@
 # Agent.getDefaultOptions()
 
-Agents can be configured with default options for memory usage, output format, and iteration steps. The `.getDefaultOptions()` method returns these defaults, resolving them if they are functions. These options apply to all `stream()` and `generate()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default options for memory usage, output format, and iteration steps. The `.getDefaultOptions()` method returns these defaults, resolving them if they're functions. These options apply to all `stream()` and `generate()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDefaultStreamOptions.md

@@ -2,7 +2,7 @@
 
 > **Warning:** **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](https://mastra.ai/reference/agents/getDefaultOptions) method instead.
 
-Agents can be configured with default streaming options for memory usage, output format, and iteration steps. The `.getDefaultStreamOptionsLegacy()` method returns these defaults, resolving them if they are functions. These options apply to all `streamLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default streaming options for memory usage, output format, and iteration steps. The `.getDefaultStreamOptionsLegacy()` method returns these defaults, resolving them if they're functions. These options apply to all `streamLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDescription.md

@@ -1,6 +1,6 @@
 # Agent.getDescription()
 
-The `.getDescription()` method retrieves the description configured for an agent. This method returns a simple string description that describes the agent's purpose and capabilities.
+The `.getDescription()` method retrieves the description configured for an agent. This method returns a string description that describes the agent's purpose and capabilities.
 
 ## Usage example
 

package/.docs/reference/agents/network.md

@@ -1,5 +1,7 @@
 # Agent.network()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
 ## Usage example
@@ -188,7 +190,7 @@ When using structured output, additional chunk types are emitted:
 
 ## Aborting a Network
 
-Use `abortSignal` to cancel a running network. When aborted, the network stops routing, cancels any in-progress sub-agent, tool, or workflow execution, and does not save partial results to memory.
+Use `abortSignal` to cancel a running network. When aborted, the network stops routing, cancels any in-progress sub-agent, tool, or workflow execution, and doesn't save partial results to memory.
 
 ```typescript
 const controller = new AbortController()

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -40,6 +40,8 @@ export async function POST(req: Request) {
 
 **params.runId** (`string`): The run ID. Required when \`resumeData\` is provided.
 
+**params.providerOptions** (`Record<string, Record<string, unknown>>`): Provider-specific options passed to the language model (e.g. \`{ openai: { reasoningEffort: "high" } }\`). Merged with \`defaultOptions.providerOptions\`, with \`params\` taking precedence.
+
 **params.requestContext** (`RequestContext`): Request context to pass to the agent execution.
 
 **defaultOptions** (`AgentExecutionOptions`): Default options passed to agent execution. These are merged with params, with params taking precedence.

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -1,5 +1,7 @@
 # handleNetworkStream()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 Framework-agnostic handler for streaming network execution in AI SDK-compatible format. Use this function directly when you need to handle network streaming outside Hono or Mastra's own [apiRoutes](https://mastra.ai/docs/server/custom-api-routes) feature.
 
 `handleNetworkStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).

package/.docs/reference/ai-sdk/network-route.md

@@ -1,5 +1,7 @@
 # networkRoute()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
 Use [`handleNetworkStream()`](https://mastra.ai/reference/ai-sdk/handle-network-stream) if you need a framework-agnostic handler.

package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md

@@ -57,7 +57,7 @@ Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV4Messages } from '@mastra/ai-sdk'

package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md

@@ -54,7 +54,7 @@ Returns an array of AI SDK V5+ `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV5Messages } from '@mastra/ai-sdk/ui'

package/.docs/reference/auth/auth0.md

@@ -18,7 +18,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`AUTH0_DOMAIN` and `AUTH0_AUDIENCE`) set. In that case, simply use `new MastraAuthAuth0()` without any arguments.
+> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`AUTH0_DOMAIN` and `AUTH0_AUDIENCE`) set. In that case, use `new MastraAuthAuth0()` without any arguments.
 
 ## Constructor parameters
 
@@ -32,7 +32,7 @@ export const mastra = new Mastra({
 
 ## Environment Variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **AUTH0\_DOMAIN** (`string`): Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.
 
@@ -44,7 +44,7 @@ By default, `MastraAuthAuth0` validates Auth0 JWT tokens and allows access to al
 
 1. **Token Verification**: The JWT token is verified using Auth0's public keys (JWKS)
 2. **Signature Validation**: Ensures the token was signed by your Auth0 tenant
-3. **Expiration Check**: Verifies the token has not expired
+3. **Expiration Check**: Verifies the token hasn't expired
 4. **Audience Validation**: Confirms the token was issued for your specific API (audience)
 5. **Issuer Validation**: Ensures the token was issued by your Auth0 domain
 

package/.docs/reference/auth/firebase.md

@@ -46,7 +46,7 @@ export const mastra = new Mastra({
 
 ## Environment Variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **FIREBASE\_SERVICE\_ACCOUNT** (`string`): Path to Firebase service account JSON file. Used if serviceAccount option is not provided.
 

package/.docs/reference/auth/workos.md

@@ -18,7 +18,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`WORKOS_API_KEY` and `WORKOS_CLIENT_ID`) set. In that case, simply use `new MastraAuthWorkos()` without any arguments.
+> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`WORKOS_API_KEY` and `WORKOS_CLIENT_ID`) set. In that case, use `new MastraAuthWorkos()` without any arguments.
 
 ## Constructor parameters
 
@@ -32,7 +32,7 @@ export const mastra = new Mastra({
 
 ## Environment Variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **WORKOS\_API\_KEY** (`string`): Your WorkOS API key. Can be found in your WorkOS Dashboard under API Keys.
 

package/.docs/reference/cli/mastra.md

@@ -30,7 +30,7 @@ Comma-separated list of custom arguments to pass to the Node.js process, e.g. `-
 
 #### `--request-context-presets`
 
-Path to a JSON file containing named [request context](https://mastra.ai/docs/server/request-context) presets. When provided, a dropdown appears in Studio's request context editor, letting you quickly switch between preset configurations.
+Path to a JSON file containing named [request context](https://mastra.ai/docs/server/request-context) presets. When provided, a dropdown displays in Studio's request context editor, letting you quickly switch between preset configurations.
 
 ```bash
 mastra dev --request-context-presets ./presets.json
@@ -57,7 +57,7 @@ Set `MASTRA_SKIP_PEERDEP_CHECK=1` to skip the peer dependency version mismatch c
 MASTRA_SKIP_PEERDEP_CHECK=1 mastra dev
 ```
 
-This is useful during monorepo development when peer dependencies may be bumped but packages are not yet published.
+This is useful during monorepo development when peer dependencies may be bumped but packages aren't yet published.
 
 #### Disable build caching
 
@@ -101,7 +101,7 @@ These are forwarded to the Mastra model router and will work with any `"openai/.
 
 ## `mastra build`
 
-The `mastra build` command bundles your Mastra project into a production-ready Hono server. [Hono](https://hono.dev/) is a lightweight, type-safe web framework that makes it easy to deploy Mastra agents as HTTP endpoints with middleware support.
+The `mastra build` command bundles your Mastra project into a production-ready Hono server. [Hono](https://hono.dev/) is a lightweight, type-safe web framework that makes it straightforward to deploy Mastra agents as HTTP endpoints with middleware support.
 
 Under the hood Mastra's Rollup server locates your Mastra entry file and bundles it to a production-ready Hono server. During that bundling it tree-shakes your code and generates source maps for debugging.
 
@@ -253,7 +253,7 @@ If enabled, example code is written to the list of components (e.g. example agen
 
 #### `--no-example`
 
-Do not include example code. Useful when using the `--default` flag.
+Don't include example code. Useful when using the `--default` flag.
 
 #### `--mcp`
 

package/.docs/reference/client-js/mastra-client.md

@@ -1,6 +1,6 @@
 # Mastra Client SDK
 
-The Mastra Client SDK provides a simple and type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/deployment/mastra-server) from your client environment.
+The Mastra Client SDK provides a type-safe interface for interacting with your [Mastra Server](https://mastra.ai/docs/deployment/mastra-server) from your client environment.
 
 ## Usage example
 

package/.docs/reference/configuration.md

@@ -59,7 +59,7 @@ export const mastra = new Mastra({
 
 Event handlers for the internal pub/sub system. Maps event topics to handler functions that are called when events are published to those topics.
 
-> **Warning:** This is used internally by Mastra's workflow engine. Most users will not need to configure this option.
+> **Warning:** This is used internally by Mastra's workflow engine. Most users won't need to configure this option.
 
 ```typescript
 import { Mastra } from '@mastra/core'
@@ -94,19 +94,39 @@ export const mastra = new Mastra({
 
 ### idGenerator
 
-**Type:** `() => string`\
+**Type:** `(context?: IdGeneratorContext) => string`\
 **Default:** `crypto.randomUUID()`
 
-Custom ID generator function for creating unique identifiers.
+Custom ID generator function for creating unique identifiers. Mastra passes optional context so you can generate IDs based on what's being created.
 
-> **Warning:** This is used internally by Mastra for creating IDs for workflow runs, agent conversations, and other resources. Most users will not need to configure this option.
+`IdGeneratorContext` includes:
+
+- `idType`: `'thread' | 'message' | 'run' | 'step' | 'generic'`
+- `source?`: `'agent' | 'workflow' | 'memory'`
+- `entityId?`: ID of the requesting agent/workflow/memory entity
+- `threadId?`: Thread ID when relevant (for example, when creating message IDs)
+- `resourceId?`: Resource ID when relevant (for example, user-scoped threads)
+- `role?`: Message role when creating a message ID
+- `stepType?`: Workflow step type when creating a step ID
+
+> **Warning:** This is used internally by Mastra for creating IDs for workflow runs, agent conversations, and other resources. Most users won't need to configure this option.
 
 ```typescript
 import { Mastra } from '@mastra/core'
 import { nanoid } from 'nanoid'
 
 export const mastra = new Mastra({
-  idGenerator: () => nanoid(),
+  idGenerator: context => {
+    if (context?.idType === 'message' && context?.threadId) {
+      return `msg-${context.threadId}-${nanoid(8)}`
+    }
+
+    if (context?.idType === 'run' && context?.source && context?.entityId) {
+      return `${context.source}-run-${context.entityId}-${nanoid(6)}`
+    }
+
+    return nanoid()
+  },
 })
 ```
 
@@ -243,7 +263,7 @@ export const mastra = new Mastra({
 
 Pub/sub system for event-driven communication between components. Used internally by Mastra for workflow event processing and component communication.
 
-> **Warning:** This is used internally by Mastra. Most users will not need to configure this option.
+> **Warning:** This is used internally by Mastra. Most users won't need to configure this option.
 
 ```typescript
 import { Mastra } from '@mastra/core'
@@ -693,6 +713,42 @@ export const mastra = new Mastra({
 })
 ```
 
+### server.onValidationError
+
+**Type:** `(error: ZodError, context: 'query' | 'body' | 'path') => { status: number; body: unknown } | undefined`
+
+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).
+
+The `context` parameter indicates which part of the request failed validation:
+
+- `'query'` — query parameters
+- `'body'` — request body
+- `'path'` — path parameters
+
+```typescript
+import { Mastra } from '@mastra/core'
+
+export const mastra = new Mastra({
+  server: {
+    onValidationError: (error, context) => ({
+      status: 422,
+      body: {
+        ok: false,
+        errors: error.issues.map(i => ({
+          path: i.path.join('.'),
+          message: i.message,
+        })),
+        source: context,
+      },
+    }),
+  },
+})
+```
+
+You can also set `onValidationError` on individual routes created with `createRoute()`. A route-level hook takes precedence over the server-level hook.
+
 ### server.port
 
 **Type:** `number`\

package/.docs/reference/core/getDeployer.md

@@ -10,7 +10,7 @@ mastra.getDeployer()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/getLogger.md

@@ -10,7 +10,7 @@ mastra.getLogger()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

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

@@ -1,6 +1,6 @@
 # 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 is not found.
+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.
 
 ## Usage Example
 
@@ -34,7 +34,7 @@ await weatherAgent.generate('What is the weather in Rome', {
 
 This method throws a `MastraError` if:
 
-- The scorer with the specified key is not found
+- The scorer with the specified key isn't found
 - No scorers are registered with the Mastra instance
 
 ```typescript

package/.docs/reference/core/getServer.md

@@ -10,7 +10,7 @@ mastra.getServer()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/getStorage.md

@@ -10,7 +10,7 @@ mastra.getStorage()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/getStoredAgentById.md

@@ -46,7 +46,7 @@ When creating an `Agent` instance from stored configuration, the method resolves
 - **Memory**: Resolved from `memory` registered in Mastra config
 - **Scorers**: Resolved from `scorers` registered in Mastra config, including sampling configuration
 
-If a referenced primitive is not found in the registry, a warning is logged but the agent is still created.
+If a referenced primitive isn't found in the registry, a warning is logged but the agent is still created.
 
 ## StorageAgentType
 

package/.docs/reference/core/getTelemetry.md

@@ -10,7 +10,7 @@ mastra.getTelemetry()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/getWorkflow.md

@@ -25,7 +25,7 @@ For best TypeScript support, use `getWorkflow()` with the workflow's **registrat
 - Output data schemas
 - Step results
 
-If you need to retrieve a workflow by its `id` property instead of its registration key, you can use `getWorkflowById()`, but note that type inference will not be as precise.
+If you need to retrieve a workflow by its `id` property instead of its registration key, you can use `getWorkflowById()`, but note that type inference won't be as precise.
 
 ## Parameters
 

package/.docs/reference/core/listAgents.md

@@ -10,7 +10,7 @@ mastra.listAgents()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/listMCPServers.md

@@ -38,7 +38,7 @@ const servers = mastra.listMCPServers()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

package/.docs/reference/core/listStoredAgents.md

@@ -63,7 +63,7 @@ When creating `Agent` instances (default behavior), each stored agent's configur
 - **Memory**: Resolved from `memory` registered in Mastra config
 - **Scorers**: Resolved from `scorers` registered in Mastra config
 
-If a referenced primitive is not found, a warning is logged but the agent is still created.
+If a referenced primitive isn't found, a warning is logged but the agent is still created.
 
 ## Example: Iterating Through All Stored Agents
 

package/.docs/reference/core/listVectors.md

@@ -10,7 +10,7 @@ mastra.listVectors()
 
 ## Parameters
 
-This method does not accept any parameters.
+This method doesn't accept any parameters.
 
 ## Returns
 

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

@@ -41,7 +41,7 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **logger** (`Logger`): Logger instance created with new PinoLogger() (Default: `Console logger with INFO level`)
 
-**idGenerator** (`() => string`): Custom ID generator function. Used by agents, workflows, memory, and other components to generate unique identifiers.
+**idGenerator** (`(context?: IdGeneratorContext) => string`): Custom ID generator function. Used by agents, workflows, memory, and other components to generate unique identifiers. Receives optional context such as idType, source, entityId, and threadId to support context-aware ID formats.
 
 **workflows** (`Record<string, Workflow>`): Workflows to register. Structured as a key-value pair, with keys being the workflow name and values being the workflow instance. (Default: `{}`)
 

package/.docs/reference/core/setLogger.md

@@ -16,7 +16,7 @@ mastra.setLogger({ logger: new PinoLogger({ name: 'testLogger' }) })
 
 ## Returns
 
-This method does not return a value.
+This method doesn't return a value.
 
 ## Related
 

package/.docs/reference/core/setStorage.md

@@ -19,7 +19,7 @@ mastra.setStorage(
 
 ## Returns
 
-This method does not return a value.
+This method doesn't return a value.
 
 ## Related
 

package/.docs/reference/datasets/dataset.md

@@ -60,7 +60,7 @@ const history = await dataset.getItemHistory({ itemId: 'item-id' })
 
 ## Access
 
-`Dataset` is not instantiated directly. Obtain one via `DatasetsManager`:
+`Dataset` isn't instantiated directly. Obtain one via `DatasetsManager`:
 
 ```typescript
 const dataset = await mastra.datasets.get({ id: 'dataset-id' })

package/.docs/reference/datasets/datasets-manager.md

@@ -78,7 +78,7 @@ const comparison = await mastra.datasets.compareExperiments({
 
 ## Access
 
-`DatasetsManager` is not instantiated directly. Access it from a `Mastra` instance:
+`DatasetsManager` isn't instantiated directly. Access it from a `Mastra` instance:
 
 ```typescript
 const mastra = new Mastra({

package/.docs/reference/datasets/get.md

@@ -2,7 +2,7 @@
 
 **Added in:** `@mastra/core@1.4.0`
 
-Retrieves an existing dataset by ID. Throws a `MastraError` if the dataset does not exist.
+Retrieves an existing dataset by ID. Throws a `MastraError` if the dataset doesn't exist.
 
 ## Usage example
 
@@ -26,6 +26,6 @@ console.log(details.name)
 
 ## Returns
 
-Throws `MastraError` if the dataset is not found.
+Throws `MastraError` if the dataset isn't found.
 
 **result** (`Promise<Dataset>`): A Dataset instance.

package/.docs/reference/datasets/getDetails.md

@@ -26,7 +26,7 @@ This method takes no parameters.
 
 ## Returns
 
-Returns a `Promise<DatasetRecord>`. Throws `MastraError` if the dataset is not found.
+Returns a `Promise<DatasetRecord>`. Throws `MastraError` if the dataset isn't found.
 
 **id** (`string`): Unique identifier of the dataset.
 

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

@@ -41,7 +41,7 @@ When `version` is specified:
 
 **result** (`Promise<DatasetItem[]>`): Array of all items at the specified dataset version.
 
-When `version` is not specified:
+When `version` isn't specified:
 
 **result** (`Promise<object>`): Paginated response.
 

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

@@ -113,4 +113,4 @@ With `studio: true`:
 
 When studio is enabled, the routing is configured so that `/api/*` requests are handled by the serverless function, static assets (JS, CSS) are served from Vercel's Edge CDN with no function invocations, and all other paths fall back to `index.html` for client-side routing.
 
-This folder is generated during build and should not be committed to version control.
+This folder is generated during build and shouldn't be committed to version control.

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

@@ -58,7 +58,7 @@ A relevancy score between 0 and 1:
 - **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.0**: The response is entirely unrelated and does not answer the query.
+- **0.0**: The response is entirely unrelated and doesn't answer the query.
 
 ## Example
 

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

@@ -4,7 +4,7 @@ The `createCompletenessScorer()` function evaluates how thoroughly an LLM's outp
 
 ## Parameters
 
-The `createCompletenessScorer()` function does not take any options.
+The `createCompletenessScorer()` function doesn't take any options.
 
 This function returns an instance of the MastraScorer class. See the [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer) for details on the `.run()` method and its input/output.
 

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

@@ -2,14 +2,14 @@
 
 The `createContextPrecisionScorer()` function creates a scorer that evaluates how relevant and well-positioned retrieved context pieces are for generating expected outputs. It uses **Mean Average Precision (MAP)** to reward systems that place relevant context earlier in the sequence.
 
-It is especially useful for these use cases:
+It's especially useful for these use cases:
 
 ## RAG System Evaluation
 
 Ideal for evaluating retrieved context in RAG pipelines where:
 
 - Context ordering matters for model performance
-- You need to measure retrieval quality beyond simple relevance
+- You need to measure retrieval quality beyond basic relevance
 - Early relevant context is more valuable than later relevant context
 
 ## Context Window Optimization
@@ -77,7 +77,7 @@ The reason field explains:
 Use results to:
 
 - **Improve retrieval**: Filter out irrelevant context before ranking
-- **Optimize ranking**: Ensure relevant context appears early
+- **Optimize ranking**: Ensure relevant context surfaces early
 - **Tune chunk size**: Balance context detail vs. relevance precision
 - **Evaluate embeddings**: Test different embedding models for better retrieval
 

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

@@ -2,7 +2,7 @@
 
 The `createContextRelevanceScorerLLM()` function creates a scorer that evaluates how relevant and useful provided context was for generating agent responses. It uses weighted relevance levels and applies penalties for unused high-relevance context and missing information.
 
-It is especially useful for these use cases:
+It's especially useful for these use cases:
 
 ## Content Generation Evaluation
 

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

@@ -8,20 +8,14 @@ The `createHallucinationScorer()` function accepts a single options object with
 
 **model** (`LanguageModel`): Configuration for the model used to evaluate hallucination.
 
-**options.scale** (`number`): Maximum score value. (Default: `1`)
+**options** (`Options`): Configuration options.
+
+**options.scale** (`number`): Maximum score value.
 
 **options.context** (`string[]`): Static context strings to use as ground truth for hallucination detection.
 
 **options.getContext** (`(params: GetContextParams) => string[] | Promise<string[]>`): A hook to dynamically resolve context at runtime. Takes priority over static context. Useful for live scoring where context (like tool results) is only available when the scorer runs.
 
-**options.getContext.run** (`GetContextRun`): The scorer run containing input, output, runId, requestContext, and tracingContext.
-
-**options.getContext.results** (`Record<string, any>`): Accumulated results from previous steps (e.g., preprocessStepResult with extracted claims).
-
-**options.getContext.score** (`number`): The computed score. Only present when called from the generateReason step.
-
-**options.getContext.step** (`'analyze' | 'generateReason'`): Which step is calling the hook. Useful for caching context between calls.
-
 This function returns an instance of the MastraScorer class. The `.run()` method accepts the same input as other scorers (see the [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer)), but the return value includes LLM-specific fields as documented below.
 
 ## .run() Returns

package/.docs/reference/evals/keyword-coverage.md

@@ -4,7 +4,7 @@ The `createKeywordCoverageScorer()` function evaluates how well an LLM's output
 
 ## Parameters
 
-The `createKeywordCoverageScorer()` function does not take any options.
+The `createKeywordCoverageScorer()` function doesn't take any options.
 
 This function returns an instance of the MastraScorer class. See the [MastraScorer reference](https://mastra.ai/reference/evals/mastra-scorer) for details on the `.run()` method and its input/output.