@mastra/mcp-docs-server 0.13.34 → 0.13.35

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.
Files changed (42) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fchangeset-cli.md +2 -0
  2. package/.docs/organized/changelogs/%40internal%2Fexternal-types.md +2 -0
  3. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +9 -9
  4. package/.docs/organized/changelogs/%40internal%2Ftypes-builder.md +2 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +23 -23
  6. package/.docs/organized/changelogs/%40mastra%2Fcore.md +61 -61
  7. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +17 -17
  8. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +17 -17
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +17 -17
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +17 -17
  11. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +37 -37
  12. package/.docs/organized/changelogs/%40mastra%2Flance.md +19 -19
  13. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +15 -15
  14. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +19 -19
  15. package/.docs/organized/changelogs/%40mastra%2Fpg.md +19 -19
  16. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +31 -31
  17. package/.docs/organized/changelogs/%40mastra%2Freact.md +19 -19
  18. package/.docs/organized/changelogs/%40mastra%2Fserver.md +27 -27
  19. package/.docs/organized/changelogs/create-mastra.md +5 -5
  20. package/.docs/organized/changelogs/mastra.md +17 -17
  21. package/.docs/organized/code-examples/memory-with-mongodb.md +208 -0
  22. package/.docs/raw/getting-started/project-structure.mdx +1 -1
  23. package/.docs/raw/getting-started/studio.mdx +4 -4
  24. package/.docs/raw/memory/overview.mdx +1 -1
  25. package/.docs/raw/memory/semantic-recall.mdx +4 -3
  26. package/.docs/raw/memory/storage/memory-with-libsql.mdx +141 -0
  27. package/.docs/raw/memory/storage/memory-with-pg.mdx +138 -0
  28. package/.docs/raw/memory/storage/memory-with-upstash.mdx +147 -0
  29. package/.docs/raw/observability/ai-tracing/exporters/arize.mdx +201 -0
  30. package/.docs/raw/observability/ai-tracing/overview.mdx +12 -8
  31. package/.docs/raw/reference/observability/ai-tracing/exporters/arize.mdx +160 -0
  32. package/.docs/raw/reference/observability/ai-tracing/exporters/braintrust.mdx +2 -2
  33. package/.docs/raw/reference/observability/ai-tracing/exporters/langfuse.mdx +1 -1
  34. package/.docs/raw/reference/observability/ai-tracing/exporters/langsmith.mdx +2 -2
  35. package/.docs/raw/reference/observability/ai-tracing/exporters/otel.mdx +1 -1
  36. package/.docs/raw/reference/observability/ai-tracing/interfaces.mdx +48 -21
  37. package/.docs/raw/reference/storage/mongodb.mdx +146 -0
  38. package/.docs/raw/server-db/storage.mdx +1 -0
  39. package/.docs/raw/workflows/agents-and-tools.mdx +15 -1
  40. package/.docs/raw/workflows/human-in-the-loop.mdx +268 -0
  41. package/CHANGELOG.md +14 -0
  42. package/package.json +11 -4
@@ -1,5 +1,23 @@
1
1
  # @mastra/mongodb
2
2
 
