@mastra/mcp-docs-server 0.13.37-alpha.1 → 0.13.38

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 (403) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +4 -0
  2. package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +4 -0
  3. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +15 -15
  4. package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +4 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +9 -9
  6. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +10 -10
  7. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +30 -30
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +116 -116
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +25 -25
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +25 -25
  11. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +27 -27
  12. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +25 -25
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +37 -37
  14. package/.docs/organized/changelogs/%40mastra%2Flance.md +10 -10
  15. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +22 -22
  16. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +9 -9
  17. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +31 -31
  18. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +44 -44
  19. package/.docs/organized/changelogs/%40mastra%2Freact.md +22 -22
  20. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +12 -0
  21. package/.docs/organized/changelogs/%40mastra%2Fserver.md +30 -30
  22. package/.docs/organized/changelogs/create-mastra.md +11 -11
  23. package/.docs/organized/changelogs/mastra.md +33 -33
  24. package/.docs/raw/agents/adding-voice.mdx +20 -9
  25. package/.docs/raw/agents/agent-memory.mdx +55 -39
  26. package/.docs/raw/agents/guardrails.mdx +68 -61
  27. package/.docs/raw/agents/networks.mdx +50 -46
  28. package/.docs/raw/agents/overview.mdx +125 -88
  29. package/.docs/raw/agents/using-tools.mdx +14 -15
  30. package/.docs/raw/auth/auth0.mdx +28 -27
  31. package/.docs/raw/auth/clerk.mdx +22 -20
  32. package/.docs/raw/auth/firebase.mdx +42 -39
  33. package/.docs/raw/auth/index.mdx +1 -1
  34. package/.docs/raw/auth/jwt.mdx +18 -16
  35. package/.docs/raw/auth/supabase.mdx +20 -18
  36. package/.docs/raw/auth/workos.mdx +32 -26
  37. package/.docs/raw/community/contributing-templates.mdx +7 -7
  38. package/.docs/raw/community/discord.mdx +2 -2
  39. package/.docs/raw/community/licensing.mdx +1 -1
  40. package/.docs/raw/course/03-agent-memory/26-updating-mastra-export-comprehensive.md +0 -32
  41. package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx +41 -22
  42. package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx +48 -29
  43. package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx +52 -24
  44. package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx +86 -55
  45. package/.docs/raw/deployment/cloud-providers/index.mdx +16 -13
  46. package/.docs/raw/deployment/monorepo.mdx +32 -42
  47. package/.docs/raw/deployment/overview.mdx +15 -15
  48. package/.docs/raw/deployment/server-deployment.mdx +18 -23
  49. package/.docs/raw/deployment/serverless-platforms/cloudflare-deployer.mdx +16 -17
  50. package/.docs/raw/deployment/serverless-platforms/index.mdx +15 -12
  51. package/.docs/raw/deployment/serverless-platforms/netlify-deployer.mdx +14 -23
  52. package/.docs/raw/deployment/serverless-platforms/vercel-deployer.mdx +16 -23
  53. package/.docs/raw/deployment/web-framework.mdx +14 -14
  54. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +138 -145
  55. package/.docs/raw/frameworks/agentic-uis/assistant-ui.mdx +54 -43
  56. package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx +51 -36
  57. package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx +161 -120
  58. package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +59 -48
  59. package/.docs/raw/frameworks/servers/express.mdx +45 -44
  60. package/.docs/raw/frameworks/web-frameworks/astro.mdx +245 -162
  61. package/.docs/raw/frameworks/web-frameworks/next-js.mdx +112 -69
  62. package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx +189 -164
  63. package/.docs/raw/frameworks/web-frameworks/vite-react.mdx +94 -81
  64. package/.docs/raw/getting-started/installation.mdx +164 -133
  65. package/.docs/raw/getting-started/mcp-docs-server.mdx +36 -39
  66. package/.docs/raw/getting-started/project-structure.mdx +34 -42
  67. package/.docs/raw/getting-started/studio.mdx +40 -58
  68. package/.docs/raw/getting-started/templates.mdx +22 -27
  69. package/.docs/raw/index.mdx +9 -9
  70. package/.docs/raw/mastra-cloud/dashboard.mdx +10 -10
  71. package/.docs/raw/mastra-cloud/observability.mdx +7 -8
  72. package/.docs/raw/mastra-cloud/overview.mdx +16 -22
  73. package/.docs/raw/mastra-cloud/setting-up.mdx +33 -20
  74. package/.docs/raw/memory/conversation-history.mdx +2 -2
  75. package/.docs/raw/memory/overview.mdx +21 -23
  76. package/.docs/raw/memory/semantic-recall.mdx +14 -13
  77. package/.docs/raw/memory/storage/memory-with-libsql.mdx +27 -28
  78. package/.docs/raw/memory/storage/memory-with-pg.mdx +26 -26
  79. package/.docs/raw/memory/storage/memory-with-upstash.mdx +26 -27
  80. package/.docs/raw/memory/threads-and-resources.mdx +23 -20
  81. package/.docs/raw/memory/working-memory.mdx +27 -38
  82. package/.docs/raw/observability/ai-tracing/exporters/arize.mdx +30 -29
  83. package/.docs/raw/observability/ai-tracing/exporters/braintrust.mdx +8 -9
  84. package/.docs/raw/observability/ai-tracing/exporters/cloud.mdx +17 -16
  85. package/.docs/raw/observability/ai-tracing/exporters/default.mdx +31 -32
  86. package/.docs/raw/observability/ai-tracing/exporters/langfuse.mdx +18 -17
  87. package/.docs/raw/observability/ai-tracing/exporters/langsmith.mdx +14 -14
  88. package/.docs/raw/observability/ai-tracing/exporters/otel.mdx +56 -46
  89. package/.docs/raw/observability/ai-tracing/overview.mdx +145 -122
  90. package/.docs/raw/observability/ai-tracing/processors/sensitive-data-filter.mdx +57 -36
  91. package/.docs/raw/observability/logging.mdx +14 -17
  92. package/.docs/raw/observability/nextjs-tracing.mdx +5 -5
  93. package/.docs/raw/observability/otel-tracing.mdx +17 -18
  94. package/.docs/raw/observability/overview.mdx +14 -10
  95. package/.docs/raw/rag/chunking-and-embedding.mdx +10 -8
  96. package/.docs/raw/rag/overview.mdx +5 -5
  97. package/.docs/raw/rag/retrieval.mdx +125 -107
  98. package/.docs/raw/rag/vector-databases.mdx +232 -223
  99. package/.docs/raw/reference/agents/agent.mdx +54 -41
  100. package/.docs/raw/reference/agents/generate.mdx +367 -261
  101. package/.docs/raw/reference/agents/generateLegacy.mdx +260 -178
  102. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +7 -5
  103. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +7 -5
  104. package/.docs/raw/reference/agents/getDescription.mdx +3 -2
  105. package/.docs/raw/reference/agents/getInstructions.mdx +7 -5
  106. package/.docs/raw/reference/agents/getLLM.mdx +11 -7
  107. package/.docs/raw/reference/agents/getMemory.mdx +7 -5
  108. package/.docs/raw/reference/agents/getModel.mdx +7 -5
  109. package/.docs/raw/reference/agents/getScorers.mdx +7 -5
  110. package/.docs/raw/reference/agents/getTools.mdx +7 -5
  111. package/.docs/raw/reference/agents/getVoice.mdx +7 -5
  112. package/.docs/raw/reference/agents/getWorkflows.mdx +7 -5
  113. package/.docs/raw/reference/agents/listAgents.mdx +6 -4
  114. package/.docs/raw/reference/agents/network.mdx +171 -116
  115. package/.docs/raw/reference/auth/auth0.mdx +18 -14
  116. package/.docs/raw/reference/auth/clerk.mdx +15 -12
  117. package/.docs/raw/reference/auth/firebase.mdx +23 -16
  118. package/.docs/raw/reference/auth/jwt.mdx +7 -6
  119. package/.docs/raw/reference/auth/supabase.mdx +13 -10
  120. package/.docs/raw/reference/auth/workos.mdx +17 -13
  121. package/.docs/raw/reference/cli/create-mastra.mdx +61 -44
  122. package/.docs/raw/reference/cli/mastra.mdx +11 -11
  123. package/.docs/raw/reference/client-js/agents.mdx +40 -43
  124. package/.docs/raw/reference/client-js/error-handling.mdx +1 -1
  125. package/.docs/raw/reference/client-js/logs.mdx +1 -1
  126. package/.docs/raw/reference/client-js/mastra-client.mdx +21 -13
  127. package/.docs/raw/reference/client-js/memory.mdx +6 -2
  128. package/.docs/raw/reference/client-js/observability.mdx +10 -9
  129. package/.docs/raw/reference/client-js/telemetry.mdx +1 -1
  130. package/.docs/raw/reference/client-js/tools.mdx +1 -1
  131. package/.docs/raw/reference/client-js/vectors.mdx +1 -1
  132. package/.docs/raw/reference/client-js/workflows-legacy.mdx +1 -1
  133. package/.docs/raw/reference/client-js/workflows.mdx +7 -7
  134. package/.docs/raw/reference/core/getAgent.mdx +6 -5
  135. package/.docs/raw/reference/core/getAgentById.mdx +5 -4
  136. package/.docs/raw/reference/core/getAgents.mdx +3 -3
  137. package/.docs/raw/reference/core/getDeployer.mdx +4 -3
  138. package/.docs/raw/reference/core/getLogger.mdx +4 -3
  139. package/.docs/raw/reference/core/getLogs.mdx +10 -6
  140. package/.docs/raw/reference/core/getLogsByRunId.mdx +8 -5
  141. package/.docs/raw/reference/core/getMCPServer.mdx +8 -5
  142. package/.docs/raw/reference/core/getMCPServers.mdx +4 -3
  143. package/.docs/raw/reference/core/getMemory.mdx +4 -3
  144. package/.docs/raw/reference/core/getScorer.mdx +15 -12
  145. package/.docs/raw/reference/core/getScorerByName.mdx +12 -9
  146. package/.docs/raw/reference/core/getScorers.mdx +3 -2
  147. package/.docs/raw/reference/core/getServer.mdx +4 -3
  148. package/.docs/raw/reference/core/getStorage.mdx +4 -3
  149. package/.docs/raw/reference/core/getTelemetry.mdx +4 -3
  150. package/.docs/raw/reference/core/getVector.mdx +6 -4
  151. package/.docs/raw/reference/core/getVectors.mdx +4 -3
  152. package/.docs/raw/reference/core/getWorkflow.mdx +7 -4
  153. package/.docs/raw/reference/core/getWorkflows.mdx +5 -3
  154. package/.docs/raw/reference/core/mastra-class.mdx +16 -16
  155. package/.docs/raw/reference/core/setLogger.mdx +6 -4
  156. package/.docs/raw/reference/core/setStorage.mdx +4 -4
  157. package/.docs/raw/reference/core/setTelemetry.mdx +4 -3
  158. package/.docs/raw/reference/deployer/cloudflare.mdx +11 -7
  159. package/.docs/raw/reference/deployer/deployer.mdx +2 -1
  160. package/.docs/raw/reference/deployer/netlify.mdx +4 -4
  161. package/.docs/raw/reference/deployer/vercel.mdx +6 -6
  162. package/.docs/raw/reference/evals/answer-relevancy.mdx +4 -5
  163. package/.docs/raw/reference/evals/bias.mdx +4 -5
  164. package/.docs/raw/reference/evals/completeness.mdx +4 -5
  165. package/.docs/raw/reference/evals/content-similarity.mdx +4 -5
  166. package/.docs/raw/reference/evals/context-position.mdx +4 -5
  167. package/.docs/raw/reference/evals/context-precision.mdx +4 -5
  168. package/.docs/raw/reference/evals/context-relevancy.mdx +4 -5
  169. package/.docs/raw/reference/evals/contextual-recall.mdx +4 -5
  170. package/.docs/raw/reference/evals/faithfulness.mdx +4 -5
  171. package/.docs/raw/reference/evals/hallucination.mdx +4 -6
  172. package/.docs/raw/reference/evals/keyword-coverage.mdx +4 -5
  173. package/.docs/raw/reference/evals/prompt-alignment.mdx +4 -6
  174. package/.docs/raw/reference/evals/summarization.mdx +4 -6
  175. package/.docs/raw/reference/evals/textual-difference.mdx +4 -5
  176. package/.docs/raw/reference/evals/tone-consistency.mdx +4 -7
  177. package/.docs/raw/reference/evals/toxicity.mdx +4 -5
  178. package/.docs/raw/reference/index.mdx +3 -3
  179. package/.docs/raw/reference/legacyWorkflows/after.mdx +5 -5
  180. package/.docs/raw/reference/legacyWorkflows/afterEvent.mdx +5 -5
  181. package/.docs/raw/reference/legacyWorkflows/commit.mdx +5 -5
  182. package/.docs/raw/reference/legacyWorkflows/createRun.mdx +4 -4
  183. package/.docs/raw/reference/legacyWorkflows/else.mdx +5 -5
  184. package/.docs/raw/reference/legacyWorkflows/events.mdx +7 -7
  185. package/.docs/raw/reference/legacyWorkflows/execute.mdx +4 -4
  186. package/.docs/raw/reference/legacyWorkflows/if.mdx +5 -5
  187. package/.docs/raw/reference/legacyWorkflows/resume.mdx +5 -5
  188. package/.docs/raw/reference/legacyWorkflows/resumeWithEvent.mdx +6 -6
  189. package/.docs/raw/reference/legacyWorkflows/snapshots.mdx +6 -6
  190. package/.docs/raw/reference/legacyWorkflows/start.mdx +6 -6
  191. package/.docs/raw/reference/legacyWorkflows/step-class.mdx +4 -4
  192. package/.docs/raw/reference/legacyWorkflows/step-condition.mdx +4 -4
  193. package/.docs/raw/reference/legacyWorkflows/step-function.mdx +5 -5
  194. package/.docs/raw/reference/legacyWorkflows/step-options.mdx +6 -6
  195. package/.docs/raw/reference/legacyWorkflows/step-retries.mdx +4 -4
  196. package/.docs/raw/reference/legacyWorkflows/suspend.mdx +4 -4
  197. package/.docs/raw/reference/legacyWorkflows/then.mdx +5 -5
  198. package/.docs/raw/reference/legacyWorkflows/until.mdx +4 -4
  199. package/.docs/raw/reference/legacyWorkflows/watch.mdx +3 -3
  200. package/.docs/raw/reference/legacyWorkflows/while.mdx +4 -4
  201. package/.docs/raw/reference/legacyWorkflows/workflow.mdx +7 -7
  202. package/.docs/raw/reference/memory/createThread.mdx +10 -10
  203. package/.docs/raw/reference/memory/deleteMessages.mdx +7 -5
  204. package/.docs/raw/reference/memory/getThreadById.mdx +6 -5
  205. package/.docs/raw/reference/memory/getThreadsByResourceId.mdx +11 -10
  206. package/.docs/raw/reference/memory/getThreadsByResourceIdPaginated.mdx +10 -9
  207. package/.docs/raw/reference/memory/{Memory.mdx → memory-class.mdx} +53 -46
  208. package/.docs/raw/reference/memory/query.mdx +39 -25
  209. package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx +9 -5
  210. package/.docs/raw/reference/observability/ai-tracing/configuration.mdx +26 -22
  211. package/.docs/raw/reference/observability/ai-tracing/exporters/arize.mdx +16 -12
  212. package/.docs/raw/reference/observability/ai-tracing/exporters/braintrust.mdx +14 -14
  213. package/.docs/raw/reference/observability/ai-tracing/exporters/cloud-exporter.mdx +16 -11
  214. package/.docs/raw/reference/observability/ai-tracing/exporters/console-exporter.mdx +10 -6
  215. package/.docs/raw/reference/observability/ai-tracing/exporters/default-exporter.mdx +23 -15
  216. package/.docs/raw/reference/observability/ai-tracing/exporters/langfuse.mdx +6 -6
  217. package/.docs/raw/reference/observability/ai-tracing/exporters/langsmith.mdx +13 -13
  218. package/.docs/raw/reference/observability/ai-tracing/exporters/otel.mdx +44 -36
  219. package/.docs/raw/reference/observability/ai-tracing/interfaces.mdx +115 -106
  220. package/.docs/raw/reference/observability/ai-tracing/processors/sensitive-data-filter.mdx +37 -32
  221. package/.docs/raw/reference/observability/ai-tracing/span.mdx +29 -26
  222. package/.docs/raw/reference/observability/logging/pino-logger.mdx +13 -15
  223. package/.docs/raw/reference/observability/otel-tracing/otel-config.mdx +2 -2
  224. package/.docs/raw/reference/observability/otel-tracing/providers/arize-ax.mdx +3 -3
  225. package/.docs/raw/reference/observability/otel-tracing/providers/arize-phoenix.mdx +2 -1
  226. package/.docs/raw/reference/observability/otel-tracing/providers/dash0.mdx +1 -1
  227. package/.docs/raw/reference/observability/otel-tracing/providers/index.mdx +12 -14
  228. package/.docs/raw/reference/observability/otel-tracing/providers/keywordsai.mdx +3 -3
  229. package/.docs/raw/reference/observability/otel-tracing/providers/laminar.mdx +1 -1
  230. package/.docs/raw/reference/observability/otel-tracing/providers/langfuse.mdx +4 -4
  231. package/.docs/raw/reference/observability/otel-tracing/providers/langsmith.mdx +1 -1
  232. package/.docs/raw/reference/observability/otel-tracing/providers/langwatch.mdx +2 -2
  233. package/.docs/raw/reference/observability/otel-tracing/providers/new-relic.mdx +1 -1
  234. package/.docs/raw/reference/observability/otel-tracing/providers/signoz.mdx +1 -1
  235. package/.docs/raw/reference/observability/otel-tracing/providers/traceloop.mdx +1 -1
  236. package/.docs/raw/reference/processors/batch-parts-processor.mdx +13 -10
  237. package/.docs/raw/reference/processors/language-detector.mdx +27 -17
  238. package/.docs/raw/reference/processors/moderation-processor.mdx +26 -17
  239. package/.docs/raw/reference/processors/pii-detector.mdx +28 -18
  240. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +25 -17
  241. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +26 -17
  242. package/.docs/raw/reference/processors/token-limiter-processor.mdx +22 -15
  243. package/.docs/raw/reference/processors/unicode-normalizer.mdx +13 -12
  244. package/.docs/raw/reference/rag/chunk.mdx +41 -23
  245. package/.docs/raw/reference/rag/database-config.mdx +56 -38
  246. package/.docs/raw/reference/rag/document.mdx +1 -1
  247. package/.docs/raw/reference/rag/embeddings.mdx +1 -1
  248. package/.docs/raw/reference/rag/extract-params.mdx +1 -1
  249. package/.docs/raw/reference/rag/graph-rag.mdx +1 -1
  250. package/.docs/raw/reference/rag/metadata-filters.mdx +23 -26
  251. package/.docs/raw/reference/rag/rerank.mdx +1 -1
  252. package/.docs/raw/reference/rag/rerankWithScorer.mdx +2 -2
  253. package/.docs/raw/reference/scorers/answer-relevancy.mdx +35 -17
  254. package/.docs/raw/reference/scorers/answer-similarity.mdx +84 -68
  255. package/.docs/raw/reference/scorers/bias.mdx +22 -19
  256. package/.docs/raw/reference/scorers/completeness.mdx +21 -16
  257. package/.docs/raw/reference/scorers/content-similarity.mdx +12 -10
  258. package/.docs/raw/reference/scorers/context-precision.mdx +73 -64
  259. package/.docs/raw/reference/scorers/context-relevance.mdx +142 -126
  260. package/.docs/raw/reference/scorers/create-scorer.mdx +93 -61
  261. package/.docs/raw/reference/scorers/faithfulness.mdx +21 -13
  262. package/.docs/raw/reference/scorers/hallucination.mdx +17 -12
  263. package/.docs/raw/reference/scorers/keyword-coverage.mdx +32 -27
  264. package/.docs/raw/reference/scorers/mastra-scorer.mdx +39 -33
  265. package/.docs/raw/reference/scorers/noise-sensitivity.mdx +203 -152
  266. package/.docs/raw/reference/scorers/prompt-alignment.mdx +186 -132
  267. package/.docs/raw/reference/scorers/run-experiment.mdx +40 -31
  268. package/.docs/raw/reference/scorers/textual-difference.mdx +25 -26
  269. package/.docs/raw/reference/scorers/tone-consistency.mdx +29 -26
  270. package/.docs/raw/reference/scorers/tool-call-accuracy.mdx +180 -176
  271. package/.docs/raw/reference/scorers/toxicity.mdx +35 -31
  272. package/.docs/raw/reference/storage/cloudflare-d1.mdx +1 -1
  273. package/.docs/raw/reference/storage/cloudflare.mdx +1 -1
  274. package/.docs/raw/reference/storage/dynamodb.mdx +1 -1
  275. package/.docs/raw/reference/storage/lance.mdx +1 -1
  276. package/.docs/raw/reference/storage/libsql.mdx +2 -2
  277. package/.docs/raw/reference/storage/mongodb.mdx +4 -5
  278. package/.docs/raw/reference/storage/mssql.mdx +5 -4
  279. package/.docs/raw/reference/storage/postgresql.mdx +35 -33
  280. package/.docs/raw/reference/storage/upstash.mdx +6 -5
  281. package/.docs/raw/reference/streaming/ChunkType.mdx +788 -314
  282. package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx +265 -109
  283. package/.docs/raw/reference/streaming/agents/stream.mdx +375 -266
  284. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +233 -162
  285. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +4 -4
  286. package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx +5 -5
  287. package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx +24 -20
  288. package/.docs/raw/reference/streaming/workflows/stream.mdx +35 -26
  289. package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +36 -27
  290. package/.docs/raw/reference/templates/overview.mdx +16 -39
  291. package/.docs/raw/reference/tools/client.mdx +1 -1
  292. package/.docs/raw/reference/tools/create-tool.mdx +45 -35
  293. package/.docs/raw/reference/tools/document-chunker-tool.mdx +2 -2
  294. package/.docs/raw/reference/tools/graph-rag-tool.mdx +12 -12
  295. package/.docs/raw/reference/tools/mcp-client.mdx +70 -64
  296. package/.docs/raw/reference/tools/mcp-server.mdx +91 -78
  297. package/.docs/raw/reference/tools/vector-query-tool.mdx +48 -38
  298. package/.docs/raw/reference/vectors/astra.mdx +1 -1
  299. package/.docs/raw/reference/vectors/chroma.mdx +25 -19
  300. package/.docs/raw/reference/vectors/couchbase.mdx +4 -4
  301. package/.docs/raw/reference/vectors/lance.mdx +5 -6
  302. package/.docs/raw/reference/vectors/libsql.mdx +1 -1
  303. package/.docs/raw/reference/vectors/mongodb.mdx +1 -1
  304. package/.docs/raw/reference/vectors/opensearch.mdx +1 -1
  305. package/.docs/raw/reference/vectors/pg.mdx +8 -4
  306. package/.docs/raw/reference/vectors/pinecone.mdx +1 -1
  307. package/.docs/raw/reference/vectors/qdrant.mdx +1 -1
  308. package/.docs/raw/reference/vectors/s3vectors.mdx +35 -27
  309. package/.docs/raw/reference/vectors/turbopuffer.mdx +1 -1
  310. package/.docs/raw/reference/vectors/upstash.mdx +33 -25
  311. package/.docs/raw/reference/vectors/vectorize.mdx +1 -1
  312. package/.docs/raw/reference/voice/azure.mdx +1 -1
  313. package/.docs/raw/reference/voice/cloudflare.mdx +1 -1
  314. package/.docs/raw/reference/voice/composite-voice.mdx +1 -1
  315. package/.docs/raw/reference/voice/deepgram.mdx +1 -1
  316. package/.docs/raw/reference/voice/elevenlabs.mdx +1 -1
  317. package/.docs/raw/reference/voice/google-gemini-live.mdx +6 -4
  318. package/.docs/raw/reference/voice/google.mdx +1 -1
  319. package/.docs/raw/reference/voice/mastra-voice.mdx +1 -1
  320. package/.docs/raw/reference/voice/murf.mdx +1 -1
  321. package/.docs/raw/reference/voice/openai-realtime.mdx +1 -1
  322. package/.docs/raw/reference/voice/openai.mdx +1 -1
  323. package/.docs/raw/reference/voice/playai.mdx +1 -1
  324. package/.docs/raw/reference/voice/sarvam.mdx +1 -1
  325. package/.docs/raw/reference/voice/speechify.mdx +1 -1
  326. package/.docs/raw/reference/voice/voice.addInstructions.mdx +1 -1
  327. package/.docs/raw/reference/voice/voice.addTools.mdx +1 -1
  328. package/.docs/raw/reference/voice/voice.answer.mdx +1 -1
  329. package/.docs/raw/reference/voice/voice.close.mdx +1 -1
  330. package/.docs/raw/reference/voice/voice.connect.mdx +1 -1
  331. package/.docs/raw/reference/voice/voice.events.mdx +1 -1
  332. package/.docs/raw/reference/voice/voice.getSpeakers.mdx +23 -30
  333. package/.docs/raw/reference/voice/voice.listen.mdx +1 -1
  334. package/.docs/raw/reference/voice/voice.off.mdx +1 -1
  335. package/.docs/raw/reference/voice/voice.on.mdx +1 -1
  336. package/.docs/raw/reference/voice/voice.send.mdx +1 -1
  337. package/.docs/raw/reference/voice/voice.speak.mdx +1 -1
  338. package/.docs/raw/reference/voice/voice.updateConfig.mdx +1 -1
  339. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +4 -3
  340. package/.docs/raw/reference/workflows/run-methods/resume.mdx +49 -34
  341. package/.docs/raw/reference/workflows/run-methods/start.mdx +43 -31
  342. package/.docs/raw/reference/workflows/run-methods/watch.mdx +7 -8
  343. package/.docs/raw/reference/workflows/run.mdx +7 -10
  344. package/.docs/raw/reference/workflows/step.mdx +15 -12
  345. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +2 -2
  346. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  347. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +7 -7
  348. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +2 -2
  349. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +2 -2
  350. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
  351. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +3 -2
  352. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  353. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +5 -5
  354. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +3 -2
  355. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +3 -2
  356. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  357. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +3 -3
  358. package/.docs/raw/reference/workflows/workflow.mdx +13 -10
  359. package/.docs/raw/scorers/custom-scorers.mdx +58 -48
  360. package/.docs/raw/scorers/evals-old-api/custom-eval.mdx +6 -8
  361. package/.docs/raw/scorers/evals-old-api/overview.mdx +8 -8
  362. package/.docs/raw/scorers/evals-old-api/running-in-ci.mdx +9 -9
  363. package/.docs/raw/scorers/evals-old-api/textual-evals.mdx +5 -5
  364. package/.docs/raw/scorers/off-the-shelf-scorers.mdx +3 -1
  365. package/.docs/raw/scorers/overview.mdx +20 -19
  366. package/.docs/raw/server-db/custom-api-routes.mdx +8 -8
  367. package/.docs/raw/server-db/mastra-client.mdx +56 -54
  368. package/.docs/raw/server-db/middleware.mdx +11 -7
  369. package/.docs/raw/server-db/production-server.mdx +5 -7
  370. package/.docs/raw/server-db/runtime-context.mdx +41 -38
  371. package/.docs/raw/server-db/storage.mdx +82 -87
  372. package/.docs/raw/streaming/events.mdx +24 -16
  373. package/.docs/raw/streaming/overview.mdx +17 -18
  374. package/.docs/raw/streaming/tool-streaming.mdx +9 -10
  375. package/.docs/raw/streaming/workflow-streaming.mdx +14 -12
  376. package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
  377. package/.docs/raw/tools-mcp/mcp-overview.mdx +92 -102
  378. package/.docs/raw/tools-mcp/overview.mdx +9 -14
  379. package/.docs/raw/voice/overview.mdx +273 -250
  380. package/.docs/raw/voice/speech-to-speech.mdx +14 -12
  381. package/.docs/raw/voice/speech-to-text.mdx +2 -2
  382. package/.docs/raw/voice/text-to-speech.mdx +2 -2
  383. package/.docs/raw/workflows/agents-and-tools.mdx +29 -28
  384. package/.docs/raw/workflows/control-flow.mdx +24 -24
  385. package/.docs/raw/workflows/error-handling.mdx +15 -17
  386. package/.docs/raw/workflows/human-in-the-loop.mdx +39 -39
  387. package/.docs/raw/workflows/inngest-workflow.mdx +33 -29
  388. package/.docs/raw/workflows/input-data-mapping.mdx +9 -9
  389. package/.docs/raw/workflows/overview.mdx +60 -60
  390. package/.docs/raw/workflows/snapshots.mdx +54 -36
  391. package/.docs/raw/workflows/suspend-and-resume.mdx +52 -57
  392. package/.docs/raw/workflows-legacy/control-flow.mdx +15 -17
  393. package/.docs/raw/workflows-legacy/dynamic-workflows.mdx +3 -1
  394. package/.docs/raw/workflows-legacy/error-handling.mdx +8 -6
  395. package/.docs/raw/workflows-legacy/nested-workflows.mdx +6 -0
  396. package/.docs/raw/workflows-legacy/overview.mdx +28 -26
  397. package/.docs/raw/workflows-legacy/runtime-variables.mdx +4 -2
  398. package/.docs/raw/workflows-legacy/steps.mdx +5 -3
  399. package/.docs/raw/workflows-legacy/suspend-and-resume.mdx +10 -8
  400. package/.docs/raw/workflows-legacy/variables.mdx +10 -8
  401. package/CHANGELOG.md +21 -0
  402. package/package.json +5 -5
  403. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -148
