@mastra/mcp-docs-server 1.2.23-alpha.3 → 1.2.23-alpha.5
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/auth/fga.md +15 -15
- package/.docs/docs/evals/custom-scorers.md +2 -3
- package/.docs/docs/evals/overview.md +9 -9
- package/.docs/docs/memory/semantic-recall.md +0 -2
- package/.docs/docs/observability/feedback.md +1 -1
- package/.docs/docs/observability/integrations/exporters/mastra-storage.md +1 -1
- package/.docs/docs/observability/metrics/overview.md +1 -1
- package/.docs/docs/observability/overview.md +13 -11
- package/.docs/docs/observability/tracing/overview.md +12 -12
- package/.docs/docs/studio/observability.md +2 -2
- package/.docs/docs/workflows/agents-and-tools.md +0 -4
- package/.docs/docs/workflows/control-flow.md +0 -2
- package/.docs/models/gateways/netlify.md +2 -1
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/crossmodel.md +2 -1
- package/.docs/models/providers/empiriolabs.md +1 -2
- package/.docs/models/providers/kilo.md +2 -2
- package/.docs/models/providers/nano-gpt.md +2 -1
- package/.docs/reference/observability/tracing/configuration.md +2 -2
- package/.docs/reference/workflows/workflow-methods/agent.md +4 -4
- package/.docs/reference/workflows/workflow-methods/tool.md +2 -2
- package/CHANGELOG.md +7 -0
- package/package.json +4 -4
package/.docs/docs/auth/fga.md
CHANGED
|
@@ -22,9 +22,9 @@ FGA is designed for multi-tenant B2B products where permissions are contextual:
|
|
|
22
22
|
Configure FGA in your Mastra server config alongside authentication and RBAC:
|
|
23
23
|
|
|
24
24
|
```typescript
|
|
25
|
-
import { Mastra } from '@mastra/core/mastra'
|
|
26
|
-
import { MastraFGAPermissions } from '@mastra/core/auth/ee'
|
|
27
|
-
import { MastraAuthWorkos, MastraFGAWorkos } from '@mastra/auth-workos'
|
|
25
|
+
import { Mastra } from '@mastra/core/mastra'
|
|
26
|
+
import { MastraFGAPermissions } from '@mastra/core/auth/ee'
|
|
27
|
+
import { MastraAuthWorkos, MastraFGAWorkos } from '@mastra/auth-workos'
|
|
28
28
|
|
|
29
29
|
const mastra = new Mastra({
|
|
30
30
|
server: {
|
|
@@ -35,8 +35,8 @@ const mastra = new Mastra({
|
|
|
35
35
|
}),
|
|
36
36
|
fga: new MastraFGAWorkos({
|
|
37
37
|
resourceMapping: {
|
|
38
|
-
agent: { fgaResourceType: 'team', deriveId:
|
|
39
|
-
workflow: { fgaResourceType: 'team', deriveId:
|
|
38
|
+
agent: { fgaResourceType: 'team', deriveId: ctx => ctx.user.teamId },
|
|
39
|
+
workflow: { fgaResourceType: 'team', deriveId: ctx => ctx.user.teamId },
|
|
40
40
|
thread: { fgaResourceType: 'workspace-thread', deriveId: ({ resourceId }) => resourceId },
|
|
41
41
|
},
|
|
42
42
|
permissionMapping: {
|
|
@@ -50,7 +50,7 @@ const mastra = new Mastra({
|
|
|
50
50
|
scope: true,
|
|
51
51
|
},
|
|
52
52
|
},
|
|
53
|
-
})
|
|
53
|
+
})
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
When using `MastraFGAWorkos`, set `fetchMemberships: true` on `MastraAuthWorkos`. WorkOS FGA checks need the user's organization memberships to resolve the correct membership ID for authorization.
|
|
@@ -117,7 +117,7 @@ const mastra = new Mastra({
|
|
|
117
117
|
scope: true,
|
|
118
118
|
},
|
|
119
119
|
},
|
|
120
|
-
})
|
|
120
|
+
})
|
|
121
121
|
```
|
|
122
122
|
|
|
123
123
|
With `scope: true`, Mastra reads `MASTRA_RESOURCE_ID_KEY` from the request context. `mapUserToResourceId()` sets this value after authentication. Stored resource handlers persist the scope in record metadata and filter list, read, update, publish, and delete operations by that scope.
|
|
@@ -155,7 +155,7 @@ const fga = new MastraFGAWorkos({
|
|
|
155
155
|
validatePermissions: async permissions => {
|
|
156
156
|
// Throw if a Mastra permission is missing from permissionMapping.
|
|
157
157
|
},
|
|
158
|
-
})
|
|
158
|
+
})
|
|
159
159
|
```
|
|
160
160
|
|
|
161
161
|
Set `auditProtectedRoutes: 'error'` to fail startup when protected routes are missing built-in FGA metadata. If `requireForProtectedRoutes` is enabled, Mastra logs this audit as a warning by default.
|
|
@@ -163,7 +163,7 @@ Set `auditProtectedRoutes: 'error'` to fail startup when protected routes are mi
|
|
|
163
163
|
For custom routes, prefer route-level `fga` metadata. This keeps authorization policy next to the route:
|
|
164
164
|
|
|
165
165
|
```typescript
|
|
166
|
-
import { createRoute } from '@mastra/server/server-adapter'
|
|
166
|
+
import { createRoute } from '@mastra/server/server-adapter'
|
|
167
167
|
|
|
168
168
|
export const getProjectRoute = createRoute({
|
|
169
169
|
method: 'GET',
|
|
@@ -176,15 +176,15 @@ export const getProjectRoute = createRoute({
|
|
|
176
176
|
permission: 'projects:read',
|
|
177
177
|
},
|
|
178
178
|
handler: async () => {
|
|
179
|
-
return { project: null }
|
|
179
|
+
return { project: null }
|
|
180
180
|
},
|
|
181
|
-
})
|
|
181
|
+
})
|
|
182
182
|
```
|
|
183
183
|
|
|
184
184
|
Use `resolveRouteFGA()` only when route metadata must be derived centrally from route, params, or request context. A route map scales better than string-prefix checks:
|
|
185
185
|
|
|
186
186
|
```typescript
|
|
187
|
-
import type { FGARouteConfig, FGARouteResolver } from '@mastra/core/auth/ee'
|
|
187
|
+
import type { FGARouteConfig, FGARouteResolver } from '@mastra/core/auth/ee'
|
|
188
188
|
|
|
189
189
|
const routeFGA = {
|
|
190
190
|
'GET /billing/:accountId': {
|
|
@@ -192,14 +192,14 @@ const routeFGA = {
|
|
|
192
192
|
resourceIdParam: 'accountId',
|
|
193
193
|
permission: 'billing:read',
|
|
194
194
|
},
|
|
195
|
-
} satisfies Record<string, FGARouteConfig
|
|
195
|
+
} satisfies Record<string, FGARouteConfig>
|
|
196
196
|
|
|
197
|
-
const resolveRouteFGA: FGARouteResolver = ({ route }) => routeFGA[`${route.method} ${route.path}`]
|
|
197
|
+
const resolveRouteFGA: FGARouteResolver = ({ route }) => routeFGA[`${route.method} ${route.path}`]
|
|
198
198
|
|
|
199
199
|
const fga = new MastraFGAWorkos({
|
|
200
200
|
/* ... */
|
|
201
201
|
resolveRouteFGA,
|
|
202
|
-
})
|
|
202
|
+
})
|
|
203
203
|
```
|
|
204
204
|
|
|
205
205
|
## Enforcement points
|
|
@@ -319,13 +319,12 @@ const customScorer = createScorer({
|
|
|
319
319
|
id: 'recent-output',
|
|
320
320
|
description: 'Scores only the last response',
|
|
321
321
|
type: 'agent',
|
|
322
|
-
prepareRun:
|
|
322
|
+
prepareRun: run => ({
|
|
323
323
|
...run,
|
|
324
324
|
output: run.output.slice(-1), // Keep only the last message
|
|
325
325
|
requestContext: undefined,
|
|
326
326
|
}),
|
|
327
|
-
})
|
|
328
|
-
.generateScore(({ run }) => {
|
|
327
|
+
}).generateScore(({ run }) => {
|
|
329
328
|
return run.output.length > 0 ? 1 : 0
|
|
330
329
|
})
|
|
331
330
|
```
|
|
@@ -80,35 +80,35 @@ export const evaluatedAgent = new Agent({
|
|
|
80
80
|
You can also add scorers to individual workflow steps to evaluate outputs at specific points in your process. Each scorer receives that step's own input and output, so you can measure quality at each step instead of only scoring the final answer:
|
|
81
81
|
|
|
82
82
|
```typescript
|
|
83
|
-
import { createWorkflow, createStep } from
|
|
84
|
-
import { z } from
|
|
85
|
-
import { customStepScorer } from
|
|
83
|
+
import { createWorkflow, createStep } from '@mastra/core/workflows'
|
|
84
|
+
import { z } from 'zod'
|
|
85
|
+
import { customStepScorer } from '../scorers/custom-step-scorer'
|
|
86
86
|
|
|
87
87
|
const contentStep = createStep({
|
|
88
|
-
id:
|
|
88
|
+
id: 'content-step',
|
|
89
89
|
inputSchema: z.object({ topic: z.string() }),
|
|
90
90
|
outputSchema: z.object({ content: z.string() }),
|
|
91
91
|
scorers: {
|
|
92
92
|
customStepScorer: {
|
|
93
93
|
scorer: customStepScorer(),
|
|
94
94
|
sampling: {
|
|
95
|
-
type:
|
|
95
|
+
type: 'ratio',
|
|
96
96
|
rate: 1, // Score every step execution
|
|
97
97
|
},
|
|
98
98
|
},
|
|
99
99
|
},
|
|
100
100
|
execute: async ({ inputData }) => {
|
|
101
|
-
return { content: await generateContent(inputData.topic) }
|
|
101
|
+
return { content: await generateContent(inputData.topic) }
|
|
102
102
|
},
|
|
103
|
-
})
|
|
103
|
+
})
|
|
104
104
|
|
|
105
105
|
export const contentWorkflow = createWorkflow({
|
|
106
|
-
id:
|
|
106
|
+
id: 'content-workflow',
|
|
107
107
|
inputSchema: z.object({ topic: z.string() }),
|
|
108
108
|
outputSchema: z.object({ content: z.string() }),
|
|
109
109
|
})
|
|
110
110
|
.then(contentStep)
|
|
111
|
-
.commit()
|
|
111
|
+
.commit()
|
|
112
112
|
```
|
|
113
113
|
|
|
114
114
|
For the step-level `scorers` API, see the [Step class reference](https://mastra.ai/reference/workflows/step).
|
|
@@ -14,8 +14,6 @@ Semantic recall is RAG-based search that helps agents maintain context across lo
|
|
|
14
14
|
|
|
15
15
|
It uses vector embeddings of messages for similarity search and integrates with vector stores, plus has configurable context windows around retrieved messages.
|
|
16
16
|
|
|
17
|
-

|
|
18
|
-
|
|
19
17
|
When it's enabled, new messages are used to query a vector DB for semantically similar messages.
|
|
20
18
|
|
|
21
19
|
After getting a response from the LLM, all new messages (user, assistant, and tool calls/results) are inserted into the vector DB to be recalled in later interactions.
|
|
@@ -166,7 +166,7 @@ Feedback flows through the observability event bus, so exporters that support fe
|
|
|
166
166
|
## Related
|
|
167
167
|
|
|
168
168
|
- [Observability overview](https://mastra.ai/docs/observability/overview)
|
|
169
|
-
- [
|
|
169
|
+
- [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
|
|
170
170
|
- [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
|
|
171
171
|
- [Client SDK observability reference](https://mastra.ai/reference/client-js/observability)
|
|
172
172
|
- [Feedback reference](https://mastra.ai/reference/observability/feedback)
|
|
@@ -248,7 +248,7 @@ new MastraStorageExporter({
|
|
|
248
248
|
|
|
249
249
|
## Related
|
|
250
250
|
|
|
251
|
-
- [
|
|
251
|
+
- [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
|
|
252
252
|
- [MastraPlatformExporter](https://mastra.ai/docs/mastra-platform/observability)
|
|
253
253
|
- [Composite Storage](https://mastra.ai/reference/storage/composite): Combine multiple storage providers
|
|
254
254
|
- [Storage Configuration](https://mastra.ai/docs/storage)
|
|
@@ -104,5 +104,5 @@ In production, always include a timestamp range in metric queries. Time bounds l
|
|
|
104
104
|
## Related
|
|
105
105
|
|
|
106
106
|
- [Observability overview](https://mastra.ai/docs/observability/overview)
|
|
107
|
-
- [
|
|
107
|
+
- [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
|
|
108
108
|
- [MastraStorageExporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)
|
|
@@ -4,14 +4,16 @@
|
|
|
4
4
|
|
|
5
5
|
# Observability
|
|
6
6
|
|
|
7
|
-
Mastra's observability system gives you visibility into every agent run, workflow step, tool call, and model interaction. Agent behavior depends on model responses, prompts, tools, memory, and workflow state, so observability helps you inspect runtime decisions from day one.
|
|
7
|
+
Mastra's observability system gives you visibility into every agent run, workflow step, tool call, and model interaction. Agent behavior depends on model responses, prompts, tools, memory, and workflow state, so observability helps you inspect runtime decisions from day one.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
- [**
|
|
12
|
-
- [**Logging**](https://mastra.ai/docs/observability/logging):
|
|
13
|
-
- [**
|
|
14
|
-
- [**
|
|
9
|
+
Start with the trace-correlated pages:
|
|
10
|
+
|
|
11
|
+
- [**Usage**](https://mastra.ai/docs/observability/tracing/overview): Inspect the span hierarchy, inputs, outputs, token usage, timing, and trace context for an execution.
|
|
12
|
+
- [**Logging**](https://mastra.ai/docs/observability/logging): Forward structured log entries from your application and Mastra internals, correlated to traces automatically.
|
|
13
|
+
- [**Feedback**](https://mastra.ai/docs/observability/feedback): Store ratings, comments, corrections, and other review signals linked to traces and spans.
|
|
14
|
+
- [**Storage**](#storage): Choose backends for persisted traces, logs, metrics aggregation, and feedback queries.
|
|
15
|
+
|
|
16
|
+
Use [**Metrics**](https://mastra.ai/docs/observability/metrics/overview) to analyze aggregate usage, performance, and cost data derived from spans. No additional instrumentation is required. Use [**Configuration**](#configuration) to enable the signals and exporters your application needs.
|
|
15
17
|
|
|
16
18
|
## When to use observability
|
|
17
19
|
|
|
@@ -23,15 +25,15 @@ Mastra's observability system gives you visibility into every agent run, workflo
|
|
|
23
25
|
|
|
24
26
|
## How the pieces fit together
|
|
25
27
|
|
|
26
|
-
|
|
28
|
+
When observability is configured, every agent run, workflow execution, tool call, and model interaction produces a [span](https://opentelemetry.io/docs/concepts/signals/traces/#spans). Mastra organizes related spans into traces that show the full request lifecycle as a hierarchical timeline.
|
|
27
29
|
|
|
28
|
-
|
|
30
|
+
When a span ends, Mastra extracts duration, token counts, and cost estimates without any extra code. These metrics power the aggregate dashboards in [Studio](https://mastra.ai/docs/studio/observability).
|
|
29
31
|
|
|
30
|
-
|
|
32
|
+
Every `logger.info()`, `logger.warn()`, or `logger.error()` call within a traced context is tagged with the current trace and span IDs. You can move from a log entry directly to the trace that produced it.
|
|
31
33
|
|
|
32
34
|
Feedback records human review signals such as ratings, comments, and corrections. Feedback can be linked to traces and spans, then queried with the same observability store used for metrics.
|
|
33
35
|
|
|
34
|
-
These
|
|
36
|
+
These records share correlation fields such as trace ID, span ID, entity type, and entity name. You can use them to move from a metric spike to its traces, logs, and related feedback.
|
|
35
37
|
|
|
36
38
|
## Quickstart
|
|
37
39
|
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
|
|
4
4
|
|
|
5
|
-
#
|
|
5
|
+
# Usage
|
|
6
6
|
|
|
7
7
|
Tracing is the observability signal that records how a request moves through agents, workflows, tools, and model calls. Mastra represents each operation as a span and groups related spans into a trace so you can inspect the full execution path.
|
|
8
8
|
|
|
@@ -660,8 +660,8 @@ export const mastra = new Mastra({
|
|
|
660
660
|
default: {
|
|
661
661
|
serviceName: 'my-service',
|
|
662
662
|
serializationOptions: {
|
|
663
|
-
maxStringLength: 2048, // Maximum length for string values (default:
|
|
664
|
-
maxDepth: 10, // Maximum depth for nested objects (default:
|
|
663
|
+
maxStringLength: 2048, // Maximum length for string values (default: 131072)
|
|
664
|
+
maxDepth: 10, // Maximum depth for nested objects (default: 8)
|
|
665
665
|
maxArrayLength: 100, // Maximum number of items in arrays (default: 50)
|
|
666
666
|
maxObjectKeys: 75, // Maximum number of keys in objects (default: 50)
|
|
667
667
|
},
|
|
@@ -674,12 +674,12 @@ export const mastra = new Mastra({
|
|
|
674
674
|
|
|
675
675
|
### Available options
|
|
676
676
|
|
|
677
|
-
| Option | Default
|
|
678
|
-
| ----------------- |
|
|
679
|
-
| `maxStringLength` |
|
|
680
|
-
| `maxDepth` |
|
|
681
|
-
| `maxArrayLength` | 50
|
|
682
|
-
| `maxObjectKeys` | 50
|
|
677
|
+
| Option | Default | Description |
|
|
678
|
+
| ----------------- | --------------- | ---------------------------------------------------------------- |
|
|
679
|
+
| `maxStringLength` | 131072 (128 KB) | Maximum length for string values. Longer strings are truncated. |
|
|
680
|
+
| `maxDepth` | 8 | Maximum depth for nested objects. Deeper levels are omitted. |
|
|
681
|
+
| `maxArrayLength` | 50 | Maximum number of items in arrays. Additional items are omitted. |
|
|
682
|
+
| `maxObjectKeys` | 50 | Maximum number of keys in objects. Additional keys are omitted. |
|
|
683
683
|
|
|
684
684
|
### Use cases
|
|
685
685
|
|
|
@@ -687,9 +687,9 @@ export const mastra = new Mastra({
|
|
|
687
687
|
|
|
688
688
|
```ts
|
|
689
689
|
serializationOptions: {
|
|
690
|
-
maxStringLength:
|
|
691
|
-
maxDepth: 12,
|
|
692
|
-
maxArrayLength: 200,
|
|
690
|
+
maxStringLength: 262144, // Capture longer text content (256 KB)
|
|
691
|
+
maxDepth: 12, // Handle deeply nested JSON responses
|
|
692
|
+
maxArrayLength: 200, // Keep more items from large lists
|
|
693
693
|
}
|
|
694
694
|
```
|
|
695
695
|
|
|
@@ -102,7 +102,7 @@ Above the trace list, open **Columns** to show or hide input, entity, duration,
|
|
|
102
102
|
|
|
103
103
|
Token and estimated cost columns require an observability store that supports metrics. These columns stay hidden in the **Branches** view because several branch rows can belong to the same trace.
|
|
104
104
|
|
|
105
|
-
Tracing filters out low-level framework details so your traces stay focused and readable. Visit
|
|
105
|
+
Tracing filters out low-level framework details so your traces stay focused and readable. Visit [Traces usage](https://mastra.ai/docs/observability/tracing/overview) for more details.
|
|
106
106
|
|
|
107
107
|
To export a trace, select **Download trace JSON** in the trace panel header. This saves the entire trace as a `trace-<id>.json` file, with every span and its full input, output, metadata, and attributes. Use it to share a trace or attach it to a bug report, or alternatively build an evaluation dataset offline.
|
|
108
108
|
|
|
@@ -116,6 +116,6 @@ Log forwarding is enabled by default when you configure observability. See [logg
|
|
|
116
116
|
|
|
117
117
|
- [Observability overview](https://mastra.ai/docs/observability/overview)
|
|
118
118
|
- [Metrics overview](https://mastra.ai/docs/observability/metrics/overview)
|
|
119
|
-
- [
|
|
119
|
+
- [Traces usage](https://mastra.ai/docs/observability/tracing/overview)
|
|
120
120
|
- [Logging](https://mastra.ai/docs/observability/logging)
|
|
121
121
|
- [Mastra platform observability](https://mastra.ai/docs/mastra-platform/observability)
|
|
@@ -41,8 +41,6 @@ const step1 = createStep({
|
|
|
41
41
|
|
|
42
42
|
Compose an agent as a step using `createStep()` when you don't need to modify the agent call. Use `.map()` to transform the previous step's output into a `prompt` the agent can use.
|
|
43
43
|
|
|
44
|
-

|
|
45
|
-
|
|
46
44
|
```typescript
|
|
47
45
|
import { testAgent } from '../agents/test-agent'
|
|
48
46
|
const step1 = createStep(testAgent)
|
|
@@ -155,8 +153,6 @@ const step2 = createStep({
|
|
|
155
153
|
|
|
156
154
|
Compose a tool as a step using `createStep()` when the previous step's output matches the tool's input context. You can use `.map()` to transform the previous step's output if they don't.
|
|
157
155
|
|
|
158
|
-

|
|
159
|
-
|
|
160
156
|
```typescript
|
|
161
157
|
import { testTool } from '../tools/test-tool'
|
|
162
158
|
|
|
@@ -212,8 +212,6 @@ Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand wh
|
|
|
212
212
|
|
|
213
213
|
Use `.branch()` to choose which step to run based on a condition. All steps in a branch need the same `inputSchema` and `outputSchema` because branching requires consistent schemas so workflows can follow different paths.
|
|
214
214
|
|
|
215
|
-

|
|
216
|
-
|
|
217
215
|
```typescript
|
|
218
216
|
const step1 = createStep({...})
|
|
219
217
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# Netlify
|
|
6
6
|
|
|
7
|
-
Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access
|
|
7
|
+
Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 234 models through Mastra's model router.
|
|
8
8
|
|
|
9
9
|
Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
|
|
10
10
|
|
|
@@ -132,6 +132,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
132
132
|
| `openrouter/deepseek/deepseek-v3.2-exp` |
|
|
133
133
|
| `openrouter/deepseek/deepseek-v4-flash` |
|
|
134
134
|
| `openrouter/deepseek/deepseek-v4-flash-0731` |
|
|
135
|
+
| `openrouter/deepseek/deepseek-v4-flash-vision-exp` |
|
|
135
136
|
| `openrouter/deepseek/deepseek-v4-pro` |
|
|
136
137
|
| `openrouter/deepseek/deepseek-v4-pro-0813` |
|
|
137
138
|
| `openrouter/google/gemma-2-27b-it` |
|
package/.docs/models/index.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# Model Providers
|
|
6
6
|
|
|
7
|
-
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to
|
|
7
|
+
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 7046 models from 199 providers through a single API.
|
|
8
8
|
|
|
9
9
|
## Features
|
|
10
10
|
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# CrossModel
|
|
6
6
|
|
|
7
|
-
Access
|
|
7
|
+
Access 56 CrossModel models through Mastra's model router. Authentication is handled automatically using the `CROSSMODEL_API_KEY` environment variable.
|
|
8
8
|
|
|
9
9
|
Learn more in the [CrossModel documentation](https://www.crossmodel.ai/docs).
|
|
10
10
|
|
|
@@ -80,6 +80,7 @@ for await (const chunk of stream) {
|
|
|
80
80
|
| `crossmodel/qwen/qwen3.8-flash` | 1.0M | | | | | | $0.13 | $0.43 |
|
|
81
81
|
| `crossmodel/qwen/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
|
|
82
82
|
| `crossmodel/tencent/hy3` | 262K | | | | | | $0.16 | $0.64 |
|
|
83
|
+
| `crossmodel/tencent/hy4-preview` | 1.0M | | | | | | $0.96 | $3 |
|
|
83
84
|
| `crossmodel/x-ai/grok-4.3` | 1.0M | | | | | | $1 | $3 |
|
|
84
85
|
| `crossmodel/x-ai/grok-4.5` | 500K | | | | | | $2 | $6 |
|
|
85
86
|
| `crossmodel/x-ai/grok-4.6` | 500K | | | | | | $2 | $6 |
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# EmpirioLabs AI
|
|
6
6
|
|
|
7
|
-
Access
|
|
7
|
+
Access 56 EmpirioLabs AI models through Mastra's model router. Authentication is handled automatically using the `EMPIRIOLABS_API_KEY` environment variable.
|
|
8
8
|
|
|
9
9
|
Learn more in the [EmpirioLabs AI documentation](https://docs.empiriolabs.ai).
|
|
10
10
|
|
|
@@ -62,7 +62,6 @@ for await (const chunk of stream) {
|
|
|
62
62
|
| `empiriolabs/minimax-m2-7` | 200K | | | | | | $0.15 | $0.60 |
|
|
63
63
|
| `empiriolabs/minimax-m2-7-highspeed` | 200K | | | | | | $0.30 | $1 |
|
|
64
64
|
| `empiriolabs/minimax-m3` | 1.0M | | | | | | $0.23 | $0.90 |
|
|
65
|
-
| `empiriolabs/mistral-medium-3` | 130K | | | | | | — | — |
|
|
66
65
|
| `empiriolabs/mistral-small-4` | 256K | | | | | | $0.15 | $0.60 |
|
|
67
66
|
| `empiriolabs/muse-glimmer-30b` | 131K | | | | | | $0.20 | $0.80 |
|
|
68
67
|
| `empiriolabs/muse-spark-1-1` | 1.0M | | | | | | $1 | $4 |
|
|
@@ -158,7 +158,7 @@ for await (const chunk of stream) {
|
|
|
158
158
|
| `kilo/meta-llama/llama-3.2-1b-instruct` | 60K | | | | | | $0.03 | $0.20 |
|
|
159
159
|
| `kilo/meta-llama/llama-3.2-3b-instruct` | 131K | | | | | | $0.05 | $0.33 |
|
|
160
160
|
| `kilo/meta-llama/llama-3.3-70b-instruct` | 128K | | | | | | $0.10 | $0.32 |
|
|
161
|
-
| `kilo/meta-llama/llama-4-maverick` |
|
|
161
|
+
| `kilo/meta-llama/llama-4-maverick` | 128K | | | | | | $0.20 | $0.70 |
|
|
162
162
|
| `kilo/meta-llama/llama-4-scout` | 131K | | | | | | $0.10 | $0.30 |
|
|
163
163
|
| `kilo/meta-llama/llama-guard-4-12b` | 164K | | | | | | $0.18 | $0.18 |
|
|
164
164
|
| `kilo/meta/muse-glimmer-30b` | 131K | | | | | | $0.30 | $1 |
|
|
@@ -365,7 +365,7 @@ for await (const chunk of stream) {
|
|
|
365
365
|
| `kilo/tencent/hy-mt2-1.8b` | 8K | | | | | | $0.04 | $0.18 |
|
|
366
366
|
| `kilo/tencent/hy-mt2-30b-a3b` | 8K | | | | | | $0.07 | $0.29 |
|
|
367
367
|
| `kilo/tencent/hy-mt2-7b` | 8K | | | | | | $0.07 | $0.29 |
|
|
368
|
-
| `kilo/tencent/hy3` | 262K | | | | | | $0.
|
|
368
|
+
| `kilo/tencent/hy3` | 262K | | | | | | $0.14 | $0.58 |
|
|
369
369
|
| `kilo/tencent/hy3-preview` | 262K | | | | | | $0.18 | $0.60 |
|
|
370
370
|
| `kilo/tencent/hy3:free` | 262K | | | | | | — | — |
|
|
371
371
|
| `kilo/tencent/hy4-preview` | 1.0M | | | | | | $0.83 | $3 |
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# NanoGPT
|
|
6
6
|
|
|
7
|
-
Access
|
|
7
|
+
Access 606 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
|
|
8
8
|
|
|
9
9
|
Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
|
|
10
10
|
|
|
@@ -544,6 +544,7 @@ for await (const chunk of stream) {
|
|
|
544
544
|
| `nano-gpt/TEE/glm-5.1-thinking` | 203K | | | | | | $2 | $5 |
|
|
545
545
|
| `nano-gpt/TEE/glm-5.2` | 1.0M | | | | | | $1 | $5 |
|
|
546
546
|
| `nano-gpt/TEE/glm-5.2:thinking` | 1.0M | | | | | | $1 | $5 |
|
|
547
|
+
| `nano-gpt/TEE/glm-5.3` | 1.0M | | | | | | $1 | $4 |
|
|
547
548
|
| `nano-gpt/TEE/glm-5.3-flash` | 1.0M | | | | | | $0.15 | $0.50 |
|
|
548
549
|
| `nano-gpt/TEE/gpt-oss-120b` | 131K | | | | | | $2 | $2 |
|
|
549
550
|
| `nano-gpt/TEE/gpt-oss-20b` | 131K | | | | | | $0.20 | $0.80 |
|
|
@@ -61,9 +61,9 @@ interface ObservabilityInstanceConfig {
|
|
|
61
61
|
|
|
62
62
|
**serializationOptions** (`SerializationOptions`): Options for controlling serialization of span data (input/output/attributes)
|
|
63
63
|
|
|
64
|
-
**serializationOptions.maxStringLength** (`number`): Maximum length for string values (default:
|
|
64
|
+
**serializationOptions.maxStringLength** (`number`): Maximum length for string values (default: 131072)
|
|
65
65
|
|
|
66
|
-
**serializationOptions.maxDepth** (`number`): Maximum depth for nested objects (default:
|
|
66
|
+
**serializationOptions.maxDepth** (`number`): Maximum depth for nested objects (default: 8)
|
|
67
67
|
|
|
68
68
|
**serializationOptions.maxArrayLength** (`number`): Maximum number of items in arrays (default: 50)
|
|
69
69
|
|
|
@@ -12,9 +12,9 @@ Unlike wrapping an agent with `createStep()`, `.agent()` records a declarative e
|
|
|
12
12
|
|
|
13
13
|
```typescript
|
|
14
14
|
workflow
|
|
15
|
-
.map({ prompt: mapVariable({ initData: workflow, path:
|
|
15
|
+
.map({ prompt: mapVariable({ initData: workflow, path: 'topic' }) })
|
|
16
16
|
.agent(testAgent)
|
|
17
|
-
.commit()
|
|
17
|
+
.commit()
|
|
18
18
|
```
|
|
19
19
|
|
|
20
20
|
## Parameters
|
|
@@ -42,7 +42,7 @@ workflow
|
|
|
42
42
|
}),
|
|
43
43
|
},
|
|
44
44
|
})
|
|
45
|
-
.commit()
|
|
45
|
+
.commit()
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
## Referencing an agent by ID
|
|
@@ -50,7 +50,7 @@ workflow
|
|
|
50
50
|
Pass a string to reference a registered agent without importing it. The agent must be registered on the Mastra instance when the workflow runs:
|
|
51
51
|
|
|
52
52
|
```typescript
|
|
53
|
-
workflow.agent(
|
|
53
|
+
workflow.agent('test-agent', { maxSteps: 3 }).commit()
|
|
54
54
|
```
|
|
55
55
|
|
|
56
56
|
## Persisting agent steps
|
|
@@ -11,7 +11,7 @@ Unlike wrapping a tool with `createStep()`, `.tool()` records a declarative entr
|
|
|
11
11
|
## Usage example
|
|
12
12
|
|
|
13
13
|
```typescript
|
|
14
|
-
workflow.tool(testTool).commit()
|
|
14
|
+
workflow.tool(testTool).commit()
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
@@ -31,7 +31,7 @@ workflow.tool(testTool).commit();
|
|
|
31
31
|
Pass a string to reference a registered tool without importing it. The tool must be registered on the Mastra instance when the workflow runs:
|
|
32
32
|
|
|
33
33
|
```typescript
|
|
34
|
-
workflow.tool(
|
|
34
|
+
workflow.tool('lookup-customer', { retries: 2 }).commit()
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
## Persisting tool steps
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.2.23-alpha.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`a3606a0`](https://github.com/mastra-ai/mastra/commit/a3606a09f3deaeef17caf04b9c6a0d7cd6b80fe6), [`4095752`](https://github.com/mastra-ai/mastra/commit/40957529233d202446ebecab1f59c76e99910230), [`a3606a0`](https://github.com/mastra-ai/mastra/commit/a3606a09f3deaeef17caf04b9c6a0d7cd6b80fe6)]:
|
|
8
|
+
- @mastra/core@1.63.3-alpha.1
|
|
9
|
+
|
|
3
10
|
## 1.2.23-alpha.0
|
|
4
11
|
|
|
5
12
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.2.23-alpha.
|
|
3
|
+
"version": "1.2.23-alpha.5",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"jsdom": "^26.1.0",
|
|
29
29
|
"local-pkg": "^1.1.2",
|
|
30
30
|
"zod": "^4.4.3",
|
|
31
|
-
"@mastra/core": "1.63.3-alpha.
|
|
31
|
+
"@mastra/core": "1.63.3-alpha.1",
|
|
32
32
|
"@mastra/mcp": "^1.17.2"
|
|
33
33
|
},
|
|
34
34
|
"devDependencies": {
|
|
@@ -45,9 +45,9 @@
|
|
|
45
45
|
"tsx": "^4.23.1",
|
|
46
46
|
"typescript": "^7.0.2",
|
|
47
47
|
"vitest": "4.1.10",
|
|
48
|
-
"@
|
|
48
|
+
"@internal/types-builder": "0.0.104",
|
|
49
49
|
"@internal/lint": "0.0.129",
|
|
50
|
-
"@
|
|
50
|
+
"@mastra/core": "1.63.3-alpha.1"
|
|
51
51
|
},
|
|
52
52
|
"homepage": "https://mastra.ai",
|
|
53
53
|
"repository": {
|