@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.
- package/.docs/course/02-agent-tools-mcp/32-conclusion.md +1 -1
- package/.docs/docs/agents/code-mode.md +3 -3
- package/.docs/docs/agents/guardrails.md +1 -1
- package/.docs/docs/agents/{agent-approval.md → human-in-the-loop.md} +5 -5
- package/.docs/docs/agents/networks.md +3 -3
- package/.docs/docs/agents/overview.md +7 -7
- package/.docs/docs/agents/processors.md +3 -3
- package/.docs/docs/agents/{using-tools.md → tools.md} +7 -7
- package/.docs/docs/{server/auth → auth}/custom-auth-provider.md +1 -1
- package/.docs/docs/{server/auth → auth}/fga.md +27 -1
- package/.docs/docs/{server/auth.md → auth/overview.md} +4 -4
- package/.docs/docs/{server/auth → auth}/simple-auth.md +1 -1
- package/.docs/docs/{server/auth → auth}/workers.md +2 -2
- package/.docs/docs/{capabilities/channels.md → channels.md} +2 -2
- package/.docs/docs/{agents → connections}/a2a.md +2 -2
- package/.docs/docs/{agents → connections}/acp.md +18 -6
- package/.docs/docs/{mcp/overview.md → connections/mcp.md} +1 -1
- package/.docs/docs/connections/overview.md +5 -5
- package/.docs/docs/{agents → connections}/sdk-agents.md +3 -1
- package/.docs/docs/deployment/cloud-providers.md +1 -0
- package/.docs/docs/deployment/mastra-server.md +2 -2
- package/.docs/docs/deployment/overview.md +2 -1
- package/.docs/docs/deployment/sandbox.md +3 -3
- package/.docs/docs/deployment/workers.md +4 -4
- package/.docs/docs/guides/context-engineering.md +297 -0
- package/.docs/docs/guides/multi-agent-systems.md +7 -7
- package/.docs/docs/guides/streaming.md +1 -1
- package/.docs/docs/harness/agent-controller.md +5 -3
- package/.docs/docs/{long-running-agents → harness}/background-tasks.md +5 -5
- package/.docs/docs/{long-running-agents → harness}/durable-agents.md +18 -2
- package/.docs/docs/{long-running-agents → harness}/goals.md +6 -6
- package/.docs/docs/harness/overview.md +11 -10
- package/.docs/docs/{long-running-agents → harness}/schedules.md +5 -5
- package/.docs/docs/{long-running-agents → harness}/signal-providers.md +4 -4
- package/.docs/docs/mastra-platform/deploy.md +1 -1
- package/.docs/docs/mastra-platform/overview.md +1 -1
- package/.docs/docs/mastra-platform/server.md +1 -1
- package/.docs/docs/memory/message-history.md +1 -1
- package/.docs/docs/memory/overview.md +4 -4
- package/.docs/docs/memory/working-memory.md +1 -1
- package/.docs/docs/observability/integrations/exporters/mastra-storage.md +1 -1
- package/.docs/docs/{workspace → sandbox}/filesystem.md +2 -2
- package/.docs/docs/{workspace → sandbox}/lsp.md +3 -3
- package/.docs/docs/{workspace/sandbox.md → sandbox/overview.md} +4 -3
- package/.docs/docs/{workspace → sandbox}/search.md +2 -2
- package/.docs/docs/{workspace → sandbox}/skills.md +5 -5
- package/.docs/docs/server/custom-api-routes.md +2 -2
- package/.docs/docs/server/mastra-client.md +2 -2
- package/.docs/docs/server/{mastra-server.md → overview.md} +3 -3
- package/.docs/docs/server/pubsub.md +2 -2
- package/.docs/docs/server/server-adapters.md +4 -4
- package/.docs/docs/{agents/skills.md → skills.md} +4 -4
- package/.docs/docs/{storage/overview.md → storage.md} +2 -1
- package/.docs/docs/studio/auth.md +4 -4
- package/.docs/docs/studio/overview.md +2 -2
- package/.docs/docs/{capabilities/subagents.md → subagents.md} +35 -5
- package/.docs/docs/workflows/agents-and-tools.md +1 -1
- package/.docs/docs/workflows/control-flow.md +0 -4
- package/.docs/docs/workflows/human-in-the-loop.md +0 -4
- package/.docs/docs/workflows/overview.md +1 -1
- package/.docs/docs/workflows/scheduled-workflows.md +2 -2
- package/.docs/docs/workflows/snapshots.md +1 -1
- package/.docs/docs/workflows/suspend-and-resume.md +0 -4
- package/.docs/integrations/agentic-ui/ai-sdk-ui.md +1 -1
- package/.docs/integrations/agentic-ui/copilotkit.md +1 -1
- package/.docs/integrations/auth/google.md +2 -2
- package/.docs/integrations/auth/workos.md +1 -1
- package/.docs/integrations/browsers/agent-browser.md +2 -2
- package/.docs/integrations/browsers/browser-viewer.md +6 -6
- package/.docs/integrations/browsers/firecrawl.md +1 -1
- package/.docs/integrations/browsers/stagehand.md +2 -2
- package/.docs/integrations/channels/discord.md +2 -2
- package/.docs/integrations/channels/github.md +1 -1
- package/.docs/integrations/channels/imessage.md +4 -4
- package/.docs/integrations/channels/slack.md +5 -5
- package/.docs/integrations/channels/teams.md +2 -2
- package/.docs/integrations/channels/telegram.md +2 -2
- package/.docs/integrations/channels/whatsapp.md +2 -2
- package/.docs/integrations/databases/postgresql.md +1 -0
- package/.docs/integrations/deploy/amazon-ec2.md +2 -2
- package/.docs/integrations/deploy/aws-lambda.md +3 -3
- package/.docs/integrations/deploy/azure-app-services.md +2 -2
- package/.docs/integrations/deploy/cloudflare.md +2 -2
- package/.docs/integrations/deploy/digital-ocean.md +3 -3
- package/.docs/integrations/deploy/kubernetes.md +11 -11
- package/.docs/integrations/deploy/netlify.md +3 -3
- package/.docs/integrations/deploy/render.md +389 -0
- package/.docs/integrations/deploy/vercel.md +2 -2
- package/.docs/integrations/file-storage/amazon-s3.md +1 -1
- package/.docs/integrations/file-storage/azure-blob.md +1 -1
- package/.docs/integrations/file-storage/google-cloud-storage.md +1 -1
- package/.docs/integrations/file-storage/mesa.md +2 -2
- package/.docs/integrations/file-storage/vercel-files.md +1 -1
- package/.docs/integrations/frameworks/astro.md +6 -2
- package/.docs/integrations/frameworks/electron.md +1 -1
- package/.docs/integrations/frameworks/express.md +1 -1
- package/.docs/integrations/frameworks/hono.md +1 -1
- package/.docs/integrations/frameworks/nestjs.md +1 -1
- package/.docs/integrations/frameworks/next-js.md +6 -2
- package/.docs/integrations/frameworks/nuxt.md +1 -1
- package/.docs/integrations/frameworks/sveltekit.md +1 -1
- package/.docs/integrations/frameworks/vite-react.md +6 -2
- package/.docs/integrations/sandboxes/agentcore.md +1 -1
- package/.docs/integrations/sandboxes/apple-container.md +1 -1
- package/.docs/integrations/sandboxes/cloudflare-sandbox.md +118 -0
- package/.docs/integrations/sandboxes/daytona.md +1 -1
- package/.docs/integrations/sandboxes/docker.md +4 -3
- package/.docs/integrations/sandboxes/e2b.md +1 -1
- package/.docs/integrations/sandboxes/modal.md +1 -1
- package/.docs/integrations/sandboxes/railway.md +11 -0
- package/.docs/integrations.md +4 -0
- package/.docs/models/environment-variables.md +9 -2
- package/.docs/models/gateways/merge-gateway.md +212 -0
- package/.docs/models/gateways/openrouter.md +3 -1
- package/.docs/models/gateways/vercel.md +22 -1
- package/.docs/models/gateways.md +1 -0
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/alibaba-token-plan-cn.md +2 -1
- package/.docs/models/providers/alibaba-token-plan.md +2 -1
- package/.docs/models/providers/ambient.md +2 -2
- package/.docs/models/providers/amd.md +73 -0
- package/.docs/models/providers/arcee.md +79 -0
- package/.docs/models/providers/baseten.md +1 -1
- package/.docs/models/providers/cerebras.md +2 -3
- package/.docs/models/providers/chutes.md +2 -1
- package/.docs/models/providers/cloudflare-workers-ai.md +3 -2
- package/.docs/models/providers/cortecs.md +2 -1
- package/.docs/models/providers/crof.md +1 -1
- package/.docs/models/providers/crossmodel.md +3 -2
- package/.docs/models/providers/deepinfra.md +5 -1
- package/.docs/models/providers/digitalocean.md +3 -2
- package/.docs/models/providers/echo.md +73 -0
- package/.docs/models/providers/edenai.md +26 -11
- package/.docs/models/providers/empiriolabs.md +11 -1
- package/.docs/models/providers/hetzner.md +6 -8
- package/.docs/models/providers/huggingface.md +4 -1
- package/.docs/models/providers/hyper.md +8 -7
- package/.docs/models/providers/inferx.md +19 -13
- package/.docs/models/providers/jalapeno.md +89 -0
- package/.docs/models/providers/kilo.md +12 -11
- package/.docs/models/providers/kosmik.md +73 -0
- package/.docs/models/providers/llmgateway.md +3 -3
- package/.docs/models/providers/llmtr.md +35 -10
- package/.docs/models/providers/nano-gpt.md +13 -17
- package/.docs/models/providers/ofox.md +8 -4
- package/.docs/models/providers/opencode-go.md +23 -22
- package/.docs/models/providers/requesty.md +143 -53
- package/.docs/models/providers/runinfra.md +76 -0
- package/.docs/models/providers/sakana.md +3 -2
- package/.docs/models/providers/scnet-token-plan.md +85 -0
- package/.docs/models/providers/scx-ai.md +76 -0
- package/.docs/models/providers/togetherai.md +2 -1
- package/.docs/models/providers/umans-ai-coding-plan.md +2 -1
- package/.docs/models/providers/umans-ai.md +2 -1
- package/.docs/models/providers/vivgrid.md +2 -1
- package/.docs/models/providers/wandb.md +2 -1
- package/.docs/models/providers/xai.md +2 -1
- package/.docs/models/providers.md +8 -2
- package/.docs/reference/acp/acp-agent.md +2 -2
- package/.docs/reference/acp/create-acp-tool.md +1 -1
- package/.docs/reference/agent-controller/agent-controller-class.md +2 -2
- package/.docs/reference/agents/agent.md +2 -2
- package/.docs/reference/agents/channels.md +2 -2
- package/.docs/reference/agents/createSkill.md +2 -2
- package/.docs/reference/agents/durable-agent.md +1 -1
- package/.docs/reference/agents/generate.md +3 -1
- package/.docs/reference/agents/getSkill.md +1 -1
- package/.docs/reference/agents/listSkills.md +1 -1
- package/.docs/reference/agents/listSuspendedRuns.md +6 -6
- package/.docs/reference/agents/listTools.md +2 -2
- package/.docs/reference/agents/network.md +3 -1
- package/.docs/reference/ai-sdk/chat-route.md +1 -1
- package/.docs/reference/ai-sdk/handle-chat-stream.md +1 -1
- package/.docs/reference/ai-sdk/handle-network-stream.md +2 -2
- package/.docs/reference/ai-sdk/handle-workflow-stream.md +1 -1
- package/.docs/reference/ai-sdk/network-route.md +2 -2
- package/.docs/reference/ai-sdk/to-ai-sdk-messages.md +1 -1
- package/.docs/reference/ai-sdk/to-ai-sdk-stream.md +1 -1
- package/.docs/reference/ai-sdk/workflow-route.md +1 -1
- package/.docs/reference/auth/fga.md +7 -5
- package/.docs/reference/auth/jwt.md +1 -1
- package/.docs/reference/browser/agent-browser.md +2 -2
- package/.docs/reference/browser/browser-viewer.md +2 -2
- package/.docs/reference/browser/firecrawl-browser.md +1 -1
- package/.docs/reference/browser/mastra-browser.md +1 -1
- package/.docs/reference/browser/stagehand-browser.md +2 -2
- package/.docs/reference/build-with-ai.md +2 -2
- package/.docs/reference/channels/channel-provider.md +1 -1
- package/.docs/reference/channels/slack-provider.md +1 -1
- package/.docs/reference/cli/mastra.md +2 -0
- package/.docs/reference/client-js/agents.md +24 -4
- package/.docs/reference/coding-agent/create-coding-agent.md +142 -13
- package/.docs/reference/configuration.md +6 -6
- package/.docs/reference/core/getEditor.md +1 -1
- package/.docs/reference/core/getMCPServer.md +1 -1
- package/.docs/reference/core/getMCPServerById.md +1 -1
- package/.docs/reference/core/getTool.md +1 -1
- package/.docs/reference/core/getToolById.md +1 -1
- package/.docs/reference/core/listMCPServers.md +1 -1
- package/.docs/reference/core/listTools.md +1 -1
- package/.docs/reference/core/removeWorkspace.md +1 -1
- package/.docs/reference/editor/mastra-editor.md +2 -2
- package/.docs/reference/editor/prompt-blocks.md +2 -2
- package/.docs/reference/editor/tool-provider.md +108 -1
- package/.docs/reference/editor/tools.md +1 -1
- package/.docs/reference/editor/versioning.md +3 -3
- package/.docs/reference/evals/prompt-alignment.md +18 -0
- package/.docs/reference/evals/rubric.md +1 -1
- package/.docs/reference/file-based-agents/memory.md +2 -2
- package/.docs/reference/file-based-agents/server.md +3 -3
- package/.docs/reference/file-based-agents/skills.md +1 -1
- package/.docs/reference/file-based-agents/storage.md +3 -3
- package/.docs/reference/file-based-agents/subagents.md +1 -1
- package/.docs/reference/file-based-agents/workspace.md +3 -3
- package/.docs/reference/index.md +1 -0
- package/.docs/reference/manual-install.md +3 -3
- package/.docs/reference/memory/memory-class.md +1 -0
- package/.docs/reference/memory/settled.md +57 -0
- package/.docs/reference/migrations/network-to-supervisor.md +2 -2
- package/.docs/reference/processors/provider-history-compat.md +6 -5
- package/.docs/reference/processors/skill-search-processor.md +3 -1
- package/.docs/reference/processors/token-limiter-processor.md +4 -0
- package/.docs/reference/processors/tool-call-filter.md +7 -7
- package/.docs/reference/processors/tool-search-processor.md +1 -1
- package/.docs/reference/project-structure.md +1 -1
- package/.docs/reference/pubsub/lease-provider.md +3 -3
- package/.docs/reference/pubsub/redis-streams.md +1 -1
- package/.docs/reference/rag/graph-rag.md +71 -8
- package/.docs/reference/rag/retrieval.md +26 -18
- package/.docs/reference/schedules/overview.md +1 -1
- package/.docs/reference/streaming/ChunkType.md +2 -2
- package/.docs/reference/streaming/agents/stream.md +29 -4
- package/.docs/reference/streaming/agents/streamUntilIdle.md +1 -1
- package/.docs/reference/tools/ask-user-tool.md +1 -1
- package/.docs/reference/tools/create-code-mode.md +1 -1
- package/.docs/reference/tools/create-tool.md +4 -4
- package/.docs/reference/tools/mcp-client.md +2 -0
- package/.docs/reference/tools/mcp-server.md +97 -4
- package/.docs/reference/tools/submit-plan-tool.md +1 -1
- package/.docs/reference/tools/task-tools.md +2 -2
- package/.docs/reference/vectors/vectorize.md +12 -2
- package/.docs/reference/workers/overview.md +2 -2
- package/.docs/reference/workflows/run-methods/resume.md +21 -0
- package/.docs/reference/workspace/local-filesystem.md +1 -1
- package/.docs/reference/workspace/local-sandbox.md +4 -3
- package/.docs/reference/workspace/platform-sandbox.md +11 -0
- package/.docs/reference/workspace/process-manager.md +20 -4
- package/.docs/reference/workspace/sandbox.md +1 -1
- package/.docs/reference/workspace/workspace-class.md +5 -5
- package/CHANGELOG.md +81 -0
- package/package.json +6 -6
- package/.docs/models/providers/merge-gateway.md +0 -265
- /package/.docs/docs/{server/auth → auth}/composite-auth.md +0 -0
- /package/.docs/docs/{server/auth → auth}/jwt.md +0 -0
- /package/.docs/docs/{browser/overview.md → browser.md} +0 -0
- /package/.docs/docs/{getting-started/develop.md → develop.md} +0 -0
- /package/.docs/docs/{long-running-agents → harness}/signals.md +0 -0
- /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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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/
|
|
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.
|
|
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.
|
|
32
|
-
"@mastra/core": "1.60.
|
|
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.
|
|
49
|
-
"@mastra/core": "1.60.
|
|
50
|
-
"@internal/types-builder": "0.0.
|
|
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
|
|
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
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|