@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,145 @@
1
+ /**
2
+ * @module as-graph/engine/credentials/GraphNodeCredentials
3
+ * @summary Ctx-bound credential resolution for graph nodes (DECAF-809 Phase B).
4
+ * @description Replaces the Phase-2 `GRAPH_CREDENTIAL_*` environment-variable
5
+ * convention (whose remaining `GRAPH_CREDENTIAL_*` strings here are
6
+ * `GraphExecutionError` codes, not configuration): node executors resolve
7
+ * credential references only through the engine's
8
+ * {@link GraphNodeCredentialResolver}, which forwards the execution context to
9
+ * the namespaced Phase A `CredentialService` and to the model/filesystem
10
+ * secret services, so tenancy (RLS) scoping is enforced and secrets are never
11
+ * read from `process.env`. Resolution fails closed — missing, disabled,
12
+ * expired, or type-mismatched credentials, and unsupported secret providers,
13
+ * all throw typed `GRAPH_CREDENTIAL_*` errors.
14
+ *
15
+ * @mermaid
16
+ * sequenceDiagram
17
+ * autonumber
18
+ * participant N as Node executor
19
+ * participant R as resolveNodeCredential
20
+ * participant E as Engine (ctx-bound)
21
+ * participant Res as GraphNodeCredentialResolver
22
+ * participant C as CredentialService (RLS)
23
+ * participant S as Secret service
24
+ * N->>R: resolveNodeCredential(context, references, expectedType)
25
+ * R->>E: context.engine.nodeCredentials
26
+ * alt no engine resolver configured
27
+ * R-->>N: throw GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE
28
+ * else resolver present
29
+ * R->>Res: resolve(reference, expectedType, required, nodeName, context)
30
+ * Res->>C: getCredential(credentialId, context)
31
+ * activate C
32
+ * C-->>Res: GraphCredentialRecord
33
+ * deactivate C
34
+ * alt disabled / expired / type mismatch / not found
35
+ * Res-->>N: throw GRAPH_CREDENTIAL_* (fail closed)
36
+ * else valid
37
+ * Res->>S: retrieve(record.secretName, {}, context)
38
+ * activate S
39
+ * S-->>Res: secret payload
40
+ * deactivate S
41
+ * Res->>C: markCredentialUsed(credentialId, context)
42
+ * Res-->>N: string | record secret (never process.env)
43
+ * end
44
+ * end
45
+ */
46
+ import type { Context } from "@decaf-ts/core";
47
+ import type { GraphCredentialReference } from "../../shared/graph/index.d.cts";
48
+ import type { GraphResolvedCredentials } from "../types.d.cts";
49
+ /**
50
+ * The resolved credential payload handed to a node: a bare token/secret
51
+ * string, a JSON-shaped record the node re-parses per its credential format,
52
+ * or `undefined` when no reference exists and none is required.
53
+ */
54
+ export type GraphNodeCredentialSecret = string | Record<string, unknown> | undefined;
55
+ /** Structural view of a Phase A credential record the resolver reads. */
56
+ export interface GraphCredentialRecord {
57
+ id: string;
58
+ name: string;
59
+ credentialType: string;
60
+ /** Name of the secret held by the provider's secret service. */
61
+ secretName: string;
62
+ /** Secret provider backing the credential (`model` or `filesystem`). */
63
+ provider: string;
64
+ enabled?: boolean;
65
+ expiresAt?: Date | string | null;
66
+ tenantId?: string;
67
+ orgUnitId?: string;
68
+ ownerPrincipalId?: string;
69
+ }
70
+ /** Port over the namespaced credential service the resolver needs. */
71
+ export interface GraphCredentialServicePort {
72
+ getCredential(credentialId: string, ...args: any[]): Promise<GraphCredentialRecord>;
73
+ markCredentialUsed?(credentialId: string, ...args: any[]): Promise<unknown>;
74
+ }
75
+ /** Port over a secret service (model-backed or filesystem-backed). */
76
+ export interface GraphSecretServicePort {
77
+ readonly provider?: string;
78
+ retrieve(nameOrRef: string, options?: Record<string, unknown>, ...args: any[]): Promise<unknown>;
79
+ }
80
+ /** Host-supplied Phase A services the engine wires into the credential resolver. */
81
+ export interface GraphNodeCredentialServices {
82
+ credentialService: GraphCredentialServicePort;
83
+ modelSecretService: GraphSecretServicePort;
84
+ fsSecretService?: GraphSecretServicePort;
85
+ }
86
+ /**
87
+ * Resolves workflow credential references through ctx-bound Phase A
88
+ * credential/secret services.
89
+ *
90
+ * The engine constructs one resolver per execution from the host's
91
+ * {@link GraphNodeCredentialServices}; nodes reach it as
92
+ * `context.engine.nodeCredentials`. Every failure mode is fail-closed and
93
+ * typed: the `GRAPH_CREDENTIAL_*` strings in thrown errors are error codes,
94
+ * never environment-variable names.
95
+ */
96
+ export declare class GraphNodeCredentialResolver {
97
+ private readonly services;
98
+ constructor(services: GraphNodeCredentialServices);
99
+ /**
100
+ * Resolves one credential reference to its secret payload.
101
+ *
102
+ * @param reference - The credential reference declared by the node (absent when the node declared none).
103
+ * @param expectedType - Credential type the node accepts (e.g. `"github"`).
104
+ * @param required - Whether execution may proceed without a credential.
105
+ * @param nodeName - Human-readable node name used in error messages.
106
+ * @param context - Execution context forwarded to the credential and secret services for tenancy scoping.
107
+ * @returns The credential record's secret payload as a string or record; `undefined` when no reference exists and `required` is false.
108
+ * @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` (no reference, required),
109
+ * `GRAPH_CREDENTIAL_TYPE_MISMATCH` (declared/record type differs from `expectedType`),
110
+ * `GRAPH_CREDENTIAL_NOT_FOUND` (credential service lookup failed),
111
+ * `GRAPH_CREDENTIAL_DISABLED`, `GRAPH_CREDENTIAL_EXPIRED`,
112
+ * `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` (filesystem provider without a configured service), and
113
+ * `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` (provider other than `model`/`filesystem`).
114
+ */
115
+ resolve(reference: GraphCredentialReference | undefined, expectedType: string, required: boolean, nodeName: string, context?: Context): Promise<GraphNodeCredentialSecret>;
116
+ /**
117
+ * Picks the secret service backing the credential's provider.
118
+ *
119
+ * @param provider - Provider recorded on the credential (`model` or `filesystem`).
120
+ * @param nodeName - Human-readable node name used in error messages.
121
+ * @returns The secret service port for the provider.
122
+ * @throws {GraphExecutionError} with code `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the filesystem provider has no configured service, or `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` for any other provider.
123
+ */
124
+ private secretServiceFor;
125
+ }
126
+ /**
127
+ * Resolves the credential reference registered under `id` for a node
128
+ * execution, through the ctx-bound resolver the executing engine carries.
129
+ *
130
+ * Convenience wrapper used by every migrated `src/node/**` executor: it reads
131
+ * the reference from `references`, obtains the engine's
132
+ * {@link GraphNodeCredentialResolver} from `context`, and delegates. There is
133
+ * deliberately no environment fallback — without a configured engine resolver
134
+ * the node fails closed.
135
+ *
136
+ * @param context - The node execution context carrying the engine reference; may be `undefined` in legacy call sites.
137
+ * @param references - Credential references resolved by the engine for this run.
138
+ * @param expectedType - Credential type the node accepts (e.g. `"sftp"`).
139
+ * @param required - Whether execution may proceed without any credential.
140
+ * @param nodeName - Human-readable node name used in error messages.
141
+ * @param id - Handle under which the reference was registered (default `"credentialRef"`).
142
+ * @returns The resolved secret (string or record), or `undefined` when no reference exists and `required` is false.
143
+ * @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` when no reference exists and `required` is true, `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the engine carries no credential resolver, and the `GRAPH_CREDENTIAL_*` codes propagated from {@link GraphNodeCredentialResolver.resolve}.
144
+ */
145
+ export declare function resolveNodeCredential(context: Context | undefined, references: GraphResolvedCredentials, expectedType: string, required: boolean, nodeName: string, id?: string): Promise<GraphNodeCredentialSecret>;
@@ -0,0 +1,145 @@
1
+ /**
2
+ * @module as-graph/engine/credentials/GraphNodeCredentials
3
+ * @summary Ctx-bound credential resolution for graph nodes (DECAF-809 Phase B).
4
+ * @description Replaces the Phase-2 `GRAPH_CREDENTIAL_*` environment-variable
5
+ * convention (whose remaining `GRAPH_CREDENTIAL_*` strings here are
6
+ * `GraphExecutionError` codes, not configuration): node executors resolve
7
+ * credential references only through the engine's
8
+ * {@link GraphNodeCredentialResolver}, which forwards the execution context to
9
+ * the namespaced Phase A `CredentialService` and to the model/filesystem
10
+ * secret services, so tenancy (RLS) scoping is enforced and secrets are never
11
+ * read from `process.env`. Resolution fails closed — missing, disabled,
12
+ * expired, or type-mismatched credentials, and unsupported secret providers,
13
+ * all throw typed `GRAPH_CREDENTIAL_*` errors.
14
+ *
15
+ * @mermaid
16
+ * sequenceDiagram
17
+ * autonumber
18
+ * participant N as Node executor
19
+ * participant R as resolveNodeCredential
20
+ * participant E as Engine (ctx-bound)
21
+ * participant Res as GraphNodeCredentialResolver
22
+ * participant C as CredentialService (RLS)
23
+ * participant S as Secret service
24
+ * N->>R: resolveNodeCredential(context, references, expectedType)
25
+ * R->>E: context.engine.nodeCredentials
26
+ * alt no engine resolver configured
27
+ * R-->>N: throw GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE
28
+ * else resolver present
29
+ * R->>Res: resolve(reference, expectedType, required, nodeName, context)
30
+ * Res->>C: getCredential(credentialId, context)
31
+ * activate C
32
+ * C-->>Res: GraphCredentialRecord
33
+ * deactivate C
34
+ * alt disabled / expired / type mismatch / not found
35
+ * Res-->>N: throw GRAPH_CREDENTIAL_* (fail closed)
36
+ * else valid
37
+ * Res->>S: retrieve(record.secretName, {}, context)
38
+ * activate S
39
+ * S-->>Res: secret payload
40
+ * deactivate S
41
+ * Res->>C: markCredentialUsed(credentialId, context)
42
+ * Res-->>N: string | record secret (never process.env)
43
+ * end
44
+ * end
45
+ */
46
+ import type { Context } from "@decaf-ts/core";
47
+ import type { GraphCredentialReference } from "../../shared/graph/index.d.mts";
48
+ import type { GraphResolvedCredentials } from "../types.d.mts";
49
+ /**
50
+ * The resolved credential payload handed to a node: a bare token/secret
51
+ * string, a JSON-shaped record the node re-parses per its credential format,
52
+ * or `undefined` when no reference exists and none is required.
53
+ */
54
+ export type GraphNodeCredentialSecret = string | Record<string, unknown> | undefined;
55
+ /** Structural view of a Phase A credential record the resolver reads. */
56
+ export interface GraphCredentialRecord {
57
+ id: string;
58
+ name: string;
59
+ credentialType: string;
60
+ /** Name of the secret held by the provider's secret service. */
61
+ secretName: string;
62
+ /** Secret provider backing the credential (`model` or `filesystem`). */
63
+ provider: string;
64
+ enabled?: boolean;
65
+ expiresAt?: Date | string | null;
66
+ tenantId?: string;
67
+ orgUnitId?: string;
68
+ ownerPrincipalId?: string;
69
+ }
70
+ /** Port over the namespaced credential service the resolver needs. */
71
+ export interface GraphCredentialServicePort {
72
+ getCredential(credentialId: string, ...args: any[]): Promise<GraphCredentialRecord>;
73
+ markCredentialUsed?(credentialId: string, ...args: any[]): Promise<unknown>;
74
+ }
75
+ /** Port over a secret service (model-backed or filesystem-backed). */
76
+ export interface GraphSecretServicePort {
77
+ readonly provider?: string;
78
+ retrieve(nameOrRef: string, options?: Record<string, unknown>, ...args: any[]): Promise<unknown>;
79
+ }
80
+ /** Host-supplied Phase A services the engine wires into the credential resolver. */
81
+ export interface GraphNodeCredentialServices {
82
+ credentialService: GraphCredentialServicePort;
83
+ modelSecretService: GraphSecretServicePort;
84
+ fsSecretService?: GraphSecretServicePort;
85
+ }
86
+ /**
87
+ * Resolves workflow credential references through ctx-bound Phase A
88
+ * credential/secret services.
89
+ *
90
+ * The engine constructs one resolver per execution from the host's
91
+ * {@link GraphNodeCredentialServices}; nodes reach it as
92
+ * `context.engine.nodeCredentials`. Every failure mode is fail-closed and
93
+ * typed: the `GRAPH_CREDENTIAL_*` strings in thrown errors are error codes,
94
+ * never environment-variable names.
95
+ */
96
+ export declare class GraphNodeCredentialResolver {
97
+ private readonly services;
98
+ constructor(services: GraphNodeCredentialServices);
99
+ /**
100
+ * Resolves one credential reference to its secret payload.
101
+ *
102
+ * @param reference - The credential reference declared by the node (absent when the node declared none).
103
+ * @param expectedType - Credential type the node accepts (e.g. `"github"`).
104
+ * @param required - Whether execution may proceed without a credential.
105
+ * @param nodeName - Human-readable node name used in error messages.
106
+ * @param context - Execution context forwarded to the credential and secret services for tenancy scoping.
107
+ * @returns The credential record's secret payload as a string or record; `undefined` when no reference exists and `required` is false.
108
+ * @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` (no reference, required),
109
+ * `GRAPH_CREDENTIAL_TYPE_MISMATCH` (declared/record type differs from `expectedType`),
110
+ * `GRAPH_CREDENTIAL_NOT_FOUND` (credential service lookup failed),
111
+ * `GRAPH_CREDENTIAL_DISABLED`, `GRAPH_CREDENTIAL_EXPIRED`,
112
+ * `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` (filesystem provider without a configured service), and
113
+ * `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` (provider other than `model`/`filesystem`).
114
+ */
115
+ resolve(reference: GraphCredentialReference | undefined, expectedType: string, required: boolean, nodeName: string, context?: Context): Promise<GraphNodeCredentialSecret>;
116
+ /**
117
+ * Picks the secret service backing the credential's provider.
118
+ *
119
+ * @param provider - Provider recorded on the credential (`model` or `filesystem`).
120
+ * @param nodeName - Human-readable node name used in error messages.
121
+ * @returns The secret service port for the provider.
122
+ * @throws {GraphExecutionError} with code `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the filesystem provider has no configured service, or `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED` for any other provider.
123
+ */
124
+ private secretServiceFor;
125
+ }
126
+ /**
127
+ * Resolves the credential reference registered under `id` for a node
128
+ * execution, through the ctx-bound resolver the executing engine carries.
129
+ *
130
+ * Convenience wrapper used by every migrated `src/node/**` executor: it reads
131
+ * the reference from `references`, obtains the engine's
132
+ * {@link GraphNodeCredentialResolver} from `context`, and delegates. There is
133
+ * deliberately no environment fallback — without a configured engine resolver
134
+ * the node fails closed.
135
+ *
136
+ * @param context - The node execution context carrying the engine reference; may be `undefined` in legacy call sites.
137
+ * @param references - Credential references resolved by the engine for this run.
138
+ * @param expectedType - Credential type the node accepts (e.g. `"sftp"`).
139
+ * @param required - Whether execution may proceed without any credential.
140
+ * @param nodeName - Human-readable node name used in error messages.
141
+ * @param id - Handle under which the reference was registered (default `"credentialRef"`).
142
+ * @returns The resolved secret (string or record), or `undefined` when no reference exists and `required` is false.
143
+ * @throws {GraphExecutionError} with codes `GRAPH_CREDENTIAL_MISSING` when no reference exists and `required` is true, `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` when the engine carries no credential resolver, and the `GRAPH_CREDENTIAL_*` codes propagated from {@link GraphNodeCredentialResolver.resolve}.
144
+ */
145
+ export declare function resolveNodeCredential(context: Context | undefined, references: GraphResolvedCredentials, expectedType: string, required: boolean, nodeName: string, id?: string): Promise<GraphNodeCredentialSecret>;
@@ -18,6 +18,7 @@
18
18
  */
