@mastra/mcp-docs-server 1.1.7 → 1.1.8

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 (276) hide show
  1. package/.docs/docs/agents/agent-approval.md +61 -31
  2. package/.docs/docs/agents/supervisor-agents.md +1 -1
  3. package/.docs/docs/getting-started/manual-install.md +1 -1
  4. package/.docs/docs/index.md +68 -24
  5. package/.docs/docs/mastra-cloud/setup.md +1 -1
  6. package/.docs/docs/memory/observational-memory.md +9 -0
  7. package/.docs/docs/memory/semantic-recall.md +17 -1
  8. package/.docs/docs/workspace/skills.md +7 -5
  9. package/.docs/guides/deployment/aws-lambda.md +76 -165
  10. package/.docs/guides/deployment/azure-app-services.md +38 -61
  11. package/.docs/guides/deployment/cloudflare.md +1 -1
  12. package/.docs/guides/deployment/netlify.md +1 -1
  13. package/.docs/guides/deployment/vercel.md +1 -1
  14. package/.docs/models/gateways/netlify.md +5 -1
  15. package/.docs/models/index.md +1 -1
  16. package/.docs/models/providers/anthropic.md +9 -9
  17. package/.docs/models/providers/deepseek.md +1 -1
  18. package/.docs/models/providers/google.md +11 -11
  19. package/.docs/models/providers/openai.md +19 -19
  20. package/.docs/models/providers/opencode.md +33 -33
  21. package/.docs/models/providers/xai.md +3 -3
  22. package/.docs/reference/agents/agent.md +20 -20
  23. package/.docs/reference/agents/generate.md +200 -66
  24. package/.docs/reference/agents/generateLegacy.md +77 -35
  25. package/.docs/reference/agents/getDefaultGenerateOptions.md +4 -6
  26. package/.docs/reference/agents/getDefaultOptions.md +4 -6
  27. package/.docs/reference/agents/getDefaultStreamOptions.md +4 -6
  28. package/.docs/reference/agents/getDescription.md +1 -1
  29. package/.docs/reference/agents/getInstructions.md +4 -6
  30. package/.docs/reference/agents/getLLM.md +6 -8
  31. package/.docs/reference/agents/getMemory.md +4 -6
  32. package/.docs/reference/agents/getModel.md +4 -6
  33. package/.docs/reference/agents/getTools.md +5 -7
  34. package/.docs/reference/agents/getVoice.md +4 -6
  35. package/.docs/reference/agents/listAgents.md +4 -6
  36. package/.docs/reference/agents/listScorers.md +4 -6
  37. package/.docs/reference/agents/listTools.md +4 -6
  38. package/.docs/reference/agents/listWorkflows.md +4 -6
  39. package/.docs/reference/agents/network.md +69 -23
  40. package/.docs/reference/ai-sdk/chat-route.md +7 -7
  41. package/.docs/reference/ai-sdk/handle-chat-stream.md +12 -12
  42. package/.docs/reference/ai-sdk/handle-network-stream.md +4 -4
  43. package/.docs/reference/ai-sdk/handle-workflow-stream.md +11 -11
  44. package/.docs/reference/ai-sdk/network-route.md +3 -3
  45. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +9 -9
  46. package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md +9 -9
  47. package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md +5 -5
  48. package/.docs/reference/ai-sdk/with-mastra.md +12 -12
  49. package/.docs/reference/ai-sdk/workflow-route.md +3 -3
  50. package/.docs/reference/auth/auth0.md +6 -6
  51. package/.docs/reference/auth/better-auth.md +5 -5
  52. package/.docs/reference/auth/clerk.md +5 -5
  53. package/.docs/reference/auth/firebase.md +7 -7
  54. package/.docs/reference/auth/jwt.md +1 -1
  55. package/.docs/reference/auth/supabase.md +4 -4
  56. package/.docs/reference/auth/workos.md +6 -6
  57. package/.docs/reference/cli/create-mastra.md +14 -14
  58. package/.docs/reference/client-js/mastra-client.md +23 -23
  59. package/.docs/reference/client-js/workflows.md +3 -3
  60. package/.docs/reference/core/addGateway.md +2 -2
  61. package/.docs/reference/core/getAgent.md +2 -2
  62. package/.docs/reference/core/getAgentById.md +2 -2
  63. package/.docs/reference/core/getDeployer.md +1 -1
  64. package/.docs/reference/core/getGateway.md +2 -2
  65. package/.docs/reference/core/getGatewayById.md +2 -2
  66. package/.docs/reference/core/getLogger.md +1 -1
  67. package/.docs/reference/core/getMCPServer.md +2 -2
  68. package/.docs/reference/core/getMCPServerById.md +3 -3
  69. package/.docs/reference/core/getMemory.md +2 -2
  70. package/.docs/reference/core/getScorer.md +2 -2
  71. package/.docs/reference/core/getScorerById.md +2 -2
  72. package/.docs/reference/core/getServer.md +1 -1
  73. package/.docs/reference/core/getStorage.md +1 -1
  74. package/.docs/reference/core/getStoredAgentById.md +18 -20
  75. package/.docs/reference/core/getTelemetry.md +1 -1
  76. package/.docs/reference/core/getVector.md +2 -2
  77. package/.docs/reference/core/getWorkflow.md +3 -3
  78. package/.docs/reference/core/listAgents.md +1 -1
  79. package/.docs/reference/core/listGateways.md +1 -1
  80. package/.docs/reference/core/listLogs.md +9 -11
  81. package/.docs/reference/core/listLogsByRunId.md +9 -9
  82. package/.docs/reference/core/listMCPServers.md +1 -1
  83. package/.docs/reference/core/listMemory.md +1 -1
  84. package/.docs/reference/core/listScorers.md +1 -1
  85. package/.docs/reference/core/listStoredAgents.md +9 -11
  86. package/.docs/reference/core/listVectors.md +1 -1
  87. package/.docs/reference/core/listWorkflows.md +2 -2
  88. package/.docs/reference/core/mastra-class.md +17 -17
  89. package/.docs/reference/core/mastra-model-gateway.md +15 -15
  90. package/.docs/reference/core/setLogger.md +2 -4
  91. package/.docs/reference/core/setStorage.md +1 -1
  92. package/.docs/reference/datasets/addItem.md +20 -4
  93. package/.docs/reference/datasets/addItems.md +8 -2
  94. package/.docs/reference/datasets/compareExperiments.md +15 -3
  95. package/.docs/reference/datasets/create.md +6 -6
  96. package/.docs/reference/datasets/dataset.md +1 -1
  97. package/.docs/reference/datasets/delete.md +2 -2
  98. package/.docs/reference/datasets/deleteExperiment.md +2 -2
  99. package/.docs/reference/datasets/deleteItem.md +2 -2
  100. package/.docs/reference/datasets/deleteItems.md +2 -2
  101. package/.docs/reference/datasets/get.md +2 -2
  102. package/.docs/reference/datasets/getDetails.md +9 -9
  103. package/.docs/reference/datasets/getExperiment.md +2 -2
  104. package/.docs/reference/datasets/getItem.md +3 -3
  105. package/.docs/reference/datasets/getItemHistory.md +22 -2
  106. package/.docs/reference/datasets/list.md +7 -3
  107. package/.docs/reference/datasets/listExperimentResults.md +34 -4
  108. package/.docs/reference/datasets/listExperiments.md +41 -3
  109. package/.docs/reference/datasets/listItems.md +18 -6
  110. package/.docs/reference/datasets/listVersions.md +23 -3
  111. package/.docs/reference/datasets/startExperiment.md +62 -12
  112. package/.docs/reference/datasets/startExperimentAsync.md +5 -1
  113. package/.docs/reference/datasets/update.md +6 -6
  114. package/.docs/reference/datasets/updateItem.md +5 -5
  115. package/.docs/reference/deployer.md +8 -8
  116. package/.docs/reference/evals/answer-relevancy.md +11 -11
  117. package/.docs/reference/evals/answer-similarity.md +17 -19
  118. package/.docs/reference/evals/bias.md +10 -10
  119. package/.docs/reference/evals/completeness.md +3 -3
  120. package/.docs/reference/evals/content-similarity.md +6 -6
  121. package/.docs/reference/evals/context-precision.md +4 -4
  122. package/.docs/reference/evals/context-relevance.md +4 -4
  123. package/.docs/reference/evals/create-scorer.md +47 -49
  124. package/.docs/reference/evals/faithfulness.md +11 -11
  125. package/.docs/reference/evals/hallucination.md +17 -21
  126. package/.docs/reference/evals/keyword-coverage.md +4 -4
  127. package/.docs/reference/evals/mastra-scorer.md +14 -14
  128. package/.docs/reference/evals/noise-sensitivity.md +4 -4
  129. package/.docs/reference/evals/prompt-alignment.md +4 -4
  130. package/.docs/reference/evals/run-evals.md +16 -16
  131. package/.docs/reference/evals/scorer-utils.md +3 -3
  132. package/.docs/reference/evals/textual-difference.md +3 -3
  133. package/.docs/reference/evals/tone-consistency.md +3 -3
  134. package/.docs/reference/evals/tool-call-accuracy.md +5 -5
  135. package/.docs/reference/evals/toxicity.md +8 -8
  136. package/.docs/reference/harness/harness-class.md +34 -42
  137. package/.docs/reference/logging/pino-logger.md +5 -5
  138. package/.docs/reference/memory/clone-utilities.md +5 -5
  139. package/.docs/reference/memory/cloneThread.md +17 -21
  140. package/.docs/reference/memory/createThread.md +10 -10
  141. package/.docs/reference/memory/deleteMessages.md +2 -2
  142. package/.docs/reference/memory/getThreadById.md +2 -2
  143. package/.docs/reference/memory/listThreads.md +5 -5
  144. package/.docs/reference/memory/memory-class.md +12 -14
  145. package/.docs/reference/memory/observational-memory.md +102 -94
  146. package/.docs/reference/memory/recall.md +14 -16
  147. package/.docs/reference/observability/tracing/configuration.md +27 -10
  148. package/.docs/reference/observability/tracing/exporters/console-exporter.md +4 -7
  149. package/.docs/reference/processors/batch-parts-processor.md +8 -10
  150. package/.docs/reference/processors/language-detector.md +14 -16
  151. package/.docs/reference/processors/message-history-processor.md +7 -9
  152. package/.docs/reference/processors/moderation-processor.md +13 -15
  153. package/.docs/reference/processors/pii-detector.md +14 -16
  154. package/.docs/reference/processors/processor-interface.md +62 -62
  155. package/.docs/reference/processors/prompt-injection-detector.md +11 -13
  156. package/.docs/reference/processors/semantic-recall-processor.md +14 -16
  157. package/.docs/reference/processors/system-prompt-scrubber.md +12 -14
  158. package/.docs/reference/processors/token-limiter-processor.md +11 -13
  159. package/.docs/reference/processors/tool-call-filter.md +5 -7
  160. package/.docs/reference/processors/tool-search-processor.md +9 -11
  161. package/.docs/reference/processors/unicode-normalizer.md +8 -10
  162. package/.docs/reference/processors/working-memory-processor.md +14 -18
  163. package/.docs/reference/rag/chunk.md +38 -38
  164. package/.docs/reference/rag/database-config.md +11 -7
  165. package/.docs/reference/rag/document.md +2 -2
  166. package/.docs/reference/rag/embeddings.md +12 -12
  167. package/.docs/reference/rag/extract-params.md +23 -23
  168. package/.docs/reference/rag/graph-rag.md +12 -12
  169. package/.docs/reference/rag/rerank.md +25 -17
  170. package/.docs/reference/rag/rerankWithScorer.md +25 -17
  171. package/.docs/reference/server/create-route.md +14 -14
  172. package/.docs/reference/server/express-adapter.md +10 -10
  173. package/.docs/reference/server/fastify-adapter.md +10 -10
  174. package/.docs/reference/server/hono-adapter.md +10 -10
  175. package/.docs/reference/server/koa-adapter.md +10 -10
  176. package/.docs/reference/server/mastra-server.md +10 -10
  177. package/.docs/reference/server/register-api-route.md +13 -13
  178. package/.docs/reference/storage/cloudflare-d1.md +5 -5
  179. package/.docs/reference/storage/cloudflare.md +6 -6
  180. package/.docs/reference/storage/composite.md +9 -9
  181. package/.docs/reference/storage/convex.md +3 -3
  182. package/.docs/reference/storage/dynamodb.md +9 -9
  183. package/.docs/reference/storage/lance.md +3 -3
  184. package/.docs/reference/storage/libsql.md +2 -2
  185. package/.docs/reference/storage/mongodb.md +5 -5
  186. package/.docs/reference/storage/mssql.md +2 -2
  187. package/.docs/reference/storage/postgresql.md +25 -25
  188. package/.docs/reference/storage/upstash.md +3 -3
  189. package/.docs/reference/streaming/ChunkType.md +251 -59
  190. package/.docs/reference/streaming/agents/MastraModelOutput.md +86 -16
  191. package/.docs/reference/streaming/agents/stream.md +155 -43
  192. package/.docs/reference/streaming/agents/streamLegacy.md +79 -39
  193. package/.docs/reference/streaming/workflows/resumeStream.md +18 -8
  194. package/.docs/reference/streaming/workflows/stream.md +21 -9
  195. package/.docs/reference/streaming/workflows/timeTravelStream.md +4 -4
  196. package/.docs/reference/tools/create-tool.md +25 -21
  197. package/.docs/reference/tools/document-chunker-tool.md +7 -7
  198. package/.docs/reference/tools/graph-rag-tool.md +16 -18
  199. package/.docs/reference/tools/mcp-client.md +38 -27
  200. package/.docs/reference/tools/mcp-server.md +45 -45
  201. package/.docs/reference/tools/vector-query-tool.md +34 -22
  202. package/.docs/reference/vectors/astra.md +22 -22
  203. package/.docs/reference/vectors/chroma.md +44 -44
  204. package/.docs/reference/vectors/convex.md +26 -26
  205. package/.docs/reference/vectors/couchbase.md +30 -30
  206. package/.docs/reference/vectors/duckdb.md +29 -29
  207. package/.docs/reference/vectors/elasticsearch.md +27 -27
  208. package/.docs/reference/vectors/lance.md +46 -38
  209. package/.docs/reference/vectors/libsql.md +31 -31
  210. package/.docs/reference/vectors/mongodb.md +32 -32
  211. package/.docs/reference/vectors/opensearch.md +27 -27
  212. package/.docs/reference/vectors/pg.md +60 -44
  213. package/.docs/reference/vectors/pinecone.md +38 -38
  214. package/.docs/reference/vectors/qdrant.md +36 -36
  215. package/.docs/reference/vectors/s3vectors.md +24 -24
  216. package/.docs/reference/vectors/turbopuffer.md +29 -29
  217. package/.docs/reference/vectors/upstash.md +25 -25
  218. package/.docs/reference/vectors/vectorize.md +27 -27
  219. package/.docs/reference/voice/azure.md +19 -15
  220. package/.docs/reference/voice/cloudflare.md +10 -12
  221. package/.docs/reference/voice/composite-voice.md +10 -10
  222. package/.docs/reference/voice/deepgram.md +20 -14
  223. package/.docs/reference/voice/elevenlabs.md +20 -22
  224. package/.docs/reference/voice/google-gemini-live.md +42 -44
  225. package/.docs/reference/voice/google.md +25 -21
  226. package/.docs/reference/voice/mastra-voice.md +20 -20
  227. package/.docs/reference/voice/murf.md +24 -28
  228. package/.docs/reference/voice/openai-realtime.md +26 -26
  229. package/.docs/reference/voice/openai.md +14 -12
  230. package/.docs/reference/voice/playai.md +13 -15
  231. package/.docs/reference/voice/sarvam.md +21 -25
  232. package/.docs/reference/voice/speechify.md +11 -13
  233. package/.docs/reference/voice/voice.addInstructions.md +1 -1
  234. package/.docs/reference/voice/voice.addTools.md +1 -1
  235. package/.docs/reference/voice/voice.answer.md +1 -1
  236. package/.docs/reference/voice/voice.connect.md +3 -3
  237. package/.docs/reference/voice/voice.events.md +11 -11
  238. package/.docs/reference/voice/voice.getSpeakers.md +30 -30
  239. package/.docs/reference/voice/voice.listen.md +9 -9
  240. package/.docs/reference/voice/voice.off.md +2 -2
  241. package/.docs/reference/voice/voice.on.md +2 -2
  242. package/.docs/reference/voice/voice.send.md +1 -1
  243. package/.docs/reference/voice/voice.speak.md +11 -11
  244. package/.docs/reference/voice/voice.updateConfig.md +3 -3
  245. package/.docs/reference/workflows/run-methods/cancel.md +2 -2
  246. package/.docs/reference/workflows/run-methods/restart.md +17 -5
  247. package/.docs/reference/workflows/run-methods/resume.md +23 -9
  248. package/.docs/reference/workflows/run-methods/start.md +22 -8
  249. package/.docs/reference/workflows/run-methods/startAsync.md +12 -6
  250. package/.docs/reference/workflows/run-methods/timeTravel.md +29 -13
  251. package/.docs/reference/workflows/run.md +12 -12
  252. package/.docs/reference/workflows/step.md +24 -26
  253. package/.docs/reference/workflows/workflow-methods/branch.md +2 -2
  254. package/.docs/reference/workflows/workflow-methods/commit.md +1 -1
  255. package/.docs/reference/workflows/workflow-methods/create-run.md +4 -4
  256. package/.docs/reference/workflows/workflow-methods/dountil.md +3 -3
  257. package/.docs/reference/workflows/workflow-methods/dowhile.md +3 -3
  258. package/.docs/reference/workflows/workflow-methods/foreach.md +9 -9
  259. package/.docs/reference/workflows/workflow-methods/map.md +2 -2
  260. package/.docs/reference/workflows/workflow-methods/parallel.md +2 -2
  261. package/.docs/reference/workflows/workflow-methods/sleep.md +2 -2
  262. package/.docs/reference/workflows/workflow-methods/sleepUntil.md +2 -2
  263. package/.docs/reference/workflows/workflow-methods/then.md +2 -2
  264. package/.docs/reference/workflows/workflow.md +40 -50
  265. package/.docs/reference/workspace/daytona-sandbox.md +33 -33
  266. package/.docs/reference/workspace/e2b-sandbox.md +20 -20
  267. package/.docs/reference/workspace/filesystem.md +22 -22
  268. package/.docs/reference/workspace/gcs-filesystem.md +15 -15
  269. package/.docs/reference/workspace/local-filesystem.md +35 -35
  270. package/.docs/reference/workspace/local-sandbox.md +26 -26
  271. package/.docs/reference/workspace/s3-filesystem.md +18 -18
  272. package/.docs/reference/workspace/sandbox.md +8 -8
  273. package/.docs/reference/workspace/workspace-class.md +30 -34
  274. package/CHANGELOG.md +16 -0
  275. package/package.json +6 -6
  276. package/.docs/docs/getting-started/start.md +0 -28
