@mastra/mcp-docs-server 1.2.17-alpha.9 → 1.2.18-alpha.1

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 (258) hide show
  1. package/.docs/course/02-agent-tools-mcp/32-conclusion.md +1 -1
  2. package/.docs/docs/agents/code-mode.md +3 -3
  3. package/.docs/docs/agents/guardrails.md +1 -1
  4. package/.docs/docs/agents/{agent-approval.md → human-in-the-loop.md} +5 -5
  5. package/.docs/docs/agents/networks.md +3 -3
  6. package/.docs/docs/agents/overview.md +7 -7
  7. package/.docs/docs/agents/processors.md +3 -3
  8. package/.docs/docs/agents/{using-tools.md → tools.md} +7 -7
  9. package/.docs/docs/{server/auth → auth}/custom-auth-provider.md +1 -1
  10. package/.docs/docs/{server/auth → auth}/fga.md +27 -1
  11. package/.docs/docs/{server/auth.md → auth/overview.md} +4 -4
  12. package/.docs/docs/{server/auth → auth}/simple-auth.md +1 -1
  13. package/.docs/docs/{server/auth → auth}/workers.md +2 -2
  14. package/.docs/docs/{capabilities/channels.md → channels.md} +2 -2
  15. package/.docs/docs/{agents → connections}/a2a.md +2 -2
  16. package/.docs/docs/{agents → connections}/acp.md +18 -6
  17. package/.docs/docs/{mcp/overview.md → connections/mcp.md} +1 -1
  18. package/.docs/docs/connections/overview.md +5 -5
  19. package/.docs/docs/{agents → connections}/sdk-agents.md +3 -1
  20. package/.docs/docs/deployment/cloud-providers.md +1 -0
  21. package/.docs/docs/deployment/mastra-server.md +2 -2
  22. package/.docs/docs/deployment/overview.md +2 -1
  23. package/.docs/docs/deployment/sandbox.md +3 -3
  24. package/.docs/docs/deployment/workers.md +4 -4
  25. package/.docs/docs/guides/context-engineering.md +297 -0
  26. package/.docs/docs/guides/multi-agent-systems.md +7 -7
  27. package/.docs/docs/guides/streaming.md +1 -1
  28. package/.docs/docs/harness/agent-controller.md +5 -3
  29. package/.docs/docs/{long-running-agents → harness}/background-tasks.md +5 -5
  30. package/.docs/docs/{long-running-agents → harness}/durable-agents.md +18 -2
  31. package/.docs/docs/{long-running-agents → harness}/goals.md +6 -6
  32. package/.docs/docs/harness/overview.md +11 -10
  33. package/.docs/docs/{long-running-agents → harness}/schedules.md +5 -5
  34. package/.docs/docs/{long-running-agents → harness}/signal-providers.md +4 -4
  35. package/.docs/docs/mastra-platform/deploy.md +1 -1
  36. package/.docs/docs/mastra-platform/overview.md +1 -1
  37. package/.docs/docs/mastra-platform/server.md +1 -1
  38. package/.docs/docs/memory/message-history.md +1 -1
  39. package/.docs/docs/memory/overview.md +4 -4
  40. package/.docs/docs/memory/working-memory.md +1 -1
  41. package/.docs/docs/observability/integrations/exporters/mastra-storage.md +1 -1
  42. package/.docs/docs/{workspace → sandbox}/filesystem.md +2 -2
  43. package/.docs/docs/{workspace → sandbox}/lsp.md +3 -3
  44. package/.docs/docs/{workspace/sandbox.md → sandbox/overview.md} +4 -3
  45. package/.docs/docs/{workspace → sandbox}/search.md +2 -2
  46. package/.docs/docs/{workspace → sandbox}/skills.md +5 -5
  47. package/.docs/docs/server/custom-api-routes.md +2 -2
  48. package/.docs/docs/server/mastra-client.md +2 -2
  49. package/.docs/docs/server/{mastra-server.md → overview.md} +3 -3
  50. package/.docs/docs/server/pubsub.md +2 -2
  51. package/.docs/docs/server/server-adapters.md +4 -4
  52. package/.docs/docs/{agents/skills.md → skills.md} +4 -4
  53. package/.docs/docs/{storage/overview.md → storage.md} +2 -1
  54. package/.docs/docs/studio/auth.md +4 -4
  55. package/.docs/docs/studio/overview.md +2 -2
  56. package/.docs/docs/{capabilities/subagents.md → subagents.md} +35 -5
  57. package/.docs/docs/workflows/agents-and-tools.md +1 -1
  58. package/.docs/docs/workflows/control-flow.md +0 -4
  59. package/.docs/docs/workflows/human-in-the-loop.md +0 -4
  60. package/.docs/docs/workflows/overview.md +1 -1
  61. package/.docs/docs/workflows/scheduled-workflows.md +2 -2
  62. package/.docs/docs/workflows/snapshots.md +1 -1
  63. package/.docs/docs/workflows/suspend-and-resume.md +0 -4
  64. package/.docs/integrations/agentic-ui/ai-sdk-ui.md +1 -1
  65. package/.docs/integrations/agentic-ui/copilotkit.md +1 -1
  66. package/.docs/integrations/auth/google.md +2 -2
  67. package/.docs/integrations/auth/workos.md +1 -1
  68. package/.docs/integrations/browsers/agent-browser.md +2 -2
  69. package/.docs/integrations/browsers/browser-viewer.md +6 -6
  70. package/.docs/integrations/browsers/firecrawl.md +1 -1
  71. package/.docs/integrations/browsers/stagehand.md +2 -2
  72. package/.docs/integrations/channels/discord.md +2 -2
  73. package/.docs/integrations/channels/github.md +1 -1
  74. package/.docs/integrations/channels/imessage.md +4 -4
  75. package/.docs/integrations/channels/slack.md +5 -5
  76. package/.docs/integrations/channels/teams.md +2 -2
  77. package/.docs/integrations/channels/telegram.md +2 -2
  78. package/.docs/integrations/channels/whatsapp.md +2 -2
  79. package/.docs/integrations/databases/postgresql.md +1 -0
  80. package/.docs/integrations/deploy/amazon-ec2.md +2 -2
  81. package/.docs/integrations/deploy/aws-lambda.md +3 -3
  82. package/.docs/integrations/deploy/azure-app-services.md +2 -2
  83. package/.docs/integrations/deploy/cloudflare.md +2 -2
  84. package/.docs/integrations/deploy/digital-ocean.md +3 -3
  85. package/.docs/integrations/deploy/kubernetes.md +11 -11
  86. package/.docs/integrations/deploy/netlify.md +3 -3
  87. package/.docs/integrations/deploy/render.md +389 -0
  88. package/.docs/integrations/deploy/vercel.md +2 -2
  89. package/.docs/integrations/file-storage/amazon-s3.md +1 -1
  90. package/.docs/integrations/file-storage/azure-blob.md +1 -1
  91. package/.docs/integrations/file-storage/google-cloud-storage.md +1 -1
  92. package/.docs/integrations/file-storage/mesa.md +2 -2
  93. package/.docs/integrations/file-storage/vercel-files.md +1 -1
  94. package/.docs/integrations/frameworks/astro.md +6 -2
  95. package/.docs/integrations/frameworks/electron.md +1 -1
  96. package/.docs/integrations/frameworks/express.md +1 -1
  97. package/.docs/integrations/frameworks/hono.md +1 -1
  98. package/.docs/integrations/frameworks/nestjs.md +1 -1
  99. package/.docs/integrations/frameworks/next-js.md +6 -2
  100. package/.docs/integrations/frameworks/nuxt.md +1 -1
  101. package/.docs/integrations/frameworks/sveltekit.md +1 -1
  102. package/.docs/integrations/frameworks/vite-react.md +6 -2
  103. package/.docs/integrations/sandboxes/agentcore.md +1 -1
  104. package/.docs/integrations/sandboxes/apple-container.md +1 -1
  105. package/.docs/integrations/sandboxes/cloudflare-sandbox.md +118 -0
  106. package/.docs/integrations/sandboxes/daytona.md +1 -1
  107. package/.docs/integrations/sandboxes/docker.md +4 -3
  108. package/.docs/integrations/sandboxes/e2b.md +1 -1
  109. package/.docs/integrations/sandboxes/modal.md +1 -1
  110. package/.docs/integrations/sandboxes/railway.md +11 -0
  111. package/.docs/integrations.md +4 -0
  112. package/.docs/models/environment-variables.md +9 -2
  113. package/.docs/models/gateways/merge-gateway.md +212 -0
  114. package/.docs/models/gateways/openrouter.md +3 -1
  115. package/.docs/models/gateways/vercel.md +22 -1
  116. package/.docs/models/gateways.md +1 -0
  117. package/.docs/models/index.md +1 -1
  118. package/.docs/models/providers/alibaba-token-plan-cn.md +2 -1
  119. package/.docs/models/providers/alibaba-token-plan.md +2 -1
  120. package/.docs/models/providers/ambient.md +2 -2
  121. package/.docs/models/providers/amd.md +73 -0
  122. package/.docs/models/providers/arcee.md +79 -0
  123. package/.docs/models/providers/baseten.md +1 -1
  124. package/.docs/models/providers/cerebras.md +2 -3
  125. package/.docs/models/providers/chutes.md +2 -1
  126. package/.docs/models/providers/cloudflare-workers-ai.md +3 -2
  127. package/.docs/models/providers/cortecs.md +2 -1
  128. package/.docs/models/providers/crof.md +1 -1
  129. package/.docs/models/providers/crossmodel.md +3 -2
  130. package/.docs/models/providers/deepinfra.md +5 -1
  131. package/.docs/models/providers/digitalocean.md +3 -2
  132. package/.docs/models/providers/echo.md +73 -0
  133. package/.docs/models/providers/edenai.md +26 -11
  134. package/.docs/models/providers/empiriolabs.md +11 -1
  135. package/.docs/models/providers/hetzner.md +6 -8
  136. package/.docs/models/providers/huggingface.md +4 -1
  137. package/.docs/models/providers/hyper.md +8 -7
  138. package/.docs/models/providers/inferx.md +19 -13
  139. package/.docs/models/providers/jalapeno.md +89 -0
  140. package/.docs/models/providers/kilo.md +12 -11
  141. package/.docs/models/providers/kosmik.md +73 -0
  142. package/.docs/models/providers/llmgateway.md +3 -3
  143. package/.docs/models/providers/llmtr.md +35 -10
  144. package/.docs/models/providers/nano-gpt.md +13 -17
  145. package/.docs/models/providers/ofox.md +8 -4
  146. package/.docs/models/providers/opencode-go.md +23 -22
  147. package/.docs/models/providers/requesty.md +143 -53
  148. package/.docs/models/providers/runinfra.md +76 -0
  149. package/.docs/models/providers/sakana.md +3 -2
  150. package/.docs/models/providers/scnet-token-plan.md +85 -0
  151. package/.docs/models/providers/scx-ai.md +76 -0
  152. package/.docs/models/providers/togetherai.md +2 -1
  153. package/.docs/models/providers/umans-ai-coding-plan.md +2 -1
  154. package/.docs/models/providers/umans-ai.md +2 -1
  155. package/.docs/models/providers/vivgrid.md +2 -1
  156. package/.docs/models/providers/wandb.md +2 -1
  157. package/.docs/models/providers/xai.md +2 -1
  158. package/.docs/models/providers.md +8 -2
  159. package/.docs/reference/acp/acp-agent.md +2 -2
  160. package/.docs/reference/acp/create-acp-tool.md +1 -1
  161. package/.docs/reference/agent-controller/agent-controller-class.md +2 -2
  162. package/.docs/reference/agents/agent.md +2 -2
  163. package/.docs/reference/agents/channels.md +2 -2
  164. package/.docs/reference/agents/createSkill.md +2 -2
  165. package/.docs/reference/agents/durable-agent.md +1 -1
  166. package/.docs/reference/agents/generate.md +3 -1
  167. package/.docs/reference/agents/getSkill.md +1 -1
  168. package/.docs/reference/agents/listSkills.md +1 -1
  169. package/.docs/reference/agents/listSuspendedRuns.md +6 -6
  170. package/.docs/reference/agents/listTools.md +2 -2
  171. package/.docs/reference/agents/network.md +3 -1
  172. package/.docs/reference/ai-sdk/chat-route.md +1 -1
  173. package/.docs/reference/ai-sdk/handle-chat-stream.md +1 -1
  174. package/.docs/reference/ai-sdk/handle-network-stream.md +2 -2
  175. package/.docs/reference/ai-sdk/handle-workflow-stream.md +1 -1
  176. package/.docs/reference/ai-sdk/network-route.md +2 -2
  177. package/.docs/reference/ai-sdk/to-ai-sdk-messages.md +1 -1
  178. package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +1 -1
  179. package/.docs/reference/ai-sdk/workflow-route.md +1 -1
  180. package/.docs/reference/auth/fga.md +7 -5
  181. package/.docs/reference/auth/jwt.md +1 -1
  182. package/.docs/reference/browser/agent-browser.md +2 -2
  183. package/.docs/reference/browser/browser-viewer.md +2 -2
  184. package/.docs/reference/browser/firecrawl-browser.md +1 -1
  185. package/.docs/reference/browser/mastra-browser.md +1 -1
  186. package/.docs/reference/browser/stagehand-browser.md +2 -2
  187. package/.docs/reference/build-with-ai.md +2 -2
  188. package/.docs/reference/channels/channel-provider.md +1 -1
  189. package/.docs/reference/channels/slack-provider.md +1 -1
  190. package/.docs/reference/cli/mastra.md +2 -0
  191. package/.docs/reference/client-js/agents.md +24 -4
  192. package/.docs/reference/coding-agent/create-coding-agent.md +142 -13
  193. package/.docs/reference/configuration.md +6 -6
  194. package/.docs/reference/core/getEditor.md +1 -1
  195. package/.docs/reference/core/getMCPServer.md +1 -1
  196. package/.docs/reference/core/getMCPServerById.md +1 -1
  197. package/.docs/reference/core/getTool.md +1 -1
  198. package/.docs/reference/core/getToolById.md +1 -1
  199. package/.docs/reference/core/listMCPServers.md +1 -1
  200. package/.docs/reference/core/listTools.md +1 -1
  201. package/.docs/reference/core/removeWorkspace.md +1 -1
  202. package/.docs/reference/editor/mastra-editor.md +2 -2
  203. package/.docs/reference/editor/prompt-blocks.md +2 -2
  204. package/.docs/reference/editor/tool-provider.md +108 -1
  205. package/.docs/reference/editor/tools.md +1 -1
  206. package/.docs/reference/editor/versioning.md +3 -3
  207. package/.docs/reference/evals/prompt-alignment.md +18 -0
  208. package/.docs/reference/evals/rubric.md +1 -1
  209. package/.docs/reference/file-based-agents/memory.md +2 -2
  210. package/.docs/reference/file-based-agents/server.md +3 -3
  211. package/.docs/reference/file-based-agents/skills.md +1 -1
  212. package/.docs/reference/file-based-agents/storage.md +3 -3
  213. package/.docs/reference/file-based-agents/subagents.md +1 -1
  214. package/.docs/reference/file-based-agents/workspace.md +3 -3
  215. package/.docs/reference/index.md +1 -0
  216. package/.docs/reference/manual-install.md +3 -3
  217. package/.docs/reference/memory/memory-class.md +1 -0
  218. package/.docs/reference/memory/settled.md +57 -0
  219. package/.docs/reference/migrations/network-to-supervisor.md +2 -2
  220. package/.docs/reference/processors/provider-history-compat.md +6 -5
  221. package/.docs/reference/processors/skill-search-processor.md +3 -1
  222. package/.docs/reference/processors/token-limiter-processor.md +4 -0
  223. package/.docs/reference/processors/tool-call-filter.md +7 -7
  224. package/.docs/reference/processors/tool-search-processor.md +1 -1
  225. package/.docs/reference/project-structure.md +1 -1
  226. package/.docs/reference/pubsub/lease-provider.md +3 -3
  227. package/.docs/reference/pubsub/redis-streams.md +1 -1
  228. package/.docs/reference/rag/graph-rag.md +71 -8
  229. package/.docs/reference/rag/retrieval.md +26 -18
  230. package/.docs/reference/schedules/overview.md +1 -1
  231. package/.docs/reference/streaming/ChunkType.md +2 -2
  232. package/.docs/reference/streaming/agents/stream.md +29 -4
  233. package/.docs/reference/streaming/agents/streamUntilIdle.md +1 -1
  234. package/.docs/reference/tools/ask-user-tool.md +1 -1
  235. package/.docs/reference/tools/create-code-mode.md +1 -1
  236. package/.docs/reference/tools/create-tool.md +4 -4
  237. package/.docs/reference/tools/mcp-client.md +2 -0
  238. package/.docs/reference/tools/mcp-server.md +97 -4
  239. package/.docs/reference/tools/submit-plan-tool.md +1 -1
  240. package/.docs/reference/tools/task-tools.md +2 -2
  241. package/.docs/reference/vectors/vectorize.md +12 -2
  242. package/.docs/reference/workers/overview.md +2 -2
  243. package/.docs/reference/workflows/run-methods/resume.md +21 -0
  244. package/.docs/reference/workspace/local-filesystem.md +1 -1
  245. package/.docs/reference/workspace/local-sandbox.md +4 -3
  246. package/.docs/reference/workspace/platform-sandbox.md +11 -0
  247. package/.docs/reference/workspace/process-manager.md +20 -4
  248. package/.docs/reference/workspace/sandbox.md +1 -1
  249. package/.docs/reference/workspace/workspace-class.md +5 -5
  250. package/CHANGELOG.md +81 -0
  251. package/package.json +6 -6
  252. package/.docs/models/providers/merge-gateway.md +0 -265
  253. /package/.docs/docs/{server/auth → auth}/composite-auth.md +0 -0
  254. /package/.docs/docs/{server/auth → auth}/jwt.md +0 -0
  255. /package/.docs/docs/{browser/overview.md → browser.md} +0 -0
  256. /package/.docs/docs/{getting-started/develop.md → develop.md} +0 -0
  257. /package/.docs/docs/{long-running-agents → harness}/signals.md +0 -0
  258. /package/.docs/docs/{editor/overview.md → studio/editor.md} +0 -0
