@mastra/mcp-docs-server 1.2.7-alpha.12 → 1.2.7-alpha.3
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/docs/agent-builder/integrations.md +2 -44
- package/.docs/docs/agent-builder/overview.md +3 -4
- package/.docs/docs/agent-builder/skill-registries.md +3 -1
- package/.docs/docs/agent-controller/overview.md +2 -3
- package/.docs/docs/agent-controller/session.md +3 -1
- package/.docs/docs/agents/a2a.md +1 -2
- package/.docs/docs/agents/channels.md +225 -0
- package/.docs/docs/agents/code-mode.md +1 -1
- package/.docs/docs/agents/file-based-agents.md +297 -0
- package/.docs/docs/agents/guardrails.md +9 -10
- package/.docs/docs/agents/overview.md +4 -4
- package/.docs/docs/agents/skills.md +5 -3
- package/.docs/docs/agents/structured-output.md +1 -1
- package/.docs/docs/agents/supervisor-agents.md +4 -3
- package/.docs/docs/agents/using-tools.md +4 -2
- package/.docs/docs/browser/agent-browser.md +3 -1
- package/.docs/docs/browser/browser-viewer.md +3 -1
- package/.docs/docs/browser/overview.md +1 -2
- package/.docs/docs/browser/stagehand.md +1 -1
- package/.docs/docs/deployment/mastra-server.md +4 -2
- package/.docs/docs/editor/overview.md +6 -2
- package/.docs/docs/editor/prompts.md +1 -1
- package/.docs/docs/editor/tools.md +5 -3
- package/.docs/docs/evals/custom-scorers.md +3 -1
- package/.docs/docs/evals/datasets/overview.md +5 -4
- package/.docs/docs/evals/datasets/running-experiments.md +2 -4
- package/.docs/docs/evals/evals-with-memory.md +3 -1
- package/.docs/docs/evals/gates-and-verdicts.md +3 -1
- package/.docs/docs/evals/overview.md +1 -4
- package/.docs/docs/evals/quick-checks.md +3 -1
- package/.docs/docs/long-running-agents/background-tasks.md +1 -1
- package/.docs/docs/long-running-agents/durable-agents.md +5 -3
- package/.docs/docs/long-running-agents/goals.md +3 -1
- package/.docs/docs/long-running-agents/signal-providers.md +3 -1
- package/.docs/docs/long-running-agents/signals.md +22 -11
- package/.docs/docs/mastra-platform/observability.md +1 -5
- package/.docs/docs/mcp/mcp-apps.md +3 -3
- package/.docs/docs/mcp/overview.md +10 -6
- package/.docs/docs/memory/observational-memory.md +1 -2
- package/.docs/docs/memory/overview.md +4 -6
- package/.docs/docs/memory/semantic-recall.md +1 -1
- package/.docs/docs/memory/working-memory.md +3 -3
- package/.docs/docs/observability/integrations/exporters/mastra-platform.md +3 -1
- package/.docs/docs/observability/logging.md +1 -1
- package/.docs/docs/observability/tracing/overview.md +1 -1
- package/.docs/docs/server/auth/auth0.md +1 -1
- package/.docs/docs/server/auth/better-auth.md +2 -2
- package/.docs/docs/server/auth/clerk.md +1 -1
- package/.docs/docs/server/auth/firebase.md +1 -1
- package/.docs/docs/server/auth/google.md +2 -2
- package/.docs/docs/server/auth/jwt.md +2 -2
- package/.docs/docs/server/auth/okta.md +2 -2
- package/.docs/docs/server/auth/workos.md +1 -1
- package/.docs/docs/server/mastra-client.md +1 -1
- package/.docs/docs/server/mastra-server.md +1 -1
- package/.docs/docs/server/pubsub.md +1 -1
- package/.docs/docs/server/request-context.md +4 -4
- package/.docs/docs/server/server-adapters.md +8 -8
- package/.docs/docs/studio/auth.md +3 -1
- package/.docs/docs/studio/overview.md +1 -1
- package/.docs/docs/voice/livekit.md +3 -100
- package/.docs/docs/workflows/agents-and-tools.md +5 -3
- package/.docs/docs/workflows/control-flow.md +3 -1
- package/.docs/docs/workflows/overview.md +7 -6
- package/.docs/docs/workspace/overview.md +1 -2
- package/.docs/docs/workspace/sandbox.md +0 -2
- package/.docs/guides/build-your-ui/assistant-ui.md +1 -1
- package/.docs/guides/build-your-ui/copilotkit/overview.md +1 -1
- package/.docs/guides/concepts/streaming.md +3 -3
- package/.docs/guides/getting-started/quickstart.md +1 -3
- package/.docs/guides/guide/chef-michel.md +2 -0
- package/.docs/guides/guide/slack-assistant.md +2 -2
- package/.docs/guides/guide/stock-agent.md +2 -0
- package/.docs/models/environment-variables.md +0 -7
- package/.docs/models/gateways/netlify.md +1 -4
- package/.docs/models/gateways/openrouter.md +7 -10
- package/.docs/models/gateways/vercel.md +1 -8
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/abacus.md +14 -44
- package/.docs/models/providers/google.md +1 -2
- package/.docs/models/providers/llmgateway.md +181 -185
- package/.docs/models/providers/nano-gpt.md +2 -2
- package/.docs/models/providers/neon.md +29 -40
- package/.docs/models/providers/nvidia.md +3 -1
- package/.docs/models/providers/openai.md +1 -6
- package/.docs/models/providers/opencode.md +2 -6
- package/.docs/models/providers/poolside.md +5 -6
- package/.docs/models/providers/routing-run.md +34 -23
- package/.docs/models/providers/the-grid-ai.md +3 -3
- package/.docs/models/providers/wandb.md +14 -21
- package/.docs/models/providers/xai.md +1 -2
- package/.docs/models/providers.md +0 -7
- package/.docs/reference/agents/channels.md +2 -2
- package/.docs/reference/channels/channel-provider.md +1 -1
- package/.docs/reference/channels/slack-provider.md +2 -2
- package/.docs/reference/cli/mastra.md +10 -117
- package/.docs/reference/evals/create-scorer.md +0 -8
- package/.docs/reference/index.md +0 -17
- package/.docs/reference/memory/memory-class.md +1 -1
- package/.docs/reference/memory/serialized-memory-config.md +1 -1
- package/.docs/reference/project-structure.md +1 -1
- package/.docs/reference/pubsub/lease-provider.md +1 -1
- package/.docs/reference/server/express-adapter.md +3 -1
- package/.docs/reference/server/fastify-adapter.md +3 -1
- package/.docs/reference/server/hono-adapter.md +3 -1
- package/.docs/reference/server/koa-adapter.md +3 -1
- package/.docs/reference/server/nestjs-adapter.md +3 -1
- package/.docs/reference/storage/clickhouse.md +0 -32
- package/.docs/reference/storage/composite.md +1 -27
- package/.docs/reference/storage/retention.md +0 -11
- package/.docs/reference/tools/mcp-client.md +0 -22
- package/.docs/reference/tools/mcp-server.md +4 -161
- package/.docs/reference/voice/livekit.md +8 -272
- package/.docs/reference/workspace/agentcore-runtime-sandbox.md +3 -1
- package/.docs/reference/workspace/agentfs-filesystem.md +3 -1
- package/.docs/reference/workspace/apple-container-sandbox.md +3 -1
- package/.docs/reference/workspace/archil-filesystem.md +3 -1
- package/.docs/reference/workspace/azure-blob-filesystem.md +3 -1
- package/.docs/reference/workspace/blaxel-sandbox.md +3 -1
- package/.docs/reference/workspace/daytona-sandbox.md +3 -1
- package/.docs/reference/workspace/docker-sandbox.md +3 -1
- package/.docs/reference/workspace/e2b-sandbox.md +3 -1
- package/.docs/reference/workspace/files-sdk-filesystem.md +3 -1
- package/.docs/reference/workspace/gcs-filesystem.md +3 -1
- package/.docs/reference/workspace/google-drive-filesystem.md +3 -1
- package/.docs/reference/workspace/local-filesystem.md +3 -1
- package/.docs/reference/workspace/local-sandbox.md +3 -1
- package/.docs/reference/workspace/modal-sandbox.md +3 -1
- package/.docs/reference/workspace/railway-sandbox.md +3 -1
- package/.docs/reference/workspace/s3-filesystem.md +3 -1
- package/.docs/reference/workspace/vercel-sandbox.md +7 -5
- package/.docs/reference/workspace/vercel-serverless.md +3 -1
- package/CHANGELOG.md +0 -29
- package/package.json +5 -5
- package/.docs/docs/capabilities/channels/discord.md +0 -98
- package/.docs/docs/capabilities/channels/other-adapters.md +0 -68
- package/.docs/docs/capabilities/channels/overview.md +0 -255
- package/.docs/docs/capabilities/channels/slack.md +0 -225
- package/.docs/docs/capabilities/channels/teams.md +0 -100
- package/.docs/docs/capabilities/channels/telegram.md +0 -98
- package/.docs/docs/capabilities/channels/whatsapp.md +0 -99
- package/.docs/docs/getting-started/file-based-agents.md +0 -116
- package/.docs/models/providers/crossmodel.md +0 -109
- package/.docs/models/providers/empiriolabs.md +0 -106
- package/.docs/models/providers/meta.md +0 -101
- package/.docs/models/providers/model-oracle-ai.md +0 -87
- package/.docs/models/providers/pioneer.md +0 -148
- package/.docs/models/providers/unorouter.md +0 -95
- package/.docs/models/providers/zenifra.md +0 -73
- package/.docs/reference/file-based-agents/config.md +0 -97
- package/.docs/reference/file-based-agents/instructions.md +0 -54
- package/.docs/reference/file-based-agents/logger.md +0 -26
- package/.docs/reference/file-based-agents/memory.md +0 -58
- package/.docs/reference/file-based-agents/observability.md +0 -32
- package/.docs/reference/file-based-agents/processors.md +0 -56
- package/.docs/reference/file-based-agents/scorers.md +0 -54
- package/.docs/reference/file-based-agents/server.md +0 -37
- package/.docs/reference/file-based-agents/skills.md +0 -56
- package/.docs/reference/file-based-agents/storage.md +0 -30
- package/.docs/reference/file-based-agents/studio.md +0 -56
- package/.docs/reference/file-based-agents/subagents.md +0 -123
- package/.docs/reference/file-based-agents/tools.md +0 -63
- package/.docs/reference/file-based-agents/workflows.md +0 -52
- package/.docs/reference/file-based-agents/workspace.md +0 -74
- package/.docs/reference/memory/summarizeConversation.md +0 -99
- package/.docs/reference/memory/summarizeThread.md +0 -93
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenAI
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 51 OpenAI models through Mastra's model router. Authentication is handled automatically using the `OPENAI_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenAI documentation](https://platform.openai.com/docs/models).
|
|
8
8
|
|
|
@@ -70,15 +70,10 @@ for await (const chunk of stream) {
|
|
|
70
70
|
| `openai/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
|
|
71
71
|
| `openai/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
72
72
|
| `openai/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
|
|
73
|
-
| `openai/gpt-5.6` | 1.1M | | | | | | $5 | $30 |
|
|
74
|
-
| `openai/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
|
|
75
|
-
| `openai/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
|
|
76
|
-
| `openai/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
|
|
77
73
|
| `openai/gpt-image-1` | — | | | | | | — | — |
|
|
78
74
|
| `openai/gpt-image-1-mini` | — | | | | | | — | — |
|
|
79
75
|
| `openai/gpt-image-1.5` | — | | | | | | — | — |
|
|
80
76
|
| `openai/gpt-image-2` | — | | | | | | $5 | $30 |
|
|
81
|
-
| `openai/gpt-realtime-2.1` | 128K | | | | | | $4 | $24 |
|
|
82
77
|
| `openai/o1` | 200K | | | | | | $15 | $60 |
|
|
83
78
|
| `openai/o1-pro` | 200K | | | | | | $150 | $600 |
|
|
84
79
|
| `openai/o3` | 200K | | | | | | $2 | $8 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenCode Zen
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 51 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
|
|
8
8
|
|
|
@@ -74,12 +74,8 @@ for await (const chunk of stream) {
|
|
|
74
74
|
| `opencode/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
|
|
75
75
|
| `opencode/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
76
76
|
| `opencode/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
|
|
77
|
-
| `opencode/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
|
|
78
|
-
| `opencode/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
|
|
79
|
-
| `opencode/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
|
|
80
|
-
| `opencode/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
81
77
|
| `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
|
|
82
|
-
| `opencode/hy3-free` |
|
|
78
|
+
| `opencode/hy3-free` | 256K | | | | | | — | — |
|
|
83
79
|
| `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
84
80
|
| `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
85
81
|
| `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Poolside
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 2 Poolside models through Mastra's model router. Authentication is handled automatically using the `POOLSIDE_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Poolside documentation](https://platform.poolside.ai).
|
|
8
8
|
|
|
@@ -34,11 +34,10 @@ for await (const chunk of stream) {
|
|
|
34
34
|
|
|
35
35
|
## Models
|
|
36
36
|
|
|
37
|
-
| Model
|
|
38
|
-
|
|
|
39
|
-
| `poolside/poolside/laguna-m.1`
|
|
40
|
-
| `poolside/poolside/laguna-xs
|
|
41
|
-
| `poolside/poolside/laguna-xs.2` | 262K | | | | | | — | — |
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `poolside/poolside/laguna-m.1` | 262K | | | | | | — | — |
|
|
40
|
+
| `poolside/poolside/laguna-xs.2` | 262K | | | | | | — | — |
|
|
42
41
|
|
|
43
42
|
## Advanced configuration
|
|
44
43
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# routing.run
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 26 routing.run models through Mastra's model router. Authentication is handled automatically using the `ROUTING_RUN_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [routing.run documentation](https://docs.routing.run).
|
|
8
8
|
|
|
@@ -17,7 +17,7 @@ const agent = new Agent({
|
|
|
17
17
|
id: "my-agent",
|
|
18
18
|
name: "My Agent",
|
|
19
19
|
instructions: "You are a helpful assistant",
|
|
20
|
-
model: "routing-run/
|
|
20
|
+
model: "routing-run/route/deepseek-v3.2"
|
|
21
21
|
});
|
|
22
22
|
|
|
23
23
|
// Generate a response
|
|
@@ -34,23 +34,34 @@ for await (const chunk of stream) {
|
|
|
34
34
|
|
|
35
35
|
## Models
|
|
36
36
|
|
|
37
|
-
| Model
|
|
38
|
-
|
|
|
39
|
-
| `routing-run/
|
|
40
|
-
| `routing-run/
|
|
41
|
-
| `routing-run/deepseek-v4-flash`
|
|
42
|
-
| `routing-run/deepseek-v4-pro`
|
|
43
|
-
| `routing-run/
|
|
44
|
-
| `routing-run/
|
|
45
|
-
| `routing-run/
|
|
46
|
-
| `routing-run/
|
|
47
|
-
| `routing-run/
|
|
48
|
-
| `routing-run/kimi-k2.6`
|
|
49
|
-
| `routing-run/kimi-k2.6-
|
|
50
|
-
| `routing-run/
|
|
51
|
-
| `routing-run/
|
|
52
|
-
| `routing-run/
|
|
53
|
-
| `routing-run/
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `routing-run/route/deepseek-v3.2` | 164K | | | | | | $0.49 | $0.74 |
|
|
40
|
+
| `routing-run/route/deepseek-v4-flash` | 1.0M | | | | | | $0.49 | $0.74 |
|
|
41
|
+
| `routing-run/route/deepseek-v4-flash-6bit` | 1.0M | | | | | | $0.49 | $0.74 |
|
|
42
|
+
| `routing-run/route/deepseek-v4-pro` | 1.0M | | | | | | $0.49 | $0.74 |
|
|
43
|
+
| `routing-run/route/deepseek-v4-pro-6bit` | 1.0M | | | | | | $0.49 | $0.74 |
|
|
44
|
+
| `routing-run/route/gemma-4-31b-it` | 131K | | | | | | $0.10 | $0.30 |
|
|
45
|
+
| `routing-run/route/glm-5.1` | 203K | | | | | | $1 | $3 |
|
|
46
|
+
| `routing-run/route/glm-5.1-6bit` | 203K | | | | | | $1 | $3 |
|
|
47
|
+
| `routing-run/route/kimi-k2.5` | 131K | | | | | | $0.46 | $2 |
|
|
48
|
+
| `routing-run/route/kimi-k2.6` | 262K | | | | | | $0.46 | $2 |
|
|
49
|
+
| `routing-run/route/kimi-k2.6-6bit` | 262K | | | | | | $0.46 | $2 |
|
|
50
|
+
| `routing-run/route/mimo-v2.5` | 1.0M | | | | | | $0.45 | $1 |
|
|
51
|
+
| `routing-run/route/mimo-v2.5-pro` | 1.0M | | | | | | $0.45 | $1 |
|
|
52
|
+
| `routing-run/route/mimo-v2.5-pro-6bit` | 1.0M | | | | | | $0.45 | $1 |
|
|
53
|
+
| `routing-run/route/minimax-m2.5` | 100K | | | | | | $0.19 | $1 |
|
|
54
|
+
| `routing-run/route/minimax-m2.5-highspeed` | 100K | | | | | | $0.19 | $1 |
|
|
55
|
+
| `routing-run/route/minimax-m2.7` | 100K | | | | | | $0.33 | $1 |
|
|
56
|
+
| `routing-run/route/minimax-m2.7-highspeed` | 100K | | | | | | $0.33 | $1 |
|
|
57
|
+
| `routing-run/route/mistral-large-3` | 128K | | | | | | $0.50 | $2 |
|
|
58
|
+
| `routing-run/route/mistral-medium-2505` | 128K | | | | | | $0.40 | $2 |
|
|
59
|
+
| `routing-run/route/mistral-small-2503` | 128K | | | | | | $0.15 | $0.60 |
|
|
60
|
+
| `routing-run/route/qwen3.6-27b` | 202K | | | | | | $1 | $3 |
|
|
61
|
+
| `routing-run/route/qwen3.6-27b-202k` | 202K | | | | | | $1 | $3 |
|
|
62
|
+
| `routing-run/route/step-3.5-flash` | 262K | | | | | | $0.10 | $0.29 |
|
|
63
|
+
| `routing-run/route/step-3.5-flash-2603` | 262K | | | | | | $0.10 | $0.30 |
|
|
64
|
+
| `routing-run/route/stepfun-3.5-flash` | 262K | | | | | | $0.10 | $0.29 |
|
|
54
65
|
|
|
55
66
|
## Advanced configuration
|
|
56
67
|
|
|
@@ -61,8 +72,8 @@ const agent = new Agent({
|
|
|
61
72
|
id: "custom-agent",
|
|
62
73
|
name: "custom-agent",
|
|
63
74
|
model: {
|
|
64
|
-
url: "https://
|
|
65
|
-
id: "routing-run/
|
|
75
|
+
url: "https://ai.routing.sh/v1",
|
|
76
|
+
id: "routing-run/route/deepseek-v3.2",
|
|
66
77
|
apiKey: process.env.ROUTING_RUN_API_KEY,
|
|
67
78
|
headers: {
|
|
68
79
|
"X-Custom-Header": "value"
|
|
@@ -80,8 +91,8 @@ const agent = new Agent({
|
|
|
80
91
|
model: ({ requestContext }) => {
|
|
81
92
|
const useAdvanced = requestContext.task === "complex";
|
|
82
93
|
return useAdvanced
|
|
83
|
-
? "routing-run/
|
|
84
|
-
: "routing-run/
|
|
94
|
+
? "routing-run/route/stepfun-3.5-flash"
|
|
95
|
+
: "routing-run/route/deepseek-v3.2";
|
|
85
96
|
}
|
|
86
97
|
});
|
|
87
98
|
```
|
|
@@ -37,13 +37,13 @@ for await (const chunk of stream) {
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `the-grid-ai/agent-max` | 1.0M | | | | | | — | — |
|
|
40
|
-
| `the-grid-ai/agent-prime` |
|
|
40
|
+
| `the-grid-ai/agent-prime` | 128K | | | | | | — | — |
|
|
41
41
|
| `the-grid-ai/agent-standard` | 128K | | | | | | — | — |
|
|
42
42
|
| `the-grid-ai/code-max` | 1.0M | | | | | | — | — |
|
|
43
|
-
| `the-grid-ai/code-prime` |
|
|
43
|
+
| `the-grid-ai/code-prime` | 128K | | | | | | — | — |
|
|
44
44
|
| `the-grid-ai/code-standard` | 128K | | | | | | — | — |
|
|
45
45
|
| `the-grid-ai/text-max` | 1.0M | | | | | | — | — |
|
|
46
|
-
| `the-grid-ai/text-prime` |
|
|
46
|
+
| `the-grid-ai/text-prime` | 128K | | | | | | — | — |
|
|
47
47
|
| `the-grid-ai/text-standard` | 128K | | | | | | — | — |
|
|
48
48
|
|
|
49
49
|
## Advanced configuration
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Weights & Biases
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 18 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Weights & Biases documentation](https://docs.wandb.ai).
|
|
8
8
|
|
|
@@ -17,7 +17,7 @@ const agent = new Agent({
|
|
|
17
17
|
id: "my-agent",
|
|
18
18
|
name: "My Agent",
|
|
19
19
|
instructions: "You are a helpful assistant",
|
|
20
|
-
model: "wandb/
|
|
20
|
+
model: "wandb/MiniMaxAI/MiniMax-M2.5"
|
|
21
21
|
});
|
|
22
22
|
|
|
23
23
|
// Generate a response
|
|
@@ -37,30 +37,23 @@ for await (const chunk of stream) {
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `wandb/deepseek-ai/DeepSeek-V3.1` | 161K | | | | | | $0.55 | $2 |
|
|
40
|
-
| `wandb/deepseek-ai/DeepSeek-V4-Flash` | 1.0M | | | | | | $0.14 | $0.28 |
|
|
41
|
-
| `wandb/deepseek-ai/DeepSeek-V4-Pro` | 1.0M | | | | | | $2 | $3 |
|
|
42
|
-
| `wandb/google/gemma-4-31B-it` | 262K | | | | | | $0.12 | $0.35 |
|
|
43
|
-
| `wandb/ibm-granite/granite-4.1-8b` | 131K | | | | | | $0.05 | $0.10 |
|
|
44
|
-
| `wandb/JetBrains/Mellum2-12B-A2.5B-Instruct` | 131K | | | | | | $0.05 | $0.10 |
|
|
45
40
|
| `wandb/meta-llama/Llama-3.1-70B-Instruct` | 128K | | | | | | $0.80 | $0.80 |
|
|
46
41
|
| `wandb/meta-llama/Llama-3.1-8B-Instruct` | 128K | | | | | | $0.22 | $0.22 |
|
|
47
42
|
| `wandb/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.71 | $0.71 |
|
|
43
|
+
| `wandb/meta-llama/Llama-4-Scout-17B-16E-Instruct` | 64K | | | | | | $0.17 | $0.66 |
|
|
44
|
+
| `wandb/microsoft/Phi-4-mini-instruct` | 128K | | | | | | $0.08 | $0.35 |
|
|
48
45
|
| `wandb/MiniMaxAI/MiniMax-M2.5` | 197K | | | | | | $0.30 | $1 |
|
|
49
|
-
| `wandb/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.
|
|
50
|
-
| `wandb/moonshotai/Kimi-K2.6` | 262K | | | | | | $0.95 | $4 |
|
|
51
|
-
| `wandb/moonshotai/Kimi-K2.7-Code` | 262K | | | | | | $0.94 | $4 |
|
|
46
|
+
| `wandb/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.50 | $3 |
|
|
52
47
|
| `wandb/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8` | 262K | | | | | | $0.20 | $0.80 |
|
|
53
|
-
| `wandb/
|
|
54
|
-
| `wandb/openai/gpt-oss-
|
|
55
|
-
| `wandb/openai/gpt-oss-20b` | 131K | | | | | | $0.03 | $0.13 |
|
|
48
|
+
| `wandb/openai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
|
|
49
|
+
| `wandb/openai/gpt-oss-20b` | 131K | | | | | | $0.05 | $0.20 |
|
|
56
50
|
| `wandb/OpenPipe/Qwen3-14B-Instruct` | 33K | | | | | | $0.05 | $0.22 |
|
|
51
|
+
| `wandb/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K | | | | | | $0.10 | $0.10 |
|
|
52
|
+
| `wandb/Qwen/Qwen3-235B-A22B-Thinking-2507` | 262K | | | | | | $0.10 | $0.10 |
|
|
57
53
|
| `wandb/Qwen/Qwen3-30B-A3B-Instruct-2507` | 262K | | | | | | $0.10 | $0.30 |
|
|
58
54
|
| `wandb/Qwen/Qwen3-Coder-480B-A35B-Instruct` | 262K | | | | | | $1 | $2 |
|
|
59
|
-
| `wandb/
|
|
60
|
-
| `wandb/
|
|
61
|
-
| `wandb/Qwen/Qwen3.6-35B-A3B` | 262K | | | | | | $0.25 | $1 |
|
|
62
|
-
| `wandb/zai-org/GLM-5.1` | 203K | | | | | | $1 | $4 |
|
|
63
|
-
| `wandb/zai-org/GLM-5.2` | 262K | | | | | | $1 | $4 |
|
|
55
|
+
| `wandb/zai-org/GLM-5-FP8` | 200K | | | | | | $1 | $3 |
|
|
56
|
+
| `wandb/zai-org/GLM-5.1` | 200K | | | | | | $1 | $4 |
|
|
64
57
|
|
|
65
58
|
## Advanced configuration
|
|
66
59
|
|
|
@@ -72,7 +65,7 @@ const agent = new Agent({
|
|
|
72
65
|
name: "custom-agent",
|
|
73
66
|
model: {
|
|
74
67
|
url: "https://api.inference.wandb.ai/v1",
|
|
75
|
-
id: "wandb/
|
|
68
|
+
id: "wandb/MiniMaxAI/MiniMax-M2.5",
|
|
76
69
|
apiKey: process.env.WANDB_API_KEY,
|
|
77
70
|
headers: {
|
|
78
71
|
"X-Custom-Header": "value"
|
|
@@ -90,8 +83,8 @@ const agent = new Agent({
|
|
|
90
83
|
model: ({ requestContext }) => {
|
|
91
84
|
const useAdvanced = requestContext.task === "complex";
|
|
92
85
|
return useAdvanced
|
|
93
|
-
? "wandb/zai-org/GLM-5.
|
|
94
|
-
: "wandb/
|
|
86
|
+
? "wandb/zai-org/GLM-5.1"
|
|
87
|
+
: "wandb/MiniMaxAI/MiniMax-M2.5";
|
|
95
88
|
}
|
|
96
89
|
});
|
|
97
90
|
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# xAI
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 8 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [xAI documentation](https://docs.x.ai/docs/models).
|
|
8
8
|
|
|
@@ -38,7 +38,6 @@ for await (const chunk of stream) {
|
|
|
38
38
|
| `xai/grok-4.20-0309-reasoning` | 1.0M | | | | | | $1 | $3 |
|
|
39
39
|
| `xai/grok-4.20-multi-agent-0309` | 1.0M | | | | | | $1 | $3 |
|
|
40
40
|
| `xai/grok-4.3` | 1.0M | | | | | | $1 | $3 |
|
|
41
|
-
| `xai/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
42
41
|
| `xai/grok-build-0.1` | 256K | | | | | | $1 | $2 |
|
|
43
42
|
| `xai/grok-imagine-image` | 8K | | | | | | — | — |
|
|
44
43
|
| `xai/grok-imagine-image-quality` | 8K | | | | | | — | — |
|
|
@@ -35,13 +35,11 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
35
35
|
- [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
|
|
36
36
|
- [Cortecs](https://mastra.ai/models/providers/cortecs)
|
|
37
37
|
- [CrofAI](https://mastra.ai/models/providers/crof)
|
|
38
|
-
- [CrossModel](https://mastra.ai/models/providers/crossmodel)
|
|
39
38
|
- [D.Run (China)](https://mastra.ai/models/providers/drun)
|
|
40
39
|
- [Databricks](https://mastra.ai/models/providers/databricks)
|
|
41
40
|
- [Deep Infra](https://mastra.ai/models/providers/deepinfra)
|
|
42
41
|
- [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
|
|
43
42
|
- [DInference](https://mastra.ai/models/providers/dinference)
|
|
44
|
-
- [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)
|
|
45
43
|
- [evroc](https://mastra.ai/models/providers/evroc)
|
|
46
44
|
- [FastRouter](https://mastra.ai/models/providers/fastrouter)
|
|
47
45
|
- [Fireworks AI](https://mastra.ai/models/providers/fireworks-ai)
|
|
@@ -71,14 +69,12 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
71
69
|
- [LongCat](https://mastra.ai/models/providers/longcat)
|
|
72
70
|
- [LucidQuery](https://mastra.ai/models/providers/lucidquery)
|
|
73
71
|
- [Meganova](https://mastra.ai/models/providers/meganova)
|
|
74
|
-
- [Meta](https://mastra.ai/models/providers/meta)
|
|
75
72
|
- [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)
|
|
76
73
|
- [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)
|
|
77
74
|
- [MiniMax Token Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan)
|
|
78
75
|
- [MiniMax Token Plan (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn-coding-plan)
|
|
79
76
|
- [Mixlayer](https://mastra.ai/models/providers/mixlayer)
|
|
80
77
|
- [Moark](https://mastra.ai/models/providers/moark)
|
|
81
|
-
- [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai)
|
|
82
78
|
- [ModelScope](https://mastra.ai/models/providers/modelscope)
|
|
83
79
|
- [Moonshot AI](https://mastra.ai/models/providers/moonshotai)
|
|
84
80
|
- [Moonshot AI (China)](https://mastra.ai/models/providers/moonshotai-cn)
|
|
@@ -98,7 +94,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
98
94
|
- [OVHcloud AI Endpoints](https://mastra.ai/models/providers/ovhcloud)
|
|
99
95
|
- [Perplexity](https://mastra.ai/models/providers/perplexity)
|
|
100
96
|
- [Perplexity Agent](https://mastra.ai/models/providers/perplexity-agent)
|
|
101
|
-
- [Pioneer](https://mastra.ai/models/providers/pioneer)
|
|
102
97
|
- [Poe](https://mastra.ai/models/providers/poe)
|
|
103
98
|
- [Poolside](https://mastra.ai/models/providers/poolside)
|
|
104
99
|
- [Privatemode AI](https://mastra.ai/models/providers/privatemode-ai)
|
|
@@ -128,7 +123,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
128
123
|
- [TrustedRouter](https://mastra.ai/models/providers/trustedrouter)
|
|
129
124
|
- [Umans AI](https://mastra.ai/models/providers/umans-ai)
|
|
130
125
|
- [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan)
|
|
131
|
-
- [UnoRouter](https://mastra.ai/models/providers/unorouter)
|
|
132
126
|
- [Upstage](https://mastra.ai/models/providers/upstage)
|
|
133
127
|
- [Vivgrid](https://mastra.ai/models/providers/vivgrid)
|
|
134
128
|
- [Vultr](https://mastra.ai/models/providers/vultr)
|
|
@@ -142,7 +136,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
142
136
|
- [Z.AI](https://mastra.ai/models/providers/zai)
|
|
143
137
|
- [Z.AI Coding Plan](https://mastra.ai/models/providers/zai-coding-plan)
|
|
144
138
|
- [Zeldoc](https://mastra.ai/models/providers/zeldoc)
|
|
145
|
-
- [Zenifra](https://mastra.ai/models/providers/zenifra)
|
|
146
139
|
- [ZenMux](https://mastra.ai/models/providers/zenmux)
|
|
147
140
|
- [Zhipu AI](https://mastra.ai/models/providers/zhipuai)
|
|
148
141
|
- [Zhipu AI Coding Plan](https://mastra.ai/models/providers/zhipuai-coding-plan)
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Added in:** `@mastra/core@1.22.0`
|
|
6
6
|
|
|
7
|
-
Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels
|
|
7
|
+
Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels guide](https://mastra.ai/docs/agents/channels) for concepts and platform setup instructions.
|
|
8
8
|
|
|
9
9
|
## Usage example
|
|
10
10
|
|
|
@@ -291,6 +291,6 @@ type InlineLinkEntry =
|
|
|
291
291
|
|
|
292
292
|
## Related
|
|
293
293
|
|
|
294
|
-
- [Channels
|
|
294
|
+
- [Channels guide](https://mastra.ai/docs/agents/channels): Concepts, quickstart, and platform setup
|
|
295
295
|
- [Agent class](https://mastra.ai/reference/agents/agent): Constructor parameters and methods
|
|
296
296
|
- [Chat SDK adapters](https://chat-sdk.dev/adapters): Adapter configuration and platform setup
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# SlackProvider
|
|
4
4
|
|
|
5
|
-
`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/docs/
|
|
5
|
+
`SlackProvider` is the managed path for connecting agents to Slack. Register it on `Mastra.channels` and it provisions Slack apps via the Manifest API, runs the OAuth install flow, rotates configuration tokens, and routes Slack events to your agents. Use it when you want Mastra to own app creation and installation. For the lower-level path where you create the Slack app and configure scopes and webhooks yourself, use [`createSlackAdapter`](https://mastra.ai/docs/agents/channels) on the agent's `channels.adapters` instead.
|
|
6
6
|
|
|
7
7
|
## Usage example
|
|
8
8
|
|
|
@@ -224,5 +224,5 @@ const result = await slack.connect('support-agent')
|
|
|
224
224
|
## Related
|
|
225
225
|
|
|
226
226
|
- [ChannelProvider](https://mastra.ai/reference/channels/channel-provider): the interface `SlackProvider` implements
|
|
227
|
-
- [Channels](https://mastra.ai/docs/
|
|
227
|
+
- [Channels](https://mastra.ai/docs/agents/channels): concepts, platform setup, and the `createSlackAdapter` path
|
|
228
228
|
- [Channels reference](https://mastra.ai/reference/agents/channels): the `channels` config on the `Agent` constructor
|
|
@@ -282,30 +282,32 @@ mastra deploy --env staging --yes
|
|
|
282
282
|
|
|
283
283
|
## `mastra env`
|
|
284
284
|
|
|
285
|
-
Manages environments on Mastra platform. Environments are named deploy targets (for example `production`, `staging`, `preview-42`) that belong to a project.
|
|
286
|
-
|
|
287
|
-
Every subcommand resolves its project from, in order: the `MASTRA_PROJECT_ID` environment variable, the `--project <name|slug|id>` flag, or the `.mastra-project.json` file written by [`mastra deploy`](#mastra-deploy) in the current directory. Run from your project directory and you never need to name the project.
|
|
285
|
+
Manages environments on Mastra platform. Environments are named deploy targets (for example `production`, `staging`, `preview-42`) that belong to a project. Every subcommand takes a `<project>` argument (name, slug, or ID) and resolves the current organization from stored credentials.
|
|
288
286
|
|
|
289
287
|
### `mastra env list`
|
|
290
288
|
|
|
291
|
-
Lists environments for a project.
|
|
289
|
+
Lists environments for a project.
|
|
292
290
|
|
|
293
291
|
```bash
|
|
294
|
-
mastra env list
|
|
292
|
+
mastra env list <project>
|
|
295
293
|
```
|
|
296
294
|
|
|
297
295
|
#### `--json`
|
|
298
296
|
|
|
299
|
-
Emit machine-readable JSON. Only non-sensitive metadata (id, name, slug, type, region, branch,
|
|
297
|
+
Emit machine-readable JSON. Only non-sensitive metadata (id, name, slug, type, region, branch, and URLs) is included so the output is safe to log in CI.
|
|
300
298
|
|
|
301
299
|
### `mastra env create`
|
|
302
300
|
|
|
303
301
|
Creates a new environment for a project.
|
|
304
302
|
|
|
305
303
|
```bash
|
|
306
|
-
mastra env create staging --type staging --region eu
|
|
304
|
+
mastra env create <project> --name staging --type staging --region eu
|
|
307
305
|
```
|
|
308
306
|
|
|
307
|
+
#### `-n, --name`
|
|
308
|
+
|
|
309
|
+
Environment name (required).
|
|
310
|
+
|
|
309
311
|
#### `-t, --type`
|
|
310
312
|
|
|
311
313
|
Environment type. One of `production`, `staging`, or `preview`. Defaults to `staging`.
|
|
@@ -323,7 +325,7 @@ Emit machine-readable JSON. Sensitive fields are omitted, as with [`mastra env l
|
|
|
323
325
|
Deletes an environment.
|
|
324
326
|
|
|
325
327
|
```bash
|
|
326
|
-
mastra env delete <env>
|
|
328
|
+
mastra env delete <project> <env>
|
|
327
329
|
```
|
|
328
330
|
|
|
329
331
|
`<env>` can be an environment name, slug, or ID. The CLI prompts for confirmation unless `--yes` is passed.
|
|
@@ -332,112 +334,6 @@ mastra env delete <env>
|
|
|
332
334
|
|
|
333
335
|
Skip the confirmation prompt.
|
|
334
336
|
|
|
335
|
-
### `mastra env restart`
|
|
336
|
-
|
|
337
|
-
Restarts an environment's running service so saved env vars (including managed vars from attached databases) take effect immediately, without a new deploy.
|
|
338
|
-
|
|
339
|
-
```bash
|
|
340
|
-
mastra env restart <env>
|
|
341
|
-
```
|
|
342
|
-
|
|
343
|
-
`<env>` can be an environment name, slug, or ID. Fails with a conflict error if the environment has never been deployed.
|
|
344
|
-
|
|
345
|
-
### `mastra env db`
|
|
346
|
-
|
|
347
|
-
Manages databases attached to a project on Mastra platform. Databases are provisioned from a managed provider (for example Turso or Neon) and inject their connection env vars into deploys automatically.
|
|
348
|
-
|
|
349
|
-
A database is either **environment-scoped** (its env vars only go to one environment) or **shared** (project-scoped: its env vars go to all environments). Pass the environment argument to work with environment-scoped databases; omit it for shared databases.
|
|
350
|
-
|
|
351
|
-
Creating and detaching databases requires the `admin` role in the organization.
|
|
352
|
-
|
|
353
|
-
### `mastra env db list`
|
|
354
|
-
|
|
355
|
-
Lists databases attached to a project, including provider, provisioning status, scope (which environment each database feeds), and the env var names each database injects. Pass an environment to only show databases feeding that environment (environment-scoped plus shared).
|
|
356
|
-
|
|
357
|
-
```bash
|
|
358
|
-
mastra env db list
|
|
359
|
-
mastra env db list <env>
|
|
360
|
-
```
|
|
361
|
-
|
|
362
|
-
#### `--json`
|
|
363
|
-
|
|
364
|
-
Emit machine-readable JSON.
|
|
365
|
-
|
|
366
|
-
### `mastra env db create`
|
|
367
|
-
|
|
368
|
-
Provisions a managed database, attaches it, and polls until it's ready. Provisioning errors are printed with the provider's error detail.
|
|
369
|
-
|
|
370
|
-
With an environment argument, the database is scoped to that environment: only it receives the database's connection env vars, and the provider region is derived from the environment's region. Without one, the database is shared by all environments.
|
|
371
|
-
|
|
372
|
-
```bash
|
|
373
|
-
mastra env db create <env> --kind turso
|
|
374
|
-
mastra env db create --kind neon --name my-app-db --region aws-us-east-1
|
|
375
|
-
```
|
|
376
|
-
|
|
377
|
-
#### `--kind`
|
|
378
|
-
|
|
379
|
-
Database provider (required). One of `turso` or `neon`.
|
|
380
|
-
|
|
381
|
-
#### `--name`
|
|
382
|
-
|
|
383
|
-
Database name. Defaults to a name derived from the project slug (for example `my-app-db`).
|
|
384
|
-
|
|
385
|
-
#### `--region`
|
|
386
|
-
|
|
387
|
-
Provider region ID for shared databases. Ignored for environment-scoped databases.
|
|
388
|
-
|
|
389
|
-
#### `--no-wait`
|
|
390
|
-
|
|
391
|
-
Return immediately after the attach is queued instead of polling until the database is ready. Check progress later with `mastra env db show`.
|
|
392
|
-
|
|
393
|
-
#### `--json`
|
|
394
|
-
|
|
395
|
-
Emit machine-readable JSON.
|
|
396
|
-
|
|
397
|
-
### `mastra env db show`
|
|
398
|
-
|
|
399
|
-
Shows database details and, once the database is ready, its connection env vars. Secret values are masked by default.
|
|
400
|
-
|
|
401
|
-
```bash
|
|
402
|
-
mastra env db show <database>
|
|
403
|
-
```
|
|
404
|
-
|
|
405
|
-
`<database>` can be a database ID or name.
|
|
406
|
-
|
|
407
|
-
#### `--show-secrets`
|
|
408
|
-
|
|
409
|
-
Print secret connection values instead of masking them.
|
|
410
|
-
|
|
411
|
-
#### `--json`
|
|
412
|
-
|
|
413
|
-
Emit machine-readable JSON. Secret values are masked unless `--show-secrets` is passed.
|
|
414
|
-
|
|
415
|
-
### `mastra env db detach`
|
|
416
|
-
|
|
417
|
-
Detaches a database from the project. The CLI prompts for confirmation unless `--yes` is passed. After detaching, deploys no longer receive the database's env vars.
|
|
418
|
-
|
|
419
|
-
```bash
|
|
420
|
-
mastra env db detach <database>
|
|
421
|
-
```
|
|
422
|
-
|
|
423
|
-
#### `-y, --yes`
|
|
424
|
-
|
|
425
|
-
Skip the confirmation prompt.
|
|
426
|
-
|
|
427
|
-
### `mastra env deploys`
|
|
428
|
-
|
|
429
|
-
Lists deploys for a project, newest first. Deploys that are serving traffic are marked `(active)`.
|
|
430
|
-
|
|
431
|
-
```bash
|
|
432
|
-
mastra env deploys [environment]
|
|
433
|
-
```
|
|
434
|
-
|
|
435
|
-
Omit `[environment]` to show deploys across all environments; pass an environment name, slug, or ID to filter to one.
|
|
436
|
-
|
|
437
|
-
#### `--json`
|
|
438
|
-
|
|
439
|
-
Emit machine-readable JSON.
|
|
440
|
-
|
|
441
337
|
## `mastra studio deploy`
|
|
442
338
|
|
|
443
339
|
> **Info:** `mastra studio deploy` continues to work but is superseded by [`mastra deploy`](#mastra-deploy), which supports named environments (`--env staging`, `--env production`) on a single project. New setups should use `mastra deploy`.
|
|
@@ -840,7 +736,6 @@ Runs database migrations to update your storage schema. This command is useful w
|
|
|
840
736
|
The command bundles your project, connects to your configured storage backend, and executes any pending migrations. Currently supports:
|
|
841
737
|
|
|
842
738
|
- **Duplicate spans migration**: Removes duplicate `(traceId, spanId)` entries and adds a unique constraint to ensure data integrity.
|
|
843
|
-
- **ClickHouse legacy-to-vNext span migration**: Copies historical spans from the legacy `mastra_ai_spans` table to the vNext `mastra_span_events` schema. Runs in batches to stay within memory limits. See the [ClickHouse storage reference](https://mastra.ai/reference/storage/clickhouse) for details.
|
|
844
739
|
|
|
845
740
|
```bash
|
|
846
741
|
mastra migrate
|
|
@@ -1484,8 +1379,6 @@ By default, Mastra collects anonymous information about your project like your O
|
|
|
1484
1379
|
|
|
1485
1380
|
When a server started with `mastra dev` or `mastra start` has observability metrics enabled, Mastra also sends anonymous, aggregated model usage at startup: input and output token counts per provider and model, plus the command (`dev` or `start`) and `NODE_ENV`. No prompts, responses, or other message content is ever sent. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/core/src/telemetry/usage-telemetry.ts) to check what's collected.
|
|
1486
1381
|
|
|
1487
|
-
At server startup, Mastra also sends an anonymous project-surface snapshot: counts of registered agents, agent controllers, workflows, tools, processors, vector stores, scorers, workspaces, MCP servers, gateways, and channels, plus booleans for memory, voice, editor, and observability usage and the coarse storage backend category. It doesn't send names or identifiers. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/core/src/telemetry/feature-telemetry.ts) to check what's collected.
|
|
1488
|
-
|
|
1489
1382
|
You can opt out of all CLI and usage analytics by setting an environment variable:
|
|
1490
1383
|
|
|
1491
1384
|
```bash
|
|
@@ -53,14 +53,6 @@ const scorer = createScorer({
|
|
|
53
53
|
|
|
54
54
|
**judge.jsonPromptInjection** (`boolean`): When true, inject the JSON schema into the prompt instead of using the provider's native response\_format API. Set this for models that don't support native structured output (e.g. some Groq Llama models) to avoid a wasted 400 call.
|
|
55
55
|
|
|
56
|
-
**judge.inputProcessors** (`Processor[]`): Input processors applied to the internal judge agent before its messages reach the model (e.g. redaction, validation).
|
|
57
|
-
|
|
58
|
-
**judge.outputProcessors** (`Processor[]`): Output processors applied to the internal judge agent's output before it is returned (e.g. moderation, transformation).
|
|
59
|
-
|
|
60
|
-
**judge.errorProcessors** (`Processor[]`): Error processors for the internal judge agent. These implement processAPIError and can inspect LLM API rejections and signal a retry, e.g. StreamErrorRetryProcessor. Requires maxProcessorRetries to be set for retry-based processors to take effect.
|
|
61
|
-
|
|
62
|
-
**judge.maxProcessorRetries** (`number`): Maximum number of times processors can trigger a retry per judge generation. Required for retry-based error processors (e.g. StreamErrorRetryProcessor) to take effect.
|
|
63
|
-
|
|
64
56
|
**type** (`string`): Type specification for input/output. Use 'agent' for automatic agent types. For custom types, use the generic approach instead.
|
|
65
57
|
|
|
66
58
|
**prepareRun** (`(run: ScorerRun) => ScorerRun | Promise<ScorerRun>`): Transform the scorer run data before the pipeline executes. Use this to filter messages, limit context size, or drop fields the scorer doesn't need. The \`filterRun()\` utility creates this function from declarative options. Can be async.
|
package/.docs/reference/index.md
CHANGED
|
@@ -175,34 +175,17 @@ The Reference section provides documentation of Mastra's API, including paramete
|
|
|
175
175
|
- [.startExperimentAsync()](https://mastra.ai/reference/datasets/startExperimentAsync)
|
|
176
176
|
- [.update()](https://mastra.ai/reference/datasets/update)
|
|
177
177
|
- [.updateItem()](https://mastra.ai/reference/datasets/updateItem)
|
|
178
|
-
- [config.ts](https://mastra.ai/reference/file-based-agents/config)
|
|
179
|
-
- [Instructions](https://mastra.ai/reference/file-based-agents/instructions)
|
|
180
|
-
- [Logger](https://mastra.ai/reference/file-based-agents/logger)
|
|
181
|
-
- [Memory](https://mastra.ai/reference/file-based-agents/memory)
|
|
182
|
-
- [Observability](https://mastra.ai/reference/file-based-agents/observability)
|
|
183
|
-
- [Processors](https://mastra.ai/reference/file-based-agents/processors)
|
|
184
|
-
- [Scorers](https://mastra.ai/reference/file-based-agents/scorers)
|
|
185
|
-
- [Server](https://mastra.ai/reference/file-based-agents/server)
|
|
186
|
-
- [Skills](https://mastra.ai/reference/file-based-agents/skills)
|
|
187
|
-
- [Storage](https://mastra.ai/reference/file-based-agents/storage)
|
|
188
|
-
- [Studio](https://mastra.ai/reference/file-based-agents/studio)
|
|
189
|
-
- [Subagents](https://mastra.ai/reference/file-based-agents/subagents)
|
|
190
|
-
- [Tools](https://mastra.ai/reference/file-based-agents/tools)
|
|
191
|
-
- [Workflows](https://mastra.ai/reference/file-based-agents/workflows)
|
|
192
|
-
- [Workspace](https://mastra.ai/reference/file-based-agents/workspace)
|
|
193
178
|
- [API Reference](https://mastra.ai/reference/mastra-platform/api)
|
|
194
179
|
- [Cloned Thread Utilities](https://mastra.ai/reference/memory/clone-utilities)
|
|
195
180
|
- [Memory Class](https://mastra.ai/reference/memory/memory-class)
|
|
196
181
|
- [Observational Memory](https://mastra.ai/reference/memory/observational-memory)
|
|
197
182
|
- [SerializedMemoryConfig](https://mastra.ai/reference/memory/serialized-memory-config)
|
|
198
|
-
- [summarizeConversation()](https://mastra.ai/reference/memory/summarizeConversation)
|
|
199
183
|
- [.cloneThread()](https://mastra.ai/reference/memory/cloneThread)
|
|
200
184
|
- [.createThread()](https://mastra.ai/reference/memory/createThread)
|
|
201
185
|
- [.deleteMessages()](https://mastra.ai/reference/memory/deleteMessages)
|
|
202
186
|
- [.getThreadById()](https://mastra.ai/reference/memory/getThreadById)
|
|
203
187
|
- [.listThreads()](https://mastra.ai/reference/memory/listThreads)
|
|
204
188
|
- [.recall()](https://mastra.ai/reference/memory/recall)
|
|
205
|
-
- [.summarizeThread()](https://mastra.ai/reference/memory/summarizeThread)
|
|
206
189
|
- [Feedback](https://mastra.ai/reference/observability/feedback)
|
|
207
190
|
- [PinoLogger](https://mastra.ai/reference/logging/pino-logger)
|
|
208
191
|
- [Automatic Metrics](https://mastra.ai/reference/observability/metrics/automatic-metrics)
|