@mastra/mcp-docs-server 1.3.8-alpha.11 → 1.3.8-alpha.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/.docs/models/gateways/netlify.md +3 -2
  2. package/.docs/models/gateways/openrouter.md +2 -2
  3. package/.docs/models/index.md +1 -1
  4. package/.docs/models/providers/digitalocean.md +2 -1
  5. package/.docs/models/providers/kilo.md +8 -8
  6. package/.docs/models/providers/nano-gpt.md +9 -7
  7. package/.docs/models/providers/opencode-go.md +1 -3
  8. package/.docs/models/providers/opencode.md +2 -1
  9. package/.docs/reference/client-js/observability.md +29 -0
  10. package/.docs/reference/observability/tracing/interfaces.md +3 -2
  11. package/package.json +5 -5
package/.docs/models/gateways/netlify.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # Netlify
6
6
 
7
- Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 277 models through Mastra's model router.
7
+ Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 278 models through Mastra's model router.
8
8
 
9
9
  Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
10
10
 
@@ -183,6 +183,7 @@ ANTHROPIC_API_KEY=ant-...
183
183
  | `openrouter/meta-llama/llama-4-scout` |
184
184
  | `openrouter/meta-llama/llama-guard-4-12b` |
185
185
  | `openrouter/meta/muse-glimmer-30b` |
186
+ | `openrouter/meta/muse-spark-open` |
186
187
  | `openrouter/microsoft/phi-4` |
187
188
  | `openrouter/microsoft/wizardlm-2-8x22b` |
188
189
  | `openrouter/minimax/minimax-m1` |
@@ -225,6 +226,7 @@ ANTHROPIC_API_KEY=ant-...
225
226
  | `openrouter/nvidia/nemotron-3-ultra-550b-a55b` |
226
227
  | `openrouter/nvidia/nemotron-3.5-content-safety` |
227
228
  | `openrouter/nvidia/nemotron-3.5-lightning` |
229
+ | `openrouter/nvidia/nemotron-3.5-super-vl` |
228
230
  | `openrouter/nvidia/switchyard` |
229
231
  | `openrouter/openai/gpt-oss-120b` |
230
232
  | `openrouter/openai/gpt-oss-20b` |
@@ -286,7 +288,6 @@ ANTHROPIC_API_KEY=ant-...
286
288
  | `openrouter/thinkingmachines/inkling` |
287
289
  | `openrouter/thinkingmachines/inkling-small` |
288
290
  | `openrouter/typesafe/jev-router` |
289
- | `openrouter/unbiased/pareto-26.10-preview` |
290
291
  | `openrouter/undi95/remm-slerp-l2-13b` |
291
292
  | `openrouter/upstage/solar-mini4` |
292
293
  | `openrouter/upstage/solar-pro4` |
package/.docs/models/gateways/openrouter.md CHANGED
@@ -80,7 +80,6 @@ ANTHROPIC_API_KEY=ant-...
80
80
  | `anthropic/claude-opus-4.8` |
81
81
  | `anthropic/claude-opus-5` |
82
82
  | `anthropic/claude-opus-5.5` |
83
- | `anthropic/claude-sonnet-4` |
84
83
  | `anthropic/claude-sonnet-4.5` |
85
84
  | `anthropic/claude-sonnet-4.6` |
86
85
  | `anthropic/claude-sonnet-5` |
@@ -231,6 +230,8 @@ ANTHROPIC_API_KEY=ant-...
231
230
  | `nvidia/nemotron-3.5-content-safety:free` |
232
231
  | `nvidia/nemotron-3.5-lightning` |
233
232
  | `nvidia/nemotron-3.5-lightning:free` |
233
+ | `nvidia/nemotron-3.5-super-vl` |
234
+ | `nvidia/nemotron-3.5-super-vl:free` |
234
235
  | `openai/gpt-3.5-turbo` |
235
236
  | `openai/gpt-3.5-turbo-0613` |
236
237
  | `openai/gpt-3.5-turbo-16k` |
@@ -385,7 +386,6 @@ ANTHROPIC_API_KEY=ant-...
385
386
  | `thinkingmachines/inkling-small` |
