@mastra/mcp-docs-server 0.13.1-alpha.0 → 0.13.1

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 (77) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +15 -15
  2. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +44 -44
  3. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +15 -15
  4. package/.docs/organized/changelogs/%40mastra%2Fcore.md +37 -37
  5. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +53 -53
  6. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +53 -53
  7. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +54 -54
  8. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +63 -63
  9. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +40 -0
  10. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +19 -19
  11. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +24 -24
  12. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +8 -8
  13. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +13 -13
  14. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +14 -14
  15. package/.docs/organized/changelogs/%40mastra%2Fpg.md +31 -31
  16. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +50 -50
  17. package/.docs/organized/changelogs/%40mastra%2Fserver.md +47 -47
  18. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +37 -37
  19. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +9 -0
  20. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +12 -12
  21. package/.docs/organized/changelogs/create-mastra.md +15 -15
  22. package/.docs/organized/changelogs/mastra.md +86 -86
  23. package/.docs/organized/code-examples/agent.md +1 -1
  24. package/.docs/organized/code-examples/agui.md +4 -1
  25. package/.docs/organized/code-examples/ai-sdk-useChat.md +1 -1
  26. package/.docs/organized/code-examples/fireworks-r1.md +1 -1
  27. package/.docs/organized/code-examples/memory-with-processors.md +2 -2
  28. package/.docs/organized/code-examples/openapi-spec-writer.md +1 -1
  29. package/.docs/organized/code-examples/quick-start.md +1 -1
  30. package/.docs/organized/code-examples/weather-agent.md +7 -1
  31. package/.docs/raw/course/01-first-agent/03-verifying-installation.md +4 -2
  32. package/.docs/raw/course/01-first-agent/16-adding-memory-to-agent.md +1 -1
  33. package/.docs/raw/course/02-agent-tools-mcp/15-updating-mcp-config-github.md +1 -1
  34. package/.docs/raw/course/02-agent-tools-mcp/20-updating-mcp-config-hackernews.md +1 -1
  35. package/.docs/raw/course/02-agent-tools-mcp/26-updating-mcp-config-filesystem.md +1 -1
  36. package/.docs/raw/course/03-agent-memory/03-installing-memory.md +4 -2
  37. package/.docs/raw/course/03-agent-memory/04-creating-basic-memory-agent.md +1 -1
  38. package/.docs/raw/course/03-agent-memory/08-configuring-conversation-history.md +3 -3
  39. package/.docs/raw/course/03-agent-memory/13-vector-store-configuration.md +27 -0
  40. package/.docs/raw/course/03-agent-memory/{13-what-is-semantic-recall.md → 14-what-is-semantic-recall.md} +1 -1
  41. package/.docs/raw/course/03-agent-memory/16-configuring-semantic-recall.md +41 -0
  42. package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +28 -0
  43. package/.docs/raw/course/03-agent-memory/21-configuring-working-memory.md +9 -9
  44. package/.docs/raw/course/03-agent-memory/22-custom-working-memory-templates.md +10 -2
  45. package/.docs/raw/course/03-agent-memory/25-combining-memory-features.md +8 -1
  46. package/.docs/raw/course/03-agent-memory/27-creating-learning-assistant.md +8 -1
  47. package/.docs/raw/deployment/deployment.mdx +26 -97
  48. package/.docs/raw/deployment/overview.mdx +18 -3
  49. package/.docs/raw/deployment/web-framework.mdx +63 -0
  50. package/.docs/raw/frameworks/web-frameworks/astro.mdx +7 -1
  51. package/.docs/raw/frameworks/web-frameworks/next-js.mdx +1 -1
  52. package/.docs/raw/getting-started/installation.mdx +98 -558
  53. package/.docs/raw/getting-started/project-structure.mdx +3 -16
  54. package/.docs/raw/rag/vector-databases.mdx +4 -7
  55. package/.docs/raw/reference/agents/generate.mdx +35 -3
  56. package/.docs/raw/reference/agents/stream.mdx +35 -3
  57. package/.docs/raw/reference/client-js/memory.mdx +14 -0
  58. package/.docs/raw/reference/client-js/workflows.mdx +28 -0
  59. package/.docs/raw/reference/deployer/cloudflare.mdx +9 -3
  60. package/.docs/raw/reference/deployer/deployer.mdx +1 -1
  61. package/.docs/raw/reference/deployer/netlify.mdx +25 -4
  62. package/.docs/raw/reference/deployer/vercel.mdx +10 -4
  63. package/.docs/raw/workflows/control-flow.mdx +45 -171
  64. package/.docs/raw/workflows/input-data-mapping.mdx +21 -88
  65. package/.docs/raw/workflows/overview.mdx +23 -46
  66. package/.docs/raw/workflows/suspend-and-resume.mdx +46 -34
  67. package/.docs/raw/workflows/using-with-agents-and-tools.mdx +55 -191
  68. package/dist/_tsup-dts-rollup.d.ts +14 -0
  69. package/dist/{chunk-QWIXFGFR.js → chunk-P5AHYMUI.js} +126 -20
  70. package/dist/prepare-docs/prepare.js +1 -1
  71. package/dist/stdio.js +42 -12
  72. package/package.json +4 -4
  73. package/.docs/raw/course/03-agent-memory/15-configuring-semantic-recall.md +0 -46
  74. package/.docs/raw/course/03-agent-memory/16-vector-store-configuration.md +0 -37
  75. package/.docs/raw/course/03-agent-memory/18-disabling-semantic-recall.md +0 -24
  76. /package/.docs/raw/{deployment/client.mdx → client-js/overview.mdx} +0 -0
  77. /package/.docs/raw/course/03-agent-memory/{14-how-semantic-recall-works.md → 15-how-semantic-recall-works.md} +0 -0
