@mastra/mcp-docs-server 1.2.2-alpha.9 → 1.2.3-alpha.1

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 (39) hide show
  1. package/.docs/docs/{harness → agent-controller}/modes.md +19 -19
  2. package/.docs/docs/agent-controller/overview.md +128 -0
  3. package/.docs/docs/agent-controller/session.md +143 -0
  4. package/.docs/docs/{harness → agent-controller}/subagents.md +12 -12
  5. package/.docs/docs/agent-controller/threads-and-state.md +141 -0
  6. package/.docs/docs/{harness → agent-controller}/tool-approvals.md +23 -23
  7. package/.docs/docs/agents/channels.md +47 -0
  8. package/.docs/docs/server/auth/google.md +281 -0
  9. package/.docs/docs/server/auth.md +2 -1
  10. package/.docs/models/gateways/vercel.md +3 -1
  11. package/.docs/models/index.md +1 -1
  12. package/.docs/models/providers/baseten.md +1 -1
  13. package/.docs/models/providers/fireworks-ai.md +2 -1
  14. package/.docs/models/providers/friendli.md +3 -1
  15. package/.docs/models/providers/llmgateway.md +1 -2
  16. package/.docs/models/providers/nebius.md +3 -2
  17. package/.docs/models/providers/opencode-go.md +1 -1
  18. package/.docs/models/providers/ovhcloud.md +1 -2
  19. package/.docs/models/providers/scaleway.md +2 -1
  20. package/.docs/models/providers/tinfoil.md +77 -0
  21. package/.docs/models/providers/togetherai.md +3 -2
  22. package/.docs/models/providers/xiaomi-token-plan-ams.md +4 -6
  23. package/.docs/models/providers/xiaomi-token-plan-cn.md +4 -6
  24. package/.docs/models/providers/xiaomi-token-plan-sgp.md +4 -6
  25. package/.docs/models/providers/xiaomi.md +4 -7
  26. package/.docs/models/providers.md +1 -0
  27. package/.docs/reference/{harness/harness-class.md → agent-controller/agent-controller-class.md} +106 -106
  28. package/.docs/reference/{harness → agent-controller}/session.md +97 -91
  29. package/.docs/reference/agents/channels.md +3 -1
  30. package/.docs/reference/agents/durable-agent.md +30 -3
  31. package/.docs/reference/auth/google.md +355 -0
  32. package/.docs/reference/channels/channel-provider.md +65 -0
  33. package/.docs/reference/channels/slack-provider.md +226 -0
  34. package/.docs/reference/index.md +5 -2
  35. package/CHANGELOG.md +28 -0
  36. package/package.json +6 -6
  37. package/.docs/docs/harness/overview.md +0 -128
  38. package/.docs/docs/harness/session.md +0 -143
  39. package/.docs/docs/harness/threads-and-state.md +0 -141
package/.docs/models/providers/tinfoil.md ADDED
@@ -0,0 +1,77 @@
1
+ # ![Tinfoil logo](https://models.dev/logos/tinfoil.svg)Tinfoil
2
+
3
+ Access 7 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.
4
+
5
+ Learn more in the [Tinfoil documentation](https://docs.tinfoil.sh).
6
+
7
+ ```bash
8
+ TINFOIL_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: "tinfoil/gemma4-31b"
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 [Tinfoil documentation](https://docs.tinfoil.sh) for details.
32
+
33
+ ## Models
34
+
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `tinfoil/gemma4-31b` | 256K | | | | | | $0.40 | $1 |
38
+ | `tinfoil/glm-5-2` | 384K | | | | | | $2 | $5 |
39
+ | `tinfoil/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
40
+ | `tinfoil/gpt-oss-safeguard-120b` | 131K | | | | | | $0.15 | $0.60 |
41
+ | `tinfoil/kimi-k2-6` | 256K | | | | | | $2 | $5 |
42
+ | `tinfoil/llama3-3-70b` | 128K | | | | | | $2 | $3 |
43
+ | `tinfoil/nomic-embed-text` | 8K | | | | | | $0.05 | — |
44
+
45
+ ## Advanced configuration
46
+
47
+ ### Custom headers
48
+
49
+ ```typescript
50
+ const agent = new Agent({
51
+ id: "custom-agent",
52
+ name: "custom-agent",
53
+ model: {
54
+ url: "https://inference.tinfoil.sh/v1",
55
+ id: "tinfoil/gemma4-31b",
56
+ apiKey: process.env.TINFOIL_API_KEY,
57
+ headers: {
58
+ "X-Custom-Header": "value"
59
+ }
60
+ }
61
+ });
62
+ ```
63
+
64
+ ### Dynamic model selection
65
+
66
+ ```typescript
67
+ const agent = new Agent({
68
+ id: "dynamic-agent",
69
+ name: "Dynamic Agent",
70
+ model: ({ requestContext }) => {
71
+ const useAdvanced = requestContext.task === "complex";
72
+ return useAdvanced
73
+ ? "tinfoil/nomic-embed-text"
74
+ : "tinfoil/gemma4-31b";
75
+ }
76
+ });
77
+ ```
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/models/providers.md CHANGED
@@ -111,6 +111,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
111
111
  - [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan)
112
112
  - [Tencent TokenHub](https://mastra.ai/models/providers/tencent-tokenhub)
113
113
  - [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
114
+ - [Tinfoil](https://mastra.ai/models/providers/tinfoil)
114
115
  - [Together AI](https://mastra.ai/models/providers/togetherai)
115
116
  - [Umans AI](https://mastra.ai/models/providers/umans-ai)
116
117
  - [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan)