@mastra/mcp-docs-server 1.0.0-beta.11 → 1.0.0-beta.14

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 (345) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +29 -29
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +51 -51
  3. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +45 -45
  4. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +180 -180
  5. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +39 -39
  6. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +39 -39
  7. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +68 -0
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +331 -331
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +31 -31
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +16 -16
  11. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +41 -41
  12. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +39 -39
  13. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  14. package/.docs/organized/changelogs/%40mastra%2Flance.md +39 -39
  15. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +45 -45
  16. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +24 -24
  17. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +24 -24
  18. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +39 -39
  19. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +39 -39
  20. package/.docs/organized/changelogs/%40mastra%2Fpg.md +45 -45
  21. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +96 -96
  22. package/.docs/organized/changelogs/%40mastra%2Frag.md +17 -17
  23. package/.docs/organized/changelogs/%40mastra%2Freact.md +49 -2
  24. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -0
  25. package/.docs/organized/changelogs/%40mastra%2Fserver.md +122 -122
  26. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +39 -39
  27. package/.docs/organized/changelogs/create-mastra.md +31 -31
  28. package/.docs/organized/changelogs/mastra.md +51 -51
  29. package/.docs/organized/code-examples/agent-v6.md +151 -0
  30. package/.docs/organized/code-examples/ai-elements.md +1 -1
  31. package/.docs/organized/code-examples/quick-start.md +0 -4
  32. package/.docs/organized/code-examples/stock-price-tool.md +21 -2
  33. package/.docs/raw/agents/adding-voice.mdx +2 -3
  34. package/.docs/raw/agents/agent-approval.mdx +139 -6
  35. package/.docs/raw/agents/agent-memory.mdx +24 -32
  36. package/.docs/raw/agents/guardrails.mdx +61 -51
  37. package/.docs/raw/agents/networks.mdx +9 -13
  38. package/.docs/raw/agents/overview.mdx +40 -24
  39. package/.docs/raw/agents/processors.mdx +20 -19
  40. package/.docs/raw/agents/structured-output.mdx +11 -7
  41. package/.docs/raw/agents/using-tools.mdx +5 -6
  42. package/.docs/raw/course/01-first-agent/07-creating-your-agent.md +1 -2
  43. package/.docs/raw/course/01-first-agent/12-connecting-tool-to-agent.md +1 -1
  44. package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +1 -2
  45. package/.docs/raw/course/02-agent-tools-mcp/05-updating-your-agent.md +1 -1
  46. package/.docs/raw/course/02-agent-tools-mcp/10-updating-agent-instructions-zapier.md +1 -1
  47. package/.docs/raw/course/02-agent-tools-mcp/16-updating-agent-instructions-github.md +1 -1
  48. package/.docs/raw/course/02-agent-tools-mcp/21-updating-agent-instructions-hackernews.md +1 -1
  49. package/.docs/raw/course/02-agent-tools-mcp/27-updating-agent-instructions-filesystem.md +1 -1
  50. package/.docs/raw/course/02-agent-tools-mcp/31-enhancing-memory-configuration.md +2 -2
  51. package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -2
  52. package/.docs/raw/course/03-agent-memory/08-configuring-conversation-history.md +1 -2
  53. package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +3 -4
  54. package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +2 -3
  55. package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +2 -3
  56. package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +1 -2
  57. package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +2 -3
  58. package/.docs/raw/course/04-workflows/11-creating-an-ai-agent.md +2 -3
  59. package/.docs/raw/deployment/cloud-providers.mdx +20 -0
  60. package/.docs/raw/deployment/{building-mastra.mdx → mastra-server.mdx} +5 -5
  61. package/.docs/raw/deployment/monorepo.mdx +23 -44
  62. package/.docs/raw/deployment/overview.mdx +32 -50
  63. package/.docs/raw/deployment/web-framework.mdx +15 -19
  64. package/.docs/raw/evals/custom-scorers.mdx +9 -6
  65. package/.docs/raw/evals/overview.mdx +3 -6
  66. package/.docs/raw/evals/running-in-ci.mdx +2 -2
  67. package/.docs/raw/getting-started/manual-install.mdx +20 -20
  68. package/.docs/raw/getting-started/mcp-docs-server.mdx +2 -2
  69. package/.docs/raw/getting-started/start.mdx +10 -1
  70. package/.docs/raw/getting-started/studio.mdx +1 -1
  71. package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +4 -4
  72. package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +1033 -79
  73. package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
  74. package/.docs/raw/guides/build-your-ui/copilotkit.mdx +11 -11
  75. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/amazon-ec2.mdx +9 -9
  76. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/aws-lambda.mdx +13 -16
  77. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/azure-app-services.mdx +5 -7
  78. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/cloudflare-deployer.mdx +8 -5
  79. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/digital-ocean.mdx +12 -15
  80. package/.docs/raw/guides/deployment/index.mdx +32 -0
  81. package/.docs/raw/guides/deployment/inngest.mdx +386 -0
  82. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/netlify-deployer.mdx +7 -3
  83. package/.docs/raw/{deployment/cloud-providers → guides/deployment}/vercel-deployer.mdx +8 -5
  84. package/.docs/raw/guides/getting-started/astro.mdx +292 -451
  85. package/.docs/raw/guides/getting-started/express.mdx +72 -153
  86. package/.docs/raw/guides/getting-started/hono.mdx +227 -0
  87. package/.docs/raw/guides/getting-started/next-js.mdx +170 -61
  88. package/.docs/raw/guides/getting-started/quickstart.mdx +4 -4
  89. package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
  90. package/.docs/raw/guides/getting-started/vite-react.mdx +317 -147
  91. package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
  92. package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
  93. package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
  94. package/.docs/raw/guides/guide/research-assistant.mdx +17 -17
  95. package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
  96. package/.docs/raw/guides/guide/web-search.mdx +8 -8
  97. package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
  98. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
  99. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +1 -1
  100. package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +17 -0
  101. package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +6 -0
  102. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +0 -2
  103. package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
  104. package/.docs/raw/index.mdx +2 -2
  105. package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/dashboard.mdx +2 -6
  106. package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/observability.mdx +1 -5
  107. package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/overview.mdx +2 -6
  108. package/.docs/raw/{deployment/mastra-cloud → mastra-cloud}/setting-up.mdx +8 -7
  109. package/.docs/raw/mcp/overview.mdx +31 -13
  110. package/.docs/raw/mcp/publishing-mcp-server.mdx +2 -2
  111. package/.docs/raw/memory/memory-processors.mdx +9 -9
  112. package/.docs/raw/memory/message-history.mdx +69 -0
  113. package/.docs/raw/memory/overview.mdx +34 -76
  114. package/.docs/raw/memory/semantic-recall.mdx +58 -49
  115. package/.docs/raw/memory/storage.mdx +188 -0
  116. package/.docs/raw/memory/working-memory.mdx +7 -7
  117. package/.docs/raw/observability/logging.mdx +10 -11
  118. package/.docs/raw/observability/overview.mdx +0 -1
  119. package/.docs/raw/observability/tracing/bridges/otel.mdx +2 -2
  120. package/.docs/raw/observability/tracing/exporters/cloud.mdx +1 -1
  121. package/.docs/raw/observability/tracing/exporters/default.mdx +3 -3
  122. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -2
  123. package/.docs/raw/observability/tracing/overview.mdx +23 -25
  124. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +3 -3
  125. package/.docs/raw/rag/chunking-and-embedding.mdx +18 -31
  126. package/.docs/raw/rag/graph-rag.mdx +220 -0
  127. package/.docs/raw/rag/overview.mdx +2 -3
  128. package/.docs/raw/rag/retrieval.mdx +34 -51
  129. package/.docs/raw/rag/vector-databases.mdx +29 -25
  130. package/.docs/raw/reference/agents/agent.mdx +3 -3
  131. package/.docs/raw/reference/agents/generate.mdx +1 -1
  132. package/.docs/raw/reference/agents/generateLegacy.mdx +2 -2
  133. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +3 -3
  134. package/.docs/raw/reference/agents/getDefaultOptions.mdx +3 -3
  135. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +3 -3
  136. package/.docs/raw/reference/agents/getDescription.mdx +1 -1
  137. package/.docs/raw/reference/agents/getInstructions.mdx +3 -3
  138. package/.docs/raw/reference/agents/getLLM.mdx +3 -3
  139. package/.docs/raw/reference/agents/getMemory.mdx +3 -3
  140. package/.docs/raw/reference/agents/getModel.mdx +3 -3
  141. package/.docs/raw/reference/agents/getTools.mdx +2 -2
  142. package/.docs/raw/reference/agents/getVoice.mdx +2 -2
  143. package/.docs/raw/reference/agents/listAgents.mdx +2 -2
  144. package/.docs/raw/reference/agents/listScorers.mdx +3 -3
  145. package/.docs/raw/reference/agents/listTools.mdx +2 -2
  146. package/.docs/raw/reference/agents/listWorkflows.mdx +2 -2
  147. package/.docs/raw/reference/agents/network.mdx +1 -1
  148. package/.docs/raw/reference/ai-sdk/chat-route.mdx +3 -3
  149. package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +2 -2
  150. package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +2 -2
  151. package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +2 -2
  152. package/.docs/raw/reference/ai-sdk/network-route.mdx +3 -3
  153. package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +6 -6
  154. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +127 -0
  155. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +107 -0
  156. package/.docs/raw/reference/ai-sdk/with-mastra.mdx +1 -1
  157. package/.docs/raw/reference/ai-sdk/workflow-route.mdx +3 -3
  158. package/.docs/raw/reference/auth/auth0.mdx +2 -3
  159. package/.docs/raw/reference/auth/clerk.mdx +2 -3
  160. package/.docs/raw/reference/auth/firebase.mdx +3 -5
  161. package/.docs/raw/reference/auth/jwt.mdx +2 -3
  162. package/.docs/raw/reference/auth/supabase.mdx +2 -3
  163. package/.docs/raw/reference/auth/workos.mdx +2 -3
  164. package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
  165. package/.docs/raw/reference/cli/mastra.mdx +10 -10
  166. package/.docs/raw/reference/client-js/agents.mdx +1 -2
  167. package/.docs/raw/reference/client-js/mastra-client.mdx +2 -2
  168. package/.docs/raw/reference/client-js/workflows.mdx +20 -0
  169. package/.docs/raw/reference/core/getAgent.mdx +1 -1
  170. package/.docs/raw/reference/core/getAgentById.mdx +1 -1
  171. package/.docs/raw/reference/core/getDeployer.mdx +1 -1
  172. package/.docs/raw/reference/core/getLogger.mdx +1 -1
  173. package/.docs/raw/reference/core/getMCPServer.mdx +1 -1
  174. package/.docs/raw/reference/core/getMCPServerById.mdx +1 -1
  175. package/.docs/raw/reference/core/getMemory.mdx +2 -2
  176. package/.docs/raw/reference/core/getServer.mdx +3 -3
  177. package/.docs/raw/reference/core/getStorage.mdx +2 -2
  178. package/.docs/raw/reference/core/getStoredAgentById.mdx +3 -3
  179. package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
  180. package/.docs/raw/reference/core/getVector.mdx +1 -1
  181. package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
  182. package/.docs/raw/reference/core/listAgents.mdx +1 -1
  183. package/.docs/raw/reference/core/listLogs.mdx +1 -1
  184. package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
  185. package/.docs/raw/reference/core/listMCPServers.mdx +1 -1
  186. package/.docs/raw/reference/core/listMemory.mdx +2 -2
  187. package/.docs/raw/reference/core/listStoredAgents.mdx +4 -4
  188. package/.docs/raw/reference/core/listVectors.mdx +1 -1
  189. package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
  190. package/.docs/raw/reference/core/setLogger.mdx +1 -1
  191. package/.docs/raw/reference/core/setStorage.mdx +2 -2
  192. package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
  193. package/.docs/raw/reference/deployer/cloudflare.mdx +1 -2
  194. package/.docs/raw/reference/deployer/deployer.mdx +0 -1
  195. package/.docs/raw/reference/deployer/netlify.mdx +1 -1
  196. package/.docs/raw/reference/deployer/vercel.mdx +2 -4
  197. package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
  198. package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
  199. package/.docs/raw/reference/evals/bias.mdx +1 -1
  200. package/.docs/raw/reference/evals/completeness.mdx +1 -1
  201. package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
  202. package/.docs/raw/reference/evals/context-precision.mdx +1 -1
  203. package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
  204. package/.docs/raw/reference/evals/hallucination.mdx +1 -1
  205. package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
  206. package/.docs/raw/reference/evals/prompt-alignment.mdx +7 -7
  207. package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
  208. package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
  209. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +10 -10
  210. package/.docs/raw/reference/evals/toxicity.mdx +1 -1
  211. package/.docs/raw/reference/logging/pino-logger.mdx +7 -8
  212. package/.docs/raw/reference/memory/createThread.mdx +2 -2
  213. package/.docs/raw/reference/memory/deleteMessages.mdx +2 -2
  214. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +2 -2
  215. package/.docs/raw/reference/memory/memory-class.mdx +3 -3
  216. package/.docs/raw/reference/memory/query.mdx +2 -2
  217. package/.docs/raw/reference/memory/recall.mdx +2 -2
  218. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
  219. package/.docs/raw/reference/processors/batch-parts-processor.mdx +2 -2
  220. package/.docs/raw/reference/processors/language-detector.mdx +2 -2
  221. package/.docs/raw/reference/processors/message-history-processor.mdx +2 -2
  222. package/.docs/raw/reference/processors/moderation-processor.mdx +3 -3
  223. package/.docs/raw/reference/processors/pii-detector.mdx +3 -3
  224. package/.docs/raw/reference/processors/processor-interface.mdx +13 -13
  225. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +2 -2
  226. package/.docs/raw/reference/processors/semantic-recall-processor.mdx +2 -2
  227. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +2 -2
  228. package/.docs/raw/reference/processors/token-limiter-processor.mdx +2 -2
  229. package/.docs/raw/reference/processors/tool-call-filter.mdx +3 -3
  230. package/.docs/raw/reference/processors/unicode-normalizer.mdx +2 -2
  231. package/.docs/raw/reference/processors/working-memory-processor.mdx +3 -3
  232. package/.docs/raw/reference/rag/chunk.mdx +1 -1
  233. package/.docs/raw/reference/rag/database-config.mdx +1 -1
  234. package/.docs/raw/reference/rag/extract-params.mdx +2 -2
  235. package/.docs/raw/reference/rag/metadata-filters.mdx +7 -7
  236. package/.docs/raw/reference/server/create-route.mdx +14 -14
  237. package/.docs/raw/reference/server/express-adapter.mdx +10 -11
  238. package/.docs/raw/reference/server/hono-adapter.mdx +10 -11
  239. package/.docs/raw/reference/server/mastra-server.mdx +22 -22
  240. package/.docs/raw/reference/server/routes.mdx +28 -1
  241. package/.docs/raw/reference/storage/cloudflare-d1.mdx +3 -3
  242. package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
  243. package/.docs/raw/reference/storage/convex.mdx +6 -6
  244. package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
  245. package/.docs/raw/reference/storage/lance.mdx +3 -3
  246. package/.docs/raw/reference/storage/libsql.mdx +69 -54
  247. package/.docs/raw/reference/storage/mongodb.mdx +80 -7
  248. package/.docs/raw/reference/storage/mssql.mdx +4 -4
  249. package/.docs/raw/{server-db/storage.mdx → reference/storage/overview.mdx} +13 -111
  250. package/.docs/raw/reference/storage/postgresql.mdx +78 -7
  251. package/.docs/raw/reference/storage/upstash.mdx +74 -2
  252. package/.docs/raw/reference/streaming/agents/stream.mdx +27 -5
  253. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +2 -2
  254. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
  255. package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +1 -1
  256. package/.docs/raw/reference/streaming/workflows/stream.mdx +35 -22
  257. package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +4 -4
  258. package/.docs/raw/reference/templates/overview.mdx +1 -2
  259. package/.docs/raw/reference/tools/create-tool.mdx +24 -5
  260. package/.docs/raw/reference/tools/graph-rag-tool.mdx +3 -3
  261. package/.docs/raw/reference/tools/vector-query-tool.mdx +4 -4
  262. package/.docs/raw/reference/vectors/astra.mdx +3 -3
  263. package/.docs/raw/reference/vectors/chroma.mdx +3 -3
  264. package/.docs/raw/reference/vectors/convex.mdx +12 -12
  265. package/.docs/raw/reference/vectors/couchbase.mdx +5 -5
  266. package/.docs/raw/reference/vectors/duckdb.mdx +10 -10
  267. package/.docs/raw/reference/vectors/elasticsearch.mdx +4 -4
  268. package/.docs/raw/reference/vectors/lance.mdx +4 -4
  269. package/.docs/raw/reference/vectors/libsql.mdx +61 -11
  270. package/.docs/raw/reference/vectors/mongodb.mdx +58 -5
  271. package/.docs/raw/reference/vectors/pg.mdx +53 -6
  272. package/.docs/raw/reference/vectors/pinecone.mdx +3 -3
  273. package/.docs/raw/reference/vectors/qdrant.mdx +3 -3
  274. package/.docs/raw/reference/vectors/s3vectors.mdx +6 -6
  275. package/.docs/raw/reference/vectors/turbopuffer.mdx +4 -4
  276. package/.docs/raw/reference/vectors/upstash.mdx +55 -6
  277. package/.docs/raw/reference/vectors/vectorize.mdx +3 -3
  278. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +2 -2
  279. package/.docs/raw/reference/workflows/run-methods/restart.mdx +1 -3
  280. package/.docs/raw/reference/workflows/run-methods/resume.mdx +2 -2
  281. package/.docs/raw/reference/workflows/run-methods/start.mdx +2 -2
  282. package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +143 -0
  283. package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +5 -5
  284. package/.docs/raw/reference/workflows/run.mdx +1 -1
  285. package/.docs/raw/reference/workflows/step.mdx +3 -3
  286. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
  287. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  288. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +37 -2
  289. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
  290. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
  291. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +6 -6
  292. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +7 -7
  293. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  294. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +2 -2
  295. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +2 -2
  296. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +2 -2
  297. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  298. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +2 -2
  299. package/.docs/raw/reference/workflows/workflow.mdx +17 -3
  300. package/.docs/raw/{auth → server/auth}/auth0.mdx +20 -14
  301. package/.docs/raw/{auth → server/auth}/clerk.mdx +16 -9
  302. package/.docs/raw/{auth → server/auth}/firebase.mdx +21 -15
  303. package/.docs/raw/{auth → server/auth}/index.mdx +6 -6
  304. package/.docs/raw/{auth → server/auth}/jwt.mdx +14 -7
  305. package/.docs/raw/{auth → server/auth}/supabase.mdx +16 -9
  306. package/.docs/raw/{auth → server/auth}/workos.mdx +19 -13
  307. package/.docs/raw/{server-db → server}/custom-adapters.mdx +13 -13
  308. package/.docs/raw/{server-db → server}/custom-api-routes.mdx +3 -5
  309. package/.docs/raw/{server-db → server}/mastra-client.mdx +26 -15
  310. package/.docs/raw/{server-db → server}/mastra-server.mdx +8 -8
  311. package/.docs/raw/{server-db → server}/middleware.mdx +9 -9
  312. package/.docs/raw/{server-db → server}/request-context.mdx +33 -32
  313. package/.docs/raw/{server-db → server}/server-adapters.mdx +12 -12
  314. package/.docs/raw/streaming/events.mdx +14 -7
  315. package/.docs/raw/streaming/overview.mdx +21 -10
  316. package/.docs/raw/streaming/tool-streaming.mdx +6 -6
  317. package/.docs/raw/streaming/workflow-streaming.mdx +6 -8
  318. package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
  319. package/.docs/raw/tools-mcp/mcp-overview.mdx +31 -12
  320. package/.docs/raw/tools-mcp/overview.mdx +10 -11
  321. package/.docs/raw/voice/overview.mdx +1 -1
  322. package/.docs/raw/workflows/agents-and-tools.mdx +28 -19
  323. package/.docs/raw/workflows/control-flow.mdx +27 -40
  324. package/.docs/raw/workflows/error-handling.mdx +172 -18
  325. package/.docs/raw/workflows/human-in-the-loop.mdx +6 -7
  326. package/.docs/raw/workflows/inngest-workflow.mdx +8 -9
  327. package/.docs/raw/workflows/input-data-mapping.mdx +7 -7
  328. package/.docs/raw/workflows/overview.mdx +34 -23
  329. package/.docs/raw/workflows/snapshots.mdx +14 -44
  330. package/.docs/raw/workflows/suspend-and-resume.mdx +7 -7
  331. package/.docs/raw/workflows/time-travel.mdx +16 -16
  332. package/.docs/raw/workflows/workflow-state.mdx +5 -8
  333. package/CHANGELOG.md +23 -0
  334. package/dist/logger.d.ts +3 -0
  335. package/dist/logger.d.ts.map +1 -1
  336. package/dist/stdio.js +53 -0
  337. package/package.json +4 -4
  338. package/.docs/organized/changelogs/%40internal%2Fai-sdk-v4.md +0 -1
  339. package/.docs/raw/deployment/cloud-providers/index.mdx +0 -55
  340. package/.docs/raw/memory/conversation-history.mdx +0 -24
  341. package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
  342. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
  343. package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
  344. package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
  345. package/.docs/raw/memory/threads-and-resources.mdx +0 -95
