@mastra/mcp-docs-server 1.0.0-beta.13 → 1.0.0-beta.15

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 (321) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +27 -27
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +78 -78
  3. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +195 -195
  4. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +173 -173
  5. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +195 -195
  6. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +195 -195
  7. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +248 -0
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +338 -338
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +33 -33
  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 +195 -195
  13. package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
  14. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  15. package/.docs/organized/changelogs/%40mastra%2Flance.md +195 -195
  16. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +195 -195
  17. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +17 -17
  18. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +139 -139
  19. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +219 -219
  20. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +219 -219
  21. package/.docs/organized/changelogs/%40mastra%2Fpg.md +235 -235
  22. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +102 -102
  23. package/.docs/organized/changelogs/%40mastra%2Frag.md +17 -17
  24. package/.docs/organized/changelogs/%40mastra%2Freact.md +77 -70
  25. package/.docs/organized/changelogs/%40mastra%2Fserver.md +218 -218
  26. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +195 -195
  27. package/.docs/organized/changelogs/create-mastra.md +13 -13
  28. package/.docs/organized/changelogs/mastra.md +56 -56
  29. package/.docs/organized/code-examples/agent-v6.md +210 -0
  30. package/.docs/organized/code-examples/ai-elements.md +1 -1
  31. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  32. package/.docs/raw/agents/adding-voice.mdx +10 -6
  33. package/.docs/raw/agents/agent-approval.mdx +5 -6
  34. package/.docs/raw/agents/agent-memory.mdx +22 -30
  35. package/.docs/raw/agents/guardrails.mdx +60 -50
  36. package/.docs/raw/agents/networks.mdx +8 -12
  37. package/.docs/raw/agents/overview.mdx +39 -23
  38. package/.docs/raw/agents/processors.mdx +20 -19
  39. package/.docs/raw/agents/structured-output.mdx +11 -7
  40. package/.docs/raw/agents/using-tools.mdx +4 -5
  41. package/.docs/raw/deployment/mastra-server.mdx +3 -3
  42. package/.docs/raw/deployment/overview.mdx +7 -1
  43. package/.docs/raw/deployment/web-framework.mdx +4 -6
  44. package/.docs/raw/deployment/workflow-runners.mdx +14 -0
  45. package/.docs/raw/evals/custom-scorers.mdx +9 -6
  46. package/.docs/raw/evals/overview.mdx +3 -6
  47. package/.docs/raw/evals/running-in-ci.mdx +2 -2
  48. package/.docs/raw/getting-started/manual-install.mdx +20 -20
  49. package/.docs/raw/getting-started/mcp-docs-server.mdx +2 -2
  50. package/.docs/raw/getting-started/studio.mdx +1 -1
  51. package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +4 -4
  52. package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +30 -30
  53. package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
  54. package/.docs/raw/guides/build-your-ui/copilotkit.mdx +11 -11
  55. package/.docs/raw/guides/deployment/amazon-ec2.mdx +9 -9
  56. package/.docs/raw/guides/deployment/aws-lambda.mdx +11 -11
  57. package/.docs/raw/guides/deployment/azure-app-services.mdx +2 -2
  58. package/.docs/raw/guides/deployment/cloudflare-deployer.mdx +5 -6
  59. package/.docs/raw/guides/deployment/digital-ocean.mdx +10 -10
  60. package/.docs/raw/guides/deployment/index.mdx +1 -1
  61. package/.docs/raw/guides/deployment/inngest.mdx +444 -0
  62. package/.docs/raw/guides/deployment/netlify-deployer.mdx +4 -4
  63. package/.docs/raw/guides/deployment/vercel-deployer.mdx +5 -6
  64. package/.docs/raw/guides/getting-started/astro.mdx +292 -451
  65. package/.docs/raw/guides/getting-started/express.mdx +7 -7
  66. package/.docs/raw/guides/getting-started/hono.mdx +18 -18
  67. package/.docs/raw/guides/getting-started/next-js.mdx +19 -20
  68. package/.docs/raw/guides/getting-started/quickstart.mdx +4 -4
  69. package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
  70. package/.docs/raw/guides/getting-started/vite-react.mdx +21 -21
  71. package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
  72. package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
  73. package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
  74. package/.docs/raw/guides/guide/research-assistant.mdx +13 -13
  75. package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
  76. package/.docs/raw/guides/guide/web-search.mdx +8 -8
  77. package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
  78. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
  79. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +1 -1
  80. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +11 -3
  81. package/.docs/raw/guides/migrations/upgrade-to-v1/processors.mdx +11 -0
  82. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +41 -0
  83. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +0 -2
  84. package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
  85. package/.docs/raw/index.mdx +2 -2
  86. package/.docs/raw/mastra-cloud/deployment.mdx +39 -0
  87. package/.docs/raw/mastra-cloud/observability.mdx +9 -15
  88. package/.docs/raw/mastra-cloud/overview.mdx +14 -44
  89. package/.docs/raw/mastra-cloud/setup.mdx +64 -0
  90. package/.docs/raw/mastra-cloud/studio.mdx +35 -0
  91. package/.docs/raw/mcp/overview.mdx +31 -13
  92. package/.docs/raw/mcp/publishing-mcp-server.mdx +2 -2
  93. package/.docs/raw/memory/memory-processors.mdx +9 -9
  94. package/.docs/raw/memory/message-history.mdx +69 -0
  95. package/.docs/raw/memory/overview.mdx +34 -76
  96. package/.docs/raw/memory/semantic-recall.mdx +58 -49
  97. package/.docs/raw/memory/storage.mdx +188 -0
  98. package/.docs/raw/memory/working-memory.mdx +7 -7
  99. package/.docs/raw/observability/logging.mdx +9 -10
  100. package/.docs/raw/observability/overview.mdx +0 -1
  101. package/.docs/raw/observability/tracing/bridges/otel.mdx +2 -2
  102. package/.docs/raw/observability/tracing/exporters/default.mdx +3 -3
  103. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -2
  104. package/.docs/raw/observability/tracing/overview.mdx +23 -25
  105. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +3 -3
  106. package/.docs/raw/rag/chunking-and-embedding.mdx +6 -6
  107. package/.docs/raw/rag/graph-rag.mdx +7 -7
  108. package/.docs/raw/rag/overview.mdx +1 -1
  109. package/.docs/raw/rag/retrieval.mdx +21 -22
  110. package/.docs/raw/rag/vector-databases.mdx +22 -22
  111. package/.docs/raw/reference/agents/agent.mdx +3 -3
  112. package/.docs/raw/reference/agents/generate.mdx +1 -1
  113. package/.docs/raw/reference/agents/generateLegacy.mdx +2 -2
  114. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +2 -2
  115. package/.docs/raw/reference/agents/getDefaultOptions.mdx +2 -2
  116. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +2 -2
  117. package/.docs/raw/reference/agents/getDescription.mdx +1 -1
  118. package/.docs/raw/reference/agents/getInstructions.mdx +2 -2
  119. package/.docs/raw/reference/agents/getLLM.mdx +2 -2
  120. package/.docs/raw/reference/agents/getMemory.mdx +2 -2
  121. package/.docs/raw/reference/agents/getModel.mdx +2 -2
  122. package/.docs/raw/reference/agents/getTools.mdx +2 -2
  123. package/.docs/raw/reference/agents/getVoice.mdx +2 -2
  124. package/.docs/raw/reference/agents/listAgents.mdx +2 -2
  125. package/.docs/raw/reference/agents/listScorers.mdx +2 -2
  126. package/.docs/raw/reference/agents/listTools.mdx +2 -2
  127. package/.docs/raw/reference/agents/listWorkflows.mdx +2 -2
  128. package/.docs/raw/reference/agents/network.mdx +1 -1
  129. package/.docs/raw/reference/ai-sdk/chat-route.mdx +2 -2
  130. package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +1 -1
  131. package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +1 -1
  132. package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +1 -1
  133. package/.docs/raw/reference/ai-sdk/network-route.mdx +2 -2
  134. package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +6 -6
  135. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +3 -3
  136. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +3 -3
  137. package/.docs/raw/reference/ai-sdk/with-mastra.mdx +1 -1
  138. package/.docs/raw/reference/ai-sdk/workflow-route.mdx +2 -2
  139. package/.docs/raw/reference/auth/auth0.mdx +1 -2
  140. package/.docs/raw/reference/auth/clerk.mdx +1 -2
  141. package/.docs/raw/reference/auth/firebase.mdx +2 -4
  142. package/.docs/raw/reference/auth/jwt.mdx +1 -2
  143. package/.docs/raw/reference/auth/supabase.mdx +1 -2
  144. package/.docs/raw/reference/auth/workos.mdx +1 -2
  145. package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
  146. package/.docs/raw/reference/cli/mastra.mdx +9 -9
  147. package/.docs/raw/reference/client-js/agents.mdx +1 -2
  148. package/.docs/raw/reference/client-js/mastra-client.mdx +1 -1
  149. package/.docs/raw/reference/core/getAgent.mdx +1 -1
  150. package/.docs/raw/reference/core/getAgentById.mdx +1 -1
  151. package/.docs/raw/reference/core/getDeployer.mdx +1 -1
  152. package/.docs/raw/reference/core/getLogger.mdx +1 -1
  153. package/.docs/raw/reference/core/getMCPServer.mdx +1 -1
  154. package/.docs/raw/reference/core/getMCPServerById.mdx +1 -1
  155. package/.docs/raw/reference/core/getMemory.mdx +2 -2
  156. package/.docs/raw/reference/core/getServer.mdx +1 -1
  157. package/.docs/raw/reference/core/getStorage.mdx +2 -2
  158. package/.docs/raw/reference/core/getStoredAgentById.mdx +3 -3
  159. package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
  160. package/.docs/raw/reference/core/getVector.mdx +1 -1
  161. package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
  162. package/.docs/raw/reference/core/listAgents.mdx +1 -1
  163. package/.docs/raw/reference/core/listLogs.mdx +1 -1
  164. package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
  165. package/.docs/raw/reference/core/listMCPServers.mdx +1 -1
  166. package/.docs/raw/reference/core/listMemory.mdx +2 -2
  167. package/.docs/raw/reference/core/listStoredAgents.mdx +4 -4
  168. package/.docs/raw/reference/core/listVectors.mdx +1 -1
  169. package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
  170. package/.docs/raw/reference/core/setLogger.mdx +1 -1
  171. package/.docs/raw/reference/core/setStorage.mdx +2 -2
  172. package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
  173. package/.docs/raw/reference/deployer/cloudflare.mdx +1 -2
  174. package/.docs/raw/reference/deployer/deployer.mdx +0 -1
  175. package/.docs/raw/reference/deployer/netlify.mdx +1 -1
  176. package/.docs/raw/reference/deployer/vercel.mdx +2 -4
  177. package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
  178. package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
  179. package/.docs/raw/reference/evals/bias.mdx +1 -1
  180. package/.docs/raw/reference/evals/completeness.mdx +1 -1
  181. package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
  182. package/.docs/raw/reference/evals/context-precision.mdx +1 -1
  183. package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
  184. package/.docs/raw/reference/evals/hallucination.mdx +1 -1
  185. package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
  186. package/.docs/raw/reference/evals/prompt-alignment.mdx +7 -7
  187. package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
  188. package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
  189. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +10 -10
  190. package/.docs/raw/reference/evals/toxicity.mdx +1 -1
  191. package/.docs/raw/reference/logging/pino-logger.mdx +7 -8
  192. package/.docs/raw/reference/memory/createThread.mdx +2 -2
  193. package/.docs/raw/reference/memory/deleteMessages.mdx +2 -2
  194. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +2 -2
  195. package/.docs/raw/reference/memory/memory-class.mdx +3 -3
  196. package/.docs/raw/reference/memory/query.mdx +2 -2
  197. package/.docs/raw/reference/memory/recall.mdx +2 -2
  198. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
  199. package/.docs/raw/reference/processors/batch-parts-processor.mdx +2 -2
  200. package/.docs/raw/reference/processors/language-detector.mdx +2 -2
  201. package/.docs/raw/reference/processors/message-history-processor.mdx +2 -2
  202. package/.docs/raw/reference/processors/moderation-processor.mdx +3 -3
  203. package/.docs/raw/reference/processors/pii-detector.mdx +3 -3
  204. package/.docs/raw/reference/processors/processor-interface.mdx +13 -13
  205. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +2 -2
  206. package/.docs/raw/reference/processors/semantic-recall-processor.mdx +2 -2
  207. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +2 -2
  208. package/.docs/raw/reference/processors/token-limiter-processor.mdx +40 -19
  209. package/.docs/raw/reference/processors/tool-call-filter.mdx +3 -3
  210. package/.docs/raw/reference/processors/unicode-normalizer.mdx +2 -2
  211. package/.docs/raw/reference/processors/working-memory-processor.mdx +3 -3
  212. package/.docs/raw/reference/rag/chunk.mdx +1 -1
  213. package/.docs/raw/reference/rag/extract-params.mdx +2 -2
  214. package/.docs/raw/reference/rag/metadata-filters.mdx +7 -7
  215. package/.docs/raw/reference/server/create-route.mdx +13 -13
  216. package/.docs/raw/reference/server/express-adapter.mdx +6 -7
  217. package/.docs/raw/reference/server/hono-adapter.mdx +6 -7
  218. package/.docs/raw/reference/server/mastra-server.mdx +20 -20
  219. package/.docs/raw/reference/storage/cloudflare-d1.mdx +7 -5
  220. package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
  221. package/.docs/raw/reference/storage/convex.mdx +6 -6
  222. package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
  223. package/.docs/raw/reference/storage/lance.mdx +6 -5
  224. package/.docs/raw/reference/storage/libsql.mdx +72 -54
  225. package/.docs/raw/reference/storage/mongodb.mdx +84 -9
  226. package/.docs/raw/reference/storage/mssql.mdx +8 -6
  227. package/.docs/raw/{memory → reference}/storage/overview.mdx +12 -110
  228. package/.docs/raw/reference/storage/postgresql.mdx +82 -9
  229. package/.docs/raw/reference/storage/upstash.mdx +74 -2
  230. package/.docs/raw/reference/streaming/agents/stream.mdx +5 -5
  231. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +2 -2
  232. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
  233. package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +1 -1
  234. package/.docs/raw/reference/streaming/workflows/stream.mdx +2 -2
  235. package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +4 -4
  236. package/.docs/raw/reference/templates/overview.mdx +1 -2
  237. package/.docs/raw/reference/tools/create-tool.mdx +1 -4
  238. package/.docs/raw/reference/tools/vector-query-tool.mdx +1 -1
  239. package/.docs/raw/reference/vectors/astra.mdx +3 -3
  240. package/.docs/raw/reference/vectors/chroma.mdx +3 -3
  241. package/.docs/raw/reference/vectors/convex.mdx +12 -12
  242. package/.docs/raw/reference/vectors/couchbase.mdx +5 -5
  243. package/.docs/raw/reference/vectors/duckdb.mdx +10 -10
  244. package/.docs/raw/reference/vectors/elasticsearch.mdx +4 -4
  245. package/.docs/raw/reference/vectors/lance.mdx +4 -4
  246. package/.docs/raw/reference/vectors/libsql.mdx +61 -11
  247. package/.docs/raw/reference/vectors/mongodb.mdx +58 -5
  248. package/.docs/raw/reference/vectors/pg.mdx +53 -6
  249. package/.docs/raw/reference/vectors/pinecone.mdx +3 -3
  250. package/.docs/raw/reference/vectors/qdrant.mdx +3 -3
  251. package/.docs/raw/reference/vectors/s3vectors.mdx +6 -6
  252. package/.docs/raw/reference/vectors/turbopuffer.mdx +4 -4
  253. package/.docs/raw/reference/vectors/upstash.mdx +55 -6
  254. package/.docs/raw/reference/vectors/vectorize.mdx +3 -3
  255. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +2 -2
  256. package/.docs/raw/reference/workflows/run-methods/restart.mdx +1 -3
  257. package/.docs/raw/reference/workflows/run-methods/resume.mdx +2 -2
  258. package/.docs/raw/reference/workflows/run-methods/start.mdx +2 -2
  259. package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +2 -2
  260. package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +5 -5
  261. package/.docs/raw/reference/workflows/run.mdx +1 -1
  262. package/.docs/raw/reference/workflows/step.mdx +3 -3
  263. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
  264. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  265. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +3 -3
  266. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
  267. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
  268. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +6 -6
  269. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +7 -7
  270. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  271. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +2 -2
  272. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +2 -2
  273. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +2 -2
  274. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  275. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +2 -2
  276. package/.docs/raw/reference/workflows/workflow.mdx +3 -3
  277. package/.docs/raw/server/auth/auth0.mdx +20 -14
  278. package/.docs/raw/server/auth/clerk.mdx +16 -9
  279. package/.docs/raw/server/auth/firebase.mdx +21 -15
  280. package/.docs/raw/server/auth/jwt.mdx +14 -7
  281. package/.docs/raw/server/auth/supabase.mdx +16 -9
  282. package/.docs/raw/server/auth/workos.mdx +19 -13
  283. package/.docs/raw/server/custom-adapters.mdx +10 -10
  284. package/.docs/raw/server/custom-api-routes.mdx +2 -4
  285. package/.docs/raw/server/mastra-client.mdx +24 -13
  286. package/.docs/raw/server/mastra-server.mdx +3 -3
  287. package/.docs/raw/server/middleware.mdx +7 -7
  288. package/.docs/raw/server/request-context.mdx +31 -30
  289. package/.docs/raw/server/server-adapters.mdx +6 -6
  290. package/.docs/raw/streaming/events.mdx +14 -7
  291. package/.docs/raw/streaming/overview.mdx +21 -10
  292. package/.docs/raw/streaming/tool-streaming.mdx +6 -6
  293. package/.docs/raw/streaming/workflow-streaming.mdx +6 -8
  294. package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
  295. package/.docs/raw/tools-mcp/mcp-overview.mdx +31 -12
  296. package/.docs/raw/tools-mcp/overview.mdx +9 -10
  297. package/.docs/raw/voice/overview.mdx +2 -2
  298. package/.docs/raw/workflows/agents-and-tools.mdx +28 -19
  299. package/.docs/raw/workflows/control-flow.mdx +27 -40
  300. package/.docs/raw/workflows/error-handling.mdx +15 -22
  301. package/.docs/raw/workflows/human-in-the-loop.mdx +6 -7
  302. package/.docs/raw/workflows/input-data-mapping.mdx +7 -7
  303. package/.docs/raw/workflows/overview.mdx +34 -23
  304. package/.docs/raw/workflows/snapshots.mdx +16 -45
  305. package/.docs/raw/workflows/suspend-and-resume.mdx +7 -7
  306. package/.docs/raw/workflows/time-travel.mdx +16 -16
  307. package/.docs/raw/workflows/workflow-state.mdx +5 -8
  308. package/CHANGELOG.md +16 -0
  309. package/dist/logger.d.ts +3 -0
  310. package/dist/logger.d.ts.map +1 -1
  311. package/dist/stdio.js +53 -0
  312. package/package.json +3 -3
  313. package/.docs/raw/mastra-cloud/dashboard.mdx +0 -96
  314. package/.docs/raw/mastra-cloud/setting-up.mdx +0 -102
  315. package/.docs/raw/memory/conversation-history.mdx +0 -24
  316. package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
  317. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
  318. package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
  319. package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
  320. package/.docs/raw/memory/threads-and-resources.mdx +0 -95
  321. package/.docs/raw/workflows/inngest-workflow.mdx +0 -363