@@ -144,6 +144,15 @@ await sandbox.snapshot()
144
144
 
145
145
  Each `id` maps to one independent filesystem. Reusing the same `id` across unrelated sandboxes causes the platform to boot them from each other's checkpoint.
146
146
 
147
+ Set `seedCheckpointName` to provide a boot-only fallback when the checkpoint for `id` doesn't exist yet. The platform restores the checkpoint for `id` first when both exist. Later snapshots continue writing to the checkpoint for `id`, so the seed remains unchanged.
148
+
149
+ ```typescript
150
+ const sandbox = new PlatformSandbox({
151
+ id: `project-session-${sessionId}`,
152
+ seedCheckpointName: 'project-base',
153
+ })
154
+ ```
155
+
147
156
  ### Cloning for a fleet of sandboxes
148
157
 
149
158
  `clone()` returns an independent sibling `PlatformSandbox` that inherits credentials and defaults (access token, project, environment, network isolation, timeout, instructions, env, idle timeout) with per-instance overrides. The returned sandbox is unstarted and provisions on its own `start()`, so `clone()` performs no I/O:
@@ -187,6 +196,8 @@ console.log(result.exitCode)
187
196
 
188
197
  **sandboxId** (`string`): Existing sandbox ID to reattach to instead of creating a new sandbox. When set, environmentId is not required.
