@mastra/mcp-docs-server 0.13.4 → 0.13.5

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 (62) hide show
  1. package/.docs/organized/changelogs/%40internal%2Fstorage-test-utils.md +8 -8
  2. package/.docs/organized/changelogs/%40mastra%2Fagui.md +12 -12
  3. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +55 -55
  4. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +11 -11
  5. package/.docs/organized/changelogs/%40mastra%2Fcore.md +47 -47
  6. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +42 -42
  7. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +24 -24
  8. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +24 -24
  9. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +72 -72
  10. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +31 -31
  11. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +7 -0
  12. package/.docs/organized/changelogs/%40mastra%2Ffirecrawl.md +14 -14
  13. package/.docs/organized/changelogs/%40mastra%2Floggers.md +9 -9
  14. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +21 -21
  15. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +25 -25
  16. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +25 -25
  17. package/.docs/organized/changelogs/%40mastra%2Fpg.md +14 -14
  18. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +77 -77
  19. package/.docs/organized/changelogs/%40mastra%2Frag.md +14 -14
  20. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -0
  21. package/.docs/organized/changelogs/%40mastra%2Fserver.md +54 -54
  22. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +13 -13
  23. package/.docs/organized/changelogs/create-mastra.md +34 -34
  24. package/.docs/organized/changelogs/mastra.md +79 -79
  25. package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
  26. package/.docs/organized/code-examples/crypto-chatbot.md +9 -9
  27. package/.docs/organized/code-examples/fireworks-r1.md +1 -1
  28. package/.docs/organized/code-examples/memory-per-resource-example.md +1 -1
  29. package/.docs/organized/code-examples/memory-with-pg.md +1 -1
  30. package/.docs/organized/code-examples/memory-with-upstash.md +1 -1
  31. package/.docs/organized/code-examples/openapi-spec-writer.md +4 -4
  32. package/.docs/raw/agents/overview.mdx +16 -33
  33. package/.docs/raw/community/licensing.mdx +27 -19
  34. package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx +279 -0
  35. package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx +1 -1
  36. package/.docs/raw/deployment/server-deployment.mdx +56 -0
  37. package/.docs/raw/deployment/serverless-platforms/index.mdx +0 -1
  38. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +97 -0
  39. package/.docs/raw/frameworks/agentic-uis/assistant-ui.mdx +34 -0
  40. package/.docs/raw/memory/overview.mdx +2 -1
  41. package/.docs/raw/rag/retrieval.mdx +24 -5
  42. package/.docs/raw/reference/agents/generate.mdx +3 -2
  43. package/.docs/raw/reference/agents/stream.mdx +3 -2
  44. package/.docs/raw/reference/cli/dev.mdx +12 -0
  45. package/.docs/raw/reference/legacyWorkflows/createRun.mdx +0 -4
  46. package/.docs/raw/reference/memory/Memory.mdx +12 -6
  47. package/.docs/raw/reference/rag/rerankWithScorer.mdx +213 -0
  48. package/.docs/raw/reference/workflows/create-run.mdx +4 -4
  49. package/.docs/raw/reference/workflows/sendEvent.mdx +49 -0
  50. package/.docs/raw/{local-dev/mastra-dev.mdx → server-db/local-dev-playground.mdx} +10 -3
  51. package/.docs/raw/{client-js/overview.mdx → server-db/mastra-client.mdx} +16 -0
  52. package/.docs/raw/server-db/production-server.mdx +66 -0
  53. package/.docs/raw/tools-mcp/mcp-overview.mdx +4 -6
  54. package/.docs/raw/workflows/control-flow.mdx +34 -34
  55. package/.docs/raw/workflows/overview.mdx +1 -1
  56. package/.docs/raw/workflows/pausing-execution.mdx +74 -37
  57. package/LICENSE.md +11 -42
  58. package/package.json +6 -6
  59. package/.docs/raw/deployment/server.mdx +0 -116
  60. /package/.docs/raw/{deployment → server-db}/custom-api-routes.mdx +0 -0
  61. /package/.docs/raw/{deployment → server-db}/middleware.mdx +0 -0
  62. /package/.docs/raw/{storage/overview.mdx → server-db/storage.mdx} +0 -0
