@mastra/mcp-docs-server 1.1.7 → 1.1.8

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
@@ -4,49 +4,49 @@ The TurbopufferVector class provides vector search using [Turbopuffer](https://t
4
4
 
5
5
  ## Constructor Options
6
6
 
7
- **apiKey:** (`string`): The API key to authenticate with Turbopuffer
7
+ **apiKey** (`string`): The API key to authenticate with Turbopuffer
8
8
 
9
- **baseUrl?:** (`string`): The base URL for the Turbopuffer API (Default: `https://api.turbopuffer.com`)
9
+ **baseUrl** (`string`): The base URL for the Turbopuffer API (Default: `https://api.turbopuffer.com`)
10
10
 
11
- **connectTimeout?:** (`number`): The timeout to establish a connection, in ms. Only applicable in Node and Deno. (Default: `10000`)
11
+ **connectTimeout** (`number`): The timeout to establish a connection, in ms. Only applicable in Node and Deno. (Default: `10000`)
12
12
 
13
- **connectionIdleTimeout?:** (`number`): The socket idle timeout, in ms. Only applicable in Node and Deno. (Default: `60000`)
13
+ **connectionIdleTimeout** (`number`): The socket idle timeout, in ms. Only applicable in Node and Deno. (Default: `60000`)
14
14
 
15
- **warmConnections?:** (`number`): The number of connections to open initially when creating a new client. (Default: `0`)
15
+ **warmConnections** (`number`): The number of connections to open initially when creating a new client. (Default: `0`)
16
16
 
17
- **compression?:** (`boolean`): Whether to compress requests and accept compressed responses. (Default: `true`)
17
+ **compression** (`boolean`): Whether to compress requests and accept compressed responses. (Default: `true`)
18
18
 
19
- **schemaConfigForIndex?:** (`function`): A callback function that takes an index name and returns a config object for that index. This allows you to define explicit schemas per index.
19
+ **schemaConfigForIndex** (`function`): A callback function that takes an index name and returns a config object for that index. This allows you to define explicit schemas per index.
20
20
 
21
21
  ## Methods
22
22
 
23
23
  ### createIndex()
24
24
 
25
- **indexName:** (`string`): Name of the index to create
25
+ **indexName** (`string`): Name of the index to create
26
26
 
27
- **dimension:** (`number`): Vector dimension (must match your embedding model)
27
+ **dimension** (`number`): Vector dimension (must match your embedding model)
28
28
 
29
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
29
+ **metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
30
30
 
31
31
  ### upsert()
32
32
 
33
- **vectors:** (`number[][]`): Array of embedding vectors
33
+ **vectors** (`number[][]`): Array of embedding vectors
34
34
 
35
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
35
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
36
36
 
37
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
37
+ **ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
38
38
 
39
39
  ### query()
40
40
 
41
- **indexName:** (`string`): Name of the index to query
41
+ **indexName** (`string`): Name of the index to query
42
42
 
43
- **queryVector:** (`number[]`): Query vector to find similar vectors
43
+ **queryVector** (`number[]`): Query vector to find similar vectors
44
44
 
45
- **topK?:** (`number`): Number of results to return (Default: `10`)
45
+ **topK** (`number`): Number of results to return (Default: `10`)
46
46
 
47
- **filter?:** (`Record<string, any>`): Metadata filters for the query
47
+ **filter** (`Record<string, any>`): Metadata filters for the query
48
48
 
49
- **includeVector?:** (`boolean`): Whether to include vectors in the results (Default: `false`)
49
+ **includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
50
50
 
51
51
  ### listIndexes()
52
52
 
@@ -54,7 +54,7 @@ Returns an array of index names as strings.
54
54
 
55
55
  ### describeIndex()
56
56
 
57
- **indexName:** (`string`): Name of the index to describe
57
+ **indexName** (`string`): Name of the index to describe
58
58
 
59
59
  Returns:
60
60
 
@@ -68,35 +68,35 @@ interface IndexStats {
68
68
 
69
69
  ### deleteIndex()
70
70
 
71
- **indexName:** (`string`): Name of the index to delete
71
+ **indexName** (`string`): Name of the index to delete
72
72
 
73
73
  ### updateVector()
74
74
 
75
75
  Update a single vector by ID or by metadata filter. Either `id` or `filter` must be provided, but not both.
76
76
 
77
- **indexName:** (`string`): Name of the index containing the vector
77
+ **indexName** (`string`): Name of the index containing the vector
78
78
 
79
- **id?:** (`string`): ID of the vector to update (mutually exclusive with filter)
79
+ **id** (`string`): ID of the vector to update (mutually exclusive with filter)
80
80
 
81
- **filter?:** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
81
+ **filter** (`Record<string, any>`): Metadata filter to identify vector(s) to update (mutually exclusive with id)
82
82
 
83
- **update:** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
83
+ **update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
84
84
 
85
85
  ### deleteVector()
86
86
 
87
- **indexName:** (`string`): Name of the index containing the vector
87
+ **indexName** (`string`): Name of the index containing the vector
88
88
 
89
- **id:** (`string`): ID of the vector to delete
89
+ **id** (`string`): ID of the vector to delete
90
90
 
91
91
  ### deleteVectors()
92
92
 
93
93
  Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` must be provided, but not both.
94
94
 
95
- **indexName:** (`string`): Name of the index containing the vectors to delete
95
+ **indexName** (`string`): Name of the index containing the vectors to delete
96
96
 
97
- **ids?:** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
97
+ **ids** (`string[]`): Array of vector IDs to delete (mutually exclusive with filter)
98
98
 
99
- **filter?:** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
99
+ **filter** (`Record<string, any>`): Metadata filter to identify vectors to delete (mutually exclusive with ids)
100
100
 
101
101
  ## Response Types
102
102
 
@@ -4,9 +4,9 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
4
4
 
5
5
  ## Constructor Options
6
6
 
7
- **url:** (`string`): Upstash Vector database URL
7
+ **url** (`string`): Upstash Vector database URL
8
8
 
9
- **token:** (`string`): Upstash Vector API token
9
+ **token** (`string`): Upstash Vector API token
10
10
 
11
11
  ## Methods
12
12
 
@@ -14,41 +14,41 @@ The UpstashVector class provides vector search using [Upstash Vector](https://up
14
14
 
15
15
  Note: This method is a no-op for Upstash as indexes are created automatically.
16
16
 
17
- **indexName:** (`string`): Name of the index to create
17
+ **indexName** (`string`): Name of the index to create
18
18
 
19
- **dimension:** (`number`): Vector dimension (must match your embedding model)
19
+ **dimension** (`number`): Vector dimension (must match your embedding model)
20
20
 
21
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
21
+ **metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (Default: `cosine`)
22
22
 
23
23
  ### upsert()
24
24
 
25
- **indexName:** (`string`): Name of the index to upsert into
25
+ **indexName** (`string`): Name of the index to upsert into
26
26
 
27
- **vectors:** (`number[][]`): Array of embedding vectors
27
+ **vectors** (`number[][]`): Array of embedding vectors
28
28
 
29
- **sparseVectors?:** (`{ indices: number[], values: number[] }[]`): Array of sparse vectors for hybrid search. Each sparse vector must have matching indices and values arrays.
29
+ **sparseVectors** (`{ indices: number[], values: number[] }[]`): Array of sparse vectors for hybrid search. Each sparse vector must have matching indices and values arrays.
30
30
 
31
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
31
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
32
32
 
33
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
33
+ **ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
34
34
 
35
35
  ### query()
36
36
 
37
- **indexName:** (`string`): Name of the index to query
37
+ **indexName** (`string`): Name of the index to query
38
38
 
39
- **queryVector:** (`number[]`): Query vector to find similar vectors
39
+ **queryVector** (`number[]`): Query vector to find similar vectors
40
40
 
41
- **sparseVector?:** (`{ indices: number[], values: number[] }`): Optional sparse vector for hybrid search. Must have matching indices and values arrays.
41
+ **sparseVector** (`{ indices: number[], values: number[] }`): Optional sparse vector for hybrid search. Must have matching indices and values arrays.
42
42
 
43
- **topK?:** (`number`): Number of results to return (Default: `10`)
43
+ **topK** (`number`): Number of results to return (Default: `10`)
44
44
 
45
- **filter?:** (`Record<string, any>`): Metadata filters for the query
45
+ **filter** (`Record<string, any>`): Metadata filters for the query
46
46
 
47
- **includeVector?:** (`boolean`): Whether to include vectors in the results (Default: `false`)
47
+ **includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
48
48
 
49
- **fusionAlgorithm?:** (`FusionAlgorithm`): Algorithm used to combine dense and sparse search results in hybrid search (e.g., RRF - Reciprocal Rank Fusion)
49
+ **fusionAlgorithm** (`FusionAlgorithm`): Algorithm used to combine dense and sparse search results in hybrid search (e.g., RRF - Reciprocal Rank Fusion)
50
50
 
51
- **queryMode?:** (`QueryMode`): Search mode: 'DENSE' for dense-only, 'SPARSE' for sparse-only, or 'HYBRID' for combined search
51
+ **queryMode** (`QueryMode`): Search mode: 'DENSE' for dense-only, 'SPARSE' for sparse-only, or 'HYBRID' for combined search
52
52
 
53
53
  ### listIndexes()
54
54
 
@@ -56,7 +56,7 @@ Returns an array of index names (namespaces) as strings.
56
56
 
57
57
  ### describeIndex()
58
58
 
59
- **indexName:** (`string`): Name of the index to describe
59
+ **indexName** (`string`): Name of the index to describe
60
60
 
61
61
  Returns:
62
62
 
@@ -70,15 +70,15 @@ interface IndexStats {
70
70
 
71
71
  ### deleteIndex()
72
72
 
73
- **indexName:** (`string`): Name of the index (namespace) to delete
73
+ **indexName** (`string`): Name of the index (namespace) to delete
74
74
 
75
75
  ### updateVector()
76
76
 
77
- **indexName:** (`string`): Name of the index to update
77
+ **indexName** (`string`): Name of the index to update
78
78
 
79
- **id:** (`string`): ID of the item to update
79
+ **id** (`string`): ID of the item to update
80
80
 
81
- **update:** (`object`): Update object containing vector, sparse vector, and/or metadata
81
+ **update** (`object`): Update object containing vector, sparse vector, and/or metadata
82
82
 
83
83
  The `update` object can have the following properties:
84
84
 
@@ -88,9 +88,9 @@ The `update` object can have the following properties:
88
88
 
89
89
  ### deleteVector()
90
90
 
91
- **indexName:** (`string`): Name of the index from which to delete the item
91
+ **indexName** (`string`): Name of the index from which to delete the item
92
92
 
93
- **id:** (`string`): ID of the item to delete
93
+ **id** (`string`): ID of the item to delete
94
94
 
95
95
  Attempts to delete an item by its ID from the specified index. Logs an error message if the deletion fails.
96
96
 
@@ -4,41 +4,41 @@ The CloudflareVector class provides vector search using [Cloudflare Vectorize](h
4
4
 
5
5
  ## Constructor Options
6
6
 
7
- **accountId:** (`string`): Cloudflare account ID
7
+ **accountId** (`string`): Cloudflare account ID
8
8
 
9
- **apiToken:** (`string`): Cloudflare API token with Vectorize permissions
9
+ **apiToken** (`string`): Cloudflare API token with Vectorize permissions
10
10
 
11
11
  ## Methods
12
12
 
13
13
  ### createIndex()
14
14
 
15
- **indexName:** (`string`): Name of the index to create
15
+ **indexName** (`string`): Name of the index to create
16
16
 
17
- **dimension:** (`number`): Vector dimension (must match your embedding model)
17
+ **dimension** (`number`): Vector dimension (must match your embedding model)
18
18
 
19
- **metric?:** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (dotproduct maps to dot-product) (Default: `cosine`)
19
+ **metric** (`'cosine' | 'euclidean' | 'dotproduct'`): Distance metric for similarity search (dotproduct maps to dot-product) (Default: `cosine`)
20
20
 
21
21
  ### upsert()
22
22
 
23
- **indexName:** (`string`): Name of the index to upsert into
23
+ **indexName** (`string`): Name of the index to upsert into
24
24
 
25
- **vectors:** (`number[][]`): Array of embedding vectors
25
+ **vectors** (`number[][]`): Array of embedding vectors
26
26
 
27
- **metadata?:** (`Record<string, any>[]`): Metadata for each vector
27
+ **metadata** (`Record<string, any>[]`): Metadata for each vector
28
28
 
29
- **ids?:** (`string[]`): Optional vector IDs (auto-generated if not provided)
29
+ **ids** (`string[]`): Optional vector IDs (auto-generated if not provided)
30
30
 
31
31
  ### query()
32
32
 
33
- **indexName:** (`string`): Name of the index to query
33
+ **indexName** (`string`): Name of the index to query
34
34
 
35
- **queryVector:** (`number[]`): Query vector to find similar vectors
35
+ **queryVector** (`number[]`): Query vector to find similar vectors
36
36
 
37
- **topK?:** (`number`): Number of results to return (Default: `10`)
37
+ **topK** (`number`): Number of results to return (Default: `10`)
38
38
 
39
- **filter?:** (`Record<string, any>`): Metadata filters for the query
39
+ **filter** (`Record<string, any>`): Metadata filters for the query
40
40
 
41
- **includeVector?:** (`boolean`): Whether to include vectors in the results (Default: `false`)
41
+ **includeVector** (`boolean`): Whether to include vectors in the results (Default: `false`)
42
42
 
43
43
  ### listIndexes()
44
44
 
@@ -46,7 +46,7 @@ Returns an array of index names as strings.
46
46
 
47
47
  ### describeIndex()
48
48
 
49
- **indexName:** (`string`): Name of the index to describe
49
+ **indexName** (`string`): Name of the index to describe
50
50
 
51
51
  Returns:
52
52
 
@@ -60,49 +60,49 @@ interface IndexStats {
60
60
 
61
61
  ### deleteIndex()
62
62
 
63
- **indexName:** (`string`): Name of the index to delete
63
+ **indexName** (`string`): Name of the index to delete
64
64
 
65
65
  ### createMetadataIndex()
66
66
 
67
67
  Creates an index on a metadata field to enable filtering.
68
68
 
69
- **indexName:** (`string`): Name of the index containing the metadata field
69
+ **indexName** (`string`): Name of the index containing the metadata field
70
70
 
71
- **propertyName:** (`string`): Name of the metadata field to index
71
+ **propertyName** (`string`): Name of the metadata field to index
72
72
 
73
- **indexType:** (`'string' | 'number' | 'boolean'`): Type of the metadata field
73
+ **indexType** (`'string' | 'number' | 'boolean'`): Type of the metadata field
74
74
 
75
75
  ### deleteMetadataIndex()
76
76
 
77
77
  Removes an index from a metadata field.
78
78
 
79
- **indexName:** (`string`): Name of the index containing the metadata field
79
+ **indexName** (`string`): Name of the index containing the metadata field
80
80
 
81
- **propertyName:** (`string`): Name of the metadata field to remove indexing from
81
+ **propertyName** (`string`): Name of the metadata field to remove indexing from
82
82
 
83
83
  ### listMetadataIndexes()
84
84
 
85
85
  Lists all metadata field indexes for an index.
86
86
 
87
- **indexName:** (`string`): Name of the index to list metadata indexes for
87
+ **indexName** (`string`): Name of the index to list metadata indexes for
88
88
 
89
89
  ### updateVector()
90
90
 
91
91
  Updates a vector or metadata for a specific ID within an index.
92
92
 
93
- **indexName:** (`string`): Name of the index containing the ID to update
93
+ **indexName** (`string`): Name of the index containing the ID to update
94
94
 
95
- **id:** (`string`): Unique identifier of the vector or metadata to update
95
+ **id** (`string`): Unique identifier of the vector or metadata to update
96
96
 
97
- **update:** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
97
+ **update** (`{ vector?: number[]; metadata?: Record<string, any>; }`): Object containing the vector and/or metadata to update
98
98
 
99
99
  ### deleteVector()
100
100
 
101
101
  Deletes a vector and its associated metadata for a specific ID within an index.
102
102
 
103
- **indexName:** (`string`): Name of the index containing the ID to delete
103
+ **indexName** (`string`): Name of the index containing the ID to delete
104
104
 
105
- **id:** (`string`): Unique identifier of the vector and metadata to delete
105
+ **id** (`string`): Unique identifier of the vector and metadata to delete
106
106
 
107
107
  ## Response Types
108
108
 
@@ -37,23 +37,27 @@ const text = await voice.listen(audioStream)
37
37
 
38
38
  ### Constructor Options
39
39
 
40
- **speechModel?:** (`AzureSpeechConfig`): Configuration for text-to-speech synthesis.
40
+ **speechModel** (`AzureSpeechConfig`): Configuration for text-to-speech synthesis.
41
41
 
42
- **listeningModel?:** (`AzureSpeechConfig`): Configuration for speech-to-text recognition.
42
+ **speechModel.apiKey** (`string`): Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE\_API\_KEY environment variable.
43
43
 
44
- **speaker?:** (`string`): Default voice ID for speech synthesis.
44
+ **speechModel.region** (`string`): Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE\_REGION environment variable.
45
45
 
46
- ### AzureSpeechConfig
46
+ **speechModel.voiceName** (`string`): Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.
47
47
 
48
- Configuration object for speech synthesis (`speechModel`) and recognition (`listeningModel`).
48
+ **speechModel.language** (`string`): Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.
49
49
 
50
- **apiKey?:** (`string`): Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE\_API\_KEY environment variable.
50
+ **listeningModel** (`AzureSpeechConfig`): Configuration for speech-to-text recognition.
51
51
 
52
- **region?:** (`string`): Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE\_REGION environment variable.
52
+ **listeningModel.apiKey** (`string`): Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE\_API\_KEY environment variable.
53
53
 
54
- **voiceName?:** (`string`): Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.
54
+ **listeningModel.region** (`string`): Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE\_REGION environment variable.
55
55
 
56
- **language?:** (`string`): Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.
56
+ **listeningModel.voiceName** (`string`): Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.
57
+
58
+ **listeningModel.language** (`string`): Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.
59
+
60
+ **speaker** (`string`): Default voice ID for speech synthesis.
57
61
 
58
62
  ## Methods
59
63
 
@@ -61,9 +65,9 @@ Configuration object for speech synthesis (`speechModel`) and recognition (`list
61
65
 
62
66
  Converts text to speech using Azure's neural text-to-speech service.
63
67
 
64
- **input:** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
68
+ **input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
65
69
 
66
- **options.speaker?:** (`string`): Voice ID to use for speech synthesis (e.g., 'en-US-JennyNeural'). Overrides the default voice. (Default: `Constructor's speaker value`)
70
+ **options.speaker** (`string`): Voice ID to use for speech synthesis (e.g., 'en-US-JennyNeural'). Overrides the default voice. (Default: `Constructor's speaker value`)
67
71
 
68
72
  Returns: `Promise<NodeJS.ReadableStream>` - Audio stream in WAV format
69
73
 
@@ -71,7 +75,7 @@ Returns: `Promise<NodeJS.ReadableStream>` - Audio stream in WAV format
71
75
 
72
76
  Transcribes audio using Azure's speech-to-text service.
73
77
 
74
- **audioStream:** (`NodeJS.ReadableStream`): Audio stream to transcribe. Must be in WAV format.
78
+ **audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe. Must be in WAV format.
75
79
 
76
80
  Returns: `Promise<string>` - The recognized text from the audio
77
81
 
@@ -81,11 +85,11 @@ Returns: `Promise<string>` - The recognized text from the audio
81
85
 
82
86
  Returns an array of available voice options (200+ voices), where each node contains:
83
87
 
84
- **voiceId:** (`string`): Unique identifier for the voice (e.g., 'en-US-JennyNeural', 'fr-FR-DeniseNeural')
88
+ **voiceId** (`string`): Unique identifier for the voice (e.g., 'en-US-JennyNeural', 'fr-FR-DeniseNeural')
85
89
 
86
- **language:** (`string`): Language code extracted from voice ID (e.g., 'en', 'fr')
90
+ **language** (`string`): Language code extracted from voice ID (e.g., 'en', 'fr')
87
91
 
88
- **region:** (`string`): Region code extracted from voice ID (e.g., 'US', 'GB', 'FR')
92
+ **region** (`string`): Region code extracted from voice ID (e.g., 'US', 'GB', 'FR')
89
93
 
90
94
  Returns: `Promise<Array<{ voiceId: string; language: string; region: string; }>>`
91
95
 
@@ -31,17 +31,15 @@ console.log(speakers)
31
31
 
32
32
  ### Constructor Options
33
33
 
34
- **speechModel?:** (`CloudflareSpeechConfig`): Configuration for text-to-speech synthesis.
34
+ **speechModel** (`CloudflareSpeechConfig`): Configuration for text-to-speech synthesis.
35
35
 
36
- **speaker?:** (`string`): Default voice ID for speech synthesis. (Default: `'en-US-1'`)
36
+ **speechModel.name** (`string`): Model name to use for TTS.
37
37
 
38
- ### CloudflareSpeechConfig
38
+ **speechModel.apiKey** (`string`): Cloudflare API token with Workers AI access. Falls back to CLOUDFLARE\_API\_TOKEN environment variable.
39
39
 
40
- **name?:** (`string`): Model name to use for TTS. (Default: `'@cf/meta/m2m100-1.2b'`)
40
+ **speechModel.accountId** (`string`): Cloudflare account ID. Falls back to CLOUDFLARE\_ACCOUNT\_ID environment variable.
41
41
 
42
- **apiKey?:** (`string`): Cloudflare API token with Workers AI access. Falls back to CLOUDFLARE\_API\_TOKEN environment variable.
43
-
44
- **accountId?:** (`string`): Cloudflare account ID. Falls back to CLOUDFLARE\_ACCOUNT\_ID environment variable.
42
+ **speaker** (`string`): Default voice ID for speech synthesis. (Default: `'en-US-1'`)
45
43
 
46
44
  ## Methods
47
45
 
@@ -49,11 +47,11 @@ console.log(speakers)
49
47
 
50
48
  Converts text to speech using Cloudflare's text-to-speech service.
51
49
 
52
- **input:** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
50
+ **input** (`string | NodeJS.ReadableStream`): Text or text stream to convert to speech.
53
51
 
54
- **options.speaker?:** (`string`): Voice ID to use for speech synthesis. (Default: `Constructor's speaker value`)
52
+ **options.speaker** (`string`): Voice ID to use for speech synthesis. (Default: `Constructor's speaker value`)
55
53
 
56
- **options.format?:** (`string`): Output audio format. (Default: `'mp3'`)
54
+ **options.format** (`string`): Output audio format. (Default: `'mp3'`)
57
55
 
58
56
  Returns: `Promise<NodeJS.ReadableStream>`
59
57
 
@@ -61,9 +59,9 @@ Returns: `Promise<NodeJS.ReadableStream>`
61
59
 
62
60
  Returns an array of available voice options, where each node contains:
63
61
 
64
- **voiceId:** (`string`): Unique identifier for the voice (e.g., 'en-US-1')
62
+ **voiceId** (`string`): Unique identifier for the voice (e.g., 'en-US-1')
65
63
 
66
- **language:** (`string`): Language code of the voice (e.g., 'en-US')
64
+ **language** (`string`): Language code of the voice (e.g., 'en-US')
67
65
 
68
66
  ## Notes
69
67
 
@@ -6,13 +6,13 @@ CompositeVoice supports both Mastra voice providers and AI SDK model providers
6
6
 
7
7
  ## Constructor Parameters
8
8
 
9
- **config:** (`object`): Configuration object for the composite voice service
9
+ **config** (`object`): Configuration object for the composite voice service
10
10
 
11
- **config.input?:** (`MastraVoice | TranscriptionModel`): Voice provider or AI SDK transcription model to use for speech-to-text operations. AI SDK models are automatically wrapped.
11
+ **config.input** (`MastraVoice | TranscriptionModel`): Voice provider or AI SDK transcription model to use for speech-to-text operations. AI SDK models are automatically wrapped.
12
12
 
13
- **config.output?:** (`MastraVoice | SpeechModel`): Voice provider or AI SDK speech model to use for text-to-speech operations. AI SDK models are automatically wrapped.
13
+ **config.output** (`MastraVoice | SpeechModel`): Voice provider or AI SDK speech model to use for text-to-speech operations. AI SDK models are automatically wrapped.
14
14
 
15
- **config.realtime?:** (`MastraVoice`): Voice provider to use for real-time speech-to-speech operations
15
+ **config.realtime** (`MastraVoice`): Voice provider to use for real-time speech-to-speech operations
16
16
 
17
17
  ## Methods
18
18
 
@@ -20,9 +20,9 @@ CompositeVoice supports both Mastra voice providers and AI SDK model providers
20
20
 
21
21
  Converts text to speech using the configured speaking provider.
22
22
 
23
- **input:** (`string | NodeJS.ReadableStream`): Text to convert to speech
23
+ **input** (`string | NodeJS.ReadableStream`): Text to convert to speech
24
24
 
25
- **options?:** (`object`): Provider-specific options passed to the speaking provider
25
+ **options** (`object`): Provider-specific options passed to the speaking provider
26
26
 
27
27
  Notes:
28
28
 
@@ -34,9 +34,9 @@ Notes:
34
34
 
35
35
  Converts speech to text using the configured listening provider.
36
36
 
37
- **audioStream:** (`NodeJS.ReadableStream`): Audio stream to convert to text
37
+ **audioStream** (`NodeJS.ReadableStream`): Audio stream to convert to text
38
38
 
39
- **options?:** (`object`): Provider-specific options passed to the listening provider
39
+ **options** (`object`): Provider-specific options passed to the listening provider
40
40
 
41
41
  Notes:
42
42
 
@@ -48,9 +48,9 @@ Notes:
48
48
 
49
49
  Returns a list of available voices from the speaking provider, where each node contains:
50
50
 
51
- **voiceId:** (`string`): Unique identifier for the voice
51
+ **voiceId** (`string`): Unique identifier for the voice
52
52
 
53
- **key?:** (`value`): Additional voice properties that vary by provider (e.g., name, language)
53
+ **key** (`value`): Additional voice properties that vary by provider (e.g., name, language)
54
54
 
55
55
  Notes:
56
56
 
@@ -32,21 +32,27 @@ const transcript = await voice.listen(audioStream)
32
32
 
33
33
  ## Constructor Parameters
34
34
 
35
- **speechModel?:** (`DeepgramVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'aura' }`)
35
+ **speechModel** (`DeepgramVoiceConfig`): Configuration for text-to-speech functionality. (Default: `{ name: 'aura' }`)
36
36
 
37
- **listeningModel?:** (`DeepgramVoiceConfig`): Configuration for speech-to-text functionality. (Default: `{ name: 'nova' }`)
37
+ **speechModel.name** (`DeepgramModel`): The Deepgram model to use
38
38
 
39
- **speaker?:** (`DeepgramVoiceId`): Default voice to use for text-to-speech (Default: `'asteria-en'`)
39
+ **speechModel.apiKey** (`string`): Deepgram API key. Falls back to DEEPGRAM\_API\_KEY environment variable
40
40
 
41
- ### DeepgramVoiceConfig
41
+ **speechModel.properties** (`Record<string, any>`): Additional properties to pass to the Deepgram API
42
42
 
43
- **name?:** (`DeepgramModel`): The Deepgram model to use
43
+ **speechModel.language** (`string`): Language code for the model
44
44
 
45
- **apiKey?:** (`string`): Deepgram API key. Falls back to DEEPGRAM\_API\_KEY environment variable
45
+ **listeningModel** (`DeepgramVoiceConfig`): Configuration for speech-to-text functionality. (Default: `{ name: 'nova' }`)
46
46
 
47
- **properties?:** (`Record<string, any>`): Additional properties to pass to the Deepgram API
47
+ **listeningModel.name** (`DeepgramModel`): The Deepgram model to use
48
48
 
49
- **language?:** (`string`): Language code for the model
49
+ **listeningModel.apiKey** (`string`): Deepgram API key. Falls back to DEEPGRAM\_API\_KEY environment variable
50
+
51
+ **listeningModel.properties** (`Record<string, any>`): Additional properties to pass to the Deepgram API
52
+
53
+ **listeningModel.language** (`string`): Language code for the model
54
+
55
+ **speaker** (`DeepgramVoiceId`): Default voice to use for text-to-speech (Default: `'asteria-en'`)
50
56
 
51
57
  ## Methods
52
58
 
@@ -54,11 +60,11 @@ const transcript = await voice.listen(audioStream)
54
60
 
55
61
  Converts text to speech using the configured speech model and voice.
56
62
 
57
- **input:** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
63
+ **input** (`string | NodeJS.ReadableStream`): Text to convert to speech. If a stream is provided, it will be converted to text first.
58
64
 
59
- **options?:** (`object`): Additional options for speech synthesis
65
+ **options** (`object`): Additional options for speech synthesis
60
66
 
61
- **options.speaker?:** (`string`): Override the default speaker for this request
67
+ **options.speaker** (`string`): Override the default speaker for this request
62
68
 
63
69
  Returns: `Promise<NodeJS.ReadableStream>`
64
70
 
@@ -66,9 +72,9 @@ Returns: `Promise<NodeJS.ReadableStream>`
66
72
 
67
73
  Converts speech to text using the configured listening model.
68
74
 
69
- **audioStream:** (`NodeJS.ReadableStream`): Audio stream to transcribe
75
+ **audioStream** (`NodeJS.ReadableStream`): Audio stream to transcribe
70
76
 
71
- **options?:** (`object`): Additional options to pass to the Deepgram API
77
+ **options** (`object`): Additional options to pass to the Deepgram API
72
78
 
73
79
  Returns: `Promise<string>`
74
80
 
@@ -76,4 +82,4 @@ Returns: `Promise<string>`
76
82
 
77
83
  Returns a list of available voice options.
78
84
 
79
- **voiceId:** (`string`): Unique identifier for the voice
85
+ **voiceId** (`string`): Unique identifier for the voice