@mastra/mcp-docs-server 1.2.4-alpha.8 → 1.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.docs/docs/browser/recording.md +9 -1
- package/.docs/docs/evals/datasets/overview.md +9 -1
- package/.docs/models/environment-variables.md +1 -0
- package/.docs/models/gateways/openrouter.md +3 -1
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/llmgateway.md +1 -1
- package/.docs/models/providers/novita-ai.md +3 -3
- package/.docs/models/providers/stepfun-ai.md +11 -5
- package/.docs/models/providers/stepfun.md +5 -2
- package/.docs/models/providers/togetherai.md +1 -1
- package/.docs/models/providers/trustedrouter.md +79 -0
- package/.docs/models/providers/zenmux.md +3 -1
- package/.docs/models/providers.md +1 -0
- package/.docs/reference/browser/agent-browser.md +1 -1
- package/.docs/reference/browser/stagehand-browser.md +1 -1
- package/.docs/reference/datasets/list.md +29 -1
- package/.docs/reference/datasets/listItems.md +10 -6
- package/CHANGELOG.md +15 -0
- package/package.json +6 -6
|
@@ -21,7 +21,7 @@ Recording tools are disabled by default. Enable them only for agents that need t
|
|
|
21
21
|
|
|
22
22
|
## Enable recording
|
|
23
23
|
|
|
24
|
-
Pass `recording
|
|
24
|
+
Pass a `recording` object to `AgentBrowser` or `StagehandBrowser`. The only required field is `outputDir`. You can also set `maxDurationMs`, `maxWidth`, and `maxHeight` as defaults for every recording started by this browser.
|
|
25
25
|
|
|
26
26
|
The following example enables recording for `AgentBrowser`:
|
|
27
27
|
|
|
@@ -33,6 +33,9 @@ export const browser = new AgentBrowser({
|
|
|
33
33
|
headless: false,
|
|
34
34
|
recording: {
|
|
35
35
|
outputDir: join(process.cwd(), 'browser-recordings'),
|
|
36
|
+
maxDurationMs: 60_000,
|
|
37
|
+
maxWidth: 1280,
|
|
38
|
+
maxHeight: 720,
|
|
36
39
|
},
|
|
37
40
|
})
|
|
38
41
|
```
|
|
@@ -47,10 +50,15 @@ export const browser = new StagehandBrowser({
|
|
|
47
50
|
headless: false,
|
|
48
51
|
recording: {
|
|
49
52
|
outputDir: join(process.cwd(), 'browser-recordings'),
|
|
53
|
+
maxDurationMs: 60_000,
|
|
54
|
+
maxWidth: 1280,
|
|
55
|
+
maxHeight: 720,
|
|
50
56
|
},
|
|
51
57
|
})
|
|
52
58
|
```
|
|
53
59
|
|
|
60
|
+
The agent can still override these defaults per-recording by passing `maxDurationMs`, `maxWidth`, or `maxHeight` to the `browser_record` tool at start time.
|
|
61
|
+
|
|
54
62
|
## Recording tools
|
|
55
63
|
|
|
56
64
|
Enabling recording adds these tools:
|
|
@@ -148,7 +148,15 @@ const { items: matches } = await dataset.listItems({
|
|
|
148
148
|
search: 'Hello',
|
|
149
149
|
})
|
|
150
150
|
|
|
151
|
-
//
|
|
151
|
+
// Search and pagination can be combined with a specific version
|
|
152
|
+
const { items: v2Matches } = await dataset.listItems({
|
|
153
|
+
version: 2,
|
|
154
|
+
search: 'Hello',
|
|
155
|
+
page: 0,
|
|
156
|
+
perPage: 50,
|
|
157
|
+
})
|
|
158
|
+
|
|
159
|
+
// Version-only snapshot returns a bare DatasetItem[]
|
|
152
160
|
const v2Items = await dataset.listItems({ version: 2 })
|
|
153
161
|
```
|
|
154
162
|
|
|
@@ -118,6 +118,7 @@ List of required environment variables for each model provider and gateway suppo
|
|
|
118
118
|
| [The Grid AI](https://mastra.ai/models/providers/the-grid-ai) | `the-grid-ai/*` | `THEGRIDAI_API_KEY` |
|
|
119
119
|
| [Tinfoil](https://mastra.ai/models/providers/tinfoil) | `tinfoil/*` | `TINFOIL_API_KEY` |
|
|
120
120
|
| [Together AI](https://mastra.ai/models/providers/togetherai) | `togetherai/*` | `TOGETHER_API_KEY` |
|
|
121
|
+
| [TrustedRouter](https://mastra.ai/models/providers/trustedrouter) | `trustedrouter/*` | `TRUSTEDROUTER_API_KEY` |
|
|
121
122
|
| [Umans AI](https://mastra.ai/models/providers/umans-ai) | `umans-ai/*` | `UMANS_AI_API_KEY` |
|
|
122
123
|
| [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan) | `umans-ai-coding-plan/*` | `UMANS_AI_CODING_PLAN_API_KEY` |
|
|
123
124
|
| [Upstage](https://mastra.ai/models/providers/upstage) | `upstage/*` | `UPSTAGE_API_KEY` |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenRouter
|
|
4
4
|
|
|
5
|
-
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
5
|
+
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 339 models through Mastra's model router.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
|
|
8
8
|
|
|
@@ -283,6 +283,8 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
283
283
|
| `perplexity/sonar-reasoning-pro` |
|
|
284
284
|
| `poolside/laguna-m.1` |
|
|
285
285
|
| `poolside/laguna-m.1:free` |
|
|
286
|
+
| `poolside/laguna-xs-2.1` |
|
|
287
|
+
| `poolside/laguna-xs-2.1:free` |
|
|
286
288
|
| `poolside/laguna-xs.2` |
|
|
287
289
|
| `poolside/laguna-xs.2:free` |
|
|
288
290
|
| `qwen/qwen-2.5-72b-instruct` |
|
package/.docs/models/index.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Model Providers
|
|
4
4
|
|
|
5
|
-
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to
|
|
5
|
+
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4520 models from 137 providers through a single API.
|
|
6
6
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
@@ -52,7 +52,7 @@ for await (const chunk of stream) {
|
|
|
52
52
|
| `llmgateway/claude-sonnet-4-5` | 200K | | | | | | $3 | $15 |
|
|
53
53
|
| `llmgateway/claude-sonnet-4-5-20250929` | 200K | | | | | | $3 | $15 |
|
|
54
54
|
| `llmgateway/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
|
|
55
|
-
| `llmgateway/claude-sonnet-5` | 1.0M | | | | | | $
|
|
55
|
+
| `llmgateway/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
|
|
56
56
|
| `llmgateway/codestral-2508` | 256K | | | | | | $0.30 | $0.90 |
|
|
57
57
|
| `llmgateway/custom` | 128K | | | | | | — | — |
|
|
58
58
|
| `llmgateway/deepseek-v3.1` | 128K | | | | | | $0.56 | $2 |
|
|
@@ -89,7 +89,7 @@ for await (const chunk of stream) {
|
|
|
89
89
|
| `novita-ai/moonshotai/kimi-k2-instruct` | 131K | | | | | | $0.57 | $2 |
|
|
90
90
|
| `novita-ai/moonshotai/kimi-k2-thinking` | 262K | | | | | | $0.60 | $3 |
|
|
91
91
|
| `novita-ai/moonshotai/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
92
|
-
| `novita-ai/moonshotai/kimi-k2.6` | 262K | | | | | | $0.
|
|
92
|
+
| `novita-ai/moonshotai/kimi-k2.6` | 262K | | | | | | $0.80 | $3 |
|
|
93
93
|
| `novita-ai/nousresearch/hermes-2-pro-llama-3-8b` | 8K | | | | | | $0.14 | $0.14 |
|
|
94
94
|
| `novita-ai/openai/gpt-oss-120b` | 131K | | | | | | $0.05 | $0.25 |
|
|
95
95
|
| `novita-ai/openai/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.15 |
|
|
@@ -106,7 +106,7 @@ for await (const chunk of stream) {
|
|
|
106
106
|
| `novita-ai/qwen/qwen3-4b-fp8` | 128K | | | | | | $0.03 | $0.03 |
|
|
107
107
|
| `novita-ai/qwen/qwen3-8b-fp8` | 128K | | | | | | $0.04 | $0.14 |
|
|
108
108
|
| `novita-ai/qwen/qwen3-coder-30b-a3b-instruct` | 160K | | | | | | $0.07 | $0.27 |
|
|
109
|
-
| `novita-ai/qwen/qwen3-coder-480b-a35b-instruct` | 262K | | | | | | $0.
|
|
109
|
+
| `novita-ai/qwen/qwen3-coder-480b-a35b-instruct` | 262K | | | | | | $0.38 | $2 |
|
|
110
110
|
| `novita-ai/qwen/qwen3-coder-next` | 262K | | | | | | $0.20 | $2 |
|
|
111
111
|
| `novita-ai/qwen/qwen3-max` | 262K | | | | | | $2 | $8 |
|
|
112
112
|
| `novita-ai/qwen/qwen3-next-80b-a3b-instruct` | 131K | | | | | | $0.15 | $2 |
|
|
@@ -129,7 +129,7 @@ for await (const chunk of stream) {
|
|
|
129
129
|
| `novita-ai/sao10K/l31-70b-euryale-v2.2` | 8K | | | | | | $1 | $1 |
|
|
130
130
|
| `novita-ai/xiaomimimo/mimo-v2-flash` | 262K | | | | | | $0.10 | $0.30 |
|
|
131
131
|
| `novita-ai/xiaomimimo/mimo-v2-pro` | 1.0M | | | | | | $2 | $6 |
|
|
132
|
-
| `novita-ai/xiaomimimo/mimo-v2.5-pro` | 1.0M | | | | | | $
|
|
132
|
+
| `novita-ai/xiaomimimo/mimo-v2.5-pro` | 1.0M | | | | | | $0.52 | $1 |
|
|
133
133
|
| `novita-ai/zai-org/autoglm-phone-9b-multilingual` | 66K | | | | | | $0.04 | $0.14 |
|
|
134
134
|
| `novita-ai/zai-org/glm-4.5` | 131K | | | | | | $0.60 | $2 |
|
|
135
135
|
| `novita-ai/zai-org/glm-4.5-air` | 131K | | | | | | $0.13 | $0.85 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# StepFun AI
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 8 StepFun AI models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [StepFun AI documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code).
|
|
8
8
|
|
|
@@ -17,7 +17,7 @@ const agent = new Agent({
|
|
|
17
17
|
id: "my-agent",
|
|
18
18
|
name: "My Agent",
|
|
19
19
|
instructions: "You are a helpful assistant",
|
|
20
|
-
model: "stepfun-ai/step-
|
|
20
|
+
model: "stepfun-ai/step-1-32k"
|
|
21
21
|
});
|
|
22
22
|
|
|
23
23
|
// Generate a response
|
|
@@ -36,8 +36,14 @@ for await (const chunk of stream) {
|
|
|
36
36
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `stepfun-ai/step-1-32k` | 33K | | | | | | $2 | $10 |
|
|
40
|
+
| `stepfun-ai/step-2-16k` | 16K | | | | | | $5 | $16 |
|
|
39
41
|
| `stepfun-ai/step-3.5-flash` | 256K | | | | | | $0.10 | $0.30 |
|
|
40
42
|
| `stepfun-ai/step-3.5-flash-2603` | 256K | | | | | | $0.10 | $0.30 |
|
|
43
|
+
| `stepfun-ai/step-3.7-flash` | 256K | | | | | | $0.20 | $1 |
|
|
44
|
+
| `stepfun-ai/step-tts-2` | — | | | | | | — | — |
|
|
45
|
+
| `stepfun-ai/stepaudio-2.5-asr` | — | | | | | | — | — |
|
|
46
|
+
| `stepfun-ai/stepaudio-2.5-tts` | — | | | | | | — | — |
|
|
41
47
|
|
|
42
48
|
## Advanced configuration
|
|
43
49
|
|
|
@@ -49,7 +55,7 @@ const agent = new Agent({
|
|
|
49
55
|
name: "custom-agent",
|
|
50
56
|
model: {
|
|
51
57
|
url: "https://api.stepfun.ai/step_plan/v1",
|
|
52
|
-
id: "stepfun-ai/step-
|
|
58
|
+
id: "stepfun-ai/step-1-32k",
|
|
53
59
|
apiKey: process.env.STEPFUN_API_KEY,
|
|
54
60
|
headers: {
|
|
55
61
|
"X-Custom-Header": "value"
|
|
@@ -67,8 +73,8 @@ const agent = new Agent({
|
|
|
67
73
|
model: ({ requestContext }) => {
|
|
68
74
|
const useAdvanced = requestContext.task === "complex";
|
|
69
75
|
return useAdvanced
|
|
70
|
-
? "stepfun-ai/
|
|
71
|
-
: "stepfun-ai/step-
|
|
76
|
+
? "stepfun-ai/stepaudio-2.5-tts"
|
|
77
|
+
: "stepfun-ai/step-1-32k";
|
|
72
78
|
}
|
|
73
79
|
});
|
|
74
80
|
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# StepFun
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 8 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept).
|
|
8
8
|
|
|
@@ -41,6 +41,9 @@ for await (const chunk of stream) {
|
|
|
41
41
|
| `stepfun/step-3.5-flash` | 256K | | | | | | $0.10 | $0.30 |
|
|
42
42
|
| `stepfun/step-3.5-flash-2603` | 256K | | | | | | $0.10 | $0.30 |
|
|
43
43
|
| `stepfun/step-3.7-flash` | 256K | | | | | | $0.20 | $1 |
|
|
44
|
+
| `stepfun/step-tts-2` | — | | | | | | — | — |
|
|
45
|
+
| `stepfun/stepaudio-2.5-asr` | — | | | | | | — | — |
|
|
46
|
+
| `stepfun/stepaudio-2.5-tts` | — | | | | | | — | — |
|
|
44
47
|
|
|
45
48
|
## Advanced configuration
|
|
46
49
|
|
|
@@ -70,7 +73,7 @@ const agent = new Agent({
|
|
|
70
73
|
model: ({ requestContext }) => {
|
|
71
74
|
const useAdvanced = requestContext.task === "complex";
|
|
72
75
|
return useAdvanced
|
|
73
|
-
? "stepfun/
|
|
76
|
+
? "stepfun/stepaudio-2.5-tts"
|
|
74
77
|
: "stepfun/step-1-32k";
|
|
75
78
|
}
|
|
76
79
|
});
|
|
@@ -40,7 +40,7 @@ for await (const chunk of stream) {
|
|
|
40
40
|
| `togetherai/google/gemma-3n-E4B-it` | 33K | | | | | | $0.06 | $0.12 |
|
|
41
41
|
| `togetherai/google/gemma-4-31B-it` | 262K | | | | | | $0.39 | $0.97 |
|
|
42
42
|
| `togetherai/LiquidAI/LFM2-24B-A2B` | 33K | | | | | | $0.03 | $0.12 |
|
|
43
|
-
| `togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo` | 131K | | | | | | $
|
|
43
|
+
| `togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo` | 131K | | | | | | $1 | $1 |
|
|
44
44
|
| `togetherai/meta-llama/Meta-Llama-3-8B-Instruct-Lite` | 8K | | | | | | $0.14 | $0.14 |
|
|
45
45
|
| `togetherai/MiniMaxAI/MiniMax-M2.7` | 203K | | | | | | $0.30 | $1 |
|
|
46
46
|
| `togetherai/MiniMaxAI/MiniMax-M3` | 524K | | | | | | $0.30 | $1 |
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
2
|
+
|
|
3
|
+
# TrustedRouter
|
|
4
|
+
|
|
5
|
+
Access 7 TrustedRouter models through Mastra's model router. Authentication is handled automatically using the `TRUSTEDROUTER_API_KEY` environment variable.
|
|
6
|
+
|
|
7
|
+
Learn more in the [TrustedRouter documentation](https://trustedrouter.com/docs).
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
TRUSTEDROUTER_API_KEY=your-api-key
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Agent } from "@mastra/core/agent";
|
|
15
|
+
|
|
16
|
+
const agent = new Agent({
|
|
17
|
+
id: "my-agent",
|
|
18
|
+
name: "My Agent",
|
|
19
|
+
instructions: "You are a helpful assistant",
|
|
20
|
+
model: "trustedrouter/auto"
|
|
21
|
+
});
|
|
22
|
+
|
|
23
|
+
// Generate a response
|
|
24
|
+
const response = await agent.generate("Hello!");
|
|
25
|
+
|
|
26
|
+
// Stream a response
|
|
27
|
+
const stream = await agent.stream("Tell me a story");
|
|
28
|
+
for await (const chunk of stream) {
|
|
29
|
+
console.log(chunk);
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [TrustedRouter documentation](https://trustedrouter.com/docs) for details.
|
|
34
|
+
|
|
35
|
+
## Models
|
|
36
|
+
|
|
37
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
|
+
| -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `trustedrouter/auto` | 1.0M | | | | | | — | — |
|
|
40
|
+
| `trustedrouter/cheap` | 1.0M | | | | | | — | — |
|
|
41
|
+
| `trustedrouter/e2e` | 1.0M | | | | | | — | — |
|
|
42
|
+
| `trustedrouter/fast` | 1.0M | | | | | | — | — |
|
|
43
|
+
| `trustedrouter/synth` | 1.0M | | | | | | — | — |
|
|
44
|
+
| `trustedrouter/synth-code` | 1.0M | | | | | | — | — |
|
|
45
|
+
| `trustedrouter/zdr` | 1.0M | | | | | | — | — |
|
|
46
|
+
|
|
47
|
+
## Advanced configuration
|
|
48
|
+
|
|
49
|
+
### Custom headers
|
|
50
|
+
|
|
51
|
+
```typescript
|
|
52
|
+
const agent = new Agent({
|
|
53
|
+
id: "custom-agent",
|
|
54
|
+
name: "custom-agent",
|
|
55
|
+
model: {
|
|
56
|
+
url: "https://api.trustedrouter.com/v1",
|
|
57
|
+
id: "trustedrouter/auto",
|
|
58
|
+
apiKey: process.env.TRUSTEDROUTER_API_KEY,
|
|
59
|
+
headers: {
|
|
60
|
+
"X-Custom-Header": "value"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
});
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Dynamic model selection
|
|
67
|
+
|
|
68
|
+
```typescript
|
|
69
|
+
const agent = new Agent({
|
|
70
|
+
id: "dynamic-agent",
|
|
71
|
+
name: "Dynamic Agent",
|
|
72
|
+
model: ({ requestContext }) => {
|
|
73
|
+
const useAdvanced = requestContext.task === "complex";
|
|
74
|
+
return useAdvanced
|
|
75
|
+
? "trustedrouter/zdr"
|
|
76
|
+
: "trustedrouter/auto";
|
|
77
|
+
}
|
|
78
|
+
});
|
|
79
|
+
```
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# ZenMux
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 114 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
|
|
8
8
|
|
|
@@ -49,6 +49,8 @@ for await (const chunk of stream) {
|
|
|
49
49
|
| `zenmux/anthropic/claude-sonnet-4` | 1.0M | | | | | | $3 | $15 |
|
|
50
50
|
| `zenmux/anthropic/claude-sonnet-4.5` | 1.0M | | | | | | $3 | $15 |
|
|
51
51
|
| `zenmux/anthropic/claude-sonnet-4.6` | 1.0M | | | | | | $3 | $15 |
|
|
52
|
+
| `zenmux/anthropic/claude-sonnet-5` | 1.0M | | | | | | $2 | $10 |
|
|
53
|
+
| `zenmux/anthropic/claude-sonnet-5-free` | 1.0M | | | | | | — | — |
|
|
52
54
|
| `zenmux/baidu/ernie-5.0-thinking-preview` | 128K | | | | | | $0.84 | $3 |
|
|
53
55
|
| `zenmux/deepseek/deepseek-chat` | 128K | | | | | | $0.28 | $0.42 |
|
|
54
56
|
| `zenmux/deepseek/deepseek-v3.2` | 128K | | | | | | $0.28 | $0.43 |
|
|
@@ -117,6 +117,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
117
117
|
- [The Grid AI](https://mastra.ai/models/providers/the-grid-ai)
|
|
118
118
|
- [Tinfoil](https://mastra.ai/models/providers/tinfoil)
|
|
119
119
|
- [Together AI](https://mastra.ai/models/providers/togetherai)
|
|
120
|
+
- [TrustedRouter](https://mastra.ai/models/providers/trustedrouter)
|
|
120
121
|
- [Umans AI](https://mastra.ai/models/providers/umans-ai)
|
|
121
122
|
- [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan)
|
|
122
123
|
- [Upstage](https://mastra.ai/models/providers/upstage)
|
|
@@ -46,7 +46,7 @@ then interact with elements using their refs (e.g., @e5).`,
|
|
|
46
46
|
|
|
47
47
|
**screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
|
|
48
48
|
|
|
49
|
-
**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset.
|
|
49
|
+
**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
|
|
50
50
|
|
|
51
51
|
**excludeTools** (`BrowserToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
|
|
52
52
|
|
|
@@ -63,7 +63,7 @@ Use stagehand_extract to get data from pages.`,
|
|
|
63
63
|
|
|
64
64
|
**screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
|
|
65
65
|
|
|
66
|
-
**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset.
|
|
66
|
+
**recording** (`BrowserRecordingOptions`): Alpha option for adding browser recording tools. Provide outputDir to add browser\_record and browser\_record\_caption to the toolset. You can also set maxDurationMs, maxWidth, and maxHeight as defaults for every recording.
|
|
67
67
|
|
|
68
68
|
**excludeTools** (`StagehandToolName[]`): Tool names to exclude from the browser toolset. Use this to disable specific tools for models that do not support certain capabilities, such as vision.
|
|
69
69
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Added in:** `@mastra/core@1.4.0`
|
|
6
6
|
|
|
7
|
-
Lists
|
|
7
|
+
Lists datasets with pagination and optional filters. Filters are applied at the storage layer, so callers don't need to post-filter results.
|
|
8
8
|
|
|
9
9
|
## Usage example
|
|
10
10
|
|
|
@@ -20,6 +20,18 @@ const { datasets, pagination } = await mastra.datasets.list({ page: 0, perPage:
|
|
|
20
20
|
for (const ds of datasets) {
|
|
21
21
|
console.log(`${ds.id}: ${ds.name} (v${ds.version})`)
|
|
22
22
|
}
|
|
23
|
+
|
|
24
|
+
// Filter by target type and name (case-insensitive substring)
|
|
25
|
+
const filtered = await mastra.datasets.list({
|
|
26
|
+
page: 0,
|
|
27
|
+
perPage: 20,
|
|
28
|
+
filters: { targetType: 'agent', name: 'qa' },
|
|
29
|
+
})
|
|
30
|
+
|
|
31
|
+
// Filter by any-overlap match on target IDs
|
|
32
|
+
const forAgents = await mastra.datasets.list({
|
|
33
|
+
filters: { targetIds: ['agent-a', 'agent-b'] },
|
|
34
|
+
})
|
|
23
35
|
```
|
|
24
36
|
|
|
25
37
|
## Parameters
|
|
@@ -28,6 +40,22 @@ for (const ds of datasets) {
|
|
|
28
40
|
|
|
29
41
|
**perPage** (`number`): Number of datasets per page. Defaults to \`20\`.
|
|
30
42
|
|
|
43
|
+
**filters** (`object`): Optional filters applied at the storage layer.
|
|
44
|
+
|
|
45
|
+
**filters.organizationId** (`string`): Tenancy filter: restrict to datasets in this organization.
|
|
46
|
+
|
|
47
|
+
**filters.projectId** (`string`): Tenancy filter: restrict to datasets in this project.
|
|
48
|
+
|
|
49
|
+
**filters.candidateKey** (`string`): Restrict to datasets belonging to this candidate key.
|
|
50
|
+
|
|
51
|
+
**filters.candidateId** (`string`): Restrict to datasets belonging to this candidate ID.
|
|
52
|
+
|
|
53
|
+
**filters.targetType** (`'agent' | 'workflow' | 'scorer' | 'processor'`): Restrict to datasets targeting this component type.
|
|
54
|
+
|
|
55
|
+
**filters.targetIds** (`string[]`): Restrict to datasets whose \`targetIds\` intersect this list (any-overlap match). Empty array is treated as no filter.
|
|
56
|
+
|
|
57
|
+
**filters.name** (`string`): Case-insensitive substring match on dataset \`name\`. Empty string is treated as no filter.
|
|
58
|
+
|
|
31
59
|
## Returns
|
|
32
60
|
|
|
33
61
|
**result** (`Promise<object>`): Paginated dataset list.
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Added in:** `@mastra/core@1.4.0`
|
|
6
6
|
|
|
7
|
-
Lists items in the dataset. When
|
|
7
|
+
Lists items in the dataset. When only `version` is provided, returns a bare `DatasetItem[]` snapshot of every item at that version. In all other cases — no arguments, or `search` / `page` / `perPage` provided with or without `version` — returns a paginated `{ items, pagination }` shape.
|
|
8
8
|
|
|
9
9
|
## Usage example
|
|
10
10
|
|
|
@@ -23,13 +23,17 @@ const result = await dataset.listItems()
|
|
|
23
23
|
// List with search
|
|
24
24
|
const filtered = await dataset.listItems({ search: 'TypeScript', page: 0, perPage: 10 })
|
|
25
25
|
|
|
26
|
-
//
|
|
26
|
+
// Paginated list scoped to a specific version
|
|
27
|
+
const versionedPage = await dataset.listItems({ version: 2, page: 0, perPage: 20 })
|
|
28
|
+
|
|
29
|
+
// Version-only snapshot returns a bare DatasetItem[] (deprecated form —
|
|
30
|
+
// prefer passing page/perPage to receive the paginated shape).
|
|
27
31
|
const versionedItems = await dataset.listItems({ version: 2 })
|
|
28
32
|
```
|
|
29
33
|
|
|
30
34
|
## Parameters
|
|
31
35
|
|
|
32
|
-
**version** (`number`): Dataset version to list items at. When
|
|
36
|
+
**version** (`number`): Dataset version to list items at. When passed on its own, returns every item at that version as a bare \`DatasetItem\[]\` snapshot. Passing \`search\` / \`page\` / \`perPage\` alongside \`version\` switches to the paginated shape.
|
|
33
37
|
|
|
34
38
|
**page** (`number`): Page number for pagination. Defaults to \`0\`.
|
|
35
39
|
|
|
@@ -39,11 +43,11 @@ const versionedItems = await dataset.listItems({ version: 2 })
|
|
|
39
43
|
|
|
40
44
|
## Returns
|
|
41
45
|
|
|
42
|
-
When `version` is
|
|
46
|
+
When only `version` is provided (no `search`, `page`, or `perPage`):
|
|
43
47
|
|
|
44
|
-
**result** (`Promise<DatasetItem[]>`):
|
|
48
|
+
**result** (`Promise<DatasetItem[]>`): Bare array of every item at the specified dataset version. This shape is retained for backwards compatibility and is deprecated — pass \`page\` / \`perPage\` (or \`search\`) to always receive the paginated shape below.
|
|
45
49
|
|
|
46
|
-
|
|
50
|
+
In all other cases (no arguments, or `search` / `page` / `perPage` provided with or without `version`):
|
|
47
51
|
|
|
48
52
|
**result** (`Promise<object>`): Paginated response.
|
|
49
53
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.2.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`700619b`](https://github.com/mastra-ai/mastra/commit/700619b61d572e592cbaaf758121d168844ca4d2), [`0f69865`](https://github.com/mastra-ai/mastra/commit/0f69865aced225d98eac812e22699dc445ee18cb), [`9250acd`](https://github.com/mastra-ai/mastra/commit/9250acd1357f0f1f33d0dcca16f9655084c58eca), [`0c3d4bc`](https://github.com/mastra-ai/mastra/commit/0c3d4bcae13ea3699d379403e6f350d5cf4efe9f), [`cc440a3`](https://github.com/mastra-ai/mastra/commit/cc440a39400d8ce06655462b26c1666a1b3d4320), [`6a61846`](https://github.com/mastra-ai/mastra/commit/6a61846eeda29fb714549b70f1bee2bf6b141c44), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`17369b2`](https://github.com/mastra-ai/mastra/commit/17369b25250561e9ed994ae509be1d15bfb33bcb), [`c64c2a8`](https://github.com/mastra-ai/mastra/commit/c64c2a8503a50252f9ca6b8e8c54cadee31b92a2), [`bcae929`](https://github.com/mastra-ai/mastra/commit/bcae929945cbf265bd9f327cc715ecafa072b5b9), [`ea6327b`](https://github.com/mastra-ai/mastra/commit/ea6327ba2d63ca647804bc97b347e03a58617162), [`3439fa8`](https://github.com/mastra-ai/mastra/commit/3439fa836ecfcaa257b40c20b30ac2a8be22e9ea), [`85107f2`](https://github.com/mastra-ai/mastra/commit/85107f2758b527147fccbedff962961927c2d3b8), [`b33822e`](https://github.com/mastra-ai/mastra/commit/b33822e8d470884954b02f7b0745407ee4ef74b1), [`06e2680`](https://github.com/mastra-ai/mastra/commit/06e26806b51d2cbd858afdc66daa2b86ff3ba64a), [`06ff9e0`](https://github.com/mastra-ai/mastra/commit/06ff9e0befd1d642ab87ff749285ee4091205c7e), [`d5c11e3`](https://github.com/mastra-ai/mastra/commit/d5c11e3ba5045969caa7272a7bd1fd141c93ab6c), [`7f5e1ff`](https://github.com/mastra-ai/mastra/commit/7f5e1ff695a92f672bb3976363925d1e9136b54a), [`ff80671`](https://github.com/mastra-ai/mastra/commit/ff8067185e208b27198b4e5b71803013175c3643), [`b8375c1`](https://github.com/mastra-ai/mastra/commit/b8375c1f8fe905df8ae2ae9a893bb365f17aec4e), [`dab1257`](https://github.com/mastra-ai/mastra/commit/dab1257b64e4ed576dc5038bb7a3f7072338bc9f), [`1240f05`](https://github.com/mastra-ai/mastra/commit/1240f051c8e5371f1c014448bf37b1a1b9a05e47), [`df25635`](https://github.com/mastra-ai/mastra/commit/df25635b954e63b5dbf8f1636af953b95c631809), [`9ab5faa`](https://github.com/mastra-ai/mastra/commit/9ab5faaff673ee9953ab4604cec217ee57875cd5), [`705ff39`](https://github.com/mastra-ai/mastra/commit/705ff3969e57214ff2fdaf3815d751dd558886ed), [`e6fbd5b`](https://github.com/mastra-ai/mastra/commit/e6fbd5bfdc28e92c0c0433f29aa1bc152d3430f6), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`6f2026c`](https://github.com/mastra-ai/mastra/commit/6f2026cdf114ff1e21e49133ca774ec7d5085059), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`003f35d`](https://github.com/mastra-ai/mastra/commit/003f35d19e07b23b4bacc591c8bc0c59b42124ae), [`f890eda`](https://github.com/mastra-ai/mastra/commit/f890eda2c8a2ae83d9b30bc6d85842f93b6c266b), [`1340fb7`](https://github.com/mastra-ai/mastra/commit/1340fb76262a3ca062130aa71859f07257a0a5a4)]:
|
|
8
|
+
- @mastra/core@1.49.0
|
|
9
|
+
- @mastra/mcp@1.13.0
|
|
10
|
+
|
|
11
|
+
## 1.2.4-alpha.9
|
|
12
|
+
|
|
13
|
+
### Patch Changes
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`9250acd`](https://github.com/mastra-ai/mastra/commit/9250acd1357f0f1f33d0dcca16f9655084c58eca), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`c64c2a8`](https://github.com/mastra-ai/mastra/commit/c64c2a8503a50252f9ca6b8e8c54cadee31b92a2), [`06e2680`](https://github.com/mastra-ai/mastra/commit/06e26806b51d2cbd858afdc66daa2b86ff3ba64a), [`1240f05`](https://github.com/mastra-ai/mastra/commit/1240f051c8e5371f1c014448bf37b1a1b9a05e47), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`24c10d3`](https://github.com/mastra-ai/mastra/commit/24c10d333e6649ac06075903aeeee13a933db3b3), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748), [`215f9b0`](https://github.com/mastra-ai/mastra/commit/215f9b0f3f3f6fc165edad360582dd4d3d7ea748)]:
|
|
16
|
+
- @mastra/core@1.49.0-alpha.5
|
|
17
|
+
|
|
3
18
|
## 1.2.4-alpha.7
|
|
4
19
|
|
|
5
20
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.2.4
|
|
3
|
+
"version": "1.2.4",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -28,8 +28,8 @@
|
|
|
28
28
|
"jsdom": "^26.1.0",
|
|
29
29
|
"local-pkg": "^1.1.2",
|
|
30
30
|
"zod": "^4.4.3",
|
|
31
|
-
"@mastra/core": "1.49.0
|
|
32
|
-
"@mastra/mcp": "^1.13.0
|
|
31
|
+
"@mastra/core": "1.49.0",
|
|
32
|
+
"@mastra/mcp": "^1.13.0"
|
|
33
33
|
},
|
|
34
34
|
"devDependencies": {
|
|
35
35
|
"@hono/node-server": "^1.19.11",
|
|
@@ -45,9 +45,9 @@
|
|
|
45
45
|
"tsx": "^4.22.4",
|
|
46
46
|
"typescript": "^6.0.3",
|
|
47
47
|
"vitest": "4.1.8",
|
|
48
|
-
"@internal/lint": "0.0.
|
|
49
|
-
"@internal/types-builder": "0.0.
|
|
50
|
-
"@mastra/core": "1.49.0
|
|
48
|
+
"@internal/lint": "0.0.111",
|
|
49
|
+
"@internal/types-builder": "0.0.86",
|
|
50
|
+
"@mastra/core": "1.49.0"
|
|
51
51
|
},
|
|
52
52
|
"homepage": "https://mastra.ai",
|
|
53
53
|
"repository": {
|