@mastra/mcp-docs-server 1.2.2-alpha.7 → 1.2.2

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 (31) hide show
  1. package/.docs/docs/server/auth/google.md +281 -0
  2. package/.docs/docs/server/auth.md +2 -1
  3. package/.docs/models/gateways/openrouter.md +2 -1
  4. package/.docs/models/gateways/vercel.md +3 -1
  5. package/.docs/models/index.md +1 -1
  6. package/.docs/models/providers/baseten.md +1 -1
  7. package/.docs/models/providers/berget.md +4 -3
  8. package/.docs/models/providers/evroc.md +19 -17
  9. package/.docs/models/providers/fireworks-ai.md +2 -1
  10. package/.docs/models/providers/friendli.md +3 -1
  11. package/.docs/models/providers/llmgateway.md +22 -22
  12. package/.docs/models/providers/minimax-cn-coding-plan.md +1 -1
  13. package/.docs/models/providers/minimax-cn.md +1 -1
  14. package/.docs/models/providers/minimax-coding-plan.md +1 -1
  15. package/.docs/models/providers/minimax.md +1 -1
  16. package/.docs/models/providers/nebius.md +3 -2
  17. package/.docs/models/providers/neuralwatt.md +2 -1
  18. package/.docs/models/providers/opencode-go.md +1 -1
  19. package/.docs/models/providers/ovhcloud.md +1 -2
  20. package/.docs/models/providers/scaleway.md +2 -1
  21. package/.docs/models/providers/stepfun.md +3 -2
  22. package/.docs/models/providers/togetherai.md +3 -2
  23. package/.docs/models/providers/xiaomi-token-plan-ams.md +4 -6
  24. package/.docs/models/providers/xiaomi-token-plan-cn.md +4 -6
  25. package/.docs/models/providers/xiaomi-token-plan-sgp.md +4 -6
  26. package/.docs/models/providers/xiaomi.md +4 -7
  27. package/.docs/reference/agents/durable-agent.md +30 -3
  28. package/.docs/reference/auth/google.md +355 -0
  29. package/.docs/reference/index.md +1 -0
  30. package/CHANGELOG.md +28 -0
  31. package/package.json +5 -5