189
198
 
199
+ **seedCheckpointName** (`string`): Boot-only fallback checkpoint used when the primary recovery checkpoint for id has no stored state. Later snapshots continue writing to the checkpoint for id.
200
+
190
201
  **idleTimeoutMinutes** (`number`): How long the sandbox stays alive with no activity before the platform destroys it.
191
202
 
192
203
  **networkIsolation** (`'ISOLATED' | 'PRIVATE'`): Network mode. 'ISOLATED' (default) allows outbound internet only. 'PRIVATE' joins the platform environment's private network.
@@ -121,7 +121,7 @@ Information about a tracked process, returned by `list()`.
121
121
 
122
122
  ## `ProcessHandle`
123
123
 
124
- Handle to a spawned background process. Provides methods to read output, send stdin, wait for completion, and kill the process.
124
+ Handle to a spawned background process. Provides methods to read output, send or close stdin, wait for completion, and kill the process.
125
125
 
126
126
  You don't create `ProcessHandle` instances directly. They're returned by `spawn()` and `get()`.
127
127
 
@@ -141,8 +141,9 @@ console.log(handle.exitCode) // undefined while running
141
141
  // Wait for completion
142
142
  const result = await handle.wait()
143
143
 
144
- // Send stdin
144
+ // Send stdin and signal EOF
145
145
  await handle.sendStdin('input data\n')
146
+ await handle.closeStdin()
146
147
 
147
148
  // Kill the process
148
149
  await handle.kill()
@@ -162,7 +163,7 @@ await handle.kill()
162
163
 
163
164
  **reader** (`Readable`): Readable stream of stdout. Useful for protocols like LSP or JSON-RPC that communicate over stdio.
164
165
 
165
- **writer** (`Writable`): Writable stream to stdin. Useful for protocols like LSP or JSON-RPC that communicate over stdio.
166
+ **writer** (`Writable`): Writable stream to stdin. Ending the stream calls closeStdin(). Useful for protocols like LSP or JSON-RPC that communicate over stdio.
166
167
 
167
168
  ### Methods
168
169
 
@@ -228,6 +229,21 @@ await handle.sendStdin('console.log("hello")\n')
228
229
 
229
230
  **Returns:** `Promise<void>`
230
231
 
232
+ #### `closeStdin()`
233
+
234
+ Close the process's stdin to signal end-of-file (EOF). Use this after sending all input to commands that read until stdin closes. An exited process or an unavailable stdin causes a throw. Providers without a stdin close primitive throw `UnsupportedStdinCloseError`.
235
+
236
+ ```typescript
237
+ const handle = await sandbox.processes.spawn('cat')
238
+ await handle.sendStdin('input data\n')
239
+ await handle.closeStdin()
240
+ const result = await handle.wait()
241
+ ```
242
+
243
+ Calling `handle.writer.end()` also closes stdin. On providers without stdin close support, `writer.end()` finishes the stream without an error.
244
+
245
+ **Returns:** `Promise<void>`
246
+
231
247
  ## Stream interop
232
248
 
233
249
  `ProcessHandle` exposes `reader` and `writer` properties for integration with Node.js stream-based protocols like LSP or JSON-RPC:
@@ -291,7 +307,7 @@ When a process manager is provided, `MastraSandbox` automatically creates a defa
291
307
 
292
308
  ## Related
293
309
 