@@ -9,7 +9,7 @@ The `.getVector()` method is used to retrieve a vector store by its name. The me
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.getVector("testVectorStore");
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.getWorkflow()` method is used to retrieve a workflow by its ID. The method
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.getWorkflow("testWorkflow");
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.listAgents()` method is used to retrieve all agents that have been configu
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.listAgents();
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.listLogs()` method is used to retrieve all logs for a specific transport I
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.listLogs("456");
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.listLogsByRunId()` method is used to retrieve logs for a specific run ID a
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.listLogsByRunId({ runId: "123", transportId: "456" });
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.listMCPServers()` method is used to retrieve all MCP server instances that
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  // Register MCP servers
14
14
  const server1 = new MCPServer({
15
15
  id: 'server-one',
@@ -9,7 +9,7 @@ The `.listMemory()` method returns all memory instances registered with the Mast
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  const memoryInstances = mastra.listMemory();
14
14
 
15
15
  for (const [key, memory] of Object.entries(memoryInstances)) {
@@ -36,7 +36,7 @@ This method takes no parameters.
36
36
 
37
37
  ## Example: Checking Registered Memory
38
38
 
39
- ```typescript copy
39
+ ```typescript
40
40
  import { Mastra } from "@mastra/core";
41
41
  import { Memory } from "@mastra/memory";
42
42
  import { LibSQLStore } from "@mastra/libsql";
@@ -9,7 +9,7 @@ The `.listStoredAgents()` method retrieves a paginated list of agent configurati
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  // Get Agent instances from storage
14
14
  const { agents, total, hasMore } = await mastra.listStoredAgents();
15
15
 
@@ -20,7 +20,7 @@ for (const agent of agents) {
20
20
  }
21
21
  ```
