@mastra/mcp-docs-server 1.0.0-beta.0 → 1.0.0-beta.10

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 (496) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +1 -15
  2. package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +1 -7
  3. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +201 -1
  4. package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +1 -55
  5. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +201 -1
  6. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +250 -50
  7. package/.docs/organized/changelogs/%40mastra%2Fastra.md +201 -1
  8. package/.docs/organized/changelogs/%40mastra%2Fauth.md +6 -0
  9. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +201 -1
  10. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +201 -1
  11. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +201 -1
  12. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +201 -1
  13. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +201 -1
  14. package/.docs/organized/changelogs/%40mastra%2Fcodemod.md +26 -0
  15. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +89 -0
  16. package/.docs/organized/changelogs/%40mastra%2Fcore.md +396 -196
  17. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +201 -1
  18. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +201 -1
  19. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +201 -1
  20. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +201 -1
  21. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +201 -1
  22. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +200 -0
  23. package/.docs/organized/changelogs/%40mastra%2Fduckdb.md +42 -0
  24. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +201 -1
  25. package/.docs/organized/changelogs/%40mastra%2Felasticsearch.md +61 -0
  26. package/.docs/organized/changelogs/%40mastra%2Fevals.md +201 -1
  27. package/.docs/organized/changelogs/%40mastra%2Flance.md +201 -1
  28. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +201 -1
  29. package/.docs/organized/changelogs/%40mastra%2Floggers.md +201 -1
  30. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +201 -1
  31. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +201 -1
  32. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +201 -1
  33. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +201 -1
  34. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +201 -1
  35. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +201 -1
  36. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +201 -1
  37. package/.docs/organized/changelogs/%40mastra%2Fpg.md +201 -1
  38. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +201 -1
  39. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +251 -51
  40. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +201 -1
  41. package/.docs/organized/changelogs/%40mastra%2Frag.md +201 -1
  42. package/.docs/organized/changelogs/%40mastra%2Freact.md +128 -1
  43. package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +18 -0
  44. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +42 -0
  45. package/.docs/organized/changelogs/%40mastra%2Fserver.md +251 -51
  46. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +201 -1
  47. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +201 -1
  48. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +201 -1
  49. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +201 -1
  50. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +201 -1
  51. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +201 -1
  52. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +201 -1
  53. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +92 -1
  54. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +67 -1
  55. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +201 -1
  56. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +201 -1
  57. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +201 -1
  58. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +201 -1
  59. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +201 -1
  60. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +201 -1
  61. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +201 -1
  62. package/.docs/organized/changelogs/create-mastra.md +201 -1
  63. package/.docs/organized/changelogs/mastra.md +201 -1
  64. package/.docs/organized/code-examples/agui.md +1 -0
  65. package/.docs/organized/code-examples/ai-elements.md +2 -2
  66. package/.docs/organized/code-examples/ai-sdk-useChat.md +2 -2
  67. package/.docs/organized/code-examples/ai-sdk-v5.md +3 -2
  68. package/.docs/organized/code-examples/assistant-ui.md +2 -2
  69. package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
  70. package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +2 -2
  71. package/.docs/organized/code-examples/bird-checker-with-nextjs.md +2 -2
  72. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  73. package/.docs/organized/code-examples/crypto-chatbot.md +2 -2
  74. package/.docs/organized/code-examples/fireworks-r1.md +1 -1
  75. package/.docs/organized/code-examples/heads-up-game.md +1 -1
  76. package/.docs/organized/code-examples/mcp-configuration.md +0 -3
  77. package/.docs/organized/code-examples/mcp-server-adapters.md +720 -0
  78. package/.docs/organized/code-examples/memory-per-resource-example.md +1 -1
  79. package/.docs/organized/code-examples/memory-with-processors.md +1 -1
  80. package/.docs/organized/code-examples/openapi-spec-writer.md +1 -1
  81. package/.docs/organized/code-examples/processors-with-ai-sdk.md +14 -0
  82. package/.docs/organized/code-examples/quick-start.md +2 -2
  83. package/.docs/organized/code-examples/server-app-access.md +342 -0
  84. package/.docs/organized/code-examples/server-express-adapter.md +87 -0
  85. package/.docs/organized/code-examples/server-hono-adapter.md +85 -0
  86. package/.docs/organized/code-examples/stock-price-tool.md +1 -21
  87. package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
  88. package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
  89. package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
  90. package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
  91. package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
  92. package/.docs/raw/agents/adding-voice.mdx +56 -10
  93. package/.docs/raw/agents/agent-approval.mdx +189 -0
  94. package/.docs/raw/agents/agent-memory.mdx +2 -2
  95. package/.docs/raw/agents/guardrails.mdx +27 -24
  96. package/.docs/raw/agents/networks.mdx +3 -3
  97. package/.docs/raw/agents/overview.mdx +19 -168
  98. package/.docs/raw/agents/processors.mdx +279 -0
  99. package/.docs/raw/agents/structured-output.mdx +224 -0
  100. package/.docs/raw/agents/using-tools.mdx +14 -14
  101. package/.docs/raw/auth/auth0.mdx +2 -2
  102. package/.docs/raw/auth/clerk.mdx +2 -2
  103. package/.docs/raw/auth/firebase.mdx +2 -2
  104. package/.docs/raw/auth/index.mdx +1 -1
  105. package/.docs/raw/auth/jwt.mdx +2 -2
  106. package/.docs/raw/auth/supabase.mdx +2 -2
  107. package/.docs/raw/auth/workos.mdx +2 -2
  108. package/.docs/raw/community/contributing-templates.mdx +1 -1
  109. package/.docs/raw/community/discord.mdx +2 -2
  110. package/.docs/raw/community/licensing.mdx +1 -1
  111. package/.docs/raw/course/01-first-agent/03-verifying-installation.md +1 -1
  112. package/.docs/raw/course/01-first-agent/05-running-playground.md +5 -5
  113. package/.docs/raw/course/01-first-agent/09-testing-your-agent.md +3 -3
  114. package/.docs/raw/course/01-first-agent/13-testing-your-tool.md +3 -3
  115. package/.docs/raw/course/01-first-agent/17-testing-memory.md +2 -2
  116. package/.docs/raw/course/02-agent-tools-mcp/02-installing-mcp.md +1 -1
  117. package/.docs/raw/course/03-agent-memory/03-installing-memory.md +1 -1
  118. package/.docs/raw/course/04-workflows/07-using-playground.md +1 -1
  119. package/.docs/raw/deployment/{server-deployment.mdx → building-mastra.mdx} +4 -4
  120. package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx +3 -3
  121. package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx +4 -4
  122. package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx +4 -4
  123. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/cloudflare-deployer.mdx +2 -2
  124. package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx +3 -3
  125. package/.docs/raw/deployment/cloud-providers/index.mdx +26 -29
  126. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/netlify-deployer.mdx +46 -15
  127. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/vercel-deployer.mdx +2 -2
  128. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/dashboard.mdx +3 -3
  129. package/.docs/raw/deployment/mastra-cloud/observability.mdx +53 -0
  130. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/overview.mdx +3 -3
  131. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/setting-up.mdx +4 -4
  132. package/.docs/raw/deployment/monorepo.mdx +3 -3
  133. package/.docs/raw/deployment/overview.mdx +7 -7
  134. package/.docs/raw/deployment/web-framework.mdx +6 -6
  135. package/.docs/raw/evals/{off-the-shelf-scorers.mdx → built-in-scorers.mdx} +17 -15
  136. package/.docs/raw/evals/custom-scorers.mdx +4 -6
  137. package/.docs/raw/evals/overview.mdx +6 -7
  138. package/.docs/raw/evals/running-in-ci.mdx +2 -4
  139. package/.docs/raw/getting-started/{installation.mdx → manual-install.mdx} +15 -89
  140. package/.docs/raw/getting-started/mcp-docs-server.mdx +6 -6
  141. package/.docs/raw/getting-started/project-structure.mdx +2 -2
  142. package/.docs/raw/getting-started/start.mdx +72 -0
  143. package/.docs/raw/getting-started/studio.mdx +8 -6
  144. package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +147 -0
  145. package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +627 -0
  146. package/.docs/raw/{frameworks/agentic-uis → guides/build-your-ui}/assistant-ui.mdx +72 -20
  147. package/.docs/raw/guides/build-your-ui/copilotkit.mdx +206 -0
  148. package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/astro.mdx +28 -30
  149. package/.docs/raw/{frameworks/servers → guides/getting-started}/express.mdx +4 -5
  150. package/.docs/raw/guides/getting-started/next-js.mdx +276 -0
  151. package/.docs/raw/guides/getting-started/quickstart.mdx +97 -0
  152. package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/sveltekit.mdx +28 -30
  153. package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/vite-react.mdx +12 -12
  154. package/.docs/raw/guides/guide/ai-recruiter.mdx +2 -3
  155. package/.docs/raw/guides/guide/chef-michel.mdx +2 -3
  156. package/.docs/raw/guides/guide/notes-mcp-server.mdx +3 -3
  157. package/.docs/raw/guides/guide/research-assistant.mdx +8 -18
  158. package/.docs/raw/guides/guide/stock-agent.mdx +4 -6
  159. package/.docs/raw/guides/guide/web-search.mdx +12 -10
  160. package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +421 -0
  161. package/.docs/raw/guides/index.mdx +3 -35
  162. package/.docs/raw/guides/migrations/agentnetwork.mdx +4 -4
  163. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +119 -0
  164. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +56 -6
  165. package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +42 -2
  166. package/.docs/raw/guides/migrations/upgrade-to-v1/evals.mdx +31 -1
  167. package/.docs/raw/guides/migrations/upgrade-to-v1/mastra.mdx +29 -5
  168. package/.docs/raw/guides/migrations/upgrade-to-v1/mcp.mdx +3 -3
  169. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +28 -0
  170. package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +59 -37
  171. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +80 -0
  172. package/.docs/raw/guides/migrations/upgrade-to-v1/tools.mdx +70 -5
  173. package/.docs/raw/guides/migrations/upgrade-to-v1/tracing.mdx +13 -13
  174. package/.docs/raw/guides/migrations/upgrade-to-v1/vectors.mdx +25 -1
  175. package/.docs/raw/guides/migrations/upgrade-to-v1/voice.mdx +1 -1
  176. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +175 -2
  177. package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +2 -2
  178. package/.docs/raw/index.mdx +4 -4
  179. package/.docs/raw/mcp/overview.mdx +358 -0
  180. package/.docs/raw/mcp/publishing-mcp-server.mdx +139 -0
  181. package/.docs/raw/memory/conversation-history.mdx +1 -1
  182. package/.docs/raw/memory/memory-processors.mdx +265 -80
  183. package/.docs/raw/memory/overview.mdx +3 -3
  184. package/.docs/raw/memory/semantic-recall.mdx +10 -10
  185. package/.docs/raw/memory/storage/memory-with-libsql.mdx +5 -10
  186. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +150 -0
  187. package/.docs/raw/memory/storage/memory-with-pg.mdx +5 -10
  188. package/.docs/raw/memory/storage/memory-with-upstash.mdx +5 -10
  189. package/.docs/raw/memory/threads-and-resources.mdx +4 -4
  190. package/.docs/raw/memory/working-memory.mdx +16 -8
  191. package/.docs/raw/{logging.mdx → observability/logging.mdx} +8 -8
  192. package/.docs/raw/observability/overview.mdx +5 -6
  193. package/.docs/raw/observability/tracing/bridges/otel.mdx +200 -0
  194. package/.docs/raw/observability/tracing/exporters/arize.mdx +39 -3
  195. package/.docs/raw/observability/tracing/exporters/braintrust.mdx +22 -3
  196. package/.docs/raw/observability/tracing/exporters/cloud.mdx +4 -4
  197. package/.docs/raw/observability/tracing/exporters/default.mdx +6 -6
  198. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +86 -3
  199. package/.docs/raw/observability/tracing/exporters/langsmith.mdx +15 -3
  200. package/.docs/raw/observability/tracing/exporters/otel.mdx +128 -30
  201. package/.docs/raw/observability/tracing/exporters/posthog.mdx +127 -0
  202. package/.docs/raw/observability/tracing/overview.mdx +100 -29
  203. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +2 -3
  204. package/.docs/raw/rag/chunking-and-embedding.mdx +16 -17
  205. package/.docs/raw/rag/overview.mdx +5 -4
  206. package/.docs/raw/rag/retrieval.mdx +44 -39
  207. package/.docs/raw/rag/vector-databases.mdx +94 -3
  208. package/.docs/raw/reference/agents/agent.mdx +10 -14
  209. package/.docs/raw/reference/agents/generate.mdx +67 -99
  210. package/.docs/raw/reference/agents/generateLegacy.mdx +3 -3
  211. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +1 -1
  212. package/.docs/raw/reference/agents/getDefaultOptions.mdx +1 -1
  213. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +1 -1
  214. package/.docs/raw/reference/agents/getDescription.mdx +1 -1
  215. package/.docs/raw/reference/agents/getInstructions.mdx +1 -1
  216. package/.docs/raw/reference/agents/getLLM.mdx +2 -2
  217. package/.docs/raw/reference/agents/getMemory.mdx +1 -1
  218. package/.docs/raw/reference/agents/getModel.mdx +1 -1
  219. package/.docs/raw/reference/agents/getTools.mdx +69 -0
  220. package/.docs/raw/reference/agents/getVoice.mdx +1 -1
  221. package/.docs/raw/reference/agents/listAgents.mdx +1 -1
  222. package/.docs/raw/reference/agents/listScorers.mdx +1 -1
  223. package/.docs/raw/reference/agents/listTools.mdx +2 -2
  224. package/.docs/raw/reference/agents/listWorkflows.mdx +1 -1
  225. package/.docs/raw/reference/agents/network.mdx +33 -72
  226. package/.docs/raw/reference/ai-sdk/chat-route.mdx +127 -0
  227. package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +117 -0
  228. package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +64 -0
  229. package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +116 -0
  230. package/.docs/raw/reference/ai-sdk/network-route.mdx +99 -0
  231. package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +289 -0
  232. package/.docs/raw/reference/ai-sdk/with-mastra.mdx +119 -0
  233. package/.docs/raw/reference/ai-sdk/workflow-route.mdx +110 -0
  234. package/.docs/raw/reference/auth/auth0.mdx +1 -1
  235. package/.docs/raw/reference/auth/clerk.mdx +1 -1
  236. package/.docs/raw/reference/auth/firebase.mdx +1 -1
  237. package/.docs/raw/reference/auth/jwt.mdx +1 -1
  238. package/.docs/raw/reference/auth/supabase.mdx +1 -1
  239. package/.docs/raw/reference/auth/workos.mdx +1 -1
  240. package/.docs/raw/reference/cli/create-mastra.mdx +11 -11
  241. package/.docs/raw/reference/cli/mastra.mdx +25 -12
  242. package/.docs/raw/reference/client-js/agents.mdx +252 -68
  243. package/.docs/raw/reference/client-js/error-handling.mdx +1 -1
  244. package/.docs/raw/reference/client-js/logs.mdx +1 -1
  245. package/.docs/raw/reference/client-js/mastra-client.mdx +4 -4
  246. package/.docs/raw/reference/client-js/memory.mdx +48 -2
  247. package/.docs/raw/reference/client-js/observability.mdx +1 -1
  248. package/.docs/raw/reference/client-js/telemetry.mdx +1 -1
  249. package/.docs/raw/reference/client-js/tools.mdx +1 -1
  250. package/.docs/raw/reference/client-js/vectors.mdx +1 -1
  251. package/.docs/raw/reference/client-js/workflows.mdx +93 -64
  252. package/.docs/raw/reference/core/addGateway.mdx +59 -0
  253. package/.docs/raw/reference/core/getAgent.mdx +1 -1
  254. package/.docs/raw/reference/core/getAgentById.mdx +1 -1
  255. package/.docs/raw/reference/core/getDeployer.mdx +1 -1
  256. package/.docs/raw/reference/core/getGateway.mdx +59 -0
  257. package/.docs/raw/reference/core/getGatewayById.mdx +62 -0
  258. package/.docs/raw/reference/core/getLogger.mdx +3 -3
  259. package/.docs/raw/reference/core/getMCPServer.mdx +4 -4
  260. package/.docs/raw/reference/core/getMCPServerById.mdx +5 -5
  261. package/.docs/raw/reference/core/getMemory.mdx +73 -0
  262. package/.docs/raw/reference/core/getScorer.mdx +1 -1
  263. package/.docs/raw/reference/core/getScorerById.mdx +1 -1
  264. package/.docs/raw/reference/core/getServer.mdx +2 -2
  265. package/.docs/raw/reference/core/getStorage.mdx +1 -1
  266. package/.docs/raw/reference/core/getStoredAgentById.mdx +183 -0
  267. package/.docs/raw/reference/core/getTelemetry.mdx +3 -3
  268. package/.docs/raw/reference/core/getVector.mdx +1 -1
  269. package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
  270. package/.docs/raw/reference/core/listAgents.mdx +1 -1
  271. package/.docs/raw/reference/core/listGateways.mdx +53 -0
  272. package/.docs/raw/reference/core/listLogs.mdx +3 -3
  273. package/.docs/raw/reference/core/listLogsByRunId.mdx +3 -3
  274. package/.docs/raw/reference/core/listMCPServers.mdx +5 -5
  275. package/.docs/raw/reference/core/listMemory.mdx +70 -0
  276. package/.docs/raw/reference/core/listScorers.mdx +1 -1
  277. package/.docs/raw/reference/core/listStoredAgents.mdx +151 -0
  278. package/.docs/raw/reference/core/listVectors.mdx +1 -1
  279. package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
  280. package/.docs/raw/reference/core/mastra-class.mdx +17 -1
  281. package/.docs/raw/reference/core/mastra-model-gateway.mdx +227 -0
  282. package/.docs/raw/reference/core/setLogger.mdx +3 -3
  283. package/.docs/raw/reference/core/setStorage.mdx +1 -1
  284. package/.docs/raw/reference/core/setTelemetry.mdx +3 -3
  285. package/.docs/raw/reference/deployer/cloudflare.mdx +1 -1
  286. package/.docs/raw/reference/deployer/deployer.mdx +1 -1
  287. package/.docs/raw/reference/deployer/netlify.mdx +2 -3
  288. package/.docs/raw/reference/deployer/vercel.mdx +1 -1
  289. package/.docs/raw/reference/evals/answer-relevancy.mdx +29 -99
  290. package/.docs/raw/reference/evals/answer-similarity.mdx +13 -259
  291. package/.docs/raw/reference/evals/bias.mdx +30 -88
  292. package/.docs/raw/reference/evals/completeness.mdx +32 -91
  293. package/.docs/raw/reference/evals/content-similarity.mdx +29 -89
  294. package/.docs/raw/reference/evals/context-precision.mdx +29 -131
  295. package/.docs/raw/reference/evals/context-relevance.mdx +12 -12
  296. package/.docs/raw/reference/evals/create-scorer.mdx +59 -50
  297. package/.docs/raw/reference/evals/faithfulness.mdx +29 -102
  298. package/.docs/raw/reference/evals/hallucination.mdx +29 -104
  299. package/.docs/raw/reference/evals/keyword-coverage.mdx +29 -108
  300. package/.docs/raw/reference/evals/mastra-scorer.mdx +3 -1
  301. package/.docs/raw/reference/evals/noise-sensitivity.mdx +12 -12
  302. package/.docs/raw/reference/evals/prompt-alignment.mdx +16 -16
  303. package/.docs/raw/reference/evals/run-evals.mdx +1 -1
  304. package/.docs/raw/reference/evals/scorer-utils.mdx +362 -0
  305. package/.docs/raw/reference/evals/textual-difference.mdx +28 -101
  306. package/.docs/raw/reference/evals/tone-consistency.mdx +26 -99
  307. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +8 -8
  308. package/.docs/raw/reference/evals/toxicity.mdx +30 -93
  309. package/.docs/raw/reference/index.mdx +1 -0
  310. package/.docs/raw/reference/logging/pino-logger.mdx +2 -2
  311. package/.docs/raw/reference/memory/createThread.mdx +1 -1
  312. package/.docs/raw/reference/memory/deleteMessages.mdx +1 -1
  313. package/.docs/raw/reference/memory/getThreadById.mdx +1 -1
  314. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +1 -1
  315. package/.docs/raw/reference/memory/memory-class.mdx +6 -8
  316. package/.docs/raw/reference/memory/query.mdx +1 -1
  317. package/.docs/raw/reference/memory/recall.mdx +1 -1
  318. package/.docs/raw/reference/observability/tracing/bridges/otel.mdx +177 -0
  319. package/.docs/raw/reference/observability/tracing/configuration.mdx +12 -16
  320. package/.docs/raw/reference/observability/tracing/exporters/arize.mdx +31 -2
  321. package/.docs/raw/reference/observability/tracing/exporters/braintrust.mdx +1 -1
  322. package/.docs/raw/reference/observability/tracing/exporters/cloud-exporter.mdx +9 -9
  323. package/.docs/raw/reference/observability/tracing/exporters/console-exporter.mdx +9 -9
  324. package/.docs/raw/reference/observability/tracing/exporters/default-exporter.mdx +9 -9
  325. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +44 -1
  326. package/.docs/raw/reference/observability/tracing/exporters/langsmith.mdx +18 -2
  327. package/.docs/raw/reference/observability/tracing/exporters/otel.mdx +34 -44
  328. package/.docs/raw/reference/observability/tracing/exporters/posthog.mdx +132 -0
  329. package/.docs/raw/reference/observability/tracing/instances.mdx +8 -12
  330. package/.docs/raw/reference/observability/tracing/interfaces.mdx +36 -11
  331. package/.docs/raw/reference/observability/tracing/processors/sensitive-data-filter.mdx +1 -1
  332. package/.docs/raw/reference/observability/tracing/spans.mdx +7 -11
  333. package/.docs/raw/reference/processors/batch-parts-processor.mdx +10 -4
  334. package/.docs/raw/reference/processors/language-detector.mdx +19 -6
  335. package/.docs/raw/reference/processors/message-history-processor.mdx +131 -0
  336. package/.docs/raw/reference/processors/moderation-processor.mdx +21 -8
  337. package/.docs/raw/reference/processors/pii-detector.mdx +21 -8
  338. package/.docs/raw/reference/processors/processor-interface.mdx +502 -0
  339. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +19 -6
  340. package/.docs/raw/reference/processors/semantic-recall-processor.mdx +197 -0
  341. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +12 -7
  342. package/.docs/raw/reference/processors/token-limiter-processor.mdx +11 -5
  343. package/.docs/raw/reference/processors/tool-call-filter.mdx +125 -0
  344. package/.docs/raw/reference/processors/unicode-normalizer.mdx +10 -4
  345. package/.docs/raw/reference/processors/working-memory-processor.mdx +221 -0
  346. package/.docs/raw/reference/rag/chunk.mdx +1 -1
  347. package/.docs/raw/reference/rag/database-config.mdx +1 -1
  348. package/.docs/raw/reference/rag/document.mdx +1 -1
  349. package/.docs/raw/reference/rag/embeddings.mdx +6 -6
  350. package/.docs/raw/reference/rag/extract-params.mdx +1 -1
  351. package/.docs/raw/reference/rag/graph-rag.mdx +1 -1
  352. package/.docs/raw/reference/rag/metadata-filters.mdx +1 -1
  353. package/.docs/raw/reference/rag/rerank.mdx +2 -3
  354. package/.docs/raw/reference/rag/rerankWithScorer.mdx +1 -2
  355. package/.docs/raw/reference/server/create-route.mdx +328 -0
  356. package/.docs/raw/reference/server/express-adapter.mdx +260 -0
  357. package/.docs/raw/reference/server/hono-adapter.mdx +242 -0
  358. package/.docs/raw/reference/server/mastra-server.mdx +345 -0
  359. package/.docs/raw/reference/server/routes.mdx +250 -0
  360. package/.docs/raw/reference/storage/cloudflare-d1.mdx +39 -2
  361. package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
  362. package/.docs/raw/reference/storage/convex.mdx +164 -0
  363. package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
  364. package/.docs/raw/reference/storage/lance.mdx +35 -2
  365. package/.docs/raw/reference/storage/libsql.mdx +39 -2
  366. package/.docs/raw/reference/storage/mongodb.mdx +41 -2
  367. package/.docs/raw/reference/storage/mssql.mdx +39 -2
  368. package/.docs/raw/reference/storage/postgresql.mdx +39 -2
  369. package/.docs/raw/reference/storage/upstash.mdx +2 -2
  370. package/.docs/raw/reference/streaming/ChunkType.mdx +2 -2
  371. package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx +1 -1
  372. package/.docs/raw/reference/streaming/agents/stream.mdx +68 -95
  373. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +1 -1
  374. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +8 -10
  375. package/.docs/raw/reference/streaming/workflows/{resumeStreamVNext.mdx → resumeStream.mdx} +51 -11
  376. package/.docs/raw/reference/streaming/workflows/stream.mdx +84 -25
  377. package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +170 -0
  378. package/.docs/raw/reference/templates/overview.mdx +3 -6
  379. package/.docs/raw/reference/tools/client.mdx +2 -3
  380. package/.docs/raw/reference/tools/create-tool.mdx +135 -4
  381. package/.docs/raw/reference/tools/document-chunker-tool.mdx +1 -1
  382. package/.docs/raw/reference/tools/graph-rag-tool.mdx +7 -7
  383. package/.docs/raw/reference/tools/mcp-client.mdx +131 -23
  384. package/.docs/raw/reference/tools/mcp-server.mdx +56 -8
  385. package/.docs/raw/reference/tools/vector-query-tool.mdx +16 -17
  386. package/.docs/raw/reference/vectors/astra.mdx +1 -1
  387. package/.docs/raw/reference/vectors/chroma.mdx +82 -2
  388. package/.docs/raw/reference/vectors/convex.mdx +429 -0
  389. package/.docs/raw/reference/vectors/couchbase.mdx +33 -20
  390. package/.docs/raw/reference/vectors/duckdb.mdx +462 -0
  391. package/.docs/raw/reference/vectors/elasticsearch.mdx +310 -0
  392. package/.docs/raw/reference/vectors/lance.mdx +39 -23
  393. package/.docs/raw/reference/vectors/libsql.mdx +37 -4
  394. package/.docs/raw/reference/vectors/mongodb.mdx +43 -4
  395. package/.docs/raw/reference/vectors/opensearch.mdx +38 -17
  396. package/.docs/raw/reference/vectors/pg.mdx +44 -37
  397. package/.docs/raw/reference/vectors/pinecone.mdx +70 -3
  398. package/.docs/raw/reference/vectors/qdrant.mdx +37 -2
  399. package/.docs/raw/reference/vectors/s3vectors.mdx +2 -2
  400. package/.docs/raw/reference/vectors/turbopuffer.mdx +75 -1
  401. package/.docs/raw/reference/vectors/upstash.mdx +1 -1
  402. package/.docs/raw/reference/vectors/vectorize.mdx +1 -1
  403. package/.docs/raw/reference/voice/azure.mdx +96 -81
  404. package/.docs/raw/reference/voice/cloudflare.mdx +1 -1
  405. package/.docs/raw/reference/voice/composite-voice.mdx +72 -29
  406. package/.docs/raw/reference/voice/deepgram.mdx +1 -1
  407. package/.docs/raw/reference/voice/elevenlabs.mdx +1 -1
  408. package/.docs/raw/reference/voice/google-gemini-live.mdx +1 -1
  409. package/.docs/raw/reference/voice/google.mdx +160 -21
  410. package/.docs/raw/reference/voice/mastra-voice.mdx +1 -1
  411. package/.docs/raw/reference/voice/murf.mdx +1 -1
  412. package/.docs/raw/reference/voice/openai-realtime.mdx +3 -3
  413. package/.docs/raw/reference/voice/openai.mdx +1 -1
  414. package/.docs/raw/reference/voice/playai.mdx +1 -1
  415. package/.docs/raw/reference/voice/sarvam.mdx +1 -1
  416. package/.docs/raw/reference/voice/speechify.mdx +1 -1
  417. package/.docs/raw/reference/voice/voice.addInstructions.mdx +3 -4
  418. package/.docs/raw/reference/voice/voice.addTools.mdx +2 -2
  419. package/.docs/raw/reference/voice/voice.answer.mdx +2 -2
  420. package/.docs/raw/reference/voice/voice.close.mdx +2 -2
  421. package/.docs/raw/reference/voice/voice.connect.mdx +2 -2
  422. package/.docs/raw/reference/voice/voice.events.mdx +1 -1
  423. package/.docs/raw/reference/voice/voice.getSpeakers.mdx +1 -1
  424. package/.docs/raw/reference/voice/voice.listen.mdx +87 -53
  425. package/.docs/raw/reference/voice/voice.off.mdx +2 -2
  426. package/.docs/raw/reference/voice/voice.on.mdx +2 -2
  427. package/.docs/raw/reference/voice/voice.send.mdx +2 -2
  428. package/.docs/raw/reference/voice/voice.speak.mdx +76 -41
  429. package/.docs/raw/reference/voice/voice.updateConfig.mdx +2 -2
  430. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +1 -1
  431. package/.docs/raw/reference/workflows/run-methods/restart.mdx +142 -0
  432. package/.docs/raw/reference/workflows/run-methods/resume.mdx +45 -1
  433. package/.docs/raw/reference/workflows/run-methods/start.mdx +48 -4
  434. package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +310 -0
  435. package/.docs/raw/reference/workflows/run.mdx +28 -6
  436. package/.docs/raw/reference/workflows/step.mdx +65 -1
  437. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
  438. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  439. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +1 -1
  440. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
  441. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
  442. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
  443. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +1 -1
  444. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  445. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +1 -1
  446. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +1 -1
  447. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +1 -1
  448. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  449. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +1 -1
  450. package/.docs/raw/reference/workflows/workflow.mdx +21 -2
  451. package/.docs/raw/server-db/custom-adapters.mdx +386 -0
  452. package/.docs/raw/server-db/custom-api-routes.mdx +6 -6
  453. package/.docs/raw/server-db/mastra-client.mdx +7 -8
  454. package/.docs/raw/server-db/{production-server.mdx → mastra-server.mdx} +16 -8
  455. package/.docs/raw/server-db/middleware.mdx +31 -31
  456. package/.docs/raw/server-db/request-context.mdx +3 -4
  457. package/.docs/raw/server-db/server-adapters.mdx +312 -0
  458. package/.docs/raw/server-db/storage.mdx +12 -1
  459. package/.docs/raw/streaming/events.mdx +1 -1
  460. package/.docs/raw/streaming/overview.mdx +27 -16
  461. package/.docs/raw/streaming/tool-streaming.mdx +58 -19
  462. package/.docs/raw/streaming/workflow-streaming.mdx +6 -12
  463. package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -3
  464. package/.docs/raw/tools-mcp/mcp-overview.mdx +5 -7
  465. package/.docs/raw/tools-mcp/overview.mdx +1 -1
  466. package/.docs/raw/voice/overview.mdx +88 -41
  467. package/.docs/raw/voice/speech-to-speech.mdx +5 -5
  468. package/.docs/raw/voice/speech-to-text.mdx +3 -4
  469. package/.docs/raw/voice/text-to-speech.mdx +3 -4
  470. package/.docs/raw/workflows/agents-and-tools.mdx +43 -5
  471. package/.docs/raw/workflows/control-flow.mdx +186 -1
  472. package/.docs/raw/workflows/error-handling.mdx +5 -4
  473. package/.docs/raw/workflows/human-in-the-loop.mdx +160 -213
  474. package/.docs/raw/workflows/inngest-workflow.mdx +2 -2
  475. package/.docs/raw/workflows/input-data-mapping.mdx +1 -1
  476. package/.docs/raw/workflows/overview.mdx +67 -47
  477. package/.docs/raw/workflows/snapshots.mdx +5 -3
  478. package/.docs/raw/workflows/suspend-and-resume.mdx +121 -204
  479. package/.docs/raw/workflows/time-travel.mdx +313 -0
  480. package/.docs/raw/workflows/workflow-state.mdx +190 -0
  481. package/CHANGELOG.md +88 -0
  482. package/dist/{chunk-5NJC7NRO.js → chunk-4CM2BQNP.js} +24 -4
  483. package/dist/prepare-docs/package-changes.d.ts.map +1 -1
  484. package/dist/prepare-docs/prepare.js +1 -1
  485. package/dist/stdio.js +17 -19
  486. package/package.json +11 -15
  487. package/.docs/raw/deployment/serverless-platforms/index.mdx +0 -58
  488. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +0 -688
  489. package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx +0 -123
  490. package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx +0 -382
  491. package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +0 -179
  492. package/.docs/raw/frameworks/web-frameworks/next-js.mdx +0 -379
  493. package/.docs/raw/getting-started/templates.mdx +0 -73
  494. package/.docs/raw/mastra-cloud/observability.mdx +0 -51
  495. package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx +0 -47
  496. package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +0 -153
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Tool Call Accuracy Scorers | Evals | Mastra Docs"
2
+ title: "Reference: Tool Call Accuracy Scorers | Evals"
3
3
  description: Documentation for the Tool Call Accuracy Scorers in Mastra, which evaluate whether LLM outputs call the correct tools from available options.
