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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (276) hide show
  1. package/.docs/docs/agents/agent-approval.md +61 -31
  2. package/.docs/docs/agents/supervisor-agents.md +1 -1
  3. package/.docs/docs/getting-started/manual-install.md +1 -1
  4. package/.docs/docs/index.md +68 -24
  5. package/.docs/docs/mastra-cloud/setup.md +1 -1
  6. package/.docs/docs/memory/observational-memory.md +9 -0
  7. package/.docs/docs/memory/semantic-recall.md +17 -1
  8. package/.docs/docs/workspace/skills.md +7 -5
  9. package/.docs/guides/deployment/aws-lambda.md +76 -165
  10. package/.docs/guides/deployment/azure-app-services.md +38 -61
  11. package/.docs/guides/deployment/cloudflare.md +1 -1
  12. package/.docs/guides/deployment/netlify.md +1 -1
  13. package/.docs/guides/deployment/vercel.md +1 -1
  14. package/.docs/models/gateways/netlify.md +5 -1
  15. package/.docs/models/index.md +1 -1
  16. package/.docs/models/providers/anthropic.md +9 -9
  17. package/.docs/models/providers/deepseek.md +1 -1
  18. package/.docs/models/providers/google.md +11 -11
  19. package/.docs/models/providers/openai.md +19 -19
  20. package/.docs/models/providers/opencode.md +33 -33
  21. package/.docs/models/providers/xai.md +3 -3
  22. package/.docs/reference/agents/agent.md +20 -20
  23. package/.docs/reference/agents/generate.md +200 -66
  24. package/.docs/reference/agents/generateLegacy.md +77 -35
  25. package/.docs/reference/agents/getDefaultGenerateOptions.md +4 -6
  26. package/.docs/reference/agents/getDefaultOptions.md +4 -6
  27. package/.docs/reference/agents/getDefaultStreamOptions.md +4 -6
  28. package/.docs/reference/agents/getDescription.md +1 -1
  29. package/.docs/reference/agents/getInstructions.md +4 -6
  30. package/.docs/reference/agents/getLLM.md +6 -8
  31. package/.docs/reference/agents/getMemory.md +4 -6
  32. package/.docs/reference/agents/getModel.md +4 -6
  33. package/.docs/reference/agents/getTools.md +5 -7
  34. package/.docs/reference/agents/getVoice.md +4 -6
  35. package/.docs/reference/agents/listAgents.md +4 -6
  36. package/.docs/reference/agents/listScorers.md +4 -6
  37. package/.docs/reference/agents/listTools.md +4 -6
  38. package/.docs/reference/agents/listWorkflows.md +4 -6
  39. package/.docs/reference/agents/network.md +69 -23
  40. package/.docs/reference/ai-sdk/chat-route.md +7 -7
  41. package/.docs/reference/ai-sdk/handle-chat-stream.md +12 -12
  42. package/.docs/reference/ai-sdk/handle-network-stream.md +4 -4
  43. package/.docs/reference/ai-sdk/handle-workflow-stream.md +11 -11
  44. package/.docs/reference/ai-sdk/network-route.md +3 -3
  45. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +9 -9
  46. package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +9 -9
  47. package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +5 -5
  48. package/.docs/reference/ai-sdk/with-mastra.md +12 -12
  49. package/.docs/reference/ai-sdk/workflow-route.md +3 -3
  50. package/.docs/reference/auth/auth0.md +6 -6
  51. package/.docs/reference/auth/better-auth.md +5 -5
  52. package/.docs/reference/auth/clerk.md +5 -5
  53. package/.docs/reference/auth/firebase.md +7 -7
  54. package/.docs/reference/auth/jwt.md +1 -1
  55. package/.docs/reference/auth/supabase.md +4 -4
  56. package/.docs/reference/auth/workos.md +6 -6
  57. package/.docs/reference/cli/create-mastra.md +14 -14
  58. package/.docs/reference/client-js/mastra-client.md +23 -23
  59. package/.docs/reference/client-js/workflows.md +3 -3
  60. package/.docs/reference/core/addGateway.md +2 -2
  61. package/.docs/reference/core/getAgent.md +2 -2
  62. package/.docs/reference/core/getAgentById.md +2 -2
  63. package/.docs/reference/core/getDeployer.md +1 -1
  64. package/.docs/reference/core/getGateway.md +2 -2
  65. package/.docs/reference/core/getGatewayById.md +2 -2
  66. package/.docs/reference/core/getLogger.md +1 -1
  67. package/.docs/reference/core/getMCPServer.md +2 -2
  68. package/.docs/reference/core/getMCPServerById.md +3 -3
  69. package/.docs/reference/core/getMemory.md +2 -2
  70. package/.docs/reference/core/getScorer.md +2 -2
  71. package/.docs/reference/core/getScorerById.md +2 -2
  72. package/.docs/reference/core/getServer.md +1 -1
  73. package/.docs/reference/core/getStorage.md +1 -1
  74. package/.docs/reference/core/getStoredAgentById.md +18 -20
  75. package/.docs/reference/core/getTelemetry.md +1 -1
  76. package/.docs/reference/core/getVector.md +2 -2
  77. package/.docs/reference/core/getWorkflow.md +3 -3
  78. package/.docs/reference/core/listAgents.md +1 -1
  79. package/.docs/reference/core/listGateways.md +1 -1
  80. package/.docs/reference/core/listLogs.md +9 -11
  81. package/.docs/reference/core/listLogsByRunId.md +9 -9
  82. package/.docs/reference/core/listMCPServers.md +1 -1
  83. package/.docs/reference/core/listMemory.md +1 -1
  84. package/.docs/reference/core/listScorers.md +1 -1
  85. package/.docs/reference/core/listStoredAgents.md +9 -11
  86. package/.docs/reference/core/listVectors.md +1 -1
  87. package/.docs/reference/core/listWorkflows.md +2 -2
  88. package/.docs/reference/core/mastra-class.md +17 -17
  89. package/.docs/reference/core/mastra-model-gateway.md +15 -15
  90. package/.docs/reference/core/setLogger.md +2 -4
  91. package/.docs/reference/core/setStorage.md +1 -1
  92. package/.docs/reference/datasets/addItem.md +20 -4
  93. package/.docs/reference/datasets/addItems.md +8 -2
  94. package/.docs/reference/datasets/compareExperiments.md +15 -3
  95. package/.docs/reference/datasets/create.md +6 -6
  96. package/.docs/reference/datasets/dataset.md +1 -1
  97. package/.docs/reference/datasets/delete.md +2 -2
  98. package/.docs/reference/datasets/deleteExperiment.md +2 -2
  99. package/.docs/reference/datasets/deleteItem.md +2 -2
  100. package/.docs/reference/datasets/deleteItems.md +2 -2
  101. package/.docs/reference/datasets/get.md +2 -2
  102. package/.docs/reference/datasets/getDetails.md +9 -9
  103. package/.docs/reference/datasets/getExperiment.md +2 -2
  104. package/.docs/reference/datasets/getItem.md +3 -3
  105. package/.docs/reference/datasets/getItemHistory.md +22 -2
  106. package/.docs/reference/datasets/list.md +7 -3
  107. package/.docs/reference/datasets/listExperimentResults.md +34 -4
  108. package/.docs/reference/datasets/listExperiments.md +41 -3
  109. package/.docs/reference/datasets/listItems.md +18 -6
  110. package/.docs/reference/datasets/listVersions.md +23 -3
  111. package/.docs/reference/datasets/startExperiment.md +62 -12
  112. package/.docs/reference/datasets/startExperimentAsync.md +5 -1
  113. package/.docs/reference/datasets/update.md +6 -6
  114. package/.docs/reference/datasets/updateItem.md +5 -5
  115. package/.docs/reference/deployer.md +8 -8
  116. package/.docs/reference/evals/answer-relevancy.md +11 -11
  117. package/.docs/reference/evals/answer-similarity.md +17 -19
  118. package/.docs/reference/evals/bias.md +10 -10
  119. package/.docs/reference/evals/completeness.md +3 -3
  120. package/.docs/reference/evals/content-similarity.md +6 -6
  121. package/.docs/reference/evals/context-precision.md +4 -4
  122. package/.docs/reference/evals/context-relevance.md +4 -4
  123. package/.docs/reference/evals/create-scorer.md +47 -49
  124. package/.docs/reference/evals/faithfulness.md +11 -11
  125. package/.docs/reference/evals/hallucination.md +17 -21
  126. package/.docs/reference/evals/keyword-coverage.md +4 -4
  127. package/.docs/reference/evals/mastra-scorer.md +14 -14
  128. package/.docs/reference/evals/noise-sensitivity.md +4 -4
  129. package/.docs/reference/evals/prompt-alignment.md +4 -4
  130. package/.docs/reference/evals/run-evals.md +16 -16
  131. package/.docs/reference/evals/scorer-utils.md +3 -3
  132. package/.docs/reference/evals/textual-difference.md +3 -3
  133. package/.docs/reference/evals/tone-consistency.md +3 -3
  134. package/.docs/reference/evals/tool-call-accuracy.md +5 -5
  135. package/.docs/reference/evals/toxicity.md +8 -8
  136. package/.docs/reference/harness/harness-class.md +34 -42
  137. package/.docs/reference/logging/pino-logger.md +5 -5
  138. package/.docs/reference/memory/clone-utilities.md +5 -5
  139. package/.docs/reference/memory/cloneThread.md +17 -21
  140. package/.docs/reference/memory/createThread.md +10 -10
  141. package/.docs/reference/memory/deleteMessages.md +2 -2
  142. package/.docs/reference/memory/getThreadById.md +2 -2
  143. package/.docs/reference/memory/listThreads.md +5 -5
  144. package/.docs/reference/memory/memory-class.md +12 -14
  145. package/.docs/reference/memory/observational-memory.md +102 -94
  146. package/.docs/reference/memory/recall.md +14 -16
  147. package/.docs/reference/observability/tracing/configuration.md +27 -10
  148. package/.docs/reference/observability/tracing/exporters/console-exporter.md +4 -7
  149. package/.docs/reference/processors/batch-parts-processor.md +8 -10
  150. package/.docs/reference/processors/language-detector.md +14 -16
  151. package/.docs/reference/processors/message-history-processor.md +7 -9
  152. package/.docs/reference/processors/moderation-processor.md +13 -15
  153. package/.docs/reference/processors/pii-detector.md +14 -16
  154. package/.docs/reference/processors/processor-interface.md +62 -62
  155. package/.docs/reference/processors/prompt-injection-detector.md +11 -13
  156. package/.docs/reference/processors/semantic-recall-processor.md +14 -16
  157. package/.docs/reference/processors/system-prompt-scrubber.md +12 -14
  158. package/.docs/reference/processors/token-limiter-processor.md +11 -13
  159. package/.docs/reference/processors/tool-call-filter.md +5 -7
  160. package/.docs/reference/processors/tool-search-processor.md +9 -11
  161. package/.docs/reference/processors/unicode-normalizer.md +8 -10
  162. package/.docs/reference/processors/working-memory-processor.md +14 -18
  163. package/.docs/reference/rag/chunk.md +38 -38
  164. package/.docs/reference/rag/database-config.md +11 -7
  165. package/.docs/reference/rag/document.md +2 -2
  166. package/.docs/reference/rag/embeddings.md +12 -12
  167. package/.docs/reference/rag/extract-params.md +23 -23
  168. package/.docs/reference/rag/graph-rag.md +12 -12
  169. package/.docs/reference/rag/rerank.md +25 -17
  170. package/.docs/reference/rag/rerankWithScorer.md +25 -17
  171. package/.docs/reference/server/create-route.md +14 -14
  172. package/.docs/reference/server/express-adapter.md +10 -10
  173. package/.docs/reference/server/fastify-adapter.md +10 -10
  174. package/.docs/reference/server/hono-adapter.md +10 -10
  175. package/.docs/reference/server/koa-adapter.md +10 -10
  176. package/.docs/reference/server/mastra-server.md +10 -10
  177. package/.docs/reference/server/register-api-route.md +13 -13
  178. package/.docs/reference/storage/cloudflare-d1.md +5 -5
  179. package/.docs/reference/storage/cloudflare.md +6 -6
  180. package/.docs/reference/storage/composite.md +9 -9
  181. package/.docs/reference/storage/convex.md +3 -3
  182. package/.docs/reference/storage/dynamodb.md +9 -9
  183. package/.docs/reference/storage/lance.md +3 -3
  184. package/.docs/reference/storage/libsql.md +2 -2
  185. package/.docs/reference/storage/mongodb.md +5 -5
  186. package/.docs/reference/storage/mssql.md +2 -2
  187. package/.docs/reference/storage/postgresql.md +25 -25
  188. package/.docs/reference/storage/upstash.md +3 -3
  189. package/.docs/reference/streaming/ChunkType.md +251 -59
  190. package/.docs/reference/streaming/agents/MastraModelOutput.md +86 -16
  191. package/.docs/reference/streaming/agents/stream.md +155 -43
  192. package/.docs/reference/streaming/agents/streamLegacy.md +79 -39
  193. package/.docs/reference/streaming/workflows/resumeStream.md +18 -8
  194. package/.docs/reference/streaming/workflows/stream.md +21 -9
  195. package/.docs/reference/streaming/workflows/timeTravelStream.md +4 -4
  196. package/.docs/reference/tools/create-tool.md +25 -21
  197. package/.docs/reference/tools/document-chunker-tool.md +7 -7
  198. package/.docs/reference/tools/graph-rag-tool.md +16 -18
  199. package/.docs/reference/tools/mcp-client.md +38 -27
  200. package/.docs/reference/tools/mcp-server.md +45 -45
  201. package/.docs/reference/tools/vector-query-tool.md +34 -22
  202. package/.docs/reference/vectors/astra.md +22 -22
  203. package/.docs/reference/vectors/chroma.md +44 -44
  204. package/.docs/reference/vectors/convex.md +26 -26
  205. package/.docs/reference/vectors/couchbase.md +30 -30
  206. package/.docs/reference/vectors/duckdb.md +29 -29
  207. package/.docs/reference/vectors/elasticsearch.md +27 -27
  208. package/.docs/reference/vectors/lance.md +46 -38
  209. package/.docs/reference/vectors/libsql.md +31 -31
  210. package/.docs/reference/vectors/mongodb.md +32 -32
  211. package/.docs/reference/vectors/opensearch.md +27 -27
  212. package/.docs/reference/vectors/pg.md +60 -44
  213. package/.docs/reference/vectors/pinecone.md +38 -38
  214. package/.docs/reference/vectors/qdrant.md +36 -36
  215. package/.docs/reference/vectors/s3vectors.md +24 -24
  216. package/.docs/reference/vectors/turbopuffer.md +29 -29
  217. package/.docs/reference/vectors/upstash.md +25 -25
  218. package/.docs/reference/vectors/vectorize.md +27 -27
  219. package/.docs/reference/voice/azure.md +19 -15
  220. package/.docs/reference/voice/cloudflare.md +10 -12
  221. package/.docs/reference/voice/composite-voice.md +10 -10
  222. package/.docs/reference/voice/deepgram.md +20 -14
  223. package/.docs/reference/voice/elevenlabs.md +20 -22
  224. package/.docs/reference/voice/google-gemini-live.md +42 -44
  225. package/.docs/reference/voice/google.md +25 -21
  226. package/.docs/reference/voice/mastra-voice.md +20 -20
  227. package/.docs/reference/voice/murf.md +24 -28
  228. package/.docs/reference/voice/openai-realtime.md +26 -26
  229. package/.docs/reference/voice/openai.md +14 -12
  230. package/.docs/reference/voice/playai.md +13 -15
  231. package/.docs/reference/voice/sarvam.md +21 -25
  232. package/.docs/reference/voice/speechify.md +11 -13
  233. package/.docs/reference/voice/voice.addInstructions.md +1 -1
  234. package/.docs/reference/voice/voice.addTools.md +1 -1
  235. package/.docs/reference/voice/voice.answer.md +1 -1
  236. package/.docs/reference/voice/voice.connect.md +3 -3
  237. package/.docs/reference/voice/voice.events.md +11 -11
  238. package/.docs/reference/voice/voice.getSpeakers.md +30 -30
  239. package/.docs/reference/voice/voice.listen.md +9 -9
  240. package/.docs/reference/voice/voice.off.md +2 -2
  241. package/.docs/reference/voice/voice.on.md +2 -2
  242. package/.docs/reference/voice/voice.send.md +1 -1
  243. package/.docs/reference/voice/voice.speak.md +11 -11
  244. package/.docs/reference/voice/voice.updateConfig.md +3 -3
  245. package/.docs/reference/workflows/run-methods/cancel.md +2 -2
  246. package/.docs/reference/workflows/run-methods/restart.md +17 -5
  247. package/.docs/reference/workflows/run-methods/resume.md +23 -9
  248. package/.docs/reference/workflows/run-methods/start.md +22 -8
  249. package/.docs/reference/workflows/run-methods/startAsync.md +12 -6
  250. package/.docs/reference/workflows/run-methods/timeTravel.md +29 -13
  251. package/.docs/reference/workflows/run.md +12 -12
  252. package/.docs/reference/workflows/step.md +24 -26
  253. package/.docs/reference/workflows/workflow-methods/branch.md +2 -2
  254. package/.docs/reference/workflows/workflow-methods/commit.md +1 -1
  255. package/.docs/reference/workflows/workflow-methods/create-run.md +4 -4
  256. package/.docs/reference/workflows/workflow-methods/dountil.md +3 -3
  257. package/.docs/reference/workflows/workflow-methods/dowhile.md +3 -3
  258. package/.docs/reference/workflows/workflow-methods/foreach.md +9 -9
  259. package/.docs/reference/workflows/workflow-methods/map.md +2 -2
  260. package/.docs/reference/workflows/workflow-methods/parallel.md +2 -2
  261. package/.docs/reference/workflows/workflow-methods/sleep.md +2 -2
  262. package/.docs/reference/workflows/workflow-methods/sleepUntil.md +2 -2
  263. package/.docs/reference/workflows/workflow-methods/then.md +2 -2
  264. package/.docs/reference/workflows/workflow.md +40 -50
  265. package/.docs/reference/workspace/daytona-sandbox.md +33 -33
  266. package/.docs/reference/workspace/e2b-sandbox.md +20 -20
  267. package/.docs/reference/workspace/filesystem.md +22 -22
  268. package/.docs/reference/workspace/gcs-filesystem.md +15 -15
  269. package/.docs/reference/workspace/local-filesystem.md +35 -35
  270. package/.docs/reference/workspace/local-sandbox.md +26 -26
  271. package/.docs/reference/workspace/s3-filesystem.md +18 -18
  272. package/.docs/reference/workspace/sandbox.md +8 -8
  273. package/.docs/reference/workspace/workspace-class.md +30 -34
  274. package/CHANGELOG.md +16 -0
  275. package/package.json +6 -6
  276. package/.docs/docs/getting-started/start.md +0 -28