@@ -1,5 +1,34 @@
1
1
  # @mastra/server
2
2
 
3
+ ## 0.23.3
4
+
5
+ ### Patch Changes
6
+
7
+ - Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
8
+
9
+ - Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
10
+
11
+ - Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
12
+ - @mastra/core@0.23.3
13
+
14
+ ## 0.23.3-alpha.0
15
+
16
+ ### Patch Changes
17
+
18
+ - Make step optional in all resume APIs ([#9462](https://github.com/mastra-ai/mastra/pull/9462))
19
+
20
+ - Make step optional in resumeStreamVNext API ([#9461](https://github.com/mastra-ai/mastra/pull/9461))
21
+
22
+ - Updated dependencies [[`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3)]:
23
+ - @mastra/core@0.23.3-alpha.0
24
+
25
+ ## 0.23.2
26
+
27
+ ### Patch Changes
28
+
29
+ - Updated dependencies [[`f57a81e`](https://github.com/mastra-ai/mastra/commit/f57a81e6ce644e45bf1c9618778cc54c50a84ad4), [`2afd345`](https://github.com/mastra-ai/mastra/commit/2afd3450825b76e41f7973baddf13867ea042e40), [`fc79af3`](https://github.com/mastra-ai/mastra/commit/fc79af3915d1c456729cbd753673b0c0564340d8), [`eefc89e`](https://github.com/mastra-ai/mastra/commit/eefc89ee69f05bb71661473a807fc7dc03d56f17), [`60bd45d`](https://github.com/mastra-ai/mastra/commit/60bd45de021f0dfbe6583928f6da5169cb5585ba), [`a30093d`](https://github.com/mastra-ai/mastra/commit/a30093de98c1836dcd5dfddf09649010712b8c95), [`0fe7adb`](https://github.com/mastra-ai/mastra/commit/0fe7adb0f20f59a6bb41f235d01f8b7a880ea6e7), [`a42e496`](https://github.com/mastra-ai/mastra/commit/a42e49686a7486e2e9e9397fa98e5ff7a71dc1b0), [`3670db7`](https://github.com/mastra-ai/mastra/commit/3670db7e8e798f9d65fac5bfb732134a1f26ba7b), [`e40d4d0`](https://github.com/mastra-ai/mastra/commit/e40d4d0a0971b4505e7c9de73c656066c7565653), [`fc843ff`](https://github.com/mastra-ai/mastra/commit/fc843ff4d1d149317b6324553ce5ad7972062a78), [`ff16f9b`](https://github.com/mastra-ai/mastra/commit/ff16f9b9dbc701b26b6c4e9872f759f3880f9327), [`35e6cf7`](https://github.com/mastra-ai/mastra/commit/35e6cf722fef16ea0301eb9cf5a32fe9ccb12d22), [`30a2e36`](https://github.com/mastra-ai/mastra/commit/30a2e369485e0e59c4faa1d83c5635c2260b304c)]:
30
+ - @mastra/core@0.23.2
31
+
3
32
  ## 0.23.2-alpha.1
4
33
 
5
34
  ### Patch Changes
@@ -270,33 +299,4 @@
270
299
  - Updated dependencies [[`c621613`](https://github.com/mastra-ai/mastra/commit/c621613069173c69eb2c3ef19a5308894c6549f0), [`12b1189`](https://github.com/mastra-ai/mastra/commit/12b118942445e4de0dd916c593e33ec78dc3bc73), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`076b092`](https://github.com/mastra-ai/mastra/commit/076b0924902ff0f49d5712d2df24c4cca683713f), [`2aee9e7`](https://github.com/mastra-ai/mastra/commit/2aee9e7d188b8b256a4ddc203ccefb366b4867fa), [`c582906`](https://github.com/mastra-ai/mastra/commit/c5829065a346260f96c4beb8af131b94804ae3ad), [`fa2eb96`](https://github.com/mastra-ai/mastra/commit/fa2eb96af16c7d433891a73932764960d3235c1d), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`a739d0c`](https://github.com/mastra-ai/mastra/commit/a739d0c8b37cd89569e04a6ca0827083c6167e19), [`603e927`](https://github.com/mastra-ai/mastra/commit/603e9279db8bf8a46caf83881c6b7389ccffff7e), [`cd45982`](https://github.com/mastra-ai/mastra/commit/cd4598291cda128a88738734ae6cbef076ebdebd), [`874f74d`](https://github.com/mastra-ai/mastra/commit/874f74da4b1acf6517f18132d035612c3ecc394a), [`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d), [`0baf2ba`](https://github.com/mastra-ai/mastra/commit/0baf2bab8420277072ef1f95df5ea7b0a2f61fe7), [`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0), [`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86), [`26e968d`](https://github.com/mastra-ai/mastra/commit/26e968db2171ded9e4d47aa1b4f19e1e771158d0), [`cbd3fb6`](https://github.com/mastra-ai/mastra/commit/cbd3fb65adb03a7c0df193cb998aed5ac56675ee)]:
271
300
  - @mastra/core@0.20.1
272
301
 
273
- ## 0.20.1-alpha.4
274
-
275
- ### Patch Changes
276
-
277
- - Updated dependencies [[`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d)]:
278
- - @mastra/core@0.20.1-alpha.4
279
-
280
- ## 0.20.1-alpha.3
281
-
282
- ### Patch Changes
283
-
284
- - Fix TypeScript errors with provider-defined tools by updating ai-v5 and openai-v5 to matching provider-utils versions. This ensures npm deduplicates to a single provider-utils instance, resolving type incompatibility issues when passing provider tools to Agent. ([#8584](https://github.com/mastra-ai/mastra/pull/8584))
285
-
286
- Also adds deprecation warning to Agent import from root path to encourage using the recommended subpath import.
287
-
288
- - Updated dependencies [[`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86)]:
289
- - @mastra/core@0.20.1-alpha.3
290
-
291
- ## 0.20.1-alpha.2
292
-
293
- ### Patch Changes
294
-
295
- - Updated dependencies [[`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c)]:
296
- - @mastra/core@0.20.1-alpha.2
297
-
298
- ## 0.20.1-alpha.1
299
-
300
- ### Patch Changes
301
-
302
- ... 3902 more lines hidden. See full changelog in package directory.
302
+ ... 3931 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,15 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.17.7
4
+
5
+ ## 0.17.7-alpha.0
6
+
7
+ ## 0.17.6
8
+
9
+ ### Patch Changes
10
+
11
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9364](https://github.com/mastra-ai/mastra/pull/9364))
12
+
3
13
  ## 0.17.6-alpha.1
4
14
 
5
15
  ## 0.17.6-alpha.0
@@ -288,15 +298,5 @@
288
298
 
289
299
  ## 0.13.4-alpha.0
290
300
 
291
- ### Patch Changes
292
-
293
- - Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
294
-
295
- ## 0.13.3
296
-
297
- ### Patch Changes
298
-
299
- - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
300
-
301
301
 
302
- ... 1794 more lines hidden. See full changelog in package directory.
302
+ ... 1804 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,37 @@
1
1
  # mastra
2
2
 
3
+ ## 0.17.7
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
8
+ - @mastra/deployer@0.23.3
9
+ - @mastra/core@0.23.3
10
+
11
+ ## 0.17.7-alpha.0
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`b55bbce`](https://github.com/mastra-ai/mastra/commit/b55bbce89404d35fdd967012dd503fae343d4c2d), [`d6cb18e`](https://github.com/mastra-ai/mastra/commit/d6cb18e189fd0ac95d4934cf0d6f2866876d1a2e), [`d0ecff7`](https://github.com/mastra-ai/mastra/commit/d0ecff793d5cd50408cd8d1d113f02e28d897a3d), [`e84a959`](https://github.com/mastra-ai/mastra/commit/e84a9592bfdec4f1c9fdf108c9d4ea4e2ee8f7e3), [`e742d37`](https://github.com/mastra-ai/mastra/commit/e742d371f24ef8059670cc05e9aee308eac068b9)]:
16
+ - @mastra/deployer@0.23.3-alpha.0
17
+ - @mastra/core@0.23.3-alpha.0
18
+
19
+ ## 0.17.6
20
+
21
+ ### Patch Changes
22
+
23
+ - Use dynamic model for scorers in create cli ([#9342](https://github.com/mastra-ai/mastra/pull/9342))
24
+
25
+ - Update MainSidebar component to fit required changes in Cloud CTA link ([#9364](https://github.com/mastra-ai/mastra/pull/9364))
26
+
27
+ - Better handle errors during `mastra start` and throw them with Mastra's logger. Also add special error handling for `ERR_MODULE_NOT_FOUND` cases. ([#9338](https://github.com/mastra-ai/mastra/pull/9338))
28
+
29
+ - Make sure that `mastra init` also installs the `mastra` CLI package (if not already installed) ([#9423](https://github.com/mastra-ai/mastra/pull/9423))
30
+
31
+ - Updated dependencies [[`f57a81e`](https://github.com/mastra-ai/mastra/commit/f57a81e6ce644e45bf1c9618778cc54c50a84ad4), [`17e5a4e`](https://github.com/mastra-ai/mastra/commit/17e5a4e828a8ebc6148c76b42a139c0f9bf7e25f), [`2afd345`](https://github.com/mastra-ai/mastra/commit/2afd3450825b76e41f7973baddf13867ea042e40), [`fc79af3`](https://github.com/mastra-ai/mastra/commit/fc79af3915d1c456729cbd753673b0c0564340d8), [`eefc89e`](https://github.com/mastra-ai/mastra/commit/eefc89ee69f05bb71661473a807fc7dc03d56f17), [`60bd45d`](https://github.com/mastra-ai/mastra/commit/60bd45de021f0dfbe6583928f6da5169cb5585ba), [`a30093d`](https://github.com/mastra-ai/mastra/commit/a30093de98c1836dcd5dfddf09649010712b8c95), [`0fe7adb`](https://github.com/mastra-ai/mastra/commit/0fe7adb0f20f59a6bb41f235d01f8b7a880ea6e7), [`a42e496`](https://github.com/mastra-ai/mastra/commit/a42e49686a7486e2e9e9397fa98e5ff7a71dc1b0), [`3670db7`](https://github.com/mastra-ai/mastra/commit/3670db7e8e798f9d65fac5bfb732134a1f26ba7b), [`e40d4d0`](https://github.com/mastra-ai/mastra/commit/e40d4d0a0971b4505e7c9de73c656066c7565653), [`fc843ff`](https://github.com/mastra-ai/mastra/commit/fc843ff4d1d149317b6324553ce5ad7972062a78), [`ff16f9b`](https://github.com/mastra-ai/mastra/commit/ff16f9b9dbc701b26b6c4e9872f759f3880f9327), [`35e6cf7`](https://github.com/mastra-ai/mastra/commit/35e6cf722fef16ea0301eb9cf5a32fe9ccb12d22), [`30f92b5`](https://github.com/mastra-ai/mastra/commit/30f92b5b3aa224289f2f0eff56babcfa7a87b772), [`30a2e36`](https://github.com/mastra-ai/mastra/commit/30a2e369485e0e59c4faa1d83c5635c2260b304c)]:
32
+ - @mastra/core@0.23.2
33
+ - @mastra/deployer@0.23.2
34
+
3
35
  ## 0.17.6-alpha.1
4
36
 
5
37
  ### Patch Changes
@@ -267,36 +299,4 @@
267
299
 
268
300
  ### Patch Changes
269
301
 
270
- - Marked telemetry as disabled in the default template, in preperation for the Nov 4th deprecation. ([#8618](https://github.com/mastra-ai/mastra/pull/8618))
271
-
272
- ## 0.15.1-alpha.0
273
-
274
- ### Patch Changes
275
-
276
- - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
277
-
278
- - Updated dependencies [[`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372)]:
279
- - @mastra/core@0.20.2-alpha.0
280
- - @mastra/deployer@0.20.2-alpha.0
281
-
282
- ## 0.15.0
283
-
284
- ### Minor Changes
285
-
286
- - Update peer dependencies to match core package version bump (0.20.1) ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
287
-
288
- ### Patch Changes
289
-
290
- - workflow run thread more visible ([#8539](https://github.com/mastra-ai/mastra/pull/8539))
291
-
292
- - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
293
-
294
- - streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
295
-
296
- - avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
297
-
298
- - add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
299
-
300
- - Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
301
-
302
- ... 6347 more lines hidden. See full changelog in package directory.
302
+ ... 6379 more lines hidden. See full changelog in package directory.
@@ -1,3 +1,7 @@
1
+ ---
2
+ title: "Adding Voice to Agents | Agents | Mastra Docs"
3
+ ---
4
+
1
5
  # Adding Voice to Agents
2
6
 
3
7
  Mastra agents can be enhanced with voice capabilities, allowing them to speak responses and listen to user input. You can configure an agent to use either a single voice provider or combine multiple providers for different operations.
@@ -163,7 +167,7 @@ The following files are created:
163
167
  - **hybrid-question.mp3** – Hybrid agent's spoken question.
164
168
  - **unified-response.mp3** – Unified agent's spoken response.
165
169
 
166
- ```typescript filename="src/test-voice-agents.ts" showLineNumbers copy
170
+ ```typescript title="src/test-voice-agents.ts" showLineNumbers copy
167
171
  import "dotenv/config";
168
172
 
169
173
  import path from "path";
@@ -175,7 +179,10 @@ import { Mastra } from "@mastra/core/mastra";
175
179
  import { openai } from "@ai-sdk/openai";
176
180
 
177
181
  // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
178
- export const saveAudioToFile = async (audio: NodeJS.ReadableStream, filename: string): Promise<void> => {
182
+ export const saveAudioToFile = async (
183
+ audio: NodeJS.ReadableStream,
184
+ filename: string,
185
+ ): Promise<void> => {
179
186
  const audioDir = path.join(process.cwd(), "audio");
180
187
  const filePath = path.join(audioDir, filename);
181
188
 
@@ -190,7 +197,9 @@ export const saveAudioToFile = async (audio: NodeJS.ReadableStream, filename: st
190
197
  };
191
198
 
192
199
  // Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
193
- export const convertToText = async (input: string | NodeJS.ReadableStream): Promise<string> => {
200
+ export const convertToText = async (
201
+ input: string | NodeJS.ReadableStream,
202
+ ): Promise<string> => {
194
203
  if (typeof input === "string") {
195
204
  return input;
196
205
  }
@@ -209,20 +218,20 @@ export const hybridVoiceAgent = new Agent({
209
218
  instructions: "You can speak and listen using different providers.",
210
219
  voice: new CompositeVoice({
211
220
  input: new OpenAIVoice(),
212
- output: new OpenAIVoice()
213
- })
221
+ output: new OpenAIVoice(),
222
+ }),
214
223
  });
215
-
224
+
216
225
  export const unifiedVoiceAgent = new Agent({
217
226
  name: "unified-voice-agent",
218
227
  instructions: "You are an agent with both STT and TTS capabilities.",
219
228
  model: openai("gpt-4o"),
220
- voice: new OpenAIVoice()
229
+ voice: new OpenAIVoice(),
221
230
  });
222
231
 
223
232
  export const mastra = new Mastra({
224
233
  // ...
225
- agents: { hybridVoiceAgent, unifiedVoiceAgent }
234
+ agents: { hybridVoiceAgent, unifiedVoiceAgent },
226
235
  });
227
236
 
228
237
  const hybridVoiceAgent = mastra.getAgent("hybridVoiceAgent");
@@ -234,7 +243,9 @@ const hybridSpoken = await hybridVoiceAgent.voice.speak(question);
234
243
 
235
244
  await saveAudioToFile(hybridSpoken!, "hybrid-question.mp3");
236
245
 
237
- const audioStream = createReadStream(path.join(process.cwd(), "audio", "hybrid-question.mp3"));
246
+ const audioStream = createReadStream(
247
+ path.join(process.cwd(), "audio", "hybrid-question.mp3"),
248
+ );
238
249
  const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream);
239
250
 
240
251
  const inputText = await convertToText(unifiedHeard!);
@@ -3,9 +3,10 @@ title: "Agent Memory | Agents | Mastra Docs"
3
3
  description: Learn how to add memory to agents to store conversation history and maintain context across interactions.
4
4
  ---
5
5
 
6
- import { Steps } from "nextra/components";
6
+ import Steps from "@site/src/components/Steps";
7
+ import StepItem from "@site/src/components/StepItem";
7
8
 
8
- ## Agent memory
9
+ # Agent memory
9
10
 
10
11
  Agents use memory to maintain context across interactions. LLMs are stateless and don't retain information between calls, so agents need memory to track conversation history and recall relevant information.
11
12
 
@@ -25,17 +26,16 @@ npm install @mastra/memory@latest @mastra/libsql@latest
25
26
 
26
27
  ## Storage providers
27
28
 
28
- Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](../server-db/storage.mdx) documentation.
29
+ Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/server-db/storage) documentation.
29
30
 
30
31
  ## Configuring memory
31
32
 
32
33
  <Steps>
33
-
34
- ### Agent memory
34
+ <StepItem>
35
35
 
36
36
  Enable memory by creating a `Memory` instance and passing it to the agent’s `memory` option.
37
37
 
38
- ```typescript {6-9} filename="src/mastra/agents/memory-agent.ts" showLineNumbers copy
38
+ ```typescript {6-9} title="src/mastra/agents/memory-agent.ts" copy
39
39
  import { Agent } from "@mastra/core/agent";
40
40
  import { Memory } from "@mastra/memory";
41
41
 
@@ -43,37 +43,48 @@ export const memoryAgent = new Agent({
43
43
  // ...
44
44
  memory: new Memory({
45
45
  options: {
46
- lastMessages: 20
47
- }
48
- })
46
+ lastMessages: 20,
47
+ },
48
+ }),
49
49
  });
50
50
  ```
51
51
 
52
- > See the [Memory Class](../../reference/memory/Memory.mdx) for a full list of configuration options.
52
+ :::note
53
+
54
+ See the [Memory Class](/reference/memory/memory-class) docs for a full list of configuration options.
55
+
56
+ :::
53
57
 
54
- ### Mastra storage
58
+ </StepItem>
59
+
60
+ <StepItem>
55
61
 
56
62
  Add a storage provider to your main Mastra instance to enable memory across all configured agents.
57
63
 
58
- ```typescript {6-8} filename="src/mastra/index.ts" showLineNumbers copy
64
+ ```typescript {6-8} title="src/mastra/index.ts" copy
59
65
  import { Mastra } from "@mastra/core/mastra";
60
66
  import { LibSQLStore } from "@mastra/libsql";
61
67
 
62
68
  export const mastra = new Mastra({
63
69
  // ..
64
70
  storage: new LibSQLStore({
65
- url: ":memory:"
71
+ url: ":memory:",
66
72
  }),
67
73
  });
68
74
  ```
69
75
 
70
- > See the [LibSQL Storage](../../reference/storage/libsql.mdx) for a full list of configuration options.
76
+ :::note
77
+
78
+ See the [LibSQL Storage](/reference/storage/libsql) docs for a full list of configuration options.
79
+
80
+ :::
71
81
 
82
+ </StepItem>
72
83
  </Steps>
73
84
 
74
85
  Alternatively, add storage directly to an agent’s memory to keep data separate or use different providers per agent.
75
86
 
76
- ```typescript {7-10} filename="src/mastra/agents/memory-agent.ts" showLineNumbers copy
87
+ ```typescript {7-10} title="src/mastra/agents/memory-agent.ts" copy
77
88
  import { Agent } from "@mastra/core/agent";
78
89
  import { Memory } from "@mastra/memory";
79
90
  import { LibSQLStore } from "@mastra/libsql";
@@ -82,9 +93,9 @@ export const memoryAgent = new Agent({
82
93
  // ...
83
94
  memory: new Memory({
84
95
  storage: new LibSQLStore({
85
- url: ":memory:"
86
- })
87
- })
96
+ url: ":memory:",
97
+ }),
98
+ }),
88
99
  });
