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

package/.docs/reference/voice/voice.listen.md

@@ -4,9 +4,9 @@ The `listen()` method is a core function available in all Mastra voice providers
 
 ## Parameters
 
-**audioStream:** (`NodeJS.ReadableStream`): Audio stream to transcribe. This can be a file stream or a microphone stream.
+**audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe. This can be a file stream or a microphone stream.
 
-**options?:** (`object`): Provider-specific options for speech recognition
+**options** (`object`): Provider-specific options for speech recognition
 
 ## Return Value
 
@@ -22,23 +22,23 @@ Each voice provider may support additional options specific to their implementat
 
 ### OpenAI
 
-**options.filetype?:** (`string`): Audio file format (e.g., 'mp3', 'wav', 'm4a') (Default: `'mp3'`)
+**options.filetype** (`string`): Audio file format (e.g., 'mp3', 'wav', 'm4a') (Default: `'mp3'`)
 
-**options.prompt?:** (`string`): Text to guide the model's transcription
+**options.prompt** (`string`): Text to guide the model's transcription
 
-**options.language?:** (`string`): Language code (e.g., 'en', 'fr', 'de')
+**options.language** (`string`): Language code (e.g., 'en', 'fr', 'de')
 
 ### Google
 
-**options.stream?:** (`boolean`): Whether to use streaming recognition (Default: `false`)
+**options.stream** (`boolean`): Whether to use streaming recognition (Default: `false`)
 
-**options.config?:** (`object`): Recognition configuration from Google Cloud Speech-to-Text API (Default: `{ encoding: 'LINEAR16', languageCode: 'en-US' }`)
+**options.config** (`object`): Recognition configuration from Google Cloud Speech-to-Text API (Default: `{ encoding: 'LINEAR16', languageCode: 'en-US' }`)
 
 ### Deepgram
 
-**options.model?:** (`string`): Deepgram model to use for transcription (Default: `'nova-2'`)
+**options.model** (`string`): Deepgram model to use for transcription (Default: `'nova-2'`)
 
-**options.language?:** (`string`): Language code for transcription (Default: `'en'`)
+**options.language** (`string`): Language code for transcription (Default: `'en'`)
 
 ## Usage Example
 

package/.docs/reference/voice/voice.off.md

@@ -37,9 +37,9 @@ voice.off('writing', writingCallback)
 
 ## Parameters
 
-**event:** (`string`): Name of the event to stop listening for (e.g., 'speaking', 'writing', 'error')
+**event** (`string`): Name of the event to stop listening for (e.g., 'speaking', 'writing', 'error')
 
-**callback:** (`function`): The same callback function that was passed to on()
+**callback** (`function`): The same callback function that was passed to on()
 
 ## Return Value
 

package/.docs/reference/voice/voice.on.md