22
22
 
23
- ```typescript copy
23
+ ```typescript
24
24
  // Get paginated results with raw storage data
25
25
  const result = await mastra.listStoredAgents({
26
26
  page: 0,
@@ -127,7 +127,7 @@ If a referenced primitive is not found, a warning is logged but the agent is sti
127
127
 
128
128
  ## Example: Iterating Through All Stored Agents
129
129
 
130
- ```typescript copy
130
+ ```typescript
131
131
  async function getAllStoredAgents(mastra: Mastra) {
132
132
  const allAgents: Agent[] = [];
133
133
  let page = 0;
@@ -147,5 +147,5 @@ async function getAllStoredAgents(mastra: Mastra) {
147
147
  ## Related
148
148
 
149
149
  - [Mastra.getStoredAgentById()](/reference/v1/core/getStoredAgentById)
150
- - [Storage overview](/docs/v1/server-db/storage)
150
+ - [Storage overview](/reference/v1/storage/overview)
151
151
  - [Agents overview](/docs/v1/agents/overview)
@@ -9,7 +9,7 @@ The `.listVectors()` method is used to retrieve all vector stores that have been
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.listVectors();
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.listWorkflows()` method is used to retrieve all workflows that have been c
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.listWorkflows();
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.setLogger()` method is used to set the logger for all components (agents,
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.setLogger({ logger: new PinoLogger({ name: "testLogger" }) });
14
14
  ```
15
15
 
@@ -9,7 +9,7 @@ The `.setStorage()` method is used to set the storage instance for the Mastra in
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.setStorage(
14
14
  new LibSQLStore({
15
15
  id: 'mastra-storage',
@@ -36,5 +36,5 @@ This method does not return a value.
36
36
 
37
37
  ## Related
38
38
 
39
- - [Storage overview](/docs/v1/server-db/storage)
39
+ - [Storage overview](/reference/v1/storage/overview)
40
40
  - [Storage reference](/reference/v1/storage/libsql)
@@ -9,7 +9,7 @@ The `.setTelemetry()` method is used to set the telemetry configuration for all
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  mastra.setTelemetry({ export: { type: "console" } });
14
14
  ```
15
15
 
@@ -9,12 +9,11 @@ The `CloudflareDeployer` class handles deployment of standalone Mastra applicati
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript title="src/mastra/index.ts" showLineNumbers copy
12
+ ```typescript title="src/mastra/index.ts"
13
13
  import { Mastra } from "@mastra/core";
14
14
  import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
15
15
 
16
16
  export const mastra = new Mastra({
17
- // ...
18
17
  deployer: new CloudflareDeployer({
19
18
  projectName: "hello-mastra",
20
19
  routes: [
@@ -28,7 +28,6 @@ class CustomDeployer extends Deployer {
28
28
  await this._bundle("server.ts", "mastra.ts", outputDirectory);
29
29
 
30
30
  // Custom deployment logic
31
- // ...
32
31
  }
33
32
  }
34
33
  ```
@@ -9,7 +9,7 @@ The `NetlifyDeployer` class handles deployment of standalone Mastra applications
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript title="src/mastra/index.ts" copy
12
+ ```typescript title="src/mastra/index.ts"
13
13
  import { Mastra } from "@mastra/core";
14
14
  import { NetlifyDeployer } from "@mastra/deployer-netlify";
15
15
 
@@ -9,12 +9,11 @@ The `VercelDeployer` class handles deployment of standalone Mastra applications
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript title="src/mastra/index.ts" showLineNumbers copy
12
+ ```typescript title="src/mastra/index.ts"
13
13
  import { Mastra } from "@mastra/core";
14
14
  import { VercelDeployer } from "@mastra/deployer-vercel";
15
15
 
16
16
  export const mastra = new Mastra({
17
- // ...
18
17
  deployer: new VercelDeployer(),
19
18
  });
20
19
  ```
@@ -31,12 +30,11 @@ These options are merged into `.vercel/output/functions/index.func/.vc-config.js
31
30
 
32
31
  ### Example with overrides
33
32
 
34
- ```typescript title="src/mastra/index.ts" showLineNumbers copy
33
+ ```typescript title="src/mastra/index.ts"
35
34
  import { Mastra } from "@mastra/core";
36
35
  import { VercelDeployer } from "@mastra/deployer-vercel";
37
36
 
38
37
  export const mastra = new Mastra({
39
- // ...
40
38
  deployer: new VercelDeployer({
41
39
  maxDuration: 600,
42
40
  memory: 1536,
@@ -116,7 +116,7 @@ A relevancy score between 0 and 1:
116
116
 
117
117
  Evaluate agent responses for relevancy across different scenarios:
118
118
 
119
- ```typescript title="src/example-answer-relevancy.ts" showLineNumbers copy
119
+ ```typescript title="src/example-answer-relevancy.ts"
120
120
  import { runEvals } from "@mastra/core/evals";
121
121
  import { createAnswerRelevancyScorer } from "@mastra/evals/scorers/prebuilt";
122
122
  import { myAgent } from "./agent";
@@ -153,7 +153,7 @@ Score calculation: `max(0, base_score - contradiction_penalty - missing_penalty
153
153
 
154
154
  Evaluate agent responses for similarity to ground truth across different scenarios:
155
155
 
156
- ```typescript title="src/example-answer-similarity.ts" showLineNumbers copy
156
+ ```typescript title="src/example-answer-similarity.ts"
157
157
  import { runEvals } from "@mastra/core/evals";
158
158
  import { createAnswerSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
159
159
  import { myAgent } from "./agent";
@@ -127,7 +127,7 @@ A bias score between 0 and 1:
127
127
 
128
128
  Evaluate agent responses for bias across different types of questions:
129
129
 
130
- ```typescript title="src/example-bias.ts" showLineNumbers copy
130
+ ```typescript title="src/example-bias.ts"
131
131
  import { runEvals } from "@mastra/core/evals";
132
132
  import { createBiasScorer } from "@mastra/evals/scorers/prebuilt";
133
133
  import { myAgent } from "./agent";
@@ -109,7 +109,7 @@ A completeness score between 0 and 1:
109
109
 
110
110
  Evaluate agent responses for completeness across different query complexities:
111
111
 
112
- ```typescript title="src/example-completeness.ts" showLineNumbers copy
112
+ ```typescript title="src/example-completeness.ts"
113
113
  import { runEvals } from "@mastra/core/evals";
114
114
  import { createCompletenessScorer } from "@mastra/evals/scorers/prebuilt";
115
115
  import { myAgent } from "./agent";
@@ -82,7 +82,7 @@ Final score: `similarity_value * scale`
82
82
 
83
83
  Evaluate textual similarity between expected and actual agent outputs:
84
84
 
85
- ```typescript title="src/example-content-similarity.ts" showLineNumbers copy
85
+ ```typescript title="src/example-content-similarity.ts"
86
86
  import { runEvals } from "@mastra/core/evals";
87
87
  import { createContentSimilarityScorer } from "@mastra/evals/scorers/prebuilt";
88
88
  import { myAgent } from "./agent";
@@ -190,7 +190,7 @@ const scorer = createContextPrecisionScorer({
190
190
 
191
191
  Evaluate RAG system context retrieval precision for different queries:
192
192
 
193
- ```typescript title="src/example-context-precision.ts" showLineNumbers copy
193
+ ```typescript title="src/example-context-precision.ts"
194
194
  import { runEvals } from "@mastra/core/evals";
195
195
  import { createContextPrecisionScorer } from "@mastra/evals/scorers/prebuilt";
196
196
  import { myAgent } from "./agent";
@@ -126,7 +126,7 @@ A faithfulness score between 0 and 1:
126
126
 
127
127
  Evaluate agent responses for faithfulness to provided context:
128
128
 
129
- ```typescript title="src/example-faithfulness.ts" showLineNumbers copy
129
+ ```typescript title="src/example-faithfulness.ts"
130
130
  import { runEvals } from "@mastra/core/evals";
131
131
  import { createFaithfulnessScorer } from "@mastra/evals/scorers/prebuilt";
132
132
  import { myAgent } from "./agent";
@@ -135,7 +135,7 @@ A hallucination score between 0 and 1:
135
135
 
136
136
  Evaluate agent responses for hallucinations against provided context:
137
137
 
138
- ```typescript title="src/example-hallucination.ts" showLineNumbers copy
138
+ ```typescript title="src/example-hallucination.ts"
139
139
  import { runEvals } from "@mastra/core/evals";
140
140
  import { createHallucinationScorer } from "@mastra/evals/scorers/prebuilt";
141
141
  import { myAgent } from "./agent";
@@ -106,7 +106,7 @@ The scorer handles several special cases:
106
106
 
107
107
  Evaluate keyword coverage between input queries and agent responses:
108
108
 
109
- ```typescript title="src/example-keyword-coverage.ts" showLineNumbers copy
109
+ ```typescript title="src/example-keyword-coverage.ts"
110
110
  import { runEvals } from "@mastra/core/evals";
111
111
  import { createKeywordCoverageScorer } from "@mastra/evals/scorers/prebuilt";
112
112
  import { myAgent } from "./agent";
@@ -107,7 +107,7 @@ The `createPromptAlignmentScorerLLM()` function creates a scorer that evaluates
107
107
 
108
108
  You can customize the Prompt Alignment Scorer by adjusting the scale parameter and evaluation mode to fit your scoring needs.
109
109
 
110
- ```typescript showLineNumbers copy
110
+ ```typescript
111
111
  const scorer = createPromptAlignmentScorerLLM({
112
112
  model: "openai/gpt-5.1",
113
113
  options: {
@@ -417,7 +417,7 @@ const result = await scorer.run({
417
417
 
418
418
  In this example, the response fully addresses the user's prompt with all requirements met.
419
419
 
420
- ```typescript title="src/example-excellent-prompt-alignment.ts" showLineNumbers copy
420
+ ```typescript title="src/example-excellent-prompt-alignment.ts"
421
421
  import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
422
422
 
423
423
  const scorer = createPromptAlignmentScorerLLM({
@@ -465,7 +465,7 @@ The output receives a high score because it perfectly addresses the intent, fulf
465
465
 
466
466
  In this example, the response addresses the core intent but misses some requirements or has format issues.
467
467
 
468
- ```typescript title="src/example-partial-prompt-alignment.ts" showLineNumbers copy
468
+ ```typescript title="src/example-partial-prompt-alignment.ts"
469
469
  import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
470
470
 
471
471
  const scorer = createPromptAlignmentScorerLLM({
@@ -506,7 +506,7 @@ The output receives a lower score because while the content is accurate, it does
506
506
 
507
507
  In this example, the response fails to address the user's specific requirements.
508
508
 
509
- ```typescript title="src/example-poor-prompt-alignment.ts" showLineNumbers copy
509
+ ```typescript title="src/example-poor-prompt-alignment.ts"
510
510
  import { createPromptAlignmentScorerLLM } from "@mastra/evals/scorers/prebuilt";
511
511
 
512
512
  const scorer = createPromptAlignmentScorerLLM({
@@ -552,7 +552,7 @@ The output receives a low score because it only partially fulfills the requireme
552
552
 
553
553
  Evaluates how well the response addresses the user's request, ignoring system instructions:
554
554
 
555
- ```typescript title="src/example-user-mode.ts" showLineNumbers copy
555
+ ```typescript title="src/example-user-mode.ts"
556
556
  const scorer = createPromptAlignmentScorerLLM({
557
557
  model: "openai/gpt-5.1",
558
558
  options: { evaluationMode: "user" },
@@ -584,7 +584,7 @@ const result = await scorer.run({
584
584
 
585
585
  Evaluates compliance with system behavioral guidelines and constraints:
586
586
 
587
- ```typescript title="src/example-system-mode.ts" showLineNumbers copy
587
+ ```typescript title="src/example-system-mode.ts"
588
588
  const scorer = createPromptAlignmentScorerLLM({
589
589
  model: "openai/gpt-5.1",
590
590
  options: { evaluationMode: "system" },
@@ -617,7 +617,7 @@ const result = await scorer.run({
617
617
 
618
618
  Evaluates both user intent fulfillment and system compliance with weighted scoring (70% user, 30% system):
619
619
 
620
- ```typescript title="src/example-both-mode.ts" showLineNumbers copy
620
+ ```typescript title="src/example-both-mode.ts"
621
621
  const scorer = createPromptAlignmentScorerLLM({
622
622
  model: "openai/gpt-5.1",
623
623
  options: { evaluationMode: "both" }, // This is the default
@@ -87,7 +87,7 @@ A textual difference score between 0 and 1:
87
87
 
88
88
  Measure textual differences between expected and actual agent outputs:
89
89
 
90
- ```typescript title="src/example-textual-difference.ts" showLineNumbers copy
90
+ ```typescript title="src/example-textual-difference.ts"
91
91
  import { runEvals } from "@mastra/core/evals";
92
92
  import { createTextualDifferenceScorer } from "@mastra/evals/scorers/prebuilt";
93
93
  import { myAgent } from "./agent";
@@ -98,7 +98,7 @@ Object with tone metrics:
98
98
 
99
99
  Evaluate tone consistency between related agent responses:
100
100
 
101
- ```typescript title="src/example-tone-consistency.ts" showLineNumbers copy
101
+ ```typescript title="src/example-tone-consistency.ts"
102
102
  import { runEvals } from "@mastra/core/evals";
103
103
  import { createToneScorer } from "@mastra/evals/scorers/prebuilt";
104
104
  import { myAgent } from "./agent";
@@ -89,7 +89,7 @@ When `expectedToolOrder` is provided, the scorer validates tool calling sequence
89
89
 
90
90
  ### Code-Based Scorer Options
91
91
 
92
- ```typescript showLineNumbers copy
92
+ ```typescript
93
93
  // Standard mode - passes if expected tool is called
94
94
  const lenientScorer = createCodeScorer({
95
95
  expectedTool: "search-tool",
@@ -135,7 +135,7 @@ The code-based scorer provides deterministic, binary scoring (0 or 1) based on e
135
135
 
136
136
  ### Correct tool selection
137
137
 
138
- ```typescript title="src/example-correct-tool.ts" showLineNumbers copy
138
+ ```typescript title="src/example-correct-tool.ts"
139
139
  const scorer = createToolCallAccuracyScorerCode({
140
140
  expectedTool: "weather-tool",
141
141
  });
@@ -177,7 +177,7 @@ console.log(result.preprocessStepResult?.correctToolCalled); // true
177
177
 
178
178
  Only passes if exactly one tool is called:
179
179
 
180
- ```typescript title="src/example-strict-mode.ts" showLineNumbers copy
180
+ ```typescript title="src/example-strict-mode.ts"
181
181
  const strictScorer = createToolCallAccuracyScorerCode({
182
182
  expectedTool: "weather-tool",
183
183
  strictMode: true,
@@ -216,7 +216,7 @@ console.log(result.score); // 0 - fails because multiple tools were called
216
216
 
217
217
  Validates that tools are called in a specific sequence:
218
218
 
219
- ```typescript title="src/example-order-validation.ts" showLineNumbers copy
219
+ ```typescript title="src/example-order-validation.ts"
220
220
  const orderScorer = createToolCallAccuracyScorerCode({
221
221
  expectedTool: "auth-tool", // ignored when order is specified
222
222
  expectedToolOrder: ["auth-tool", "fetch-tool"],
@@ -255,7 +255,7 @@ console.log(result.score); // 1 - correct order
255
255
 
256
256
  Allows extra tools as long as expected tools maintain relative order:
257
257
 
258
- ```typescript title="src/example-flexible-order.ts" showLineNumbers copy
258
+ ```typescript title="src/example-flexible-order.ts"
259
259
  const flexibleOrderScorer = createToolCallAccuracyScorerCode({
260
260
  expectedTool: "auth-tool",
261
261
  expectedToolOrder: ["auth-tool", "fetch-tool"],
@@ -346,7 +346,7 @@ The LLM-based scorer provides:
346
346
 
347
347
  ### LLM-Based Scorer Options
348
348
 
349
- ```typescript showLineNumbers copy
349
+ ```typescript
350
350
  // Basic configuration
351
351
  const basicLLMScorer = createLLMScorer({
352
352
  model: 'openai/gpt-5.1',
@@ -387,7 +387,7 @@ The LLM-based scorer uses AI to evaluate whether tool selections are appropriate
387
387
 
388
388
  ### Basic LLM evaluation
389
389
 
390
- ```typescript title="src/example-llm-basic.ts" showLineNumbers copy
390
+ ```typescript title="src/example-llm-basic.ts"
391
391
  const llmScorer = createToolCallAccuracyScorerLLM({
392
392
  model: "openai/gpt-5.1",
393
393
  availableTools: [
@@ -440,7 +440,7 @@ console.log(result.reason); // "The agent correctly used the weather-tool to add
440
440
 
441
441
  ### Handling inappropriate tool usage
442
442
 
443
- ```typescript title="src/example-llm-inappropriate.ts" showLineNumbers copy
443
+ ```typescript title="src/example-llm-inappropriate.ts"
444
444
  const inputMessages = [
445
445
  createUIMessage({
446
446
  content: "What is the weather in Tokyo?",
@@ -477,7 +477,7 @@ console.log(result.reason); // "The agent used search-tool when weather-tool wou
477
477
 
478
478
  The LLM scorer recognizes when agents appropriately ask for clarification:
479
479
 
480
- ```typescript title="src/example-llm-clarification.ts" showLineNumbers copy
480
+ ```typescript title="src/example-llm-clarification.ts"
481
481
  const vagueInput = [
482
482
  createUIMessage({
483
483
  content: 'I need help with something',
@@ -509,7 +509,7 @@ console.log(result.reason); // "The agent appropriately asked for clarification
509
509
 
510
510
  Here's an example using both scorers on the same data:
511
511
 
512
- ```typescript title="src/example-comparison.ts" showLineNumbers copy
512
+ ```typescript title="src/example-comparison.ts"
513
513
  import {
514
514
  createToolCallAccuracyScorerCode as createCodeScorer,
515
515
  createToolCallAccuracyScorerLLM as createLLMScorer
@@ -123,7 +123,7 @@ A toxicity score between 0 and 1:
123
123
 
124
124
  Evaluate agent responses for toxic, biased, or harmful content:
125
125
 
126
- ```typescript title="src/example-toxicity.ts" showLineNumbers copy
126
+ ```typescript title="src/example-toxicity.ts"
127
127
  import { runEvals } from "@mastra/core/evals";
128
128
  import { createToxicityScorer } from "@mastra/evals/scorers/prebuilt";
129
129
  import { myAgent } from "./agent";
@@ -7,16 +7,15 @@ description: Documentation for PinoLogger, which provides methods to record even
7
7
 
8
8
  A Logger instance is created using `new PinoLogger()` and provides methods to record events at various severity levels.
9
9
 
10
- When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/deployment/mastra-cloud/dashboard#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
10
+ When deploying to Mastra Cloud, logs are displayed on the [Logs](/docs/v1/mastra-cloud/dashboard#logs) page. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
11
11
 
12
12
  ## Usage example
13
13
 
14
- ```typescript title="src/mastra/index.ts" showLineNumbers copy
14
+ ```typescript title="src/mastra/index.ts"
15
15
  import { Mastra } from "@mastra/core";
16
16
  import { PinoLogger } from "@mastra/loggers";
17
17
 
18
18
  export const mastra = new Mastra({
19
- // ...
20
19
  logger: new PinoLogger({
21
20
  name: "Mastra",
22
21
  level: "info",
@@ -63,7 +62,7 @@ export const mastra = new Mastra({
63
62
 
64
63
  Writes structured logs to a file using the `FileTransport`. The logger accepts a plain message as the first argument and structured metadata as the second argument. These are internally converted to a `BaseLogMessage` and persisted to the configured file path.
65
64
 
66
- ```typescript title="src/mastra/loggers/file-transport.ts" showLineNumbers copy
65
+ ```typescript title="src/mastra/loggers/file-transport.ts"
67
66
  import { FileTransport } from "@mastra/loggers/file";
68
67
  import { PinoLogger } from "@mastra/loggers/pino";
69
68
 
@@ -76,7 +75,7 @@ export const fileLogger = new PinoLogger({
76
75
 
77
76
  ### File transport usage
78
77
 
79
- ```typescript showLineNumbers copy
78
+ ```typescript
80
79
  fileLogger.warn("Low disk space", {
81
80
  destinationPath: "system",
82
81
  type: "WORKFLOW",
@@ -87,7 +86,7 @@ fileLogger.warn("Low disk space", {
87
86
 
88
87
  Streams structured logs to a remote Redis list using the `UpstashTransport`. The logger accepts a string message and a structured metadata object. This enables centralized logging for distributed environments, supporting filtering by `destinationPath`, `type`, and `runId`.
89
88
 
90
- ```typescript title="src/mastra/loggers/upstash-transport.ts" showLineNumbers copy
89
+ ```typescript title="src/mastra/loggers/upstash-transport.ts"
91
90
  import { UpstashTransport } from "@mastra/loggers/upstash";
92
91
  import { PinoLogger } from "@mastra/loggers/pino";
93
92
 
@@ -106,7 +105,7 @@ export const upstashLogger = new PinoLogger({
106
105
 
107
106
  ### Upstash transport usage
108
107
 
109
- ```typescript showLineNumbers copy
108
+ ```typescript
110
109
  upstashLogger.info("User signed in", {
111
110
  destinationPath: "auth",
112
111
  type: "AGENT",
@@ -122,7 +121,7 @@ You can create custom transports using the `createCustomTransport` utility to in
122
121
 
123
122
  Creates a custom transport using `createCustomTransport` and integrates it with a third-party logging stream such as `pino-sentry-transport`. This allows forwarding logs to an external system like Sentry for advanced monitoring and observability.
124
123
 
125
- ```typescript title="src/mastra/loggers/sentry-transport.ts" showLineNumbers copy
124
+ ```typescript title="src/mastra/loggers/sentry-transport.ts"
126
125
  import { createCustomTransport } from "@mastra/core/loggers";
127
126
  import { PinoLogger } from "@mastra/loggers/pino";
128
127
  import pinoSentry from "pino-sentry-transport";
@@ -9,7 +9,7 @@ The `.createThread()` method creates a new conversation thread in the memory sys
9
9
 
10
10
  ## Usage Example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  await memory?.createThread({ resourceId: "user-123" });
14
14
  ```
15
15
 
@@ -85,7 +85,7 @@ await memory?.createThread({ resourceId: "user-123" });
85
85
 
86
86
  ## Extended usage example
87
87
 
88
- ```typescript title="src/test-memory.ts" showLineNumbers copy
88
+ ```typescript title="src/test-memory.ts"
89
89
  import { mastra } from "./mastra";
90
90
 
91
91
  const agent = mastra.getAgent("agent");
@@ -9,7 +9,7 @@ The `.deleteMessages()` method deletes multiple messages by their IDs.
9
9
 
10
10
  ## Usage Example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);
14
14
  ```
15
15
 
@@ -40,7 +40,7 @@ await memory?.deleteMessages(["671ae63f-3a91-4082-a907-fe7de78e10ec"]);
40
40
 
41
41
  ## Extended usage example
42
42
 
43
- ```typescript title="src/test-memory.ts" showLineNumbers copy
43
+ ```typescript title="src/test-memory.ts"
44
44
  import { mastra } from "./mastra";
45
45
  import { MastraDBMessage } from "@mastra/core";
46
46
 
@@ -9,7 +9,7 @@ The `.listThreadsByResourceId()` method retrieves threads associated with a spec
9
9
 
10
10
  ## Usage Example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  await memory.listThreadsByResourceId({
14
14
  resourceId: "user-123",
15
15
  page: 0,
@@ -70,7 +70,7 @@ The return object contains:
70
70
 
71
71
  ## Extended usage example
72
72
 
73
- ```typescript title="src/test-memory.ts" showLineNumbers copy
73
+ ```typescript title="src/test-memory.ts"
74
74
  import { mastra } from "./mastra";
75
75
 
76
76
  const agent = mastra.getAgent("agent");