@mastra/mcp-docs-server 0.13.46-alpha.1 → 0.13.46-alpha.3
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 +10 -10
- package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +16 -16
- package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +21 -21
- package/.docs/organized/changelogs/%40mastra%2Fcore.md +11 -11
- package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +17 -17
- package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +28 -28
- package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +17 -17
- package/.docs/organized/changelogs/%40mastra%2Fmcp.md +23 -23
- package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +19 -19
- package/.docs/organized/changelogs/%40mastra%2Freact.md +15 -15
- package/.docs/organized/changelogs/%40mastra%2Fserver.md +15 -15
- package/.docs/raw/agents/overview.mdx +17 -2
- package/.docs/raw/mcp/overview.mdx +6 -0
- package/.docs/raw/observability/ai-tracing/exporters/otel.mdx +67 -1
- package/.docs/raw/observability/ai-tracing/overview.mdx +1 -1
- package/.docs/raw/reference/index.mdx +1 -0
- package/.docs/raw/reference/tools/mcp-server.mdx +72 -1
- package/CHANGELOG.md +16 -0
- package/package.json +5 -5
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# @mastra/agent-builder
|
|
2
2
|
|
|
3
|
+
## 0.2.6-alpha.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Fix install step validation error by making targetPath optional in InstallInputSchema. This resolves the "expected string, received undefined" error when running the agent builder template workflow without explicitly providing a targetPath parameter. ([#10923](https://github.com/mastra-ai/mastra/pull/10923))
|
|
8
|
+
|
|
9
|
+
- Updated dependencies []:
|
|
10
|
+
- @mastra/core@0.24.7-alpha.3
|
|
11
|
+
|
|
3
12
|
## 0.2.6-alpha.0
|
|
4
13
|
|
|
5
14
|
### Patch Changes
|
|
@@ -489,14 +498,5 @@
|
|
|
489
498
|
|
|
490
499
|
- Updated dependencies [[`85ef90b`](https://github.com/mastra-ai/mastra/commit/85ef90bb2cd4ae4df855c7ac175f7d392c55c1bf), [`de3cbc6`](https://github.com/mastra-ai/mastra/commit/de3cbc61079211431bd30487982ea3653517278e)]:
|
|
491
500
|
- @mastra/core@0.15.3-alpha.5
|
|
492
|
-
- @mastra/memory@0.14.3-alpha.2
|
|
493
|
-
|
|
494
|
-
## 0.0.1-alpha.2
|
|
495
|
-
|
|
496
|
-
### Patch Changes
|
|
497
|
-
|
|
498
|
-
- [#5816](https://github.com/mastra-ai/mastra/pull/5816) [`ab48c97`](https://github.com/mastra-ai/mastra/commit/ab48c979098ea571faf998a55d3a00e7acd7a715) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
|
|
499
|
-
- Updated dependency [`zod@^3.25.76` ↗︎](https://www.npmjs.com/package/zod/v/3.25.76) (from `^3.25.67`, in `dependencies`)
|
|
500
|
-
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 28 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,20 @@
|
|
|
1
1
|
# @mastra/ai-sdk
|
|
2
2
|
|
|
3
|
+
## 0.3.3-alpha.0
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Return NetworkDataPart on each agent-execution-event and workflow-execution-event in network streams ([#10979](https://github.com/mastra-ai/mastra/pull/10979))
|
|
8
|
+
|
|
9
|
+
- Fixed tool-call-suspended chunks being dropped in workflow-step-output when using AI SDK. Previously, when an agent inside a workflow step called a tool that got suspended, the tool-call-suspended chunk was not received on the frontend even though tool-input-available chunks were correctly received. ([#10988](https://github.com/mastra-ai/mastra/pull/10988))
|
|
10
|
+
|
|
11
|
+
The issue occurred because tool-call-suspended was not included in the isMastraTextStreamChunk list, causing it to be filtered out in transformWorkflow. Now tool-call-suspended, tool-call-approval, object, and tripwire chunks are properly included in the text stream chunk list and will be transformed and passed through correctly.
|
|
12
|
+
|
|
13
|
+
Fixes #10978
|
|
14
|
+
|
|
15
|
+
- Updated dependencies []:
|
|
16
|
+
- @mastra/core@0.24.7-alpha.3
|
|
17
|
+
|
|
3
18
|
## 0.3.2
|
|
4
19
|
|
|
5
20
|
### Patch Changes
|
|
@@ -483,20 +498,5 @@
|
|
|
483
498
|
|
|
484
499
|
- Make sure agent Id is part of the data-tool-agent heuristic: ([#8592](https://github.com/mastra-ai/mastra/pull/8592))
|
|
485
500
|
|
|
486
|
-
- Add support for streaming nested agent tools ([#8580](https://github.com/mastra-ai/mastra/pull/8580))
|
|
487
|
-
|
|
488
|
-
- Updated dependencies [[`c621613`](https://github.com/mastra-ai/mastra/commit/c621613069173c69eb2c3ef19a5308894c6549f0), [`12b1189`](https://github.com/mastra-ai/mastra/commit/12b118942445e4de0dd916c593e33ec78dc3bc73), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`076b092`](https://github.com/mastra-ai/mastra/commit/076b0924902ff0f49d5712d2df24c4cca683713f), [`2aee9e7`](https://github.com/mastra-ai/mastra/commit/2aee9e7d188b8b256a4ddc203ccefb366b4867fa), [`c582906`](https://github.com/mastra-ai/mastra/commit/c5829065a346260f96c4beb8af131b94804ae3ad), [`fa2eb96`](https://github.com/mastra-ai/mastra/commit/fa2eb96af16c7d433891a73932764960d3235c1d), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`a739d0c`](https://github.com/mastra-ai/mastra/commit/a739d0c8b37cd89569e04a6ca0827083c6167e19), [`603e927`](https://github.com/mastra-ai/mastra/commit/603e9279db8bf8a46caf83881c6b7389ccffff7e), [`cd45982`](https://github.com/mastra-ai/mastra/commit/cd4598291cda128a88738734ae6cbef076ebdebd), [`874f74d`](https://github.com/mastra-ai/mastra/commit/874f74da4b1acf6517f18132d035612c3ecc394a), [`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d), [`0baf2ba`](https://github.com/mastra-ai/mastra/commit/0baf2bab8420277072ef1f95df5ea7b0a2f61fe7), [`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0), [`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86), [`26e968d`](https://github.com/mastra-ai/mastra/commit/26e968db2171ded9e4d47aa1b4f19e1e771158d0), [`cbd3fb6`](https://github.com/mastra-ai/mastra/commit/cbd3fb65adb03a7c0df193cb998aed5ac56675ee)]:
|
|
489
|
-
- @mastra/core@0.20.1
|
|
490
|
-
|
|
491
|
-
## 0.1.1-alpha.1
|
|
492
|
-
|
|
493
|
-
### Patch Changes
|
|
494
|
-
|
|
495
|
-
- Add support for streaming nested agent tools ([#8580](https://github.com/mastra-ai/mastra/pull/8580))
|
|
496
|
-
|
|
497
|
-
- Updated dependencies [[`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86)]:
|
|
498
|
-
- @mastra/core@0.20.1-alpha.3
|
|
499
|
-
|
|
500
|
-
## 0.1.1-alpha.0
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 206 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,25 @@
|
|
|
1
1
|
# @mastra/client-js
|
|
2
2
|
|
|
3
|
+
## 0.17.0-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies []:
|
|
8
|
+
- @mastra/core@0.24.7-alpha.3
|
|
9
|
+
|
|
10
|
+
## 0.17.0-alpha.2
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- The client-js package had its own simpler zodToJsonSchema implementation that was missing critical features from schema-compat. This could cause issues when users pass Zod schemas with `z.record()` or `z.date()` through the MastraClient. ([#10925](https://github.com/mastra-ai/mastra/pull/10925))
|
|
15
|
+
|
|
16
|
+
Now the client uses the same implementation as the rest of the codebase, which includes the Zod v4 `z.record()` bug fix, date-time format conversion for `z.date()`, and proper handling of unrepresentable types.
|
|
17
|
+
|
|
18
|
+
Also removes the now-unused `zod-to-json-schema` dependency from client-js.
|
|
19
|
+
|
|
20
|
+
- Updated dependencies [[`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
21
|
+
- @mastra/core@0.24.7-alpha.2
|
|
22
|
+
|
|
3
23
|
## 0.17.0-alpha.1
|
|
4
24
|
|
|
5
25
|
### Minor Changes
|
|
@@ -479,24 +499,4 @@
|
|
|
479
499
|
|
|
480
500
|
- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
|
|
481
501
|
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
|
|
485
|
-
- @mastra/core@0.20.0
|
|
486
|
-
|
|
487
|
-
## 0.15.0-alpha.0
|
|
488
|
-
|
|
489
|
-
### Minor Changes
|
|
490
|
-
|
|
491
|
-
- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
|
|
492
|
-
|
|
493
|
-
### Patch Changes
|
|
494
|
-
|
|
495
|
-
- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
|
|
496
|
-
|
|
497
|
-
- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
|
|
498
|
-
|
|
499
|
-
- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
|
|
500
|
-
- @mastra/core@0.20.0-alpha.0
|
|
501
|
-
|
|
502
|
-
... 3043 more lines hidden. See full changelog in package directory.
|
|
502
|
+
... 3063 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# @mastra/core
|
|
2
2
|
|
|
3
|
+
## 0.24.7-alpha.3
|
|
4
|
+
|
|
5
|
+
## 0.24.7-alpha.2
|
|
6
|
+
|
|
7
|
+
### Patch Changes
|
|
8
|
+
|
|
9
|
+
- Fix writer.custom not working during workflow resume operations ([#10921](https://github.com/mastra-ai/mastra/pull/10921))
|
|
10
|
+
|
|
11
|
+
When a workflow step is resumed, the writer parameter was not being properly passed through, causing writer.custom() calls to fail. This fix ensures the writableStream parameter is correctly passed to both run.resume() and run.start() calls in the workflow execution engine, allowing custom events to be emitted properly during resume operations.
|
|
12
|
+
|
|
3
13
|
## 0.24.7-alpha.1
|
|
4
14
|
|
|
5
15
|
### Patch Changes
|
|
@@ -488,15 +498,5 @@
|
|
|
488
498
|
|
|
489
499
|
Fixes issues where thread and messages were not saved before suspension when tools require approval or call suspend() during execution. This caused conversation history to be lost if users refreshed during tool approval or suspension.
|
|
490
500
|
|
|
491
|
-
**Backend changes (@mastra/core):**
|
|
492
|
-
- Add assistant messages to messageList immediately after LLM execution
|
|
493
|
-
- Flush messages synchronously before suspension to persist state
|
|
494
|
-
- Create thread if it doesn't exist before flushing
|
|
495
|
-
- Add metadata helpers to persist and remove tool approval state
|
|
496
|
-
- Pass saveQueueManager and memory context through workflow for immediate persistence
|
|
497
|
-
|
|
498
|
-
**Frontend changes (@mastra/react):**
|
|
499
|
-
- Extract runId from pending approvals to enable resumption after refresh
|
|
500
|
-
- Convert `pendingToolApprovals` (DB format) to `requireApprovalMetadata` (runtime format)
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 5409 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @mastra/deployer-cloud
|
|
2
2
|
|
|
3
|
+
## 0.24.7-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`6c13ef3`](https://github.com/mastra-ai/mastra/commit/6c13ef39887dca28f1393dd6ac33be562fcd8731), [`ae6c0f8`](https://github.com/mastra-ai/mastra/commit/ae6c0f87231cd4f0a6204f2ce188f05875fd9bf5)]:
|
|
8
|
+
- @mastra/deployer@0.24.7-alpha.3
|
|
9
|
+
- @mastra/core@0.24.7-alpha.3
|
|
10
|
+
|
|
11
|
+
## 0.24.7-alpha.2
|
|
12
|
+
|
|
13
|
+
### Patch Changes
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
16
|
+
- @mastra/core@0.24.7-alpha.2
|
|
17
|
+
- @mastra/deployer@0.24.7-alpha.2
|
|
18
|
+
|
|
3
19
|
## 0.24.7-alpha.1
|
|
4
20
|
|
|
5
21
|
### Patch Changes
|
|
@@ -483,20 +499,4 @@
|
|
|
483
499
|
|
|
484
500
|
### Patch Changes
|
|
485
501
|
|
|
486
|
-
|
|
487
|
-
- @mastra/core@0.19.1
|
|
488
|
-
- @mastra/deployer@0.19.1
|
|
489
|
-
|
|
490
|
-
## 0.19.1-alpha.1
|
|
491
|
-
|
|
492
|
-
### Patch Changes
|
|
493
|
-
|
|
494
|
-
- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead)]:
|
|
495
|
-
- @mastra/core@0.19.1-alpha.1
|
|
496
|
-
- @mastra/deployer@0.19.1-alpha.1
|
|
497
|
-
|
|
498
|
-
## 0.19.1-alpha.0
|
|
499
|
-
|
|
500
|
-
### Patch Changes
|
|
501
|
-
|
|
502
|
-
... 579 more lines hidden. See full changelog in package directory.
|
|
502
|
+
... 595 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,32 @@
|
|
|
1
1
|
# @mastra/deployer
|
|
2
2
|
|
|
3
|
+
## 0.24.7-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Fixed bundling to correctly exclude subpath imports of external packages. Previously, when a package like `lodash` was marked as external, subpath imports such as `lodash/merge` were still being bundled incorrectly. Now all subpaths are properly excluded. ([#10596](https://github.com/mastra-ai/mastra/pull/10596))
|
|
8
|
+
|
|
9
|
+
Fixes #10055
|
|
10
|
+
|
|
11
|
+
- Improved error messages when bundling fails during deployment. ([#10997](https://github.com/mastra-ai/mastra/pull/10997))
|
|
12
|
+
|
|
13
|
+
**What changed:**
|
|
14
|
+
- Build errors now show clearer messages that identify the problematic package
|
|
15
|
+
- Added detection for common issues like missing native builds and unresolved modules
|
|
16
|
+
- Errors in workspace packages are now properly identified with actionable guidance
|
|
17
|
+
|
|
18
|
+
- Updated dependencies []:
|
|
19
|
+
- @mastra/server@0.24.7-alpha.3
|
|
20
|
+
- @mastra/core@0.24.7-alpha.3
|
|
21
|
+
|
|
22
|
+
## 0.24.7-alpha.2
|
|
23
|
+
|
|
24
|
+
### Patch Changes
|
|
25
|
+
|
|
26
|
+
- Updated dependencies [[`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
27
|
+
- @mastra/core@0.24.7-alpha.2
|
|
28
|
+
- @mastra/server@0.24.7-alpha.2
|
|
29
|
+
|
|
3
30
|
## 0.24.7-alpha.1
|
|
4
31
|
|
|
5
32
|
### Patch Changes
|
|
@@ -471,32 +498,5 @@
|
|
|
471
498
|
|
|
472
499
|
- Updated dependencies [[`1908ca0`](https://github.com/mastra-ai/mastra/commit/1908ca0521f90e43779cc29ab590173ca560443c)]:
|
|
473
500
|
- @mastra/server@0.21.0-alpha.4
|
|
474
|
-
- @mastra/core@0.21.0-alpha.4
|
|
475
|
-
|
|
476
|
-
## 0.21.0-alpha.3
|
|
477
|
-
|
|
478
|
-
### Patch Changes
|
|
479
|
-
|
|
480
|
-
- Updated dependencies [[`a1799bc`](https://github.com/mastra-ai/mastra/commit/a1799bcc1b5a1cdc188f2ac0165f17a1c4ac6f7b), [`6ff6094`](https://github.com/mastra-ai/mastra/commit/6ff60946f4ecfebdeef6e21d2b230c2204f2c9b8)]:
|
|
481
|
-
- @mastra/core@0.21.0-alpha.3
|
|
482
|
-
- @mastra/server@0.21.0-alpha.3
|
|
483
|
-
|
|
484
|
-
## 0.21.0-alpha.2
|
|
485
|
-
|
|
486
|
-
### Patch Changes
|
|
487
|
-
|
|
488
|
-
- Updated dependencies [[`f59fc1e`](https://github.com/mastra-ai/mastra/commit/f59fc1e406b8912e692f6bff6cfd4754cc8d165c)]:
|
|
489
|
-
- @mastra/core@0.21.0-alpha.2
|
|
490
|
-
- @mastra/server@0.21.0-alpha.2
|
|
491
|
-
|
|
492
|
-
## 0.21.0-alpha.1
|
|
493
|
-
|
|
494
|
-
### Patch Changes
|
|
495
|
-
|
|
496
|
-
- Add typescript to global externals to reduce bundling OOM ([#8789](https://github.com/mastra-ai/mastra/pull/8789))
|
|
497
|
-
|
|
498
|
-
- Improve error handling formatting in dev/build bundling. ([#8792](https://github.com/mastra-ai/mastra/pull/8792))
|
|
499
|
-
|
|
500
|
-
- Remove validation step in bundling process ([#8778](https://github.com/mastra-ai/mastra/pull/8778))
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 4973 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 0.13.46-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`d1e8539`](https://github.com/mastra-ai/mastra/commit/d1e853959339dc11bd306a1cd3431f35c410f715)]:
|
|
8
|
+
- @mastra/mcp@0.14.5-alpha.1
|
|
9
|
+
- @mastra/core@0.24.7-alpha.3
|
|
10
|
+
|
|
11
|
+
## 0.13.46-alpha.2
|
|
12
|
+
|
|
13
|
+
### Patch Changes
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`6c38116`](https://github.com/mastra-ai/mastra/commit/6c381162fc107bfe1271284a90a507d9e3304241), [`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
16
|
+
- @mastra/mcp@0.14.5-alpha.0
|
|
17
|
+
- @mastra/core@0.24.7-alpha.2
|
|
18
|
+
|
|
3
19
|
## 0.13.46-alpha.1
|
|
4
20
|
|
|
5
21
|
### Patch Changes
|
|
@@ -482,21 +498,5 @@
|
|
|
482
498
|
|
|
483
499
|
### Patch Changes
|
|
484
500
|
|
|
485
|
-
- dependencies updates: ([#7907](https://github.com/mastra-ai/mastra/pull/7907))
|
|
486
|
-
- Updated dependency [`turndown@^7.2.1` ↗︎](https://www.npmjs.com/package/turndown/v/7.2.1) (from `^7.2.0`, in `dependencies`)
|
|
487
|
-
|
|
488
|
-
- Update peerdep of @mastra/core ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
|
|
489
|
-
|
|
490
|
-
- Updated dependencies [[`197cbb2`](https://github.com/mastra-ai/mastra/commit/197cbb248fc8cb4bbf61bf70b770f1388b445df2), [`a1bb887`](https://github.com/mastra-ai/mastra/commit/a1bb887e8bfae44230f487648da72e96ef824561), [`6590763`](https://github.com/mastra-ai/mastra/commit/65907630ef4bf4127067cecd1cb21b56f55d5f1b), [`fb84c21`](https://github.com/mastra-ai/mastra/commit/fb84c21859d09bdc8f158bd5412bdc4b5835a61c), [`5802bf5`](https://github.com/mastra-ai/mastra/commit/5802bf57f6182e4b67c28d7d91abed349a8d14f3), [`5bda53a`](https://github.com/mastra-ai/mastra/commit/5bda53a9747bfa7d876d754fc92c83a06e503f62), [`c2eade3`](https://github.com/mastra-ai/mastra/commit/c2eade3508ef309662f065e5f340d7840295dd53), [`f26a8fd`](https://github.com/mastra-ai/mastra/commit/f26a8fd99fcb0497a5d86c28324430d7f6a5fb83), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382), [`222965a`](https://github.com/mastra-ai/mastra/commit/222965a98ce8197b86673ec594244650b5960257), [`6047778`](https://github.com/mastra-ai/mastra/commit/6047778e501df460648f31decddf8e443f36e373), [`a0f5f1c`](https://github.com/mastra-ai/mastra/commit/a0f5f1ca39c3c5c6d26202e9fcab986b4fe14568), [`9d4fc09`](https://github.com/mastra-ai/mastra/commit/9d4fc09b2ad55caa7738c7ceb3a905e454f74cdd), [`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`0324ceb`](https://github.com/mastra-ai/mastra/commit/0324ceb8af9d16c12a531f90e575f6aab797ac81), [`d75ccf0`](https://github.com/mastra-ai/mastra/commit/d75ccf06dfd2582b916aa12624e3cd61b279edf1), [`0f9d227`](https://github.com/mastra-ai/mastra/commit/0f9d227890a98db33865abbea39daf407cd55ef7), [`b356f5f`](https://github.com/mastra-ai/mastra/commit/b356f5f7566cb3edb755d91f00b72fc1420b2a37), [`de056a0`](https://github.com/mastra-ai/mastra/commit/de056a02cbb43f6aa0380ab2150ea404af9ec0dd), [`f5ce05f`](https://github.com/mastra-ai/mastra/commit/f5ce05f831d42c69559bf4c0fdb46ccb920fc3a3), [`60c9cec`](https://github.com/mastra-ai/mastra/commit/60c9cec7048a79a87440f7840c383875bd710d93), [`c93532a`](https://github.com/mastra-ai/mastra/commit/c93532a340b80e4dd946d4c138d9381de5f70399), [`6cb1fcb`](https://github.com/mastra-ai/mastra/commit/6cb1fcbc8d0378ffed0d17784c96e68f30cb0272), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a), [`9f6f30f`](https://github.com/mastra-ai/mastra/commit/9f6f30f04ec6648bbca798ea8aad59317c40d8db), [`547c621`](https://github.com/mastra-ai/mastra/commit/547c62104af3f7a551b3754e9cbdf0a3fbba15e4), [`897995e`](https://github.com/mastra-ai/mastra/commit/897995e630d572fe2891e7ede817938cabb43251), [`0fed8f2`](https://github.com/mastra-ai/mastra/commit/0fed8f2aa84b167b3415ea6f8f70755775132c8d), [`4f9ea8c`](https://github.com/mastra-ai/mastra/commit/4f9ea8c95ea74ba9abbf3b2ab6106c7d7bc45689), [`1a1fbe6`](https://github.com/mastra-ai/mastra/commit/1a1fbe66efb7d94abc373ed0dd9676adb8122454), [`d706fad`](https://github.com/mastra-ai/mastra/commit/d706fad6e6e4b72357b18d229ba38e6c913c0e70), [`87fd07f`](https://github.com/mastra-ai/mastra/commit/87fd07ff35387a38728967163460231b5d33ae3b), [`5c3768f`](https://github.com/mastra-ai/mastra/commit/5c3768fa959454232ad76715c381f4aac00c6881), [`2685a78`](https://github.com/mastra-ai/mastra/commit/2685a78f224b8b04e20d4fab5ac1adb638190071), [`36f39c0`](https://github.com/mastra-ai/mastra/commit/36f39c00dc794952dc3c11aab91c2fa8bca74b11), [`239b5a4`](https://github.com/mastra-ai/mastra/commit/239b5a497aeae2e8b4d764f46217cfff2284788e), [`8a3f5e4`](https://github.com/mastra-ai/mastra/commit/8a3f5e4212ec36b302957deb4bd47005ab598382)]:
|
|
491
|
-
- @mastra/core@0.17.0
|
|
492
|
-
- @mastra/mcp@0.13.0
|
|
493
|
-
|
|
494
|
-
## 0.13.22-alpha.8
|
|
495
|
-
|
|
496
|
-
### Patch Changes
|
|
497
|
-
|
|
498
|
-
- Updated dependencies [[`05c7abf`](https://github.com/mastra-ai/mastra/commit/05c7abfe105a015b7760c9bf33ff4419727502a0), [`aee4f00`](https://github.com/mastra-ai/mastra/commit/aee4f00e61e1a42e81a6d74ff149dbe69e32695a)]:
|
|
499
|
-
- @mastra/core@0.17.0-alpha.8
|
|
500
|
-
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 2103 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,27 @@
|
|
|
1
1
|
# @mastra/mcp
|
|
2
2
|
|
|
3
|
+
## 0.14.5-alpha.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Fix MCPClient automatic reconnection when session becomes invalid ([#10993](https://github.com/mastra-ai/mastra/pull/10993))
|
|
8
|
+
|
|
9
|
+
When an MCP server restarts, the session ID becomes invalid causing "Bad Request: No valid session ID provided" errors. The MCPClient now automatically detects session-related errors, reconnects to the server, and retries the tool call.
|
|
10
|
+
|
|
11
|
+
This fix addresses issue #7675 where MCPClient would fail to reconnect after an MCP server went offline and came back online.
|
|
12
|
+
|
|
13
|
+
- Updated dependencies []:
|
|
14
|
+
- @mastra/core@0.24.7-alpha.3
|
|
15
|
+
|
|
16
|
+
## 0.14.5-alpha.0
|
|
17
|
+
|
|
18
|
+
### Patch Changes
|
|
19
|
+
|
|
20
|
+
- add flag to skip sessions and streaming in serverless mcp ([#10927](https://github.com/mastra-ai/mastra/pull/10927))
|
|
21
|
+
|
|
22
|
+
- Updated dependencies [[`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
23
|
+
- @mastra/core@0.24.7-alpha.2
|
|
24
|
+
|
|
3
25
|
## 0.14.4
|
|
4
26
|
|
|
5
27
|
### Patch Changes
|
|
@@ -476,27 +498,5 @@
|
|
|
476
498
|
|
|
477
499
|
### Patch Changes
|
|
478
500
|
|
|
479
|
-
- [#6643](https://github.com/mastra-ai/mastra/pull/6643) [`e38f807`](https://github.com/mastra-ai/mastra/commit/e38f8072853cc803ba48394e1930825129708400) Thanks [@dane-ai-mastra](https://github.com/apps/dane-ai-mastra)! - dependencies updates:
|
|
480
|
-
- Updated dependency [`@modelcontextprotocol/sdk@^1.17.3` ↗︎](https://www.npmjs.com/package/@modelcontextprotocol/sdk/v/1.17.3) (from `^1.17.0`, in `dependencies`)
|
|
481
|
-
- Updated dependencies [[`0778757`](https://github.com/mastra-ai/mastra/commit/07787570e4addbd501522037bd2542c3d9e26822), [`bf504a8`](https://github.com/mastra-ai/mastra/commit/bf504a833051f6f321d832cc7d631f3cb86d657b), [`e6f5046`](https://github.com/mastra-ai/mastra/commit/e6f50467aff317e67e8bd74c485c3fbe2a5a6db1), [`9613558`](https://github.com/mastra-ai/mastra/commit/9613558e6475f4710e05d1be7553a32ee7bddc20)]:
|
|
482
|
-
- @mastra/core@0.14.2-alpha.0
|
|
483
|
-
|
|
484
|
-
## 0.10.12
|
|
485
|
-
|
|
486
|
-
### Patch Changes
|
|
487
|
-
|
|
488
|
-
- 895d3b2: Update the MCP SDK version and update elicitation to match new spec (reject becomes decline)
|
|
489
|
-
- e1aed55: Fixed an issue where keep-alive messages were interfering with endpoint messages on initial SSE connection
|
|
490
|
-
- 03997ae: Update peerdeps
|
|
491
|
-
- Updated dependencies [227c7e6]
|
|
492
|
-
- Updated dependencies [12cae67]
|
|
493
|
-
- Updated dependencies [fd3a3eb]
|
|
494
|
-
- Updated dependencies [6faaee5]
|
|
495
|
-
- Updated dependencies [4232b14]
|
|
496
|
-
- Updated dependencies [a89de7e]
|
|
497
|
-
- Updated dependencies [5a37d0c]
|
|
498
|
-
- Updated dependencies [4bde0cb]
|
|
499
|
-
- Updated dependencies [cf4f357]
|
|
500
|
-
- Updated dependencies [ad888a2]
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 2376 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,23 @@
|
|
|
1
1
|
# @mastra/playground-ui
|
|
2
2
|
|
|
3
|
+
## 7.0.0-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies []:
|
|
8
|
+
- @mastra/core@0.24.7-alpha.3
|
|
9
|
+
- @mastra/client-js@0.17.0-alpha.3
|
|
10
|
+
- @mastra/react@0.0.22-alpha.3
|
|
11
|
+
|
|
12
|
+
## 7.0.0-alpha.2
|
|
13
|
+
|
|
14
|
+
### Patch Changes
|
|
15
|
+
|
|
16
|
+
- Updated dependencies [[`461f5f7`](https://github.com/mastra-ai/mastra/commit/461f5f747ce07d77dc048cf0f5df44744183c3c3), [`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
17
|
+
- @mastra/client-js@0.17.0-alpha.2
|
|
18
|
+
- @mastra/core@0.24.7-alpha.2
|
|
19
|
+
- @mastra/react@0.0.22-alpha.2
|
|
20
|
+
|
|
3
21
|
## 7.0.0-alpha.1
|
|
4
22
|
|
|
5
23
|
### Patch Changes
|
|
@@ -481,22 +499,4 @@
|
|
|
481
499
|
|
|
482
500
|
- Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
|
|
483
501
|
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
- Fix back the tripwire verification inside the new react system ([#8674](https://github.com/mastra-ai/mastra/pull/8674))
|
|
487
|
-
|
|
488
|
-
- Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
|
|
489
|
-
|
|
490
|
-
- Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
|
|
491
|
-
|
|
492
|
-
- Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
|
|
493
|
-
|
|
494
|
-
- handle error case in react sdk ([#8676](https://github.com/mastra-ai/mastra/pull/8676))
|
|
495
|
-
|
|
496
|
-
- Make sure to convert the agent instructions when showing them ([#8702](https://github.com/mastra-ai/mastra/pull/8702))
|
|
497
|
-
|
|
498
|
-
- Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
|
|
499
|
-
|
|
500
|
-
- Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
|
|
501
|
-
|
|
502
|
-
... 3949 more lines hidden. See full changelog in package directory.
|
|
502
|
+
... 3967 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @mastra/react-hooks
|
|
2
2
|
|
|
3
|
+
## 0.0.22-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies []:
|
|
8
|
+
- @mastra/client-js@0.17.0-alpha.3
|
|
9
|
+
|
|
10
|
+
## 0.0.22-alpha.2
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [[`461f5f7`](https://github.com/mastra-ai/mastra/commit/461f5f747ce07d77dc048cf0f5df44744183c3c3)]:
|
|
15
|
+
- @mastra/client-js@0.17.0-alpha.2
|
|
16
|
+
|
|
3
17
|
## 0.0.22-alpha.1
|
|
4
18
|
|
|
5
19
|
### Patch Changes
|
|
@@ -484,19 +498,5 @@
|
|
|
484
498
|
|
|
485
499
|
## 0.0.2
|
|
486
500
|
|
|
487
|
-
### Patch Changes
|
|
488
|
-
|
|
489
|
-
- Updated dependencies []:
|
|
490
|
-
- @mastra/client-js@0.14.1
|
|
491
|
-
|
|
492
|
-
## 0.0.2-alpha.1
|
|
493
|
-
|
|
494
|
-
### Patch Changes
|
|
495
|
-
|
|
496
|
-
- Updated dependencies []:
|
|
497
|
-
- @mastra/client-js@0.14.1-alpha.1
|
|
498
|
-
|
|
499
|
-
## 0.0.2-alpha.0
|
|
500
|
-
|
|
501
501
|
|
|
502
|
-
...
|
|
502
|
+
... 44 more lines hidden. See full changelog in package directory.
|
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @mastra/server
|
|
2
2
|
|
|
3
|
+
## 0.24.7-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies []:
|
|
8
|
+
- @mastra/core@0.24.7-alpha.3
|
|
9
|
+
|
|
10
|
+
## 0.24.7-alpha.2
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [[`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
15
|
+
- @mastra/core@0.24.7-alpha.2
|
|
16
|
+
|
|
3
17
|
## 0.24.7-alpha.1
|
|
4
18
|
|
|
5
19
|
### Patch Changes
|
|
@@ -485,18 +499,4 @@
|
|
|
485
499
|
|
|
486
500
|
### Patch Changes
|
|
487
501
|
|
|
488
|
-
|
|
489
|
-
- @mastra/core@0.20.1-alpha.4
|
|
490
|
-
|
|
491
|
-
## 0.20.1-alpha.3
|
|
492
|
-
|
|
493
|
-
### Patch Changes
|
|
494
|
-
|
|
495
|
-
- Fix TypeScript errors with provider-defined tools by updating ai-v5 and openai-v5 to matching provider-utils versions. This ensures npm deduplicates to a single provider-utils instance, resolving type incompatibility issues when passing provider tools to Agent. ([#8584](https://github.com/mastra-ai/mastra/pull/8584))
|
|
496
|
-
|
|
497
|
-
Also adds deprecation warning to Agent import from root path to encourage using the recommended subpath import.
|
|
498
|
-
|
|
499
|
-
- Updated dependencies [[`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86)]:
|
|
500
|
-
- @mastra/core@0.20.1-alpha.3
|
|
501
|
-
|
|
502
|
-
... 3913 more lines hidden. See full changelog in package directory.
|
|
502
|
+
... 3927 more lines hidden. See full changelog in package directory.
|
|
@@ -355,9 +355,9 @@ const response = await testAgent.generate(
|
|
|
355
355
|
console.log(response.object);
|
|
356
356
|
```
|
|
357
357
|
|
|
358
|
-
###
|
|
358
|
+
### Structuring sub agent
|
|
359
359
|
|
|
360
|
-
Use the `model` property to
|
|
360
|
+
Use the `model` property to have a separate agent generate the structured output for you.
|
|
361
361
|
|
|
362
362
|
```typescript showLineNumbers copy
|
|
363
363
|
import { z } from "zod";
|
|
@@ -420,6 +420,21 @@ const response = await testAgentThatDoesntSupportStructuredOutput.generate(
|
|
|
420
420
|
console.log(response.object);
|
|
421
421
|
```
|
|
422
422
|
|
|
423
|
+
:::info[Gemini 2.5 with tools]
|
|
424
|
+
|
|
425
|
+
Gemini 2.5 models do not support combining `response_format` (structured output) with function calling (tools) in the same API call. If your agent has tools and you're using `structuredOutput` with a Gemini 2.5 model, you must set `jsonPromptInjection: true` to avoid the error `Function calling with a response mime type: 'application/json' is unsupported`.
|
|
426
|
+
|
|
427
|
+
```typescript
|
|
428
|
+
const response = await agentWithTools.generate("Your prompt", {
|
|
429
|
+
structuredOutput: {
|
|
430
|
+
schema: yourSchema,
|
|
431
|
+
jsonPromptInjection: true, // Required for Gemini 2.5 when tools are present
|
|
432
|
+
},
|
|
433
|
+
});
|
|
434
|
+
```
|
|
435
|
+
|
|
436
|
+
:::
|
|
437
|
+
|
|
423
438
|
## Using tools
|
|
424
439
|
|
|
425
440
|
Agents can use tools to go beyond language generation, enabling structured interactions with external APIs and services. Tools allow agents to access data and perform clearly defined operations in a reliable, repeatable way.
|
|
@@ -99,6 +99,12 @@ export const testMcpServer = new MCPServer({
|
|
|
99
99
|
|
|
100
100
|
> See [MCPServer](/reference/tools/mcp-server) for a full list of configuration options.
|
|
101
101
|
|
|
102
|
+
### Serverless deployments
|
|
103
|
+
|
|
104
|
+
`MCPServer` can be deployed in serverless environments (Cloudflare Workers, Vercel Edge Functions, AWS Lambda, etc.) by enabling the `serverless: true` option in `startHTTP()`. This runs the server in stateless mode, where each request is handled independently without session management.
|
|
105
|
+
|
|
106
|
+
**Note:** Some MCP features require persistent connections and won't work in serverless mode, including elicitation, resource subscriptions, and update notifications. See the [serverless section](/reference/tools/mcp-server#starthttp) in the API reference for full details and limitations.
|
|
107
|
+
|
|
102
108
|
## Registering an `MCPServer`
|
|
103
109
|
|
|
104
110
|
To make an MCP server available to other systems or agents that support the protocol, register it in the main `Mastra` instance using `mcpServers`.
|
|
@@ -33,7 +33,7 @@ Each provider requires specific protocol packages. Install the base exporter plu
|
|
|
33
33
|
npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
### For gRPC Providers (Dash0)
|
|
36
|
+
### For gRPC Providers (Dash0, Datadog)
|
|
37
37
|
|
|
38
38
|
```bash npm2yarn
|
|
39
39
|
npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
|
|
@@ -148,6 +148,71 @@ new OtelExporter({
|
|
|
148
148
|
});
|
|
149
149
|
```
|
|
150
150
|
|
|
151
|
+
### Datadog
|
|
152
|
+
|
|
153
|
+
[Datadog](https://www.datadoghq.com/) APM provides application performance monitoring with distributed tracing. To send traces to Datadog via OTLP, you need the Datadog Agent running with OTLP ingestion enabled.
|
|
154
|
+
|
|
155
|
+
Datadog uses gRPC for OTLP ingestion, which requires explicit imports and bundler configuration to work correctly:
|
|
156
|
+
|
|
157
|
+
```typescript title="src/mastra/index.ts"
|
|
158
|
+
// Explicitly import gRPC dependencies for the bundler
|
|
159
|
+
import "@grpc/grpc-js";
|
|
160
|
+
import "@opentelemetry/exporter-trace-otlp-grpc";
|
|
161
|
+
import { Mastra } from "@mastra/core";
|
|
162
|
+
import { OtelExporter, type ExportProtocol } from "@mastra/otel-exporter";
|
|
163
|
+
|
|
164
|
+
export const mastra = new Mastra({
|
|
165
|
+
// Add grpc-js to externals so it's handled at runtime
|
|
166
|
+
bundler: {
|
|
167
|
+
externals: ["@grpc/grpc-js"],
|
|
168
|
+
},
|
|
169
|
+
|
|
170
|
+
observability: {
|
|
171
|
+
configs: {
|
|
172
|
+
default: {
|
|
173
|
+
serviceName: "my-service",
|
|
174
|
+
exporters: [
|
|
175
|
+
new OtelExporter({
|
|
176
|
+
provider: {
|
|
177
|
+
custom: {
|
|
178
|
+
endpoint:
|
|
179
|
+
process.env.OTEL_EXPORTER_OTLP_ENDPOINT ||
|
|
180
|
+
"http://localhost:4317",
|
|
181
|
+
protocol: (process.env.OTEL_EXPORTER_OTLP_PROTOCOL ||
|
|
182
|
+
"grpc") as ExportProtocol,
|
|
183
|
+
headers: {},
|
|
184
|
+
},
|
|
185
|
+
},
|
|
186
|
+
}),
|
|
187
|
+
],
|
|
188
|
+
},
|
|
189
|
+
},
|
|
190
|
+
},
|
|
191
|
+
});
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
:::info
|
|
195
|
+
|
|
196
|
+
The Datadog Agent must be configured with OTLP ingestion enabled. Add the following to your `datadog.yaml`:
|
|
197
|
+
|
|
198
|
+
```yaml
|
|
199
|
+
otlp_config:
|
|
200
|
+
receiver:
|
|
201
|
+
protocols:
|
|
202
|
+
grpc:
|
|
203
|
+
endpoint: 0.0.0.0:4317
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
The default OTLP endpoint is `http://localhost:4317` when running the Datadog Agent locally.
|
|
207
|
+
|
|
208
|
+
:::
|
|
209
|
+
|
|
210
|
+
:::warning
|
|
211
|
+
|
|
212
|
+
The explicit imports of `@grpc/grpc-js` and `@opentelemetry/exporter-trace-otlp-grpc` at the top of the file, along with the `bundler.externals` configuration, are required for the gRPC transport to work correctly. Without these, you may encounter connection issues.
|
|
213
|
+
|
|
214
|
+
:::
|
|
215
|
+
|
|
151
216
|
### Custom/Generic OTEL Endpoints
|
|
152
217
|
|
|
153
218
|
For other OTEL-compatible platforms or custom collectors:
|
|
@@ -223,6 +288,7 @@ Choose the right protocol package based on your provider:
|
|
|
223
288
|
| Provider | Protocol | Required Package |
|
|
224
289
|
| --------- | ------------- | ------------------------------------------ |
|
|
225
290
|
| Dash0 | gRPC | `@opentelemetry/exporter-trace-otlp-grpc` |
|
|
291
|
+
| Datadog | gRPC | `@opentelemetry/exporter-trace-otlp-grpc` |
|
|
226
292
|
| SigNoz | HTTP/Protobuf | `@opentelemetry/exporter-trace-otlp-proto` |
|
|
227
293
|
| New Relic | HTTP/Protobuf | `@opentelemetry/exporter-trace-otlp-proto` |
|
|
228
294
|
| Traceloop | HTTP/JSON | `@opentelemetry/exporter-trace-otlp-http` |
|
|
@@ -91,7 +91,7 @@ In addition to the internal exporters, Mastra supports integration with popular
|
|
|
91
91
|
- **[Langfuse](/docs/observability/ai-tracing/exporters/langfuse)** - Sends traces to the Langfuse open-source LLM engineering platform
|
|
92
92
|
- **[LangSmith](/docs/observability/ai-tracing/exporters/langsmith)** - Pushes traces into LangSmith's observability and evaluation toolkit
|
|
93
93
|
- **[OpenTelemetry](/docs/observability/ai-tracing/exporters/otel)** - Deliver traces to any OpenTelemetry-compatible observability system
|
|
94
|
-
- Supports: Dash0, Laminar, New Relic, SigNoz, Traceloop, Zipkin, and others!
|
|
94
|
+
- Supports: Dash0, Datadog, Laminar, New Relic, SigNoz, Traceloop, Zipkin, and others!
|
|
95
95
|
|
|
96
96
|
## Sampling Strategies
|
|
97
97
|
|
|
@@ -387,7 +387,7 @@ const httpServer = http.createServer(async (req, res) => {
|
|
|
387
387
|
req,
|
|
388
388
|
res,
|
|
389
389
|
options: {
|
|
390
|
-
sessionIdGenerator:
|
|
390
|
+
sessionIdGenerator: () => randomUUID(),
|
|
391
391
|
},
|
|
392
392
|
});
|
|
393
393
|
});
|
|
@@ -397,6 +397,70 @@ httpServer.listen(PORT, () => {
|
|
|
397
397
|
});
|
|
398
398
|
```
|
|
399
399
|
|
|
400
|
+
For **serverless environments** (Supabase Edge Functions, Cloudflare Workers, Vercel Edge, etc.), use `serverless: true` to enable stateless operation:
|
|
401
|
+
|
|
402
|
+
```typescript
|
|
403
|
+
// Supabase Edge Function example
|
|
404
|
+
import { serve } from "https://deno.land/std@0.168.0/http/server.ts";
|
|
405
|
+
import { MCPServer } from "@mastra/mcp";
|
|
406
|
+
// Note: You will need to convert req/res format from Deno to Node
|
|
407
|
+
import { toReqRes, toFetchResponse } from "fetch-to-node";
|
|
408
|
+
|
|
409
|
+
const server = new MCPServer({
|
|
410
|
+
name: "my-serverless-mcp",
|
|
411
|
+
version: "1.0.0",
|
|
412
|
+
tools: { /* your tools */ },
|
|
413
|
+
});
|
|
414
|
+
|
|
415
|
+
serve(async (req) => {
|
|
416
|
+
const url = new URL(req.url);
|
|
417
|
+
|
|
418
|
+
if (url.pathname === "/mcp") {
|
|
419
|
+
// Convert Deno Request to Node.js-compatible format
|
|
420
|
+
const { req: nodeReq, res: nodeRes } = toReqRes(req);
|
|
421
|
+
|
|
422
|
+
await server.startHTTP({
|
|
423
|
+
url,
|
|
424
|
+
httpPath: "/mcp",
|
|
425
|
+
req: nodeReq,
|
|
426
|
+
res: nodeRes,
|
|
427
|
+
options: {
|
|
428
|
+
serverless: true, // ← Enable stateless mode for serverless
|
|
429
|
+
},
|
|
430
|
+
});
|
|
431
|
+
|
|
432
|
+
return toFetchResponse(nodeRes);
|
|
433
|
+
}
|
|
434
|
+
|
|
435
|
+
return new Response("Not found", { status: 404 });
|
|
436
|
+
});
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
> **When to use `serverless: true`**
|
|
440
|
+
>
|
|
441
|
+
> Use `serverless: true` when deploying to environments where each request runs in a fresh, stateless execution context:
|
|
442
|
+
> - Supabase Edge Functions
|
|
443
|
+
> - Cloudflare Workers
|
|
444
|
+
> - Vercel Edge Functions
|
|
445
|
+
> - Netlify Edge Functions
|
|
446
|
+
> - AWS Lambda
|
|
447
|
+
> - Deno Deploy
|
|
448
|
+
>
|
|
449
|
+
> Use the default session-based mode (without `serverless: true`) for:
|
|
450
|
+
> - Long-lived Node.js servers
|
|
451
|
+
> - Docker containers
|
|
452
|
+
> - Traditional hosting (VPS, dedicated servers)
|
|
453
|
+
>
|
|
454
|
+
> The serverless mode disables session management and creates fresh server instances per request, which is necessary for stateless environments where memory doesn't persist between invocations.
|
|
455
|
+
>
|
|
456
|
+
> **Note:** The following MCP features require session state or persistent connections and will **not work** in serverless mode:
|
|
457
|
+
> - **Elicitation** - Interactive user input requests during tool execution require session management to route responses back to the correct client
|
|
458
|
+
> - **Resource subscriptions** - `resources/subscribe` and `resources/unsubscribe` need persistent connections to maintain subscription state
|
|
459
|
+
> - **Resource update notifications** - `resources.notifyUpdated()` requires active subscriptions and persistent connections to notify clients
|
|
460
|
+
> - **Prompt list change notifications** - `prompts.notifyListChanged()` requires persistent connections to push updates to clients
|
|
461
|
+
>
|
|
462
|
+
> These features work normally in long-lived server environments (Node.js servers, Docker containers, etc.).
|
|
463
|
+
|
|
400
464
|
Here are the details for the values needed by the `startHTTP` method:
|
|
401
465
|
|
|
402
466
|
<PropertiesTable
|
|
@@ -437,6 +501,13 @@ The `StreamableHTTPServerTransportOptions` object allows you to customize the be
|
|
|
437
501
|
|
|
438
502
|
<PropertiesTable
|
|
439
503
|
content={[
|
|
504
|
+
{
|
|
505
|
+
name: "serverless",
|
|
506
|
+
type: "boolean",
|
|
507
|
+
description:
|
|
508
|
+
"If `true`, runs in stateless mode without session management. Each request is handled independently with a fresh server instance. Essential for serverless environments (Cloudflare Workers, Supabase Edge Functions, Vercel Edge, etc.) where sessions cannot persist between invocations. Defaults to `false`.",
|
|
509
|
+
optional: true,
|
|
510
|
+
},
|
|
440
511
|
{
|
|
441
512
|
name: "sessionIdGenerator",
|
|
442
513
|
type: "(() => string) | undefined",
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 0.13.46-alpha.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`d1e8539`](https://github.com/mastra-ai/mastra/commit/d1e853959339dc11bd306a1cd3431f35c410f715)]:
|
|
8
|
+
- @mastra/mcp@0.14.5-alpha.1
|
|
9
|
+
- @mastra/core@0.24.7-alpha.3
|
|
10
|
+
|
|
11
|
+
## 0.13.46-alpha.2
|
|
12
|
+
|
|
13
|
+
### Patch Changes
|
|
14
|
+
|
|
15
|
+
- Updated dependencies [[`6c38116`](https://github.com/mastra-ai/mastra/commit/6c381162fc107bfe1271284a90a507d9e3304241), [`b685c9c`](https://github.com/mastra-ai/mastra/commit/b685c9c0b89f49e0d4542c4ac72569682db69794)]:
|
|
16
|
+
- @mastra/mcp@0.14.5-alpha.0
|
|
17
|
+
- @mastra/core@0.24.7-alpha.2
|
|
18
|
+
|
|
3
19
|
## 0.13.46-alpha.1
|
|
4
20
|
|
|
5
21
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "0.13.46-alpha.
|
|
3
|
+
"version": "0.13.46-alpha.3",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -33,8 +33,8 @@
|
|
|
33
33
|
"uuid": "^11.1.0",
|
|
34
34
|
"zod": "^3.25.76",
|
|
35
35
|
"zod-to-json-schema": "^3.24.6",
|
|
36
|
-
"@mastra/core": "0.24.7-alpha.
|
|
37
|
-
"@mastra/mcp": "^0.14.
|
|
36
|
+
"@mastra/core": "0.24.7-alpha.3",
|
|
37
|
+
"@mastra/mcp": "^0.14.5-alpha.1"
|
|
38
38
|
},
|
|
39
39
|
"devDependencies": {
|
|
40
40
|
"@hono/node-server": "^1.19.5",
|
|
@@ -49,8 +49,8 @@
|
|
|
49
49
|
"tsx": "^4.19.4",
|
|
50
50
|
"typescript": "^5.8.3",
|
|
51
51
|
"vitest": "^3.2.4",
|
|
52
|
-
"@
|
|
53
|
-
"@
|
|
52
|
+
"@mastra/core": "0.24.7-alpha.3",
|
|
53
|
+
"@internal/lint": "0.0.64"
|
|
54
54
|
},
|
|
55
55
|
"homepage": "https://mastra.ai",
|
|
56
56
|
"repository": {
|