@@ -1,5 +1,41 @@
1
1
  # @mastra/upstash
2
2
 
3
+ ## 0.11.0-alpha.2
4
+
5
+ ### Patch Changes
6
+
7
+ - e8fdbdd: Fix dynamic require of crypto using upstash.
8
+ caused by a bad import was used in the monorepo
9
+
10
+ Fixes #4801
11
+
12
+ - Updated dependencies [9589624]
13
+ - @mastra/core@0.10.6-alpha.4
14
+
15
+ ## 0.11.0-alpha.1
16
+
17
+ ### Patch Changes
18
+
19
+ - 2fda031: Clarify upstash argument concepts.
20
+ - Updated dependencies [ee9af57]
21
+ - Updated dependencies [751c894]
22
+ - Updated dependencies [577ce3a]
23
+ - Updated dependencies [9260b3a]
24
+ - @mastra/core@0.10.6-alpha.1
25
+
26
+ ## 0.11.0-alpha.0
27
+
28
+ ### Minor Changes
29
+
30
+ - 704d1ca: Thread Timestamp Auto-Update Enhancement
31
+ Added automatic thread updatedAt timestamp updates when messages are saved across all storage providers
32
+ Enhanced user experience: Threads now accurately reflect their latest activity with automatic timestamp updates when new messages are added
33
+ Universal implementation: Consistent behavior across all 7 storage backends (ClickHouse, Cloudflare D1, DynamoDB, MongoDB, PostgreSQL, Upstash, LibSQL)
34
+ Performance optimized: Updates execute in parallel with message saving operations for minimal performance impact
35
+ Backwards compatible: No breaking changes - existing code continues to work unchanged
36
+ Improved conversation ordering: Chat interfaces can now properly sort threads by actual last activity
37
+ This enhancement resolves the issue where active conversations appeared stale due to outdated thread timestamps, providing better conversation management and user experience in chat applications.
38
+
3
39
  ## 0.10.3
4
40
 
5
41
  ### Patch Changes
@@ -262,41 +298,5 @@
262
298
 
263
299
  - Updated dependencies [3171b5b]
264
300
  - Updated dependencies [973e5ac]
265
- - Updated dependencies [9e1eff5]
266
- - @mastra/core@0.9.4-alpha.2
267
-
268
- ## 0.3.4-alpha.1
269
-
270
- ### Patch Changes
271
-
272
- - Updated dependencies [ab80e7e]
273
- - Updated dependencies [6fa1ad1]
274
- - Updated dependencies [c28d7a0]
275
- - Updated dependencies [edf1e88]
276
- - @mastra/core@0.9.4-alpha.1
277
-
278
- ## 0.3.4-alpha.0
279
-
280
- ### Patch Changes
281
-
282
- - Updated dependencies [daf942f]
283
- - Updated dependencies [0b8b868]
284
- - @mastra/core@0.9.4-alpha.0
285
-
286
- ## 0.3.3
287
-
288
- ### Patch Changes
289
-
290
- - Updated dependencies [e450778]
291
- - Updated dependencies [8902157]
292
- - Updated dependencies [ca0dc88]
293
- - Updated dependencies [526c570]
294
- - Updated dependencies [d7a6a33]
295
- - Updated dependencies [9cd1a46]
296
- - Updated dependencies [b5d2de0]
297
- - Updated dependencies [644f8ad]
298
- - Updated dependencies [70dbf51]
299
- - @mastra/core@0.9.3
300
-
301
301
 