89
100
  ```
90
101
 
@@ -98,12 +109,15 @@ Include a `memory` object with both `resource` and `thread` to track conversatio
98
109
  These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across a conversation.
99
110
 
100
111
  ```typescript {3-4}
101
- const response = await memoryAgent.generate("Remember my favorite color is blue.", {
102
- memory: {
103
- thread: "user-123",
104
- resource: "test-123"
105
- }
106
- });
112
+ const response = await memoryAgent.generate(
113
+ "Remember my favorite color is blue.",
114
+ {
115
+ memory: {
116
+ thread: "user-123",
117
+ resource: "test-123",
118
+ },
119
+ },
120
+ );
107
121
  ```
108
122
 
109
123
  To recall information stored in memory, call the agent with the same `resource` and `thread` values used in the original conversation.
@@ -112,24 +126,24 @@ To recall information stored in memory, call the agent with the same `resource`
112
126
  const response = await memoryAgent.generate("What's my favorite color?", {
113
127
  memory: {
114
128
  thread: "user-123",
115
- resource: "test-123"
116
- }
129
+ resource: "test-123",
130
+ },
117
131
  });
118
132
  ```
119
133
 
120
- To learn more about memory see the [Memory](../memory/overview.mdx) documentation.
134
+ To learn more about memory see the [Memory](../memory/overview) documentation.
121
135
 
