@mastra/mcp-docs-server 1.2.25-alpha.3 → 1.2.25-alpha.6
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/mastra-platform/studio.md +32 -0
- package/.docs/docs/observability/feedback.md +12 -0
- package/.docs/docs/studio/auth.md +2 -0
- package/.docs/models/gateways/netlify.md +10 -1
- package/.docs/models/gateways/openrouter.md +2 -1
- package/.docs/models/gateways/vercel.md +375 -376
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/cloudflare-workers-ai.md +2 -1
- package/.docs/models/providers/crossmodel.md +4 -3
- package/.docs/models/providers/digitalocean.md +1 -1
- package/.docs/models/providers/edenai.md +4 -3
- package/.docs/models/providers/greenpt.md +3 -1
- package/.docs/models/providers/kilo.md +7 -6
- package/.docs/models/providers/llmgateway-providers.md +2 -3
- package/.docs/models/providers/llmgateway.md +1 -1
- package/.docs/models/providers/nano-gpt.md +6 -8
- package/.docs/models/providers/nearai.md +10 -15
- package/.docs/models/providers/ofox.md +2 -2
- package/.docs/models/providers/opencode-go.md +7 -7
- package/.docs/models/providers/zenmux.md +0 -1
- package/.docs/reference/client-js/observability.md +18 -0
- package/.docs/reference/code-sdk/mount-agent-controller.md +20 -0
- package/.docs/reference/coding-agent/build-base-prompt.md +1 -1
- package/.docs/reference/observability/feedback.md +30 -8
- package/.docs/reference/observability/tracing/interfaces.md +195 -8
- package/.docs/reference/observability/tracing/spans.md +2 -2
- package/.docs/reference/voice/voice.connect.md +38 -29
- package/package.json +4 -4
|
@@ -56,6 +56,38 @@ A deploy transitions through **queued → uploading → starting → running** o
|
|
|
56
56
|
|
|
57
57
|
See the [`mastra deploy` CLI reference](https://mastra.ai/reference/cli/mastra) for the full list of flags and CI/CD usage.
|
|
58
58
|
|
|
59
|
+
## Authentication
|
|
60
|
+
|
|
61
|
+
By default, every Studio deploy on Mastra platform is protected by platform auth. Members of your platform organization sign in with their platform account, and no one else can access the deployed Studio. You don't need to configure anything to get this behavior.
|
|
62
|
+
|
|
63
|
+
Platform auth applies to the Studio UI only. Your server's API routes are governed by your own [`server.auth`](https://mastra.ai/docs/studio/auth) configuration, or remain open if you haven't set one.
|
|
64
|
+
|
|
65
|
+
### Roles and permissions
|
|
66
|
+
|
|
67
|
+
Platform auth maps your organization roles to Studio permissions:
|
|
68
|
+
|
|
69
|
+
| Platform role | Studio permissions |
|
|
70
|
+
| ------------- | ------------------ |
|
|
71
|
+
| `admin` | Full access (`*`) |
|
|
72
|
+
| `member` | Read and execute |
|
|
73
|
+
| `viewer` | Read-only |
|
|
74
|
+
|
|
75
|
+
To customize this mapping, set `roleMapping` on `studio.rbac` in your Mastra configuration. When present, your mapping replaces the platform defaults. See [Role-based access control](https://mastra.ai/docs/studio/auth) for the permission format.
|
|
76
|
+
|
|
77
|
+
### Bring your own auth
|
|
78
|
+
|
|
79
|
+
To use your own auth provider for the deployed Studio instead of platform auth, set an environment variable on the project:
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
MASTRA_PLATFORM_STUDIO_AUTH=disabled
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Add it to the env file you deploy with, or store it on the project through the dashboard, then redeploy. With platform auth disabled, the deploy leaves your auth and RBAC configuration untouched. Your own provider drives the Studio login flow, exactly like a self-hosted deploy. `studio.auth` protects the Studio UI, while `server.auth` protects your API routes. Studio requests fall back to `server.auth` when `studio.auth` isn't set.
|
|
86
|
+
|
|
87
|
+
> **Warning:** Disabling platform auth turns off platform account logins. If you disable it without configuring your own auth provider, the deployed Studio and all API routes are publicly accessible.
|
|
88
|
+
|
|
89
|
+
If you keep platform auth enabled and also configure your own `studio.auth`, both providers validate tokens, but the login screen only offers the platform sign-in flow. To sign in through your own provider, disable platform auth.
|
|
90
|
+
|
|
59
91
|
## Environment files
|
|
60
92
|
|
|
61
93
|
A local env file is optional. When a `.env` or `.env.*` file is present in the project directory, the deploy bundles its environment variables.
|
|
@@ -120,6 +120,18 @@ await observability!.listFeedback({
|
|
|
120
120
|
})
|
|
121
121
|
```
|
|
122
122
|
|
|
123
|
+
## Delete feedback
|
|
124
|
+
|
|
125
|
+
Use `deleteFeedback()` to hide feedback records from reads by id. This is useful when a comment contains sensitive data. Each request accepts at most 1,000 `feedbackIds`, and deletion is idempotent. The optional `organizationId` field filters by organization, and the optional `resourceId` field filters by resource. You can supply either filter independently or use both together. In Studio, each comment on a trace or span Feedback tab has a delete action.
|
|
126
|
+
|
|
127
|
+
```typescript
|
|
128
|
+
await observability!.deleteFeedback({
|
|
129
|
+
feedbackIds: ['feedback-1', 'feedback-2'],
|
|
130
|
+
})
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
Deleted records also disappear from feedback analytics. ClickHouse uses a lightweight delete to hide rows without guaranteeing immediate physical removal, so open-source deployments must configure an [observability retention period](https://mastra.ai/reference/storage/retention) to physically purge them. ClickHouse doesn't configure a retention TTL for deletion requests in open-source deployments. Delete APIs intentionally leave cursor-only delta rows untouched. These rows contain identifiers rather than feedback payloads and expire within two days.
|
|
134
|
+
|
|
123
135
|
## Query feedback analytics
|
|
124
136
|
|
|
125
137
|
OLAP feedback queries operate on numeric `value` fields. Use them for ratings, thumbs encoded as `1` and `-1`, numeric QA scores, or other numeric feedback types.
|
|
@@ -8,6 +8,8 @@ When you configure [authentication](https://mastra.ai/docs/auth/overview) on you
|
|
|
8
8
|
|
|
9
9
|
Without authentication, Studio and all API routes are publicly accessible.
|
|
10
10
|
|
|
11
|
+
> **Note:** Studio deployed on Mastra platform works differently. By default, the platform injects its own auth so only your organization members can sign in, and your `server.auth` applies to API routes only. Set `MASTRA_PLATFORM_STUDIO_AUTH=disabled` to opt out. See [Authentication on Mastra platform](https://mastra.ai/docs/mastra-platform/studio).
|
|
12
|
+
|
|
11
13
|
## When to use Studio Auth
|
|
12
14
|
|
|
13
15
|
- Multiple team members need to interact with agents, workflows, and tools through a shared Studio deployment.
|
|
@@ -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 251 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
|
|
|
@@ -106,6 +106,14 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
106
106
|
| `openai/gpt-5.6-sol` |
|
|
107
107
|
| `openai/gpt-5.6-terra` |
|
|
108
108
|
| `openai/gpt-6-astra` |
|
|
109
|
+
| `openai/gpt-image-1` |
|
|
110
|
+
| `openai/gpt-image-1.5` |
|
|
111
|
+
| `openai/gpt-image-2` |
|
|
112
|
+
| `openai/gpt-image-2-2026-04-21` |
|
|
113
|
+
| `openai/gpt-image-2.5-flare` |
|
|
114
|
+
| `openai/gpt-image-2.5-flare-2026-09-08` |
|
|
115
|
+
| `openai/gpt-image-2.5-sunburst` |
|
|
116
|
+
| `openai/gpt-image-2.5-sunburst-2026-09-08` |
|
|
109
117
|
| `openai/o3` |
|
|
110
118
|
| `openai/o3-mini` |
|
|
111
119
|
| `openai/o4-mini` |
|
|
@@ -138,6 +146,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
138
146
|
| `openrouter/deepseek/deepseek-v4-flash-vision-exp` |
|
|
139
147
|
| `openrouter/deepseek/deepseek-v4-pro` |
|
|
140
148
|
| `openrouter/deepseek/deepseek-v4-pro-0813` |
|
|
149
|
+
| `openrouter/deepseek/deepseek-v4.1-flash` |
|
|
141
150
|
| `openrouter/google/gemma-2-27b-it` |
|
|
142
151
|
| `openrouter/google/gemma-3-12b-it` |
|
|
143
152
|
| `openrouter/google/gemma-3-27b-it` |
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
# OpenRouter
|
|
6
6
|
|
|
7
|
-
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
7
|
+
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 358 models through Mastra's model router.
|
|
8
8
|
|
|
9
9
|
Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
|
|
10
10
|
|
|
@@ -105,6 +105,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
105
105
|
| `deepseek/deepseek-v4-flash-vision-exp` |
|
|
106
106
|
| `deepseek/deepseek-v4-pro` |
|
|
107
107
|
| `deepseek/deepseek-v4-pro-0813` |
|
|
108
|
+
| `deepseek/deepseek-v4.1-flash` |
|
|
108
109
|
| `dots-studio/dots-3-note-preview:free` |
|
|
109
110
|
| `google/gemini-2.5-flash` |
|
|
110
111
|
| `google/gemini-2.5-flash-image` |
|