@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
@@ -9,7 +9,7 @@ the `.recall()` method retrieves messages from a specific thread, with support f
9
9
 
10
10
  ## Usage Example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  await memory?.recall({ threadId: "user-123" });
14
14
  ```
15
15
 
@@ -138,7 +138,7 @@ await memory?.recall({ threadId: "user-123" });
138
138
 
139
139
  ## Extended usage example
140
140
 
141
- ```typescript title="src/test-memory.ts" showLineNumbers copy
141
+ ```typescript title="src/test-memory.ts"
142
142
  import { mastra } from "./mastra";
143
143
 
144
144
  const agent = mastra.getAgent("agent");
@@ -137,7 +137,7 @@ const prompt = await langfuse.getPrompt("customer-support");
137
137
  const agent = new Agent({
138
138
  name: "support-agent",
139
139
  instructions: prompt.prompt,
140
- model: openai("gpt-4o"),
140
+ model: "openai/gpt-4o",
141
141
  defaultGenerateOptions: {
142
142
  tracingOptions: buildTracingOptions(withLangfusePrompt(prompt)),
143
143
  },
@@ -9,7 +9,7 @@ The `BatchPartsProcessor` is an **output processor** that batches multiple strea
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { BatchPartsProcessor } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new BatchPartsProcessor({
@@ -93,7 +93,7 @@ const processor = new BatchPartsProcessor({
93
93
 
94
94
  ## Extended usage example
95
95
 
96
- ```typescript title="src/mastra/agents/batched-agent.ts" showLineNumbers copy
96
+ ```typescript title="src/mastra/agents/batched-agent.ts"
97
97
  import { Agent } from "@mastra/core/agent";
98
98
  import { BatchPartsProcessor } from "@mastra/core/processors";
99
99
 
@@ -9,7 +9,7 @@ The `LanguageDetector` is an **input processor** that identifies the language of
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { LanguageDetector } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new LanguageDetector({
@@ -136,7 +136,7 @@ const processor = new LanguageDetector({
136
136
 
137
137
  ## Extended usage example
138
138
 
139
- ```typescript title="src/mastra/agents/multilingual-agent.ts" showLineNumbers copy
139
+ ```typescript title="src/mastra/agents/multilingual-agent.ts"
140
140
  import { Agent } from "@mastra/core/agent";
141
141
  import { LanguageDetector } from "@mastra/core/processors";
142
142
 
@@ -9,7 +9,7 @@ The `MessageHistory` is a **hybrid processor** that handles both retrieval and p
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { MessageHistory } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new MessageHistory({
@@ -83,7 +83,7 @@ const processor = new MessageHistory({
83
83
 
84
84
  ## Extended usage example
85
85
 
86
- ```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers copy
86
+ ```typescript title="src/mastra/agents/memory-agent.ts"
87
87
  import { Agent } from "@mastra/core/agent";
88
88
  import { MessageHistory } from "@mastra/core/processors";
89
89
  import { PostgresStorage } from "@mastra/pg";
@@ -9,7 +9,7 @@ The `ModerationProcessor` is a **hybrid processor** that can be used for both in
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { ModerationProcessor } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new ModerationProcessor({
@@ -130,7 +130,7 @@ const processor = new ModerationProcessor({
130
130
 
131
131
  ### Input processing
132
132
 
133
- ```typescript title="src/mastra/agents/moderated-agent.ts" showLineNumbers copy
133
+ ```typescript title="src/mastra/agents/moderated-agent.ts"
134
134
  import { Agent } from "@mastra/core/agent";
135
135
  import { ModerationProcessor } from "@mastra/core/processors";
136
136
 
@@ -155,7 +155,7 @@ export const agent = new Agent({
155
155
 
156
156
  When using `ModerationProcessor` as an output processor, it's recommended to combine it with `BatchPartsProcessor` to optimize performance. The `BatchPartsProcessor` batches stream chunks together before passing them to the moderator, reducing the number of LLM calls required for moderation.
157
157
 
158
- ```typescript title="src/mastra/agents/output-moderated-agent.ts" showLineNumbers copy
158
+ ```typescript title="src/mastra/agents/output-moderated-agent.ts"
159
159
  import { Agent } from "@mastra/core/agent";
160
160
  import { BatchPartsProcessor, ModerationProcessor } from "@mastra/core/processors";
161
161
 
@@ -9,7 +9,7 @@ The `PIIDetector` is a **hybrid processor** that can be used for both input and
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { PIIDetector } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new PIIDetector({
@@ -137,7 +137,7 @@ const processor = new PIIDetector({
137
137
 
138
138
  ### Input processing
139
139
 
140
- ```typescript title="src/mastra/agents/private-agent.ts" showLineNumbers copy
140
+ ```typescript title="src/mastra/agents/private-agent.ts"
141
141
  import { Agent } from "@mastra/core/agent";
142
142
  import { PIIDetector } from "@mastra/core/processors";
143
143
 
@@ -164,7 +164,7 @@ export const agent = new Agent({
164
164
 
165
165
  When using `PIIDetector` as an output processor, it's recommended to combine it with `BatchPartsProcessor` to optimize performance. The `BatchPartsProcessor` batches stream chunks together before passing them to the PII detector, reducing the number of LLM calls required for detection.
166
166
 
167
- ```typescript title="src/mastra/agents/output-pii-agent.ts" showLineNumbers copy
167
+ ```typescript title="src/mastra/agents/output-pii-agent.ts"
168
168
  import { Agent } from "@mastra/core/agent";
169
169
  import { BatchPartsProcessor, PIIDetector } from "@mastra/core/processors";
170
170
 
@@ -70,7 +70,7 @@ The five processor methods run at different points in the agent execution lifecy
70
70
 
71
71
  ## Interface definition
72
72
 
73
- ```typescript copy
73
+ ```typescript
74
74
  interface Processor<TId extends string = string> {
75
75
  readonly id: TId;
76
76
  readonly name?: string;
@@ -108,7 +108,7 @@ interface Processor<TId extends string = string> {
108
108
 
109
109
  Processes input messages before they are sent to the LLM. Runs once at the start of agent execution.
110
110
 
111
- ```typescript copy
111
+ ```typescript
112
112
  processInput?(args: ProcessInputArgs): Promise<ProcessInputResult> | ProcessInputResult;
113
113
  ```
