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

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 (297) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +19 -19
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +28 -28
  3. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +98 -98
  4. package/.docs/organized/changelogs/%40mastra%2Fconvex.md +30 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fcore.md +171 -171
  6. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +15 -15
  7. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +16 -16
  8. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +15 -15
  9. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +10 -10
  10. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +12 -12
  11. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +22 -22
  12. package/.docs/organized/changelogs/%40mastra%2Frag.md +17 -17
  13. package/.docs/organized/changelogs/%40mastra%2Freact.md +9 -2
  14. package/.docs/organized/changelogs/%40mastra%2Fserver.md +94 -94
  15. package/.docs/organized/changelogs/create-mastra.md +3 -3
  16. package/.docs/organized/changelogs/mastra.md +17 -17
  17. package/.docs/organized/code-examples/agent-v6.md +151 -0
  18. package/.docs/organized/code-examples/ai-elements.md +1 -1
  19. package/.docs/raw/agents/adding-voice.mdx +2 -3
  20. package/.docs/raw/agents/agent-approval.mdx +5 -6
  21. package/.docs/raw/agents/agent-memory.mdx +22 -30
  22. package/.docs/raw/agents/guardrails.mdx +60 -50
  23. package/.docs/raw/agents/networks.mdx +8 -12
  24. package/.docs/raw/agents/overview.mdx +39 -23
  25. package/.docs/raw/agents/processors.mdx +20 -19
  26. package/.docs/raw/agents/structured-output.mdx +11 -7
  27. package/.docs/raw/agents/using-tools.mdx +4 -5
  28. package/.docs/raw/deployment/mastra-server.mdx +3 -3
  29. package/.docs/raw/deployment/overview.mdx +7 -0
  30. package/.docs/raw/deployment/web-framework.mdx +4 -6
  31. package/.docs/raw/evals/custom-scorers.mdx +9 -6
  32. package/.docs/raw/evals/overview.mdx +3 -6
  33. package/.docs/raw/evals/running-in-ci.mdx +2 -2
  34. package/.docs/raw/getting-started/manual-install.mdx +20 -20
  35. package/.docs/raw/getting-started/mcp-docs-server.mdx +2 -2
  36. package/.docs/raw/guides/agent-frameworks/ai-sdk.mdx +4 -4
  37. package/.docs/raw/guides/build-your-ui/ai-sdk-ui.mdx +30 -30
  38. package/.docs/raw/guides/build-your-ui/assistant-ui.mdx +8 -8
  39. package/.docs/raw/guides/build-your-ui/copilotkit.mdx +11 -11
  40. package/.docs/raw/guides/deployment/amazon-ec2.mdx +9 -9
  41. package/.docs/raw/guides/deployment/aws-lambda.mdx +11 -11
  42. package/.docs/raw/guides/deployment/azure-app-services.mdx +2 -2
  43. package/.docs/raw/guides/deployment/cloudflare-deployer.mdx +5 -6
  44. package/.docs/raw/guides/deployment/digital-ocean.mdx +10 -10
  45. package/.docs/raw/guides/deployment/index.mdx +1 -1
  46. package/.docs/raw/guides/deployment/inngest.mdx +386 -0
  47. package/.docs/raw/guides/deployment/netlify-deployer.mdx +4 -4
  48. package/.docs/raw/guides/deployment/vercel-deployer.mdx +5 -6
  49. package/.docs/raw/guides/getting-started/astro.mdx +292 -451
  50. package/.docs/raw/guides/getting-started/express.mdx +7 -7
  51. package/.docs/raw/guides/getting-started/hono.mdx +18 -18
  52. package/.docs/raw/guides/getting-started/next-js.mdx +19 -20
  53. package/.docs/raw/guides/getting-started/quickstart.mdx +4 -4
  54. package/.docs/raw/guides/getting-started/sveltekit.mdx +238 -409
  55. package/.docs/raw/guides/getting-started/vite-react.mdx +21 -21
  56. package/.docs/raw/guides/guide/ai-recruiter.mdx +10 -10
  57. package/.docs/raw/guides/guide/chef-michel.mdx +9 -11
  58. package/.docs/raw/guides/guide/notes-mcp-server.mdx +15 -15
  59. package/.docs/raw/guides/guide/research-assistant.mdx +13 -13
  60. package/.docs/raw/guides/guide/stock-agent.mdx +5 -5
  61. package/.docs/raw/guides/guide/web-search.mdx +8 -8
  62. package/.docs/raw/guides/guide/whatsapp-chat-bot.mdx +7 -7
  63. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +2 -2
  64. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +1 -1
  65. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +0 -2
  66. package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx +21 -23
  67. package/.docs/raw/index.mdx +2 -2
  68. package/.docs/raw/mastra-cloud/setting-up.mdx +6 -2
  69. package/.docs/raw/mcp/overview.mdx +31 -13
  70. package/.docs/raw/mcp/publishing-mcp-server.mdx +2 -2
  71. package/.docs/raw/memory/memory-processors.mdx +9 -9
  72. package/.docs/raw/memory/message-history.mdx +69 -0
  73. package/.docs/raw/memory/overview.mdx +34 -76
  74. package/.docs/raw/memory/semantic-recall.mdx +58 -49
  75. package/.docs/raw/memory/storage.mdx +188 -0
  76. package/.docs/raw/memory/working-memory.mdx +7 -7
  77. package/.docs/raw/observability/logging.mdx +9 -10
  78. package/.docs/raw/observability/overview.mdx +0 -1
  79. package/.docs/raw/observability/tracing/bridges/otel.mdx +2 -2
  80. package/.docs/raw/observability/tracing/exporters/default.mdx +3 -3
  81. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -2
  82. package/.docs/raw/observability/tracing/overview.mdx +23 -25
  83. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +3 -3
  84. package/.docs/raw/rag/chunking-and-embedding.mdx +6 -6
  85. package/.docs/raw/rag/graph-rag.mdx +7 -7
  86. package/.docs/raw/rag/overview.mdx +1 -1
  87. package/.docs/raw/rag/retrieval.mdx +21 -22
  88. package/.docs/raw/rag/vector-databases.mdx +22 -22
  89. package/.docs/raw/reference/agents/agent.mdx +3 -3
  90. package/.docs/raw/reference/agents/generate.mdx +1 -1
  91. package/.docs/raw/reference/agents/generateLegacy.mdx +2 -2
  92. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +2 -2
  93. package/.docs/raw/reference/agents/getDefaultOptions.mdx +2 -2
  94. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +2 -2
  95. package/.docs/raw/reference/agents/getDescription.mdx +1 -1
  96. package/.docs/raw/reference/agents/getInstructions.mdx +2 -2
  97. package/.docs/raw/reference/agents/getLLM.mdx +2 -2
  98. package/.docs/raw/reference/agents/getMemory.mdx +2 -2
  99. package/.docs/raw/reference/agents/getModel.mdx +2 -2
  100. package/.docs/raw/reference/agents/getTools.mdx +2 -2
  101. package/.docs/raw/reference/agents/getVoice.mdx +2 -2
  102. package/.docs/raw/reference/agents/listAgents.mdx +2 -2
  103. package/.docs/raw/reference/agents/listScorers.mdx +2 -2
  104. package/.docs/raw/reference/agents/listTools.mdx +2 -2
  105. package/.docs/raw/reference/agents/listWorkflows.mdx +2 -2
  106. package/.docs/raw/reference/agents/network.mdx +1 -1
  107. package/.docs/raw/reference/ai-sdk/chat-route.mdx +2 -2
  108. package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx +1 -1
  109. package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx +1 -1
  110. package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx +1 -1
  111. package/.docs/raw/reference/ai-sdk/network-route.mdx +2 -2
  112. package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx +6 -6
  113. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx +3 -3
  114. package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx +3 -3
  115. package/.docs/raw/reference/ai-sdk/with-mastra.mdx +1 -1
  116. package/.docs/raw/reference/ai-sdk/workflow-route.mdx +2 -2
  117. package/.docs/raw/reference/auth/auth0.mdx +1 -2
  118. package/.docs/raw/reference/auth/clerk.mdx +1 -2
  119. package/.docs/raw/reference/auth/firebase.mdx +2 -4
  120. package/.docs/raw/reference/auth/jwt.mdx +1 -2
  121. package/.docs/raw/reference/auth/supabase.mdx +1 -2
  122. package/.docs/raw/reference/auth/workos.mdx +1 -2
  123. package/.docs/raw/reference/cli/create-mastra.mdx +10 -10
  124. package/.docs/raw/reference/cli/mastra.mdx +9 -9
  125. package/.docs/raw/reference/client-js/agents.mdx +1 -2
  126. package/.docs/raw/reference/client-js/mastra-client.mdx +1 -1
  127. package/.docs/raw/reference/core/getAgent.mdx +1 -1
  128. package/.docs/raw/reference/core/getAgentById.mdx +1 -1
  129. package/.docs/raw/reference/core/getDeployer.mdx +1 -1
  130. package/.docs/raw/reference/core/getLogger.mdx +1 -1
  131. package/.docs/raw/reference/core/getMCPServer.mdx +1 -1
  132. package/.docs/raw/reference/core/getMCPServerById.mdx +1 -1
  133. package/.docs/raw/reference/core/getMemory.mdx +2 -2
  134. package/.docs/raw/reference/core/getServer.mdx +1 -1
  135. package/.docs/raw/reference/core/getStorage.mdx +2 -2
  136. package/.docs/raw/reference/core/getStoredAgentById.mdx +3 -3
  137. package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
  138. package/.docs/raw/reference/core/getVector.mdx +1 -1
  139. package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
  140. package/.docs/raw/reference/core/listAgents.mdx +1 -1
  141. package/.docs/raw/reference/core/listLogs.mdx +1 -1
  142. package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
  143. package/.docs/raw/reference/core/listMCPServers.mdx +1 -1
  144. package/.docs/raw/reference/core/listMemory.mdx +2 -2
  145. package/.docs/raw/reference/core/listStoredAgents.mdx +4 -4
  146. package/.docs/raw/reference/core/listVectors.mdx +1 -1
  147. package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
  148. package/.docs/raw/reference/core/setLogger.mdx +1 -1
  149. package/.docs/raw/reference/core/setStorage.mdx +2 -2
  150. package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
  151. package/.docs/raw/reference/deployer/cloudflare.mdx +1 -2
  152. package/.docs/raw/reference/deployer/deployer.mdx +0 -1
  153. package/.docs/raw/reference/deployer/netlify.mdx +1 -1
  154. package/.docs/raw/reference/deployer/vercel.mdx +2 -4
  155. package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
  156. package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
  157. package/.docs/raw/reference/evals/bias.mdx +1 -1
  158. package/.docs/raw/reference/evals/completeness.mdx +1 -1
  159. package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
  160. package/.docs/raw/reference/evals/context-precision.mdx +1 -1
  161. package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
  162. package/.docs/raw/reference/evals/hallucination.mdx +1 -1
  163. package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
  164. package/.docs/raw/reference/evals/prompt-alignment.mdx +7 -7
  165. package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
  166. package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
  167. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +10 -10
  168. package/.docs/raw/reference/evals/toxicity.mdx +1 -1
  169. package/.docs/raw/reference/logging/pino-logger.mdx +6 -7
  170. package/.docs/raw/reference/memory/createThread.mdx +2 -2
  171. package/.docs/raw/reference/memory/deleteMessages.mdx +2 -2
  172. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +2 -2
  173. package/.docs/raw/reference/memory/memory-class.mdx +3 -3
  174. package/.docs/raw/reference/memory/query.mdx +2 -2
  175. package/.docs/raw/reference/memory/recall.mdx +2 -2
  176. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
  177. package/.docs/raw/reference/processors/batch-parts-processor.mdx +2 -2
  178. package/.docs/raw/reference/processors/language-detector.mdx +2 -2
  179. package/.docs/raw/reference/processors/message-history-processor.mdx +2 -2
  180. package/.docs/raw/reference/processors/moderation-processor.mdx +3 -3
  181. package/.docs/raw/reference/processors/pii-detector.mdx +3 -3
  182. package/.docs/raw/reference/processors/processor-interface.mdx +13 -13
  183. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +2 -2
  184. package/.docs/raw/reference/processors/semantic-recall-processor.mdx +2 -2
  185. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +2 -2
  186. package/.docs/raw/reference/processors/token-limiter-processor.mdx +2 -2
  187. package/.docs/raw/reference/processors/tool-call-filter.mdx +3 -3
  188. package/.docs/raw/reference/processors/unicode-normalizer.mdx +2 -2
  189. package/.docs/raw/reference/processors/working-memory-processor.mdx +3 -3
  190. package/.docs/raw/reference/rag/chunk.mdx +1 -1
  191. package/.docs/raw/reference/rag/extract-params.mdx +2 -2
  192. package/.docs/raw/reference/rag/metadata-filters.mdx +7 -7
  193. package/.docs/raw/reference/server/create-route.mdx +13 -13
  194. package/.docs/raw/reference/server/express-adapter.mdx +6 -7
  195. package/.docs/raw/reference/server/hono-adapter.mdx +6 -7
  196. package/.docs/raw/reference/server/mastra-server.mdx +20 -20
  197. package/.docs/raw/reference/storage/cloudflare-d1.mdx +3 -3
  198. package/.docs/raw/reference/storage/cloudflare.mdx +2 -2
  199. package/.docs/raw/reference/storage/convex.mdx +6 -6
  200. package/.docs/raw/reference/storage/dynamodb.mdx +4 -4
  201. package/.docs/raw/reference/storage/lance.mdx +3 -3
  202. package/.docs/raw/reference/storage/libsql.mdx +69 -54
  203. package/.docs/raw/reference/storage/mongodb.mdx +80 -7
  204. package/.docs/raw/reference/storage/mssql.mdx +4 -4
  205. package/.docs/raw/{memory → reference}/storage/overview.mdx +12 -110
  206. package/.docs/raw/reference/storage/postgresql.mdx +78 -7
  207. package/.docs/raw/reference/storage/upstash.mdx +74 -2
  208. package/.docs/raw/reference/streaming/agents/stream.mdx +5 -5
  209. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +2 -2
  210. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
  211. package/.docs/raw/reference/streaming/workflows/resumeStream.mdx +1 -1
  212. package/.docs/raw/reference/streaming/workflows/stream.mdx +2 -2
  213. package/.docs/raw/reference/streaming/workflows/timeTravelStream.mdx +4 -4
  214. package/.docs/raw/reference/templates/overview.mdx +1 -2
  215. package/.docs/raw/reference/tools/create-tool.mdx +1 -4
  216. package/.docs/raw/reference/tools/vector-query-tool.mdx +1 -1
  217. package/.docs/raw/reference/vectors/astra.mdx +3 -3
  218. package/.docs/raw/reference/vectors/chroma.mdx +3 -3
  219. package/.docs/raw/reference/vectors/convex.mdx +12 -12
  220. package/.docs/raw/reference/vectors/couchbase.mdx +5 -5
  221. package/.docs/raw/reference/vectors/duckdb.mdx +10 -10
  222. package/.docs/raw/reference/vectors/elasticsearch.mdx +4 -4
  223. package/.docs/raw/reference/vectors/lance.mdx +4 -4
  224. package/.docs/raw/reference/vectors/libsql.mdx +61 -11
  225. package/.docs/raw/reference/vectors/mongodb.mdx +58 -5
  226. package/.docs/raw/reference/vectors/pg.mdx +53 -6
  227. package/.docs/raw/reference/vectors/pinecone.mdx +3 -3
  228. package/.docs/raw/reference/vectors/qdrant.mdx +3 -3
  229. package/.docs/raw/reference/vectors/s3vectors.mdx +6 -6
  230. package/.docs/raw/reference/vectors/turbopuffer.mdx +4 -4
  231. package/.docs/raw/reference/vectors/upstash.mdx +55 -6
  232. package/.docs/raw/reference/vectors/vectorize.mdx +3 -3
  233. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +2 -2
  234. package/.docs/raw/reference/workflows/run-methods/restart.mdx +1 -3
  235. package/.docs/raw/reference/workflows/run-methods/resume.mdx +2 -2
  236. package/.docs/raw/reference/workflows/run-methods/start.mdx +2 -2
  237. package/.docs/raw/reference/workflows/run-methods/startAsync.mdx +2 -2
  238. package/.docs/raw/reference/workflows/run-methods/timeTravel.mdx +5 -5
  239. package/.docs/raw/reference/workflows/run.mdx +1 -1
  240. package/.docs/raw/reference/workflows/step.mdx +3 -3
  241. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
  242. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  243. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +3 -3
  244. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
  245. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
  246. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +6 -6
  247. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +7 -7
  248. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  249. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +2 -2
  250. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +2 -2
  251. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +2 -2
  252. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  253. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +2 -2
  254. package/.docs/raw/reference/workflows/workflow.mdx +3 -3
  255. package/.docs/raw/server/auth/auth0.mdx +20 -14
  256. package/.docs/raw/server/auth/clerk.mdx +16 -9
  257. package/.docs/raw/server/auth/firebase.mdx +21 -15
  258. package/.docs/raw/server/auth/jwt.mdx +14 -7
  259. package/.docs/raw/server/auth/supabase.mdx +16 -9
  260. package/.docs/raw/server/auth/workos.mdx +19 -13
  261. package/.docs/raw/server/custom-adapters.mdx +10 -10
  262. package/.docs/raw/server/custom-api-routes.mdx +2 -4
  263. package/.docs/raw/server/mastra-client.mdx +24 -13
  264. package/.docs/raw/server/mastra-server.mdx +3 -3
  265. package/.docs/raw/server/middleware.mdx +7 -7
  266. package/.docs/raw/server/request-context.mdx +31 -30
  267. package/.docs/raw/server/server-adapters.mdx +6 -6
  268. package/.docs/raw/streaming/events.mdx +14 -7
  269. package/.docs/raw/streaming/overview.mdx +21 -10
  270. package/.docs/raw/streaming/tool-streaming.mdx +6 -6
  271. package/.docs/raw/streaming/workflow-streaming.mdx +6 -8
  272. package/.docs/raw/tools-mcp/advanced-usage.mdx +2 -2
  273. package/.docs/raw/tools-mcp/mcp-overview.mdx +31 -12
  274. package/.docs/raw/tools-mcp/overview.mdx +9 -10
  275. package/.docs/raw/voice/overview.mdx +1 -1
  276. package/.docs/raw/workflows/agents-and-tools.mdx +28 -19
  277. package/.docs/raw/workflows/control-flow.mdx +27 -40
  278. package/.docs/raw/workflows/error-handling.mdx +15 -22
  279. package/.docs/raw/workflows/human-in-the-loop.mdx +6 -7
  280. package/.docs/raw/workflows/inngest-workflow.mdx +8 -9
  281. package/.docs/raw/workflows/input-data-mapping.mdx +7 -7
  282. package/.docs/raw/workflows/overview.mdx +33 -22
  283. package/.docs/raw/workflows/snapshots.mdx +14 -44
  284. package/.docs/raw/workflows/suspend-and-resume.mdx +7 -7
  285. package/.docs/raw/workflows/time-travel.mdx +16 -16
  286. package/.docs/raw/workflows/workflow-state.mdx +5 -8
  287. package/CHANGELOG.md +9 -0
  288. package/dist/logger.d.ts +3 -0
  289. package/dist/logger.d.ts.map +1 -1
  290. package/dist/stdio.js +53 -0
  291. package/package.json +4 -4
  292. package/.docs/raw/memory/conversation-history.mdx +0 -24
  293. package/.docs/raw/memory/storage/memory-with-libsql.mdx +0 -140
  294. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +0 -150
  295. package/.docs/raw/memory/storage/memory-with-pg.mdx +0 -138
  296. package/.docs/raw/memory/storage/memory-with-upstash.mdx +0 -146
  297. package/.docs/raw/memory/threads-and-resources.mdx +0 -95