302
- ... 1437 more lines hidden. See full changelog in package directory.
302
+ ... 1473 more lines hidden. See full changelog in package directory.
@@ -0,0 +1,9 @@
1
+ # @mastra/voice-gladia
2
+
3
+ ## 0.10.1-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - f4007f8: Add gladia-api speech to text provider
8
+ - Updated dependencies [4b0f8a6]
9
+ - @mastra/core@0.10.6-alpha.2
@@ -1,5 +1,16 @@
1
1
  # @mastra/voice-openai-realtime
2
2
 
3
+ ## 0.10.2-alpha.1
4
+
5
+ ### Patch Changes
6
+
7
+ - 00335a2: Fix Typo in Example Usage of addInstructions Method
8
+ - Updated dependencies [ee9af57]
9
+ - Updated dependencies [751c894]
10
+ - Updated dependencies [577ce3a]
11
+ - Updated dependencies [9260b3a]
12
+ - @mastra/core@0.10.6-alpha.1
13
+
3
14
  ## 0.10.2-alpha.0
4
15
 
5
16
  ### Patch Changes
@@ -287,16 +298,5 @@
287
298
  - Updated dependencies [0097d50]
288
299
  - @mastra/core@0.9.2-alpha.0
289
300
 
290
- ## 0.2.1
291
-
292
- ### Patch Changes
293
-
294
- - Updated dependencies [405b63d]
295
- - Updated dependencies [81fb7f6]
296
- - Updated dependencies [20275d4]
297
- - Updated dependencies [7d1892c]
298
- - Updated dependencies [a90a082]
299
- - Updated dependencies [2d17c73]
300
- - Updated dependencies [61e92f5]
301
301
 
302
- ... 576 more lines hidden. See full changelog in package directory.
302
+ ... 587 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,19 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.10.5-alpha.2
4
+
5
+ ### Patch Changes
6
+
7
+ - 5f2aa3e: Move workflow hooks to playground
8
+
9
+ ## 0.10.5-alpha.1
10
+
11
+ ### Patch Changes
12
+
13
+ - 44ba52d: Add proper error message when installation of mastra fails
14
+ - 3270d9d: Fix runtime context being undefined
15
+ - fc677d7: For final result for a workflow
16
+
3
17
  ## 0.10.5-alpha.0
4
18
 
5
19
  ### Patch Changes
@@ -285,18 +299,4 @@
285
299
 
286
300
  ### Patch Changes
287
301
 
288
- - 5b43dd0: revamp ui for threads
289
-
290
- ## 0.3.1-alpha.2
291
-
292
- ### Patch Changes
293
-
294
- - 33b84fd: fix showing sig digits in trace / span duration
295
- - 4155f47: Add parameters to filter workflow runs
296
- Add fromDate and toDate to telemetry parameters
297
-
298
- ## 0.3.1-alpha.1
299
-
300
- ### Patch Changes
301
-
302
- ... 854 more lines hidden. See full changelog in package directory.
302
+ ... 868 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,90 @@
1
1
  # mastra
2
2
 