@@ -1,5 +1,58 @@
1
1
  # @mastra/deployer
2
2
 
3
+ ## 0.10.11-alpha.4
4
+
5
+ ### Patch Changes
6
+
7
+ - @mastra/core@0.10.11-alpha.4
8
+
9
+ ## 0.10.11-alpha.3
10
+
11
+ ### Patch Changes
12
+
13
+ - Updated dependencies [c7bbf1e]
14
+ - Updated dependencies [8722d53]
15
+ - Updated dependencies [132027f]
16
+ - Updated dependencies [0c85311]
17
+ - Updated dependencies [cb16baf]
18
+ - @mastra/core@0.10.11-alpha.3
19
+
20
+ ## 0.10.11-alpha.2
21
+
22
+ ### Patch Changes
23
+
24
+ - Updated dependencies [2873c7f]
25
+ - Updated dependencies [1c1c6a1]
26
+ - Updated dependencies [565cc0c]
27
+ - @mastra/core@0.10.11-alpha.2
28
+
29
+ ## 0.10.11-alpha.1
30
+
31
+ ### Patch Changes
32
+
33
+ - Updated dependencies [7f6e403]
34
+ - @mastra/core@0.10.11-alpha.1
35
+
36
+ ## 0.10.11-alpha.0
37
+
38
+ ### Patch Changes
39
+
40
+ - Updated dependencies [f8ce2cc]
41
+ - Updated dependencies [8c846b6]
42
+ - Updated dependencies [b790fd1]
43
+ - Updated dependencies [d7ed04d]
44
+ - Updated dependencies [f36e4f1]
45
+ - @mastra/core@0.10.11-alpha.0
46
+
47
+ ## 0.10.10
48
+
49
+ ### Patch Changes
50
+
51
+ - 6e13b80: Add error cause and stack trace to mastra server error handler
52
+ - 6997af1: add send event to server, deployer, client-js and playground-ui
53
+ - Updated dependencies [4d3fbdf]
54
+ - @mastra/core@0.10.10
55
+
3
56
  ## 0.10.10-alpha.1
4
57
 
5
58
  ### Patch Changes
@@ -245,58 +298,5 @@
245
298
  ### Patch Changes
246
299
 
247
300
  - ee9af57: Add api for polling run execution result and get run by id
248
- - 3270d9d: Fix runtime context being undefined
249
- - Updated dependencies [ee9af57]
250
- - Updated dependencies [751c894]
251
- - Updated dependencies [577ce3a]
252
- - Updated dependencies [9260b3a]
253
- - @mastra/core@0.10.6-alpha.1
254
-
255
- ## 0.10.6-alpha.0
256
-
257
- ### Patch Changes
258
-
259
- - 53d3c37: Get workflows from an agent if not found from Mastra instance #5083
260
- - Updated dependencies [63f6b7d]
261
- - Updated dependencies [36f1c36]
262
- - Updated dependencies [10d352e]
263
- - Updated dependencies [53d3c37]
264
- - @mastra/core@0.10.6-alpha.0
265
-
266
- ## 0.10.5
267
-
268
- ### Patch Changes
269
-
270
- - 1ba421d: fix the tools not showing on workflows attached to agents
271
- - Updated dependencies [13c97f9]
272
- - @mastra/core@0.10.5
273
-
274
- ## 0.10.4
275
-
276
- ### Patch Changes
277
-
278
- - f1f1f1b: Add basic filtering capabilities to logs
279
- - 9597ee5: Hoist runtimeContext from POST request into middleware
280
- - 82090c1: Add pagination to logs
281
- - bebd27c: Only apply <placeholder> text inside instructions in the playground ui
282
- - Updated dependencies [d1ed912]
283
- - Updated dependencies [f6fd25f]
284
- - Updated dependencies [dffb67b]
285
- - Updated dependencies [f1f1f1b]
286
- - Updated dependencies [925ab94]
287
- - Updated dependencies [f9816ae]
288
- - Updated dependencies [82090c1]
289
- - Updated dependencies [1b443fd]
290
- - Updated dependencies [ce97900]
291
- - Updated dependencies [f1309d3]
292
- - Updated dependencies [14a2566]
293
- - Updated dependencies [f7f8293]
294
- - Updated dependencies [48eddb9]
295
- - @mastra/core@0.10.4
296
-
297
- ## 0.10.4-alpha.3
298
-
299
- ### Patch Changes
300
-
301
301
 