294
- - [Sandbox](https://mastra.ai/docs/workspace/sandbox)
310
+ - [Sandbox](https://mastra.ai/docs/sandbox/overview)
295
311
  - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
296
312
  - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
297
313
  - [E2BSandbox reference](https://mastra.ai/integrations/sandboxes/e2b)
@@ -102,6 +102,6 @@ const instructions = sandbox.getInstructions?.()
102
102
  ## Related
103
103
 
104
104
  - [SandboxProcessManager reference](https://mastra.ai/reference/workspace/process-manager)
105
- - [Sandbox](https://mastra.ai/docs/workspace/sandbox)
105
+ - [Sandbox](https://mastra.ai/docs/sandbox/overview)
106
106
  - [Workspace Class](https://mastra.ai/reference/workspace/workspace-class)
107
107
  - [Filesystem Interface](https://mastra.ai/reference/workspace/filesystem)
@@ -139,7 +139,7 @@ const workspace = new Workspace({
139
139
  })
140
140
  ```
141
141
 
142
- See [Filesystem tools](https://mastra.ai/docs/workspace/filesystem), [Sandbox tools](https://mastra.ai/docs/workspace/sandbox), [LSP inspection](https://mastra.ai/docs/workspace/lsp), and [Search tools](https://mastra.ai/docs/workspace/search) for capability-specific configuration.
142
+ See [Filesystem tools](https://mastra.ai/docs/sandbox/filesystem), [Sandbox tools](https://mastra.ai/docs/sandbox/overview), [LSP inspection](https://mastra.ai/docs/sandbox/lsp), and [Search tools](https://mastra.ai/docs/sandbox/search) for capability-specific configuration.
143
143
 
144
144
  ### Tool name remapping
145
145
 
@@ -460,7 +460,7 @@ Added when a filesystem is configured:
460
460
  | `mastra_workspace_mkdir` | Create a directory. Creates parent directories automatically if they don't exist. |
461
461
  | `mastra_workspace_grep` | Search file contents using regex patterns. Supports glob filtering, context lines, and case-insensitive search. |
462
462
 
463
- With a static filesystem, write tools (`write_file`, `edit_file`, `delete`, `mkdir`) are excluded when the filesystem is in read-only mode. With a [runtime-defined filesystem](https://mastra.ai/docs/workspace/filesystem), write tools are always included and read-only is enforced at runtime.
463
+ With a static filesystem, write tools (`write_file`, `edit_file`, `delete`, `mkdir`) are excluded when the filesystem is in read-only mode. With a [runtime-defined filesystem](https://mastra.ai/docs/sandbox/filesystem), write tools are always included and read-only is enforced at runtime.
464
464
 
465
465
  The `read_file` tool accepts `mediaTypes` and `maxMediaBytes` options to control which mime types are surfaced to the model as native media parts and how large those files can be:
466
466
 
@@ -492,7 +492,7 @@ Added when a sandbox is configured:
492
492
  | `mastra_workspace_get_process_output` | Get stdout, stderr, and status of a background process by PID. Accepts `tail` to limit output lines and `wait: true` to block until exit. Only available when the sandbox has a process manager. |
493
493
  | `mastra_workspace_kill_process` | Kill a background process by PID. Returns the last 50 lines of output. Only available when the sandbox has a process manager. |
494
494
 
495
- With a static sandbox, capability checks (`executeCommand`, `processes`) decide which tool variants are exposed. With a [runtime-defined sandbox](https://mastra.ai/docs/workspace/sandbox), all sandbox tools are registered and the runtime throws a clear error if the resolved sandbox doesn't implement a requested capability.
495
+ With a static sandbox, capability checks (`executeCommand`, `processes`) decide which tool variants are exposed. With a [runtime-defined sandbox](https://mastra.ai/docs/sandbox/overview), all sandbox tools are registered and the runtime throws a clear error if the resolved sandbox doesn't implement a requested capability.
496
496
 
497
497
  The `execute_command` tool accepts a `backgroundProcesses` option for lifecycle callbacks on background processes:
498
498
 
@@ -506,7 +506,7 @@ The `execute_command` tool accepts a `backgroundProcesses` option for lifecycle
506
506
 
507
507
  **backgroundProcesses.abortSignal** (`AbortSignal | null | false`): Abort signal for background processes. undefined (default) uses the agent's signal. null or false disables abort — processes persist after agent shutdown.
508
508
 
509
- See [Background processes](https://mastra.ai/docs/workspace/sandbox) for callback examples.
509
+ See [Background processes](https://mastra.ai/docs/sandbox/overview) for callback examples.
510
510
 
511
511
  ### Search tools
512
512
 
@@ -529,4 +529,4 @@ Added when skills are configured:
529
529
  | `skill_search` | Search across skill content. Accepts an optional list of skill names to filter and a `topK` parameter. |
530
530
  | `skill_read` | Read a specific file (reference, script, or asset) from a skill directory. |
531
531
 
532
- When multiple skills share the same name, `list()` returns all of them. `get()` with a name applies tie-breaking (local > managed > external). If two skills share the same name and source type, `get()` throws an error. Pass a skill's full path to `get()` to bypass tie-breaking. See [Skills with the same name](https://mastra.ai/docs/workspace/skills) for details.
532
+ When multiple skills share the same name, `list()` returns all of them. `get()` with a name applies tie-breaking (local > managed > external). If two skills share the same name and source type, `get()` throws an error. Pass a skill's full path to `get()` to bypass tie-breaking. See [Skills with the same name](https://mastra.ai/docs/sandbox/skills) for details.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,86 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.2.18-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`88d14ca`](https://github.com/mastra-ai/mastra/commit/88d14cac008582a618fecc3d5c7fd3bdf4f6ddc3), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`64cd7ac`](https://github.com/mastra-ai/mastra/commit/64cd7ac22c2c7a6e6b533a4b3a9ede432700f1fb), [`84a5b69`](https://github.com/mastra-ai/mastra/commit/84a5b699f84d6bae0a34efe5a970d891090b9f41), [`038b7b4`](https://github.com/mastra-ai/mastra/commit/038b7b405cb4ac25ab3f3031334111b1f87ac112), [`4132d61`](https://github.com/mastra-ai/mastra/commit/4132d61f8367077120ee9e6420d3224dffd93c93)]:
8
+ - @mastra/core@1.60.1-alpha.0
9
+ - @mastra/mcp@1.17.1-alpha.0
10
+
11
+ ## 1.2.17
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`587f6ef`](https://github.com/mastra-ai/mastra/commit/587f6efcfc25880b93760a8607d1cd381ec612fe), [`7e096f0`](https://github.com/mastra-ai/mastra/commit/7e096f02f0dddbf09b85d306458351245ed2f886), [`d7e6745`](https://github.com/mastra-ai/mastra/commit/d7e67456954863c55440ea9c49bc6ceb9949972d), [`6223446`](https://github.com/mastra-ai/mastra/commit/6223446ddce6166e96e0ba5e00d628b615dee8ca), [`15101bb`](https://github.com/mastra-ai/mastra/commit/15101bb53c0d934f31af6b8813b88191e382a5e5), [`4e7a421`](https://github.com/mastra-ai/mastra/commit/4e7a421dce8a48742f785d1e93ad2f43a572b282), [`c2c3deb`](https://github.com/mastra-ai/mastra/commit/c2c3debcf670c7082d0a5e553aa99818a864698c), [`d8308a2`](https://github.com/mastra-ai/mastra/commit/d8308a2be3c07e777393d1017a381dcae3890d30), [`b0a2a07`](https://github.com/mastra-ai/mastra/commit/b0a2a07800d42bd9823292e7db832374ed084c9c), [`74e5bd3`](https://github.com/mastra-ai/mastra/commit/74e5bd315b8b3a1e04cb6cf480bb0f5fc4951dc8), [`242e324`](https://github.com/mastra-ai/mastra/commit/242e3241e73cbd5c9bb86a31ebb49ca0256488d4), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`d774e89`](https://github.com/mastra-ai/mastra/commit/d774e8930c781df8c9effe3763e6b501c099b6cc), [`9c27a53`](https://github.com/mastra-ai/mastra/commit/9c27a53cd9d3de4f3f025bc387d94ce371c33f95), [`8f0a332`](https://github.com/mastra-ai/mastra/commit/8f0a3321bf180368d76fe7b36aa1a8f60f00b6de), [`0b4f108`](https://github.com/mastra-ai/mastra/commit/0b4f1089aa8d92e67c2a8e99726822c5ee410784), [`9acb50f`](https://github.com/mastra-ai/mastra/commit/9acb50f71cec9c362f06820033f90ae6b1f8282f), [`46e9e3f`](https://github.com/mastra-ai/mastra/commit/46e9e3f73babe1bc70080a596cf2ac0b9da48519), [`3f9a190`](https://github.com/mastra-ai/mastra/commit/3f9a19057c027155867b9317294ee4ca7bd0581a), [`dff25a1`](https://github.com/mastra-ai/mastra/commit/dff25a1103fa72ee082a9b6f805ebeb5ce400753), [`6db7a5d`](https://github.com/mastra-ai/mastra/commit/6db7a5dd3dd2b6f7ef75dcd804fcffef5fa83963), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`583e235`](https://github.com/mastra-ai/mastra/commit/583e23519c13af16c1746f9c49722d011216611b), [`b098de9`](https://github.com/mastra-ai/mastra/commit/b098de9d7cb9f672e0883a5c716465a3a689693d), [`e8808e3`](https://github.com/mastra-ai/mastra/commit/e8808e3d8eb585a2565be53e56a7e0e1477352a4), [`a77f8d4`](https://github.com/mastra-ai/mastra/commit/a77f8d4740d2178a74c41e4bf678b4fcd8fa0bb2), [`7f78585`](https://github.com/mastra-ai/mastra/commit/7f785857e401570e2ffb316911f126ed363aa537), [`33374ba`](https://github.com/mastra-ai/mastra/commit/33374ba359e4fb13eaa918ae925fe167a3c55414), [`940bf5c`](https://github.com/mastra-ai/mastra/commit/940bf5ccf04f2c9ebd8a1390431733222a03b1cd), [`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`58c43d3`](https://github.com/mastra-ai/mastra/commit/58c43d3f7cb2eeaeb8ac733ae71dde822348e588), [`ef6e295`](https://github.com/mastra-ai/mastra/commit/ef6e295b59bc25a5b61b633a89c97bcfce9fb465), [`208e1b3`](https://github.com/mastra-ai/mastra/commit/208e1b39f30f4b386e494394e9d71d96f0f90241), [`c938d34`](https://github.com/mastra-ai/mastra/commit/c938d34739936c8ecbabd67ad6a4a4396f41c4c6), [`88ddc7c`](https://github.com/mastra-ai/mastra/commit/88ddc7ce01d40175f13a3228b789a906779680bd), [`f2a4afd`](https://github.com/mastra-ai/mastra/commit/f2a4afd7e37e809669001ed17724b341a5c1f45e), [`d438148`](https://github.com/mastra-ai/mastra/commit/d438148e222c1e2fb3c652725ce75680962ebec4), [`ba05fe0`](https://github.com/mastra-ai/mastra/commit/ba05fe0738f70cb686777546e968237d09269142), [`40d358e`](https://github.com/mastra-ai/mastra/commit/40d358e29d55543803e64b49241122f598ffabc7), [`d26a8d4`](https://github.com/mastra-ai/mastra/commit/d26a8d4281f28414715b333c85bedaf70d0b2890), [`e80cd7e`](https://github.com/mastra-ai/mastra/commit/e80cd7e7683e7d732e1cc6784bcac1d2640d2ce3), [`ccbbcd9`](https://github.com/mastra-ai/mastra/commit/ccbbcd974eedff4367a54ed0e24c9ee742ab2f61), [`39ba1b9`](https://github.com/mastra-ai/mastra/commit/39ba1b9ce256a9a910a16f125cc6a59588185bfe), [`1d9a0ea`](https://github.com/mastra-ai/mastra/commit/1d9a0ea4a9901baee6cd56737243bd6d1f631ac0), [`677cdc6`](https://github.com/mastra-ai/mastra/commit/677cdc6af564dec29a13464d12b7ab2a4efc22e9), [`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`a7dd322`](https://github.com/mastra-ai/mastra/commit/a7dd32247d95afc539f483ca37f4594af0387f59), [`3f5c6f7`](https://github.com/mastra-ai/mastra/commit/3f5c6f728ea35da344248de9aa070f12849f3aa0), [`a318490`](https://github.com/mastra-ai/mastra/commit/a318490e17da32f338d50929c770d901a9b3dd72), [`b860493`](https://github.com/mastra-ai/mastra/commit/b86049391100e665d579f700c8a2034c036defc3), [`d4be8c1`](https://github.com/mastra-ai/mastra/commit/d4be8c1739d22d621e3f78790e1dd5eb5ecc3589), [`a5d2eb1`](https://github.com/mastra-ai/mastra/commit/a5d2eb10347eade1ae2816d88f466c25186c54a5), [`13d49d8`](https://github.com/mastra-ai/mastra/commit/13d49d82f434f319d4bd9a4234369d8186f8e102), [`0f53aeb`](https://github.com/mastra-ai/mastra/commit/0f53aeb119158bd9f83bd8ef667f1f675740e8f0), [`3667679`](https://github.com/mastra-ai/mastra/commit/3667679db057edfb086846d13369fdda4902ad65), [`49696e8`](https://github.com/mastra-ai/mastra/commit/49696e8e42f870674a0a58f5abcd22cc54dd2864), [`2ef2f23`](https://github.com/mastra-ai/mastra/commit/2ef2f230a7aed342e7dc3b2000cd42e4c43e08a7), [`763e0c6`](https://github.com/mastra-ai/mastra/commit/763e0c61e04d76ad9a9efd301aa57525ca0cbea9), [`20504b2`](https://github.com/mastra-ai/mastra/commit/20504b2ecebd0e077acda3d457ab57480a98ed3e), [`77e6b1b`](https://github.com/mastra-ai/mastra/commit/77e6b1bc4c46ce94fe501023fb4393c812ec6be3), [`c5f964d`](https://github.com/mastra-ai/mastra/commit/c5f964d3f77064e978f8066ec506eed77ba5c63c), [`23e0be2`](https://github.com/mastra-ai/mastra/commit/23e0be261381e49534b4ff3101c60ee64a946cbf), [`7fc8806`](https://github.com/mastra-ai/mastra/commit/7fc880627d3cbf995d31ea0e8b807bf15417e651), [`0e02eac`](https://github.com/mastra-ai/mastra/commit/0e02eacdb2e30e1697a41910b41163742a181dc1), [`4df174c`](https://github.com/mastra-ai/mastra/commit/4df174c32bddf093a82f273070b8380aef7c9e90), [`f7c25b5`](https://github.com/mastra-ai/mastra/commit/f7c25b5106ddfb48e591f98df7a51e0f2dd01dba), [`7aad631`](https://github.com/mastra-ai/mastra/commit/7aad631b43bc10db77d5b8c66b200d7a49d18bf2), [`512100a`](https://github.com/mastra-ai/mastra/commit/512100a7d8b7e9c920f2590c6b3612f5de0d3cff), [`e81744c`](https://github.com/mastra-ai/mastra/commit/e81744cd13c46619c142dc521dc0baac47607a84), [`f8f653f`](https://github.com/mastra-ai/mastra/commit/f8f653f10980d01a73706cc3c8689ca5e40ce808), [`dc09cc1`](https://github.com/mastra-ai/mastra/commit/dc09cc1083d861cde192c1cd235324dc75b8c731), [`9ef432b`](https://github.com/mastra-ai/mastra/commit/9ef432b6faa534b57b0d182a610e13dd9a7123ff), [`36b4649`](https://github.com/mastra-ai/mastra/commit/36b4649045a3a380cbab8ceca866db4086223aff), [`b9cf308`](https://github.com/mastra-ai/mastra/commit/b9cf30846f97f99ac1906ee8a68f4f2d117b0378), [`2e1d098`](https://github.com/mastra-ai/mastra/commit/2e1d0984e325fd319d32ea182f596b3170be3847), [`377eb81`](https://github.com/mastra-ai/mastra/commit/377eb81ce43b964e3a6b541df172da74a8ff3716), [`1794a79`](https://github.com/mastra-ai/mastra/commit/1794a79178c418004a7261b1ad9114066f7ef01d), [`0cdc5dc`](https://github.com/mastra-ai/mastra/commit/0cdc5dc69024957815da4f51acc4119eb4f447d7), [`5740ec6`](https://github.com/mastra-ai/mastra/commit/5740ec60c760ffdfbfaa59d603d03b847c864e05)]:
16
+ - @mastra/core@1.60.0
17
+ - @mastra/mcp@1.17.0
18
+
19
+ ## 1.2.17-alpha.21
20
+
21
+ ### Patch Changes
22
+
23
+ - Updated dependencies [[`58c43d3`](https://github.com/mastra-ai/mastra/commit/58c43d3f7cb2eeaeb8ac733ae71dde822348e588)]:
24
+ - @mastra/core@1.60.0-alpha.14
25
+
26
+ ## 1.2.17-alpha.20
27
+
28
+ ### Patch Changes
29
+
30
+ - Updated dependencies [[`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`c549e2f`](https://github.com/mastra-ai/mastra/commit/c549e2f40edc1cac5d9e74e82f90da22b48df084), [`2ef2f23`](https://github.com/mastra-ai/mastra/commit/2ef2f230a7aed342e7dc3b2000cd42e4c43e08a7), [`5740ec6`](https://github.com/mastra-ai/mastra/commit/5740ec60c760ffdfbfaa59d603d03b847c864e05)]:
31
+ - @mastra/core@1.60.0-alpha.13
32
+
33
+ ## 1.2.17-alpha.19
34
+
35
+ ### Patch Changes
36
+
37
+ - Updated dependencies [[`6db7a5d`](https://github.com/mastra-ai/mastra/commit/6db7a5dd3dd2b6f7ef75dcd804fcffef5fa83963), [`0cdc5dc`](https://github.com/mastra-ai/mastra/commit/0cdc5dc69024957815da4f51acc4119eb4f447d7)]:
38
+ - @mastra/core@1.60.0-alpha.12
39
+
40
+ ## 1.2.17-alpha.18
41
+
42
+ ### Patch Changes
43
+
44
+ - Updated dependencies [[`6223446`](https://github.com/mastra-ai/mastra/commit/6223446ddce6166e96e0ba5e00d628b615dee8ca), [`583e235`](https://github.com/mastra-ai/mastra/commit/583e23519c13af16c1746f9c49722d011216611b), [`a77f8d4`](https://github.com/mastra-ai/mastra/commit/a77f8d4740d2178a74c41e4bf678b4fcd8fa0bb2), [`40d358e`](https://github.com/mastra-ai/mastra/commit/40d358e29d55543803e64b49241122f598ffabc7), [`e80cd7e`](https://github.com/mastra-ai/mastra/commit/e80cd7e7683e7d732e1cc6784bcac1d2640d2ce3), [`39ba1b9`](https://github.com/mastra-ai/mastra/commit/39ba1b9ce256a9a910a16f125cc6a59588185bfe), [`0f53aeb`](https://github.com/mastra-ai/mastra/commit/0f53aeb119158bd9f83bd8ef667f1f675740e8f0), [`20504b2`](https://github.com/mastra-ai/mastra/commit/20504b2ecebd0e077acda3d457ab57480a98ed3e)]:
45
+ - @mastra/core@1.60.0-alpha.11
46
+ - @mastra/mcp@1.17.0-alpha.2
47
+
48
+ ## 1.2.17-alpha.17
49
+
50
+ ### Patch Changes
51
+
52
+ - Updated dependencies [[`b860493`](https://github.com/mastra-ai/mastra/commit/b86049391100e665d579f700c8a2034c036defc3)]:
53
+ - @mastra/core@1.60.0-alpha.10
54
+
55
+ ## 1.2.17-alpha.15
56
+
57
+ ### Patch Changes
58
+
59
+ - Updated dependencies [[`b0a2a07`](https://github.com/mastra-ai/mastra/commit/b0a2a07800d42bd9823292e7db832374ed084c9c), [`ccbbcd9`](https://github.com/mastra-ai/mastra/commit/ccbbcd974eedff4367a54ed0e24c9ee742ab2f61), [`3f5c6f7`](https://github.com/mastra-ai/mastra/commit/3f5c6f728ea35da344248de9aa070f12849f3aa0), [`77e6b1b`](https://github.com/mastra-ai/mastra/commit/77e6b1bc4c46ce94fe501023fb4393c812ec6be3), [`2e1d098`](https://github.com/mastra-ai/mastra/commit/2e1d0984e325fd319d32ea182f596b3170be3847)]:
60
+ - @mastra/core@1.60.0-alpha.9
61
+
62
+ ## 1.2.17-alpha.14
63
+
64
+ ### Patch Changes
65
+
66
+ - Updated dependencies [[`4e7a421`](https://github.com/mastra-ai/mastra/commit/4e7a421dce8a48742f785d1e93ad2f43a572b282), [`242e324`](https://github.com/mastra-ai/mastra/commit/242e3241e73cbd5c9bb86a31ebb49ca0256488d4), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`d774e89`](https://github.com/mastra-ai/mastra/commit/d774e8930c781df8c9effe3763e6b501c099b6cc), [`9c27a53`](https://github.com/mastra-ai/mastra/commit/9c27a53cd9d3de4f3f025bc387d94ce371c33f95), [`dff25a1`](https://github.com/mastra-ai/mastra/commit/dff25a1103fa72ee082a9b6f805ebeb5ce400753), [`217e967`](https://github.com/mastra-ai/mastra/commit/217e9672d8b3160eb729d8e9f0044949e88da239), [`7f78585`](https://github.com/mastra-ai/mastra/commit/7f785857e401570e2ffb316911f126ed363aa537), [`f2a4afd`](https://github.com/mastra-ai/mastra/commit/f2a4afd7e37e809669001ed17724b341a5c1f45e), [`d438148`](https://github.com/mastra-ai/mastra/commit/d438148e222c1e2fb3c652725ce75680962ebec4), [`ba05fe0`](https://github.com/mastra-ai/mastra/commit/ba05fe0738f70cb686777546e968237d09269142), [`d26a8d4`](https://github.com/mastra-ai/mastra/commit/d26a8d4281f28414715b333c85bedaf70d0b2890), [`677cdc6`](https://github.com/mastra-ai/mastra/commit/677cdc6af564dec29a13464d12b7ab2a4efc22e9), [`a318490`](https://github.com/mastra-ai/mastra/commit/a318490e17da32f338d50929c770d901a9b3dd72), [`763e0c6`](https://github.com/mastra-ai/mastra/commit/763e0c61e04d76ad9a9efd301aa57525ca0cbea9), [`23e0be2`](https://github.com/mastra-ai/mastra/commit/23e0be261381e49534b4ff3101c60ee64a946cbf), [`7fc8806`](https://github.com/mastra-ai/mastra/commit/7fc880627d3cbf995d31ea0e8b807bf15417e651), [`0e02eac`](https://github.com/mastra-ai/mastra/commit/0e02eacdb2e30e1697a41910b41163742a181dc1), [`4df174c`](https://github.com/mastra-ai/mastra/commit/4df174c32bddf093a82f273070b8380aef7c9e90), [`f7c25b5`](https://github.com/mastra-ai/mastra/commit/f7c25b5106ddfb48e591f98df7a51e0f2dd01dba), [`dc09cc1`](https://github.com/mastra-ai/mastra/commit/dc09cc1083d861cde192c1cd235324dc75b8c731), [`36b4649`](https://github.com/mastra-ai/mastra/commit/36b4649045a3a380cbab8ceca866db4086223aff), [`377eb81`](https://github.com/mastra-ai/mastra/commit/377eb81ce43b964e3a6b541df172da74a8ff3716)]:
67
+ - @mastra/core@1.60.0-alpha.8
68
+ - @mastra/mcp@1.17.0-alpha.1
69
+
70
+ ## 1.2.17-alpha.12
71
+
72
+ ### Patch Changes
73
+
74
+ - Updated dependencies [[`940bf5c`](https://github.com/mastra-ai/mastra/commit/940bf5ccf04f2c9ebd8a1390431733222a03b1cd)]:
75
+ - @mastra/core@1.60.0-alpha.7
76
+
77
+ ## 1.2.17-alpha.10
78
+
79
+ ### Patch Changes
80
+
81
+ - Updated dependencies [[`0b4f108`](https://github.com/mastra-ai/mastra/commit/0b4f1089aa8d92e67c2a8e99726822c5ee410784), [`88ddc7c`](https://github.com/mastra-ai/mastra/commit/88ddc7ce01d40175f13a3228b789a906779680bd), [`a7dd322`](https://github.com/mastra-ai/mastra/commit/a7dd32247d95afc539f483ca37f4594af0387f59)]:
82
+ - @mastra/core@1.60.0-alpha.6
83
+
3
84
  ## 1.2.17-alpha.8
4
85
 
5
86
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.2.17-alpha.9",
3
+ "version": "1.2.18-alpha.1",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -28,8 +28,8 @@
28
28
  "jsdom": "^26.1.0",
29
29
  "local-pkg": "^1.1.2",
30
30
  "zod": "^4.4.3",
31
- "@mastra/mcp": "^1.17.0-alpha.0",
32
- "@mastra/core": "1.60.0-alpha.5"
31
+ "@mastra/mcp": "^1.17.1-alpha.0",
32
+ "@mastra/core": "1.60.1-alpha.0"
33
33
  },
34
34
  "devDependencies": {
35
35
  "@hono/node-server": "^2.0.0",
@@ -45,9 +45,9 @@
45
45
  "tsx": "^4.23.1",
46
46
  "typescript": "^6.0.3",
47
47
  "vitest": "4.1.10",
48
- "@internal/lint": "0.0.123",
49
- "@mastra/core": "1.60.0-alpha.5",
50
- "@internal/types-builder": "0.0.98"
48
+ "@internal/lint": "0.0.124",
49
+ "@mastra/core": "1.60.1-alpha.0",
50
+ "@internal/types-builder": "0.0.99"
51
51
  },
52
52
  "homepage": "https://mastra.ai",
53
53
  "repository": {
@@ -1,265 +0,0 @@
1
- > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
-
3
- # ![Merge Gateway logo](https://models.dev/logos/merge-gateway.svg)Merge Gateway
4
-
5
- Access 169 Merge Gateway models through Mastra's model router. Authentication is handled automatically using the `MERGE_GATEWAY_API_KEY` environment variable.
6
-
7
- Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
8
-
9
- ```bash
10
- MERGE_GATEWAY_API_KEY=your-api-key
11
- ```
12
-
13
- ```typescript
14
- import { Agent } from "@mastra/core/agent";
15
-
16
- const agent = new Agent({
17
- id: "my-agent",
18
- name: "My Agent",
19
- instructions: "You are a helpful assistant",
20
- model: "merge-gateway/anthropic/claude-3-7-sonnet-20250219"
21
- });
22
-
23
- // Generate a response
24
- const response = await agent.generate("Hello!");
25
-
26
- // Stream a response
27
- const stream = await agent.stream("Tell me a story");
28
- for await (const chunk of stream) {
29
- console.log(chunk);
30
- }
31
- ```
32
-
33
- > **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway) for details.
34
-
35
- ## Models
36
-
37
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
- | -------------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
- | `merge-gateway/anthropic/claude-3-7-sonnet-20250219` | 200K | | | | | | $3 | $15 |
40
- | `merge-gateway/anthropic/claude-fable-5` | 1.0M | | | | | | $10 | $50 |
41
- | `merge-gateway/anthropic/claude-haiku-4-5-20251001` | 200K | | | | | | $1 | $5 |
42
- | `merge-gateway/anthropic/claude-opus-4-1-20250805` | 200K | | | | | | $15 | $75 |
43
- | `merge-gateway/anthropic/claude-opus-4-20250514` | 200K | | | | | | $15 | $75 |
44
- | `merge-gateway/anthropic/claude-opus-4-5-20251101` | 200K | | | | | | $5 | $25 |
45
- | `merge-gateway/anthropic/claude-opus-4-6` | 1.0M | | | | | | $5 | $25 |
46
- | `merge-gateway/anthropic/claude-opus-4-7` | 1.0M | | | | | | $5 | $25 |
47
- | `merge-gateway/anthropic/claude-opus-4-8` | 1.0M | | | | | | $5 | $25 |
48
- | `merge-gateway/anthropic/claude-opus-5` | 1.0M | | | | | | $5 | $25 |
49
- | `merge-gateway/anthropic/claude-sonnet-4-20250514` | 200K | | | | | | $3 | $15 |
50
- | `merge-gateway/anthropic/claude-sonnet-4-5-20250929` | 200K | | | | | | $3 | $15 |
51
- | `merge-gateway/anthropic/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
52
- | `merge-gateway/anthropic/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
53
- | `merge-gateway/bytedance/dola-seed-2.0-code` | 256K | | | | | | $0.40 | $2 |
54
- | `merge-gateway/bytedance/dola-seed-2.0-code-preview` | 131K | | | | | | $0.50 | $3 |
55
- | `merge-gateway/bytedance/dola-seed-2.0-lite` | 131K | | | | | | $0.25 | $2 |
56
- | `merge-gateway/bytedance/dola-seed-2.0-mini` | 131K | | | | | | $0.10 | $0.40 |
57
- | `merge-gateway/bytedance/dola-seed-2.0-pro` | 131K | | | | | | $0.50 | $3 |
58
- | `merge-gateway/cohere/command-a-03-2025` | 256K | | | | | | $3 | $10 |
59
- | `merge-gateway/cohere/command-r-08-2024` | 128K | | | | | | $0.15 | $0.60 |
60
- | `merge-gateway/cohere/command-r-plus-08-2024` | 128K | | | | | | $3 | $10 |
61
- | `merge-gateway/cohere/command-r7b-12-2024` | 128K | | | | | | $0.04 | $0.15 |
62
- | `merge-gateway/deepseek/deepseek-r1` | 164K | | | | | | $1 | $5 |
63
- | `merge-gateway/deepseek/deepseek-v3` | 164K | | | | | | $0.58 | $2 |
64
- | `merge-gateway/deepseek/deepseek-v3.1` | 164K | | | | | | $0.50 | $2 |
65
- | `merge-gateway/deepseek/deepseek-v3.2` | 164K | | | | | | $0.28 | $0.45 |
66
- | `merge-gateway/deepseek/deepseek-v4-flash` | 1.0M | | | | | | $0.14 | $0.28 |
67
- | `merge-gateway/deepseek/deepseek-v4-flash-0731` | 1.0M | | | | | | $0.14 | $0.28 |
68
- | `merge-gateway/deepseek/deepseek-v4-pro` | 1.0M | | | | | | $0.43 | $0.87 |
69
- | `merge-gateway/deepseek/deepseek-v4-pro-0813` | 1.0M | | | | | | $0.43 | $0.87 |
70
- | `merge-gateway/google/gemini-2.5-computer-use-preview-10-2025` | 128K | | | | | | $1 | $10 |
71
- | `merge-gateway/google/gemini-2.5-flash` | 1.0M | | | | | | $0.30 | $3 |
72
- | `merge-gateway/google/gemini-2.5-flash-image` | 33K | | | | | | $0.30 | $3 |
73
- | `merge-gateway/google/gemini-2.5-flash-lite` | 1.0M | | | | | | $0.10 | $0.40 |
74
- | `merge-gateway/google/gemini-2.5-pro` | 1.0M | | | | | | $1 | $10 |
75
- | `merge-gateway/google/gemini-3-flash-preview` | 1.0M | | | | | | $0.50 | $3 |
76
- | `merge-gateway/google/gemini-3-pro-image` | 66K | | | | | | $2 | $12 |
77
- | `merge-gateway/google/gemini-3-pro-preview` | 1.0M | | | | | | $2 | $12 |
78
- | `merge-gateway/google/gemini-3.1-flash-image` | 33K | | | | | | $0.50 | $3 |
79
- | `merge-gateway/google/gemini-3.1-flash-lite` | 1.0M | | | | | | $0.25 | $2 |
80
- | `merge-gateway/google/gemini-3.1-flash-lite-preview` | 1.0M | | | | | | $0.25 | $2 |
81
- | `merge-gateway/google/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
82
- | `merge-gateway/google/gemini-3.1-pro-preview-customtools` | 1.0M | | | | | | $2 | $12 |
83
- | `merge-gateway/google/gemini-3.5-flash` | 1.0M | | | | | | $2 | $9 |
84
- | `merge-gateway/google/gemini-3.5-flash-lite` | 1.0M | | | | | | $0.30 | $3 |
85
- | `merge-gateway/google/gemini-3.6-flash` | 1.0M | | | | | | $2 | $8 |
86
- | `merge-gateway/google/gemini-3.7-flash` | 1.0M | | | | | | $0.75 | $4 |
87
- | `merge-gateway/google/gemini-embedding-001` | 2K | | | | | | $0.15 | — |
88
- | `merge-gateway/google/gemini-flash-latest` | 1.0M | | | | | | $2 | $9 |
89
- | `merge-gateway/google/gemini-flash-lite-latest` | 1.0M | | | | | | $0.25 | $2 |
90
- | `merge-gateway/google/gemma-4-26b-a4b-it` | 262K | | | | | | $0.13 | $0.40 |
91
- | `merge-gateway/google/gemma-4-31b-it` | 262K | | | | | | $0.14 | $0.40 |
92
- | `merge-gateway/meta/llama-3.1-8b-instruct` | 128K | | | | | | $0.22 | $0.22 |
93
- | `merge-gateway/meta/llama-3.3-70b-instruct` | 131K | | | | | | $0.22 | $0.50 |
94
- | `merge-gateway/meta/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
95
- | `merge-gateway/meta/muse-spark-1.2` | 1.0M | | | | | | $1 | $4 |
96
- | `merge-gateway/minimax/minimax-m2` | 205K | | | | | | $0.30 | $1 |
97
- | `merge-gateway/minimax/minimax-m2.1` | 205K | | | | | | $0.30 | $1 |
98
- | `merge-gateway/minimax/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
99
- | `merge-gateway/minimax/minimax-m2.5-highspeed` | 205K | | | | | | $0.60 | $2 |
100
- | `merge-gateway/minimax/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
101
- | `merge-gateway/minimax/minimax-m2.7-highspeed` | 205K | | | | | | $0.60 | $2 |
102
- | `merge-gateway/minimax/minimax-m3` | 1.0M | | | | | | $0.30 | $1 |
103
- | `merge-gateway/mistral/codestral-latest` | 256K | | | | | | $0.30 | $0.90 |
104
- | `merge-gateway/mistral/devstral-2512` | 256K | | | | | | $0.40 | $2 |
105
- | `merge-gateway/mistral/magistral-medium-latest` | 128K | | | | | | $2 | $5 |
106
- | `merge-gateway/mistral/mistral-large-2411` | 131K | | | | | | $2 | $6 |
107
- | `merge-gateway/mistral/mistral-large-2512` | 256K | | | | | | $0.50 | $2 |
108
- | `merge-gateway/mistral/mistral-large-latest` | 262K | | | | | | $0.50 | $2 |
109
- | `merge-gateway/mistral/mistral-medium-2505` | 128K | | | | | | $0.40 | $2 |
110
- | `merge-gateway/mistral/mistral-medium-latest` | 262K | | | | | | $0.40 | $2 |
111
- | `merge-gateway/mistral/mistral-small-latest` | 256K | | | | | | $0.15 | $0.60 |
112
- | `merge-gateway/mistral/pixtral-large-latest` | 128K | | | | | | $2 | $6 |
113
- | `merge-gateway/moonshot/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
114
- | `merge-gateway/moonshot/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
115
- | `merge-gateway/moonshot/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
116
- | `merge-gateway/moonshot/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
117
- | `merge-gateway/moonshot/kimi-k3` | 1.0M | | | | | | $3 | $15 |
118
- | `merge-gateway/nvidia/nemotron-3.5-lightning-30b-a3b` | 1.0M | | | | | | — | — |
119
- | `merge-gateway/nvidia/nemotron-nano-9b-v2` | 128K | | | | | | $0.06 | $0.23 |
120
- | `merge-gateway/openai/gpt-3.5-turbo` | 16K | | | | | | $0.50 | $2 |
121
- | `merge-gateway/openai/gpt-4` | 8K | | | | | | $30 | $60 |
122
- | `merge-gateway/openai/gpt-4-turbo` | 128K | | | | | | $10 | $30 |
123
- | `merge-gateway/openai/gpt-4.1` | 1.0M | | | | | | $2 | $8 |
124
- | `merge-gateway/openai/gpt-4.1-mini` | 1.0M | | | | | | $0.40 | $2 |
125
- | `merge-gateway/openai/gpt-4.1-nano` | 1.0M | | | | | | $0.10 | $0.40 |
126
- | `merge-gateway/openai/gpt-4o` | 128K | | | | | | $3 | $10 |
127
- | `merge-gateway/openai/gpt-4o-2024-05-13` | 128K | | | | | | $5 | $15 |
128
- | `merge-gateway/openai/gpt-4o-2024-08-06` | 128K | | | | | | $3 | $10 |
129
- | `merge-gateway/openai/gpt-4o-2024-11-20` | 128K | | | | | | $3 | $10 |
130
- | `merge-gateway/openai/gpt-4o-mini` | 128K | | | | | | $0.15 | $0.60 |
131
- | `merge-gateway/openai/gpt-5` | 400K | | | | | | $1 | $10 |
132
- | `merge-gateway/openai/gpt-5-chat-latest` | 128K | | | | | | $1 | $10 |
133
- | `merge-gateway/openai/gpt-5-mini` | 400K | | | | | | $0.25 | $2 |
134
- | `merge-gateway/openai/gpt-5-nano` | 400K | | | | | | $0.05 | $0.40 |
135
- | `merge-gateway/openai/gpt-5.1` | 400K | | | | | | $1 | $10 |
136
- | `merge-gateway/openai/gpt-5.1-chat-latest` | 128K | | | | | | $1 | $10 |
137
- | `merge-gateway/openai/gpt-5.2` | 400K | | | | | | $2 | $14 |
138
- | `merge-gateway/openai/gpt-5.2-chat-latest` | 128K | | | | | | $2 | $14 |
139
- | `merge-gateway/openai/gpt-5.3-chat-latest` | 128K | | | | | | $2 | $14 |
140
- | `merge-gateway/openai/gpt-5.4` | 1.1M | | | | | | $3 | $15 |
141
- | `merge-gateway/openai/gpt-5.4-mini` | 400K | | | | | | $0.75 | $5 |
142
- | `merge-gateway/openai/gpt-5.4-nano` | 400K | | | | | | $0.20 | $1 |
143
- | `merge-gateway/openai/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
144
- | `merge-gateway/openai/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
145
- | `merge-gateway/openai/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
146
- | `merge-gateway/openai/gpt-5.6-terra` | 1.1M | | | | | | $2 | $12 |
147
- | `merge-gateway/openai/gpt-oss-120b` | 131K | | | | | | $0.09 | $0.36 |
148
- | `merge-gateway/openai/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.20 |
149
- | `merge-gateway/openai/gpt-oss-safeguard-120b` | 4K | | | | | | $0.15 | $0.60 |
150
- | `merge-gateway/openai/o1` | 200K | | | | | | $15 | $60 |
151
- | `merge-gateway/openai/o3` | 200K | | | | | | $2 | $8 |
152
- | `merge-gateway/openai/o3-mini` | 200K | | | | | | $1 | $4 |
153
- | `merge-gateway/openai/o4-mini` | 200K | | | | | | $1 | $4 |
154
- | `merge-gateway/qwen/qwen-flash` | 1.0M | | | | | | $0.02 | $0.22 |
155
- | `merge-gateway/qwen/qwen-plus` | 1.0M | | | | | | $0.12 | $0.29 |
156
- | `merge-gateway/qwen/qwen3-235b-a22b` | 131K | | | | | | $0.29 | $1 |
157
- | `merge-gateway/qwen/qwen3-235b-a22b-instruct-2507` | 131K | | | | | | $0.10 | $0.60 |
158
- | `merge-gateway/qwen/qwen3-30b-a3b` | 131K | | | | | | $0.11 | $1 |
159
- | `merge-gateway/qwen/qwen3-32b` | 131K | | | | | | $0.15 | $0.60 |
160
- | `merge-gateway/qwen/qwen3-coder-480b-a35b-instruct` | 131K | | | | | | $0.22 | $2 |
161
- | `merge-gateway/qwen/qwen3-coder-flash` | 1.0M | | | | | | $0.14 | $0.57 |
162
- | `merge-gateway/qwen/qwen3-coder-next` | 262K | | | | | | $0.15 | $0.80 |
163
- | `merge-gateway/qwen/qwen3-coder-plus` | 1.0M | | | | | | $0.57 | $2 |
164
- | `merge-gateway/qwen/qwen3-max` | 262K | | | | | | $0.36 | $1 |
165
- | `merge-gateway/qwen/qwen3-next-80b-a3b-instruct` | 131K | | | | | | $0.14 | $0.57 |
166
- | `merge-gateway/qwen/qwen3-next-80b-a3b-thinking` | 131K | | | | | | $0.15 | $1 |
167
- | `merge-gateway/qwen/qwen3-vl-plus` | 262K | | | | | | $0.14 | $1 |
168
- | `merge-gateway/qwen/qwen3.5-122b-a10b` | 256K | | | | | | $0.12 | $0.92 |
169
- | `merge-gateway/qwen/qwen3.5-27b` | 256K | | | | | | $0.09 | $0.69 |
170
- | `merge-gateway/qwen/qwen3.5-35b-a3b` | 256K | | | | | | $0.06 | $0.46 |
171
- | `merge-gateway/qwen/qwen3.5-397b-a17b` | 256K | | | | | | $0.17 | $1 |
172
- | `merge-gateway/qwen/qwen3.5-9b` | 262K | | | | | | $0.09 | $0.13 |
173
- | `merge-gateway/qwen/qwen3.5-flash` | 1.0M | | | | | | $0.03 | $0.29 |
174
- | `merge-gateway/qwen/qwen3.5-plus` | 1.0M | | | | | | $0.12 | $0.69 |
175
- | `merge-gateway/qwen/qwen3.6-27b` | 131K | | | | | | $0.29 | $2 |
176
- | `merge-gateway/qwen/qwen3.6-35b-a3b` | 262K | | | | | | $0.25 | $1 |
177
- | `merge-gateway/qwen/qwen3.6-flash` | 1.0M | | | | | | $0.17 | $0.99 |
178
- | `merge-gateway/qwen/qwen3.6-max-preview` | 256K | | | | | | $1 | $8 |
179
- | `merge-gateway/qwen/qwen3.6-plus` | 1.0M | | | | | | $0.28 | $2 |
180
- | `merge-gateway/qwen/qwen3.7-max` | 1.0M | | | | | | $0.82 | $2 |
181
- | `merge-gateway/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
182
- | `merge-gateway/qwen/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
183
- | `merge-gateway/sakana/fugu-ultra` | 1.0M | | | | | | $5 | $30 |
184
- | `merge-gateway/thinkingmachines/inkling` | 1.0M | | | | | | $1 | $4 |
185
- | `merge-gateway/writer/palmyra-x4` | 128K | | | | | | $3 | $10 |
186
- | `merge-gateway/writer/palmyra-x5` | 1.0M | | | | | | $0.60 | $6 |
187
- | `merge-gateway/xai/grok-4.20-0309-non-reasoning` | 1.0M | | | | | | $1 | $3 |
188
- | `merge-gateway/xai/grok-4.20-0309-reasoning` | 1.0M | | | | | | $1 | $3 |
189
- | `merge-gateway/xai/grok-4.3` | 1.0M | | | | | | $1 | $3 |
190
- | `merge-gateway/xai/grok-4.5` | 500K | | | | | | $2 | $6 |
191
- | `merge-gateway/xai/grok-4.6` | 500K | | | | | | $2 | $5 |
192
- | `merge-gateway/xai/grok-build-0.1` | 256K | | | | | | $1 | $2 |
193
- | `merge-gateway/zai/glm-4.5` | 128K | | | | | | $0.60 | $2 |
194
- | `merge-gateway/zai/glm-4.5-air` | 128K | | | | | | $0.20 | $1 |
195
- | `merge-gateway/zai/glm-4.5v` | 128K | | | | | | $0.60 | $2 |
196
- | `merge-gateway/zai/glm-4.6` | 200K | | | | | | $0.60 | $2 |
197
- | `merge-gateway/zai/glm-4.7` | 200K | | | | | | $0.60 | $2 |
198
- | `merge-gateway/zai/glm-4.7-flash` | 200K | | | | | | $0.07 | $0.40 |
199
- | `merge-gateway/zai/glm-4.7-flashx` | 200K | | | | | | $0.07 | $0.40 |
200
- | `merge-gateway/zai/glm-5` | 200K | | | | | | $1 | $3 |
201
- | `merge-gateway/zai/glm-5-turbo` | 200K | | | | | | $1 | $4 |
202
- | `merge-gateway/zai/glm-5.1` | 200K | | | | | | $1 | $4 |
203
- | `merge-gateway/zai/glm-5.2` | 1.0M | | | | | | $1 | $3 |
204
-
205
- ## Advanced configuration
206
-
207
- ### Custom headers
208
-
209
- ```typescript
210
- const agent = new Agent({
211
- id: "custom-agent",
212
- name: "custom-agent",
213
- model: {
214
- url: "https://api-gateway.merge.dev/v1/ai-sdk",
215
- id: "merge-gateway/anthropic/claude-3-7-sonnet-20250219",
216
- apiKey: process.env.MERGE_GATEWAY_API_KEY,
217
- headers: {
218
- "X-Custom-Header": "value"
219
- }
220
- }
221
- });
222
- ```
223
-
224
- ### Dynamic model selection
225
-
226
- ```typescript
227
- const agent = new Agent({
228
- id: "dynamic-agent",
229
- name: "Dynamic Agent",
230
- model: ({ requestContext }) => {
231
- const useAdvanced = requestContext.task === "complex";
232
- return useAdvanced
233
- ? "merge-gateway/zai/glm-5.2"
234
- : "merge-gateway/anthropic/claude-3-7-sonnet-20250219";
235
- }
236
- });
237
- ```
238
-
239
- ## Direct provider installation
240
-
241
- This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/merge-gateway-ai-sdk-provider) for more details.
242
-
243
- **npm**:
244
-
245
- ```bash
246
- npm install merge-gateway-ai-sdk-provider
247
- ```
248
-
249
- **pnpm**:
250
-
251
- ```bash
252
- pnpm add merge-gateway-ai-sdk-provider
253
- ```
254
-
255
- **Yarn**:
256
-
257
- ```bash
258
- yarn add merge-gateway-ai-sdk-provider
259
- ```
260
-
261
- **Bun**:
262
-
263
- ```bash
264
- bun add merge-gateway-ai-sdk-provider
265
- ```
File without changes
File without changes