@mastra/mcp-docs-server 1.1.7 → 1.1.8

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

@@ -24,11 +24,11 @@ await weatherAgent.generate('What is the weather in Rome', {
 
 ## Parameters
 
-**key:** (`string`): The registration key of the scorer to retrieve. This should match a key used when registering scorers in the Mastra constructor.
+**key** (`string`): The registration key of the scorer to retrieve. This should match a key used when registering scorers in the Mastra constructor.
 
 ## Returns
 
-**scorer:** (`MastraScorer`): The MastraScorer instance associated with the provided key.
+**scorer** (`MastraScorer`): The MastraScorer instance associated with the provided key.
 
 ## Error Handling
 

package/.docs/reference/core/getScorerById.md

@@ -24,11 +24,11 @@ await weatherAgent.generate('What is the weather in Rome', {
 
 ## Parameters
 
-**id:** (`string`): The id property of the scorer to retrieve. This should match the 'id' field specified when creating the scorer with createScorer(). The method will also search by 'name' property as a fallback.
+**id** (`string`): The id property of the scorer to retrieve. This should match the 'id' field specified when creating the scorer with createScorer(). The method will also search by 'name' property as a fallback.
 
 ## Returns
 
-**scorer:** (`MastraScorer`): The MastraScorer instance that has the matching id (or name) property.
+**scorer** (`MastraScorer`): The MastraScorer instance that has the matching id (or name) property.
 
 ## Error Handling
 

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

@@ -14,7 +14,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**server:** (`ServerConfig | undefined`): The configured server configuration including port, host, studioBase, timeout, API routes, middleware, CORS settings, and build options, or undefined if no server has been configured.
+**server** (`ServerConfig | undefined`): The configured server configuration including port, host, studioBase, timeout, API routes, middleware, CORS settings, and build options, or undefined if no server has been configured.
 
 ## Related
 

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

@@ -14,7 +14,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**storage:** (`MastraCompositeStore | undefined`): The configured storage instance, or undefined if no storage has been configured.
+**storage** (`MastraCompositeStore | undefined`): The configured storage instance, or undefined if no storage has been configured.
 
 ## Related
 

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

@@ -26,17 +26,15 @@ if (storedConfig) {
 
 ## Parameters
 
-**id:** (`string`): The unique identifier of the stored agent to retrieve.
+**id** (`string`): The unique identifier of the stored agent to retrieve.
 
-**options?:** (`{ raw?: boolean }`): Optional configuration object.
+**options** (`{ raw?: boolean }`): Optional configuration object.
 
-### Options
-
-**raw?:** (`boolean`): When \`true\`, returns the raw \`StorageAgentType\` object from storage instead of creating an \`Agent\` instance. Useful for inspecting stored configuration or metadata. (Default: `false`)
+**options.raw** (`boolean`): When \`true\`, returns the raw \`StorageAgentType\` object from storage instead of creating an \`Agent\` instance. Useful for inspecting stored configuration or metadata.
 
 ## Returns
 
-**result:** (`Agent | StorageAgentType | null`): Returns an \`Agent\` instance by default, or \`StorageAgentType\` when \`raw: true\`. Returns \`null\` if no agent with the given ID exists.
+**result** (`Agent | StorageAgentType | null`): Returns an \`Agent\` instance by default, or \`StorageAgentType\` when \`raw: true\`. Returns \`null\` if no agent with the given ID exists.
 
 ## Primitive Resolution
 
@@ -54,33 +52,33 @@ If a referenced primitive is not found in the registry, a warning is logged but
 
 When using `raw: true`, the returned object has the following structure:
 
-**id:** (`string`): Unique identifier for the agent.
+**id** (`string`): Unique identifier for the agent.
 
-**name:** (`string`): Display name of the agent.
+**name** (`string`): Display name of the agent.
 
-**description?:** (`string`): Optional description of the agent.
+**description** (`string`): Optional description of the agent.
 
-**instructions:** (`string`): System instructions for the agent.
+**instructions** (`string`): System instructions for the agent.
 
-**model:** (`Record<string, unknown>`): Model configuration with provider and name.
+**model** (`Record<string, unknown>`): Model configuration with provider and name.
 
-**tools?:** (`Record<string, unknown>`): Tool references to resolve from registry.
+**tools** (`Record<string, unknown>`): Tool references to resolve from registry.
 
-**workflows?:** (`Record<string, unknown>`): Workflow references to resolve from registry.
+**workflows** (`Record<string, unknown>`): Workflow references to resolve from registry.
 
-**agents?:** (`Record<string, unknown>`): Subagent references to resolve from registry.
+**agents** (`Record<string, unknown>`): Subagent references to resolve from registry.
 
-**memory?:** (`Record<string, unknown>`): Memory reference to resolve from registry.
+**memory** (`Record<string, unknown>`): Memory reference to resolve from registry.
 
-**scorers?:** (`Record<string, unknown>`): Scorer references with optional sampling config.
+**scorers** (`Record<string, unknown>`): Scorer references with optional sampling config.
 
-**defaultOptions?:** (`Record<string, unknown>`): Default options passed to agent execution.
+**defaultOptions** (`Record<string, unknown>`): Default options passed to agent execution.
 
-**metadata?:** (`Record<string, unknown>`): Custom metadata stored with the agent.
+**metadata** (`Record<string, unknown>`): Custom metadata stored with the agent.
 
-**createdAt:** (`Date`): Timestamp when the agent was created.
+**createdAt** (`Date`): Timestamp when the agent was created.
 
-**updatedAt:** (`Date`): Timestamp when the agent was last updated.
+**updatedAt** (`Date`): Timestamp when the agent was last updated.
 
 ## Related
 

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

@@ -14,7 +14,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**telemetry:** (`Telemetry | undefined`): The configured telemetry instance used for tracing and observability across all components, or undefined if no telemetry has been configured.
+**telemetry** (`Telemetry | undefined`): The configured telemetry instance used for tracing and observability across all components, or undefined if no telemetry has been configured.
 
 ## Related
 

package/.docs/reference/core/getVector.md

@@ -10,11 +10,11 @@ mastra.getVector('testVectorStore')
 
 ## Parameters
 
-**name:** (`TVectorName extends keyof TVectors`): The name of the vector store to retrieve. Must be a valid vector store name that exists in the Mastra configuration.
+**name** (`TVectorName extends keyof TVectors`): The name of the vector store to retrieve. Must be a valid vector store name that exists in the Mastra configuration.
 
 ## Returns
 
-**vector:** (`TVectors[TVectorName]`): The vector store instance with the specified name. Throws an error if the vector store is not found.
+**vector** (`TVectors[TVectorName]`): The vector store instance with the specified name. Throws an error if the vector store is not found.
 
 ## Related
 

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

@@ -29,13 +29,13 @@ If you need to retrieve a workflow by its `id` property instead of its registrat
 
 ## Parameters
 
-**id:** (`TWorkflowId extends keyof TWorkflows`): The ID of the workflow to retrieve. Must be a valid workflow ID that exists in the Mastra configuration.
+**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
 
-**workflow:** (`TWorkflows[TWorkflowId]`): The workflow instance with the specified ID. Throws an error if the workflow is not found.
+**workflow** (`TWorkflows[TWorkflowId]`): The workflow instance with the specified ID. Throws an error if the workflow is not found.
 
 ## Related
 

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

@@ -14,7 +14,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**agents:** (`TAgents`): A record of all configured agents, where keys are agent names and values are agent instances.
+**agents** (`TAgents`): A record of all configured agents, where keys are agent names and values are agent instances.
 
 ## Related
 

package/.docs/reference/core/listGateways.md

@@ -29,7 +29,7 @@ None.
 
 ## Returns
 
-**gateways:** (`Record<string, MastraModelGateway>`): A record of gateway instances indexed by registration key
+**gateways** (`Record<string, MastraModelGateway>`): A record of gateway instances indexed by registration key
 
 ## Related
 

package/.docs/reference/core/listLogs.md

@@ -10,27 +10,25 @@ mastra.listLogs('456')
 
 ## Parameters
 
-**transportId:** (`string`): The transport ID to retrieve logs from.
+**transportId** (`string`): The transport ID to retrieve logs from.
 
-**options:** (`object`): Optional parameters for filtering and pagination. See Options section below for details.
+**options** (`object`): Optional parameters for filtering and pagination.
 
-### Options
+**options.fromDate** (`Date`): Optional start date for filtering logs. e.g., new Date('2024-01-01').
 
-**fromDate:** (`Date`): Optional start date for filtering logs. e.g., new Date('2024-01-01').
+**options.toDate** (`Date`): Optional end date for filtering logs. e.g., new Date('2024-01-31').
 
-**toDate:** (`Date`): Optional end date for filtering logs. e.g., new Date('2024-01-31').
+**options.logLevel** (`LogLevel`): Optional log level to filter by.
 
-**logLevel:** (`LogLevel`): Optional log level to filter by.
+**options.filters** (`Record<string, any>`): Optional additional filters to apply to the log query.
 
-**filters:** (`Record<string, any>`): Optional additional filters to apply to the log query.
+**options.page** (`number`): Optional page number for pagination.
 
-**page:** (`number`): Optional page number for pagination.
-
-**perPage:** (`number`): Optional number of logs per page for pagination.
+**options.perPage** (`number`): Optional number of logs per page for pagination.
 
 ## Returns
 
-**logs:** (`Promise<any>`): A promise that resolves to the logs for the specified transport ID.
+**logs** (`Promise<any>`): A promise that resolves to the logs for the specified transport ID.
 
 ## Related
 

package/.docs/reference/core/listLogsByRunId.md

@@ -10,25 +10,25 @@ mastra.listLogsByRunId({ runId: '123', transportId: '456' })
 
 ## Parameters
 
-**runId:** (`string`): The run ID to retrieve logs for.
+**runId** (`string`): The run ID to retrieve logs for.
 
-**transportId:** (`string`): The transport ID to retrieve logs from.
+**transportId** (`string`): The transport ID to retrieve logs from.
 
-**fromDate:** (`Date`): Optional start date for filtering logs. e.g., new Date('2024-01-01').
+**fromDate** (`Date`): Optional start date for filtering logs. e.g., new Date('2024-01-01').
 
-**toDate:** (`Date`): Optional end date for filtering logs. e.g., new Date('2024-01-31').
+**toDate** (`Date`): Optional end date for filtering logs. e.g., new Date('2024-01-31').
 
-**logLevel:** (`LogLevel`): Optional log level to filter by.
+**logLevel** (`LogLevel`): Optional log level to filter by.
 
-**filters:** (`Record<string, any>`): Optional additional filters to apply to the log query.
+**filters** (`Record<string, any>`): Optional additional filters to apply to the log query.
 
-**page:** (`number`): Optional page number for pagination.
+**page** (`number`): Optional page number for pagination.
 
-**perPage:** (`number`): Optional number of logs per page for pagination.
+**perPage** (`number`): Optional number of logs per page for pagination.
 
 ## Returns
 
-**logs:** (`Promise<any>`): A promise that resolves to the logs for the specified run ID and transport ID.
+**logs** (`Promise<any>`): A promise that resolves to the logs for the specified run ID and transport ID.
 
 ## Related
 

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

@@ -42,7 +42,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**servers:** (`Record<string, MCPServerBase> | undefined`): A record of all registered MCP server instances, where keys are the registry keys (from mcpServers configuration) and values are MCPServerBase instances, or undefined if no servers are registered.
+**servers** (`Record<string, MCPServerBase> | undefined`): A record of all registered MCP server instances, where keys are the registry keys (from mcpServers configuration) and values are MCPServerBase instances, or undefined if no servers are registered.
 
 ## Related Methods
 

package/.docs/reference/core/listMemory.md

@@ -18,7 +18,7 @@ This method takes no parameters.
 
 ## Returns
 
-**memory:** (`Record<string, MastraMemory>`): An object containing all registered memory instances, keyed by their registry keys.
+**memory** (`Record<string, MastraMemory>`): An object containing all registered memory instances, keyed by their registry keys.
 
 ## Example: Checking Registered Memory
 

package/.docs/reference/core/listScorers.md

@@ -20,7 +20,7 @@ This method takes no parameters.
 
 ## Returns
 
-**scorers:** (`Record<string, MastraScorer> | undefined`): An object containing all registered scorers, where keys are scorer names and values are MastraScorer instances. Returns undefined if no scorers are registered.
+**scorers** (`Record<string, MastraScorer> | undefined`): An object containing all registered scorers, where keys are scorer names and values are MastraScorer instances. Returns undefined if no scorers are registered.
 
 ## Related
 

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

@@ -33,27 +33,25 @@ for (const config of result.agents) {
 
 ## Parameters
 
-**args?:** (`object`): Optional configuration object for pagination and output format.
+**args** (`object`): Optional configuration object for pagination and output format.
 
-### Args Options
+**args.page** (`number`): Zero-indexed page number for pagination.
 
-**page?:** (`number`): Zero-indexed page number for pagination. (Default: `0`)
+**args.perPage** (`number | false`): Number of items per page. Set to \`false\` to fetch all records without pagination.
 
-**perPage?:** (`number | false`): Number of items per page. Set to \`false\` to fetch all records without pagination. (Default: `100`)
-
-**raw?:** (`boolean`): When \`true\`, returns raw \`StorageAgentType\` objects instead of \`Agent\` instances. (Default: `false`)
+**args.raw** (`boolean`): When \`true\`, returns raw \`StorageAgentType\` objects instead of \`Agent\` instances.
 
 ## Returns
 
-**agents:** (`Agent[] | StorageAgentType[]`): Array of \`Agent\` instances by default, or \`StorageAgentType\` objects when \`raw: true\`.
+**agents** (`Agent[] | StorageAgentType[]`): Array of \`Agent\` instances by default, or \`StorageAgentType\` objects when \`raw: true\`.
 
-**total:** (`number`): Total number of stored agents across all pages.
+**total** (`number`): Total number of stored agents across all pages.
 
-**page:** (`number`): Current page number (zero-indexed).
+**page** (`number`): Current page number (zero-indexed).
 
-**perPage:** (`number | false`): Number of items per page, or \`false\` if fetching all.
+**perPage** (`number | false`): Number of items per page, or \`false\` if fetching all.
 
-**hasMore:** (`boolean`): Whether there are more pages available.
+**hasMore** (`boolean`): Whether there are more pages available.
 
 ## Primitive Resolution
 

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

@@ -14,7 +14,7 @@ This method does not accept any parameters.
 
 ## Returns
 
-**vectors:** (`TVectors`): A record of all configured vector stores, where keys are vector store names and values are vector store instances.
+**vectors** (`TVectors`): A record of all configured vector stores, where keys are vector store names and values are vector store instances.
 
 ## Related
 

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

@@ -10,11 +10,11 @@ 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
 
-**workflows:** (`Record<string, Workflow>`): A record of all configured workflows, where keys are workflow IDs and values are workflow instances (or simplified objects if serialized is true).
+**workflows** (`Record<string, Workflow>`): A record of all configured workflows, where keys are workflow IDs and values are workflow instances (or simplified objects if serialized is true).
 
 ## Related
 

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

@@ -31,36 +31,36 @@ export const mastra = new Mastra({
 
 Visit the [Configuration reference](https://mastra.ai/reference/configuration) for detailed documentation on all available configuration options.
 
-**agents?:** (`Record<string, Agent>`): Agent instances to register, keyed by name (Default: `{}`)
+**agents** (`Record<string, Agent>`): Agent instances to register, keyed by name (Default: `{}`)
 
-**tools?:** (`Record<string, ToolApi>`): Custom tools to register. Structured as a key-value pair, with keys being the tool name and values being the tool function. (Default: `{}`)
+**tools** (`Record<string, ToolApi>`): Custom tools to register. Structured as a key-value pair, with keys being the tool name and values being the tool function. (Default: `{}`)
 
-**storage?:** (`MastraCompositeStore`): Storage engine instance for persisting data
+**storage** (`MastraCompositeStore`): Storage engine instance for persisting data
 
-**vectors?:** (`Record<string, MastraVector>`): Vector store instance, used for semantic search and vector-based tools (eg Pinecone, PgVector or Qdrant)
+**vectors** (`Record<string, MastraVector>`): Vector store instance, used for semantic search and vector-based tools (eg Pinecone, PgVector or Qdrant)
 
-**logger?:** (`Logger`): Logger instance created with new PinoLogger() (Default: `Console logger with INFO level`)
+**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** (`() => string`): Custom ID generator function. Used by agents, workflows, memory, and other components to generate unique identifiers.
 
-**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: `{}`)
+**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: `{}`)
 
-**tts?:** (`Record<string, MastraVoice>`): Text-to-speech providers for voice synthesis
+**tts** (`Record<string, MastraVoice>`): Text-to-speech providers for voice synthesis
 
-**observability?:** (`ObservabilityEntrypoint`): Observability configuration for tracing and monitoring
+**observability** (`ObservabilityEntrypoint`): Observability configuration for tracing and monitoring
 
-**deployer?:** (`MastraDeployer`): An instance of a MastraDeployer for managing deployments.
+**deployer** (`MastraDeployer`): An instance of a MastraDeployer for managing deployments.
 
-**server?:** (`ServerConfig`): Server configuration including port, host, timeout, API routes, middleware, CORS settings, and build options for Swagger UI, API request logging, and OpenAPI docs.
+**server** (`ServerConfig`): Server configuration including port, host, timeout, API routes, middleware, CORS settings, and build options for Swagger UI, API request logging, and OpenAPI docs.
 
-**mcpServers?:** (`Record<string, MCPServerBase>`): An object where keys are registry keys (used for getMCPServer()) and values are instances of MCPServer or classes extending MCPServerBase. Each MCPServer must have an id property. Servers can be retrieved by registry key using getMCPServer() or by their intrinsic id using getMCPServerById().
+**mcpServers** (`Record<string, MCPServerBase>`): An object where keys are registry keys (used for getMCPServer()) and values are instances of MCPServer or classes extending MCPServerBase. Each MCPServer must have an id property. Servers can be retrieved by registry key using getMCPServer() or by their intrinsic id using getMCPServerById().
 
-**bundler?:** (`BundlerConfig`): Configuration for the asset bundler with options for externals, sourcemap, and transpilePackages.
+**bundler** (`BundlerConfig`): Configuration for the asset bundler with options for externals, sourcemap, and transpilePackages.
 
-**scorers?:** (`Record<string, Scorer>`): Scorers for evaluating agent responses and workflow outputs (Default: `{}`)
+**scorers** (`Record<string, Scorer>`): Scorers for evaluating agent responses and workflow outputs (Default: `{}`)
 
-**processors?:** (`Record<string, Processor>`): Input/output processors for transforming agent inputs and outputs (Default: `{}`)
+**processors** (`Record<string, Processor>`): Input/output processors for transforming agent inputs and outputs (Default: `{}`)
 
-**gateways?:** (`Record<string, MastraModelGateway>`): Custom model gateways to register for accessing AI models through alternative providers or private deployments. Structured as a key-value pair, with keys being the registry key (used for getGateway()) and values being gateway instances. (Default: `{}`)
+**gateways** (`Record<string, MastraModelGateway>`): Custom model gateways to register for accessing AI models through alternative providers or private deployments. Structured as a key-value pair, with keys being the registry key (used for getGateway()) and values being gateway instances. (Default: `{}`)
 
-**memory?:** (`Record<string, MastraMemory>`): Memory instances to register. These can be referenced by stored agents and resolved at runtime. Structured as a key-value pair, with keys being the registry key and values being memory instances. (Default: `{}`)
+**memory** (`Record<string, MastraMemory>`): Memory instances to register. These can be referenced by stored agents and resolved at runtime. Structured as a key-value pair, with keys being the registry key and values being memory instances. (Default: `{}`)

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

@@ -55,9 +55,9 @@ class MyCustomGateway extends MastraModelGateway {
 
 ## Required Properties
 
-**id:** (`string`): Unique identifier for the gateway. This ID is used as the prefix for all providers from this gateway (e.g., "netlify/anthropic"). Exception: models.dev is a provider registry and doesn't use a prefix.
+**id** (`string`): Unique identifier for the gateway. This ID is used as the prefix for all providers from this gateway (e.g., "netlify/anthropic"). Exception: models.dev is a provider registry and doesn't use a prefix.
 
-**name:** (`string`): Human-readable name for the gateway.
+**name** (`string`): Human-readable name for the gateway.
 
 ## Required Methods
 
@@ -69,19 +69,19 @@ Fetches provider configurations from the gateway.
 
 **ProviderConfig Structure:**
 
-**name:** (`string`): Display name of the provider
+**name** (`string`): Display name of the provider
 
-**models:** (`string[]`): Array of available model IDs
+**models** (`string[]`): Array of available model IDs
 
-**apiKeyEnvVar:** (`string | string[]`): Environment variable(s) for API key
+**apiKeyEnvVar** (`string | string[]`): Environment variable(s) for API key
 
-**gateway:** (`string`): Gateway identifier
+**gateway** (`string`): Gateway identifier
 
-**url?:** (`string`): Optional base API URL
+**url** (`string`): Optional base API URL
 
-**apiKeyHeader?:** (`string`): Optional custom auth header name
+**apiKeyHeader** (`string`): Optional custom auth header name
 
-**docUrl?:** (`string`): Optional documentation URL
+**docUrl** (`string`): Optional documentation URL
 
 ### buildUrl()
 
@@ -89,9 +89,9 @@ Builds the API URL for a specific model/provider combination.
 
 **Parameters:**
 
-**modelId:** (`string`): Full model ID (e.g., "custom/my-provider/model-1")
+**modelId** (`string`): Full model ID (e.g., "custom/my-provider/model-1")
 
-**envVars?:** (`Record<string, string>`): Optional environment variables
+**envVars** (`Record<string, string>`): Optional environment variables
 
 **Returns:** `string | undefined | Promise<string | undefined>`
 
@@ -101,7 +101,7 @@ Retrieves the API key for authentication.
 
 **Parameters:**
 
-**modelId:** (`string`): Full model ID
+**modelId** (`string`): Full model ID
 
 **Returns:** `Promise<string>`
 
@@ -111,11 +111,11 @@ Creates a language model instance.
 
 **Parameters:**
 
-**modelId:** (`string`): The model ID
+**modelId** (`string`): The model ID
 
-**providerId:** (`string`): The provider ID
+**providerId** (`string`): The provider ID
 
-**apiKey:** (`string`): The API key for authentication
+**apiKey** (`string`): The API key for authentication
 
 **Returns:** `Promise<LanguageModelV2> | LanguageModelV2`
 

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

@@ -10,11 +10,9 @@ mastra.setLogger({ logger: new PinoLogger({ name: 'testLogger' }) })
 
 ## Parameters
 
-**options:** (`{ logger: TLogger }`): An object containing the logger instance to set for all components.
+**options** (`{ logger: TLogger }`): An object containing the logger instance to set for all components.
 
-### Options
-
-**logger:** (`TLogger`): The logger instance to set for all components (agents, workflows, etc.).
+**options.logger** (`TLogger`): The logger instance to set for all components (agents, workflows, etc.).
 
 ## Returns
 

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

@@ -15,7 +15,7 @@ mastra.setStorage(
 
 ## Parameters
 
-**storage:** (`MastraCompositeStore`): The storage instance to set for the Mastra instance.
+**storage** (`MastraCompositeStore`): The storage instance to set for the Mastra instance.
 
 ## Returns
 

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

@@ -26,12 +26,28 @@ console.log(item.id)
 
 ## Parameters
 
-**input:** (`unknown`): Input data for the item.
+**input** (`unknown`): Input data for the item.
 
-**groundTruth?:** (`unknown`): Expected output or ground truth for scoring.
+**groundTruth** (`unknown`): Expected output or ground truth for scoring.
 
-**metadata?:** (`Record<string, unknown>`): Arbitrary metadata for the item.
+**metadata** (`Record<string, unknown>`): Arbitrary metadata for the item.
 
 ## Returns
 
-**result:** (`Promise<DatasetItem>`): DatasetItemid:stringUnique identifier of the item.datasetId:stringID of the parent dataset.datasetVersion:numberDataset version when the item was created.input:unknownInput data.groundTruth?:unknownGround truth data.metadata?:Record\<string, unknown>Item metadata.createdAt:DateWhen the item was created.updatedAt:DateWhen the item was last updated.
+**result** (`Promise<DatasetItem>`): The created dataset item.
+
+**result.id** (`string`): Unique identifier of the item.
+
+**result.datasetId** (`string`): ID of the parent dataset.
+
+**result.datasetVersion** (`number`): Dataset version when the item was created.
+
+**result.input** (`unknown`): Input data.
+
+**result.groundTruth** (`unknown`): Ground truth data.
+
+**result.metadata** (`Record<string, unknown>`): Item metadata.
+
+**result.createdAt** (`Date`): When the item was created.
+
+**result.updatedAt** (`Date`): When the item was last updated.

package/.docs/reference/datasets/addItems.md

@@ -28,8 +28,14 @@ console.log(`Added ${items.length} items`)
 
 ## Parameters
 
-**items:** (`Array<object>`): DatasetIteminput:unknownInput data for the item.groundTruth?:unknownExpected output or ground truth.metadata?:Record\<string, unknown>Arbitrary metadata.
+**items** (`Array<object>`): Array of items to add. Each item has the same shape as the dataset.addItem() input.
+
+**items.input** (`unknown`): Input data for the item.
+
+**items.groundTruth** (`unknown`): Expected output or ground truth.
+
+**items.metadata** (`Record<string, unknown>`): Arbitrary metadata.
 
 ## Returns
 
-**result:** (`Promise<DatasetItem[]>`): Array of created dataset items. See dataset.addItem() for the item shape.
+**result** (`Promise<DatasetItem[]>`): Array of created dataset items. See dataset.addItem() for the item shape.

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

@@ -36,15 +36,27 @@ for (const item of comparison.items) {
 
 ## Parameters
 
-**experimentIds:** (`string[]`): Array of experiment IDs to compare. Must contain at least 2.
+**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
 
 Throws `MastraError` if fewer than 2 experiment IDs are provided.
 
-**result:** (`Promise<object>`): objectbaselineId:stringID of the baseline experiment used for comparison.items:Array\<object>Per-item comparison data.objectitemId:stringID of the dataset item.input:unknown | nullInput data for the item.groundTruth:unknown | nullGround truth for the item.results:Record\<string, { output: unknown; scores: Record\<string, number | null> } | null>Results keyed by experiment ID. Each entry contains the output and scorer results for that experiment.
+**result** (`Promise<object>`): Comparison results.
+
+**result.baselineId** (`string`): ID of the baseline experiment used for comparison.
+
+**result.items** (`Array<object>`): Per-item comparison data.
+
+**result.items.itemId** (`string`): ID of the dataset item.
+
+**result.items.input** (`unknown | null`): Input data for the item.
+
+**result.items.groundTruth** (`unknown | null`): Ground truth for the item.
+
+**result.items.results** (`Record<string, { output: unknown; scores: Record<string, number | null> } | null>`): Results keyed by experiment ID. Each entry contains the output and scorer results for that experiment.
 
 ## Related
 

package/.docs/reference/datasets/create.md

@@ -36,16 +36,16 @@ const typedDataset = await mastra.datasets.create({
 
 ## Parameters
 
-**name:** (`string`): Display name for the dataset.
+**name** (`string`): Display name for the dataset.
 
-**description?:** (`string`): Description of the dataset.
+**description** (`string`): Description of the dataset.
 
-**inputSchema?:** (`unknown`): JSON Schema or Zod schema for item inputs. Zod schemas are auto-converted.
+**inputSchema** (`unknown`): JSON Schema or Zod schema for item inputs. Zod schemas are auto-converted.
 
-**groundTruthSchema?:** (`unknown`): JSON Schema or Zod schema for item ground truths. Zod schemas are auto-converted.
+**groundTruthSchema** (`unknown`): JSON Schema or Zod schema for item ground truths. Zod schemas are auto-converted.
 
-**metadata?:** (`Record<string, unknown>`): Arbitrary metadata.
+**metadata** (`Record<string, unknown>`): Arbitrary metadata.
 
 ## Returns
 
-**result:** (`Promise<Dataset>`): A Dataset instance for the newly created dataset.
+**result** (`Promise<Dataset>`): A Dataset instance for the newly created dataset.

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

@@ -72,7 +72,7 @@ const dataset = await mastra.datasets.create({ name: 'My dataset' })
 
 For the full dataset record (name, description, schemas, version, timestamps), call [`dataset.getDetails()`](https://mastra.ai/reference/datasets/getDetails).
 
-**id:** (`string`): The unique identifier of the dataset. Read-only.
+**id** (`string`): The unique identifier of the dataset. Read-only.
 
 ## Related