3
+ ## 0.10.6-alpha.7
4
+
5
+ ### Patch Changes
6
+
7
+ - b29c802: Remove open browser
8
+ - Updated dependencies [bd1674f]
9
+ - Updated dependencies [69f76f7]
10
+ - @mastra/mcp@0.10.4-alpha.1
11
+ - @mastra/deployer@0.10.6-alpha.5
12
+
13
+ ## 0.10.6-alpha.6
14
+
15
+ ### Patch Changes
16
+
17
+ - 5f2aa3e: Move workflow hooks to playground
18
+ - Updated dependencies [12a95fc]
19
+ - Updated dependencies [51264a5]
20
+ - Updated dependencies [8e6f677]
21
+ - @mastra/core@0.10.6-alpha.5
22
+ - @mastra/deployer@0.10.6-alpha.5
23
+
24
+ ## 0.10.6-alpha.5
25
+
26
+ ### Patch Changes
27
+
28
+ - 084f6aa: Add logs to circular dependency to warn people when starting server might break
29
+ - Updated dependencies [79b9909]
30
+ - Updated dependencies [084f6aa]
31
+ - Updated dependencies [9589624]
32
+ - @mastra/deployer@0.10.6-alpha.4
33
+ - @mastra/core@0.10.6-alpha.4
34
+
35
+ ## 0.10.6-alpha.4
36
+
37
+ ### Patch Changes
38
+
39
+ - 4051477: dependencies updates:
40
+ - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
41
+ - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
42
+ - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
43
+ - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
44
+ - Added dependency [`open@^10.1.2` ↗︎](https://www.npmjs.com/package/open/v/10.1.2) (to `dependencies`)
45
+ - b40f365: dependencies updates:
46
+ - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
47
+ - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
48
+ - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
49
+ - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
50
+ - Updated dependencies [4051477]
51
+ - Updated dependencies [c28ed65]
52
+ - Updated dependencies [d70c420]
53
+ - Updated dependencies [2a16996]
54
+ - @mastra/deployer@0.10.6-alpha.3
55
+ - @mastra/core@0.10.6-alpha.3
56
+
57
+ ## 0.10.6-alpha.3
58
+
59
+ ### Patch Changes
60
+
61
+ - Updated dependencies [4b0f8a6]
62
+ - Updated dependencies [ec7f824]
63
+ - @mastra/core@0.10.6-alpha.2
64
+ - @mastra/deployer@0.10.6-alpha.2
65
+
66
+ ## 0.10.6-alpha.2
67
+
68
+ ### Patch Changes
69
+
70
+ - 143b4e4: Fix globbing of tools to only capture js/ts files
71
+ - 44ba52d: Add proper error message when installation of mastra fails
72
+ - 3270d9d: Fix runtime context being undefined
73
+ - fc677d7: For final result for a workflow
74
+ - Updated dependencies [ee9af57]
75
+ - Updated dependencies [3270d9d]
76
+ - Updated dependencies [751c894]
77
+ - Updated dependencies [577ce3a]
78
+ - Updated dependencies [9260b3a]
79
+ - @mastra/deployer@0.10.6-alpha.1
80
+ - @mastra/core@0.10.6-alpha.1
81
+
82
+ ## 0.10.6-alpha.1
83
+
84
+ ### Patch Changes
85
+
86
+ - 47e7029: Add open browser functionality when running mastra dev
87
+
3
88
  ## 0.10.6-alpha.0
4
89
 
5
90
  ### Patch Changes
@@ -213,90 +298,5 @@
213
298
  - 6fd77b5: add docs and txt support for multi modal
214
299
  - 9faee5b: small fixes in the workflows graph
215
300
  - 631683f: move workflow runs list in playground-ui instead of playground
216
- - 068b850: fix: able to pass headers to playground components which are using the mastra client
217
- - 668af6d: Fix mastra dev server restarts
218
- - f0d559f: Fix peerdeps for alpha channel
219
- - f6ddf55: fix traces not showing and reduce API surface from playground ui
220
- - 9a31c09: Highlight steps in nested workflows on workflow graph
221
- - Updated dependencies [ee77e78]
222
- - Updated dependencies [592a2db]
223
- - Updated dependencies [e5dc18d]
224
- - Updated dependencies [ab5adbe]
225
- - Updated dependencies [e8d2aff]
226
- - Updated dependencies [1e8bb40]
227
- - Updated dependencies [1b5fc55]
228
- - Updated dependencies [195c428]
229
- - Updated dependencies [f73e11b]
230
- - Updated dependencies [37643b8]
231
- - Updated dependencies [99fd6cf]
232
- - Updated dependencies [1fcc048]
233
- - Updated dependencies [c5bf1ce]
234
- - Updated dependencies [f946acf]
235
- - Updated dependencies [add596e]
236
- - Updated dependencies [8dc94d8]
237
- - Updated dependencies [ecebbeb]
238
- - Updated dependencies [4187ed4]
239
- - Updated dependencies [79d5145]
240
- - Updated dependencies [12b7002]
241
- - Updated dependencies [f0d559f]
242
- - Updated dependencies [2901125]
243
- - @mastra/core@0.10.2
244
- - @mastra/mcp@0.10.2
245
- - @mastra/deployer@0.10.2
246
- - @mastra/loggers@0.10.1
247
-
248
- ## 0.10.2-alpha.9
249
-
250
- ### Patch Changes
251
-
252
- - 90e96de: Fix: prevent default flag from triggering interactive prompt
253
- - Updated dependencies [37643b8]
254
- - Updated dependencies [79d5145]
255
- - @mastra/core@0.10.2-alpha.8
256
- - @mastra/deployer@0.10.2-alpha.8
257
-
258
- ## 0.10.2-alpha.8
259
-
260
- ### Patch Changes
261
-
262
- - a399086: Bumping because we forgot to
263
- - @mastra/deployer@0.10.2-alpha.7
264
- - @mastra/core@0.10.2-alpha.7
265
-
266
- ## 0.10.2-alpha.7
267
-
268
- ### Patch Changes
269
-
270
- - 1fcc048: chore: generate sourcemaps in dev build
271
- - 6fd77b5: add docs and txt support for multi modal
272
- - 631683f: move workflow runs list in playground-ui instead of playground
273
- - Updated dependencies [99fd6cf]
274
- - Updated dependencies [1fcc048]
275
- - Updated dependencies [8dc94d8]
276
- - @mastra/core@0.10.2-alpha.6
277
- - @mastra/deployer@0.10.2-alpha.6
278
-
279
- ## 0.10.2-alpha.6
280
-
281
- ### Patch Changes
282
-
283
- - 1b5fc55: Fixed an issue where the playground wouldn't display images saved in memory. Fixed memory to always store images as strings. Removed duplicate storage of reasoning and file/image parts in storage dbs
284
- - 9666468: move the fetch traces call to the playground instead of playground-ui
285
- - 668af6d: Fix mastra dev server restarts
286
- - Updated dependencies [1b5fc55]
287
- - Updated dependencies [add596e]
288
- - Updated dependencies [ecebbeb]
289
- - @mastra/core@0.10.2-alpha.5
290
- - @mastra/deployer@0.10.2-alpha.5
291
-
292
- ## 0.10.2-alpha.5
293
-
294
- ### Patch Changes
295
-
296
- - 401bbae: Show workflow graph from stepGraph of previous runs when viewing a previous run
297
-
298
- ## 0.10.2-alpha.4
299
-
300
- ### Patch Changes
301
301
 
302
- ... 3749 more lines hidden. See full changelog in package directory.
302
+ ... 3834 more lines hidden. See full changelog in package directory.
@@ -16,7 +16,7 @@
16
16
  "@mastra/memory": "latest",
17
17
  "@mastra/voice-openai": "latest",
18
18
  "@mastra/libsql": "latest",
19
- "ai": "^4.3.15",
19
+ "ai": "^4.3.16",
20
20
  "fetch-to-node": "^2.1.0",
21
21
  "mastra": "latest",
22
22
  "zod": "^3.25.56"
@@ -21,16 +21,19 @@
21
21
  "@mastra/agui": "latest",
22
22
  "@mastra/core": "latest",
23
23
  "@mastra/libsql": "latest",
24
+ "@mastra/loggers": "latest",
24
25
  "@mastra/memory": "latest",
25
26
  "mastra": "latest",
26
27
  "react": "^19.1.0",
27
- "react-dom": "^19.1.0"
28
+ "react-dom": "^19.1.0",
29
+ "zod": "^3.25.57"
28
30
  },
