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

package/.docs/reference/vectors/convex.md

@@ -387,7 +387,6 @@ const results = await vectorStore.query({
 
 | Operator | Description           |
 | -------- | --------------------- |
-| `$eq`    | Equal to              |
 | `$ne`    | Not equal to          |
 | `$gt`    | Greater than          |
 | `$gte`   | Greater than or equal |
@@ -400,10 +399,9 @@ const results = await vectorStore.query({
 
 ## Architecture
 
-`ConvexVector` stores vectors in the `mastra_vectors` table with the following structure:
+`ConvexVector` stores each index in its own table named `mastra_vector_{indexName}`. Each record has the following structure:
 
 - `id`: Unique vector identifier
-- `indexName`: Name of the index
 - `embedding`: The vector data (array of floats)
 - `metadata`: Optional JSON metadata
 

package/.docs/reference/vectors/couchbase.md

@@ -69,8 +69,6 @@ const store = new CouchbaseVector({
 
 **collectionName** (`string`): Name of the Couchbase collection to use
 
-**options** (`CouchbaseClientOptions`): Optional Couchbase client options
-
 ## Methods
 
 ### `createIndex()`
@@ -83,7 +81,7 @@ Creates a new vector index in Couchbase.
 
 **dimension** (`number`): Vector dimension (must match your embedding model)
 
-**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
+**metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `dotproduct`)
 
 ### `upsert()`
 
@@ -111,11 +109,9 @@ Searches for similar vectors.
 
 **topK** (`number`): Number of results to return (Default: `10`)
 
-**filter** (`Record<string, any>`): Metadata filters
-
-**includeVector** (`boolean`): Whether to include vector data in results (Default: `false`)
+**filter** (`Record<string, any>`): Not supported. Filters passed here are ignored.
 
-**minScore** (`number`): Minimum similarity score threshold (Default: `0`)
+**includeVector** (`boolean`): Not supported. Setting this to true throws an error. (Default: `false`)
 
 ### `describeIndex()`
 
@@ -135,7 +131,7 @@ interface IndexStats {
 
 ### `deleteIndex()`
 
-Deletes an index and all its data.
+Deletes the Search index. Documents stored in the collection aren't deleted.
 
 **indexName** (`string`): Name of the index to delete
 
@@ -184,7 +180,6 @@ interface QueryResult {
   id: string
   score: number
   metadata: Record<string, any>
-  vector?: number[] // Only included if includeVector is true
 }
 ```
 

package/.docs/reference/vectors/duckdb.md

@@ -216,7 +216,7 @@ DuckDB vector store supports MongoDB-like filter operators:
 | ---------- | ------------------------------------------ |
 | Comparison | `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte` |
 | Logical    | `$and`, `$or`, `$not`, `$nor`              |
-| Array      | `$in`, `$nin`                              |
+| Array      | `$in`, `$nin`, `$all`                      |
 | Element    | `$exists`                                  |
 | Text       | `$contains`                                |
 

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