@mastra/mcp-docs-server 1.3.7-alpha.1 → 1.3.7-alpha.3

package/.docs/reference/vectors/libsql.md

@@ -121,7 +121,7 @@ Searches for similar vectors with optional metadata filtering.
 
 **includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
 
-**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
+**minScore** (`number`): Minimum similarity score threshold (cosine similarity ranges from -1 to 1) (Default: `-1`)
 
 ### `describeIndex()`
 

package/.docs/reference/vectors/mongodb.md

@@ -352,6 +352,7 @@ interface QueryResult {
   score: number
   metadata: Record<string, any>
   vector?: number[] // Only included if includeVector is true
+  document?: string // Source text stored with the vector, when available
 }
 ```
 
@@ -429,7 +430,7 @@ const results = await store.query({
 
 **similarity** (`'cosine' | 'dotProduct' | 'euclidean'`): Vector similarity function. Defaults to MongoDB's own default when omitted.
 
-**numDimensions** (`256 | 512 | 1024 | 2048`): Length of the generated embeddings. (Default: `1024`)
+**numDimensions** (`number`): Length of the generated embeddings. Common values are 256, 512, 1024, and 2048. (Default: `1024`)
 
 **quantization** (`'float' | 'scalar' | 'binary' | 'binaryNoRescore'`): Storage format for the generated vectors. (Default: `scalar`)
 

package/.docs/reference/vectors/pg.md

@@ -82,7 +82,9 @@ const vectorStore = new PgVector({
 
 **dimension** (`number`): Vector dimension (must match your embedding model)
 
-**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean' | 'dotproduct' | 'hamming' | 'jaccard'`): Distance metric for similarity search. 'hamming' and 'jaccard' are only valid with vectorType 'bit', and 'jaccard' requires an HNSW index. (Default: `'cosine' ('hamming' when vectorType is 'bit')`)
+
+**vectorType** (`'vector' | 'halfvec' | 'bit' | 'sparsevec'`): pgvector storage type for the embeddings (Default: `vector`)
 
 **indexConfig** (`IndexConfig`): Index configuration (Default: `{ type: 'ivfflat' }`)
 
@@ -142,13 +144,11 @@ Higher M values or efConstruction values will increase memory requirements subst
 
 **includeVector** (`boolean`): Whether to include the vector in the result (Default: `false`)
 
-**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
-
-**options** (`{ ef?: number; probes?: number }`): Additional options for HNSW and IVF indexes
+**minScore** (`number`): Minimum similarity score threshold (Default: `-1`)
 
-**options.ef** (`number`): HNSW search parameter
+**ef** (`number`): HNSW search parameter. Higher values improve accuracy at the cost of speed.
 
-**options.probes** (`number`): IVF search parameter
+**probes** (`number`): IVFFlat search parameter. Number of lists to visit during search.
 
 ### `listIndexes()`
 