@@ -28,15 +28,13 @@ const speakers = await voice.getSpeakers()
28
28
 
29
29
  ## Constructor Parameters
30
30
 
31
- **speechModel?:** (`ElevenLabsVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'eleven_multilingual_v2' }`)
31
+ **speechModel** (`ElevenLabsVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'eleven_multilingual_v2' }`)
32
32
 
33
- **speaker?:** (`string`): ID of the speaker to use for text-to-speech (Default: `'9BWtsMINqrJLrRacOk9x' (Aria voice)`)
33
+ **speechModel.name** (`ElevenLabsModel`): The ElevenLabs model to use
34
34
 
35
- ### ElevenLabsVoiceConfig
35
+ **speechModel.apiKey** (`string`): ElevenLabs API key. Falls back to ELEVENLABS\_API\_KEY environment variable
36
36
 
37
- **name?:** (`ElevenLabsModel`): The ElevenLabs model to use (Default: `'eleven_multilingual_v2'`)
38
-
39
- **apiKey?:** (`string`): ElevenLabs API key. Falls back to ELEVENLABS\_API\_KEY environment variable
37
+ **speaker** (`string`): ID of the speaker to use for text-to-speech (Default: `'9BWtsMINqrJLrRacOk9x' (Aria voice)`)
40
38
 