302
- ... 2241 more lines hidden. See full changelog in package directory.
302
+ ... 2294 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,16 @@
1
1
  # @mastra/upstash
2
2
 
3
+ ## 0.12.1-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - bef10e5: dependencies updates:
8
+ - Updated dependency [`@upstash/vector@^1.2.2` ↗︎](https://www.npmjs.com/package/@upstash/vector/v/1.2.2) (from `^1.2.1`, in `dependencies`)
9
+ - Updated dependencies [2873c7f]
10
+ - Updated dependencies [1c1c6a1]
11
+ - Updated dependencies [565cc0c]
12
+ - @mastra/core@0.10.11-alpha.2
13
+
3
14
  ## 0.12.0
4
15
 
5
16
  ### Minor Changes
@@ -287,16 +298,5 @@
287
298
  ### Patch Changes
288
299
 
289
300
  - e60402a: Use scan instead of keys for upstash redis and implement batchInsert
290
- - Updated dependencies [d70b807]
291
- - Updated dependencies [6d16390]
292
- - Updated dependencies [1e4a421]
293
- - Updated dependencies [200d0da]
294
- - Updated dependencies [bf5f17b]
295
- - Updated dependencies [5343f93]
296
- - Updated dependencies [38aee50]
297
- - Updated dependencies [5c41100]
298
- - Updated dependencies [d6a759b]
299
- - Updated dependencies [6015bdf]
300
- - @mastra/core@0.10.1
301
-
302
- ... 1590 more lines hidden. See full changelog in package directory.
301
+
302
+ ... 1601 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,38 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.10.10-alpha.3
4
+
5
+ ### Patch Changes
6
+
7
+ - f457d86: reset localstorage when resetting model settings
8
+ - 8722d53: Fix multi modal remaining steps
9
+
10
+ ## 0.10.10-alpha.2
11
+
12
+ ### Patch Changes
13
+
14
+ - 4219597: add JSON input close to form input
15
+ - 18ca936: Update rollup config for create-mastra
16
+
17
+ ## 0.10.10-alpha.1
18
+
19
+ ### Patch Changes
20
+
21
+ - a7a836a: Highlight send event button
22
+
23
+ ## 0.10.10-alpha.0
24
+
25
+ ### Patch Changes
26
+
27
+ - af9e40e: Map log level number to string value
28
+ - b790fd1: Use SerializedStepFlowEntry in playground
29
+
30
+ ## 0.10.9
31
+
32
+ ### Patch Changes
33
+
34
+ - 6997af1: add send event to server, deployer, client-js and playground-ui
35
+
3
36
  ## 0.10.9-alpha.0
4
37
 
5
38
  ### Patch Changes
@@ -265,38 +298,5 @@
265
298
 
266
299
  - 7a32205: add empty states for workflows, agents and mcp servers
267
300
 
268
- ## 0.10.1-alpha.0
269
-
270
- ### Patch Changes
271
-
272
- - 35bb6a3: Allow undefined temprature, topP model setting from playground
273
-
274
- ## 0.10.0
275
-
276
- ### Patch Changes
277
-
278
- - bdb7934: fix tools not showing (discoverability)
279
- - b3a3d63: BREAKING: Make vnext workflow the default worklow, and old workflow legacy_workflow
280
- - ae122cc: show the entities ID close to the copy button
281
- - 99552bc: revamp the UI of the tools page
282
- - f2d3352: fix overflow scroll in runtime context
283
- - 95911be: Fixed an issue where if @mastra/core was not released at the same time as create-mastra, create-mastra would match the alpha tag instead of latest tag when running npm create mastra@latest
284
- - db4211d: improve the UI/UX of the runtime context with formatting, copying, docs and syntax highlighting
285
- - 9b7294a: Revamp the UI for the right sidebar of the agents page
286
- - e2c2cf1: Persist playground agent settings across refresh
287
- - 47776b4: update the mcp pages
288
- - fd69cc3: revamp UI of workflow "Run" pane
289
- - 1270183: Add waterfull traces instead of stacked progressbar (UI improvement mostly)
290
- - 392a14d: changing the empty state for threads in agent chat
291
- - cbf153f: Handle broken images on the playground
292
- - 0cae9b1: sidebar adjustments (storing status + showing the action of collapsing / expanding)
293
- - d2b595a: a better tools playground page
294
- - 1f6886f: bring back the memory not activated warning in agent chat
295
- - 8a68886: revamp the UI of the workflow form input
296
-
297
- ## 0.3.4-alpha.2
298
-
299
- ### Patch Changes
300
-
301
301
 
302
- ... 965 more lines hidden. See full changelog in package directory.
302
+ ... 998 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,83 @@
1
1
  # mastra
2
2
 
3
+ ## 0.10.11-alpha.3
4
+
5
+ ### Patch Changes
6
+
7
+ - f457d86: reset localstorage when resetting model settings
8
+ - 8722d53: Fix multi modal remaining steps
9
+ - Updated dependencies [c7bbf1e]
10
+ - Updated dependencies [8722d53]
11
+ - Updated dependencies [132027f]
12
+ - Updated dependencies [0c85311]
13
+ - Updated dependencies [c0ba5e2]
14
+ - Updated dependencies [cb16baf]
15
+ - @mastra/core@0.10.11-alpha.3
16
+ - @mastra/mcp@0.10.6-alpha.1
17
+ - @mastra/deployer@0.10.11-alpha.3
18
+
19
+ ## 0.10.11-alpha.2
20
+
21
+ ### Patch Changes
22
+
23
+ - ec77f83: Expose --inspect flag for mastra dev to start debugger
24
+ - 565cc0c: fix redirection when clicking on the playground breadcrumbs
25
+ - 4219597: add JSON input close to form input
26
+ - 2873c7f: dependencies updates:
27
+ - Updated dependency [`dotenv@^16.6.1` ↗︎](https://www.npmjs.com/package/dotenv/v/16.6.1) (from `^16.5.0`, in `dependencies`)
28
+ - Updated dependencies [2873c7f]
29
+ - Updated dependencies [1c1c6a1]
30
+ - Updated dependencies [2873c7f]
31
+ - Updated dependencies [1c1c6a1]
32
+ - Updated dependencies [d9b26b5]
33
+ - Updated dependencies [f5ec3a4]
34
+ - Updated dependencies [ab3bbff]
35
+ - Updated dependencies [565cc0c]
36
+ - Updated dependencies [18ca936]
37
+ - @mastra/core@0.10.11-alpha.2
38
+ - @mastra/deployer@0.10.11-alpha.2
39
+ - @mastra/mcp@0.10.6-alpha.0
40
+
41
+ ## 0.10.11-alpha.1
42
+
43
+ ### Patch Changes
44
+
45
+ - a7a836a: Highlight send event button
46
+ - Updated dependencies [7f6e403]
47
+ - @mastra/core@0.10.11-alpha.1
48
+ - @mastra/deployer@0.10.11-alpha.1
49
+
50
+ ## 0.10.11-alpha.0
51
+
52
+ ### Patch Changes
53
+
54
+ - af9e40e: Map log level number to string value
55
+ - a9f51e4: Fix plaground get tools not including x-mastra-dev-header"
56
+ - 3322d00: Fix tools watcher in dev
57
+ - b790fd1: Use SerializedStepFlowEntry in playground
58
+ - Updated dependencies [bc40cdd]
59
+ - Updated dependencies [f8ce2cc]
60
+ - Updated dependencies [8c846b6]
61
+ - Updated dependencies [b790fd1]
62
+ - Updated dependencies [d7ed04d]
63
+ - Updated dependencies [f36e4f1]
64
+ - @mastra/deployer@0.10.11-alpha.0
65
+ - @mastra/core@0.10.11-alpha.0
66
+
67
+ ## 0.10.10
68
+
69
+ ### Patch Changes
70
+
71
+ - 6997af1: add send event to server, deployer, client-js and playground-ui
72
+ - 4d3fbdf: Return tool error message rather than throw when a tool error happens for agent and tool playground page.
73
+ - Updated dependencies [6e13b80]
74
+ - Updated dependencies [25bf999]
75
+ - Updated dependencies [6997af1]
76
+ - Updated dependencies [4d3fbdf]
77
+ - @mastra/deployer@0.10.10
78
+ - @mastra/loggers@0.10.3
79
+ - @mastra/core@0.10.10
80
+
3
81
  ## 0.10.10-alpha.2
4
82
 
5
83
  ### Patch Changes
@@ -220,83 +298,5 @@
220
298
  - Updated dependencies [8e1b6e9]
221
299
  - Updated dependencies [36cd0f1]
222
300
  - Updated dependencies [2eab82b]
223
- - Updated dependencies [ee93d96]
224
- - Updated dependencies [c00039d]
225
- - Updated dependencies [15e9d26]
226
- - Updated dependencies [9bf1d55]
227
- - Updated dependencies [914684e]
228
- - Updated dependencies [07d6d88]
229
- - Updated dependencies [5d74aab]
230
- - Updated dependencies [5d74aab]
231
- - Updated dependencies [17903a3]
232
- - Updated dependencies [144eb0b]
233
- - @mastra/deployer@0.10.7-alpha.2
234
- - @mastra/mcp@0.10.5-alpha.1
235
- - @mastra/core@0.10.7-alpha.2
236
-
237
- ## 0.10.7-alpha.1
238
-
239
- ### Patch Changes
240
-
241
- - 21ffb97: Make dynamic form handle schema better
242
- - Updated dependencies [d1baedb]
243
- - Updated dependencies [4d21bf2]
244
- - Updated dependencies [2097952]
245
- - Updated dependencies [4fb0cc2]
246
- - Updated dependencies [d2a7a31]
247
- - Updated dependencies [0e17048]
248
- - @mastra/core@0.10.7-alpha.1
249
- - @mastra/mcp@0.10.5-alpha.0
250
- - @mastra/deployer@0.10.7-alpha.1
251
-
252
- ## 0.10.7-alpha.0
253
-
254
- ### Patch Changes
255
-
256
- - 9102d89: Fix final output not showing on playground for previously suspended steps
257
- - Updated dependencies [d8f2d19]
258
- - Updated dependencies [9d52b17]
259
- - Updated dependencies [8ba1b51]
260
- - @mastra/core@0.10.7-alpha.0
261
- - @mastra/deployer@0.10.7-alpha.0
262
-
263
- ## 0.10.6
264
-
265
- ### Patch Changes
266
301
 
267
- - 02560d4: lift evals fetching to the playground package instead
268
- - 084f6aa: Add logs to circular dependency to warn people when starting server might break
269
- - b29c802: Remove open browser
270
- - 5f2aa3e: Move workflow hooks to playground
271
- - 4051477: dependencies updates:
272
- - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
273
- - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
274
- - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
275
- - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
276
- - Added dependency [`open@^10.1.2` ↗︎](https://www.npmjs.com/package/open/v/10.1.2) (to `dependencies`)
277
- - b40f365: dependencies updates:
278
- - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
279
- - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
280
- - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
281
- - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
282
- - 63f6b7d: dependencies updates:
283
- - Updated dependency [`execa@^9.6.0` ↗︎](https://www.npmjs.com/package/execa/v/9.6.0) (from `^9.5.2`, in `dependencies`)
284
- - Updated dependency [`json-schema-to-zod@^2.6.1` ↗︎](https://www.npmjs.com/package/json-schema-to-zod/v/2.6.1) (from `^2.6.0`, in `dependencies`)
285
- - Updated dependency [`shell-quote@^1.8.3` ↗︎](https://www.npmjs.com/package/shell-quote/v/1.8.3) (from `^1.8.2`, in `dependencies`)
286
- - Updated dependency [`strip-json-comments@^5.0.2` ↗︎](https://www.npmjs.com/package/strip-json-comments/v/5.0.2) (from `^5.0.1`, in `dependencies`)
287
- - Updated dependency [`zod@^3.25.57` ↗︎](https://www.npmjs.com/package/zod/v/3.25.57) (from `^3.25.56`, in `dependencies`)
288
- - 143b4e4: Fix globbing of tools to only capture js/ts files
289
- - 44ba52d: Add proper error message when installation of mastra fails
290
- - 311132e: move useWorkflow to playground instead of playground-ui
291
- - 3270d9d: Fix runtime context being undefined
292
- - 906f992: CLI error log
293
- - 53d3c37: Get workflows from an agent if not found from Mastra instance #5083
294
- - fc677d7: For final result for a workflow
295
- - 47e7029: Add open browser functionality when running mastra dev
296
- - Updated dependencies [63f6b7d]
297
- - Updated dependencies [4051477]
298
- - Updated dependencies [2d12edd]
299
- - Updated dependencies [63f6b7d]
300
- - Updated dependencies [c28ed65]
301
-
302
- ... 4157 more lines hidden. See full changelog in package directory.
302
+ ... 4235 more lines hidden. See full changelog in package directory.
@@ -6,7 +6,7 @@
6
6
  "@types/express": "^4.0.0",
7
7
  "@types/node": "^20.17.57",
8
8
  "concurrently": "^9.1.2",
9
- "dotenv": "^16.5.0",
9
+ "dotenv": "^17.0.0",
10
10
  "express": "^4.21.2",
11
11
  "nodemon": "^3.1.9",
12
12
  "ts-node": "^10.9.2",
@@ -10,16 +10,16 @@
10
10
  "@mastra/memory": "latest",
11
11
  "@mastra/pg": "latest",
12
12
  "@next/env": "^15.2.2",
13
- "@radix-ui/react-alert-dialog": "^1.1.6",
14
- "@radix-ui/react-dialog": "^1.1.6",
15
- "@radix-ui/react-dropdown-menu": "^2.1.11",
13
+ "@radix-ui/react-alert-dialog": "^1.1.14",
14
+ "@radix-ui/react-dialog": "^1.1.14",
15
+ "@radix-ui/react-dropdown-menu": "^2.1.15",
16
16
  "@radix-ui/react-icons": "^1.3.2",
17
- "@radix-ui/react-label": "^2.1.4",
18
- "@radix-ui/react-select": "^2.1.6",
19
- "@radix-ui/react-separator": "^1.1.2",
20
- "@radix-ui/react-slot": "^1.1.2",
21
- "@radix-ui/react-tooltip": "^1.1.8",
22
- "@radix-ui/react-visually-hidden": "^1.1.2",
17
+ "@radix-ui/react-label": "^2.1.7",
18
+ "@radix-ui/react-select": "^2.2.5",
19
+ "@radix-ui/react-separator": "^1.1.7",
20
+ "@radix-ui/react-slot": "^1.2.3",
21
+ "@radix-ui/react-tooltip": "^1.2.7",
22
+ "@radix-ui/react-visually-hidden": "^1.2.3",
23
23
  "@typescript-eslint/parser": "^8.31.0",
24
24
  "@vercel/analytics": "^1.5.0",
25
25
  "@vercel/blob": "^1.0.0",
@@ -17,7 +17,7 @@
17
17
  },
18
18
  "devDependencies": {
19
19
  "@types/node": "^20.17.57",
20
- "dotenv": "^16.5.0",
20
+ "dotenv": "^17.0.0",
21
21
  "mastra": "latest",
22
22
  "tsx": "^4.19.3",
23
23
  "typescript": "^5.8.2"
@@ -3,7 +3,7 @@
3
3
  {
4
4
  "name": "memory-per-resource-example",
5
5
  "dependencies": {
6
- "@ai-sdk/openai": "^0.0.68",
6
+ "@ai-sdk/openai": "^1.3.22",
7
7
  "@mastra/core": "latest",
8
8
  "@mastra/memory": "latest",
9
9
  "@mastra/libsql": "latest",
@@ -9,7 +9,7 @@
9
9
  "@mastra/pg": "latest"
10
10
  },
11
11
  "devDependencies": {
12
- "dotenv": "^16.5.0",
12
+ "dotenv": "^17.0.0",
13
13
  "tsx": "^4.19.3"
14
14
  }
15
15
  }
@@ -10,7 +10,7 @@
10
10
  "@mastra/upstash": "latest"
11
11
  },
12
12
  "devDependencies": {
13
- "dotenv": "^16.5.0",
13
+ "dotenv": "^17.0.0",
14
14
  "tsx": "^4.19.3"
15
15
  }
16
16
  }
@@ -9,10 +9,10 @@
9
9
  "@mastra/github": "latest",
10
10
  "@mastra/loggers": "latest",
11
11
  "@mastra/rag": "latest",
12
- "@radix-ui/react-accordion": "^1.2.3",
13
- "@radix-ui/react-dialog": "^1.1.6",
14
- "@radix-ui/react-select": "^2.1.6",
15
- "@radix-ui/react-slot": "^1.1.2",
12
+ "@radix-ui/react-accordion": "^1.2.11",
13
+ "@radix-ui/react-dialog": "^1.1.14",
14
+ "@radix-ui/react-select": "^2.2.5",
15
+ "@radix-ui/react-slot": "^1.2.3",
16
16
  "class-variance-authority": "^0.7.1",
17
17
  "clsx": "^2.1.1",
18
18
  "lucide-react": "^0.454.0",
@@ -1,13 +1,13 @@
1
1
  ---
2
- title: "Creating and Calling Agents | Agent Documentation | Mastra"
2
+ title: "Agent Overview | Agent Documentation | Mastra"
3
3
  description: Overview of agents in Mastra, detailing their capabilities and how they interact with tools, workflows, and external systems.
4
4
  ---
5
5
 
6
- # Creating and Calling Agents
6
+ # Using Agents
7
7
 
8
- Agents in Mastra are systems where the language model can autonomously decide on a sequence of actions to perform tasks. They have access to tools, workflows, and synced data, enabling them to perform complex tasks and interact with external systems. Agents can invoke your custom functions, utilize third-party APIs through integrations, and access knowledge bases you have built.
8
+ **Agents** are one of the core Mastra primitives. Agents use a language model to decide on a sequence of actions. They can call functions (known as _tools_). You can compose them with *workflows* (the other main Mastra primitive), either by giving an agent a workflow as a tool, or by running an agent from within a workflow.
9
9
 
10
- Agents are like employees who can be used for ongoing projects. They have names, persistent memory, consistent model configurations, and instructions across calls, as well as a set of enabled tools.
10
+ Agents can run autonomously in a loop, run once, or take turns with a user. You can give short-term, long-term, and working memory of their user interactions. They can stream text or return structured output (ie, JSON). They can access third-party APIs, query knowledge bases, and so on.
11
11
 
12
12
  ## 1. Creating an Agent
13
13
 
@@ -185,11 +185,13 @@ console.log("Structured Output:", response.object);
185
185
 
186
186
  This allows you to have strong typing and validation for the structured data returned by the agent.
187
187
 
188
- ## 4. Multi-step Tool use Agents
188
+ ## 4. Multi-step tool use
189
189
 
190
- Agents can be enhanced with tools - functions that extend their capabilities beyond text generation. Tools allow agents to perform calculations, access external systems, and process data. For details on creating and configuring tools, see the [Adding Tools documentation](/docs/agents/using-tools-and-mcp).
190
+ Agents can be enhanced with tools - functions that extend their capabilities beyond text generation. Tools allow agents to perform calculations, access external systems, and process data. Agents not only decide whether to call tools they're given, they determine the parameters that should be given to that tool.
191
191
 
192
- ### Using maxSteps
192
+ For a detailed guide to creating and configuring tools, see the [Adding Tools documentation](/docs/agents/using-tools-and-mcp), but below are the important things to know.
193
+
194
+ ### Using `maxSteps`
193
195
 
194
196
  The `maxSteps` parameter controls the maximum number of sequential LLM calls an agent can make, particularly important when using tool calls. By default, it is set to 1 to prevent infinite loops in case of misconfigured tools. You can increase this limit based on your use case:
195
197
 
@@ -217,7 +219,7 @@ const response = await myAgent.generate(
217
219
  {
218
220
  role: "user",
219
221
  content:
220
- "If a taxi driver earns $9461 per hour and works 12 hours a day, how much do they earn in one day?",
222
+ "If a taxi driver earns $41 per hour and works 12 hours a day, how much do they earn in one day?",
221
223
  },
222
224
  ],
223
225
  {
@@ -226,9 +228,10 @@ const response = await myAgent.generate(
226
228
  );
227
229
  ```
228
230
 
229
- ### Using onStepFinish
231
+ ### Streaming progress with `onStepFinish`
230
232
 
231
233
  You can monitor the progress of multi-step operations using the `onStepFinish` callback. This is useful for debugging or providing progress updates to users.
234
+
232
235
  `onStepFinish` is only available when streaming or generating text without structured output.
233
236
 
234
237
  ```ts showLineNumbers filename="src/mastra/agents/index.ts" copy
@@ -243,7 +246,7 @@ const response = await myAgent.generate(
243
246
  );
244
247
  ```
245
248
 
246
- ### Using onFinish
249
+ ### Detecting completion with `onFinish`
247
250
 
248
251
  The `onFinish` callback is available when streaming responses and provides detailed information about the completed interaction. It is called after the LLM has finished generating its response and all tool executions have completed.
249
252
  This callback receives the final response text, execution steps, token usage statistics, and other metadata that can be useful for monitoring and logging:
@@ -270,31 +273,11 @@ const stream = await myAgent.stream(
270
273
  );
271
274
  ```
272
275
 
273
- ## 5. Running Agents
274
-
275
- Mastra provides a CLI command `mastra dev` to run your agents behind an API. By default, this looks for exported agents in files in the `src/mastra/agents` directory.
276
+ ## 5. Testing agents locally
276
277
 
277
- ### Starting the Server
278
-
279
- ```bash
280
- mastra dev
281
- ```
278
+ Mastra provides a CLI command `mastra dev` to run your agents behind an API. By default, this looks for exported agents in files in the `src/mastra/agents` directory. It generates endpoints for testing your agent (eg `http://localhost:4111/api/agents/myAgent/generate`) and provides a visual playground where you can chat with an agent and view traces.
282
279
 
283
- This will start the server and make your agent available at `http://localhost:4111/api/agents/myAgent/generate`.
284
-
285
- ### Interacting with the Agent
286
-
287
- You can interact with the agent using `curl` from the command line:
288
-
289
- ```bash
290
- curl -X POST http://localhost:4111/api/agents/myAgent/generate \
291
- -H "Content-Type: application/json" \
292
- -d '{
293
- "messages": [
294
- { "role": "user", "content": "Hello, how can you assist me today?" }
295
- ]
296
- }'
297
- ```
280
+ For more details, see the [Local Dev Playground](/docs/server-db/local-dev-playground) docs.
298
281
 
299
282
  ## Next Steps
300
283