@mastra/mcp-docs-server 1.2.4 → 1.2.5-alpha.3

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

@@ -193,8 +193,151 @@ Path to a JSON file containing named [request context](https://mastra.ai/docs/se
 mastra studio --request-context-presets ./presets.json
 ```
 
+## `mastra deploy`
+
+Builds and deploys your project to a named environment on Mastra platform. This is the recommended command for all new deploys and replaces both [`mastra studio deploy`](#mastra-studio-deploy) and [`mastra server deploy`](#mastra-server-deploy), which continue to work but should no longer be used for new setups.
+
+Requires authentication via [`mastra auth login`](#mastra-auth-login) or a `MASTRA_API_TOKEN` environment variable.
+
+```bash
+mastra deploy
+mastra deploy --env staging
+mastra deploy --env production --region eu
+```
+
+The command runs `mastra build`, zips the output, uploads it to the selected environment, and then polls the deploy status while streaming build logs until the deploy reaches a terminal state.
+
+Organization, project, and environment are resolved in order from: environment variable (`MASTRA_ORG_ID`, `MASTRA_PROJECT_ID`), CLI flag (`--org`, `--project`, `--env`), `.mastra-project.json` config file, current org from credentials, and lastly interactive prompt. On first deploy, the CLI saves the resolved org and project IDs to `.mastra-project.json` so subsequent deploys skip the prompts.
+
+If the project doesn't exist yet, the CLI creates it from the `package.json` `name` field after confirmation. If the target environment doesn't exist, the CLI creates it (defaulting to `type: staging` for anything other than `production`) after confirmation. Combined with `--yes`, this creates and deploys everything in one non-interactive command:
+
+```bash
+mastra deploy --env staging --yes
+```
+
+When `--env <name>` is set and `--env-file` is not, the CLI auto-selects `.env.<name>` from the project directory if present (for example `.env.staging`). The `<name>` value is validated against a strict allowlist before being interpolated into a file path.
+
+### Arguments
+
+#### `[dir]`
+
+Project directory. Defaults to the current directory.
+
+### Flags
+
+#### `--env`
+
+Target environment name. Defaults to `production`. Auto-selects `.env.<name>` from the project directory when `--env-file` is not set. If the environment doesn't exist, the CLI creates it after confirmation.
+
+#### `--org`
+
+Organization ID. Can also be set via the `MASTRA_ORG_ID` environment variable.
+
+#### `--project`
+
+Project ID, slug, or name. Can also be set via the `MASTRA_PROJECT_ID` environment variable. If no project matches, the value is used as the name of a new project to create on deploy.
+
+#### `-y, --yes`
+
+Auto-accept defaults without confirmation prompts, including creating projects and environments.
+
+#### `-c, --config`
+
+Path to the project config file. Defaults to `.mastra-project.json`.
+
+#### `--env-file`
+
+Path to the env file to bundle with the deploy (relative to the project directory). When set, disables the `.env.<name>` auto-selection based on `--env`.
+
+```bash
+mastra deploy --env staging --env-file .env.staging.local
+```
+
+#### `--region`
+
+Region for a newly created environment (for example `eu`). Applied only when the CLI creates the environment.
+
+#### `--skip-build`
+
+Skip the build step and deploy the existing `.mastra/output` directory. The CLI warns if the existing build is stale relative to the current source.
+
+#### `--skip-preflight`
+
+Skip the pre-upload validation of the built output.
+
+#### `--debug`
+
+Enable debug logs during the build step.
+
+### CI/CD usage
+
+Set `MASTRA_API_TOKEN`, `MASTRA_ORG_ID`, and `MASTRA_PROJECT_ID` as environment variables for headless deploys. Interactive prompts are skipped automatically when `MASTRA_API_TOKEN` is set. Combine with `--yes` to auto-accept environment creation.
+
+```bash
+export MASTRA_API_TOKEN="..."
+export MASTRA_ORG_ID="..."
+export MASTRA_PROJECT_ID="..."
+mastra deploy --env staging --yes
+```
+
+## `mastra env`
+
+Manages environments on Mastra platform. Environments are named deploy targets (for example `production`, `staging`, `preview-42`) that belong to a project. Every subcommand takes a `<project>` argument (name, slug, or ID) and resolves the current organization from stored credentials.
+
+### `mastra env list`
+
+Lists environments for a project.
+
+```bash
+mastra env list <project>
+```
+
+#### `--json`
+
+Emit machine-readable JSON. Only non-sensitive metadata (id, name, slug, type, region, branch, and URLs) is included so the output is safe to log in CI.
+
+### `mastra env create`
+
+Creates a new environment for a project.
+
+```bash
+mastra env create <project> --name staging --type staging --region eu
+```
+
+#### `-n, --name`
+
+Environment name (required).
+
+#### `-t, --type`
+
+Environment type. One of `production`, `staging`, or `preview`. Defaults to `staging`.
+
+#### `-r, --region`
+
+Region for the environment (for example `eu`).
+
+#### `--json`
+
+Emit machine-readable JSON. Sensitive fields are omitted, as with [`mastra env list`](#mastra-env-list).
+
+### `mastra env delete`
+
+Deletes an environment.
+
+```bash
+mastra env delete <project> <env>
+```
+
+`<env>` can be an environment name, slug, or ID. The CLI prompts for confirmation unless `--yes` is passed.
+
+#### `-y, --yes`
+
+Skip the confirmation prompt.
+
 ## `mastra studio deploy`
 
+> **Info:** `mastra studio deploy` continues to work but is superseded by [`mastra deploy`](#mastra-deploy), which supports named environments (`--env staging`, `--env production`) on a single project. New setups should use `mastra deploy`.
+
 Builds and deploys your project to Mastra platform. Requires authentication via [`mastra auth login`](#mastra-auth-login) or a `MASTRA_API_TOKEN` environment variable.
 
 ```bash
@@ -311,6 +454,8 @@ Creates a new project through an interactive prompt. This command doesn't accept
 
 ## `mastra server deploy`
 
+> **Info:** `mastra server deploy` continues to work but is superseded by [`mastra deploy`](#mastra-deploy), which deploys a single project to multiple named environments instead of separate Studio and Server commands. New setups should use `mastra deploy`.
+
 Builds and deploys your project to Server on Mastra platform. Works the same as [`mastra studio deploy`](#mastra-studio-deploy) with the same flags, arguments, and resolution logic.
 
 The deploy command auto-loads the project's `.env` file. If `MASTRA_PROJECT_ID` points to a project that was provisioned for Observability, the deploy links to that project instead of creating a new one. Deploying Server to an observability-only project converts it into a Server project on the platform side.

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

@@ -237,21 +237,21 @@ await agent.sendSignal({
 
 Returns `{ accepted: true, runId: string }`.
 
-**signal** (`{ type: 'user' | 'reactive' | 'notification' | string; tagName?: string; contents: string | Array<TextPart | FilePart>; attributes?: Record<string, JSONValue>; metadata?: Record<string, unknown>; providerOptions?: ProviderMetadata }`): Lower-level signal payload. Use \`type\` for the semantic signal category and \`tagName\` for the XML tag shown to the model. \`providerOptions\` is attached to the resulting prompt turn and persisted on the stored signal message.
+**signal** (`{ type: 'user' | 'reactive' | 'notification' | string; tagName?: string; contents: string | Array<TextPart | FilePart>; attributes?: Record<string, JSONValue>; metadata?: Record<string, unknown>; providerOptions?: ProviderMetadata }`): Lower-level signal payload. Use type for the semantic signal category and tagName for the XML tag shown to the model. providerOptions is attached to the resulting prompt turn and persisted on the stored signal message.
 
 **runId** (`string`): Run ID to target directly.
 
-**resourceId** (`string`): Resource ID for the memory thread. Use with \`threadId\` for thread-targeted signals.
+**resourceId** (`string`): Resource ID for the memory thread. Use with threadId for thread-targeted signals.
 
-**threadId** (`string`): Thread ID to target. Use with \`resourceId\` for thread-targeted signals.
+**threadId** (`string`): Thread ID to target. Use with resourceId for thread-targeted signals.
 
-**ifActive.behavior** (`'deliver' | 'persist' | 'discard'`): Controls what happens when the target thread is active. Defaults to \`deliver\`.
+**ifActive.behavior** (`'deliver' | 'persist' | 'discard'`): Controls what happens when the target thread is active. Defaults to deliver.
 
 **ifActive.attributes** (`Record<string, string | number | boolean>`): Attributes merged into the signal when Mastra accepts it while the target thread is active.
 
-**ifIdle.behavior** (`'wake' | 'persist' | 'discard'`): Controls what happens when the target thread is idle. Defaults to \`wake\`.
+**ifIdle.behavior** (`'wake' | 'persist' | 'discard'`): Controls what happens when the target thread is idle. Defaults to wake.
 
-**ifIdle.streamOptions** (`Omit<AgentExecutionOptions, 'messages'>`): Options for the stream that starts when \`ifIdle.behavior\` is \`wake\`.
+**ifIdle.streamOptions** (`Omit<AgentExecutionOptions, 'messages'>`): Options for the stream that starts when ifIdle.behavior is wake.
 
 **ifIdle.attributes** (`Record<string, string | number | boolean>`): Attributes merged into the signal when Mastra accepts it while the target thread is idle.
 
@@ -281,11 +281,11 @@ await subscription.processDataStream({
 
 **threadId** (`string`): Thread ID to subscribe to.
 
-**processDataStream().reconnect** (`boolean | { maxRetries?: number; delayMs?: number }`): Reconnects the subscription stream after it closes or a reconnect request fails. \`true\` retries indefinitely with a one-second delay.
+**processDataStream().reconnect** (`boolean | { maxRetries?: number; delayMs?: number }`): Reconnects the subscription stream after it closes or a reconnect request fails. true retries indefinitely with a one-second delay.
 
 ### `streamUntilIdle()`
 
-Stream a response and keep the stream open until every [background task](https://mastra.ai/docs/agents/background-tasks) dispatched during the run completes. The server re-enters the agentic loop on each task completion so the LLM can react to results in the same call. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call falls through to a plain `stream()`.
+Stream a response and keep the stream open until every [background task](https://mastra.ai/docs/long-running-agents/background-tasks) dispatched during the run completes. The server re-enters the agentic loop on each task completion so the LLM can react to results in the same call. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call falls through to a plain `stream()`.
 
 ```typescript
 const response = await agent.streamUntilIdle('Research solana for me', {
@@ -307,7 +307,7 @@ response.processDataStream({
 
 ### `resumeStreamUntilIdle()`
 
-Resume a suspended agent stream with custom data and keep the stream open until every [background task](https://mastra.ai/docs/agents/background-tasks) dispatched during the run completes. Use this to continue execution after a suspension point, such as a workflow suspend within an agent. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call falls through to a plain `resumeStream()`:
+Resume a suspended agent stream with custom data and keep the stream open until every [background task](https://mastra.ai/docs/long-running-agents/background-tasks) dispatched during the run completes. Use this to continue execution after a suspension point, such as a workflow suspend within an agent. Requires background tasks to be [enabled on the Mastra instance](https://mastra.ai/reference/configuration) and a memory thread; otherwise the call falls through to a plain `resumeStream()`:
 
 ```typescript
 const response = await agent.resumeStreamUntilIdle(

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

@@ -57,7 +57,7 @@ You can also pass `requestContext` as a `Record<string, any>`.
 
 **getAgent(agentId)** (`Agent`): Retrieves a specific agent instance by ID.
 
-**listMemoryThreads(params)** (`Promise<StorageThreadType[]>`): Retrieves memory threads for the specified resource and agent. Requires a \`resourceId\` and an \`agentId\`.
+**listMemoryThreads(params)** (`Promise<StorageThreadType[]>`): Retrieves memory threads for the specified resource and agent. Requires a resourceId and an agentId.
 
 **createMemoryThread(params)** (`Promise<MemoryThread>`): Creates a new memory thread with the given parameters.
 
@@ -75,13 +75,13 @@ You can also pass `requestContext` as a `Record<string, any>`.
 
 **getWorkflow(workflowId)** (`Workflow`): Retrieves a specific workflow instance by ID.
 
-**getAgentBuilderActions()** (`Promise<Record<string, WorkflowInfo>>`): Returns all available Agent Builder actions. See \[Agent Builder API]\(/reference/client-js/agent-builder).
+**getAgentBuilderActions()** (`Promise<Record<string, WorkflowInfo>>`): Returns all available Agent Builder actions. See Agent Builder API.
 
-**getAgentBuilderAction(actionId)** (`AgentBuilder`): Retrieves an Agent Builder action by ID. See \[Agent Builder API]\(/reference/client-js/agent-builder).
+**getAgentBuilderAction(actionId)** (`AgentBuilder`): Retrieves an Agent Builder action by ID. See Agent Builder API.
 
-**responses** (`Responses`): Provides OpenAI-style Responses API helpers with \`create()\`, \`retrieve()\`, \`stream()\`, and \`delete()\`.
+**responses** (`Responses`): Provides OpenAI-style Responses API helpers with create(), retrieve(), stream(), and delete().
 
-**conversations** (`Conversations`): Provides conversation helpers with \`create()\`, \`retrieve()\`, \`delete()\`, and \`items.list()\`.
+**conversations** (`Conversations`): Provides conversation helpers with create(), retrieve(), delete(), and items.list().
 
 **getVector(vectorName)** (`MastraVector`): Returns a vector store instance by name.
 

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

@@ -196,15 +196,15 @@ The returned response object includes:
 
 ## Parameters
 
-**agent\_id** (`string`): Required on initial requests. Selects the Mastra agent that executes the request. Stored follow-up turns can omit it when continuing with \`previous\_response\_id\`.
+**agent\_id** (`string`): Required on initial requests. Selects the Mastra agent that executes the request. Stored follow-up turns can omit it when continuing with previous\_response\_id.
 
-**model** (`string`): Optional model override for this request, such as \`openai/gpt-5\`. If omitted, Mastra uses the model configured on the selected agent.
+**model** (`string`): Optional model override for this request, such as openai/gpt-5. If omitted, Mastra uses the model configured on the selected agent.
 
 **input** (`string | Array<{ role: 'system' | 'developer' | 'user' | 'assistant'; content: string | Array<{ type: 'input_text' | 'text' | 'output_text'; text: string }> }>`): Required. Input text or message array for the response.
 
 **instructions** (`string`): Optional instruction override for this request.
 
-**text** (`{ format: { type: 'json_object' } | { type: 'json_schema'; name: string; schema: Record<string, unknown>; description?: string; strict?: boolean } }`): Optional text output format. Use \`json\_object\` for JSON mode or \`json\_schema\` for schema-constrained structured output.
+**text** (`{ format: { type: 'json_object' } | { type: 'json_schema'; name: string; schema: Record<string, unknown>; description?: string; strict?: boolean } }`): Optional text output format. Use json\_object for JSON mode or json\_schema for schema-constrained structured output.
 
 **providerOptions** (`Record<string, Record<string, unknown> | undefined>`): Optional provider-specific options passed through to the underlying model call.
 

package/.docs/reference/configuration.md

@@ -44,7 +44,7 @@ export const mastra = new Mastra({
 
 Enables and configures the background task manager. When enabled, agents can dispatch long-running tool calls (including subagent invocations) to run asynchronously while the agentic loop continues. Tasks are persisted, so a configured `storage` backend is required.
 
-Visit the [Background tasks documentation](https://mastra.ai/docs/agents/background-tasks) to learn more.
+Visit the [Background tasks documentation](https://mastra.ai/docs/long-running-agents/background-tasks) to learn more.
 
 ```typescript
 import { Mastra } from '@mastra/core'

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

@@ -34,7 +34,7 @@ const response = await agent.generate('How can I reset my password?')
 
 ## Parameters
 
-**id** (`string`): The ID of the agent to retrieve. Mastra first searches registered agents by \`agent.id\`. If none match, it uses this value as the agent registry key and calls \`getAgent()\`.
+**id** (`string`): The ID of the agent to retrieve. Mastra first searches registered agents by agent.id. If none match, it uses this value as the agent registry key and calls getAgent().
 
 **version** (`{ versionId: string } | { status?: 'draft' | 'published' }`): Optional version selector for retrieving a versioned agent. When provided, the method returns a promise.
 
@@ -44,9 +44,9 @@ const response = await agent.generate('How can I reset my password?')
 
 ## Returns
 
-**agent** (`TAgents[TAgentName]`): The agent instance with the specified ID when \`version\` is omitted.
+**agent** (`TAgents[TAgentName]`): The agent instance with the specified ID when version is omitted.
 
-**agent** (`Promise<TAgents[TAgentName]>`): A promise that resolves to the versioned agent instance when \`version\` is provided.
+**agent** (`Promise<TAgents[TAgentName]>`): A promise that resolves to the versioned agent instance when version is provided.
 
 Throws a `MastraError` when no agent is found by ID or registry key.
 

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

@@ -33,7 +33,7 @@ If you need to retrieve a workflow by its `id` property instead of its registrat
 
 **id** (`TWorkflowId extends keyof TWorkflows`): The ID of the workflow to retrieve. Must be a valid workflow ID that exists in the Mastra configuration.
 
-**options** (`{ serialized?: boolean }`): Optional configuration object. When \`serialized\` is true, returns only the workflow name instead of the full workflow instance.
+**options** (`{ serialized?: boolean }`): Optional configuration object. When serialized is true, returns only the workflow name instead of the full workflow instance.
 
 ## Returns
 

package/.docs/reference/core/listWorkflows.md

@@ -12,7 +12,7 @@ mastra.listWorkflows()
 
 ## Parameters
 
-**options** (`{ serialized?: boolean }`): Optional configuration object. When \`serialized\` is true, returns simplified workflow objects with only the name property instead of full workflow instances.
+**options** (`{ serialized?: boolean }`): Optional configuration object. When serialized is true, returns simplified workflow objects with only the name property instead of full workflow instances.
 
 ## Returns
 

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

@@ -69,7 +69,7 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **observability** (`ObservabilityEntrypoint`): Observability configuration for tracing and monitoring
 
-**environment** (`string`): Deployment environment name (e.g. \`production\`, \`staging\`, \`development\`). When set, automatically attached to all observability signals so they can be filtered by environment without passing \`tracingOptions.metadata.environment\` on each call. Falls back to \`process.env.NODE\_ENV\` when unset; left undefined if neither is set. Per-call \`tracingOptions.metadata.environment\` always takes precedence.
+**environment** (`string`): Deployment environment name (e.g. production, staging, development). When set, automatically attached to all observability signals so they can be filtered by environment without passing tracingOptions.metadata.environment on each call. Falls back to process.env.NODE\_ENV when unset; left undefined if neither is set. Per-call tracingOptions.metadata.environment always takes precedence.
 
 **deployer** (`MastraDeployer`): An instance of a MastraDeployer for managing deployments.
 
@@ -91,13 +91,13 @@ Visit the [Configuration reference](https://mastra.ai/reference/configuration) f
 
 **notifications.dispatch** (`NotificationDispatchConfig`): Scheduled dispatch configuration for deferred notifications and notification summaries. Dispatch is enabled by default.
 
-**notifications.dispatch.enabled** (`boolean`): Set to \`false\` to opt out of automatic scheduled notification dispatch.
+**notifications.dispatch.enabled** (`boolean`): Set to false to opt out of automatic scheduled notification dispatch.
 
 **notifications.dispatch.cron** (`string`): Cron schedule used by the internal notification dispatcher workflow.
 
 **notifications.dispatch.batchSize** (`number`): Maximum number of due notification records to process per dispatch run.
 
-**versions** (`VersionOverrides`): Global version overrides for sub-agent delegation. When a supervisor agent delegates to a sub-agent, these overrides determine which stored version of that sub-agent to use instead of the code-defined default. Requires the editor package to be configured. See \[Sub-agent versioning]\(/docs/editor/overview#sub-agent-versioning) for details.
+**versions** (`VersionOverrides`): Global version overrides for sub-agent delegation. When a supervisor agent delegates to a sub-agent, these overrides determine which stored version of that sub-agent to use instead of the code-defined default. Requires the editor package to be configured. See Sub-agent versioning for details.
 
 **versions.agents** (`Record<string, VersionSelector>`): A map of agent IDs to their version selectors. Each selector can target a specific version by ID or by publication status.
 

package/.docs/reference/core/removeWorkspace.md

@@ -14,11 +14,11 @@ await mastra.removeWorkspace('workspace-123', { destroy: true })
 
 **id** (`string`): The ID of the workspace to remove.
 
-**options** (`{ destroy?: boolean }`): Optional cleanup behavior. Set \`destroy\` to \`true\` to call \`workspace.destroy()\` before removing the workspace.
+**options** (`{ destroy?: boolean }`): Optional cleanup behavior. Set destroy to true to call workspace.destroy() before removing the workspace.
 
 ## Returns
 
-**removed** (`Promise<boolean>`): \`true\` when a workspace was removed. \`false\` when no workspace exists for the ID.
+**removed** (`Promise<boolean>`): true when a workspace was removed. false when no workspace exists for the ID.
 
 When `destroy` is `true` and `workspace.destroy()` throws, the call rejects with that error and the workspace remains registered so the caller can retry cleanup.
 

package/.docs/reference/datasets/compareExperiments.md

@@ -40,7 +40,7 @@ for (const item of comparison.items) {
 
 **experimentIds** (`string[]`): Array of experiment IDs to compare. Must contain at least 2.
 
-**baselineId** (`string`): ID of the baseline experiment. Defaults to the first ID in \`experimentIds\`.
+**baselineId** (`string`): ID of the baseline experiment. Defaults to the first ID in experimentIds.
 
 ## Returns
 

package/.docs/reference/datasets/getItemHistory.md

@@ -38,7 +38,7 @@ for (const row of history) {
 
 **result.datasetVersion** (`number`): Dataset version for this row.
 
-**result.validTo** (`number | null`): Version at which this row was superseded, or \`null\` if still current.
+**result.validTo** (`number | null`): Version at which this row was superseded, or null if still current.
 
 **result.isDeleted** (`boolean`): Whether this row represents a deletion.
 

package/.docs/reference/datasets/list.md

@@ -36,9 +36,9 @@ const forAgents = await mastra.datasets.list({
 
 ## Parameters
 
-**page** (`number`): Page number. Defaults to \`0\`.
+**page** (`number`): Page number. Defaults to 0.
 
-**perPage** (`number`): Number of datasets per page. Defaults to \`20\`.
+**perPage** (`number`): Number of datasets per page. Defaults to 20.
 
 **filters** (`object`): Optional filters applied at the storage layer.
 
@@ -52,9 +52,9 @@ const forAgents = await mastra.datasets.list({
 
 **filters.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): Restrict to datasets targeting this component type.
 
-**filters.targetIds** (`string[]`): Restrict to datasets whose \`targetIds\` intersect this list (any-overlap match). Empty array is treated as no filter.
+**filters.targetIds** (`string[]`): Restrict to datasets whose targetIds intersect this list (any-overlap match). Empty array is treated as no filter.
 
-**filters.name** (`string`): Case-insensitive substring match on dataset \`name\`. Empty string is treated as no filter.
+**filters.name** (`string`): Case-insensitive substring match on dataset name. Empty string is treated as no filter.
 
 ## Returns
 
@@ -62,4 +62,4 @@ const forAgents = await mastra.datasets.list({
 
 **result.datasets** (`DatasetRecord[]`): Array of dataset records. See dataset.getDetails() for the record shape.
 
-**result.pagination** (`PaginationInfo`): Pagination metadata with \`total\`, \`page\`, \`perPage\`, and \`hasMore\`.
+**result.pagination** (`PaginationInfo`): Pagination metadata with total, page, perPage, and hasMore.

package/.docs/reference/datasets/listExperimentResults.md

@@ -48,11 +48,11 @@ for (const result of results) {
 
 **status** (`'needs-review' | 'reviewed' | 'complete'`): Restrict results to this per-result review status.
 
-**filters** (`ExperimentTenancyFilters`): Multi-tenant scoping filters (\`organizationId\`, \`projectId\`). Forwarded to the storage layer.
+**filters** (`ExperimentTenancyFilters`): Multi-tenant scoping filters (organizationId, projectId). Forwarded to the storage layer.
 
-**page** (`number`): Page number. Defaults to \`0\`.
+**page** (`number`): Page number. Defaults to 0.
 
-**perPage** (`number`): Number of results per page. Defaults to \`20\`.
+**perPage** (`number`): Number of results per page. Defaults to 20.
 
 ## Returns
 
@@ -86,4 +86,4 @@ for (const result of results) {
 
 **result.results.createdAt** (`Date`): When the result record was created.
 
-**result.pagination** (`PaginationInfo`): Pagination metadata with \`total\`, \`page\`, \`perPage\`, and \`hasMore\`.
+**result.pagination** (`PaginationInfo`): Pagination metadata with total, page, perPage, and hasMore.

package/.docs/reference/datasets/listExperiments.md

@@ -43,11 +43,11 @@ for (const exp of experiments) {
 
 **status** (`'pending' | 'running' | 'completed' | 'failed'`): Restrict results to experiments in this status.
 
-**filters** (`ExperimentTenancyFilters`): Multi-tenant scoping filters (\`organizationId\`, \`projectId\`). Forwarded to the storage layer.
+**filters** (`ExperimentTenancyFilters`): Multi-tenant scoping filters (organizationId, projectId). Forwarded to the storage layer.
 
-**page** (`number`): Page number. Defaults to \`0\`.
+**page** (`number`): Page number. Defaults to 0.
 
-**perPage** (`number`): Number of experiments per page. Defaults to \`20\`.
+**perPage** (`number`): Number of experiments per page. Defaults to 20.
 
 ## Returns
 
@@ -89,4 +89,4 @@ for (const exp of experiments) {
 
 **result.experiments.updatedAt** (`Date`): When the experiment record was last updated.
 
-**result.pagination** (`PaginationInfo`): Pagination metadata with \`total\`, \`page\`, \`perPage\`, and \`hasMore\`.
+**result.pagination** (`PaginationInfo`): Pagination metadata with total, page, perPage, and hasMore.

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

@@ -33,11 +33,11 @@ const versionedItems = await dataset.listItems({ version: 2 })
 
 ## Parameters
 
-**version** (`number`): Dataset version to list items at. When passed on its own, returns every item at that version as a bare \`DatasetItem\[]\` snapshot. Passing \`search\` / \`page\` / \`perPage\` alongside \`version\` switches to the paginated shape.
+**version** (`number`): Dataset version to list items at. When passed on its own, returns every item at that version as a bare DatasetItem\[] snapshot. Passing search / page / perPage alongside version switches to the paginated shape.
 
-**page** (`number`): Page number for pagination. Defaults to \`0\`.
+**page** (`number`): Page number for pagination. Defaults to 0.
 
-**perPage** (`number`): Number of items per page. Defaults to \`20\`.
+**perPage** (`number`): Number of items per page. Defaults to 20.
 
 **search** (`string`): Search string to filter items.
 
@@ -45,7 +45,7 @@ const versionedItems = await dataset.listItems({ version: 2 })
 
 When only `version` is provided (no `search`, `page`, or `perPage`):
 
-**result** (`Promise<DatasetItem[]>`): Bare array of every item at the specified dataset version. This shape is retained for backwards compatibility and is deprecated — pass \`page\` / \`perPage\` (or \`search\`) to always receive the paginated shape below.
+**result** (`Promise<DatasetItem[]>`): Bare array of every item at the specified dataset version. This shape is retained for backwards compatibility and is deprecated — pass page / perPage (or search) to always receive the paginated shape below.
 
 In all other cases (no arguments, or `search` / `page` / `perPage` provided with or without `version`):
 
@@ -59,6 +59,6 @@ In all other cases (no arguments, or `search` / `page` / `perPage` provided with
 
 **result.pagination.page** (`number`): Current page number.
 
-**result.pagination.perPage** (`number | false`): Items per page, or \`false\` if unpaginated.
+**result.pagination.perPage** (`number | false`): Items per page, or false if unpaginated.
 
 **result.pagination.hasMore** (`boolean`): Whether more pages are available.

package/.docs/reference/datasets/listVersions.md

@@ -26,9 +26,9 @@ for (const version of versions) {
 
 ## Parameters
 
-**page** (`number`): Page number. Defaults to \`0\`.
+**page** (`number`): Page number. Defaults to 0.
 
-**perPage** (`number`): Number of versions per page. Defaults to \`20\`.
+**perPage** (`number`): Number of versions per page. Defaults to 20.
 
 ## Returns
 
@@ -50,6 +50,6 @@ for (const version of versions) {
 
 **result.pagination.page** (`number`): Current page number.
 
-**result.pagination.perPage** (`number | false`): Versions per page, or \`false\` if unpaginated.
+**result.pagination.perPage** (`number | false`): Versions per page, or false if unpaginated.
 
 **result.pagination.hasMore** (`boolean`): Whether more pages are available.

package/.docs/reference/datasets/startExperiment.md

@@ -57,11 +57,11 @@ console.log(`Status: ${summary2.status}`)
 
 ## Parameters
 
-**targetType** (`'agent' | 'workflow' | 'scorer'`): Type of registered target to run items against. Use with \`targetId\`.
+**targetType** (`'agent' | 'workflow' | 'scorer'`): Type of registered target to run items against. Use with targetId.
 
-**targetId** (`string`): ID of the registered target. Use with \`targetType\`.
+**targetId** (`string`): ID of the registered target. Use with targetType.
 
-**scorers** (`(MastraScorer | string)[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to evaluate each result. Accepts a flat array of \`MastraScorer\` instances or registered scorer IDs, or the same categorised config shape used by \`runEvals\` (\`AgentScorerConfig\` / \`WorkflowScorerConfig\`). Trajectory scorers (\`type: "trajectory"\`) automatically receive a pre-extracted \`Trajectory\` as their output regardless of which form is used. For workflow targets, per-step scorers can be passed via \`scorers: { steps: { stepId: \[...] } }\` and run against each step's output; their results carry the originating \`stepId\` and keep \`targetScope: "span"\` (matching \`runEvals\`).
+**scorers** (`(MastraScorer | string)[] | AgentScorerConfig | WorkflowScorerConfig`): Scorers to evaluate each result. Accepts a flat array of MastraScorer instances or registered scorer IDs, or the same categorised config shape used by runEvals (AgentScorerConfig / WorkflowScorerConfig). Trajectory scorers (type: "trajectory") automatically receive a pre-extracted Trajectory as their output regardless of which form is used. For workflow targets, per-step scorers can be passed via scorers: { steps: { stepId: \[...] } } and run against each step's output; their results carry the originating stepId and keep targetScope: "span" (matching runEvals).
 
 **name** (`string`): Display name for the experiment.
 
@@ -71,13 +71,13 @@ console.log(`Status: ${summary2.status}`)
 
 **version** (`number`): Pin to a specific dataset version. Defaults to the latest version.
 
-**maxConcurrency** (`number`): Maximum concurrent item executions. Defaults to \`5\`.
+**maxConcurrency** (`number`): Maximum concurrent item executions. Defaults to 5.
 
 **signal** (`AbortSignal`): AbortSignal for cancelling the experiment.
 
 **itemTimeout** (`number`): Per-item execution timeout in milliseconds.
 
-**maxRetries** (`number`): Maximum retries per item on failure. Defaults to \`0\` (no retries). Abort errors are never retried.
+**maxRetries** (`number`): Maximum retries per item on failure. Defaults to 0 (no retries). Abort errors are never retried.
 
 ## Returns
 
@@ -95,7 +95,7 @@ console.log(`Status: ${summary2.status}`)
 
 **result.skippedCount** (`number`): Number of items skipped (e.g., due to abort).
 
-**result.completedWithErrors** (`boolean`): \`true\` if the run completed but some items failed.
+**result.completedWithErrors** (`boolean`): true if the run completed but some items failed.
 
 **result.startedAt** (`Date`): When the experiment started.
 
@@ -109,7 +109,7 @@ console.log(`Status: ${summary2.status}`)
 
 **result.results.input** (`unknown`): Input data passed to the target.
 
-**result.results.output** (`unknown | null`): Output from the target, or \`null\` if failed.
+**result.results.output** (`unknown | null`): Output from the target, or null if failed.
 
 **result.results.groundTruth** (`unknown | null`): Expected output from the dataset item.
 
@@ -127,7 +127,7 @@ console.log(`Status: ${summary2.status}`)
 
 **result.results.scores.scorerName** (`string`): Display name of the scorer.
 
-**result.results.scores.score** (`number | null`): Computed score, or \`null\` if the scorer failed.
+**result.results.scores.score** (`number | null`): Computed score, or null if the scorer failed.
 
 **result.results.scores.reason** (`string | null`): Reason/explanation for the score.
 

package/.docs/reference/datasets/startExperimentAsync.md

@@ -41,7 +41,7 @@ Takes the same `StartExperimentConfig` as [`dataset.startExperiment()`](https://
 
 **result.experimentId** (`string`): Unique ID of the created experiment.
 
-**result.status** (`'pending'`): Always \`'pending'\` since the experiment hasn't started executing yet.
+**result.status** (`'pending'`): Always 'pending' since the experiment hasn't started executing yet.
 
 ## Related
 

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

@@ -38,9 +38,9 @@ new MastraEditor({
 
 ## Properties
 
-**enabled** (`boolean`): Master switch. When false, the Builder UI is disabled and \`MastraEditor.resolveBuilder()\` returns undefined. (Default: `true`)
+**enabled** (`boolean`): Master switch. When false, the Builder UI is disabled and MastraEditor.resolveBuilder() returns undefined. (Default: `true`)
 
-**features** (`{ agent?: AgentFeatures }`): UI toggles. Each key on \`features.agent\` defaults to true when omitted.
+**features** (`{ agent?: AgentFeatures }`): UI toggles. Each key on features.agent defaults to true when omitted.
 
 **features.agent.tools** (`boolean`): Show the tools tab in the agent editor.
 
@@ -54,7 +54,7 @@ new MastraEditor({
 
 **features.agent.model** (`boolean`): Show the model picker in the agent editor. When false, the admin-pinned default model applies.
 
-**features.agent.browser** (`boolean`): Show the browser tab. Resolves to true only when a valid browser provider is registered on \`MastraEditor.browsers\`; otherwise it is downgraded to false and a warning is logged.
+**features.agent.browser** (`boolean`): Show the browser tab. Resolves to true only when a valid browser provider is registered on MastraEditor.browsers; otherwise it is downgraded to false and a warning is logged.
 
 **features.agent.avatarUpload** (`boolean`): Allow end users to upload an avatar for stored agents.
 
@@ -66,7 +66,7 @@ new MastraEditor({
 
 **registries.skillsSh** (`{ enabled: boolean }`): Enable the skills.sh registry. When enabled, the Builder shows registry browse UI for skills.sh skills.
 
-**registries.skillsSh.enabled** (`boolean`): Set to \`true\` to opt in. Defaults to \`false\`.
+**registries.skillsSh.enabled** (`boolean`): Set to true to opt in. Defaults to false.
 
 ## Related