@mastra/mcp-docs-server 1.2.7-alpha.6 → 1.2.7
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 +44 -2
- package/.docs/docs/agent-builder/skill-registries.md +1 -3
- package/.docs/docs/agent-controller/overview.md +1 -1
- package/.docs/docs/agent-controller/session.md +1 -3
- package/.docs/docs/agents/code-mode.md +17 -1
- package/.docs/docs/agents/guardrails.md +8 -8
- package/.docs/docs/agents/overview.md +2 -2
- package/.docs/docs/agents/processors.md +9 -3
- package/.docs/docs/agents/skills.md +2 -4
- package/.docs/docs/agents/structured-output.md +1 -1
- package/.docs/docs/agents/supervisor-agents.md +1 -3
- package/.docs/docs/agents/using-tools.md +4 -4
- package/.docs/docs/browser/agent-browser.md +1 -3
- package/.docs/docs/browser/browser-viewer.md +1 -3
- package/.docs/docs/browser/stagehand.md +1 -1
- package/.docs/docs/capabilities/channels/overview.md +1 -3
- package/.docs/docs/deployment/mastra-server.md +2 -4
- package/.docs/docs/editor/overview.md +2 -6
- package/.docs/docs/editor/prompts.md +1 -1
- package/.docs/docs/editor/tools.md +3 -5
- package/.docs/docs/evals/custom-scorers.md +1 -3
- package/.docs/docs/evals/datasets/overview.md +4 -4
- package/.docs/docs/evals/datasets/running-experiments.md +4 -2
- package/.docs/docs/evals/evals-with-memory.md +1 -3
- package/.docs/docs/evals/gates-and-verdicts.md +17 -2
- package/.docs/docs/evals/quick-checks.md +1 -3
- package/.docs/docs/getting-started/file-based-agents.md +9 -4
- package/.docs/docs/long-running-agents/background-tasks.md +1 -1
- package/.docs/docs/long-running-agents/durable-agents.md +3 -5
- package/.docs/docs/long-running-agents/goals.md +1 -3
- package/.docs/docs/long-running-agents/signal-providers.md +1 -3
- package/.docs/docs/long-running-agents/signals.md +7 -21
- package/.docs/docs/mastra-platform/configuration.md +15 -22
- package/.docs/docs/mastra-platform/database.md +50 -6
- package/.docs/docs/mastra-platform/deploy.md +142 -0
- package/.docs/docs/mastra-platform/environments.md +103 -0
- package/.docs/docs/mastra-platform/github.md +2 -2
- package/.docs/docs/mastra-platform/overview.md +5 -5
- package/.docs/docs/mastra-platform/server.md +2 -0
- package/.docs/docs/mastra-platform/studio.md +5 -3
- package/.docs/docs/mcp/mcp-apps.md +3 -3
- package/.docs/docs/mcp/overview.md +6 -10
- package/.docs/docs/memory/overview.md +4 -4
- package/.docs/docs/observability/integrations/exporters/mastra-platform.md +1 -3
- package/.docs/docs/observability/logging.md +3 -1
- package/.docs/docs/observability/metrics/querying.md +2 -0
- package/.docs/docs/observability/tracing/overview.md +3 -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 +1 -3
- package/.docs/docs/workflows/agents-and-tools.md +3 -5
- package/.docs/docs/workflows/control-flow.md +1 -1
- package/.docs/docs/workflows/overview.md +5 -5
- 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/guide/chef-michel.md +1 -1
- package/.docs/guides/guide/coding-agent.md +392 -0
- package/.docs/guides/migrations/mastra-cloud.md +5 -12
- package/.docs/models/environment-variables.md +16 -2
- package/.docs/models/gateways/azure-openai.md +15 -15
- package/.docs/models/gateways/mastra.md +2 -2
- package/.docs/models/gateways/netlify.md +4 -1
- package/.docs/models/gateways/openrouter.md +10 -11
- package/.docs/models/gateways/vercel.md +9 -10
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/abacus.md +44 -14
- package/.docs/models/providers/ai-router.md +77 -0
- package/.docs/models/providers/ambient.md +10 -6
- package/.docs/models/providers/baseten.md +1 -1
- package/.docs/models/providers/blueclaw.md +74 -0
- package/.docs/models/providers/crossmodel.md +115 -0
- package/.docs/models/providers/daoxe.md +81 -0
- package/.docs/models/providers/databricks.md +7 -2
- package/.docs/models/providers/deepinfra.md +2 -2
- package/.docs/models/providers/deepseek.md +2 -2
- package/.docs/models/providers/ebcloud.md +76 -0
- package/.docs/models/providers/empiriolabs.md +108 -0
- package/.docs/models/providers/google.md +4 -0
- package/.docs/models/providers/hpc-ai.md +16 -10
- package/.docs/models/providers/inferx.md +78 -0
- package/.docs/models/providers/llmgateway.md +6 -7
- package/.docs/models/providers/lynkr.md +73 -0
- package/.docs/models/providers/meta.md +101 -0
- package/.docs/models/providers/model-oracle-ai.md +87 -0
- package/.docs/models/providers/nano-gpt.md +2 -2
- package/.docs/models/providers/neon.md +1 -1
- package/.docs/models/providers/nvidia.md +1 -3
- package/.docs/models/providers/openai.md +16 -3
- package/.docs/models/providers/opencode.md +5 -2
- package/.docs/models/providers/pioneer.md +148 -0
- package/.docs/models/providers/poolside.md +6 -5
- package/.docs/models/providers/routing-run.md +23 -34
- package/.docs/models/providers/snowflake-cortex.md +4 -1
- package/.docs/models/providers/stepfun-ai-step-plan.md +75 -0
- package/.docs/models/providers/stepfun-ai.md +6 -6
- package/.docs/models/providers/stepfun-step-plan.md +76 -0
- package/.docs/models/providers/stepfun.md +5 -5
- package/.docs/models/providers/the-grid-ai.md +3 -3
- package/.docs/models/providers/unorouter.md +95 -0
- package/.docs/models/providers/vivgrid.md +5 -2
- package/.docs/models/providers/wafer.ai.md +9 -12
- package/.docs/models/providers/xai.md +1 -1
- package/.docs/models/providers/zenmux.md +5 -1
- package/.docs/models/providers.md +16 -2
- package/.docs/reference/agents/generateLegacy.md +8 -2
- package/.docs/reference/cli/mastra.md +131 -10
- package/.docs/reference/code-sdk/mount-agent-controller.md +2 -0
- package/.docs/reference/coding-agent/create-coding-agent.md +5 -4
- package/.docs/reference/evals/create-scorer.md +63 -0
- package/.docs/reference/evals/run-evals.md +2 -2
- package/.docs/reference/file-based-agents/logger.md +26 -0
- package/.docs/reference/file-based-agents/scorers.md +54 -0
- package/.docs/reference/index.md +2 -0
- package/.docs/reference/mastra-platform/api.md +1 -1
- package/.docs/reference/observability/metrics/automatic-metrics.md +8 -8
- package/.docs/reference/observability/tracing/exporters/braintrust.md +1 -0
- package/.docs/reference/observability/tracing/exporters/datadog.md +10 -9
- package/.docs/reference/observability/tracing/exporters/langsmith.md +8 -7
- package/.docs/reference/observability/tracing/exporters/posthog.md +13 -12
- package/.docs/reference/observability/tracing/exporters/sentry.md +1 -0
- package/.docs/reference/observability/tracing/interfaces.md +9 -0
- package/.docs/reference/processors/stream-error-retry-processor.md +39 -2
- package/.docs/reference/pubsub/base.md +10 -0
- package/.docs/reference/pubsub/caching-pubsub.md +8 -0
- package/.docs/reference/pubsub/redis-streams.md +12 -0
- package/.docs/reference/server/express-adapter.md +1 -3
- package/.docs/reference/server/fastify-adapter.md +1 -3
- package/.docs/reference/server/hono-adapter.md +1 -3
- package/.docs/reference/server/koa-adapter.md +1 -3
- package/.docs/reference/server/nestjs-adapter.md +1 -3
- package/.docs/reference/server/register-api-route.md +5 -4
- package/.docs/reference/templates/overview.md +1 -1
- package/.docs/reference/tools/mcp-client.md +22 -0
- package/.docs/reference/tools/mcp-server.md +161 -4
- package/.docs/reference/voice/google.md +48 -8
- package/.docs/reference/voice/speechify.md +10 -6
- package/.docs/reference/workspace/agentcore-runtime-sandbox.md +1 -3
- package/.docs/reference/workspace/agentfs-filesystem.md +1 -3
- package/.docs/reference/workspace/apple-container-sandbox.md +1 -3
- package/.docs/reference/workspace/archil-filesystem.md +1 -3
- package/.docs/reference/workspace/azure-blob-filesystem.md +1 -3
- package/.docs/reference/workspace/blaxel-sandbox.md +1 -3
- package/.docs/reference/workspace/daytona-sandbox.md +1 -3
- package/.docs/reference/workspace/docker-sandbox.md +1 -3
- package/.docs/reference/workspace/e2b-sandbox.md +20 -3
- package/.docs/reference/workspace/files-sdk-filesystem.md +1 -3
- package/.docs/reference/workspace/gcs-filesystem.md +1 -3
- package/.docs/reference/workspace/google-drive-filesystem.md +1 -3
- package/.docs/reference/workspace/local-filesystem.md +1 -3
- package/.docs/reference/workspace/local-sandbox.md +1 -3
- package/.docs/reference/workspace/modal-sandbox.md +1 -3
- package/.docs/reference/workspace/railway-sandbox.md +1 -3
- package/.docs/reference/workspace/s3-filesystem.md +1 -3
- package/.docs/reference/workspace/vercel-sandbox.md +5 -7
- package/.docs/reference/workspace/vercel-serverless.md +1 -3
- package/CHANGELOG.md +86 -0
- package/package.json +10 -10
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# InferX
|
|
4
|
+
|
|
5
|
+
Access 6 InferX models through Mastra's model router. Authentication is handled automatically using the `INFERX_API_KEY` environment variable.
|
|
6
|
+
|
|
7
|
+
Learn more in the [InferX documentation](https://model.inferx.net/endpoints).
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
INFERX_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: "inferx/google/gemma-4-31b-it-fp8"
|
|
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
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [InferX documentation](https://model.inferx.net/endpoints) for details.
|
|
34
|
+
|
|
35
|
+
## Models
|
|
36
|
+
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `inferx/google/gemma-4-31b-it-fp8` | 262K | | | | | | — | — |
|
|
40
|
+
| `inferx/qwen/qwen3-coder-next-fp8` | 256K | | | | | | — | — |
|
|
41
|
+
| `inferx/qwen/qwen3-coder-next-fp8-1m` | 1.0M | | | | | | — | — |
|
|
42
|
+
| `inferx/qwen/qwen3.5-122b-a10b-nvfp4` | 256K | | | | | | — | — |
|
|
43
|
+
| `inferx/qwen/qwen3.6-27b-fp8` | 262K | | | | | | — | — |
|
|
44
|
+
| `inferx/qwen/qwen3.6-35b-a3b-fp8` | 262K | | | | | | — | — |
|
|
45
|
+
|
|
46
|
+
## Advanced configuration
|
|
47
|
+
|
|
48
|
+
### Custom headers
|
|
49
|
+
|
|
50
|
+
```typescript
|
|
51
|
+
const agent = new Agent({
|
|
52
|
+
id: "custom-agent",
|
|
53
|
+
name: "custom-agent",
|
|
54
|
+
model: {
|
|
55
|
+
url: "https://model.inferx.net/endpoints/v1",
|
|
56
|
+
id: "inferx/google/gemma-4-31b-it-fp8",
|
|
57
|
+
apiKey: process.env.INFERX_API_KEY,
|
|
58
|
+
headers: {
|
|
59
|
+
"X-Custom-Header": "value"
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
});
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Dynamic model selection
|
|
66
|
+
|
|
67
|
+
```typescript
|
|
68
|
+
const agent = new Agent({
|
|
69
|
+
id: "dynamic-agent",
|
|
70
|
+
name: "Dynamic Agent",
|
|
71
|
+
model: ({ requestContext }) => {
|
|
72
|
+
const useAdvanced = requestContext.task === "complex";
|
|
73
|
+
return useAdvanced
|
|
74
|
+
? "inferx/qwen/qwen3.6-35b-a3b-fp8"
|
|
75
|
+
: "inferx/google/gemma-4-31b-it-fp8";
|
|
76
|
+
}
|
|
77
|
+
});
|
|
78
|
+
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# LLM Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 176 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
|
|
8
8
|
|
|
@@ -113,6 +113,9 @@ for await (const chunk of stream) {
|
|
|
113
113
|
| `llmgateway/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
|
|
114
114
|
| `llmgateway/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
115
115
|
| `llmgateway/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
|
|
116
|
+
| `llmgateway/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
|
|
117
|
+
| `llmgateway/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
|
|
118
|
+
| `llmgateway/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
|
|
116
119
|
| `llmgateway/gpt-oss-120b` | 131K | | | | | | $0.05 | $0.25 |
|
|
117
120
|
| `llmgateway/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.15 |
|
|
118
121
|
| `llmgateway/grok-4` | 256K | | | | | | $3 | $15 |
|
|
@@ -140,8 +143,6 @@ for await (const chunk of stream) {
|
|
|
140
143
|
| `llmgateway/llama-3.3-70b-instruct` | 131K | | | | | | $0.13 | $0.40 |
|
|
141
144
|
| `llmgateway/llama-4-maverick-17b-instruct` | 1.0M | | | | | | $0.27 | $0.85 |
|
|
142
145
|
| `llmgateway/llama-4-scout-17b-instruct` | 131K | | | | | | $0.18 | $0.59 |
|
|
143
|
-
| `llmgateway/mimo-v2-omni` | 256K | | | | | | $0.40 | $2 |
|
|
144
|
-
| `llmgateway/mimo-v2-pro` | 1.0M | | | | | | $1 | $3 |
|
|
145
146
|
| `llmgateway/mimo-v2.5` | 1.0M | | | | | | $0.14 | $0.28 |
|
|
146
147
|
| `llmgateway/mimo-v2.5-pro` | 1.0M | | | | | | $0.43 | $0.87 |
|
|
147
148
|
| `llmgateway/minimax-m2` | 197K | | | | | | $0.20 | $1 |
|
|
@@ -159,6 +160,7 @@ for await (const chunk of stream) {
|
|
|
159
160
|
| `llmgateway/mistral-large-2512` | 262K | | | | | | $0.50 | $2 |
|
|
160
161
|
| `llmgateway/mistral-large-latest` | 128K | | | | | | $4 | $12 |
|
|
161
162
|
| `llmgateway/mistral-small-2506` | 128K | | | | | | $0.10 | $0.30 |
|
|
163
|
+
| `llmgateway/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
|
|
162
164
|
| `llmgateway/nemotron-3-ultra-550b` | 262K | | | | | | $0.50 | $3 |
|
|
163
165
|
| `llmgateway/o1` | 200K | | | | | | $15 | $60 |
|
|
164
166
|
| `llmgateway/o3` | 200K | | | | | | $2 | $8 |
|
|
@@ -172,9 +174,6 @@ for await (const chunk of stream) {
|
|
|
172
174
|
| `llmgateway/qwen-omni-turbo` | 33K | | | | | | $0.20 | $0.80 |
|
|
173
175
|
| `llmgateway/qwen-plus` | 131K | | | | | | $0.40 | $1 |
|
|
174
176
|
| `llmgateway/qwen-plus-latest` | 1.0M | | | | | | $0.40 | $1 |
|
|
175
|
-
| `llmgateway/qwen-turbo` | 1.0M | | | | | | $0.05 | $0.20 |
|
|
176
|
-
| `llmgateway/qwen-vl-max` | 131K | | | | | | $0.80 | $3 |
|
|
177
|
-
| `llmgateway/qwen-vl-plus` | 131K | | | | | | $0.21 | $0.64 |
|
|
178
177
|
| `llmgateway/qwen2-5-vl-32b-instruct` | 131K | | | | | | $1 | $4 |
|
|
179
178
|
| `llmgateway/qwen2-5-vl-72b-instruct` | 33K | | | | | | $0.13 | $0.40 |
|
|
180
179
|
| `llmgateway/qwen3-235b-a22b-fp8` | 41K | | | | | | $0.20 | $0.80 |
|
|
@@ -200,12 +199,12 @@ for await (const chunk of stream) {
|
|
|
200
199
|
| `llmgateway/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
|
|
201
200
|
| `llmgateway/qwen3.5-9b` | 262K | | | | | | $0.10 | $0.15 |
|
|
202
201
|
| `llmgateway/qwen3.6-35b-a3b` | 262K | | | | | | $0.25 | $1 |
|
|
202
|
+
| `llmgateway/qwen3.6-flash` | 262K | | | | | | $0.15 | $0.90 |
|
|
203
203
|
| `llmgateway/qwen3.6-max-preview` | 262K | | | | | | $1 | $8 |
|
|
204
204
|
| `llmgateway/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
|
|
205
205
|
| `llmgateway/qwen3.7-max` | 1.0M | | | | | | $1 | $4 |
|
|
206
206
|
| `llmgateway/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
|
|
207
207
|
| `llmgateway/qwen35-397b-a17b` | 262K | | | | | | $0.60 | $4 |
|
|
208
|
-
| `llmgateway/qwq-plus` | 131K | | | | | | $0.80 | $2 |
|
|
209
208
|
| `llmgateway/seed-1-6-250615` | 256K | | | | | | $0.25 | $2 |
|
|
210
209
|
| `llmgateway/seed-1-6-250915` | 256K | | | | | | $0.25 | $2 |
|
|
211
210
|
| `llmgateway/seed-1-6-flash-250715` | 256K | | | | | | $0.07 | $0.30 |
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# Lynkr
|
|
4
|
+
|
|
5
|
+
Access 1 Lynkr model through Mastra's model router. Authentication is handled automatically using the `LYNKR_API_KEY` environment variable.
|
|
6
|
+
|
|
7
|
+
Learn more in the [Lynkr documentation](https://github.com/Fast-Editor/Lynkr).
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
LYNKR_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: "lynkr/lynkr-auto"
|
|
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
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Lynkr documentation](https://github.com/Fast-Editor/Lynkr) for details.
|
|
34
|
+
|
|
35
|
+
## Models
|
|
36
|
+
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `lynkr/lynkr-auto` | 128K | | | | | | — | — |
|
|
40
|
+
|
|
41
|
+
## Advanced configuration
|
|
42
|
+
|
|
43
|
+
### Custom headers
|
|
44
|
+
|
|
45
|
+
```typescript
|
|
46
|
+
const agent = new Agent({
|
|
47
|
+
id: "custom-agent",
|
|
48
|
+
name: "custom-agent",
|
|
49
|
+
model: {
|
|
50
|
+
url: "http://127.0.0.1:8081/v1",
|
|
51
|
+
id: "lynkr/lynkr-auto",
|
|
52
|
+
apiKey: process.env.LYNKR_API_KEY,
|
|
53
|
+
headers: {
|
|
54
|
+
"X-Custom-Header": "value"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Dynamic model selection
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
const agent = new Agent({
|
|
64
|
+
id: "dynamic-agent",
|
|
65
|
+
name: "Dynamic Agent",
|
|
66
|
+
model: ({ requestContext }) => {
|
|
67
|
+
const useAdvanced = requestContext.task === "complex";
|
|
68
|
+
return useAdvanced
|
|
69
|
+
? "lynkr/lynkr-auto"
|
|
70
|
+
: "lynkr/lynkr-auto";
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
```
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# Meta
|
|
4
|
+
|
|
5
|
+
Access 1 Meta model through Mastra's model router. Authentication is handled automatically using the `META_MODEL_API_KEY` environment variable.
|
|
6
|
+
|
|
7
|
+
Learn more in the [Meta documentation](https://dev.meta.ai/docs).
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
META_MODEL_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: "meta/muse-spark-1.1"
|
|
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
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Meta documentation](https://dev.meta.ai/docs) for details.
|
|
34
|
+
|
|
35
|
+
## Models
|
|
36
|
+
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `meta/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
|
|
40
|
+
|
|
41
|
+
## Advanced configuration
|
|
42
|
+
|
|
43
|
+
### Custom headers
|
|
44
|
+
|
|
45
|
+
```typescript
|
|
46
|
+
const agent = new Agent({
|
|
47
|
+
id: "custom-agent",
|
|
48
|
+
name: "custom-agent",
|
|
49
|
+
model: {
|
|
50
|
+
url: "https://api.meta.ai/v1",
|
|
51
|
+
id: "meta/muse-spark-1.1",
|
|
52
|
+
apiKey: process.env.META_MODEL_API_KEY,
|
|
53
|
+
headers: {
|
|
54
|
+
"X-Custom-Header": "value"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Dynamic model selection
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
const agent = new Agent({
|
|
64
|
+
id: "dynamic-agent",
|
|
65
|
+
name: "Dynamic Agent",
|
|
66
|
+
model: ({ requestContext }) => {
|
|
67
|
+
const useAdvanced = requestContext.task === "complex";
|
|
68
|
+
return useAdvanced
|
|
69
|
+
? "meta/muse-spark-1.1"
|
|
70
|
+
: "meta/muse-spark-1.1";
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## Direct provider installation
|
|
76
|
+
|
|
77
|
+
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/@ai-sdk/openai) for more details.
|
|
78
|
+
|
|
79
|
+
**npm**:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
npm install @ai-sdk/openai
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
**pnpm**:
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
pnpm add @ai-sdk/openai
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
**Yarn**:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
yarn add @ai-sdk/openai
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**Bun**:
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
bun add @ai-sdk/openai
|
|
101
|
+
```
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# Model Oracle AI
|
|
4
|
+
|
|
5
|
+
Access 15 Model Oracle AI models through Mastra's model router. Authentication is handled automatically using the `MODEL_ORACLE_API_KEY` environment variable.
|
|
6
|
+
|
|
7
|
+
Learn more in the [Model Oracle AI documentation](https://modeloracle.com/setup/).
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
MODEL_ORACLE_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: "model-oracle-ai/auto"
|
|
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
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Model Oracle AI documentation](https://modeloracle.com/setup/) for details.
|
|
34
|
+
|
|
35
|
+
## Models
|
|
36
|
+
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `model-oracle-ai/auto` | 1.0M | | | | | | — | — |
|
|
40
|
+
| `model-oracle-ai/claude-fable-5` | 1.0M | | | | | | — | — |
|
|
41
|
+
| `model-oracle-ai/claude-haiku-4.5` | 200K | | | | | | — | — |
|
|
42
|
+
| `model-oracle-ai/claude-opus-4.8` | 1.0M | | | | | | — | — |
|
|
43
|
+
| `model-oracle-ai/claude-sonnet-5` | 1.0M | | | | | | — | — |
|
|
44
|
+
| `model-oracle-ai/deepseek-v4-pro` | 1.0M | | | | | | — | — |
|
|
45
|
+
| `model-oracle-ai/glm-5.2` | 1.0M | | | | | | — | — |
|
|
46
|
+
| `model-oracle-ai/gpt-4.1` | 1.0M | | | | | | — | — |
|
|
47
|
+
| `model-oracle-ai/gpt-4.1-mini` | 1.0M | | | | | | — | — |
|
|
48
|
+
| `model-oracle-ai/gpt-5` | 400K | | | | | | — | — |
|
|
49
|
+
| `model-oracle-ai/gpt-5.4` | 1.1M | | | | | | — | — |
|
|
50
|
+
| `model-oracle-ai/gpt-5.4-mini` | 400K | | | | | | — | — |
|
|
51
|
+
| `model-oracle-ai/gpt-5.4-nano` | 400K | | | | | | — | — |
|
|
52
|
+
| `model-oracle-ai/gpt-5.5` | 1.1M | | | | | | — | — |
|
|
53
|
+
| `model-oracle-ai/o4-mini` | 200K | | | | | | — | — |
|
|
54
|
+
|
|
55
|
+
## Advanced configuration
|
|
56
|
+
|
|
57
|
+
### Custom headers
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
const agent = new Agent({
|
|
61
|
+
id: "custom-agent",
|
|
62
|
+
name: "custom-agent",
|
|
63
|
+
model: {
|
|
64
|
+
url: "https://api.modeloracle.com/api/v1",
|
|
65
|
+
id: "model-oracle-ai/auto",
|
|
66
|
+
apiKey: process.env.MODEL_ORACLE_API_KEY,
|
|
67
|
+
headers: {
|
|
68
|
+
"X-Custom-Header": "value"
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
});
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Dynamic model selection
|
|
75
|
+
|
|
76
|
+
```typescript
|
|
77
|
+
const agent = new Agent({
|
|
78
|
+
id: "dynamic-agent",
|
|
79
|
+
name: "Dynamic Agent",
|
|
80
|
+
model: ({ requestContext }) => {
|
|
81
|
+
const useAdvanced = requestContext.task === "complex";
|
|
82
|
+
return useAdvanced
|
|
83
|
+
? "model-oracle-ai/o4-mini"
|
|
84
|
+
: "model-oracle-ai/auto";
|
|
85
|
+
}
|
|
86
|
+
});
|
|
87
|
+
```
|
|
@@ -430,8 +430,8 @@ for await (const chunk of stream) {
|
|
|
430
430
|
| `nano-gpt/perceptron/perceptron-mk1` | 33K | | | | | | $0.15 | $2 |
|
|
431
431
|
| `nano-gpt/phi-4-mini-instruct` | 128K | | | | | | $0.17 | $0.68 |
|
|
432
432
|
| `nano-gpt/phi-4-multimodal-instruct` | 128K | | | | | | $0.07 | $0.11 |
|
|
433
|
-
| `nano-gpt/poolside/laguna-m.1` |
|
|
434
|
-
| `nano-gpt/poolside/laguna-xs.2` |
|
|
433
|
+
| `nano-gpt/poolside/laguna-m.1` | 262K | | | | | | $0.20 | $0.40 |
|
|
434
|
+
| `nano-gpt/poolside/laguna-xs.2` | 262K | | | | | | $0.20 | $0.40 |
|
|
435
435
|
| `nano-gpt/qvq-max` | 128K | | | | | | $1 | $5 |
|
|
436
436
|
| `nano-gpt/qwen-3.6-plus` | 992K | | | | | | $0.45 | $3 |
|
|
437
437
|
| `nano-gpt/qwen-long` | 10.0M | | | | | | $0.10 | $0.41 |
|
|
@@ -83,7 +83,7 @@ const agent = new Agent({
|
|
|
83
83
|
id: "custom-agent",
|
|
84
84
|
name: "custom-agent",
|
|
85
85
|
model: {
|
|
86
|
-
url: "${NEON_AI_GATEWAY_BASE_URL}/
|
|
86
|
+
url: "${NEON_AI_GATEWAY_BASE_URL}/v1",
|
|
87
87
|
id: "neon/claude-haiku-4-5",
|
|
88
88
|
apiKey: process.env.NEON_AI_GATEWAY_TOKEN,
|
|
89
89
|
headers: {
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Nvidia
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 82 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
|
|
8
8
|
|
|
@@ -73,8 +73,6 @@ for await (const chunk of stream) {
|
|
|
73
73
|
| `nvidia/mistralai/mistral-small-4-119b-2603` | 128K | | | | | | — | — |
|
|
74
74
|
| `nvidia/mistralai/mixtral-8x22b-instruct` | 66K | | | | | | — | — |
|
|
75
75
|
| `nvidia/mistralai/mixtral-8x7b-instruct` | 33K | | | | | | — | — |
|
|
76
|
-
| `nvidia/moonshotai/kimi-k2-instruct-0905` | 262K | | | | | | — | — |
|
|
77
|
-
| `nvidia/moonshotai/kimi-k2.6` | 262K | | | | | | — | — |
|
|
78
76
|
| `nvidia/nvidia/active-speaker-detection` | — | | | | | | — | — |
|
|
79
77
|
| `nvidia/nvidia/bevformer` | 128K | | | | | | — | — |
|
|
80
78
|
| `nvidia/nvidia/cosmos-predict1-5b` | — | | | | | | — | — |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenAI
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 56 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,10 +70,15 @@ 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 |
|
|
73
77
|
| `openai/gpt-image-1` | — | | | | | | — | — |
|
|
74
78
|
| `openai/gpt-image-1-mini` | — | | | | | | — | — |
|
|
75
79
|
| `openai/gpt-image-1.5` | — | | | | | | — | — |
|
|
76
80
|
| `openai/gpt-image-2` | — | | | | | | $5 | $30 |
|
|
81
|
+
| `openai/gpt-realtime-2.1` | 128K | | | | | | $4 | $24 |
|
|
77
82
|
| `openai/o1` | 200K | | | | | | $15 | $60 |
|
|
78
83
|
| `openai/o1-pro` | 200K | | | | | | $150 | $600 |
|
|
79
84
|
| `openai/o3` | 200K | | | | | | $2 | $8 |
|
|
@@ -137,7 +142,7 @@ const response = await agent.generate("Hello!", {
|
|
|
137
142
|
|
|
138
143
|
**conversation** (`string | null | undefined`)
|
|
139
144
|
|
|
140
|
-
**include** (`("file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
|
|
145
|
+
**include** (`("web_search_call.results" | "file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
|
|
141
146
|
|
|
142
147
|
**instructions** (`string | null | undefined`)
|
|
143
148
|
|
|
@@ -153,18 +158,26 @@ const response = await agent.generate("Hello!", {
|
|
|
153
158
|
|
|
154
159
|
**promptCacheKey** (`string | null | undefined`)
|
|
155
160
|
|
|
161
|
+
**promptCacheOptions** (`{ mode?: "explicit" | "implicit" | undefined; ttl?: "30m" | undefined; } | undefined`)
|
|
162
|
+
|
|
156
163
|
**promptCacheRetention** (`"in_memory" | "24h" | null | undefined`)
|
|
157
164
|
|
|
158
165
|
**reasoningEffort** (`string | null | undefined`)
|
|
159
166
|
|
|
167
|
+
**reasoningMode** (`"standard" | "pro" | undefined`)
|
|
168
|
+
|
|
169
|
+
**reasoningContext** (`"auto" | "current_turn" | "all_turns" | undefined`)
|
|
170
|
+
|
|
160
171
|
**reasoningSummary** (`string | null | undefined`)
|
|
161
172
|
|
|
162
173
|
**safetyIdentifier** (`string | null | undefined`)
|
|
163
174
|
|
|
164
|
-
**serviceTier** (`"
|
|
175
|
+
**serviceTier** (`"auto" | "default" | "flex" | "priority" | null | undefined`)
|
|
165
176
|
|
|
166
177
|
**store** (`boolean | null | undefined`): Controls whether OpenAI stores your API requests for model training. Required to be "false" if your organization has zero data retention enabled. See: https\://platform.openai.com/docs/guides/your-data#zero-data-retention
|
|
167
178
|
|
|
179
|
+
**passThroughUnsupportedFiles** (`boolean | undefined`)
|
|
180
|
+
|
|
168
181
|
**strictJsonSchema** (`boolean | null | undefined`)
|
|
169
182
|
|
|
170
183
|
**textVerbosity** (`"low" | "medium" | "high" | null | undefined`)
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenCode Zen
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 55 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,9 +74,12 @@ 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 |
|
|
77
80
|
| `opencode/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
78
81
|
| `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
|
|
79
|
-
| `opencode/hy3-free` |
|
|
82
|
+
| `opencode/hy3-free` | 190K | | | | | | — | — |
|
|
80
83
|
| `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
81
84
|
| `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
82
85
|
| `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
|