@mastra/mcp-docs-server 1.2.5-alpha.1 → 1.2.5-alpha.5

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
 

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

@@ -45,29 +45,29 @@ new MastraEditor({
 
 ## Properties
 
-**memory** (`SerializedMemoryConfig`): Default memory configuration for new agents. Pass \`{ observationalMemory: true }\` to enable long-lived fact extraction. Requires \`Mastra.storage\`. See the SerializedMemoryConfig reference for the full schema.
+**memory** (`SerializedMemoryConfig`): Default memory configuration for new agents. Pass { observationalMemory: true } to enable long-lived fact extraction. Requires Mastra.storage. See the SerializedMemoryConfig reference for the full schema.
 
-**workspace** (`StorageWorkspaceRef`): Default workspace reference for new agents. Pass \`{ type: 'inline', config }\` to embed a snapshot, or \`{ type: 'id', workspaceId }\` to point at a workspace registered on \`Mastra.workspace\`. See the StorageWorkspaceRef reference for both variants.
+**workspace** (`StorageWorkspaceRef`): Default workspace reference for new agents. Pass { type: 'inline', config } to embed a snapshot, or { type: 'id', workspaceId } to point at a workspace registered on Mastra.workspace. See the StorageWorkspaceRef reference for both variants.
 
-**browser** (`StorageBrowserRef`): Default browser configuration for new agents. Pass \`{ type: 'inline', config: { provider } }\` to attach a registered browser provider. See the StorageBrowserRef reference for the full schema.
+**browser** (`StorageBrowserRef`): Default browser configuration for new agents. Pass { type: 'inline', config: { provider } } to attach a registered browser provider. See the StorageBrowserRef reference for the full schema.
 
 **models** (`{ allowed?: ProviderModelEntry[]; default?: DefaultModelEntry }`): Model allowlist and default applied to every Builder-created agent. See the BuilderModels reference for the full schema and validation rules.
 
 **models.allowed** (`ProviderModelEntry[]`): Allowlist of providers and models. Omit to allow every registered model. ProviderModelEntry is a discriminated union (known providers vs. custom).
 
-**models.default** (`DefaultModelEntry`): Pre-selected model on new-agent create. Required when the model picker is hidden. DefaultModelEntry requires \`provider\` and \`modelId\`, with an optional \`kind\`.
+**models.default** (`DefaultModelEntry`): Pre-selected model on new-agent create. Required when the model picker is hidden. DefaultModelEntry requires provider and modelId, with an optional kind.
 
 **tools** (`{ allowed?: string[] }`): Allowlist of tool IDs visible in the Builder tools picker. Unknown IDs are dropped and surfaced as warnings.
 
-**tools.allowed** (`string[]`): Allowlist of \`tool.id\` values. Omit for unrestricted, pass \`\[]\` to lock the picker down, pass \`\[...ids]\` to restrict to the listed tools.
+**tools.allowed** (`string[]`): Allowlist of tool.id values. Omit for unrestricted, pass \[] to lock the picker down, pass \[...ids] to restrict to the listed tools.
 
 **agents** (`{ allowed?: string[] }`): Allowlist of agent IDs visible in the Builder sub-agents picker. Unknown IDs are dropped and surfaced as warnings.
 
-**agents.allowed** (`string[]`): Allowlist of \`Agent.id\` values. Omit for unrestricted, pass \`\[]\` to lock the picker down, pass \`\[...ids]\` to restrict to the listed agents.
+**agents.allowed** (`string[]`): Allowlist of Agent.id values. Omit for unrestricted, pass \[] to lock the picker down, pass \[...ids] to restrict to the listed agents.
 
 **workflows** (`{ allowed?: string[] }`): Allowlist of workflow IDs visible in the Builder workflows picker. Unknown IDs are dropped and surfaced as warnings.
 
-**workflows.allowed** (`string[]`): Allowlist of \`workflow\.id\` values. Omit for unrestricted, pass \`\[]\` to lock the picker down, pass \`\[...ids]\` to restrict to the listed workflows.
+**workflows.allowed** (`string[]`): Allowlist of workflow\.id values. Omit for unrestricted, pass \[] to lock the picker down, pass \[...ids] to restrict to the listed workflows.
 
 ## Related
 

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

@@ -33,7 +33,7 @@ new MastraEditor({
 
 **allowed** (`ProviderModelEntry[]`): Allowlist of providers and models. Omit to allow every registered model. When non-empty, only the listed entries are selectable in the Builder.
 
-**allowed.provider** (`Provider`): Provider id from the generated provider registry (for example, \`openai\`, \`anthropic\`).
+**allowed.provider** (`Provider`): Provider id from the generated provider registry (for example, openai, anthropic).
 
 **allowed.modelId** (`ModelForProvider<Provider>`): Specific model id for that provider. Omit to allow every model under the provider.
 
@@ -43,13 +43,13 @@ new MastraEditor({
 
 **allowed.modelId** (`string`): Specific model id under the custom provider. Omit to allow every model under it.
 
-**default** (`DefaultModelEntry`): Pre-selected model on new-agent create. Same shape as \`ProviderModelEntry\`, but \`modelId\` is required. Must satisfy the \`allowed\` list when set.
+**default** (`DefaultModelEntry`): Pre-selected model on new-agent create. Same shape as ProviderModelEntry, but modelId is required. Must satisfy the allowed list when set.
 
-**default.provider** (`Provider | string`): Provider id. Use a \`Provider\` literal for known providers, or any \`string\` with \`kind: 'custom'\`.
+**default.provider** (`Provider | string`): Provider id. Use a Provider literal for known providers, or any string with kind: 'custom'.
 
 **default.modelId** (`string`): Required model id. Points at a specific model, not a whole provider.
 
-**default.kind** (`'custom'`): Set to \`custom\` when targeting a provider that isn't in the generated registry.
+**default.kind** (`'custom'`): Set to custom when targeting a provider that isn't in the generated registry.
 
 ## Validation rules
 

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

@@ -21,7 +21,7 @@ new MastraEditor({
 
 ## Properties
 
-**id** (`string`): Unique provider identifier (for example, \`"storage"\`, \`"s3"\`).
+**id** (`string`): Unique provider identifier (for example, "storage", "s3").
 
 **name** (`string`): Human-readable name for UI display.
 
@@ -29,7 +29,7 @@ new MastraEditor({
 
 **configSchema** (`Record<string, unknown>`): JSON Schema describing provider-specific configuration. Used by the UI to render config forms.
 
-**createBlobStore** (`(config: TConfig) => BlobStore | Promise<BlobStore>`): Create a runtime \`BlobStore\` instance from the stored config. Called when the editor resolves a blob store via \`MastraEditor.resolveBlobStore(providerId, config)\`.
+**createBlobStore** (`(config: TConfig) => BlobStore | Promise<BlobStore>`): Create a runtime BlobStore instance from the stored config. Called when the editor resolves a blob store via MastraEditor.resolveBlobStore(providerId, config).
 
 ## Implementing a provider
 

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

@@ -21,7 +21,7 @@ new MastraEditor({
 
 ## Properties
 
-**id** (`string`): Unique provider identifier (for example, \`"stagehand"\`). Must match \`StorageBrowserConfig.provider\` on every stored agent that uses this provider.
+**id** (`string`): Unique provider identifier (for example, "stagehand"). Must match StorageBrowserConfig.provider on every stored agent that uses this provider.
 
 **name** (`string`): Human-readable name for UI display.
 
@@ -29,7 +29,7 @@ new MastraEditor({
 
 **configSchema** (`Record<string, unknown>`): JSON Schema describing provider-specific configuration. Used by the UI to render config forms.
 
-**createBrowser** (`(config: TConfig) => MastraBrowser | Promise<MastraBrowser>`): Create a runtime \`MastraBrowser\` instance from the stored config. Called once per agent hydration; the resulting instance is cached alongside the agent.
+**createBrowser** (`(config: TConfig) => MastraBrowser | Promise<MastraBrowser>`): Create a runtime MastraBrowser instance from the stored config. Called once per agent hydration; the resulting instance is cached alongside the agent.
 
 ## Implementing a provider
 

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

@@ -21,7 +21,7 @@ new MastraEditor({
 
 ## Properties
 
-**id** (`string`): Unique provider identifier (for example, \`"local"\`, \`"s3"\`). Must match \`StorageFilesystemConfig.provider\` on every stored workspace that uses this provider.
+**id** (`string`): Unique provider identifier (for example, "local", "s3"). Must match StorageFilesystemConfig.provider on every stored workspace that uses this provider.
 
 **name** (`string`): Human-readable name for UI display.
 
@@ -29,7 +29,7 @@ new MastraEditor({
 
 **configSchema** (`Record<string, unknown>`): JSON Schema describing provider-specific configuration. Used by the UI to render config forms.
 
-**createFilesystem** (`(config: TConfig) => WorkspaceFilesystem | Promise<WorkspaceFilesystem>`): Create a runtime \`WorkspaceFilesystem\` instance from the stored config. Called at workspace hydration time.
+**createFilesystem** (`(config: TConfig) => WorkspaceFilesystem | Promise<WorkspaceFilesystem>`): Create a runtime WorkspaceFilesystem instance from the stored config. Called at workspace hydration time.
 
 ## Implementing a provider
 

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

@@ -41,9 +41,9 @@ export const mastra = new Mastra({
 
 **blobStores** (`Record<string, BlobStoreProvider>`): Blob storage providers for binary data (for example, S3). Falls back to the Mastra storage blob store if no provider is specified. (Default: `{}`)
 
-**browsers** (`Record<string, BrowserProvider>`): Browser providers for agent browser access (for example, Stagehand). No built-ins — required when \`builder.features.agent.browser\` is enabled. See the BrowserProvider reference for the provider interface. (Default: `{}`)
+**browsers** (`Record<string, BrowserProvider>`): Browser providers for agent browser access (for example, Stagehand). No built-ins — required when builder.features.agent.browser is enabled. See the BrowserProvider reference for the provider interface. (Default: `{}`)
 
-**builder** (`AgentBuilderOptions`): Agent Builder configuration. See the AgentBuilderOptions reference. Omit or set \`enabled: false\` to disable the Builder.
+**builder** (`AgentBuilderOptions`): Agent Builder configuration. See the AgentBuilderOptions reference. Omit or set enabled: false to disable the Builder.
 
 **source** (`'code' | 'db'`): Where agent overrides are stored. With 'db', overrides live in the configured storage backend and Studio shows the save and publish flow. With 'code', overrides live as per-agent JSON files on disk (routed through a local FilesystemStore) and Studio shows filesystem actions. See the Editor overview for the difference. (Default: `'db'`)
 

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

@@ -26,17 +26,17 @@ new MastraEditor({
 
 **info** (`ProcessorProviderInfo`): Metadata about the provider.
 
-**info.id** (`string`): Unique identifier (for example, \`"moderation"\`, \`"token-limiter"\`).
+**info.id** (`string`): Unique identifier (for example, "moderation", "token-limiter").
 
 **info.name** (`string`): Human-readable name.
 
 **info.description** (`string`): Short description of the provider.
 
-**configSchema** (`ZodSchema`): Zod schema describing the configuration this provider accepts. Used by the UI to render a form. The validated config object is passed to \`createProcessor()\`.
+**configSchema** (`ZodSchema`): Zod schema describing the configuration this provider accepts. Used by the UI to render a form. The validated config object is passed to createProcessor().
 
-**availablePhases** (`ProcessorPhase[]`): Phases this provider's processors support. One or more of \`'processInput'\`, \`'processInputStep'\`, \`'processOutputStream'\`, \`'processOutputResult'\`, \`'processOutputStep'\`.
+**availablePhases** (`ProcessorPhase[]`): Phases this provider's processors support. One or more of 'processInput', 'processInputStep', 'processOutputStream', 'processOutputResult', 'processOutputStep'.
 
-**createProcessor** (`(config: Record<string, unknown>) => Processor`): Create a \`Processor\` instance from the validated configuration. Called during agent hydration to resolve stored processor configs into live instances.
+**createProcessor** (`(config: Record<string, unknown>) => Processor`): Create a Processor instance from the validated configuration. Called during agent hydration to resolve stored processor configs into live instances.
 
 ## Implementing a provider
 

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

@@ -21,7 +21,7 @@ new MastraEditor({
 
 ## Properties
 
-**id** (`string`): Unique provider identifier (for example, \`"local"\`, \`"e2b"\`). Must match \`StorageSandboxConfig.provider\` on every stored workspace that uses this provider.
+**id** (`string`): Unique provider identifier (for example, "local", "e2b"). Must match StorageSandboxConfig.provider on every stored workspace that uses this provider.
 
 **name** (`string`): Human-readable name for UI display.
 
@@ -29,7 +29,7 @@ new MastraEditor({
 
 **configSchema** (`Record<string, unknown>`): JSON Schema describing provider-specific configuration. Used by the UI to render config forms.
 
-**createSandbox** (`(config: TConfig) => WorkspaceSandbox | Promise<WorkspaceSandbox>`): Create a runtime \`WorkspaceSandbox\` instance from the stored config. Called at workspace hydration time.
+**createSandbox** (`(config: TConfig) => WorkspaceSandbox | Promise<WorkspaceSandbox>`): Create a runtime WorkspaceSandbox instance from the stored config. Called at workspace hydration time.
 
 ## Implementing a provider
 

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

@@ -42,7 +42,7 @@ A `{ type: 'id' }` variant for browsers isn't available — they're always inlin
 
 ## Properties
 
-**type** (`'inline'`): Discriminant. Must be the literal \`"inline"\`.
+**type** (`'inline'`): Discriminant. Must be the literal "inline".
 
 **config** (`StorageBrowserConfig`): Provider id and per-instance browser configuration. See the section below.
 
@@ -50,7 +50,7 @@ A `{ type: 'id' }` variant for browsers isn't available — they're always inlin
 
 The shape embedded under `config`. Defined in `@mastra/core/storage`.
 
-**provider** (`string`): Provider identifier (for example, \`"stagehand"\`). Must match a \`BrowserProvider.id\` registered on \`MastraEditor.browsers\`. There are no built-in providers.
+**provider** (`string`): Provider identifier (for example, "stagehand"). Must match a BrowserProvider.id registered on MastraEditor.browsers. There are no built-in providers.
 
 **headless** (`boolean`): Run the browser in headless mode (no visible UI). (Default: `true`)
 

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

@@ -47,17 +47,17 @@ new MastraEditor({
 
 ## Variants
 
-**{ type: 'id'; workspaceId: string }** (`IdRef`): Reference a workspace registered on the Mastra runtime via \`new Mastra({ workspace })\` or \`mastra.addWorkspace()\`. The id is the join key between admin config, stored agent record, and hydration.
+**{ type: 'id'; workspaceId: string }** (`IdRef`): Reference a workspace registered on the Mastra runtime via new Mastra({ workspace }) or mastra.addWorkspace(). The id is the join key between admin config, stored agent record, and hydration.
 
-**{ type: 'id'; workspaceId: string }.type** (`'id'`): Discriminant. Must be the literal \`"id"\`.
+**{ type: 'id'; workspaceId: string }.type** (`'id'`): Discriminant. Must be the literal "id".
 
 **{ type: 'id'; workspaceId: string }.workspaceId** (`string`): Id of a workspace registered on the Mastra runtime. Used by the Builder to snapshot, persist, and later hydrate the workspace.
 
-**{ type: 'inline'; config: StorageWorkspaceSnapshotType }** (`InlineRef`): Embed a workspace snapshot directly. The Builder derives a deterministic id of the form \`inline-\<sha256(config)\[:12]>\` and persists the snapshot, so identical inline configs are deduplicated across agents.
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }** (`InlineRef`): Embed a workspace snapshot directly. The Builder derives a deterministic id of the form inline-\<sha256(config)\[:12]> and persists the snapshot, so identical inline configs are deduplicated across agents.
 
-**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.type** (`'inline'`): Discriminant. Must be the literal \`"inline"\`.
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.type** (`'inline'`): Discriminant. Must be the literal "inline".
 
-**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.config** (`StorageWorkspaceSnapshotType`): Serialized workspace configuration (filesystem, sandbox, mounts, search, skills, tools). See the \`StorageWorkspaceSnapshotType\` section below for the field list.
+**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.config** (`StorageWorkspaceSnapshotType`): Serialized workspace configuration (filesystem, sandbox, mounts, search, skills, tools). See the StorageWorkspaceSnapshotType section below for the field list.
 
 ## `StorageWorkspaceSnapshotType`
 
@@ -67,9 +67,9 @@ The shape embedded under `{ type: 'inline', config }`. Defined in `@mastra/core/
 
 **description** (`string`): Purpose description shown in the workspace listing.
 
-**filesystem** (`StorageFilesystemConfig`): Primary filesystem configuration. \`provider\` must match an id registered on \`MastraEditor.filesystems\` (built-in: \`local\`).
+**filesystem** (`StorageFilesystemConfig`): Primary filesystem configuration. provider must match an id registered on MastraEditor.filesystems (built-in: local).
 
-**sandbox** (`StorageSandboxConfig`): Sandbox configuration. \`provider\` must match an id registered on \`MastraEditor.sandboxes\` (built-in: \`local\`).
+**sandbox** (`StorageSandboxConfig`): Sandbox configuration. provider must match an id registered on MastraEditor.sandboxes (built-in: local).
 
 **mounts** (`Record<string, StorageFilesystemConfig>`): Additional filesystems mounted on the workspace, keyed by mount path.