@mastra/mcp-docs-server 1.1.26-alpha.13 → 1.1.26-alpha.16

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/index.md +1 -1
  2. package/.docs/models/providers/302ai.md +32 -1
  3. package/.docs/models/providers/berget.md +9 -12
  4. package/.docs/models/providers/cortecs.md +2 -1
  5. package/.docs/models/providers/llmgateway.md +59 -77
  6. package/.docs/models/providers/nvidia.md +2 -1
  7. package/.docs/models/providers/wafer.ai.md +72 -0
  8. package/.docs/models/providers.md +1 -0
  9. package/.docs/reference/harness/harness-class.md +72 -49
  10. package/CHANGELOG.md +14 -0
  11. package/package.json +4 -4
package/.docs/models/index.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Model Providers
2
2
 
3
- Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3653 models from 103 providers through a single API.
3
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3667 models from 104 providers through a single API.
4
4
 
5
5
  ## Features
6
6
 
package/.docs/models/providers/302ai.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![302.AI logo](https://models.dev/logos/302ai.svg)302.AI
2
2
 
3
- Access 64 302.AI models through Mastra's model router. Authentication is handled automatically using the `302AI_API_KEY` environment variable.
3
+ Access 95 302.AI models through Mastra's model router. Authentication is handled automatically using the `302AI_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [302.AI documentation](https://doc.302.ai).
6
6
 
@@ -35,13 +35,25 @@ for await (const chunk of stream) {
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
37
  | `302ai/chatgpt-4o-latest` | 128K | | | | | | $5 | $15 |
38
+ | `302ai/claude-3-5-haiku-20241022` | 200K | | | | | | $0.80 | $4 |
39
+ | `302ai/claude-3-5-haiku-latest` | 200K | | | | | | $0.80 | $4 |
40
+ | `302ai/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
38
41
  | `302ai/claude-haiku-4-5-20251001` | 200K | | | | | | $1 | $5 |
39
42
  | `302ai/claude-opus-4-1-20250805` | 200K | | | | | | $15 | $75 |
40
43
  | `302ai/claude-opus-4-1-20250805-thinking` | 200K | | | | | | $15 | $75 |
44
+ | `302ai/claude-opus-4-20250514` | 200K | | | | | | $15 | $75 |
45
+ | `302ai/claude-opus-4-5` | 200K | | | | | | $5 | $25 |
41
46
  | `302ai/claude-opus-4-5-20251101` | 200K | | | | | | $5 | $25 |
42
47
  | `302ai/claude-opus-4-5-20251101-thinking` | 200K | | | | | | $5 | $25 |
48
+ | `302ai/claude-opus-4-6` | 1.0M | | | | | | $5 | $25 |
49
+ | `302ai/claude-opus-4-6-thinking` | 1.0M | | | | | | $5 | $25 |
50
+ | `302ai/claude-opus-4-7` | 200K | | | | | | $5 | $25 |
51
+ | `302ai/claude-sonnet-4-20250514` | 200K | | | | | | $3 | $15 |
52
+ | `302ai/claude-sonnet-4-5` | 200K | | | | | | $3 | $15 |
43
53
  | `302ai/claude-sonnet-4-5-20250929` | 200K | | | | | | $3 | $15 |
44
54
  | `302ai/claude-sonnet-4-5-20250929-thinking` | 200K | | | | | | $3 | $15 |
55
+ | `302ai/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
56
+ | `302ai/claude-sonnet-4-6-thinking` | 1.0M | | | | | | $3 | $15 |
45
57
  | `302ai/deepseek-chat` | 128K | | | | | | $0.29 | $0.43 |
46
58
  | `302ai/deepseek-reasoner` | 128K | | | | | | $0.29 | $0.43 |
47
59
  | `302ai/deepseek-v3.2` | 128K | | | | | | $0.29 | $0.43 |
@@ -60,11 +72,21 @@ for await (const chunk of stream) {
60
72
  | `302ai/gemini-3-flash-preview` | 1.0M | | | | | | $0.50 | $3 |
61
73
  | `302ai/gemini-3-pro-image-preview` | 33K | | | | | | $2 | $120 |
62
74
  | `302ai/gemini-3-pro-preview` | 1.0M | | | | | | $2 | $12 |
75
+ | `302ai/gemini-3.1-flash-image-preview` | 131K | | | | | | $0.50 | $60 |
63
76
  | `302ai/glm-4.5` | 128K | | | | | | $0.29 | $1 |
77
+ | `302ai/glm-4.5-air` | 128K | | | | | | $0.11 | $0.29 |
78
+ | `302ai/glm-4.5-airx` | 128K | | | | | | $0.57 | $2 |
79
+ | `302ai/glm-4.5-x` | 128K | | | | | | $1 | $2 |
64
80
  | `302ai/glm-4.5v` | 64K | | | | | | $0.29 | $0.86 |
65
81
  | `302ai/glm-4.6` | 200K | | | | | | $0.29 | $1 |
66
82
  | `302ai/glm-4.6v` | 128K | | | | | | $0.14 | $0.43 |
67
83
  | `302ai/glm-4.7` | 200K | | | | | | $0.29 | $1 |
84
+ | `302ai/glm-4.7-flashx` | 200K | | | | | | $0.07 | $0.43 |
85
+ | `302ai/glm-5` | 200K | | | | | | $0.60 | $3 |
86
+ | `302ai/glm-5-turbo` | 200K | | | | | | $0.72 | $3 |
87
+ | `302ai/glm-5.1` | 200K | | | | | | $0.86 | $4 |
88
+ | `302ai/glm-5v-turbo` | 200K | | | | | | $0.72 | $3 |
89
+ | `302ai/glm-for-coding` | 200K | | | | | | $0.09 | $0.34 |
68
90
  | `302ai/gpt-4.1` | 1.0M | | | | | | $2 | $8 |
69
91
  | `302ai/gpt-4.1-mini` | 1.0M | | | | | | $0.40 | $2 |
70
92
  | `302ai/gpt-4.1-nano` | 1.0M | | | | | | $0.10 | $0.40 |
@@ -77,17 +99,26 @@ for await (const chunk of stream) {
77
99
  | `302ai/gpt-5.1-chat-latest` | 128K | | | | | | $1 | $10 |
78
100
  | `302ai/gpt-5.2` | 400K | | | | | | $2 | $14 |
79
101
  | `302ai/gpt-5.2-chat-latest` | 128K | | | | | | $2 | $14 |
102
+ | `302ai/gpt-5.4-mini` | 400K | | | | | | $0.75 | $5 |
103
+ | `302ai/gpt-5.4-mini-2026-03-17` | 400K | | | | | | $0.75 | $5 |
104
+ | `302ai/gpt-5.4-nano` | 400K | | | | | | $0.20 | $1 |
105
+ | `302ai/gpt-5.4-nano-2026-03-17` | 400K | | | | | | $0.20 | $1 |
80
106
  | `302ai/grok-4-1-fast-non-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
81
107
  | `302ai/grok-4-1-fast-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
82
108
  | `302ai/grok-4-fast-non-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
83
109
  | `302ai/grok-4-fast-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
84
110
  | `302ai/grok-4.1` | 200K | | | | | | $2 | $10 |
111
+ | `302ai/grok-4.20-beta-0309-non-reasoning` | 2.0M | | | | | | $2 | $6 |
112
+ | `302ai/grok-4.20-beta-0309-reasoning` | 2.0M | | | | | | $2 | $6 |
113
+ | `302ai/grok-4.20-multi-agent-beta-0309` | 2.0M | | | | | | $2 | $6 |
85
114
  | `302ai/kimi-k2-0905-preview` | 262K | | | | | | $0.63 | $3 |
86
115
  | `302ai/kimi-k2-thinking` | 262K | | | | | | $0.57 | $2 |
87
116
  | `302ai/kimi-k2-thinking-turbo` | 262K | | | | | | $1 | $9 |
88
117
  | `302ai/MiniMax-M1` | 1.0M | | | | | | $0.13 | $1 |
89
118
  | `302ai/MiniMax-M2` | 1.0M | | | | | | $0.33 | $1 |
90
119
  | `302ai/MiniMax-M2.1` | 1.0M | | | | | | $0.30 | $1 |
120
+ | `302ai/MiniMax-M2.7` | 205K | | | | | | $0.30 | $1 |
121
+ | `302ai/MiniMax-M2.7-highspeed` | 205K | | | | | | $0.60 | $5 |
91
122
  | `302ai/ministral-14b-2512` | 128K | | | | | | $0.33 | $0.33 |
92
123
  | `302ai/mistral-large-2512` | 128K | | | | | | $1 | $3 |
93
124
  | `302ai/qwen-flash` | 1.0M | | | | | | $0.02 | $0.22 |
package/.docs/models/providers/berget.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Berget.AI logo](https://models.dev/logos/berget.svg)Berget.AI
2
2
 
3
- Access 8 Berget.AI models through Mastra's model router. Authentication is handled automatically using the `BERGET_API_KEY` environment variable.
3
+ Access 5 Berget.AI models through Mastra's model router. Authentication is handled automatically using the `BERGET_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Berget.AI documentation](https://api.berget.ai).
6
6
 
@@ -15,7 +15,7 @@ const agent = new Agent({
15
15
  id: "my-agent",
16
16
  name: "My Agent",
17
17
  instructions: "You are a helpful assistant",
18
- model: "berget/BAAI/bge-reranker-v2-m3"
18
+ model: "berget/google/gemma-4-31B-it"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -34,14 +34,11 @@ for await (const chunk of stream) {
34
34
 
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | ------------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `berget/BAAI/bge-reranker-v2-m3` | 512 | | | | | | $0.10 | $0.10 |
38
- | `berget/intfloat/multilingual-e5-large` | 512 | | | | | | $0.02 | — |
39
- | `berget/intfloat/multilingual-e5-large-instruct` | 512 | | | | | | $0.02 | — |
40
- | `berget/KBLab/kb-whisper-large` | 480K | | | | | | $3 | $3 |
41
- | `berget/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.90 | $0.90 |
42
- | `berget/mistralai/Mistral-Small-3.2-24B-Instruct-2506` | 32K | | | | | | $0.30 | $0.30 |
43
- | `berget/openai/gpt-oss-120b` | 128K | | | | | | $0.30 | $0.90 |
44
- | `berget/zai-org/GLM-4.7` | 128K | | | | | | $0.70 | $2 |
37
+ | `berget/google/gemma-4-31B-it` | 128K | | | | | | $0.28 | $0.55 |
38
+ | `berget/meta-llama/Llama-3.3-70B-Instruct` | 128K | | | | | | $0.99 | $0.99 |
39
+ | `berget/mistralai/Mistral-Small-3.2-24B-Instruct-2506` | 32K | | | | | | $0.33 | $0.33 |
40
+ | `berget/openai/gpt-oss-120b` | 128K | | | | | | $0.44 | $0.99 |
41
+ | `berget/zai-org/GLM-4.7` | 128K | | | | | | $0.77 | $3 |
45
42
 
46
43
  ## Advanced configuration
47
44
 
@@ -53,7 +50,7 @@ const agent = new Agent({
53
50
  name: "custom-agent",
54
51
  model: {
55
52
  url: "https://api.berget.ai/v1",
56
- id: "berget/BAAI/bge-reranker-v2-m3",
53
+ id: "berget/google/gemma-4-31B-it",
57
54
  apiKey: process.env.BERGET_API_KEY,
58
55
  headers: {
59
56
  "X-Custom-Header": "value"
@@ -72,7 +69,7 @@ const agent = new Agent({
72
69
  const useAdvanced = requestContext.task === "complex";
73
70
  return useAdvanced
74
71
  ? "berget/zai-org/GLM-4.7"
75
- : "berget/BAAI/bge-reranker-v2-m3";
72
+ : "berget/google/gemma-4-31B-it";
76
73
  }
77
74
  });
78
75
  ```
package/.docs/models/providers/cortecs.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Cortecs logo](https://models.dev/logos/cortecs.svg)Cortecs
2
2
 
3
- Access 32 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
3
+ Access 33 Cortecs models through Mastra's model router. Authentication is handled automatically using the `CORTECS_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Cortecs documentation](https://cortecs.ai).
6
6
 
@@ -39,6 +39,7 @@ for await (const chunk of stream) {
39
39
  | `cortecs/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
40
40
  | `cortecs/claude-opus4-5` | 200K | | | | | | $6 | $30 |
41
41
  | `cortecs/claude-opus4-6` | 1.0M | | | | | | $6 | $30 |
42
+ | `cortecs/claude-opus4-7` | 1.0M | | | | | | $6 | $28 |
42
43
  | `cortecs/claude-sonnet-4` | 200K | | | | | | $3 | $17 |
43
44
  | `cortecs/deepseek-v3-0324` | 128K | | | | | | $0.55 | $2 |
44
45
  | `cortecs/devstral-2512` | 262K | | | | | | — | — |
package/.docs/models/providers/llmgateway.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
2
2
 
3
- Access 199 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
3
+ Access 181 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
6
6
 
@@ -35,11 +35,9 @@ for await (const chunk of stream) {
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | -------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
37
  | `llmgateway/auto` | 128K | | | | | | — | — |
38
- | `llmgateway/claude-3-5-sonnet` | 200K | | | | | | $3 | $15 |
38
+ | `llmgateway/claude-3-5-sonnet-20241022` | 200K | | | | | | $3 | $15 |
39
39
  | `llmgateway/claude-3-7-sonnet` | 200K | | | | | | $3 | $15 |
40
40
  | `llmgateway/claude-3-7-sonnet-20250219` | 200K | | | | | | $3 | $15 |
41
- | `llmgateway/claude-3-haiku` | 200K | | | | | | $0.25 | $1 |
42
- | `llmgateway/claude-3-haiku-20240307` | 200K | | | | | | $0.25 | $1 |
43
41
  | `llmgateway/claude-3-opus` | 200K | | | | | | $15 | $75 |
44
42
  | `llmgateway/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
45
43
  | `llmgateway/claude-haiku-4-5-20251001` | 200K | | | | | | $1 | $5 |
@@ -47,53 +45,51 @@ for await (const chunk of stream) {
47
45
  | `llmgateway/claude-opus-4-20250514` | 200K | | | | | | $15 | $75 |
48
46
  | `llmgateway/claude-opus-4-5-20251101` | 200K | | | | | | $5 | $25 |
49
47
  | `llmgateway/claude-opus-4-6` | 1.0M | | | | | | $5 | $25 |
48
+ | `llmgateway/claude-opus-4-7` | 1.0M | | | | | | $5 | $25 |
50
49
  | `llmgateway/claude-sonnet-4-20250514` | 200K | | | | | | $3 | $15 |
51
50
  | `llmgateway/claude-sonnet-4-5` | 200K | | | | | | $3 | $15 |
52
51
  | `llmgateway/claude-sonnet-4-5-20250929` | 200K | | | | | | $3 | $15 |
53
- | `llmgateway/claude-sonnet-4-6` | 200K | | | | | | $3 | $15 |
52
+ | `llmgateway/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
54
53
  | `llmgateway/codestral-2508` | 256K | | | | | | $0.30 | $0.90 |
55
- | `llmgateway/cogview-4` | 2K | | | | | | — | — |
56
54
  | `llmgateway/custom` | 128K | | | | | | — | — |
57
55
  | `llmgateway/deepseek-r1-0528` | 64K | | | | | | $0.80 | $2 |
58
56
  | `llmgateway/deepseek-v3.1` | 128K | | | | | | $0.56 | $2 |
59
57
  | `llmgateway/deepseek-v3.2` | 164K | | | | | | $0.28 | $0.42 |
60
58
  | `llmgateway/devstral-2512` | 262K | | | | | | $0.40 | $2 |
61
- | `llmgateway/devstral-small-2507` | 131K | | | | | | $0.10 | $0.30 |
59
+ | `llmgateway/devstral-small-2507` | 128K | | | | | | $0.10 | $0.30 |
60
+ | `llmgateway/gemini-2.0-flash` | 1.0M | | | | | | $0.10 | $0.40 |
61
+ | `llmgateway/gemini-2.0-flash-lite` | 1.0M | | | | | | $0.07 | $0.30 |
62
62
  | `llmgateway/gemini-2.5-flash` | 1.0M | | | | | | $0.30 | $3 |
63
- | `llmgateway/gemini-2.5-flash-image` | 33K | | | | | | $0.30 | $30 |
64
- | `llmgateway/gemini-2.5-flash-image-preview` | 33K | | | | | | $0.30 | $3 |
65
63
  | `llmgateway/gemini-2.5-flash-lite` | 1.0M | | | | | | $0.10 | $0.40 |
66
64
  | `llmgateway/gemini-2.5-flash-lite-preview-09-2025` | 1.0M | | | | | | $0.10 | $0.40 |
67
65
  | `llmgateway/gemini-2.5-pro` | 1.0M | | | | | | $1 | $10 |
68
66
  | `llmgateway/gemini-3-flash-preview` | 1.0M | | | | | | $0.50 | $3 |
69
- | `llmgateway/gemini-3-pro-image-preview` | 66K | | | | | | $2 | $12 |
70
- | `llmgateway/gemini-3.1-flash-image-preview` | 66K | | | | | | $0.25 | $2 |
71
67
  | `llmgateway/gemini-3.1-flash-lite-preview` | 1.0M | | | | | | $0.25 | $2 |
72
68
  | `llmgateway/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
73
69
  | `llmgateway/gemini-pro-latest` | 1.0M | | | | | | $2 | $12 |
74
70
  | `llmgateway/gemma-2-27b-it-together` | 8K | | | | | | $0.08 | $0.08 |
75
- | `llmgateway/gemma-3-12b-it` | 1.0M | | | | | | $0.08 | $0.30 |
71
+ | `llmgateway/gemma-3-12b-it` | 33K | | | | | | — | — |
76
72
  | `llmgateway/gemma-3-1b-it` | 1.0M | | | | | | $0.08 | $0.30 |
77
73
  | `llmgateway/gemma-3-27b` | 128K | | | | | | $0.27 | $0.27 |
78
- | `llmgateway/gemma-3-4b-it` | 1.0M | | | | | | $0.08 | $0.30 |
79
- | `llmgateway/gemma-3n-e2b-it` | 1.0M | | | | | | $0.08 | $0.30 |
80
- | `llmgateway/gemma-3n-e4b-it` | 1.0M | | | | | | $0.08 | $0.30 |
74
+ | `llmgateway/gemma-3-4b-it` | 33K | | | | | | — | — |
75
+ | `llmgateway/gemma-3n-e2b-it` | 8K | | | | | | — | — |
76
+ | `llmgateway/gemma-3n-e4b-it` | 8K | | | | | | — | — |
81
77
  | `llmgateway/glm-4-32b-0414-128k` | 128K | | | | | | $0.10 | $0.10 |
82
- | `llmgateway/glm-4.5` | 128K | | | | | | $0.60 | $2 |
83
- | `llmgateway/glm-4.5-air` | 128K | | | | | | $0.20 | $1 |
78
+ | `llmgateway/glm-4.5` | 131K | | | | | | $0.60 | $2 |
79
+ | `llmgateway/glm-4.5-air` | 131K | | | | | | $0.20 | $1 |
84
80
  | `llmgateway/glm-4.5-airx` | 128K | | | | | | $1 | $5 |
85
- | `llmgateway/glm-4.5-flash` | 128K | | | | | | — | — |
81
+ | `llmgateway/glm-4.5-flash` | 131K | | | | | | — | — |
86
82
  | `llmgateway/glm-4.5-x` | 128K | | | | | | $2 | $9 |
87
- | `llmgateway/glm-4.5v` | 128K | | | | | | $0.60 | $2 |
88
- | `llmgateway/glm-4.6` | 200K | | | | | | $0.60 | $2 |
83
+ | `llmgateway/glm-4.5v` | 64K | | | | | | $0.60 | $2 |
84
+ | `llmgateway/glm-4.6` | 205K | | | | | | $0.60 | $2 |
89
85
  | `llmgateway/glm-4.6v` | 128K | | | | | | $0.30 | $0.90 |
90
86
  | `llmgateway/glm-4.6v-flash` | 128K | | | | | | — | — |
91
87
  | `llmgateway/glm-4.6v-flashx` | 128K | | | | | | $0.04 | $0.40 |
92
- | `llmgateway/glm-4.7` | 200K | | | | | | $0.60 | $2 |
88
+ | `llmgateway/glm-4.7` | 205K | | | | | | $0.60 | $2 |
93
89
  | `llmgateway/glm-4.7-flash` | 200K | | | | | | — | — |
94
90
  | `llmgateway/glm-4.7-flashx` | 200K | | | | | | $0.07 | $0.40 |
95
- | `llmgateway/glm-5` | 203K | | | | | | $1 | $3 |
96
- | `llmgateway/glm-image` | 2K | | | | | | — | — |
91
+ | `llmgateway/glm-5` | 205K | | | | | | $1 | $3 |
92
+ | `llmgateway/glm-5.1` | 200K | | | | | | $6 | $24 |
97
93
  | `llmgateway/gpt-3.5-turbo` | 16K | | | | | | $0.50 | $2 |
98
94
  | `llmgateway/gpt-4` | 8K | | | | | | $30 | $60 |
99
95
  | `llmgateway/gpt-4-turbo` | 128K | | | | | | $10 | $30 |
@@ -132,13 +128,10 @@ for await (const chunk of stream) {
132
128
  | `llmgateway/grok-4-1-fast-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
133
129
  | `llmgateway/grok-4-20-beta-0309-non-reasoning` | 2.0M | | | | | | $2 | $6 |
134
130
  | `llmgateway/grok-4-20-beta-0309-reasoning` | 2.0M | | | | | | $2 | $6 |
135
- | `llmgateway/grok-4-20-multi-agent-beta-0309` | 2.0M | | | | | | $2 | $6 |
136
131
  | `llmgateway/grok-4-fast` | 2.0M | | | | | | $0.20 | $0.50 |
137
132
  | `llmgateway/grok-4-fast-non-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
138
133
  | `llmgateway/grok-4-fast-reasoning` | 2.0M | | | | | | $0.20 | $0.50 |
139
134
  | `llmgateway/grok-code-fast-1` | 256K | | | | | | $0.20 | $2 |
140
- | `llmgateway/grok-imagine-image` | 2K | | | | | | — | — |
141
- | `llmgateway/grok-imagine-image-pro` | 2K | | | | | | — | — |
142
135
  | `llmgateway/hermes-2-pro-llama-3-8b` | 8K | | | | | | $0.14 | $0.14 |
143
136
  | `llmgateway/kimi-k2` | 131K | | | | | | $1 | $3 |
144
137
  | `llmgateway/kimi-k2-thinking` | 262K | | | | | | $0.60 | $3 |
@@ -151,13 +144,13 @@ for await (const chunk of stream) {
151
144
  | `llmgateway/llama-3.1-nemotron-ultra-253b` | 128K | | | | | | $0.60 | $2 |
152
145
  | `llmgateway/llama-3.2-11b-instruct` | 128K | | | | | | $0.07 | $0.33 |
153
146
  | `llmgateway/llama-3.2-3b-instruct` | 33K | | | | | | $0.03 | $0.05 |
154
- | `llmgateway/llama-3.3-70b-instruct` | 128K | | | | | | $0.13 | $0.40 |
147
+ | `llmgateway/llama-3.3-70b-instruct` | 128K | | | | | | — | — |
155
148
  | `llmgateway/llama-4-maverick-17b-instruct` | 8K | | | | | | $0.24 | $0.97 |
156
149
  | `llmgateway/llama-4-scout` | 33K | | | | | | $0.18 | $0.59 |
157
150
  | `llmgateway/llama-4-scout-17b-instruct` | 8K | | | | | | $0.17 | $0.66 |
158
- | `llmgateway/llama-guard-4-12b` | 131K | | | | | | $0.20 | $0.20 |
159
- | `llmgateway/minimax-m2` | 197K | | | | | | $0.20 | $1 |
160
- | `llmgateway/minimax-m2.1` | 197K | | | | | | $0.27 | $1 |
151
+ | `llmgateway/mimo-v2-flash` | 256K | | | | | | $0.10 | $0.30 |
152
+ | `llmgateway/minimax-m2` | 197K | | | | | | $0.30 | $1 |
153
+ | `llmgateway/minimax-m2.1` | 205K | | | | | | $0.30 | $1 |
161
154
  | `llmgateway/minimax-m2.1-lightning` | 197K | | | | | | $0.12 | $0.48 |
162
155
  | `llmgateway/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
163
156
  | `llmgateway/minimax-m2.5-highspeed` | 205K | | | | | | $0.60 | $2 |
@@ -168,57 +161,50 @@ for await (const chunk of stream) {
168
161
  | `llmgateway/ministral-3b-2512` | 131K | | | | | | $0.10 | $0.10 |
169
162
  | `llmgateway/ministral-8b-2512` | 262K | | | | | | $0.15 | $0.15 |
170
163
  | `llmgateway/mistral-large-2512` | 262K | | | | | | $0.50 | $2 |
171
- | `llmgateway/mistral-large-latest` | 128K | | | | | | $4 | $12 |
164
+ | `llmgateway/mistral-large-latest` | 262K | | | | | | $0.50 | $2 |
172
165
  | `llmgateway/mistral-small-2506` | 128K | | | | | | $0.10 | $0.30 |
173
- | `llmgateway/mixtral-8x7b-instruct-together` | 33K | | | | | | $0.06 | $0.06 |
174
166
  | `llmgateway/o1` | 200K | | | | | | $15 | $60 |
175
167
  | `llmgateway/o3` | 200K | | | | | | $2 | $8 |
176
168
  | `llmgateway/o3-mini` | 200K | | | | | | $1 | $4 |
177
169
  | `llmgateway/o4-mini` | 200K | | | | | | $1 | $4 |
178
- | `llmgateway/pixtral-large-latest` | 128K | | | | | | $4 | $12 |
179
- | `llmgateway/qwen-coder-plus` | 131K | | | | | | $1 | $5 |
170
+ | `llmgateway/pixtral-large-latest` | 128K | | | | | | $2 | $6 |
171
+ | `llmgateway/qwen-coder-plus` | 131K | | | | | | $0.50 | $1 |
180
172
  | `llmgateway/qwen-flash` | 1.0M | | | | | | $0.05 | $0.40 |
181
- | `llmgateway/qwen-image` | 2K | | | | | | — | — |
182
- | `llmgateway/qwen-image-edit-max` | 2K | | | | | | — | — |
183
- | `llmgateway/qwen-image-edit-plus` | 2K | | | | | | — | — |
184
- | `llmgateway/qwen-image-max` | 2K | | | | | | — | — |
185
- | `llmgateway/qwen-image-max-2025-12-30` | 2K | | | | | | — | — |
186
- | `llmgateway/qwen-image-plus` | 2K | | | | | | — | — |
187
- | `llmgateway/qwen-max` | 131K | | | | | | $2 | $6 |
188
- | `llmgateway/qwen-max-latest` | 131K | | | | | | $2 | $6 |
189
- | `llmgateway/qwen-omni-turbo` | 33K | | | | | | $0.20 | $0.80 |
190
- | `llmgateway/qwen-plus` | 131K | | | | | | $0.40 | $1 |
191
- | `llmgateway/qwen-plus-latest` | 1.0M | | | | | | $0.40 | $1 |
173
+ | `llmgateway/qwen-max` | 33K | | | | | | $2 | $6 |
174
+ | `llmgateway/qwen-max-latest` | 33K | | | | | | $2 | $6 |
175
+ | `llmgateway/qwen-omni-turbo` | 33K | | | | | | $0.07 | $0.27 |
176
+ | `llmgateway/qwen-plus` | 1.0M | | | | | | $0.40 | $1 |
177
+ | `llmgateway/qwen-plus-latest` | 131K | | | | | | $0.30 | $0.90 |
192
178
  | `llmgateway/qwen-turbo` | 1.0M | | | | | | $0.05 | $0.20 |
193
179
  | `llmgateway/qwen-vl-max` | 131K | | | | | | $0.80 | $3 |
194
- | `llmgateway/qwen-vl-plus` | 131K | | | | | | $0.21 | $0.64 |
195
- | `llmgateway/qwen2-5-vl-32b-instruct` | 131K | | | | | | $1 | $4 |
196
- | `llmgateway/qwen2-5-vl-72b-instruct` | 33K | | | | | | $0.13 | $0.40 |
197
- | `llmgateway/qwen25-coder-7b` | 33K | | | | | | $0.01 | $0.03 |
198
- | `llmgateway/qwen3-235b-a22b-fp8` | 41K | | | | | | $0.20 | $0.80 |
199
- | `llmgateway/qwen3-235b-a22b-instruct-2507` | 262K | | | | | | $0.20 | $0.60 |
200
- | `llmgateway/qwen3-235b-a22b-thinking-2507` | 262K | | | | | | $0.20 | $0.60 |
201
- | `llmgateway/qwen3-30b-a3b-fp8` | 41K | | | | | | $0.09 | $0.45 |
202
- | `llmgateway/qwen3-30b-a3b-instruct-2507` | 262K | | | | | | $0.10 | $0.30 |
203
- | `llmgateway/qwen3-30b-a3b-thinking-2507` | 262K | | | | | | $0.10 | $0.30 |
204
- | `llmgateway/qwen3-32b` | 33K | | | | | | $0.10 | $0.30 |
205
- | `llmgateway/qwen3-32b-fp8` | 41K | | | | | | $0.10 | $0.45 |
206
- | `llmgateway/qwen3-4b-fp8` | 128K | | | | | | $0.03 | $0.03 |
207
- | `llmgateway/qwen3-coder-30b-a3b-instruct` | 262K | | | | | | $0.10 | $0.30 |
208
- | `llmgateway/qwen3-coder-480b-a35b-instruct` | 262K | | | | | | $0.40 | $2 |
180
+ | `llmgateway/qwen-vl-plus` | 131K | | | | | | $0.21 | $0.63 |
181
+ | `llmgateway/qwen2-5-vl-32b-instruct` | 131K | | | | | | $0.30 | $0.30 |
182
+ | `llmgateway/qwen2-5-vl-72b-instruct` | 131K | | | | | | $3 | $8 |
183
+ | `llmgateway/qwen25-coder-7b` | 131K | | | | | | $0.05 | $0.05 |
184
+ | `llmgateway/qwen3-235b-a22b-fp8` | 131K | | | | | | $0.50 | $3 |
185
+ | `llmgateway/qwen3-235b-a22b-instruct-2507` | 131K | | | | | | $0.80 | $2 |
186
+ | `llmgateway/qwen3-235b-a22b-thinking-2507` | 131K | | | | | | $0.80 | $2 |
187
+ | `llmgateway/qwen3-30b-a3b-fp8` | 131K | | | | | | $0.10 | $0.10 |
188
+ | `llmgateway/qwen3-30b-a3b-instruct-2507` | 131K | | | | | | $0.10 | $0.10 |
189
+ | `llmgateway/qwen3-30b-a3b-thinking-2507` | 131K | | | | | | $0.10 | $0.10 |
190
+ | `llmgateway/qwen3-32b` | 131K | | | | | | $0.70 | $3 |
191
+ | `llmgateway/qwen3-32b-fp8` | 131K | | | | | | $0.10 | $0.10 |
192
+ | `llmgateway/qwen3-4b-fp8` | 131K | | | | | | $0.03 | $0.05 |
193
+ | `llmgateway/qwen3-coder-30b-a3b-instruct` | 262K | | | | | | $0.45 | $2 |
194
+ | `llmgateway/qwen3-coder-480b-a35b-instruct` | 262K | | | | | | $2 | $8 |
209
195
  | `llmgateway/qwen3-coder-flash` | 1.0M | | | | | | $0.30 | $2 |
210
- | `llmgateway/qwen3-coder-next` | 262K | | | | | | $0.11 | $0.68 |
211
- | `llmgateway/qwen3-coder-plus` | 1.0M | | | | | | $6 | $60 |
212
- | `llmgateway/qwen3-max` | 256K | | | | | | $3 | $15 |
213
- | `llmgateway/qwen3-max-2026-01-23` | 262K | | | | | | $1 | $6 |
214
- | `llmgateway/qwen3-next-80b-a3b-instruct` | 129K | | | | | | $0.50 | $2 |
196
+ | `llmgateway/qwen3-coder-next` | 262K | | | | | | $0.80 | $4 |
197
+ | `llmgateway/qwen3-coder-plus` | 1.0M | | | | | | $1 | $5 |
198
+ | `llmgateway/qwen3-max` | 262K | | | | | | $1 | $6 |
199
+ | `llmgateway/qwen3-max-2026-01-23` | 256K | | | | | | $3 | $15 |
200
+ | `llmgateway/qwen3-next-80b-a3b-instruct` | 131K | | | | | | $0.50 | $2 |
215
201
  | `llmgateway/qwen3-next-80b-a3b-thinking` | 131K | | | | | | $0.50 | $6 |
216
- | `llmgateway/qwen3-vl-235b-a22b-instruct` | 131K | | | | | | $0.50 | $2 |
217
- | `llmgateway/qwen3-vl-235b-a22b-thinking` | 131K | | | | | | $0.50 | $2 |
218
- | `llmgateway/qwen3-vl-30b-a3b-instruct` | 131K | | | | | | $0.20 | $0.70 |
219
- | `llmgateway/qwen3-vl-30b-a3b-thinking` | 131K | | | | | | $0.20 | $1 |
220
- | `llmgateway/qwen3-vl-8b-instruct` | 131K | | | | | | $0.08 | $0.50 |
221
- | `llmgateway/qwen3-vl-flash` | 262K | | | | | | $0.05 | $0.40 |
202
+ | `llmgateway/qwen3-vl-235b-a22b-instruct` | 131K | | | | | | $0.80 | $2 |
203
+ | `llmgateway/qwen3-vl-235b-a22b-thinking` | 131K | | | | | | $0.80 | $2 |
204
+ | `llmgateway/qwen3-vl-30b-a3b-instruct` | 131K | | | | | | $0.10 | $0.10 |
205
+ | `llmgateway/qwen3-vl-30b-a3b-thinking` | 131K | | | | | | $0.10 | $0.10 |
206
+ | `llmgateway/qwen3-vl-8b-instruct` | 131K | | | | | | $0.10 | $0.10 |
207
+ | `llmgateway/qwen3-vl-flash` | 1.0M | | | | | | $0.05 | $0.40 |
222
208
  | `llmgateway/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
223
209
  | `llmgateway/qwen35-397b-a17b` | 262K | | | | | | $0.60 | $4 |
224
210
  | `llmgateway/qwq-plus` | 131K | | | | | | $0.80 | $2 |
@@ -226,13 +212,9 @@ for await (const chunk of stream) {
226
212
  | `llmgateway/seed-1-6-250915` | 256K | | | | | | $0.25 | $2 |
227
213
  | `llmgateway/seed-1-6-flash-250715` | 256K | | | | | | $0.07 | $0.30 |
228
214
  | `llmgateway/seed-1-8-251228` | 256K | | | | | | $0.25 | $2 |
229
- | `llmgateway/seedream-4-0` | 2K | | | | | | — | — |
230
- | `llmgateway/seedream-4-5` | 2K | | | | | | — | — |
231
- | `llmgateway/sonar` | 130K | | | | | | $1 | $1 |
215
+ | `llmgateway/sonar` | 128K | | | | | | $1 | $1 |
232
216
  | `llmgateway/sonar-pro` | 200K | | | | | | $3 | $15 |
233
217
  | `llmgateway/sonar-reasoning-pro` | 128K | | | | | | $2 | $8 |
234
- | `llmgateway/veo-3.1-fast-generate-preview` | 33K | | | | | | — | — |
235
- | `llmgateway/veo-3.1-generate-preview` | 33K | | | | | | — | — |
236
218
 
237
219
  ## Advanced configuration
238
220
 
@@ -262,7 +244,7 @@ const agent = new Agent({
262
244
  model: ({ requestContext }) => {
263
245
  const useAdvanced = requestContext.task === "complex";
264
246
  return useAdvanced
265
- ? "llmgateway/veo-3.1-generate-preview"
247
+ ? "llmgateway/sonar-reasoning-pro"
266
248
  : "llmgateway/auto";
267
249
  }
268
250
  });
package/.docs/models/providers/nvidia.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
2
2
 
3
- Access 76 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
3
+ Access 77 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
6
6
 
@@ -108,6 +108,7 @@ for await (const chunk of stream) {
108
108
  | `nvidia/qwen/qwen3.5-397b-a17b` | 262K | | | | | | — | — |
109
109
  | `nvidia/qwen/qwq-32b` | 128K | | | | | | — | — |
110
110
  | `nvidia/stepfun-ai/step-3.5-flash` | 256K | | | | | | — | — |
111
+ | `nvidia/z-ai/glm-5.1` | 131K | | | | | | — | — |
111
112
  | `nvidia/z-ai/glm4.7` | 205K | | | | | | — | — |
112
113
  | `nvidia/z-ai/glm5` | 203K | | | | | | — | — |
113
114
 
package/.docs/models/providers/wafer.ai.md ADDED
@@ -0,0 +1,72 @@
1
+ # ![Wafer logo](https://models.dev/logos/wafer.ai.svg)Wafer
2
+
3
+ Access 2 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
4
+
5
+ Learn more in the [Wafer documentation](https://docs.wafer.ai/wafer-pass).
6
+
7
+ ```bash
8
+ WAFER_API_KEY=your-api-key
9
+ ```
10
+
11
+ ```typescript
12
+ import { Agent } from "@mastra/core/agent";
13
+
14
+ const agent = new Agent({
15
+ id: "my-agent",
16
+ name: "My Agent",
17
+ instructions: "You are a helpful assistant",
18
+ model: "wafer.ai/GLM-5.1"
19
+ });
20
+
21
+ // Generate a response
22
+ const response = await agent.generate("Hello!");
23
+
24
+ // Stream a response
25
+ const stream = await agent.stream("Tell me a story");
26
+ for await (const chunk of stream) {
27
+ console.log(chunk);
28
+ }
29
+ ```
30
+
31
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Wafer documentation](https://docs.wafer.ai/wafer-pass) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `wafer.ai/GLM-5.1` | 203K | | | | | | — | — |
38
+ | `wafer.ai/Qwen3.5-397B-A17B` | 262K | | | | | | — | — |
39
+
40
+ ## Advanced configuration
41
+
42
+ ### Custom headers
43
+
44
+ ```typescript
45
+ const agent = new Agent({
46
+ id: "custom-agent",
47
+ name: "custom-agent",
48
+ model: {
49
+ url: "https://pass.wafer.ai/v1",
50
+ id: "wafer.ai/GLM-5.1",
51
+ apiKey: process.env.WAFER_API_KEY,
52
+ headers: {
53
+ "X-Custom-Header": "value"
54
+ }
55
+ }
56
+ });
57
+ ```
58
+
59
+ ### Dynamic model selection
60
+
61
+ ```typescript
62
+ const agent = new Agent({
63
+ id: "dynamic-agent",
64
+ name: "Dynamic Agent",
65
+ model: ({ requestContext }) => {
66
+ const useAdvanced = requestContext.task === "complex";
67
+ return useAdvanced
68
+ ? "wafer.ai/Qwen3.5-397B-A17B"
69
+ : "wafer.ai/GLM-5.1";
70
+ }
71
+ });
72
+ ```
package/.docs/models/providers.md CHANGED
@@ -91,6 +91,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
91
91
  - [Upstage](https://mastra.ai/models/providers/upstage)
92
92
  - [Vivgrid](https://mastra.ai/models/providers/vivgrid)
93
93
  - [Vultr](https://mastra.ai/models/providers/vultr)
94
+ - [Wafer](https://mastra.ai/models/providers/wafer.ai)
94
95
  - [Weights & Biases](https://mastra.ai/models/providers/wandb)
95
96
  - [Xiaomi](https://mastra.ai/models/providers/xiaomi)
96
97
  - [Xiaomi Token Plan (China)](https://mastra.ai/models/providers/xiaomi-token-plan-cn)
package/.docs/reference/harness/harness-class.md CHANGED
@@ -458,6 +458,12 @@ Respond to a pending question from the `ask_user` built-in tool.
458
458
  harness.respondToQuestion({ questionId: 'q-123', answer: 'Yes, proceed with the refactor' })
459
459
  ```
460
460
 
461
+ For multi-select questions, pass the selected option labels as a string array.
462
+
463
+ ```typescript
464
+ harness.respondToQuestion({ questionId: 'q-123', answer: ['Add tests', 'Update docs'] })
465
+ ```
466
+
461
467
  #### `respondToPlanApproval({ planId, response })`
462
468
 
463
469
  Respond to a pending plan approval from the `submit_plan` built-in tool. The `response` object contains `action` (`'approved'` or `'rejected'`) and an optional `feedback` string.
@@ -700,57 +706,74 @@ unsubscribe()
700
706
 
701
707
  The harness emits events through registered listeners. The following table lists the available event types:
702
708
 
703
- | Event type | Description |
704
- | -------------------------- | ------------------------------------------------------------------- |
705
- | `mode_changed` | The active mode changed. |
706
- | `model_changed` | The active model changed. |
707
- | `thread_changed` | The active thread changed. |
708
- | `thread_created` | A new thread was created. |
709
- | `thread_deleted` | A thread was deleted. |
710
- | `state_changed` | Harness state was updated. |
711
- | `agent_start` | The agent started processing. |
712
- | `agent_end` | The agent finished processing. |
713
- | `message_start` | A new message started streaming. |
714
- | `message_update` | A message was updated with new content. |
715
- | `message_end` | A message finished streaming. |
716
- | `tool_start` | A tool call started. |
717
- | `tool_approval_required` | A tool call requires user approval. |
718
- | `tool_update` | A tool call was updated with progress. |
719
- | `tool_end` | A tool call finished. |
720
- | `tool_input_start` | Tool input started streaming. |
721
- | `tool_input_delta` | Tool input received a streaming delta. |
722
- | `tool_input_end` | Tool input finished streaming. |
723
- | `usage_update` | Token usage was updated. |
724
- | `error` | An error occurred. |
725
- | `info` | An informational message was emitted. |
726
- | `follow_up_queued` | A follow-up message was queued. |
727
- | `workspace_status_changed` | The workspace status changed. |
728
- | `workspace_ready` | The workspace finished initializing. |
729
- | `workspace_error` | The workspace encountered an error. |
730
- | `om_status` | Observational Memory status update. |
731
- | `om_observation_start` | An observation started. |
732
- | `om_observation_end` | An observation completed. |
733
- | `om_reflection_start` | A reflection started. |
734
- | `om_reflection_end` | A reflection completed. |
735
- | `ask_question` | The agent asked a question via the `ask_user` tool. |
736
- | `plan_approval_required` | The agent submitted a plan for approval via the `submit_plan` tool. |
737
- | `plan_approved` | A plan was approved. |
738
- | `subagent_start` | A subagent started processing. |
739
- | `subagent_text_delta` | A subagent emitted a text delta. |
740
- | `subagent_tool_start` | A subagent started a tool call. |
741
- | `subagent_tool_end` | A subagent finished a tool call. |
742
- | `subagent_end` | A subagent finished processing. |
743
- | `subagent_model_changed` | A subagent's model changed. |
744
- | `task_updated` | A task list was updated. |
709
+ | Event type | Description |
710
+ | -------------------------- | --------------------------------------------------------------------------------------------------- |
711
+ | `mode_changed` | The active mode changed. |
712
+ | `model_changed` | The active model changed. |
713
+ | `thread_changed` | The active thread changed. |
714
+ | `thread_created` | A new thread was created. |
715
+ | `thread_deleted` | A thread was deleted. |
716
+ | `state_changed` | Harness state was updated. |
717
+ | `agent_start` | The agent started processing. |
718
+ | `agent_end` | The agent finished processing. |
719
+ | `message_start` | A new message started streaming. |
720
+ | `message_update` | A message was updated with new content. |
721
+ | `message_end` | A message finished streaming. |
722
+ | `tool_start` | A tool call started. |
723
+ | `tool_approval_required` | A tool call requires user approval. |
724
+ | `tool_update` | A tool call was updated with progress. |
725
+ | `tool_end` | A tool call finished. |
726
+ | `tool_input_start` | Tool input started streaming. |
727
+ | `tool_input_delta` | Tool input received a streaming delta. |
728
+ | `tool_input_end` | Tool input finished streaming. |
729
+ | `usage_update` | Token usage was updated. |
730
+ | `error` | An error occurred. |
731
+ | `info` | An informational message was emitted. |
732
+ | `follow_up_queued` | A follow-up message was queued. |
733
+ | `workspace_status_changed` | The workspace status changed. |
734
+ | `workspace_ready` | The workspace finished initializing. |
735
+ | `workspace_error` | The workspace encountered an error. |
736
+ | `om_status` | Observational Memory status update. |
737
+ | `om_observation_start` | An observation started. |
738
+ | `om_observation_end` | An observation completed. |
739
+ | `om_reflection_start` | A reflection started. |
740
+ | `om_reflection_end` | A reflection completed. |
741
+ | `ask_question` | The agent asked a question via the `ask_user` tool. Includes optional choices and a selection mode. |
742
+ | `plan_approval_required` | The agent submitted a plan for approval via the `submit_plan` tool. |
743
+ | `plan_approved` | A plan was approved. |
744
+ | `subagent_start` | A subagent started processing. |
745
+ | `subagent_text_delta` | A subagent emitted a text delta. |
746
+ | `subagent_tool_start` | A subagent started a tool call. |
747
+ | `subagent_tool_end` | A subagent finished a tool call. |
748
+ | `subagent_end` | A subagent finished processing. |
749
+ | `subagent_model_changed` | A subagent's model changed. |
750
+ | `task_updated` | A task list was updated. |
745
751
 
746
752
  ## Built-in tools
747
753
 
748
754
  The harness provides built-in tools to agents in every mode:
749
755
 
750
- | Tool | Description |
751
- | ------------- | ------------------------------------------------------------------------------------------------ |
752
- | `ask_user` | Ask the user a question and wait for their response. |
753
- | `submit_plan` | Submit a plan for user review and approval. |
754
- | `task_write` | Create or update a structured task list for tracking progress. |
755
- | `task_check` | Check the completion status of the current task list. |
756
- | `subagent` | Spawn a focused subagent with constrained tools (only available when `subagents` is configured). |
756
+ | Tool | Description |
757
+ | ------------- | ------------------------------------------------------------------------------------------------------------------------- |
758
+ | `ask_user` | Ask the user a question and wait for their response. Supports free text, single-select choices, and multi-select choices. |
759
+ | `submit_plan` | Submit a plan for user review and approval. |
760
+ | `task_write` | Create or update a structured task list for tracking progress. |
761
+ | `task_check` | Check the completion status of the current task list. |
762
+ | `subagent` | Spawn a focused subagent with constrained tools (only available when `subagents` is configured). |
763
+
764
+ ### `ask_user` selections
765
+
766
+ The `ask_user` tool accepts `options` for choice prompts. Set `selectionMode` to `single_select` to let the user pick one option, or `multi_select` to let the user pick multiple options. When `options` are provided and `selectionMode` is omitted, the prompt defaults to `single_select`. Omit `options` for free-text questions.
767
+
768
+ The following example demonstrates a multi-select response handler. The UI reads `event.selectionMode`, lets the user choose multiple options, then returns a string array with `respondToQuestion()`.
769
+
770
+ ```typescript
771
+ harness.subscribe(event => {
772
+ if (event.type === 'ask_question' && event.selectionMode === 'multi_select') {
773
+ harness.respondToQuestion({
774
+ questionId: event.questionId,
775
+ answer: ['Add tests', 'Update docs'],
776
+ })
777
+ }
778
+ })
779
+ ```
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.1.26-alpha.16
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`1bd5104`](https://github.com/mastra-ai/mastra/commit/1bd51048b6da93507276d6623e3fd96a9e1a8944)]:
8
+ - @mastra/core@1.26.0-alpha.8
9
+
10
+ ## 1.1.26-alpha.14
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`8786a61`](https://github.com/mastra-ai/mastra/commit/8786a61fa54ba265f85eeff9985ca39863d18bb6), [`8fb2405`](https://github.com/mastra-ai/mastra/commit/8fb2405138f2d208b7962ad03f121ca25bcc28c5)]:
15
+ - @mastra/core@1.26.0-alpha.7
16
+
3
17
  ## 1.1.26-alpha.12
4
18
 
5
19
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.1.26-alpha.13",
3
+ "version": "1.1.26-alpha.16",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -29,8 +29,8 @@
29
29
  "jsdom": "^26.1.0",
30
30
  "local-pkg": "^1.1.2",
31
31
  "zod": "^4.3.6",
32
- "@mastra/mcp": "^1.5.1-alpha.1",
33
- "@mastra/core": "1.26.0-alpha.6"
32
+ "@mastra/core": "1.26.0-alpha.8",
33
+ "@mastra/mcp": "^1.5.1-alpha.1"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@hono/node-server": "^1.19.11",
@@ -48,7 +48,7 @@
48
48
  "vitest": "4.0.18",
49
49
  "@internal/lint": "0.0.83",
50
50
  "@internal/types-builder": "0.0.58",
51
- "@mastra/core": "1.26.0-alpha.6"
51
+ "@mastra/core": "1.26.0-alpha.8"
52
52
  },
53
53
  "homepage": "https://mastra.ai",
54
54
  "repository": {