122
136
  ## Using `RuntimeContext`
123
137
 
124
- Use [RuntimeContext](../server-db/runtime-context.mdx) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
138
+ Use [RuntimeContext](/docs/server-db/runtime-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
125
139
 
126
- ```typescript filename="src/mastra/agents/memory-agent.ts" showLineNumbers
140
+ ```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers
127
141
  export type UserTier = {
128
142
  "user-tier": "enterprise" | "pro";
129
143
  };
130
144
 
131
145
  const premiumMemory = new Memory({
132
- // ...
146
+ // ...
133
147
  });
134
148
 
135
149
  const standardMemory = new Memory({
@@ -141,18 +155,20 @@ export const memoryAgent = new Agent({
141
155
  memory: ({ runtimeContext }) => {
142
156
  const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
143
157
 
144
- return userTier === "enterprise"
145
- ? premiumMemory
146
- : standardMemory;
147
- }
158
+ return userTier === "enterprise" ? premiumMemory : standardMemory;
159
+ },
148
160
  });
149
161
  ```
150
162
 
151
- > See [Runtime Context](../server-db/runtime-context.mdx) for more information.
163
+ :::note
164
+
165
+ See [Runtime Context](/docs/server-db/runtime-context) docs for more information.
166
+
167
+ :::
152
168
 
153
169
  ## Related
154
170
 
155
- - [Working Memory](../memory/working-memory.mdx)
156
- - [Semantic Recall](../memory/semantic-recall.mdx)
157
- - [Threads and Resources](../memory/threads-and-resources.mdx)
158
- - [Runtime Context](../server-db/runtime-context.mdx)
171
+ - [Working Memory](../memory/working-memory)
172
+ - [Semantic Recall](../memory/semantic-recall)
173
+ - [Threads and Resources](../memory/threads-and-resources)
174
+ - [Runtime Context](/docs/server-db/runtime-context)