@@ -48,9 +48,9 @@ voice.on('error', ({ message, code, details }) => {
 
 ## Parameters
 
-**event:** (`string`): Name of the event to listen for. See the \[Voice Events]\(./voice.events) documentation for a list of available events.
+**event** (`string`): Name of the event to listen for. See the \[Voice Events]\(./voice.events) documentation for a list of available events.
 
-**callback:** (`function`): Callback function that will be called when the event occurs. The callback signature depends on the specific event.
+**callback** (`function`): Callback function that will be called when the event occurs. The callback signature depends on the specific event.
 
 ## Return Value
 

package/.docs/reference/voice/voice.send.md

@@ -48,7 +48,7 @@ await voice.send(audioBuffer)
 
 ## Parameters
 
-**audioData:** (`NodeJS.ReadableStream | Int16Array`): Audio data to send to the voice provider. Can be a readable stream (like a microphone stream) or an Int16Array of audio samples.
+**audioData** (`NodeJS.ReadableStream | Int16Array`): Audio data to send to the voice provider. Can be a readable stream (like a microphone stream) or an Int16Array of audio samples.
 
 ## Return Value
 

package/.docs/reference/voice/voice.speak.md

@@ -4,11 +4,11 @@ The `speak()` method is a core function available in all Mastra voice providers
 
 ## Parameters
 
-**input:** (`string | NodeJS.ReadableStream`): Text to convert to speech. Can be a string or a readable stream of text.
+**input** (`string | NodeJS.ReadableStream`): Text to convert to speech. Can be a string or a readable stream of text.
 
-**options?:** (`object`): Options for speech synthesis
+**options** (`object`): Options for speech synthesis
 
-**options.speaker?:** (`string`): Voice ID to use for this specific request. Overrides the default speaker set in the constructor.
+**options.speaker** (`string`): Voice ID to use for this specific request. Overrides the default speaker set in the constructor.
 
 ## Return Value
 
@@ -23,27 +23,27 @@ Each voice provider may support additional options specific to their implementat
 
 ### OpenAI
 
-**options.speed?:** (`number`): Speech speed multiplier. Values between 0.25 and 4.0 are supported. (Default: `1.0`)
+**options.speed** (`number`): Speech speed multiplier. Values between 0.25 and 4.0 are supported. (Default: `1.0`)
 
 ### ElevenLabs
 
-**options.stability?:** (`number`): Voice stability. Higher values result in more stable, less expressive speech. (Default: `0.5`)
+**options.stability** (`number`): Voice stability. Higher values result in more stable, less expressive speech. (Default: `0.5`)
 
-**options.similarity\_boost?:** (`number`): Voice clarity and similarity to the original voice. (Default: `0.75`)
+**options.similarity\_boost** (`number`): Voice clarity and similarity to the original voice. (Default: `0.75`)
 
 ### Google
 
-**options.languageCode?:** (`string`): Language code for the voice (e.g., 'en-US').
+**options.languageCode** (`string`): Language code for the voice (e.g., 'en-US').
 
-**options.audioConfig?:** (`object`): Audio configuration options from Google Cloud Text-to-Speech API. (Default: `{ audioEncoding: 'LINEAR16' }`)
+**options.audioConfig** (`object`): Audio configuration options from Google Cloud Text-to-Speech API. (Default: `{ audioEncoding: 'LINEAR16' }`)
 
 ### Murf
 
-**options.properties.rate?:** (`number`): Speech rate multiplier.
+**options.properties.rate** (`number`): Speech rate multiplier.
 
-**options.properties.pitch?:** (`number`): Voice pitch adjustment.
+**options.properties.pitch** (`number`): Voice pitch adjustment.
 
-**options.properties.format?:** (`'MP3' | 'WAV' | 'FLAC' | 'ALAW' | 'ULAW'`): Output audio format.
+**options.properties.format** (`'MP3' | 'WAV' | 'FLAC' | 'ALAW' | 'ULAW'`): Output audio format.
 
 ## Usage Example
 

package/.docs/reference/voice/voice.updateConfig.md

@@ -35,7 +35,7 @@ await voice.speak('Hello with my new voice!')
 
 ## Parameters
 
-**options:** (`Record<string, unknown>`): Configuration options to update. The specific properties depend on the voice provider.
+**options** (`Record<string, unknown>`): Configuration options to update. The specific properties depend on the voice provider.
 
 ## Return Value
 
@@ -47,9 +47,9 @@ Different voice providers support different configuration options:
 
 ### OpenAI Realtime
 
-**voice?:** (`string`): Voice ID to use for speech synthesis (e.g., 'alloy', 'echo', 'nova')
+**voice** (`string`): Voice ID to use for speech synthesis (e.g., 'alloy', 'echo', 'nova')
 
-**turn\_detection?:** (`{ type: string, threshold?: number, silence_duration_ms?: number }`): Configuration for detecting when a user has finished speaking
+**turn\_detection** (`{ type: string, threshold?: number, silence_duration_ms?: number }`): Configuration for detecting when a user has finished speaking
 
 ## Notes
 

package/.docs/reference/workflows/run-methods/cancel.md

@@ -15,11 +15,11 @@ await run.cancel()
 
 ## Parameters
 
-**No parameters:** (`void`): This method takes no parameters
+**No parameters** (`void`): This method takes no parameters
 
 ## Returns
 
-**result:** (`Promise<{ message: string }>`): A promise that resolves with { message: 'Workflow run canceled' } when cancellation succeeds
+**result** (`Promise<{ message: string }>`): A promise that resolves with { message: 'Workflow run canceled' } when cancellation succeeds
 
 ## How cancellation works
 

package/.docs/reference/workflows/run-methods/restart.md

@@ -14,17 +14,29 @@ const restartedResult = await run.restart()
 
 ## Parameters
 
-**requestContext?:** (`RequestContext`): Request Context data to use when resuming
+**requestContext** (`RequestContext`): Request Context data to use when resuming
 
-**tracingContext?:** (`TracingContext`): currentSpan?:SpanCurrent span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
+**tracingContext** (`TracingContext`): Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.
 
-**tracingOptions?:** (`TracingOptions`): metadata?:Record\<string, any>Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.requestContextKeys?:string\[]Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').traceId?:stringTrace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.parentSpanId?:stringParent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.tags?:string\[]Tags to apply to this trace. String labels for categorizing and filtering traces.
+**tracingContext.currentSpan** (`Span`): Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
+
+**tracingOptions** (`TracingOptions`): Options for Tracing configuration.
+
+**tracingOptions.metadata** (`Record<string, any>`): Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.
+
+**tracingOptions.requestContextKeys** (`string[]`): Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').
+
+**tracingOptions.traceId** (`string`): Trace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+
+**tracingOptions.parentSpanId** (`string`): Parent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.
+
+**tracingOptions.tags** (`string[]`): Tags to apply to this trace. String labels for categorizing and filtering traces.
 
 ## Returns
 
-**result:** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
+**result** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
 
-**traceId?:** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
+**traceId** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
 
 ## Related
 

package/.docs/reference/workflows/run-methods/resume.md

@@ -18,25 +18,39 @@ if (result.status === 'suspended') {
 
 ## Parameters
 
-**resumeData?:** (`z.infer<TResumeSchema>`): Data for resuming the suspended step
+**resumeData** (`z.infer<TResumeSchema>`): Data for resuming the suspended step
 
-**step?:** (`Step<string, any, any, TResumeSchema, any, TEngineType> | [...Step<string, any, any, any, any, TEngineType>[], Step<string, any, any, TResumeSchema, any, TEngineType>] | string | string[]`): The step(s) to resume execution from. Can be a Step instance, array of Steps, step ID string, or array of step ID strings
+**step** (`Step<string, any, any, TResumeSchema, any, TEngineType> | [...Step<string, any, any, any, any, TEngineType>[], Step<string, any, any, TResumeSchema, any, TEngineType>] | string | string[]`): The step(s) to resume execution from. Can be a Step instance, array of Steps, step ID string, or array of step ID strings
 
-**requestContext?:** (`RequestContext`): Request Context data to use when resuming
+**requestContext** (`RequestContext`): Request Context data to use when resuming
 
-**retryCount?:** (`number`): Optional retry count for nested workflow execution
+**retryCount** (`number`): Optional retry count for nested workflow execution
 
-**tracingContext?:** (`TracingContext`): currentSpan?:SpanCurrent span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
+**tracingContext** (`TracingContext`): Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.
 
-**tracingOptions?:** (`TracingOptions`): metadata?:Record\<string, any>Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.requestContextKeys?:string\[]Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').traceId?:stringTrace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.parentSpanId?:stringParent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.tags?:string\[]Tags to apply to this trace. String labels for categorizing and filtering traces.
+**tracingContext.currentSpan** (`Span`): Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
 
-**outputOptions?:** (`OutputOptions`): includeState?:booleanWhether to include the workflow run state in the result.
+**tracingOptions** (`TracingOptions`): Options for Tracing configuration.
+
+**tracingOptions.metadata** (`Record<string, any>`): Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.
+
+**tracingOptions.requestContextKeys** (`string[]`): Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').
+
+**tracingOptions.traceId** (`string`): Trace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+
+**tracingOptions.parentSpanId** (`string`): Parent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.
+
+**tracingOptions.tags** (`string[]`): Tags to apply to this trace. String labels for categorizing and filtering traces.
+
+**outputOptions** (`OutputOptions`): Options for output configuration.
+
+**outputOptions.includeState** (`boolean`): Whether to include the workflow run state in the result.
 
 ## Returns
 
-**result:** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
+**result** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
 
-**traceId?:** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
+**traceId** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
 
 ## Extended usage example
 

package/.docs/reference/workflows/run-methods/start.md

@@ -16,23 +16,37 @@ const result = await run.start({
 
 ## Parameters
 
-**inputData?:** (`z.infer<TInput>`): Input data that matches the workflow's input schema
+**inputData** (`z.infer<TInput>`): Input data that matches the workflow's input schema
 
-**requestContext?:** (`RequestContext`): Request Context data to use during workflow execution
+**requestContext** (`RequestContext`): Request Context data to use during workflow execution
 
-**outputWriter?:** (`(chunk: TOutput) => Promise<void>`): Optional asynchronous function to handle output chunks as they are produced
+**outputWriter** (`(chunk: TOutput) => Promise<void>`): Optional asynchronous function to handle output chunks as they are produced
 
-**tracingContext?:** (`TracingContext`): currentSpan?:SpanCurrent span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
+**tracingContext** (`TracingContext`): Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.
 
-**tracingOptions?:** (`TracingOptions`): metadata?:Record\<string, any>Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.requestContextKeys?:string\[]Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').traceId?:stringTrace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.parentSpanId?:stringParent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.tags?:string\[]Tags to apply to this trace. String labels for categorizing and filtering traces.
+**tracingContext.currentSpan** (`Span`): Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
 
-**outputOptions?:** (`OutputOptions`): includeState?:booleanWhether to include the workflow run state in the result.
+**tracingOptions** (`TracingOptions`): Options for Tracing configuration.
+
+**tracingOptions.metadata** (`Record<string, any>`): Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.
+
+**tracingOptions.requestContextKeys** (`string[]`): Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').
+
+**tracingOptions.traceId** (`string`): Trace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+
+**tracingOptions.parentSpanId** (`string`): Parent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.
+
+**tracingOptions.tags** (`string[]`): Tags to apply to this trace. String labels for categorizing and filtering traces.
+
+**outputOptions** (`OutputOptions`): Options for output configuration.
+
+**outputOptions.includeState** (`boolean`): Whether to include the workflow run state in the result.
 
 ## Returns
 
-**result:** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
+**result** (`Promise<WorkflowResult<TState, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
 
-**traceId?:** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
+**traceId** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
 
 ## Extended usage example
 

package/.docs/reference/workflows/run-methods/startAsync.md

@@ -20,19 +20,25 @@ const result = await workflow.getWorkflowRunExecutionResult(runId)
 
 ## Parameters
 
-**inputData?:** (`z.infer<TInput>`): Input data that matches the workflow's input schema
+**inputData** (`z.infer<TInput>`): Input data that matches the workflow's input schema
 
-**requestContext?:** (`RequestContext`): Request Context data to use during workflow execution
+**requestContext** (`RequestContext`): Request Context data to use during workflow execution
 
-**initialState?:** (`z.infer<TState>`): Initial state to use for the workflow execution
+**initialState** (`z.infer<TState>`): Initial state to use for the workflow execution
 
-**tracingOptions?:** (`TracingOptions`): metadata?:Record\<string, any>Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.traceId?:stringTrace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+**tracingOptions** (`TracingOptions`): Options for Tracing configuration.
 
-**outputOptions?:** (`OutputOptions`): includeState?:booleanWhether to include the workflow run state in the result.
+**tracingOptions.metadata** (`Record<string, any>`): Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.
+
+**tracingOptions.traceId** (`string`): Trace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+
+**outputOptions** (`OutputOptions`): Options for output configuration.
+
+**outputOptions.includeState** (`boolean`): Whether to include the workflow run state in the result.
 
 ## Returns
 
-**runId:** (`string`): The unique identifier for this workflow run. Use this to check status or retrieve results later.
+**runId** (`string`): The unique identifier for this workflow run. Use this to check status or retrieve results later.
 
 ## When to use startAsync()
 

package/.docs/reference/workflows/run-methods/timeTravel.md

@@ -15,33 +15,49 @@ const result = await run.timeTravel({
 
 ## Parameters
 
-**step:** (`Step<string, any, TInputSchema, any, any, any, TEngineType> | [...Step<string, any, any, any, any, any, TEngineType>[], Step<string, any, TInputSchema, any, any, any, TEngineType>] | string | string[]`): The target step to start execution from. It can be a Step instance, array of Steps (for nested workflows), step ID string, or array of step ID strings. Use dot notation or arrays for nested workflow steps (e.g., 'nestedWorkflow\.step3' or \['nestedWorkflow', 'step3'])
+**step** (`Step<string, any, TInputSchema, any, any, any, TEngineType> | [...Step<string, any, any, any, any, any, TEngineType>[], Step<string, any, TInputSchema, any, any, any, TEngineType>] | string | string[]`): The target step to start execution from. It can be a Step instance, array of Steps (for nested workflows), step ID string, or array of step ID strings. Use dot notation or arrays for nested workflow steps (e.g., 'nestedWorkflow\.step3' or \['nestedWorkflow', 'step3'])
 
-**inputData?:** (`z.infer<TInputSchema>`): Input data for the target step. Must match the step's input schema. If not provided, uses data from the workflow snapshot
+**inputData** (`z.infer<TInputSchema>`): Input data for the target step. Must match the step's input schema. If not provided, uses data from the workflow snapshot
 
-**resumeData?:** (`any`): Resume data to provide if the workflow was previously suspended
+**resumeData** (`any`): Resume data to provide if the workflow was previously suspended
 
-**initialState?:** (`z.infer<TState>`): Initial state to set for the workflow run. Used to set workflow-level state before execution
+**initialState** (`z.infer<TState>`): Initial state to set for the workflow run. Used to set workflow-level state before execution
 
-**context?:** (`TimeTravelContext<any, any, any, any>`): Execution context containing step results for steps before the target step. Each key is a step ID with a StepResult object containing status, payload, output, startedAt, endedAt, suspendPayload, and resumePayload
+**context** (`TimeTravelContext<any, any, any, any>`): Execution context containing step results for steps before the target step. Each key is a step ID with a StepResult object containing status, payload, output, startedAt, endedAt, suspendPayload, and resumePayload
 
-**nestedStepsContext?:** (`Record<string, TimeTravelContext<any, any, any, any>>`): Context for nested workflow steps. Keyed by nested workflow ID, each containing step results for that nested workflow
+**nestedStepsContext** (`Record<string, TimeTravelContext<any, any, any, any>>`): Context for nested workflow steps. Keyed by nested workflow ID, each containing step results for that nested workflow
 
-**requestContext?:** (`RequestContext`): Request Context data to use during time travel execution
+**requestContext** (`RequestContext`): Request Context data to use during time travel execution
 
-**outputWriter?:** (`(chunk: TOutput) => Promise<void>`): Optional asynchronous function to handle output chunks as they are produced
+**outputWriter** (`(chunk: TOutput) => Promise<void>`): Optional asynchronous function to handle output chunks as they are produced
 
-**tracingContext?:** (`TracingContext`): currentSpan?:SpanCurrent span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
+**tracingContext** (`TracingContext`): Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.
 
-**tracingOptions?:** (`TracingOptions`): metadata?:Record\<string, any>Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.requestContextKeys?:string\[]Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').traceId?:stringTrace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.parentSpanId?:stringParent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.tags?:string\[]Tags to apply to this trace. String labels for categorizing and filtering traces.
+**tracingContext.currentSpan** (`Span`): Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.
 
-**outputOptions?:** (`OutputOptions`): includeState?:booleanWhether to include the workflow run state in the result.includeResumeLabels?:booleanWhether to include resume labels in the result.
+**tracingOptions** (`TracingOptions`): Options for Tracing configuration.
+
+**tracingOptions.metadata** (`Record<string, any>`): Metadata to add to the root trace span. Useful for adding custom attributes like user IDs, session IDs, or feature flags.
+
+**tracingOptions.requestContextKeys** (`string[]`): Additional RequestContext keys to extract as metadata for this trace. Supports dot notation for nested values (e.g., 'user.id').
+
+**tracingOptions.traceId** (`string`): Trace ID to use for this execution (1-32 hexadecimal characters). If provided, this trace will be part of the specified trace.
+
+**tracingOptions.parentSpanId** (`string`): Parent span ID to use for this execution (1-16 hexadecimal characters). If provided, the root span will be created as a child of this span.
+
+**tracingOptions.tags** (`string[]`): Tags to apply to this trace. String labels for categorizing and filtering traces.
+
+**outputOptions** (`OutputOptions`): Options for output configuration.
+
+**outputOptions.includeState** (`boolean`): Whether to include the workflow run state in the result.
+
+**outputOptions.includeResumeLabels** (`boolean`): Whether to include resume labels in the result.
 
 ## Returns
 
-**result:** (`Promise<WorkflowResult<TState, TInput, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
+**result** (`Promise<WorkflowResult<TState, TInput, TOutput, TSteps>>`): A promise that resolves to the workflow execution result containing step outputs and status
 
-**traceId?:** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
+**traceId** (`string`): The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.
 
 ## Extended usage examples
 

package/.docs/reference/workflows/run.md

@@ -20,33 +20,33 @@ if (result.status === 'suspended') {
 
 ## Run Methods
 
-**start:** (`(options?: StartOptions) => Promise<WorkflowResult>`): Starts workflow execution with input data
+**start** (`(options?: StartOptions) => Promise<WorkflowResult>`): Starts workflow execution with input data
 
-**resume:** (`(options?: ResumeOptions) => Promise<WorkflowResult>`): Resumes a suspended workflow from a specific step
+**resume** (`(options?: ResumeOptions) => Promise<WorkflowResult>`): Resumes a suspended workflow from a specific step
 
-**stream:** (`(options?: StreamOptions) => MastraWorkflowStream`): Monitors workflow execution as a stream of events with enhanced streaming features
+**stream** (`(options?: StreamOptions) => MastraWorkflowStream`): Monitors workflow execution as a stream of events with enhanced streaming features
 
-**resumeStream:** (`(options?: ResumeStreamOptions) => MastraWorkflowStream`): Resumes a suspended workflow with streaming support
+**resumeStream** (`(options?: ResumeStreamOptions) => MastraWorkflowStream`): Resumes a suspended workflow with streaming support
 
-**cancel:** (`() => Promise<{ message: string }>`): Cancels the workflow execution, stopping any running steps and preventing subsequent steps from executing
+**cancel** (`() => Promise<{ message: string }>`): Cancels the workflow execution, stopping any running steps and preventing subsequent steps from executing
 
-**restart:** (`(options?: RestartOptions) => Promise<WorkflowResult>`): Restarts the workflow execution from last active step
+**restart** (`(options?: RestartOptions) => Promise<WorkflowResult>`): Restarts the workflow execution from last active step
 
-**timeTravel:** (`(options?: TimeTravelOptions) => Promise<WorkflowResult>`): Re-executes a workflow starting from any specific step, using either stored snapshot data or custom context you provide.
+**timeTravel** (`(options?: TimeTravelOptions) => Promise<WorkflowResult>`): Re-executes a workflow starting from any specific step, using either stored snapshot data or custom context you provide.
 
-**timeTravelStream:** (`(options?: TimeTravelOptions) => MastraWorkflowStream`): Time travels a workflow execution with streaming support
+**timeTravelStream** (`(options?: TimeTravelOptions) => MastraWorkflowStream`): Time travels a workflow execution with streaming support
 
 ## Run Status
 
 A workflow run's `status` indicates its current execution state. The possible values are:
 
-**success:** (`string`): All steps finished executing successfully, with a valid result output
+**success** (`string`): All steps finished executing successfully, with a valid result output
 
-**failed:** (`string`): Workflow execution encountered an error during execution, with error details available
+**failed** (`string`): Workflow execution encountered an error during execution, with error details available
 
-**suspended:** (`string`): Workflow execution is paused waiting for resume, with suspended step information
+**suspended** (`string`): Workflow execution is paused waiting for resume, with suspended step information
 
-**canceled:** (`string`): Workflow execution was canceled via the cancel() method, stopping any running steps and preventing subsequent steps from executing
+**canceled** (`string`): Workflow execution was canceled via the cancel() method, stopping any running steps and preventing subsequent steps from executing
 
 ## Related
 

package/.docs/reference/workflows/step.md

@@ -60,57 +60,55 @@ const agentStep = createStep(testAgent, {
 
 ### Agent step options
 
-**structuredOutput:** (`{ schema: z.ZodType<any> }`): When provided, the agent returns structured data matching this schema instead of plain text. The step's outputSchema is set to the provided schema.
+**structuredOutput** (`{ schema: z.ZodType<any> }`): When provided, the agent returns structured data matching this schema instead of plain text. The step's outputSchema is set to the provided schema.
 
-**onFinish:** (`(result: AgentResult) => void`): Callback invoked when the agent completes generation.
+**onFinish** (`(result: AgentResult) => void`): Callback invoked when the agent completes generation.
 
 ## Constructor Parameters
 
-**id:** (`string`): Unique identifier for the step
+**id** (`string`): Unique identifier for the step
 
-**description:** (`string`): Optional description of what the step does
+**description** (`string`): Optional description of what the step does
 
-**inputSchema:** (`z.ZodType<any>`): Zod schema defining the input structure
+**inputSchema** (`z.ZodType<any>`): Zod schema defining the input structure
 
-**outputSchema:** (`z.ZodType<any>`): Zod schema defining the output structure
+**outputSchema** (`z.ZodType<any>`): Zod schema defining the output structure
 
-**resumeSchema:** (`z.ZodType<any>`): Optional Zod schema for resuming the step
+**resumeSchema** (`z.ZodType<any>`): Optional Zod schema for resuming the step
 
-**suspendSchema:** (`z.ZodType<any>`): Optional Zod schema for suspending the step
+**suspendSchema** (`z.ZodType<any>`): Optional Zod schema for suspending the step
 
-**stateSchema:** (`z.ZodObject<any>`): Optional Zod schema for the step state. Automatically injected when using Mastra's state system. The stateSchema must be a subset of the workflow's stateSchema. If not specified, type is 'any'.
+**stateSchema** (`z.ZodObject<any>`): Optional Zod schema for the step state. Automatically injected when using Mastra's state system. The stateSchema must be a subset of the workflow's stateSchema. If not specified, type is 'any'.
 
-**requestContextSchema:** (`z.ZodType<any>`): Zod schema for validating request context values. When provided, the context is validated before the step's execute() runs, failing the step if validation fails.
+**requestContextSchema** (`z.ZodType<any>`): Zod schema for validating request context values. When provided, the context is validated before the step's execute() runs, failing the step if validation fails.
 
-**execute:** (`(params: ExecuteParams) => Promise<any>`): Async function containing step logic
+**execute** (`(params: ExecuteParams) => Promise<any>`): Async function containing step logic
 
-**metadata:** (`Record<string, any>`): Optional key-value pairs for storing additional step information. Values must be serializable (no functions, circular references, etc.).
+**execute.inputData** (`z.infer<TStepInput>`): The input data matching the inputSchema
 
-### ExecuteParams
+**execute.resumeData** (`z.infer<TResumeSchema>`): The resume data matching the resumeSchema, when resuming the step from a suspended state. Only exists if the step is being resumed.
 
-**inputData:** (`z.infer<TStepInput>`): The input data matching the inputSchema
+**execute.suspendData** (`z.infer<TSuspendSchema>`): The suspend data that was originally passed to suspend() when the step was suspended. Only exists if the step is being resumed and was previously suspended with data.
 
-**resumeData:** (`z.infer<TResumeSchema>`): The resume data matching the resumeSchema, when resuming the step from a suspended state. Only exists if the step is being resumed.
+**execute.mastra** (`Mastra`): Access to Mastra services (agents, tools, etc.)
 
-**suspendData:** (`z.infer<TSuspendSchema>`): The suspend data that was originally passed to suspend() when the step was suspended. Only exists if the step is being resumed and was previously suspended with data.
+**execute.getStepResult** (`(step: Step | string) => any`): Function to access results from other steps
 
-**mastra:** (`Mastra`): Access to Mastra services (agents, tools, etc.)
+**execute.getInitData** (`() => any`): Function to access the initial input data of the workflow in any step
 
-**getStepResult:** (`(step: Step | string) => any`): Function to access results from other steps
+**execute.suspend** (`(suspendPayload: any, suspendOptions?: { resumeLabel?: string }) => Promise<void>`): Function to pause workflow execution
 
-**getInitData:** (`() => any`): Function to access the initial input data of the workflow in any step
+**execute.state** (`z.infer<TState>`): The current workflow state. Contains shared values that persist across all steps and suspend/resume cycles. The structure is defined by the step's stateSchema.
 
-**suspend:** (`(suspendPayload: any, suspendOptions?: { resumeLabel?: string }) => Promise<void>`): Function to pause workflow execution
+**execute.setState** (`(state: z.infer<TState>) => void`): Function to set the state of the workflow. Inject via reducer-like pattern, such as 'setState({ ...state, ...newState })'
 
-**state:** (`z.infer<TState>`): The current workflow state. Contains shared values that persist across all steps and suspend/resume cycles. The structure is defined by the step's stateSchema.
+**execute.runId** (`string`): Current run id
 
-**setState:** (`(state: z.infer<TState>) => void`): Function to set the state of the workflow. Inject via reducer-like pattern, such as 'setState({ ...state, ...newState })'
+**execute.requestContext** (`RequestContext`): Request Context for dependency injection and contextual information.
 
-**runId:** (`string`): Current run id
+**execute.retryCount** (`number`): The retry count for this specific step, it automatically increases each time the step is retried
 
-**requestContext?:** (`RequestContext`): Request Context for dependency injection and contextual information.
-
-**retryCount?:** (`number`): The retry count for this specific step, it automatically increases each time the step is retried
+**metadata** (`Record<string, any>`): Optional key-value pairs for storing additional step information. Values must be serializable (no functions, circular references, etc.).
 
 ## Related
 

package/.docs/reference/workflows/workflow-methods/branch.md

@@ -13,11 +13,11 @@ workflow.branch([
 
 ## Parameters
 
-**steps:** (`[() => boolean, Step]`): An array of tuples, each containing a condition function and a step to execute if the condition is true
+**steps** (`[() => boolean, Step]`): An array of tuples, each containing a condition function and a step to execute if the condition is true
 
 ## Returns
 
-**workflow:** (`NewWorkflow`): The workflow instance for method chaining
+**workflow** (`NewWorkflow`): The workflow instance for method chaining
 
 ## Related
 

package/.docs/reference/workflows/workflow-methods/commit.md

@@ -10,7 +10,7 @@ workflow.then(step1).commit()
 
 ## Returns
 
-**workflow:** (`Workflow`): The workflow instance for method chaining
+**workflow** (`Workflow`): The workflow instance for method chaining
 
 ## Related
 

package/.docs/reference/workflows/workflow-methods/create-run.md

@@ -10,15 +10,15 @@ await workflow.createRun()
 
 ## Parameters
 
-**runId?:** (`string`): Optional custom identifier for the workflow run
+**runId** (`string`): Optional custom identifier for the workflow run
 
-**resourceId?:** (`string`): Optional identifier to associate the workflow run with a specific resource (e.g., user ID, tenant ID). This value is persisted with the workflow run and can be used for filtering and querying runs.
+**resourceId** (`string`): Optional identifier to associate the workflow run with a specific resource (e.g., user ID, tenant ID). This value is persisted with the workflow run and can be used for filtering and querying runs.
 
-**disableScorers?:** (`boolean`): Optional flag to disable scorers for this workflow run
+**disableScorers** (`boolean`): Optional flag to disable scorers for this workflow run
 
 ## Returns
 
-**run:** (`Run`): A new workflow run instance that can be used to execute the workflow
+**run** (`Run`): A new workflow run instance that can be used to execute the workflow
 
 ## Extended usage example
 

package/.docs/reference/workflows/workflow-methods/dountil.md

@@ -10,13 +10,13 @@ workflow.dountil(step1, async ({ inputData }) => true)
 
 ## Parameters
 
-**step:** (`Step`): The step instance to execute in the loop
+**step** (`Step`): The step instance to execute in the loop
 
-**condition:** (`(params : ExecuteParams & { iterationCount: number }) => Promise<boolean>`): A function that returns a boolean indicating whether to continue the loop. The function receives the execution parameters and the iteration count.
+**condition** (`(params : ExecuteParams & { iterationCount: number }) => Promise<boolean>`): A function that returns a boolean indicating whether to continue the loop. The function receives the execution parameters and the iteration count.
 
 ## Returns
 
-**workflow:** (`Workflow`): The workflow instance for method chaining
+**workflow** (`Workflow`): The workflow instance for method chaining
 
 ## Related