@mastra/mcp-docs-server 1.0.0-beta.9 → 1.0.1

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 (541) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +3 -1
  2. package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +3 -1
  3. package/.docs/organized/changelogs/%40internal%2Fplayground.md +60 -0
  4. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +15 -15
  5. package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +3 -1
  6. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +287 -287
  7. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +302 -302
  8. package/.docs/organized/changelogs/%40mastra%2Fastra.md +53 -53
  9. package/.docs/organized/changelogs/%40mastra%2Fauth.md +38 -0
  10. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +66 -66
  11. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +522 -212
  12. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +239 -239
  13. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +439 -234
  14. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +450 -211
  15. package/.docs/organized/changelogs/%40mastra%2Fcodemod.md +202 -0
  16. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +448 -22
  17. package/.docs/organized/changelogs/%40mastra%2Fcore.md +348 -348
  18. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +60 -60
  19. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +287 -287
  20. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +106 -106
  21. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +90 -90
  22. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +86 -86
  23. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +221 -221
  24. package/.docs/organized/changelogs/%40mastra%2Fduckdb.md +70 -0
  25. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +403 -225
  26. package/.docs/organized/changelogs/%40mastra%2Felasticsearch.md +72 -0
  27. package/.docs/organized/changelogs/%40mastra%2Fevals.md +145 -145
  28. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +54 -0
  29. package/.docs/organized/changelogs/%40mastra%2Flance.md +456 -226
  30. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +625 -229
  31. package/.docs/organized/changelogs/%40mastra%2Floggers.md +71 -71
  32. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +245 -245
  33. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +28 -28
  34. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +281 -281
  35. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +354 -156
  36. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +545 -212
  37. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +481 -202
  38. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +194 -194
  39. package/.docs/organized/changelogs/%40mastra%2Fpg.md +781 -235
  40. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +198 -198
  41. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +282 -282
  42. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +163 -163
  43. package/.docs/organized/changelogs/%40mastra%2Frag.md +310 -310
  44. package/.docs/organized/changelogs/%40mastra%2Freact.md +328 -237
  45. package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +64 -0
  46. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +160 -0
  47. package/.docs/organized/changelogs/%40mastra%2Fserver.md +230 -230
  48. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +57 -57
  49. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +479 -232
  50. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +53 -53
  51. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +45 -45
  52. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +45 -45
  53. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +47 -47
  54. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +110 -110
  55. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +15 -0
  56. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +98 -0
  57. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +54 -54
  58. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +46 -46
  59. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +93 -93
  60. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +47 -47
  61. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +45 -45
  62. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +45 -45
  63. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +45 -45
  64. package/.docs/organized/changelogs/create-mastra.md +219 -219
  65. package/.docs/organized/changelogs/mastra.md +276 -276
  66. package/.docs/organized/code-examples/a2a.md +2 -2
  67. package/.docs/organized/code-examples/agent-v6.md +221 -0
  68. package/.docs/organized/code-examples/agui.md +4 -4
  69. package/.docs/organized/code-examples/ai-elements.md +3 -3
  70. package/.docs/organized/code-examples/ai-sdk-useChat.md +2 -2
  71. package/.docs/organized/code-examples/ai-sdk-v5.md +3 -3
  72. package/.docs/organized/code-examples/assistant-ui.md +5 -5
  73. package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
  74. package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +2 -2
  75. package/.docs/organized/code-examples/bird-checker-with-nextjs.md +3 -3
  76. package/.docs/organized/code-examples/client-side-tools.md +4 -4
  77. package/.docs/organized/code-examples/crypto-chatbot.md +5 -5
  78. package/.docs/organized/code-examples/experimental-auth-weather-agent.md +1 -1
  79. package/.docs/organized/code-examples/fireworks-r1.md +2 -2
  80. package/.docs/organized/code-examples/heads-up-game.md +7 -7
  81. package/.docs/organized/code-examples/inngest.md +1075 -0
  82. package/.docs/organized/code-examples/mcp-configuration.md +1 -1
  83. package/.docs/organized/code-examples/mcp-server-adapters.md +2 -2
  84. package/.docs/organized/code-examples/memory-per-resource-example.md +3 -3
  85. package/.docs/organized/code-examples/memory-todo-agent.md +1 -1
  86. package/.docs/organized/code-examples/memory-with-context.md +1 -1
  87. package/.docs/organized/code-examples/memory-with-processors.md +1 -1
  88. package/.docs/organized/code-examples/openapi-spec-writer.md +3 -3
  89. package/.docs/organized/code-examples/quick-start.md +1 -5
  90. package/.docs/organized/code-examples/server-app-access.md +2 -2
  91. package/.docs/organized/code-examples/server-express-adapter.md +1 -1
  92. package/.docs/organized/code-examples/server-fastify-adapter.md +83 -0
  93. package/.docs/organized/code-examples/server-hono-adapter.md +2 -2
  94. package/.docs/organized/code-examples/server-koa-adapter.md +94 -0
  95. package/.docs/organized/code-examples/stock-price-tool.md +21 -2
  96. package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
  97. package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
  98. package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
  99. package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
  100. package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
  101. package/.docs/raw/agents/adding-voice.mdx +24 -6
  102. package/.docs/raw/agents/agent-approval.mdx +209 -12
  103. package/.docs/raw/agents/agent-memory.mdx +36 -32
  104. package/.docs/raw/agents/guardrails.mdx +105 -56
  105. package/.docs/raw/agents/network-approval.mdx +281 -0
  106. package/.docs/raw/agents/networks.mdx +69 -13
  107. package/.docs/raw/agents/overview.mdx +43 -25
  108. package/.docs/raw/agents/processors.mdx +234 -17
  109. package/.docs/raw/agents/structured-output.mdx +78 -8
  110. package/.docs/raw/agents/using-tools.mdx +67 -6
  111. package/.docs/raw/course/01-first-agent/07-creating-your-agent.md +1 -2
  112. package/.docs/raw/course/01-first-agent/12-connecting-tool-to-agent.md +1 -1
  113. package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +1 -2
  114. package/.docs/raw/course/02-agent-tools-mcp/05-updating-your-agent.md +1 -1
  115. package/.docs/raw/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md +1 -1
  116. package/.docs/raw/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md +1 -1
  117. package/.docs/raw/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md +1 -1
  118. package/.docs/raw/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md +1 -1
  119. package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md +3 -3
  120. package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -2
  121. package/.docs/raw/course/03-agent-memory/07-understanding-memory-threads.md +35 -0
  122. package/.docs/raw/course/03-agent-memory/08-configuring-conversation-history.md +1 -2
  123. package/.docs/raw/course/03-agent-memory/13-vector-store-configuration.md +1 -1
  124. package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +4 -5
  125. package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +1 -1
  126. package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +3 -4
  127. package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +3 -4
  128. package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +3 -4
  129. package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +3 -4
  130. package/.docs/raw/course/04-workflows/11-creating-an-ai-agent.md +2 -3
  131. package/.docs/raw/deployment/cloud-providers.mdx +22 -0
  132. package/.docs/raw/deployment/mastra-server.mdx +140 -0
  133. package/.docs/raw/deployment/monorepo.mdx +106 -42
  134. package/.docs/raw/deployment/overview.mdx +35 -48
  135. package/.docs/raw/deployment/web-framework.mdx +17 -19
  136. package/.docs/raw/deployment/workflow-runners.mdx +16 -0
  137. package/.docs/raw/evals/built-in-scorers.mdx +2 -0
  138. package/.docs/raw/evals/custom-scorers.mdx +60 -12
  139. package/.docs/raw/evals/overview.mdx +6 -6
  140. package/.docs/raw/evals/running-in-ci.mdx +4 -2
  141. package/.docs/raw/getting-started/manual-install.mdx +20 -20
  142. package/.docs/raw/getting-started/mcp-docs-server.mdx +59 -2
  143. package/.docs/raw/getting-started/project-structure.mdx +2 -2
  144. package/.docs/raw/getting-started/start.mdx +17 -1
  145. package/.docs/raw/getting-started/studio.mdx +6 -35
  146. package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +23 -33
  147. package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +1034 -80
  148. package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
  149. package/.docs/raw/guides/build-your-ui/copilotkit.mdx +32 -11
  150. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/amazon-ec2.mdx +9 -9
  151. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/aws-lambda.mdx +13 -16
  152. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/azure-app-services.mdx +5 -7
  153. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/cloudflare-deployer.mdx +8 -5
  154. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/digital-ocean.mdx +18 -23
  155. package/.docs/raw/guides/deployment/index.mdx +32 -0
  156. package/.docs/raw/guides/deployment/inngest.mdx +673 -0
  157. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/netlify-deployer.mdx +7 -3
  158. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/vercel-deployer.mdx +8 -5
  159. package/.docs/raw/guides/getting-started/astro.mdx +292 -451
  160. package/.docs/raw/guides/getting-started/express.mdx +72 -153
  161. package/.docs/raw/guides/getting-started/hono.mdx +227 -0
  162. package/.docs/raw/guides/getting-started/next-js.mdx +173 -61
  163. package/.docs/raw/guides/getting-started/nuxt.mdx +505 -0
  164. package/.docs/raw/guides/getting-started/quickstart.mdx +5 -5
  165. package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
  166. package/.docs/raw/guides/getting-started/vite-react.mdx +317 -147
  167. package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
  168. package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
  169. package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
  170. package/.docs/raw/guides/guide/research-assistant.mdx +20 -20
  171. package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
  172. package/.docs/raw/guides/guide/web-search.mdx +38 -38
  173. package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
  174. package/.docs/raw/guides/index.mdx +0 -1
  175. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
  176. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +105 -4
  177. package/.docs/raw/guides/migrations/upgrade-to-v1/cli.mdx +15 -1
  178. package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +170 -0
  179. package/.docs/raw/guides/migrations/upgrade-to-v1/deployment.mdx +42 -0
  180. package/.docs/raw/guides/migrations/upgrade-to-v1/mastra.mdx +0 -35
  181. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +40 -3
  182. package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +17 -2
  183. package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
  184. package/.docs/raw/guides/migrations/upgrade-to-v1/rag.mdx +47 -0
  185. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +271 -25
  186. package/.docs/raw/guides/migrations/upgrade-to-v1/tracing.mdx +72 -17
  187. package/.docs/raw/guides/migrations/upgrade-to-v1/vectors.mdx +46 -1
  188. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +50 -7
  189. package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
  190. package/.docs/raw/index.mdx +2 -2
  191. package/.docs/raw/mastra-cloud/deployment.mdx +86 -0
  192. package/.docs/raw/mastra-cloud/observability.mdx +43 -0
  193. package/.docs/raw/mastra-cloud/overview.mdx +31 -0
  194. package/.docs/raw/mastra-cloud/setup.mdx +64 -0
  195. package/.docs/raw/mastra-cloud/studio.mdx +35 -0
  196. package/.docs/raw/mcp/overview.mdx +60 -25
  197. package/.docs/raw/mcp/publishing-mcp-server.mdx +7 -4
  198. package/.docs/raw/memory/memory-processors.mdx +17 -12
  199. package/.docs/raw/memory/message-history.mdx +72 -0
  200. package/.docs/raw/memory/overview.mdx +38 -76
  201. package/.docs/raw/memory/semantic-recall.mdx +65 -52
  202. package/.docs/raw/memory/storage.mdx +248 -0
  203. package/.docs/raw/memory/working-memory.mdx +24 -13
  204. package/.docs/raw/observability/logging.mdx +16 -15
  205. package/.docs/raw/observability/overview.mdx +27 -7
  206. package/.docs/raw/observability/tracing/bridges/otel.mdx +7 -4
  207. package/.docs/raw/observability/tracing/exporters/arize.mdx +61 -24
  208. package/.docs/raw/observability/tracing/exporters/braintrust.mdx +32 -22
  209. package/.docs/raw/observability/tracing/exporters/cloud.mdx +24 -5
  210. package/.docs/raw/observability/tracing/exporters/datadog.mdx +175 -0
  211. package/.docs/raw/observability/tracing/exporters/default.mdx +28 -7
  212. package/.docs/raw/observability/tracing/exporters/laminar.mdx +89 -0
  213. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +31 -22
  214. package/.docs/raw/observability/tracing/exporters/langsmith.mdx +33 -3
  215. package/.docs/raw/observability/tracing/exporters/otel.mdx +194 -22
  216. package/.docs/raw/observability/tracing/exporters/posthog.mdx +32 -22
  217. package/.docs/raw/observability/tracing/exporters/sentry.mdx +198 -0
  218. package/.docs/raw/observability/tracing/overview.mdx +388 -108
  219. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +27 -7
  220. package/.docs/raw/rag/chunking-and-embedding.mdx +22 -33
  221. package/.docs/raw/rag/graph-rag.mdx +223 -0
  222. package/.docs/raw/rag/overview.mdx +6 -3
  223. package/.docs/raw/rag/retrieval.mdx +53 -57
  224. package/.docs/raw/rag/vector-databases.mdx +55 -31
  225. package/.docs/raw/reference/agents/agent.mdx +17 -14
  226. package/.docs/raw/reference/agents/generate.mdx +172 -44
  227. package/.docs/raw/reference/agents/generateLegacy.mdx +5 -3
  228. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +5 -3
  229. package/.docs/raw/reference/agents/getDefaultOptions.mdx +5 -3
  230. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +5 -3
  231. package/.docs/raw/reference/agents/getDescription.mdx +3 -1
  232. package/.docs/raw/reference/agents/getInstructions.mdx +5 -3
  233. package/.docs/raw/reference/agents/getLLM.mdx +5 -3
  234. package/.docs/raw/reference/agents/getMemory.mdx +5 -3
  235. package/.docs/raw/reference/agents/getModel.mdx +5 -3
  236. package/.docs/raw/reference/agents/getTools.mdx +4 -2
  237. package/.docs/raw/reference/agents/getVoice.mdx +4 -2
  238. package/.docs/raw/reference/agents/listAgents.mdx +4 -2
  239. package/.docs/raw/reference/agents/listScorers.mdx +5 -3
  240. package/.docs/raw/reference/agents/listTools.mdx +4 -2
  241. package/.docs/raw/reference/agents/listWorkflows.mdx +4 -2
  242. package/.docs/raw/reference/agents/network.mdx +113 -1
  243. package/.docs/raw/reference/ai-sdk/chat-route.mdx +6 -3
  244. package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +4 -2
  245. package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +4 -2
  246. package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +5 -3
  247. package/.docs/raw/reference/ai-sdk/network-route.mdx +6 -3
  248. package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +10 -6
  249. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +130 -0
  250. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +110 -0
  251. package/.docs/raw/reference/ai-sdk/with-mastra.mdx +122 -0
  252. package/.docs/raw/reference/ai-sdk/workflow-route.mdx +7 -4
  253. package/.docs/raw/reference/auth/auth0.mdx +5 -3
  254. package/.docs/raw/reference/auth/clerk.mdx +5 -3
  255. package/.docs/raw/reference/auth/firebase.mdx +6 -5
  256. package/.docs/raw/reference/auth/jwt.mdx +5 -3
  257. package/.docs/raw/reference/auth/supabase.mdx +5 -3
  258. package/.docs/raw/reference/auth/workos.mdx +5 -3
  259. package/.docs/raw/reference/cli/create-mastra.mdx +12 -10
  260. package/.docs/raw/reference/cli/mastra.mdx +63 -15
  261. package/.docs/raw/reference/client-js/agents.mdx +77 -35
  262. package/.docs/raw/reference/client-js/error-handling.mdx +3 -3
  263. package/.docs/raw/reference/client-js/logs.mdx +2 -0
  264. package/.docs/raw/reference/client-js/mastra-client.mdx +4 -2
  265. package/.docs/raw/reference/client-js/memory.mdx +43 -1
  266. package/.docs/raw/reference/client-js/observability.mdx +2 -0
  267. package/.docs/raw/reference/client-js/telemetry.mdx +2 -0
  268. package/.docs/raw/reference/client-js/tools.mdx +2 -0
  269. package/.docs/raw/reference/client-js/vectors.mdx +2 -0
  270. package/.docs/raw/reference/client-js/workflows.mdx +47 -3
  271. package/.docs/raw/reference/configuration.mdx +761 -0
  272. package/.docs/raw/reference/core/addGateway.mdx +2 -0
  273. package/.docs/raw/reference/core/getAgent.mdx +3 -1
  274. package/.docs/raw/reference/core/getAgentById.mdx +3 -1
  275. package/.docs/raw/reference/core/getDeployer.mdx +3 -1
  276. package/.docs/raw/reference/core/getGateway.mdx +2 -0
  277. package/.docs/raw/reference/core/getGatewayById.mdx +2 -0
  278. package/.docs/raw/reference/core/getLogger.mdx +3 -1
  279. package/.docs/raw/reference/core/getMCPServer.mdx +3 -1
  280. package/.docs/raw/reference/core/getMCPServerById.mdx +3 -1
  281. package/.docs/raw/reference/core/getMemory.mdx +7 -3
  282. package/.docs/raw/reference/core/getScorer.mdx +2 -0
  283. package/.docs/raw/reference/core/getScorerById.mdx +2 -0
  284. package/.docs/raw/reference/core/getServer.mdx +6 -4
  285. package/.docs/raw/reference/core/getStorage.mdx +5 -3
  286. package/.docs/raw/reference/core/getStoredAgentById.mdx +6 -4
  287. package/.docs/raw/reference/core/getTelemetry.mdx +3 -1
  288. package/.docs/raw/reference/core/getVector.mdx +3 -1
  289. package/.docs/raw/reference/core/getWorkflow.mdx +3 -1
  290. package/.docs/raw/reference/core/listAgents.mdx +3 -1
  291. package/.docs/raw/reference/core/listGateways.mdx +2 -0
  292. package/.docs/raw/reference/core/listLogs.mdx +3 -1
  293. package/.docs/raw/reference/core/listLogsByRunId.mdx +3 -1
  294. package/.docs/raw/reference/core/listMCPServers.mdx +3 -1
  295. package/.docs/raw/reference/core/listMemory.mdx +8 -4
  296. package/.docs/raw/reference/core/listScorers.mdx +2 -0
  297. package/.docs/raw/reference/core/listStoredAgents.mdx +7 -5
  298. package/.docs/raw/reference/core/listVectors.mdx +3 -1
  299. package/.docs/raw/reference/core/listWorkflows.mdx +3 -1
  300. package/.docs/raw/reference/core/mastra-class.mdx +27 -20
  301. package/.docs/raw/reference/core/mastra-model-gateway.mdx +2 -0
  302. package/.docs/raw/reference/core/setLogger.mdx +3 -1
  303. package/.docs/raw/reference/core/setStorage.mdx +6 -4
  304. package/.docs/raw/reference/deployer/cloudflare.mdx +22 -53
  305. package/.docs/raw/reference/deployer/deployer.mdx +2 -1
  306. package/.docs/raw/reference/deployer/netlify.mdx +4 -1
  307. package/.docs/raw/reference/deployer/vercel.mdx +5 -4
  308. package/.docs/raw/reference/evals/answer-relevancy.mdx +4 -1
  309. package/.docs/raw/reference/evals/answer-similarity.mdx +4 -1
  310. package/.docs/raw/reference/evals/bias.mdx +4 -1
  311. package/.docs/raw/reference/evals/completeness.mdx +4 -1
  312. package/.docs/raw/reference/evals/content-similarity.mdx +4 -1
  313. package/.docs/raw/reference/evals/context-precision.mdx +4 -1
  314. package/.docs/raw/reference/evals/context-relevance.mdx +2 -0
  315. package/.docs/raw/reference/evals/create-scorer.mdx +11 -3
  316. package/.docs/raw/reference/evals/faithfulness.mdx +4 -1
  317. package/.docs/raw/reference/evals/hallucination.mdx +4 -1
  318. package/.docs/raw/reference/evals/keyword-coverage.mdx +4 -1
  319. package/.docs/raw/reference/evals/mastra-scorer.mdx +2 -0
  320. package/.docs/raw/reference/evals/noise-sensitivity.mdx +2 -0
  321. package/.docs/raw/reference/evals/prompt-alignment.mdx +9 -7
  322. package/.docs/raw/reference/evals/run-evals.mdx +3 -1
  323. package/.docs/raw/reference/evals/scorer-utils.mdx +3 -0
  324. package/.docs/raw/reference/evals/textual-difference.mdx +4 -1
  325. package/.docs/raw/reference/evals/tone-consistency.mdx +4 -1
  326. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +25 -23
  327. package/.docs/raw/reference/evals/toxicity.mdx +4 -1
  328. package/.docs/raw/reference/index.mdx +2 -1
  329. package/.docs/raw/reference/logging/pino-logger.mdx +10 -8
  330. package/.docs/raw/reference/memory/clone-utilities.mdx +345 -0
  331. package/.docs/raw/reference/memory/cloneThread.mdx +237 -0
  332. package/.docs/raw/reference/memory/createThread.mdx +6 -4
  333. package/.docs/raw/reference/memory/deleteMessages.mdx +4 -2
  334. package/.docs/raw/reference/memory/getThreadById.mdx +3 -1
  335. package/.docs/raw/reference/memory/listThreads.mdx +187 -0
  336. package/.docs/raw/reference/memory/memory-class.mdx +27 -20
  337. package/.docs/raw/reference/memory/recall.mdx +6 -4
  338. package/.docs/raw/reference/observability/tracing/bridges/otel.mdx +6 -2
  339. package/.docs/raw/reference/observability/tracing/configuration.mdx +51 -0
  340. package/.docs/raw/reference/observability/tracing/exporters/arize.mdx +25 -6
  341. package/.docs/raw/reference/observability/tracing/exporters/braintrust.mdx +23 -2
  342. package/.docs/raw/reference/observability/tracing/exporters/cloud-exporter.mdx +10 -0
  343. package/.docs/raw/reference/observability/tracing/exporters/console-exporter.mdx +3 -0
  344. package/.docs/raw/reference/observability/tracing/exporters/datadog.mdx +172 -0
  345. package/.docs/raw/reference/observability/tracing/exporters/default-exporter.mdx +10 -0
  346. package/.docs/raw/reference/observability/tracing/exporters/laminar.mdx +139 -0
  347. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +26 -4
  348. package/.docs/raw/reference/observability/tracing/exporters/langsmith.mdx +10 -0
  349. package/.docs/raw/reference/observability/tracing/exporters/otel.mdx +51 -34
  350. package/.docs/raw/reference/observability/tracing/exporters/posthog.mdx +25 -4
  351. package/.docs/raw/reference/observability/tracing/exporters/sentry.mdx +224 -0
  352. package/.docs/raw/reference/observability/tracing/instances.mdx +2 -0
  353. package/.docs/raw/reference/observability/tracing/interfaces.mdx +20 -0
  354. package/.docs/raw/reference/observability/tracing/processors/sensitive-data-filter.mdx +2 -0
  355. package/.docs/raw/reference/observability/tracing/spans.mdx +2 -0
  356. package/.docs/raw/reference/processors/batch-parts-processor.mdx +4 -2
  357. package/.docs/raw/reference/processors/language-detector.mdx +6 -3
  358. package/.docs/raw/reference/processors/message-history-processor.mdx +5 -2
  359. package/.docs/raw/reference/processors/moderation-processor.mdx +6 -4
  360. package/.docs/raw/reference/processors/pii-detector.mdx +6 -4
  361. package/.docs/raw/reference/processors/processor-interface.mdx +326 -23
  362. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +5 -3
  363. package/.docs/raw/reference/processors/semantic-recall-processor.mdx +7 -2
  364. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +5 -3
  365. package/.docs/raw/reference/processors/token-limiter-processor.mdx +62 -19
  366. package/.docs/raw/reference/processors/tool-call-filter.mdx +5 -3
  367. package/.docs/raw/reference/processors/unicode-normalizer.mdx +6 -3
  368. package/.docs/raw/reference/processors/working-memory-processor.mdx +6 -3
  369. package/.docs/raw/reference/rag/chunk.mdx +7 -6
  370. package/.docs/raw/reference/rag/database-config.mdx +8 -6
  371. package/.docs/raw/reference/rag/document.mdx +2 -0
  372. package/.docs/raw/reference/rag/embeddings.mdx +2 -0
  373. package/.docs/raw/reference/rag/extract-params.mdx +57 -3
  374. package/.docs/raw/reference/rag/graph-rag.mdx +2 -0
  375. package/.docs/raw/reference/rag/metadata-filters.mdx +27 -7
  376. package/.docs/raw/reference/rag/rerank.mdx +2 -0
  377. package/.docs/raw/reference/rag/rerankWithScorer.mdx +2 -0
  378. package/.docs/raw/reference/server/create-route.mdx +34 -18
  379. package/.docs/raw/reference/server/express-adapter.mdx +27 -51
  380. package/.docs/raw/reference/server/fastify-adapter.mdx +130 -0
  381. package/.docs/raw/reference/server/hono-adapter.mdx +27 -51
  382. package/.docs/raw/reference/server/koa-adapter.mdx +129 -0
  383. package/.docs/raw/reference/server/mastra-server.mdx +52 -34
  384. package/.docs/raw/reference/server/routes.mdx +73 -10
  385. package/.docs/raw/reference/storage/cloudflare-d1.mdx +10 -5
  386. package/.docs/raw/reference/storage/cloudflare.mdx +12 -2
  387. package/.docs/raw/reference/storage/composite.mdx +245 -0
  388. package/.docs/raw/reference/storage/convex.mdx +8 -6
  389. package/.docs/raw/reference/storage/dynamodb.mdx +134 -8
  390. package/.docs/raw/reference/storage/lance.mdx +9 -5
  391. package/.docs/raw/reference/storage/libsql.mdx +76 -54
  392. package/.docs/raw/reference/storage/mongodb.mdx +115 -16
  393. package/.docs/raw/reference/storage/mssql.mdx +11 -6
  394. package/.docs/raw/{server-db/storage.mdx → reference/storage/overview.mdx} +15 -111
  395. package/.docs/raw/reference/storage/postgresql.mdx +228 -83
  396. package/.docs/raw/reference/storage/upstash.mdx +78 -2
  397. package/.docs/raw/reference/streaming/ChunkType.mdx +31 -3
  398. package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx +67 -6
  399. package/.docs/raw/reference/streaming/agents/stream.mdx +48 -51
  400. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +5 -3
  401. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +3 -1
  402. package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +3 -1
  403. package/.docs/raw/reference/streaming/workflows/stream.mdx +37 -22
  404. package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +6 -4
  405. package/.docs/raw/reference/templates/overview.mdx +3 -2
  406. package/.docs/raw/reference/tools/client.mdx +3 -0
  407. package/.docs/raw/reference/tools/create-tool.mdx +127 -5
  408. package/.docs/raw/reference/tools/document-chunker-tool.mdx +2 -0
  409. package/.docs/raw/reference/tools/graph-rag-tool.mdx +40 -3
  410. package/.docs/raw/reference/tools/mcp-client.mdx +110 -1
  411. package/.docs/raw/reference/tools/mcp-server.mdx +278 -24
  412. package/.docs/raw/reference/tools/vector-query-tool.mdx +68 -4
  413. package/.docs/raw/reference/vectors/astra.mdx +5 -3
  414. package/.docs/raw/reference/vectors/chroma.mdx +5 -3
  415. package/.docs/raw/reference/vectors/convex.mdx +14 -12
  416. package/.docs/raw/reference/vectors/couchbase.mdx +7 -5
  417. package/.docs/raw/reference/vectors/duckdb.mdx +12 -10
  418. package/.docs/raw/reference/vectors/elasticsearch.mdx +12 -4
  419. package/.docs/raw/reference/vectors/lance.mdx +6 -4
  420. package/.docs/raw/reference/vectors/libsql.mdx +66 -13
  421. package/.docs/raw/reference/vectors/mongodb.mdx +90 -10
  422. package/.docs/raw/reference/vectors/opensearch.mdx +30 -3
  423. package/.docs/raw/reference/vectors/pg.mdx +58 -6
  424. package/.docs/raw/reference/vectors/pinecone.mdx +23 -8
  425. package/.docs/raw/reference/vectors/qdrant.mdx +148 -4
  426. package/.docs/raw/reference/vectors/s3vectors.mdx +8 -6
  427. package/.docs/raw/reference/vectors/turbopuffer.mdx +6 -4
  428. package/.docs/raw/reference/vectors/upstash.mdx +60 -6
  429. package/.docs/raw/reference/vectors/vectorize.mdx +5 -3
  430. package/.docs/raw/reference/voice/azure.mdx +2 -0
  431. package/.docs/raw/reference/voice/cloudflare.mdx +2 -0
  432. package/.docs/raw/reference/voice/composite-voice.mdx +4 -0
  433. package/.docs/raw/reference/voice/deepgram.mdx +2 -0
  434. package/.docs/raw/reference/voice/elevenlabs.mdx +2 -0
  435. package/.docs/raw/reference/voice/google-gemini-live.mdx +3 -0
  436. package/.docs/raw/reference/voice/google.mdx +2 -0
  437. package/.docs/raw/reference/voice/mastra-voice.mdx +2 -0
  438. package/.docs/raw/reference/voice/murf.mdx +2 -0
  439. package/.docs/raw/reference/voice/openai-realtime.mdx +3 -0
  440. package/.docs/raw/reference/voice/openai.mdx +2 -0
  441. package/.docs/raw/reference/voice/playai.mdx +2 -0
  442. package/.docs/raw/reference/voice/sarvam.mdx +2 -0
  443. package/.docs/raw/reference/voice/speechify.mdx +2 -0
  444. package/.docs/raw/reference/voice/voice.addInstructions.mdx +3 -0
  445. package/.docs/raw/reference/voice/voice.addTools.mdx +3 -0
  446. package/.docs/raw/reference/voice/voice.answer.mdx +4 -0
  447. package/.docs/raw/reference/voice/voice.close.mdx +3 -0
  448. package/.docs/raw/reference/voice/voice.connect.mdx +5 -1
  449. package/.docs/raw/reference/voice/voice.events.mdx +2 -0
  450. package/.docs/raw/reference/voice/voice.getSpeakers.mdx +3 -0
  451. package/.docs/raw/reference/voice/voice.listen.mdx +6 -0
  452. package/.docs/raw/reference/voice/voice.off.mdx +2 -0
  453. package/.docs/raw/reference/voice/voice.on.mdx +5 -1
  454. package/.docs/raw/reference/voice/voice.send.mdx +4 -0
  455. package/.docs/raw/reference/voice/voice.speak.mdx +6 -0
  456. package/.docs/raw/reference/voice/voice.updateConfig.mdx +2 -0
  457. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +55 -5
  458. package/.docs/raw/reference/workflows/run-methods/restart.mdx +3 -3
  459. package/.docs/raw/reference/workflows/run-methods/resume.mdx +6 -4
  460. package/.docs/raw/reference/workflows/run-methods/start.mdx +7 -5
  461. package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +145 -0
  462. package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +10 -8
  463. package/.docs/raw/reference/workflows/run.mdx +11 -3
  464. package/.docs/raw/reference/workflows/step.mdx +56 -3
  465. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +3 -1
  466. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +3 -1
  467. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +39 -2
  468. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +3 -1
  469. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +3 -1
  470. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +71 -4
  471. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +9 -7
  472. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +3 -1
  473. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +4 -6
  474. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +4 -6
  475. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +3 -1
  476. package/.docs/raw/reference/workflows/workflow.mdx +193 -2
  477. package/.docs/raw/{auth → server/auth}/auth0.mdx +40 -21
  478. package/.docs/raw/{auth → server/auth}/clerk.mdx +37 -16
  479. package/.docs/raw/{auth → server/auth}/firebase.mdx +47 -25
  480. package/.docs/raw/{auth → server/auth}/index.mdx +8 -6
  481. package/.docs/raw/{auth → server/auth}/jwt.mdx +22 -10
  482. package/.docs/raw/{auth → server/auth}/supabase.mdx +45 -25
  483. package/.docs/raw/{auth → server/auth}/workos.mdx +39 -20
  484. package/.docs/raw/{server-db → server}/custom-adapters.mdx +40 -24
  485. package/.docs/raw/{server-db → server}/custom-api-routes.mdx +6 -6
  486. package/.docs/raw/{server-db → server}/mastra-client.mdx +35 -38
  487. package/.docs/raw/server/mastra-server.mdx +86 -0
  488. package/.docs/raw/{server-db → server}/middleware.mdx +11 -9
  489. package/.docs/raw/{server-db → server}/request-context.mdx +85 -43
  490. package/.docs/raw/{server-db → server}/server-adapters.mdx +154 -33
  491. package/.docs/raw/streaming/events.mdx +16 -7
  492. package/.docs/raw/streaming/overview.mdx +30 -17
  493. package/.docs/raw/streaming/tool-streaming.mdx +8 -6
  494. package/.docs/raw/streaming/workflow-streaming.mdx +8 -8
  495. package/.docs/raw/tools-mcp/advanced-usage.mdx +4 -2
  496. package/.docs/raw/tools-mcp/mcp-overview.mdx +46 -12
  497. package/.docs/raw/tools-mcp/overview.mdx +14 -13
  498. package/.docs/raw/voice/overview.mdx +17 -2
  499. package/.docs/raw/voice/speech-to-speech.mdx +5 -0
  500. package/.docs/raw/voice/speech-to-text.mdx +4 -0
  501. package/.docs/raw/voice/text-to-speech.mdx +3 -0
  502. package/.docs/raw/workflows/agents-and-tools.mdx +70 -21
  503. package/.docs/raw/workflows/control-flow.mdx +369 -34
  504. package/.docs/raw/workflows/error-handling.mdx +192 -18
  505. package/.docs/raw/workflows/human-in-the-loop.mdx +8 -7
  506. package/.docs/raw/workflows/input-data-mapping.mdx +9 -7
  507. package/.docs/raw/workflows/overview.mdx +80 -34
  508. package/.docs/raw/workflows/snapshots.mdx +19 -45
  509. package/.docs/raw/workflows/suspend-and-resume.mdx +14 -14
  510. package/.docs/raw/workflows/time-travel.mdx +25 -21
  511. package/.docs/raw/workflows/workflow-state.mdx +7 -8
  512. package/CHANGELOG.md +260 -0
  513. package/README.md +36 -0
  514. package/dist/index.d.ts.map +1 -1
  515. package/dist/logger.d.ts +3 -0
  516. package/dist/logger.d.ts.map +1 -1
  517. package/dist/stdio.js +746 -49
  518. package/dist/tools/course.d.ts.map +1 -1
  519. package/dist/tools/embedded-docs.d.ts +276 -0
  520. package/dist/tools/embedded-docs.d.ts.map +1 -0
  521. package/package.json +9 -8
  522. package/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md +0 -1
  523. package/.docs/raw/deployment/building-mastra.mdx +0 -73
  524. package/.docs/raw/deployment/cloud-providers/index.mdx +0 -55
  525. package/.docs/raw/deployment/mastra-cloud/dashboard.mdx +0 -100
  526. package/.docs/raw/deployment/mastra-cloud/observability.mdx +0 -53
  527. package/.docs/raw/deployment/mastra-cloud/overview.mdx +0 -65
  528. package/.docs/raw/deployment/mastra-cloud/setting-up.mdx +0 -105
  529. package/.docs/raw/memory/conversation-history.mdx +0 -24
  530. package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
  531. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
  532. package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
  533. package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
  534. package/.docs/raw/memory/threads-and-resources.mdx +0 -95
  535. package/.docs/raw/reference/core/setTelemetry.mdx +0 -36
  536. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +0 -110
  537. package/.docs/raw/reference/memory/query.mdx +0 -189
  538. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +0 -70
  539. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +0 -66
  540. package/.docs/raw/server-db/mastra-server.mdx +0 -97
  541. package/.docs/raw/workflows/inngest-workflow.mdx +0 -363