19
19
  import { Adapter, ClientBasedService, type Context, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
20
20
  import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
21
+ import { GraphNodeCredentialResolver, type GraphNodeCredentialServices } from "../credentials/GraphNodeCredentials.d.cts";
21
22
  import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.cts";
22
23
  import type { GraphExecutionObserver } from "../events/GraphExecutionObserver.d.cts";
23
24
  import { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.cts";
@@ -26,9 +27,11 @@ import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.cts";
26
27
  import { GraphExecutionPlanner } from "../planning/GraphExecutionPlanner.d.cts";
27
28
  import { GraphWorkflowDocumentValidator, type GraphWorkflowDocumentValidationLimits } from "../validation/GraphWorkflowDocumentValidator.d.cts";
28
29
  import type { GraphCredentialAuthorizer } from "../validation/GraphCredentialReferenceValidator.d.cts";
30
+ import { GraphWebhookResponseRegistry } from "./GraphWebhookResponseRegistry.d.cts";
31
+ import { type GraphDataTableRepository } from "../store/GraphDataTableRepository.d.cts";
29
32
  import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
30
33
  import { type GraphBackendCapabilities, type GraphBackendWorkflowStore, type GraphBackendWorkflowSummary, type GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
31
- import { GraphAuthValidator, type GraphNamespaceMatchOptions } from "../auth/index.d.cts";
34
+ import { GraphAuthValidator, graphAuthDataOf, type GraphNamespaceMatchOptions } from "../auth/index.d.cts";
32
35
  /**
33
36
  * Strips facade-owned keys from a backend's retained configuration that the facade
34
37
  * did not itself set (defense in depth). A backend's `config` getter may derive
@@ -119,6 +122,13 @@ export interface GraphExecutionEngineConfig {
119
122
  * sub-workflows through the same engine).
120
123
  */
121
124
  onEngineCreated?: (engine: GraphExecutionEngine) => void | Promise<void>;
125
+ /**
126
+ * Ctx-bound credential services every node kind resolves its credential
127
+ * references through. The host supplies the undecorated integration
128
+ * service instances booted with explicit configuration; node execution never
129
+ * reads secrets from the Environment.
130
+ */
131
+ nodeCredentials?: GraphNodeCredentialServices;
122
132
  }
123
133
  /**
124
134
  * Runtime collaborators resolved by {@link GraphExecutionEngine.initialize}.
@@ -142,6 +152,8 @@ export interface GraphExecutionEngineClient {
142
152
  authValidator: GraphAuthValidator;
143
153
  /** Optional pluggable code sandbox evaluator. */
144
154
  codeSandboxEvaluator?: CodeSandboxEvaluator;
155
+ /** Ctx-bound credential resolver, when the host configured credential services. */
156
+ nodeCredentials?: GraphNodeCredentialResolver;
145
157
  }
146
158
  /**
147
159
  * Reference graph execution engine.
@@ -184,6 +196,50 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
184
196
  }>;
185
197
  /** Pluggable code sandbox evaluator (§22.4); may be undefined. */
186
198
  get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
199
+ /**
200
+ * The ctx-bound credential resolver configured by the host.
201
+ *
202
+ * Nodes resolve credential references only through this resolver, which
203
+ * forwards the execution context to the namespaced `CredentialService` and
204
+ * the model/filesystem secret services, so RLS scoping is enforced.
205
+ */
206
+ get nodeCredentials(): GraphNodeCredentialResolver | undefined;
207
+ /** Lazily-bound data-table repository backing {@linkcode GraphExecutionEngine.dataTableStore}. */
208
+ private dataTableRepository?;
209
+ /** Registry instance backing {@linkcode GraphExecutionEngine.webhookResponses}. */
210
+ private readonly webhookResponseRegistry;
211
+ /** Sub-workflow depth of each in-flight run, used by the depth guard. */
212
+ private readonly runSubWorkflowDepth;
213
+ /** Root run id of each in-flight run, used by the child-run budget. */
214
+ private readonly runRootId;
215
+ /** Sub-workflow child-run count per root run. */
216
+ private readonly rootChildRunCounts;
217
+ /**
218
+ * Cross-run data-table persistence for the `core.data.dataTable` kind.
219
+ *
220
+ * The repository is created lazily on first access and bound to the
221
+ * engine's value adapter via `createGraphDataTableRepository`, so data-table
222
+ * rows live in the same adapter (and flavour behaviour) as workflow values
223
+ * but survive their originating run. Data-table nodes resolve the store
224
+ * through `context.engine?.dataTableStore` and fail closed with
225
+ * `GRAPH_ENGINE_NOT_AVAILABLE` when the engine is absent.
226
+ *
227
+ * @returns The data-table repository for this engine.
228
+ */
229
+ get dataTableStore(): GraphDataTableRepository;
230
+ /**
231
+ * Run-keyed webhook response correlation for the `core.io.respondToWebhook`
232
+ * kind.
233
+ *
234
+ * One registry instance is owned per engine for its lifetime: a
235
+ * webhook-triggered run awaits `register(runId, timeoutMs)` while the
236
+ * Respond to Webhook node resolves it through
237
+ * `deliver(context.runId, response)`. Consumers treat `webhookResponses` as
238
+ * the engine-owned correlation point rather than building their own.
239
+ *
240
+ * @returns The engine's webhook response registry.
241
+ */
242
+ get webhookResponses(): GraphWebhookResponseRegistry;
187
243
  private get emitter();
188
244
  private get planner();
189
245
  private get valueAdapter();
@@ -262,6 +318,22 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
262
318
  * when the active backend declares no lookup support.
263
319
  */
264
320
  getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
321
+ /**
322
+ * Applies the engine's workflow-level read authorization to a document that
323
+ * was resolved through the workflow catalogue seam.
324
+ *
325
+ * Ownership is enforced by the persistence store's own read path; this adds
326
+ * the namespace/role check for the resolved document when graph auth is
327
+ * enabled, so a sub-workflow lookup cannot read a namespace-scoped document
328
+ * the caller is not entitled to.
329
+ *
330
+ * @param document - The resolved canonical workflow document.
331
+ * @param auth - The caller's authenticated principal facts.
332
+ * @param logger - Optional run-scoped logger for the denial audit line.
333
+ * @throws {ForbiddenError} when the document's workflow-level namespace/role
334
+ * requirements are not granted.
335
+ */
336
+ assertWorkflowReadAccess(document: GraphWorkflowDocument, auth: ReturnType<typeof graphAuthDataOf>, logger?: Parameters<GraphAuthValidator["validateWorkflowRead"]>[2]): void;
265
337
  /**
266
338
  * Lists the workflows a *specific* registered backend can surface, resolved by
267
339
  * flavour. This is the flavour-scoped counterpart of {@link listWorkflows}: the
@@ -330,6 +402,21 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
330
402
  */
331
403
  private mergeOptions;
332
404
  private assertNotAborted;
405
+ /**
406
+ * Registers a run in the sub-workflow depth/child-budget bookkeeping and
407
+ * fails closed when either bound would be exceeded.
408
+ *
409
+ * Depth is inherited through the `parentRunId` chain and only increments when
410
+ * the execution itself is a `subworkflow` edge (the last path segment), so
411
+ * loop bodies remain governed by their iteration caps. The child-run budget
412
+ * is tracked per root run and increments for every sub-workflow child.
413
+ */
414
+ private enterExecutionBudget;
415
+ /**
416
+ * Releases a finished run's depth/root bookkeeping. The root's child count is
417
+ * removed only when the root itself finishes, after all descendants.
418
+ */
419
+ private releaseExecutionBudget;
333
420
  /**
334
421
  * Generates a cryptographically random run id. `crypto.randomUUID` is always
335
422
  * available in the backend runtimes as-graph targets; the frontend never
@@ -18,6 +18,7 @@
18
18
  */
19
19
  import { Adapter, ClientBasedService, type Context, type ContextualArgs, type MaybeContextualArg } from "@decaf-ts/core";
20
20
  import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
21
+ import { GraphNodeCredentialResolver, type GraphNodeCredentialServices } from "../credentials/GraphNodeCredentials.d.mts";
21
22
  import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.mts";
22
23
  import type { GraphExecutionObserver } from "../events/GraphExecutionObserver.d.mts";
23
24
  import { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.mts";
@@ -26,9 +27,11 @@ import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.mts";
26
27
  import { GraphExecutionPlanner } from "../planning/GraphExecutionPlanner.d.mts";
27
28
  import { GraphWorkflowDocumentValidator, type GraphWorkflowDocumentValidationLimits } from "../validation/GraphWorkflowDocumentValidator.d.mts";
28
29
  import type { GraphCredentialAuthorizer } from "../validation/GraphCredentialReferenceValidator.d.mts";
30
+ import { GraphWebhookResponseRegistry } from "./GraphWebhookResponseRegistry.d.mts";
31
+ import { type GraphDataTableRepository } from "../store/GraphDataTableRepository.d.mts";
29
32
  import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
30
33
  import { type GraphBackendCapabilities, type GraphBackendWorkflowStore, type GraphBackendWorkflowSummary, type GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
31
- import { GraphAuthValidator, type GraphNamespaceMatchOptions } from "../auth/index.d.mts";
34
+ import { GraphAuthValidator, graphAuthDataOf, type GraphNamespaceMatchOptions } from "../auth/index.d.mts";
32
35
  /**
33
36
  * Strips facade-owned keys from a backend's retained configuration that the facade
34
37
  * did not itself set (defense in depth). A backend's `config` getter may derive
@@ -119,6 +122,13 @@ export interface GraphExecutionEngineConfig {
119
122
  * sub-workflows through the same engine).
120
123
  */
121
124
  onEngineCreated?: (engine: GraphExecutionEngine) => void | Promise<void>;
125
+ /**
126
+ * Ctx-bound credential services every node kind resolves its credential
127
+ * references through. The host supplies the undecorated integration
128
+ * service instances booted with explicit configuration; node execution never
129
+ * reads secrets from the Environment.
130
+ */
131
+ nodeCredentials?: GraphNodeCredentialServices;
122
132
  }
123
133
  /**
124
134
  * Runtime collaborators resolved by {@link GraphExecutionEngine.initialize}.
@@ -142,6 +152,8 @@ export interface GraphExecutionEngineClient {
142
152
  authValidator: GraphAuthValidator;
143
153
  /** Optional pluggable code sandbox evaluator. */
144
154
  codeSandboxEvaluator?: CodeSandboxEvaluator;
155
+ /** Ctx-bound credential resolver, when the host configured credential services. */
156
+ nodeCredentials?: GraphNodeCredentialResolver;
145
157
  }
146
158
  /**
147
159
  * Reference graph execution engine.
@@ -184,6 +196,50 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
184
196
  }>;
185
197
  /** Pluggable code sandbox evaluator (§22.4); may be undefined. */
186
198
  get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
199
+ /**
200
+ * The ctx-bound credential resolver configured by the host.
201
+ *
202
+ * Nodes resolve credential references only through this resolver, which
203
+ * forwards the execution context to the namespaced `CredentialService` and
204
+ * the model/filesystem secret services, so RLS scoping is enforced.
205
+ */
206
+ get nodeCredentials(): GraphNodeCredentialResolver | undefined;
207
+ /** Lazily-bound data-table repository backing {@linkcode GraphExecutionEngine.dataTableStore}. */
208
+ private dataTableRepository?;
209
+ /** Registry instance backing {@linkcode GraphExecutionEngine.webhookResponses}. */
210
+ private readonly webhookResponseRegistry;
211
+ /** Sub-workflow depth of each in-flight run, used by the depth guard. */
212
+ private readonly runSubWorkflowDepth;
213
+ /** Root run id of each in-flight run, used by the child-run budget. */
214
+ private readonly runRootId;
215
+ /** Sub-workflow child-run count per root run. */
216
+ private readonly rootChildRunCounts;
217
+ /**
218
+ * Cross-run data-table persistence for the `core.data.dataTable` kind.
219
+ *
220
+ * The repository is created lazily on first access and bound to the
221
+ * engine's value adapter via `createGraphDataTableRepository`, so data-table
222
+ * rows live in the same adapter (and flavour behaviour) as workflow values
223
+ * but survive their originating run. Data-table nodes resolve the store
224
+ * through `context.engine?.dataTableStore` and fail closed with
225
+ * `GRAPH_ENGINE_NOT_AVAILABLE` when the engine is absent.
226
+ *
227
+ * @returns The data-table repository for this engine.
228
+ */
229
+ get dataTableStore(): GraphDataTableRepository;
230
+ /**
231
+ * Run-keyed webhook response correlation for the `core.io.respondToWebhook`
232
+ * kind.
233
+ *
234
+ * One registry instance is owned per engine for its lifetime: a
235
+ * webhook-triggered run awaits `register(runId, timeoutMs)` while the
236
+ * Respond to Webhook node resolves it through
237
+ * `deliver(context.runId, response)`. Consumers treat `webhookResponses` as
238
+ * the engine-owned correlation point rather than building their own.
239
+ *
240
+ * @returns The engine's webhook response registry.
241
+ */
242
+ get webhookResponses(): GraphWebhookResponseRegistry;
187
243
  private get emitter();
188
244
  private get planner();
189
245
  private get valueAdapter();
@@ -262,6 +318,22 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
262
318
  * when the active backend declares no lookup support.
263
319
  */
264
320
  getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
321
+ /**
322
+ * Applies the engine's workflow-level read authorization to a document that
323
+ * was resolved through the workflow catalogue seam.
324
+ *
325
+ * Ownership is enforced by the persistence store's own read path; this adds
326
+ * the namespace/role check for the resolved document when graph auth is
327
+ * enabled, so a sub-workflow lookup cannot read a namespace-scoped document
328
+ * the caller is not entitled to.
329
+ *
330
+ * @param document - The resolved canonical workflow document.
331
+ * @param auth - The caller's authenticated principal facts.
332
+ * @param logger - Optional run-scoped logger for the denial audit line.
333
+ * @throws {ForbiddenError} when the document's workflow-level namespace/role
334
+ * requirements are not granted.
335
+ */
336
+ assertWorkflowReadAccess(document: GraphWorkflowDocument, auth: ReturnType<typeof graphAuthDataOf>, logger?: Parameters<GraphAuthValidator["validateWorkflowRead"]>[2]): void;
265
337
  /**
266
338
  * Lists the workflows a *specific* registered backend can surface, resolved by
267
339
  * flavour. This is the flavour-scoped counterpart of {@link listWorkflows}: the
@@ -330,6 +402,21 @@ export declare class GraphExecutionEngine extends ClientBasedService<GraphExecut
330
402
  */
331
403
  private mergeOptions;
332
404
  private assertNotAborted;
405
+ /**
406
+ * Registers a run in the sub-workflow depth/child-budget bookkeeping and
407
+ * fails closed when either bound would be exceeded.
408
+ *
409
+ * Depth is inherited through the `parentRunId` chain and only increments when
410
+ * the execution itself is a `subworkflow` edge (the last path segment), so
411
+ * loop bodies remain governed by their iteration caps. The child-run budget
412
+ * is tracked per root run and increments for every sub-workflow child.
413
+ */
414
+ private enterExecutionBudget;
415
+ /**
416
+ * Releases a finished run's depth/root bookkeeping. The root's child count is
417
+ * removed only when the root itself finishes, after all descendants.
418
+ */
419
+ private releaseExecutionBudget;
333
420
  /**
334
421
  * Generates a cryptographically random run id. `crypto.randomUUID` is always
335
422
  * available in the backend runtimes as-graph targets; the frontend never
@@ -0,0 +1,24 @@
1
+ /**
2
+ * @module as-graph/engine/execution/GraphNodeEngineRequirements
3
+ * @summary Which node kinds require a specific execution engine (SAA-837 M1).
4
+ * @description Single authority for the kind-level capability boundary the
5
+ * acceptance criteria describe: the mastra AI family (`core.agent` and its
6
+ * `core.agent.*` sub-kinds — tools, hooks, skills, sandbox, scorers) only runs on
7
+ * the mastra backend. The general (local) engine consults this to fail closed
8
+ * instead of executing a registered placeholder for an AI kind it cannot run.
9
+ * Kept engine-private; node manifests keep declaring their own traits.
10
+ */
11
+ /**
12
+ * Kind prefix of the mastra AI family. `core.agent` itself (the agent node) and
13
+ * every `core.agent.*` family kind require the mastra engine.
14
+ */
15
+ export declare const GRAPH_MASTRA_ONLY_KIND_PREFIX = "core.agent";
16
+ /**
17
+ * Whether a node kind requires the mastra engine. The agent node (`core.agent`)
18
+ * and its family kinds (`core.agent.tool`, `core.agent.scorer`, …) return
19
+ * `true`; every general-engine structural/utility/flow kind returns `false`.
20
+ *
21
+ * @param kind - The node kind discriminator.
22
+ * @returns `true` when only the mastra engine can execute the kind.
23
+ */
24
+ export declare function graphNodeRequiresMastraEngine(kind: string): boolean;
@@ -0,0 +1,24 @@
1
+ /**
2
+ * @module as-graph/engine/execution/GraphNodeEngineRequirements
3
+ * @summary Which node kinds require a specific execution engine (SAA-837 M1).
4
+ * @description Single authority for the kind-level capability boundary the
5
+ * acceptance criteria describe: the mastra AI family (`core.agent` and its
6
+ * `core.agent.*` sub-kinds — tools, hooks, skills, sandbox, scorers) only runs on
7
+ * the mastra backend. The general (local) engine consults this to fail closed
8
+ * instead of executing a registered placeholder for an AI kind it cannot run.
9
+ * Kept engine-private; node manifests keep declaring their own traits.
10
+ */
11
+ /**
12
+ * Kind prefix of the mastra AI family. `core.agent` itself (the agent node) and
13
+ * every `core.agent.*` family kind require the mastra engine.
14
+ */
15
+ export declare const GRAPH_MASTRA_ONLY_KIND_PREFIX = "core.agent";
16
+ /**
17
+ * Whether a node kind requires the mastra engine. The agent node (`core.agent`)
18
+ * and its family kinds (`core.agent.tool`, `core.agent.scorer`, …) return
19
+ * `true`; every general-engine structural/utility/flow kind returns `false`.
20
+ *
21
+ * @param kind - The node kind discriminator.
22
+ * @returns `true` when only the mastra engine can execute the kind.
23
+ */
24
+ export declare function graphNodeRequiresMastraEngine(kind: string): boolean;