@mastra/core 1.18.0-alpha.1 → 1.18.0-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (177) hide show
  1. package/CHANGELOG.md +93 -0
  2. package/dist/agent/agent-legacy.d.ts +3 -3
  3. package/dist/agent/agent-legacy.d.ts.map +1 -1
  4. package/dist/agent/agent.d.ts +12 -12
  5. package/dist/agent/agent.d.ts.map +1 -1
  6. package/dist/agent/index.cjs +8 -8
  7. package/dist/agent/index.js +1 -1
  8. package/dist/agent/types.d.ts +12 -12
  9. package/dist/agent/types.d.ts.map +1 -1
  10. package/dist/agent/workflows/prepare-stream/index.d.ts.map +1 -1
  11. package/dist/agent/workflows/prepare-stream/prepare-memory-step.d.ts +2 -1
  12. package/dist/agent/workflows/prepare-stream/prepare-memory-step.d.ts.map +1 -1
  13. package/dist/{chunk-3U4ZNZIF.js → chunk-32NEFSTI.js} +168 -59
  14. package/dist/chunk-32NEFSTI.js.map +1 -0
  15. package/dist/{chunk-G62XEVSI.cjs → chunk-3UM5VCQ5.cjs} +3 -3
  16. package/dist/{chunk-G62XEVSI.cjs.map → chunk-3UM5VCQ5.cjs.map} +1 -1
  17. package/dist/{chunk-GFBH7Q4W.cjs → chunk-4K2NKQGN.cjs} +331 -222
  18. package/dist/chunk-4K2NKQGN.cjs.map +1 -0
  19. package/dist/{chunk-Z3VUDCXI.cjs → chunk-5IZ346TV.cjs} +7 -7
  20. package/dist/{chunk-Z3VUDCXI.cjs.map → chunk-5IZ346TV.cjs.map} +1 -1
  21. package/dist/{chunk-R2V6BCYX.cjs → chunk-64565EZF.cjs} +9 -9
  22. package/dist/{chunk-R2V6BCYX.cjs.map → chunk-64565EZF.cjs.map} +1 -1
  23. package/dist/{chunk-MSDZQ4DW.cjs → chunk-6LHF5UDX.cjs} +9 -9
  24. package/dist/{chunk-MSDZQ4DW.cjs.map → chunk-6LHF5UDX.cjs.map} +1 -1
  25. package/dist/{chunk-BYJDWJCX.js → chunk-7USX5P3I.js} +3 -3
  26. package/dist/{chunk-BYJDWJCX.js.map → chunk-7USX5P3I.js.map} +1 -1
  27. package/dist/{chunk-FWDG2WUV.js → chunk-AHFHYQS6.js} +3 -3
  28. package/dist/{chunk-FWDG2WUV.js.map → chunk-AHFHYQS6.js.map} +1 -1
  29. package/dist/{chunk-G5HKDGNT.cjs → chunk-B6D4D2CY.cjs} +2 -2
  30. package/dist/{chunk-G5HKDGNT.cjs.map → chunk-B6D4D2CY.cjs.map} +1 -1
  31. package/dist/{chunk-RB2QRGRV.js → chunk-BFRUEBG3.js} +4 -4
  32. package/dist/{chunk-RB2QRGRV.js.map → chunk-BFRUEBG3.js.map} +1 -1
  33. package/dist/{chunk-CT4YYQI3.js → chunk-CX5I6VS4.js} +2 -2
  34. package/dist/{chunk-CT4YYQI3.js.map → chunk-CX5I6VS4.js.map} +1 -1
  35. package/dist/{chunk-UQ2HAEHL.js → chunk-D5VCCQ4L.js} +5 -5
  36. package/dist/{chunk-UQ2HAEHL.js.map → chunk-D5VCCQ4L.js.map} +1 -1
  37. package/dist/{chunk-A2Z26HFR.js → chunk-FB6O7FNK.js} +42 -61
  38. package/dist/chunk-FB6O7FNK.js.map +1 -0
  39. package/dist/{chunk-PQWEJELD.cjs → chunk-GVHBM6VU.cjs} +6 -6
  40. package/dist/{chunk-PQWEJELD.cjs.map → chunk-GVHBM6VU.cjs.map} +1 -1
  41. package/dist/{chunk-ZOJZL62I.js → chunk-HDPQ3LEE.js} +4 -4
  42. package/dist/{chunk-ZOJZL62I.js.map → chunk-HDPQ3LEE.js.map} +1 -1
  43. package/dist/{chunk-TKKBZUWD.js → chunk-IR4WRS3N.js} +38 -14
  44. package/dist/chunk-IR4WRS3N.js.map +1 -0
  45. package/dist/{chunk-D4DCPE5Y.js → chunk-MP2VGF73.js} +3 -3
  46. package/dist/{chunk-D4DCPE5Y.js.map → chunk-MP2VGF73.js.map} +1 -1
  47. package/dist/{chunk-KL2IRBNK.cjs → chunk-OKKJRRSS.cjs} +39 -15
  48. package/dist/chunk-OKKJRRSS.cjs.map +1 -0
  49. package/dist/{chunk-2U4M4SGY.cjs → chunk-OVWOD5GI.cjs} +53 -72
  50. package/dist/chunk-OVWOD5GI.cjs.map +1 -0
  51. package/dist/{chunk-MBJ6IAKF.cjs → chunk-OXS5X7PW.cjs} +13 -13
  52. package/dist/{chunk-MBJ6IAKF.cjs.map → chunk-OXS5X7PW.cjs.map} +1 -1
  53. package/dist/{chunk-HEHK7LXS.js → chunk-OYAHOEQP.js} +4 -4
  54. package/dist/{chunk-HEHK7LXS.js.map → chunk-OYAHOEQP.js.map} +1 -1
  55. package/dist/{chunk-UPCNNWXW.cjs → chunk-PYNUWPGW.cjs} +19 -19
  56. package/dist/{chunk-UPCNNWXW.cjs.map → chunk-PYNUWPGW.cjs.map} +1 -1
  57. package/dist/{chunk-7IDACSBM.cjs → chunk-QXPUTX3W.cjs} +32 -32
  58. package/dist/chunk-QXPUTX3W.cjs.map +1 -0
  59. package/dist/{chunk-VMKNS3YO.js → chunk-SLHDZJ4B.js} +3 -3
  60. package/dist/chunk-SLHDZJ4B.js.map +1 -0
  61. package/dist/{chunk-3O73Q6M2.cjs → chunk-T5XU5TAV.cjs} +82 -82
  62. package/dist/{chunk-3O73Q6M2.cjs.map → chunk-T5XU5TAV.cjs.map} +1 -1
  63. package/dist/{chunk-3NMSFQPY.js → chunk-UORUVXKY.js} +5 -5
  64. package/dist/{chunk-3NMSFQPY.js.map → chunk-UORUVXKY.js.map} +1 -1
  65. package/dist/{chunk-JFPVUKPB.cjs → chunk-VVR3SFKH.cjs} +68 -68
  66. package/dist/{chunk-JFPVUKPB.cjs.map → chunk-VVR3SFKH.cjs.map} +1 -1
  67. package/dist/{chunk-EYM6DWKD.js → chunk-W2QYKEBN.js} +5 -5
  68. package/dist/{chunk-EYM6DWKD.js.map → chunk-W2QYKEBN.js.map} +1 -1
  69. package/dist/{chunk-PK3X5KIF.cjs → chunk-X36INADV.cjs} +23 -23
  70. package/dist/{chunk-PK3X5KIF.cjs.map → chunk-X36INADV.cjs.map} +1 -1
  71. package/dist/{chunk-WYFCQAHY.js → chunk-YBVRBNRY.js} +7 -7
  72. package/dist/{chunk-WYFCQAHY.js.map → chunk-YBVRBNRY.js.map} +1 -1
  73. package/dist/{chunk-K22Q6XPG.js → chunk-ZFH5KWHO.js} +3 -3
  74. package/dist/{chunk-K22Q6XPG.js.map → chunk-ZFH5KWHO.js.map} +1 -1
  75. package/dist/{chunk-UEZU2TA2.cjs → chunk-ZFZ6HQFT.cjs} +185 -185
  76. package/dist/{chunk-UEZU2TA2.cjs.map → chunk-ZFZ6HQFT.cjs.map} +1 -1
  77. package/dist/datasets/index.cjs +17 -17
  78. package/dist/datasets/index.js +2 -2
  79. package/dist/docs/SKILL.md +1 -3
  80. package/dist/docs/assets/SOURCE_MAP.json +469 -469
  81. package/dist/docs/references/docs-memory-observational-memory.md +49 -4
  82. package/dist/docs/references/docs-server-mastra-client.md +17 -0
  83. package/dist/docs/references/reference-client-js-agents.md +11 -6
  84. package/dist/docs/references/reference-evals-scorer-utils.md +9 -5
  85. package/dist/docs/references/reference-evals-trajectory-accuracy.md +29 -15
  86. package/dist/docs/references/reference-logging-pino-logger.md +58 -0
  87. package/dist/docs/references/reference-memory-observational-memory.md +32 -6
  88. package/dist/docs/references/reference.md +0 -2
  89. package/dist/evals/index.cjs +23 -23
  90. package/dist/evals/index.js +3 -3
  91. package/dist/evals/scoreTraces/index.cjs +7 -7
  92. package/dist/evals/scoreTraces/index.js +3 -3
  93. package/dist/evals/types.d.ts +58 -28
  94. package/dist/evals/types.d.ts.map +1 -1
  95. package/dist/harness/harness.d.ts.map +1 -1
  96. package/dist/harness/index.cjs +28 -8
  97. package/dist/harness/index.cjs.map +1 -1
  98. package/dist/harness/index.js +26 -6
  99. package/dist/harness/index.js.map +1 -1
  100. package/dist/index.cjs +2 -2
  101. package/dist/index.js +1 -1
  102. package/dist/llm/index.cjs +16 -16
  103. package/dist/llm/index.js +5 -5
  104. package/dist/llm/model/provider-types.generated.d.ts +14 -2
  105. package/dist/loop/index.cjs +14 -14
  106. package/dist/loop/index.js +1 -1
  107. package/dist/loop/workflows/agentic-execution/llm-execution-step.d.ts.map +1 -1
  108. package/dist/mastra/index.cjs +2 -2
  109. package/dist/mastra/index.d.ts +11 -0
  110. package/dist/mastra/index.d.ts.map +1 -1
  111. package/dist/mastra/index.js +1 -1
  112. package/dist/memory/index.cjs +14 -14
  113. package/dist/memory/index.js +1 -1
  114. package/dist/memory/memory.d.ts.map +1 -1
  115. package/dist/memory/types.d.ts +16 -2
  116. package/dist/memory/types.d.ts.map +1 -1
  117. package/dist/models-dev-MIC2CW43.cjs +12 -0
  118. package/dist/{models-dev-BJHT4GXA.cjs.map → models-dev-MIC2CW43.cjs.map} +1 -1
  119. package/dist/models-dev-VDZIOMAC.js +3 -0
  120. package/dist/{models-dev-3U6ICCNW.js.map → models-dev-VDZIOMAC.js.map} +1 -1
  121. package/dist/netlify-2CGMKEKT.js +3 -0
  122. package/dist/{netlify-DE3IXMT2.js.map → netlify-2CGMKEKT.js.map} +1 -1
  123. package/dist/netlify-KZ4HQR5N.cjs +12 -0
  124. package/dist/{netlify-UARJYMCW.cjs.map → netlify-KZ4HQR5N.cjs.map} +1 -1
  125. package/dist/observability/index.cjs +18 -18
  126. package/dist/observability/index.js +1 -1
  127. package/dist/observability/types/tracing.d.ts +3 -0
  128. package/dist/observability/types/tracing.d.ts.map +1 -1
  129. package/dist/processor-provider/index.cjs +10 -10
  130. package/dist/processor-provider/index.js +1 -1
  131. package/dist/processors/index.cjs +44 -44
  132. package/dist/processors/index.js +1 -1
  133. package/dist/processors/tool-result-reminder.d.ts +2 -0
  134. package/dist/processors/tool-result-reminder.d.ts.map +1 -1
  135. package/dist/provider-registry-HGWTTWCL.cjs +40 -0
  136. package/dist/{provider-registry-65CPGTUU.cjs.map → provider-registry-HGWTTWCL.cjs.map} +1 -1
  137. package/dist/provider-registry-QRWUBN5N.js +3 -0
  138. package/dist/{provider-registry-EQAT7FXK.js.map → provider-registry-QRWUBN5N.js.map} +1 -1
  139. package/dist/provider-registry.json +34 -10
  140. package/dist/relevance/index.cjs +3 -3
  141. package/dist/relevance/index.js +1 -1
  142. package/dist/storage/constants.cjs +56 -56
  143. package/dist/storage/constants.js +1 -1
  144. package/dist/storage/index.cjs +268 -268
  145. package/dist/storage/index.js +3 -3
  146. package/dist/stream/index.cjs +8 -8
  147. package/dist/stream/index.js +1 -1
  148. package/dist/test-utils/llm-mock.cjs +4 -4
  149. package/dist/test-utils/llm-mock.js +1 -1
  150. package/dist/tool-loop-agent/index.cjs +4 -4
  151. package/dist/tool-loop-agent/index.js +1 -1
  152. package/dist/utils.cjs +23 -23
  153. package/dist/utils.js +1 -1
  154. package/dist/vector/index.cjs +7 -7
  155. package/dist/vector/index.js +1 -1
  156. package/dist/workflows/evented/index.cjs +10 -10
  157. package/dist/workflows/evented/index.js +1 -1
  158. package/dist/workflows/index.cjs +24 -24
  159. package/dist/workflows/index.js +1 -1
  160. package/package.json +5 -4
  161. package/src/llm/model/provider-types.generated.d.ts +14 -2
  162. package/dist/chunk-2U4M4SGY.cjs.map +0 -1
  163. package/dist/chunk-3U4ZNZIF.js.map +0 -1
  164. package/dist/chunk-7IDACSBM.cjs.map +0 -1
  165. package/dist/chunk-A2Z26HFR.js.map +0 -1
  166. package/dist/chunk-GFBH7Q4W.cjs.map +0 -1
  167. package/dist/chunk-KL2IRBNK.cjs.map +0 -1
  168. package/dist/chunk-TKKBZUWD.js.map +0 -1
  169. package/dist/chunk-VMKNS3YO.js.map +0 -1
  170. package/dist/docs/references/reference-core-getStoredAgentById.md +0 -87
  171. package/dist/docs/references/reference-core-listStoredAgents.md +0 -91
  172. package/dist/models-dev-3U6ICCNW.js +0 -3
  173. package/dist/models-dev-BJHT4GXA.cjs +0 -12
  174. package/dist/netlify-DE3IXMT2.js +0 -3
  175. package/dist/netlify-UARJYMCW.cjs +0 -12
  176. package/dist/provider-registry-65CPGTUU.cjs +0 -40
  177. package/dist/provider-registry-EQAT7FXK.js +0 -3