41
39
  ## Methods
42
40
 
@@ -44,11 +42,11 @@ const speakers = await voice.getSpeakers()
44
42
 
45
43
  Converts text to speech using the configured speech model and voice.
46
44
 
47
- **input:** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
45
+ **input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
48
46
 
49
- **options?:** (`object`): Additional options for speech synthesis
47
+ **options** (`object`): Additional options for speech synthesis
50
48
 
51
- **options.speaker?:** (`string`): Override the default speaker ID for this request
49
+ **options.speaker** (`string`): Override the default speaker ID for this request
52
50
 
53
51
  Returns: `Promise<NodeJS.ReadableStream>`
54
52
 
@@ -56,37 +54,37 @@ Returns: `Promise<NodeJS.ReadableStream>`
56
54
 
57
55
  Returns an array of available voice options, where each node contains:
58
56
 
59
- **voiceId:** (`string`): Unique identifier for the voice
57
+ **voiceId** (`string`): Unique identifier for the voice
60
58
 
61
- **name:** (`string`): Display name of the voice
59
+ **name** (`string`): Display name of the voice
62
60
 
63
- **language:** (`string`): Language code for the voice
61
+ **language** (`string`): Language code for the voice
64
62
 
65
- **gender:** (`string`): Gender of the voice
63
+ **gender** (`string`): Gender of the voice
66
64
 