@@ -24,7 +24,7 @@ Clone this [boilerplate repository](https://github.com/mastra-ai/express-ts-boil
24
24
  <Tabs>
25
25
  <TabItem value="https" label="HTTPS">
26
26
 
27
- ```bash copy
27
+ ```bash
28
28
  git clone https://github.com/mastra-ai/express-ts-boilerplate.git
29
29
  cd express-ts-boilerplate
30
30
  npm install
@@ -33,7 +33,7 @@ npm install
33
33
  </TabItem>
34
34
  <TabItem value="ssh" label="SSH">
35
35
 
36
- ```bash copy
36
+ ```bash
37
37
  git clone git@github.com:mastra-ai/express-ts-boilerplate.git
38
38
  cd express-ts-boilerplate
39
39
  npm install
@@ -48,7 +48,7 @@ Inside your Express project directory, run [`mastra init`](/reference/v1/cli/mas
48
48
 
49
49
  When prompted, choose a provider (e.g. OpenAI) and enter your key:
50
50
 
51
- ```bash copy
51
+ ```bash
52
52
  npx mastra@beta init
53
53
  ```
54
54
 
@@ -64,13 +64,13 @@ You'll pass the `src/mastra/index.ts` file to the Express server adapter later.
64
64
 
65
65
  Install the Express server adapter package:
66
66
 
67
- ```bash copy
67
+ ```bash
68
68
  npm install @mastra/express@beta
69
69
  ```
70
70
 
71
71
  Open the Express entry file at `src/index.ts` and add the required import and initialization code:
72
72
 
73
- ```typescript copy {2-3,11-12} title="src/index.ts"
73
+ ```typescript {2-3,11-12} title="src/index.ts"
74
74
  import express, { type Request, type Response } from "express";
75
75
  import { MastraServer } from "@mastra/express";
76
76
  import { mastra } from "./mastra";
@@ -103,13 +103,13 @@ By default, Mastra's endpoints are added under the `/api` subpath and use your a
103
103
 
104
104
  Start your Express server:
105
105
 
106
- ```bash copy
106
+ ```bash
107
107
  npm run start
108
108
  ```
109
109
 
110
110
  In a separate terminal window, use `curl` to ask the weather agent:
111
111
 
112
- ```bash copy
112
+ ```bash
113
113
  curl -X POST http://localhost:3000/api/agents/weather-agent/generate -H "Content-Type: application/json" -d "{\"messages\":[{\"role\":\"user\",\"content\":\"What is the weather like in Seoul?\"}]}"
114
114
  ```
115
115
 
@@ -24,28 +24,28 @@ Run the following command to [create a new Hono app](https://hono.dev/docs/getti
24
24
  <Tabs groupId="pm">
25
25
  <TabItem value="npm" label="npm">
26
26
 
27
- ```bash copy
27
+ ```bash
28
28
  npm create hono@latest mastra-hono -- --template nodejs --install --pm npm
29
29
  ```
30
30
 
31
31
  </TabItem>
32
32
  <TabItem value="pnpm" label="pnpm">
33
33
 
34
- ```bash copy
34
+ ```bash
35
35
  pnpm create hono@latest mastra-hono --template nodejs --install --pm pnpm
36
36
  ```
37
37
 
38
38
  </TabItem>
39
39
  <TabItem value="yarn" label="yarn">
40
40
 
41
- ```bash copy
41
+ ```bash
42
42
  yarn create hono@latest mastra-hono --template nodejs --install --pm yarn
43
43
  ```
44
44
 
45
45
  </TabItem>
46
46
  <TabItem value="bun" label="bun">
47
47
 
48
- ```bash copy
48
+ ```bash
49
49
  bun create hono@latest mastra-hono --template nodejs --install --pm bun
50
50
  ```
51
51
 
@@ -63,7 +63,7 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
63
63
  <Tabs groupId="pm">
64
64
  <TabItem value="npm" label="npm">
65
65
 
66
- ```bash copy
66
+ ```bash
67
67
  cd mastra-hono
68
68
  npx mastra@beta init
69
69
  ```
@@ -71,7 +71,7 @@ npx mastra@beta init
71
71
  </TabItem>
72
72
  <TabItem value="pnpm" label="pnpm">
73
73
 
74
- ```bash copy
74
+ ```bash
75
75
  cd mastra-hono
76
76
  pnpm dlx mastra@beta init
77
77
  ```
@@ -79,7 +79,7 @@ pnpm dlx mastra@beta init
79
79
  </TabItem>
80
80
  <TabItem value="yarn" label="yarn">
81
81
 
82
- ```bash copy
82
+ ```bash
83
83
  cd mastra-hono
84
84
  yarn dlx mastra@beta init
85
85
  ```
@@ -87,7 +87,7 @@ yarn dlx mastra@beta init
87
87
  </TabItem>
88
88
  <TabItem value="bun" label="bun">
89
89
 
90
- ```bash copy
90
+ ```bash
91
91
  cd mastra-hono
92
92
  bunx mastra@beta init
93
93
  ```
@@ -110,28 +110,28 @@ Install the Hono server adapter package:
110
110
  <Tabs groupId="pm">
111
111
  <TabItem value="npm" label="npm">
112
112
 
113
- ```bash copy
113
+ ```bash
114
114
  npm install @mastra/hono@beta
115
115
  ```
116
116
 
117
117
  </TabItem>
118
118
  <TabItem value="pnpm" label="pnpm">
119
119
 
120
- ```bash copy
120
+ ```bash
121
121
  pnpm add @mastra/hono@beta
122
122
  ```
123
123
 
124
124
  </TabItem>
125
125
  <TabItem value="yarn" label="yarn">
126
126
 
127
- ```bash copy
127
+ ```bash
128
128
  yarn add @mastra/hono@beta
129
129
  ```
130
130
 
131
131
  </TabItem>
132
132
  <TabItem value="bun" label="bun">
133
133
 
134
- ```bash copy
134
+ ```bash
135
135
  bun add @mastra/hono@beta
136
136
  ```
137
137
 
@@ -140,7 +140,7 @@ bun add @mastra/hono@beta
140
140
 
141
141
  Open the Hono entry file at `src/index.ts` and add the required import and initialization code:
142
142
 
143
- ```typescript copy title="src/index.ts" {3-8,10-11,13}
143
+ ```typescript title="src/index.ts" {3-8,10-11,13}
144
144
  import { serve } from '@hono/node-server'
145
145
  import { Hono } from 'hono'
146
146
  import {
@@ -178,28 +178,28 @@ Start your Hono server:
178
178
  <Tabs groupId="pm">
179
179
  <TabItem value="npm" label="npm">
180
180
 
181
- ```bash copy
181
+ ```bash
182
182
  npm run dev
183
183
  ```
184
184
 
185
185
  </TabItem>
186
186
  <TabItem value="pnpm" label="pnpm">
187
187
 
188
- ```bash copy
188
+ ```bash
189
189
  pnpm run dev
190
190
  ```
191
191
 
192
192
  </TabItem>
193
193
  <TabItem value="yarn" label="yarn">
194
194
 
195
- ```bash copy
195
+ ```bash
196
196
  yarn run dev
197
197
  ```
198
198
 
199
199
  </TabItem>
200
200
  <TabItem value="bun" label="bun">
201
201
 
202
- ```bash copy
202
+ ```bash
203
203
  bun run dev
204
204
  ```
205
205
 
@@ -208,7 +208,7 @@ bun run dev
208
208
 
209
209
  In a separate terminal window, use `curl` to ask the weather agent:
210
210
 
211
- ```bash copy
211
+ ```bash
212
212
  curl -X POST http://localhost:3000/api/agents/weather-agent/generate -H "Content-Type: application/json" -d "{\"messages\":[{\"role\":\"user\",\"content\":\"What is the weather like in Seoul?\"}]}"
213
213
  ```
214
214
 
@@ -31,28 +31,28 @@ Run the following command to [create a new Next.js app](https://nextjs.org/docs/
31
31
  <Tabs groupId="pm">
32
32
  <TabItem value="npm" label="npm">
33
33
 
34
- ```bash copy
34
+ ```bash
35
35
  npx create-next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
36
36
  ```
37
37
 
38
38
  </TabItem>
39
39
  <TabItem value="pnpm" label="pnpm">
40
40
 
41
- ```bash copy
41
+ ```bash
42
42
  pnpm create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
43
43
  ```
44
44
 
45
45
  </TabItem>
46
46
  <TabItem value="yarn" label="yarn">
47
47
 
48
- ```bash copy
48
+ ```bash
49
49
  yarn create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
50
50
  ```
51
51
 
52
52
  </TabItem>
53
53
  <TabItem value="bun" label="bun">
54
54
 
55
- ```bash copy
55
+ ```bash
56
56
  bun create next-app@latest my-nextjs-agent --yes --ts --eslint --tailwind --src-dir --app --turbopack --no-react-compiler --no-import-alias
57
57
  ```
58
58
 
@@ -70,7 +70,7 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
70
70
  <Tabs groupId="pm">
71
71
  <TabItem value="npm" label="npm">
72
72
 
73
- ```bash copy
73
+ ```bash
74
74
  cd my-nextjs-agent
75
75
  npx --force mastra@beta init
76
76
  ```
@@ -78,7 +78,7 @@ npx --force mastra@beta init
78
78
  </TabItem>
79
79
  <TabItem value="pnpm" label="pnpm">
80
80
 
81
- ```bash copy
81
+ ```bash
82
82
  cd my-nextjs-agent
83
83
  pnpm dlx mastra@beta init
84
84
  ```
@@ -86,7 +86,7 @@ pnpm dlx mastra@beta init
86
86
  </TabItem>
87
87
  <TabItem value="yarn" label="yarn">
88
88
 
89
- ```bash copy
89
+ ```bash
90
90
  cd my-nextjs-agent
91
91
  yarn dlx mastra@beta init
92
92
  ```
@@ -94,7 +94,7 @@ yarn dlx mastra@beta init
94
94
  </TabItem>
95
95
  <TabItem value="bun" label="bun">
96
96
 
97
- ```bash copy
97
+ ```bash
98
98
  cd my-nextjs-agent
99
99
  bunx mastra@beta init
100
100
  ```
@@ -117,28 +117,28 @@ Install AI SDK UI along with the Mastra adapter:
117
117
  <Tabs groupId="pm">
118
118
  <TabItem value="npm" label="npm">
119
119
 
120
- ```bash copy
120
+ ```bash
121
121
  npm install @mastra/ai-sdk@beta @ai-sdk/react ai
122
122
  ```
123
123
 
124
124
  </TabItem>
125
125
  <TabItem value="pnpm" label="pnpm">
126
126
 
127
- ```bash copy
127
+ ```bash
128
128
  pnpm add @mastra/ai-sdk@beta @ai-sdk/react ai
129
129
  ```
130
130
 
131
131
  </TabItem>
132
132
  <TabItem value="yarn" label="yarn">
133
133
 
134
- ```bash copy
134
+ ```bash
135
135
  yarn add @mastra/ai-sdk@beta @ai-sdk/react ai
136
136
  ```
137
137
 
138
138
  </TabItem>
139
139
  <TabItem value="bun" label="bun">
140
140
 
141
- ```bash copy
141
+ ```bash
142
142
  bun add @mastra/ai-sdk@beta @ai-sdk/react ai
143
143
  ```
144
144
 
@@ -150,28 +150,28 @@ Next, initialize AI Elements. When prompted, choose the default options:
150
150
  <Tabs groupId="pm">
151
151
  <TabItem value="npm" label="npm">
152
152
 
153
- ```bash copy
153
+ ```bash
154
154
  npx ai-elements@latest
155
155
  ```
156
156
 
157
157
  </TabItem>
158
158
  <TabItem value="pnpm" label="pnpm">
159
159
 
160
- ```bash copy
160
+ ```bash
161
161
  pnpm dlx ai-elements@latest
162
162
  ```
163
163
 
164
164
  </TabItem>
165
165
  <TabItem value="yarn" label="yarn">
166
166
 
167
- ```bash copy
167
+ ```bash
168
168
  yarn dlx ai-elements@latest
169
169
  ```
170
170
 
171
171
  </TabItem>
172
172
  <TabItem value="bun" label="bun">
173
173
 
174
- ```bash copy
174
+ ```bash
175
175
  bunx ai-elements@latest
176
176
  ```
177
177
 
@@ -198,7 +198,7 @@ export async function POST(req: Request) {
198
198
  const params = await req.json();
199
199
  const stream = await handleChatStream({
200
200
  mastra,
201
- agentId: 'weatherAgent',
201
+ agentId: 'weather-agent',
202
202
  params: {
203
203
  ...params,
204
204
  memory: {
@@ -212,7 +212,7 @@ export async function POST(req: Request) {
212
212
  }
213
213
 
214
214
  export async function GET() {
215
- const memory = await mastra.getAgent('weatherAgent').getMemory()
215
+ const memory = await mastra.getAgentById('weather-agent').getMemory()
216
216
  let response = null
217
217
 
218
218
  try {
@@ -230,7 +230,7 @@ export async function GET() {
230
230
  }
231
231
  ```
232
232
 
233
- The POST route accepts a prompt and streams the agent's response back in AI SDK format, while the GET route fetches message history from memory so the UI can be hydrated when the client reloads.
233
+ The `POST` route accepts a prompt and streams the agent's response back in AI SDK format, while the `GET` route fetches message history from memory so the UI can be hydrated when the client reloads.
234
234
 
235
235
  ## Create a chat page
236
236
 
@@ -362,7 +362,6 @@ This component connects [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-u
362
362
 
363
363
  It renders the response text using the [`<MessageResponse>`](https://ai-sdk.dev/elements/components/message#messageresponse-) component, and shows any tool invocations with the [`<Tool>`](https://ai-sdk.dev/elements/components/tool) component.
364
364
 
365
-
366
365
  ## Test your agent
367
366
 
368
367
  1. Run your Next.js app with `npm run dev`
@@ -28,28 +28,28 @@ When prompted, choose a provider (e.g. OpenAI) and enter your key:
28
28
  <Tabs>
29
29
  <TabItem value="npm" label="npm">
30
30
 
31
- ```bash copy
31
+ ```bash
32
32
  npm create mastra@beta
33
33
  ```
34
34
 
35
35
  </TabItem>
36
36
  <TabItem value="pnpm" label="pnpm">
37
37
 
38
- ```bash copy
38
+ ```bash
39
39
  pnpm create mastra@beta
40
40
  ```
41
41
 
42
42
  </TabItem>
43
43
  <TabItem value="yarn" label="yarn">
44
44
 
45
- ```bash copy
45
+ ```bash
46
46
  yarn create mastra@beta
47
47
  ```
48
48
 
49
49
  </TabItem>
50
50
  <TabItem value="bun" label="bun">
51
51
 
52
- ```bash copy
52
+ ```bash
53
53
  bun create mastra@beta
54
54
  ```
55
55