@mastra/mcp-docs-server 1.1.4 → 1.1.5

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 (547) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/package.json +5 -5
  3. package/.docs/docs/agents/adding-voice.md +0 -353
  4. package/.docs/docs/agents/agent-approval.md +0 -377
  5. package/.docs/docs/agents/agent-memory.md +0 -212
  6. package/.docs/docs/agents/guardrails.md +0 -382
  7. package/.docs/docs/agents/network-approval.md +0 -275
  8. package/.docs/docs/agents/networks.md +0 -290
  9. package/.docs/docs/agents/overview.md +0 -309
  10. package/.docs/docs/agents/processors.md +0 -632
  11. package/.docs/docs/agents/structured-output.md +0 -271
  12. package/.docs/docs/agents/using-tools.md +0 -214
  13. package/.docs/docs/build-with-ai/mcp-docs-server.md +0 -241
  14. package/.docs/docs/build-with-ai/skills.md +0 -35
  15. package/.docs/docs/community/contributing-templates.md +0 -3
  16. package/.docs/docs/community/discord.md +0 -9
  17. package/.docs/docs/community/licensing.md +0 -66
  18. package/.docs/docs/deployment/cloud-providers.md +0 -15
  19. package/.docs/docs/deployment/mastra-server.md +0 -122
  20. package/.docs/docs/deployment/monorepo.md +0 -142
  21. package/.docs/docs/deployment/overview.md +0 -62
  22. package/.docs/docs/deployment/studio.md +0 -234
  23. package/.docs/docs/deployment/web-framework.md +0 -52
  24. package/.docs/docs/deployment/workflow-runners.md +0 -9
  25. package/.docs/docs/evals/built-in-scorers.md +0 -47
  26. package/.docs/docs/evals/custom-scorers.md +0 -519
  27. package/.docs/docs/evals/overview.md +0 -146
  28. package/.docs/docs/evals/running-in-ci.md +0 -106
  29. package/.docs/docs/getting-started/build-with-ai.md +0 -68
  30. package/.docs/docs/getting-started/manual-install.md +0 -226
  31. package/.docs/docs/getting-started/project-structure.md +0 -60
  32. package/.docs/docs/getting-started/start.md +0 -28
  33. package/.docs/docs/getting-started/studio.md +0 -101
  34. package/.docs/docs/index.md +0 -43
  35. package/.docs/docs/mastra-cloud/deployment.md +0 -77
  36. package/.docs/docs/mastra-cloud/observability.md +0 -38
  37. package/.docs/docs/mastra-cloud/overview.md +0 -23
  38. package/.docs/docs/mastra-cloud/setup.md +0 -42
  39. package/.docs/docs/mastra-cloud/studio.md +0 -24
  40. package/.docs/docs/mcp/overview.md +0 -370
  41. package/.docs/docs/mcp/publishing-mcp-server.md +0 -95
  42. package/.docs/docs/memory/memory-processors.md +0 -316
  43. package/.docs/docs/memory/message-history.md +0 -260
  44. package/.docs/docs/memory/observational-memory.md +0 -246
  45. package/.docs/docs/memory/overview.md +0 -45
  46. package/.docs/docs/memory/semantic-recall.md +0 -272
  47. package/.docs/docs/memory/storage.md +0 -261
  48. package/.docs/docs/memory/working-memory.md +0 -400
  49. package/.docs/docs/observability/datasets/overview.md +0 -188
  50. package/.docs/docs/observability/datasets/running-experiments.md +0 -266
  51. package/.docs/docs/observability/logging.md +0 -99
  52. package/.docs/docs/observability/overview.md +0 -70
  53. package/.docs/docs/observability/tracing/bridges/otel.md +0 -209
  54. package/.docs/docs/observability/tracing/exporters/arize.md +0 -274
  55. package/.docs/docs/observability/tracing/exporters/braintrust.md +0 -111
  56. package/.docs/docs/observability/tracing/exporters/cloud.md +0 -129
  57. package/.docs/docs/observability/tracing/exporters/datadog.md +0 -187
  58. package/.docs/docs/observability/tracing/exporters/default.md +0 -211
  59. package/.docs/docs/observability/tracing/exporters/laminar.md +0 -100
  60. package/.docs/docs/observability/tracing/exporters/langfuse.md +0 -217
  61. package/.docs/docs/observability/tracing/exporters/langsmith.md +0 -202
  62. package/.docs/docs/observability/tracing/exporters/otel.md +0 -479
  63. package/.docs/docs/observability/tracing/exporters/posthog.md +0 -148
  64. package/.docs/docs/observability/tracing/exporters/sentry.md +0 -208
  65. package/.docs/docs/observability/tracing/overview.md +0 -1114
  66. package/.docs/docs/observability/tracing/processors/sensitive-data-filter.md +0 -303
  67. package/.docs/docs/rag/chunking-and-embedding.md +0 -183
  68. package/.docs/docs/rag/graph-rag.md +0 -215
  69. package/.docs/docs/rag/overview.md +0 -72
  70. package/.docs/docs/rag/retrieval.md +0 -521
  71. package/.docs/docs/rag/vector-databases.md +0 -648
  72. package/.docs/docs/server/auth/auth0.md +0 -222
  73. package/.docs/docs/server/auth/better-auth.md +0 -203
  74. package/.docs/docs/server/auth/clerk.md +0 -132
  75. package/.docs/docs/server/auth/composite-auth.md +0 -234
  76. package/.docs/docs/server/auth/custom-auth-provider.md +0 -513
  77. package/.docs/docs/server/auth/firebase.md +0 -272
  78. package/.docs/docs/server/auth/jwt.md +0 -110
  79. package/.docs/docs/server/auth/simple-auth.md +0 -178
  80. package/.docs/docs/server/auth/supabase.md +0 -117
  81. package/.docs/docs/server/auth/workos.md +0 -190
  82. package/.docs/docs/server/auth.md +0 -38
  83. package/.docs/docs/server/custom-adapters.md +0 -374
  84. package/.docs/docs/server/custom-api-routes.md +0 -267
  85. package/.docs/docs/server/mastra-client.md +0 -243
  86. package/.docs/docs/server/mastra-server.md +0 -71
  87. package/.docs/docs/server/middleware.md +0 -228
  88. package/.docs/docs/server/request-context.md +0 -478
  89. package/.docs/docs/server/server-adapters.md +0 -547
  90. package/.docs/docs/streaming/events.md +0 -247
  91. package/.docs/docs/streaming/overview.md +0 -181
  92. package/.docs/docs/streaming/tool-streaming.md +0 -178
  93. package/.docs/docs/streaming/workflow-streaming.md +0 -109
  94. package/.docs/docs/voice/overview.md +0 -979
  95. package/.docs/docs/voice/speech-to-speech.md +0 -103
  96. package/.docs/docs/voice/speech-to-text.md +0 -80
  97. package/.docs/docs/voice/text-to-speech.md +0 -84
  98. package/.docs/docs/workflows/agents-and-tools.md +0 -170
  99. package/.docs/docs/workflows/control-flow.md +0 -823
  100. package/.docs/docs/workflows/error-handling.md +0 -360
  101. package/.docs/docs/workflows/human-in-the-loop.md +0 -213
  102. package/.docs/docs/workflows/overview.md +0 -372
  103. package/.docs/docs/workflows/snapshots.md +0 -238
  104. package/.docs/docs/workflows/suspend-and-resume.md +0 -205
  105. package/.docs/docs/workflows/time-travel.md +0 -309
  106. package/.docs/docs/workflows/workflow-state.md +0 -181
  107. package/.docs/docs/workspace/filesystem.md +0 -162
  108. package/.docs/docs/workspace/overview.md +0 -239
  109. package/.docs/docs/workspace/sandbox.md +0 -63
  110. package/.docs/docs/workspace/search.md +0 -219
  111. package/.docs/docs/workspace/skills.md +0 -126
  112. package/.docs/guides/agent-frameworks/ai-sdk.md +0 -140
  113. package/.docs/guides/build-your-ui/ai-sdk-ui.md +0 -1463
  114. package/.docs/guides/build-your-ui/assistant-ui.md +0 -156
  115. package/.docs/guides/build-your-ui/copilotkit.md +0 -292
  116. package/.docs/guides/deployment/amazon-ec2.md +0 -130
  117. package/.docs/guides/deployment/aws-lambda.md +0 -248
  118. package/.docs/guides/deployment/azure-app-services.md +0 -114
  119. package/.docs/guides/deployment/cloudflare.md +0 -99
  120. package/.docs/guides/deployment/digital-ocean.md +0 -168
  121. package/.docs/guides/deployment/inngest.md +0 -685
  122. package/.docs/guides/deployment/netlify.md +0 -77
  123. package/.docs/guides/deployment/vercel.md +0 -101
  124. package/.docs/guides/getting-started/astro.md +0 -408
  125. package/.docs/guides/getting-started/electron.md +0 -504
  126. package/.docs/guides/getting-started/express.md +0 -251
  127. package/.docs/guides/getting-started/hono.md +0 -191
  128. package/.docs/guides/getting-started/next-js.md +0 -355
  129. package/.docs/guides/getting-started/nuxt.md +0 -476
  130. package/.docs/guides/getting-started/quickstart.md +0 -67
  131. package/.docs/guides/getting-started/sveltekit.md +0 -300
  132. package/.docs/guides/getting-started/vite-react.md +0 -439
  133. package/.docs/guides/guide/ai-recruiter.md +0 -227
  134. package/.docs/guides/guide/chef-michel.md +0 -215
  135. package/.docs/guides/guide/code-review-bot.md +0 -221
  136. package/.docs/guides/guide/dev-assistant.md +0 -304
  137. package/.docs/guides/guide/docs-manager.md +0 -238
  138. package/.docs/guides/guide/github-actions-pr-description.md +0 -236
  139. package/.docs/guides/guide/notes-mcp-server.md +0 -425
  140. package/.docs/guides/guide/research-assistant.md +0 -349
  141. package/.docs/guides/guide/stock-agent.md +0 -134
  142. package/.docs/guides/guide/web-search.md +0 -326
  143. package/.docs/guides/guide/whatsapp-chat-bot.md +0 -416
  144. package/.docs/guides/index.md +0 -3
  145. package/.docs/guides/migrations/agentnetwork.md +0 -101
  146. package/.docs/guides/migrations/ai-sdk-v4-to-v5.md +0 -112
  147. package/.docs/guides/migrations/upgrade-to-v1/agent.md +0 -404
  148. package/.docs/guides/migrations/upgrade-to-v1/cli.md +0 -57
  149. package/.docs/guides/migrations/upgrade-to-v1/client.md +0 -337
  150. package/.docs/guides/migrations/upgrade-to-v1/deployment.md +0 -37
  151. package/.docs/guides/migrations/upgrade-to-v1/evals.md +0 -239
  152. package/.docs/guides/migrations/upgrade-to-v1/mastra.md +0 -143
  153. package/.docs/guides/migrations/upgrade-to-v1/mcp.md +0 -97
  154. package/.docs/guides/migrations/upgrade-to-v1/memory.md +0 -285
  155. package/.docs/guides/migrations/upgrade-to-v1/overview.md +0 -119
  156. package/.docs/guides/migrations/upgrade-to-v1/processors.md +0 -68
  157. package/.docs/guides/migrations/upgrade-to-v1/rag.md +0 -42
  158. package/.docs/guides/migrations/upgrade-to-v1/storage.md +0 -553
  159. package/.docs/guides/migrations/upgrade-to-v1/tools.md +0 -180
  160. package/.docs/guides/migrations/upgrade-to-v1/tracing.md +0 -417
  161. package/.docs/guides/migrations/upgrade-to-v1/vectors.md +0 -87
  162. package/.docs/guides/migrations/upgrade-to-v1/voice.md +0 -30
  163. package/.docs/guides/migrations/upgrade-to-v1/workflows.md +0 -341
  164. package/.docs/guides/migrations/vnext-to-standard-apis.md +0 -364
  165. package/.docs/models/embeddings.md +0 -161
  166. package/.docs/models/gateways/azure-openai.md +0 -128
  167. package/.docs/models/gateways/custom-gateways.md +0 -545
  168. package/.docs/models/gateways/netlify.md +0 -88
  169. package/.docs/models/gateways/openrouter.md +0 -219
  170. package/.docs/models/gateways/vercel.md +0 -225
  171. package/.docs/models/gateways.md +0 -14
  172. package/.docs/models/index.md +0 -286
  173. package/.docs/models/providers/302ai.md +0 -134
  174. package/.docs/models/providers/abacus.md +0 -125
  175. package/.docs/models/providers/agentrouter.md +0 -90
  176. package/.docs/models/providers/aihubmix.md +0 -107
  177. package/.docs/models/providers/alibaba-cn.md +0 -135
  178. package/.docs/models/providers/alibaba.md +0 -111
  179. package/.docs/models/providers/amazon-bedrock.md +0 -33
  180. package/.docs/models/providers/anthropic.md +0 -153
  181. package/.docs/models/providers/azure.md +0 -33
  182. package/.docs/models/providers/bailing.md +0 -72
  183. package/.docs/models/providers/baseten.md +0 -77
  184. package/.docs/models/providers/berget.md +0 -78
  185. package/.docs/models/providers/cerebras.md +0 -101
  186. package/.docs/models/providers/chutes.md +0 -136
  187. package/.docs/models/providers/cloudflare-ai-gateway.md +0 -33
  188. package/.docs/models/providers/cloudflare-workers-ai.md +0 -109
  189. package/.docs/models/providers/cohere.md +0 -33
  190. package/.docs/models/providers/cortecs.md +0 -91
  191. package/.docs/models/providers/deepinfra.md +0 -112
  192. package/.docs/models/providers/deepseek.md +0 -88
  193. package/.docs/models/providers/fastrouter.md +0 -84
  194. package/.docs/models/providers/fireworks-ai.md +0 -89
  195. package/.docs/models/providers/firmware.md +0 -85
  196. package/.docs/models/providers/friendli.md +0 -78
  197. package/.docs/models/providers/github-models.md +0 -125
  198. package/.docs/models/providers/google-vertex.md +0 -33
  199. package/.docs/models/providers/google.md +0 -159
  200. package/.docs/models/providers/groq.md +0 -107
  201. package/.docs/models/providers/helicone.md +0 -161
  202. package/.docs/models/providers/huggingface.md +0 -90
  203. package/.docs/models/providers/iflowcn.md +0 -84
  204. package/.docs/models/providers/inception.md +0 -72
  205. package/.docs/models/providers/inference.md +0 -79
  206. package/.docs/models/providers/io-intelligence.md +0 -87
  207. package/.docs/models/providers/io-net.md +0 -87
  208. package/.docs/models/providers/jiekou.md +0 -131
  209. package/.docs/models/providers/kilo.md +0 -333
  210. package/.docs/models/providers/kimi-for-coding.md +0 -100
  211. package/.docs/models/providers/kuae-cloud-coding-plan.md +0 -71
  212. package/.docs/models/providers/llama.md +0 -77
  213. package/.docs/models/providers/lmstudio.md +0 -73
  214. package/.docs/models/providers/lucidquery.md +0 -72
  215. package/.docs/models/providers/minimax-cn-coding-plan.md +0 -102
  216. package/.docs/models/providers/minimax-cn.md +0 -102
  217. package/.docs/models/providers/minimax-coding-plan.md +0 -102
  218. package/.docs/models/providers/minimax.md +0 -104
  219. package/.docs/models/providers/mistral.md +0 -124
  220. package/.docs/models/providers/moark.md +0 -72
  221. package/.docs/models/providers/modelscope.md +0 -77
  222. package/.docs/models/providers/moonshotai-cn.md +0 -76
  223. package/.docs/models/providers/moonshotai.md +0 -76
  224. package/.docs/models/providers/morph.md +0 -73
  225. package/.docs/models/providers/nano-gpt.md +0 -103
  226. package/.docs/models/providers/nebius.md +0 -116
  227. package/.docs/models/providers/nova.md +0 -72
  228. package/.docs/models/providers/novita-ai.md +0 -154
  229. package/.docs/models/providers/nvidia.md +0 -141
  230. package/.docs/models/providers/ollama-cloud.md +0 -103
  231. package/.docs/models/providers/ollama.md +0 -33
  232. package/.docs/models/providers/openai.md +0 -193
  233. package/.docs/models/providers/opencode.md +0 -100
  234. package/.docs/models/providers/ovhcloud.md +0 -83
  235. package/.docs/models/providers/perplexity.md +0 -100
  236. package/.docs/models/providers/poe.md +0 -183
  237. package/.docs/models/providers/privatemode-ai.md +0 -75
  238. package/.docs/models/providers/requesty.md +0 -90
  239. package/.docs/models/providers/scaleway.md +0 -84
  240. package/.docs/models/providers/siliconflow-cn.md +0 -138
  241. package/.docs/models/providers/siliconflow.md +0 -140
  242. package/.docs/models/providers/stackit.md +0 -78
  243. package/.docs/models/providers/stepfun.md +0 -73
  244. package/.docs/models/providers/submodel.md +0 -79
  245. package/.docs/models/providers/synthetic.md +0 -96
  246. package/.docs/models/providers/togetherai.md +0 -115
  247. package/.docs/models/providers/upstage.md +0 -73
  248. package/.docs/models/providers/venice.md +0 -95
  249. package/.docs/models/providers/vivgrid.md +0 -106
  250. package/.docs/models/providers/vultr.md +0 -75
  251. package/.docs/models/providers/wandb.md +0 -80
  252. package/.docs/models/providers/xai.md +0 -141
  253. package/.docs/models/providers/xiaomi.md +0 -71
  254. package/.docs/models/providers/zai-coding-plan.md +0 -80
  255. package/.docs/models/providers/zai.md +0 -79
  256. package/.docs/models/providers/zenmux.md +0 -161
  257. package/.docs/models/providers/zhipuai-coding-plan.md +0 -79
  258. package/.docs/models/providers/zhipuai.md +0 -79
  259. package/.docs/models/providers.md +0 -81
  260. package/.docs/reference/agents/agent.md +0 -142
  261. package/.docs/reference/agents/generate.md +0 -174
  262. package/.docs/reference/agents/generateLegacy.md +0 -176
  263. package/.docs/reference/agents/getDefaultGenerateOptions.md +0 -36
  264. package/.docs/reference/agents/getDefaultOptions.md +0 -34
  265. package/.docs/reference/agents/getDefaultStreamOptions.md +0 -36
  266. package/.docs/reference/agents/getDescription.md +0 -21
  267. package/.docs/reference/agents/getInstructions.md +0 -34
  268. package/.docs/reference/agents/getLLM.md +0 -37
  269. package/.docs/reference/agents/getMemory.md +0 -34
  270. package/.docs/reference/agents/getModel.md +0 -34
  271. package/.docs/reference/agents/getTools.md +0 -29
  272. package/.docs/reference/agents/getVoice.md +0 -34
  273. package/.docs/reference/agents/listAgents.md +0 -35
  274. package/.docs/reference/agents/listScorers.md +0 -34
  275. package/.docs/reference/agents/listTools.md +0 -34
  276. package/.docs/reference/agents/listWorkflows.md +0 -34
  277. package/.docs/reference/agents/network.md +0 -134
  278. package/.docs/reference/ai-sdk/chat-route.md +0 -82
  279. package/.docs/reference/ai-sdk/handle-chat-stream.md +0 -53
  280. package/.docs/reference/ai-sdk/handle-network-stream.md +0 -37
  281. package/.docs/reference/ai-sdk/handle-workflow-stream.md +0 -55
  282. package/.docs/reference/ai-sdk/network-route.md +0 -74
  283. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +0 -232
  284. package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +0 -79
  285. package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +0 -73
  286. package/.docs/reference/ai-sdk/with-mastra.md +0 -59
  287. package/.docs/reference/ai-sdk/workflow-route.md +0 -79
  288. package/.docs/reference/auth/auth0.md +0 -73
  289. package/.docs/reference/auth/better-auth.md +0 -71
  290. package/.docs/reference/auth/clerk.md +0 -36
  291. package/.docs/reference/auth/firebase.md +0 -80
  292. package/.docs/reference/auth/jwt.md +0 -26
  293. package/.docs/reference/auth/supabase.md +0 -33
  294. package/.docs/reference/auth/workos.md +0 -84
  295. package/.docs/reference/cli/create-mastra.md +0 -137
  296. package/.docs/reference/cli/mastra.md +0 -336
  297. package/.docs/reference/client-js/agents.md +0 -438
  298. package/.docs/reference/client-js/error-handling.md +0 -16
  299. package/.docs/reference/client-js/logs.md +0 -24
  300. package/.docs/reference/client-js/mastra-client.md +0 -63
  301. package/.docs/reference/client-js/memory.md +0 -225
  302. package/.docs/reference/client-js/observability.md +0 -72
  303. package/.docs/reference/client-js/telemetry.md +0 -20
  304. package/.docs/reference/client-js/tools.md +0 -44
  305. package/.docs/reference/client-js/vectors.md +0 -79
  306. package/.docs/reference/client-js/workflows.md +0 -199
  307. package/.docs/reference/configuration.md +0 -749
  308. package/.docs/reference/core/addGateway.md +0 -42
  309. package/.docs/reference/core/getAgent.md +0 -21
  310. package/.docs/reference/core/getAgentById.md +0 -21
  311. package/.docs/reference/core/getDeployer.md +0 -22
  312. package/.docs/reference/core/getGateway.md +0 -38
  313. package/.docs/reference/core/getGatewayById.md +0 -41
  314. package/.docs/reference/core/getLogger.md +0 -22
  315. package/.docs/reference/core/getMCPServer.md +0 -45
  316. package/.docs/reference/core/getMCPServerById.md +0 -53
  317. package/.docs/reference/core/getMemory.md +0 -50
  318. package/.docs/reference/core/getScorer.md +0 -54
  319. package/.docs/reference/core/getScorerById.md +0 -54
  320. package/.docs/reference/core/getServer.md +0 -22
  321. package/.docs/reference/core/getStorage.md +0 -22
  322. package/.docs/reference/core/getStoredAgentById.md +0 -89
  323. package/.docs/reference/core/getTelemetry.md +0 -22
  324. package/.docs/reference/core/getVector.md +0 -22
  325. package/.docs/reference/core/getWorkflow.md +0 -40
  326. package/.docs/reference/core/listAgents.md +0 -21
  327. package/.docs/reference/core/listGateways.md +0 -40
  328. package/.docs/reference/core/listLogs.md +0 -38
  329. package/.docs/reference/core/listLogsByRunId.md +0 -36
  330. package/.docs/reference/core/listMCPServers.md +0 -51
  331. package/.docs/reference/core/listMemory.md +0 -56
  332. package/.docs/reference/core/listScorers.md +0 -29
  333. package/.docs/reference/core/listStoredAgents.md +0 -93
  334. package/.docs/reference/core/listVectors.md +0 -22
  335. package/.docs/reference/core/listWorkflows.md +0 -21
  336. package/.docs/reference/core/mastra-class.md +0 -66
  337. package/.docs/reference/core/mastra-model-gateway.md +0 -153
  338. package/.docs/reference/core/setLogger.md +0 -26
  339. package/.docs/reference/core/setStorage.md +0 -27
  340. package/.docs/reference/datasets/addItem.md +0 -35
  341. package/.docs/reference/datasets/addItems.md +0 -33
  342. package/.docs/reference/datasets/compareExperiments.md +0 -48
  343. package/.docs/reference/datasets/create.md +0 -49
  344. package/.docs/reference/datasets/dataset.md +0 -78
  345. package/.docs/reference/datasets/datasets-manager.md +0 -84
  346. package/.docs/reference/datasets/delete.md +0 -23
  347. package/.docs/reference/datasets/deleteExperiment.md +0 -25
  348. package/.docs/reference/datasets/deleteItem.md +0 -25
  349. package/.docs/reference/datasets/deleteItems.md +0 -27
  350. package/.docs/reference/datasets/get.md +0 -29
  351. package/.docs/reference/datasets/getDetails.md +0 -45
  352. package/.docs/reference/datasets/getExperiment.md +0 -28
  353. package/.docs/reference/datasets/getItem.md +0 -31
  354. package/.docs/reference/datasets/getItemHistory.md +0 -29
  355. package/.docs/reference/datasets/list.md +0 -29
  356. package/.docs/reference/datasets/listExperimentResults.md +0 -37
  357. package/.docs/reference/datasets/listExperiments.md +0 -31
  358. package/.docs/reference/datasets/listItems.md +0 -44
  359. package/.docs/reference/datasets/listVersions.md +0 -31
  360. package/.docs/reference/datasets/startExperiment.md +0 -60
  361. package/.docs/reference/datasets/startExperimentAsync.md +0 -41
  362. package/.docs/reference/datasets/update.md +0 -46
  363. package/.docs/reference/datasets/updateItem.md +0 -36
  364. package/.docs/reference/deployer/cloudflare.md +0 -79
  365. package/.docs/reference/deployer/netlify.md +0 -82
  366. package/.docs/reference/deployer/vercel.md +0 -91
  367. package/.docs/reference/deployer.md +0 -100
  368. package/.docs/reference/evals/answer-relevancy.md +0 -105
  369. package/.docs/reference/evals/answer-similarity.md +0 -99
  370. package/.docs/reference/evals/bias.md +0 -120
  371. package/.docs/reference/evals/completeness.md +0 -137
  372. package/.docs/reference/evals/content-similarity.md +0 -101
  373. package/.docs/reference/evals/context-precision.md +0 -196
  374. package/.docs/reference/evals/context-relevance.md +0 -536
  375. package/.docs/reference/evals/create-scorer.md +0 -270
  376. package/.docs/reference/evals/faithfulness.md +0 -114
  377. package/.docs/reference/evals/hallucination.md +0 -220
  378. package/.docs/reference/evals/keyword-coverage.md +0 -128
  379. package/.docs/reference/evals/mastra-scorer.md +0 -123
  380. package/.docs/reference/evals/noise-sensitivity.md +0 -685
  381. package/.docs/reference/evals/prompt-alignment.md +0 -619
  382. package/.docs/reference/evals/run-evals.md +0 -138
  383. package/.docs/reference/evals/scorer-utils.md +0 -330
  384. package/.docs/reference/evals/textual-difference.md +0 -113
  385. package/.docs/reference/evals/tone-consistency.md +0 -119
  386. package/.docs/reference/evals/tool-call-accuracy.md +0 -533
  387. package/.docs/reference/evals/toxicity.md +0 -123
  388. package/.docs/reference/harness/harness-class.md +0 -645
  389. package/.docs/reference/index.md +0 -276
  390. package/.docs/reference/logging/pino-logger.md +0 -117
  391. package/.docs/reference/memory/clone-utilities.md +0 -199
  392. package/.docs/reference/memory/cloneThread.md +0 -130
  393. package/.docs/reference/memory/createThread.md +0 -68
  394. package/.docs/reference/memory/deleteMessages.md +0 -40
  395. package/.docs/reference/memory/getThreadById.md +0 -24
  396. package/.docs/reference/memory/listThreads.md +0 -145
  397. package/.docs/reference/memory/memory-class.md +0 -147
  398. package/.docs/reference/memory/observational-memory.md +0 -565
  399. package/.docs/reference/memory/recall.md +0 -91
  400. package/.docs/reference/observability/tracing/bridges/otel.md +0 -131
  401. package/.docs/reference/observability/tracing/configuration.md +0 -178
  402. package/.docs/reference/observability/tracing/exporters/arize.md +0 -141
  403. package/.docs/reference/observability/tracing/exporters/braintrust.md +0 -93
  404. package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +0 -163
  405. package/.docs/reference/observability/tracing/exporters/console-exporter.md +0 -138
  406. package/.docs/reference/observability/tracing/exporters/datadog.md +0 -116
  407. package/.docs/reference/observability/tracing/exporters/default-exporter.md +0 -174
  408. package/.docs/reference/observability/tracing/exporters/laminar.md +0 -78
  409. package/.docs/reference/observability/tracing/exporters/langfuse.md +0 -134
  410. package/.docs/reference/observability/tracing/exporters/langsmith.md +0 -110
  411. package/.docs/reference/observability/tracing/exporters/otel.md +0 -199
  412. package/.docs/reference/observability/tracing/exporters/posthog.md +0 -92
  413. package/.docs/reference/observability/tracing/exporters/sentry.md +0 -184
  414. package/.docs/reference/observability/tracing/instances.md +0 -109
  415. package/.docs/reference/observability/tracing/interfaces.md +0 -749
  416. package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md +0 -144
  417. package/.docs/reference/observability/tracing/spans.md +0 -224
  418. package/.docs/reference/processors/batch-parts-processor.md +0 -61
  419. package/.docs/reference/processors/language-detector.md +0 -81
  420. package/.docs/reference/processors/message-history-processor.md +0 -85
  421. package/.docs/reference/processors/moderation-processor.md +0 -104
  422. package/.docs/reference/processors/pii-detector.md +0 -107
  423. package/.docs/reference/processors/processor-interface.md +0 -525
  424. package/.docs/reference/processors/prompt-injection-detector.md +0 -71
  425. package/.docs/reference/processors/semantic-recall-processor.md +0 -123
  426. package/.docs/reference/processors/system-prompt-scrubber.md +0 -80
  427. package/.docs/reference/processors/token-limiter-processor.md +0 -113
  428. package/.docs/reference/processors/tool-call-filter.md +0 -85
  429. package/.docs/reference/processors/tool-search-processor.md +0 -113
  430. package/.docs/reference/processors/unicode-normalizer.md +0 -62
  431. package/.docs/reference/processors/working-memory-processor.md +0 -154
  432. package/.docs/reference/rag/chunk.md +0 -221
  433. package/.docs/reference/rag/database-config.md +0 -264
  434. package/.docs/reference/rag/document.md +0 -114
  435. package/.docs/reference/rag/embeddings.md +0 -92
  436. package/.docs/reference/rag/extract-params.md +0 -168
  437. package/.docs/reference/rag/graph-rag.md +0 -111
  438. package/.docs/reference/rag/metadata-filters.md +0 -216
  439. package/.docs/reference/rag/rerank.md +0 -80
  440. package/.docs/reference/rag/rerankWithScorer.md +0 -80
  441. package/.docs/reference/server/create-route.md +0 -260
  442. package/.docs/reference/server/express-adapter.md +0 -176
  443. package/.docs/reference/server/fastify-adapter.md +0 -90
  444. package/.docs/reference/server/hono-adapter.md +0 -162
  445. package/.docs/reference/server/koa-adapter.md +0 -127
  446. package/.docs/reference/server/mastra-server.md +0 -298
  447. package/.docs/reference/server/register-api-route.md +0 -249
  448. package/.docs/reference/server/routes.md +0 -306
  449. package/.docs/reference/storage/cloudflare-d1.md +0 -218
  450. package/.docs/reference/storage/cloudflare.md +0 -88
  451. package/.docs/reference/storage/composite.md +0 -235
  452. package/.docs/reference/storage/convex.md +0 -161
  453. package/.docs/reference/storage/dynamodb.md +0 -282
  454. package/.docs/reference/storage/lance.md +0 -131
  455. package/.docs/reference/storage/libsql.md +0 -135
  456. package/.docs/reference/storage/mongodb.md +0 -262
  457. package/.docs/reference/storage/mssql.md +0 -155
  458. package/.docs/reference/storage/overview.md +0 -121
  459. package/.docs/reference/storage/postgresql.md +0 -529
  460. package/.docs/reference/storage/upstash.md +0 -160
  461. package/.docs/reference/streaming/ChunkType.md +0 -292
  462. package/.docs/reference/streaming/agents/MastraModelOutput.md +0 -182
  463. package/.docs/reference/streaming/agents/stream.md +0 -212
  464. package/.docs/reference/streaming/agents/streamLegacy.md +0 -142
  465. package/.docs/reference/streaming/workflows/observeStream.md +0 -42
  466. package/.docs/reference/streaming/workflows/resumeStream.md +0 -61
  467. package/.docs/reference/streaming/workflows/stream.md +0 -88
  468. package/.docs/reference/streaming/workflows/timeTravelStream.md +0 -142
  469. package/.docs/reference/templates/overview.md +0 -194
  470. package/.docs/reference/tools/create-tool.md +0 -237
  471. package/.docs/reference/tools/document-chunker-tool.md +0 -89
  472. package/.docs/reference/tools/graph-rag-tool.md +0 -185
  473. package/.docs/reference/tools/mcp-client.md +0 -962
  474. package/.docs/reference/tools/mcp-server.md +0 -1275
  475. package/.docs/reference/tools/vector-query-tool.md +0 -459
  476. package/.docs/reference/vectors/astra.md +0 -121
  477. package/.docs/reference/vectors/chroma.md +0 -267
  478. package/.docs/reference/vectors/convex.md +0 -303
  479. package/.docs/reference/vectors/couchbase.md +0 -226
  480. package/.docs/reference/vectors/duckdb.md +0 -318
  481. package/.docs/reference/vectors/elasticsearch.md +0 -189
  482. package/.docs/reference/vectors/lance.md +0 -220
  483. package/.docs/reference/vectors/libsql.md +0 -305
  484. package/.docs/reference/vectors/mongodb.md +0 -295
  485. package/.docs/reference/vectors/opensearch.md +0 -99
  486. package/.docs/reference/vectors/pg.md +0 -408
  487. package/.docs/reference/vectors/pinecone.md +0 -168
  488. package/.docs/reference/vectors/qdrant.md +0 -222
  489. package/.docs/reference/vectors/s3vectors.md +0 -277
  490. package/.docs/reference/vectors/turbopuffer.md +0 -157
  491. package/.docs/reference/vectors/upstash.md +0 -294
  492. package/.docs/reference/vectors/vectorize.md +0 -147
  493. package/.docs/reference/voice/azure.md +0 -148
  494. package/.docs/reference/voice/cloudflare.md +0 -83
  495. package/.docs/reference/voice/composite-voice.md +0 -121
  496. package/.docs/reference/voice/deepgram.md +0 -79
  497. package/.docs/reference/voice/elevenlabs.md +0 -98
  498. package/.docs/reference/voice/google-gemini-live.md +0 -378
  499. package/.docs/reference/voice/google.md +0 -228
  500. package/.docs/reference/voice/mastra-voice.md +0 -313
  501. package/.docs/reference/voice/murf.md +0 -122
  502. package/.docs/reference/voice/openai-realtime.md +0 -203
  503. package/.docs/reference/voice/openai.md +0 -88
  504. package/.docs/reference/voice/playai.md +0 -80
  505. package/.docs/reference/voice/sarvam.md +0 -126
  506. package/.docs/reference/voice/speechify.md +0 -75
  507. package/.docs/reference/voice/voice.addInstructions.md +0 -56
  508. package/.docs/reference/voice/voice.addTools.md +0 -67
  509. package/.docs/reference/voice/voice.answer.md +0 -54
  510. package/.docs/reference/voice/voice.close.md +0 -51
  511. package/.docs/reference/voice/voice.connect.md +0 -94
  512. package/.docs/reference/voice/voice.events.md +0 -37
  513. package/.docs/reference/voice/voice.getSpeakers.md +0 -129
  514. package/.docs/reference/voice/voice.listen.md +0 -164
  515. package/.docs/reference/voice/voice.off.md +0 -54
  516. package/.docs/reference/voice/voice.on.md +0 -111
  517. package/.docs/reference/voice/voice.send.md +0 -65
  518. package/.docs/reference/voice/voice.speak.md +0 -157
  519. package/.docs/reference/voice/voice.updateConfig.md +0 -60
  520. package/.docs/reference/workflows/run-methods/cancel.md +0 -86
  521. package/.docs/reference/workflows/run-methods/restart.md +0 -33
  522. package/.docs/reference/workflows/run-methods/resume.md +0 -59
  523. package/.docs/reference/workflows/run-methods/start.md +0 -58
  524. package/.docs/reference/workflows/run-methods/startAsync.md +0 -67
  525. package/.docs/reference/workflows/run-methods/timeTravel.md +0 -142
  526. package/.docs/reference/workflows/run.md +0 -59
  527. package/.docs/reference/workflows/step.md +0 -119
  528. package/.docs/reference/workflows/workflow-methods/branch.md +0 -25
  529. package/.docs/reference/workflows/workflow-methods/commit.md +0 -17
  530. package/.docs/reference/workflows/workflow-methods/create-run.md +0 -63
  531. package/.docs/reference/workflows/workflow-methods/dountil.md +0 -25
  532. package/.docs/reference/workflows/workflow-methods/dowhile.md +0 -25
  533. package/.docs/reference/workflows/workflow-methods/foreach.md +0 -118
  534. package/.docs/reference/workflows/workflow-methods/map.md +0 -93
  535. package/.docs/reference/workflows/workflow-methods/parallel.md +0 -21
  536. package/.docs/reference/workflows/workflow-methods/sleep.md +0 -35
  537. package/.docs/reference/workflows/workflow-methods/sleepUntil.md +0 -35
  538. package/.docs/reference/workflows/workflow-methods/then.md +0 -21
  539. package/.docs/reference/workflows/workflow.md +0 -157
  540. package/.docs/reference/workspace/e2b-sandbox.md +0 -288
  541. package/.docs/reference/workspace/filesystem.md +0 -202
  542. package/.docs/reference/workspace/gcs-filesystem.md +0 -170
  543. package/.docs/reference/workspace/local-filesystem.md +0 -327
  544. package/.docs/reference/workspace/local-sandbox.md +0 -285
  545. package/.docs/reference/workspace/s3-filesystem.md +0 -169
  546. package/.docs/reference/workspace/sandbox.md +0 -81
  547. package/.docs/reference/workspace/workspace-class.md +0 -226