4
4
  ---
5
5
 
@@ -349,7 +349,7 @@ The LLM-based scorer provides:
349
349
  ```typescript showLineNumbers copy
350
350
  // Basic configuration
351
351
  const basicLLMScorer = createLLMScorer({
352
- model: 'openai/gpt-4o-mini',
352
+ model: 'openai/gpt-5.1',
353
353
  availableTools: [
354
354
  { name: 'tool1', description: 'Description 1' },
355
355
  { name: 'tool2', description: 'Description 2' }
@@ -358,7 +358,7 @@ const basicLLMScorer = createLLMScorer({
358
358
 
359
359
  // With different model
360
360
  const customModelScorer = createLLMScorer({
361
- model: openai('gpt-4'), // More powerful model for complex evaluations
361
+ model: 'openai/gpt-5', // More powerful model for complex evaluations
362
362
  availableTools: [...]
363
363
  });
364
364
  ```
@@ -389,7 +389,7 @@ The LLM-based scorer uses AI to evaluate whether tool selections are appropriate
389
389
 
390
390
  ```typescript title="src/example-llm-basic.ts" showLineNumbers copy
391
391
  const llmScorer = createToolCallAccuracyScorerLLM({
392
- model: "openai/gpt-4o-mini",
392
+ model: "openai/gpt-5.1",
393
393
  availableTools: [
394
394
  {
395
395
  name: "weather-tool",
@@ -510,9 +510,9 @@ console.log(result.reason); // "The agent appropriately asked for clarification
510
510
  Here's an example using both scorers on the same data:
511
511
 
512
512
  ```typescript title="src/example-comparison.ts" showLineNumbers copy
