@mastra/mcp-docs-server 1.2.18-alpha.1 → 1.2.18-alpha.5
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/mastra-platform/workspaces.md +6 -3
- package/.docs/docs/sandbox/filesystem.md +120 -139
- package/.docs/docs/sandbox/lsp.md +195 -143
- package/.docs/docs/sandbox/overview.md +103 -69
- package/.docs/docs/sandbox/search.md +172 -153
- package/.docs/docs/sandbox/skills.md +94 -151
- package/.docs/integrations/agentic-ui/ai-sdk-ui.md +2 -1
- package/.docs/integrations/deploy/render.md +136 -89
- package/.docs/integrations/frameworks/next-js.md +3 -2
- package/.docs/models/gateways/netlify.md +227 -70
- package/.docs/models/gateways/openrouter.md +3 -4
- package/.docs/models/gateways/vercel.md +5 -3
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/crossmodel.md +3 -2
- package/.docs/models/providers/edenai.md +4 -7
- package/.docs/models/providers/empiriolabs.md +3 -2
- package/.docs/models/providers/huggingface.md +2 -1
- package/.docs/models/providers/hyper.md +9 -9
- package/.docs/models/providers/inceptron.md +4 -5
- package/.docs/models/providers/kilo.md +10 -11
- package/.docs/models/providers/llmgateway.md +4 -3
- package/.docs/models/providers/nano-gpt.md +3 -1
- package/.docs/models/providers/ofox.md +5 -5
- package/.docs/models/providers/opencode-go.md +1 -1
- package/.docs/models/providers/opencode.md +65 -65
- package/.docs/models/providers/pioneer.md +12 -12
- package/.docs/models/providers/runinfra.md +2 -1
- package/.docs/models/providers/umans-ai-coding-plan.md +1 -2
- package/.docs/models/providers/umans-ai.md +1 -2
- package/.docs/reference/agent-controller/agent-controller-class.md +1 -1
- package/.docs/reference/ai-sdk/handle-chat-stream.md +2 -1
- package/.docs/reference/observability/tracing/exporters/langfuse.md +2 -0
- package/.docs/reference/rag/metadata-filters.md +16 -8
- package/.docs/reference/rag/retrieval.md +113 -5
- package/CHANGELOG.md +14 -0
- package/package.json +5 -5
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Kilo Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 359 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Kilo Gateway documentation](https://kilo.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: "kilo/
|
|
20
|
+
model: "kilo/aion-labs/aion-2.0"
|
|
21
21
|
});
|
|
22
22
|
|
|
23
23
|
// Generate a response
|
|
@@ -40,14 +40,14 @@ for await (const chunk of stream) {
|
|
|
40
40
|
| `kilo/~anthropic/claude-haiku-latest` | 200K | | | | | | $1 | $5 |
|
|
41
41
|
| `kilo/~anthropic/claude-opus-latest` | 1.0M | | | | | | $5 | $25 |
|
|
42
42
|
| `kilo/~anthropic/claude-sonnet-latest` | 1.0M | | | | | | $2 | $10 |
|
|
43
|
-
| `kilo/~deepseek/deepseek-v4-flash-latest` | 262K | | | | | | $0.
|
|
43
|
+
| `kilo/~deepseek/deepseek-v4-flash-latest` | 262K | | | | | | $0.07 | $0.14 |
|
|
44
44
|
| `kilo/~google/gemini-flash-latest` | 1.0M | | | | | | $0.38 | $2 |
|
|
45
45
|
| `kilo/~google/gemini-pro-latest` | 1.0M | | | | | | $2 | $12 |
|
|
46
46
|
| `kilo/~moonshotai/kimi-latest` | 975K | | | | | | $3 | $13 |
|
|
47
47
|
| `kilo/~openai/gpt-latest` | 1.1M | | | | | | $3 | $15 |
|
|
48
48
|
| `kilo/~openai/gpt-mini-latest` | 400K | | | | | | $0.75 | $5 |
|
|
49
49
|
| `kilo/~x-ai/grok-latest` | 500K | | | | | | $2 | $6 |
|
|
50
|
-
| `kilo/
|
|
50
|
+
| `kilo/~z-ai/glm-latest` | 1.0M | | | | | | $1 | $4 |
|
|
51
51
|
| `kilo/aion-labs/aion-2.0` | 131K | | | | | | $0.80 | $2 |
|
|
52
52
|
| `kilo/aion-labs/aion-3.0` | 131K | | | | | | $3 | $6 |
|
|
53
53
|
| `kilo/aion-labs/aion-3.0-mini` | 131K | | | | | | $0.70 | $1 |
|
|
@@ -155,7 +155,6 @@ for await (const chunk of stream) {
|
|
|
155
155
|
| `kilo/kwaipilot/kat-coder-pro-v2` | 256K | | | | | | $0.30 | $1 |
|
|
156
156
|
| `kilo/kwaipilot/kat-coder-pro-v2.5` | 256K | | | | | | $0.74 | $3 |
|
|
157
157
|
| `kilo/liquid/lfm-2.5-2.6b:free` | 128K | | | | | | — | — |
|
|
158
|
-
| `kilo/mancer/weaver` | 8K | | | | | | $0.50 | $0.75 |
|
|
159
158
|
| `kilo/meituan/longcat-2.0` | 1.0M | | | | | | $0.75 | $3 |
|
|
160
159
|
| `kilo/meta-llama/llama-3.1-70b-instruct` | 131K | | | | | | $0.40 | $0.40 |
|
|
161
160
|
| `kilo/meta-llama/llama-3.1-8b-instruct` | 131K | | | | | | $0.02 | $0.04 |
|
|
@@ -175,7 +174,7 @@ for await (const chunk of stream) {
|
|
|
175
174
|
| `kilo/minimax/minimax-m2` | 205K | | | | | | $0.30 | $1 |
|
|
176
175
|
| `kilo/minimax/minimax-m2-her` | 66K | | | | | | $0.30 | $1 |
|
|
177
176
|
| `kilo/minimax/minimax-m2.1` | 205K | | | | | | $0.30 | $1 |
|
|
178
|
-
| `kilo/minimax/minimax-m2.5` |
|
|
177
|
+
| `kilo/minimax/minimax-m2.5` | 66K | | | | | | $0.30 | $1 |
|
|
179
178
|
| `kilo/minimax/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
|
|
180
179
|
| `kilo/minimax/minimax-m3` | 524K | | | | | | $0.30 | $1 |
|
|
181
180
|
| `kilo/mistralai/codestral-2508` | 256K | | | | | | $0.30 | $0.90 |
|
|
@@ -261,6 +260,7 @@ for await (const chunk of stream) {
|
|
|
261
260
|
| `kilo/openai/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
|
|
262
261
|
| `kilo/openai/gpt-5.6-luna-pro` | 1.1M | | | | | | $0.20 | $1 |
|
|
263
262
|
| `kilo/openai/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
|
|
263
|
+
| `kilo/openai/gpt-5.6-sol-discounted` | 1.1M | | | | | | $3 | $15 |
|
|
264
264
|
| `kilo/openai/gpt-5.6-sol-pro` | 1.1M | | | | | | $5 | $30 |
|
|
265
265
|
| `kilo/openai/gpt-5.6-terra` | 1.1M | | | | | | $2 | $12 |
|
|
266
266
|
| `kilo/openai/gpt-5.6-terra-pro` | 1.1M | | | | | | $2 | $12 |
|
|
@@ -341,7 +341,7 @@ for await (const chunk of stream) {
|
|
|
341
341
|
| `kilo/qwen/qwen3.7-max` | 1.0M | | | | | | $1 | $4 |
|
|
342
342
|
| `kilo/qwen/qwen3.7-plus` | 1.0M | | | | | | $0.32 | $1 |
|
|
343
343
|
| `kilo/qwen/qwen3.8-2.4t-a95b` | 1.0M | | | | | | $2 | $6 |
|
|
344
|
-
| `kilo/qwen/qwen3.8-27b` | 262K | | | | | | $0.
|
|
344
|
+
| `kilo/qwen/qwen3.8-27b` | 262K | | | | | | $0.55 | $3 |
|
|
345
345
|
| `kilo/qwen/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
|
|
346
346
|
| `kilo/rekaai/reka-edge` | 16K | | | | | | $0.10 | $0.10 |
|
|
347
347
|
| `kilo/rekaai/reka-flash-3` | 66K | | | | | | $0.10 | $0.20 |
|
|
@@ -356,7 +356,6 @@ for await (const chunk of stream) {
|
|
|
356
356
|
| `kilo/stealth/claude-opus-4.7` | 1.0M | | | | | | $4 | $20 |
|
|
357
357
|
| `kilo/stealth/claude-opus-4.8` | 1.0M | | | | | | $4 | $20 |
|
|
358
358
|
| `kilo/stealth/claude-sonnet-4.6` | 1.0M | | | | | | $2 | $12 |
|
|
359
|
-
| `kilo/stealth/gpt-5.6-sol` | 1.1M | | | | | | $4 | $24 |
|
|
360
359
|
| `kilo/stealth/qwen3.6-plus` | 1.0M | | | | | | $0.25 | $2 |
|
|
361
360
|
| `kilo/stepfun/step-3.5-flash` | 262K | | | | | | $0.10 | $0.30 |
|
|
362
361
|
| `kilo/stepfun/step-3.7-flash` | 256K | | | | | | $0.20 | $1 |
|
|
@@ -407,7 +406,7 @@ const agent = new Agent({
|
|
|
407
406
|
name: "custom-agent",
|
|
408
407
|
model: {
|
|
409
408
|
url: "https://api.kilo.ai/api/gateway",
|
|
410
|
-
id: "kilo/
|
|
409
|
+
id: "kilo/aion-labs/aion-2.0",
|
|
411
410
|
apiKey: process.env.KILO_API_KEY,
|
|
412
411
|
headers: {
|
|
413
412
|
"X-Custom-Header": "value"
|
|
@@ -425,8 +424,8 @@ const agent = new Agent({
|
|
|
425
424
|
model: ({ requestContext }) => {
|
|
426
425
|
const useAdvanced = requestContext.task === "complex";
|
|
427
426
|
return useAdvanced
|
|
428
|
-
? "kilo/~
|
|
429
|
-
: "kilo/
|
|
427
|
+
? "kilo/~z-ai/glm-latest"
|
|
428
|
+
: "kilo/aion-labs/aion-2.0";
|
|
430
429
|
}
|
|
431
430
|
});
|
|
432
431
|
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# LLM Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 190 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
|
|
|
@@ -37,7 +37,6 @@ for await (const chunk of stream) {
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `llmgateway/auto` | 128K | | | | | | — | — |
|
|
40
|
-
| `llmgateway/claude-3-opus` | 200K | | | | | | $15 | $75 |
|
|
41
40
|
| `llmgateway/claude-fable-5` | 1.0M | | | | | | $10 | $50 |
|
|
42
41
|
| `llmgateway/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
|
|
43
42
|
| `llmgateway/claude-haiku-4-5-20251001` | 200K | | | | | | $1 | $5 |
|
|
@@ -55,7 +54,7 @@ for await (const chunk of stream) {
|
|
|
55
54
|
| `llmgateway/cosmos3-super-reasoner` | 262K | | | | | | $0.10 | $0.30 |
|
|
56
55
|
| `llmgateway/custom` | 128K | | | | | | — | — |
|
|
57
56
|
| `llmgateway/deepseek-v3.2` | 164K | | | | | | $0.26 | $0.38 |
|
|
58
|
-
| `llmgateway/deepseek-v4-flash` | 1.1M | | | | | | $0.
|
|
57
|
+
| `llmgateway/deepseek-v4-flash` | 1.1M | | | | | | $0.08 | $0.15 |
|
|
59
58
|
| `llmgateway/deepseek-v4-pro` | 1.1M | | | | | | $0.43 | $0.87 |
|
|
60
59
|
| `llmgateway/ernie-4.5-vl-424b-a47b` | 123K | | | | | | $0.42 | $1 |
|
|
61
60
|
| `llmgateway/fugu-ultra` | 1.0M | | | | | | $5 | $30 |
|
|
@@ -88,6 +87,8 @@ for await (const chunk of stream) {
|
|
|
88
87
|
| `llmgateway/glm-5` | 203K | | | | | | $0.72 | $2 |
|
|
89
88
|
| `llmgateway/glm-5.1` | 205K | | | | | | $0.93 | $3 |
|
|
90
89
|
| `llmgateway/glm-5.2` | 1.0M | | | | | | $0.55 | $2 |
|
|
90
|
+
| `llmgateway/glm-5.2-fast` | 1.0M | | | | | | $2 | $6 |
|
|
91
|
+
| `llmgateway/glm-5.3` | 1.0M | | | | | | $1 | $4 |
|
|
91
92
|
| `llmgateway/gpt-3.5-turbo` | 16K | | | | | | $0.50 | $2 |
|
|
92
93
|
| `llmgateway/gpt-4` | 8K | | | | | | $30 | $60 |
|
|
93
94
|
| `llmgateway/gpt-4-turbo` | 128K | | | | | | $10 | $30 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# NanoGPT
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 595 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
|
|
8
8
|
|
|
@@ -422,6 +422,8 @@ for await (const chunk of stream) {
|
|
|
422
422
|
| `nano-gpt/openai/o4-mini` | 200K | | | | | | $1 | $4 |
|
|
423
423
|
| `nano-gpt/openai/o4-mini-deep-research` | 200K | | | | | | $2 | $9 |
|
|
424
424
|
| `nano-gpt/openai/o4-mini-high` | 200K | | | | | | $1 | $4 |
|
|
425
|
+
| `nano-gpt/ornith-ai/ornith-1.5-35b-a3b` | 262K | | | | | | $0.10 | $0.40 |
|
|
426
|
+
| `nano-gpt/ornith-ai/ornith-1.5-35b-a3b:thinking` | 262K | | | | | | $0.10 | $0.40 |
|
|
425
427
|
| `nano-gpt/pamanseau/OpenReasoning-Nemotron-32B` | 33K | | | | | | $0.10 | $0.40 |
|
|
426
428
|
| `nano-gpt/perceptron/perceptron-mk1` | 33K | | | | | | $0.15 | $2 |
|
|
427
429
|
| `nano-gpt/perplexity-academic-researcher` | 127K | | | | | | $2 | $8 |
|
|
@@ -63,7 +63,7 @@ for await (const chunk of stream) {
|
|
|
63
63
|
| `ofox/bailian/qwen3.5-plus` | 1.0M | | | | | | $0.40 | $2 |
|
|
64
64
|
| `ofox/bailian/qwen3.6-27b` | 256K | | | | | | $0.60 | $4 |
|
|
65
65
|
| `ofox/bailian/qwen3.6-flash` | 1.0M | | | | | | $0.25 | $2 |
|
|
66
|
-
| `ofox/bailian/qwen3.6-max-preview` | 262K | | | | | | $2 | $
|
|
66
|
+
| `ofox/bailian/qwen3.6-max-preview` | 262K | | | | | | $2 | $13 |
|
|
67
67
|
| `ofox/bailian/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
|
|
68
68
|
| `ofox/bailian/qwen3.7-max` | 1.0M | | | | | | $3 | $8 |
|
|
69
69
|
| `ofox/bailian/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
|
|
@@ -115,7 +115,7 @@ for await (const chunk of stream) {
|
|
|
115
115
|
| `ofox/openai/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
|
|
116
116
|
| `ofox/openai/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
117
117
|
| `ofox/openai/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
|
|
118
|
-
| `ofox/openai/gpt-5.6-sol` | 1.1M | | | | | | $
|
|
118
|
+
| `ofox/openai/gpt-5.6-sol` | 1.1M | | | | | | $3 | $15 |
|
|
119
119
|
| `ofox/openai/gpt-5.6-terra` | 1.1M | | | | | | $2 | $12 |
|
|
120
120
|
| `ofox/volcengine/doubao-seed-1-6` | 256K | | | | | | $0.12 | $0.29 |
|
|
121
121
|
| `ofox/volcengine/doubao-seed-1-6-flash` | 256K | | | | | | $0.03 | $0.22 |
|
|
@@ -125,8 +125,8 @@ for await (const chunk of stream) {
|
|
|
125
125
|
| `ofox/volcengine/doubao-seed-2.0-lite` | 256K | | | | | | $0.13 | $0.76 |
|
|
126
126
|
| `ofox/volcengine/doubao-seed-2.0-mini` | 256K | | | | | | $0.06 | $0.56 |
|
|
127
127
|
| `ofox/volcengine/doubao-seed-2.0-pro` | 256K | | | | | | $0.67 | $3 |
|
|
128
|
-
| `ofox/volcengine/doubao-seed-2.1-pro` | 256K | | | | | | $0.
|
|
129
|
-
| `ofox/volcengine/doubao-seed-2.1-turbo` | 256K | | | | | | $0.
|
|
128
|
+
| `ofox/volcengine/doubao-seed-2.1-pro` | 256K | | | | | | $0.71 | $4 |
|
|
129
|
+
| `ofox/volcengine/doubao-seed-2.1-turbo` | 256K | | | | | | $0.35 | $2 |
|
|
130
130
|
| `ofox/volcengine/doubao-seed-character` | 256K | | | | | | $0.18 | $0.88 |
|
|
131
131
|
| `ofox/volcengine/doubao-seed-evolving` | 256K | | | | | | $0.88 | $4 |
|
|
132
132
|
| `ofox/x-ai/grok-4.1-fast` | 2.0M | | | | | | $0.20 | $0.50 |
|
|
@@ -140,7 +140,7 @@ for await (const chunk of stream) {
|
|
|
140
140
|
| `ofox/z-ai/glm-5` | 205K | | | | | | $1 | $3 |
|
|
141
141
|
| `ofox/z-ai/glm-5-turbo` | 200K | | | | | | $1 | $4 |
|
|
142
142
|
| `ofox/z-ai/glm-5.1` | 200K | | | | | | $1 | $4 |
|
|
143
|
-
| `ofox/z-ai/glm-5.2` | 1.0M | | | | | | $
|
|
143
|
+
| `ofox/z-ai/glm-5.2` | 1.0M | | | | | | $0.98 | $3 |
|
|
144
144
|
| `ofox/z-ai/glm-5.3` | 1.0M | | | | | | $1 | $4 |
|
|
145
145
|
| `ofox/z-ai/glm-5v-turbo` | 200K | | | | | | $1 | $4 |
|
|
146
146
|
|
|
@@ -43,7 +43,7 @@ for await (const chunk of stream) {
|
|
|
43
43
|
| `opencode-go/glm-5.3` | 1.0M | | | | | | $1 | $4 |
|
|
44
44
|
| `opencode-go/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
|
|
45
45
|
| `opencode-go/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
46
|
-
| `opencode-go/hy3` | 256K | | | | | | $0.
|
|
46
|
+
| `opencode-go/hy3` | 256K | | | | | | $0.02 | $0.07 |
|
|
47
47
|
| `opencode-go/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
48
48
|
| `opencode-go/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
|
|
49
49
|
| `opencode-go/kimi-k3` | 1.0M | | | | | | $3 | $15 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenCode Zen
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 92 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
|
|
|
@@ -34,70 +34,70 @@ for await (const chunk of stream) {
|
|
|
34
34
|
|
|
35
35
|
## Models
|
|
36
36
|
|
|
37
|
-
| Model
|
|
38
|
-
|
|
|
39
|
-
| `opencode/big-pickle`
|
|
40
|
-
| `opencode/claude-fable-5`
|
|
41
|
-
| `opencode/claude-haiku-4-5`
|
|
42
|
-
| `opencode/claude-opus-4-5`
|
|
43
|
-
| `opencode/claude-opus-4-6`
|
|
44
|
-
| `opencode/claude-opus-4-7`
|
|
45
|
-
| `opencode/claude-opus-4-8`
|
|
46
|
-
| `opencode/claude-opus-5`
|
|
47
|
-
| `opencode/claude-sonnet-4`
|
|
48
|
-
| `opencode/claude-sonnet-4-5`
|
|
49
|
-
| `opencode/claude-sonnet-4-6`
|
|
50
|
-
| `opencode/claude-sonnet-5`
|
|
51
|
-
| `opencode/deepseek-v4-flash`
|
|
52
|
-
| `opencode/deepseek-v4-flash-free`
|
|
53
|
-
| `opencode/deepseek-v4-pro`
|
|
54
|
-
| `opencode/gemini-3-flash`
|
|
55
|
-
| `opencode/gemini-3.1-pro`
|
|
56
|
-
| `opencode/gemini-3.5-flash`
|
|
57
|
-
| `opencode/gemini-3.5-flash-lite`
|
|
58
|
-
| `opencode/gemini-3.6-flash`
|
|
59
|
-
| `opencode/gemini-3.7-flash`
|
|
60
|
-
| `opencode/glm-5`
|
|
61
|
-
| `opencode/glm-5.1`
|
|
62
|
-
| `opencode/glm-5.2`
|
|
63
|
-
| `opencode/gpt-5`
|
|
64
|
-
| `opencode/gpt-5-codex`
|
|
65
|
-
| `opencode/gpt-5-nano`
|
|
66
|
-
| `opencode/gpt-5.1`
|
|
67
|
-
| `opencode/gpt-5.1-codex`
|
|
68
|
-
| `opencode/gpt-5.1-codex-max`
|
|
69
|
-
| `opencode/gpt-5.1-codex-mini`
|
|
70
|
-
| `opencode/gpt-5.2`
|
|
71
|
-
| `opencode/gpt-5.2-codex`
|
|
72
|
-
| `opencode/gpt-5.3-codex`
|
|
73
|
-
| `opencode/gpt-5.3-codex-spark`
|
|
74
|
-
| `opencode/gpt-5.4`
|
|
75
|
-
| `opencode/gpt-5.4-mini`
|
|
76
|
-
| `opencode/gpt-5.4-nano`
|
|
77
|
-
| `opencode/gpt-5.4-pro`
|
|
78
|
-
| `opencode/gpt-5.5`
|
|
79
|
-
| `opencode/gpt-5.5-pro`
|
|
80
|
-
| `opencode/gpt-5.6-luna`
|
|
81
|
-
| `opencode/gpt-5.6-sol`
|
|
82
|
-
| `opencode/gpt-5.6-terra`
|
|
83
|
-
| `opencode/grok-4.5`
|
|
84
|
-
| `opencode/grok-4.6`
|
|
85
|
-
| `opencode/grok-build-0.1`
|
|
86
|
-
| `opencode/hy3-free`
|
|
87
|
-
| `opencode/kimi-k2.5`
|
|
88
|
-
| `opencode/kimi-k2.6`
|
|
89
|
-
| `opencode/kimi-k2.7-code`
|
|
90
|
-
| `opencode/kimi-k3`
|
|
91
|
-
| `opencode/
|
|
92
|
-
| `opencode/
|
|
93
|
-
| `opencode/minimax-m2.
|
|
94
|
-
| `opencode/minimax-
|
|
95
|
-
| `opencode/
|
|
96
|
-
| `opencode/muse-spark-1.2`
|
|
97
|
-
| `opencode/nemotron-3-ultra-free`
|
|
98
|
-
| `opencode/nemotron-3.5-lightning-free`
|
|
99
|
-
| `opencode/qwen3.5-plus`
|
|
100
|
-
| `opencode/qwen3.6-plus`
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| ------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `opencode/big-pickle` | 200K | | | | | | — | — |
|
|
40
|
+
| `opencode/claude-fable-5` | 1.0M | | | | | | $10 | $50 |
|
|
41
|
+
| `opencode/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
|
|
42
|
+
| `opencode/claude-opus-4-5` | 200K | | | | | | $5 | $25 |
|
|
43
|
+
| `opencode/claude-opus-4-6` | 1.0M | | | | | | $5 | $25 |
|
|
44
|
+
| `opencode/claude-opus-4-7` | 1.0M | | | | | | $5 | $25 |
|
|
45
|
+
| `opencode/claude-opus-4-8` | 1.0M | | | | | | $5 | $25 |
|
|
46
|
+
| `opencode/claude-opus-5` | 1.0M | | | | | | $5 | $25 |
|
|
47
|
+
| `opencode/claude-sonnet-4` | 1.0M | | | | | | $3 | $15 |
|
|
48
|
+
| `opencode/claude-sonnet-4-5` | 1.0M | | | | | | $3 | $15 |
|
|
49
|
+
| `opencode/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
|
|
50
|
+
| `opencode/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
|
|
51
|
+
| `opencode/deepseek-v4-flash` | 1.0M | | | | | | $0.14 | $0.28 |
|
|
52
|
+
| `opencode/deepseek-v4-flash-free` | 200K | | | | | | — | — |
|
|
53
|
+
| `opencode/deepseek-v4-pro` | 1.0M | | | | | | $2 | $4 |
|
|
54
|
+
| `opencode/gemini-3-flash` | 1.0M | | | | | | $0.50 | $3 |
|
|
55
|
+
| `opencode/gemini-3.1-pro` | 1.0M | | | | | | $2 | $12 |
|
|
56
|
+
| `opencode/gemini-3.5-flash` | 1.0M | | | | | | $2 | $9 |
|
|
57
|
+
| `opencode/gemini-3.5-flash-lite` | 1.0M | | | | | | $0.30 | $3 |
|
|
58
|
+
| `opencode/gemini-3.6-flash` | 1.0M | | | | | | $2 | $8 |
|
|
59
|
+
| `opencode/gemini-3.7-flash` | 1.0M | | | | | | $2 | $8 |
|
|
60
|
+
| `opencode/glm-5` | 205K | | | | | | $1 | $3 |
|
|
61
|
+
| `opencode/glm-5.1` | 205K | | | | | | $1 | $4 |
|
|
62
|
+
| `opencode/glm-5.2` | 1.0M | | | | | | $1 | $4 |
|
|
63
|
+
| `opencode/gpt-5` | 400K | | | | | | $1 | $9 |
|
|
64
|
+
| `opencode/gpt-5-codex` | 400K | | | | | | $1 | $9 |
|
|
65
|
+
| `opencode/gpt-5-nano` | 400K | | | | | | $0.05 | $0.40 |
|
|
66
|
+
| `opencode/gpt-5.1` | 400K | | | | | | $1 | $9 |
|
|
67
|
+
| `opencode/gpt-5.1-codex` | 400K | | | | | | $1 | $9 |
|
|
68
|
+
| `opencode/gpt-5.1-codex-max` | 400K | | | | | | $1 | $10 |
|
|
69
|
+
| `opencode/gpt-5.1-codex-mini` | 400K | | | | | | $0.25 | $2 |
|
|
70
|
+
| `opencode/gpt-5.2` | 400K | | | | | | $2 | $14 |
|
|
71
|
+
| `opencode/gpt-5.2-codex` | 400K | | | | | | $2 | $14 |
|
|
72
|
+
| `opencode/gpt-5.3-codex` | 400K | | | | | | $2 | $14 |
|
|
73
|
+
| `opencode/gpt-5.3-codex-spark` | 128K | | | | | | $2 | $14 |
|
|
74
|
+
| `opencode/gpt-5.4` | 1.1M | | | | | | $3 | $15 |
|
|
75
|
+
| `opencode/gpt-5.4-mini` | 400K | | | | | | $0.75 | $5 |
|
|
76
|
+
| `opencode/gpt-5.4-nano` | 400K | | | | | | $0.20 | $1 |
|
|
77
|
+
| `opencode/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
|
|
78
|
+
| `opencode/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
79
|
+
| `opencode/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
|
|
80
|
+
| `opencode/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
|
|
81
|
+
| `opencode/gpt-5.6-sol` | 1.1M | | | | | | $3 | $15 |
|
|
82
|
+
| `opencode/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
|
|
83
|
+
| `opencode/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
84
|
+
| `opencode/grok-4.6` | 500K | | | | | | $2 | $6 |
|
|
85
|
+
| `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
|
|
86
|
+
| `opencode/hy3-free` | 190K | | | | | | — | — |
|
|
87
|
+
| `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
88
|
+
| `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
89
|
+
| `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
|
|
90
|
+
| `opencode/kimi-k3` | 1.0M | | | | | | $3 | $15 |
|
|
91
|
+
| `opencode/mimo-v2.5-free` | 200K | | | | | | — | — |
|
|
92
|
+
| `opencode/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
|
|
93
|
+
| `opencode/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
|
|
94
|
+
| `opencode/minimax-m3` | 512K | | | | | | $0.30 | $1 |
|
|
95
|
+
| `opencode/muse-spark-1.2` | 1.0M | | | | | | $1 | $4 |
|
|
96
|
+
| `opencode/muse-spark-1.2-contributor-free` | 1.0M | | | | | | — | — |
|
|
97
|
+
| `opencode/nemotron-3-ultra-free` | 1.0M | | | | | | — | — |
|
|
98
|
+
| `opencode/nemotron-3.5-lightning-free` | 262K | | | | | | — | — |
|
|
99
|
+
| `opencode/qwen3.5-plus` | 262K | | | | | | $0.20 | $1 |
|
|
100
|
+
| `opencode/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
|
|
101
101
|
|
|
102
102
|
## Advanced configuration
|
|
103
103
|
|
|
@@ -90,29 +90,29 @@ for await (const chunk of stream) {
|
|
|
90
90
|
| `pioneer/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
91
91
|
| `pioneer/HuggingFaceTB/SmolLM3-3B-Base` | 33K | | | | | | $0.15 | $0.15 |
|
|
92
92
|
| `pioneer/LiquidAI/LFM2-24B-A2B` | 33K | | | | | | $0.03 | $0.12 |
|
|
93
|
-
| `pioneer/meta-llama/Llama-3.1-8B-Instruct` |
|
|
93
|
+
| `pioneer/meta-llama/Llama-3.1-8B-Instruct` | 128K | | | | | | $0.20 | $0.20 |
|
|
94
94
|
| `pioneer/meta-llama/Llama-3.2-1B` | 131K | | | | | | $0.10 | $0.10 |
|
|
95
95
|
| `pioneer/meta-llama/Llama-3.2-1B-Instruct` | 131K | | | | | | $0.10 | $0.20 |
|
|
96
96
|
| `pioneer/meta-llama/Llama-3.2-3B` | 131K | | | | | | $0.10 | $0.10 |
|
|
97
97
|
| `pioneer/meta-llama/Llama-3.2-3B-Instruct` | 131K | | | | | | $0.10 | $0.34 |
|
|
98
|
-
| `pioneer/meta-llama/Llama-3.3-70B-Instruct` |
|
|
98
|
+
| `pioneer/meta-llama/Llama-3.3-70B-Instruct` | 16K | | | | | | $0.90 | $0.90 |
|
|
99
99
|
| `pioneer/meta/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
|
|
100
100
|
| `pioneer/MiniMaxAI/MiniMax-M2.7` | 205K | | | | | | $0.28 | $1 |
|
|
101
101
|
| `pioneer/MiniMaxAI/MiniMax-M3` | 1.0M | | | | | | $0.30 | $1 |
|
|
102
102
|
| `pioneer/mistral-large-3` | 256K | | | | | | $0.50 | $2 |
|
|
103
|
-
| `pioneer/mistral-medium-3.5` |
|
|
103
|
+
| `pioneer/mistral-medium-3.5` | 256K | | | | | | $2 | $8 |
|
|
104
104
|
| `pioneer/mistralai/Codestral-22B-v0.1` | 128K | | | | | | $0.30 | $0.90 |
|
|
105
105
|
| `pioneer/mistralai/Magistral-Small-2506` | 128K | | | | | | $0.50 | $2 |
|
|
106
106
|
| `pioneer/mistralai/Ministral-8B-Instruct-2410` | 128K | | | | | | $0.15 | $0.15 |
|
|
107
107
|
| `pioneer/mistralai/Mistral-7B-Instruct-v0.3` | 33K | | | | | | $0.20 | $0.20 |
|
|
108
|
-
| `pioneer/mistralai/Mistral-Nemo-Instruct-2407` |
|
|
109
|
-
| `pioneer/mistralai/Mistral-Small-4-119B-2603` |
|
|
108
|
+
| `pioneer/mistralai/Mistral-Nemo-Instruct-2407` | 128K | | | | | | $0.02 | $0.03 |
|
|
109
|
+
| `pioneer/mistralai/Mistral-Small-4-119B-2603` | 32K | | | | | | $0.15 | $0.60 |
|
|
110
110
|
| `pioneer/mistralai/Pixtral-12B-2409` | 128K | | | | | | $0.15 | $0.15 |
|
|
111
111
|
| `pioneer/moonshotai/Kimi-K2.6` | 262K | | | | | | $0.95 | $4 |
|
|
112
|
-
| `pioneer/moonshotai/Kimi-K2.7-Code` |
|
|
112
|
+
| `pioneer/moonshotai/Kimi-K2.7-Code` | 256K | | | | | | $0.95 | $4 |
|
|
113
113
|
| `pioneer/moonshotai/Kimi-K3` | 1.0M | | | | | | $3 | $15 |
|
|
114
114
|
| `pioneer/nvidia/NVIDIA-Nemotron-3-Nano-30B-A3B-BF16` | 262K | | | | | | $0.05 | $0.20 |
|
|
115
|
-
| `pioneer/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8` |
|
|
115
|
+
| `pioneer/nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-FP8` | 256K | | | | | | $0.09 | $0.45 |
|
|
116
116
|
| `pioneer/nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-BF16` | 1.0M | | | | | | $0.50 | $3 |
|
|
117
117
|
| `pioneer/openai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
|
|
118
118
|
| `pioneer/openai/gpt-oss-20b` | 131K | | | | | | $0.07 | $0.30 |
|
|
@@ -123,20 +123,20 @@ for await (const chunk of stream) {
|
|
|
123
123
|
| `pioneer/Qwen/Qwen3-235B-A22B-Instruct-2507` | 262K | | | | | | $1 | $1 |
|
|
124
124
|
| `pioneer/Qwen/Qwen3-32B` | 131K | | | | | | $0.90 | $0.90 |
|
|
125
125
|
| `pioneer/Qwen/Qwen3-4B-Base` | 33K | | | | | | $0.15 | $0.15 |
|
|
126
|
-
| `pioneer/Qwen/Qwen3-4B-Instruct-2507` |
|
|
127
|
-
| `pioneer/Qwen/Qwen3-8B` |
|
|
126
|
+
| `pioneer/Qwen/Qwen3-4B-Instruct-2507` | 33K | | | | | | $0.20 | $0.20 |
|
|
127
|
+
| `pioneer/Qwen/Qwen3-8B` | 41K | | | | | | $0.20 | $0.20 |
|
|
128
128
|
| `pioneer/Qwen/Qwen3.5-9B` | 33K | | | | | | $0.30 | $0.30 |
|
|
129
129
|
| `pioneer/Qwen/Qwen3.6-27B` | 33K | | | | | | $0.60 | $0.60 |
|
|
130
130
|
| `pioneer/Qwen/Qwen3.6-35B-A3B` | 262K | | | | | | $0.14 | $1 |
|
|
131
131
|
| `pioneer/qwen3.6-flash` | 1.0M | | | | | | $0.19 | $1 |
|
|
132
|
-
| `pioneer/qwen3.6-max-preview` |
|
|
132
|
+
| `pioneer/qwen3.6-max-preview` | 240K | | | | | | $1 | $6 |
|
|
133
133
|
| `pioneer/qwen3.6-plus` | 1.0M | | | | | | $0.33 | $2 |
|
|
134
|
-
| `pioneer/qwen3.7-max` |
|
|
134
|
+
| `pioneer/qwen3.7-max` | 991K | | | | | | $1 | $4 |
|
|
135
135
|
| `pioneer/qwen3.7-plus` | 1.0M | | | | | | $0.32 | $1 |
|
|
136
136
|
| `pioneer/sakana/fugu-ultra` | 1.0M | | | | | | $5 | $30 |
|
|
137
137
|
| `pioneer/XiaomiMiMo/MiMo-V2.5` | 1.1M | | | | | | $0.14 | $0.28 |
|
|
138
138
|
| `pioneer/XiaomiMiMo/MiMo-V2.5-Pro` | 1.1M | | | | | | $0.43 | $0.87 |
|
|
139
|
-
| `pioneer/zai-org/GLM-5.1` |
|
|
139
|
+
| `pioneer/zai-org/GLM-5.1` | 202K | | | | | | $0.98 | $3 |
|
|
140
140
|
| `pioneer/zai-org/GLM-5.2` | 1.0M | | | | | | $1 | $4 |
|
|
141
141
|
|
|
142
142
|
## Advanced configuration
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# RunInfra
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 5 RunInfra models through Mastra's model router. Authentication is handled automatically using the `RUNINFRA_GATEWAY_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [RunInfra documentation](https://runinfra.ai/docs).
|
|
8
8
|
|
|
@@ -37,6 +37,7 @@ for await (const chunk of stream) {
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| ------------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `runinfra/deepseek-ai/DeepSeek-V4-Flash-0731` | 1.0M | | | | | | $0.13 | $0.27 |
|
|
40
|
+
| `runinfra/deepseek-ai/DeepSeek-V4-Pro-0813` | 1.0M | | | | | | $0.60 | $2 |
|
|
40
41
|
| `runinfra/Inferact/Qwen3.8-2.4T-A95B-NVFP4` | 262K | | | | | | $2 | $6 |
|
|
41
42
|
| `runinfra/nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16` | 262K | | | | | | $0.05 | $0.15 |
|
|
42
43
|
| `runinfra/Qwen/Qwen3.8-27B` | 262K | | | | | | $0.10 | $0.40 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Umans AI Coding Plan
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 8 Umans AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_CODING_PLAN_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Umans AI Coding Plan documentation](https://app.umans.ai/offers/code/docs).
|
|
8
8
|
|
|
@@ -40,7 +40,6 @@ for await (const chunk of stream) {
|
|
|
40
40
|
| `umans-ai-coding-plan/umans-deepseek-v4-flash-0731` | 1.0M | | | | | | — | — |
|
|
41
41
|
| `umans-ai-coding-plan/umans-deepseek-v4-pro-0813` | 1.0M | | | | | | — | — |
|
|
42
42
|
| `umans-ai-coding-plan/umans-flash` | 262K | | | | | | — | — |
|
|
43
|
-
| `umans-ai-coding-plan/umans-glm-5.1` | 205K | | | | | | — | — |
|
|
44
43
|
| `umans-ai-coding-plan/umans-glm-5.2` | 406K | | | | | | — | — |
|
|
45
44
|
| `umans-ai-coding-plan/umans-kimi-k2.7` | 262K | | | | | | — | — |
|
|
46
45
|
| `umans-ai-coding-plan/umans-kimi-k3` | 1.0M | | | | | | — | — |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Umans AI
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 7 Umans AI models through Mastra's model router. Authentication is handled automatically using the `UMANS_AI_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Umans AI documentation](https://app.umans.ai/offers/code/docs/orgs).
|
|
8
8
|
|
|
@@ -40,7 +40,6 @@ for await (const chunk of stream) {
|
|
|
40
40
|
| `umans-ai/umans-deepseek-v4-flash-0731` | 1.0M | | | | | | $0.14 | $0.28 |
|
|
41
41
|
| `umans-ai/umans-deepseek-v4-pro-0813` | 1.0M | | | | | | $1 | $4 |
|
|
42
42
|
| `umans-ai/umans-flash` | 262K | | | | | | $0.15 | $1 |
|
|
43
|
-
| `umans-ai/umans-glm-5.1` | 205K | | | | | | $1 | $4 |
|
|
44
43
|
| `umans-ai/umans-glm-5.2` | 406K | | | | | | $1 | $4 |
|
|
45
44
|
| `umans-ai/umans-kimi-k2.7` | 262K | | | | | | $0.95 | $4 |
|
|
46
45
|
| `umans-ai/umans-kimi-k3` | 1.0M | | | | | | $3 | $15 |
|
|
@@ -292,7 +292,7 @@ interface ActiveThreadRun {
|
|
|
292
292
|
|
|
293
293
|
#### `init()`
|
|
294
294
|
|
|
295
|
-
Initialize shared storage,
|
|
295
|
+
Initialize shared storage, propagate runtime services to agents, and start configured interval handlers. Configured workspaces initialize lazily when used. Repeated calls reuse the same initialization promise.
|
|
296
296
|
|
|
297
297
|
```typescript
|
|
298
298
|
await controller.init()
|
|
@@ -6,7 +6,7 @@ Framework-agnostic handler for streaming agent chat in AI SDK-compatible format.
|
|
|
6
6
|
|
|
7
7
|
`handleChatStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
|
|
8
8
|
|
|
9
|
-
`handleChatStream()`
|
|
9
|
+
`handleChatStream()` defaults to AI SDK v5 for backward compatibility. Pass the version that matches your installed AI SDK, such as `version: 'v7'` for AI SDK v7.
|
|
10
10
|
|
|
11
11
|
Use [`chatRoute()`](https://mastra.ai/reference/ai-sdk/chat-route) if you want to create a chat route inside a Mastra server.
|
|
12
12
|
|
|
@@ -41,6 +41,7 @@ export async function POST(req: Request) {
|
|
|
41
41
|
const stream = await handleChatStream({
|
|
42
42
|
mastra,
|
|
43
43
|
agentId: 'weatherAgent',
|
|
44
|
+
version: 'v7',
|
|
44
45
|
params,
|
|
45
46
|
messageMetadata: () => ({ createdAt: new Date().toISOString() }),
|
|
46
47
|
})
|
|
@@ -17,6 +17,7 @@ interface LangfuseExporterConfig extends BaseExporterConfig {
|
|
|
17
17
|
publicKey?: string
|
|
18
18
|
secretKey?: string
|
|
19
19
|
baseUrl?: string
|
|
20
|
+
additionalHeaders?: Record<string, string>
|
|
20
21
|
realtime?: boolean
|
|
21
22
|
flushAt?: number
|
|
22
23
|
flushInterval?: number
|
|
@@ -78,6 +79,7 @@ const exporter = new LangfuseExporter({
|
|
|
78
79
|
publicKey: process.env.LANGFUSE_PUBLIC_KEY,
|
|
79
80
|
secretKey: process.env.LANGFUSE_SECRET_KEY,
|
|
80
81
|
baseUrl: 'https://cloud.langfuse.com',
|
|
82
|
+
additionalHeaders: { 'x-custom-header': 'custom-value' },
|
|
81
83
|
realtime: true,
|
|
82
84
|
})
|
|
83
85
|
```
|
|
@@ -46,7 +46,7 @@ const results = await store.query({
|
|
|
46
46
|
|
|
47
47
|
### Custom Operators
|
|
48
48
|
|
|
49
|
-
`$contains`Text contains substring{ description: { $contains: "sale" } }Supported by: Upstash, libSQL, PgVector, OracleDB`$regex`Regular expression match{ name: { $regex: "^test" } }Supported by: Qdrant, PgVector, Upstash, MongoDB, OracleDB`$size`Array length check{ tags: { $size: 3 } }Supported by: Astra, libSQL, PgVector, MongoDB, OracleDB`$geo`Geospatial query{ location: { $geo: { type: "radius", ... } } }Supported by: Qdrant`$datetime`Datetime range query{ created: { $datetime: { range: { gt: "2024-01-01" } } } }Supported by: Qdrant`$hasId`Vector ID existence check{ $hasId: \["id1", "id2"] }Supported by: Qdrant`$hasVector`Vector existence check{ $hasVector: true }Supported by: Qdrant
|
|
49
|
+
`$contains`Text contains substring{ description: { $contains: "sale" } }Supported by: Upstash, libSQL, PgVector, OracleDB`$regex`Regular expression match{ name: { $regex: "^test" } }Supported by: Qdrant, PgVector, Upstash, MongoDB, OracleDB`$size`Array length check{ tags: { $size: { $gt: 2 } } } — MongoDB requires an integer instead: { tags: { $size: 3 } }Supported by: Astra, libSQL, PgVector, MongoDB, OracleDB`$geo`Geospatial query{ location: { $geo: { type: "radius", ... } } }Supported by: Qdrant`$datetime`Datetime range query{ created: { $datetime: { range: { gt: "2024-01-01" } } } }Supported by: Qdrant`$hasId`Vector ID existence check{ $hasId: \["id1", "id2"] }Supported by: Qdrant`$hasVector`Vector existence check{ $hasVector: true }Supported by: Qdrant
|
|
50
50
|
|
|
51
51
|
## Common rules and restrictions
|
|
52
52
|
|
|
@@ -186,13 +186,21 @@ const results = await store.query({
|
|
|
186
186
|
|
|
187
187
|
### MongoDB
|
|
188
188
|
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
- Supports
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
|
|
195
|
-
|
|
189
|
+
- Requires MongoDB Atlas or a deployment with MongoDB Vector Search enabled. The store queries with the `$vectorSearch` aggregation stage.
|
|
190
|
+
- Uses MongoDB query syntax directly for metadata filters, including nested fields and arrays in metadata.
|
|
191
|
+
- Supports the comparison, array, logical, and element operators in the tables above, plus `$regex` and `$size`. `$size` takes an integer, as in `{ tags: { $size: 3 } }`.
|
|
192
|
+
- Use `filter` to match fields in the metadata object and `documentFilter` to match the original document text. You can combine them in a single query.
|
|
193
|
+
- Declare the metadata fields you filter on in `filterFields` when you create the index. Mastra passes filters that use only declared fields and the operators MongoDB Vector Search accepts (`$and`, `$or`, `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`) directly to `$vectorSearch`:
|
|
194
|
+
|
|
195
|
+
```typescript
|
|
196
|
+
await store.createIndex({
|
|
197
|
+
indexName: 'my_index',
|
|
198
|
+
dimension: 1536,
|
|
199
|
+
filterFields: ['category', 'price'],
|
|
200
|
+
})
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
- Filters that reference an undeclared field or use another operator take a fallback path: Mastra pre-filters the collection and passes the matching document IDs to `$vectorSearch`. This works only while the ID set fits within MongoDB's 16 MB BSON document limit. On large collections the query fails once that limit is exceeded, so declare your filter fields for selective queries over large data sets.
|
|
196
204
|
|
|
197
205
|
### Couchbase
|
|
198
206
|
|