@@ -45,23 +45,23 @@ The first parameter is the Mastra stream to convert. It can be one of:
45
45
 
46
46
  The second parameter is an options object:
47
47
 
48
- **from:** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
48
+ **from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
49
49
 
50
- **lastMessageId?:** (`string`): (Agent only) The ID of the last message in the conversation.
50
+ **lastMessageId** (`string`): (Agent only) The ID of the last message in the conversation.
51
51
 
52
- **sendStart?:** (`boolean`): (Agent only) Whether to send start events in the stream. (Default: `true`)
52
+ **sendStart** (`boolean`): (Agent only) Whether to send start events in the stream. (Default: `true`)
53
53
 
54
- **sendFinish?:** (`boolean`): (Agent only) Whether to send finish events in the stream. (Default: `true`)
54
+ **sendFinish** (`boolean`): (Agent only) Whether to send finish events in the stream. (Default: `true`)
55
55
 
56
- **sendReasoning?:** (`boolean`): (Agent only) Whether to include reasoning-delta chunks in the stream. Set to true to stream reasoning content from models that support extended thinking. (Default: `false`)
56
+ **sendReasoning** (`boolean`): (Agent only) Whether to include reasoning-delta chunks in the stream. Set to true to stream reasoning content from models that support extended thinking. (Default: `false`)
57
57
 