67
65
  ### listen()
68
66
 
69
67
  Converts audio input to text using ElevenLabs Speech-to-Text API.
70
68
 
71
- **input:** (`NodeJS.ReadableStream`): A readable stream containing the audio data to transcribe
69
+ **input** (`NodeJS.ReadableStream`): A readable stream containing the audio data to transcribe
72
70
 
73
- **options?:** (`object`): Configuration options for the transcription
71
+ **options** (`object`): Configuration options for the transcription
74
72
 
75
73
  The options object supports the following properties:
76
74
 
77
- **language\_code?:** (`string`): ISO language code (e.g., 'en', 'fr', 'es')
75
+ **language\_code** (`string`): ISO language code (e.g., 'en', 'fr', 'es')
78
76
 
79
- **tag\_audio\_events?:** (`boolean`): Whether to tag audio events like \[MUSIC], \[LAUGHTER], etc.
77
+ **tag\_audio\_events** (`boolean`): Whether to tag audio events like \[MUSIC], \[LAUGHTER], etc.
80
78
 
81
- **num\_speakers?:** (`number`): Number of speakers to detect in the audio
79
+ **num\_speakers** (`number`): Number of speakers to detect in the audio
82
80
 
83
- **filetype?:** (`string`): Audio file format (e.g., 'mp3', 'wav', 'ogg')
81
+ **filetype** (`string`): Audio file format (e.g., 'mp3', 'wav', 'ogg')
84
82
 
85
- **timeoutInSeconds?:** (`number`): Request timeout in seconds
83
+ **timeoutInSeconds** (`number`): Request timeout in seconds
86
84
 
87
- **maxRetries?:** (`number`): Maximum number of retry attempts
85
+ **maxRetries** (`number`): Maximum number of retry attempts
88
86
 
89
- **abortSignal?:** (`AbortSignal`): Signal to abort the request
87
+ **abortSignal** (`AbortSignal`): Signal to abort the request
90
88
 
91
89
  Returns: `Promise<string>` - A Promise that resolves to the transcribed text
92
90
 
@@ -90,37 +90,35 @@ voice.close()
90
90
 
91
91
  ### Constructor Options
92
92
 
93
- **apiKey?:** (`string`): Google API key for Gemini API authentication. Required unless using Vertex AI.
93
+ **apiKey** (`string`): Google API key for Gemini API authentication. Required unless using Vertex AI.
94
94
 
95
- **model?:** (`GeminiVoiceModel`): The model ID to use for real-time voice interactions. (Default: `'gemini-2.0-flash-exp'`)
95
+ **model** (`GeminiVoiceModel`): The model ID to use for real-time voice interactions. (Default: `'gemini-2.0-flash-exp'`)
96
96
 
97
- **speaker?:** (`GeminiVoiceName`): Default voice ID for speech synthesis. (Default: `'Puck'`)
97
+ **speaker** (`GeminiVoiceName`): Default voice ID for speech synthesis. (Default: `'Puck'`)
98
98
 
99
- **vertexAI?:** (`boolean`): Use Vertex AI instead of Gemini API for authentication. (Default: `false`)
99
+ **vertexAI** (`boolean`): Use Vertex AI instead of Gemini API for authentication. (Default: `false`)
100
100
 
101
- **project?:** (`string`): Google Cloud project ID (required for Vertex AI).
101
+ **project** (`string`): Google Cloud project ID (required for Vertex AI).
102
102
 
103
- **location?:** (`string`): Google Cloud region for Vertex AI. (Default: `'us-central1'`)
103
+ **location** (`string`): Google Cloud region for Vertex AI. (Default: `'us-central1'`)
104
104
 
105
- **serviceAccountKeyFile?:** (`string`): Path to service account JSON key file for Vertex AI authentication.
105
+ **serviceAccountKeyFile** (`string`): Path to service account JSON key file for Vertex AI authentication.
106
106
 
107
- **serviceAccountEmail?:** (`string`): Service account email for impersonation (alternative to key file).
107
+ **serviceAccountEmail** (`string`): Service account email for impersonation (alternative to key file).
108
108
 