@@ -164,8 +164,9 @@ Returns:
 interface PGIndexStats {
   dimension: number
   count: number
-  metric: 'cosine' | 'euclidean' | 'dotproduct'
+  metric: 'cosine' | 'euclidean' | 'dotproduct' | 'hamming' | 'jaccard'
   type: 'flat' | 'hnsw' | 'ivfflat'
+  vectorType: 'vector' | 'halfvec' | 'bit' | 'sparsevec'
   config: {
     m?: number
     efConstruction?: number
@@ -246,7 +247,7 @@ Closes the database connection pool. Should be called when done using the store.
 
 **indexName** (`string`): Name of the index to define
 
-**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean' | 'dotproduct' | 'hamming' | 'jaccard'`): Distance metric for similarity search (Default: `cosine`)
 
 **indexConfig** (`IndexConfig`): Configuration for the index type and parameters
 
@@ -291,17 +292,21 @@ interface QueryResult {
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_PG_QUERY_FAILED'
+    console.log(error.domain) // 'MASTRA_VECTOR'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/pinecone.md

@@ -130,24 +130,28 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_PINECONE_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/qdrant.md

@@ -198,24 +198,28 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_QDRANT_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/s3vectors.md

@@ -196,7 +196,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number // 1/(1 + distance)
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
@@ -244,17 +244,21 @@ S3 Vectors supports a strict subset of operators and value types. The Mastra fil
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index-name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_S3VECTORS_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/turbopuffer.md

@@ -28,11 +28,13 @@ The TurbopufferVector class provides vector search using [Turbopuffer](https://t
 
 ### `createIndex()`
 
+Turbopuffer has no explicit create-index operation. `createIndex()` validates the arguments and records the dimension and metric locally; the namespace is created in Turbopuffer on the first `upsert()`.
+
 **indexName** (`string`): Name of the index to create
 
 **dimension** (`number`): Vector dimension (must match your embedding model)
 
-**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean'`): Distance metric for similarity search. 'dotproduct' isn't supported and throws an error. (Default: `cosine`)
 
 ### `upsert()`
 
@@ -80,7 +82,7 @@ interface IndexStats {
 
 ### `updateVector()`
 
-Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
+Update a single vector by ID, or every vector that matches a metadata filter. Either `id` or `filter` must be provided, but not both.
 
 **indexName** (`string`): Name of the index containing the vector
 
@@ -114,7 +116,7 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
@@ -144,17 +146,21 @@ schemaConfigForIndex: (indexName: string) => {
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_TURBOPUFFER_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/upstash.md

@@ -8,6 +8,8 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
 
 ## Constructor options
 
+**id** (`string`): Unique identifier for this vector store instance
+
 **url** (`string`): Upstash Vector database URL
 
 **token** (`string`): Upstash Vector API token
@@ -194,24 +196,28 @@ Query results are returned in this format:
 interface QueryResult {
   id: string
   score: number
-  metadata: Record<string, any>
+  metadata?: Record<string, any>
   vector?: number[] // Only included if includeVector is true
 }
 ```
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_UPSTASH_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/vectorize.md

@@ -133,17 +133,21 @@ interface QueryResult {
 
 ## Error handling
 
-The store throws typed errors that can be caught:
+The store throws `MastraError` instances from `@mastra/core/error`:
 
 ```typescript
+import { MastraError } from '@mastra/core/error'
+
 try {
   await store.query({
     indexName: 'index_name',
     queryVector: queryVector,
   })
 } catch (error) {
-  if (error instanceof VectorStoreError) {
-    console.log(error.code) // 'connection_failed' | 'invalid_dimension' | etc
+  if (error instanceof MastraError) {
+    console.log(error.id) // 'MASTRA_VECTOR_VECTORIZE_QUERY_FAILED'
+    console.log(error.domain) // 'STORAGE'
+    console.log(error.category) // 'USER' | 'THIRD_PARTY'
     console.log(error.details) // Additional error context
   }
 }

package/.docs/reference/vectors/weaviate.md

@@ -50,7 +50,7 @@ The `WeaviateVector` class provides vector search using [Weaviate](https://weavi
 
 **indexName** (`string`): Name of the index to query.
 
-**queryVector** (`number[]`): Query vector to find similar vectors for.
+**queryVector** (`number[]`): Query vector to find similar vectors for. At least one of queryVector or filter must be provided.
 
 **topK** (`number`): Number of results to return. (Default: `10`)
 

package/.docs/reference/voice/composite-voice.md

@@ -10,13 +10,11 @@ CompositeVoice supports both Mastra voice providers and AI SDK model providers
 
 ## Constructor parameters
 
-**config** (`object`): Configuration object for the composite voice service
+**input** (`MastraVoice | TranscriptionModel`): Voice provider or AI SDK transcription model to use for speech-to-text operations. AI SDK models are automatically wrapped.
 
-**config.input** (`MastraVoice | TranscriptionModel`): Voice provider or AI SDK transcription model to use for speech-to-text operations. AI SDK models are automatically wrapped.
+**output** (`MastraVoice | SpeechModel`): Voice provider or AI SDK speech model to use for text-to-speech operations. AI SDK models are automatically wrapped.
 
-**config.output** (`MastraVoice | SpeechModel`): Voice provider or AI SDK speech model to use for text-to-speech operations. AI SDK models are automatically wrapped.
-
-**config.realtime** (`MastraVoice`): Voice provider to use for real-time speech-to-speech operations
+**realtime** (`MastraVoice`): Voice provider to use for real-time speech-to-speech operations
 
 ## Methods
 
@@ -30,9 +28,10 @@ Converts text to speech using the configured speaking provider.
 
 Notes:
 
-- If no speaking provider is configured, this method will throw an error
-- Options are passed through to the configured speaking provider
-- Returns a stream of audio data
+- If a realtime provider is configured, it handles the call; otherwise the speaking provider is used
+- Throws a `MastraError` only when neither a realtime nor a speaking provider is configured
+- Options are passed through to the provider that handles the call
+- Returns a stream of audio data, or `void` when a realtime provider handles the call
 
 ### `listen()`
 
@@ -44,13 +43,14 @@ Converts speech to text using the configured listening provider.
 
 Notes:
 
-- If no listening provider is configured, this method will throw an error
-- Options are passed through to the configured listening provider
-- Returns either a string or a stream of transcribed text, depending on the provider
+- If a realtime provider is configured, it handles the call; otherwise the listening provider is used
+- Throws a `MastraError` only when neither a realtime nor a listening provider is configured
+- Options are passed through to the provider that handles the call
+- Returns a string or a stream of transcribed text, depending on the provider, or `void` when a realtime provider emits results through events
 
 ### `getSpeakers()`
 
-Returns a list of available voices from the speaking provider, where each node contains:
+Returns a list of available voices from the realtime provider, or from the speaking provider when no realtime provider is configured, where each node contains:
 
 **voiceId** (`string`): Unique identifier for the voice
 
@@ -58,10 +58,10 @@ Returns a list of available voices from the speaking provider, where each node c
 
 Notes:
 
-- Returns voices from the speaking provider only
-- If no speaking provider is configured, returns an empty array
+- Returns voices from the realtime provider when one is configured, otherwise from the speaking provider
+- Throws a `MastraError` when neither a realtime nor a speaking provider is configured
 - Each voice object will have at least a voiceId property
-- Additional voice properties depend on the speaking provider
+- Additional voice properties depend on the provider
 
 ## Usage examples
 

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

@@ -141,7 +141,7 @@ Converts speech to text using the configured listening model.
 
 ```typescript
 abstract listen(
-  audioStream: NodeJS.ReadableStream,
+  audioStream: NodeJS.ReadableStream | unknown,
   options?: {
     [key: string]: unknown;
   }
@@ -150,31 +150,32 @@ abstract listen(
 
 Purpose:
 
-- Takes an audio stream and converts it to text using the provider's speech-to-text service
+- Takes an audio stream (or another provider-specific audio input) and converts it to text using the provider's speech-to-text service
 - Supports provider-specific options for transcription configuration
 - Can return either a complete text transcription or a stream of transcribed text
 - Not all providers support this functionality (e.g., PlayAI, Speechify)
 - May return void if the transcription is handled by emitting 'writing' event
 
+## Optional methods
+
+These methods have default implementations but can be overridden by voice providers that support speech-to-speech capabilities.
+
 ### `getSpeakers()`
 
 Returns a list of available voices supported by the provider.
 
 ```typescript
-abstract getSpeakers(): Promise<Array<{ voiceId: string; [key: string]: unknown }>>
+getSpeakers(): Promise<Array<{ voiceId: string; [key: string]: unknown }>>
 ```
 
 Purpose:
 
 - Retrieves the list of available voices/speakers from the provider
+- The default implementation returns an empty array; providers override it to list their voices
 - Each voice must have at least a voiceId property
 - Providers can include additional metadata about each voice
 - Used to discover available voices for text-to-speech conversion
 
-## Optional methods
-
-These methods have default implementations but can be overridden by voice providers that support speech-to-speech capabilities.
-
 ### `connect()`
 
 Establishes a WebSocket or WebRTC connection for communication.
@@ -210,12 +211,13 @@ Purpose:
 Triggers the voice provider to generate a response.
 
 ```typescript
-answer(): Promise<void>
+answer(options?: Record<string, unknown>): Promise<void>
 ```
 
 Purpose:
 
 - Sends a signal to the voice provider to generate a response
+- Accepts optional provider-specific options
 - Used in real-time conversations to prompt the AI to respond
 - Response will be emitted through the event system (e.g., 'speaking' event)
 
@@ -285,9 +287,11 @@ Purpose:
 
 The MastraVoice class includes an event system for real-time communication. Standard event types include:
 
-**speaking** (`{ text: string; audioStream?: NodeJS.ReadableStream; audio?: Int16Array }`): Emitted when the voice provider is speaking, contains audio data
+**speaker** (`NodeJS.ReadableStream`): Emitted with an audio stream for each new response the voice provider speaks
+
+**speaking** (`{ audio?: string }`): Emitted when the voice provider is speaking, contains audio data
 
-**writing** (`{ text: string, role: string }`): Emitted when text is transcribed from speech
+**writing** (`{ text: string; role: 'assistant' | 'user' }`): Emitted when text is transcribed from speech
 
 **error** (`{ message: string; code?: string; details?: unknown }`): Emitted when an error occurs
 
@@ -308,7 +312,7 @@ MastraVoice includes built-in telemetry support through the `traced` method, whi
 ## Notes
 
 - MastraVoice is an abstract class and can't be instantiated directly
-- Implementations must provide concrete implementations for all abstract methods
+- Implementations must provide concrete implementations of the abstract `speak()` and `listen()` methods
 - The class provides a consistent interface across different voice service providers
 - Speech-to-speech capabilities are optional and provider-specific
 - The event system enables asynchronous communication for real-time interactions

package/.docs/reference/voice/voice.addInstructions.md

@@ -54,7 +54,7 @@ This method doesn't return a value.
 
 - Instructions are most effective when they're clear, specific, and relevant to the voice interaction
 - This method is primarily used with real-time voice providers that maintain conversation context
-- If called on a voice provider that doesn't support instructions, it will log a warning and do nothing
+- If called on a voice provider that doesn't support instructions, it will do nothing
 - Instructions added with this method are typically combined with any instructions provided by an associated Agent
 - For best results, add instructions before starting a conversation (before calling `connect()`)
 - Multiple calls to `addInstructions()` may either replace or append to existing instructions, depending on the provider implementation

package/.docs/reference/voice/voice.addTools.md

@@ -64,7 +64,7 @@ This method doesn't return a value.
 
 - Tools must follow the Mastra tool format with name, description, input schema, and execute function
 - This method is primarily used with real-time voice providers that support function calling
-- If called on a voice provider that doesn't support tools, it will log a warning and do nothing
+- If called on a voice provider that doesn't support tools, it will do nothing
 - Tools added with this method are typically combined with any tools provided by an associated Agent
 - For best results, add tools before starting a conversation (before calling `connect()`)
 - The voice provider will automatically handle the invocation of tool handlers when the model decides to use them

package/.docs/reference/voice/voice.answer.md

@@ -52,7 +52,7 @@ Returns a `Promise<void>` that resolves when the response has been triggered.
 ## Notes
 
 - This method is only implemented by real-time voice providers that support speech-to-speech capabilities
-- If called on a voice provider that doesn't support this functionality, it will log a warning and resolve immediately
+- If called on a voice provider that doesn't support this functionality, it will log a debug message and resolve immediately
 - The response audio will typically be emitted through the 'speaking' event rather than returned directly
 - For providers that support it, you can use this method to send a specific response instead of having the AI generate one
 - This method is commonly used in conjunction with `send()` to create a conversational flow

package/.docs/reference/voice/voice.close.md

@@ -51,5 +51,5 @@ This method doesn't return a value.
 - Always call `close()` when you're done with a real-time voice session to free up resources
 - After calling `close()`, you'll need to call `connect()` again if you want to start a new session
 - This method is primarily used with real-time voice providers that maintain persistent connections
-- If called on a voice provider that doesn't support real-time connections, it will log a warning and do nothing
+- If called on a voice provider that doesn't support real-time connections, it will log a debug message and do nothing
 - Failing to close connections can lead to resource leaks and potential billing issues with voice service providers

package/.docs/reference/voice/voice.events.md

@@ -10,7 +10,7 @@ Voice providers emit events during real-time voice interactions. These events ca
 
 These events are commonly implemented across real-time voice providers:
 
-**error** (`Error`): Emitted when an error occurs during voice processing or when audio data format is unsupported
+**error** (`{ message: string; code?: string; details?: unknown }`): Emitted when an error occurs during voice processing or when audio data format is unsupported
 
 **session.created** (`object`): Emitted when a new session is created with the OpenAI service
 
@@ -20,7 +20,7 @@ These events are commonly implemented across real-time voice providers:
 
 **response.done** (`object`): Emitted when the AI assistant has completed its response
 
-**speaker** (`StreamWithId`): Emitted with a new audio stream that can be piped to an audio output
+**speaker** (`NodeJS.ReadableStream`): Emitted with a new audio stream that can be piped to an audio output. Some realtime providers attach an id property to the stream
 
 **writing** (`object`): Emitted when text is being transcribed (user) or generated (assistant)
 

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

@@ -8,7 +8,7 @@ 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 | unknown`): Audio to transcribe. This is usually a file stream or a microphone stream; some realtime providers accept other audio input types.
 
 **options** (`object`): Provider-specific options for speech recognition
 

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

@@ -54,5 +54,5 @@ This method doesn't return a value.
 - The callback passed to `off()` must be the same function reference that was passed to `on()`
 - If the callback isn't found, the method will have no effect
 - This method is primarily used with real-time voice providers that support event-based communication
-- If called on a voice provider that doesn't support events, it will log a warning and do nothing
+- If called on a voice provider that doesn't support events, it will log a debug message and do nothing
 - Removing event listeners is important for preventing memory leaks in long-running applications

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

@@ -107,7 +107,7 @@ voice.on('speaker', stream => {
 ## Notes
 
 - This method is primarily used with real-time voice providers that support event-based communication
-- If called on a voice provider that doesn't support events, it will log a warning and do nothing
+- If called on a voice provider that doesn't support events, it will log a debug message and do nothing
 - Event listeners should be registered before calling methods that might emit events
 - To remove an event listener, use the [voice.off()](https://mastra.ai/reference/voice/voice.off) method with the same event name and callback function
 - Multiple listeners can be registered for the same event

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

@@ -56,12 +56,12 @@ await voice.send(audioBuffer)
 
 ## Return value
 
-Returns a `Promise<void>` that resolves when the audio data has been accepted by the voice provider.
+Returns a `Promise<void>`. For providers that support real-time audio, it resolves when the provider has accepted the audio data. The default implementation sends nothing and resolves immediately.
 
 ## Notes
 
 - This method is only implemented by real-time voice providers that support speech-to-speech capabilities
-- If called on a voice provider that doesn't support this functionality, it will log a warning and resolve immediately
+- If called on a voice provider that doesn't support this functionality, it will log a debug message and resolve immediately
 - You must call `connect()` before using `send()` to establish the WebSocket connection
 - The audio format requirements depend on the specific voice provider
 - For continuous conversation, you typically call `send()` to transmit user audio, then `answer()` to trigger the AI response

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

@@ -57,7 +57,7 @@ Different voice providers support different configuration options:
 
 ## Notes
 
-- The default implementation logs a warning if the provider doesn't support this method
+- The default implementation logs a debug message if the provider doesn't support this method
 - Configuration updates are typically applied to subsequent operations, not ongoing ones
 - Not all properties that can be set in the constructor can be updated at runtime
 - The specific behavior depends on the voice provider implementation

package/.docs/reference/workflows/dynamic-workflow-definition.md

@@ -128,18 +128,19 @@ Add an `outputSchema` to request structured output from the agent:
 
 Use a `mapping` entry before an agent to build its `{ prompt }` input from workflow data.
 
-Agent entries accept an optional `description` and an `options` object:
+Agent entries accept an `options` object:
 
 ```json
 {
   "type": "agent",
   "id": "summarize",
   "agentId": "support-agent",
-  "description": "Summarize the incoming request",
   "options": { "retries": 2, "metadata": { "team": "support" } }
 }
 ```
 
+The step description comes from the registered agent. A `description` set on the agent entry is ignored when the workflow is rehydrated.
+
 Only `retries` and `metadata` persist. Function-valued options such as `onFinish` and function-valued `toolChoice` are rejected when a code-defined workflow is stored. Other agent call options don't persist.
 
 ### Classifier steps

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

@@ -14,7 +14,6 @@ This method aborts any running steps and updates the workflow status to 'cancele
 const run = await workflow.createRun()
 
 await run.cancel()
-// Returns: { message: 'Workflow run canceled' }
 ```
 
 ## Parameters
@@ -23,7 +22,7 @@ await run.cancel()
 
 ## Returns
 
-**result** (`Promise<{ message: string }>`): A promise that resolves with { message: 'Workflow run canceled' } when cancellation succeeds
+**result** (`Promise<void>`): A promise that resolves once cancellation is requested and, if storage is configured, the status update to canceled has been attempted. It does not wait for running steps to stop. Calling cancel() on a run that already finished leaves its status unchanged, except with the Inngest engine.
 
 ## How cancellation works