@@ -1,114 +0,0 @@
1
- # MDocument
2
-
3
- The MDocument class processes documents for RAG applications. The main methods are `.chunk()` and `.extractMetadata()`.
4
-
5
- ## Constructor
6
-
7
- **docs:** (`Array<{ text: string, metadata?: Record<string, any> }>`): Array of document chunks with their text content and optional metadata
8
-
9
- **type:** (`'text' | 'html' | 'markdown' | 'json' | 'latex'`): Type of document content
10
-
11
- ## Static Methods
12
-
13
- ### fromText()
14
-
15
- Creates a document from plain text content.
16
-
17
- ```typescript
18
- static fromText(text: string, metadata?: Record<string, any>): MDocument
19
- ```
20
-
21
- ### fromHTML()
22
-
23
- Creates a document from HTML content.
24
-
25
- ```typescript
26
- static fromHTML(html: string, metadata?: Record<string, any>): MDocument
27
- ```
28
-
29
- ### fromMarkdown()
30
-
31
- Creates a document from Markdown content.
32
-
33
- ```typescript
34
- static fromMarkdown(markdown: string, metadata?: Record<string, any>): MDocument
35
- ```
36
-
37
- ### fromJSON()
38
-
39
- Creates a document from JSON content.
40
-
41
- ```typescript
42
- static fromJSON(json: string, metadata?: Record<string, any>): MDocument
43
- ```
44
-
45
- ## Instance Methods
46
-
47
- ### chunk()
48
-
49
- Splits document into chunks and optionally extracts metadata.
50
-
51
- ```typescript
52
- async chunk(params?: ChunkParams): Promise<Chunk[]>
53
- ```
54
-
55
- See [chunk() reference](https://mastra.ai/reference/rag/chunk) for detailed options.
56
-
57
- ### getDocs()
58
-
59
- Returns array of processed document chunks.
60
-
61
- ```typescript
62
- getDocs(): Chunk[]
63
- ```
64
-
65
- ### getText()
66
-
67
- Returns array of text strings from chunks.
68
-
69
- ```typescript
70
- getText(): string[]
71
- ```
72
-
73
- ### getMetadata()
74
-
75
- Returns array of metadata objects from chunks.
76
-
77
- ```typescript
78
- getMetadata(): Record<string, any>[]
79
- ```
80
-
81
- ### extractMetadata()
82
-
83
- Extracts metadata using specified extractors. See [ExtractParams reference](https://mastra.ai/reference/rag/extract-params) for details.
84
-
85
- ```typescript
86
- async extractMetadata(params: ExtractParams): Promise<MDocument>
87
- ```
88
-
89
- ## Examples
90
-
91
- ```typescript
92
- import { MDocument } from "@mastra/rag";
93
-
94
- // Create document from text
95
- const doc = MDocument.fromText("Your content here");
96
-
97
- // Split into chunks with metadata extraction
98
- const chunks = await doc.chunk({
99
- strategy: "markdown",
100
- headers: [
101
- ["#", "title"],
102
- ["##", "section"],
103
- ],
104
- extract: {
105
- summary: true, // Extract summaries with default settings
106
- keywords: true, // Extract keywords with default settings
107
- },
108
- });
109
-
110
- // Get processed chunks
111
- const docs = doc.getDocs();
112
- const texts = doc.getText();
113
- const metadata = doc.getMetadata();
114
- ```
@@ -1,92 +0,0 @@
1
- # Embed
2
-
3
- Mastra uses the AI SDK's `embed` and `embedMany` functions to generate vector embeddings for text inputs, enabling similarity search and RAG workflows.
4
-
5
- ## Single Embedding
6
-
7
- The `embed` function generates a vector embedding for a single text input:
8
-
9
- ```typescript
10
- import { embed } from "ai";
11
- import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
12
-
13
- const result = await embed({
14
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
15
- value: "Your text to embed",
16
- maxRetries: 2, // optional, defaults to 2
17
- });
18
- ```
19
-
20
- ### Parameters
21
-
22
- **model:** (`EmbeddingModel`): The embedding model to use (e.g. openai.embedding('text-embedding-3-small'))
23
-
24
- **value:** (`string | Record<string, any>`): The text content or object to embed
25
-
26
- **maxRetries?:** (`number`): Maximum number of retries per embedding call. Set to 0 to disable retries. (Default: `2`)
27
-
28
- **abortSignal?:** (`AbortSignal`): Optional abort signal to cancel the request
29
-
30
- **headers?:** (`Record<string, string>`): Additional HTTP headers for the request (only for HTTP-based providers)
31
-
32
- ### Return Value
33
-
34
- **embedding:** (`number[]`): The embedding vector for the input
35
-
36
- ## Multiple Embeddings
37
-
38
- For embedding multiple texts at once, use the `embedMany` function:
39
-
40
- ```typescript
41
- import { embedMany } from "ai";
42
-
43
- const result = await embedMany({
44
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
45
- values: ["First text", "Second text", "Third text"],
46
- maxRetries: 2, // optional, defaults to 2
47
- });
48
- ```
49
-
50
- ### Parameters
51
-
52
- **model:** (`EmbeddingModel`): The embedding model to use (e.g. openai.embedding('text-embedding-3-small'))
53
-
54
- **values:** (`string[] | Record<string, any>[]`): Array of text content or objects to embed
55
-
56
- **maxRetries?:** (`number`): Maximum number of retries per embedding call. Set to 0 to disable retries. (Default: `2`)
57
-
58
- **abortSignal?:** (`AbortSignal`): Optional abort signal to cancel the request
59
-
60
- **headers?:** (`Record<string, string>`): Additional HTTP headers for the request (only for HTTP-based providers)
61
-
62
- ### Return Value
63
-
64
- **embeddings:** (`number[][]`): Array of embedding vectors corresponding to the input values
65
-
66
- ## Example Usage
67
-
68
- ```typescript
69
- import { embed, embedMany } from "ai";
70
-
71
- // Single embedding
72
- const singleResult = await embed({
73
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
74
- value: "What is the meaning of life?",
75
- });
76
-
77
- // Multiple embeddings
78
- const multipleResult = await embedMany({
79
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
80
- values: [
81
- "First question about life",
82
- "Second question about universe",
83
- "Third question about everything",
84
- ],
85
- });
86
- ```
87
-
88
- For more detailed information about embeddings in the Vercel AI SDK, see:
89
-
90
- - [AI SDK Embeddings Overview](https://sdk.vercel.ai/docs/ai-sdk-core/embeddings)
91
- - [embed()](https://sdk.vercel.ai/docs/reference/ai-sdk-core/embed)
92
- - [embedMany()](https://sdk.vercel.ai/docs/reference/ai-sdk-core/embed-many)
@@ -1,168 +0,0 @@
1
- # ExtractParams
2
-
3
- ExtractParams configures metadata extraction from document chunks using LLM analysis.
4
-
5
- ## Example
6
-
7
- ```typescript
8
- import { MDocument } from "@mastra/rag";
9
-
10
- const doc = MDocument.fromText(text);
11
- const chunks = await doc.chunk({
12
- extract: {
13
- title: true, // Extract titles using default settings
14
- summary: true, // Generate summaries using default settings
15
- keywords: true, // Extract keywords using default settings
16
- },
17
- });
18
-
19
- // Example output:
20
- // chunks[0].metadata = {
21
- // documentTitle: "AI Systems Overview",
22
- // sectionSummary: "Overview of artificial intelligence concepts and applications",
23
- // excerptKeywords: "KEYWORDS: AI, machine learning, algorithms"
24
- // }
25
- ```
26
-
27
- ## Parameters
28
-
29
- The `extract` parameter accepts the following fields:
30
-
31
- **title?:** (`boolean | TitleExtractorsArgs`): Enable title extraction. Set to true for default settings, or provide custom configuration.
32
-
33
- **summary?:** (`boolean | SummaryExtractArgs`): Enable summary extraction. Set to true for default settings, or provide custom configuration.
34
-
35
- **questions?:** (`boolean | QuestionAnswerExtractArgs`): Enable question generation. Set to true for default settings, or provide custom configuration.
36
-
37
- **keywords?:** (`boolean | KeywordExtractArgs`): Enable keyword extraction. Set to true for default settings, or provide custom configuration.
38
-
39
- **schema?:** (`SchemaExtractArgs`): Enable structured metadata extraction using a Zod schema.
40
-
41
- ## Extractor Arguments
42
-
43
- ### TitleExtractorsArgs
44
-
45
- **llm?:** (`MastraLanguageModel`): AI SDK language model to use for title extraction
46
-
47
- **nodes?:** (`number`): Number of title nodes to extract
48
-
49
- **nodeTemplate?:** (`string`): Custom prompt template for title node extraction. Must include {context} placeholder
50
-
51
- **combineTemplate?:** (`string`): Custom prompt template for combining titles. Must include {context} placeholder
52
-
53
- ### SummaryExtractArgs
54
-
55
- **llm?:** (`MastraLanguageModel`): AI SDK language model to use for summary extraction
56
-
57
- **summaries?:** (`('self' | 'prev' | 'next')[]`): List of summary types to generate. Can only include 'self' (current chunk), 'prev' (previous chunk), or 'next' (next chunk)
58
-
59
- **promptTemplate?:** (`string`): Custom prompt template for summary generation. Must include {context} placeholder
60
-
61
- ### QuestionAnswerExtractArgs
62
-
63
- **llm?:** (`MastraLanguageModel`): AI SDK language model to use for question generation
64
-
65
- **questions?:** (`number`): Number of questions to generate
66
-
67
- **promptTemplate?:** (`string`): Custom prompt template for question generation. Must include both {context} and {numQuestions} placeholders
68
-
69
- **embeddingOnly?:** (`boolean`): If true, only generate embeddings without actual questions
70
-
71
- ### KeywordExtractArgs
72
-
73
- **llm?:** (`MastraLanguageModel`): AI SDK language model to use for keyword extraction
74
-
75
- **keywords?:** (`number`): Number of keywords to extract
76
-
77
- **promptTemplate?:** (`string`): Custom prompt template for keyword extraction. Must include both {context} and {maxKeywords} placeholders
78
-
79
- ### SchemaExtractArgs
80
-
81
- **schema:** (`ZodType`): Zod schema defining the structure of the data to extract.
82
-
83
- **llm?:** (`MastraLanguageModel`): AI SDK language model to use for extraction.
84
-
85
- **instructions?:** (`string`): Instructions for the LLM on what to extract.
86
-
87
- **metadataKey?:** (`string`): Key to nest extraction results under. If omitted, results are spread into the metadata object.
88
-
89
- ## Advanced Example
90
-
91
- ```typescript
92
- import { MDocument } from "@mastra/rag";
93
-
94
- const doc = MDocument.fromText(text);
95
- const chunks = await doc.chunk({
96
- extract: {
97
- // Title extraction with custom settings
98
- title: {
99
- nodes: 2, // Extract 2 title nodes
100
- nodeTemplate: "Generate a title for this: {context}",
101
- combineTemplate: "Combine these titles: {context}",
102
- },
103
-
104
- // Summary extraction with custom settings
105
- summary: {
106
- summaries: ["self"], // Generate summaries for current chunk
107
- promptTemplate: "Summarize this: {context}",
108
- },
109
-
110
- // Question generation with custom settings
111
- questions: {
112
- questions: 3, // Generate 3 questions
113
- promptTemplate: "Generate {numQuestions} questions about: {context}",
114
- embeddingOnly: false,
115
- },
116
-
117
- // Keyword extraction with custom settings
118
- keywords: {
119
- keywords: 5, // Extract 5 keywords
120
- promptTemplate: "Extract {maxKeywords} key terms from: {context}",
121
- },
122
-
123
- // Schema extraction with Zod
124
- schema: {
125
- schema: z.object({
126
- productName: z.string(),
127
- category: z.enum(["electronics", "clothing"]),
128
- }),
129
- instructions: "Extract product information.",
130
- metadataKey: "product",
131
- },
132
- },
133
- });
134
-
135
- // Example output:
136
- // chunks[0].metadata = {
137
- // documentTitle: "AI in Modern Computing",
138
- // sectionSummary: "Overview of AI concepts and their applications in computing",
139
- // questionsThisExcerptCanAnswer: "1. What is machine learning?\n2. How do neural networks work?",
140
- // excerptKeywords: "1. Machine learning\n2. Neural networks\n3. Training data",
141
- // product: {
142
- // productName: "Neural Net 2000",
143
- // category: "electronics"
144
- // }
145
- // }
146
- ```
147
-
148
- ## Document Grouping for Title Extraction
149
-
150
- When using the `TitleExtractor`, you can group multiple chunks together for title extraction by specifying a shared `docId` in the `metadata` field of each chunk. All chunks with the same `docId` will receive the same extracted title. If no `docId` is set, each chunk is treated as its own document for title extraction.
151
-
152
- **Example:**
153
-
154
- ```ts
155
- import { MDocument } from "@mastra/rag";
156
-
157
- const doc = new MDocument({
158
- docs: [
159
- { text: "chunk 1", metadata: { docId: "docA" } },
160
- { text: "chunk 2", metadata: { docId: "docA" } },
161
- { text: "chunk 3", metadata: { docId: "docB" } },
162
- ],
163
- type: "text",
164
- });
165
-
166
- await doc.extractMetadata({ title: true });
167
- // The first two chunks will share a title, while the third chunk will be assigned a separate title.
168
- ```
@@ -1,111 +0,0 @@
1
- # GraphRAG
2
-
3
- The `GraphRAG` class implements a graph-based approach to retrieval augmented generation. It creates a knowledge graph from document chunks where nodes represent documents and edges represent semantic relationships, enabling both direct similarity matching and discovery of related content through graph traversal.
4
-
5
- ## Basic Usage
6
-
7
- ```typescript
8
- import { GraphRAG } from "@mastra/rag";
9
-
10
- const graphRag = new GraphRAG({
11
- dimension: 1536,
12
- threshold: 0.7,
13
- });
14
-
15
- // Create the graph from chunks and embeddings
16
- graphRag.createGraph(documentChunks, embeddings);
17
-
18
- // Query the graph with embedding
19
- const results = await graphRag.query({
20
- query: queryEmbedding,
21
- topK: 10,
22
- randomWalkSteps: 100,
23
- restartProb: 0.15,
24
- });
25
- ```
26
-
27
- ## Constructor Parameters
28
-
29
- **dimension?:** (`number`): Dimension of the embedding vectors (Default: `1536`)
30
-
31
- **threshold?:** (`number`): Similarity threshold for creating edges between nodes (0-1) (Default: `0.7`)
32
-
33
- ## Methods
34
-
35
- ### createGraph
36
-
37
- Creates a knowledge graph from document chunks and their embeddings.
38
-
39
- ```typescript
40
- createGraph(chunks: GraphChunk[], embeddings: GraphEmbedding[]): void
41
- ```
42
-
43
- #### Parameters
44
-
45
- **chunks:** (`GraphChunk[]`): Array of document chunks with text and metadata
46
-
47
- **embeddings:** (`GraphEmbedding[]`): Array of embeddings corresponding to chunks
48
-
49
- ### query
50
-
51
- Performs a graph-based search combining vector similarity and graph traversal.
52
-
53
- ```typescript
54
- query({
55
- query,
56
- topK = 10,
57
- randomWalkSteps = 100,
58
- restartProb = 0.15
59
- }: {
60
- query: number[];
61
- topK?: number;
62
- randomWalkSteps?: number;
63
- restartProb?: number;
64
- }): RankedNode[]
65
- ```
66
-
67
- #### Parameters
68
-
69
- **query:** (`number[]`): Query embedding vector
70
-
71
- **topK?:** (`number`): Number of results to return (Default: `10`)
72
-
73
- **randomWalkSteps?:** (`number`): Number of steps in random walk (Default: `100`)
74
-
75
- **restartProb?:** (`number`): Probability of restarting walk from query node (Default: `0.15`)
76
-
77
- #### Returns
78
-
79
- Returns an array of `RankedNode` objects, where each node contains:
80
-
81
- **id:** (`string`): Unique identifier for the node
82
-
83
- **content:** (`string`): Text content of the document chunk
84
-
85
- **metadata:** (`Record<string, any>`): Additional metadata associated with the chunk
86
-
87
- **score:** (`number`): Combined relevance score from graph traversal
88
-
89
- ## Advanced Example
90
-
91
- ```typescript
92
- const graphRag = new GraphRAG({
93
- dimension: 1536,
94
- threshold: 0.8, // Stricter similarity threshold
95
- });
96
-
97
- // Create graph from chunks and embeddings
98
- graphRag.createGraph(documentChunks, embeddings);
99
-
100
- // Query with custom parameters
101
- const results = await graphRag.query({
102
- query: queryEmbedding,
103
- topK: 5,
104
- randomWalkSteps: 200,
105
- restartProb: 0.2,
106
- });
107
- ```
108
-
109
- ## Related
110
-
111
- - [createGraphRAGTool](https://mastra.ai/reference/tools/graph-rag-tool)
@@ -1,216 +0,0 @@
1
- # Metadata Filters
2
-
3
- Mastra provides a unified metadata filtering syntax across all vector stores, based on MongoDB/Sift query syntax. Each vector store translates these filters into their native format.
4
-
5
- ## Basic Example
6
-
7
- ```typescript
8
- import { PgVector } from "@mastra/pg";
9
-
10
- const store = new PgVector({
11
- id: 'pg-vector',
12
- connectionString
13
- });
14
-
15
- const results = await store.query({
16
- indexName: "my_index",
17
- queryVector: queryVector,
18
- topK: 10,
19
- filter: {
20
- category: "electronics", // Simple equality
21
- price: { $gt: 100 }, // Numeric comparison
22
- tags: { $in: ["sale", "new"] }, // Array membership
23
- },
24
- });
25
- ```
26
-
27
- ## Supported Operators
28
-
29
- ### Basic Comparison
30
-
31
- `$eq`Matches values equal to specified value{ age: { $eq: 25 } }Supported by: All except Couchbase`$ne`Matches values not equal{ status: { $ne: 'inactive' } }Supported by: All except Couchbase`$gt`Greater than{ price: { $gt: 100 } }Supported by: All except Couchbase`$gte`Greater than or equal{ rating: { $gte: 4.5 } }Supported by: All except Couchbase`$lt`Less than{ stock: { $lt: 20 } }Supported by: All except Couchbase`$lte`Less than or equal{ priority: { $lte: 3 } }Supported by: All except Couchbase
32
-
33
- ### Array Operators
34
-
35
- `$in`Matches any value in array{ category: { $in: \["A", "B"] } }Supported by: All except Couchbase`$nin`Matches none of the values{ status: { $nin: \["deleted", "archived"] } }Supported by: All except Couchbase`$all`Matches arrays containing all elements{ tags: { $all: \["urgent", "high"] } }Supported by: Astra, Pinecone, Upstash, MongoDB`$elemMatch`Matches array elements meeting criteria{ scores: { $elemMatch: { $gt: 80 } } }Supported by: libSQL, PgVector, MongoDB
36
-
37
- ### Logical Operators
38
-
39
- `$and`Logical AND{ $and: \[{ price: { $gt: 100 } }, { stock: { $gt: 0 } }] }Supported by: All except Vectorize, Couchbase`$or`Logical OR{ $or: \[{ status: "active" }, { priority: "high" }] }Supported by: All except Vectorize, Couchbase`$not`Logical NOT{ price: { $not: { $lt: 100 } } }Supported by: Astra, Qdrant, Upstash, PgVector, libSQL, MongoDB`$nor`Logical NOR{ $nor: \[{ status: "deleted" }, { archived: true }] }Supported by: Qdrant, Upstash, PgVector, libSQL, MongoDB
40
-
41
- ### Element Operators
42
-
43
- `$exists`Matches documents with field{ rating: { $exists: true } }Supported by: All except Vectorize, Chroma, Couchbase
44
-
45
- ### Custom Operators
46
-
47
- `$contains`Text contains substring{ description: { $contains: "sale" } }Supported by: Upstash, libSQL, PgVector`$regex`Regular expression match{ name: { $regex: "^test" } }Supported by: Qdrant, PgVector, Upstash, MongoDB`$size`Array length check{ tags: { $size: { $gt: 2 } } }Supported by: Astra, libSQL, PgVector, MongoDB`$geo`Geospatial query{ location: { $geo: { type: "radius", ... } } }Supported by: Qdrant`$datetime`Datetime range query{ created: { $datetime: { range: { gt: "2024-01-01" } } } }Supported by: Qdrant`$hasId`Vector ID existence check{ $hasId: \["id1", "id2"] }Supported by: Qdrant`$hasVector`Vector existence check{ $hasVector: true }Supported by: Qdrant
48
-
49
- ## Common Rules and Restrictions
50
-
51
- 1. Field names cannot:
52
-
53
- - Contain dots (.) unless referring to nested fields
54
- - Start with $ or contain null characters
55
- - Be empty strings
56
-
57
- 2. Values must be:
58
-
59
- - Valid JSON types (string, number, boolean, object, array)
60
- - Not undefined
61
- - Properly typed for the operator (e.g., numbers for numeric comparisons)
62
-
63
- 3. Logical operators:
64
-
65
- - Must contain valid conditions
66
- - Cannot be empty
67
- - Must be properly nested
68
- - Can only be used at top level or nested within other logical operators
69
- - Cannot be used at field level or nested inside a field
70
- - Cannot be used inside an operator
71
- - Valid: `{ "$and": [{ "field": { "$gt": 100 } }] }`
72
- - Valid: `{ "$or": [{ "$and": [{ "field": { "$gt": 100 } }] }] }`
73
- - Invalid: `{ "field": { "$and": [{ "$gt": 100 }] } }`
74
- - Invalid: `{ "field": { "$gt": { "$and": [{...}] } } }`
75
-
76
- 4. $not operator:
77
-
78
- - Must be an object
79
- - Cannot be empty
80
- - Can be used at field level or top level
81
- - Valid: `{ "$not": { "field": "value" } }`
82
- - Valid: `{ "field": { "$not": { "$eq": "value" } } }`
83
-
84
- 5. Operator nesting:
85
-
86
- - Logical operators must contain field conditions, not direct operators
87
- - Valid: `{ "$and": [{ "field": { "$gt": 100 } }] }`
88
- - Invalid: `{ "$and": [{ "$gt": 100 }] }`
89
-
90
- ## Store-Specific Notes
91
-
92
- ### Astra
93
-
94
- - Nested field queries are supported using dot notation
95
- - Array fields must be explicitly defined as arrays in the metadata
96
- - Metadata values are case-sensitive
97
-
98
- ### ChromaDB
99
-
100
- - Where filters only return results where the filtered field exists in metadata
101
- - Empty metadata fields are not included in filter results
102
- - Metadata fields must be present for negative matches (e.g., $ne won't match documents missing the field)
103
-
104
- ### Cloudflare Vectorize
105
-
106
- - Requires explicit metadata indexing before filtering can be used
107
- - Use `createMetadataIndex()` to index fields you want to filter on
108
- - Up to 10 metadata indexes per Vectorize index
109
- - String values are indexed up to first 64 bytes (truncated on UTF-8 boundaries)
110
- - Number values use float64 precision
111
- - Filter JSON must be under 2048 bytes
112
- - Field names cannot contain dots (.) or start with $
113
- - Field names limited to 512 characters
114
- - Vectors must be re-upserted after creating new metadata indexes to be included in filtered results
115
- - Range queries may have reduced accuracy with very large datasets (\~10M+ vectors)
116
-
117
- ### libSQL
118
-
119
- - Supports nested object queries with dot notation
120
- - Array fields are validated to ensure they contain valid JSON arrays
121
- - Numeric comparisons maintain proper type handling
122
- - Empty arrays in conditions are handled gracefully
123
- - Metadata is stored in a JSONB column for efficient querying
124
-
125
- ### PgVector
126
-
127
- - Full support for PostgreSQL's native JSON querying capabilities
128
- - Efficient handling of array operations using native array functions
129
- - Proper type handling for numbers, strings, and booleans
130
- - Nested field queries use PostgreSQL's JSON path syntax internally
131
- - Metadata is stored in a JSONB column for efficient indexing
132
-
133
- ### Pinecone
134
-
135
- - Metadata field names are limited to 512 characters
136
- - Numeric values must be within the range of ±1e38
137
- - Arrays in metadata are limited to 64KB total size
138
- - Nested objects are flattened with dot notation
139
- - Metadata updates replace the entire metadata object
140
-
141
- ### Qdrant
142
-
143
- - Supports advanced filtering with nested conditions
144
- - Payload (metadata) fields must be explicitly indexed for filtering
145
- - Use `createPayloadIndex()` to index fields you want to filter on:
146
-
147
- ```typescript
148
- // Index a field before filtering on it
149
- await store.createPayloadIndex({
150
- indexName: "my_index",
151
- fieldName: "source",
152
- fieldSchema: "keyword", // 'keyword' | 'integer' | 'float' | 'geo' | 'text' | 'bool' | 'datetime' | 'uuid'
153
- });
154
-
155
- // Now filtering works
156
- const results = await store.query({
157
- indexName: "my_index",
158
- queryVector: queryVector,
159
- filter: { source: "document-a" },
160
- });
161
- ```
162
-
163
- - Efficient handling of geo-spatial queries
164
- - Special handling for null and empty values
165
- - Vector-specific filtering capabilities
166
- - Datetime values must be in RFC 3339 format
167
-
168
- ### Upstash
169
-
170
- - 512-character limit for metadata field keys
171
- - Query size is limited (avoid large IN clauses)
172
- - No support for null/undefined values in filters
173
- - Translates to SQL-like syntax internally
174
- - Case-sensitive string comparisons
175
- - Metadata updates are atomic
176
-
177
- ### MongoDB
178
-
179
- - Full support for MongoDB/Sift query syntax for metadata filters
180
- - Supports all standard comparison, array, logical, and element operators
181
- - Supports nested fields and arrays in metadata
182
- - Filtering can be applied to both `metadata` and the original document content using the `filter` and `documentFilter` options, respectively
183
- - `filter` applies to the metadata object; `documentFilter` applies to the original document fields
184
- - No artificial limits on filter size or complexity (subject to MongoDB query limits)
185
- - Indexing metadata fields is recommended for optimal performance
186
-
187
- ### Couchbase
188
-
189
- - Currently does not have support for metadata filters. Filtering must be done client-side after retrieving results or by using the Couchbase SDK's Search capabilities directly for more complex queries.
190
-
191
- ### Amazon S3 Vectors
192
-
193
- - Equality values must be primitives (string/number/boolean). `null`/`undefined`, arrays, objects, and Date are not allowed for equality. Range operators accept numbers or Date (Dates are normalized to epoch ms).
194
- - `$in`/`$nin` require **non-empty arrays of primitives**; Date elements are allowed and normalized to epoch ms. **Array equality** is not supported.
195
- - Implicit AND is canonicalized (`{a:1,b:2}` → `{$and:[{a:1},{b:2}]}`). Logical operators must contain field conditions, use non-empty arrays, and appear only at the root or within other logical operators (not inside field values).
196
- - Keys listed in `nonFilterableMetadataKeys` at index creation are stored but not filterable; this setting is immutable.
197
- - $exists requires a boolean value.
198
- - undefined/null/empty filters are treated as no filter.
199
- - Each metadata key name limited to 63 characters.
200
- - Total metadata per vector: Up to 40 KB (filterable + non-filterable)
201
- - Total metadata keys per vector: Up to 10
202
- - Filterable metadata per vector: Up to 2 KB
203
- - Non-filterable metadata keys per vector index: Up to 10
204
-
205
- ## Related
206
-
207
- - [Astra](https://mastra.ai/reference/vectors/astra)
208
- - [Chroma](https://mastra.ai/reference/vectors/chroma)
209
- - [Cloudflare Vectorize](https://mastra.ai/reference/vectors/vectorize)
210
- - [libSQL](https://mastra.ai/reference/vectors/libsql)
211
- - [MongoDB](https://mastra.ai/reference/vectors/mongodb)
212
- - [PgStore](https://mastra.ai/reference/vectors/pg)
213
- - [Pinecone](https://mastra.ai/reference/vectors/pinecone)
214
- - [Qdrant](https://mastra.ai/reference/vectors/qdrant)
215
- - [Upstash](https://mastra.ai/reference/vectors/upstash)
216
- - [Amazon S3 Vectors](https://mastra.ai/reference/vectors/s3vectors)