@decaf-ts/as-graph 0.6.0 → 0.7.0

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 (919) hide show
  1. package/README.md +776 -26
  2. package/assets/i18n/en.json +2527 -32
  3. package/dist/as-graph.cjs +1 -1
  4. package/dist/as-graph.cjs.map +1 -1
  5. package/dist/as-graph.js +1 -1
  6. package/dist/as-graph.js.map +1 -1
  7. package/lib/cjs/engine/auth/GraphAuthValidator.cjs +19 -0
  8. package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
  9. package/lib/cjs/engine/constants.cjs +61 -1
  10. package/lib/cjs/engine/constants.cjs.map +1 -1
  11. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
  12. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
  13. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +228 -67
  14. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  15. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
  16. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
  17. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
  18. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
  19. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +53 -1
  20. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
  21. package/lib/cjs/engine/execution/index.cjs +1 -0
  22. package/lib/cjs/engine/execution/index.cjs.map +1 -1
  23. package/lib/cjs/engine/index.cjs +4 -0
  24. package/lib/cjs/engine/index.cjs.map +1 -1
  25. package/lib/cjs/engine/store/GraphDataTableModel.cjs +76 -0
  26. package/lib/cjs/engine/store/GraphDataTableModel.cjs.map +1 -0
  27. package/lib/cjs/engine/store/GraphDataTableRepository.cjs +324 -0
  28. package/lib/cjs/engine/store/GraphDataTableRepository.cjs.map +1 -0
  29. package/lib/cjs/engine/store/index.cjs +2 -0
  30. package/lib/cjs/engine/store/index.cjs.map +1 -1
  31. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs +28 -0
  32. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs.map +1 -1
  33. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs +4 -2
  34. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs.map +1 -1
  35. package/lib/cjs/engine/validation/GraphParameterValidator.cjs +6 -0
  36. package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
  37. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
  38. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
  39. package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
  40. package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
  41. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
  42. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
  43. package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
  44. package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
  45. package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
  46. package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
  47. package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
  48. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
  49. package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
  50. package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
  51. package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
  52. package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
  53. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +240 -22
  54. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -1
  55. package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
  56. package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
  57. package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
  58. package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
  59. package/lib/cjs/mastra/MastraEventBridge.cjs +21 -1
  60. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
  61. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +414 -19
  62. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
  63. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
  64. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
  65. package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
  66. package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
  67. package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
  68. package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
  69. package/lib/cjs/mastra/MastraMemory.cjs +467 -0
  70. package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
  71. package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
  72. package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
  73. package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
  74. package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
  75. package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
  76. package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
  77. package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
  78. package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
  79. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
  80. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
  81. package/lib/cjs/mastra/MastraObservability.cjs +335 -0
  82. package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
  83. package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
  84. package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
  85. package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
  86. package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
  87. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
  88. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
  89. package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
  90. package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
  91. package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
  92. package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
  93. package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
  94. package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
  95. package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
  96. package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
  97. package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
  98. package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
  99. package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
  100. package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
  101. package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
  102. package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
  103. package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
  104. package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
  105. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
  106. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
  107. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +38 -6
  108. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  109. package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
  110. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
  111. package/lib/cjs/mastra/index.cjs +40 -1
  112. package/lib/cjs/mastra/index.cjs.map +1 -1
  113. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
  114. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
  115. package/lib/cjs/mastra/nodes/index.cjs +29 -0
  116. package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
  117. package/lib/cjs/mastra/nodes/types.cjs +4 -0
  118. package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
  119. package/lib/cjs/mastra/types.cjs +126 -1
  120. package/lib/cjs/mastra/types.cjs.map +1 -1
  121. package/lib/cjs/nest/graph/GraphBackendHost.cjs +12 -4
  122. package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
  123. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +35 -1
  124. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  125. package/lib/cjs/nest/graph/GraphRunController.cjs +47 -6
  126. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  127. package/lib/cjs/nest/graph/main.cjs +83 -1
  128. package/lib/cjs/nest/graph/main.cjs.map +1 -1
  129. package/lib/cjs/node/agents/agent/node.cjs +189 -31
  130. package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
  131. package/lib/cjs/node/agents/hitl/node.cjs +115 -0
  132. package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
  133. package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
  134. package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
  135. package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
  136. package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
  137. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
  138. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
  139. package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
  140. package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
  141. package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
  142. package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
  143. package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
  144. package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
  145. package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
  146. package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
  147. package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
  148. package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
  149. package/lib/cjs/node/agents/processors/types.cjs +68 -0
  150. package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
  151. package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
  152. package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
  153. package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
  154. package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
  155. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
  156. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
  157. package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
  158. package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
  159. package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
  160. package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
  161. package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
  162. package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
  163. package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
  164. package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
  165. package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
  166. package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
  167. package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
  168. package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
  169. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
  170. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
  171. package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
  172. package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
  173. package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
  174. package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
  175. package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
  176. package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
  177. package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
  178. package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
  179. package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
  180. package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
  181. package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
  182. package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
  183. package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
  184. package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
  185. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
  186. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
  187. package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
  188. package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
  189. package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
  190. package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
  191. package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
  192. package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
  193. package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
  194. package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
  195. package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
  196. package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
  197. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
  198. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
  199. package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
  200. package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
  201. package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
  202. package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
  203. package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
  204. package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
  205. package/lib/cjs/node/agents/voice/node.cjs +107 -0
  206. package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
  207. package/lib/cjs/node/agents/zones.cjs +43 -0
  208. package/lib/cjs/node/agents/zones.cjs.map +1 -0
  209. package/lib/cjs/node/comms/email-send/node.cjs +340 -0
  210. package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
  211. package/lib/cjs/node/comms/gmail/node.cjs +287 -0
  212. package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
  213. package/lib/cjs/node/comms/slack/node.cjs +276 -0
  214. package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
  215. package/lib/cjs/node/comms/teams/node.cjs +231 -0
  216. package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
  217. package/lib/cjs/node/comms/telegram/node.cjs +260 -0
  218. package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
  219. package/lib/cjs/node/credentials.cjs +103 -0
  220. package/lib/cjs/node/credentials.cjs.map +1 -0
  221. package/lib/cjs/node/data/data-table/node.cjs +265 -0
  222. package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
  223. package/lib/cjs/node/data/date-time/node.cjs +180 -0
  224. package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
  225. package/lib/cjs/node/data/filter/node.cjs +134 -0
  226. package/lib/cjs/node/data/filter/node.cjs.map +1 -0
  227. package/lib/cjs/node/data/limit/node.cjs +104 -0
  228. package/lib/cjs/node/data/limit/node.cjs.map +1 -0
  229. package/lib/cjs/node/data/merge/node.cjs +251 -0
  230. package/lib/cjs/node/data/merge/node.cjs.map +1 -0
  231. package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
  232. package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
  233. package/lib/cjs/node/data/set/node.cjs +148 -0
  234. package/lib/cjs/node/data/set/node.cjs.map +1 -0
  235. package/lib/cjs/node/data/sort/node.cjs +125 -0
  236. package/lib/cjs/node/data/sort/node.cjs.map +1 -0
  237. package/lib/cjs/node/data/split-out/node.cjs +140 -0
  238. package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
  239. package/lib/cjs/node/data/support.cjs +398 -0
  240. package/lib/cjs/node/data/support.cjs.map +1 -0
  241. package/lib/cjs/node/devops/crypto/node.cjs +364 -0
  242. package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
  243. package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
  244. package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
  245. package/lib/cjs/node/devops/ftp/node.cjs +241 -0
  246. package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
  247. package/lib/cjs/node/devops/github/node.cjs +282 -0
  248. package/lib/cjs/node/devops/github/node.cjs.map +1 -0
  249. package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
  250. package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
  251. package/lib/cjs/node/devops/jwt/node.cjs +204 -0
  252. package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
  253. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
  254. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
  255. package/lib/cjs/node/index.cjs +402 -66
  256. package/lib/cjs/node/index.cjs.map +1 -1
  257. package/lib/cjs/node/io/airtable/node.cjs +318 -0
  258. package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
  259. package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
  260. package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
  261. package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
  262. package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
  263. package/lib/cjs/node/io/graphql/node.cjs +169 -0
  264. package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
  265. package/lib/cjs/node/io/http-request/node.cjs +415 -0
  266. package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
  267. package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
  268. package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
  269. package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
  270. package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
  271. package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
  272. package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
  273. package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
  274. package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
  275. package/lib/cjs/node/manifests.cjs +264 -36
  276. package/lib/cjs/node/manifests.cjs.map +1 -1
  277. package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
  278. package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
  279. package/lib/cjs/node/storage/blob/base.cjs +321 -0
  280. package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
  281. package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
  282. package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
  283. package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
  284. package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
  285. package/lib/cjs/node/storage/database/base.cjs +301 -0
  286. package/lib/cjs/node/storage/database/base.cjs.map +1 -0
  287. package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
  288. package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
  289. package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
  290. package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
  291. package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
  292. package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
  293. package/lib/cjs/node/storage/redis/node.cjs +340 -0
  294. package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
  295. package/lib/cjs/node/storage/support.cjs +81 -0
  296. package/lib/cjs/node/storage/support.cjs.map +1 -0
  297. package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
  298. package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
  299. package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
  300. package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
  301. package/lib/cjs/shared/graph/GraphNodeModel.cjs +4 -0
  302. package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -1
  303. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
  304. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
  305. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
  306. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  307. package/lib/cjs/shared/graph/category-styles.cjs +12 -0
  308. package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
  309. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
  310. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
  311. package/lib/cjs/typeorm/index.cjs +29 -0
  312. package/lib/cjs/typeorm/index.cjs.map +1 -0
  313. package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
  314. package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
  315. package/lib/esm/engine/constants.js +60 -0
  316. package/lib/esm/engine/constants.js.map +1 -1
  317. package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
  318. package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
  319. package/lib/esm/engine/execution/GraphExecutionEngine.js +229 -68
  320. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  321. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
  322. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
  323. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
  324. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
  325. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +54 -2
  326. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
  327. package/lib/esm/engine/execution/index.js +1 -0
  328. package/lib/esm/engine/execution/index.js.map +1 -1
  329. package/lib/esm/engine/index.js +4 -0
  330. package/lib/esm/engine/index.js.map +1 -1
  331. package/lib/esm/engine/store/GraphDataTableModel.js +67 -0
  332. package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
  333. package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
  334. package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
  335. package/lib/esm/engine/store/index.js +2 -0
  336. package/lib/esm/engine/store/index.js.map +1 -1
  337. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
  338. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
  339. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
  340. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
  341. package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
  342. package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
  343. package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
  344. package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
  345. package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
  346. package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
  347. package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
  348. package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
  349. package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
  350. package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
  351. package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
  352. package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
  353. package/lib/esm/mastra/MastraCapabilities.js +115 -0
  354. package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
  355. package/lib/esm/mastra/MastraChannelResponse.js +154 -0
  356. package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
  357. package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
  358. package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
  359. package/lib/esm/mastra/MastraDefaultStepHandlers.js +240 -22
  360. package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -1
  361. package/lib/esm/mastra/MastraEnvironment.js +287 -0
  362. package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
  363. package/lib/esm/mastra/MastraEvalModels.js +535 -0
  364. package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
  365. package/lib/esm/mastra/MastraEventBridge.js +21 -1
  366. package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
  367. package/lib/esm/mastra/MastraGraphExecutionBackend.js +414 -19
  368. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
  369. package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
  370. package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
  371. package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
  372. package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
  373. package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
  374. package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
  375. package/lib/esm/mastra/MastraMemory.js +455 -0
  376. package/lib/esm/mastra/MastraMemory.js.map +1 -0
  377. package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
  378. package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
  379. package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
  380. package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
  381. package/lib/esm/mastra/MastraMetricsModels.js +486 -0
  382. package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
  383. package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
  384. package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
  385. package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
  386. package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
  387. package/lib/esm/mastra/MastraObservability.js +327 -0
  388. package/lib/esm/mastra/MastraObservability.js.map +1 -0
  389. package/lib/esm/mastra/MastraPersistence.js +530 -0
  390. package/lib/esm/mastra/MastraPersistence.js.map +1 -0
  391. package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
  392. package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
  393. package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
  394. package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
  395. package/lib/esm/mastra/MastraRunRecovery.js +89 -0
  396. package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
  397. package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
  398. package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
  399. package/lib/esm/mastra/MastraStorageWiring.js +119 -0
  400. package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
  401. package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
  402. package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
  403. package/lib/esm/mastra/MastraToolBuilder.js +68 -0
  404. package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
  405. package/lib/esm/mastra/MastraToolConfig.js +37 -0
  406. package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
  407. package/lib/esm/mastra/MastraToolDecorator.js +92 -0
  408. package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
  409. package/lib/esm/mastra/MastraVectorStore.js +605 -0
  410. package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
  411. package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
  412. package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
  413. package/lib/esm/mastra/MastraWorkflowCompiler.js +38 -6
  414. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  415. package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
  416. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
  417. package/lib/esm/mastra/index.js +40 -1
  418. package/lib/esm/mastra/index.js.map +1 -1
  419. package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
  420. package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
  421. package/lib/esm/mastra/nodes/index.js +12 -0
  422. package/lib/esm/mastra/nodes/index.js.map +1 -0
  423. package/lib/esm/mastra/nodes/types.js +2 -0
  424. package/lib/esm/mastra/nodes/types.js.map +1 -0
  425. package/lib/esm/mastra/types.js +125 -0
  426. package/lib/esm/mastra/types.js.map +1 -1
  427. package/lib/esm/nest/graph/GraphBackendHost.js +10 -2
  428. package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
  429. package/lib/esm/nest/graph/GraphExecutionModule.js +35 -1
  430. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  431. package/lib/esm/nest/graph/GraphRunController.js +47 -6
  432. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  433. package/lib/esm/nest/graph/main.js +83 -1
  434. package/lib/esm/nest/graph/main.js.map +1 -1
  435. package/lib/esm/node/agents/agent/node.js +189 -31
  436. package/lib/esm/node/agents/agent/node.js.map +1 -1
  437. package/lib/esm/node/agents/hitl/node.js +106 -0
  438. package/lib/esm/node/agents/hitl/node.js.map +1 -0
  439. package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
  440. package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
  441. package/lib/esm/node/agents/hooks/hook/node.js +111 -0
  442. package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
  443. package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
  444. package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
  445. package/lib/esm/node/agents/memory/memory/node.js +222 -0
  446. package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
  447. package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
  448. package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
  449. package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
  450. package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
  451. package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
  452. package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
  453. package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
  454. package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
  455. package/lib/esm/node/agents/processors/types.js +64 -0
  456. package/lib/esm/node/agents/processors/types.js.map +1 -0
  457. package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
  458. package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
  459. package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
  460. package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
  461. package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
  462. package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
  463. package/lib/esm/node/agents/rag/chunking/node.js +211 -0
  464. package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
  465. package/lib/esm/node/agents/rag/embedding/node.js +101 -0
  466. package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
  467. package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
  468. package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
  469. package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
  470. package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
  471. package/lib/esm/node/agents/rag/rerank/node.js +103 -0
  472. package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
  473. package/lib/esm/node/agents/rag/retriever/node.js +111 -0
  474. package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
  475. package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
  476. package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
  477. package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
  478. package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
  479. package/lib/esm/node/agents/responses/discord/node.js +92 -0
  480. package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
  481. package/lib/esm/node/agents/responses/slack/node.js +92 -0
  482. package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
  483. package/lib/esm/node/agents/responses/teams/node.js +92 -0
  484. package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
  485. package/lib/esm/node/agents/responses/telegram/node.js +92 -0
  486. package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
  487. package/lib/esm/node/agents/sandbox/node.js +125 -0
  488. package/lib/esm/node/agents/sandbox/node.js.map +1 -0
  489. package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
  490. package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
  491. package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
  492. package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
  493. package/lib/esm/node/agents/skills/skill/node.js +96 -0
  494. package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
  495. package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
  496. package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
  497. package/lib/esm/node/agents/tools/tool/node.js +91 -0
  498. package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
  499. package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
  500. package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
  501. package/lib/esm/node/agents/triggers/discord/node.js +92 -0
  502. package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
  503. package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
  504. package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
  505. package/lib/esm/node/agents/triggers/slack/node.js +92 -0
  506. package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
  507. package/lib/esm/node/agents/triggers/teams/node.js +92 -0
  508. package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
  509. package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
  510. package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
  511. package/lib/esm/node/agents/voice/node.js +98 -0
  512. package/lib/esm/node/agents/voice/node.js.map +1 -0
  513. package/lib/esm/node/agents/zones.js +39 -0
  514. package/lib/esm/node/agents/zones.js.map +1 -0
  515. package/lib/esm/node/comms/email-send/node.js +331 -0
  516. package/lib/esm/node/comms/email-send/node.js.map +1 -0
  517. package/lib/esm/node/comms/gmail/node.js +278 -0
  518. package/lib/esm/node/comms/gmail/node.js.map +1 -0
  519. package/lib/esm/node/comms/slack/node.js +267 -0
  520. package/lib/esm/node/comms/slack/node.js.map +1 -0
  521. package/lib/esm/node/comms/teams/node.js +222 -0
  522. package/lib/esm/node/comms/teams/node.js.map +1 -0
  523. package/lib/esm/node/comms/telegram/node.js +251 -0
  524. package/lib/esm/node/comms/telegram/node.js.map +1 -0
  525. package/lib/esm/node/credentials.js +96 -0
  526. package/lib/esm/node/credentials.js.map +1 -0
  527. package/lib/esm/node/data/data-table/node.js +256 -0
  528. package/lib/esm/node/data/data-table/node.js.map +1 -0
  529. package/lib/esm/node/data/date-time/node.js +171 -0
  530. package/lib/esm/node/data/date-time/node.js.map +1 -0
  531. package/lib/esm/node/data/filter/node.js +125 -0
  532. package/lib/esm/node/data/filter/node.js.map +1 -0
  533. package/lib/esm/node/data/limit/node.js +95 -0
  534. package/lib/esm/node/data/limit/node.js.map +1 -0
  535. package/lib/esm/node/data/merge/node.js +242 -0
  536. package/lib/esm/node/data/merge/node.js.map +1 -0
  537. package/lib/esm/node/data/rename-keys/node.js +130 -0
  538. package/lib/esm/node/data/rename-keys/node.js.map +1 -0
  539. package/lib/esm/node/data/set/node.js +139 -0
  540. package/lib/esm/node/data/set/node.js.map +1 -0
  541. package/lib/esm/node/data/sort/node.js +116 -0
  542. package/lib/esm/node/data/sort/node.js.map +1 -0
  543. package/lib/esm/node/data/split-out/node.js +131 -0
  544. package/lib/esm/node/data/split-out/node.js.map +1 -0
  545. package/lib/esm/node/data/support.js +382 -0
  546. package/lib/esm/node/data/support.js.map +1 -0
  547. package/lib/esm/node/devops/crypto/node.js +355 -0
  548. package/lib/esm/node/devops/crypto/node.js.map +1 -0
  549. package/lib/esm/node/devops/execute-command/node.js +192 -0
  550. package/lib/esm/node/devops/execute-command/node.js.map +1 -0
  551. package/lib/esm/node/devops/ftp/node.js +232 -0
  552. package/lib/esm/node/devops/ftp/node.js.map +1 -0
  553. package/lib/esm/node/devops/github/node.js +273 -0
  554. package/lib/esm/node/devops/github/node.js.map +1 -0
  555. package/lib/esm/node/devops/gitlab/node.js +264 -0
  556. package/lib/esm/node/devops/gitlab/node.js.map +1 -0
  557. package/lib/esm/node/devops/jwt/node.js +195 -0
  558. package/lib/esm/node/devops/jwt/node.js.map +1 -0
  559. package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
  560. package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
  561. package/lib/esm/node/index.js +338 -2
  562. package/lib/esm/node/index.js.map +1 -1
  563. package/lib/esm/node/io/airtable/node.js +309 -0
  564. package/lib/esm/node/io/airtable/node.js.map +1 -0
  565. package/lib/esm/node/io/extract-from-file/node.js +260 -0
  566. package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
  567. package/lib/esm/node/io/google-sheets/node.js +258 -0
  568. package/lib/esm/node/io/google-sheets/node.js.map +1 -0
  569. package/lib/esm/node/io/graphql/node.js +160 -0
  570. package/lib/esm/node/io/graphql/node.js.map +1 -0
  571. package/lib/esm/node/io/http-request/node.js +406 -0
  572. package/lib/esm/node/io/http-request/node.js.map +1 -0
  573. package/lib/esm/node/io/read-pdf/node.js +164 -0
  574. package/lib/esm/node/io/read-pdf/node.js.map +1 -0
  575. package/lib/esm/node/io/read-write-file/node.js +305 -0
  576. package/lib/esm/node/io/read-write-file/node.js.map +1 -0
  577. package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
  578. package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
  579. package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
  580. package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
  581. package/lib/esm/node/manifests.js +228 -0
  582. package/lib/esm/node/manifests.js.map +1 -1
  583. package/lib/esm/node/storage/blob/azure/node.js +129 -0
  584. package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
  585. package/lib/esm/node/storage/blob/base.js +311 -0
  586. package/lib/esm/node/storage/blob/base.js.map +1 -0
  587. package/lib/esm/node/storage/blob/gcs/node.js +117 -0
  588. package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
  589. package/lib/esm/node/storage/blob/s3/node.js +176 -0
  590. package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
  591. package/lib/esm/node/storage/database/base.js +291 -0
  592. package/lib/esm/node/storage/database/base.js.map +1 -0
  593. package/lib/esm/node/storage/database/mssql/node.js +42 -0
  594. package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
  595. package/lib/esm/node/storage/database/mysql/node.js +42 -0
  596. package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
  597. package/lib/esm/node/storage/database/postgres/node.js +42 -0
  598. package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
  599. package/lib/esm/node/storage/redis/node.js +331 -0
  600. package/lib/esm/node/storage/redis/node.js.map +1 -0
  601. package/lib/esm/node/storage/support.js +69 -0
  602. package/lib/esm/node/storage/support.js.map +1 -0
  603. package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
  604. package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
  605. package/lib/esm/ram/GraphRunEventModel.js +5 -1
  606. package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
  607. package/lib/esm/shared/graph/GraphNodeModel.js +5 -1
  608. package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -1
  609. package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
  610. package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
  611. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
  612. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  613. package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
  614. package/lib/esm/shared/graph/category-styles.js +12 -0
  615. package/lib/esm/shared/graph/category-styles.js.map +1 -1
  616. package/lib/esm/shared/graph/constants.js.map +1 -1
  617. package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
  618. package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
  619. package/lib/esm/typeorm/index.js +12 -0
  620. package/lib/esm/typeorm/index.js.map +1 -0
  621. package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
  622. package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
  623. package/lib/types/engine/constants.d.cts +60 -0
  624. package/lib/types/engine/constants.d.mts +60 -0
  625. package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
  626. package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
  627. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +88 -1
  628. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +88 -1
  629. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
  630. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
  631. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
  632. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
  633. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +12 -3
  634. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +12 -3
  635. package/lib/types/engine/execution/index.d.cts +1 -0
  636. package/lib/types/engine/execution/index.d.mts +1 -0
  637. package/lib/types/engine/index.d.cts +4 -0
  638. package/lib/types/engine/index.d.mts +4 -0
  639. package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
  640. package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
  641. package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
  642. package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
  643. package/lib/types/engine/store/index.d.cts +2 -0
  644. package/lib/types/engine/store/index.d.mts +2 -0
  645. package/lib/types/engine/types.d.cts +12 -0
  646. package/lib/types/engine/types.d.mts +12 -0
  647. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
  648. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
  649. package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
  650. package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
  651. package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
  652. package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
  653. package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
  654. package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
  655. package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
  656. package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
  657. package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
  658. package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
  659. package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
  660. package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
  661. package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
  662. package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
  663. package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
  664. package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
  665. package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
  666. package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
  667. package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +53 -6
  668. package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +53 -6
  669. package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
  670. package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
  671. package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
  672. package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
  673. package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
  674. package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
  675. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +108 -1
  676. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +108 -1
  677. package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
  678. package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
  679. package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
  680. package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
  681. package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
  682. package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
  683. package/lib/types/mastra/MastraMemory.d.cts +362 -0
  684. package/lib/types/mastra/MastraMemory.d.mts +362 -0
  685. package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
  686. package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
  687. package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
  688. package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
  689. package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
  690. package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
  691. package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
  692. package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
  693. package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
  694. package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
  695. package/lib/types/mastra/MastraObservability.d.cts +197 -0
  696. package/lib/types/mastra/MastraObservability.d.mts +197 -0
  697. package/lib/types/mastra/MastraPersistence.d.cts +241 -0
  698. package/lib/types/mastra/MastraPersistence.d.mts +241 -0
  699. package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
  700. package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
  701. package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
  702. package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
  703. package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
  704. package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
  705. package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
  706. package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
  707. package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
  708. package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
  709. package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
  710. package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
  711. package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
  712. package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
  713. package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
  714. package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
  715. package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
  716. package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
  717. package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
  718. package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
  719. package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
  720. package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
  721. package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
  722. package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
  723. package/lib/types/mastra/index.d.cts +40 -1
  724. package/lib/types/mastra/index.d.mts +40 -1
  725. package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
  726. package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
  727. package/lib/types/mastra/nodes/index.d.cts +11 -0
  728. package/lib/types/mastra/nodes/index.d.mts +11 -0
  729. package/lib/types/mastra/nodes/types.d.cts +57 -0
  730. package/lib/types/mastra/nodes/types.d.mts +57 -0
  731. package/lib/types/mastra/types.d.cts +365 -6
  732. package/lib/types/mastra/types.d.mts +365 -6
  733. package/lib/types/nest/graph/GraphExecutionModule.d.cts +17 -0
  734. package/lib/types/nest/graph/GraphExecutionModule.d.mts +17 -0
  735. package/lib/types/nest/graph/GraphRunController.d.cts +24 -4
  736. package/lib/types/nest/graph/GraphRunController.d.mts +24 -4
  737. package/lib/types/node/agents/agent/node.d.cts +72 -16
  738. package/lib/types/node/agents/agent/node.d.mts +72 -16
  739. package/lib/types/node/agents/hitl/node.d.cts +45 -0
  740. package/lib/types/node/agents/hitl/node.d.mts +45 -0
  741. package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
  742. package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
  743. package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
  744. package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
  745. package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
  746. package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
  747. package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
  748. package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
  749. package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
  750. package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
  751. package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
  752. package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
  753. package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
  754. package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
  755. package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
  756. package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
  757. package/lib/types/node/agents/processors/types.d.cts +45 -0
  758. package/lib/types/node/agents/processors/types.d.mts +45 -0
  759. package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
  760. package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
  761. package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
  762. package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
  763. package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
  764. package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
  765. package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
  766. package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
  767. package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
  768. package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
  769. package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
  770. package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
  771. package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
  772. package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
  773. package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
  774. package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
  775. package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
  776. package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
  777. package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
  778. package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
  779. package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
  780. package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
  781. package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
  782. package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
  783. package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
  784. package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
  785. package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
  786. package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
  787. package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
  788. package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
  789. package/lib/types/node/agents/sandbox/node.d.cts +47 -0
  790. package/lib/types/node/agents/sandbox/node.d.mts +47 -0
  791. package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
  792. package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
  793. package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
  794. package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
  795. package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
  796. package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
  797. package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
  798. package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
  799. package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
  800. package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
  801. package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
  802. package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
  803. package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
  804. package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
  805. package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
  806. package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
  807. package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
  808. package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
  809. package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
  810. package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
  811. package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
  812. package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
  813. package/lib/types/node/agents/voice/node.d.cts +34 -0
  814. package/lib/types/node/agents/voice/node.d.mts +34 -0
  815. package/lib/types/node/agents/zones.d.cts +30 -0
  816. package/lib/types/node/agents/zones.d.mts +30 -0
  817. package/lib/types/node/comms/email-send/node.d.cts +85 -0
  818. package/lib/types/node/comms/email-send/node.d.mts +85 -0
  819. package/lib/types/node/comms/gmail/node.d.cts +67 -0
  820. package/lib/types/node/comms/gmail/node.d.mts +67 -0
  821. package/lib/types/node/comms/slack/node.d.cts +65 -0
  822. package/lib/types/node/comms/slack/node.d.mts +65 -0
  823. package/lib/types/node/comms/teams/node.d.cts +49 -0
  824. package/lib/types/node/comms/teams/node.d.mts +49 -0
  825. package/lib/types/node/comms/telegram/node.d.cts +61 -0
  826. package/lib/types/node/comms/telegram/node.d.mts +61 -0
  827. package/lib/types/node/credentials.d.cts +43 -0
  828. package/lib/types/node/credentials.d.mts +43 -0
  829. package/lib/types/node/data/data-table/node.d.cts +86 -0
  830. package/lib/types/node/data/data-table/node.d.mts +86 -0
  831. package/lib/types/node/data/date-time/node.d.cts +49 -0
  832. package/lib/types/node/data/date-time/node.d.mts +49 -0
  833. package/lib/types/node/data/filter/node.d.cts +31 -0
  834. package/lib/types/node/data/filter/node.d.mts +31 -0
  835. package/lib/types/node/data/limit/node.d.cts +28 -0
  836. package/lib/types/node/data/limit/node.d.mts +28 -0
  837. package/lib/types/node/data/merge/node.d.cts +63 -0
  838. package/lib/types/node/data/merge/node.d.mts +63 -0
  839. package/lib/types/node/data/rename-keys/node.d.cts +35 -0
  840. package/lib/types/node/data/rename-keys/node.d.mts +35 -0
  841. package/lib/types/node/data/set/node.d.cts +52 -0
  842. package/lib/types/node/data/set/node.d.mts +52 -0
  843. package/lib/types/node/data/sort/node.d.cts +40 -0
  844. package/lib/types/node/data/sort/node.d.mts +40 -0
  845. package/lib/types/node/data/split-out/node.d.cts +30 -0
  846. package/lib/types/node/data/split-out/node.d.mts +30 -0
  847. package/lib/types/node/data/support.d.cts +164 -0
  848. package/lib/types/node/data/support.d.mts +164 -0
  849. package/lib/types/node/devops/crypto/node.d.cts +65 -0
  850. package/lib/types/node/devops/crypto/node.d.mts +65 -0
  851. package/lib/types/node/devops/execute-command/node.d.cts +55 -0
  852. package/lib/types/node/devops/execute-command/node.d.mts +55 -0
  853. package/lib/types/node/devops/ftp/node.d.cts +55 -0
  854. package/lib/types/node/devops/ftp/node.d.mts +55 -0
  855. package/lib/types/node/devops/github/node.d.cts +61 -0
  856. package/lib/types/node/devops/github/node.d.mts +61 -0
  857. package/lib/types/node/devops/gitlab/node.d.cts +61 -0
  858. package/lib/types/node/devops/gitlab/node.d.mts +61 -0
  859. package/lib/types/node/devops/jwt/node.d.cts +53 -0
  860. package/lib/types/node/devops/jwt/node.d.mts +53 -0
  861. package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
  862. package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
  863. package/lib/types/node/index.d.cts +182 -2
  864. package/lib/types/node/index.d.mts +182 -2
  865. package/lib/types/node/io/airtable/node.d.cts +73 -0
  866. package/lib/types/node/io/airtable/node.d.mts +73 -0
  867. package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
  868. package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
  869. package/lib/types/node/io/google-sheets/node.d.cts +77 -0
  870. package/lib/types/node/io/google-sheets/node.d.mts +77 -0
  871. package/lib/types/node/io/graphql/node.d.cts +46 -0
  872. package/lib/types/node/io/graphql/node.d.mts +46 -0
  873. package/lib/types/node/io/http-request/node.d.cts +107 -0
  874. package/lib/types/node/io/http-request/node.d.mts +107 -0
  875. package/lib/types/node/io/read-pdf/node.d.cts +40 -0
  876. package/lib/types/node/io/read-pdf/node.d.mts +40 -0
  877. package/lib/types/node/io/read-write-file/node.d.cts +41 -0
  878. package/lib/types/node/io/read-write-file/node.d.mts +41 -0
  879. package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
  880. package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
  881. package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
  882. package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
  883. package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
  884. package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
  885. package/lib/types/node/storage/blob/base.d.cts +83 -0
  886. package/lib/types/node/storage/blob/base.d.mts +83 -0
  887. package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
  888. package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
  889. package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
  890. package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
  891. package/lib/types/node/storage/database/base.d.cts +97 -0
  892. package/lib/types/node/storage/database/base.d.mts +97 -0
  893. package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
  894. package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
  895. package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
  896. package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
  897. package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
  898. package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
  899. package/lib/types/node/storage/redis/node.d.cts +68 -0
  900. package/lib/types/node/storage/redis/node.d.mts +68 -0
  901. package/lib/types/node/storage/support.d.cts +36 -0
  902. package/lib/types/node/storage/support.d.mts +36 -0
  903. package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
  904. package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
  905. package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
  906. package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
  907. package/lib/types/shared/graph/GraphNodeModel.d.cts +6 -0
  908. package/lib/types/shared/graph/GraphNodeModel.d.mts +6 -0
  909. package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
  910. package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
  911. package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
  912. package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
  913. package/lib/types/shared/graph/constants.d.cts +39 -0
  914. package/lib/types/shared/graph/constants.d.mts +39 -0
  915. package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
  916. package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
  917. package/lib/types/typeorm/index.d.cts +11 -0
  918. package/lib/types/typeorm/index.d.mts +11 -0
  919. package/package.json +51 -11