3
+ ## 0.14.7
4
+
5
+ ### Patch Changes
6
+
7
+ - Adds MongoDB Observability support, and MongoDB Storage documentation, examples, and telemetry. ([#8426](https://github.com/mastra-ai/mastra/pull/8426))
8
+
9
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
10
+ - @mastra/core@0.23.0
11
+
12
+ ## 0.14.7-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Adds MongoDB Observability support, and MongoDB Storage documentation, examples, and telemetry. ([#8426](https://github.com/mastra-ai/mastra/pull/8426))
17
+
18
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
19
+ - @mastra/core@0.23.0-alpha.0
20
+
3
21
  ## 0.14.6
4
22
 
5
23
  ### Patch Changes
@@ -280,23 +298,5 @@
280
298
 
281
299
  ### Patch Changes
282
300
 
283
- - [#6700](https://github.com/mastra-ai/mastra/pull/6700) [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02) Thanks [@gpanakkal](https://github.com/gpanakkal)! - Add `getMessagesById` method to `MastraStorage` adapters
284
-
285
- - Updated dependencies [[`6e7e120`](https://github.com/mastra-ai/mastra/commit/6e7e1207d6e8d8b838f9024f90bd10df1181ba27), [`a5a23d9`](https://github.com/mastra-ai/mastra/commit/a5a23d981920d458dc6078919992a5338931ef02)]:
286
- - @mastra/core@0.14.1-alpha.0
287
-
288
- ## 0.13.2
289
-
290
- ### Patch Changes
291
301
 
292
- - 03997ae: Update peerdeps
293
- - Updated dependencies [227c7e6]
294
- - Updated dependencies [12cae67]
295
- - Updated dependencies [fd3a3eb]
296
- - Updated dependencies [6faaee5]
297
- - Updated dependencies [4232b14]
298
- - Updated dependencies [a89de7e]
299
- - Updated dependencies [5a37d0c]
300
- - Updated dependencies [4bde0cb]
301
-
302
- ... 912 more lines hidden. See full changelog in package directory.
302
+ ... 930 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,23 @@
1
1
  # @mastra/pg
2
2
 
3
+ ## 0.17.6
4
+
5
+ ### Patch Changes
6
+
7
+ - Fixes "invalid input syntax for type json" error in AI tracing with PostgreSQL. ([#9181](https://github.com/mastra-ai/mastra/pull/9181))
8
+
9
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
10
+ - @mastra/core@0.23.0
11
+
12
+ ## 0.17.6-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Fixes "invalid input syntax for type json" error in AI tracing with PostgreSQL. ([#9181](https://github.com/mastra-ai/mastra/pull/9181))
17
+
18
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
19
+ - @mastra/core@0.23.0-alpha.0
20
+
3
21
  ## 0.17.5
4
22
 
5
23
  ### Patch Changes
@@ -281,22 +299,4 @@
281
299
 
282
300
  - remove debug logs ([#7708](https://github.com/mastra-ai/mastra/pull/7708))
283
301
 
284
- - Updated dependencies [[`b4379f7`](https://github.com/mastra-ai/mastra/commit/b4379f703fd74474f253420e8c3a684f2c4b2f8e), [`dd9119b`](https://github.com/mastra-ai/mastra/commit/dd9119b175a8f389082f75c12750e51f96d65dca), [`d34aaa1`](https://github.com/mastra-ai/mastra/commit/d34aaa1da5d3c5f991740f59e2fe6d28d3e2dd91), [`ce1e580`](https://github.com/mastra-ai/mastra/commit/ce1e580f6391e94a0c6816a9c5db0a21566a262f), [`b2babfa`](https://github.com/mastra-ai/mastra/commit/b2babfa9e75b22f2759179e71d8473f6dc5421ed), [`d8c3ba5`](https://github.com/mastra-ai/mastra/commit/d8c3ba516f4173282d293f7e64769cfc8738d360), [`a566c4e`](https://github.com/mastra-ai/mastra/commit/a566c4e92d86c1671707c54359b1d33934f7cc13), [`af333aa`](https://github.com/mastra-ai/mastra/commit/af333aa30fe6d1b127024b03a64736c46eddeca2), [`3863c52`](https://github.com/mastra-ai/mastra/commit/3863c52d44b4e5779968b802d977e87adf939d8e), [`6424c7e`](https://github.com/mastra-ai/mastra/commit/6424c7ec38b6921d66212431db1e0958f441b2a7), [`db94750`](https://github.com/mastra-ai/mastra/commit/db94750a41fd29b43eb1f7ce8e97ba8b9978c91b), [`a66a371`](https://github.com/mastra-ai/mastra/commit/a66a3716b00553d7f01842be9deb34f720b10fab), [`69fc3cd`](https://github.com/mastra-ai/mastra/commit/69fc3cd0fd814901785bdcf49bf536ab1e7fd975)]:
285
- - @mastra/core@0.16.3-alpha.0
286
-
287
- ## 0.15.1
288
-
289
- ### Patch Changes
290
-
291
- - Fix PgVector listIndexes() to only return Mastra-managed tables instead of all tables with vector columns. This prevents initialization failures when other pgvector tables exist in the database. ([#7539](https://github.com/mastra-ai/mastra/pull/7539))
292
-
293
- - Updated dependencies [[`47b6dc9`](https://github.com/mastra-ai/mastra/commit/47b6dc94f4976d4f3d3882e8f19eb365bbc5976c), [`827d876`](https://github.com/mastra-ai/mastra/commit/827d8766f36a900afcaf64a040f7ba76249009b3), [`0662d02`](https://github.com/mastra-ai/mastra/commit/0662d02ef16916e67531890639fcd72c69cfb6e2), [`565d65f`](https://github.com/mastra-ai/mastra/commit/565d65fc16314a99f081975ec92f2636dff0c86d), [`6189844`](https://github.com/mastra-ai/mastra/commit/61898448e65bda02bb814fb15801a89dc6476938), [`4da3d68`](https://github.com/mastra-ai/mastra/commit/4da3d68a778e5c4d5a17351ef223289fe2f45a45), [`fd9bbfe`](https://github.com/mastra-ai/mastra/commit/fd9bbfee22484f8493582325f53e8171bf8e682b), [`7eaf1d1`](https://github.com/mastra-ai/mastra/commit/7eaf1d1cec7e828d7a98efc2a748ac395bbdba3b), [`6f046b5`](https://github.com/mastra-ai/mastra/commit/6f046b5ccc5c8721302a9a61d5d16c12374cc8d7), [`d7a8f59`](https://github.com/mastra-ai/mastra/commit/d7a8f59154b0621aec4f41a6b2ea2b3882f03cb7), [`0b0bbb2`](https://github.com/mastra-ai/mastra/commit/0b0bbb24f4198ead69792e92b68a350f52b45cf3), [`d951f41`](https://github.com/mastra-ai/mastra/commit/d951f41771e4e5da8da4b9f870949f9509e38756), [`4dda259`](https://github.com/mastra-ai/mastra/commit/4dda2593b6343f9258671de5fb237aeba3ef6bb7), [`8049e2e`](https://github.com/mastra-ai/mastra/commit/8049e2e8cce80a00353c64894c62b695ac34e35e), [`f3427cd`](https://github.com/mastra-ai/mastra/commit/f3427cdaf9eecd63360dfc897a4acbf5f4143a4e), [`defed1c`](https://github.com/mastra-ai/mastra/commit/defed1ca8040cc8d42e645c5a50a1bc52a4918d7), [`6991ced`](https://github.com/mastra-ai/mastra/commit/6991cedcb5a44a49d9fe58ef67926e1f96ba55b1), [`9cb9c42`](https://github.com/mastra-ai/mastra/commit/9cb9c422854ee81074989dd2d8dccc0500ba8d3e), [`8334859`](https://github.com/mastra-ai/mastra/commit/83348594d4f37b311ba4a94d679c5f8721d796d4), [`05f13b8`](https://github.com/mastra-ai/mastra/commit/05f13b8fb269ccfc4de98e9db58dbe16eae55a5e)]:
294
- - @mastra/core@0.16.1
295
-
296
- ## 0.15.1-alpha.0
297
-
298
- ### Patch Changes
299
-
300
- - Fix PgVector listIndexes() to only return Mastra-managed tables instead of all tables with vector columns. This prevents initialization failures when other pgvector tables exist in the database. ([#7539](https://github.com/mastra-ai/mastra/pull/7539))
301
-
302
- ... 2567 more lines hidden. See full changelog in package directory.
302
+ ... 2585 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,35 @@
1
1
  # @mastra/playground-ui
2
2
 
3
+ ## 6.7.0
4
+
5
+ ### Minor Changes
6
+
7
+ - Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
8
+
9
+ ### Patch Changes
10
+
11
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
12
+
13
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
14
+ - @mastra/core@0.23.0
15
+ - @mastra/client-js@0.16.5
16
+ - @mastra/react@0.0.11
17
+
18
+ ## 6.7.0-alpha.0
19
+
20
+ ### Minor Changes
21
+
22
+ - Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
23
+
24
+ ### Patch Changes
25
+
26
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
27
+
28
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
29
+ - @mastra/core@0.23.0-alpha.0
30
+ - @mastra/client-js@0.16.5-alpha.0
31
+ - @mastra/react@0.0.11-alpha.0
32
+
3
33
  ## 6.6.2
4
34
 
5
35
  ### Patch Changes
@@ -268,35 +298,5 @@
268
298
  - @mastra/client-js@0.15.2
269
299
  - @mastra/react@0.0.5
270
300
 
271
- ## 6.4.1-alpha.1
272
-
273
- ### Patch Changes
274
-
275
- - Updated dependencies [[`07eaf25`](https://github.com/mastra-ai/mastra/commit/07eaf25aada9e42235dbf905854de53da4d8121b), [`68b1111`](https://github.com/mastra-ai/mastra/commit/68b11118a1303f93e9c0c157850c0751309304c5)]:
276
- - @mastra/core@0.20.2-alpha.1
277
- - @mastra/client-js@0.15.2-alpha.1
278
- - @mastra/react@0.0.5-alpha.1
279
-
280
- ## 6.4.1-alpha.0
281
-
282
- ### Patch Changes
283
-
284
- - Updated dependencies [[`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372)]:
285
- - @mastra/core@0.20.2-alpha.0
286
- - @mastra/client-js@0.15.2-alpha.0
287
- - @mastra/react@0.0.5-alpha.0
288
-
289
- ## 6.4.0
290
-
291
- ### Minor Changes
292
-
293
- - Update peer dependencies to match core package version bump (0.20.1) ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
294
-
295
- ### Patch Changes
296
-
297
- - workflow run thread more visible ([#8539](https://github.com/mastra-ai/mastra/pull/8539))
298
-
299
- - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
300
-
301
301
 
302
- ... 3814 more lines hidden. See full changelog in package directory.
302
+ ... 3844 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,23 @@
1
1
  # @mastra/react-hooks
2
2
 
3
+ ## 0.0.11
4
+
5
+ ### Patch Changes
6
+
7
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
8
+
9
+ - Updated dependencies [[`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18)]:
10
+ - @mastra/client-js@0.16.5
11
+
12
+ ## 0.0.11-alpha.0
13
+
14
+ ### Patch Changes
15
+
16
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
17
+
18
+ - Updated dependencies [[`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18)]:
19
+ - @mastra/client-js@0.16.5-alpha.0
20
+
3
21
  ## 0.0.10
4
22
 
5
23
  ### Patch Changes
@@ -281,22 +299,4 @@
281
299
 
282
300
  - modify the useMastraChat hook to useChat ([#8265](https://github.com/mastra-ai/mastra/pull/8265))
283
301
 
284
- - Updated dependencies [[`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67), [`5cb4596`](https://github.com/mastra-ai/mastra/commit/5cb4596c644104ea817bb0c5a07b8b1f8de595a8), [`86be6be`](https://github.com/mastra-ai/mastra/commit/86be6bee7e64b7d828a6b4eec283265c820dfa43), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`67b0f00`](https://github.com/mastra-ai/mastra/commit/67b0f005b520335c71fb85cbaa25df4ce8484a81), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30)]:
285
- - @mastra/client-js@0.14.0
286
-
287
- ## 0.0.1-alpha.1
288
-
289
- ### Patch Changes
290
-
291
- - modify the useMastraChat hook to useChat ([#8265](https://github.com/mastra-ai/mastra/pull/8265))
292
-
293
- - Updated dependencies [[`5cb4596`](https://github.com/mastra-ai/mastra/commit/5cb4596c644104ea817bb0c5a07b8b1f8de595a8), [`86be6be`](https://github.com/mastra-ai/mastra/commit/86be6bee7e64b7d828a6b4eec283265c820dfa43), [`57b6dd5`](https://github.com/mastra-ai/mastra/commit/57b6dd50f9e6d92c0ed3e7199e6a92752025e3a1), [`ea8d386`](https://github.com/mastra-ai/mastra/commit/ea8d386cd8c5593664515fd5770c06bf2aa980ef), [`6f67656`](https://github.com/mastra-ai/mastra/commit/6f676562276926e2982401574d1e07157579be30)]:
294
- - @mastra/client-js@0.14.0-alpha.1
295
-
296
- ## 0.0.1-alpha.1
297
-
298
- ### Patch Changes
299
-
300
- - Updated dependencies [[`dc099b4`](https://github.com/mastra-ai/mastra/commit/dc099b40fb31147ba3f362f98d991892033c4c67)]:
301
-
302
- ... 2 more lines hidden. See full changelog in package directory.
302
+ ... 20 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,31 @@
1
1
  # @mastra/server
2
2
 
3
+ ## 0.23.0
4
+
5
+ ### Minor Changes
6
+
7
+ - Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
8
+
9
+ ### Patch Changes
10
+
11
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
12
+
13
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
14
+ - @mastra/core@0.23.0
15
+
16
+ ## 0.23.0-alpha.0
17
+
18
+ ### Minor Changes
19
+
20
+ - Update peer dependencies to match core package version bump (0.22.1) ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
21
+
22
+ ### Patch Changes
23
+
24
+ - Add tool call approval ([#8649](https://github.com/mastra-ai/mastra/pull/8649))
25
+
26
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
27
+ - @mastra/core@0.23.0-alpha.0
28
+
3
29
  ## 0.22.2
4
30
 
5
31
  ### Patch Changes
@@ -272,31 +298,5 @@
272
298
 
273
299
  - Add approve and decline tool calls to mastra server pkg ([#8360](https://github.com/mastra-ai/mastra/pull/8360))
274
300
 
275
- - Fix/8219 preserve resourceid on resume ([#8359](https://github.com/mastra-ai/mastra/pull/8359))
276
-
277
- - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
278
-
279
- - 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)]:
280
- - @mastra/core@0.20.0
281
-
282
- ## 0.20.0-alpha.0
283
-
284
- ### Minor Changes
285
-
286
- - 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))
287
-
288
- ### Patch Changes
289
-
290
- - Add approve and decline tool calls to mastra server pkg ([#8360](https://github.com/mastra-ai/mastra/pull/8360))
291
-
292
- - Fix/8219 preserve resourceid on resume ([#8359](https://github.com/mastra-ai/mastra/pull/8359))
293
-
294
- - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
295
-
296
- - 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)]:
297
- - @mastra/core@0.20.0-alpha.0
298
-
299
- ## 0.19.1
300
-
301
301
 
302
- ... 3853 more lines hidden. See full changelog in package directory.
302
+ ... 3879 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,9 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.17.4
4
+
5
+ ## 0.17.4-alpha.0
6
+
3
7
  ## 0.17.3
4
8
 
5
9
  ## 0.17.3-alpha.0
@@ -294,9 +298,5 @@
294
298
 
295
299
  - Fixed an issue in playground where text-start/end parts were ignored in handleStreamChunk and tool ordering vs text wasn't retained ([#8234](https://github.com/mastra-ai/mastra/pull/8234))
296
300
 
297
- - Add conditional chaining to scorer.agentNames return ([#8199](https://github.com/mastra-ai/mastra/pull/8199))
298
-
299
- - Show model that worked when there are model fallbacks ([#8167](https://github.com/mastra-ai/mastra/pull/8167))
300
-
301
301
 
302
- ... 1776 more lines hidden. See full changelog in package directory.
302
+ ... 1780 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,21 @@
1
1
  # mastra
2
2
 
3
+ ## 0.17.4
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
8
+ - @mastra/core@0.23.0
9
+ - @mastra/deployer@0.23.0
10
+
11
+ ## 0.17.4-alpha.0
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2060766`](https://github.com/mastra-ai/mastra/commit/20607667bf78ea104cca3e15dfb93ae0b62c9d18), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3)]:
16
+ - @mastra/core@0.23.0-alpha.0
17
+ - @mastra/deployer@0.23.0-alpha.0
18
+
3
19
  ## 0.17.3
4
20
 
5
21
  ### Patch Changes
@@ -282,21 +298,5 @@
282
298
 
283
299
  ### Patch Changes
284
300
 
285
- - Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
286
- fixed an issue with provider ID rendering in playground UI
287
- - Updated dependencies [[`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d)]:
288
- - @mastra/core@0.20.1-alpha.4
289
- - @mastra/deployer@0.20.1-alpha.4
290
-
291
- ## 0.14.2-alpha.2
292
-
293
- ### Patch Changes
294
-
295
- - Added AI SDK provider packages to model router for anthropic/google/openai/openrouter/xai ([#8559](https://github.com/mastra-ai/mastra/pull/8559))
296
-
297
- - Updated dependencies [[`42ffed3`](https://github.com/mastra-ai/mastra/commit/42ffed311b9d8750652bbc55c773be62c989fcc6), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c)]:
298
- - @mastra/deployer@0.20.1-alpha.2
299
- - @mastra/core@0.20.1-alpha.2
300
-
301
301
 
302
- ... 6296 more lines hidden. See full changelog in package directory.
302
+ ... 6312 more lines hidden. See full changelog in package directory.
@@ -0,0 +1,208 @@
1
+ ### package.json
2
+ ```json
3
+ {
4
+ "name": "memory-with-mongodb",
5
+ "dependencies": {
6
+ "@ai-sdk/openai": "latest",
7
+ "@mastra/core": "latest",
8
+ "@mastra/memory": "latest",
9
+ "@mastra/mongodb": "latest"
10
+ },
11
+ "devDependencies": {
12
+ "dotenv": "^17.0.0",
13
+ "tsx": "^4.19.3"
14
+ }
15
+ }
16
+ ```
17
+
18
+ ### chat.ts
19
+ ```typescript
20
+ import { randomUUID } from 'crypto';
21
+ import Readline from 'readline';
22
+
23
+ import 'dotenv/config';
24
+
25
+ import { mastra } from './mastra';
26
+
27
+ const agent = mastra.getAgent('memoryAgent');
28
+
29
+ let thread = randomUUID();
30
+ // use this to play with a long running conversation. comment it out to get a new thread id every time
31
+ thread = `39873fbf-84d6-425e-8c1b-8afd798d72a4`;
32
+ // thread = `12569b14-3e16-4e31-8130-8d9676f1932c`;
33
+ console.log(thread);
34
+
35
+ const resource = 'SOME_USER_ID';
36
+
37
+ async function logRes(res: Awaited<ReturnType<typeof agent.stream>>) {
38
+ console.log(`\n🤖 Agent:`);
39
+ for await (const chunk of res.textStream) {
40
+ process.stdout.write(chunk);
41
+ }
42
+ console.log(`\n\n`);
43
+ }
44
+
45
+ async function main() {
46
+ await logRes(
47
+ await agent.stream(
48
+ [
49
+ {
50
+ role: 'system',
51
+ content: `Chat with user started now ${new Date().toISOString()}. Don't mention this message. This means some time may have passed between this message and the one before. The user left and came back again. Say something to start the conversation up again.`,
52
+ },
53
+ ],
54
+ { memory: { resource, thread } },
55
+ ),
56
+ );
57
+
58
+ const rl = Readline.createInterface({
59
+ input: process.stdin,
60
+ output: process.stdout,
61
+ });
62
+
63
+ while (true) {
64
+ const prompt: string = await new Promise(res => {
65
+ rl.question('Message: ', answer => {
66
+ res(answer);
67
+ });
68
+ });
69
+
70
+ await logRes(
71
+ await agent.stream(prompt, {
72
+ memory: { thread, resource },
73
+ }),
74
+ );
75
+ }
76
+ }
77
+
78
+ main();
79
+
80
+ ```
81
+
82
+ ### index.ts
83
+ ```typescript
84
+ import { randomUUID } from 'crypto';
85
+
86
+ import { mastra } from './mastra';
87
+
88
+ function log(message: string) {
89
+ console.log(`\n>>Prompt: ${message}`);
90
+ return message;
91
+ }
92
+
93
+ const agent = mastra.getAgent('chefAgent');
94
+ const threadId = randomUUID();
95
+ const resourceId = 'SOME_USER_ID';
96
+
97
+ async function logRes(res: Awaited<ReturnType<typeof agent.stream>>) {
98
+ console.log(`\n👨‍🍳 Chef:`);
99
+ for await (const chunk of res.textStream) {
100
+ process.stdout.write(chunk);
101
+ }
102
+ console.log(`\n\n`);
103
+ }
104
+
105
+ async function main() {
106
+ await logRes(
107
+ await agent.stream(
108
+ log(
109
+ 'In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some dried herbs (basil and oregano). What can I make? Please keep your answer brief, only give me the high level steps.',
110
+ ),
111
+ {
112
+ threadId,
113
+ resourceId,
114
+ },
115
+ ),
116
+ );
117
+
118
+ await logRes(
119
+ await agent.stream(
120
+ log(
121
+ "Now I'm over at my friend's house, and they have: chicken thighs, coconut milk, sweet potatoes, and some curry powder.",
122
+ ),
123
+ {
124
+ threadId,
125
+ resourceId,
126
+ },
127
+ ),
128
+ );
129
+
130
+ await logRes(
131
+ await agent.stream(log('What did we cook before I went to my friends house?'), {
132
+ threadId,
133
+ resourceId,
134
+ memoryOptions: {
135
+ lastMessages: 3,
136
+ },
137
+ }),
138
+ );
139
+
140
+ process.exit(0);
141
+ }
142
+
143
+ main();
144
+
145
+ ```
146
+
147
+ ### mastra/agents/index.ts
148
+ ```typescript
149
+ import { openai } from '@ai-sdk/openai';
150
+ import { Agent } from '@mastra/core/agent';
151
+ import { Memory } from '@mastra/memory';
152
+ import { MongoDBStore, MongoDBVector } from '@mastra/mongodb';
153
+
154
+ // This URI must be an Atlas MongoDB deployment in order to work with vector search
155
+ // in the format mongodb+srv://<username>:<password>@<cluster>.mongodb.net
156
+ const uri = process.env.MONGODB_URI;
157
+ const dbName = process.env.MONGODB_DB_NAME || 'mastra_memory';
158
+
159
+ export const memory = new Memory({
160
+ storage: new MongoDBStore({
161
+ url: uri,
162
+ dbName,
163
+ }),
164
+ vector: new MongoDBVector({
165
+ uri,
166
+ dbName,
167
+ }),
168
+ options: {
169
+ lastMessages: 10,
170
+ semanticRecall: {
171
+ topK: 3,
172
+ messageRange: 2,
173
+ },
174
+ },
175
+ embedder: openai.embedding('text-embedding-3-small'),
176
+ });
177
+
178
+ export const chefAgent = new Agent({
179
+ name: 'chefAgent',
180
+ instructions:
181
+ 'You are Michel, a practical and experienced home chef who helps people cook great meals with whatever ingredients they have available. Your first priority is understanding what ingredients and equipment the user has access to, then suggesting achievable recipes. You explain cooking steps clearly and offer substitutions when needed, maintaining a friendly and encouraging tone throughout.',
182
+ model: openai('gpt-4o'),
183
+ memory,
184
+ });
185
+
186
+ export const memoryAgent = new Agent({
187
+ name: 'Memory Agent',
188
+ instructions:
189
+ "You are an AI agent with the ability to automatically recall memories from previous interactions. You may have conversations that last hours, days, months, or years. If you don't know it already you should ask for the users name and some info about them.",
190
+ model: openai('gpt-4o'),
191
+ memory,
192
+ });
193
+
194
+ ```
195
+
196
+ ### mastra/index.ts
197
+ ```typescript
198
+ import { Mastra } from '@mastra/core';
199
+
200
+ import 'dotenv/config';
201
+
202
+ import { chefAgent, memoryAgent } from './agents';
203
+
204
+ export const mastra = new Mastra({
205
+ agents: { chefAgent, memoryAgent },
206
+ });
207
+
208
+ ```
@@ -63,7 +63,7 @@ Top-level files define how your Mastra project is configured, built, and connect
63
63
  | File | Description |
64
64
  | --------------------- | ------------ |
65
65
  | `src/mastra/index.ts` | Central entry point where you configure and initialize Mastra. |
66
- | `.env.example` | Template for environment variables copy and rename to `.env` to add your secret [model provider](/models) keys. |
66
+ | `.env.example` | Template for environment variables - copy and rename to `.env` to add your secret [model provider](/models) keys. |
67
67
  | `package.json` | Defines project metadata, dependencies, and available npm scripts. |
68
68
  | `tsconfig.json` | Configures TypeScript options such as path aliases, compiler settings, and build output. |
69
69
 
@@ -10,15 +10,15 @@ import { Callout } from "nextra/components";
10
10
 
11
11
  # Playground
12
12
 
13
- Playground helps you build agents quickly. It provides an interactive UI for testing your agents and workflows, along with a REST API that exposes your Mastra application as a local service. This lets you start building without having to integrate Mastra into your project right away.
13
+ Playground 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, Playground enables you to iterate quickly. Features like Observability and Scorers give you visibility into performance at every stage of development.
15
+ As your project evolves, Playground'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 Playground locally using the instructions below, or [deploy to Mastra Cloud](/docs/mastra-cloud/setting-up) to access the Playground remotely and collaborate with your team.
17
+ To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
18
18
 
19
19
  <YouTube id="spGlcTEjuXY" startTime={126}/>
20
20
 
21
- ## Launch Playground
21
+ ## Start Playground
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
 
@@ -69,7 +69,7 @@ All memory types are [thread-scoped](./working-memory.mdx#thread-scoped-memory-d
69
69
 
70
70
  To persist and recall information between conversations, memory requires a storage adapter.
71
71
 
72
- Supported options include [LibSQL](/examples/memory/memory-with-libsql), [Postgres](/examples/memory/memory-with-pg), and [Upstash](/examples/memory/memory-with-upstash)
72
+ Supported options include [LibSQL](/docs/memory/storage/memory-with-libsql), [MongoDB](/docs/memory/storage/memory-with-mongodb), [Postgres](/docs/memory/storage/memory-with-pg), and [Upstash](/docs/memory/storage/memory-with-upstash)
73
73
 
74
74
  We use LibSQL out of the box because it is file-based or in-memory, so it is easy to install and works well with the playground.
75
75
 
@@ -92,9 +92,10 @@ const agent = new Agent({
92
92
 
93
93
  **Storage/vector code Examples**:
94
94
 
95
- - [LibSQL](/examples/memory/memory-with-libsql)
96
- - [Postgres](/examples/memory/memory-with-pg)
97
- - [Upstash](/examples/memory/memory-with-upstash)
95
+ - [LibSQL](/docs/memory/storage/memory-with-libsql)
96
+ - [MongoDB](/docs/memory/storage/memory-with-mongodb)
97
+ - [Postgres](/docs/memory/storage/memory-with-pg)
98
+ - [Upstash](/docs/memory/storage/memory-with-upstash)
98
99
 
99
100
  ### Embedder configuration
100
101