58
- **sendSources?:** (`boolean`): (Agent only) Whether to include source citations in the output. (Default: `false`)
58
+ **sendSources** (`boolean`): (Agent only) Whether to include source citations in the output. (Default: `false`)
59
59
 
60
- **includeTextStreamParts?:** (`boolean`): (Workflow only) Whether to include text stream parts in the output. (Default: `true`)
60
+ **includeTextStreamParts** (`boolean`): (Workflow only) Whether to include text stream parts in the output. (Default: `true`)
61
61
 
62
- **messageMetadata?:** (`(options: { part: UIMessageStreamPart }) => Record<string, unknown> | undefined`): (Agent only) A function that receives the current stream part and returns metadata to attach to start and finish chunks.
62
+ **messageMetadata** (`(options: { part: UIMessageStreamPart }) => Record<string, unknown> | undefined`): (Agent only) A function that receives the current stream part and returns metadata to attach to start and finish chunks.
63
63
 
64
- **onError?:** (`(error: unknown) => string`): (Agent only) A function to handle errors during stream conversion. Receives the error and should return a string representation.
64
+ **onError** (`(error: unknown) => string`): (Agent only) A function to handle errors during stream conversion. Receives the error and should return a string representation.
65
65
 
66
66
  ## Examples
67
67
 
