@mastra/mcp-docs-server 0.13.38 → 0.13.39-alpha.0
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/organized/changelogs/%40mastra%2Fagent-builder.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fastra.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fauth.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Fchroma.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fcloud.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +20 -20
- package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +12 -12
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +35 -35
- package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fevals.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Flance.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Flibsql.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmemory.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fmssql.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fpg.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +22 -22
- package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Frag.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Freact.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +9 -0
- package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -0
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +18 -18
- package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fupstash.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +11 -1
- package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +10 -10
- package/.docs/organized/changelogs/create-mastra.md +7 -7
- package/.docs/organized/changelogs/mastra.md +18 -18
- package/.docs/raw/agents/overview.mdx +2 -2
- package/.docs/raw/auth/jwt.mdx +2 -2
- package/.docs/raw/auth/supabase.mdx +2 -2
- package/.docs/raw/auth/workos.mdx +2 -2
- package/.docs/raw/course/02-agent-tools-mcp/04-initializing-mcp-tools.md +2 -2
- package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +1 -1
- package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +24 -8
- package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +1 -1
- package/.docs/raw/frameworks/servers/express.mdx +1 -1
- package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx +34 -18
- package/.docs/raw/getting-started/installation.mdx +7 -7
- package/.docs/raw/getting-started/mcp-docs-server.mdx +1 -1
- package/.docs/raw/getting-started/studio.mdx +27 -17
- package/.docs/raw/getting-started/templates.mdx +12 -4
- package/.docs/raw/index.mdx +1 -1
- package/.docs/raw/mastra-cloud/dashboard.mdx +6 -6
- package/.docs/raw/mastra-cloud/observability.mdx +2 -2
- package/.docs/raw/mastra-cloud/overview.mdx +1 -1
- package/.docs/raw/mastra-cloud/setting-up.mdx +1 -1
- package/.docs/raw/memory/overview.mdx +1 -1
- package/.docs/raw/memory/semantic-recall.mdx +2 -4
- package/.docs/raw/memory/threads-and-resources.mdx +1 -1
- package/.docs/raw/memory/working-memory.mdx +1 -1
- package/.docs/raw/observability/ai-tracing/exporters/default.mdx +6 -6
- package/.docs/raw/observability/ai-tracing/overview.mdx +7 -7
- package/.docs/raw/observability/overview.mdx +1 -1
- package/.docs/raw/reference/agents/agent.mdx +2 -2
- package/.docs/raw/reference/agents/listScorers.mdx +69 -0
- package/.docs/raw/reference/agents/listTools.mdx +69 -0
- package/.docs/raw/reference/agents/listWorkflows.mdx +69 -0
- package/.docs/raw/reference/cli/mastra.mdx +1 -1
- package/.docs/raw/reference/client-js/agents.mdx +1 -1
- package/.docs/raw/reference/client-js/logs.mdx +1 -1
- package/.docs/raw/reference/client-js/mastra-client.mdx +7 -7
- package/.docs/raw/reference/client-js/memory.mdx +1 -1
- package/.docs/raw/reference/client-js/tools.mdx +1 -1
- package/.docs/raw/reference/client-js/workflows.mdx +1 -1
- package/.docs/raw/reference/core/getScorerByName.mdx +1 -1
- package/.docs/raw/reference/core/listAgents.mdx +35 -0
- package/.docs/raw/reference/core/listLogs.mdx +96 -0
- package/.docs/raw/reference/core/listLogsByRunId.mdx +87 -0
- package/.docs/raw/reference/core/listScorers.mdx +43 -0
- package/.docs/raw/reference/core/listWorkflows.mdx +45 -0
- package/.docs/raw/reference/memory/memory-class.mdx +2 -1
- package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx +0 -1
- package/.docs/raw/reference/observability/ai-tracing/interfaces.mdx +1 -1
- package/.docs/raw/reference/observability/otel-tracing/providers/keywordsai.mdx +1 -1
- package/.docs/raw/reference/processors/batch-parts-processor.mdx +10 -14
- package/.docs/raw/reference/processors/language-detector.mdx +20 -32
- package/.docs/raw/reference/processors/moderation-processor.mdx +46 -30
- package/.docs/raw/reference/processors/pii-detector.mdx +47 -32
- package/.docs/raw/reference/processors/prompt-injection-detector.mdx +20 -30
- package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +24 -29
- package/.docs/raw/reference/processors/token-limiter-processor.mdx +14 -23
- package/.docs/raw/reference/processors/unicode-normalizer.mdx +12 -14
- package/.docs/raw/reference/rag/document.mdx +1 -1
- package/.docs/raw/reference/scorers/run-experiment.mdx +1 -1
- package/.docs/raw/reference/storage/mssql.mdx +3 -3
- package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/stream.mdx +1 -1
- package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +1 -1
- package/.docs/raw/reference/tools/mcp-client.mdx +8 -8
- package/.docs/raw/reference/voice/google-gemini-live.mdx +1 -1
- package/.docs/raw/reference/workflows/step.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
- package/.docs/raw/reference/workflows/workflow-methods/map.mdx +72 -2
- package/.docs/raw/reference/workflows/workflow.mdx +0 -14
- package/.docs/raw/scorers/overview.mdx +5 -5
- package/.docs/raw/server-db/middleware.mdx +4 -4
- package/.docs/raw/tools-mcp/overview.mdx +2 -2
- package/.docs/raw/workflows/agents-and-tools.mdx +2 -6
- package/.docs/raw/workflows/control-flow.mdx +208 -165
- package/.docs/raw/workflows/inngest-workflow.mdx +2 -2
- package/.docs/raw/workflows/overview.mdx +106 -54
- package/.docs/raw/workflows/suspend-and-resume.mdx +1 -9
- package/CHANGELOG.md +10 -0
- package/package.json +4 -4
- package/.docs/raw/workflows/input-data-mapping.mdx +0 -107
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# @mastra/voice-speechify
|
|
2
2
|
|
|
3
|
+
## 0.11.12-alpha.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
|
|
8
|
+
|
|
9
|
+
- Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712)]:
|
|
10
|
+
- @mastra/core@0.24.0-alpha.0
|
|
11
|
+
|
|
3
12
|
## 0.11.11
|
|
4
13
|
|
|
5
14
|
### Patch Changes
|
|
@@ -289,14 +298,5 @@
|
|
|
289
298
|
|
|
290
299
|
## 0.10.9-alpha.0
|
|
291
300
|
|
|
292
|
-
### Patch Changes
|
|
293
|
-
|
|
294
|
-
- [#6942](https://github.com/mastra-ai/mastra/pull/6942) [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01) Thanks [@wardpeet](https://github.com/wardpeet)! - Add zod as peerdeps for all packages
|
|
295
|
-
|
|
296
|
-
- Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
|
|
297
|
-
- @mastra/core@0.14.2-alpha.1
|
|
298
|
-
|
|
299
|
-
## 0.10.8
|
|
300
|
-
|
|
301
301
|
|
|
302
|
-
...
|
|
302
|
+
... 1400 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# create-mastra
|
|
2
2
|
|
|
3
|
+
## 0.18.0-alpha.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
|
|
8
|
+
|
|
3
9
|
## 0.17.7
|
|
4
10
|
|
|
5
11
|
## 0.17.7-alpha.0
|
|
@@ -292,11 +298,5 @@
|
|
|
292
298
|
|
|
293
299
|
## 0.13.4-alpha.1
|
|
294
300
|
|
|
295
|
-
### Patch Changes
|
|
296
|
-
|
|
297
|
-
- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
|
|
298
|
-
|
|
299
|
-
## 0.13.4-alpha.0
|
|
300
|
-
|
|
301
301
|
|
|
302
|
-
...
|
|
302
|
+
... 1810 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,22 @@
|
|
|
1
1
|
# mastra
|
|
2
2
|
|
|
3
|
+
## 0.18.0-alpha.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- Update peer dependencies to match core package version bump (0.23.4) ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
|
|
8
|
+
|
|
9
|
+
### Patch Changes
|
|
10
|
+
|
|
11
|
+
- update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
|
|
12
|
+
|
|
13
|
+
- Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`2437a90`](https://github.com/mastra-ai/mastra/commit/2437a90d94a0ff94fa8dd42d2558d73c124972d3), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`3e6c29a`](https://github.com/mastra-ai/mastra/commit/3e6c29a8924f63da4def2cf95180f671b3b2c89c), [`139588d`](https://github.com/mastra-ai/mastra/commit/139588df7755c9111a3060f72a789c1a8c95e091), [`186b29b`](https://github.com/mastra-ai/mastra/commit/186b29bd51ac1dcc24ad3825fdb7207a6d6391a6), [`4e92a19`](https://github.com/mastra-ai/mastra/commit/4e92a19aef1bd7f608482b366b1e46873a9dc6c7), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712), [`dbb705e`](https://github.com/mastra-ai/mastra/commit/dbb705e61999ec655b912ea8b5d77ae4792989a7)]:
|
|
16
|
+
- @mastra/deployer@0.24.0-alpha.0
|
|
17
|
+
- @mastra/loggers@0.10.19-alpha.0
|
|
18
|
+
- @mastra/core@0.24.0-alpha.0
|
|
19
|
+
|
|
3
20
|
## 0.17.7
|
|
4
21
|
|
|
5
22
|
### Patch Changes
|
|
@@ -281,22 +298,5 @@
|
|
|
281
298
|
- @mastra/deployer@0.21.0-alpha.0
|
|
282
299
|
- @mastra/core@0.21.0-alpha.0
|
|
283
300
|
- @mastra/loggers@0.10.16-alpha.0
|
|
284
|
-
- @mastra/mcp@0.13.5-alpha.0
|
|
285
|
-
|
|
286
|
-
## 0.15.1
|
|
287
|
-
|
|
288
|
-
### Patch Changes
|
|
289
|
-
|
|
290
|
-
- Marked telemetry as disabled in the default template, in preperation for the Nov 4th deprecation. ([#8618](https://github.com/mastra-ai/mastra/pull/8618))
|
|
291
|
-
|
|
292
|
-
- Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
|
|
293
|
-
|
|
294
|
-
- Updated dependencies [[`07eaf25`](https://github.com/mastra-ai/mastra/commit/07eaf25aada9e42235dbf905854de53da4d8121b), [`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372), [`68b1111`](https://github.com/mastra-ai/mastra/commit/68b11118a1303f93e9c0c157850c0751309304c5)]:
|
|
295
|
-
- @mastra/core@0.20.2
|
|
296
|
-
- @mastra/deployer@0.20.2
|
|
297
|
-
|
|
298
|
-
## 0.15.1-alpha.1
|
|
299
|
-
|
|
300
|
-
### Patch Changes
|
|
301
301
|
|
|
302
|
-
...
|
|
302
|
+
... 6396 more lines hidden. See full changelog in package directory.
|
|
@@ -450,9 +450,9 @@ export const testAgent = new Agent({
|
|
|
450
450
|
|
|
451
451
|
> See [Runtime Context](/docs/server-db/runtime-context) for more information.
|
|
452
452
|
|
|
453
|
-
## Testing with
|
|
453
|
+
## Testing with Studio
|
|
454
454
|
|
|
455
|
-
Use
|
|
455
|
+
Use [Studio](/docs/getting-started/studio) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
|
|
456
456
|
|
|
457
457
|
## Related
|
|
458
458
|
|
package/.docs/raw/auth/jwt.mdx
CHANGED
|
@@ -58,7 +58,7 @@ export const mastraClient = new MastraClient({
|
|
|
58
58
|
Once `MastraClient` is configured, you can send authenticated requests from your frontend application, or use `curl` for quick local testing:
|
|
59
59
|
|
|
60
60
|
<Tabs>
|
|
61
|
-
<TabItem value="
|
|
61
|
+
<TabItem value="react" label="React">
|
|
62
62
|
```tsx title="src/components/test-agent.tsx" showLineNumbers copy
|
|
63
63
|
import { mastraClient } from "../../lib/mastra-client";
|
|
64
64
|
|
|
@@ -78,7 +78,7 @@ Once `MastraClient` is configured, you can send authenticated requests from your
|
|
|
78
78
|
```
|
|
79
79
|
|
|
80
80
|
</TabItem>
|
|
81
|
-
<TabItem value="
|
|
81
|
+
<TabItem value="curl" label="cURL">
|
|
82
82
|
```bash copy
|
|
83
83
|
curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
|
|
84
84
|
-H "Content-Type: application/json" \
|
|
@@ -97,7 +97,7 @@ export const mastraClient = new MastraClient({
|
|
|
97
97
|
Once `MastraClient` is configured with the Supabase access token, you can send authenticated requests:
|
|
98
98
|
|
|
99
99
|
<Tabs>
|
|
100
|
-
<TabItem value="
|
|
100
|
+
<TabItem value="react" label="React">
|
|
101
101
|
```tsx title="src/components/test-agent.tsx" showLineNumbers copy
|
|
102
102
|
import { mastraClient } from "../../lib/mastra-client";
|
|
103
103
|
|
|
@@ -117,7 +117,7 @@ Once `MastraClient` is configured with the Supabase access token, you can send a
|
|
|
117
117
|
```
|
|
118
118
|
|
|
119
119
|
</TabItem>
|
|
120
|
-
<TabItem value="
|
|
120
|
+
<TabItem value="curl" label="cURL">
|
|
121
121
|
```bash copy
|
|
122
122
|
curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
|
|
123
123
|
-H "Content-Type: application/json" \
|
|
@@ -159,7 +159,7 @@ export const createMastraClient = (accessToken: string) => {
|
|
|
159
159
|
Once `MastraClient` is configured with the WorkOS access token, you can send authenticated requests:
|
|
160
160
|
|
|
161
161
|
<Tabs>
|
|
162
|
-
<TabItem value="
|
|
162
|
+
<TabItem value="react" label="React">
|
|
163
163
|
```typescript title="src/api/agents.ts" showLineNumbers copy
|
|
164
164
|
import { WorkOS } from '@workos-inc/node';
|
|
165
165
|
import { MastraClient } from '@mastra/client-js';
|
|
@@ -191,7 +191,7 @@ Once `MastraClient` is configured with the WorkOS access token, you can send aut
|
|
|
191
191
|
```
|
|
192
192
|
|
|
193
193
|
</TabItem>
|
|
194
|
-
<TabItem value="
|
|
194
|
+
<TabItem value="curl" label="cURL">
|
|
195
195
|
```bash copy
|
|
196
196
|
curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
|
|
197
197
|
-H "Content-Type: application/json" \
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
Once you have the configuration set up, you need to initialize the MCP tools:
|
|
4
4
|
|
|
5
5
|
```typescript
|
|
6
|
-
const mcpTools = await mcp.
|
|
6
|
+
const mcpTools = await mcp.listTools();
|
|
7
7
|
```
|
|
8
8
|
|
|
9
|
-
This asynchronous call fetches all the available tools from the configured MCP servers. The `
|
|
9
|
+
This asynchronous call fetches all the available tools from the configured MCP servers. The `listTools()` method connects to each server specified in your configuration, retrieves the available tools, and returns them in a format that can be used by your Mastra agent.
|
|
10
10
|
|
|
11
11
|
The `mcpTools` object will contain all the tools provided by the MCP servers you've configured. We'll add these tools to our agent in the next step.
|
|
@@ -23,6 +23,6 @@ const memory = new Memory({
|
|
|
23
23
|
});
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
The `topK` parameter controls how many semantically similar messages are retrieved. A higher value will retrieve more messages, which can be helpful for complex topics but may also include less relevant information. The default value is `
|
|
26
|
+
The `topK` parameter controls how many semantically similar messages are retrieved. A higher value will retrieve more messages, which can be helpful for complex topics but may also include less relevant information. The default value is `4`.
|
|
27
27
|
|
|
28
28
|
The `messageRange` parameter controls how much context is included with each match. This is important because the matching message alone might not provide enough context to understand the conversation. Including messages before and after the match helps the agent understand the context of the matched message.
|
|
@@ -32,16 +32,24 @@ The recommended way of using Mastra and AI SDK together is by installing the `@m
|
|
|
32
32
|
|
|
33
33
|
<Tabs>
|
|
34
34
|
<TabItem value="npm" label="npm">
|
|
35
|
-
```bash copy
|
|
35
|
+
```bash copy
|
|
36
|
+
npm install @mastra/ai-sdk
|
|
37
|
+
```
|
|
36
38
|
</TabItem>
|
|
37
39
|
<TabItem value="pnpm" label="pnpm">
|
|
38
|
-
```bash copy
|
|
40
|
+
```bash copy
|
|
41
|
+
pnpm add @mastra/ai-sdk
|
|
42
|
+
```
|
|
39
43
|
</TabItem>
|
|
40
44
|
<TabItem value="yarn" label="yarn">
|
|
41
|
-
```bash copy
|
|
45
|
+
```bash copy
|
|
46
|
+
yarn add @mastra/ai-sdk
|
|
47
|
+
```
|
|
42
48
|
</TabItem>
|
|
43
49
|
<TabItem value="bun" label="bun">
|
|
44
|
-
```bash copy
|
|
50
|
+
```bash copy
|
|
51
|
+
bun add @mastra/ai-sdk
|
|
52
|
+
```
|
|
45
53
|
</TabItem>
|
|
46
54
|
</Tabs>
|
|
47
55
|
|
|
@@ -350,16 +358,24 @@ Install the required AI SDK React package:
|
|
|
350
358
|
|
|
351
359
|
<Tabs>
|
|
352
360
|
<TabItem value="npm" label="npm">
|
|
353
|
-
```bash copy
|
|
361
|
+
```bash copy
|
|
362
|
+
npm install @ai-sdk/react
|
|
363
|
+
```
|
|
354
364
|
</TabItem>
|
|
355
365
|
<TabItem value="pnpm" label="pnpm">
|
|
356
|
-
```bash copy
|
|
366
|
+
```bash copy
|
|
367
|
+
pnpm add @ai-sdk/react
|
|
368
|
+
```
|
|
357
369
|
</TabItem>
|
|
358
370
|
<TabItem value="yarn" label="yarn">
|
|
359
|
-
```bash copy
|
|
371
|
+
```bash copy
|
|
372
|
+
yarn add @ai-sdk/react
|
|
373
|
+
```
|
|
360
374
|
</TabItem>
|
|
361
375
|
<TabItem value="bun" label="bun">
|
|
362
|
-
```bash copy
|
|
376
|
+
```bash copy
|
|
377
|
+
bun add @ai-sdk/react
|
|
378
|
+
```
|
|
363
379
|
</TabItem>
|
|
364
380
|
</Tabs>
|
|
365
381
|
|
|
@@ -91,7 +91,7 @@ npm run dev
|
|
|
91
91
|
|
|
92
92
|
This will start the Mastra development server.
|
|
93
93
|
|
|
94
|
-
You can now test your agent by visiting [http://localhost:4111](http://localhost:4111)
|
|
94
|
+
You can now test your agent by visiting [http://localhost:4111](http://localhost:4111) and using Studio or via the Mastra API at [http://localhost:4111/api/agents/assistant/stream](http://localhost:4111/api/agents/assistant/stream).
|
|
95
95
|
|
|
96
96
|
</StepItem>
|
|
97
97
|
|
|
@@ -31,19 +31,23 @@ Install the required Mastra packages:
|
|
|
31
31
|
|
|
32
32
|
<Tabs>
|
|
33
33
|
<TabItem value="npm" label="npm">
|
|
34
|
-
```bash copy
|
|
35
|
-
@mastra/libsql@latest
|
|
34
|
+
```bash copy
|
|
35
|
+
npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
36
|
+
```
|
|
36
37
|
</TabItem>
|
|
37
38
|
<TabItem value="yarn" label="yarn">
|
|
38
|
-
```bash copy
|
|
39
|
-
@mastra/libsql@latest
|
|
39
|
+
```bash copy
|
|
40
|
+
yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
41
|
+
```
|
|
40
42
|
</TabItem>
|
|
41
43
|
<TabItem value="pnpm" label="pnpm">
|
|
42
|
-
```bash copy
|
|
43
|
-
@mastra/libsql@latest
|
|
44
|
+
```bash copy
|
|
45
|
+
pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
46
|
+
```
|
|
44
47
|
</TabItem>
|
|
45
48
|
<TabItem value="bun" label="bun">
|
|
46
|
-
```bash copy
|
|
49
|
+
```bash copy
|
|
50
|
+
bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
47
51
|
```
|
|
48
52
|
</TabItem>
|
|
49
53
|
</Tabs>
|
|
@@ -146,10 +150,14 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
|
|
|
146
150
|
|
|
147
151
|
<Tabs>
|
|
148
152
|
<TabItem value="npm" label="npm">
|
|
149
|
-
```bash copy
|
|
153
|
+
```bash copy
|
|
154
|
+
npm run dev:mastra
|
|
155
|
+
```
|
|
150
156
|
</TabItem>
|
|
151
157
|
<TabItem value="cli" label="CLI">
|
|
152
|
-
```bash copy
|
|
158
|
+
```bash copy
|
|
159
|
+
mastra dev:mastra
|
|
160
|
+
```
|
|
153
161
|
</TabItem>
|
|
154
162
|
</Tabs>
|
|
155
163
|
|
|
@@ -254,19 +262,23 @@ Install the required Mastra packages:
|
|
|
254
262
|
|
|
255
263
|
<Tabs>
|
|
256
264
|
<TabItem value="npm" label="npm">
|
|
257
|
-
```bash copy
|
|
258
|
-
@mastra/libsql@latest
|
|
265
|
+
```bash copy
|
|
266
|
+
npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
267
|
+
```
|
|
259
268
|
</TabItem>
|
|
260
269
|
<TabItem value="yarn" label="yarn">
|
|
261
|
-
```bash copy
|
|
262
|
-
@mastra/libsql@latest
|
|
270
|
+
```bash copy
|
|
271
|
+
yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
272
|
+
```
|
|
263
273
|
</TabItem>
|
|
264
274
|
<TabItem value="pnpm" label="pnpm">
|
|
265
|
-
```bash copy
|
|
266
|
-
@mastra/libsql@latest
|
|
275
|
+
```bash copy
|
|
276
|
+
pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
277
|
+
```
|
|
267
278
|
</TabItem>
|
|
268
279
|
<TabItem value="bun" label="bun">
|
|
269
|
-
```bash copy
|
|
280
|
+
```bash copy
|
|
281
|
+
bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
|
|
270
282
|
```
|
|
271
283
|
</TabItem>
|
|
272
284
|
</Tabs>
|
|
@@ -369,10 +381,14 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
|
|
|
369
381
|
|
|
370
382
|
<Tabs>
|
|
371
383
|
<TabItem value="npm" label="npm">
|
|
372
|
-
```bash copy
|
|
384
|
+
```bash copy
|
|
385
|
+
npm run dev:mastra
|
|
386
|
+
```
|
|
373
387
|
</TabItem>
|
|
374
388
|
<TabItem value="cli" label="CLI">
|
|
375
|
-
```bash copy
|
|
389
|
+
```bash copy
|
|
390
|
+
mastra dev:mastra
|
|
391
|
+
```
|
|
376
392
|
</TabItem>
|
|
377
393
|
</Tabs>
|
|
378
394
|
|
|
@@ -30,28 +30,28 @@ The wizard will guide you through setup, create a new directory for your project
|
|
|
30
30
|
<TabItem value="npm" label="npm">
|
|
31
31
|
|
|
32
32
|
```bash copy
|
|
33
|
-
npm create mastra@latest
|
|
33
|
+
npm create mastra@latest
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
</TabItem>
|
|
37
37
|
<TabItem value="pnpm" label="pnpm">
|
|
38
38
|
|
|
39
39
|
```bash copy
|
|
40
|
-
pnpm create mastra@latest
|
|
40
|
+
pnpm create mastra@latest
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
</TabItem>
|
|
44
44
|
<TabItem value="yarn" label="yarn">
|
|
45
45
|
|
|
46
46
|
```bash copy
|
|
47
|
-
yarn create mastra@latest
|
|
47
|
+
yarn create mastra@latest
|
|
48
48
|
```
|
|
49
49
|
|
|
50
50
|
</TabItem>
|
|
51
51
|
<TabItem value="bun" label="bun">
|
|
52
52
|
|
|
53
53
|
```bash copy
|
|
54
|
-
bun create mastra@latest
|
|
54
|
+
bun create mastra@latest
|
|
55
55
|
```
|
|
56
56
|
|
|
57
57
|
</TabItem>
|
|
@@ -65,7 +65,7 @@ You can use flags with `create mastra` like `--no-example` to skip the example w
|
|
|
65
65
|
|
|
66
66
|
### Test your agent
|
|
67
67
|
|
|
68
|
-
Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open
|
|
68
|
+
Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open Studio at http://localhost:4111.
|
|
69
69
|
|
|
70
70
|
Try asking about the weather. If your API key is set up correctly, you'll get a response:
|
|
71
71
|
|
|
@@ -77,7 +77,7 @@ If you encounter an error, your API key may not be configured correctly. Double-
|
|
|
77
77
|
|
|
78
78
|
:::
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
[Studio](/docs/getting-started/studio) lets you rapidly build and prototype agents without needing to build a UI. Once you're ready, you can integrate your Mastra agent into your application using the guides below.
|
|
81
81
|
|
|
82
82
|
### Next steps
|
|
83
83
|
|
|
@@ -309,7 +309,7 @@ export const mastra = new Mastra({
|
|
|
309
309
|
|
|
310
310
|
<StepItem>
|
|
311
311
|
|
|
312
|
-
You can now launch
|
|
312
|
+
You can now launch [Studio](/docs/getting-started/studio) and test your agent.
|
|
313
313
|
|
|
314
314
|
<Tabs>
|
|
315
315
|
<TabItem value="npm" label="npm">
|
|
@@ -3,7 +3,7 @@ title: "Mastra Docs Server | Getting Started | Mastra Docs"
|
|
|
3
3
|
description: "Learn how to use the Mastra MCP documentation server in your IDE to turn it into an agentic Mastra expert."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
import
|
|
6
|
+
import YouTube from "@site/src/components/YouTube-player";
|
|
7
7
|
|
|
8
8
|
# Mastra Docs Server
|
|
9
9
|
|
|
@@ -1,53 +1,63 @@
|
|
|
1
1
|
---
|
|
2
|
-
title: "
|
|
2
|
+
title: "Studio | Getting Started | Mastra Docs"
|
|
3
3
|
description: Guide on installing Mastra and setting up the necessary prerequisites for running it with various LLM providers.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
import
|
|
6
|
+
import YouTube from "@site/src/components/YouTube-player";
|
|
7
7
|
import Tabs from "@theme/Tabs";
|
|
8
8
|
import TabItem from "@theme/TabItem";
|
|
9
9
|
import { VideoPlayer } from "@site/src/components/video-player";
|
|
10
10
|
|
|
11
|
-
#
|
|
11
|
+
# Studio
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Studio provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
|
|
14
14
|
|
|
15
|
-
As your project evolves,
|
|
15
|
+
As your project evolves, Studio's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
|
|
16
16
|
|
|
17
|
-
To get started, run
|
|
17
|
+
To get started, run Studio locally using the instructions below, or [create a project in Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
|
|
18
18
|
|
|
19
|
-
<YouTube id="
|
|
19
|
+
<YouTube id="ojGu6Bi4wYk" />
|
|
20
20
|
|
|
21
|
-
## Start
|
|
21
|
+
## Start Studio
|
|
22
22
|
|
|
23
23
|
If you created your application with `create mastra`, start the local development server using the `dev` script. You can also run it directly with `mastra dev`.
|
|
24
24
|
|
|
25
25
|
<Tabs>
|
|
26
26
|
<TabItem value="npm" label="npm">
|
|
27
|
-
```bash copy
|
|
27
|
+
```bash copy
|
|
28
|
+
npm run dev
|
|
29
|
+
```
|
|
28
30
|
</TabItem>
|
|
29
31
|
<TabItem value="pnpm" label="pnpm">
|
|
30
|
-
```bash copy
|
|
32
|
+
```bash copy
|
|
33
|
+
pnpm run dev
|
|
34
|
+
```
|
|
31
35
|
</TabItem>
|
|
32
36
|
<TabItem value="yarn" label="yarn">
|
|
33
|
-
```bash copy
|
|
37
|
+
```bash copy
|
|
38
|
+
yarn run dev
|
|
39
|
+
```
|
|
34
40
|
</TabItem>
|
|
35
41
|
<TabItem value="bun" label="bun">
|
|
36
|
-
```bash copy
|
|
42
|
+
```bash copy
|
|
43
|
+
bun run dev
|
|
44
|
+
```
|
|
37
45
|
</TabItem>
|
|
38
46
|
<TabItem value="mastra" label="mastra">
|
|
39
|
-
```bash copy
|
|
47
|
+
```bash copy
|
|
48
|
+
mastra dev
|
|
49
|
+
```
|
|
40
50
|
</TabItem>
|
|
41
51
|
</Tabs>
|
|
42
52
|
|
|
43
53
|
Once the server's running, you can:
|
|
44
54
|
|
|
45
|
-
- Open the
|
|
55
|
+
- Open the Studio UI at http://localhost:4111/ to test your agent interactively.
|
|
46
56
|
- Visit http://localhost:4111/swagger-ui to discover and interact with the underlying REST API.
|
|
47
57
|
|
|
48
|
-
##
|
|
58
|
+
## Studio UI
|
|
49
59
|
|
|
50
|
-
The
|
|
60
|
+
The Studio UI provides an interactive development environment for you to test your agents, workflows, and tools, observe exactly what happens under the hood with each interaction, and tweak things as you go.
|
|
51
61
|
|
|
52
62
|
### Agents
|
|
53
63
|
|
|
@@ -73,7 +83,7 @@ Run tools in isolation to observe their behavior. Test them before assigning the
|
|
|
73
83
|
### MCP List the MCP servers attached to your Mastra instance and explore their
|
|
74
84
|
available tools.
|
|
75
85
|
|
|
76
|
-

|
|
77
87
|
|
|
78
88
|
### Observability
|
|
79
89
|
|
|
@@ -16,16 +16,24 @@ Install a template using the `create-mastra` command:
|
|
|
16
16
|
|
|
17
17
|
<Tabs>
|
|
18
18
|
<TabItem value="npm" label="npm">
|
|
19
|
-
```bash copy
|
|
19
|
+
```bash copy
|
|
20
|
+
npx create-mastra@latest --template template-name
|
|
21
|
+
```
|
|
20
22
|
</TabItem>
|
|
21
23
|
<TabItem value="yarn" label="yarn">
|
|
22
|
-
```bash copy
|
|
24
|
+
```bash copy
|
|
25
|
+
yarn dlx create-mastra@latest --template template-name
|
|
26
|
+
```
|
|
23
27
|
</TabItem>
|
|
24
28
|
<TabItem value="pnpm" label="pnpm">
|
|
25
|
-
```bash copy
|
|
29
|
+
```bash copy
|
|
30
|
+
pnpm create mastra@latest --template template-name
|
|
31
|
+
```
|
|
26
32
|
</TabItem>
|
|
27
33
|
<TabItem value="bun" label="bun">
|
|
28
|
-
```bash copy
|
|
34
|
+
```bash copy
|
|
35
|
+
bun create mastra@latest --template template-name
|
|
36
|
+
```
|
|
29
37
|
</TabItem>
|
|
30
38
|
</Tabs>
|
|
31
39
|
|
package/.docs/raw/index.mdx
CHANGED
|
@@ -5,7 +5,7 @@ sidebar_label: "Introduction"
|
|
|
5
5
|
description: "Mastra is an all-in-one framework for building AI-powered applications and agents with a modern TypeScript stack."
|
|
6
6
|
---
|
|
7
7
|
|
|
8
|
-
import
|
|
8
|
+
import YouTube from "@site/src/components/YouTube-player";
|
|
9
9
|
|
|
10
10
|
# About Mastra
|
|
11
11
|
|
|
@@ -7,7 +7,7 @@ import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
|
|
|
7
7
|
|
|
8
8
|
# Navigating the Dashboard
|
|
9
9
|
|
|
10
|
-
This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [
|
|
10
|
+
This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Studio](/docs/mastra-cloud/dashboard#studio).
|
|
11
11
|
|
|
12
12
|
<MastraCloudCallout />
|
|
13
13
|
|
|
@@ -53,13 +53,13 @@ You can manage environment variables, edit key project settings like the name an
|
|
|
53
53
|
|
|
54
54
|
> Changes to configuration require a new deployment before taking effect.
|
|
55
55
|
|
|
56
|
-
##
|
|
56
|
+
## Studio
|
|
57
57
|
|
|
58
58
|
### Agents
|
|
59
59
|
|
|
60
60
|
On the **Agents** page you'll see all agents used in your application. Click any agent to interact using the chat interface.
|
|
61
61
|
|
|
62
|
-

|
|
63
63
|
|
|
64
64
|
Key features:
|
|
65
65
|
|
|
@@ -69,7 +69,7 @@ Test your agents in real time using the chat interface, review traces of each in
|
|
|
69
69
|
|
|
70
70
|
On the **Workflows** page you'll see all workflows used in your application. Click any workflow to interact using the runner interface.
|
|
71
71
|
|
|
72
|
-

|
|
73
73
|
|
|
74
74
|
Key features:
|
|
75
75
|
|
|
@@ -79,7 +79,7 @@ Visualize your workflow with a step-by-step graph, view execution traces, and ru
|
|
|
79
79
|
|
|
80
80
|
On the **Tools** page you'll see all tools used by your agents. Click any tool to interact using the input interface.
|
|
81
81
|
|
|
82
|
-

|
|
83
83
|
|
|
84
84
|
Key features:
|
|
85
85
|
|
|
@@ -89,7 +89,7 @@ Test your tools by providing an input that matches the schema and viewing the st
|
|
|
89
89
|
|
|
90
90
|
The **MCP Servers** page lists all MCP Servers included in your application. Click any MCP Server for more information.
|
|
91
91
|
|
|
92
|
-

|
|
93
93
|
|
|
94
94
|
Key features:
|
|
95
95
|
|
|
@@ -27,7 +27,7 @@ More detailed traces are available for both agents and workflows by using a [log
|
|
|
27
27
|
|
|
28
28
|
### Agents
|
|
29
29
|
|
|
30
|
-
With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section
|
|
30
|
+
With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section in Studio.
|
|
31
31
|
|
|
32
32
|

|
|
33
33
|
|
|
@@ -37,7 +37,7 @@ Tools passed to the agent during generation are standardized using `convertTools
|
|
|
37
37
|
|
|
38
38
|
### Workflows
|
|
39
39
|
|
|
40
|
-
With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section
|
|
40
|
+
With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section in Studio.
|
|
41
41
|
|
|
42
42
|

|
|
43
43
|
|
|
@@ -29,7 +29,7 @@ Monitor and debug your applications with detailed output logs, deployment state,
|
|
|
29
29
|
|
|
30
30
|
Key features:
|
|
31
31
|
|
|
32
|
-
The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a
|
|
32
|
+
The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a Studio for testing agents and workflows.
|
|
33
33
|
|
|
34
34
|
## Project structure
|
|
35
35
|
|