@@ -0,0 +1,294 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import { GraphExecutionError } from "./../engine/errors/GraphExecutionError.js";
3
+ import { GRAPH_MASTRA_VECTOR_UNAVAILABLE } from "./types.js";
4
+ import { mastraVectorMatchesFilter, mastraVectorScore, } from "./MastraVectorStore.js";
5
+ const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
6
+ /**
7
+ * Validates a SQL identifier supplied through config, refusing anything that
8
+ * could escape the quoted identifier.
9
+ *
10
+ * @param value - The identifier to validate.
11
+ * @param label - The option name (error details).
12
+ * @returns The validated identifier.
13
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_VECTOR_UNAVAILABLE} when the
14
+ * identifier is empty or contains unsupported characters.
15
+ */
16
+ function identifierOf(value, label) {
17
+ if (value.length > 63 || !IDENTIFIER.test(value)) {
18
+ throw new GraphExecutionError(`The Apache AGE vector store ${label} '${value}' is not a valid SQL identifier (letters, digits, and underscores; at most 63 characters)`, GRAPH_MASTRA_VECTOR_UNAVAILABLE, { option: label, value });
19
+ }
20
+ return value;
21
+ }
22
+ /**
23
+ * Coerces a database vector representation into a number array. PostgreSQL
24
+ * drivers differ on whether `double precision[]` arrives as an array or as the
25
+ * text form `{1,2,3}`.
26
+ *
27
+ * @param value - The raw column value.
28
+ * @returns The parsed vector.
29
+ * @throws {GraphExecutionError} when the value is not a numeric array.
30
+ */
31
+ function vectorOf(value) {
32
+ if (Array.isArray(value)) {
33
+ const vector = value.map((entry) => Number(entry));
34
+ if (vector.every((entry) => Number.isFinite(entry)))
35
+ return vector;
36
+ }
37
+ if (typeof value === "string") {
38
+ const text = value.trim().replace(/^\{/, "").replace(/\}$/, "");
39
+ if (text.length === 0)
40
+ return [];
41
+ const vector = text.split(",").map((entry) => Number(entry.trim()));
42
+ if (vector.every((entry) => Number.isFinite(entry)))
43
+ return vector;
44
+ }
45
+ throw new GraphExecutionError("The Apache AGE vector store read a vector column that is not a numeric array", GRAPH_MASTRA_VECTOR_UNAVAILABLE);
46
+ }
47
+ /**
48
+ * Coerces a database metadata representation into a plain object.
49
+ *
50
+ * @param value - The raw `jsonb` column value.
51
+ * @returns The metadata, or `undefined` when unset.
52
+ * @throws {GraphExecutionError} when the value is neither an object nor valid
53
+ * JSON object text.
54
+ */
55
+ function metadataOf(value) {
56
+ if (value === null || value === undefined)
57
+ return undefined;
58
+ if (typeof value === "object" && !Array.isArray(value)) {
59
+ return value;
60
+ }
61
+ if (typeof value === "string" && value.length > 0) {
62
+ try {
63
+ const parsed = JSON.parse(value);
64
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
65
+ return parsed;
66
+ }
67
+ }
68
+ catch (error) {
69
+ throw new GraphExecutionError(`The Apache AGE vector store read unparseable metadata JSON: ${String(error)}`, GRAPH_MASTRA_VECTOR_UNAVAILABLE);
70
+ }
71
+ }
72
+ throw new GraphExecutionError("The Apache AGE vector store read a metadata column that is not a JSON object", GRAPH_MASTRA_VECTOR_UNAVAILABLE);
73
+ }
74
+ /** The metric a stored index declares, defaulting to cosine. */
75
+ function metricOf(value) {
76
+ return value === "euclidean" || value === "dotproduct" ? value : "cosine";
77
+ }
78
+ /**
79
+ * Creates the reference Apache AGE driver for the custom mastra `age` vector
80
+ * store.
81
+ *
82
+ * The returned driver implements mastra's {@link MastraVectorDriver} contract;
83
+ * wrap it with {@link DriverBackedVectorStore} (the `age` provider resolution
84
+ * does this automatically) or pass it as `vectorStoreDrivers.age`. It keeps
85
+ * vectors in the AGE graph schema and scores them in-process, so the AGE
86
+ * extension and its graph are the only database prerequisites.
87
+ *
88
+ * @param options - The SQL client and optional graph/table identifiers.
89
+ * @returns A driver over the AGE-enabled database.
90
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_VECTOR_UNAVAILABLE} when a
91
+ * configured identifier is invalid.
92
+ */
93
+ export function createMastraAgeVectorDriver(options) {
94
+ const graph = identifierOf(options.graphName ?? "as_graph_age_vectors", "graphName");
95
+ const prefix = identifierOf(options.tablePrefix ?? "vectors", "tablePrefix");
96
+ const client = options.client;
97
+ const schema = `"${graph}"`;
98
+ const indexesTable = `${schema}."${prefix}_indexes"`;
99
+ const vectorsTable = `${schema}."${prefix}_vectors"`;
100
+ let graphReady;
101
+ const ensureGraph = () => {
102
+ if (!graphReady) {
103
+ graphReady = (async () => {
104
+ const extension = await client.query("SELECT extname FROM pg_extension WHERE extname = 'age'");
105
+ if (extension.rows.length === 0) {
106
+ throw new GraphExecutionError("The Apache AGE vector store requires the 'age' extension on the target database", GRAPH_MASTRA_VECTOR_UNAVAILABLE, { graph });
107
+ }
108
+ const existing = await client.query("SELECT name FROM ag_catalog.ag_graph WHERE name = $1", [graph]);
109
+ if (existing.rows.length === 0) {
110
+ await client.query("SELECT ag_catalog.create_graph($1::name)", [graph]);
111
+ }
112
+ await client.query(`CREATE TABLE IF NOT EXISTS ${indexesTable} (
113
+ index_name text PRIMARY KEY,
114
+ dimension integer NOT NULL,
115
+ metric text NOT NULL
116
+ )`);
117
+ await client.query(`CREATE TABLE IF NOT EXISTS ${vectorsTable} (
118
+ index_name text NOT NULL REFERENCES ${indexesTable}(index_name) ON DELETE CASCADE,
119
+ id text NOT NULL,
120
+ vector double precision[] NOT NULL,
121
+ metadata jsonb,
122
+ PRIMARY KEY (index_name, id)
123
+ )`);
124
+ })().catch((error) => {
125
+ graphReady = undefined;
126
+ if (error instanceof GraphExecutionError)
127
+ throw error;
128
+ throw new GraphExecutionError(`The Apache AGE vector store could not initialize graph '${graph}': ${String(error)}`, GRAPH_MASTRA_VECTOR_UNAVAILABLE, { graph });
129
+ });
130
+ }
131
+ return graphReady;
132
+ };
133
+ const requireIndex = async (indexName) => {
134
+ const result = await client.query(`SELECT dimension, metric FROM ${indexesTable} WHERE index_name = $1`, [indexName]);
135
+ const row = result.rows[0];
136
+ if (!row) {
137
+ throw new GraphExecutionError(`Apache AGE vector index '${indexName}' does not exist in graph '${graph}'`, GRAPH_MASTRA_VECTOR_UNAVAILABLE, { graph, indexName });
138
+ }
139
+ const dimension = Number(row["dimension"]);
140
+ if (!Number.isFinite(dimension)) {
141
+ throw new GraphExecutionError(`Apache AGE vector index '${indexName}' has an invalid dimension`, GRAPH_MASTRA_VECTOR_UNAVAILABLE, { graph, indexName });
142
+ }
143
+ return { dimension, metric: metricOf(row["metric"]) };
144
+ };
145
+ const rowsOf = async (indexName) => {
146
+ const result = await client.query(`SELECT id, vector, metadata FROM ${vectorsTable} WHERE index_name = $1`, [indexName]);
147
+ return result.rows.map((row) => ({
148
+ id: String(row["id"]),
149
+ vector: vectorOf(row["vector"]),
150
+ metadata: metadataOf(row["metadata"]),
151
+ }));
152
+ };
153
+ return {
154
+ async createIndex(params) {
155
+ await ensureGraph();
156
+ await client.query(`INSERT INTO ${indexesTable} (index_name, dimension, metric)
157
+ VALUES ($1, $2, $3)
158
+ ON CONFLICT (index_name)
159
+ DO UPDATE SET dimension = EXCLUDED.dimension, metric = EXCLUDED.metric`, [
160
+ params.indexName,
161
+ params.dimension,
162
+ params.metric ?? "cosine",
163
+ ]);
164
+ },
165
+ async listIndexes() {
166
+ await ensureGraph();
167
+ const result = await client.query(`SELECT index_name FROM ${indexesTable} ORDER BY index_name`);
168
+ return result.rows.map((row) => String(row["index_name"]));
169
+ },
170
+ async describeIndex(params) {
171
+ await ensureGraph();
172
+ const index = await requireIndex(params.indexName);
173
+ const count = await client.query(`SELECT COUNT(*)::integer AS count FROM ${vectorsTable} WHERE index_name = $1`, [params.indexName]);
174
+ return {
175
+ dimension: index.dimension,
176
+ count: Number(count.rows[0]?.["count"] ?? 0),
177
+ metric: index.metric,
178
+ };
179
+ },
180
+ async deleteIndex(params) {
181
+ await ensureGraph();
182
+ await client.query(`DELETE FROM ${indexesTable} WHERE index_name = $1`, [params.indexName]);
183
+ },
184
+ async upsert(params) {
185
+ await ensureGraph();
186
+ await requireIndex(params.indexName);
187
+ if (params.deleteFilter) {
188
+ const existing = await rowsOf(params.indexName);
189
+ const ids = existing
190
+ .filter((entry) => mastraVectorMatchesFilter(entry.metadata, params.deleteFilter))
191
+ .map((entry) => entry.id);
192
+ if (ids.length > 0) {
193
+ await client.query(`DELETE FROM ${vectorsTable} WHERE index_name = $1 AND id = ANY($2::text[])`, [params.indexName, ids]);
194
+ }
195
+ }
196
+ const ids = [];
197
+ for (const [position, vector] of params.vectors.entries()) {
198
+ const id = params.ids?.[position] ?? `${randomUUID()}_${position}`;
199
+ await client.query(`INSERT INTO ${vectorsTable} (index_name, id, vector, metadata)
200
+ VALUES ($1, $2, $3::double precision[], $4::jsonb)
201
+ ON CONFLICT (index_name, id)
202
+ DO UPDATE SET vector = EXCLUDED.vector, metadata = EXCLUDED.metadata`, [
203
+ params.indexName,
204
+ id,
205
+ vector,
206
+ params.metadata?.[position] === undefined
207
+ ? null
208
+ : JSON.stringify(params.metadata[position]),
209
+ ]);
210
+ ids.push(id);
211
+ }
212
+ return ids;
213
+ },
214
+ async query(params) {
215
+ await ensureGraph();
216
+ const index = await requireIndex(params.indexName);
217
+ const rows = await rowsOf(params.indexName);
218
+ const scored = rows
219
+ .filter((entry) => mastraVectorMatchesFilter(entry.metadata, params.filter))
220
+ .map((entry) => {
221
+ const result = {
222
+ id: entry.id,
223
+ score: params.queryVector
224
+ ? mastraVectorScore(index.metric, params.queryVector, entry.vector)
225
+ : 1,
226
+ metadata: entry.metadata,
227
+ };
228
+ if (params.includeVector)
229
+ result.vector = entry.vector;
230
+ return result;
231
+ });
232
+ scored.sort((a, b) => b.score - a.score);
233
+ return params.topK !== undefined ? scored.slice(0, params.topK) : scored;
234
+ },
235
+ async updateVector(params) {
236
+ await ensureGraph();
237
+ await requireIndex(params.indexName);
238
+ if (params.id !== undefined) {
239
+ await client.query(`UPDATE ${vectorsTable}
240
+ SET vector = COALESCE($3::double precision[], vector),
241
+ metadata = COALESCE($4::jsonb, metadata)
242
+ WHERE index_name = $1 AND id = $2`, [
243
+ params.indexName,
244
+ params.id,
245
+ params.update.vector ?? null,
246
+ params.update.metadata === undefined
247
+ ? null
248
+ : JSON.stringify(params.update.metadata),
249
+ ]);
250
+ return;
251
+ }
252
+ const rows = await rowsOf(params.indexName);
253
+ const ids = rows
254
+ .filter((entry) => mastraVectorMatchesFilter(entry.metadata, params.filter))
255
+ .map((entry) => entry.id);
256
+ for (const id of ids) {
257
+ await client.query(`UPDATE ${vectorsTable}
258
+ SET vector = COALESCE($3::double precision[], vector),
259
+ metadata = COALESCE($4::jsonb, metadata)
260
+ WHERE index_name = $1 AND id = $2`, [
261
+ params.indexName,
262
+ id,
263
+ params.update.vector ?? null,
264
+ params.update.metadata === undefined
265
+ ? null
266
+ : JSON.stringify(params.update.metadata),
267
+ ]);
268
+ }
269
+ },
270
+ async deleteVector(params) {
271
+ await ensureGraph();
272
+ await requireIndex(params.indexName);
273
+ await client.query(`DELETE FROM ${vectorsTable} WHERE index_name = $1 AND id = $2`, [params.indexName, params.id]);
274
+ },
275
+ async deleteVectors(params) {
276
+ await ensureGraph();
277
+ await requireIndex(params.indexName);
278
+ if (params.ids) {
279
+ if (params.ids.length === 0)
280
+ return;
281
+ await client.query(`DELETE FROM ${vectorsTable} WHERE index_name = $1 AND id = ANY($2::text[])`, [params.indexName, params.ids]);
282
+ return;
283
+ }
284
+ const rows = await rowsOf(params.indexName);
285
+ const ids = rows
286
+ .filter((entry) => mastraVectorMatchesFilter(entry.metadata, params.filter))
287
+ .map((entry) => entry.id);
288
+ if (ids.length === 0)
289
+ return;
290
+ await client.query(`DELETE FROM ${vectorsTable} WHERE index_name = $1 AND id = ANY($2::text[])`, [params.indexName, ids]);
291
+ },
292
+ };
293
+ }
294
+ //# sourceMappingURL=MastraAgeVectorDriver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraAgeVectorDriver.js","sourceRoot":"","sources":["../../../src/mastra/MastraAgeVectorDriver.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,244 @@
1
+ import { PortDirection } from "./../shared/graph/constants.js";
2
+ import { GraphWorkflowDocumentBuilder } from "./../shared/graph/document/GraphWorkflowDocumentBuilder.js";
3
+ import { graphDefinitionOf } from "./../shared/graph/reader.js";
4
+ import { AgentNode } from "./../node/agents/agent/node.js";
5
+ /**
6
+ * Derives the connection-port handle a satellite node exposes toward its
7
+ * agent zone: the first `@connection` port's declared handle (falling back to
8
+ * the port name).
9
+ *
10
+ * @param definition - The satellite node's resolved definition.
11
+ * @returns The connection handle.
12
+ */
13
+ function satelliteConnectionHandleOf(definition) {
14
+ const connection = definition.ports.find((port) => port.direction === PortDirection.CONNECTION);
15
+ return connection?.graph?.handle ?? connection?.name ?? "";
16
+ }
17
+ /**
18
+ * Derives the zone connection-port handle the agent node exposes for a zone:
19
+ * the `@connection` port whose category names the zone.
20
+ *
21
+ * @param definition - The agent node's resolved definition.
22
+ * @param zone - The mastra agent zone.
23
+ * @returns The zone connection handle.
24
+ */
25
+ function agentZoneHandleOf(definition, zone) {
26
+ const port = definition.ports.find((candidate) => candidate.direction === PortDirection.CONNECTION &&
27
+ candidate.graph?.category === zone);
28
+ return port?.graph?.handle ?? port?.name ?? "";
29
+ }
30
+ /**
31
+ * Fluent builder for valid mastra agent documents. Every `with*` method adds
32
+ * a satellite node derived from its `@node` decorations and connects it to
33
+ * the agent's matching zone connection port; every parameter method tunes the
34
+ * agent node's own parameters. {@link MastraAgentBuilder.build} validates the
35
+ * assembled document.
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * const doc = new MastraAgentBuilder({ id: "support-agent" })
40
+ * .describes("Support", "Answers customer questions")
41
+ * .model("openai", "gpt-4o")
42
+ * .prompt("You are a support agent. {{ $input.question }}")
43
+ * .withTool(MyToolNode)
44
+ * .withMemory(MyMemoryNode)
45
+ * .build();
46
+ * ```
47
+ */
48
+ export class MastraAgentBuilder {
49
+ /**
50
+ * @param options - Builder options (document id/name and agent node id).
51
+ */
52
+ constructor(options = {}) {
53
+ this.edgeSequence = 0;
54
+ const id = options.id ?? "agent-document";
55
+ this.agentId = options.agentId ?? "agent";
56
+ this.inner = new GraphWorkflowDocumentBuilder(id, options.name ?? id);
57
+ this.inner.addDerivedNode(AgentNode, {
58
+ id: this.agentId,
59
+ });
60
+ }
61
+ /**
62
+ * Adds a satellite node to the agent's zone and connects it with a
63
+ * `connection` edge.
64
+ *
65
+ * @param zone - The mastra agent zone to wire the satellite into.
66
+ * @param satellite - The satellite node class or decorated node instance.
67
+ * @param overrides - Optional per-node overrides for the satellite.
68
+ * @returns this builder, for chaining.
69
+ */
70
+ withZoneNode(zone, satellite, overrides) {
71
+ const definition = graphDefinitionOf(satellite);
72
+ const stored = this.inner.addDerivedNode(satellite, overrides);
73
+ const sourceHandle = satelliteConnectionHandleOf(definition);
74
+ const targetHandle = agentZoneHandleOf(graphDefinitionOf(AgentNode), zone);
75
+ this.inner.addEdge({
76
+ id: `${zone}-${++this.edgeSequence}`,
77
+ type: "connection",
78
+ source: { scope: "node", nodeId: stored.id, port: sourceHandle },
79
+ target: { scope: "node", nodeId: this.agentId, port: targetHandle },
80
+ });
81
+ return this;
82
+ }
83
+ /**
84
+ * Sets the agent's task prompt.
85
+ *
86
+ * @param prompt - The prompt text.
87
+ * @returns this builder, for chaining.
88
+ */
89
+ prompt(prompt) {
90
+ return this.withAgentParameters({ prompt });
91
+ }
92
+ /**
93
+ * Sets the agent's system instructions.
94
+ *
95
+ * @param instructions - The instructions text.
96
+ * @returns this builder, for chaining.
97
+ */
98
+ instructions(instructions) {
99
+ return this.withAgentParameters({ instructions });
100
+ }
101
+ /**
102
+ * Sets the agent's display name and description.
103
+ *
104
+ * @param name - The agent name.
105
+ * @param description - The agent description.
106
+ * @returns this builder, for chaining.
107
+ */
108
+ describes(name, description) {
109
+ return this.withAgentParameters({ name, description });
110
+ }
111
+ /**
112
+ * Sets the agent's model-adapter config (the LLM carried as config, R1).
113
+ *
114
+ * @param provider - The model provider id.
115
+ * @param modelId - The model id.
116
+ * @returns this builder, for chaining.
117
+ */
118
+ model(provider, modelId) {
119
+ return this.withAgentParameters({
120
+ modelAdapter: { provider, modelId },
121
+ });
122
+ }
123
+ /**
124
+ * Sets the agent's per-invocation retry bound.
125
+ *
126
+ * @param maxRetries - The retry bound.
127
+ * @returns this builder, for chaining.
128
+ */
129
+ maxRetries(maxRetries) {
130
+ return this.withAgentParameters({ maxRetries });
131
+ }
132
+ /**
133
+ * Merges raw parameter overrides onto the agent node.
134
+ *
135
+ * @param parameters - The parameter overrides.
136
+ * @returns this builder, for chaining.
137
+ */
138
+ withAgentParameters(parameters) {
139
+ const agent = this.inner.getNode(this.agentId);
140
+ if (agent) {
141
+ agent.parameters = { ...agent.parameters, ...parameters };
142
+ }
143
+ return this;
144
+ }
145
+ /**
146
+ * Wires a tool node into the agent's `tools` zone.
147
+ *
148
+ * @param satellite - The tool node class or decorated node instance.
149
+ * @param overrides - Optional per-node overrides.
150
+ * @returns this builder, for chaining.
151
+ */
152
+ withTool(satellite, overrides) {
153
+ return this.withZoneNode("tools", satellite, overrides);
154
+ }
155
+ /**
156
+ * Wires a memory provider node into the agent's `memory` zone.
157
+ *
158
+ * @param satellite - The memory node class or decorated node instance.
159
+ * @param overrides - Optional per-node overrides.
160
+ * @returns this builder, for chaining.
161
+ */
162
+ withMemory(satellite, overrides) {
163
+ return this.withZoneNode("memory", satellite, overrides);
164
+ }
165
+ /**
166
+ * Wires a skill node into the agent's `skill` zone.
167
+ *
168
+ * @param satellite - The skill node class or decorated node instance.
169
+ * @param overrides - Optional per-node overrides.
170
+ * @returns this builder, for chaining.
171
+ */
172
+ withSkill(satellite, overrides) {
173
+ return this.withZoneNode("skill", satellite, overrides);
174
+ }
175
+ /**
176
+ * Wires a scorer node into the agent's `scorers` zone.
177
+ *
178
+ * @param satellite - The scorer node class or decorated node instance.
179
+ * @param overrides - Optional per-node overrides.
180
+ * @returns this builder, for chaining.
181
+ */
182
+ withScorer(satellite, overrides) {
183
+ return this.withZoneNode("scorers", satellite, overrides);
184
+ }
185
+ /**
186
+ * Wires a hook node into the agent's `hooks` zone.
187
+ *
188
+ * @param satellite - The hook node class or decorated node instance.
189
+ * @param overrides - Optional per-node overrides.
190
+ * @returns this builder, for chaining.
191
+ */
192
+ withHook(satellite, overrides) {
193
+ return this.withZoneNode("hooks", satellite, overrides);
194
+ }
195
+ /**
196
+ * Wires a sandbox node into the agent's `sandbox` zone.
197
+ *
198
+ * @param satellite - The sandbox node class or decorated node instance.
199
+ * @param overrides - Optional per-node overrides.
200
+ * @returns this builder, for chaining.
201
+ */
202
+ withSandbox(satellite, overrides) {
203
+ return this.withZoneNode("sandbox", satellite, overrides);
204
+ }
205
+ /**
206
+ * Wires an embedding node into the agent's `embedding` zone.
207
+ *
208
+ * @param satellite - The embedding node class or decorated node instance.
209
+ * @param overrides - Optional per-node overrides.
210
+ * @returns this builder, for chaining.
211
+ */
212
+ withEmbedding(satellite, overrides) {
213
+ return this.withZoneNode("embedding", satellite, overrides);
214
+ }
215
+ /**
216
+ * Wires an input-processor node into the agent's `inputProcessors` zone.
217
+ *
218
+ * @param satellite - The input-processor node class or decorated node instance.
219
+ * @param overrides - Optional per-node overrides.
220
+ * @returns this builder, for chaining.
221
+ */
222
+ withInputProcessor(satellite, overrides) {
223
+ return this.withZoneNode("inputProcessors", satellite, overrides);
224
+ }
225
+ /**
226
+ * Wires an output-processor node into the agent's `outputProcessors` zone.
227
+ *
228
+ * @param satellite - The output-processor node class or decorated node instance.
229
+ * @param overrides - Optional per-node overrides.
230
+ * @returns this builder, for chaining.
231
+ */
232
+ withOutputProcessor(satellite, overrides) {
233
+ return this.withZoneNode("outputProcessors", satellite, overrides);
234
+ }
235
+ /**
236
+ * Validates and freezes the assembled agent document.
237
+ *
238
+ * @returns The validated canonical {@link GraphWorkflowDocument}.
239
+ */
240
+ build() {
241
+ return this.inner.build();
242
+ }
243
+ }
244
+ //# sourceMappingURL=MastraAgentBuilder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraAgentBuilder.js","sourceRoot":"","sources":["../../../src/mastra/MastraAgentBuilder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import { isGraphCredentialReference, } from "./../shared/graph/catalog/GraphCredentialReference.js";
2
+ function isPlainRecord(value) {
3
+ return !!value && typeof value === "object" && !Array.isArray(value);
4
+ }
5
+ /**
6
+ * Structural guard for {@link MastraModelAdapterConfig}: requires non-empty
7
+ * `provider` and `modelId` strings and, when present, a well-formed credential
8
+ * reference.
9
+ *
10
+ * @param value - The candidate adapter config.
11
+ * @returns `true` when the value is a valid model-adapter configuration.
12
+ */
13
+ export function isMastraModelAdapterConfig(value) {
14
+ if (!isPlainRecord(value))
15
+ return false;
16
+ if (typeof value["provider"] !== "string" || value["provider"].length === 0) {
17
+ return false;
18
+ }
19
+ if (typeof value["modelId"] !== "string" || value["modelId"].length === 0) {
20
+ return false;
21
+ }
22
+ const credentialRef = value["credentialRef"];
23
+ if (credentialRef !== undefined && !isGraphCredentialReference(credentialRef)) {
24
+ return false;
25
+ }
26
+ return true;
27
+ }
28
+ /**
29
+ * Reads the model-adapter config carried by a document node. Looks at the
30
+ * canonical `modelAdapter` parameter only; an absent or malformed value returns
31
+ * `undefined` so the caller fails closed instead of constructing a bogus model.
32
+ *
33
+ * @param node - The canonical node instance.
34
+ * @returns The validated adapter config, or `undefined` when none is present.
35
+ */
36
+ export function graphModelAdapterOf(node) {
37
+ const candidate = node.parameters?.["modelAdapter"];
38
+ return isMastraModelAdapterConfig(candidate) ? candidate : undefined;
39
+ }
40
+ /**
41
+ * Translates a {@link MastraModelAdapterConfig} into the `@mastra/core` model
42
+ * config. Never injects an API key: the provider reads its own environment
43
+ * (`.env.secret`, gate C) at call time, so no secret is ever held in the graph
44
+ * document, node parameters, or this translation.
45
+ *
46
+ * @param adapter - The validated adapter config.
47
+ * @returns The mastra model config the agent is constructed with.
48
+ */
49
+ export function mastraModelConfigOf(adapter) {
50
+ const config = { id: `${adapter.provider}/${adapter.modelId}` };
51
+ if (typeof adapter.maxRetries === "number")
52
+ config.maxRetries = adapter.maxRetries;
53
+ if (adapter.modelSettings)
54
+ config.modelSettings = adapter.modelSettings;
55
+ if (adapter.providerOptions)
56
+ config.providerOptions = adapter.providerOptions;
57
+ return config;
58
+ }
59
+ //# sourceMappingURL=MastraAgentModelAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraAgentModelAdapter.js","sourceRoot":"","sources":["../../../src/mastra/MastraAgentModelAdapter.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,0BAA0B,GAE3B,8DAAyD;AA0B1D,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,aAAa,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IAC7C,IAAI,aAAa,KAAK,SAAS,IAAI,CAAC,0BAA0B,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAuB;IAEvB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAcD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAiC;IACnE,MAAM,MAAM,GAAsB,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IACnF,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;QAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACnF,IAAI,OAAO,CAAC,aAAa;QAAE,MAAM,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IACxE,IAAI,OAAO,CAAC,eAAe;QAAE,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAC9E,OAAO,MAAM,CAAC;AAChB,CAAC"}