114
114
 
@@ -191,7 +191,7 @@ The method can return one of three types:
191
191
 
192
192
  Processes input messages at each step of the agentic loop, before they are sent to the LLM. Unlike `processInput` which runs once at the start, this runs at every step including tool call continuations.
193
193
 
194
- ```typescript copy
194
+ ```typescript
195
195
  processInputStep?(args: ProcessInputStepArgs): ProcessorMessageResult;
196
196
  ```
197
197
 
@@ -401,7 +401,7 @@ System messages are **reset to their original values** at the start of each step
401
401
 
402
402
  Processes streaming output chunks with built-in state management. Allows processors to accumulate chunks and make decisions based on larger context.
403
403
 
404
- ```typescript copy
404
+ ```typescript
405
405
  processOutputStream?(args: ProcessOutputStreamArgs): Promise<ChunkType | null | undefined>;
406
406
  ```
407
407
 
@@ -465,7 +465,7 @@ processOutputStream?(args: ProcessOutputStreamArgs): Promise<ChunkType | null |
465
465
 
466
466
  Processes the complete output result after streaming or generation is finished.
467
467
 
468
- ```typescript copy
468
+ ```typescript
469
469
  processOutputResult?(args: ProcessOutputResultArgs): ProcessorMessageResult;
470
470
  ```
471
471
 
@@ -512,7 +512,7 @@ processOutputResult?(args: ProcessOutputResultArgs): ProcessorMessageResult;
512
512
 
513
513
  Processes output after each LLM response in the agentic loop, before tool execution. Unlike `processOutputResult` which runs once at the end, this runs at every step. This is the ideal method for implementing guardrails that can trigger retries.
514
514
 
515
- ```typescript copy
515
+ ```typescript
516
516
  processOutputStep?(args: ProcessOutputStepArgs): ProcessorMessageResult;
517
517
  ```