@@ -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/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/observability#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");
@@ -9,7 +9,7 @@ The `Memory` class provides a robust system for managing conversation history an
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
12
+ ```typescript title="src/mastra/agents/test-agent.ts"
13
13
  import { Memory } from "@mastra/memory";
14
14
  import { Agent } from "@mastra/core/agent";
15
15
 
@@ -124,7 +124,7 @@ export const agent = new Agent({
124
124
 
125
125
  ## Extended usage example
126
126
 
127
- ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
127
+ ```typescript title="src/mastra/agents/test-agent.ts"
128
128
  import { Memory } from "@mastra/memory";
129
129
  import { Agent } from "@mastra/core/agent";
130
130
  import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
@@ -162,7 +162,7 @@ export const agent = new Agent({
162
162
 
163
163
  ## PostgreSQL with index configuration
164
164
 
165
- ```typescript title="src/mastra/agents/pg-agent.ts" showLineNumbers copy
165
+ ```typescript title="src/mastra/agents/pg-agent.ts"
166
166
  import { Memory } from "@mastra/memory";
167
167
  import { Agent } from "@mastra/core/agent";
168
168
  import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
@@ -13,7 +13,7 @@ the `.query()` method retrieves messages from a specific thread, with support fo
13
13
 
14
14
  ## Usage Example
15
15
 
16
- ```typescript copy
16
+ ```typescript
17
17
  await memory?.query({ threadId: "user-123" });
18
18
  ```
19
19
 
@@ -142,7 +142,7 @@ await memory?.query({ threadId: "user-123" });
142
142
 
143
143
  ## Extended usage example
144
144
 
145
- ```typescript title="src/test-memory.ts" showLineNumbers copy
145
+ ```typescript title="src/test-memory.ts"
146
146
  import { mastra } from "./mastra";
147
147
 
148
148
  const agent = mastra.getAgent("agent");
@@ -9,7 +9,7 @@ the `.recall()` method retrieves messages from a specific thread, with support f
9
9
 
10
10
  ## Usage Example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  await memory?.recall({ threadId: "user-123" });
14
14
  ```
15
15
 
@@ -138,7 +138,7 @@ await memory?.recall({ threadId: "user-123" });
138
138
 
139
139
  ## Extended usage example
140
140
 
141
- ```typescript title="src/test-memory.ts" showLineNumbers copy
141
+ ```typescript title="src/test-memory.ts"
142
142
  import { mastra } from "./mastra";
143
143
 
144
144
  const agent = mastra.getAgent("agent");
@@ -137,7 +137,7 @@ const prompt = await langfuse.getPrompt("customer-support");
137
137
  const agent = new Agent({
138
138
  name: "support-agent",
139
139
  instructions: prompt.prompt,
140
- model: openai("gpt-4o"),
140
+ model: "openai/gpt-4o",
141
141
  defaultGenerateOptions: {
142
142
  tracingOptions: buildTracingOptions(withLangfusePrompt(prompt)),
143
143
  },
@@ -9,7 +9,7 @@ The `BatchPartsProcessor` is an **output processor** that batches multiple strea
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { BatchPartsProcessor } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new BatchPartsProcessor({
@@ -93,7 +93,7 @@ const processor = new BatchPartsProcessor({
93
93
 
94
94
  ## Extended usage example
95
95
 
96
- ```typescript title="src/mastra/agents/batched-agent.ts" showLineNumbers copy
96
+ ```typescript title="src/mastra/agents/batched-agent.ts"
97
97
  import { Agent } from "@mastra/core/agent";
98
98
  import { BatchPartsProcessor } from "@mastra/core/processors";
99
99
 
@@ -9,7 +9,7 @@ The `LanguageDetector` is an **input processor** that identifies the language of
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { LanguageDetector } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new LanguageDetector({
@@ -136,7 +136,7 @@ const processor = new LanguageDetector({
136
136
 
137
137
  ## Extended usage example
138
138
 
139
- ```typescript title="src/mastra/agents/multilingual-agent.ts" showLineNumbers copy
139
+ ```typescript title="src/mastra/agents/multilingual-agent.ts"
140
140
  import { Agent } from "@mastra/core/agent";
141
141
  import { LanguageDetector } from "@mastra/core/processors";
142
142
 
@@ -9,7 +9,7 @@ The `MessageHistory` is a **hybrid processor** that handles both retrieval and p
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { MessageHistory } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new MessageHistory({
@@ -83,7 +83,7 @@ const processor = new MessageHistory({
83
83
 
84
84
  ## Extended usage example
85
85
 
86
- ```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers copy
86
+ ```typescript title="src/mastra/agents/memory-agent.ts"
87
87
  import { Agent } from "@mastra/core/agent";
88
88
  import { MessageHistory } from "@mastra/core/processors";
89
89
  import { PostgresStorage } from "@mastra/pg";
@@ -9,7 +9,7 @@ The `ModerationProcessor` is a **hybrid processor** that can be used for both in
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { ModerationProcessor } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new ModerationProcessor({
@@ -130,7 +130,7 @@ const processor = new ModerationProcessor({
130
130
 
131
131
  ### Input processing
132
132
 
133
- ```typescript title="src/mastra/agents/moderated-agent.ts" showLineNumbers copy
133
+ ```typescript title="src/mastra/agents/moderated-agent.ts"
134
134
  import { Agent } from "@mastra/core/agent";
135
135
  import { ModerationProcessor } from "@mastra/core/processors";
136
136
 
@@ -155,7 +155,7 @@ export const agent = new Agent({
155
155
 
156
156
  When using `ModerationProcessor` as an output processor, it's recommended to combine it with `BatchPartsProcessor` to optimize performance. The `BatchPartsProcessor` batches stream chunks together before passing them to the moderator, reducing the number of LLM calls required for moderation.
157
157
 
158
- ```typescript title="src/mastra/agents/output-moderated-agent.ts" showLineNumbers copy
158
+ ```typescript title="src/mastra/agents/output-moderated-agent.ts"
159
159
  import { Agent } from "@mastra/core/agent";
160
160
  import { BatchPartsProcessor, ModerationProcessor } from "@mastra/core/processors";
161
161
 
@@ -9,7 +9,7 @@ The `PIIDetector` is a **hybrid processor** that can be used for both input and
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { PIIDetector } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new PIIDetector({
@@ -137,7 +137,7 @@ const processor = new PIIDetector({
137
137
 
138
138
  ### Input processing
139
139
 
140
- ```typescript title="src/mastra/agents/private-agent.ts" showLineNumbers copy
140
+ ```typescript title="src/mastra/agents/private-agent.ts"
141
141
  import { Agent } from "@mastra/core/agent";
142
142
  import { PIIDetector } from "@mastra/core/processors";
143
143
 
@@ -164,7 +164,7 @@ export const agent = new Agent({
164
164
 
165
165
  When using `PIIDetector` as an output processor, it's recommended to combine it with `BatchPartsProcessor` to optimize performance. The `BatchPartsProcessor` batches stream chunks together before passing them to the PII detector, reducing the number of LLM calls required for detection.
166
166
 
167
- ```typescript title="src/mastra/agents/output-pii-agent.ts" showLineNumbers copy
167
+ ```typescript title="src/mastra/agents/output-pii-agent.ts"
168
168
  import { Agent } from "@mastra/core/agent";
169
169
  import { BatchPartsProcessor, PIIDetector } from "@mastra/core/processors";
170
170