package/.docs/models/providers/minimax.md CHANGED
@@ -40,7 +40,7 @@ for await (const chunk of stream) {
40
40
  | `minimax/MiniMax-M2.5-highspeed` | 205K | | | | | | $0.60 | $2 |
41
41
  | `minimax/MiniMax-M2.7` | 205K | | | | | | $0.30 | $1 |
42
42
  | `minimax/MiniMax-M2.7-highspeed` | 205K | | | | | | $0.60 | $2 |
43
- | `minimax/MiniMax-M3` | 512K | | | | | | $0.60 | $2 |
43
+ | `minimax/MiniMax-M3` | 1.0M | | | | | | $0.30 | $1 |
44
44
 
45
45
  ## Advanced configuration
46
46
 
package/.docs/models/providers/nebius.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Nebius Token Factory logo](https://models.dev/logos/nebius.svg)Nebius Token Factory
2
2
 
3
- Access 18 Nebius Token Factory models through Mastra's model router. Authentication is handled automatically using the `NEBIUS_API_KEY` environment variable.
3
+ Access 19 Nebius Token Factory models through Mastra's model router. Authentication is handled automatically using the `NEBIUS_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Nebius Token Factory documentation](https://docs.tokenfactory.nebius.com/).
6
6
 
@@ -52,6 +52,7 @@ for await (const chunk of stream) {
52
52
  | `nebius/Qwen/Qwen3-Embedding-8B` | 33K | | | | | | $0.01 | — |
53
53
  | `nebius/Qwen/Qwen3-Next-80B-A3B-Thinking` | 128K | | | | | | $0.15 | $1 |
54
54
  | `nebius/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.60 | $4 |
55
+ | `nebius/zai-org/GLM-5.2` | 432K | | | | | | $1 | $4 |
55
56
 
56
57
  ## Advanced configuration
57
58
 
@@ -81,7 +82,7 @@ const agent = new Agent({
81
82
  model: ({ requestContext }) => {
82
83
  const useAdvanced = requestContext.task === "complex";
83
84
  return useAdvanced
84
- ? "nebius/openai/gpt-oss-120b"
85
+ ? "nebius/zai-org/GLM-5.2"
85
86
  : "nebius/MiniMaxAI/MiniMax-M2.5";
86
87
  }
87
88
  });
package/.docs/models/providers/neuralwatt.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Neuralwatt logo](https://models.dev/logos/neuralwatt.svg)Neuralwatt
2
2
 
3
- Access 13 Neuralwatt models through Mastra's model router. Authentication is handled automatically using the `NEURALWATT_API_KEY` environment variable.
3
+ Access 14 Neuralwatt models through Mastra's model router. Authentication is handled automatically using the `NEURALWATT_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Neuralwatt documentation](https://portal.neuralwatt.com/docs).
6
6
 
@@ -37,6 +37,7 @@ for await (const chunk of stream) {
37
37
  | `neuralwatt/glm-5-fast` | 203K | | | | | | $1 | $4 |
38
38
  | `neuralwatt/glm-5.1-fast` | 203K | | | | | | $1 | $4 |
39
39
  | `neuralwatt/glm-5.2` | 1.0M | | | | | | $1 | $5 |
40
+ | `neuralwatt/glm-5.2-short` | 200K | | | | | | $1 | $5 |
40
41
  | `neuralwatt/kimi-k2.5-fast` | 262K | | | | | | $0.52 | $3 |
41
42
  | `neuralwatt/kimi-k2.6-fast` | 262K | | | | | | $0.69 | $3 |
42
43
  | `neuralwatt/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.52 | $3 |
package/.docs/models/providers/opencode-go.md CHANGED
@@ -43,7 +43,7 @@ for await (const chunk of stream) {
43
43
  | `opencode-go/mimo-v2.5` | 1.0M | | | | | | $0.14 | $0.28 |
44
44
  | `opencode-go/mimo-v2.5-pro` | 1.0M | | | | | | $2 | $3 |
45
45
  | `opencode-go/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
46
- | `opencode-go/minimax-m3` | 512K | | | | | | $0.10 | $0.40 |
46
+ | `opencode-go/minimax-m3` | 1.0M | | | | | | $0.10 | $0.40 |
47
47
  | `opencode-go/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
48
48
  | `opencode-go/qwen3.7-max` | 1.0M | | | | | | $3 | $8 |
49
49
  | `opencode-go/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
package/.docs/models/providers/ovhcloud.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![OVHcloud AI Endpoints logo](https://models.dev/logos/ovhcloud.svg)OVHcloud AI Endpoints
2
2
 
3
- Access 15 OVHcloud AI Endpoints models through Mastra's model router. Authentication is handled automatically using the `OVHCLOUD_API_KEY` environment variable.
3
+ Access 14 OVHcloud AI Endpoints models through Mastra's model router. Authentication is handled automatically using the `OVHCLOUD_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [OVHcloud AI Endpoints documentation](https://www.ovhcloud.com/en/public-cloud/ai-endpoints/catalog//).
6
6
 
@@ -36,7 +36,6 @@ for await (const chunk of stream) {
36
36
  | ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
37
  | `ovhcloud/gpt-oss-120b` | 131K | | | | | | $0.09 | $0.47 |
38
38
  | `ovhcloud/gpt-oss-20b` | 131K | | | | | | $0.05 | $0.18 |
39
- | `ovhcloud/llama-3.1-8b-instruct` | 131K | | | | | | $0.11 | $0.11 |
40
39
  | `ovhcloud/meta-llama-3_3-70b-instruct` | 131K | | | | | | $0.74 | $0.74 |
41
40
  | `ovhcloud/mistral-7b-instruct-v0.3` | 66K | | | | | | $0.11 | $0.11 |
42
41
  | `ovhcloud/mistral-nemo-instruct-2407` | 66K | | | | | | $0.14 | $0.14 |
package/.docs/models/providers/scaleway.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Scaleway logo](https://models.dev/logos/scaleway.svg)Scaleway
2
2
 
3
- Access 15 Scaleway models through Mastra's model router. Authentication is handled automatically using the `SCALEWAY_API_KEY` environment variable.
3
+ Access 16 Scaleway models through Mastra's model router. Authentication is handled automatically using the `SCALEWAY_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Scaleway documentation](https://www.scaleway.com/en/docs/generative-apis/).
6
6
 
@@ -37,6 +37,7 @@ for await (const chunk of stream) {
37
37
  | `scaleway/bge-multilingual-gemma2` | 8K | | | | | | $0.10 | — |
38
38
  | `scaleway/gemma-3-27b-it` | 40K | | | | | | $0.25 | $0.50 |
39
39
  | `scaleway/gemma-4-26b-a4b-it` | 256K | | | | | | $0.25 | $0.50 |
40
+ | `scaleway/glm-5.2` | 256K | | | | | | $2 | $6 |
40
41
  | `scaleway/gpt-oss-120b` | 128K | | | | | | $0.15 | $0.60 |
41
42
  | `scaleway/llama-3.3-70b-instruct` | 100K | | | | | | $0.90 | $0.90 |
42
43
  | `scaleway/mistral-medium-3.5-128b` | 256K | | | | | | $2 | $8 |
package/.docs/models/providers/stepfun.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![StepFun logo](https://models.dev/logos/stepfun.svg)StepFun
2
2
 
3
- Access 4 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
3
+ Access 5 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept).
6
6
 
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
38
38
  | `stepfun/step-2-16k` | 16K | | | | | | $5 | $16 |
39
39
  | `stepfun/step-3.5-flash` | 256K | | | | | | $0.10 | $0.30 |
40
40
  | `stepfun/step-3.5-flash-2603` | 256K | | | | | | $0.10 | $0.30 |
41
+ | `stepfun/step-3.7-flash` | 256K | | | | | | $0.19 | $1 |
41
42
 
42
43
  ## Advanced configuration
43
44
 
@@ -67,7 +68,7 @@ const agent = new Agent({
67
68
  model: ({ requestContext }) => {
68
69
  const useAdvanced = requestContext.task === "complex";
69
70
  return useAdvanced
70
- ? "stepfun/step-3.5-flash-2603"
71
+ ? "stepfun/step-3.7-flash"
71
72
  : "stepfun/step-1-32k";
72
73
  }
73
74
  });
package/.docs/models/providers/togetherai.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
2
2
 
3
- Access 24 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
3
+ Access 25 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
6
6
 
@@ -56,6 +56,7 @@ for await (const chunk of stream) {
56
56
  | `togetherai/Qwen/Qwen3.7-Max` | 1.0M | | | | | | $1 | $4 |
57
57
  | `togetherai/zai-org/GLM-5` | 203K | | | | | | $1 | $3 |
58
58
  | `togetherai/zai-org/GLM-5.1` | 203K | | | | | | $1 | $4 |
59
+ | `togetherai/zai-org/GLM-5.2` | 262K | | | | | | $1 | $4 |
59
60
 
60
61
  ## Advanced configuration
61
62
 
@@ -84,7 +85,7 @@ const agent = new Agent({
84
85
  model: ({ requestContext }) => {
85
86
  const useAdvanced = requestContext.task === "complex";
86
87
  return useAdvanced
87
- ? "togetherai/zai-org/GLM-5.1"
88
+ ? "togetherai/zai-org/GLM-5.2"
88
89
  : "togetherai/LiquidAI/LFM2-24B-A2B";
89
90
  }
90
91
  });
package/.docs/models/providers/xiaomi-token-plan-ams.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Xiaomi Token Plan (Europe) logo](https://models.dev/logos/xiaomi-token-plan-ams.svg)Xiaomi Token Plan (Europe)
2
2
 
3
- Access 8 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
3
+ Access 6 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Xiaomi Token Plan (Europe) documentation](https://platform.xiaomimimo.com/#/docs).
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: "xiaomi-token-plan-ams/mimo-v2-omni"
18
+ model: "xiaomi-token-plan-ams/mimo-v2-tts"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -34,8 +34,6 @@ for await (const chunk of stream) {
34
34
 
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | ------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `xiaomi-token-plan-ams/mimo-v2-omni` | 262K | | | | | | — | — |
38
- | `xiaomi-token-plan-ams/mimo-v2-pro` | 1.0M | | | | | | — | — |
39
37
  | `xiaomi-token-plan-ams/mimo-v2-tts` | 8K | | | | | | — | — |
40
38
  | `xiaomi-token-plan-ams/mimo-v2.5` | 1.0M | | | | | | — | — |
41
39
  | `xiaomi-token-plan-ams/mimo-v2.5-pro` | 1.0M | | | | | | — | — |
@@ -53,7 +51,7 @@ const agent = new Agent({
53
51
  name: "custom-agent",
54
52
  model: {
55
53
  url: "https://token-plan-ams.xiaomimimo.com/v1",
56
- id: "xiaomi-token-plan-ams/mimo-v2-omni",
54
+ id: "xiaomi-token-plan-ams/mimo-v2-tts",
57
55
  apiKey: process.env.XIAOMI_API_KEY,
58
56
  headers: {
59
57
  "X-Custom-Header": "value"
@@ -72,7 +70,7 @@ const agent = new Agent({
72
70
  const useAdvanced = requestContext.task === "complex";
73
71
  return useAdvanced
74
72
  ? "xiaomi-token-plan-ams/mimo-v2.5-tts-voicedesign"
75
- : "xiaomi-token-plan-ams/mimo-v2-omni";
73
+ : "xiaomi-token-plan-ams/mimo-v2-tts";
76
74
  }
77
75
  });
78
76
  ```
package/.docs/models/providers/xiaomi-token-plan-cn.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Xiaomi Token Plan (China) logo](https://models.dev/logos/xiaomi-token-plan-cn.svg)Xiaomi Token Plan (China)
2
2
 
3
- Access 8 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
3
+ Access 6 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Xiaomi Token Plan (China) documentation](https://platform.xiaomimimo.com/#/docs).
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: "xiaomi-token-plan-cn/mimo-v2-omni"
18
+ model: "xiaomi-token-plan-cn/mimo-v2-tts"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -34,8 +34,6 @@ for await (const chunk of stream) {
34
34
 
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | ------------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `xiaomi-token-plan-cn/mimo-v2-omni` | 262K | | | | | | — | — |
38
- | `xiaomi-token-plan-cn/mimo-v2-pro` | 1.0M | | | | | | — | — |
39
37
  | `xiaomi-token-plan-cn/mimo-v2-tts` | 8K | | | | | | — | — |
40
38
  | `xiaomi-token-plan-cn/mimo-v2.5` | 1.0M | | | | | | — | — |
41
39
  | `xiaomi-token-plan-cn/mimo-v2.5-pro` | 1.0M | | | | | | — | — |
@@ -53,7 +51,7 @@ const agent = new Agent({
53
51
  name: "custom-agent",
54
52
  model: {
55
53
  url: "https://token-plan-cn.xiaomimimo.com/v1",
56
- id: "xiaomi-token-plan-cn/mimo-v2-omni",
54
+ id: "xiaomi-token-plan-cn/mimo-v2-tts",
57
55
  apiKey: process.env.XIAOMI_API_KEY,
58
56
  headers: {
59
57
  "X-Custom-Header": "value"
@@ -72,7 +70,7 @@ const agent = new Agent({
72
70
  const useAdvanced = requestContext.task === "complex";
73
71
  return useAdvanced
74
72
  ? "xiaomi-token-plan-cn/mimo-v2.5-tts-voicedesign"
75
- : "xiaomi-token-plan-cn/mimo-v2-omni";
73
+ : "xiaomi-token-plan-cn/mimo-v2-tts";
76
74
  }
77
75
  });
78
76
  ```
package/.docs/models/providers/xiaomi-token-plan-sgp.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Xiaomi Token Plan (Singapore) logo](https://models.dev/logos/xiaomi-token-plan-sgp.svg)Xiaomi Token Plan (Singapore)
2
2
 
3
- Access 8 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
3
+ Access 6 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Xiaomi Token Plan (Singapore) documentation](https://platform.xiaomimimo.com/#/docs).
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: "xiaomi-token-plan-sgp/mimo-v2-omni"
18
+ model: "xiaomi-token-plan-sgp/mimo-v2-tts"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -34,8 +34,6 @@ for await (const chunk of stream) {
34
34
 
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | ------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `xiaomi-token-plan-sgp/mimo-v2-omni` | 262K | | | | | | — | — |
38
- | `xiaomi-token-plan-sgp/mimo-v2-pro` | 1.0M | | | | | | — | — |
39
37
  | `xiaomi-token-plan-sgp/mimo-v2-tts` | 8K | | | | | | — | — |
40
38
  | `xiaomi-token-plan-sgp/mimo-v2.5` | 1.0M | | | | | | — | — |
41
39
  | `xiaomi-token-plan-sgp/mimo-v2.5-pro` | 1.0M | | | | | | — | — |
@@ -53,7 +51,7 @@ const agent = new Agent({
53
51
  name: "custom-agent",
54
52
  model: {
55
53
  url: "https://token-plan-sgp.xiaomimimo.com/v1",
56
- id: "xiaomi-token-plan-sgp/mimo-v2-omni",
54
+ id: "xiaomi-token-plan-sgp/mimo-v2-tts",
57
55
  apiKey: process.env.XIAOMI_API_KEY,
58
56
  headers: {
59
57
  "X-Custom-Header": "value"
@@ -72,7 +70,7 @@ const agent = new Agent({
72
70
  const useAdvanced = requestContext.task === "complex";
73
71
  return useAdvanced
74
72
  ? "xiaomi-token-plan-sgp/mimo-v2.5-tts-voicedesign"
75
- : "xiaomi-token-plan-sgp/mimo-v2-omni";
73
+ : "xiaomi-token-plan-sgp/mimo-v2-tts";
76
74
  }
77
75
  });
78
76
  ```
package/.docs/models/providers/xiaomi.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ![Xiaomi logo](https://models.dev/logos/xiaomi.svg)Xiaomi
2
2
 
3
- Access 6 Xiaomi models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
3
+ Access 3 Xiaomi models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Xiaomi documentation](https://platform.xiaomimimo.com/#/docs).
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: "xiaomi/mimo-v2-flash"
18
+ model: "xiaomi/mimo-v2.5"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -34,9 +34,6 @@ for await (const chunk of stream) {
34
34
 
35
35
  | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
36
  | --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `xiaomi/mimo-v2-flash` | 262K | | | | | | $0.10 | $0.30 |
38
- | `xiaomi/mimo-v2-omni` | 262K | | | | | | $0.40 | $2 |
39
- | `xiaomi/mimo-v2-pro` | 1.0M | | | | | | $1 | $3 |
40
37
  | `xiaomi/mimo-v2.5` | 1.0M | | | | | | $0.40 | $2 |
41
38
  | `xiaomi/mimo-v2.5-pro` | 1.0M | | | | | | $1 | $3 |
42
39
  | `xiaomi/mimo-v2.5-pro-ultraspeed` | 1.0M | | | | | | $1 | $3 |
@@ -51,7 +48,7 @@ const agent = new Agent({
51
48
  name: "custom-agent",
52
49
  model: {
53
50
  url: "https://api.xiaomimimo.com/v1",
54
- id: "xiaomi/mimo-v2-flash",
51
+ id: "xiaomi/mimo-v2.5",
55
52
  apiKey: process.env.XIAOMI_API_KEY,
56
53
  headers: {
57
54
  "X-Custom-Header": "value"
@@ -70,7 +67,7 @@ const agent = new Agent({
70
67
  const useAdvanced = requestContext.task === "complex";
71
68
  return useAdvanced
72
69
  ? "xiaomi/mimo-v2.5-pro-ultraspeed"
73
- : "xiaomi/mimo-v2-flash";
70
+ : "xiaomi/mimo-v2.5";
74
71
  }
75
72
  });
76
73
  ```
package/.docs/reference/agents/durable-agent.md CHANGED
@@ -203,9 +203,13 @@ interface PrepareResult {
203
203
 
204
204
  **activeTools** (`string[]`): Restricts execution to the named subset of the agent's tools.
205
205
 
206
- **modelSettings** (`object`): Model-specific settings such as temperature.
206
+ **modelSettings** (`object`): Model-specific settings such as temperature. Credential-bearing headers (\`Authorization\`, \`X-Api-Key\`, and similar) are stripped from the serialized snapshot before it crosses process boundaries.
207
207
 
208
- **requireToolApproval** (`boolean`): Require approval for all tool calls, which suspends the run until resumed.
208
+ **stopWhen** (`AgentExecutionOptions['stopWhen']`): Predicate or composition that ends the agentic loop early. The closure rides on the in-process run registry; cross-process resumes degrade to \`maxSteps\` only.
209
+
210
+ **system** (`string | string[]`): Additional system message appended after the agent instructions and before user messages.
211
+
212
+ **requireToolApproval** (`boolean | ((args: { toolName: string; args: unknown; requestContext: RequestContext; workspace?: string }) => boolean | Promise<boolean>)`): Require approval for tool calls. Pass \`true\` or \`false\` to gate all or none, or a function for per-call policy. Function-form policies live on the in-process run registry; cross-process resumes fall back to a \`true\` shadow.
209
213
 
210
214
  **autoResumeSuspendedTools** (`boolean`): Automatically resume tools that suspended, instead of waiting for an external \`resume()\` call.
211
215
 
@@ -217,10 +221,26 @@ interface PrepareResult {
217
221
 
218
222
  **structuredOutput** (`object`): Structured output configuration.
219
223
 
220
- **untilIdle** (`boolean | { maxIdleMs?: number }`): When set, keeps the stream open across background-task continuations until the agent is idle. Pass \`true\` for the default 5-minute idle timeout, or \`{ maxIdleMs }\` to customise. Equivalent to the deprecated \`streamUntilIdle()\` method.
224
+ **untilIdle** (`boolean | { maxIdleMs?: number }`): When set, keeps the stream open across background-task continuations until the agent is idle. Pass \`true\` for the default 5-minute idle timeout, or \`{ maxIdleMs }\` to customise. Equivalent to the deprecated \`streamUntilIdle()\` method. Also supported on \`resume()\`.
225
+
226
+ **disableBackgroundTasks** (`boolean`): Disable background-task dispatch for this run. Background-eligible tools execute inline instead.
227
+
228
+ **tracingOptions** (`AgentExecutionOptions['tracingOptions']`): Tracing metadata, tags, trace ID, parent span ID, and \`requestContextKeys\` forwarded to the agent and model spans. Fully JSON-serializable.
229
+
230
+ **actor** (`AgentExecutionOptions['actor']`): Per-call actor signal forwarded to FGA checks and tool execution.
231
+
232
+ **transform** (`AgentExecutionOptions['transform']`): Per-invocation tool payload transform policy. The \`transformToolPayload\` closure lives on the in-process run registry; only the JSON-safe \`targets\` shadow is serialized.
233
+
234
+ **prepareStep** (`AgentExecutionOptions['prepareStep']`): Per-step preparation hook invoked as a \`PrepareStepProcessor\` at the start of every iteration. Closure-only — stored on the in-process run registry. Cross-process resumes lose the hook.
235
+
236
+ **isTaskComplete** (`AgentExecutionOptions['isTaskComplete']`): Per-call completion policy. Scorer instances and \`onComplete\` live on the in-process run registry; the JSON-safe primitives (\`strategy\`, \`timeout\`, \`parallel\`, \`suppressFeedback\`, \`scorerNames\`) are serialized for cross-process observability.
237
+
238
+ **delegation** (`AgentExecutionOptions['delegation']`): Sub-agent delegation hooks (\`onDelegationStart\`, \`onDelegationComplete\`, \`messageFilter\`). Callbacks are baked into the sub-agent tool wrappers at prepare time. Cross-process resumes lose the callbacks.
221
239
 
222
240
  **versions** (`object`): Version overrides for sub-agent delegation.
223
241
 
242
+ **abortSignal** (`AbortSignal`): External abort signal. Forwarded to the durable run's internal \`AbortController\`, so either source can cancel the run. Cross-process resumes cannot recover the signal — pass a fresh one to \`resume()\` if you need post-resume abortability.
243
+
224
244
  **onChunk** (`(chunk: ChunkType) => void | Promise<void>`): Called for each streamed chunk.
225
245
 
226
246
  **onStepFinish** (`(result: AgentStepFinishEventData) => void | Promise<void>`): Called when a step in the agentic loop finishes.
@@ -231,6 +251,10 @@ interface PrepareResult {
231
251
 
232
252
  **onSuspended** (`(data: AgentSuspendedEventData) => void | Promise<void>`): Called when the run suspends, for example for tool approval.
233
253
 
254
+ **onAbort** (`AgentExecutionOptions['onAbort']`): Called when the run is aborted via \`abortSignal\` or \`result.abort()\`.
255
+
256
+ **onIterationComplete** (`AgentExecutionOptions['onIterationComplete']`): Called after every agentic-loop iteration with the latest \`messageList\`, \`finishReason\`, and \`isFinal\` flag. Observation-only on durable agents: returning \`continue: false\` or feedback does not influence the loop.
257
+
234
258
  `resume()` and `observe()` accept the same lifecycle callbacks (`onChunk`, `onStepFinish`, `onFinish`, `onError`, `onSuspended`). `observe()` also accepts an `offset` to control where replay starts.
235
259
 
236
260
  ## DurableAgentStreamResult
@@ -245,6 +269,7 @@ interface DurableAgentStreamResult<OUTPUT = undefined> {
245
269
  threadId?: string
246
270
  resourceId?: string
247
271
  cleanup: () => void
272
+ abort: () => void
248
273
  }
249
274
  ```
250
275
 
@@ -260,6 +285,8 @@ interface DurableAgentStreamResult<OUTPUT = undefined> {
260
285
 
261
286
  **cleanup** (`() => void`): Unsubscribes from PubSub and clears registry entries for the run. Call it when done with the run.
262
287
 
288
+ **abort** (`() => void`): Aborts the run by flipping the internal \`AbortController\`. Surfaces as an \`AbortError\` inside the durable LLM-execution step and fires the \`onAbort\` callback. Safe to call after the run has finished — a no-op in that case.
289
+
263
290
  ## Related
264
291
 
265
292
  - [`createInngestAgent()`](https://mastra.ai/reference/agents/inngest-agent)