386
387
  | `thinkingmachines/inkling-small:free` |
387
388
  | `thinkingmachines/inkling:free` |
388
- | `unbiased/pareto-26.10-preview` |
389
389
  | `unbiased/pareto-26.9` |
390
390
  | `undi95/remm-slerp-l2-13b` |
391
391
  | `upstage/solar-mini4` |
package/.docs/models/index.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # Model Providers
6
6
 
7
- Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 8208 models from 218 providers through a single API.
7
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 8205 models from 218 providers through a single API.
8
8
 
9
9
  ## Features
10
10
 
package/.docs/models/providers/digitalocean.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![DigitalOcean logo](https://models.dev/logos/digitalocean.svg)DigitalOcean
6
6
 
7
- Access 102 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
7
+ Access 103 DigitalOcean models through Mastra's model router. Authentication is handled automatically using the `DIGITALOCEAN_ACCESS_TOKEN` environment variable.
8
8
 
9
9
  Learn more in the [DigitalOcean documentation](https://docs.digitalocean.com/products/gradient-ai-platform/details/models/).
10
10
 
@@ -95,6 +95,7 @@ for await (const chunk of stream) {
95
95
  | `digitalocean/nemotron-3-nano-30b` | 262K | | | | | | — | — |
96
96
  | `digitalocean/nemotron-3-nano-omni` | 66K | | | | | | $0.50 | $0.90 |
97
97
  | `digitalocean/nemotron-3-ultra-550b` | 131K | | | | | | $0.90 | $2 |
98
+ | `digitalocean/nemotron-3.5-super-vl` | 1.0M | | | | | | $0.30 | $0.65 |
98
99
  | `digitalocean/nemotron-nano-12b-v2-vl` | 128K | | | | | | $0.20 | $0.60 |
99
100
  | `digitalocean/nvidia-nemotron-3-super-120b` | 1.0M | | | | | | $0.30 | $0.65 |
100
101
  | `digitalocean/openai-gpt-4.1` | 1.0M | | | | | | $2 | $8 |
package/.docs/models/providers/kilo.md CHANGED
@@ -43,11 +43,11 @@ for await (const chunk of stream) {
43
43
  | `kilo/~anthropic/claude-opus-latest` | 1.0M | | | | | | $4 | $20 |
44
44
  | `kilo/~anthropic/claude-sonnet-latest` | 1.0M | | | | | | $2 | $10 |
45
45
  | `kilo/~deepseek/deepseek-flash-latest` | 1.0M | | | | | | $0.02 | $0.72 |
46
- | `kilo/~deepseek/deepseek-pro-latest` | 1.0M | | | | | | $0.23 | $8 |
46
+ | `kilo/~deepseek/deepseek-pro-latest` | 1.0M | | | | | | $0.13 | $8 |
47
47
  | `kilo/~deepseek/deepseek-v4-flash-latest` | 1.0M | | | | | | $0.01 | $0.58 |
48
48
  | `kilo/~google/gemini-flash-latest` | 1.0M | | | | | | $0.75 | $4 |
49
49
  | `kilo/~google/gemini-pro-latest` | 1.0M | | | | | | $2 | $10 |
50
- | `kilo/~moonshotai/kimi-latest` | 1.0M | | | | | | $0.30 | $14 |
50
+ | `kilo/~moonshotai/kimi-latest` | 1.0M | | | | | | $0.41 | $15 |
51
51
  | `kilo/~openai/gpt-astra-latest` | 1.1M | | | | | | $10 | $50 |
52
52
  | `kilo/~openai/gpt-luna-latest` | 1.1M | | | | | | $0.10 | $0.50 |
53
53
  | `kilo/~openai/gpt-mini-latest` | 400K | | | | | | $0.75 | $5 |
@@ -56,7 +56,7 @@ for await (const chunk of stream) {
56
56
  | `kilo/~unbiased/pareto-latest` | 262K | | | | | | $3 | $8 |
57
57
  | `kilo/~x-ai/grok-latest` | 500K | | | | | | $2 | $6 |
58
58
  | `kilo/~z-ai/glm-flash-latest` | 1.0M | | | | | | $0.04 | $0.90 |
59
- | `kilo/~z-ai/glm-latest` | 1.0M | | | | | | $0.02 | $4 |
59
+ | `kilo/~z-ai/glm-latest` | 1.0M | | | | | | $0.06 | $4 |
60
60
  | `kilo/aion-labs/aion-2.0` | 131K | | | | | | $0.80 | $2 |
61
61
  | `kilo/aion-labs/aion-3.0` | 131K | | | | | | $3 | $6 |
62
62
  | `kilo/aion-labs/aion-3.0-mini` | 131K | | | | | | $0.70 | $1 |
@@ -80,7 +80,6 @@ for await (const chunk of stream) {
80
80
  | `kilo/anthropic/claude-opus-4.8` | 1.0M | | | | | | $5 | $25 |
81
81
  | `kilo/anthropic/claude-opus-5` | 1.0M | | | | | | $5 | $25 |
82
82
  | `kilo/anthropic/claude-opus-5.5` | 1.0M | | | | | | $4 | $20 |
83
- | `kilo/anthropic/claude-sonnet-4` | 200K | | | | | | $3 | $15 |
84
83
  | `kilo/anthropic/claude-sonnet-4.5` | 1.0M | | | | | | $3 | $15 |
85
84
  | `kilo/anthropic/claude-sonnet-4.6` | 1.0M | | | | | | $3 | $15 |
86
85
  | `kilo/anthropic/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
@@ -207,7 +206,7 @@ for await (const chunk of stream) {
207
206
  | `kilo/mistralai/mistral-small-24b-instruct-2501` | 33K | | | | | | $0.05 | $0.08 |
208
207
  | `kilo/mistralai/mistral-small-2603` | 262K | | | | | | $0.15 | $0.60 |
209
208
  | `kilo/mistralai/mistral-small-3.1-24b-instruct` | 128K | | | | | | $0.35 | $0.56 |
210
- | `kilo/mistralai/mistral-small-3.2-24b-instruct` | 128K | | | | | | $0.10 | $0.30 |
209
+ | `kilo/mistralai/mistral-small-3.2-24b-instruct` | 256K | | | | | | $0.10 | $0.30 |
211
210
  | `kilo/mistralai/mixtral-8x22b-instruct` | 66K | | | | | | $2 | $6 |
212
211
  | `kilo/mistralai/voxtral-small-24b-2507` | 33K | | | | | | $0.10 | $0.30 |
213
212
  | `kilo/moonshotai/kimi-k2` | 131K | | | | | | $0.57 | $2 |
@@ -234,6 +233,8 @@ for await (const chunk of stream) {
234
233
  | `kilo/nvidia/nemotron-3.5-content-safety:free` | 128K | | | | | | — | — |
235
234
  | `kilo/nvidia/nemotron-3.5-lightning` | 262K | | | | | | $0.03 | $0.12 |
236
235
  | `kilo/nvidia/nemotron-3.5-lightning:free` | 1.0M | | | | | | — | — |
236
+ | `kilo/nvidia/nemotron-3.5-super-vl` | 262K | | | | | | $0.15 | $0.50 |
237
+ | `kilo/nvidia/nemotron-3.5-super-vl:free` | 1.0M | | | | | | — | — |
237
238
  | `kilo/openai/gpt-3.5-turbo` | 16K | | | | | | $0.50 | $2 |
238
239
  | `kilo/openai/gpt-3.5-turbo-0613` | 4K | | | | | | $1 | $2 |
239
240
  | `kilo/openai/gpt-3.5-turbo-16k` | 16K | | | | | | $3 | $4 |
@@ -384,16 +385,15 @@ for await (const chunk of stream) {
384
385
  | `kilo/tencent/hy-mt2-1.8b` | 8K | | | | | | $0.04 | $0.18 |
385
386
  | `kilo/tencent/hy-mt2-30b-a3b` | 8K | | | | | | $0.07 | $0.29 |
386
387
  | `kilo/tencent/hy-mt2-7b` | 8K | | | | | | $0.07 | $0.29 |
387
- | `kilo/tencent/hy3` | 262K | | | | | | $0.13 | $0.53 |
388
+ | `kilo/tencent/hy3` | 262K | | | | | | $0.08 | $0.33 |
388
389
  | `kilo/tencent/hy3-preview` | 262K | | | | | | $0.18 | $0.60 |
389
- | `kilo/tencent/hy4-preview` | 1.0M | | | | | | $0.83 | $3 |
390
+ | `kilo/tencent/hy4-preview` | 1.0M | | | | | | $0.75 | $2 |
390
391
  | `kilo/thedrummer/cydonia-24b-v4.1` | 131K | | | | | | $0.30 | $0.50 |
391
392
  | `kilo/thedrummer/skyfall-36b-v2` | 33K | | | | | | $0.55 | $0.80 |
392
393
  | `kilo/thedrummer/unslopnemo-12b` | 1.0M | | | | | | $0.40 | $0.40 |
393
394
  | `kilo/thinkingmachines/inkling` | 524K | | | | | | $0.95 | $4 |
394
395
  | `kilo/thinkingmachines/inkling-small` | 524K | | | | | | $0.45 | $1 |
395
396
  | `kilo/thinkingmachines/inkling-small:free` | 1.0M | | | | | | — | — |
396
- | `kilo/unbiased/pareto-26.10-preview` | 1.0M | | | | | | $0.80 | $3 |
397
397
  | `kilo/unbiased/pareto-26.9` | 262K | | | | | | $3 | $8 |
398
398
  | `kilo/undi95/remm-slerp-l2-13b` | 6K | | | | | | $0.35 | $0.65 |
399
399
  | `kilo/upstage/solar-mini4` | 524K | | | | | | $0.10 | $0.40 |
package/.docs/models/providers/nano-gpt.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![NanoGPT logo](https://models.dev/logos/nano-gpt.svg)NanoGPT
6
6
 
7
- Access 612 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
7
+ Access 614 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
10
10
 
@@ -49,6 +49,7 @@ for await (const chunk of stream) {
49
49
  | `nano-gpt/aion-labs/aion-3.5` | 262K | | | | | | $3 | $6 |
50
50
  | `nano-gpt/aion-labs/aion-3.5-mini` | 262K | | | | | | $0.70 | $1 |
51
51
  | `nano-gpt/aion-labs/aion-rp-llama-3.1-8b` | 33K | | | | | | $0.80 | $2 |
52
+ | `nano-gpt/aisingapore/Gemma-SEA-LION-v4-27B-IT` | 131K | | | | | | $0.24 | $0.48 |
52
53
  | `nano-gpt/amazon/nova-2-lite-v1` | 1.0M | | | | | | $0.51 | $4 |
53
54
  | `nano-gpt/amazon/nova-lite-v1` | 300K | | | | | | $0.06 | $0.24 |
54
55
  | `nano-gpt/amazon/nova-pro-v1` | 300K | | | | | | $0.80 | $3 |
@@ -129,7 +130,7 @@ for await (const chunk of stream) {
129
130
  | `nano-gpt/deepseek-reasoner` | 64K | | | | | | $0.40 | $2 |
130
131
  | `nano-gpt/deepseek-reasoner-cheaper` | 128K | | | | | | $0.40 | $2 |
131
132
  | `nano-gpt/deepseek-v3-0324` | 128K | | | | | | $0.20 | $0.77 |
132
- | `nano-gpt/deepseek/deepseek-latest` | 1.0M | | | | | | $0.90 | $0.99 |
133
+ | `nano-gpt/deepseek/deepseek-latest` | 1.0M | | | | | | $1 | $3 |
133
134
  | `nano-gpt/deepseek/deepseek-v3.2` | 163K | | | | | | $0.21 | $0.31 |
134
135
  | `nano-gpt/deepseek/deepseek-v3.2:thinking` | 163K | | | | | | $0.21 | $0.31 |
135
136
  | `nano-gpt/deepseek/deepseek-v4-flash` | 1.0M | | | | | | $0.14 | $0.28 |
@@ -139,11 +140,10 @@ for await (const chunk of stream) {
139
140
  | `nano-gpt/deepseek/deepseek-v4-flash-0731:thinking` | 1.0M | | | | | | $0.05 | $0.16 |
140
141
  | `nano-gpt/deepseek/deepseek-v4-flash-latest` | 1.0M | | | | | | $0.05 | $0.16 |
141
142
  | `nano-gpt/deepseek/deepseek-v4-flash-vision-exp` | 1.0M | | | | | | $0.22 | $0.66 |
142
- | `nano-gpt/deepseek/deepseek-v4-flash-vision-exp-cybersecurity` | 1.0M | | | | | | $0.15 | $0.60 |
143
143
  | `nano-gpt/deepseek/deepseek-v4-flash:thinking` | 1.0M | | | | | | $0.14 | $0.28 |
144
144
  | `nano-gpt/deepseek/deepseek-v4-pro` | 1.0M | | | | | | $1 | $2 |
145
- | `nano-gpt/deepseek/deepseek-v4-pro-0813` | 1.0M | | | | | | $0.90 | $0.99 |
146
- | `nano-gpt/deepseek/deepseek-v4-pro-0813:thinking` | 1.0M | | | | | | $0.90 | $0.99 |
145
+ | `nano-gpt/deepseek/deepseek-v4-pro-0813` | 1.0M | | | | | | $1 | $3 |
146
+ | `nano-gpt/deepseek/deepseek-v4-pro-0813:thinking` | 1.0M | | | | | | $1 | $3 |
147
147
  | `nano-gpt/deepseek/deepseek-v4-pro:thinking` | 1.0M | | | | | | $1 | $2 |
148
148
  | `nano-gpt/deepseek/deepseek-v4.1-flash` | 1.0M | | | | | | $0.13 | $0.52 |
149
149
  | `nano-gpt/deepseek/deepseek-v4.1-flash:thinking` | 1.0M | | | | | | $0.13 | $0.52 |
@@ -338,8 +338,8 @@ for await (const chunk of stream) {
338
338
  | `nano-gpt/moonshotai/kimi-k2-thinking` | 262K | | | | | | $0.60 | $3 |
339
339
  | `nano-gpt/moonshotai/kimi-k2.5` | 262K | | | | | | $0.38 | $2 |
340
340
  | `nano-gpt/moonshotai/kimi-k2.5:thinking` | 262K | | | | | | $0.38 | $2 |
341
- | `nano-gpt/moonshotai/kimi-k2.6` | 262K | | | | | | $0.44 | $2 |
342
- | `nano-gpt/moonshotai/kimi-k2.6:thinking` | 262K | | | | | | $0.44 | $2 |
341
+ | `nano-gpt/moonshotai/kimi-k2.6` | 262K | | | | | | $0.50 | $3 |
342
+ | `nano-gpt/moonshotai/kimi-k2.6:thinking` | 262K | | | | | | $0.50 | $3 |
343
343
  | `nano-gpt/moonshotai/kimi-k2.7-code` | 262K | | | | | | $0.67 | $3 |
344
344
  | `nano-gpt/moonshotai/kimi-k2.7-code-highspeed` | 262K | | | | | | $2 | $8 |
345
345
  | `nano-gpt/moonshotai/kimi-k3` | 1.0M | | | | | | $2 | $10 |
@@ -513,6 +513,8 @@ for await (const chunk of stream) {
513
513
  | `nano-gpt/Qwen3.5-27B-BlueStar-v3-Derestricted` | 262K | | | | | | $0.31 | $0.31 |
514
514
  | `nano-gpt/Qwen3.5-27B-Queen-Derestricted` | 262K | | | | | | $0.31 | $0.31 |
515
515
  | `nano-gpt/ReadyArt/MS3.2-The-Omega-Directive-24B-Unslop-v2.0` | 33K | | | | | | $0.50 | $0.50 |
516
+ | `nano-gpt/reka/reka-edge-2603` | 16K | | | | | | $0.10 | $0.10 |
517
+ | `nano-gpt/reka/reka-flash-3` | 66K | | | | | | $0.10 | $0.21 |
516
518
  | `nano-gpt/sakana/fugu-max` | 1.0M | | | | | | $2 | $6 |
517
519
  | `nano-gpt/sakana/fugu-ultra` | 1.0M | | | | | | $5 | $30 |
518
520
  | `nano-gpt/sakana/fugu-ultra-v1.1` | 1.0M | | | | | | $5 | $30 |
package/.docs/models/providers/opencode-go.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![OpenCode Go logo](https://models.dev/logos/opencode-go.svg)OpenCode Go
6
6
 
7
- Access 38 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
7
+ Access 30 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [OpenCode Go documentation](https://opencode.ai/v2/docs/console/go/).
10
10
 
@@ -48,7 +48,6 @@ for await (const chunk of stream) {
48
48
  | `opencode-go/glm-5.3-flash` | 1.0M | | | | | | $0.15 | $0.50 |
49
49
  | `opencode-go/gpt-5.6-luna` | 1.1M | | | | | | $0.20 | $1 |
50
50
  | `opencode-go/gpt-6-luna` | 1.1M | | | | | | $0.10 | $0.50 |
51
- | `opencode-go/grok-4.6` | 500K | | | | | | $2 | $6 |
52
51
  | `opencode-go/grok-4.7` | 500K | | | | | | $2 | $6 |
53
52
  | `opencode-go/hy3` | 256K | | | | | | $0.14 | $0.58 |
54
53
  | `opencode-go/hy4-preview` | 1.0M | | | | | | $0.83 | $3 |
@@ -60,7 +59,6 @@ for await (const chunk of stream) {
60
59
  | `opencode-go/mimo-v2.5-pro` | 1.0M | | | | | | $0.43 | $0.87 |
61
60
  | `opencode-go/mimo-v2.6-flash` | 1.0M | | | | | | $0.14 | $0.28 |
62
61
  | `opencode-go/mimo-v2.6-pro` | 1.0M | | | | | | $0.43 | $0.87 |
63
- | `opencode-go/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
64
62
  | `opencode-go/minimax-m3` | 1.0M | | | | | | $0.30 | $1 |
65
63
  | `opencode-go/muse-spark-1.2-contributor` | 1.0M | | | | | | $0.10 | $0.20 |
66
64
  | `opencode-go/muse-spark-1.3-contributor` | 1.0M | | | | | | $0.10 | $0.20 |
package/.docs/models/providers/opencode.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
  # ![OpenCode logo](https://models.dev/logos/opencode.svg)OpenCode
6
6
 
7
- Access 123 OpenCode models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
7
+ Access 124 OpenCode models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
8
8
 
9
9
  Learn more in the [OpenCode documentation](https://opencode.ai/v2/docs/console/models/).
10
10
 
@@ -116,6 +116,7 @@ for await (const chunk of stream) {
116
116
  | `opencode/muse-spark-1.3-contributor-free` | 1.0M | | | | | | — | — |
117
117
  | `opencode/nemotron-3-ultra-free` | 1.0M | | | | | | — | — |
118
118
  | `opencode/nemotron-3.5-lightning-free` | 262K | | | | | | — | — |
119
+ | `opencode/nemotron-3.5-super-vl-free` | 1.0M | | | | | | — | — |
119
120
  | `opencode/qwen3.5-plus` | 262K | | | | | | $0.20 | $1 |
120
121
  | `opencode/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
121
122
  | `opencode/qwen3.8-flash` | 1.0M | | | | | | $0.15 | $0.47 |
package/.docs/reference/client-js/observability.md CHANGED
@@ -118,6 +118,33 @@ Merge `changes.traces` by `traceId`, retain `changes.deltaCursor`, and continue
118
118
 
119
119
  See [Delta polling](https://mastra.ai/reference/observability/tracing/trace-query) for bootstrap behavior, cursor lifetime, retention, and a complete polling loop.
120
120
 
121
+ ### Aggregate traces
122
+
123
+ `aggregateTraces()` groups the traces selected by a time range and optional `where` predicate, and returns one row per group. It accepts the same predicates as `queryTraces()`.
124
+
125
+ ```typescript
126
+ const { capabilities } = await mastraClient.getObservabilityCapabilities()
127
+
128
+ if (capabilities.traceAggregate) {
129
+ const { rows, truncated } = await mastraClient.aggregateTraces({
130
+ timeRange: {
131
+ from: '2026-08-01T00:00:00.000Z',
132
+ to: '2026-08-08T00:00:00.000Z',
133
+ },
134
+ where: { op: 'eq', left: { path: 'environment' }, right: { literal: 'production' } },
135
+ groupBy: ['entityName'],
136
+ interval: '1d',
137
+ measures: ['count', 'errorRate', 'duration.p95', 'cost.sum'],
138
+ orderBy: { field: 'count', direction: 'desc' },
139
+ limit: 10,
140
+ })
141
+ }
142
+ ```
143
+
144
+ Each row has `dimensions` keyed by `groupBy` field, `measures` keyed by measure name, a `bucket` timestamp when `interval` is set, and `cost` coverage when a cost measure is requested. `truncated` is `true` when more groups matched than `limit`.
145
+
146
+ Check `capabilities.traceAggregate` before calling. Unlike `traceQuery`, a missing value means the server doesn't support aggregation. The client retries server errors like `queryTraces()` but doesn't retry `422` validation errors.
147
+
121
148
  ### Discover trace-query fields and values
122
149
 
123
150
  `getTraceQueryFields()` returns canonical query fields and observed top-level string metadata fields for one predicate scope. The response includes each field's value kind, supported operators, and whether value suggestions are available.
@@ -136,6 +163,8 @@ const fields = await mastraClient.getTraceQueryFields({
136
163
  })
137
164
  ```
138
165
 
166
+ For the `trace` scope on a server that supports aggregation, the response also includes `aggregate`: the `dimensions` you can pass to `groupBy` and the `measures` you can request. Every observed metadata field is also a dimension, and `countDistinct.<field>` accepts any dimension or `traceId`.
167
+
139
168
  Use the exact local path from the response with the same scope. For example, `model` belongs inside a `spans.some` or `spans.none` predicate. A field picker can fetch the `trace` and `spans` scopes in parallel.
140
169
 
141
170
  Call `getTraceQueryValues()` only after selecting a field with `valueSuggestions: true`:
package/.docs/reference/observability/tracing/interfaces.md CHANGED
@@ -805,8 +805,9 @@ interface ProcessorRunAttributes {
805
805
  /**
806
806
  * Milliseconds spent inside `processOutputStream`, summed across every
807
807
  * chunk. Only set on output stream processor spans. The span's own duration
808
- * covers the whole stream, model latency included, so this is what
809
- * separates a slow processor from a slow model.
808
+ * covers its step, from the first chunk to the step's end with model latency
809
+ * and tool calls included, so this is what separates a slow processor from
810
+ * the rest of the step.
810
811
  */
811
812
  hookDurationMs?: number
812
813
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.3.8-alpha.11",
3
+ "version": "1.3.8-alpha.12",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -26,8 +26,8 @@
26
26
  "@mastra/mcp-legacy": "npm:@mastra/mcp@^1.18.0",
27
27
  "local-pkg": "^1.1.2",
28
28
  "zod": "^4.6.4",
29
- "@mastra/core": "1.78.0-alpha.8",
30
- "@mastra/mcp": "^2.4.1-alpha.1"
29
+ "@mastra/mcp": "^2.4.1-alpha.1",
30
+ "@mastra/core": "1.78.0-alpha.9"
31
31
  },
32
32
  "devDependencies": {
33
33
  "@hono/node-server": "^2.0.0",
@@ -44,8 +44,8 @@
44
44
  "typescript": "^7.0.2",
45
45
  "vitest": "4.1.11",
46
46
  "@internal/lint": "0.0.143",
47
- "@mastra/core": "1.78.0-alpha.8",
48
- "@internal/types-builder": "0.0.118"
47
+ "@internal/types-builder": "0.0.118",
48
+ "@mastra/core": "1.78.0-alpha.9"
49
49
  },
50
50
  "homepage": "https://mastra.ai",
51
51
  "repository": {