109
- **instructions?:** (`string`): System instructions for the model.
109
+ **instructions** (`string`): System instructions for the model.
110
110
 
111
- **sessionConfig?:** (`GeminiSessionConfig`): Session configuration including interrupt and context settings.
111
+ **sessionConfig** (`GeminiSessionConfig`): Session configuration including interrupt and context settings.
112
112
 
113
- **debug?:** (`boolean`): Enable debug logging for troubleshooting. (Default: `false`)
113
+ **sessionConfig.interrupts** (`object`): Interrupt handling configuration.
114
114
 
115
- ### Session Configuration
115
+ **sessionConfig.interrupts.enabled** (`boolean`): Enable interrupt handling.
116
116
 
117
- **interrupts?:** (`object`): Interrupt handling configuration.
117
+ **sessionConfig.interrupts.allowUserInterruption** (`boolean`): Allow user to interrupt model responses.
118
118
 
119
- **interrupts.enabled?:** (`boolean`): Enable interrupt handling. (Default: `true`)
119
+ **sessionConfig.contextCompression** (`boolean`): Enable automatic context compression.
120
120
 
121
- **interrupts.allowUserInterruption?:** (`boolean`): Allow user to interrupt model responses. (Default: `true`)
122
-
123
- **contextCompression?:** (`boolean`): Enable automatic context compression. (Default: `false`)
121
+ **debug** (`boolean`): Enable debug logging for troubleshooting. (Default: `false`)
124
122
 
125
123
  ## Methods
126
124
 
@@ -128,23 +126,23 @@ voice.close()
128
126
 
129
127
  Establishes a connection to the Gemini Live API. Must be called before using speak, listen, or send methods.
130
128
 
131
- **requestContext?:** (`object`): Optional request context for the connection.
129
+ **requestContext** (`object`): Optional request context for the connection.
132
130
 
133
- **returns:** (`Promise<void>`): Promise that resolves when the connection is established.
131
+ **returns** (`Promise<void>`): Promise that resolves when the connection is established.
134
132
 
135
133
  ### speak()
136
134
 
137
135
  Converts text to speech and sends it to the model. Can accept either a string or a readable stream as input.
138
136
 
139
- **input:** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
137
+ **input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
140
138
 
141
- **options?:** (`GeminiLiveVoiceOptions`): Optional speech configuration.
139
+ **options** (`GeminiLiveVoiceOptions`): Optional speech configuration.
142
140
 
143
- **options.speaker?:** (`GeminiVoiceName`): Voice ID to use for this specific speech request. (Default: `Constructor's speaker value`)
141
+ **options.speaker** (`GeminiVoiceName`): Voice ID to use for this specific speech request. (Default: `Constructor's speaker value`)
144
142
 
145
- **options.languageCode?:** (`string`): Language code for the response.
143
+ **options.languageCode** (`string`): Language code for the response.
146
144
 
147
- **options.responseModalities?:** (`('AUDIO' | 'TEXT')[]`): Response modalities to receive from the model. (Default: `['AUDIO', 'TEXT']`)
145
+ **options.responseModalities** (`('AUDIO' | 'TEXT')[]`): Response modalities to receive from the model. (Default: `['AUDIO', 'TEXT']`)
148
146
 
149
147
  Returns: `Promise<void>` (responses are emitted via `speaker` and `writing` events)
150
148
 