@@ -31,7 +31,7 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
31
31
 
32
32
  Create a new file `src/mastra/agents/chefAgent.ts` and define your agent:
33
33
 
34
- ```ts copy title="src/mastra/agents/chefAgent.ts"
34
+ ```ts title="src/mastra/agents/chefAgent.ts"
35
35
  import { Agent } from "@mastra/core/agent";
36
36
 
37
37
  export const chefAgent = new Agent({
@@ -50,7 +50,7 @@ export const chefAgent = new Agent({
50
50
 
51
51
  In your `src/mastra/index.ts` file, register the agent:
52
52
 
53
- ```ts copy title="src/mastra/index.ts" {2, 5}
53
+ ```ts title="src/mastra/index.ts" {2, 5}
54
54
  import { Mastra } from "@mastra/core";
55
55
  import { chefAgent } from "./agents/chefAgent";
56
56
 
@@ -73,7 +73,7 @@ Depending on your requirements you can interact and get responses from the agent
73
73
 
74
74
  Create a new file `src/index.ts` and add a `main()` function to it. Inside, craft a query to ask the agent and log its response.
75
75
 
76
- ```ts copy title="src/index.ts"
76
+ ```ts title="src/index.ts"
77
77
  import { chefAgent } from "./mastra/agents/chefAgent";
78
78
 
79
79
  async function main() {
@@ -90,7 +90,7 @@ main();
90
90
 
91
91
  Afterwards, run the script:
92
92
 
93
- ```bash copy
93
+ ```bash
94
94
  npx bun src/index.ts
95
95
  ```
96
96
 
@@ -108,7 +108,7 @@ Query: In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some
108
108
 
109
109
  In the previous example you might have waited a bit for the response without any sign of progress. To show the agent's output as it creates it you should instead stream its response to the terminal.
110
110
 
111
- ```ts copy title="src/index.ts"
111
+ ```ts title="src/index.ts"
112
112
  import { chefAgent } from "./mastra/agents/chefAgent";
113
113
 
114
114
  async function main() {
@@ -132,7 +132,7 @@ main();
132
132
 
133
133
  Afterwards, run the script again:
134
134
 
135
- ```bash copy
135
+ ```bash
136
136
  npx bun src/index.ts
137
137
  ```
138
138
 
@@ -155,7 +155,7 @@ Instead of showing the agent's response to a human you might want to pass it alo
155
155
 
156
156
  Change your `src/index.ts` to the following:
157
157
 
158
- ```ts copy title="src/index.ts"
158
+ ```ts title="src/index.ts"
159
159
  import { chefAgent } from "./mastra/agents/chefAgent";
160
160
  import { z } from "zod";
161
161
 
@@ -198,12 +198,10 @@ Query: I want to make lasagna, can you generate a lasagna recipe for me?
198
198
  ingredients: [
199
199
  { name: "Lasagna noodles", amount: "12 sheets" },
200
200
  { name: "Ground beef", amount: "1 pound" },
201
- // ...
202
201
  ],
203
202
  steps: [
204
203
  "Preheat oven to 375°F (190°C).",
205
204
  "Cook the lasagna noodles according to package instructions.",
206
- // ...
207
205
  ]
208
206
  }
209
207
  ```
@@ -222,7 +220,7 @@ Learn how to interact with your agent through Mastra's API.
222
220
 
223
221
  You can run your agent as a service using the `mastra dev` command:
224
222
 
225
- ```bash copy
223
+ ```bash
226
224
  mastra dev
227
225
  ```
228
226
 
@@ -244,7 +242,7 @@ POST http://localhost:4111/api/agents/chefAgent/generate
244
242
 
245
243
  You can interact with the agent using `curl` from the command line:
246
244
 
247
- ```bash copy
245
+ ```bash
248
246
  curl -X POST http://localhost:4111/api/agents/chefAgent/generate \
249
247
  -H "Content-Type: application/json" \
250
248
  -d '{
@@ -30,7 +30,7 @@ Before you can create an MCP server you first need to install additional depende
30
30
 
31
31
  Add `@mastra/mcp` to your project:
32
32
 
33
- ```bash copy
33
+ ```bash
34
34
  npm install @mastra/mcp@beta
35
35
  ```
36
36
 
@@ -40,13 +40,13 @@ npm install @mastra/mcp@beta
40
40
 
41
41
  After following the default [installation guide](/guides/v1/getting-started/quickstart) your project will include files that are not relevant for this guide. You can safely remove them:
42
42
 
43
- ```bash copy
43
+ ```bash
44
44
  rm -rf src/mastra/agents src/mastra/workflows src/mastra/tools/weather-tool.ts
45
45
  ```
46
46
 
47
47
  You should also change the `src/mastra/index.ts` file like so:
48
48
 
49
- ```ts copy title="src/mastra/index.ts"
49
+ ```ts title="src/mastra/index.ts"
50
50
  import { Mastra } from "@mastra/core";
51
51
  import { PinoLogger } from "@mastra/loggers";
52
52
  import { LibSQLStore } from "@mastra/libsql";
@@ -70,13 +70,13 @@ export const mastra = new Mastra({
70
70
 
71
71
  Create a dedicated directory for your MCP server's logic and a `notes` directory for your notes:
72
72
 
73
- ```bash copy
73
+ ```bash
74
74
  mkdir notes src/mastra/mcp
75
75
  ```
76
76
 
77
77
  Create the following files:
78
78
 
79
- ```bash copy
79
+ ```bash
80
80
  touch src/mastra/mcp/{server,resources,prompts}.ts
81
81
  ```
82
82
 
@@ -113,7 +113,7 @@ Let's add the MCP server!
113
113
 
114
114
  In `src/mastra/mcp/server.ts`, define the MCP server instance:
115
115
 
116
- ```typescript copy title="src/mastra/mcp/server.ts"
116
+ ```typescript title="src/mastra/mcp/server.ts"
117
117
  import { MCPServer } from "@mastra/mcp";
118
118
 
119
119
  export const notes = new MCPServer({
@@ -126,7 +126,7 @@ export const notes = new MCPServer({
126
126
 
127
127
  Register this MCP server in your Mastra instance at `src/mastra/index.ts`. The key `notes` is the public identifier for your MCP server:
128
128
 
129
- ```typescript copy title="src/mastra/index.ts" {4, 15-17}
129
+ ```typescript title="src/mastra/index.ts" {4, 15-17}
130
130
  import { Mastra } from "@mastra/core";
131
131
  import { PinoLogger } from "@mastra/loggers";
132
132
  import { LibSQLStore } from "@mastra/libsql";
@@ -154,7 +154,7 @@ export const mastra = new Mastra({
154
154
 
155
155
  Resource handlers allow clients to discover and read the content your server manages. Implement handlers to work with markdown files in the `notes` directory. Add to the `src/mastra/mcp/resources.ts` file:
156
156
 
157
- ```typescript copy title="src/mastra/mcp/resources.ts"
157
+ ```typescript title="src/mastra/mcp/resources.ts"
158
158
  import fs from "fs/promises";
159
159
  import path from "path";
160
160
  import { fileURLToPath } from "url";
@@ -210,7 +210,7 @@ export const resourceHandlers: MCPServerResources = {
210
210
 
211
211
  Register these resource handlers in `src/mastra/mcp/server.ts`:
212
212
 
213
- ```typescript copy title="src/mastra/mcp/server.ts" {2, 8}
213
+ ```typescript title="src/mastra/mcp/server.ts" {2, 8}
214
214
  import { MCPServer } from "@mastra/mcp";
215
215
  import { resourceHandlers } from "./resources";
216
216
 
@@ -230,7 +230,7 @@ export const notes = new MCPServer({
230
230
  Tools are the actions your server can perform. Let's create a `write` tool.
231
231
  First, define the tool in `src/mastra/tools/write-note.ts`:
232
232
 
233
- ```typescript copy title="src/mastra/tools/write-note.ts"
233
+ ```typescript title="src/mastra/tools/write-note.ts"
234
234
  import { createTool } from "@mastra/core/tools";
235
235
  import { z } from "zod";
236
236
  import { fileURLToPath } from "url";
@@ -271,7 +271,7 @@ export const writeNoteTool = createTool({
271
271
 
272
272
  Register this tool in `src/mastra/mcp/server.ts`:
273
273
 
274
- ```typescript copy title="src/mastra/mcp/server.ts"
274
+ ```typescript title="src/mastra/mcp/server.ts"
275
275
  import { MCPServer } from "@mastra/mcp";
276
276
  import { resourceHandlers } from "./resources";
277
277
  import { writeNoteTool } from "../tools/write-note";
@@ -299,13 +299,13 @@ Prompt handlers provide ready-to-use prompts for clients. You'll add these three
299
299
 
300
300
  This requires a few markdown-parsing libraries you need to install:
301
301
 
302
- ```bash copy
302
+ ```bash
303
303
  npm install unified remark-parse gray-matter @types/unist
304
304
  ```
305
305
 
306
306
  Implement the prompts in `src/mastra/mcp/prompts.ts`:
307
307
 
308
- ```typescript copy title="src/mastra/mcp/prompts.ts"
308
+ ```typescript title="src/mastra/mcp/prompts.ts"
309
309
  import type { MCPServerPrompts } from "@mastra/mcp";
310
310
  import { unified } from "unified";
311
311
  import remarkParse from "remark-parse";
@@ -413,7 +413,7 @@ export const promptHandlers: MCPServerPrompts = {
413
413
 
414
414
  Register these prompt handlers in `src/mastra/mcp/server.ts`:
415
415
 
416
- ```typescript copy title="src/mastra/mcp/server.ts"
416
+ ```typescript title="src/mastra/mcp/server.ts"
417
417
  import { MCPServer } from "@mastra/mcp";
418
418
  import { resourceHandlers } from "./resources";
419
419
  import { writeNoteTool } from "../tools/write-note";
@@ -439,7 +439,7 @@ export const notes = new MCPServer({
439
439
 
440
440
  Great, you've authored your first MCP server! Now you can try it out by starting the Mastra dev server and opening [Studio](/docs/v1/getting-started/studio):
441
441
 
442
- ```bash copy
442
+ ```bash
443
443
  npm run dev
444
444
  ```
445
445
 
@@ -10,7 +10,7 @@ import StepItem from "@site/src/components/StepItem";
10
10
 
11
11
  In this guide, you'll create an AI research assistant that can analyze academic papers and answer specific questions about their content using Retrieval Augmented Generation (RAG).
12
12
 
13
- You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local LibSQL database.
13
+ You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local libSQL database.
14
14
 
15
15
  ## Prerequisites
16
16
 
@@ -59,7 +59,7 @@ Install additional dependencies
59
59
 
60
60
  After running the [installation guide](/guides/v1/getting-started/quickstart) you'll need to install additional dependencies:
61
61
 
62
- ```bash copy
62
+ ```bash
63
63
  npm install @mastra/rag@beta ai@^4.0.0
64
64
  ```
65
65
  </StepItem>
@@ -74,7 +74,7 @@ Now you'll create your RAG-enabled research assistant. The agent uses:
74
74
 
75
75
  Create a new file `src/mastra/agents/researchAgent.ts` and define your agent:
76
76
 
77
- ```ts copy title="src/mastra/agents/researchAgent.ts"
77
+ ```ts title="src/mastra/agents/researchAgent.ts"
78
78
  import { Agent } from "@mastra/core/agent";
79
79
  import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
80
80
  import { createVectorQueryTool } from "@mastra/rag";
@@ -114,13 +114,13 @@ In the root of your project, grab the absolute path with the `pwd` command. The
114
114
 
115
115
  In your `src/mastra/index.ts` file, add the following to your existing file and configuration:
116
116
 
117
- ```ts copy title="src/mastra/index.ts" {2, 4-6, 9}
117
+ ```ts title="src/mastra/index.ts" {2, 4-6, 9}
118
118
  import { Mastra } from "@mastra/core";
119
119
  import { LibSQLVector } from "@mastra/libsql";
120
120
 
121
121
  const libSqlVector = new LibSQLVector({
122
122
  id: 'research-vectors',
123
- connectionUrl: "file:/Users/your-name/guides/research-assistant/vector.db",
123
+ url: "file:/Users/your-name/guides/research-assistant/vector.db",
124
124
  });
125
125
 
126
126
  export const mastra = new Mastra({
@@ -128,12 +128,12 @@ export const mastra = new Mastra({
128
128
  });
129
129
  ```
130
130
 
131
- For the `connectionUrl` use the absolute path you got from the `pwd` command. This way the `vector.db` file is created at the root of your project.
131
+ For the `url` use the absolute path you got from the `pwd` command. This way the `vector.db` file is created at the root of your project.
132
132
 
133
133
  :::note
134
134
 
135
135
  For the purpose of this guide you are using a hardcoded absolute path to your
136
- local LibSQL file, however for production usage this won't work. You should
136
+ local libSQL file, however for production usage this won't work. You should
137
137
  use a remote persistent database then.
138
138
 
139
139
  :::
@@ -144,14 +144,14 @@ use a remote persistent database then.
144
144
 
145
145
  In the `src/mastra/index.ts` file, add the agent to Mastra:
146
146
 
147
- ```ts copy title="src/mastra/index.ts" {3, 10}
147
+ ```ts title="src/mastra/index.ts" {3, 10}
148
148
  import { Mastra } from "@mastra/core";
149
149
  import { LibSQLVector } from "@mastra/libsql";
150
150
  import { researchAgent } from "./agents/researchAgent";
151
151
 
152
152
  const libSqlVector = new LibSQLVector({
153
153
  id: 'research-vectors',
154
- connectionUrl: "file:/Users/your-name/guides/research-assistant/vector.db",
154
+ url: "file:/Users/your-name/guides/research-assistant/vector.db",
155
155
  });
156
156
 
157
157
  export const mastra = new Mastra({
@@ -176,7 +176,7 @@ In this step the research paper is retrieved by providing an URL, then converted
176
176
 
177
177
  Create a new file `src/store.ts` and add the following:
178
178
 
179
- ```ts copy title="src/store.ts"
179
+ ```ts title="src/store.ts"
180
180
  import { MDocument } from "@mastra/rag";
181
181
 
182
182
  // Load the paper
@@ -198,7 +198,7 @@ console.log("Number of chunks:", chunks.length);
198
198
 
199
199
  Run the file in your terminal:
200
200
 
201
- ```bash copy
201
+ ```bash
202
202
  npx bun src/store.ts
203
203
  ```
204
204
 
@@ -229,7 +229,7 @@ This allows the agent to efficiently search and retrieve relevant information.
229
229
 
230
230
  Open the `src/store.ts` file and add the following:
231
231
 
232
- ```ts copy title="src/store.ts"
232
+ ```ts title="src/store.ts"
233
233
  import { MDocument } from "@mastra/rag";
234
234
  import { embedMany } from "ai";
235
235
  import { mastra } from "./mastra";
@@ -276,7 +276,7 @@ await vectorStore.upsert({
276
276
 
277
277
  Lastly, you'll now need to store the embeddings by running the script again:
278
278
 
279
- ```bash copy
279
+ ```bash
280
280
  npx bun src/store.ts
281
281
  ```
282
282
 
@@ -292,7 +292,7 @@ Now that the vector database has all embeddings, you can test the research assis
292
292
 
293
293
  Create a new file `src/ask-agent.ts` and add different types of queries:
294
294
 
295
- ```ts title="src/ask-agent.ts" copy
295
+ ```ts title="src/ask-agent.ts"
296
296
  import { mastra } from "./mastra";
297
297
  const agent = mastra.getAgent("researchAgent");
298
298
 
@@ -306,7 +306,7 @@ console.log("Response:", response1.text);
306
306
 
307
307
  Run the script:
308
308
 
309
- ```bash copy
309
+ ```bash
310
310
  npx bun src/ask-agent.ts
311
311
  ```
312
312
 
@@ -323,7 +323,7 @@ Response: Sequence modeling with neural networks faces several key challenges:
323
323
 
324
324
  Try another question:
325
325
 
326
- ```ts title="src/ask-agent.ts" copy
326
+ ```ts title="src/ask-agent.ts"
327
327
  import { mastra } from "./mastra";
328
328
  const agent = mastra.getAgent("researchAgent");
329
329
 
@@ -373,7 +373,7 @@ curl -X POST http://localhost:4111/api/agents/researchAgent/generate \
373
373
 
374
374
  Explore these examples for more advanced RAG techniques:
375
375
 
376
- - [Filter RAG](/examples/v1/rag/usage/filter-rag) for filtering results using metadata
377
- - [Cleanup RAG](/examples/v1/rag/usage/cleanup-rag) for optimizing information density
378
- - [Chain of Thought RAG](/examples/v1/rag/usage/cot-rag) for complex reasoning queries using workflows
379
- - [Rerank RAG](/examples/v1/rag/usage/cleanup-rag) for improved result relevance
376
+ - [Filter RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/filter-rag) for filtering results using metadata
377
+ - [Cleanup RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/cleanup-rag) for optimizing information density
378
+ - [Chain of Thought RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/cot-rag) for complex reasoning queries using workflows
379
+ - [Rerank RAG](https://github.com/mastra-ai/mastra/tree/main/examples/basics/rag/rerank-rag) for improved result relevance
@@ -29,7 +29,7 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
29
29
 
30
30
  Create a new file `src/mastra/agents/stockAgent.ts` and define your agent:
31
31
 
32
- ```ts copy title="src/mastra/agents/stockAgent.ts"
32
+ ```ts title="src/mastra/agents/stockAgent.ts"
33
33
  import { Agent } from "@mastra/core/agent";
34
34
 
35
35
  export const stockAgent = new Agent({
@@ -47,7 +47,7 @@ export const stockAgent = new Agent({
47
47
 
48
48
  In your `src/mastra/index.ts` file, register the agent:
49
49
 
50
- ```ts copy title="src/mastra/index.ts" {2, 5}
50
+ ```ts title="src/mastra/index.ts" {2, 5}
51
51
  import { Mastra } from "@mastra/core";
52
52
  import { stockAgent } from "./agents/stockAgent";
53
53
 
@@ -103,7 +103,7 @@ export const stockPrices = createTool({
103
103
 
104
104
  Inside `src/mastra/agents/stockAgent.ts` import your newly created `stockPrices` tool and add it to the agent.
105
105
 
106
- ```ts copy title="src/mastra/agents/stockAgent.ts" {9-11}
106
+ ```ts title="src/mastra/agents/stockAgent.ts" {9-11}
107
107
  import { Agent } from "@mastra/core/agent";
108
108
  import { stockPrices } from "../tools/stockPrices";
109
109
 
@@ -133,7 +133,7 @@ Learn how to interact with your agent through Mastra's API.
133
133
 
134
134
  You can run your agent as a service using the `mastra dev` command:
135
135
 
136
- ```bash copy
136
+ ```bash
137
137
  mastra dev
138
138
  ```
139
139
 
@@ -155,7 +155,7 @@ POST http://localhost:4111/api/agents/stockAgent/generate
155
155
 
156
156
  You can interact with the agent using `curl` from the command line:
157
157
 
158
- ```bash copy
158
+ ```bash
159
159
  curl -X POST http://localhost:4111/api/agents/stockAgent/generate \
160
160
  -H "Content-Type: application/json" \
161
161
  -d '{
@@ -57,11 +57,11 @@ Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
57
57
  import { Agent } from "@mastra/core/agent";
58
58
 
59
59
  export const searchAgent = new Agent({
60
- id: "search-agent",
61
- name: "Search Agent",
62
- instructions:
63
- "You are a search agent that can search the web for information.",
64
- model: "openai/gpt-5.1",
60
+ id: "search-agent",
61
+ name: "Search Agent",
62
+ instructions:
63
+ "You are a search agent that can search the web for information.",
64
+ model: "openai/gpt-5.1",
65
65
  });
66
66
  ```
67
67
 
@@ -72,11 +72,11 @@ Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
72
72
  import { Agent } from "@mastra/core/agent";
73
73
 
74
74
  export const searchAgent = new Agent({
75
- id: "search-agent",
76
- name: "Search Agent",
77
- instructions:
78
- "You are a search agent that can search the web for information.",
79
- model: "google/gemini-2.5-flash",
75
+ id: "search-agent",
76
+ name: "Search Agent",
77
+ instructions:
78
+ "You are a search agent that can search the web for information.",
79
+ model: "google/gemini-2.5-flash",
80
80
  });
81
81
  ```
82
82
 
@@ -93,40 +93,40 @@ Setup the tool:
93
93
  <Tabs>
94
94
  <TabItem value="openai" label="Open AI">
95
95
 
96
- ```ts copy title="src/mastra/agents/searchAgent.ts" {9-12}
96
+ ```ts copy title="src/mastra/agents/searchAgent.ts" {1,9-12}
97
97
  import { openai } from "@ai-sdk/openai";
98
98
  import { Agent } from "@mastra/core/agent";
99
99
 
100
100
  export const searchAgent = new Agent({
101
- id: "search-agent",
102
- name: "Search Agent",
103
- instructions:
104
- "You are a search agent that can search the web for information.",
105
- model: "openai/gpt-5.1",
106
- tools: {
107
- webSearch: openai.tools.webSearch()
108
- }
101
+ id: "search-agent",
102
+ name: "Search Agent",
103
+ instructions:
104
+ "You are a search agent that can search the web for information.",
105
+ model: "openai/gpt-5.1",
106
+ tools: {
107
+ webSearch: openai.tools.webSearch()
108
+ }
109
109
  });
110
110
  ```
111
111
 
112
112
  </TabItem>
113
113
  <TabItem value="gemini" label="Gemini">
114
114
 
115
- ```ts copy title="src/mastra/agents/searchAgent.ts" {9-14}
115
+ ```ts copy title="src/mastra/agents/searchAgent.ts" {1,9-14}
116
116
  import { google } from "@ai-sdk/google";
117
117
  import { Agent } from "@mastra/core/agent";
118
118
 
119
119
  export const searchAgent = new Agent({
120
- id: "search-agent",
121
- name: "Search Agent",
122
- instructions:
123
- "You are a search agent that can search the web for information.",
124
- model: "google/gemini-2.5-flash",
125
- tools: {
126
- webSearch: google.tools.googleSearch({
127
- mode: "MODE_DYNAMIC"
128
- })
129
- }
120
+ id: "search-agent",
121
+ name: "Search Agent",
122
+ instructions:
123
+ "You are a search agent that can search the web for information.",
124
+ model: "google/gemini-2.5-flash",
125
+ tools: {
126
+ webSearch: google.tools.googleSearch({
127
+ mode: "MODE_DYNAMIC"
128
+ })
129
+ }
130
130
  });
131
131
  ```
132
132
 
@@ -140,7 +140,7 @@ Setup the tool:
140
140
 
141
141
  In your `src/mastra/index.ts` file, register the agent:
142
142
 
143
- ```ts copy title="src/mastra/index.ts" {2, 5}
143
+ ```ts title="src/mastra/index.ts" {2, 5}
144
144
  import { Mastra } from "@mastra/core";
145
145
  import { searchAgent } from "./agents/searchAgent";
146
146
 
@@ -155,7 +155,7 @@ export const mastra = new Mastra({
155
155
 
156
156
  You can test your agent with [Studio](/docs/v1/getting-started/studio) using the `mastra dev` command:
157
157
 
158
- ```bash copy
158
+ ```bash
159
159
  mastra dev
160
160
  ```
161
161
 
@@ -175,7 +175,7 @@ For more control over search behavior, you can integrate external search APIs as
175
175
 
176
176
  Install dependencies
177
177
 
178
- ```bash copy
178
+ ```bash
179
179
  npm install exa-js
180
180
  ```
181
181
 
@@ -185,7 +185,7 @@ npm install exa-js
185
185
 
186
186
  Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
187
187
 
188
- ```ts copy title="src/mastra/agents/searchAgent.ts"
188
+ ```ts title="src/mastra/agents/searchAgent.ts"
189
189
  import { Agent } from "@mastra/core/agent";
190
190
 
191
191
  export const searchAgent = new Agent({
@@ -203,7 +203,7 @@ export const searchAgent = new Agent({
203
203
 
204
204
  Setup the tool
205
205
 
206
- ```ts copy title="src/mastra/tools/searchTool.ts"
206
+ ```ts title="src/mastra/tools/searchTool.ts"
207
207
  import { createTool } from "@mastra/core/tools";
208
208
  import z from "zod";
209
209
  import Exa from "exa-js";
@@ -246,7 +246,7 @@ export const webSearch = createTool({
246
246
 
247
247
  Add to your Agent
248
248
 
249
- ```ts copy title="src/mastra/agents/searchAgent.ts"
249
+ ```ts title="src/mastra/agents/searchAgent.ts"
250
250
  import { webSearch } from "./tools/searchTool";
251
251
 
252
252
  export const searchAgent = new Agent({
@@ -267,7 +267,7 @@ export const searchAgent = new Agent({
267
267
 
268
268
  In your `src/mastra/index.ts` file, register the agent:
269
269
 
270
- ```ts copy title="src/mastra/index.ts" {2, 5}
270
+ ```ts title="src/mastra/index.ts" {2, 5}
271
271
  import { Mastra } from "@mastra/core";
272
272
  import { searchAgent } from "./agents/searchAgent";
273
273
 
@@ -282,7 +282,7 @@ export const mastra = new Mastra({
282
282
 
283
283
  You can test your agent with [Studio](/docs/v1/getting-started/studio) using the `mastra dev` command:
284
284
 
285
- ```bash copy
285
+ ```bash
286
286
  mastra dev
287
287
  ```
288
288
 
@@ -11,7 +11,7 @@ This guide demonstrates how to create a WhatsApp chat bot using Mastra agents an
11
11
 
12
12
  This example requires a WhatsApp Business API setup and uses the `anthropic` model. Add these environment variables to your `.env` file:
13
13
 
14
- ```bash title=".env" copy
14
+ ```bash title=".env"
15
15
  ANTHROPIC_API_KEY=<your-anthropic-api-key>
16
16
  WHATSAPP_VERIFY_TOKEN=<your-verify-token>
17
17
  WHATSAPP_ACCESS_TOKEN=<your-whatsapp-access-token>
@@ -23,7 +23,7 @@ WHATSAPP_API_VERSION=v22.0
23
23
 
24
24
  This client handles sending messages to users via the WhatsApp Business API.
25
25
 
26
- ```typescript title="src/whatsapp-client.ts" showLineNumbers copy
26
+ ```typescript title="src/whatsapp-client.ts"
27
27
  // Simple WhatsApp Business API client for sending messages
28
28
 
29
29
  interface SendMessageParams {
@@ -87,7 +87,7 @@ export async function sendWhatsAppMessage({ to, message }: SendMessageParams) {
87
87
 
88
88
  This agent handles the main conversation logic with a friendly, conversational personality.
89
89
 
90
- ```typescript title="src/mastra/agents/chat-agent.ts" showLineNumbers copy
90
+ ```typescript title="src/mastra/agents/chat-agent.ts"
91
91
  import { Agent } from "@mastra/core/agent";
92
92
  import { Memory } from "@mastra/memory";
93
93
  import { LibSQLStore } from "@mastra/libsql";
@@ -136,7 +136,7 @@ export const chatAgent = new Agent({
136
136
 
137
137
  This agent converts longer responses into natural, bite-sized text messages suitable for WhatsApp.
138
138
 
139
- ```typescript title="src/mastra/agents/text-message-agent.ts" showLineNumbers copy
139
+ ```typescript title="src/mastra/agents/text-message-agent.ts"
140
140
  import { Agent } from "@mastra/core/agent";
141
141
  import { Memory } from "@mastra/memory";
142
142
  import { LibSQLStore } from "@mastra/libsql";
@@ -174,7 +174,7 @@ export const textMessageAgent = new Agent({
174
174
 
175
175
  This workflow orchestrates the entire chat process: generating a response, breaking it into messages, and sending them via WhatsApp.
176
176
 
177
- ```typescript title="src/mastra/workflows/chat-workflow.ts" showLineNumbers copy
177
+ ```typescript title="src/mastra/workflows/chat-workflow.ts"
178
178
  import { createStep, createWorkflow } from "@mastra/core/workflows";
179
179
  import { z } from "zod";
180
180
  import { sendWhatsAppMessage } from "../../whatsapp-client";
@@ -300,7 +300,7 @@ chatWorkflow.commit();
300
300
 
301
301
  Configure your Mastra instance with the agents, workflow, and WhatsApp webhook endpoints.
302
302
 
303
- ```typescript title="src/mastra/index.ts" showLineNumbers copy
303
+ ```typescript title="src/mastra/index.ts"
304
304
  import { Mastra } from "@mastra/core";
305
305
  import { registerApiRoute } from "@mastra/core/server";
306
306
  import { PinoLogger } from "@mastra/loggers";
@@ -365,7 +365,7 @@ export const mastra = new Mastra({
365
365
 
366
366
  You can test the chat bot locally by simulating a WhatsApp webhook payload.
367
367
 
368
- ```typescript title="src/test-whatsapp-bot.ts" showLineNumbers copy
368
+ ```typescript title="src/test-whatsapp-bot.ts"
369
369
  import "dotenv/config";
370
370
 
371
371
  import { mastra } from "./mastra";
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  title: "Overview"
3
3
  description: "Guides on building with Mastra"
4
- showCopyButton: false
5
4
  ---
6
5
 
7
6
  import { CardGrid, CardGridItem } from "@site/src/components/CardGrid";
@@ -45,7 +45,7 @@ When using tools with TypeScript in AI SDK v5, Mastra provides type inference he
45
45
 
46
46
  The `InferUITool` type helper infers the input and output types of a single Mastra tool:
47
47
 
48
- ```typescript title="app/types.ts" copy
48
+ ```typescript title="app/types.ts"
49
49
  import { InferUITool, createTool } from "@mastra/core/tools";
50
50
  import { z } from "zod";
51
51
 
@@ -80,7 +80,7 @@ type WeatherUITool = InferUITool<typeof weatherTool>;
80
80
 
81
81
  The `InferUITools` type helper infers the input and output types of multiple tools:
82
82
 
83
- ```typescript title="app/mastra/tools.ts" copy
83
+ ```typescript title="app/mastra/tools.ts"
84
84
  import { InferUITools, createTool } from "@mastra/core/tools";
85
85
  import { z } from "zod";
86
86