@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,139 @@
1
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
2
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
3
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
4
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
5
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
6
+ };
7
+ var __metadata = (this && this.__metadata) || function (k, v) {
8
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
9
+ };
10
+ /**
11
+ * @module as-graph/mastra/MastraGraphExecutionModule
12
+ * @summary Mastra NestJS integration for the graph backend (SAA-836 O1).
13
+ * @description The mastra-specific NestJS dynamic module that boots the mastra
14
+ * engine: {@link MastraGraphExecutionModule.forRoot} constructs and initializes
15
+ * the real {@link MastraGraphExecutionBackend} from the host wiring plus the
16
+ * accumulated mastra environment (`MASTRA__*` — engine enablement, observability
17
+ * with langfuse, per-layer persistence), selects it as the active graph backend,
18
+ * and delegates the full graph serving stack (catalogue, workflows, runs,
19
+ * capability manifest, run-metrics delegation) to
20
+ * {@link module:as-graph/nest/graph/GraphExecutionModule}.
21
+ *
22
+ * Boot is fail-closed: when the mastra lane is disabled in the environment
23
+ * (`MASTRA__ENGINE__ENABLED=false`) the backend `initialize` rejects with
24
+ * `GRAPH_MASTRA_ENGINE_DISABLED` and the module never boots. On application
25
+ * shutdown the owned engine surfaces (observability exporter, per-layer
26
+ * persistence adapters) are disposed through the backend's `dispose`, so a
27
+ * NestJS host never leaks the persistence adapters it booted.
28
+ *
29
+ * @mermaid
30
+ * sequenceDiagram
31
+ * autonumber
32
+ * participant Host as NestJS backend app
33
+ * participant M as MastraGraphExecutionModule
34
+ * participant B as MastraGraphExecutionBackend
35
+ * participant G as GraphExecutionModule
36
+ * Host->>M: forRoot(options)
37
+ * M->>G: forRoot({ backendFactory, engines.defaultEngineId: "mastra", ... })
38
+ * Note over G: engine provider factory (async)
39
+ * G->>M: backendFactory()
40
+ * M->>B: new + initialize(host mastra config)
41
+ * alt MASTRA__ENGINE__ENABLED=false
42
+ * B-->>M: GraphExecutionError (GRAPH_MASTRA_ENGINE_DISABLED)
43
+ * end
44
+ * B-->>M: backend registered under "mastra"
45
+ * M-->>G: backend
46
+ * G-->>Host: graph serving stack active on the mastra engine
47
+ * Host->>M: application shutdown
48
+ * M->>B: dispose() (observability flush + persistence adapter shutdown)
49
+ */
50
+ import { Injectable, Module } from "@nestjs/common";
51
+ import { MASTRA_BACKEND_FLAVOUR } from "./types.js";
52
+ import { GraphExecutionModule, } from "./../nest/graph/GraphExecutionModule.js";
53
+ import { MastraGraphExecutionBackend } from "./MastraGraphExecutionBackend.js";
54
+ /** Injection token for the mastra backend shutdown hook provider. */
55
+ export const MASTRA_GRAPH_BACKEND_SHUTDOWN = "MASTRA_GRAPH_BACKEND_SHUTDOWN";
56
+ /**
57
+ * Application-shutdown hook that disposes the mastra backend the module booted
58
+ * (observability flush/shutdown and owned per-layer persistence adapters).
59
+ * Registered only by {@link MastraGraphExecutionModule.forRoot}; a no-op when
60
+ * the engine booted without the mastra backend.
61
+ */
62
+ let MastraGraphBackendShutdown = class MastraGraphBackendShutdown {
63
+ /**
64
+ * Builds the hook. The backend is read lazily through the supplied accessor
65
+ * (the module's `backendFactory` closure), so the provider never forces an
66
+ * injection cycle with the engine factory.
67
+ *
68
+ * @param backendRef - Accessor resolving the booted mastra backend, when present.
69
+ */
70
+ constructor(backendRef) {
71
+ this.backendRef = backendRef;
72
+ }
73
+ /**
74
+ * Disposes the mastra backend on application shutdown. When the engine
75
+ * booted without a mastra backend the hook resolves without effect.
76
+ *
77
+ * @returns Resolves when the backend (when present) has disposed.
78
+ */
79
+ async onApplicationShutdown() {
80
+ const backend = this.backendRef();
81
+ if (!backend)
82
+ return;
83
+ await backend.dispose();
84
+ }
85
+ };
86
+ MastraGraphBackendShutdown = __decorate([
87
+ Injectable(),
88
+ __metadata("design:paramtypes", [Function])
89
+ ], MastraGraphBackendShutdown);
90
+ export { MastraGraphBackendShutdown };
91
+ /**
92
+ * Mastra NestJS dynamic module for the graph backend (SAA-836 O1). Configure
93
+ * via {@link MastraGraphExecutionModule.forRoot}.
94
+ */
95
+ let MastraGraphExecutionModule = class MastraGraphExecutionModule {
96
+ /**
97
+ * Creates the mastra graph dynamic module: the mastra backend is constructed
98
+ * and initialized lazily inside the graph engine's provider factory (Nest
99
+ * supports async factories; `forRoot` stays synchronous), the mastra flavour
100
+ * becomes the advertised default engine id, and an application-shutdown hook
101
+ * disposes the backend's owned surfaces.
102
+ *
103
+ * @param options - The mastra host wiring plus base graph module options.
104
+ * @returns The composed dynamic module to import in the backend app.
105
+ */
106
+ static forRoot(options = {}) {
107
+ const { mastra, seedWorkflows, base } = options;
108
+ // The closure the shutdown hook reads: set once the engine's provider
109
+ // factory awaits `backendFactory`, before the engine serves any run.
110
+ let bootedBackend;
111
+ const composed = GraphExecutionModule.forRoot({
112
+ ...(base ?? {}),
113
+ ...(seedWorkflows ? { seedWorkflows } : {}),
114
+ engines: {
115
+ ...(base?.engines ?? {}),
116
+ defaultEngineId: MASTRA_BACKEND_FLAVOUR,
117
+ },
118
+ backendFactory: async () => {
119
+ const backend = new MastraGraphExecutionBackend();
120
+ await backend.initialize(mastra ?? {});
121
+ bootedBackend = backend;
122
+ return backend;
123
+ },
124
+ });
125
+ const shutdownProvider = {
126
+ provide: MASTRA_GRAPH_BACKEND_SHUTDOWN,
127
+ useFactory: () => new MastraGraphBackendShutdown(() => bootedBackend),
128
+ };
129
+ return {
130
+ ...composed,
131
+ providers: [...(composed.providers ?? []), shutdownProvider],
132
+ };
133
+ }
134
+ };
135
+ MastraGraphExecutionModule = __decorate([
136
+ Module({})
137
+ ], MastraGraphExecutionModule);
138
+ export { MastraGraphExecutionModule };
139
+ //# sourceMappingURL=MastraGraphExecutionModule.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraGraphExecutionModule.js","sourceRoot":"","sources":["../../../src/mastra/MastraGraphExecutionModule.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAiB,UAAU,EAAE,MAAM,EAAmC,MAAM,gBAAgB,CAAC;AAEpG,OAAO,EAAE,sBAAsB,EAAE,mBAAgB;AACjD,OAAO,EACL,oBAAoB,GAErB,gDAA2C;AAE5C,OAAO,EAAE,2BAA2B,EAAE,yCAAsC;AAE5E,qEAAqE;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,+BAA+B,CAAC;AA4B7E;;;;;GAKG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IAIrC;;;;;;OAMG;IACH,YAAY,UAAyD;QACnE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,qBAAqB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AA1BY,0BAA0B;IADtC,UAAU,EAAE;;GACA,0BAA0B,CA0BtC;;AAED;;;GAGG;AAEI,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IACrC;;;;;;;;;OASG;IACH,MAAM,CAAC,OAAO,CACZ,UAA6C,EAAE;QAE/C,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;QAChD,sEAAsE;QACtE,qEAAqE;QACrE,IAAI,aAAsD,CAAC;QAC3D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,CAAC;YAC5C,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;YACf,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,EAAE;gBACP,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;gBACxB,eAAe,EAAE,sBAAsB;aACxC;YACD,cAAc,EAAE,KAAK,IAAI,EAAE;gBACzB,MAAM,OAAO,GAAG,IAAI,2BAA2B,EAAE,CAAC;gBAClD,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBACvC,aAAa,GAAG,OAAO,CAAC;gBACxB,OAAO,OAAO,CAAC;YACjB,CAAC;SACF,CAAC,CAAC;QACH,MAAM,gBAAgB,GAAa;YACjC,OAAO,EAAE,6BAA6B;YACtC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,0BAA0B,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC;SACtE,CAAC;QACF,OAAO;YACL,GAAG,QAAQ;YACX,SAAS,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,gBAAgB,CAAC;SAC7D,CAAC;IACJ,CAAC;CACF,CAAA;AAzCY,0BAA0B;IADtC,MAAM,CAAC,EAAE,CAAC;GACE,0BAA0B,CAyCtC"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraHitlStepHandler
3
+ * @summary Mastra step handler for the `core.agent.hitl` kind (SAA-836 M5).
4
+ * @description Translates a human-in-the-loop node into a suspending mastra
5
+ * step with mastra's own suspend/resume semantics (R3): the step suspends with
6
+ * the node's `message`/`prompt` payload and resumes with the user's input,
7
+ * validated against the node's declared resume schema (C15) and routed onto
8
+ * the canonical `approved`/`rejected` outputs. Resume requests themselves are
9
+ * authorized upstream by the run service's owner-equality gate and validated by
10
+ * the backend resume guard (SAA-193); this handler only owns the step
11
+ * translation.
12
+ */
13
+ import { z } from "zod";
14
+ import { createStep } from "@mastra/core/workflows";
15
+ import { assertMastraResumeSchemaSafe, toMastraZodSchema } from "./MastraSchemaConverter.js";
16
+ /** The document node kind the HITL handler translates. */
17
+ export const GRAPH_MASTRA_HITL_KIND = "core.agent.hitl";
18
+ /**
19
+ * Builds the {@link MastraNodeStepHandler} registered for the
20
+ * `core.agent.hitl` kind. The step declares the node's `suspendSchema`
21
+ * (optional, mastra-validates the suspend payload shape) and the required,
22
+ * non-degraded `resumeSchema` (C15); when the step runs without resume data it
23
+ * suspends with the node's message/prompt payload, and the resumed payload is
24
+ * routed to `approved` (or `rejected` on an explicit decline) exactly like the
25
+ * general-engine human-approval translation.
26
+ *
27
+ * @returns The HITL step handler.
28
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE} at
29
+ * translation time when the node declares a missing or degraded resume
30
+ * schema, so an unresumable HITL node never reaches execution.
31
+ */
32
+ export function createMastraHitlStepHandler() {
33
+ return {
34
+ kind: GRAPH_MASTRA_HITL_KIND,
35
+ createStep: (node, { stepId }) => {
36
+ const parameters = node.parameters ?? {};
37
+ const suspendSchema = toMastraZodSchema(parameters["suspendSchema"]);
38
+ const resumeSchema = assertMastraResumeSchemaSafe(parameters["resumeSchema"]);
39
+ return createStep({
40
+ id: stepId,
41
+ inputSchema: z.any(),
42
+ outputSchema: z.any(),
43
+ suspendSchema: suspendSchema.schema,
44
+ resumeSchema,
45
+ execute: async (args) => {
46
+ if (args.resumeData === undefined) {
47
+ await args.suspend?.({
48
+ message: parameters["message"],
49
+ prompt: parameters["prompt"],
50
+ });
51
+ }
52
+ const resumeData = args.resumeData;
53
+ const value = resumeData?.value ?? resumeData;
54
+ return resumeData?.approved === false
55
+ ? { rejected: value }
56
+ : { approved: value };
57
+ },
58
+ });
59
+ },
60
+ };
61
+ }
62
+ //# sourceMappingURL=MastraHitlStepHandler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraHitlStepHandler.js","sourceRoot":"","sources":["../../../src/mastra/MastraHitlStepHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,mCAAgC;AAG1F,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,CAAC,IAAuB,EAAE,EAAE,MAAM,EAAyB,EAAE,EAAE;YACzE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,iBAAiB,CACrC,UAAU,CAAC,eAAe,CAAU,CACrC,CAAC;YACF,MAAM,YAAY,GAAG,4BAA4B,CAC/C,UAAU,CAAC,cAAc,CAAU,CACpC,CAAC;YACF,OAAO,UAAU,CAAC;gBAChB,EAAE,EAAE,MAAM;gBACV,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE;gBACpB,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE;gBACrB,aAAa,EAAE,aAAa,CAAC,MAAM;gBACnC,YAAY;gBACZ,OAAO,EAAE,KAAK,EAAE,IAGf,EAAE,EAAE;oBACH,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;wBAClC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;4BACnB,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;4BAC9B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;yBAC7B,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAEX,CAAC;oBACd,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,UAAU,CAAC;oBAC9C,OAAO,UAAU,EAAE,QAAQ,KAAK,KAAK;wBACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;wBACrB,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBAC1B,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,246 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraMcpTrigger
3
+ * @summary Mastra step handler for the `core.agent.trigger.mcp` kind
4
+ * (SAA-836 M5).
5
+ * @description Translates an MCP Server Trigger node into a mastra step that
6
+ * resolves the trigger's MCP server descriptor and hands it to the
7
+ * host-supplied server factory. The concrete mastra MCP server implementation
8
+ * is packaged as `@mastra/mcp`, which as-graph does not vendor; per R2 the
9
+ * server surface is therefore a declared extension point — the host factory
10
+ * wraps the real server, and without one the trigger fails closed with
11
+ * {@link GRAPH_MASTRA_MCP_UNAVAILABLE} instead of fabricating a served
12
+ * endpoint.
13
+ */
14
+ import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual, } from "node:crypto";
15
+ import { z } from "zod";
16
+ import { createStep } from "@mastra/core/workflows";
17
+ import { GraphExecutionError } from "./../engine/errors/GraphExecutionError.js";
18
+ import { resolveMastraCredentialValue } from "./MastraEnvironment.js";
19
+ import { GRAPH_MASTRA_MCP_UNAVAILABLE, } from "./types.js";
20
+ /** The document node kind the MCP trigger handler translates. */
21
+ export const GRAPH_MASTRA_MCP_TRIGGER_KIND = "core.agent.trigger.mcp";
22
+ /** Default number of concurrent un-released deliveries a guard admits. */
23
+ export const MASTRA_MCP_DEFAULT_PENDING_CAP = 256;
24
+ /** Default ceiling (ms) a delivery may stay pending before being pruned. */
25
+ export const MASTRA_MCP_DEFAULT_PENDING_TIMEOUT_MS = 60_000;
26
+ function digestOf(value) {
27
+ return createHash("sha256").update(value).digest();
28
+ }
29
+ function positiveIntegerOr(value, fallback) {
30
+ return typeof value === "number" &&
31
+ Number.isInteger(value) &&
32
+ value > 0
33
+ ? value
34
+ : fallback;
35
+ }
36
+ /**
37
+ * Reads the C6 delivery-authentication config an MCP trigger node declares.
38
+ * Only the credential **name** is carried by the document; auth mode and the
39
+ * pending-delivery ceilings are plain node config.
40
+ *
41
+ * @param node - The MCP trigger node.
42
+ * @returns The resolved auth config.
43
+ */
44
+ export function mastraMcpAuthConfigOf(node) {
45
+ const parameters = node.parameters ?? {};
46
+ const mode = parameters["authMode"] === "hmac" ? "hmac" : "token";
47
+ const reference = parameters["authCredentialRef"];
48
+ const credentialEnv = (() => {
49
+ if (typeof reference === "string" && reference.trim().length > 0) {
50
+ return reference.trim();
51
+ }
52
+ if (typeof reference === "object" &&
53
+ reference !== null &&
54
+ "credentialId" in reference &&
55
+ typeof reference.credentialId ===
56
+ "string") {
57
+ const id = reference.credentialId.trim();
58
+ return id.length > 0 ? id : undefined;
59
+ }
60
+ return undefined;
61
+ })();
62
+ return {
63
+ mode,
64
+ ...(credentialEnv ? { credentialEnv } : {}),
65
+ pendingCap: positiveIntegerOr(parameters["pendingCap"], MASTRA_MCP_DEFAULT_PENDING_CAP),
66
+ pendingTimeoutMs: positiveIntegerOr(parameters["pendingTimeoutMs"], MASTRA_MCP_DEFAULT_PENDING_TIMEOUT_MS),
67
+ };
68
+ }
69
+ /**
70
+ * Run-scoped C6 delivery guard handed to the host MCP server factory alongside
71
+ * the descriptor. It authenticates delivery callers with a timing-safe token
72
+ * (or HMAC signature) and caps concurrent pending deliveries so the served
73
+ * workflow cannot be flooded or answer an unauthenticated caller.
74
+ *
75
+ * The exposed server id is minted per run and unrelated to the descriptor's
76
+ * document-carried `serverId`, and both it and the delivery secret are
77
+ * prototype accessors, so serializing or logging the guard never leaks them.
78
+ */
79
+ export class MastraMcpDeliveryGuard {
80
+ #exposedServerId;
81
+ #deliverySecret;
82
+ #secretDigest;
83
+ #pending = new Map();
84
+ /**
85
+ * @param config - Auth config; when no credential environment variable is
86
+ * named a random run-scoped secret is generated and exposed to the host.
87
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_CREDENTIALS_UNAVAILABLE}
88
+ * when a named credential is missing from the host environment.
89
+ */
90
+ constructor(config = { mode: "token" }) {
91
+ this.mode = config.mode;
92
+ this.pendingCap = config.pendingCap ?? MASTRA_MCP_DEFAULT_PENDING_CAP;
93
+ this.pendingTimeoutMs =
94
+ config.pendingTimeoutMs ?? MASTRA_MCP_DEFAULT_PENDING_TIMEOUT_MS;
95
+ this.#deliverySecret = config.credentialEnv
96
+ ? resolveMastraCredentialValue(config.credentialEnv)
97
+ : randomBytes(32).toString("hex");
98
+ this.#secretDigest = digestOf(this.#deliverySecret);
99
+ this.#exposedServerId = `mcp-${randomUUID()}`;
100
+ }
101
+ /** The run-scoped server id exposed to clients (never the document id). */
102
+ get exposedServerId() {
103
+ return this.#exposedServerId;
104
+ }
105
+ /** The shared secret the host publishes to authenticated clients. */
106
+ get deliverySecret() {
107
+ return this.#deliverySecret;
108
+ }
109
+ /** The number of currently pending deliveries. */
110
+ get pendingCount() {
111
+ this.prune();
112
+ return this.#pending.size;
113
+ }
114
+ /**
115
+ * Authenticates a presented token in constant time.
116
+ *
117
+ * @param presented - The caller-presented token.
118
+ * @returns `true` when it matches the guard secret.
119
+ */
120
+ authenticate(presented) {
121
+ if (typeof presented !== "string" || presented.length === 0) {
122
+ return false;
123
+ }
124
+ return timingSafeEqual(digestOf(presented), this.#secretDigest);
125
+ }
126
+ /**
127
+ * Signs a delivery payload with the guard secret.
128
+ *
129
+ * @param payload - The delivery payload.
130
+ * @returns The lowercase hex HMAC-SHA256 signature.
131
+ */
132
+ sign(payload) {
133
+ return createHmac("sha256", this.#deliverySecret)
134
+ .update(payload)
135
+ .digest("hex");
136
+ }
137
+ /**
138
+ * Verifies an HMAC-SHA256 delivery signature in constant time.
139
+ *
140
+ * @param payload - The delivery payload.
141
+ * @param signature - The caller-presented hex signature.
142
+ * @returns `true` when the signature is valid.
143
+ */
144
+ verify(payload, signature) {
145
+ if (typeof signature !== "string" || signature.length === 0) {
146
+ return false;
147
+ }
148
+ return timingSafeEqual(digestOf(this.sign(payload)), digestOf(signature));
149
+ }
150
+ /**
151
+ * Reserves a pending delivery slot. Expired slots are pruned first; when the
152
+ * concurrent ceiling is reached the delivery is refused instead of queued.
153
+ *
154
+ * @returns The pending delivery slot.
155
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MCP_UNAVAILABLE} when the
156
+ * concurrent pending-delivery ceiling is reached.
157
+ */
158
+ begin() {
159
+ this.prune();
160
+ if (this.#pending.size >= this.pendingCap) {
161
+ throw new GraphExecutionError(`MCP trigger refused a delivery: ${this.#pending.size} deliveries are already pending (cap ${this.pendingCap})`, GRAPH_MASTRA_MCP_UNAVAILABLE, { pendingCount: this.#pending.size, pendingCap: this.pendingCap });
162
+ }
163
+ const id = randomUUID();
164
+ this.#pending.set(id, Date.now());
165
+ let released = false;
166
+ return {
167
+ id,
168
+ release: () => {
169
+ if (!released) {
170
+ released = true;
171
+ this.#pending.delete(id);
172
+ }
173
+ },
174
+ };
175
+ }
176
+ prune() {
177
+ const cutoff = Date.now() - this.pendingTimeoutMs;
178
+ for (const [id, startedAt] of this.#pending) {
179
+ if (startedAt < cutoff) {
180
+ this.#pending.delete(id);
181
+ }
182
+ }
183
+ }
184
+ }
185
+ /**
186
+ * Reads the {@link MastraMcpServerDescriptor} an MCP Server Trigger node
187
+ * resolves from its parameters (R9 descriptor shape).
188
+ *
189
+ * @param node - The trigger node.
190
+ * @param workflowId - The canonical workflow id the trigger belongs to.
191
+ * @returns The MCP server descriptor.
192
+ */
193
+ export function mastraMcpServerDescriptorOf(node, workflowId) {
194
+ const parameters = node.parameters ?? {};
195
+ const transport = parameters["transport"];
196
+ return {
197
+ serverId: String(parameters["serverId"] ?? node.id),
198
+ ...(typeof parameters["title"] === "string"
199
+ ? { title: parameters["title"] }
200
+ : {}),
201
+ ...(typeof parameters["instructions"] === "string"
202
+ ? { instructions: parameters["instructions"] }
203
+ : {}),
204
+ ...(transport === "http" || transport === "stdio"
205
+ ? { transport }
206
+ : {}),
207
+ ...(workflowId ? { workflowId } : {}),
208
+ nodeId: node.id,
209
+ };
210
+ }
211
+ /**
212
+ * Builds the {@link MastraNodeStepHandler} registered for the
213
+ * `core.agent.trigger.mcp` kind. The step resolves the trigger's MCP server
214
+ * descriptor, delegates the serving to the host factory, and returns the
215
+ * server surface on the `resource` output. Without a host factory the step
216
+ * fails closed — no endpoint is ever fabricated.
217
+ *
218
+ * @param options - The handler options (the host server factory).
219
+ * @returns The MCP trigger step handler.
220
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MCP_UNAVAILABLE} when no
221
+ * host factory is configured or it yields nothing.
222
+ */
223
+ export function createMastraMcpTriggerStepHandler(options = {}) {
224
+ return {
225
+ kind: GRAPH_MASTRA_MCP_TRIGGER_KIND,
226
+ createStep: (node, { stepId }) => createStep({
227
+ id: stepId,
228
+ inputSchema: z.any(),
229
+ outputSchema: z.any(),
230
+ execute: async (args) => {
231
+ void args;
232
+ const descriptor = mastraMcpServerDescriptorOf(node);
233
+ if (!options.createMcpServer) {
234
+ throw new GraphExecutionError(`MCP trigger node '${node.id}' has no host mastra MCP server surface configured`, GRAPH_MASTRA_MCP_UNAVAILABLE, { nodeId: node.id, kind: node.kind });
235
+ }
236
+ const guard = new MastraMcpDeliveryGuard(mastraMcpAuthConfigOf(node));
237
+ const server = await options.createMcpServer(descriptor, guard);
238
+ if (server === undefined || server === null) {
239
+ throw new GraphExecutionError(`MCP trigger node '${node.id}': the host mastra MCP server factory resolved no server`, GRAPH_MASTRA_MCP_UNAVAILABLE, { nodeId: node.id, kind: node.kind });
240
+ }
241
+ return { resource: server };
242
+ },
243
+ }),
244
+ };
245
+ }
246
+ //# sourceMappingURL=MastraMcpTrigger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraMcpTrigger.js","sourceRoot":"","sources":["../../../src/mastra/MastraMcpTrigger.ts"],"names":[],"mappings":"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"}