@mastra/mcp-docs-server 1.2.15-alpha.9 → 1.2.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 (498) hide show
  1. package/.docs/docs/agents/agent-approval.md +14 -0
  2. package/.docs/docs/agents/code-mode.md +17 -2
  3. package/.docs/docs/agents/networks.md +2 -2
  4. package/.docs/docs/agents/overview.md +2 -2
  5. package/.docs/docs/agents/processors.md +3 -3
  6. package/.docs/docs/agents/using-tools.md +1 -1
  7. package/.docs/docs/browser/overview.md +8 -8
  8. package/.docs/docs/browser/recording.md +4 -4
  9. package/.docs/docs/capabilities/{channels/overview.md → channels.md} +70 -7
  10. package/.docs/docs/capabilities/subagents.md +6 -3
  11. package/.docs/docs/datasets/running-experiments.md +49 -0
  12. package/.docs/docs/deployment/cloud-providers.md +9 -9
  13. package/.docs/docs/deployment/overview.md +9 -9
  14. package/.docs/docs/deployment/sandbox.md +3 -3
  15. package/.docs/docs/deployment/web-framework.md +6 -6
  16. package/.docs/docs/deployment/workers.md +1 -1
  17. package/.docs/docs/deployment/workflow-runners.md +2 -2
  18. package/.docs/docs/getting-started/develop.md +1 -1
  19. package/.docs/docs/harness/agent-controller.md +45 -4
  20. package/.docs/docs/harness/overview.md +2 -4
  21. package/.docs/docs/index.md +8 -8
  22. package/.docs/docs/long-running-agents/durable-agents.md +3 -3
  23. package/.docs/docs/long-running-agents/goals.md +1 -1
  24. package/.docs/docs/long-running-agents/schedules.md +1 -1
  25. package/.docs/docs/long-running-agents/signal-providers.md +3 -16
  26. package/.docs/docs/long-running-agents/signals.md +2 -2
  27. package/.docs/docs/mastra-platform/database.md +2 -2
  28. package/.docs/docs/mastra-platform/deploy.md +27 -0
  29. package/.docs/docs/mastra-platform/server.md +1 -1
  30. package/.docs/docs/mastra-platform/trace-intelligence.md +9 -13
  31. package/.docs/docs/mcp/overview.md +42 -0
  32. package/.docs/docs/memory/memory-processors.md +5 -5
  33. package/.docs/docs/memory/message-history.md +3 -3
  34. package/.docs/docs/memory/multi-user-threads.md +1 -1
  35. package/.docs/docs/memory/observational-memory.md +2 -2
  36. package/.docs/docs/memory/semantic-recall.md +2 -1
  37. package/.docs/docs/memory/working-memory.md +1 -0
  38. package/.docs/docs/observability/integrations/exporters/mastra-platform.md +1 -1
  39. package/.docs/docs/observability/integrations/exporters/mastra-storage.md +16 -15
  40. package/.docs/docs/observability/integrations/overview.md +3 -3
  41. package/.docs/docs/server/auth/fga.md +1 -1
  42. package/.docs/docs/server/auth/simple-auth.md +1 -1
  43. package/.docs/docs/server/auth/workers.md +2 -0
  44. package/.docs/docs/server/auth.md +10 -8
  45. package/.docs/docs/server/custom-adapters.md +1 -1
  46. package/.docs/docs/server/custom-api-routes.md +35 -0
  47. package/.docs/docs/server/mastra-client.md +2 -2
  48. package/.docs/docs/server/mastra-server.md +1 -1
  49. package/.docs/docs/storage/overview.md +14 -12
  50. package/.docs/docs/studio/observability.md +1 -1
  51. package/.docs/docs/workflows/dynamic-workflows.md +1 -1
  52. package/.docs/docs/workflows/overview.md +2 -2
  53. package/.docs/docs/workflows/snapshots.md +12 -10
  54. package/.docs/docs/workflows/time-travel.md +2 -0
  55. package/.docs/docs/workspace/filesystem.md +15 -15
  56. package/.docs/docs/workspace/sandbox.md +17 -17
  57. package/.docs/docs/workspace/search.md +1 -1
  58. package/.docs/guides/agent-frameworks/ai-sdk.md +2 -2
  59. package/.docs/guides/deployment/mastra-workers.md +4 -2
  60. package/.docs/guides/getting-started/quickstart.md +3 -3
  61. package/.docs/guides/guide/signal-provider.md +1 -1
  62. package/.docs/guides/index.md +8 -8
  63. package/.docs/guides/voice/overview.md +55 -106
  64. package/.docs/guides/voice/speech-to-text.md +7 -7
  65. package/.docs/guides/voice/text-to-speech.md +9 -10
  66. package/.docs/{guides/build-your-ui → integrations/agentic-ui}/ai-sdk-ui.md +5 -5
  67. package/.docs/{guides/build-your-ui → integrations/agentic-ui}/assistant-ui.md +1 -1
  68. package/.docs/{guides/build-your-ui/copilotkit/overview.md → integrations/agentic-ui/copilotkit.md} +257 -4
  69. package/.docs/{docs/server → integrations}/auth/auth0.md +1 -1
  70. package/.docs/{docs/server → integrations}/auth/clerk.md +2 -2
  71. package/.docs/{docs/server → integrations}/auth/firebase.md +1 -1
  72. package/.docs/{docs/server → integrations}/auth/okta.md +24 -4
  73. package/.docs/{docs/server → integrations}/auth/supabase.md +2 -2
  74. package/.docs/{docs/server → integrations}/auth/workos.md +1 -1
  75. package/.docs/{docs/browser → integrations/browsers}/agent-browser.md +2 -2
  76. package/.docs/{docs/browser → integrations/browsers}/browser-viewer.md +3 -3
  77. package/.docs/{docs/browser → integrations/browsers}/firecrawl.md +2 -2
  78. package/.docs/{docs/browser → integrations/browsers}/stagehand.md +1 -1
  79. package/.docs/{docs/capabilities → integrations}/channels/discord.md +2 -2
  80. package/.docs/integrations/channels/github.md +103 -0
  81. package/.docs/{docs/capabilities → integrations}/channels/imessage.md +12 -4
  82. package/.docs/{docs/capabilities → integrations}/channels/slack.md +4 -4
  83. package/.docs/{docs/capabilities → integrations}/channels/teams.md +2 -2
  84. package/.docs/{docs/capabilities → integrations}/channels/telegram.md +2 -2
  85. package/.docs/{docs/capabilities → integrations}/channels/whatsapp.md +2 -2
  86. package/.docs/{reference/storage/dsql.md → integrations/databases/aurora-dsql.md} +1 -1
  87. package/.docs/{reference/storage → integrations/databases}/clickhouse.md +2 -2
  88. package/.docs/{reference/storage → integrations/databases}/cloudflare-d1.md +1 -1
  89. package/.docs/{reference/storage/cloudflare.md → integrations/databases/cloudflare-kv.md} +1 -1
  90. package/.docs/{reference/storage → integrations/databases}/convex.md +1 -1
  91. package/.docs/{reference/storage → integrations/databases}/duckdb.md +5 -5
  92. package/.docs/{reference/storage → integrations/databases}/dynamodb.md +1 -1
  93. package/.docs/{reference/storage/lance.md → integrations/databases/lancedb.md} +1 -1
  94. package/.docs/{reference/storage → integrations/databases}/libsql.md +2 -2
  95. package/.docs/{reference/storage → integrations/databases}/mongodb.md +1 -1
  96. package/.docs/{reference/storage → integrations/databases}/mssql.md +1 -1
  97. package/.docs/integrations/databases/neon.md +220 -0
  98. package/.docs/integrations/databases/oracledb.md +239 -0
  99. package/.docs/{reference/storage → integrations/databases}/postgresql.md +1 -1
  100. package/.docs/{reference/storage → integrations/databases}/redis.md +1 -1
  101. package/.docs/{reference/storage → integrations/databases}/spanner.md +1 -1
  102. package/.docs/{reference/storage → integrations/databases}/upstash.md +1 -1
  103. package/.docs/{guides/deployment → integrations/deploy}/amazon-ec2.md +1 -1
  104. package/.docs/{guides/deployment → integrations/deploy}/aws-bedrock-agentcore.md +1 -1
  105. package/.docs/{guides/deployment → integrations/deploy}/aws-lambda.md +2 -2
  106. package/.docs/{guides/deployment → integrations/deploy}/azure-app-services.md +2 -2
  107. package/.docs/{guides/deployment → integrations/deploy}/cloudflare.md +2 -2
  108. package/.docs/{guides/deployment → integrations/deploy}/digital-ocean.md +3 -3
  109. package/.docs/{guides/deployment → integrations/deploy}/kubernetes.md +2 -2
  110. package/.docs/{guides/deployment → integrations/deploy}/netlify.md +3 -3
  111. package/.docs/{guides/deployment → integrations/deploy}/vercel.md +3 -3
  112. package/.docs/{reference/workspace/s3-filesystem.md → integrations/file-storage/amazon-s3.md} +5 -5
  113. package/.docs/{reference/workspace/archil-filesystem.md → integrations/file-storage/archil.md} +3 -3
  114. package/.docs/{reference/workspace/azure-blob-filesystem.md → integrations/file-storage/azure-blob.md} +2 -2
  115. package/.docs/{reference/workspace/gcs-filesystem.md → integrations/file-storage/google-cloud-storage.md} +5 -5
  116. package/.docs/{reference/workspace/mesa-filesystem.md → integrations/file-storage/mesa.md} +2 -2
  117. package/.docs/{reference/workspace/files-sdk-filesystem.md → integrations/file-storage/vercel-files.md} +5 -5
  118. package/.docs/{guides/getting-started → integrations/frameworks}/astro.md +1 -1
  119. package/.docs/{guides/getting-started → integrations/frameworks}/electron.md +3 -3
  120. package/.docs/{guides/getting-started → integrations/frameworks}/next-js.md +2 -2
  121. package/.docs/{guides/getting-started → integrations/frameworks}/nuxt.md +1 -1
  122. package/.docs/{guides/getting-started → integrations/frameworks}/sveltekit.md +1 -1
  123. package/.docs/{guides/getting-started → integrations/frameworks}/vite-react.md +1 -1
  124. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/arize.md +1 -1
  125. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/arthur.md +1 -1
  126. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/braintrust.md +1 -1
  127. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/confident-ai.md +1 -1
  128. package/.docs/integrations/observability/datadog.md +538 -0
  129. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/laminar.md +1 -1
  130. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/langfuse.md +1 -1
  131. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/langsmith.md +1 -1
  132. package/.docs/{docs/observability/integrations/exporters/otel.md → integrations/observability/opentelemetry.md} +278 -46
  133. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/posthog.md +1 -1
  134. package/.docs/{docs/observability/integrations/exporters → integrations/observability}/sentry.md +1 -1
  135. package/.docs/{reference/workspace/apple-container-sandbox.md → integrations/sandboxes/apple-container.md} +1 -1
  136. package/.docs/{reference/workspace/daytona-sandbox.md → integrations/sandboxes/daytona.md} +23 -2
  137. package/.docs/{reference/workspace/docker-sandbox.md → integrations/sandboxes/docker.md} +1 -1
  138. package/.docs/{reference/workspace/e2b-sandbox.md → integrations/sandboxes/e2b.md} +3 -3
  139. package/.docs/{reference/workspace/modal-sandbox.md → integrations/sandboxes/modal.md} +2 -2
  140. package/.docs/{reference/workspace/railway-sandbox.md → integrations/sandboxes/railway.md} +8 -0
  141. package/.docs/{reference/workspace/vercel-sandbox.md → integrations/sandboxes/vercel.md} +141 -12
  142. package/.docs/{reference → integrations}/tools/brightdata.md +1 -1
  143. package/.docs/{reference → integrations}/tools/perplexity.md +1 -1
  144. package/.docs/{reference → integrations}/tools/tavily.md +1 -1
  145. package/.docs/{reference → integrations}/voice/aws-nova-sonic.md +1 -1
  146. package/.docs/{reference → integrations}/voice/cloudflare.md +3 -3
  147. package/.docs/{reference/voice/google-gemini-live.md → integrations/voice/google.md} +305 -30
  148. package/.docs/{reference/voice/inworld-realtime.md → integrations/voice/inworld.md} +163 -25
  149. package/.docs/{reference → integrations}/voice/livekit.md +437 -34
  150. package/.docs/{reference/voice/openai-realtime.md → integrations/voice/openai.md} +117 -20
  151. package/.docs/integrations.md +147 -0
  152. package/.docs/models/embeddings.md +3 -3
  153. package/.docs/models/environment-variables.md +1 -0
  154. package/.docs/models/gateways/custom-gateways.md +4 -0
  155. package/.docs/models/gateways/neon.md +1 -1
  156. package/.docs/models/gateways/netlify.md +1 -1
  157. package/.docs/models/gateways/openrouter.md +9 -3
  158. package/.docs/models/gateways/vercel.md +7 -4
  159. package/.docs/models/index.md +3 -3
  160. package/.docs/models/providers/302ai.md +1 -1
  161. package/.docs/models/providers/abacus.md +1 -1
  162. package/.docs/models/providers/abliteration-ai.md +1 -1
  163. package/.docs/models/providers/agentrouter.md +1 -1
  164. package/.docs/models/providers/ai-router.md +1 -1
  165. package/.docs/models/providers/aiand.md +1 -1
  166. package/.docs/models/providers/aki-io.md +1 -1
  167. package/.docs/models/providers/alibaba-cn.md +1 -1
  168. package/.docs/models/providers/alibaba-coding-plan-cn.md +1 -1
  169. package/.docs/models/providers/alibaba-coding-plan.md +1 -1
  170. package/.docs/models/providers/alibaba-token-plan-cn.md +1 -1
  171. package/.docs/models/providers/alibaba-token-plan.md +1 -1
  172. package/.docs/models/providers/alibaba.md +7 -5
  173. package/.docs/models/providers/ambient.md +2 -2
  174. package/.docs/models/providers/anyapi.md +1 -1
  175. package/.docs/models/providers/atomic-chat.md +1 -1
  176. package/.docs/models/providers/auriko.md +1 -1
  177. package/.docs/models/providers/bailing.md +1 -1
  178. package/.docs/models/providers/baseten.md +2 -2
  179. package/.docs/models/providers/berget.md +1 -1
  180. package/.docs/models/providers/blueclaw.md +1 -1
  181. package/.docs/models/providers/chutes.md +1 -1
  182. package/.docs/models/providers/clarifai.md +1 -1
  183. package/.docs/models/providers/claudinio.md +1 -1
  184. package/.docs/models/providers/cline-pass.md +1 -1
  185. package/.docs/models/providers/cloudferro-sherlock.md +1 -1
  186. package/.docs/models/providers/cloudflare-workers-ai.md +1 -1
  187. package/.docs/models/providers/coralbricks.md +75 -0
  188. package/.docs/models/providers/cortecs.md +3 -5
  189. package/.docs/models/providers/crof.md +1 -1
  190. package/.docs/models/providers/crossmodel.md +2 -3
  191. package/.docs/models/providers/daoxe.md +1 -1
  192. package/.docs/models/providers/databricks.md +1 -1
  193. package/.docs/models/providers/deepinfra.md +6 -5
  194. package/.docs/models/providers/digitalocean.md +5 -5
  195. package/.docs/models/providers/dinference.md +1 -1
  196. package/.docs/models/providers/drun.md +1 -1
  197. package/.docs/models/providers/ebcloud.md +1 -1
  198. package/.docs/models/providers/empiriolabs.md +3 -2
  199. package/.docs/models/providers/evroc.md +3 -4
  200. package/.docs/models/providers/fastrouter.md +1 -1
  201. package/.docs/models/providers/firepass.md +1 -1
  202. package/.docs/models/providers/fireworks-ai.md +1 -1
  203. package/.docs/models/providers/firmware.md +1 -1
  204. package/.docs/models/providers/freemodel.md +1 -1
  205. package/.docs/models/providers/friendli.md +1 -1
  206. package/.docs/models/providers/frogbot.md +1 -1
  207. package/.docs/models/providers/github-models.md +1 -1
  208. package/.docs/models/providers/gmicloud.md +1 -1
  209. package/.docs/models/providers/google.md +1 -1
  210. package/.docs/models/providers/greenpt.md +1 -1
  211. package/.docs/models/providers/helicone.md +1 -1
  212. package/.docs/models/providers/hetzner.md +8 -5
  213. package/.docs/models/providers/hpc-ai.md +1 -1
  214. package/.docs/models/providers/huggingface.md +1 -1
  215. package/.docs/models/providers/hyper.md +7 -7
  216. package/.docs/models/providers/iflowcn.md +1 -1
  217. package/.docs/models/providers/impossibl.md +1 -1
  218. package/.docs/models/providers/inception.md +1 -1
  219. package/.docs/models/providers/inceptron.md +1 -1
  220. package/.docs/models/providers/inference.md +1 -1
  221. package/.docs/models/providers/inferx.md +1 -1
  222. package/.docs/models/providers/infomaniak.md +1 -1
  223. package/.docs/models/providers/io-intelligence.md +1 -1
  224. package/.docs/models/providers/io-net.md +1 -1
  225. package/.docs/models/providers/jiekou.md +1 -1
  226. package/.docs/models/providers/kenari.md +1 -1
  227. package/.docs/models/providers/kilo.md +16 -11
  228. package/.docs/models/providers/kimi-for-coding.md +1 -1
  229. package/.docs/models/providers/kiro.md +1 -1
  230. package/.docs/models/providers/kuae-cloud-coding-plan.md +1 -1
  231. package/.docs/models/providers/lilac.md +1 -1
  232. package/.docs/models/providers/llama.md +1 -1
  233. package/.docs/models/providers/llmgateway.md +2 -7
  234. package/.docs/models/providers/llmtr.md +1 -1
  235. package/.docs/models/providers/lmstudio.md +1 -1
  236. package/.docs/models/providers/longcat.md +1 -1
  237. package/.docs/models/providers/lucidquery.md +1 -1
  238. package/.docs/models/providers/lynkr.md +1 -1
  239. package/.docs/models/providers/meganova.md +1 -1
  240. package/.docs/models/providers/meta.md +1 -1
  241. package/.docs/models/providers/minimax-cn-coding-plan.md +1 -1
  242. package/.docs/models/providers/minimax-cn.md +1 -1
  243. package/.docs/models/providers/minimax-coding-plan.md +1 -1
  244. package/.docs/models/providers/minimax.md +1 -1
  245. package/.docs/models/providers/mixlayer.md +1 -1
  246. package/.docs/models/providers/moark.md +1 -1
  247. package/.docs/models/providers/modal.md +1 -1
  248. package/.docs/models/providers/model-oracle-ai.md +1 -1
  249. package/.docs/models/providers/modelis.md +1 -1
  250. package/.docs/models/providers/modelscope.md +1 -1
  251. package/.docs/models/providers/moonshotai-cn.md +1 -1
  252. package/.docs/models/providers/moonshotai.md +1 -1
  253. package/.docs/models/providers/morph.md +1 -1
  254. package/.docs/models/providers/nano-gpt.md +8 -4
  255. package/.docs/models/providers/nearai.md +1 -1
  256. package/.docs/models/providers/nebius.md +3 -2
  257. package/.docs/models/providers/neuralwatt.md +1 -1
  258. package/.docs/models/providers/nova.md +1 -1
  259. package/.docs/models/providers/novita-ai.md +1 -1
  260. package/.docs/models/providers/nvidia.md +3 -2
  261. package/.docs/models/providers/ofox.md +4 -3
  262. package/.docs/models/providers/ollama-cloud.md +1 -1
  263. package/.docs/models/providers/opencode-go.md +1 -1
  264. package/.docs/models/providers/opencode.md +65 -64
  265. package/.docs/models/providers/orcarouter.md +1 -1
  266. package/.docs/models/providers/ovhcloud.md +1 -1
  267. package/.docs/models/providers/perplexity-agent.md +1 -1
  268. package/.docs/models/providers/pioneer.md +1 -1
  269. package/.docs/models/providers/poe.md +1 -1
  270. package/.docs/models/providers/poolside.md +1 -1
  271. package/.docs/models/providers/privatemode-ai.md +12 -10
  272. package/.docs/models/providers/qihang-ai.md +1 -1
  273. package/.docs/models/providers/qiniu-ai.md +1 -1
  274. package/.docs/models/providers/regolo-ai.md +26 -21
  275. package/.docs/models/providers/requesty.md +3 -3
  276. package/.docs/models/providers/routing-run.md +1 -1
  277. package/.docs/models/providers/sakana.md +1 -1
  278. package/.docs/models/providers/sarvam.md +1 -1
  279. package/.docs/models/providers/scaleway.md +1 -1
  280. package/.docs/models/providers/scx.md +1 -1
  281. package/.docs/models/providers/siliconflow-cn.md +1 -1
  282. package/.docs/models/providers/siliconflow.md +1 -1
  283. package/.docs/models/providers/snowflake-cortex.md +6 -2
  284. package/.docs/models/providers/stackit.md +1 -1
  285. package/.docs/models/providers/stepfun-ai-step-plan.md +1 -1
  286. package/.docs/models/providers/stepfun-ai.md +1 -1
  287. package/.docs/models/providers/stepfun-step-plan.md +1 -1
  288. package/.docs/models/providers/stepfun.md +1 -1
  289. package/.docs/models/providers/subconscious.md +1 -1
  290. package/.docs/models/providers/submodel.md +1 -1
  291. package/.docs/models/providers/synthetic.md +1 -1
  292. package/.docs/models/providers/tencent-coding-plan.md +1 -1
  293. package/.docs/models/providers/tencent-token-plan.md +1 -1
  294. package/.docs/models/providers/tencent-tokenhub.md +1 -1
  295. package/.docs/models/providers/tensorx.md +1 -1
  296. package/.docs/models/providers/the-grid-ai.md +1 -1
  297. package/.docs/models/providers/thinkingmachines.md +1 -1
  298. package/.docs/models/providers/tinfoil.md +2 -2
  299. package/.docs/models/providers/togetherai.md +1 -1
  300. package/.docs/models/providers/trustedrouter.md +1 -1
  301. package/.docs/models/providers/umans-ai-coding-plan.md +1 -1
  302. package/.docs/models/providers/umans-ai.md +1 -1
  303. package/.docs/models/providers/unorouter.md +1 -1
  304. package/.docs/models/providers/upstage.md +1 -1
  305. package/.docs/models/providers/venice.md +1 -1
  306. package/.docs/models/providers/vivgrid.md +1 -1
  307. package/.docs/models/providers/vultr.md +1 -1
  308. package/.docs/models/providers/wafer.ai.md +1 -1
  309. package/.docs/models/providers/wandb.md +3 -2
  310. package/.docs/models/providers/xiaomi-token-plan-ams.md +1 -1
  311. package/.docs/models/providers/xiaomi-token-plan-cn.md +1 -1
  312. package/.docs/models/providers/xiaomi-token-plan-sgp.md +1 -1
  313. package/.docs/models/providers/xiaomi.md +1 -1
  314. package/.docs/models/providers/xpersona.md +1 -1
  315. package/.docs/models/providers/zai-coding-plan.md +1 -1
  316. package/.docs/models/providers/zai.md +1 -1
  317. package/.docs/models/providers/zeldoc.md +8 -8
  318. package/.docs/models/providers/zenifra.md +1 -1
  319. package/.docs/models/providers/zenmux.md +1 -16
  320. package/.docs/models/providers/zhipuai-coding-plan.md +1 -1
  321. package/.docs/models/providers/zhipuai.md +1 -1
  322. package/.docs/models/providers.md +1 -0
  323. package/.docs/reference/agent-controller/agent-controller-class.md +35 -4
  324. package/.docs/reference/agent-controller/session.md +5 -3
  325. package/.docs/reference/agents/channels.md +2 -2
  326. package/.docs/reference/agents/durable-agent.md +2 -0
  327. package/.docs/reference/agents/generateLegacy.md +2 -2
  328. package/.docs/reference/agents/getDefaultOptions.md +1 -1
  329. package/.docs/reference/agents/getDefaultStreamOptions.md +1 -1
  330. package/.docs/reference/agents/inngest-agent.md +3 -1
  331. package/.docs/reference/agents/network.md +1 -1
  332. package/.docs/reference/ai-sdk/handle-network-stream.md +1 -1
  333. package/.docs/reference/ai-sdk/network-route.md +1 -1
  334. package/.docs/reference/auth/auth0.md +1 -1
  335. package/.docs/reference/auth/better-auth.md +1 -1
  336. package/.docs/reference/auth/clerk.md +1 -1
  337. package/.docs/reference/auth/firebase.md +1 -1
  338. package/.docs/reference/auth/google.md +1 -1
  339. package/.docs/reference/auth/okta.md +5 -1
  340. package/.docs/reference/auth/supabase.md +1 -1
  341. package/.docs/reference/auth/workos.md +1 -1
  342. package/.docs/reference/browser/agent-browser.md +2 -2
  343. package/.docs/reference/browser/browser-viewer.md +1 -1
  344. package/.docs/reference/browser/firecrawl-browser.md +1 -1
  345. package/.docs/reference/browser/mastra-browser.md +1 -1
  346. package/.docs/reference/browser/stagehand-browser.md +2 -2
  347. package/.docs/reference/channels/channel-provider.md +1 -1
  348. package/.docs/reference/channels/slack-provider.md +2 -2
  349. package/.docs/reference/cli/mastra.md +6 -6
  350. package/.docs/reference/client-js/agents.md +2 -1
  351. package/.docs/reference/client-js/workflows.md +3 -3
  352. package/.docs/reference/code-sdk/mount-agent-controller.md +1 -1
  353. package/.docs/reference/configuration.md +21 -27
  354. package/.docs/reference/core/addDynamicWorkflow.md +2 -2
  355. package/.docs/reference/core/addDynamicWorkflows.md +2 -2
  356. package/.docs/reference/core/getStorage.md +1 -1
  357. package/.docs/reference/core/getVector.md +2 -2
  358. package/.docs/reference/core/listVectors.md +2 -2
  359. package/.docs/reference/core/setStorage.md +1 -1
  360. package/.docs/reference/datasets/startExperiment.md +8 -0
  361. package/.docs/reference/file-based-agents/config.md +2 -0
  362. package/.docs/reference/file-based-agents/instructions.md +2 -0
  363. package/.docs/reference/file-based-agents/logger.md +2 -0
  364. package/.docs/reference/file-based-agents/memory.md +2 -0
  365. package/.docs/reference/file-based-agents/observability.md +2 -0
  366. package/.docs/reference/file-based-agents/processors.md +2 -0
  367. package/.docs/reference/file-based-agents/schedules.md +2 -0
  368. package/.docs/reference/file-based-agents/scorers.md +2 -0
  369. package/.docs/reference/file-based-agents/server.md +2 -0
  370. package/.docs/reference/file-based-agents/skills.md +2 -0
  371. package/.docs/reference/file-based-agents/storage.md +3 -1
  372. package/.docs/reference/file-based-agents/studio.md +3 -1
  373. package/.docs/reference/file-based-agents/subagents.md +2 -0
  374. package/.docs/reference/file-based-agents/tools.md +2 -0
  375. package/.docs/reference/file-based-agents/workflows.md +2 -0
  376. package/.docs/reference/file-based-agents/workspace.md +2 -0
  377. package/.docs/reference/index.md +29 -54
  378. package/.docs/{guides/getting-started → reference}/manual-install.md +2 -2
  379. package/.docs/{guides → reference}/migrations/ai-sdk-v4-to-v5.md +1 -1
  380. package/.docs/{guides → reference}/migrations/mastra-cloud.md +2 -2
  381. package/.docs/{guides → reference}/migrations/upgrade-to-v1/cli.md +1 -1
  382. package/.docs/{guides → reference}/migrations/upgrade-to-v1/memory.md +1 -1
  383. package/.docs/{guides → reference}/migrations/upgrade-to-v1/overview.md +41 -41
  384. package/.docs/{guides → reference}/migrations/upgrade-to-v1/tools.md +1 -1
  385. package/.docs/{guides → reference}/migrations/upgrade-to-v1/tracing.md +10 -10
  386. package/.docs/reference/observability/tracing/bridges/datadog.md +2 -2
  387. package/.docs/reference/observability/tracing/bridges/otel.md +2 -2
  388. package/.docs/reference/observability/tracing/exporters/arize.md +1 -1
  389. package/.docs/reference/observability/tracing/exporters/arthur.md +1 -1
  390. package/.docs/reference/observability/tracing/exporters/confident-ai.md +1 -1
  391. package/.docs/reference/observability/tracing/exporters/datadog.md +1 -1
  392. package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md +12 -0
  393. package/.docs/reference/observability/tracing/exporters/otel.md +2 -2
  394. package/.docs/reference/processors/pii-detector.md +2 -0
  395. package/.docs/reference/processors/prompt-injection-detector.md +2 -0
  396. package/.docs/reference/processors/regex-filter-processor.md +20 -0
  397. package/.docs/reference/processors/response-cache.md +2 -0
  398. package/.docs/reference/processors/tool-search-processor.md +33 -1
  399. package/.docs/reference/pubsub/lease-provider.md +1 -1
  400. package/.docs/{guides → reference}/rag/chunking-and-embedding.md +16 -19
  401. package/.docs/reference/rag/database-config.md +1 -1
  402. package/.docs/{guides/rag/graph-rag.md → reference/rag/graph-rag-guide.md} +1 -1
  403. package/.docs/reference/rag/metadata-filters.md +13 -4
  404. package/.docs/{guides → reference}/rag/overview.md +2 -2
  405. package/.docs/{guides → reference}/rag/retrieval.md +18 -1
  406. package/.docs/{guides → reference}/rag/vector-databases.md +42 -1
  407. package/.docs/reference/schedules/overview.md +2 -0
  408. package/.docs/reference/server/create-route.md +27 -1
  409. package/.docs/reference/server/register-api-route.md +2 -0
  410. package/.docs/reference/signals/create-notification-inbox-tool.md +2 -0
  411. package/.docs/reference/signals/signal-provider.md +2 -0
  412. package/.docs/reference/signals/task-signal-provider.md +2 -0
  413. package/.docs/reference/signals/webhook-signal-provider.md +2 -0
  414. package/.docs/reference/storage/composite.md +4 -4
  415. package/.docs/reference/storage/retention.md +4 -4
  416. package/.docs/reference/streaming/ChunkType.md +3 -3
  417. package/.docs/reference/streaming/agents/stream.md +1 -1
  418. package/.docs/reference/streaming/agents/streamLegacy.md +3 -3
  419. package/.docs/reference/streaming/agents/streamUntilIdle.md +1 -1
  420. package/.docs/reference/tools/create-code-mode.md +3 -1
  421. package/.docs/reference/tools/isolated-vm-transport.md +1 -1
  422. package/.docs/reference/tools/mcp-client.md +51 -0
  423. package/.docs/reference/tools/mcp-server.md +1 -1
  424. package/.docs/reference/tools/quickjs-transport.md +92 -0
  425. package/.docs/reference/vectors/chroma.md +1 -1
  426. package/.docs/reference/vectors/convex.md +2 -2
  427. package/.docs/reference/vectors/oracledb.md +347 -0
  428. package/.docs/reference/workers/overview.md +10 -8
  429. package/.docs/reference/workflows/dynamic-workflow-definition.md +3 -1
  430. package/.docs/reference/workflows/run-methods/timeTravel.md +1 -0
  431. package/.docs/reference/workflows/workflow.md +18 -0
  432. package/.docs/reference/workspace/local-sandbox.md +1 -1
  433. package/.docs/reference/workspace/platform-filesystem.md +3 -3
  434. package/.docs/reference/workspace/platform-sandbox.md +11 -3
  435. package/.docs/reference/workspace/process-manager.md +3 -3
  436. package/.docs/reference/workspace/sandbox.md +10 -0
  437. package/CHANGELOG.md +90 -0
  438. package/dist/index.js +1 -1
  439. package/dist/{src-BZcgzbk9.js → src-D-W-bx5t.js} +2 -2
  440. package/dist/{src-BZcgzbk9.js.map → src-D-W-bx5t.js.map} +1 -1
  441. package/dist/stdio.js +1 -1
  442. package/package.json +6 -6
  443. package/.docs/docs/capabilities/channels/other-adapters.md +0 -68
  444. package/.docs/docs/observability/integrations/bridges/datadog.md +0 -219
  445. package/.docs/docs/observability/integrations/bridges/otel.md +0 -234
  446. package/.docs/docs/observability/integrations/exporters/datadog.md +0 -321
  447. package/.docs/guides/build-your-ui/copilotkit/channels.md +0 -86
  448. package/.docs/guides/build-your-ui/copilotkit/generative-ui.md +0 -174
  449. package/.docs/guides/guide/chef-michel.md +0 -211
  450. package/.docs/guides/guide/publishing-mcp-server.md +0 -137
  451. package/.docs/guides/guide/slack-assistant.md +0 -193
  452. package/.docs/guides/guide/stock-agent.md +0 -132
  453. package/.docs/guides/guide/web-search.md +0 -322
  454. package/.docs/guides/guide/whatsapp-chat-bot.md +0 -407
  455. package/.docs/guides/voice/realtime-voice.md +0 -430
  456. package/.docs/reference/voice/google.md +0 -290
  457. package/.docs/reference/voice/inworld.md +0 -137
  458. package/.docs/reference/voice/openai.md +0 -96
  459. package/.docs/reference/voice/playai.md +0 -82
  460. package/.docs/reference/workspace/vercel-serverless.md +0 -128
  461. /package/.docs/{guides/concepts → docs/guides}/multi-agent-systems.md +0 -0
  462. /package/.docs/{guides/concepts → docs/guides}/streaming.md +0 -0
  463. /package/.docs/{guides/build-your-ui → integrations/agentic-ui}/openui.md +0 -0
  464. /package/.docs/{docs/server → integrations}/auth/better-auth.md +0 -0
  465. /package/.docs/{docs/server → integrations}/auth/google.md +0 -0
  466. /package/.docs/{guides/deployment → integrations/deploy}/inngest.md +0 -0
  467. /package/.docs/{guides/deployment → integrations/deploy}/temporal.md +0 -0
  468. /package/.docs/{reference/workspace/agentfs-filesystem.md → integrations/file-storage/agentfs.md} +0 -0
  469. /package/.docs/{reference/workspace/google-drive-filesystem.md → integrations/file-storage/google-drive.md} +0 -0
  470. /package/.docs/{guides/getting-started → integrations/frameworks}/express.md +0 -0
  471. /package/.docs/{guides/getting-started → integrations/frameworks}/hono.md +0 -0
  472. /package/.docs/{guides/getting-started → integrations/frameworks}/nestjs.md +0 -0
  473. /package/.docs/{reference/workspace/agentcore-runtime-sandbox.md → integrations/sandboxes/agentcore.md} +0 -0
  474. /package/.docs/{reference/workspace/blaxel-sandbox.md → integrations/sandboxes/blaxel.md} +0 -0
  475. /package/.docs/{guides/guide → integrations/tools}/firecrawl.md +0 -0
  476. /package/.docs/{reference → integrations}/voice/azure.md +0 -0
  477. /package/.docs/{reference → integrations}/voice/deepgram.md +0 -0
  478. /package/.docs/{reference → integrations}/voice/elevenlabs.md +0 -0
  479. /package/.docs/{reference → integrations}/voice/mistral.md +0 -0
  480. /package/.docs/{reference → integrations}/voice/murf.md +0 -0
  481. /package/.docs/{reference → integrations}/voice/sarvam.md +0 -0
  482. /package/.docs/{reference → integrations}/voice/speechify.md +0 -0
  483. /package/.docs/{reference/voice/xai-realtime.md → integrations/voice/xai.md} +0 -0
  484. /package/.docs/{guides → reference}/migrations/agentnetwork.md +0 -0
  485. /package/.docs/{guides → reference}/migrations/network-to-supervisor.md +0 -0
  486. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/agent.md +0 -0
  487. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/client.md +0 -0
  488. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/deployment.md +0 -0
  489. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/evals.md +0 -0
  490. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/mastra.md +0 -0
  491. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/mcp.md +0 -0
  492. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/processors.md +0 -0
  493. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/rag.md +0 -0
  494. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/storage.md +0 -0
  495. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/vectors.md +0 -0
  496. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/voice.md +0 -0
  497. /package/.docs/{guides → reference}/migrations/upgrade-to-v1/workflows.md +0 -0
  498. /package/.docs/{guides → reference}/migrations/vnext-to-standard-apis.md +0 -0