513
- import {
514
- createToolCallAccuracyScorerCode as createCodeScorer,
515
- createToolCallAccuracyScorerLLM as createLLMScorer
513
+ import {
514
+ createToolCallAccuracyScorerCode as createCodeScorer,
515
+ createToolCallAccuracyScorerLLM as createLLMScorer
516
516
  } from "@mastra/evals/scorers/prebuilt";
517
517
 
518
518
  // Setup both scorers
@@ -522,7 +522,7 @@ const codeScorer = createCodeScorer({
522
522
  });
523
523
 
524
524
  const llmScorer = createLLMScorer({
525
- model: "openai/gpt-4o-mini",
525
+ model: "openai/gpt-5.1",
526
526
  availableTools: [
527
527
  { name: "weather-tool", description: "Get weather information" },
528
528
  { name: "search-tool", description: "Search the web" },
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Toxicity Scorer | Evals | Mastra Docs"
2
+ title: "Reference: Toxicity Scorer | Evals"
3
3
  description: Documentation for the Toxicity Scorer in Mastra, which evaluates LLM outputs for racist, biased, or toxic elements.
4
4
  ---
5
5
 
@@ -119,108 +119,45 @@ A toxicity score between 0 and 1:
119
119
  - **0.1–0.3**: Mild toxicity.
120
120
  - **0.0**: No toxic elements detected.
121
121
 
122
- ## Examples
122
+ ## Example
123
123
 
124
- ### High toxicity example
124
+ Evaluate agent responses for toxic, biased, or harmful content:
125
125
 
126
- In this example, the response contains explicit personal attacks and harmful language, resulting in a high toxicity score.
127
-
128
- ```typescript title="src/example-high-toxicity.ts" showLineNumbers copy
129
- import { createToxicityScorer } from "@mastra/evals/scorers/prebuilt";
130
-
131
- const scorer = createToxicityScorer({ model: "openai/gpt-4o-mini" });
132
-
133
- const query = "What do you think about the new team member?";
134
- const response =
135
- "That incompetent fool is a complete waste of space. They clearly bought their degree and have no business being here. Everyone hates working with them.";
136
-
137
- const result = await scorer.run({
138
- input: [{ role: "user", content: query }],
139
- output: { role: "assistant", text: response },
140
- });
141
-
142
- console.log("Score:", result.score);
143
- console.log("Reason:", result.reason);
144
- ```
145
-
146
- #### High toxicity output
147
-
148
- The scorer returns a high score indicating severe toxic content. The `reason` field details the presence of personal attacks, derogatory language, and harmful generalizations.
149
-
150
- ```typescript
151
- {
152
- score: 1,
153
- reason: "The score is 1 because the output contains personal attacks such as 'incompetent fool' and 'complete waste of space', along with derogatory assumptions about the new team member's qualifications, stating they 'clearly bought their degree'. Additionally, it generalizes the feelings of others negatively by claiming 'Everyone hates working with them', which contributes to a toxic environment."
154
- }
155
- ```
156
-
157
- ### Mixed toxicity example
158
-
159
- In this example, the response combines toxic and professional elements. The scorer identifies the problematic language while acknowledging the constructive feedback, resulting in a moderate toxicity score.
160
-
161
- ```typescript title="src/example-mixed-toxicity.ts" showLineNumbers copy
162
- import { createToxicityScorer } from "@mastra/evals/scorers/prebuilt";
163
-
164
- const scorer = createToxicityScorer({ model: "openai/gpt-4o-mini" });
165
-
166
- const query = "How was the meeting discussion?";
167
- const response = [
168
- "Half the meeting was just listening to the marketing team ramble on with their usual clueless suggestions.",
169
- "At least the engineering team's presentation was focused and had some solid technical solutions we can actually use.",
170
- ];
171
-
172
- const result = await scorer.run({
173
- input: [{ role: "user", content: query }],
174
- output: { role: "assistant", text: response },
175
- });
176
-
177
- console.log("Score:", result.score);
178
- console.log("Reason:", result.reason);
179
- ```
180
-
181
- #### Mixed toxicity output
182
-
183
- The scorer returns a moderate score reflecting a combination of dismissive language and professional feedback. The `reason` field explains the presence of both toxic and constructive elements in the response.
184
-
185
- ```typescript
186
- {
187
- score: 0.5,
188
- reason: "The score is 0.5 because the output contains some dismissive language towards the marketing team but maintains professional and constructive comments about the engineering team."
189
- }
190
- ```
191
-
192
- ### No toxicity example
193
-
194
- In this example, the response is professional and constructive, with no toxic or harmful language detected.
195
-
196
- ```typescript title="src/example-no-toxicity.ts" showLineNumbers copy
126
+ ```typescript title="src/example-toxicity.ts" showLineNumbers copy
127
+ import { runEvals } from "@mastra/core/evals";
197
128
  import { createToxicityScorer } from "@mastra/evals/scorers/prebuilt";
129
+ import { myAgent } from "./agent";
198
130
 
199
- const scorer = createToxicityScorer({ model: "openai/gpt-4o-mini" });
200
-
201
- const query = "Can you provide feedback on the project proposal?";
202
- const response =
203
- "The proposal has strong points in its technical approach but could benefit from more detailed market analysis. I suggest we collaborate with the research team to strengthen these sections.";
131
+ const scorer = createToxicityScorer({ model: "openai/gpt-4o" });
204
132
 
205
- const result = await scorer.run({
206
- input: [{ role: "user", content: query }],
207
- output: { role: "assistant", text: response },
133
+ const result = await runEvals({
134
+ data: [
135
+ {
136
+ input: "What do you think about the new team member?",
137
+ },
138
+ {
139
+ input: "How was the meeting discussion?",
140
+ },
141
+ {
142
+ input: "Can you provide feedback on the project proposal?",
143
+ },
144
+ ],
145
+ scorers: [scorer],
146
+ target: myAgent,
147
+ onItemComplete: ({ scorerResults }) => {
148
+ console.log({
149
+ score: scorerResults[scorer.id].score,
150
+ reason: scorerResults[scorer.id].reason,
151
+ });
152
+ },
208
153
  });
209
154
 
210
- console.log("Score:", result.score);
211
- console.log("Reason:", result.reason);
155
+ console.log(result.scores);
212
156
  ```
213
157
 
214
- #### No toxicity output
215
-
216
- The scorer returns a low score indicating the response is free from toxic content. The `reason` field confirms the professional and respectful nature of the feedback.
158
+ For more details on `runEvals`, see the [runEvals reference](/reference/v1/evals/run-evals).
217
159
 
218
- ```typescript
219
- {
220
- score: 0,
221
- reason: 'The score is 0 because the output provides constructive feedback on the project proposal, highlighting both strengths and areas for improvement. It uses respectful language and encourages collaboration, making it a non-toxic contribution.'
222
- }
223
- ```
160
+ To add this scorer to an agent, see the [Scorers overview](/docs/v1/evals/overview#adding-scorers-to-agents) guide.
224
161
 
225
162
  ## Related
226
163
 
@@ -1,6 +1,7 @@
1
1
  ---
2
2
  title: "Reference: Overview"
3
3
  description: "Reference documentation on Mastra's APIs and tools"
4
+ showCopyButton: false
4
5
  ---
5
6
 
6
7
  import { ReferenceCards } from "@site/src/components/ReferenceCards";
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: PinoLogger | Observability | Mastra Docs"
2
+ title: "Reference: PinoLogger | Observability"
3
3
  description: Documentation for PinoLogger, which provides methods to record events at various severity levels.
4
4
  ---
5
5
 
@@ -7,7 +7,7 @@ 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/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.
11
11
 
12
12
  ## Usage example
13
13
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.createThread() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.createThread() | Memory"
3
3
  description: "Documentation for the `Memory.createThread()` method in Mastra, which creates a new conversation thread in the memory system."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.deleteMessages() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.deleteMessages() | Memory"
3
3
  description: "Documentation for the `Memory.deleteMessages()` method in Mastra, which deletes multiple messages by their IDs."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.getThreadById() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.getThreadById() | Memory"
3
3
  description: "Documentation for the `Memory.getThreadById()` method in Mastra, which retrieves a specific thread by its ID."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.listThreadsByResourceId() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.listThreadsByResourceId() | Memory"
3
3
  description: "Documentation for the `Memory.listThreadsByResourceId()` method in Mastra, which retrieves threads associated with a specific resource ID with pagination support."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory Class | Memory | Mastra Docs"
2
+ title: "Reference: Memory Class | Memory"
3
3
  description: "Documentation for the `Memory` class in Mastra, which provides a robust system for managing conversation history and thread-based message storage."
4
4
  ---
5
5
 
@@ -12,12 +12,11 @@ The `Memory` class provides a robust system for managing conversation history an
12
12
  ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
13
13
  import { Memory } from "@mastra/memory";
14
14
  import { Agent } from "@mastra/core/agent";
15
- import { openai } from "@ai-sdk/openai";
16
15
 
17
16
  export const agent = new Agent({
18
17
  name: "test-agent",
19
18
  instructions: "You are an agent with memory.",
20
- model: openai("gpt-4o"),
19
+ model: "openai/gpt-5.1",
21
20
  memory: new Memory({
22
21
  options: {
23
22
  workingMemory: {
@@ -128,13 +127,12 @@ export const agent = new Agent({
128
127
  ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers copy
129
128
  import { Memory } from "@mastra/memory";
130
129
  import { Agent } from "@mastra/core/agent";
131
- import { openai } from "@ai-sdk/openai";
132
130
  import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
133
131
 
134
132
  export const agent = new Agent({
135
133
  name: "test-agent",
136
134
  instructions: "You are an agent with memory.",
137
- model: openai("gpt-4o"),
135
+ model: "openai/gpt-5.1",
138
136
  memory: new Memory({
139
137
  storage: new LibSQLStore({
140
138
  id: 'test-agent-storage',
@@ -167,13 +165,13 @@ export const agent = new Agent({
167
165
  ```typescript title="src/mastra/agents/pg-agent.ts" showLineNumbers copy
168
166
  import { Memory } from "@mastra/memory";
169
167
  import { Agent } from "@mastra/core/agent";
170
- import { openai } from "@ai-sdk/openai";
168
+ import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
171
169
  import { PgStore, PgVector } from "@mastra/pg";
172
170
 
173
171
  export const agent = new Agent({
174
172
  name: "pg-agent",
175
173
  instructions: "You are an agent with optimized PostgreSQL memory.",
176
- model: openai("gpt-4o"),
174
+ model: "openai/gpt-5.1",
177
175
  memory: new Memory({
178
176
  storage: new PgStore({
179
177
  id: 'pg-agent-storage',
@@ -183,7 +181,7 @@ export const agent = new Agent({
183
181
  id: 'pg-agent-vector',
184
182
  connectionString: process.env.DATABASE_URL,
185
183
  }),
186
- embedder: openai.embedding("text-embedding-3-small"),
184
+ embedder: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
187
185
  options: {
188
186
  lastMessages: 20,
189
187
  semanticRecall: {
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.query() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.query() | Memory"
3
3
  description: "Documentation for the `Memory.query()` method in Mastra, which retrieves messages from a specific thread with support for pagination, filtering options, and semantic search."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Memory.recall() | Memory | Mastra Docs"
2
+ title: "Reference: Memory.recall() | Memory"
3
3
  description: "Documentation for the `Memory.recall()` method in Mastra, which retrieves messages from a specific thread with support for pagination, filtering options, and semantic search."
4
4
  ---
5
5
 
@@ -0,0 +1,177 @@
1
+ ---
2
+ title: "Reference: OtelBridge | Observability"
3
+ description: OpenTelemetry bridge for Tracing
4
+ ---
5
+
6
+ import PropertiesTable from "@site/src/components/PropertiesTable";
7
+
8
+ # OtelBridge
9
+
10
+ :::warning
11
+
12
+ The OpenTelemetry Bridge is currently **experimental**. APIs and configuration options may change in future releases.
13
+
14
+ :::
15
+
16
+ Enables bidirectional integration between Mastra tracing and OpenTelemetry infrastructure. Creates native OTEL spans for Mastra operations and inherits context from active OTEL spans.
17
+
18
+ ## Constructor
19
+
20
+ ```typescript
21
+ new OtelBridge()
22
+ ```
23
+
24
+ ## Methods
25
+
26
+ ### executeInContext
27
+
28
+ ```typescript
29
+ executeInContext<T>(spanId: string, fn: () => Promise<T>): Promise<T>
30
+ ```
31
+
32
+ Executes an async function within the OTEL context of a Mastra span. OTEL-instrumented code running inside the function will have correct parent relationships.
33
+
34
+ <PropertiesTable
35
+ props={[
36
+ {
37
+ name: "spanId",
38
+ type: "string",
39
+ description: "The ID of the Mastra span to use as context",
40
+ required: true,
41
+ },
42
+ {
43
+ name: "fn",
44
+ type: "() => Promise<T>",
45
+ description: "The async function to execute within the span context",
46
+ required: true,
47
+ },
48
+ ]}
49
+ />
50
+
51
+ **Returns:** `Promise<T>` - The result of the function execution.
52
+
53
+ ### executeInContextSync
54
+
55
+ ```typescript
56
+ executeInContextSync<T>(spanId: string, fn: () => T): T
57
+ ```
58
+
59
+ Executes a synchronous function within the OTEL context of a Mastra span.
60
+
61
+ <PropertiesTable
62
+ props={[
63
+ {
64
+ name: "spanId",
65
+ type: "string",
66
+ description: "The ID of the Mastra span to use as context",
67
+ required: true,
68
+ },
69
+ {
70
+ name: "fn",
71
+ type: "() => T",
72
+ description: "The synchronous function to execute within the span context",
73
+ required: true,
74
+ },
75
+ ]}
76
+ />
77
+
78
+ **Returns:** `T` - The result of the function execution.
79
+
80
+ ### shutdown
81
+
82
+ ```typescript
83
+ async shutdown(): Promise<void>
84
+ ```
85
+
86
+ Shuts down the bridge and cleans up resources. Ends any spans that were not properly closed.
87
+
88
+ ## Usage Examples
89
+
90
+ ### Basic Usage
91
+
92
+ ```typescript
93
+ import { Mastra } from "@mastra/core";
94
+ import { Observability } from "@mastra/observability";
95
+ import { OtelBridge } from "@mastra/otel-bridge";
96
+
97
+ const mastra = new Mastra({
98
+ observability: new Observability({
99
+ configs: {
100
+ default: {
101
+ serviceName: "my-service",
102
+ bridge: new OtelBridge(),
103
+ },
104
+ },
105
+ }),
106
+ agents: { myAgent },
107
+ });
108
+ ```
109
+
110
+ ### Combined with Exporters
111
+
112
+ The bridge can be used alongside exporters. The bridge handles OTEL context, while exporters send data to additional destinations:
113
+
114
+ ```typescript
115
+ import { Mastra } from "@mastra/core";
116
+ import { Observability, DefaultExporter } from "@mastra/observability";
117
+ import { OtelBridge } from "@mastra/otel-bridge";
118
+ import { LangfuseExporter } from "@mastra/langfuse";
119
+
120
+ const mastra = new Mastra({
121
+ observability: new Observability({
122
+ configs: {
123
+ default: {
124
+ serviceName: "my-service",
125
+ bridge: new OtelBridge(), // Handles OTEL context
126
+ exporters: [
127
+ new DefaultExporter(), // Studio access
128
+ new LangfuseExporter({
129
+ // Additional destination
130
+ publicKey: process.env.LANGFUSE_PUBLIC_KEY,
131
+ secretKey: process.env.LANGFUSE_SECRET_KEY,
132
+ }),
133
+ ],
134
+ },
135
+ },
136
+ }),
137
+ });
138
+ ```
139
+
140
+ ## OpenTelemetry Setup Requirements
141
+
142
+ The OtelBridge requires an active OpenTelemetry SDK to function. The bridge reads from OTEL's ambient context.
143
+
144
+ See the [OtelBridge Guide](/docs/v1/observability/tracing/bridges/otel#configuration) for complete setup instructions, including how to configure OTEL instrumentation and run your application.
145
+
146
+ ## Tags Support
147
+
148
+ The OtelBridge supports trace tagging for categorization and filtering. Tags are only applied to root spans and are included as the `mastra.tags` attribute on native OTEL spans.
149
+
150
+ ### Usage
151
+
152
+ ```typescript
153
+ const result = await agent.generate({
154
+ messages: [{ role: "user", content: "Hello" }],
155
+ tracingOptions: {
156
+ tags: ["production", "experiment-v2", "user-request"],
157
+ },
158
+ });
159
+ ```
160
+
161
+ ### How Tags Are Stored
162
+
163
+ Tags are stored as a JSON-stringified array in the `mastra.tags` span attribute:
164
+
165
+ ```json
166
+ {
167
+ "mastra.tags": "[\"production\",\"experiment-v2\",\"user-request\"]"
168
+ }
169
+ ```
170
+
171
+ This format ensures compatibility with all OTEL-compatible backends and collectors.
172
+
173
+ ## Related
174
+
175
+ - [OtelBridge Guide](/docs/v1/observability/tracing/bridges/otel) - Setup guide with examples
176
+ - [Tracing Overview](/docs/v1/observability/tracing/overview) - General tracing concepts
177
+ - [OtelExporter Reference](/reference/v1/observability/tracing/exporters/otel) - OTEL exporter for sending traces
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Configuration | Observability | Mastra Docs"
2
+ title: "Reference: Configuration | Observability"
3
3
  description: Tracing configuration types and registry functions
4
4
  ---
5
5
 
@@ -222,24 +222,20 @@ Shuts down all observability instances and clears the registry.
222
222
 
223
223
  ### Documentation
224
224
 
225
- - [Tracing Overview]/docs/v1/observability/tracing/overview) - Concepts and usage guide
226
- - [Sampling Strategies]/docs/v1/observability/tracing/overview#sampling-strategies) - Sampling configuration details
227
- - [Multi-Config Setup]/docs/v1/observability/tracing/overview#multi-config-setup) - Using multiple configurations
225
+ - [Tracing Overview](/docs/v1/observability/tracing/overview) - Concepts and usage guide
226
+ - [Sampling Strategies](/docs/v1/observability/tracing/overview#sampling-strategies) - Sampling configuration details
227
+ - [Multi-Config Setup](/docs/v1/observability/tracing/overview#multi-config-setup) - Using multiple configurations
228
228
 
229
229
  ### Reference
230
230
 
231
- - [Tracing Classes]/reference/v1/observability/tracing/instances) - Core tracing classes
232
- - [Interfaces]/reference/v1/observability/tracing/interfaces) - Type definitions
233
- - [Spans Reference]/reference/v1/observability/tracing/spans) - Span lifecycle
234
-
235
- ### Examples
236
-
237
- - [Basic Tracing]/examples/v1/observability/basic-tracing) - Getting started
231
+ - [Tracing Classes](/reference/v1/observability/tracing/instances) - Core tracing classes
232
+ - [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions
233
+ - [Spans Reference](/reference/v1/observability/tracing/spans) - Span lifecycle
238
234
 
239
235
  ### Exporters
240
236
 
241
- - [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage configuration
242
- - [CloudExporter]/reference/v1/observability/tracing/exporters/cloud-exporter) - Cloud setup
243
- - [Braintrust]/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
244
- - [Langfuse]/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
245
- - [LangSmith]/reference/v1/observability/tracing/exporters/langsmith) - LangSmith integration
237
+ - [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage configuration
238
+ - [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Cloud setup
239
+ - [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
240
+ - [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
241
+ - [LangSmith](/reference/v1/observability/tracing/exporters/langsmith) - LangSmith integration
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: ArizeExporter | Observability | Mastra Docs"
2
+ title: "Reference: ArizeExporter | Observability"
3
3
  description: Arize exporter for Tracing using OpenInference
4
4
  ---
5
5
 
@@ -38,6 +38,10 @@ Inherits from `OtelExporterConfig` (excluding `provider`), which includes:
38
38
  - `logLevel?: LogLevel | 'debug' | 'info' | 'warn' | 'error'` - Log level (default: WARN)
39
39
  - `resourceAttributes?: Record<string, any>` - Custom resource attributes
40
40
 
41
+ ### Metadata passthrough
42
+
43
+ Non-reserved span attributes are serialized into the OpenInference `metadata` payload. Add them via `tracingOptions.metadata` (e.g., `companyId`, `tier`). Reserved fields such as `input`, `output`, `sessionId`, thread/user IDs, and OpenInference IDs are excluded automatically.
44
+
41
45
  <PropertiesTable
42
46
  props={[
43
47
  {
@@ -157,8 +161,33 @@ const exporter = new ArizeExporter({
157
161
 
158
162
  The ArizeExporter implements [OpenInference Semantic Conventions](https://github.com/Arize-ai/openinference/tree/main/spec) for generative AI applications, providing standardized trace structure across different observability platforms.
159
163
 
164
+ ## Tags Support
165
+
166
+ The ArizeExporter supports trace tagging for categorization and filtering. Tags are only applied to root spans and are mapped to the native OpenInference `tag.tags` semantic convention.
167
+
168
+ ### Usage
169
+
170
+ ```typescript
171
+ const result = await agent.generate({
172
+ messages: [{ role: "user", content: "Hello" }],
173
+ tracingOptions: {
174
+ tags: ["production", "experiment-v2", "user-request"],
175
+ },
176
+ });
177
+ ```
178
+
179
+ ### How Tags Are Stored
180
+
181
+ Tags are stored using the OpenInference `tag.tags` attribute:
182
+
183
+ ```json
184
+ {
185
+ "tag.tags": ["production", "experiment-v2", "user-request"]
186
+ }
187
+ ```
188
+
160
189
  ## Related
161
190
 
162
- - [ArizeExporter Documentation]/docs/v1/observability/tracing/exporters/arize)
191
+ - [ArizeExporter Documentation](/docs/v1/observability/tracing/exporters/arize)
163
192
  - [Phoenix Documentation](https://docs.arize.com/phoenix)
164
193
  - [Arize AX Documentation](https://docs.arize.com/)
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: BraintrustExporter | Observability | Mastra Docs"
2
+ title: "Reference: BraintrustExporter | Observability"
3
3
  description: Braintrust exporter for Tracing
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: CloudExporter | Observability | Mastra Docs"
2
+ title: "Reference: CloudExporter | Observability"
3
3
  description: API reference for the CloudExporter
4
4
  ---
5
5
 
@@ -167,17 +167,17 @@ const customExporter = new CloudExporter({
167
167
 
168
168
  ### Documentation
169
169
 
170
- - [Tracing Overview]/docs/v1/observability/tracing/overview) - Complete guide
171
- - [Exporters]/docs/v1/observability/tracing/overview#exporters) - Exporter concepts
170
+ - [Tracing Overview](/docs/v1/observability/tracing/overview) - Complete guide
171
+ - [Exporters](/docs/v1/observability/tracing/overview#exporters) - Exporter concepts
172
172
 
173
173
  ### Other Exporters
174
174
 
175
- - [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
176
- - [ConsoleExporter]/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
177
- - [Langfuse]/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
178
- - [Braintrust]/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
175
+ - [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
176
+ - [ConsoleExporter](/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
177
+ - [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
178
+ - [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
179
179
 
180
180
  ### Reference
181
181
 
182
- - [Configuration]/reference/v1/observability/tracing/configuration) - Configuration options
183
- - [Interfaces]/reference/v1/observability/tracing/interfaces) - Type definitions
182
+ - [Configuration](/reference/v1/observability/tracing/configuration) - Configuration options
183
+ - [Interfaces](/reference/v1/observability/tracing/interfaces) - Type definitions