518
518
 
@@ -598,7 +598,7 @@ processOutputStep?(args: ProcessOutputStepArgs): ProcessorMessageResult;
598
598
 
599
599
  #### Example: Quality guardrail with retry
600
600
 
601
- ```typescript title="src/mastra/processors/quality-guardrail.ts" showLineNumbers copy
601
+ ```typescript title="src/mastra/processors/quality-guardrail.ts"
602
602
  import type { Processor } from "@mastra/core";
603
603
 
604
604
  export class QualityGuardrail implements Processor {
@@ -629,7 +629,7 @@ export class QualityGuardrail implements Processor {
629
629
 
630
630
  Mastra provides type aliases to ensure processors implement the required methods:
631
631
 
632
- ```typescript copy
632
+ ```typescript
633
633
  // Must implement processInput OR processInputStep (or both)
634
634
  type InputProcessor = Processor & (
635
635
  | { processInput: required }
@@ -648,7 +648,7 @@ type OutputProcessor = Processor & (
648
648
 
649
649
  ### Basic input processor
650
650
 
651
- ```typescript title="src/mastra/processors/lowercase.ts" showLineNumbers copy
651
+ ```typescript title="src/mastra/processors/lowercase.ts"
652
652
  import type { Processor, MastraDBMessage } from "@mastra/core";
653
653
 
654
654
  export class LowercaseProcessor implements Processor {
@@ -672,7 +672,7 @@ export class LowercaseProcessor implements Processor {
672
672
 
673
673
  ### Per-step processor with processInputStep
674
674
 
675
- ```typescript title="src/mastra/processors/dynamic-model.ts" showLineNumbers copy
675
+ ```typescript title="src/mastra/processors/dynamic-model.ts"
676
676
  import type { Processor, ProcessInputStepArgs, ProcessInputStepResult } from "@mastra/core";
677
677
 
678
678
  export class DynamicModelProcessor implements Processor {
@@ -705,7 +705,7 @@ export class DynamicModelProcessor implements Processor {
705
705
 
706
706
  ### Message transformer with processInputStep
707
707
 
708
- ```typescript title="src/mastra/processors/reasoning-transformer.ts" showLineNumbers copy
708
+ ```typescript title="src/mastra/processors/reasoning-transformer.ts"
709
709
  import type { Processor, MastraDBMessage } from "@mastra/core";
710
710
 
711
711
  export class ReasoningTransformer implements Processor {
@@ -730,7 +730,7 @@ export class ReasoningTransformer implements Processor {
730
730
 
731
731
  ### Hybrid processor (input and output)
732
732
 
733
- ```typescript title="src/mastra/processors/content-filter.ts" showLineNumbers copy
733
+ ```typescript title="src/mastra/processors/content-filter.ts"
734
734
  import type { Processor, MastraDBMessage, ChunkType } from "@mastra/core";
735
735
 
736
736
  export class ContentFilter implements Processor {
@@ -768,7 +768,7 @@ export class ContentFilter implements Processor {
768
768
 
769
769
  ### Stream accumulator with state
770
770
 
771
- ```typescript title="src/mastra/processors/word-counter.ts" showLineNumbers copy
771
+ ```typescript title="src/mastra/processors/word-counter.ts"
772
772
  import type { Processor, ChunkType } from "@mastra/core";
773
773
 
774
774
  export class WordCounter implements Processor {
@@ -9,7 +9,7 @@ The `PromptInjectionDetector` is an **input processor** that detects and prevent
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { PromptInjectionDetector } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new PromptInjectionDetector({
@@ -115,7 +115,7 @@ const processor = new PromptInjectionDetector({
115
115
 
116
116
  ## Extended usage example
117
117
 
118
- ```typescript title="src/mastra/agents/secure-agent.ts" showLineNumbers copy
118
+ ```typescript title="src/mastra/agents/secure-agent.ts"
119
119
  import { Agent } from "@mastra/core/agent";
120
120
  import { PromptInjectionDetector } from "@mastra/core/processors";
121
121
 
@@ -9,7 +9,7 @@ The `SemanticRecall` is a **hybrid processor** that enables semantic search over
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { SemanticRecall } from "@mastra/core/processors";
14
14
  import { openai } from "@ai-sdk/openai";
15
15
 
@@ -133,7 +133,7 @@ const processor = new SemanticRecall({
133
133
 
134
134
  ## Extended usage example
135
135
 
136
- ```typescript title="src/mastra/agents/semantic-memory-agent.ts" showLineNumbers copy
136
+ ```typescript title="src/mastra/agents/semantic-memory-agent.ts"
137
137
  import { Agent } from "@mastra/core/agent";
138
138
  import { SemanticRecall, MessageHistory } from "@mastra/core/processors";
139
139
  import { PostgresStorage } from "@mastra/pg";
@@ -9,7 +9,7 @@ The `SystemPromptScrubber` is an **output processor** that detects and handles s
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { SystemPromptScrubber } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new SystemPromptScrubber({
@@ -123,7 +123,7 @@ const processor = new SystemPromptScrubber({
123
123
 
124
124
  When using `SystemPromptScrubber` as an output processor, it's recommended to combine it with `BatchPartsProcessor` to optimize performance. The `BatchPartsProcessor` batches stream chunks together before passing them to the scrubber, reducing the number of LLM calls required for detection.
125
125
 
126
- ```typescript title="src/mastra/agents/scrubbed-agent.ts" showLineNumbers copy
126
+ ```typescript title="src/mastra/agents/scrubbed-agent.ts"
127
127
  import { Agent } from "@mastra/core/agent";
128
128
  import { BatchPartsProcessor, SystemPromptScrubber } from "@mastra/core/processors";
129
129
 
@@ -9,7 +9,7 @@ The `TokenLimiterProcessor` is an **output processor** that limits the number of
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { TokenLimiterProcessor } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new TokenLimiterProcessor({
@@ -117,7 +117,7 @@ const processor = new TokenLimiterProcessor({
117
117
 
118
118
  ## Extended usage example
119
119
 
120
- ```typescript title="src/mastra/agents/limited-agent.ts" showLineNumbers copy
120
+ ```typescript title="src/mastra/agents/limited-agent.ts"
121
121
  import { Agent } from "@mastra/core/agent";
122
122
  import { TokenLimiterProcessor } from "@mastra/core/processors";
123
123
 
@@ -9,7 +9,7 @@ The `ToolCallFilter` is an **input processor** that filters out tool calls and t
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { ToolCallFilter } from "@mastra/core/processors";
14
14
 
15
15
  // Exclude all tool calls
@@ -74,7 +74,7 @@ const filterSpecific = new ToolCallFilter({
74
74
 
75
75
  ## Extended usage example
76
76
 
77
- ```typescript title="src/mastra/agents/filtered-agent.ts" showLineNumbers copy
77
+ ```typescript title="src/mastra/agents/filtered-agent.ts"
78
78
  import { Agent } from "@mastra/core/agent";
79
79
  import { ToolCallFilter } from "@mastra/core/processors";
80
80
 
@@ -99,7 +99,7 @@ export const agent = new Agent({
99
99
 
100
100
  ## Filtering all tool calls
101
101
 
102
- ```typescript copy
102
+ ```typescript
103
103
  import { Agent } from "@mastra/core/agent";
104
104
  import { ToolCallFilter } from "@mastra/core/processors";
105
105
 
@@ -9,7 +9,7 @@ The `UnicodeNormalizer` is an **input processor** that normalizes Unicode text t
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { UnicodeNormalizer } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new UnicodeNormalizer({
@@ -94,7 +94,7 @@ const processor = new UnicodeNormalizer({
94
94
 
95
95
  ## Extended usage example
96
96
 
97
- ```typescript title="src/mastra/agents/normalized-agent.ts" showLineNumbers copy
97
+ ```typescript title="src/mastra/agents/normalized-agent.ts"
98
98
  import { Agent } from "@mastra/core/agent";
99
99
  import { UnicodeNormalizer } from "@mastra/core/processors";
100
100
 
@@ -9,7 +9,7 @@ The `WorkingMemory` is an **input processor** that injects working memory data a
9
9
 
10
10
  ## Usage example
11
11
 
12
- ```typescript copy
12
+ ```typescript
13
13
  import { WorkingMemory } from "@mastra/core/processors";
14
14
 
15
15
  const processor = new WorkingMemory({
@@ -135,7 +135,7 @@ const processor = new WorkingMemory({
135
135
 
136
136
  ## Extended usage example
137
137
 
138
- ```typescript title="src/mastra/agents/personalized-agent.ts" showLineNumbers copy
138
+ ```typescript title="src/mastra/agents/personalized-agent.ts"
139
139
  import { Agent } from "@mastra/core/agent";
140
140
  import { WorkingMemory, MessageHistory } from "@mastra/core/processors";
141
141
  import { PostgresStorage } from "@mastra/pg";
@@ -173,7 +173,7 @@ export const agent = new Agent({
173
173
 
174
174
  ## JSON format example
175
175
 
176
- ```typescript copy
176
+ ```typescript
177
177
  import { WorkingMemory } from "@mastra/core/processors";
178
178
 
179
179
  const processor = new WorkingMemory({
@@ -112,7 +112,7 @@ See [ExtractParams reference](/reference/v1/rag/extract-params) for details on t
112
112
 
113
113
  Strategy-specific options are passed as top-level parameters alongside the strategy parameter. For example:
114
114
 
115
- ```typescript showLineNumbers copy
115
+ ```typescript
116
116
  // Character strategy example
117
117
  const chunks = await doc.chunk({
118
118
  strategy: "character",
@@ -9,7 +9,7 @@ ExtractParams configures metadata extraction from document chunks using LLM anal
9
9
 
10
10
  ## Example
11
11
 
12
- ```typescript showLineNumbers copy
12
+ ```typescript
13
13
  import { MDocument } from "@mastra/rag";
14
14
 
15
15
  const doc = MDocument.fromText(text);
@@ -188,7 +188,7 @@ The `extract` parameter accepts the following fields:
188
188
 
189
189
  ## Advanced Example
190
190
 
191
- ```typescript showLineNumbers copy
191
+ ```typescript
192
192
  import { MDocument } from "@mastra/rag";
193
193
 
194
194
  const doc = MDocument.fromText(text);
@@ -98,7 +98,7 @@ const results = await store.query({
98
98
  name: "$elemMatch",
99
99
  description: "Matches array elements meeting criteria",
100
100
  example: "{ scores: { $elemMatch: { $gt: 80 } } }",
101
- supportedBy: ["LibSQL", "PgVector", "MongoDB"],
101
+ supportedBy: ["libSQL", "PgVector", "MongoDB"],
102
102
  },
103
103
  ]}
104
104
  />
@@ -127,7 +127,7 @@ const results = await store.query({
127
127
  "Qdrant",
128
128
  "Upstash",
129
129
  "PgVector",
130
- "LibSQL",
130
+ "libSQL",
131
131
  "MongoDB",
132
132
  ],
133
133
  },
@@ -135,7 +135,7 @@ const results = await store.query({
135
135
  name: "$nor",
136
136
  description: "Logical NOR",
137
137
  example: '{ $nor: [{ status: "deleted" }, { archived: true }] }',
138
- supportedBy: ["Qdrant", "Upstash", "PgVector", "LibSQL", "MongoDB"],
138
+ supportedBy: ["Qdrant", "Upstash", "PgVector", "libSQL", "MongoDB"],
139
139
  },
140
140
  ]}
141
141
  />
@@ -159,7 +159,7 @@ const results = await store.query({
159
159
  name: "$contains",
160
160
  description: "Text contains substring",
161
161
  example: '{ description: { $contains: "sale" } }',
162
- supportedBy: ["Upstash", "LibSQL", "PgVector"],
162
+ supportedBy: ["Upstash", "libSQL", "PgVector"],
163
163
  },
164
164
  {
165
165
  name: "$regex",
@@ -171,7 +171,7 @@ const results = await store.query({
171
171
  name: "$size",
172
172
  description: "Array length check",
173
173
  example: "{ tags: { $size: { $gt: 2 } } }",
174
- supportedBy: ["Astra", "LibSQL", "PgVector", "MongoDB"],
174
+ supportedBy: ["Astra", "libSQL", "PgVector", "MongoDB"],
175
175
  },
176
176
  {
177
177
  name: "$geo",
@@ -263,7 +263,7 @@ const results = await store.query({
263
263
  - Vectors must be re-upserted after creating new metadata indexes to be included in filtered results
264
264
  - Range queries may have reduced accuracy with very large datasets (~10M+ vectors)
265
265
 
266
- ### LibSQL
266
+ ### libSQL
267
267
 
268
268
  - Supports nested object queries with dot notation
269
269
  - Array fields are validated to ensure they contain valid JSON arrays
@@ -338,7 +338,7 @@ const results = await store.query({
338
338
  - [Astra](/reference/v1/vectors/astra)
339
339
  - [Chroma](/reference/v1/vectors/chroma)
340
340
  - [Cloudflare Vectorize](/reference/v1/vectors/vectorize)
341
- - [LibSQL](/reference/v1/vectors/libsql)
341
+ - [libSQL](/reference/v1/vectors/libsql)
342
342
  - [MongoDB](/reference/v1/vectors/mongodb)
343
343
  - [PgStore](/reference/v1/vectors/pg)
344
344
  - [Pinecone](/reference/v1/vectors/pinecone)
@@ -11,13 +11,13 @@ The `createRoute()` function creates type-safe routes with Zod validation. When
11
11
 
12
12
  ## Import
13
13
 
14
- ```typescript copy
14
+ ```typescript
15
15
  import { createRoute } from '@mastra/server/server-adapter';
16
16
  ```
17
17
 
18
18
  ## Signature
19
19
 
20
- ```typescript copy
20
+ ```typescript
21
21
  function createRoute<TPath, TQuery, TBody, TResponse, TResponseType>(
22
22
  config: RouteConfig<TPath, TQuery, TBody, TResponse, TResponseType>
23
23
  ): ServerRoute
@@ -118,7 +118,7 @@ function createRoute<TPath, TQuery, TBody, TResponse, TResponseType>(
118
118
 
119
119
  The handler receives validated parameters plus runtime context:
120
120
 
121
- ```typescript copy showLineNumbers
121
+ ```typescript
122
122
  handler: async (params) => {
123
123
  // From schemas (typed from Zod)
124
124
  params.id; // From pathParamSchema
@@ -142,7 +142,7 @@ Returns a `ServerRoute` object that can be registered with an adapter.
142
142
 
143
143
  ### GET route with path params
144
144
 
145
- ```typescript copy showLineNumbers
145
+ ```typescript
146
146
  import { createRoute } from '@mastra/server/server-adapter';
147
147
  import { z } from 'zod';
148
148
 
@@ -167,7 +167,7 @@ const getAgent = createRoute({
167
167
 
168
168
  ### POST route with body
169
169
 
170
- ```typescript copy showLineNumbers
170
+ ```typescript
171
171
  const createItem = createRoute({
172
172
  method: 'POST',
173
173
  path: '/api/items',
@@ -190,7 +190,7 @@ const createItem = createRoute({
190
190
 
191
191
  ### Query params with coercion
192
192
 
193
- ```typescript copy showLineNumbers
193
+ ```typescript
194
194
  const listItems = createRoute({
195
195
  method: 'GET',
196
196
  path: '/api/items',
@@ -209,7 +209,7 @@ const listItems = createRoute({
209
209
 
210
210
  ### Streaming route
211
211
 
212
- ```typescript copy showLineNumbers
212
+ ```typescript
213
213
  const streamAgent = createRoute({
214
214
  method: 'POST',
215
215
  path: '/api/agents/:agentId/stream',
@@ -230,7 +230,7 @@ const streamAgent = createRoute({
230
230
 
231
231
  ### Custom body size limit
232
232
 
233
- ```typescript copy showLineNumbers
233
+ ```typescript
234
234
  const uploadRoute = createRoute({
235
235
  method: 'POST',
236
236
  path: '/api/upload',
@@ -249,7 +249,7 @@ const uploadRoute = createRoute({
249
249
 
250
250
  ### Passthrough for extensibility
251
251
 
252
- ```typescript copy
252
+ ```typescript
253
253
  const bodySchema = z.object({
254
254
  required: z.string(),
255
255
  }).passthrough(); // Allow unknown fields
@@ -257,7 +257,7 @@ const bodySchema = z.object({
257
257
 
258
258
  ### Date coercion
259
259
 
260
- ```typescript copy
260
+ ```typescript
261
261
  const querySchema = z.object({
262
262
  fromDate: z.coerce.date().optional(),
263
263
  toDate: z.coerce.date().optional(),
@@ -266,7 +266,7 @@ const querySchema = z.object({
266
266
 
267
267
  ### Union types
268
268
 
269
- ```typescript copy
269
+ ```typescript
270
270
  const bodySchema = z.object({
271
271
  messages: z.union([
272
272
  z.array(z.any()),
@@ -279,7 +279,7 @@ const bodySchema = z.object({
279
279
 
280
280
  Throw an error with a `status` property to return specific HTTP status codes from handlers. If using Hono, you can use `HTTPException` from `hono/http-exception`:
281
281
 
282
- ```typescript copy showLineNumbers
282
+ ```typescript
283
283
  import { createRoute } from '@mastra/server/server-adapter';
284
284
  import { HTTPException } from 'hono/http-exception';
285
285
 
@@ -300,7 +300,7 @@ const getAgent = createRoute({
300
300
 
301
301
  For Express or framework-agnostic code, throw an error with a `status` property:
302
302
 
303
- ```typescript copy showLineNumbers
303
+ ```typescript
304
304
  class HttpError extends Error {
305
305
  constructor(public status: number, message: string) {
306
306
  super(message);
@@ -25,7 +25,7 @@ For general adapter concepts (constructor options, initialization flow, etc.), s
25
25
 
26
26
  Install the Express adapter and Express framework:
27
27
 
28
- ```bash copy
28
+ ```bash
29
29
  npm install @mastra/express@beta express
30
30
  ```
31
31
 
@@ -35,7 +35,7 @@ npm install @mastra/express@beta express
35
35
 
36
36
  Create your server file:
37
37
 
38
- ```typescript title="server.ts" copy
38
+ ```typescript title="server.ts"
39
39
  import express from 'express';
40
40
  import { MastraServer } from '@mastra/express';
41
41
  import { mastra } from './mastra';
@@ -63,7 +63,7 @@ Express requires `express.json()` middleware for JSON body parsing. Add it befor
63
63
 
64
64
  ## Full example
65
65
 
66
- ```typescript title="server.ts" copy
66
+ ```typescript title="server.ts"
67
67
  import express from 'express';
68
68
  import { MastraServer } from '@mastra/express';
69
69
  import { mastra } from './mastra';
@@ -166,7 +166,7 @@ app.listen(4111);
166
166
 
167
167
  Add routes directly to the Express app:
168
168
 
169
- ```typescript title="server.ts" copy
169
+ ```typescript title="server.ts"
170
170
  const app = express();
171
171
  app.use(express.json());
172
172
 
@@ -196,7 +196,7 @@ Routes added before `init()` run without Mastra context. Add routes after `init(
196
196
 
197
197
  In Express middleware and routes, access Mastra context via `res.locals`:
198
198
 
199
- ```typescript copy
199
+ ```typescript
200
200
  app.get('/custom', (req, res) => {
201
201
  const mastra = res.locals.mastra;
202
202
  const requestContext = res.locals.requestContext;
@@ -223,7 +223,7 @@ Available properties on `res.locals`:
223
223
 
224
224
  Add Express middleware before or after `init()`:
225
225
 
226
- ```typescript title="server.ts" copy
226
+ ```typescript title="server.ts"
227
227
  const app = express();
228
228
  app.use(express.json());
229
229
 
@@ -239,7 +239,6 @@ await server.init();
239
239
  // Middleware after init has access to Mastra context
240
240
  app.use((req, res, next) => {
241
241
  const mastra = res.locals.mastra;
242
- // ...
243
242
  next();
244
243
  });
245
244
  ```