@@ -152,9 +150,9 @@ Returns: `Promise<void>` (responses are emitted via `speaker` and `writing` even
152
150
 
153
151
  Processes audio input for speech recognition. Takes a readable stream of audio data and returns the transcribed text.
154
152
 
155
- **audioStream:** (`NodeJS.ReadableStream`): Audio stream to transcribe.
153
+ **audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe.
156
154
 
157
- **options?:** (`GeminiLiveVoiceOptions`): Optional listening configuration.
155
+ **options** (`GeminiLiveVoiceOptions`): Optional listening configuration.
158
156
 
159
157
  Returns: `Promise<string>` - The transcribed text
160
158
 
@@ -162,7 +160,7 @@ Returns: `Promise<string>` - The transcribed text
162
160
 
163
161
  Streams audio data in real-time to the Gemini service for continuous audio streaming scenarios like live microphone input.
164
162
 
165
- **audioData:** (`NodeJS.ReadableStream | Int16Array`): Audio stream or buffer to send to the service.
163
+ **audioData** (`NodeJS.ReadableStream | Int16Array`): Audio stream or buffer to send to the service.
166
164
 
167
165
  Returns: `Promise<void>`
168
166
 
@@ -170,7 +168,7 @@ Returns: `Promise<void>`
170
168
 
171
169
  Updates the session configuration dynamically. This can be used to modify voice settings, speaker selection, and other runtime configurations.
172
170
 
173
- **config:** (`Partial<GeminiLiveVoiceConfig>`): Configuration updates to apply.
171
+ **config** (`Partial<GeminiLiveVoiceConfig>`): Configuration updates to apply.
174
172
 
175
173
  Returns: `Promise<void>`
176
174
 
@@ -178,7 +176,7 @@ Returns: `Promise<void>`
178
176
 
179
177
  Adds a set of tools to the voice instance. Tools allow the model to perform additional actions during conversations. When GeminiLiveVoice is added to an Agent, any tools configured for the Agent will automatically be available to the voice interface.
180
178
 
181
- **tools:** (`ToolsInput`): Tools configuration to equip.
179
+ **tools** (`ToolsInput`): Tools configuration to equip.
182
180
 
183
181
  Returns: `void`
184
182
 
@@ -186,7 +184,7 @@ Returns: `void`
186
184
 
187
185
  Adds or updates system instructions for the model.
188
186
 
189
- **instructions?:** (`string`): System instructions to set.
187
+ **instructions** (`string`): System instructions to set.
190
188
 
191
189
  Returns: `void`
192
190
 
@@ -194,7 +192,7 @@ Returns: `void`
194
192
 
195
193
  Triggers a response from the model. This method is primarily used internally when integrated with an Agent.
196
194
 
197
- **options?:** (`Record<string, unknown>`): Optional parameters for the answer request.
195
+ **options** (`Record<string, unknown>`): Optional parameters for the answer request.
198
196
 
199
197
  Returns: `Promise<void>`
200
198
 
@@ -220,9 +218,9 @@ Returns: `void`
220
218
 
221
219
  Registers an event listener for voice events.
222
220
 
223
- **event:** (`string`): Name of the event to listen for.
221
+ **event** (`string`): Name of the event to listen for.
224
222
 
225
- **callback:** (`Function`): Function to call when the event occurs.
223
+ **callback** (`Function`): Function to call when the event occurs.
226
224
 
227
225
  Returns: `void`
228
226
 
@@ -230,9 +228,9 @@ Returns: `void`
230
228
 
231
229
  Removes a previously registered event listener.
232
230
 
233
- **event:** (`string`): Name of the event to stop listening to.
231
+ **event** (`string`): Name of the event to stop listening to.
234
232
 
235
- **callback:** (`Function`): The specific callback function to remove.
233
+ **callback** (`Function`): The specific callback function to remove.
236
234
 
237
235
  Returns: `void`
238
236
 
@@ -240,23 +238,23 @@ Returns: `void`
240
238
 
241
239
  The GeminiLiveVoice class emits the following events:
242
240
 
243
- **speaker:** (`event`): Emitted when audio data is received from the model. Callback receives a NodeJS.ReadableStream.
241
+ **speaker** (`event`): Emitted when audio data is received from the model. Callback receives a NodeJS.ReadableStream.
244
242
 
245
- **speaking:** (`event`): Emitted with audio metadata. Callback receives { audioData?: Int16Array, sampleRate?: number }.
243
+ **speaking** (`event`): Emitted with audio metadata. Callback receives { audioData?: Int16Array, sampleRate?: number }.
246
244
 
247
- **writing:** (`event`): Emitted when transcribed text is available. Callback receives { text: string, role: 'assistant' | 'user' }.
245
+ **writing** (`event`): Emitted when transcribed text is available. Callback receives { text: string, role: 'assistant' | 'user' }.
248
246
 
249
- **session:** (`event`): Emitted on session state changes. Callback receives { state: 'connecting' | 'connected' | 'disconnected' | 'disconnecting' | 'updated', config?: object }.
247
+ **session** (`event`): Emitted on session state changes. Callback receives { state: 'connecting' | 'connected' | 'disconnected' | 'disconnecting' | 'updated', config?: object }.
250
248
 
251
- **turnComplete:** (`event`): Emitted when a conversation turn is completed. Callback receives { timestamp: number }.
249
+ **turnComplete** (`event`): Emitted when a conversation turn is completed. Callback receives { timestamp: number }.
252
250
 
253
- **toolCall:** (`event`): Emitted when the model requests a tool call. Callback receives { name: string, args: object, id: string }.
251
+ **toolCall** (`event`): Emitted when the model requests a tool call. Callback receives { name: string, args: object, id: string }.
254
252
 
255
- **usage:** (`event`): Emitted with token usage information. Callback receives { inputTokens: number, outputTokens: number, totalTokens: number, modality: string }.
253
+ **usage** (`event`): Emitted with token usage information. Callback receives { inputTokens: number, outputTokens: number, totalTokens: number, modality: string }.
256
254
 
257
- **error:** (`event`): Emitted when an error occurs. Callback receives { message: string, code?: string, details?: unknown }.
255
+ **error** (`event`): Emitted when an error occurs. Callback receives { message: string, code?: string, details?: unknown }.
258
256
 
259
- **interrupt:** (`event`): Interrupt events. Callback receives { type: 'user' | 'model', timestamp: number }.
257
+ **interrupt** (`event`): Interrupt events. Callback receives { type: 'user' | 'model', timestamp: number }.
260
258
 
261
259
  ## Available Models
262
260
 
@@ -32,25 +32,29 @@ const voices = await voice.getSpeakers({ languageCode: 'en-US' })
32
32
 
33
33
  ## Constructor Parameters
34
34
 
35
- **speechModel?:** (`GoogleModelConfig`): Configuration for text-to-speech functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
35
+ **speechModel** (`GoogleModelConfig`): Configuration for text-to-speech functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
36
36
 
37
- **listeningModel?:** (`GoogleModelConfig`): Configuration for speech-to-text functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
37
+ **speechModel.apiKey** (`string`): Google Cloud API key. Falls back to GOOGLE\_API\_KEY environment variable. Not used when vertexAI is true.
38
38
 
39
- **speaker?:** (`string`): Default voice ID to use for text-to-speech (Default: `'en-US-Casual-K'`)
39
+ **speechModel.keyFilename** (`string`): Path to service account JSON key file. Falls back to GOOGLE\_APPLICATION\_CREDENTIALS environment variable.
40
40
 
41
- **vertexAI?:** (`boolean`): Enable Vertex AI mode for enterprise deployments. Uses project-based authentication instead of API keys. Requires 'project' to be set. (Default: `false`)
41
+ **speechModel.credentials** (`object`): In-memory service account credentials object with client\_email and private\_key properties.
42
42
 
43
- **project?:** (`string`): Google Cloud project ID (required when vertexAI is true). Falls back to GOOGLE\_CLOUD\_PROJECT environment variable.
43
+ **listeningModel** (`GoogleModelConfig`): Configuration for speech-to-text functionality (Default: `{ apiKey: process.env.GOOGLE_API_KEY }`)
44
44
 
45
- **location?:** (`string`): Google Cloud region for Vertex AI. Falls back to GOOGLE\_CLOUD\_LOCATION environment variable. (Default: `'us-central1'`)
45
+ **listeningModel.apiKey** (`string`): Google Cloud API key. Falls back to GOOGLE\_API\_KEY environment variable. Not used when vertexAI is true.
46
46
 
47
- ### GoogleModelConfig
47
+ **listeningModel.keyFilename** (`string`): Path to service account JSON key file. Falls back to GOOGLE\_APPLICATION\_CREDENTIALS environment variable.
48
48
 
49
- **apiKey?:** (`string`): Google Cloud API key. Falls back to GOOGLE\_API\_KEY environment variable. Not used when vertexAI is true.
49
+ **listeningModel.credentials** (`object`): In-memory service account credentials object with client\_email and private\_key properties.
50
50
 
51
- **keyFilename?:** (`string`): Path to service account JSON key file. Falls back to GOOGLE\_APPLICATION\_CREDENTIALS environment variable.
51
+ **speaker** (`string`): Default voice ID to use for text-to-speech (Default: `'en-US-Casual-K'`)
52
52
 
53
- **credentials?:** (`object`): In-memory service account credentials object with client\_email and private\_key properties.
53
+ **vertexAI** (`boolean`): Enable Vertex AI mode for enterprise deployments. Uses project-based authentication instead of API keys. Requires 'project' to be set. (Default: `false`)
54
+
55
+ **project** (`string`): Google Cloud project ID (required when vertexAI is true). Falls back to GOOGLE\_CLOUD\_PROJECT environment variable.
56
+
57
+ **location** (`string`): Google Cloud region for Vertex AI. Falls back to GOOGLE\_CLOUD\_LOCATION environment variable. (Default: `'us-central1'`)
54
58
 
55
59
  ## Methods
56
60
 
@@ -58,15 +62,15 @@ const voices = await voice.getSpeakers({ languageCode: 'en-US' })
58
62
 
59
63
  Converts text to speech using Google Cloud Text-to-Speech service.
60
64
 
61
- **input:** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
65
+ **input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
62
66
 
63
- **options?:** (`object`): Speech synthesis options
67
+ **options** (`object`): Speech synthesis options
64
68
 
65
- **options.speaker?:** (`string`): Voice ID to use for this request
69
+ **options.speaker** (`string`): Voice ID to use for this request
66
70
 
67
- **options.languageCode?:** (`string`): Language code for the voice (e.g., 'en-US'). Defaults to the language code from the speaker ID or 'en-US'
71
+ **options.languageCode** (`string`): Language code for the voice (e.g., 'en-US'). Defaults to the language code from the speaker ID or 'en-US'
68
72
 
69
- **options.audioConfig?:** (`ISynthesizeSpeechRequest['audioConfig']`): Audio configuration options from Google Cloud Text-to-Speech API (Default: `{ audioEncoding: 'LINEAR16' }`)
73
+ **options.audioConfig** (`ISynthesizeSpeechRequest['audioConfig']`): Audio configuration options from Google Cloud Text-to-Speech API (Default: `{ audioEncoding: 'LINEAR16' }`)
70
74
 
71
75
  Returns: `Promise<NodeJS.ReadableStream>`
72
76
 
@@ -74,13 +78,13 @@ Returns: `Promise<NodeJS.ReadableStream>`
74
78
 
75
79
  Converts speech to text using Google Cloud Speech-to-Text service.
76
80
 
77
- **audioStream:** (`NodeJS.ReadableStream`): Audio stream to transcribe
81
+ **audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe
78
82
 
79
- **options?:** (`object`): Recognition options
83
+ **options** (`object`): Recognition options
80
84
 
81
- **options.stream?:** (`boolean`): Whether to use streaming recognition
85
+ **options.stream** (`boolean`): Whether to use streaming recognition
82
86
 
83
- **options.config?:** (`IRecognitionConfig`): Recognition configuration from Google Cloud Speech-to-Text API (Default: `{ encoding: 'LINEAR16', languageCode: 'en-US' }`)
87
+ **options.config** (`IRecognitionConfig`): Recognition configuration from Google Cloud Speech-to-Text API (Default: `{ encoding: 'LINEAR16', languageCode: 'en-US' }`)
84
88
 
85
89
  Returns: `Promise<string>`
86
90
 
@@ -88,9 +92,9 @@ Returns: `Promise<string>`
88
92
 
89
93
  Returns an array of available voice options, where each node contains:
90
94
 
91
- **voiceId:** (`string`): Unique identifier for the voice
95
+ **voiceId** (`string`): Unique identifier for the voice
92
96
 
93
- **languageCodes:** (`string[]`): List of language codes supported by this voice
97
+ **languageCodes** (`string[]`): List of language codes supported by this voice
94
98
 
95
99
  ### isUsingVertexAI()
96
100
 
@@ -79,31 +79,31 @@ class MyVoiceProvider extends MastraVoice {
79
79
 
80
80
  ## Constructor Parameters
81
81
 
82
- **config?:** (`VoiceConfig`): Configuration object for the voice service
82
+ **config** (`VoiceConfig`): Configuration object for the voice service
83
83
 
84
- **config.speechModel?:** (`BuiltInModelConfig`): Configuration for the text-to-speech model
84
+ **config.speechModel** (`BuiltInModelConfig`): Configuration for the text-to-speech model
85
85
 
86
- **config.listeningModel?:** (`BuiltInModelConfig`): Configuration for the speech-to-text model
86
+ **config.speechModel.name** (`string`): Name of the model to use
87
87
 
88
- **config.speaker?:** (`string`): Default speaker/voice ID to use
88
+ **config.speechModel.apiKey** (`string`): API key for the model service
89
89
 
90
- **config.name?:** (`string`): Name for the voice provider instance
90
+ **config.listeningModel** (`BuiltInModelConfig`): Configuration for the speech-to-text model
91
91
 
92
- **config.realtimeConfig?:** (`object`): Configuration for real-time speech-to-speech capabilities
92
+ **config.listeningModel.name** (`string`): Name of the model to use
93
93
 
94
- ### BuiltInModelConfig
94
+ **config.listeningModel.apiKey** (`string`): API key for the model service
95
95
 
96
- **name:** (`string`): Name of the model to use
96
+ **config.speaker** (`string`): Default speaker/voice ID to use
97
97
 
98
- **apiKey?:** (`string`): API key for the model service
98
+ **config.name** (`string`): Name for the voice provider instance
99
99
 
100
- ### RealtimeConfig
100
+ **config.realtimeConfig** (`object`): Configuration for real-time speech-to-speech capabilities
101
101
 
102
- **model?:** (`string`): Model to use for real-time speech-to-speech capabilities
102
+ **config.realtimeConfig.model** (`string`): Model to use for real-time speech-to-speech capabilities
103
103
 
104
- **apiKey?:** (`string`): API key for the real-time service
104
+ **config.realtimeConfig.apiKey** (`string`): API key for the real-time service
105
105
 
106
- **options?:** (`unknown`): Provider-specific options for real-time capabilities
106
+ **config.realtimeConfig.options** (`unknown`): Provider-specific options for real-time capabilities
107
107
 
108
108
  ## Abstract Methods
109
109
 
@@ -281,21 +281,21 @@ Purpose:
281
281
 
282
282
  The MastraVoice class includes an event system for real-time communication. Standard event types include:
283
283
 
284
- **speaking:** (`{ text: string; audioStream?: NodeJS.ReadableStream; audio?: Int16Array }`): Emitted when the voice provider is speaking, contains audio data
284
+ **speaking** (`{ text: string; audioStream?: NodeJS.ReadableStream; audio?: Int16Array }`): Emitted when the voice provider is speaking, contains audio data
285
285
 
286
- **writing:** (`{ text: string, role: string }`): Emitted when text is transcribed from speech
286
+ **writing** (`{ text: string, role: string }`): Emitted when text is transcribed from speech
287
287
 
288
- **error:** (`{ message: string; code?: string; details?: unknown }`): Emitted when an error occurs
288
+ **error** (`{ message: string; code?: string; details?: unknown }`): Emitted when an error occurs
289
289
 
290
290
  ## Protected Properties
291
291
 
292
- **listeningModel?:** (`BuiltInModelConfig | undefined`): Configuration for the speech-to-text model
292
+ **listeningModel** (`BuiltInModelConfig | undefined`): Configuration for the speech-to-text model
293
293
 
294
- **speechModel?:** (`BuiltInModelConfig | undefined`): Configuration for the text-to-speech model
294
+ **speechModel** (`BuiltInModelConfig | undefined`): Configuration for the text-to-speech model
295
295
 
296
- **speaker?:** (`string | undefined`): Default speaker/voice ID
296
+ **speaker** (`string | undefined`): Default speaker/voice ID
297
297
 
298
- **realtimeConfig?:** (`{ model?: string; apiKey?: string; options?: unknown } | undefined`): Configuration for real-time speech-to-speech capabilities
298
+ **realtimeConfig** (`{ model?: string; apiKey?: string; options?: unknown } | undefined`): Configuration for real-time speech-to-speech capabilities
299
299
 
300
300
  ## Telemetry Support
301
301
 
@@ -45,41 +45,37 @@ const voices = await voice.getSpeakers()
45
45
 
46
46
  ## Constructor Parameters
47
47
 
48
- **speechModel?:** (`MurfConfig`): Configuration for text-to-speech functionality (Default: `{ name: 'GEN2' }`)
48
+ **speechModel** (`MurfConfig`): Configuration for text-to-speech functionality (Default: `{ name: 'GEN2' }`)
49
49
 
50
- **speaker?:** (`string`): Default voice ID to use for text-to-speech (Default: `'en-UK-hazel'`)
50
+ **speechModel.name** (`'GEN1' | 'GEN2'`): The Murf model generation to use
51
51
 
52
- ### MurfConfig
52
+ **speechModel.apiKey** (`string`): Murf API key. Falls back to MURF\_API\_KEY environment variable
53
53
 
54
- **name:** (`'GEN1' | 'GEN2'`): The Murf model generation to use (Default: `'GEN2'`)
54
+ **speechModel.properties** (`object`): Default properties for all speech synthesis requests
55
55
 
56
- **apiKey?:** (`string`): Murf API key. Falls back to MURF\_API\_KEY environment variable
56
+ **speechModel.properties.style** (`string`): Speaking style for the voice
57
57
 
58
- **properties?:** (`object`): Default properties for all speech synthesis requests
58
+ **speechModel.properties.rate** (`number`): Speech rate multiplier
59
59
 
60
- ### Speech Properties
60
+ **speechModel.properties.pitch** (`number`): Voice pitch adjustment
61
61
 
62
- **style?:** (`string`): Speaking style for the voice
62
+ **speechModel.properties.sampleRate** (`8000 | 24000 | 44100 | 48000`): Audio sample rate in Hz
63
63
 
64
- **rate?:** (`number`): Speech rate multiplier
64
+ **speechModel.properties.format** (`'MP3' | 'WAV' | 'FLAC' | 'ALAW' | 'ULAW'`): Output audio format
65
65
 
66
- **pitch?:** (`number`): Voice pitch adjustment
66
+ **speechModel.properties.channelType** (`'STEREO' | 'MONO'`): Audio channel configuration
67
67
 
68
- **sampleRate?:** (`8000 | 24000 | 44100 | 48000`): Audio sample rate in Hz
68
+ **speechModel.properties.pronunciationDictionary** (`Record<string, string>`): Custom pronunciation mappings
69
69
 
70
- **format?:** (`'MP3' | 'WAV' | 'FLAC' | 'ALAW' | 'ULAW'`): Output audio format
70
+ **speechModel.properties.encodeAsBase64** (`boolean`): Whether to encode the audio as base64
71
71
 
72
- **channelType?:** (`'STEREO' | 'MONO'`): Audio channel configuration
72
+ **speechModel.properties.variation** (`number`): Voice variation parameter
73
73
 
74
- **pronunciationDictionary?:** (`Record<string, string>`): Custom pronunciation mappings
74
+ **speechModel.properties.audioDuration** (`number`): Target audio duration in seconds
75
75
 
76
- **encodeAsBase64?:** (`boolean`): Whether to encode the audio as base64
76
+ **speechModel.properties.multiNativeLocale** (`string`): Locale for multilingual support
77
77
 
78
- **variation?:** (`number`): Voice variation parameter
79
-
80
- **audioDuration?:** (`number`): Target audio duration in seconds
81
-
82
- **multiNativeLocale?:** (`string`): Locale for multilingual support
78
+ **speaker** (`string`): Default voice ID to use for text-to-speech (Default: `'en-UK-hazel'`)
83
79
 
84
80
  ## Methods
85
81
 
@@ -87,13 +83,13 @@ const voices = await voice.getSpeakers()
87
83
 
88
84
  Converts text to speech using Murf's API.
89
85
 
90
- **input:** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
86
+ **input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
91
87
 
92
- **options?:** (`object`): Speech synthesis options
88
+ **options** (`object`): Speech synthesis options
93
89
 
94
- **options.speaker?:** (`string`): Override the default speaker for this request
90
+ **options.speaker** (`string`): Override the default speaker for this request
95
91
 
96
- **options.properties?:** (`object`): Override default speech properties for this request
92
+ **options.properties** (`object`): Override default speech properties for this request
97
93
 
98
94
  Returns: `Promise<NodeJS.ReadableStream>`
99
95
 
@@ -101,13 +97,13 @@ Returns: `Promise<NodeJS.ReadableStream>`
101
97
 
102
98
  Returns an array of available voice options, where each node contains:
103
99
 
104
- **voiceId:** (`string`): Unique identifier for the voice
100
+ **voiceId** (`string`): Unique identifier for the voice
105
101
 
106
- **name:** (`string`): Display name of the voice
102
+ **name** (`string`): Display name of the voice
107
103
 
108
- **language:** (`string`): Language code for the voice
104
+ **language** (`string`): Language code for the voice
109
105
 
110
- **gender:** (`string`): Gender of the voice
106
+ **gender** (`string`): Gender of the voice
111
107
 
112
108
  ### listen()
113
109