29
31
  "pnpm": {
30
32
  "overrides": {
31
33
  "@mastra/core": "link:../../packages/core",
32
34
  "@mastra/agui": "link:../../packages/agui",
33
35
  "@mastra/libsql": "link:../../stores/libsql",
36
+ "@mastra/loggers": "link:../../packages/loggers",
34
37
  "@mastra/memory": "link:../../packages/memory",
35
38
  "mastra": "link:../../packages/cli"
36
39
  }
@@ -11,7 +11,7 @@
11
11
  "lint": "next lint"
12
12
  },
13
13
  "dependencies": {
14
- "@ai-sdk/anthropic": "^1.2.11",
14
+ "@ai-sdk/anthropic": "^1.2.12",
15
15
  "@ai-sdk/react": "^1.2.12",
16
16
  "@mastra/core": "latest",
17
17
  "next": "^15.3.1",
@@ -13,7 +13,7 @@
13
13
  "author": "",
14
14
  "license": "MIT",
15
15
  "dependencies": {
16
- "@ai-sdk/anthropic": "^1.2.11",
16
+ "@ai-sdk/anthropic": "^1.2.12",
17
17
  "@ai-sdk/fireworks": "^0.2.14",
18
18
  "@mastra/core": "latest",
19
19
  "@mastra/mcp": "latest",
@@ -14,7 +14,7 @@
14
14
  "@ai-sdk/openai": "latest",
15
15
  "@mastra/core": "latest",
16
16
  "@mastra/memory": "latest",
17
- "ai": "^4.3.15",
17
+ "ai": "^4.3.16",
18
18
  "chalk": "^5.4.1",
19
19
  "dotenv": "^16.3.1",
20
20
  "js-tiktoken": "^1.0.13",
@@ -249,7 +249,7 @@ const interviewMemory = new Memory({
249
249
  export const interviewerAgent = new Agent({
250
250
  name: 'Forgetful Job Interviewer',
251
251
  instructions:
252
- "You are a professional job interviewer for a technology company. Conduct insightful interviews by asking relevant questions about skills, experience, and problem-solving abilities. Respond to candidate answers and ask follow-up questions. Keep the interview professional and engaging. Remember details the candidate shares earlier in the conversation. Sometimes you forget things by accident. The system will show you if you forgot. Don't be embarassed, you can admit when you forget something, you'll know when you do because there will be a message wrapped in <forgetten> tags. Don't refer to the user by their name, it comes across as too eager",
252
+ "You are a professional job interviewer for a technology company. Conduct insightful interviews by asking relevant questions about skills, experience, and problem-solving abilities. Respond to candidate answers and ask follow-up questions. Keep the interview professional and engaging. Remember details the candidate shares earlier in the conversation. Sometimes you forget things by accident. The system will show you if you forgot. Don't be embarrassed, you can admit when you forget something, you'll know when you do because there will be a message wrapped in <forgetten> tags. Don't refer to the user by their name, it comes across as too eager",
253
253
  model: openai('gpt-4o'),
254
254
  memory: interviewMemory,
255
255
  });
@@ -24,7 +24,7 @@
24
24
  "class-variance-authority": "^0.7.1",
25
25
  "clsx": "^2.1.1",
26
26
  "lucide-react": "^0.454.0",
27
- "next": "15.2.3",
27
+ "next": "15.2.4",
28
28
  "react": "^19.0.0",
29
29
  "react-dom": "^19.0.0",
30
30
  "react-syntax-highlighter": "^15.6.1",
@@ -19,7 +19,7 @@
19
19
  "zod": "^3.25.56"
20
20
  },
21
21
  "dependencies": {
22
- "@ai-sdk/anthropic": "^1.1.15",
22
+ "@ai-sdk/anthropic": "^1.2.12",
23
23
  "@ai-sdk/groq": "latest",
24
24
  "@ai-sdk/openai": "latest",
25
25
  "@mastra/core": "latest",
@@ -15,12 +15,14 @@
15
15
  "dependencies": {
16
16
  "@ai-sdk/openai": "^1.3.22",
17
17
  "@mastra/core": "latest",
18
+ "@mastra/libsql": "latest",
18
19
  "zod": "^3.25.56"
19
20
  },
20
21
  "version": "0.0.1",
21
22
  "pnpm": {
22
23
  "overrides": {
23
- "@mastra/core": "link:../../packages/core"
24
+ "@mastra/core": "link:../../packages/core",
25
+ "@mastra/libsql": "link:../../stores/libsql"
24
26
  }
25
27
  },
26
28
  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
@@ -65,12 +67,16 @@ export const weatherReporterAgent = new Agent({
65
67
  ### mastra/index.ts
66
68
  ```typescript
67
69
  import { Mastra } from '@mastra/core';
70
+ import { LibSQLStore } from '@mastra/libsql';
68
71
 
69
72
  import { weatherAgent } from './agents';
70
73
  import { weatherWorkflow as legacyWeatherWorkflow } from './workflows';
71
74
  import { weatherWorkflow, weatherWorkflow2 } from './workflows/new-workflow';
72
75
 
73
76
  export const mastra = new Mastra({
77
+ storage: new LibSQLStore({
78
+ url: 'file:./mastra.db',
79
+ }),
74
80
  agents: { weatherAgent },
75
81
  legacy_workflows: { legacyWeatherWorkflow },
76
82
  workflows: { weatherWorkflow, weatherWorkflow2 },
@@ -1,11 +1,13 @@
1
1
  # Verifying Your Mastra Installation
2
2
 
3
- Before we begin building our agent, let's make sure you have Mastra properly installed. First, let's check if @mastra/core is in the package.json and there is a src/mastra directory. If so, you can skip this step.
3
+ Before we begin building our agent, let's make sure you have the right development environment set up. Let's check if you have Node.js 18.x or later installed.
4
+
5
+ Then, let's check if @mastra/core is in the package.json and there is a src/mastra directory. If so, you can skip this step.
4
6
 
5
7
  If you haven't installed Mastra yet, you can do so by running:
6
8
 
7
9
  ```bash
8
- npm create mastra@latest
10
+ npm -y create mastra@latest
9
11
  ```
10
12
 
11
13
  If you do need to install mastra, follow the on-screen prompts and make sure to:
@@ -24,7 +24,7 @@ export const financialAgent = new Agent({
24
24
  tools: { getTransactionsTool },
25
25
  memory: new Memory({
26
26
  storage: new LibSQLStore({
27
- url: "../../memory.db", // local file-system database. Location is relative to the output directory `.mastra/output`
27
+ url: "file:../../memory.db", // local file-system database. Location is relative to the output directory `.mastra/output`
28
28
  }),
29
29
  }), // Add memory here
30
30
  });
@@ -3,7 +3,7 @@
3
3
  Now, let's update your MCP configuration in `src/mastra/agents/index.ts` to include the GitHub server:
4
4
 
5
5
  ```typescript
6
- const mcp = new MCPConfiguration({
6
+ const mcp = new MCPClient({
7
7
  servers: {
8
8
  zapier: {
9
9
  url: new URL(process.env.ZAPIER_MCP_URL || ""),
@@ -5,7 +5,7 @@ Unlike the previous MCP servers that use URLs, the Hacker News MCP server can be
5
5
  Let's update your MCP configuration in `src/mastra/agents/index.ts` to include the Hacker News server:
6
6
 
7
7
  ```typescript
8
- const mcp = new MCPConfiguration({
8
+ const mcp = new MCPClient({
9
9
  servers: {
10
10
  zapier: {
11
11
  url: new URL(process.env.ZAPIER_MCP_URL || ""),
@@ -5,7 +5,7 @@ Now, let's update your MCP configuration in `src/mastra/agents/index.ts` to incl
5
5
  ```typescript
6
6
  import path from "path";
7
7
 
8
- const mcp = new MCPConfiguration({
8
+ const mcp = new MCPClient({
9
9
  servers: {
10
10
  zapier: {
11
11
  url: new URL(process.env.ZAPIER_MCP_URL || ""),
@@ -3,9 +3,11 @@
3
3
  Let's start by installing the Mastra memory package:
4
4
 
5
5
  ```bash
6
- npm install @mastra/memory
6
+ npm install @mastra/memory @mastra/libsql
7
7
  ```
8
8
 
9
9
  The `@mastra/memory` package provides all the functionality you need to add memory capabilities to your Mastra agents. It includes support for conversation history, semantic recall, and working memory.
10
10
 
11
- This package is separate from the core Mastra package, allowing you to only include it when you need memory capabilities in your project. This modular approach helps keep your project dependencies lean when you don't need all features.
11
+ The `@mastra/libsql` package is **one of many** storage adapters that complement the memory package. The purpose of a storage adapter is to provide a way to persist the memory data to a database or other storage system. The `@mastra/libsql` package provides a storage adapter for LibSQL, which is a fast, open-source fork of SQLite.
12
+
13
+ These packages are separate from the core Mastra package, allowing you to only include them when you need memory capabilities in your project. This modular approach helps keep your project dependencies lean when you don't need all features.
@@ -13,7 +13,7 @@ import { openai } from "@ai-sdk/openai";
13
13
  // Create a basic memory instance
14
14
  const memory = new Memory({
15
15
  storage: new LibSQLStore({
16
- url: "../../memory.db",
16
+ url: "file:../../memory.db", // relative path from the `.mastra/output` directory
17
17
  }),
18
18
  });
19
19
 
@@ -1,6 +1,6 @@
1
1
  # Configuring Conversation History
2
2
 
3
- By default, the `Memory` instance includes the last 40 messages from the current memory thread in each new request. You can customize this by configuring the `lastMessages` option:
3
+ By default, the `Memory` instance includes the last 10 messages from the current memory thread in each new request. You can customize this by configuring the `lastMessages` option:
4
4
 
5
5
  ```typescript
6
6
  import { Agent } from "@mastra/core/agent";
@@ -11,10 +11,10 @@ import { LibSQLStore } from "@mastra/libsql";
11
11
  // Create a memory instance with custom conversation history settings
12
12
  const memory = new Memory({
13
13
  storage: new LibSQLStore({
14
- url: "../../memory.db",
14
+ url: "file:../../memory.db",
15
15
  }),
16
16
  options: {
17
- lastMessages: 20, // Include the last 20 messages in the context
17
+ lastMessages: 20, // Include the last 20 messages in the context instead of the default 10
18
18
  },
19
19
  });
20
20
 
@@ -0,0 +1,27 @@
1
+ # Vector Store Configuration
2
+
3
+ In addition to the memory storage adapters, Mastra also provides vector store adapters useful for storing and retrieving vector embeddings. One of these is the `LibSQLVector` adapter, which provides a simple interface for storing and retrieving vector embeddings in a LibSQL vector database.
4
+
5
+ ```typescript
6
+ import { Memory } from "@mastra/memory";
7
+ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
8
+
9
+ const memory = new Memory({
10
+ storage: new LibSQLStore({
11
+ url: "file:../../memory.db", // relative path from the `.mastra/output` directory
12
+ }),
13
+ vector: new LibSQLVector({
14
+ connectionUrl: "file:../../vector.db", // relative path from the `.mastra/output` directory
15
+ }),
16
+ });
17
+ ```
18
+
19
+ Mastra supports several vector store options, including:
20
+
21
+ - LibSQL
22
+ - Chroma
23
+ - Pinecone
24
+ - Qdrant
25
+ - Postgres (with pgvector)
26
+
27
+ The vector store is responsible for storing and retrieving the vector embeddings used for semantic search.
@@ -1,6 +1,6 @@
1
1
  # Implementing Semantic Recall
2
2
 
3
- In this step, we'll explore semantic recall, a feature that helps agents maintain context across longer interactions when messages are no longer within recent conversation history.
3
+ One of the quickest ways to take advantage of the configured vector store is to use semantic recall.
4
4
 
5
5
  ## What is Semantic Recall?
6
6
 
@@ -0,0 +1,41 @@
1
+ # Configuring Semantic Recall
2
+
3
+ Let's update our agent with custom semantic recall settings:
4
+
5
+ ```typescript
6
+ import { Agent } from "@mastra/core/agent";
7
+ import { Memory } from "@mastra/memory";
8
+ import { openai } from "@ai-sdk/openai";
9
+ import { LibSQLStore, LibSQLVector } from "@mastra/libsql";
10
+
11
+ // Create a memory instance with semantic recall configuration
12
+ const memory = new Memory({
13
+ storage: new LibSQLStore({
14
+ url: "file:../../memory.db", // relative path from the `.mastra/output` directory
15
+ }), // Storage for message history
16
+ vector: new LibSQLVector({
17
+ connectionUrl: "file:../../vector.db", // relative path from the `.mastra/output` directory
18
+ }), // Vector database for semantic search
19
+ embedder: openai.embedding("text-embedding-3-small"), // Embedder for message embeddings
20
+ options: {
21
+ lastMessages: 20, // Include the last 20 messages in the context
22
+ semanticRecall: true, // Enable semantic recall with default settings
23
+ },
24
+ });
25
+
26
+ // Create an agent with the configured memory
27
+ export const memoryAgent = new Agent({
28
+ name: "MemoryAgent",
29
+ instructions: `
30
+ You are a helpful assistant with advanced memory capabilities.
31
+ You can remember previous conversations and user preferences.
32
+ When a user shares information about themselves, acknowledge it and remember it for future reference.
33
+ If asked about something mentioned earlier in the conversation, recall it accurately.
34
+ You can also recall relevant information from older conversations when appropriate.
35
+ `,
36
+ model: openai("gpt-4o"),
37
+ memory: memory,
38
+ });
39
+ ```
40
+
41
+ For semantic recall to work, you need to have a **vector store** configured. You also need to have an **embedder** configured. You may use any `@ai-sdk`-compatible embedding model for this. In this example, we're using OpenAI's `text-embedding-3-small` model.