@@ -33,27 +33,27 @@ export default function Chat() {
33
33
 
34
34
  ## Parameters
35
35
 
36
- **messages:** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
36
+ **messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
37
37
 
38
38
  ## Returns
39
39
 
40
40
  Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
41
41
 
42
- **id:** (`string`): Unique message identifier.
42
+ **id** (`string`): Unique message identifier.
43
43
 
44
- **role:** (`'user' | 'assistant' | 'system'`): The role of the message sender.
44
+ **role** (`'user' | 'assistant' | 'system'`): The role of the message sender.
45
45
 
46
- **content:** (`string`): Text content of the message.
46
+ **content** (`string`): Text content of the message.
47
47
 
48
- **parts:** (`UIMessagePart[]`): Array of UI parts including text, tool-invocation, file, reasoning, source, and step markers.
48
+ **parts** (`UIMessagePart[]`): Array of UI parts including text, tool-invocation, file, reasoning, source, and step markers.
49
49
 
50
- **createdAt:** (`Date`): Message creation timestamp.
50
+ **createdAt** (`Date`): Message creation timestamp.
51
51
 
52
- **toolInvocations?:** (`ToolInvocation[]`): Array of tool invocations for assistant messages.
52
+ **toolInvocations** (`ToolInvocation[]`): Array of tool invocations for assistant messages.
53
53
 
54
- **experimental\_attachments?:** (`Attachment[]`): File attachments on the message.
54
+ **experimental\_attachments** (`Attachment[]`): File attachments on the message.
55
55
 
56
- **metadata?:** (`Record<string, unknown>`): Custom metadata attached to the message.
56
+ **metadata** (`Record<string, unknown>`): Custom metadata attached to the message.
57
57
 
58
58
  ## Examples
59
59
 
@@ -38,19 +38,19 @@ export default function Chat() {
38
38
 
39
39
  ## Parameters
40
40
 
41
- **messages:** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
41
+ **messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
42
42
 
43
43
  ## Returns
44
44
 
45
45
  Returns an array of AI SDK V5+ `UIMessage` objects with the following structure:
46
46
 
47
- **id:** (`string`): Unique message identifier.
47
+ **id** (`string`): Unique message identifier.
48
48
 
49
- **role:** (`'user' | 'assistant' | 'system'`): The role of the message sender.
49
+ **role** (`'user' | 'assistant' | 'system'`): The role of the message sender.
50
50
 
51
- **parts:** (`UIMessagePart[]`): Array of UI parts including text, tool results, files, reasoning, sources, and step markers.
51
+ **parts** (`UIMessagePart[]`): Array of UI parts including text, tool results, files, reasoning, sources, and step markers.
52
52
 
53
- **metadata?:** (`Record<string, unknown>`): Optional metadata including createdAt, threadId, resourceId, and custom fields.
53
+ **metadata** (`Record<string, unknown>`): Optional metadata including createdAt, threadId, resourceId, and custom fields.
54
54
 
55
55
  ## Examples
56
56
 
@@ -30,29 +30,29 @@ const { text } = await generateText({
30
30
 
31
31
  ## Parameters
32
32
 
33
- **model:** (`LanguageModelV2`): Any AI SDK language model (e.g., \`openai('gpt-4o')\`, \`anthropic('claude-3-opus')\`).
33
+ **model** (`LanguageModelV2`): Any AI SDK language model (e.g., \`openai('gpt-4o')\`, \`anthropic('claude-3-opus')\`).
34
34
 
35
- **options?:** (`WithMastraOptions`): Configuration object for processors and memory.
35
+ **options** (`WithMastraOptions`): Configuration object for processors and memory.
36
36
 
37
- **options.inputProcessors?:** (`InputProcessor[]`): Input processors to run before the LLM call.
37
+ **options.inputProcessors** (`InputProcessor[]`): Input processors to run before the LLM call.
38
38
 
39
- **options.outputProcessors?:** (`OutputProcessor[]`): Output processors to run on the LLM response.
39
+ **options.outputProcessors** (`OutputProcessor[]`): Output processors to run on the LLM response.
40
40
 
41
- **options.memory?:** (`WithMastraMemoryOptions`): Memory configuration - enables automatic message history persistence.
41
+ **options.memory** (`WithMastraMemoryOptions`): Memory configuration - enables automatic message history persistence.
42
42
 
43
- **options.memory.storage:** (`MemoryStorage`): Memory storage domain for message persistence. Get it from a composite store using \`await storage.getStore('memory')\`.
43
+ **options.memory.storage** (`MemoryStorage`): Memory storage domain for message persistence. Get it from a composite store using \`await storage.getStore('memory')\`.
44
44
 
45
- **options.memory.threadId:** (`string`): Thread ID for conversation persistence.
45
+ **options.memory.threadId** (`string`): Thread ID for conversation persistence.
46
46
 
47
- **options.memory.resourceId?:** (`string`): Resource ID (user/session identifier).
47
+ **options.memory.resourceId** (`string`): Resource ID (user/session identifier).
48
48
 
49
- **options.memory.lastMessages?:** (`number | false`): Number of recent messages to retrieve, or false to disable.
49
+ **options.memory.lastMessages** (`number | false`): Number of recent messages to retrieve, or false to disable.
50
50
 
51
- **options.memory.semanticRecall?:** (`WithMastraSemanticRecallOptions`): Semantic recall configuration (RAG-based memory retrieval).
51
+ **options.memory.semanticRecall** (`WithMastraSemanticRecallOptions`): Semantic recall configuration (RAG-based memory retrieval).
52
52
 
53
- **options.memory.workingMemory?:** (`MemoryConfig['workingMemory']`): Working memory configuration (persistent user data).
53
+ **options.memory.workingMemory** (`MemoryConfig['workingMemory']`): Working memory configuration (persistent user data).
54
54
 
55
- **options.memory.readOnly?:** (`boolean`): Read-only mode - prevents saving new messages.
55
+ **options.memory.readOnly** (`boolean`): Read-only mode - prevents saving new messages.
56
56
 
57
57
  ## Returns
58
58
 
@@ -47,11 +47,11 @@ export const mastra = new Mastra({
47
47
 
48
48
  ## Parameters
49
49
 
50
- **path?:** (`string`): The route path (e.g., \`/workflow\` or \`/workflow/:workflowId\`). Include \`:workflowId\` for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
50
+ **path** (`string`): The route path (e.g., \`/workflow\` or \`/workflow/:workflowId\`). Include \`:workflowId\` for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
51
51
 
52
- **workflow?:** (`string`): Fixed workflow ID when not using dynamic routing. (Default: `undefined`)
52
+ **workflow** (`string`): Fixed workflow ID when not using dynamic routing. (Default: `undefined`)
53
53
 
54
- **includeTextStreamParts?:** (`boolean`): Whether to include text stream parts in the output. (Default: `true`)
54
+ **includeTextStreamParts** (`boolean`): Whether to include text stream parts in the output. (Default: `true`)
55
55
 
56
56
  ## Additional configuration
57
57
 
@@ -22,21 +22,21 @@ export const mastra = new Mastra({
22
22
 
23
23
  ## Constructor parameters
24
24
 
25
- **domain?:** (`string`): Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant. (Default: `process.env.AUTH0_DOMAIN`)
25
+ **domain** (`string`): Your Auth0 domain (e.g., your-tenant.auth0.com). This is used to verify JWT tokens issued by your Auth0 tenant. (Default: `process.env.AUTH0_DOMAIN`)
26
26
 
27
- **audience?:** (`string`): Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API. (Default: `process.env.AUTH0_AUDIENCE`)
27
+ **audience** (`string`): Your Auth0 API identifier/audience. This ensures tokens are intended for your specific API. (Default: `process.env.AUTH0_AUDIENCE`)
28
28
 
29
- **name?:** (`string`): Custom name for the auth provider instance. (Default: `"auth0"`)
29
+ **name** (`string`): Custom name for the auth provider instance. (Default: `"auth0"`)
30
30
 
31
- **authorizeUser?:** (`(user: Auth0User) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.
31
+ **authorizeUser** (`(user: Auth0User) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.
32
32
 
33
33
  ## Environment Variables
34
34
 
35
35
  The following environment variables are automatically used when constructor options are not provided:
36
36
 
37
- **AUTH0\_DOMAIN?:** (`string`): Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.
37
+ **AUTH0\_DOMAIN** (`string`): Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.
38
38
 
39
- **AUTH0\_AUDIENCE?:** (`string`): Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.
39
+ **AUTH0\_AUDIENCE** (`string`): Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.
40
40
 
41
41
  ## Default Authorization Behavior
42
42
 
@@ -33,15 +33,15 @@ export const mastra = new Mastra({
33
33
 
34
34
  ## Constructor parameters
35
35
 
36
- **auth:** (`Auth`): Your Better Auth instance created via betterAuth({ ... }). This is required and must be properly configured with a supported database provider.
36
+ **auth** (`Auth`): Your Better Auth instance created via betterAuth({ ... }). This is required and must be properly configured with a supported database provider.
37
37
 
38
- **name?:** (`string`): Custom name for the auth provider instance. (Default: `'better-auth'`)
38
+ **name** (`string`): Custom name for the auth provider instance. (Default: `'better-auth'`)
39
39
 
40
- **authorizeUser?:** (`(user: BetterAuthUser, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after session verification. By default, allows all authenticated users with valid sessions.
40
+ **authorizeUser** (`(user: BetterAuthUser, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after session verification. By default, allows all authenticated users with valid sessions.
41
41
 
42
- **public?:** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Public routes that do not require authentication. Supports exact paths, wildcards, and path params.
42
+ **public** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Public routes that do not require authentication. Supports exact paths, wildcards, and path params.
43
43
 
44
- **protected?:** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Protected routes that require authentication. Supports exact paths, wildcards, and path params.
44
+ **protected** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Protected routes that require authentication. Supports exact paths, wildcards, and path params.
45
45
 
46
46
  ## BetterAuthUser Type
47
47
 
@@ -21,15 +21,15 @@ export const mastra = new Mastra({
21
21
 
22
22
  ## Constructor parameters
23
23
 
24
- **publishableKey?:** (`string`): Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys. (Default: `process.env.CLERK_PUBLISHABLE_KEY`)
24
+ **publishableKey** (`string`): Your Clerk publishable key. Can be found in your Clerk Dashboard under API Keys. (Default: `process.env.CLERK_PUBLISHABLE_KEY`)
25
25
 
26
- **secretKey?:** (`string`): Your Clerk secret key. Used for server-side authentication and token verification. (Default: `process.env.CLERK_SECRET_KEY`)
26
+ **secretKey** (`string`): Your Clerk secret key. Used for server-side authentication and token verification. (Default: `process.env.CLERK_SECRET_KEY`)
27
27
 
28
- **jwksUri?:** (`string`): The JWKS URI from your Clerk application. Used to verify JWT signatures. (Default: `process.env.CLERK_JWKS_URI`)
28
+ **jwksUri** (`string`): The JWKS URI from your Clerk application. Used to verify JWT signatures. (Default: `process.env.CLERK_JWKS_URI`)
29
29
 
30
- **name?:** (`string`): Custom name for the auth provider instance.
30
+ **name** (`string`): Custom name for the auth provider instance.
31
31
 
32
- **authorizeUser?:** (`(user: User, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users.
32
+ **authorizeUser** (`(user: User, request: HonoRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users.
33
33
 
34
34
  ## Related
35
35
 
@@ -36,23 +36,23 @@ export const mastra = new Mastra({
36
36
 
37
37
  ## Constructor parameters
38
38
 
39
- **serviceAccount?:** (`string`): Path to the Firebase service account JSON file. This file contains the credentials needed to verify Firebase ID tokens on the server side. (Default: `process.env.FIREBASE_SERVICE_ACCOUNT`)
39
+ **serviceAccount** (`string`): Path to the Firebase service account JSON file. This file contains the credentials needed to verify Firebase ID tokens on the server side. (Default: `process.env.FIREBASE_SERVICE_ACCOUNT`)
40
40
 
41
- **databaseId?:** (`string`): The Firestore database ID to use. Typically '(default)' for the default database. (Default: `process.env.FIRESTORE_DATABASE_ID || process.env.FIREBASE_DATABASE_ID`)
41
+ **databaseId** (`string`): The Firestore database ID to use. Typically '(default)' for the default database. (Default: `process.env.FIRESTORE_DATABASE_ID || process.env.FIREBASE_DATABASE_ID`)
42
42
 
43
- **name?:** (`string`): Custom name for the auth provider instance. (Default: `"firebase"`)
43
+ **name** (`string`): Custom name for the auth provider instance. (Default: `"firebase"`)
44
44
 
45
- **authorizeUser?:** (`(user: FirebaseUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks for the presence of a document in the 'user\_access' collection keyed by the user's UID.
45
+ **authorizeUser** (`(user: FirebaseUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks for the presence of a document in the 'user\_access' collection keyed by the user's UID.
46
46
 
47
47
  ## Environment Variables
48
48
 
49
49
  The following environment variables are automatically used when constructor options are not provided:
50
50
 
51
- **FIREBASE\_SERVICE\_ACCOUNT?:** (`string`): Path to Firebase service account JSON file. Used if serviceAccount option is not provided.
51
+ **FIREBASE\_SERVICE\_ACCOUNT** (`string`): Path to Firebase service account JSON file. Used if serviceAccount option is not provided.
52
52
 
53
- **FIRESTORE\_DATABASE\_ID?:** (`string`): Firestore database ID. Primary environment variable for database configuration.
53
+ **FIRESTORE\_DATABASE\_ID** (`string`): Firestore database ID. Primary environment variable for database configuration.
54
54
 
55
- **FIREBASE\_DATABASE\_ID?:** (`string`): Alternative environment variable for Firestore database ID. Used if FIRESTORE\_DATABASE\_ID is not set.
55
+ **FIREBASE\_DATABASE\_ID** (`string`): Alternative environment variable for Firestore database ID. Used if FIRESTORE\_DATABASE\_ID is not set.
56
56
 
57
57
  ## Default Authorization Behavior
58
58
 
@@ -19,7 +19,7 @@ export const mastra = new Mastra({
19
19
 
20
20
  ## Constructor parameters
21
21
 
22
- **secret:** (`string`): A unique string used to sign and verify JSON Web Tokens (JWTs) for authenticating incoming requests.
22
+ **secret** (`string`): A unique string used to sign and verify JSON Web Tokens (JWTs) for authenticating incoming requests.
23
23
 
24
24
  ## Related
25
25
 
@@ -20,13 +20,13 @@ export const mastra = new Mastra({
20
20
 
21
21
  ## Constructor parameters
22
22
 
23
- **url?:** (`string`): The URL of your Supabase project. Can be found in your Supabase project settings. (Default: `process.env.SUPABASE_URL`)
23
+ **url** (`string`): The URL of your Supabase project. Can be found in your Supabase project settings. (Default: `process.env.SUPABASE_URL`)
24
24
 
25
- **anonKey?:** (`string`): The anonymous/public key for your Supabase project. Used for client-side authentication. (Default: `process.env.SUPABASE_ANON_KEY`)
25
+ **anonKey** (`string`): The anonymous/public key for your Supabase project. Used for client-side authentication. (Default: `process.env.SUPABASE_ANON_KEY`)
26
26
 
27
- **name?:** (`string`): Custom name for the auth provider instance.
27
+ **name** (`string`): Custom name for the auth provider instance.
28
28
 
29
- **authorizeUser?:** (`(user: User, request: HoneRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks the 'isAdmin' column in the 'users' table.
29
+ **authorizeUser** (`(user: User, request: HoneRequest) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks the 'isAdmin' column in the 'users' table.
30
30
 
31
31
  ## Related
32
32
 
@@ -22,21 +22,21 @@ export const mastra = new Mastra({
22
22
 
23
23
  ## Constructor parameters
24
24
 
25
- **apiKey?:** (`string`): Your WorkOS API key. This is used to authenticate with the WorkOS API for user verification and organization management. (Default: `process.env.WORKOS_API_KEY`)
25
+ **apiKey** (`string`): Your WorkOS API key. This is used to authenticate with the WorkOS API for user verification and organization management. (Default: `process.env.WORKOS_API_KEY`)
26
26
 
27
- **clientId?:** (`string`): Your WorkOS Client ID. This identifies your application when exchanging authorization codes for access tokens. (Default: `process.env.WORKOS_CLIENT_ID`)
27
+ **clientId** (`string`): Your WorkOS Client ID. This identifies your application when exchanging authorization codes for access tokens. (Default: `process.env.WORKOS_CLIENT_ID`)
28
28
 
29
- **name?:** (`string`): Custom name for the auth provider instance. (Default: `"workos"`)
29
+ **name** (`string`): Custom name for the auth provider instance. (Default: `"workos"`)
30
30
 
31
- **authorizeUser?:** (`(user: WorkosUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks if the user has an 'admin' role in any organization membership.
31
+ **authorizeUser** (`(user: WorkosUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks if the user has an 'admin' role in any organization membership.
32
32
 
33
33
  ## Environment Variables
34
34
 
35
35
  The following environment variables are automatically used when constructor options are not provided:
36
36
 
37
- **WORKOS\_API\_KEY?:** (`string`): Your WorkOS API key. Can be found in your WorkOS Dashboard under API Keys.
37
+ **WORKOS\_API\_KEY** (`string`): Your WorkOS API key. Can be found in your WorkOS Dashboard under API Keys.
38
38
 
39
- **WORKOS\_CLIENT\_ID?:** (`string`): Your WorkOS Client ID. Can be found in your WorkOS Dashboard under Applications.
39
+ **WORKOS\_CLIENT\_ID** (`string`): Your WorkOS Client ID. Can be found in your WorkOS Dashboard under Applications.
40
40
 
41
41
  ## Default Authorization Behavior
42
42
 
@@ -92,33 +92,33 @@ bun x create-mastra@latest my-project -- --default --skills claude-code,cursor
92
92
 
93
93
  Instead of an interactive prompt you can also define these CLI flags.
94
94
 
95
- **--version?:** (`boolean`): Output the version number
95
+ **--version** (`boolean`): Output the version number
96
96
 
97
- **--project-name?:** (`string`): Project name that will be used in package.json and as the project directory name
97
+ **--project-name** (`string`): Project name that will be used in package.json and as the project directory name
98
98
 
99
- **--default?:** (`boolean`): Quick start with defaults (src, OpenAI, no examples)
99
+ **--default** (`boolean`): Quick start with defaults (src, OpenAI, no examples)
100
100
 
101
- **--components?:** (`string`): Comma-separated list of components (agents, tools, workflows, scorers)
101
+ **--components** (`string`): Comma-separated list of components (agents, tools, workflows, scorers)
102
102
 
103
- **--llm?:** (`string`): Default model provider (openai, anthropic, groq, google, or cerebras)
103
+ **--llm** (`string`): Default model provider (openai, anthropic, groq, google, or cerebras)
104
104
 
105
- **--llm-api-key?:** (`string`): API key for the model provider
105
+ **--llm-api-key** (`string`): API key for the model provider
106
106
 
107
- **--example?:** (`boolean`): Include example code
107
+ **--example** (`boolean`): Include example code
108
108
 
109
- **--no-example?:** (`boolean`): Do not include example code
109
+ **--no-example** (`boolean`): Do not include example code
110
110
 
111
- **--template?:** (`string`): Create project from a template (use template name, public GitHub URL, or leave blank to select from list)
111
+ **--template** (`string`): Create project from a template (use template name, public GitHub URL, or leave blank to select from list)
112
112
 
113
- **--timeout?:** (`number`): Configurable timeout for package installation, defaults to 60000 ms
113
+ **--timeout** (`number`): Configurable timeout for package installation, defaults to 60000 ms
114
114
 
115
- **--dir?:** (`string`): Target directory for Mastra source code (default: src/)
115
+ **--dir** (`string`): Target directory for Mastra source code (default: src/)
116
116
 
117
- **--mcp?:** (`string`): MCP Server for code editor (cursor, cursor-global, windsurf, vscode)
117
+ **--mcp** (`string`): MCP Server for code editor (cursor, cursor-global, windsurf, vscode)
118
118
 
119
- **--skills?:** (`string`): Comma-separated list of agents to install Mastra skills for (e.g., claude-code,cursor,windsurf)
119
+ **--skills** (`string`): Comma-separated list of agents to install Mastra skills for (e.g., claude-code,cursor,windsurf)
120
120
 
121
- **--help?:** (`boolean`): Display help for command
121
+ **--help** (`boolean`): Display help for command
122
122
 
123
123
  ## Telemetry
124
124
 
@@ -14,50 +14,50 @@ export const mastraClient = new MastraClient({
14
14
 
15
15
  ## Parameters
16
16
 
17
- **baseUrl:** (`string`): The base URL for the Mastra API. All requests will be sent relative to this URL.
17
+ **baseUrl** (`string`): The base URL for the Mastra API. All requests will be sent relative to this URL.
18
18
 
19
- **retries?:** (`number`): The number of times a request will be retried on failure before throwing an error. (Default: `3`)
19
+ **retries** (`number`): The number of times a request will be retried on failure before throwing an error. (Default: `3`)
20
20
 
21
- **backoffMs?:** (`number`): The initial delay in milliseconds before retrying a failed request. This value is doubled with each retry (exponential backoff). (Default: `300`)
21
+ **backoffMs** (`number`): The initial delay in milliseconds before retrying a failed request. This value is doubled with each retry (exponential backoff). (Default: `300`)
22
22
 
23
- **maxBackoffMs?:** (`number`): The maximum backoff time in milliseconds. Prevents retries from waiting too long between attempts. (Default: `5000`)
23
+ **maxBackoffMs** (`number`): The maximum backoff time in milliseconds. Prevents retries from waiting too long between attempts. (Default: `5000`)
24
24
 
25
- **headers?:** (`Record<string, string>`): An object containing custom HTTP headers to include with every request.
25
+ **headers** (`Record<string, string>`): An object containing custom HTTP headers to include with every request.
26
26
 
27
- **credentials?:** (`"omit" | "same-origin" | "include"`): Credentials mode for requests. See https\://developer.mozilla.org/en-US/docs/Web/API/Request/credentials for more info.
27
+ **credentials** (`"omit" | "same-origin" | "include"`): Credentials mode for requests. See https\://developer.mozilla.org/en-US/docs/Web/API/Request/credentials for more info.
28
28
 
29
29
  ## Methods
30
30
 
31
- **listAgents():** (`Promise<Record<string, GetAgentResponse>>`): Returns all available agent instances.
31
+ **listAgents()** (`Promise<Record<string, GetAgentResponse>>`): Returns all available agent instances.
32
32
 
33
- **getAgent(agentId):** (`Agent`): Retrieves a specific agent instance by ID.
33
+ **getAgent(agentId)** (`Agent`): Retrieves a specific agent instance by ID.
34
34
 
35
- **getMemoryThreads(params):** (`Promise<StorageThreadType[]>`): Retrieves memory threads for the specified resource and agent. Requires a \`resourceId\` and an \`agentId\`.
35
+ **getMemoryThreads(params)** (`Promise<StorageThreadType[]>`): Retrieves memory threads for the specified resource and agent. Requires a \`resourceId\` and an \`agentId\`.
36
36
 
37
- **createMemoryThread(params):** (`Promise<MemoryThread>`): Creates a new memory thread with the given parameters.
37
+ **createMemoryThread(params)** (`Promise<MemoryThread>`): Creates a new memory thread with the given parameters.
38
38
 
39
- **getMemoryThread({ threadId, agentId }):** (`MemoryThread`): Fetches a specific memory thread by ID.
39
+ **getMemoryThread({ threadId, agentId })** (`MemoryThread`): Fetches a specific memory thread by ID.
40
40
 
41
- **saveMessageToMemory(params):** (`Promise<{ messages: (MastraMessageV1 | MastraDBMessage)[] }>`): Saves one or more messages to the memory system. Returns the saved messages.
41
+ **saveMessageToMemory(params)** (`Promise<{ messages: (MastraMessageV1 | MastraDBMessage)[] }>`): Saves one or more messages to the memory system. Returns the saved messages.
42
42
 
43
- **getMemoryStatus():** (`Promise<MemoryStatus>`): Returns the current status of the memory system.
43
+ **getMemoryStatus()** (`Promise<MemoryStatus>`): Returns the current status of the memory system.
44
44
 
45
- **listTools():** (`Record<string, Tool>`): Returns all available tools.
45
+ **listTools()** (`Record<string, Tool>`): Returns all available tools.
46
46
 
47
- **getTool(toolId):** (`Tool`): Retrieves a specific tool instance by ID.
47
+ **getTool(toolId)** (`Tool`): Retrieves a specific tool instance by ID.
48
48
 
49
- **listWorkflows():** (`Record<string, Workflow>`): Returns all available workflow instances.
49
+ **listWorkflows()** (`Record<string, Workflow>`): Returns all available workflow instances.
50
50
 
51
- **getWorkflow(workflowId):** (`Workflow`): Retrieves a specific workflow instance by ID.
51
+ **getWorkflow(workflowId)** (`Workflow`): Retrieves a specific workflow instance by ID.
52
52
 
53
- **getVector(vectorName):** (`MastraVector`): Returns a vector store instance by name.
53
+ **getVector(vectorName)** (`MastraVector`): Returns a vector store instance by name.
54
54
 
55
- **listLogs(params):** (`Promise<LogEntry[]>`): Fetches system logs matching the provided filters.
55
+ **listLogs(params)** (`Promise<LogEntry[]>`): Fetches system logs matching the provided filters.
56
56
 
57
- **getLog(params):** (`Promise<LogEntry>`): Retrieves a specific log entry by ID or filter.
57
+ **getLog(params)** (`Promise<LogEntry>`): Retrieves a specific log entry by ID or filter.
58
58
 
59
- **listLogTransports():** (`string[]`): Returns the list of configured log transport types.
59
+ **listLogTransports()** (`string[]`): Returns the list of configured log transport types.
60
60
 
61
- **getTrace(traceId):** (`Promise<TraceRecord>`): Retrieves a specific trace by ID, including all its spans and details.
61
+ **getTrace(traceId)** (`Promise<TraceRecord>`): Retrieves a specific trace by ID, including all its spans and details.
62
62
 
63
- **getTraces(params):** (`Promise<GetTracesResponse>`): Retrieves paginated list of trace root spans with optional filtering. Use getTrace() to get complete traces with all spans.
63
+ **getTraces(params)** (`Promise<GetTracesResponse>`): Retrieves paginated list of trace root spans with optional filtering. Use getTrace() to get complete traces with all spans.
@@ -192,8 +192,8 @@ const result = await workflow.runById(runId, {
192
192
 
193
193
  A workflow run result yields the following:
194
194
 
195
- **runId:** (`string`): Unique identifier for this workflow run instance
195
+ **runId** (`string`): Unique identifier for this workflow run instance
196
196
 
197
- **eventTimestamp:** (`Date`): The timestamp of the event
197
+ **eventTimestamp** (`Date`): The timestamp of the event
198
198
 
199
- **payload:** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
199
+ **payload** (`object`): Contains currentStep (id, status, output, payload) and workflowState (status, steps record)
@@ -19,9 +19,9 @@ mastra.addGateway(new MyCustomGateway())
19
19
 
20
20
  ## Parameters
21
21
 
22
- **gateway:** (`MastraModelGateway`): The gateway instance to add
22
+ **gateway** (`MastraModelGateway`): The gateway instance to add
23
23
 
24
- **key?:** (`string`): Optional registration key. If not provided, uses gateway.getId()
24
+ **key** (`string`): Optional registration key. If not provided, uses gateway.getId()
25
25
 
26
26
  ## Returns
27
27
 
@@ -10,11 +10,11 @@ mastra.getAgent('testAgent')
10
10
 
11
11
  ## Parameters
12
12
 
13
- **name:** (`TAgentName extends keyof TAgents`): The name of the agent to retrieve. Must be a valid agent name that exists in the Mastra configuration.
13
+ **name** (`TAgentName extends keyof TAgents`): The name of the agent to retrieve. Must be a valid agent name that exists in the Mastra configuration.
14
14
 
15
15
  ## Returns
16
16
 
17
- **agent:** (`TAgents[TAgentName]`): The agent instance with the specified name. Throws an error if the agent is not found.
17
+ **agent** (`TAgents[TAgentName]`): The agent instance with the specified name. Throws an error if the agent is not found.
18
18
 
19
19
  ## Related
20
20
 
@@ -10,11 +10,11 @@ mastra.getAgentById('test-agent-123')
10
10
 
11
11
  ## Parameters
12
12
 
13
- **id:** (`string`): The ID of the agent to retrieve. The method will first search for an agent with this ID, and if not found, will attempt to use it as a name to call getAgent().
13
+ **id** (`string`): The ID of the agent to retrieve. The method will first search for an agent with this ID, and if not found, will attempt to use it as a name to call getAgent().
14
14
 
15
15
  ## Returns
16
16
 
17
- **agent:** (`Agent`): The agent instance with the specified ID. Throws an error if the agent is not found.
17
+ **agent** (`Agent`): The agent instance with the specified ID. Throws an error if the agent is not found.
18
18
 
19
19
  ## Related
20
20
 
@@ -14,7 +14,7 @@ This method does not accept any parameters.
14
14
 
15
15
  ## Returns
16
16
 
17
- **deployer:** (`MastraDeployer | undefined`): The configured deployer instance, or undefined if no deployer has been configured.
17
+ **deployer** (`MastraDeployer | undefined`): The configured deployer instance, or undefined if no deployer has been configured.
18
18
 
19
19
  ## Related
20
20
 
@@ -19,11 +19,11 @@ console.log(gateway.name) // 'My Custom Gateway'
19
19
 
20
20
  ## Parameters
21
21
 
22
- **key:** (`string`): The registration key of the gateway
22
+ **key** (`string`): The registration key of the gateway
23
23
 
24
24
  ## Returns
25
25
 
26
- **gateway:** (`MastraModelGateway`): The gateway instance
26
+ **gateway** (`MastraModelGateway`): The gateway instance
27
27
 
28
28
  ## Throws
29
29
 
@@ -26,11 +26,11 @@ console.log(gateway.name) // 'My Custom Gateway'
26
26
 
27
27
  ## Parameters
28
28
 
29
- **id:** (`string`): The unique ID of the gateway (gateway.id property)
29
+ **id** (`string`): The unique ID of the gateway (gateway.id property)
30
30
 
31
31
  ## Returns
32
32
 
33
- **gateway:** (`MastraModelGateway | undefined`): The gateway instance, or undefined if not found
33
+ **gateway** (`MastraModelGateway | undefined`): The gateway instance, or undefined if not found
34
34
 
35
35
  ## Related
36
36
 
@@ -14,7 +14,7 @@ This method does not accept any parameters.
14
14
 
15
15
  ## Returns
16
16
 
17
- **logger:** (`TLogger`): The configured logger instance used for logging across all components (agents, workflows, etc.).
17
+ **logger** (`TLogger`): The configured logger instance used for logging across all components (agents, workflows, etc.).
18
18
 
19
19
  ## Related
20
20
 
@@ -30,11 +30,11 @@ const serverById = mastra.getMCPServerById('my-mcp-server')
30
30
 
31
31
  ## Parameters
32
32
 
33
- **registryKey:** (`string`): The registry key used when registering the MCP server in the mcpServers configuration object. This is the key in the key-value pair, not the server's intrinsic id property.
33
+ **registryKey** (`string`): The registry key used when registering the MCP server in the mcpServers configuration object. This is the key in the key-value pair, not the server's intrinsic id property.
34
34
 
35
35
  ## Returns
36
36
 
37
- **server:** (`MCPServerBase | undefined`): The MCP server instance with the specified registry key, or undefined if not found.
37
+ **server** (`MCPServerBase | undefined`): The MCP server instance with the specified registry key, or undefined if not found.
38
38
 
39
39
  ## Related Methods
40
40
 
@@ -30,13 +30,13 @@ const serverByKey = mastra.getMCPServer('customKey')
30
30
 
31
31
  ## Parameters
32
32
 
33
- **serverId:** (`string`): The intrinsic id property of the MCP server (set when the server was instantiated).
33
+ **serverId** (`string`): The intrinsic id property of the MCP server (set when the server was instantiated).
34
34
 
35
- **version?:** (`string`): Optional. If provided, returns the server only if its version matches.
35
+ **version** (`string`): Optional. If provided, returns the server only if its version matches.
36
36
 
37
37
  ## Returns
38
38
 
39
- **server:** (`MCPServerBase | undefined`): The MCP server instance with the specified id (and version, if provided), or undefined if not found.
39
+ **server** (`MCPServerBase | undefined`): The MCP server instance with the specified id (and version, if provided), or undefined if not found.
40
40
 
41
41
  ## Notes
42
42
 
@@ -16,11 +16,11 @@ const thread = await memory.createThread({
16
16
 
17
17
  ## Parameters
18
18
 
19
- **key:** (`TMemoryKey extends keyof TMemory`): The registry key of the memory instance to retrieve. Must match a key used when registering memory in the Mastra constructor.
19
+ **key** (`TMemoryKey extends keyof TMemory`): The registry key of the memory instance to retrieve. Must match a key used when registering memory in the Mastra constructor.
20
20
 
21
21
  ## Returns
22
22
 
23
- **memory:** (`TMemory[TMemoryKey]`): The memory instance with the specified key. Throws an error if the memory is not found.
23
+ **memory** (`TMemory[TMemoryKey]`): The memory instance with the specified key. Throws an error if the memory is not found.
24
24
 
25
25
  ## Example: Registering and Retrieving Memory
26
26