@@ -4,7 +4,7 @@
4
4
 
5
5
  Mastra runs as an HTTP server that exposes your agents, workflows, and other functionality as API endpoints. The server handles request routing, middleware execution, authentication, and streaming responses.
6
6
 
7
- > **Info:** This page covers the [`server`](https://mastra.ai/reference/configuration) configuration options passed to the `Mastra` constructor. For running Mastra with your own HTTP server (Hono, Express, etc.), visit [Server Adapters](https://mastra.ai/docs/server/server-adapters).
7
+ > **Note:** This page covers the [`server`](https://mastra.ai/reference/configuration) configuration options passed to the `Mastra` constructor. For running Mastra with your own HTTP server (Hono, Express, etc.), visit [Server Adapters](https://mastra.ai/docs/server/server-adapters).
8
8
 
9
9
  ## Server features
10
10
 
@@ -190,18 +190,20 @@ You can also route `observability` to a dedicated analytics backend. See the [ob
190
190
 
191
191
  Each provider page includes installation instructions, configuration parameters, and usage examples:
192
192
 
193
- - [libSQL](https://mastra.ai/reference/storage/libsql)
194
- - [PostgreSQL](https://mastra.ai/reference/storage/postgresql)
195
- - [MongoDB](https://mastra.ai/reference/storage/mongodb)
196
- - [Upstash](https://mastra.ai/reference/storage/upstash)
197
- - [Redis](https://mastra.ai/reference/storage/redis)
198
- - [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
199
- - [Cloudflare KV & Durable Objects](https://mastra.ai/reference/storage/cloudflare)
200
- - [Convex](https://mastra.ai/reference/storage/convex)
201
- - [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
202
- - [LanceDB](https://mastra.ai/reference/storage/lance)
203
- - [Microsoft SQL Server](https://mastra.ai/reference/storage/mssql)
204
- - [Google Cloud Spanner](https://mastra.ai/reference/storage/spanner)
193
+ - [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
194
+ - [Cloudflare KV & Durable Objects](https://mastra.ai/integrations/databases/cloudflare-kv)
195
+ - [Convex](https://mastra.ai/integrations/databases/convex)
196
+ - [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
197
+ - [Google Cloud Spanner](https://mastra.ai/integrations/databases/spanner)
198
+ - [LanceDB](https://mastra.ai/integrations/databases/lancedb)
199
+ - [libSQL](https://mastra.ai/integrations/databases/libsql)
200
+ - [Microsoft SQL Server](https://mastra.ai/integrations/databases/mssql)
201
+ - [MongoDB](https://mastra.ai/integrations/databases/mongodb)
202
+ - [Neon Postgres](https://mastra.ai/integrations/databases/neon)
203
+ - [OracleDB](https://mastra.ai/integrations/databases/oracledb)
204
+ - [PostgreSQL](https://mastra.ai/integrations/databases/postgresql)
205
+ - [Redis](https://mastra.ai/integrations/databases/redis)
206
+ - [Upstash](https://mastra.ai/integrations/databases/upstash)
205
207
 
206
208
  > **Tip:** libSQL is the fastest path for local development because it doesn't require running a separate database server.
207
209
 
@@ -12,7 +12,7 @@ All require an observability storage backend to be configured.
12
12
 
13
13
  ## Quickstart
14
14
 
15
- For detailed instructions, follow the [observability instructions](https://mastra.ai/docs/observability/overview). To get up and running quickly, add the `@mastra/observability` package to your project and configure it with [LibSQL](https://mastra.ai/reference/storage/libsql) and [DuckDB](https://mastra.ai/reference/vectors/duckdb) for a local development setup that supports both traces and metrics.
15
+ For detailed instructions, follow the [observability instructions](https://mastra.ai/docs/observability/overview). To get up and running quickly, add the `@mastra/observability` package to your project and configure it with [LibSQL](https://mastra.ai/integrations/databases/libsql) and [DuckDB](https://mastra.ai/reference/vectors/duckdb) for a local development setup that supports both traces and metrics.
16
16
 
17
17
  **npm**:
18
18
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Dynamic workflows
4
4
 
5
- > **Beta:** This feature is in beta. Breaking changes may occur without a major version bump until the API is stable.
5
+ > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
6
6
 
7
7
  Dynamic workflows are workflow definitions expressed as data instead of code. A definition is a JSON document that describes the workflow's schemas and step graph. Mastra validates the definition and registers it as a runnable workflow, then persists it in storage so it survives process restarts.
8
8
 
@@ -287,7 +287,7 @@ You can run workflows from agents, tools, the Mastra Client, or the command line
287
287
  const testWorkflow = mastra.getWorkflow('testWorkflow')
288
288
  ```
289
289
 
290
- > **Info:** `mastra.getWorkflow()` is preferred over a direct import for two reasons:
290
+ > **Note:** `mastra.getWorkflow()` is preferred over a direct import for two reasons:
291
291
  >
292
292
  > 1. It provides access to the Mastra instance configuration (logger, telemetry, storage, registered agents, and vector stores)
293
293
  > 2. It provides full TypeScript type inference for workflow input and output schemas
@@ -407,7 +407,7 @@ Here's an example of a successful workflow result, showing the `input`, `steps`,
407
407
 
408
408
  ## Streaming
409
409
 
410
- For generic `writer` API usage, see [Streaming](https://mastra.ai/guides/concepts/streaming).
410
+ For generic `writer` API usage, see [Streaming](https://mastra.ai/docs/guides/streaming).
411
411
 
412
412
  ### Inspecting workflow stream payloads
413
413
 
@@ -81,13 +81,14 @@ Each snapshot includes the `runId`, input, step status (`success`, `suspended`,
81
81
 
82
82
  ## How snapshots are saved and retrieved
83
83
 
84
- Snapshots are saved to the configured storage system. By default, they use libSQL, but you can configure Upstash or PostgreSQL instead. Each snapshot is saved in the `workflow_snapshots` table and identified by the workflow's `runId`.
84
+ Snapshots are saved to the configured storage system. By default, they use libSQL, but you can configure Upstash, PostgreSQL, or OracleDB instead. Each snapshot is saved in the `workflow_snapshots` table and identified by the workflow's `runId`.
85
85
 
86
86
  Read more about:
87
87
 
88
- - [libSQL Storage](https://mastra.ai/reference/storage/libsql)
89
- - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
90
- - [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
88
+ - [libSQL Storage](https://mastra.ai/integrations/databases/libsql)
89
+ - [Upstash Storage](https://mastra.ai/integrations/databases/upstash)
90
+ - [PostgreSQL Storage](https://mastra.ai/integrations/databases/postgresql)
91
+ - [OracleDB Storage](https://mastra.ai/integrations/databases/oracledb)
91
92
 
92
93
  ### Saving snapshots
93
94
 
@@ -139,12 +140,13 @@ export const mastra = new Mastra({
139
140
  })
140
141
  ```
141
142
 
142
- - [libSQL Storage](https://mastra.ai/reference/storage/libsql)
143
- - [PostgreSQL Storage](https://mastra.ai/reference/storage/postgresql)
144
- - [MongoDB Storage](https://mastra.ai/reference/storage/mongodb)
145
- - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
146
- - [Cloudflare D1](https://mastra.ai/reference/storage/cloudflare-d1)
147
- - [DynamoDB](https://mastra.ai/reference/storage/dynamodb)
143
+ - [libSQL Storage](https://mastra.ai/integrations/databases/libsql)
144
+ - [PostgreSQL Storage](https://mastra.ai/integrations/databases/postgresql)
145
+ - [OracleDB Storage](https://mastra.ai/integrations/databases/oracledb)
146
+ - [MongoDB Storage](https://mastra.ai/integrations/databases/mongodb)
147
+ - [Upstash Storage](https://mastra.ai/integrations/databases/upstash)
148
+ - [Cloudflare D1](https://mastra.ai/integrations/databases/cloudflare-d1)
149
+ - [DynamoDB](https://mastra.ai/integrations/databases/dynamodb)
148
150
  - [More storage providers](https://mastra.ai/docs/storage/overview)
149
151
 
150
152
  ## Best practices
@@ -15,6 +15,8 @@ When you call `timeTravel()` on a workflow run:
15
15
  3. Execution begins from the specified step with the provided or reconstructed input data
16
16
  4. The workflow continues to completion from that point forward
17
17
 
18
+ If the workflow definition has changed since the run was recorded (for example, a step was renamed), or the recorded run never reached a step that precedes the target, time travel fails with a descriptive error before anything executes, and the stored snapshot is left unchanged.
19
+
18
20
  Time travel requires storage to be configured since it relies on persisted workflow snapshots.
19
21
 
20
22
  ## Basic usage
@@ -21,15 +21,15 @@ A filesystem provider handles all file operations for a workspace:
21
21
  Available providers:
22
22
 
23
23
  - [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem): Stores files in a directory on disk
24
- - [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO, Tigris)
25
- - [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem): Stores files in Google Cloud Storage
24
+ - [`S3Filesystem`](https://mastra.ai/integrations/file-storage/amazon-s3): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO, Tigris)
25
+ - [`GCSFilesystem`](https://mastra.ai/integrations/file-storage/google-cloud-storage): Stores files in Google Cloud Storage
26
26
  - [`PlatformFilesystem`](https://mastra.ai/reference/workspace/platform-filesystem): Stores files in a Mastra Platform workspace bucket
27
- - [`GoogleDriveFilesystem`](https://mastra.ai/reference/workspace/google-drive-filesystem): Stores files inside a Google Drive folder
28
- - [`AzureBlobFilesystem`](https://mastra.ai/reference/workspace/azure-blob-filesystem): Stores files in Azure Blob Storage
29
- - [`FilesSDKFilesystem`](https://mastra.ai/reference/workspace/files-sdk-filesystem): Stores files in any [FilesSDK](https://files-sdk.dev) adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more): useful when you want one provider that can target multiple backends
30
- - [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem): Stores files in a Turso/SQLite database via AgentFS
31
- - [`MesaFilesystem`](https://mastra.ai/reference/workspace/mesa-filesystem): Stores files in versioned Mesa repos
32
- - [`ArchilFilesystem`](https://mastra.ai/reference/workspace/archil-filesystem): Stores files on Archil elastic, serverless disks
27
+ - [`GoogleDriveFilesystem`](https://mastra.ai/integrations/file-storage/google-drive): Stores files inside a Google Drive folder
28
+ - [`AzureBlobFilesystem`](https://mastra.ai/integrations/file-storage/azure-blob): Stores files in Azure Blob Storage
29
+ - [`FilesSDKFilesystem`](https://mastra.ai/integrations/file-storage/vercel-files): Stores files in any [FilesSDK](https://files-sdk.dev) adapter (S3, R2, GCS, Azure Blob, Vercel Blob, local filesystem, and more): useful when you want one provider that can target multiple backends
30
+ - [`AgentFSFilesystem`](https://mastra.ai/integrations/file-storage/agentfs): Stores files in a Turso/SQLite database via AgentFS
31
+ - [`MesaFilesystem`](https://mastra.ai/integrations/file-storage/mesa): Stores files in versioned Mesa repos
32
+ - [`ArchilFilesystem`](https://mastra.ai/integrations/file-storage/archil): Stores files on Archil elastic, serverless disks
33
33
 
34
34
  > **Tip:** `LocalFilesystem` is the simplest way to get started as it requires no external services. For cloud storage, use `S3Filesystem`, `GCSFilesystem`, or `AzureBlobFilesystem`. For versioned storage, use `MesaFilesystem`. For database-backed storage without external services, use `AgentFSFilesystem`.
35
35
 
@@ -227,12 +227,12 @@ When you configure a filesystem on a workspace, agents receive tools for reading
227
227
  ## Related
228
228
 
229
229
  - [LocalFilesystem reference](https://mastra.ai/reference/workspace/local-filesystem)
230
- - [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
231
- - [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
232
- - [GoogleDriveFilesystem reference](https://mastra.ai/reference/workspace/google-drive-filesystem)
233
- - [AzureBlobFilesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
234
- - [FilesSDKFilesystem reference](https://mastra.ai/reference/workspace/files-sdk-filesystem)
235
- - [AgentFSFilesystem reference](https://mastra.ai/reference/workspace/agentfs-filesystem)
236
- - [MesaFilesystem reference](https://mastra.ai/reference/workspace/mesa-filesystem)
230
+ - [S3Filesystem reference](https://mastra.ai/integrations/file-storage/amazon-s3)
231
+ - [GCSFilesystem reference](https://mastra.ai/integrations/file-storage/google-cloud-storage)
232
+ - [GoogleDriveFilesystem reference](https://mastra.ai/integrations/file-storage/google-drive)
233
+ - [AzureBlobFilesystem reference](https://mastra.ai/integrations/file-storage/azure-blob)
234
+ - [FilesSDKFilesystem reference](https://mastra.ai/integrations/file-storage/vercel-files)
235
+ - [AgentFSFilesystem reference](https://mastra.ai/integrations/file-storage/agentfs)
236
+ - [MesaFilesystem reference](https://mastra.ai/integrations/file-storage/mesa)
237
237
  - [Workspace overview](https://mastra.ai/docs/workspace/overview)
238
238
  - [Sandbox](https://mastra.ai/docs/workspace/sandbox)
@@ -20,17 +20,17 @@ A sandbox provider executes commands in a controlled environment:
20
20
  ## Supported providers
21
21
 
22
22
  - [`LocalSandbox`](https://mastra.ai/reference/workspace/local-sandbox): Executes commands on the local machine
23
- - [`AgentCoreRuntimeSandbox`](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox): Executes commands in AWS Bedrock AgentCore Runtime sessions
24
- - [`AppleContainerSandbox`](https://mastra.ai/reference/workspace/apple-container-sandbox): Executes commands in local OCI Linux containers using Apple's `container` CLI
25
- - [`BlaxelSandbox`](https://mastra.ai/reference/workspace/blaxel-sandbox): Executes commands in isolated Blaxel cloud sandboxes
26
- - [`DaytonaSandbox`](https://mastra.ai/reference/workspace/daytona-sandbox): Executes commands in isolated Daytona cloud sandboxes
27
- - [`DockerSandbox`](https://mastra.ai/reference/workspace/docker-sandbox): Executes commands in long-lived Docker containers on the local machine
28
- - [`E2BSandbox`](https://mastra.ai/reference/workspace/e2b-sandbox): Executes commands in isolated E2B cloud sandboxes
29
- - [`ModalSandbox`](https://mastra.ai/reference/workspace/modal-sandbox): Executes commands in isolated Modal cloud sandboxes
23
+ - [`AgentCoreRuntimeSandbox`](https://mastra.ai/integrations/sandboxes/agentcore): Executes commands in AWS Bedrock AgentCore Runtime sessions
24
+ - [`AppleContainerSandbox`](https://mastra.ai/integrations/sandboxes/apple-container): Executes commands in local OCI Linux containers using Apple's `container` CLI
25
+ - [`BlaxelSandbox`](https://mastra.ai/integrations/sandboxes/blaxel): Executes commands in isolated Blaxel cloud sandboxes
26
+ - [`DaytonaSandbox`](https://mastra.ai/integrations/sandboxes/daytona): Executes commands in isolated Daytona cloud sandboxes
27
+ - [`DockerSandbox`](https://mastra.ai/integrations/sandboxes/docker): Executes commands in long-lived Docker containers on the local machine
28
+ - [`E2BSandbox`](https://mastra.ai/integrations/sandboxes/e2b): Executes commands in isolated E2B cloud sandboxes
29
+ - [`ModalSandbox`](https://mastra.ai/integrations/sandboxes/modal): Executes commands in isolated Modal cloud sandboxes
30
30
  - [`PlatformSandbox`](https://mastra.ai/reference/workspace/platform-sandbox): Executes commands in a sandbox tied to a Mastra Platform environment
31
- - [`RailwaySandbox`](https://mastra.ai/reference/workspace/railway-sandbox): Executes commands in ephemeral, isolated Railway cloud sandboxes
32
- - [`VercelSandbox`](https://mastra.ai/reference/workspace/vercel-sandbox): Executes commands in an ephemeral Vercel Sandbox Firecracker MicroVM
33
- - [`VercelServerlessSandbox`](https://mastra.ai/reference/workspace/vercel-serverless): Executes commands as stateless Vercel serverless functions
31
+ - [`RailwaySandbox`](https://mastra.ai/integrations/sandboxes/railway): Executes commands in ephemeral, isolated Railway cloud sandboxes
32
+ - [`VercelSandbox`](https://mastra.ai/integrations/sandboxes/vercel): Executes commands in an ephemeral Vercel Sandbox Firecracker MicroVM
33
+ - [`VercelServerlessSandbox`](https://mastra.ai/integrations/sandboxes/vercel): Executes commands as stateless Vercel serverless functions
34
34
 
35
35
  ## Basic usage
36
36
 
@@ -234,13 +234,13 @@ Use `null` or `false` for cloud sandboxes (for example, E2B, Daytona, or Modal)
234
234
  ## Related
235
235
 
236
236
  - [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/process-manager)
237
- - [`AgentCoreRuntimeSandbox` reference](https://mastra.ai/reference/workspace/agentcore-runtime-sandbox)
238
- - [`AppleContainerSandbox` reference](https://mastra.ai/reference/workspace/apple-container-sandbox)
239
- - [`DaytonaSandbox` reference](https://mastra.ai/reference/workspace/daytona-sandbox)
240
- - [`E2BSandbox` reference](https://mastra.ai/reference/workspace/e2b-sandbox)
237
+ - [`AgentCoreRuntimeSandbox` reference](https://mastra.ai/integrations/sandboxes/agentcore)
238
+ - [`AppleContainerSandbox` reference](https://mastra.ai/integrations/sandboxes/apple-container)
239
+ - [`DaytonaSandbox` reference](https://mastra.ai/integrations/sandboxes/daytona)
240
+ - [`E2BSandbox` reference](https://mastra.ai/integrations/sandboxes/e2b)
241
241
  - [`LocalSandbox` reference](https://mastra.ai/reference/workspace/local-sandbox)
242
- - [`ModalSandbox` reference](https://mastra.ai/reference/workspace/modal-sandbox)
243
- - [`VercelSandbox` reference](https://mastra.ai/reference/workspace/vercel-sandbox)
244
- - [`VercelServerlessSandbox` reference](https://mastra.ai/reference/workspace/vercel-serverless)
242
+ - [`ModalSandbox` reference](https://mastra.ai/integrations/sandboxes/modal)
243
+ - [`VercelSandbox` reference](https://mastra.ai/integrations/sandboxes/vercel)
244
+ - [`VercelServerlessSandbox` reference](https://mastra.ai/integrations/sandboxes/vercel)
245
245
  - [Workspace overview](https://mastra.ai/docs/workspace/overview)
246
246
  - [Filesystem](https://mastra.ai/docs/workspace/filesystem)
@@ -280,5 +280,5 @@ When you configure search on a workspace, agents receive tools for searching and
280
280
  ## Related
281
281
 
282
282
  - [Workspace overview](https://mastra.ai/docs/workspace/overview)
283
- - [RAG overview](https://mastra.ai/guides/rag/overview)
283
+ - [RAG overview](https://mastra.ai/reference/rag/overview)
284
284
  - [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)
@@ -4,7 +4,7 @@
4
4
 
5
5
  If you're already using the [Vercel AI SDK](https://sdk.vercel.ai) directly and want to add Mastra capabilities like [processors](https://mastra.ai/docs/agents/processors) or [memory](https://mastra.ai/docs/memory/memory-processors) without switching to the full Mastra agent API, [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) lets you wrap any AI SDK model with these features. This is useful when you want to keep your existing AI SDK code but add input/output processing, conversation persistence, or content filtering.
6
6
 
7
- > **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/guides/build-your-ui/ai-sdk-ui).
7
+ > **Tip:** If you want to use Mastra together with AI SDK UI (e.g. `useChat()`), visit the [AI SDK UI guide](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui).
8
8
 
9
9
  ## Installation
10
10
 
@@ -139,4 +139,4 @@ const { text } = await generateText({
139
139
  - [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra): API reference for `withMastra()`
140
140
  - [Processors](https://mastra.ai/docs/agents/processors): Learn about input and output processors
141
141
  - [Memory](https://mastra.ai/docs/memory/overview): Overview of Mastra's memory system
142
- - [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks
142
+ - [AI SDK UI](https://mastra.ai/integrations/agentic-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks
@@ -4,7 +4,9 @@
4
4
 
5
5
  Run [Mastra workers](https://mastra.ai/docs/deployment/workers) as separate processes so you can scale orchestration, scheduling, and background tasks independently from the API. This guide walks through a fully split deployment using Docker Compose or Kubernetes.
6
6
 
7
- > **Info:** This guide covers splitting workers into their own containers. If you only need workers to run in-process alongside the API, see [Workers](https://mastra.ai/docs/deployment/workers). No extra setup is required.
7
+ > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
8
+
9
+ > **Note:** This guide covers splitting workers into their own containers. If you only need workers to run in-process alongside the API, see [Workers](https://mastra.ai/docs/deployment/workers). No extra setup is required.
8
10
 
9
11
  ## Before you begin
10
12
 
@@ -573,4 +575,4 @@ Workers recover from crashes because the distributed PubSub backend persists una
573
575
  - [CLI reference](https://mastra.ai/reference/cli/mastra): `mastra worker build` and `mastra worker start`
574
576
  - [PubSub](https://mastra.ai/docs/server/pubsub): Event delivery backends
575
577
  - [Deploy a Mastra server](https://mastra.ai/docs/deployment/mastra-server): Build output and server configuration
576
- - [Deploy Mastra to Kubernetes](https://mastra.ai/guides/deployment/kubernetes): Multi-pod deployment with durable agents
578
+ - [Deploy Mastra to Kubernetes](https://mastra.ai/integrations/deploy/kubernetes): Multi-pod deployment with durable agents
@@ -2,11 +2,11 @@
2
2
 
3
3
  # Mastra Quickstart
4
4
 
5
- **For AI agents:** Create a new Mastra project non-interactively with `npm create mastra@latest <project-name> -- --llm <provider>`, replacing `<provider>` with `openai`, `anthropic`, `google`, or `xai`. For a minimal project without an agent or model provider, use `npm create mastra@latest <project-name> -- --empty`. To build a Mastra project from scratch, see the [manual installation guide](https://mastra.ai/guides/getting-started/manual-install).
5
+ **For AI agents:** Create a new Mastra project non-interactively with `npm create mastra@latest <project-name> -- --llm <provider>`, replacing `<provider>` with `openai`, `anthropic`, `google`, or `xai`. For a minimal project without an agent or model provider, use `npm create mastra@latest <project-name> -- --empty`. To build a Mastra project from scratch, see the [manual installation guide](https://mastra.ai/reference/manual-install).
6
6
 
7
7
  The `create-mastra` CLI is the quickest way to start a Mastra project. It creates an agent harness with workspace tools, memory, task tracking, web access, schedules, storage, and observability.
8
8
 
9
- For more control, see the [manual installation guide](https://mastra.ai/guides/getting-started/manual-install). To add Mastra to an existing project, use [`mastra init`](https://mastra.ai/reference/cli/mastra).
9
+ For more control, see the [manual installation guide](https://mastra.ai/reference/manual-install). To add Mastra to an existing project, use [`mastra init`](https://mastra.ai/reference/cli/mastra).
10
10
 
11
11
  > **📹 Watch:** Watch the [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
12
12
 
@@ -82,7 +82,7 @@ Open [Studio at localhost:4111](http://localhost:4111), select the agent, and se
82
82
 
83
83
  ## Next steps
84
84
 
85
- - Integrate Mastra with [Next.js](https://mastra.ai/guides/getting-started/next-js), [React](https://mastra.ai/guides/getting-started/vite-react), or [Astro](https://mastra.ai/guides/getting-started/astro)
85
+ - Integrate Mastra with [Next.js](https://mastra.ai/integrations/frameworks/next-js), [React](https://mastra.ai/integrations/frameworks/vite-react), or [Astro](https://mastra.ai/integrations/frameworks/astro)
86
86
  - Learn how to [build Mastra with AI](https://mastra.ai/reference/build-with-ai)
87
87
  - Build an agent from scratch with a [guide](https://mastra.ai/guides)
88
88
  - Watch the [Mastra YouTube channel](https://www.youtube.com/@mastra-ai)
@@ -6,7 +6,7 @@ In this guide, you'll build a signal provider that polls an external service on
6
6
 
7
7
  The example watches build pipelines in a fake CI service, but the pattern applies to any pull-based source: an issue tracker, a status API, a queue, or your own backend.
8
8
 
9
- > **Beta:** Signal providers are in beta. Breaking changes may occur without a major version bump until the API is stable.
9
+ > **Beta:** Breaking changes may occur without a major version bump until the API is stable.
10
10
 
11
11
  ## Prerequisites
12
12
 
@@ -14,11 +14,11 @@ The `npm create mastra@latest` command is the fastest way to build your first ag
14
14
 
15
15
  Add Mastra to an existing project, or scaffold a new Mastra-powered app if you’re starting from scratch.
16
16
 
17
- - [Next.js](https://mastra.ai/guides/getting-started/next-js)
18
- - [React](https://mastra.ai/guides/getting-started/vite-react)
19
- - [SvelteKit](https://mastra.ai/guides/getting-started/sveltekit)
20
- - [Astro](https://mastra.ai/guides/getting-started/astro)
21
- - [Nuxt](https://mastra.ai/guides/getting-started/nuxt)
22
- - [Express](https://mastra.ai/guides/getting-started/express)
23
- - [Hono](https://mastra.ai/guides/getting-started/hono)
24
- - [Electron](https://mastra.ai/guides/getting-started/electron)
17
+ - [Next.js](https://mastra.ai/integrations/frameworks/next-js)
18
+ - [React](https://mastra.ai/integrations/frameworks/vite-react)
19
+ - [SvelteKit](https://mastra.ai/integrations/frameworks/sveltekit)
20
+ - [Astro](https://mastra.ai/integrations/frameworks/astro)
21
+ - [Nuxt](https://mastra.ai/integrations/frameworks/nuxt)
22
+ - [Express](https://mastra.ai/integrations/frameworks/express)
23
+ - [Hono](https://mastra.ai/integrations/frameworks/hono)
24
+ - [Electron](https://mastra.ai/integrations/frameworks/electron)