@@ -1,91 +0,0 @@
1
- # Mastra.listStoredAgents()
2
-
3
- The `.listStoredAgents()` method retrieves a paginated list of agent configurations from storage. By default, it returns executable `Agent` instances, but can also return raw storage data.
4
-
5
- ## Usage example
6
-
7
- ```typescript
8
- // Get Agent instances from storage
9
- const { agents, total, hasMore } = await mastra.listStoredAgents()
10
-
11
- for (const agent of agents) {
12
- console.log(agent.id, agent.name)
13
- // Each agent is ready to use
14
- // const response = await agent.generate("Hello");
15
- }
16
- ```
17
-
18
- ```typescript
19
- // Get paginated results with raw storage data
20
- const result = await mastra.listStoredAgents({
21
- page: 0,
22
- perPage: 10,
23
- raw: true,
24
- })
25
-
26
- console.log(`Showing ${result.agents.length} of ${result.total} agents`)
27
- console.log(`Has more: ${result.hasMore}`)
28
-
29
- for (const config of result.agents) {
30
- console.log(config.id, config.name, config.createdAt)
31
- }
32
- ```
33
-
34
- ## Parameters
35
-
36
- **args** (`object`): Optional configuration object for pagination and output format.
37
-
38
- **args.page** (`number`): Zero-indexed page number for pagination.
39
-
40
- **args.perPage** (`number | false`): Number of items per page. Set to \`false\` to fetch all records without pagination.
41
-
42
- **args.raw** (`boolean`): When \`true\`, returns raw \`StorageAgentType\` objects instead of \`Agent\` instances.
43
-
44
- ## Returns
45
-
46
- **agents** (`Agent[] | StorageAgentType[]`): Array of \`Agent\` instances by default, or \`StorageAgentType\` objects when \`raw: true\`.
47
-
48
- **total** (`number`): Total number of stored agents across all pages.
49
-
50
- **page** (`number`): Current page number (zero-indexed).
51
-
52
- **perPage** (`number | false`): Number of items per page, or \`false\` if fetching all.
53
-
54
- **hasMore** (`boolean`): Whether there are more pages available.
55
-
56
- ## Primitive resolution
57
-
58
- When creating `Agent` instances (default behavior), each stored agent's configuration is resolved against registered primitives:
59
-
60
- - **Tools**: Resolved from `tools` registered in Mastra config
61
- - **Workflows**: Resolved from `workflows` registered in Mastra config
62
- - **Subagents**: Resolved from `agents` registered in Mastra config
63
- - **Memory**: Resolved from `memory` registered in Mastra config
64
- - **Scorers**: Resolved from `scorers` registered in Mastra config
65
-
66
- If a referenced primitive isn't found, a warning is logged but the agent is still created.
67
-
68
- ## Example: Iterating through all stored agents
69
-
70
- ```typescript
71
- async function getAllStoredAgents(mastra: Mastra) {
72
- const allAgents: Agent[] = []
73
- let page = 0
74
- let hasMore = true
75
-
76
- while (hasMore) {
77
- const result = await mastra.listStoredAgents({ page, perPage: 50 })
78
- allAgents.push(...result.agents)
79
- hasMore = result.hasMore
80
- page++
81
- }
82
-
83
- return allAgents
84
- }
85
- ```
86
-
87
- ## Related
88
-
89
- - [Mastra.getStoredAgentById()](https://mastra.ai/reference/core/getStoredAgentById)
90
- - [Storage overview](https://mastra.ai/reference/storage/overview)
91
- - [Agents overview](https://mastra.ai/docs/agents/overview)
@@ -1,3 +0,0 @@
1
- export { ModelsDevGateway } from './chunk-BYJDWJCX.js';
2
- //# sourceMappingURL=models-dev-3U6ICCNW.js.map
3
- //# sourceMappingURL=models-dev-3U6ICCNW.js.map
@@ -1,12 +0,0 @@
1
- 'use strict';
2
-
3
- var chunkUEZU2TA2_cjs = require('./chunk-UEZU2TA2.cjs');
4
-
5
-
6
-
7
- Object.defineProperty(exports, "ModelsDevGateway", {
8
- enumerable: true,
9
- get: function () { return chunkUEZU2TA2_cjs.ModelsDevGateway; }
10
- });
11
- //# sourceMappingURL=models-dev-BJHT4GXA.cjs.map
12
- //# sourceMappingURL=models-dev-BJHT4GXA.cjs.map
@@ -1,3 +0,0 @@
1
- export { NetlifyGateway } from './chunk-D4DCPE5Y.js';
2
- //# sourceMappingURL=netlify-DE3IXMT2.js.map
3
- //# sourceMappingURL=netlify-DE3IXMT2.js.map
@@ -1,12 +0,0 @@
1
- 'use strict';
2
-
3
- var chunkMSDZQ4DW_cjs = require('./chunk-MSDZQ4DW.cjs');
4
-
5
-
6
-
7
- Object.defineProperty(exports, "NetlifyGateway", {
8
- enumerable: true,
9
- get: function () { return chunkMSDZQ4DW_cjs.NetlifyGateway; }
10
- });
11
- //# sourceMappingURL=netlify-UARJYMCW.cjs.map
12
- //# sourceMappingURL=netlify-UARJYMCW.cjs.map
@@ -1,40 +0,0 @@
1
- 'use strict';
2
-
3
- var chunkKL2IRBNK_cjs = require('./chunk-KL2IRBNK.cjs');
4
-
5
-
6
-
7
- Object.defineProperty(exports, "GatewayRegistry", {
8
- enumerable: true,
9
- get: function () { return chunkKL2IRBNK_cjs.GatewayRegistry; }
10
- });
11
- Object.defineProperty(exports, "PROVIDER_MODELS", {
12
- enumerable: true,
13
- get: function () { return chunkKL2IRBNK_cjs.PROVIDER_MODELS; }
14
- });
15
- Object.defineProperty(exports, "PROVIDER_REGISTRY", {
16
- enumerable: true,
17
- get: function () { return chunkKL2IRBNK_cjs.PROVIDER_REGISTRY; }
18
- });
19
- Object.defineProperty(exports, "getProviderConfig", {
20
- enumerable: true,
21
- get: function () { return chunkKL2IRBNK_cjs.getProviderConfig; }
22
- });
23
- Object.defineProperty(exports, "getRegisteredProviders", {
24
- enumerable: true,
25
- get: function () { return chunkKL2IRBNK_cjs.getRegisteredProviders; }
26
- });
27
- Object.defineProperty(exports, "isProviderRegistered", {
28
- enumerable: true,
29
- get: function () { return chunkKL2IRBNK_cjs.isProviderRegistered; }
30
- });
31
- Object.defineProperty(exports, "isValidModelId", {
32
- enumerable: true,
33
- get: function () { return chunkKL2IRBNK_cjs.isValidModelId; }
34
- });
35
- Object.defineProperty(exports, "parseModelString", {
36
- enumerable: true,
37
- get: function () { return chunkKL2IRBNK_cjs.parseModelString; }
38
- });
39
- //# sourceMappingURL=provider-registry-65CPGTUU.cjs.map
40
- //# sourceMappingURL=provider-registry-65CPGTUU.cjs.map
@@ -1,3 +0,0 @@
1
- export { GatewayRegistry, PROVIDER_MODELS, PROVIDER_REGISTRY, getProviderConfig, getRegisteredProviders, isProviderRegistered, isValidModelId, parseModelString } from './chunk-TKKBZUWD.js';
2
- //# sourceMappingURL=provider-registry-EQAT7FXK.js.map
3
- //# sourceMappingURL=provider-registry-EQAT7FXK.js.map