@decaf-ts/as-graph 0.6.0 → 0.8.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 (1262) hide show
  1. package/README.md +857 -27
  2. package/assets/i18n/en.json +3899 -15
  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/dagster/DagsterGraphExecutionBackend.cjs +13 -0
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
  9. package/lib/cjs/dagster/capabilities.cjs +5 -0
  10. package/lib/cjs/dagster/capabilities.cjs.map +1 -1
  11. package/lib/cjs/engine/auth/GraphAuthValidator.cjs +19 -0
  12. package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
  13. package/lib/cjs/engine/constants.cjs +61 -1
  14. package/lib/cjs/engine/constants.cjs.map +1 -1
  15. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
  16. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
  17. package/lib/cjs/engine/execution/GraphCodeMode.cjs +42 -0
  18. package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -1
  19. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +263 -71
  20. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  21. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
  22. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
  23. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
  24. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
  25. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +53 -1
  26. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
  27. package/lib/cjs/engine/execution/index.cjs +1 -0
  28. package/lib/cjs/engine/execution/index.cjs.map +1 -1
  29. package/lib/cjs/engine/index.cjs +4 -0
  30. package/lib/cjs/engine/index.cjs.map +1 -1
  31. package/lib/cjs/engine/store/GraphDataTableModel.cjs +76 -0
  32. package/lib/cjs/engine/store/GraphDataTableModel.cjs.map +1 -0
  33. package/lib/cjs/engine/store/GraphDataTableRepository.cjs +324 -0
  34. package/lib/cjs/engine/store/GraphDataTableRepository.cjs.map +1 -0
  35. package/lib/cjs/engine/store/index.cjs +2 -0
  36. package/lib/cjs/engine/store/index.cjs.map +1 -1
  37. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs +28 -0
  38. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs.map +1 -1
  39. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs +4 -2
  40. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs.map +1 -1
  41. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs +29 -1
  42. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs.map +1 -1
  43. package/lib/cjs/engine/validation/GraphParameterValidator.cjs +6 -0
  44. package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
  45. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs +6 -2
  46. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs.map +1 -1
  47. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
  48. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
  49. package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
  50. package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
  51. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
  52. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
  53. package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
  54. package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
  55. package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
  56. package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
  57. package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
  58. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
  59. package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
  60. package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
  61. package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
  62. package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
  63. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +240 -22
  64. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -1
  65. package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
  66. package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
  67. package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
  68. package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
  69. package/lib/cjs/mastra/MastraEventBridge.cjs +21 -1
  70. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
  71. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +414 -19
  72. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
  73. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
  74. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
  75. package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
  76. package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
  77. package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
  78. package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
  79. package/lib/cjs/mastra/MastraMemory.cjs +467 -0
  80. package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
  81. package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
  82. package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
  83. package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
  84. package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
  85. package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
  86. package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
  87. package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
  88. package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
  89. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
  90. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
  91. package/lib/cjs/mastra/MastraObservability.cjs +335 -0
  92. package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
  93. package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
  94. package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
  95. package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
  96. package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
  97. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
  98. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
  99. package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
  100. package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
  101. package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
  102. package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
  103. package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
  104. package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
  105. package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
  106. package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
  107. package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
  108. package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
  109. package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
  110. package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
  111. package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
  112. package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
  113. package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
  114. package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
  115. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
  116. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
  117. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +79 -15
  118. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  119. package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
  120. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
  121. package/lib/cjs/mastra/index.cjs +40 -1
  122. package/lib/cjs/mastra/index.cjs.map +1 -1
  123. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
  124. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
  125. package/lib/cjs/mastra/nodes/index.cjs +29 -0
  126. package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
  127. package/lib/cjs/mastra/nodes/types.cjs +4 -0
  128. package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
  129. package/lib/cjs/mastra/types.cjs +126 -1
  130. package/lib/cjs/mastra/types.cjs.map +1 -1
  131. package/lib/cjs/nest/graph/GraphBackendHost.cjs +12 -4
  132. package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
  133. package/lib/cjs/nest/graph/GraphEngineController.cjs +18 -0
  134. package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -1
  135. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +35 -1
  136. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  137. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs +14 -0
  138. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs.map +1 -1
  139. package/lib/cjs/nest/graph/GraphRunController.cjs +64 -6
  140. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  141. package/lib/cjs/nest/graph/GraphWorkflowController.cjs +34 -5
  142. package/lib/cjs/nest/graph/GraphWorkflowController.cjs.map +1 -1
  143. package/lib/cjs/nest/graph/main.cjs +83 -1
  144. package/lib/cjs/nest/graph/main.cjs.map +1 -1
  145. package/lib/cjs/node/agents/agent/node.cjs +189 -31
  146. package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
  147. package/lib/cjs/node/agents/hitl/node.cjs +115 -0
  148. package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
  149. package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
  150. package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
  151. package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
  152. package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
  153. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
  154. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
  155. package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
  156. package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
  157. package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
  158. package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
  159. package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
  160. package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
  161. package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
  162. package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
  163. package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
  164. package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
  165. package/lib/cjs/node/agents/processors/types.cjs +68 -0
  166. package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
  167. package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
  168. package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
  169. package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
  170. package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
  171. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
  172. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
  173. package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
  174. package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
  175. package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
  176. package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
  177. package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
  178. package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
  179. package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
  180. package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
  181. package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
  182. package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
  183. package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
  184. package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
  185. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
  186. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
  187. package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
  188. package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
  189. package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
  190. package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
  191. package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
  192. package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
  193. package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
  194. package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
  195. package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
  196. package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
  197. package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
  198. package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
  199. package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
  200. package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
  201. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
  202. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
  203. package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
  204. package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
  205. package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
  206. package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
  207. package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
  208. package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
  209. package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
  210. package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
  211. package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
  212. package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
  213. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
  214. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
  215. package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
  216. package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
  217. package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
  218. package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
  219. package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
  220. package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
  221. package/lib/cjs/node/agents/voice/node.cjs +107 -0
  222. package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
  223. package/lib/cjs/node/agents/zones.cjs +43 -0
  224. package/lib/cjs/node/agents/zones.cjs.map +1 -0
  225. package/lib/cjs/node/comms/discord/node.cjs +384 -0
  226. package/lib/cjs/node/comms/discord/node.cjs.map +1 -0
  227. package/lib/cjs/node/comms/email-send/node.cjs +340 -0
  228. package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
  229. package/lib/cjs/node/comms/gmail/node.cjs +287 -0
  230. package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
  231. package/lib/cjs/node/comms/outlook/node.cjs +395 -0
  232. package/lib/cjs/node/comms/outlook/node.cjs.map +1 -0
  233. package/lib/cjs/node/comms/slack/node.cjs +276 -0
  234. package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
  235. package/lib/cjs/node/comms/teams/node.cjs +231 -0
  236. package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
  237. package/lib/cjs/node/comms/telegram/node.cjs +260 -0
  238. package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
  239. package/lib/cjs/node/comms/whatsapp/node.cjs +341 -0
  240. package/lib/cjs/node/comms/whatsapp/node.cjs.map +1 -0
  241. package/lib/cjs/node/credentials.cjs +103 -0
  242. package/lib/cjs/node/credentials.cjs.map +1 -0
  243. package/lib/cjs/node/data/aggregate/node.cjs +196 -0
  244. package/lib/cjs/node/data/aggregate/node.cjs.map +1 -0
  245. package/lib/cjs/node/data/compare-datasets/node.cjs +331 -0
  246. package/lib/cjs/node/data/compare-datasets/node.cjs.map +1 -0
  247. package/lib/cjs/node/data/data-table/node.cjs +265 -0
  248. package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
  249. package/lib/cjs/node/data/date-time/node.cjs +180 -0
  250. package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
  251. package/lib/cjs/node/data/filter/node.cjs +134 -0
  252. package/lib/cjs/node/data/filter/node.cjs.map +1 -0
  253. package/lib/cjs/node/data/item-lists/node.cjs +416 -0
  254. package/lib/cjs/node/data/item-lists/node.cjs.map +1 -0
  255. package/lib/cjs/node/data/limit/node.cjs +104 -0
  256. package/lib/cjs/node/data/limit/node.cjs.map +1 -0
  257. package/lib/cjs/node/data/merge/node.cjs +251 -0
  258. package/lib/cjs/node/data/merge/node.cjs.map +1 -0
  259. package/lib/cjs/node/data/remove-duplicates/node.cjs +141 -0
  260. package/lib/cjs/node/data/remove-duplicates/node.cjs.map +1 -0
  261. package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
  262. package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
  263. package/lib/cjs/node/data/set/node.cjs +148 -0
  264. package/lib/cjs/node/data/set/node.cjs.map +1 -0
  265. package/lib/cjs/node/data/sort/node.cjs +125 -0
  266. package/lib/cjs/node/data/sort/node.cjs.map +1 -0
  267. package/lib/cjs/node/data/split-out/node.cjs +140 -0
  268. package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
  269. package/lib/cjs/node/data/summarize/node.cjs +155 -0
  270. package/lib/cjs/node/data/summarize/node.cjs.map +1 -0
  271. package/lib/cjs/node/data/support.cjs +403 -0
  272. package/lib/cjs/node/data/support.cjs.map +1 -0
  273. package/lib/cjs/node/data/transform-utils.cjs +719 -0
  274. package/lib/cjs/node/data/transform-utils.cjs.map +1 -0
  275. package/lib/cjs/node/devops/crypto/node.cjs +364 -0
  276. package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
  277. package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
  278. package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
  279. package/lib/cjs/node/devops/ftp/node.cjs +241 -0
  280. package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
  281. package/lib/cjs/node/devops/github/node.cjs +282 -0
  282. package/lib/cjs/node/devops/github/node.cjs.map +1 -0
  283. package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
  284. package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
  285. package/lib/cjs/node/devops/jwt/node.cjs +204 -0
  286. package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
  287. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
  288. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
  289. package/lib/cjs/node/index.cjs +508 -66
  290. package/lib/cjs/node/index.cjs.map +1 -1
  291. package/lib/cjs/node/io/airtable/node.cjs +318 -0
  292. package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
  293. package/lib/cjs/node/io/confluence/node.cjs +253 -0
  294. package/lib/cjs/node/io/confluence/node.cjs.map +1 -0
  295. package/lib/cjs/node/io/convert-to-file/node.cjs +349 -0
  296. package/lib/cjs/node/io/convert-to-file/node.cjs.map +1 -0
  297. package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
  298. package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
  299. package/lib/cjs/node/io/file-support.cjs +311 -0
  300. package/lib/cjs/node/io/file-support.cjs.map +1 -0
  301. package/lib/cjs/node/io/google-calendar/node.cjs +359 -0
  302. package/lib/cjs/node/io/google-calendar/node.cjs.map +1 -0
  303. package/lib/cjs/node/io/google-docs/node.cjs +272 -0
  304. package/lib/cjs/node/io/google-docs/node.cjs.map +1 -0
  305. package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
  306. package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
  307. package/lib/cjs/node/io/graphql/node.cjs +169 -0
  308. package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
  309. package/lib/cjs/node/io/html/node.cjs +275 -0
  310. package/lib/cjs/node/io/html/node.cjs.map +1 -0
  311. package/lib/cjs/node/io/html-extract/node.cjs +162 -0
  312. package/lib/cjs/node/io/html-extract/node.cjs.map +1 -0
  313. package/lib/cjs/node/io/html-support.cjs +246 -0
  314. package/lib/cjs/node/io/html-support.cjs.map +1 -0
  315. package/lib/cjs/node/io/http-request/node.cjs +415 -0
  316. package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
  317. package/lib/cjs/node/io/jira/node.cjs +351 -0
  318. package/lib/cjs/node/io/jira/node.cjs.map +1 -0
  319. package/lib/cjs/node/io/markdown/node.cjs +229 -0
  320. package/lib/cjs/node/io/markdown/node.cjs.map +1 -0
  321. package/lib/cjs/node/io/microsoft-excel/node.cjs +261 -0
  322. package/lib/cjs/node/io/microsoft-excel/node.cjs.map +1 -0
  323. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs +274 -0
  324. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs.map +1 -0
  325. package/lib/cjs/node/io/read-binary-file/node.cjs +114 -0
  326. package/lib/cjs/node/io/read-binary-file/node.cjs.map +1 -0
  327. package/lib/cjs/node/io/read-binary-files/node.cjs +113 -0
  328. package/lib/cjs/node/io/read-binary-files/node.cjs.map +1 -0
  329. package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
  330. package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
  331. package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
  332. package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
  333. package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
  334. package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
  335. package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
  336. package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
  337. package/lib/cjs/node/io/write-binary-file/node.cjs +164 -0
  338. package/lib/cjs/node/io/write-binary-file/node.cjs.map +1 -0
  339. package/lib/cjs/node/io/xml/node.cjs +322 -0
  340. package/lib/cjs/node/io/xml/node.cjs.map +1 -0
  341. package/lib/cjs/node/manifests.cjs +322 -36
  342. package/lib/cjs/node/manifests.cjs.map +1 -1
  343. package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
  344. package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
  345. package/lib/cjs/node/storage/blob/base.cjs +321 -0
  346. package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
  347. package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
  348. package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
  349. package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
  350. package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
  351. package/lib/cjs/node/storage/database/base.cjs +301 -0
  352. package/lib/cjs/node/storage/database/base.cjs.map +1 -0
  353. package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
  354. package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
  355. package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
  356. package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
  357. package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
  358. package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
  359. package/lib/cjs/node/storage/rabbitmq/node.cjs +252 -0
  360. package/lib/cjs/node/storage/rabbitmq/node.cjs.map +1 -0
  361. package/lib/cjs/node/storage/redis/node.cjs +340 -0
  362. package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
  363. package/lib/cjs/node/storage/support.cjs +81 -0
  364. package/lib/cjs/node/storage/support.cjs.map +1 -0
  365. package/lib/cjs/node/triggers/error/node.cjs +108 -0
  366. package/lib/cjs/node/triggers/error/node.cjs.map +1 -0
  367. package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
  368. package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
  369. package/lib/cjs/node/triggers/postgres/node.cjs +244 -0
  370. package/lib/cjs/node/triggers/postgres/node.cjs.map +1 -0
  371. package/lib/cjs/node/triggers/rabbitmq/node.cjs +284 -0
  372. package/lib/cjs/node/triggers/rabbitmq/node.cjs.map +1 -0
  373. package/lib/cjs/node/triggers/redis/node.cjs +233 -0
  374. package/lib/cjs/node/triggers/redis/node.cjs.map +1 -0
  375. package/lib/cjs/node/triggers/sse/node.cjs +196 -0
  376. package/lib/cjs/node/triggers/sse/node.cjs.map +1 -0
  377. package/lib/cjs/node/triggers/support.cjs +107 -0
  378. package/lib/cjs/node/triggers/support.cjs.map +1 -0
  379. package/lib/cjs/node/triggers/workflow/node.cjs +193 -0
  380. package/lib/cjs/node/triggers/workflow/node.cjs.map +1 -0
  381. package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
  382. package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
  383. package/lib/cjs/shared/graph/GraphNodeModel.cjs +4 -0
  384. package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -1
  385. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
  386. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
  387. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
  388. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  389. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs +20 -3
  390. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs.map +1 -1
  391. package/lib/cjs/shared/graph/category-styles.cjs +12 -0
  392. package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
  393. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
  394. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
  395. package/lib/cjs/typeorm/index.cjs +29 -0
  396. package/lib/cjs/typeorm/index.cjs.map +1 -0
  397. package/lib/cjs/workflows/boundary-value.workflow.cjs +38 -0
  398. package/lib/cjs/workflows/boundary-value.workflow.cjs.map +1 -0
  399. package/lib/cjs/workflows/builders.cjs +47 -0
  400. package/lib/cjs/workflows/builders.cjs.map +1 -0
  401. package/lib/cjs/workflows/chat-agent.workflow.cjs +40 -0
  402. package/lib/cjs/workflows/chat-agent.workflow.cjs.map +1 -0
  403. package/lib/cjs/workflows/error-boundary.workflow.cjs +54 -0
  404. package/lib/cjs/workflows/error-boundary.workflow.cjs.map +1 -0
  405. package/lib/cjs/workflows/event-map.workflow.cjs +37 -0
  406. package/lib/cjs/workflows/event-map.workflow.cjs.map +1 -0
  407. package/lib/cjs/workflows/foreach-break.workflow.cjs +58 -0
  408. package/lib/cjs/workflows/foreach-break.workflow.cjs.map +1 -0
  409. package/lib/cjs/workflows/human-approval.workflow.cjs +44 -0
  410. package/lib/cjs/workflows/human-approval.workflow.cjs.map +1 -0
  411. package/lib/cjs/workflows/if-switch.workflow.cjs +66 -0
  412. package/lib/cjs/workflows/if-switch.workflow.cjs.map +1 -0
  413. package/lib/cjs/workflows/index.cjs +135 -0
  414. package/lib/cjs/workflows/index.cjs.map +1 -0
  415. package/lib/cjs/workflows/loops-while-until.workflow.cjs +76 -0
  416. package/lib/cjs/workflows/loops-while-until.workflow.cjs.map +1 -0
  417. package/lib/cjs/workflows/manual-log.workflow.cjs +52 -0
  418. package/lib/cjs/workflows/manual-log.workflow.cjs.map +1 -0
  419. package/lib/cjs/workflows/schedule-code.workflow.cjs +42 -0
  420. package/lib/cjs/workflows/schedule-code.workflow.cjs.map +1 -0
  421. package/lib/cjs/workflows/types.cjs +4 -0
  422. package/lib/cjs/workflows/types.cjs.map +1 -0
  423. package/lib/cjs/workflows/value-templates.workflow.cjs +43 -0
  424. package/lib/cjs/workflows/value-templates.workflow.cjs.map +1 -0
  425. package/lib/cjs/workflows/webhook-form.workflow.cjs +48 -0
  426. package/lib/cjs/workflows/webhook-form.workflow.cjs.map +1 -0
  427. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +13 -0
  428. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
  429. package/lib/esm/dagster/capabilities.js +5 -0
  430. package/lib/esm/dagster/capabilities.js.map +1 -1
  431. package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
  432. package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
  433. package/lib/esm/engine/constants.js +60 -0
  434. package/lib/esm/engine/constants.js.map +1 -1
  435. package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
  436. package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
  437. package/lib/esm/engine/execution/GraphCodeMode.js +40 -0
  438. package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -1
  439. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
  440. package/lib/esm/engine/execution/GraphExecutionEngine.js +265 -73
  441. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  442. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
  443. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
  444. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
  445. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
  446. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +54 -2
  447. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
  448. package/lib/esm/engine/execution/index.js +1 -0
  449. package/lib/esm/engine/execution/index.js.map +1 -1
  450. package/lib/esm/engine/index.js +4 -0
  451. package/lib/esm/engine/index.js.map +1 -1
  452. package/lib/esm/engine/store/GraphDataTableModel.js +67 -0
  453. package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
  454. package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
  455. package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
  456. package/lib/esm/engine/store/index.js +2 -0
  457. package/lib/esm/engine/store/index.js.map +1 -1
  458. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
  459. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
  460. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
  461. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
  462. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js +29 -1
  463. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js.map +1 -1
  464. package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
  465. package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
  466. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js +6 -2
  467. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js.map +1 -1
  468. package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
  469. package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
  470. package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
  471. package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
  472. package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
  473. package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
  474. package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
  475. package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
  476. package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
  477. package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
  478. package/lib/esm/mastra/MastraCapabilities.js +115 -0
  479. package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
  480. package/lib/esm/mastra/MastraChannelResponse.js +154 -0
  481. package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
  482. package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
  483. package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
  484. package/lib/esm/mastra/MastraDefaultStepHandlers.js +240 -22
  485. package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -1
  486. package/lib/esm/mastra/MastraEnvironment.js +287 -0
  487. package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
  488. package/lib/esm/mastra/MastraEvalModels.js +535 -0
  489. package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
  490. package/lib/esm/mastra/MastraEventBridge.js +21 -1
  491. package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
  492. package/lib/esm/mastra/MastraGraphExecutionBackend.js +414 -19
  493. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
  494. package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
  495. package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
  496. package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
  497. package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
  498. package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
  499. package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
  500. package/lib/esm/mastra/MastraMemory.js +455 -0
  501. package/lib/esm/mastra/MastraMemory.js.map +1 -0
  502. package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
  503. package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
  504. package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
  505. package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
  506. package/lib/esm/mastra/MastraMetricsModels.js +486 -0
  507. package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
  508. package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
  509. package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
  510. package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
  511. package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
  512. package/lib/esm/mastra/MastraObservability.js +327 -0
  513. package/lib/esm/mastra/MastraObservability.js.map +1 -0
  514. package/lib/esm/mastra/MastraPersistence.js +530 -0
  515. package/lib/esm/mastra/MastraPersistence.js.map +1 -0
  516. package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
  517. package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
  518. package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
  519. package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
  520. package/lib/esm/mastra/MastraRunRecovery.js +89 -0
  521. package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
  522. package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
  523. package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
  524. package/lib/esm/mastra/MastraStorageWiring.js +119 -0
  525. package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
  526. package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
  527. package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
  528. package/lib/esm/mastra/MastraToolBuilder.js +68 -0
  529. package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
  530. package/lib/esm/mastra/MastraToolConfig.js +37 -0
  531. package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
  532. package/lib/esm/mastra/MastraToolDecorator.js +92 -0
  533. package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
  534. package/lib/esm/mastra/MastraVectorStore.js +605 -0
  535. package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
  536. package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
  537. package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
  538. package/lib/esm/mastra/MastraWorkflowCompiler.js +79 -15
  539. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  540. package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
  541. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
  542. package/lib/esm/mastra/index.js +40 -1
  543. package/lib/esm/mastra/index.js.map +1 -1
  544. package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
  545. package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
  546. package/lib/esm/mastra/nodes/index.js +12 -0
  547. package/lib/esm/mastra/nodes/index.js.map +1 -0
  548. package/lib/esm/mastra/nodes/types.js +2 -0
  549. package/lib/esm/mastra/nodes/types.js.map +1 -0
  550. package/lib/esm/mastra/types.js +125 -0
  551. package/lib/esm/mastra/types.js.map +1 -1
  552. package/lib/esm/nest/graph/GraphBackendHost.js +10 -2
  553. package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
  554. package/lib/esm/nest/graph/GraphEngineController.js +19 -1
  555. package/lib/esm/nest/graph/GraphEngineController.js.map +1 -1
  556. package/lib/esm/nest/graph/GraphExecutionModule.js +35 -1
  557. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  558. package/lib/esm/nest/graph/GraphNodeCatalogueController.js +15 -1
  559. package/lib/esm/nest/graph/GraphNodeCatalogueController.js.map +1 -1
  560. package/lib/esm/nest/graph/GraphRunController.js +65 -7
  561. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  562. package/lib/esm/nest/graph/GraphWorkflowController.js +35 -6
  563. package/lib/esm/nest/graph/GraphWorkflowController.js.map +1 -1
  564. package/lib/esm/nest/graph/main.js +83 -1
  565. package/lib/esm/nest/graph/main.js.map +1 -1
  566. package/lib/esm/node/agents/agent/node.js +189 -31
  567. package/lib/esm/node/agents/agent/node.js.map +1 -1
  568. package/lib/esm/node/agents/hitl/node.js +106 -0
  569. package/lib/esm/node/agents/hitl/node.js.map +1 -0
  570. package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
  571. package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
  572. package/lib/esm/node/agents/hooks/hook/node.js +111 -0
  573. package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
  574. package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
  575. package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
  576. package/lib/esm/node/agents/memory/memory/node.js +222 -0
  577. package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
  578. package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
  579. package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
  580. package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
  581. package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
  582. package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
  583. package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
  584. package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
  585. package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
  586. package/lib/esm/node/agents/processors/types.js +64 -0
  587. package/lib/esm/node/agents/processors/types.js.map +1 -0
  588. package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
  589. package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
  590. package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
  591. package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
  592. package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
  593. package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
  594. package/lib/esm/node/agents/rag/chunking/node.js +211 -0
  595. package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
  596. package/lib/esm/node/agents/rag/embedding/node.js +101 -0
  597. package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
  598. package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
  599. package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
  600. package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
  601. package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
  602. package/lib/esm/node/agents/rag/rerank/node.js +103 -0
  603. package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
  604. package/lib/esm/node/agents/rag/retriever/node.js +111 -0
  605. package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
  606. package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
  607. package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
  608. package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
  609. package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
  610. package/lib/esm/node/agents/responses/discord/node.js +92 -0
  611. package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
  612. package/lib/esm/node/agents/responses/slack/node.js +92 -0
  613. package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
  614. package/lib/esm/node/agents/responses/teams/node.js +92 -0
  615. package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
  616. package/lib/esm/node/agents/responses/telegram/node.js +92 -0
  617. package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
  618. package/lib/esm/node/agents/sandbox/node.js +125 -0
  619. package/lib/esm/node/agents/sandbox/node.js.map +1 -0
  620. package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
  621. package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
  622. package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
  623. package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
  624. package/lib/esm/node/agents/skills/skill/node.js +96 -0
  625. package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
  626. package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
  627. package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
  628. package/lib/esm/node/agents/tools/tool/node.js +91 -0
  629. package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
  630. package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
  631. package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
  632. package/lib/esm/node/agents/triggers/discord/node.js +92 -0
  633. package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
  634. package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
  635. package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
  636. package/lib/esm/node/agents/triggers/slack/node.js +92 -0
  637. package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
  638. package/lib/esm/node/agents/triggers/teams/node.js +92 -0
  639. package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
  640. package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
  641. package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
  642. package/lib/esm/node/agents/voice/node.js +98 -0
  643. package/lib/esm/node/agents/voice/node.js.map +1 -0
  644. package/lib/esm/node/agents/zones.js +39 -0
  645. package/lib/esm/node/agents/zones.js.map +1 -0
  646. package/lib/esm/node/comms/discord/node.js +375 -0
  647. package/lib/esm/node/comms/discord/node.js.map +1 -0
  648. package/lib/esm/node/comms/email-send/node.js +331 -0
  649. package/lib/esm/node/comms/email-send/node.js.map +1 -0
  650. package/lib/esm/node/comms/gmail/node.js +278 -0
  651. package/lib/esm/node/comms/gmail/node.js.map +1 -0
  652. package/lib/esm/node/comms/outlook/node.js +386 -0
  653. package/lib/esm/node/comms/outlook/node.js.map +1 -0
  654. package/lib/esm/node/comms/slack/node.js +267 -0
  655. package/lib/esm/node/comms/slack/node.js.map +1 -0
  656. package/lib/esm/node/comms/teams/node.js +222 -0
  657. package/lib/esm/node/comms/teams/node.js.map +1 -0
  658. package/lib/esm/node/comms/telegram/node.js +251 -0
  659. package/lib/esm/node/comms/telegram/node.js.map +1 -0
  660. package/lib/esm/node/comms/whatsapp/node.js +332 -0
  661. package/lib/esm/node/comms/whatsapp/node.js.map +1 -0
  662. package/lib/esm/node/credentials.js +96 -0
  663. package/lib/esm/node/credentials.js.map +1 -0
  664. package/lib/esm/node/data/aggregate/node.js +187 -0
  665. package/lib/esm/node/data/aggregate/node.js.map +1 -0
  666. package/lib/esm/node/data/compare-datasets/node.js +322 -0
  667. package/lib/esm/node/data/compare-datasets/node.js.map +1 -0
  668. package/lib/esm/node/data/data-table/node.js +256 -0
  669. package/lib/esm/node/data/data-table/node.js.map +1 -0
  670. package/lib/esm/node/data/date-time/node.js +171 -0
  671. package/lib/esm/node/data/date-time/node.js.map +1 -0
  672. package/lib/esm/node/data/filter/node.js +125 -0
  673. package/lib/esm/node/data/filter/node.js.map +1 -0
  674. package/lib/esm/node/data/item-lists/node.js +407 -0
  675. package/lib/esm/node/data/item-lists/node.js.map +1 -0
  676. package/lib/esm/node/data/limit/node.js +95 -0
  677. package/lib/esm/node/data/limit/node.js.map +1 -0
  678. package/lib/esm/node/data/merge/node.js +242 -0
  679. package/lib/esm/node/data/merge/node.js.map +1 -0
  680. package/lib/esm/node/data/remove-duplicates/node.js +132 -0
  681. package/lib/esm/node/data/remove-duplicates/node.js.map +1 -0
  682. package/lib/esm/node/data/rename-keys/node.js +130 -0
  683. package/lib/esm/node/data/rename-keys/node.js.map +1 -0
  684. package/lib/esm/node/data/set/node.js +139 -0
  685. package/lib/esm/node/data/set/node.js.map +1 -0
  686. package/lib/esm/node/data/sort/node.js +116 -0
  687. package/lib/esm/node/data/sort/node.js.map +1 -0
  688. package/lib/esm/node/data/split-out/node.js +131 -0
  689. package/lib/esm/node/data/split-out/node.js.map +1 -0
  690. package/lib/esm/node/data/summarize/node.js +146 -0
  691. package/lib/esm/node/data/summarize/node.js.map +1 -0
  692. package/lib/esm/node/data/support.js +386 -0
  693. package/lib/esm/node/data/support.js.map +1 -0
  694. package/lib/esm/node/data/transform-utils.js +702 -0
  695. package/lib/esm/node/data/transform-utils.js.map +1 -0
  696. package/lib/esm/node/devops/crypto/node.js +355 -0
  697. package/lib/esm/node/devops/crypto/node.js.map +1 -0
  698. package/lib/esm/node/devops/execute-command/node.js +192 -0
  699. package/lib/esm/node/devops/execute-command/node.js.map +1 -0
  700. package/lib/esm/node/devops/ftp/node.js +232 -0
  701. package/lib/esm/node/devops/ftp/node.js.map +1 -0
  702. package/lib/esm/node/devops/github/node.js +273 -0
  703. package/lib/esm/node/devops/github/node.js.map +1 -0
  704. package/lib/esm/node/devops/gitlab/node.js +264 -0
  705. package/lib/esm/node/devops/gitlab/node.js.map +1 -0
  706. package/lib/esm/node/devops/jwt/node.js +195 -0
  707. package/lib/esm/node/devops/jwt/node.js.map +1 -0
  708. package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
  709. package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
  710. package/lib/esm/node/index.js +444 -2
  711. package/lib/esm/node/index.js.map +1 -1
  712. package/lib/esm/node/io/airtable/node.js +309 -0
  713. package/lib/esm/node/io/airtable/node.js.map +1 -0
  714. package/lib/esm/node/io/confluence/node.js +244 -0
  715. package/lib/esm/node/io/confluence/node.js.map +1 -0
  716. package/lib/esm/node/io/convert-to-file/node.js +340 -0
  717. package/lib/esm/node/io/convert-to-file/node.js.map +1 -0
  718. package/lib/esm/node/io/extract-from-file/node.js +260 -0
  719. package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
  720. package/lib/esm/node/io/file-support.js +299 -0
  721. package/lib/esm/node/io/file-support.js.map +1 -0
  722. package/lib/esm/node/io/google-calendar/node.js +350 -0
  723. package/lib/esm/node/io/google-calendar/node.js.map +1 -0
  724. package/lib/esm/node/io/google-docs/node.js +263 -0
  725. package/lib/esm/node/io/google-docs/node.js.map +1 -0
  726. package/lib/esm/node/io/google-sheets/node.js +258 -0
  727. package/lib/esm/node/io/google-sheets/node.js.map +1 -0
  728. package/lib/esm/node/io/graphql/node.js +160 -0
  729. package/lib/esm/node/io/graphql/node.js.map +1 -0
  730. package/lib/esm/node/io/html/node.js +266 -0
  731. package/lib/esm/node/io/html/node.js.map +1 -0
  732. package/lib/esm/node/io/html-extract/node.js +153 -0
  733. package/lib/esm/node/io/html-extract/node.js.map +1 -0
  734. package/lib/esm/node/io/html-support.js +206 -0
  735. package/lib/esm/node/io/html-support.js.map +1 -0
  736. package/lib/esm/node/io/http-request/node.js +406 -0
  737. package/lib/esm/node/io/http-request/node.js.map +1 -0
  738. package/lib/esm/node/io/jira/node.js +342 -0
  739. package/lib/esm/node/io/jira/node.js.map +1 -0
  740. package/lib/esm/node/io/markdown/node.js +217 -0
  741. package/lib/esm/node/io/markdown/node.js.map +1 -0
  742. package/lib/esm/node/io/microsoft-excel/node.js +252 -0
  743. package/lib/esm/node/io/microsoft-excel/node.js.map +1 -0
  744. package/lib/esm/node/io/microsoft-sharepoint/node.js +265 -0
  745. package/lib/esm/node/io/microsoft-sharepoint/node.js.map +1 -0
  746. package/lib/esm/node/io/read-binary-file/node.js +105 -0
  747. package/lib/esm/node/io/read-binary-file/node.js.map +1 -0
  748. package/lib/esm/node/io/read-binary-files/node.js +104 -0
  749. package/lib/esm/node/io/read-binary-files/node.js.map +1 -0
  750. package/lib/esm/node/io/read-pdf/node.js +164 -0
  751. package/lib/esm/node/io/read-pdf/node.js.map +1 -0
  752. package/lib/esm/node/io/read-write-file/node.js +305 -0
  753. package/lib/esm/node/io/read-write-file/node.js.map +1 -0
  754. package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
  755. package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
  756. package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
  757. package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
  758. package/lib/esm/node/io/write-binary-file/node.js +155 -0
  759. package/lib/esm/node/io/write-binary-file/node.js.map +1 -0
  760. package/lib/esm/node/io/xml/node.js +313 -0
  761. package/lib/esm/node/io/xml/node.js.map +1 -0
  762. package/lib/esm/node/manifests.js +286 -0
  763. package/lib/esm/node/manifests.js.map +1 -1
  764. package/lib/esm/node/storage/blob/azure/node.js +129 -0
  765. package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
  766. package/lib/esm/node/storage/blob/base.js +311 -0
  767. package/lib/esm/node/storage/blob/base.js.map +1 -0
  768. package/lib/esm/node/storage/blob/gcs/node.js +117 -0
  769. package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
  770. package/lib/esm/node/storage/blob/s3/node.js +176 -0
  771. package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
  772. package/lib/esm/node/storage/database/base.js +291 -0
  773. package/lib/esm/node/storage/database/base.js.map +1 -0
  774. package/lib/esm/node/storage/database/mssql/node.js +42 -0
  775. package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
  776. package/lib/esm/node/storage/database/mysql/node.js +42 -0
  777. package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
  778. package/lib/esm/node/storage/database/postgres/node.js +42 -0
  779. package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
  780. package/lib/esm/node/storage/rabbitmq/node.js +243 -0
  781. package/lib/esm/node/storage/rabbitmq/node.js.map +1 -0
  782. package/lib/esm/node/storage/redis/node.js +331 -0
  783. package/lib/esm/node/storage/redis/node.js.map +1 -0
  784. package/lib/esm/node/storage/support.js +69 -0
  785. package/lib/esm/node/storage/support.js.map +1 -0
  786. package/lib/esm/node/triggers/error/node.js +99 -0
  787. package/lib/esm/node/triggers/error/node.js.map +1 -0
  788. package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
  789. package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
  790. package/lib/esm/node/triggers/postgres/node.js +235 -0
  791. package/lib/esm/node/triggers/postgres/node.js.map +1 -0
  792. package/lib/esm/node/triggers/rabbitmq/node.js +275 -0
  793. package/lib/esm/node/triggers/rabbitmq/node.js.map +1 -0
  794. package/lib/esm/node/triggers/redis/node.js +224 -0
  795. package/lib/esm/node/triggers/redis/node.js.map +1 -0
  796. package/lib/esm/node/triggers/sse/node.js +187 -0
  797. package/lib/esm/node/triggers/sse/node.js.map +1 -0
  798. package/lib/esm/node/triggers/support.js +99 -0
  799. package/lib/esm/node/triggers/support.js.map +1 -0
  800. package/lib/esm/node/triggers/workflow/node.js +184 -0
  801. package/lib/esm/node/triggers/workflow/node.js.map +1 -0
  802. package/lib/esm/ram/GraphRunEventModel.js +5 -1
  803. package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
  804. package/lib/esm/shared/graph/GraphNodeModel.js +5 -1
  805. package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -1
  806. package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
  807. package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
  808. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
  809. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  810. package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
  811. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js +20 -3
  812. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js.map +1 -1
  813. package/lib/esm/shared/graph/category-styles.js +12 -0
  814. package/lib/esm/shared/graph/category-styles.js.map +1 -1
  815. package/lib/esm/shared/graph/constants.js.map +1 -1
  816. package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
  817. package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
  818. package/lib/esm/typeorm/index.js +12 -0
  819. package/lib/esm/typeorm/index.js.map +1 -0
  820. package/lib/esm/workflows/boundary-value.workflow.js +34 -0
  821. package/lib/esm/workflows/boundary-value.workflow.js.map +1 -0
  822. package/lib/esm/workflows/builders.js +40 -0
  823. package/lib/esm/workflows/builders.js.map +1 -0
  824. package/lib/esm/workflows/chat-agent.workflow.js +36 -0
  825. package/lib/esm/workflows/chat-agent.workflow.js.map +1 -0
  826. package/lib/esm/workflows/error-boundary.workflow.js +50 -0
  827. package/lib/esm/workflows/error-boundary.workflow.js.map +1 -0
  828. package/lib/esm/workflows/event-map.workflow.js +33 -0
  829. package/lib/esm/workflows/event-map.workflow.js.map +1 -0
  830. package/lib/esm/workflows/foreach-break.workflow.js +54 -0
  831. package/lib/esm/workflows/foreach-break.workflow.js.map +1 -0
  832. package/lib/esm/workflows/human-approval.workflow.js +40 -0
  833. package/lib/esm/workflows/human-approval.workflow.js.map +1 -0
  834. package/lib/esm/workflows/if-switch.workflow.js +62 -0
  835. package/lib/esm/workflows/if-switch.workflow.js.map +1 -0
  836. package/lib/esm/workflows/index.js +116 -0
  837. package/lib/esm/workflows/index.js.map +1 -0
  838. package/lib/esm/workflows/loops-while-until.workflow.js +72 -0
  839. package/lib/esm/workflows/loops-while-until.workflow.js.map +1 -0
  840. package/lib/esm/workflows/manual-log.workflow.js +48 -0
  841. package/lib/esm/workflows/manual-log.workflow.js.map +1 -0
  842. package/lib/esm/workflows/schedule-code.workflow.js +38 -0
  843. package/lib/esm/workflows/schedule-code.workflow.js.map +1 -0
  844. package/lib/esm/workflows/types.js +2 -0
  845. package/lib/esm/workflows/types.js.map +1 -0
  846. package/lib/esm/workflows/value-templates.workflow.js +39 -0
  847. package/lib/esm/workflows/value-templates.workflow.js.map +1 -0
  848. package/lib/esm/workflows/webhook-form.workflow.js +44 -0
  849. package/lib/esm/workflows/webhook-form.workflow.js.map +1 -0
  850. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +7 -0
  851. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +7 -0
  852. package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
  853. package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
  854. package/lib/types/engine/constants.d.cts +60 -0
  855. package/lib/types/engine/constants.d.mts +60 -0
  856. package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
  857. package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
  858. package/lib/types/engine/execution/GraphCodeMode.d.cts +46 -0
  859. package/lib/types/engine/execution/GraphCodeMode.d.mts +46 -0
  860. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +21 -0
  861. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +21 -0
  862. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -4
  863. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -4
  864. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
  865. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
  866. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
  867. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
  868. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +12 -3
  869. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +12 -3
  870. package/lib/types/engine/execution/index.d.cts +1 -0
  871. package/lib/types/engine/execution/index.d.mts +1 -0
  872. package/lib/types/engine/index.d.cts +4 -0
  873. package/lib/types/engine/index.d.mts +4 -0
  874. package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
  875. package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
  876. package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
  877. package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
  878. package/lib/types/engine/store/index.d.cts +2 -0
  879. package/lib/types/engine/store/index.d.mts +2 -0
  880. package/lib/types/engine/types.d.cts +12 -0
  881. package/lib/types/engine/types.d.mts +12 -0
  882. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
  883. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
  884. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.cts +11 -1
  885. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.mts +11 -1
  886. package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
  887. package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
  888. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.cts +7 -0
  889. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.mts +7 -0
  890. package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
  891. package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
  892. package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
  893. package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
  894. package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
  895. package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
  896. package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
  897. package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
  898. package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
  899. package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
  900. package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
  901. package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
  902. package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
  903. package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
  904. package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
  905. package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
  906. package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +53 -6
  907. package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +53 -6
  908. package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
  909. package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
  910. package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
  911. package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
  912. package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
  913. package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
  914. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +108 -1
  915. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +108 -1
  916. package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
  917. package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
  918. package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
  919. package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
  920. package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
  921. package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
  922. package/lib/types/mastra/MastraMemory.d.cts +362 -0
  923. package/lib/types/mastra/MastraMemory.d.mts +362 -0
  924. package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
  925. package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
  926. package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
  927. package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
  928. package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
  929. package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
  930. package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
  931. package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
  932. package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
  933. package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
  934. package/lib/types/mastra/MastraObservability.d.cts +197 -0
  935. package/lib/types/mastra/MastraObservability.d.mts +197 -0
  936. package/lib/types/mastra/MastraPersistence.d.cts +241 -0
  937. package/lib/types/mastra/MastraPersistence.d.mts +241 -0
  938. package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
  939. package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
  940. package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
  941. package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
  942. package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
  943. package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
  944. package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
  945. package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
  946. package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
  947. package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
  948. package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
  949. package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
  950. package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
  951. package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
  952. package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
  953. package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
  954. package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
  955. package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
  956. package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
  957. package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
  958. package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
  959. package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
  960. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +23 -8
  961. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +23 -8
  962. package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
  963. package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
  964. package/lib/types/mastra/index.d.cts +40 -1
  965. package/lib/types/mastra/index.d.mts +40 -1
  966. package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
  967. package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
  968. package/lib/types/mastra/nodes/index.d.cts +11 -0
  969. package/lib/types/mastra/nodes/index.d.mts +11 -0
  970. package/lib/types/mastra/nodes/types.d.cts +57 -0
  971. package/lib/types/mastra/nodes/types.d.mts +57 -0
  972. package/lib/types/mastra/types.d.cts +365 -6
  973. package/lib/types/mastra/types.d.mts +365 -6
  974. package/lib/types/nest/graph/GraphEngineController.d.cts +19 -0
  975. package/lib/types/nest/graph/GraphEngineController.d.mts +19 -0
  976. package/lib/types/nest/graph/GraphExecutionModule.d.cts +17 -0
  977. package/lib/types/nest/graph/GraphExecutionModule.d.mts +17 -0
  978. package/lib/types/nest/graph/GraphNodeCatalogueController.d.cts +13 -0
  979. package/lib/types/nest/graph/GraphNodeCatalogueController.d.mts +13 -0
  980. package/lib/types/nest/graph/GraphRunController.d.cts +40 -4
  981. package/lib/types/nest/graph/GraphRunController.d.mts +40 -4
  982. package/lib/types/nest/graph/GraphWorkflowController.d.cts +26 -3
  983. package/lib/types/nest/graph/GraphWorkflowController.d.mts +26 -3
  984. package/lib/types/node/agents/agent/node.d.cts +72 -16
  985. package/lib/types/node/agents/agent/node.d.mts +72 -16
  986. package/lib/types/node/agents/hitl/node.d.cts +45 -0
  987. package/lib/types/node/agents/hitl/node.d.mts +45 -0
  988. package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
  989. package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
  990. package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
  991. package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
  992. package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
  993. package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
  994. package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
  995. package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
  996. package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
  997. package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
  998. package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
  999. package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
  1000. package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
  1001. package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
  1002. package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
  1003. package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
  1004. package/lib/types/node/agents/processors/types.d.cts +45 -0
  1005. package/lib/types/node/agents/processors/types.d.mts +45 -0
  1006. package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
  1007. package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
  1008. package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
  1009. package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
  1010. package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
  1011. package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
  1012. package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
  1013. package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
  1014. package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
  1015. package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
  1016. package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
  1017. package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
  1018. package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
  1019. package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
  1020. package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
  1021. package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
  1022. package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
  1023. package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
  1024. package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
  1025. package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
  1026. package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
  1027. package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
  1028. package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
  1029. package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
  1030. package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
  1031. package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
  1032. package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
  1033. package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
  1034. package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
  1035. package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
  1036. package/lib/types/node/agents/sandbox/node.d.cts +47 -0
  1037. package/lib/types/node/agents/sandbox/node.d.mts +47 -0
  1038. package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
  1039. package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
  1040. package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
  1041. package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
  1042. package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
  1043. package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
  1044. package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
  1045. package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
  1046. package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
  1047. package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
  1048. package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
  1049. package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
  1050. package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
  1051. package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
  1052. package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
  1053. package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
  1054. package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
  1055. package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
  1056. package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
  1057. package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
  1058. package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
  1059. package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
  1060. package/lib/types/node/agents/voice/node.d.cts +34 -0
  1061. package/lib/types/node/agents/voice/node.d.mts +34 -0
  1062. package/lib/types/node/agents/zones.d.cts +30 -0
  1063. package/lib/types/node/agents/zones.d.mts +30 -0
  1064. package/lib/types/node/comms/discord/node.d.cts +67 -0
  1065. package/lib/types/node/comms/discord/node.d.mts +67 -0
  1066. package/lib/types/node/comms/email-send/node.d.cts +85 -0
  1067. package/lib/types/node/comms/email-send/node.d.mts +85 -0
  1068. package/lib/types/node/comms/gmail/node.d.cts +67 -0
  1069. package/lib/types/node/comms/gmail/node.d.mts +67 -0
  1070. package/lib/types/node/comms/outlook/node.d.cts +77 -0
  1071. package/lib/types/node/comms/outlook/node.d.mts +77 -0
  1072. package/lib/types/node/comms/slack/node.d.cts +65 -0
  1073. package/lib/types/node/comms/slack/node.d.mts +65 -0
  1074. package/lib/types/node/comms/teams/node.d.cts +49 -0
  1075. package/lib/types/node/comms/teams/node.d.mts +49 -0
  1076. package/lib/types/node/comms/telegram/node.d.cts +61 -0
  1077. package/lib/types/node/comms/telegram/node.d.mts +61 -0
  1078. package/lib/types/node/comms/whatsapp/node.d.cts +71 -0
  1079. package/lib/types/node/comms/whatsapp/node.d.mts +71 -0
  1080. package/lib/types/node/credentials.d.cts +43 -0
  1081. package/lib/types/node/credentials.d.mts +43 -0
  1082. package/lib/types/node/data/aggregate/node.d.cts +58 -0
  1083. package/lib/types/node/data/aggregate/node.d.mts +58 -0
  1084. package/lib/types/node/data/compare-datasets/node.d.cts +72 -0
  1085. package/lib/types/node/data/compare-datasets/node.d.mts +72 -0
  1086. package/lib/types/node/data/data-table/node.d.cts +86 -0
  1087. package/lib/types/node/data/data-table/node.d.mts +86 -0
  1088. package/lib/types/node/data/date-time/node.d.cts +49 -0
  1089. package/lib/types/node/data/date-time/node.d.mts +49 -0
  1090. package/lib/types/node/data/filter/node.d.cts +31 -0
  1091. package/lib/types/node/data/filter/node.d.mts +31 -0
  1092. package/lib/types/node/data/item-lists/node.d.cts +92 -0
  1093. package/lib/types/node/data/item-lists/node.d.mts +92 -0
  1094. package/lib/types/node/data/limit/node.d.cts +28 -0
  1095. package/lib/types/node/data/limit/node.d.mts +28 -0
  1096. package/lib/types/node/data/merge/node.d.cts +63 -0
  1097. package/lib/types/node/data/merge/node.d.mts +63 -0
  1098. package/lib/types/node/data/remove-duplicates/node.d.cts +47 -0
  1099. package/lib/types/node/data/remove-duplicates/node.d.mts +47 -0
  1100. package/lib/types/node/data/rename-keys/node.d.cts +35 -0
  1101. package/lib/types/node/data/rename-keys/node.d.mts +35 -0
  1102. package/lib/types/node/data/set/node.d.cts +52 -0
  1103. package/lib/types/node/data/set/node.d.mts +52 -0
  1104. package/lib/types/node/data/sort/node.d.cts +40 -0
  1105. package/lib/types/node/data/sort/node.d.mts +40 -0
  1106. package/lib/types/node/data/split-out/node.d.cts +30 -0
  1107. package/lib/types/node/data/split-out/node.d.mts +30 -0
  1108. package/lib/types/node/data/summarize/node.d.cts +44 -0
  1109. package/lib/types/node/data/summarize/node.d.mts +44 -0
  1110. package/lib/types/node/data/support.d.cts +177 -0
  1111. package/lib/types/node/data/support.d.mts +177 -0
  1112. package/lib/types/node/data/transform-utils.d.cts +236 -0
  1113. package/lib/types/node/data/transform-utils.d.mts +236 -0
  1114. package/lib/types/node/devops/crypto/node.d.cts +65 -0
  1115. package/lib/types/node/devops/crypto/node.d.mts +65 -0
  1116. package/lib/types/node/devops/execute-command/node.d.cts +55 -0
  1117. package/lib/types/node/devops/execute-command/node.d.mts +55 -0
  1118. package/lib/types/node/devops/ftp/node.d.cts +55 -0
  1119. package/lib/types/node/devops/ftp/node.d.mts +55 -0
  1120. package/lib/types/node/devops/github/node.d.cts +61 -0
  1121. package/lib/types/node/devops/github/node.d.mts +61 -0
  1122. package/lib/types/node/devops/gitlab/node.d.cts +61 -0
  1123. package/lib/types/node/devops/gitlab/node.d.mts +61 -0
  1124. package/lib/types/node/devops/jwt/node.d.cts +53 -0
  1125. package/lib/types/node/devops/jwt/node.d.mts +53 -0
  1126. package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
  1127. package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
  1128. package/lib/types/node/index.d.cts +230 -2
  1129. package/lib/types/node/index.d.mts +230 -2
  1130. package/lib/types/node/io/airtable/node.d.cts +73 -0
  1131. package/lib/types/node/io/airtable/node.d.mts +73 -0
  1132. package/lib/types/node/io/confluence/node.d.cts +49 -0
  1133. package/lib/types/node/io/confluence/node.d.mts +49 -0
  1134. package/lib/types/node/io/convert-to-file/node.d.cts +75 -0
  1135. package/lib/types/node/io/convert-to-file/node.d.mts +75 -0
  1136. package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
  1137. package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
  1138. package/lib/types/node/io/file-support.d.cts +118 -0
  1139. package/lib/types/node/io/file-support.d.mts +118 -0
  1140. package/lib/types/node/io/google-calendar/node.d.cts +65 -0
  1141. package/lib/types/node/io/google-calendar/node.d.mts +65 -0
  1142. package/lib/types/node/io/google-docs/node.d.cts +51 -0
  1143. package/lib/types/node/io/google-docs/node.d.mts +51 -0
  1144. package/lib/types/node/io/google-sheets/node.d.cts +77 -0
  1145. package/lib/types/node/io/google-sheets/node.d.mts +77 -0
  1146. package/lib/types/node/io/graphql/node.d.cts +46 -0
  1147. package/lib/types/node/io/graphql/node.d.mts +46 -0
  1148. package/lib/types/node/io/html/node.d.cts +68 -0
  1149. package/lib/types/node/io/html/node.d.mts +68 -0
  1150. package/lib/types/node/io/html-extract/node.d.cts +42 -0
  1151. package/lib/types/node/io/html-extract/node.d.mts +42 -0
  1152. package/lib/types/node/io/html-support.d.cts +69 -0
  1153. package/lib/types/node/io/html-support.d.mts +69 -0
  1154. package/lib/types/node/io/http-request/node.d.cts +107 -0
  1155. package/lib/types/node/io/http-request/node.d.mts +107 -0
  1156. package/lib/types/node/io/jira/node.d.cts +57 -0
  1157. package/lib/types/node/io/jira/node.d.mts +57 -0
  1158. package/lib/types/node/io/markdown/node.d.cts +61 -0
  1159. package/lib/types/node/io/markdown/node.d.mts +61 -0
  1160. package/lib/types/node/io/microsoft-excel/node.d.cts +45 -0
  1161. package/lib/types/node/io/microsoft-excel/node.d.mts +45 -0
  1162. package/lib/types/node/io/microsoft-sharepoint/node.d.cts +47 -0
  1163. package/lib/types/node/io/microsoft-sharepoint/node.d.mts +47 -0
  1164. package/lib/types/node/io/read-binary-file/node.d.cts +45 -0
  1165. package/lib/types/node/io/read-binary-file/node.d.mts +45 -0
  1166. package/lib/types/node/io/read-binary-files/node.d.cts +41 -0
  1167. package/lib/types/node/io/read-binary-files/node.d.mts +41 -0
  1168. package/lib/types/node/io/read-pdf/node.d.cts +40 -0
  1169. package/lib/types/node/io/read-pdf/node.d.mts +40 -0
  1170. package/lib/types/node/io/read-write-file/node.d.cts +41 -0
  1171. package/lib/types/node/io/read-write-file/node.d.mts +41 -0
  1172. package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
  1173. package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
  1174. package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
  1175. package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
  1176. package/lib/types/node/io/write-binary-file/node.d.cts +55 -0
  1177. package/lib/types/node/io/write-binary-file/node.d.mts +55 -0
  1178. package/lib/types/node/io/xml/node.d.cts +67 -0
  1179. package/lib/types/node/io/xml/node.d.mts +67 -0
  1180. package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
  1181. package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
  1182. package/lib/types/node/storage/blob/base.d.cts +83 -0
  1183. package/lib/types/node/storage/blob/base.d.mts +83 -0
  1184. package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
  1185. package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
  1186. package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
  1187. package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
  1188. package/lib/types/node/storage/database/base.d.cts +97 -0
  1189. package/lib/types/node/storage/database/base.d.mts +97 -0
  1190. package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
  1191. package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
  1192. package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
  1193. package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
  1194. package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
  1195. package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
  1196. package/lib/types/node/storage/rabbitmq/node.d.cts +55 -0
  1197. package/lib/types/node/storage/rabbitmq/node.d.mts +55 -0
  1198. package/lib/types/node/storage/redis/node.d.cts +68 -0
  1199. package/lib/types/node/storage/redis/node.d.mts +68 -0
  1200. package/lib/types/node/storage/support.d.cts +36 -0
  1201. package/lib/types/node/storage/support.d.mts +36 -0
  1202. package/lib/types/node/triggers/error/node.d.cts +34 -0
  1203. package/lib/types/node/triggers/error/node.d.mts +34 -0
  1204. package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
  1205. package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
  1206. package/lib/types/node/triggers/postgres/node.d.cts +54 -0
  1207. package/lib/types/node/triggers/postgres/node.d.mts +54 -0
  1208. package/lib/types/node/triggers/rabbitmq/node.d.cts +59 -0
  1209. package/lib/types/node/triggers/rabbitmq/node.d.mts +59 -0
  1210. package/lib/types/node/triggers/redis/node.d.cts +53 -0
  1211. package/lib/types/node/triggers/redis/node.d.mts +53 -0
  1212. package/lib/types/node/triggers/sse/node.d.cts +43 -0
  1213. package/lib/types/node/triggers/sse/node.d.mts +43 -0
  1214. package/lib/types/node/triggers/support.d.cts +41 -0
  1215. package/lib/types/node/triggers/support.d.mts +41 -0
  1216. package/lib/types/node/triggers/workflow/node.d.cts +46 -0
  1217. package/lib/types/node/triggers/workflow/node.d.mts +46 -0
  1218. package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
  1219. package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
  1220. package/lib/types/shared/graph/GraphNodeModel.d.cts +6 -0
  1221. package/lib/types/shared/graph/GraphNodeModel.d.mts +6 -0
  1222. package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
  1223. package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
  1224. package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
  1225. package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
  1226. package/lib/types/shared/graph/constants.d.cts +39 -0
  1227. package/lib/types/shared/graph/constants.d.mts +39 -0
  1228. package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
  1229. package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
  1230. package/lib/types/typeorm/index.d.cts +11 -0
  1231. package/lib/types/typeorm/index.d.mts +11 -0
  1232. package/lib/types/workflows/boundary-value.workflow.d.cts +3 -0
  1233. package/lib/types/workflows/boundary-value.workflow.d.mts +3 -0
  1234. package/lib/types/workflows/builders.d.cts +31 -0
  1235. package/lib/types/workflows/builders.d.mts +31 -0
  1236. package/lib/types/workflows/chat-agent.workflow.d.cts +3 -0
  1237. package/lib/types/workflows/chat-agent.workflow.d.mts +3 -0
  1238. package/lib/types/workflows/error-boundary.workflow.d.cts +3 -0
  1239. package/lib/types/workflows/error-boundary.workflow.d.mts +3 -0
  1240. package/lib/types/workflows/event-map.workflow.d.cts +3 -0
  1241. package/lib/types/workflows/event-map.workflow.d.mts +3 -0
  1242. package/lib/types/workflows/foreach-break.workflow.d.cts +3 -0
  1243. package/lib/types/workflows/foreach-break.workflow.d.mts +3 -0
  1244. package/lib/types/workflows/human-approval.workflow.d.cts +3 -0
  1245. package/lib/types/workflows/human-approval.workflow.d.mts +3 -0
  1246. package/lib/types/workflows/if-switch.workflow.d.cts +3 -0
  1247. package/lib/types/workflows/if-switch.workflow.d.mts +3 -0
  1248. package/lib/types/workflows/index.d.cts +37 -0
  1249. package/lib/types/workflows/index.d.mts +37 -0
  1250. package/lib/types/workflows/loops-while-until.workflow.d.cts +3 -0
  1251. package/lib/types/workflows/loops-while-until.workflow.d.mts +3 -0
  1252. package/lib/types/workflows/manual-log.workflow.d.cts +3 -0
  1253. package/lib/types/workflows/manual-log.workflow.d.mts +3 -0
  1254. package/lib/types/workflows/schedule-code.workflow.d.cts +3 -0
  1255. package/lib/types/workflows/schedule-code.workflow.d.mts +3 -0
  1256. package/lib/types/workflows/types.d.cts +32 -0
  1257. package/lib/types/workflows/types.d.mts +32 -0
  1258. package/lib/types/workflows/value-templates.workflow.d.cts +16 -0
  1259. package/lib/types/workflows/value-templates.workflow.d.mts +16 -0
  1260. package/lib/types/workflows/webhook-form.workflow.d.cts +3 -0
  1261. package/lib/types/workflows/webhook-form.workflow.d.mts +3 -0
  1262. package/package.json +283 -21
package/README.md CHANGED
@@ -80,10 +80,13 @@ src/
80
80
  │ │ └── snapshot.ts # frontend-safe execution snapshots
81
81
  │ └── ui/ # framework-neutral view models for the graph UI
82
82
  ├── node/ # built-in @node classes, one folder per node: node/<category>/<sub>/<node>/node.ts
83
- │ # (triggers, flow, utility, loops, agents, boundary input/output value nodes)
84
- ├── engine/ # execution engine (planning, validation, auth, loops, pinning, runs, store, catalog)
83
+ │ # (triggers, flow, data, io, storage, devops, comms, utility, agents, boundary)
84
+ ├── engine/ # execution engine (planning, validation, auth, credentials, loops, pinning, runs, store, catalog)
85
85
  ├── nest/ # NestJS HTTP/SSE wiring for the engine
86
86
  ├── ram/ # adapter-backed run/run-event persistence (RamGraphRunStore, RamGraphRunEventStore)
87
+ ├── mastra/ # Mastra execution backend (mastra/nodes/: the mastra-only node-kind registry)
88
+ ├── typeorm/ # durable Postgres adapter factory for the as-graph decaf tables
89
+ ├── dagster/ # Dagster execution backend (host-injected DagsterClient port)
87
90
  ├── assets/ # locale JSON for @uielement strings (i18n/en.json, shipped via package files)
88
91
  └── log/ # run-log channel
89
92
  ```
@@ -96,7 +99,8 @@ compiled into a canonical `GraphWorkflowDocument` (`GraphDecoratedWorkflowCompil
96
99
 
97
100
  The document topology **is** the concurrency model: multiple `data` connections out of one output port
98
101
  fan out and execute concurrently, and multiple connections into one input port fan in and are joined
99
- before the target node runs. There are no dedicated `parallel` or `merge` node kinds. Node classes
102
+ before the target node runs. There is no dedicated `parallel` node kind (`core.data.merge` is a data-transform node, not an
103
+ execution branch merge). Node classes
100
104
  carry their behaviour on the **instance** `execute` method (parameters are hydrated onto the instance
101
105
  before it runs), and each kind is described by a `GraphNodeManifest` compiled from `@node`/`@input`/
102
106
  `@output` metadata.
@@ -148,7 +152,9 @@ npm install @decaf-ts/as-graph
148
152
  | `@decaf-ts/as-graph/shared` | UI-known contracts: `@node`/`@graph`/`@port` decorators, the canonical `GraphWorkflowDocument` and its builder/reader/serializer, manifest catalogue types, the persistable `GraphNodeModel` catalogue row with its manifest converters, constants, and frontend-safe execution-state projections |
149
153
  | `@decaf-ts/as-graph/nest` | NestJS HTTP/SSE wiring: catalogue, workflow persistence and run-lifecycle controllers |
150
154
  | `@decaf-ts/as-graph/ram` | Adapter-backed persistence: `GraphRunModel`/`GraphRunEventModel`/`GraphValueModel` and their `@repository()` classes, the `GraphNodeRepository` node-kind rows, the `RamGraphRunStore`/`RamGraphRunEventStore` stores, and the `createRamGraphAdapter` helper |
151
- | `@decaf-ts/as-graph/mastra` | Mastra execution backend: `MastraGraphExecutionBackend`, the workflow compiler, condition/event bridges, schema converter, resume guard, and the Mastra capability table. Runs canonical documents on a host-injected `@mastra/core` runtime (pinned `1.74.0`) |
155
+ | `@decaf-ts/as-graph/typeorm` | Durable production persistence: `createTypeormGraphAdapter({ dataSource })` — a `@decaf-ts/for-typeorm` Postgres adapter factory for the five as-graph decaf tables plus the mastra-layer decaf models (flavoured for the durable lane, `jsonb`-pinned structured columns, `synchronize: false`, bootstrap-owned DDL). See [Durable Postgres lane](#durable-postgres-lane-decaf-tsas-graphtypeorm) |
156
+ | `@decaf-ts/as-graph/mastra` | Mastra execution backend: `MastraGraphExecutionBackend`, the workflow compiler, condition/event bridges, schema converter, resume guard, and the Mastra capability table — plus the backend contract: `MastraModelSchemaConverter` (`mastraSchemaFromModel`/`mastraModelFromSchema`, the single decaf↔mastra schema conversion path over `@decaf-ts/as-zod`), `MastraStructuredOutput` (the JSON-safe structured-output definition/resolution contract), and `MastraEnvironment` (the `MASTRA__*` engine environment with the credential fail-closed gate). Runs canonical documents on a host-injected `@mastra/core` runtime (peer dependency `^1.77.0`; the capability manifest separately pins `MASTRA_PINNED_VERSION = "1.74.0"` as the reviewed engine contract), executing the RAG/sandbox kinds for real through `MastraRagStepHandlers` (fail-closed `GRAPH_MASTRA_RAG_UNAVAILABLE`/`GRAPH_MASTRA_EMBEDDING_UNAVAILABLE`/`GRAPH_MASTRA_SANDBOX_UNAVAILABLE`) and serving MCP deliveries behind the run-scoped C6 `MastraMcpDeliveryGuard` |
157
+ | `@decaf-ts/as-graph/mastra/nodes` | Mastra-only node-kind registry (SAA-1141): the authoritative list of `core.agent[.*]` kinds, each paired with its declaration class and the step-handler factory that owns it. `createMastraNodeStepHandlers` composes the backend's registered handler set from the host extension points; `auditMastraNodeCoverage` / `assertMastraNodeCoverage` prove zero missing implementations |
152
158
  | `@decaf-ts/as-graph/dagster` | Dagster execution backend: `DagsterGraphExecutionBackend`, the workflow translator, event bridge, result mapper, capability table (`DAGSTER_CAPABILITY_TABLE`), and Dagster identifier/condition-grammar helpers. Driven through a host-injected `DagsterClient` port against the pinned engine contract (`1.13.25`; Dagster is Python-side, there is no JavaScript runtime dependency) |
153
159
 
154
160
  The `exports` map in `package.json` is:
@@ -176,11 +182,21 @@ The `exports` map in `package.json` is:
176
182
  "require": { "types": "./lib/types/ram/index.d.cts", "default": "./lib/cjs/ram/index.cjs" },
177
183
  "default": "./lib/esm/ram/index.js"
178
184
  },
185
+ "./typeorm": {
186
+ "import": { "types": "./lib/types/typeorm/index.d.mts", "default": "./lib/esm/typeorm/index.js" },
187
+ "require": { "types": "./lib/types/typeorm/index.d.cts", "default": "./lib/cjs/typeorm/index.cjs" },
188
+ "default": "./lib/esm/typeorm/index.js"
189
+ },
179
190
  "./mastra": {
180
191
  "import": { "types": "./lib/types/mastra/index.d.mts", "default": "./lib/esm/mastra/index.js" },
181
192
  "require": { "types": "./lib/types/mastra/index.d.cts", "default": "./lib/cjs/mastra/index.cjs" },
182
193
  "default": "./lib/esm/mastra/index.js"
183
194
  },
195
+ "./mastra/nodes": {
196
+ "import": { "types": "./lib/types/mastra/nodes/index.d.mts", "default": "./lib/esm/mastra/nodes/index.js" },
197
+ "require": { "types": "./lib/types/mastra/nodes/index.d.cts", "default": "./lib/cjs/mastra/nodes/index.cjs" },
198
+ "default": "./lib/esm/mastra/nodes/index.js"
199
+ },
184
200
  "./dagster": {
185
201
  "import": { "types": "./lib/types/dagster/index.d.mts", "default": "./lib/esm/dagster/index.js" },
186
202
  "require": { "types": "./lib/types/dagster/index.d.cts", "default": "./lib/cjs/dagster/index.cjs" },
@@ -282,24 +298,77 @@ The built-in kinds are declared one folder per node under
282
298
 
283
299
  | Group | Kinds |
284
300
  | --- | --- |
285
- | Triggers | `core.trigger.manual`, `core.trigger.webhook`, `core.trigger.schedule`, `core.trigger.event`, `core.trigger.form`, `core.trigger.chat` |
286
- | Flow | `core.flow.if`, `core.flow.switch`, `core.flow.delay`, `core.flow.errorBoundary`, `core.flow.humanApproval`, `core.flow.log`, `core.flow.break` |
301
+ | Triggers | `core.trigger.manual`, `core.trigger.webhook`, `core.trigger.schedule`, `core.trigger.event`, `core.trigger.form`, `core.trigger.chat`, `core.trigger.executeWorkflow`, `core.trigger.error`, `core.trigger.workflow`, `core.trigger.rabbitmq`, `core.trigger.redis`, `core.trigger.sse`, `core.trigger.postgres` |
302
+ | Flow | `core.flow.if`, `core.flow.switch`, `core.flow.delay`, `core.flow.errorBoundary`, `core.flow.humanApproval`, `core.flow.log`, `core.flow.break`, `core.flow.executeSubWorkflow` |
303
+ | Data | `core.data.set`, `core.data.merge`, `core.data.filter`, `core.data.splitOut`, `core.data.dateTime`, `core.data.dataTable`, `core.data.limit`, `core.data.sort`, `core.data.renameKeys`, `core.data.aggregate`, `core.data.itemLists`, `core.data.compareDatasets`, `core.data.summarize`, `core.data.removeDuplicates` |
304
+ | IO | `core.io.httpRequest`, `core.io.respondToWebhook`, `core.io.extractFromFile`, `core.io.readPDF`, `core.io.readWriteFile`, `core.io.googleSheets`, `core.io.airtable`, `core.io.spreadsheetFile`, `core.io.graphql`, `core.io.convertToFile`, `core.io.html`, `core.io.htmlExtract`, `core.io.markdown`, `core.io.xml`, `core.io.readBinaryFile`, `core.io.readBinaryFiles`, `core.io.writeBinaryFile`, `core.io.microsoftExcel`, `core.io.confluence`, `core.io.jira`, `core.io.googleDocs`, `core.io.microsoftSharePoint`, `core.io.googleCalendar` |
305
+ | Storage | `core.storage.postgres`, `core.storage.mySql`, `core.storage.microsoftSql`, `core.storage.redis`, `core.storage.rabbitmq`, `core.storage.s3`, `core.storage.awsS3`, `core.storage.googleCloudStorage`, `core.storage.azureStorage` |
306
+ | DevOps | `core.devops.crypto`, `core.devops.jwt`, `core.devops.executeCommand`, `core.devops.ftp`, `core.devops.github`, `core.devops.gitlab` |
307
+ | Comms | `core.comms.slack`, `core.comms.telegram`, `core.comms.teams`, `core.comms.gmail`, `core.comms.emailSend`, `core.comms.discord`, `core.comms.whatsApp`, `core.comms.microsoftOutlook` |
287
308
  | Utility | `core.utility.code`, `core.utility.map`, `core.utility.log` |
288
309
  | Loops | `core.loop.foreach`, `core.loop.while`, `core.loop.until` |
289
- | Agent | `core.agent` |
310
+ | Agent | `core.agent` (the agent node) and its `core.agent.*` family kinds: `core.agent.tool|toolSelector` (tools), `core.agent.hook|toolDeny|delegationHook` (hooks), `core.agent.skill|skillSelector` (skills), `core.agent.sandbox` (sandbox), `core.agent.scorer|scorerSelector` (scorers), `core.agent.memory|memorySelector` (memory), `core.agent.embedding|vectorStore|retriever|rerank|chunking` (RAG), `core.agent.chain.basic|qa|summarization` (RAG chains), `core.agent.inputProcessor|outputProcessor|guardrail|structuredOutputParser|informationExtractor|langchainCode` (processors), `core.agent.hitl` (human-in-the-loop), `core.agent.voice` (voice), `core.agent.trigger.mcp|slack|discord|telegram|teams` (triggers), `core.agent.response.slack|discord|telegram|teams` (channel responses). Every `core.agent[.*]` kind requires the mastra engine — the general (local) engine fails closed with `GRAPH_LOCAL_UNSUPPORTED_NODE_KIND` |
290
311
  | Boundary | `graph-input-value-node` (`GraphNode<void, …>` — reusable value node whose single `value` output may feed multiple targets), `graph-output-value-node` (`GraphNode<…, void>` — terminal sink whose `value` input receives the workflow result; it has **no output port** — the engine captures workflow outputs from the `$workflow` boundary edges into it) |
291
312
 
292
- There are no `parallel` or `merge` node kinds: the graph itself parallelizes on multiple connections
313
+ Storage, DevOps, Comms, and credential-bearing IO kinds resolve their credentials at execution time through the engine's ctx-bound
314
+ `GraphNodeCredentialResolver` (`GraphExecutionEngine.nodeCredentials`), backed by the `@decaf-ts/integrations` credential and
315
+ secret services. A node's `credentialRef` parameter holds a `{ credentialId, credentialType }` reference; the resolver loads the
316
+ credential record, validates its type, enabled state and expiry, then retrieves the secret by `secretName` through the model-backed
317
+ or filesystem-backed secret service. A missing/unconfigured resolver fails closed with `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` and an
318
+ unsupported provider with `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED`; secrets are never stored in workflow documents. The
319
+ PostgreSQL, MySQL, and Microsoft SQL kinds require the matching TypeORM driver (`pg`, `mysql2`, `mssql`), all three declared as optional dependencies. The Comms, DevOps, and IO kinds delegate to the service classes in `@decaf-ts/integrations` where applicable (`comms/{slack,telegram,teams,gmail,email,discord,whatsapp,outlook}`, `devops/{github,gitlab}`, `core.devops.ftp` via `@decaf-ts/integrations/sftp`, `io/{google-sheets,airtable,graphql,confluence,jira,google-docs,microsoft-excel,microsoft-sharepoint}`, and `core.io.googleCalendar` via `@decaf-ts/integrations/calendar/google-calendar`); the Stage 5 stream triggers connect directly through their thin client libraries — `core.trigger.rabbitmq`/`core.storage.rabbitmq` over `amqplib`, `core.trigger.redis` over the `@decaf-ts/integrations/redis` adapter (same connection handling as `core.storage.redis`), `core.trigger.sse` over the `eventsource` client, and `core.trigger.postgres` over `pg` with the same TLS policy as `core.storage.postgres`. `core.devops.crypto` and `core.devops.jwt` use `@decaf-ts/crypto`, `core.devops.executeCommand` runs a local `child_process`, and `core.io.spreadsheetFile` is local parsing/writing with no network service.
320
+
321
+ There is no structural `parallel` node kind: the graph itself parallelizes on multiple connections
293
322
  to an output port (native fan-out) and syncs on multiple connections into an input port (native
294
- fan-in). Notable per-node properties:
323
+ fan-in). `core.data.merge` is a data-transform node for joining value arrays, not an execution
324
+ branch merge. Data nodes use array-in/array-out values (no n8n item model); `core.data.dataTable`
325
+ persists cross-run rows through the engine's data-table repository, and
326
+ `core.io.respondToWebhook` correlates responses by `runId`. Notable per-node properties:
295
327
 
296
328
  - `core.utility.code` — `timeoutMs` (node property forwarded to the code sandbox evaluator) and the
297
329
  `code` editor field (`@uielement("code-editor", …)`).
330
+ - `core.flow.executeSubWorkflow` — `workflowId` or an inline `workflow` document; child runs inherit
331
+ `parentRunId` and return the child `result`, `outputs`, and `childRunId`.
332
+ - `core.io.readPDF` — requires the `pdf-parse` dependency; returns extracted text plus per-page text.
333
+ - `core.data.dataTable` — operations `insert|upsert|get|list|delete|clear` over a named table.
298
334
  - `core.trigger.schedule` — `cron`, mapped to the for-angular Cron input
299
335
  (`@uielement("app-cron-selector-field", …)`), with timezone support.
300
336
  - `core.trigger.form` / `core.trigger.webhook` — `schema`, a `ModelBuilder`-produced model rendered
301
337
  with the for-angular model-builder webcomponent (`@uielement("ngx-decaf-model-builder", …)`); the
302
338
  resulting `payload` output is a plain data port.
339
+ - `core.agent` — the mastra agent node. Every mastra agent option is a first-class CRUD field
340
+ (`name`, `description`, `instructions`, `skillsFormat`, `maxRetries`, `structuredOutput`, and the
341
+ advanced `agentOptions` passthrough), the `prompt` input accepts placeholder expressions like
342
+ `{{ $input.brief }}`, and the LLM is carried as **config** via the `modelAdapter` parameter
343
+ (`provider`, `modelId`, optional `credentialRef` credential reference — resolved by document
344
+ validation stage 8 — plus optional `modelSettings`); there is no model-provider node kind, and the
345
+ bottom `model`/`workspace` connections stay for explicit wiring only. Its structural dependencies
346
+ are dedicated connection zones — `memory` bottom-left, `scorers` top-right, `embedding`
347
+ bottom-right, `hooks`/`sandbox` top-middle, `tools`/`skill` bottom-middle, and the processor
348
+ zones `inputProcessors`/`outputProcessors` — each accepting only
349
+ the matching family node's connection (same-category rule).
350
+ - Stream triggers (`core.trigger.rabbitmq`, `core.trigger.redis`, `core.trigger.sse`,
351
+ `core.trigger.postgres`) — wait for exactly one event inside the executor: the run
352
+ service starts the run, the trigger subscribes (queue consume, pub/sub channel
353
+ patterns, SSE endpoint, Postgres `LISTEN`), and the run continues on the first
354
+ event. The wait honours `timeoutMs` (default 30 s) and the run's abort signal
355
+ (`GRAPH_TRIGGER_ABORTED`), the subscription is always cleaned up, and one
356
+ message per run is consumed and acknowledged immediately.
357
+ - `core.storage.rabbitmq` — the producer pairing node for `core.trigger.rabbitmq`:
358
+ publishes a message to a queue or a topic exchange (exchange type defaults to
359
+ `topic`) over `amqplib`; a message published to the same queue/exchange fires
360
+ the trigger. `core.storage.redis` with `operation: "publish"` is the producer
361
+ side of `core.trigger.redis` (same channel prefix scoping).
362
+ - `core.trigger.error` — payloadless entrypoint of an error workflow; normalizes
363
+ the failure payload delivered through the run/event boundary into the
364
+ `execution`/`workflow`/`error` blocks. `core.trigger.workflow` — starts a run
365
+ on the workflow's own `activate`/`update` lifecycle events; a delivered event
366
+ outside the configured list fails closed.
367
+ - `core.io.readBinaryFile` / `core.io.readBinaryFiles` (glob) / `core.io.writeBinaryFile` —
368
+ binary payloads (`base64` data + mime type, `utf8`/`base64`/`auto` decoding)
369
+ confined to the same `GRAPH_FILE_IO_BASE` root as `core.io.readWriteFile`
370
+ (traversal and forbidden-directory escapes fail closed with
371
+ `GRAPH_FILE_PATH_FORBIDDEN`).
303
372
 
304
373
  `@uielement` labels and placeholders are locale keys, not hardcoded strings: the strings live in
305
374
  `assets/i18n/en.json`, shipped in the published package.
@@ -443,9 +512,19 @@ with `GRAPH_BACKEND_SEED_NOT_SUPPORTED` when the backend does not implement it.
443
512
  ##### Mastra backend (`@decaf-ts/as-graph/mastra`)
444
513
 
445
514
  `MastraGraphExecutionBackend` translates the canonical document into a Mastra
446
- workflow, runs it on the injected `@mastra/core` runtime (pinned `1.74.0`),
515
+ workflow, runs it on the injected `@mastra/core` runtime (peer dependency
516
+ `^1.77.0`; the capability manifest pins `MASTRA_PINNED_VERSION = "1.74.0"` as
517
+ the reviewed engine contract),
447
518
  bridges Mastra's `fullStream` onto the facade event sink, and enforces the
448
- schema-safe resume guard on every resume payload. It reports `codeMode:
519
+ schema-safe resume guard on every resume payload. The returned
520
+ `GraphExecutionResult.status` is derived from the run's terminal outcome, never
521
+ assumed from the bare fact that the run resolved: the event bridge records the
522
+ terminal `workflow-finish` status (`failed`/`tripwire` → `failed`,
523
+ `canceled`/`cancelled` → `cancelled`, `success`/`succeeded` → `succeeded`), with
524
+ the run result's/stream's raw status as fallback when the stream was not
525
+ observed — so a failed or guardrail-tripped run reports `failed` and a
526
+ cancelled run reports `cancelled` instead of a false `succeeded`. It reports
527
+ `codeMode:
449
528
  "unsupported"` (code-mode surfaces currently fail closed) and surfaces
450
529
  `workflowList`/`workflowLookup` over its compiled-workflow cache. Its full
451
530
  per-feature capability table (`MASTRA_FEATURE_CAPABILITIES`) declares, per
@@ -459,19 +538,583 @@ import { MastraGraphExecutionBackend } from "@decaf-ts/as-graph/mastra";
459
538
 
460
539
  const backend = new MastraGraphExecutionBackend(); // self-registers under the "mastra" flavour
461
540
  await backend.initialize({
462
- mastra, // the host's @mastra/core runtime instance
463
- agents, // optional agent map for agent/LLM nodes
464
- stepHandlers, // optional MastraNodeStepHandler[] for custom node kinds
465
- suspendStateReader, // optional, for suspend/resume runs
466
- maxResumeBytes, // optional resume payload byte cap
541
+ mastra, // the host's @mastra/core runtime instance
542
+ agents, // optional agent map for `core.agent` nodes, keyed by `<provider>/<modelId>`, model id, or node id
543
+ createAgent, // optional factory building an agent from a node's model-adapter config (fallback after `agents`)
544
+ agentRuntime, // optional pre-built agent runtime (takes precedence over both)
545
+ memories, createMemory, // optional memory wiring for `core.agent.memory` nodes
546
+ stepHandlers, // optional MastraNodeStepHandler[] for custom node kinds
547
+ resolveProcessorModel, // optional model resolver for input/output processors and guardrails
548
+ resolveStructuredOutputModel, // optional model resolver for structured-output parsing
549
+ createMcpServer, // optional MCP server factory — receives `(descriptor, guard)` where `guard` is the run-scoped C6 delivery guard; omitting the factory makes `core.agent.trigger.mcp` fail closed (`GRAPH_MASTRA_MCP_UNAVAILABLE`)
550
+ resolveChannelAdapter, sendChannelResponse, // optional channel wiring — omitting them makes `core.agent.trigger.*`/`response.*` fail closed (`GRAPH_MASTRA_CHANNEL_UNAVAILABLE`)
551
+ resolveVoice, // optional voice wiring — omitting it makes `core.agent.voice` fail closed (`GRAPH_MASTRA_VOICE_UNAVAILABLE`)
552
+ embedText, generateText, runSandboxedCode, // optional RAG/sandbox host ports — see "Real RAG & sandbox execution (SAA-747 Stage 2)" below
553
+ embedding, // optional backend-wide embedding config used when a RAG document carries none
554
+ vectorStoreBindings, vectorStoreDrivers, resolveVectorStore, // optional mastra-native vector-store wiring for the RAG steps (Stage 4 provider matrix)
555
+ memoryStorageBindings, memoryVectorStore, memoryEmbedder, // optional memory-matrix wiring — see "Stage 4 mastra breadth" below
556
+ persistence, // optional per-layer persistence surface (replays/cache/pins), overriding the `MASTRA__PERSISTENCE__*` env defaults
557
+ storage, // optional Mastra storage for the runtime — applied and verified back; see storage wiring below
558
+ suspendStateReader, // optional, for suspend/resume runs
559
+ maxResumeBytes, // optional resume payload byte cap
560
+ terminalTimeoutMs, // optional run-level terminal timeout
467
561
  });
468
562
  // pass `backend` via GraphExecutionEngineConfig.backend
469
563
  ```
470
564
 
565
+ **Explicit storage wiring (SAA-926 §6.2).** The optional `storage` config
566
+ member is applied to the wired `@mastra/core` runtime through its
567
+ `setStorage` surface and then verified back through `getStorage()`:
568
+ the wiring fails closed with `GRAPH_MASTRA_STORAGE_UNWIRED` when the runtime
569
+ is not a Mastra instance or exposes no `setStorage` surface (a silently
570
+ ignored declared storage would fall back to in-memory persistence), and with
571
+ `GRAPH_MASTRA_STORAGE_DOMAIN_INMEMORY` when the resolved workflows domain is
572
+ absent or silently in-memory — a composite storage that misses the workflows
573
+ domain loses suspend/resume snapshots on restart. The only accepted path to
574
+ an in-memory workflows domain is the host explicitly declaring an
575
+ `InMemoryStore`. `backend.storageStatus` exposes the resolved outcome
576
+ (`{ wired, explicitInMemory, domains: { workflows: "durable" | "in-memory" |
577
+ "absent" } }`; `undefined` when no storage config was declared): production
578
+ hosts must configure Mastra storage explicitly and durably, i.e.
579
+ `storageStatus.domains.workflows === "durable"`.
580
+
581
+ **Resume run recovery (SAA-926 §6.3).** `@mastra/core` 1.77.0 exposes no
582
+ public `getRun` on the `Mastra` class, so resume on a plain runtime used to
583
+ fail closed. The backend's run loading now falls back to
584
+ `recoverMastraRunHandle` — mastra's own restart-recovery pattern: resolve the
585
+ persisted run record from the configured storage's workflows domain
586
+ (`getWorkflowRunById`) to learn the workflow name, then rebind the run id
587
+ onto the live workflow via `createRun({ runId })`. Hosts can wrap their own
588
+ `getRun` with `createMastraGetRunWrapper(runtime)`, which delegates to a
589
+ runtime-provided `getRun` when present and otherwise recovers the handle the
590
+ same way.
591
+
592
+ `core.agent` executes as a real mastra agent step (no degraded echo): the backend builds the agent
593
+ step handler from an explicit `agentRuntime`, or from `createAgent`/`agents` (consulted in that
594
+ order), invokes the resolved agent with the node's `prompt` input, and projects the result onto the
595
+ node's `response`/`actions` outputs. When none of the three is configured the step fails closed with
596
+ `GRAPH_MASTRA_AGENT_UNAVAILABLE` instead of returning a fabricated result; the `core.agent.*` family
597
+ kinds resolve their configuration into resource descriptors through the default handler set,
598
+ overridden for the RAG and sandbox kinds by the real execution handlers below. Every mastra-only
599
+ step handler is composed through the `@decaf-ts/as-graph/mastra/nodes` registry
600
+ (`createMastraNodeStepHandlers`), which filters the host options to the mastra-only kinds and
601
+ proves zero missing implementations with `auditMastraNodeCoverage` / `assertMastraNodeCoverage`. The
602
+ general (local) engine never runs the mastra AI family: any `core.agent[.*]` node reaching it fails
603
+ closed with `GRAPH_LOCAL_UNSUPPORTED_NODE_KIND`.
604
+
471
605
  The flavour constant is `MASTRA_BACKEND_FLAVOUR` (`"mastra"`); unsupported node
472
606
  kinds and unsafe/invalid resume payloads fail loudly with
473
607
  `GRAPH_MASTRA_UNSUPPORTED_KIND` / `GRAPH_MASTRA_RESUME_*` errors.
474
608
 
609
+ **Single schema conversion path (as-zod).** Every decaf↔mastra schema
610
+ conversion goes through `@decaf-ts/as-zod` — `mastraSchemaFromModel` converts
611
+ a decaf Model constructor into the mastra Zod object schema, and
612
+ `mastraModelFromSchema` converts back. There is no second metadata walker;
613
+ both directions fail closed with `GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE` when
614
+ the conversion cannot produce a usable schema instead of handing the engine a
615
+ degraded schema (only a Zod object schema with a non-empty declared shape can
616
+ drive structured output).
617
+
618
+ **Structured output.** A graph document authors structured output as a plain,
619
+ JSON-safe definition on a node's `structuredOutput` parameter: a decaf model
620
+ **name** resolved through the host-supplied model registry
621
+ (`MastraDecafModelResolver` — the host owns the model catalogue; the backend
622
+ never invents one), or a host-carried, already-converted Zod schema (takes
623
+ precedence), plus optional `instructions`, `jsonPromptInjection`, and
624
+ `providerOptions` forwarded to mastra verbatim.
625
+ `mastraStructuredOutputOf` resolves it into mastra's `structuredOutput`
626
+ generate option; an unresolvable definition fails closed with
627
+ `GRAPH_MASTRA_STRUCTURED_OUTPUT_UNRESOLVED` rather than silently degrading to
628
+ unstructured output, and an absent definition leaves the agent unstructured
629
+ (mastra's default). The definition never carries a secret and never carries
630
+ raw JSON Schema — mastra consumes Zod. The model-builder UI (SAA-836 U1)
631
+ consumes this same contract.
632
+
633
+ ```typescript
634
+ import {
635
+ mastraSchemaFromModel,
636
+ mastraStructuredOutputOf,
637
+ } from "@decaf-ts/as-graph/mastra";
638
+
639
+ const zodSchema = mastraSchemaFromModel(MyDecafModel); // via @decaf-ts/as-zod
640
+ const structuredOutput = mastraStructuredOutputOf(node, (name) => models[name]);
641
+ // → { schema, instructions?, jsonPromptInjection?, providerOptions? } | undefined
642
+ ```
643
+
644
+ **Real RAG & sandbox execution (SAA-747 Stage 2).** The RAG/sandbox data-flow
645
+ family is no longer config-only in the mastra engine:
646
+ `createMastraRagStepHandlers` registers real steps **after** the host default
647
+ set for `core.agent.embedding`, `core.agent.vectorStore`,
648
+ `core.agent.retriever`, `core.agent.chain.basic|qa|summarization`,
649
+ `core.agent.structuredOutputParser`, `core.agent.informationExtractor`,
650
+ `core.agent.sandbox`, and `core.agent.langchainCode`
651
+ (`MASTRA_RAG_EXECUTION_KINDS` / `MASTRA_SANDBOX_EXECUTION_KINDS`). Insert
652
+ steps embed the input documents — the node's embedding config, falling back
653
+ to the backend-wide `embedding` config when the document carries none, run
654
+ through the host `embedText` port or mastra's `ModelRouterEmbeddingModel` by
655
+ default — create the index, and upsert into the mastra-native `MastraVector`
656
+ resolved through `MastraVectorStore` (a shared store cache, so the retriever
657
+ reads the same in-memory instance the insert wrote); retriever steps embed the
658
+ query and read the store wired on the `store` data edge, with a `queryVector`
659
+ bypass; chain/extractor steps generate through the host `generateText` port or
660
+ a mastra `Agent` built from the node's `modelAdapter` config and emit
661
+ `text`/`sourceDocuments`/`data`; the parser parses JSON on the real `text`
662
+ input. Vector-store wiring is mastra-native: `vectorStoreBindings` (the nine
663
+ mastra-native providers), custom `vectorStoreDrivers` (`age`, `graph`), and an
664
+ optional `resolveVectorStore` override — see the
665
+ [Stage 4 mastra breadth](#stage-4-mastra-breadth-saa-749-vector-store-matrix-memory-matrix-processor-variants)
666
+ section for the full provider/credential matrix and the RAG walkthrough. Every step selects real execution only
667
+ when the document wires the work the kind needs (documents, query, model
668
+ config, or code); otherwise it emits the same JSON-safe descriptor fallback
669
+ (R9) the default set emits, so a config-only node never makes a model or
670
+ database call by accident. Missing embedding config, an invalid vector batch,
671
+ or a failed generation fails closed with
672
+ `GRAPH_MASTRA_EMBEDDING_UNAVAILABLE` / `GRAPH_MASTRA_RAG_UNAVAILABLE` — no
673
+ vector, answer, or extraction is ever fabricated. The `core.agent.sandbox`
674
+ node stays config-only when no host `runSandboxedCode` runner is wired, while
675
+ `core.agent.langchainCode` carrying code without a runner fails closed with
676
+ `GRAPH_MASTRA_SANDBOX_UNAVAILABLE` — never executing code outside a sandbox —
677
+ and both reuse `GRAPH_CODE_SANDBOX_TIMEOUT` (exported as
678
+ `GRAPH_MASTRA_SANDBOX_TIMEOUT`) when the runner exceeds the ceiling-clamped
679
+ `timeoutMs`.
680
+
681
+ ```typescript
682
+ import { createMastraRagStepHandlers } from "@decaf-ts/as-graph/mastra";
683
+
684
+ // The backend registers these handlers automatically; hosts pass the backend
685
+ // config members above to override the mastra-native defaults
686
+ // (ModelRouterEmbeddingModel embeddings / Agent.generate text).
687
+ const ragHandlers = createMastraRagStepHandlers({
688
+ vectorStoreBindings: myVectorStoreBindings, // all nine mastra-native providers (Stage 4)
689
+ embedText: async ({ values, config }) => myEmbedder(values, config),
690
+ generateText: async ({ prompt, instructions }) => ({
691
+ text: await myLlm(prompt, instructions),
692
+ }),
693
+ runSandboxedCode: async ({ code, timeoutMs }) =>
694
+ mySandbox.run(code, timeoutMs),
695
+ });
696
+ ```
697
+
698
+ ##### Stage 4 mastra breadth (SAA-749): vector-store matrix, memory matrix, processor variants
699
+
700
+ Stage 4 completes the mastra AI breadth behind the same patterns as the
701
+ earlier stages: every provider is selected by node **config**, every backend
702
+ package stays host-bound (as-graph never imports an optional backend package),
703
+ every missing binding/driver/model fails closed instead of fabricating a
704
+ resource, and only JSON-safe, secret-free descriptors (R9) are ever persisted.
705
+
706
+ ###### Vector-store matrix (`core.agent.vectorStore`)
707
+
708
+ The vector-store node's `vectorStore` parameter carries a
709
+ `MastraVectorStoreConfig`; `resolveMastraVectorStore` turns it into a live
710
+ mastra `MastraVector` at execution time. Providers, in palette order:
711
+
712
+ | Provider | Backing | Host wiring |
713
+ | --- | --- | --- |
714
+ | `memory` | built-in `InMemoryVectorStore` (dependency-free, offline-capable) | none |
715
+ | `pgvector`, `redis`, `upstash`, `qdrant`, `pinecone`, `supabase`, `mongodb`, `libsql`, `chroma` | mastra-native `MastraVector` constructors (e.g. `@mastra/pg`'s `PGVector`, `@mastra/libsql`'s `LibSQLVector`) | `vectorStoreBindings`, keyed by provider |
716
+ | `age`, `graph` | custom `MastraVector` stores (`DriverBackedVectorStore`) over a host `MastraVectorDriver` | `vectorStoreDrivers`, keyed by provider |
717
+
718
+ Config members:
719
+
720
+ | Member | Meaning |
721
+ | --- | --- |
722
+ | `provider` | One of the twelve providers above; anything else fails with `GRAPH_MASTRA_VECTOR_PROVIDER_UNKNOWN`. |
723
+ | `id` | Optional store id; defaults to `indexName`, then `provider`. |
724
+ | `indexName` / `dimension` / `metric` | The index to create; `metric` is `cosine` (default), `euclidean`, or `dotproduct`. |
725
+ | `embedding` | The embedding adapter carried **in config** (R1): `provider`, `modelId`, optional `credentialRef`, `dimension`, `batchSize`. There is no embedding-provider node kind. |
726
+ | `connection` | Provider connection options. **Never carries credential material** — plaintext credential members (e.g. `password`, `connectionString`) are refused outright — never stripped — with `GRAPH_MASTRA_PLAIN_CREDENTIAL_REFUSED`. |
727
+ | `credentialKey` | The `connection` member the resolved credential populates; defaults to the provider's native option name (table below). Only used with `credentialRef`. |
728
+ | `credentialRef` | `{ credentialId, credentialType }` naming the environment variable (a `MASTRA_*` name is required) in the git-ignored `.env.secret` that carries the credential. Required for `pgvector` (PostgreSQL authenticates every connection); optional elsewhere — a passwordless local `redis` stays usable. |
729
+
730
+ Default credential-injection members (the `credentialKey` when unset):
731
+
732
+ | Provider | Default `credentialKey` |
733
+ | --- | --- |
734
+ | `pgvector`, `redis`, `mongodb` | `password` |
735
+ | `upstash` | `token` |
736
+ | `qdrant`, `pinecone`, `chroma` | `apiKey` |
737
+ | `supabase` | `serviceRoleKey` |
738
+ | `libsql` | `authToken` |
739
+
740
+ Fail-closed behaviour (C6): an unbound mastra-native provider fails with
741
+ `GRAPH_MASTRA_VECTOR_UNAVAILABLE` (the message names the exact binding to
742
+ supply, e.g. `@mastra/qdrant QdrantVector`), an unknown provider with
743
+ `GRAPH_MASTRA_VECTOR_PROVIDER_UNKNOWN`, and an absent or unresolvable
744
+ credential with `GRAPH_MASTRA_CREDENTIALS_UNAVAILABLE`. A resolved store emits
745
+ the JSON-safe descriptor `{ type: "mastra.vectorStore", provider, id, … }`
746
+ (R9) — the live `MastraVector` is never persisted, only the descriptor is.
747
+
748
+ ###### The AGE custom driver (`MastraAgeVectorDriver`)
749
+
750
+ Apache AGE has no stock mastra binding, so the `age` provider resolves through
751
+ a host driver. `createMastraAgeVectorDriver({ client, graphName?, tablePrefix? })`
752
+ is the reference driver exported from `@decaf-ts/as-graph/mastra`:
753
+
754
+ - `client` is a `MastraVectorSqlClient` (`query(sql, params)`) — the host owns
755
+ the Postgres connection (typically `pg`'s `Pool`/`Client`) and its
756
+ credentials; as-graph never imports a Postgres client package.
757
+ - On first use the driver idempotently verifies the `age` extension, creates
758
+ the graph (`ag_catalog.create_graph`, default `as_graph_age_vectors`) when
759
+ absent, and creates the `<prefix>_indexes`/`<prefix>_vectors` tables inside
760
+ the graph schema; a missing extension or a failed setup fails closed with
761
+ `GRAPH_MASTRA_VECTOR_UNAVAILABLE` — never a silent fallback to another
762
+ backend.
763
+ - Vectors are stored as `double precision[]` and metadata as `jsonb`; the
764
+ cosine/euclidean/dotproduct scores are computed in-process, so the driver
765
+ works on any AGE-enabled PostgreSQL without the `pgvector` extension. Every
766
+ value is bound as a query parameter, and `graphName`/`tablePrefix` must be
767
+ plain SQL identifiers.
768
+ - The `graph` provider is the same custom-store pattern with a host-injected
769
+ driver: implement `MastraVectorDriver` over your own store and pass it as
770
+ `vectorStoreDrivers.graph`.
771
+
772
+ ###### Memory matrix (`core.agent.memory`)
773
+
774
+ The memory node resolves a `MastraMemoryConfig` into mastra's own `Memory`
775
+ (`@mastra/memory`) over a config-selected storage backend:
776
+
777
+ | Provider | Backing | Host wiring |
778
+ | --- | --- | --- |
779
+ | `memory` | mastra's `InMemoryStore` baseline | none |
780
+ | `libsql`, `pg` | mastra-native `LibSQLStore` / `PostgresStore` | none (statically imported peer packages) |
781
+ | `mongodb`, `upstash`, `cloud`, `d1`, `dynamodb`, `convex`, `astra`, `redis` | mastra-native storage stores (`MongoStore`, `UpstashStore`, …) | `memoryStorageBindings`, keyed by provider |
782
+
783
+ Config members: `id`, `threadId`, `resourceId`, `lastMessages`,
784
+ `semanticRecall`, `workingMemoryTemplate` (enables mastra working memory with
785
+ that template), `generateTitle`, and the advanced `memoryOptions` passthrough
786
+ (named fields override the same key), plus the same credential gate as vector
787
+ stores (`connection` never carries plaintext credentials; `credentialRef`
788
+ names a `MASTRA_*` environment variable; `credentialKey` overrides the
789
+ injection member). Provider-specific requirements, both fail-closed with
790
+ `GRAPH_MASTRA_MEMORY_UNAVAILABLE`: `pg` needs a complete non-secret host
791
+ config (`host`, `port`, `database`, `user`) **plus** its `credentialRef` (a
792
+ `connectionString` is not an accepted alternative), and `libsql` needs a
793
+ `connection.url` (e.g. `file:./agent-memory.db`). An unknown provider fails
794
+ with `GRAPH_MASTRA_MEMORY_PROVIDER_UNKNOWN`.
795
+
796
+ **Semantic-recall host seam.** A `semanticRecall` memory needs a live mastra
797
+ vector store, which the host supplies through the backend config's
798
+ `memoryVectorStore` (and `memoryEmbedder` when the store does not generate
799
+ embeddings itself — mastra's `isSelfEmbedding`). A semantic-recall memory
800
+ without the vector seam fails closed with
801
+ `GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED`; a non-self-embedding store without an
802
+ embedder fails with `GRAPH_MASTRA_MEMORY_EMBEDDER_REQUIRED`. Memory nodes wire
803
+ to agents through the agent node's `memory` zone; the invocation binds to the
804
+ first wired config's `threadId` (fail-closed when no wired memory declares a
805
+ thread). Memory nodes may also carry `memoryId`, which maps onto the config
806
+ `id` so descriptors and host memory maps resolve by the configured id.
807
+
808
+ ###### Processor / guardrail variants
809
+
810
+ Processor and guardrail nodes wire onto the agent node's
811
+ `inputProcessors`/`outputProcessors` zones and resolve to real
812
+ `@mastra/core/processors` instances; guardrails compose with the
813
+ output-processor pipeline, and resolution follows document edge order, so the
814
+ pipeline order is deterministic:
815
+
816
+ | Zone | `processorType` / `guardrailType` values |
817
+ | --- | --- |
818
+ | Input | `unicodeNormalizer`, `languageDetector`*, `piiDetector`*, `promptInjectionDetector`*, `systemPromptScrubber`*, `tokenCostControl`, `modelSelection` |
819
+ | Output | `tokenLimiter`, `toolCallFilter`, `regexFilter`, `responseCache`, `batchParts`, `providerHistoryCompat`, `cyberRefusalHandler`, `prefillErrorHandler`, `streamErrorRetry`, `unsupportedFileHandler` |
820
+ | Guardrail | `moderation`*, `piiDetector`*, `promptInjectionDetector`*, `regexFilter` |
821
+
822
+ \* Model-carrying variants take their classifier as `modelAdapter` config
823
+ (R1): the host `resolveProcessorModel` hook resolves it to a live model,
824
+ otherwise the composed `<provider>/<modelId>` id is used; without either, the
825
+ node fails closed with `GRAPH_MASTRA_PROCESSOR_UNAVAILABLE`.
826
+
827
+ JSON-config-only constraints (the node vocabulary carries no live objects):
828
+
829
+ - `tokenCostControl` requires a positive numeric `options.maxCost`.
830
+ - `modelSelection` requires at least two `choices`, each with non-empty
831
+ `criteria` and a valid `modelAdapter`; its classifier **decision model**
832
+ must come from the host `resolveProcessorModel` hook (mastra validates the
833
+ classifier structurally — a language-model id cannot serve as one),
834
+ otherwise the node fails closed with `GRAPH_MASTRA_PROCESSOR_UNAVAILABLE`.
835
+ - `regexFilter` rule `pattern`s may be given as strings (documents are JSON)
836
+ and are compiled into `RegExp`s with the optional rule `flags`; a pattern
837
+ that is neither a `RegExp` nor a compiling string fails closed.
838
+ - `providerHistoryCompat` refuses `additionalRules` and all options
839
+ (compatibility rules contain functions/regexes that are not
840
+ JSON-serializable; the built-in mastra rules stay active);
841
+ `cyberRefusalHandler`, `prefillErrorHandler`, and `unsupportedFileHandler`
842
+ take no options at all; `streamErrorRetry` refuses `matchers` (predicates
843
+ are not JSON-serializable — only its numeric/boolean retry knobs are
844
+ supported).
845
+
846
+ ###### Node descriptors and capability rows
847
+
848
+ - `core.agent.vectorStore` gains the `embedding` (object) and `credentialKey`
849
+ (text) CRUD fields alongside its existing provider/index fields.
850
+ - `core.agent.memory` gains the `credentialKey` field, its `provider` select
851
+ lists the full storage matrix, and an unknown provider now fails closed
852
+ with `GRAPH_MASTRA_MEMORY_PROVIDER_UNKNOWN` instead of silently defaulting
853
+ to `memory`.
854
+ - The Mastra capability table (`MASTRA_FEATURE_CAPABILITIES`) gained the
855
+ `memoryStorage` and `processorVariants` rows (both `SUPPORTED`), and the
856
+ `vectorStores` row now names all twelve providers.
857
+
858
+ ###### Walkthrough: a RAG graph against PGVector / Redis / AGE / Graph via config
859
+
860
+ The acceptance criterion is "a RAG graph runs against PGVector, Redis, AGE and
861
+ Graph stores via config-selected bindings". Everything below is config — the
862
+ same document shape works for every provider; only the store wiring changes.
863
+
864
+ 1. **Stand up the backend fixture** (the live-test Docker precedent):
865
+
866
+ ```bash
867
+ # PGVector (pgvector extension image; publishes :5432 on the Docker host)
868
+ docker run -d --name asgraph-pgvector -p 55441:5432 \
869
+ -e POSTGRES_PASSWORD=postgres pgvector/pgvector:pg17
870
+ # Apache AGE (AGE extension image; publishes :5432 on the Docker host)
871
+ docker run -d --name asgraph-age -p 55442:5432 \
872
+ -e POSTGRES_PASSWORD=postgres apache/age:release_PG17_1.7.0
873
+ # From a containerized host the endpoints are the Docker bridge gateway
874
+ # (172.17.0.1); from a normal host they are 127.0.0.1.
875
+ ```
876
+
877
+ 2. **Reference credentials by name**, never in the document — put the value
878
+ in the git-ignored `.env.secret`:
879
+
880
+ ```bash
881
+ MASTRA_PGVECTOR_PASSWORD=postgres # or your own MASTRA_* variable name
882
+ ```
883
+
884
+ 3. **Author the vector-store config** on a `core.agent.vectorStore` node
885
+ (the same config the retriever/chain steps consume through the store's
886
+ `resource` port):
887
+
888
+ ```jsonc
889
+ {
890
+ "provider": "pgvector",
891
+ "indexName": "docs",
892
+ "dimension": 1536,
893
+ "metric": "cosine",
894
+ "embedding": { "provider": "openai", "modelId": "text-embedding-3-small" },
895
+ "connection": { "host": "172.17.0.1", "port": 55441, "database": "test", "user": "postgres", "schemaName": "public" },
896
+ "credentialRef": { "credentialId": "MASTRA_PGVECTOR_PASSWORD", "credentialType": "password" }
897
+ }
898
+ ```
899
+
900
+ Switching to `redis`, `age`, or `graph` changes `provider` and
901
+ `connection` only; `age` needs no `pgvector` extension — only the AGE
902
+ extension and its graph (see the driver section above).
903
+
904
+ 4. **Wire the host bindings** once at backend initialization:
905
+
906
+ ```typescript
907
+ import { PgVector } from "@mastra/pg"; // the host installs backend packages
908
+ import { createMastraAgeVectorDriver } from "@decaf-ts/as-graph/mastra";
909
+
910
+ await backend.initialize({
911
+ // …mastra runtime, agents, RAG ports (see "Real RAG & sandbox execution")…
912
+ vectorStoreBindings: {
913
+ pgvector: PgVector,
914
+ // redis/upstash/qdrant/pinecone/supabase/mongodb/libsql/chroma likewise
915
+ },
916
+ vectorStoreDrivers: {
917
+ age: createMastraAgeVectorDriver({ client: myPgPool }),
918
+ graph: myGraphVectorDriver,
919
+ },
920
+ // memory matrix: non-built-in storage + the semantic-recall seam
921
+ memoryStorageBindings: { mongodb: MongoStore /* … */ },
922
+ memoryVectorStore: myMastraVector, // required by semanticRecall memories
923
+ memoryEmbedder: myEmbeddingModel, // when the vector store doesn't embed itself
924
+ });
925
+ ```
926
+
927
+ 5. **Run the live driver tests** (the suites skip honestly when the
928
+ endpoints are unset):
929
+
930
+ ```bash
931
+ GRAPH_IT_PGVECTOR_HOST=172.17.0.1 GRAPH_IT_AGE_HOST=172.17.0.1 \
932
+ npm run test:integration:mastra
933
+ ```
934
+
935
+ The resolution flow these steps exercise:
936
+
937
+ ```mermaid
938
+ sequenceDiagram
939
+ autonumber
940
+ participant Doc as Graph document
941
+ participant Res as resolveMastraVectorStore
942
+ participant Bind as Host bindings
943
+ participant Store as Live MastraVector
944
+
945
+ activate Doc
946
+ Doc->>Res: vectorStore config (provider, embedding, credentialRef)
947
+ activate Res
948
+ Res->>Bind: binding/driver lookup
949
+ activate Bind
950
+ Bind-->>Res: constructor | driver | undefined
951
+ deactivate Bind
952
+ alt binding or driver missing
953
+ Res-->>Doc: fail-closed GraphExecutionError
954
+ else resolved
955
+ Res->>Store: construct (connection, resolved credential)
956
+ activate Store
957
+ Store-->>Res: live store
958
+ deactivate Store
959
+ Res-->>Doc: store + secret-free descriptor (R9)
960
+ end
961
+ deactivate Res
962
+ deactivate Doc
963
+ ```
964
+
965
+ ##### Mastra compatibility surface (SAA-836)
966
+
967
+ Beyond the backend itself, the `@decaf-ts/as-graph/mastra` entrypoint exports
968
+ the full compatibility surface built across the SAA-836 slices:
969
+
970
+ - **Authoring builders** — `MastraAgentBuilder` (fluent facade over
971
+ `GraphWorkflowDocumentBuilder` producing valid `core.agent` documents, wiring
972
+ the agent zones: `tools`, `memory`, `skill`, `scorers`, `hooks`, `sandbox`,
973
+ `embedding`, `inputProcessors`, `outputProcessors`) and `MastraToolBuilder`
974
+ (the same contract for `core.agent.tool` documents), plus
975
+ `MastraToolConfig`/`MastraToolDecorator` for tool authoring.
976
+ - **Memory and vector layers** — `MastraMemory` (mastra memory wiring over
977
+ `@mastra/memory`, including the `memorySelector` decision sub-flow; the
978
+ Stage 4 storage matrix resolves every mastra-native backend, with the host
979
+ `memoryVectorStore`/`memoryEmbedder` seam for semantic recall) and
980
+ `MastraVectorStore` (the Stage 4 twelve-provider matrix: the built-in
981
+ `InMemoryVectorStore` baseline, host-bound mastra-native constructors, and
982
+ `DriverBackedVectorStore`/`MastraAgeVectorDriver` for the custom
983
+ `age`/`graph` stores — see the
984
+ [Stage 4 mastra breadth](#stage-4-mastra-breadth-saa-749-vector-store-matrix-memory-matrix-processor-variants)
985
+ section). Backend configs never carry
986
+ credential values (SAA-911 F4, gate C): plaintext credential members in a
987
+ config's `connection` options are refused outright — never stripped — with
988
+ `GRAPH_MASTRA_PLAIN_CREDENTIAL_REFUSED`, and `pg`/`pgvector` (and a
989
+ credentialed `redis`) resolve their password only through a `credentialRef`
990
+ whose `credentialId` names the `.env.secret` variable carrying it (see the
991
+ Mastra engine environment section below); the value is resolved from the
992
+ host environment only at backend-construction time.
993
+ - **Real RAG/sandbox execution (SAA-747 Stage 2)** — `MastraRagStepHandlers`
994
+ (`createMastraRagStepHandlers`, the `MASTRA_RAG_EXECUTION_KINDS` /
995
+ `MASTRA_SANDBOX_EXECUTION_KINDS` kind tables, the host
996
+ `MastraRagEmbedder`/`MastraRagTextGenerator`/`MastraSandboxRunner` ports,
997
+ and `mastraEmbeddingConfigOf`) — see "Real RAG & sandbox execution
998
+ (SAA-747 Stage 2)" above for the execution contract and the fail-closed
999
+ `GRAPH_MASTRA_RAG_UNAVAILABLE` / `GRAPH_MASTRA_EMBEDDING_UNAVAILABLE` /
1000
+ `GRAPH_MASTRA_SANDBOX_UNAVAILABLE` / `GRAPH_CODE_SANDBOX_TIMEOUT` codes.
1001
+ - **Processors** — `MastraAgentProcessors` (input/output processor and
1002
+ guardrail wiring, with the host-supplied `resolveProcessorModel` model hook;
1003
+ the Stage 4 variant vocabularies add `tokenCostControl`/`modelSelection` on
1004
+ input and the JSON-config-safe output variants — see the
1005
+ [Stage 4 mastra breadth](#stage-4-mastra-breadth-saa-749-vector-store-matrix-memory-matrix-processor-variants)
1006
+ section for the per-variant constraints).
1007
+ - **Human-in-the-loop and voice** — `MastraHitlStepHandler` (the
1008
+ `core.agent.hitl` suspend/resume handler) and `MastraVoiceStepHandler`
1009
+ (`core.agent.voice`, failing closed with `GRAPH_MASTRA_VOICE_UNAVAILABLE`
1010
+ when no voice wiring is supplied).
1011
+ - **Triggers and channel responses** — `MastraMcpTrigger` (MCP server trigger,
1012
+ fail-closed `GRAPH_MASTRA_MCP_UNAVAILABLE`, with the run-scoped
1013
+ `MastraMcpDeliveryGuard` (C6, SAA-747 Stage 2) handed to
1014
+ `createMcpServer(descriptor, guard)`: timing-safe token or HMAC-SHA256
1015
+ delivery auth (`MastraMcpAuthMode`, read by `mastraMcpAuthConfigOf` from the
1016
+ node's `authMode`/`authCredentialRef` fields — the credential reference
1017
+ names a `MASTRA_*` environment variable and never carries the secret; when
1018
+ the node names no credential the run generates a scoped secret the host
1019
+ publishes to its clients), a concurrent pending-delivery cap (`pendingCap`,
1020
+ default 256) with age pruning (`pendingTimeoutMs`, default 60000) — excess
1021
+ refusals fail closed with `GRAPH_MASTRA_MCP_UNAVAILABLE` — and an exposed
1022
+ run-scoped server id that is never the document-carried `serverId`),
1023
+ `MastraScheduleTrigger`,
1024
+ `MastraChannelTrigger`/`MastraChannelResponse` (Slack/Discord/Telegram/Teams,
1025
+ fail-closed `GRAPH_MASTRA_CHANNEL_UNAVAILABLE` without channel wiring). A
1026
+ channel response delivers to the node's **configured** conversation
1027
+ binding; a wired `threadId` may never override it — a mismatch fails
1028
+ closed with `GRAPH_MASTRA_CHANNEL_THREAD_MISMATCH` (SAA-911 F5).
1029
+ - **Run metrics (S2)** — the read-only metrics layer:
1030
+ `MastraMetricsModels` (run/score/trace rows), `MastraMetricsAdapter`
1031
+ (read-only adapter over the mastra storage), `MastraMetricsStatement` +
1032
+ paginator, `MastraMetricsGateway` (owner-scoped serving), and
1033
+ `MastraRunMetricsEndpoint` (the editor-endpoint delegation behind
1034
+ `GET /graph/workflows/:workflowId/runs`).
1035
+ - **Eval models (O1)** — `MastraEvalModels` (read-only experiments/results
1036
+ models for eval pipelines).
1037
+ - **Observability and persistence** — `MastraObservability` (langfuse exporter
1038
+ wiring; enabled by default and fail-closed without credentials) and
1039
+ `MastraPersistence` (per-layer replay/cache/pin repositories with the
1040
+ `MASTRA__PERSISTENCE__*` adapter routing). Replay snapshots are **versioned
1041
+ and restorable** (row id `${runId}::v${version}`), backing mastra's own
1042
+ time-travel replay; a recording failure never fails a run, while restoring
1043
+ a missing snapshot fails closed. Workflows persist through the as-graph
1044
+ adapter only, versioned with restore.
1045
+ - **Nest wiring** — `MastraGraphExecutionModule` (the mastra `forRoot` module
1046
+ variant of `GraphExecutionModule`).
1047
+
1048
+ The agent-family node kinds themselves (memory, RAG, processors, HITL, voice,
1049
+ triggers, channel responses) are declared under
1050
+ `src/node/agents/**` and registered from their `@node` metadata — see the
1051
+ Agent row of the built-in node-kind table above.
1052
+
1053
+ ##### Mastra engine environment (`.env` / `.env.secret`)
1054
+
1055
+ The mastra engine reads its configuration from the accumulated
1056
+ `@decaf-ts/logging` environment (`MastraEnvironment`), overridable through
1057
+ `MASTRA__*` keys:
1058
+
1059
+ | Key | Default | Purpose |
1060
+ |:----|:--------|:--------|
1061
+ | `MASTRA__ENGINE__ENABLED` | `true` | Enables the mastra engine lane; `false` makes `MastraGraphExecutionBackend.initialize()` fail closed with `GRAPH_MASTRA_ENGINE_DISABLED`. |
1062
+ | `MASTRA__ENGINE__TERMINAL_TIMEOUT_MS` | `300000` | Default run-level terminal timeout for mastra runs (used when the backend config sets no positive `terminalTimeoutMs`). |
1063
+ | `MASTRA__PROVIDER__ENDPOINT` | `""` | Reserved provider config (declared in `MastraEnvironment`; not yet consumed — agents take their model from the node's `modelAdapter` parameter). |
1064
+ | `MASTRA__PROVIDER__MODEL` | `""` | Reserved provider config (declared in `MastraEnvironment`; not yet consumed — agents take their model from the node's `modelAdapter` parameter). |
1065
+ | `MASTRA__CREDENTIALS__API_KEY_ENV` | `MASTRA_PROVIDER_API_KEY` | The **name** of the environment variable that carries the provider credential. |
1066
+ | `MASTRA__OBSERVABILITY__ENABLED` | `true` | Enables the langfuse observability lane; it **fails closed** when enabled and the langfuse credentials are missing, so a mastra boot without `.env.secret` langfuse keys requires `false`. |
1067
+ | `MASTRA__OBSERVABILITY__SERVICE_NAME` | `as-graph-mastra` | Service name attached to observability exports. |
1068
+ | `MASTRA__OBSERVABILITY__ENVIRONMENT` | `""` | Environment label attached to observability exports. |
1069
+ | `MASTRA__OBSERVABILITY__LANGFUSE__ENDPOINT` | `https://cloud.langfuse.com` | Langfuse web/API base URL traces are exported to. |
1070
+ | `MASTRA__OBSERVABILITY__LANGFUSE__PUBLIC_KEY_ENV` / `MASTRA__OBSERVABILITY__LANGFUSE__SECRET_KEY_ENV` | `LANGFUSE_PUBLIC_KEY` / `LANGFUSE_SECRET_KEY` | The **names** of the environment variables carrying the langfuse keys (values live in `.env.secret` and are read only at exporter construction). |
1071
+ | `MASTRA__PERSISTENCE__REPLAYS__ADAPTER` | `fs` | Storage adapter for the replay-snapshot layer (`ram` \| `fs` \| `host`). |
1072
+ | `MASTRA__PERSISTENCE__CACHE__ADAPTER` | `ram` | Storage adapter for the compiled-workflow cache layer. |
1073
+ | `MASTRA__PERSISTENCE__PINS__ADAPTER` | `fs` | Storage adapter for the pinned-values layer. |
1074
+ | `MASTRA__PERSISTENCE__FS__ROOT` | `var/as-graph-mastra` | Base directory for the filesystem adapter's persisted data (a per-adapter-alias sub-directory is created automatically). |
1075
+
1076
+ Host-operator workflow (gate C):
1077
+
1078
+ - **Non-secret config goes in `.env`** — the engine flags and observability /
1079
+ persistence routing. (The `MASTRA__PROVIDER__ENDPOINT` / `MASTRA__PROVIDER__MODEL`
1080
+ keys are declared but reserved — agents take their model from the node's
1081
+ `modelAdapter` parameter.) `.env` is git-ignored and must never be committed.
1082
+ - **The credential value goes in `.env.secret`** — copy the tracked
1083
+ `.env.secret.template` (placeholders only) to `.env.secret`, fill in
1084
+ `MASTRA_PROVIDER_API_KEY` (or point `MASTRA__CREDENTIALS__API_KEY_ENV` at
1085
+ another variable name), and never commit it; `.env.secret` is git-ignored.
1086
+ - **Backend connection credentials are name-referenced too (SAA-911 F4,
1087
+ gate C)** — a `pg` memory provider, a `pgvector` vector store, or a
1088
+ credentialed `redis` vector store declares a `credentialRef` whose
1089
+ `credentialId` NAMES the environment variable carrying the password
1090
+ (placeholders `MASTRA_PG_PASSWORD` / `MASTRA_PGVECTOR_PASSWORD` /
1091
+ `MASTRA_REDIS_PASSWORD` in `.env.secret.template`); the value is resolved
1092
+ from the host environment only at backend-construction time. Plaintext
1093
+ credential members in a config's `connection` options (e.g. `password`,
1094
+ `connectionString`) are refused outright — never stripped — with
1095
+ `GRAPH_MASTRA_PLAIN_CREDENTIAL_REFUSED`. The `pg` memory provider requires
1096
+ a complete non-secret host config (`host`, `port`, `database`, `user`)
1097
+ plus its `credentialRef` — a `connectionString` is no longer an accepted
1098
+ alternative.
1099
+ - **Secrets are referenced by name only.** The graph layer reads the
1100
+ credential by environment-variable name and asserts only its presence —
1101
+ `assertMastraProviderCredentials()` throws
1102
+ `GRAPH_MASTRA_CREDENTIALS_UNAVAILABLE` when the referenced variable is
1103
+ unset or empty (no unauthenticated model traffic is ever attempted), and
1104
+ `hasMastraProviderCredentials()` reports availability without throwing. A
1105
+ secret value is never read into, held by, or persisted in the graph layer.
1106
+
1107
+ ```typescript
1108
+ import {
1109
+ assertMastraProviderCredentials,
1110
+ MastraEnvironment,
1111
+ } from "@decaf-ts/as-graph/mastra";
1112
+
1113
+ MastraEnvironment.mastra.engine.enabled; // MASTRA__ENGINE__ENABLED
1114
+ MastraEnvironment.mastra.provider.endpoint; // MASTRA__PROVIDER__ENDPOINT
1115
+ assertMastraProviderCredentials(); // fails closed without a resolvable credential
1116
+ ```
1117
+
475
1118
  ##### Dagster backend (`@decaf-ts/as-graph/dagster`)
476
1119
 
477
1120
  `DagsterGraphExecutionBackend` translates the canonical document into Dagster
@@ -518,7 +1161,7 @@ Run lifecycle and cached/pinned-value persistence always flows through Decaf rep
518
1161
  | `GraphValueModel` / `GraphValueRepository` | Cached/pinned graph values (must survive restarts for pinning), persisted as `graph_value` rows; per-execution runtime values are not persisted |
519
1162
  | `GraphNodeRepository` | Node-kind catalogue rows (one row per registered kind, persisted as `graph_node`); the `GraphNodeModel` row class lives in `./shared` so backend stores and UI listing/forms share it |
520
1163
  | `RamGraphRunStore` / `RamGraphRunEventStore` | Adapter-backed `GraphRunStore`/`GraphRunEventStore` implementations; construct with an initialized adapter |
521
- | `createRamGraphAdapter(alias?)` | Creates and initializes a `RamAdapter` (tests); production passes a durable adapter (e.g. TypeORM) |
1164
+ | `createRamGraphAdapter(alias?)` | Creates and initializes a `RamAdapter` (tests); production passes a durable adapter — see [Durable Postgres lane](#durable-postgres-lane-decaf-tsas-graphtypeorm) |
522
1165
  | `createGraphValueRepository(adapter)` | Factory for a fresh `GraphValueRepository` instance over the provided adapter |
523
1166
 
524
1167
  ```typescript
@@ -534,6 +1177,50 @@ and must not be used as production persistence. In a NestJS host,
534
1177
  `GraphExecutionModule.forRoot({ valueAdapter, runAdapter })` wires these adapter-backed stores
535
1178
  automatically (see [NestJS](#nestjs)).
536
1179
 
1180
+ #### Durable Postgres lane (`@decaf-ts/as-graph/typeorm`)
1181
+
1182
+ The stores never create an adapter implicitly: development boots persist through the built-in
1183
+ `RamAdapter` (`./ram`), while production hosts must supply a durable adapter for the five as-graph
1184
+ decaf tables (`graph_workflow`, `graph_run`, `graph_run_event`, `graph_node`, `graph_value`) plus the
1185
+ mastra-layer decaf models. The `./typeorm` export is the durable production path (SAA-926 §6.4):
1186
+ `createTypeormGraphAdapter({ dataSource })` builds and initializes a `@decaf-ts/for-typeorm` Postgres
1187
+ adapter and registers it as the current decaf adapter, so the engine's repositories resolve the
1188
+ flavoured entities.
1189
+
1190
+ The factory enforces the production contract on the host config (fail-closed):
1191
+
1192
+ - `type: "postgres"` only — the durable as-graph production path is Postgres.
1193
+ - `synchronize: false` only — the `asgraph` schema is owned by the stack's bootstrap migrations
1194
+ (executed by the `db-migrate` one-shot service as the `mastra_migrator` role); the least-privilege
1195
+ `mastra_app` runtime role must never mutate it, and the factory force-sets the flag regardless.
1196
+ - Credentials are resolved by the host from its environment or Docker secrets — never hard-coded.
1197
+ - The as-graph decaf models are flavoured for TypeORM explicitly, their model modules are imported
1198
+ lazily (importing `./typeorm` never flips a development RAM boot sharing the process), structured
1199
+ Object/Array decaf columns are pinned to `jsonb` so the runtime shape matches the bootstrap DDL 1:1,
1200
+ and the model class is canonicalized before TypeORM entity resolution.
1201
+
1202
+ ```typescript
1203
+ import { createTypeormGraphAdapter } from "@decaf-ts/as-graph/typeorm";
1204
+
1205
+ const adapter = await createTypeormGraphAdapter({
1206
+ dataSource: {
1207
+ type: "postgres",
1208
+ host: "db.internal",
1209
+ port: 5432,
1210
+ username: "mastra_app",
1211
+ password: /* resolved by the host from its environment or Docker secrets */,
1212
+ database: "mastra",
1213
+ schema: "asgraph",
1214
+ synchronize: false,
1215
+ },
1216
+ });
1217
+ ```
1218
+
1219
+ The standalone host selects this lane with `GRAPH_DB_DRIVER=postgres` — the connection is resolved
1220
+ from the environment/Docker secrets (`GRAPH_DB_URL`, or `GRAPH_DB_HOST`/`GRAPH_DB_PORT`/
1221
+ `GRAPH_DB_USER`/`GRAPH_DB_DATABASE` plus `GRAPH_DB_PASSWORD_FILE`; see the standalone-host
1222
+ environment table under [Running each backend + UI combination](#running-each-backend--ui-combination)).
1223
+
537
1224
  #### Consuming `shared` from a UI
538
1225
 
539
1226
  A UI bundle imports only from `@decaf-ts/as-graph/shared` and stays engine-free:
@@ -567,7 +1254,12 @@ manifests, documents and engine run results into DOM-free render inputs.
567
1254
  (`GET /graph/node-types`, `GET /graph/node-types/:kind`, `POST /graph/node-types/:kind/resolve`), canonical
568
1255
  workflow persistence (`PUT|GET /graph/workflows/:workflowId`, `GET /graph/workflows` ownership-filtered
569
1256
  summaries, `POST /graph/workflows/validate`), the asynchronous run lifecycle (`POST /graph/runs` → `202`,
570
- `GET /graph/workflows/:workflowId/runs` per-workflow run listing, `GET /graph/runs/:runId/events` SSE,
1257
+ `GET /graph/workflows/:workflowId/runs` per-workflow run listing — with optional
1258
+ `page`/`perPage` query params (`400` on non-integer or `< 1` values), and,
1259
+ when the active backend is mastra and the workflow is mastra-owned, serving the
1260
+ owner-scoped agent run-metrics page envelope `{ data, current, total, count }`
1261
+ through the metrics gateway instead of local run rows,
1262
+ `GET /graph/runs/:runId/events` SSE,
571
1263
  `DELETE /graph/runs/:runId`), and the read-only engine capability API (`GET /graph/engines`,
572
1264
  `GET /graph/engines/:engineId`, `GET /graph/engines/:engineId/workflows`,
573
1265
  `GET /graph/engines/:engineId/workflows/:workflowId`).
@@ -593,7 +1285,7 @@ dynamic engine output. The manifest shape:
593
1285
  engineId: "local", // backend flavour (allowlisted id)
594
1286
  displayName: "Local (built-in)",
595
1287
  local: true,
596
- pinnedEngineVersion: "built-in", // "1.13.25" for dagster, "1.74.0" for mastra
1288
+ pinnedEngineVersion: "built-in", // "1.13.25" for dagster, MASTRA_PINNED_VERSION ("1.74.0") for mastra — the peer dependency contract is @mastra/core ^1.77.0
597
1289
  capabilities: [
598
1290
  { feature: "codeMode", verdict: "SUPPORTED", detail?: "…" },
599
1291
  { feature: "workflowList", verdict: "NOT_SUPPORTED" },
@@ -652,6 +1344,34 @@ import { KeycloakAuthHandler } from "@decaf-ts/integrations/nest";
652
1344
  export class AppModule {}
653
1345
  ```
654
1346
 
1347
+ ##### Graph serving authentication (`@Public()` and the enforcement chain)
1348
+
1349
+ All four graph serving controllers — `GraphRunController`, `GraphWorkflowController`,
1350
+ `GraphNodeCatalogueController`, and `GraphEngineController` — carry `@Public()` from
1351
+ `@decaf-ts/for-nest`, opting their routes out of the global `AuthInterceptor` that
1352
+ `DecafAuthModule.forRoot` installs when `authGlobal` is `true`. Without the marker, that
1353
+ interceptor's `authHandler.authorize(...)` gate ran before the controllers' own
1354
+ route-level policy could apply, and its `AuthorizationError` — a decaf error, not a Nest
1355
+ `HttpException` — surfaced the intended `401` as a generic `500`.
1356
+
1357
+ `@Public()` is not an anonymous-access grant. The authoritative enforcement chain is:
1358
+
1359
+ 1. **Context priming** — the for-nest `AuthMiddleware` still runs and calls
1360
+ `authHandler.prime(...)`, putting the authenticated `user`, `roles`, `namespaces`,
1361
+ and `organization` on the `DecafRequestContext`.
1362
+ 2. **Surface policy** — each controller's `requireAuthenticatedContext()` enforces the
1363
+ per-API `auth` option: the `"required"` default rejects a request with no request
1364
+ context or no resolved owner user with `401`; `"optional"` admits anonymous callers
1365
+ for standalone runs.
1366
+ 3. **Engine authorization** — `GraphAuthValidator` authorizes the workflow-level
1367
+ requirements and every plan node's required namespaces/roles against the primed
1368
+ principal and fails closed with `ForbiddenError` before any node executes.
1369
+ 4. **Ownership checks** — service-level rules (never a controller option) gate the
1370
+ data: the `allowAnonymousAccess` tolerance widens *read* visibility of owner-less
1371
+ resources only, payload projection (`inputs`/`result`/`error` on run rows) is served
1372
+ on owner equality, and writes (workflow overwrites, run cancellation) require strict
1373
+ owner equality.
1374
+
655
1375
  #### Running each backend + UI combination
656
1376
 
657
1377
  The standalone host (`bin.as-graph-server`, `lib/cjs/nest/graph/main.cjs`) boots exactly one engine
@@ -679,6 +1399,11 @@ the backend and the UI together with `concurrently`.
679
1399
  | `GRAPH_BACKEND_PORT` | `3000` | Backend HTTP port (the standalone binary also accepts the port as its first argument) |
680
1400
  | `DAGSTER_GRAPHQL_URL` | unset | Read-only Dagster client target. Without it the dagster backend still boots and serves the manifest, but the catalogue reports `NOT_SUPPORTED` (`501`) |
681
1401
  | `DAGSTER_EXECUTION_ENABLED` | `false` | Opt-in gate for launching/replaying existing Dagster runs |
1402
+ | `GRAPH_DB_DRIVER` | unset | `postgres` boots the durable TypeORM/Postgres adapter (SAA-926 §6.4); anything else keeps the development `RamAdapter` posture |
1403
+ | `GRAPH_DB_URL` | unset | Full Postgres DSN for the durable lane — an alternative to the parts below plus the password file |
1404
+ | `GRAPH_DB_HOST` / `GRAPH_DB_PORT` / `GRAPH_DB_USER` / `GRAPH_DB_DATABASE` | — / `5432` | Durable-lane connection parts used when `GRAPH_DB_URL` is unset; an incomplete set fails closed at boot |
1405
+ | `GRAPH_DB_PASSWORD_FILE` | `/run/secrets/postgres_app_password` | Docker secret file carrying the `mastra_app` runtime password (the value is never logged) |
1406
+ | `GRAPH_DB_SCHEMA` | `asgraph` | Postgres schema owning the as-graph decaf tables |
682
1407
  | `GRAPH_BACKEND_URL` | `http://localhost:3000` | for-angular injection token for the backend base URL (a provider override, not an env var) |
683
1408
 
684
1409
  The host binds to `127.0.0.1` and only admits `http://localhost`/`http://127.0.0.1` CORS origins
@@ -690,7 +1415,10 @@ The standalone host seeds the demo workflow fixture registry into whichever
690
1415
  engine it boots: `loadGraphDemoWorkflows()` (exported from
691
1416
  `@decaf-ts/as-graph/nest`) imports the `graphWorkflowFixtures` registry from
692
1417
  `src/workflows` and passes its canonical documents as `seedWorkflows`, so each
693
- driver's catalogue lists the full fixture set out of the box. The registry is
1418
+ driver's catalogue lists the full fixture set out of the box. Operators can
1419
+ suppress boot-time seeding with `GRAPH_SEED_DEMO=off` (also
1420
+ `false`/`0`/`no`/`disabled`) — any other value (or an unset variable) keeps the
1421
+ default on. The registry is
694
1422
  test-only content — `npm pack` excludes `lib/**/workflows` — so a
695
1423
  release-packaged host boots with an empty seed set and its catalogues behave
696
1424
  exactly as before (the mastra catalogue starts empty; the dagster catalogue
@@ -718,8 +1446,19 @@ workflows persisted in the backend's local engine store, including the seeded de
718
1446
 
719
1447
  ##### Mastra
720
1448
 
721
- In-process; the only prerequisite is the `@mastra/core` peer dependency (pinned `^1.77.0`),
722
- resolved by `npm install` in `as-graph`. The host lazily builds a real `@mastra/core` runtime.
1449
+ In-process; the prerequisites are the `@mastra/core` peer dependency (`^1.77.0`,
1450
+ resolved by `npm install` in `as-graph`, alongside the optional `@mastra/memory`,
1451
+ `@mastra/libsql`, and `@mastra/pg` peers consumed by the memory/vector-store
1452
+ layers) and the langfuse credentials (`LANGFUSE_PUBLIC_KEY` /
1453
+ `LANGFUSE_SECRET_KEY` in `.env.secret`) — the observability lane is on by
1454
+ default and fails closed without them; disable it with
1455
+ `MASTRA__OBSERVABILITY__ENABLED=false`. The host lazily builds a real
1456
+ `@mastra/core` runtime. The standalone host's mastra wiring declares an
1457
+ explicit `InMemoryStore` (development posture); a production host must
1458
+ configure Mastra storage explicitly and durably through
1459
+ `MastraBackendConfig.storage` and verify
1460
+ `backend.storageStatus.domains.workflows === "durable"` (see the
1461
+ [Mastra backend](#mastra-backend-decaf-tsas-graphmastra) section).
723
1462
 
724
1463
  ```bash
725
1464
  npm run start:backend:mastra # engine: mastra, still on :3000
@@ -737,7 +1476,7 @@ host-injected `DagsterClient` built from `DAGSTER_GRAPHQL_URL`. Provision the pi
737
1476
  (Docker; Dagster `1.13.25`) with the integration harness:
738
1477
 
739
1478
  ```bash
740
- # as-graph: boot + seed the pinned gateway and persist its GraphQL URL
1479
+ # as-graph: boot the integration service matrix + the pinned gateway (its GraphQL URL is persisted to the it-env file)
741
1480
  npm run prepare-it-tests # publishes the gateway at http://127.0.0.1:3300/graphql
742
1481
  DAGSTER_GRAPHQL_URL=http://127.0.0.1:3300/graphql npm run start:backend:dagster
743
1482
  npm run teardown-it-tests # when done
@@ -774,7 +1513,9 @@ with an empty seed set answers `501` (`NOT_SUPPORTED`). To run against an alread
774
1513
 
775
1514
  The dagster suite needs the gateway fixture (`prepare-it-tests`) and Docker; it skips honestly when
776
1515
  no gateway is prepared. The standalone-binary boot test needs the `lib/cjs` build and skips when it
777
- is absent.
1516
+ is absent. All integration suites resolve their live endpoints from the service matrix booted by
1517
+ `npm run prepare-it-tests` (see [Integration service matrix](#integration-service-matrix)); absent
1518
+ infra is skipped honestly rather than faked.
778
1519
 
779
1520
  #### Scripts
780
1521
 
@@ -786,10 +1527,13 @@ is absent.
786
1527
  | `npm run start:backend:dagster` | Boot the standalone host with the Dagster engine (`GRAPH_BACKEND_ENGINE=dagster`) |
787
1528
  | `npm run test:integration:standard` / `:mastra` / `:dagster` | Run one engine variant's integration suite |
788
1529
  | `npm run test:integration:backend` | Run the host-boot integration suite (all variants + standalone binary) |
789
- | `npm run prepare-it-tests` / `teardown-it-tests` | Provision / stop the pinned Dagster gateway fixture |
1530
+ | `npm run prepare-it-tests` / `teardown-it-tests` | Boot / stop the integration service matrix (`docker/tests-compose.yml`, 12 services), the pinned Dagster gateway fixture, and — when the sibling `integrations` checkout is present — its Postgres harness on `:55435` — see [Integration service matrix](#integration-service-matrix) |
790
1531
  | `npm run test:unit` / `test:integration` / `test:e2e` | Run the Jest unit / integration / e2e suites |
791
- | `npm run test:all` | Run the entire Jest suite (unit, integration, e2e) |
792
- | `npm run test:dist` | Re-run the full suite against the compiled `lib` and `dist` outputs |
1532
+ | `npm run test:unit:pdf` | Run the `ReadPDFNode` unit suite through `jest.pdf.config.cjs`; `pdf-parse`'s `pdfjs-dist` fake worker needs the Node `--experimental-vm-modules` runtime, so the file stays excluded from the default Jest config and runs first in `test:all` (and therefore in `test`, `test:dist`, `coverage`, `prepare-pr`, and `prepare-release`) |
1533
+ | `npm run test:evals` | Run the standalone eval suite (`jest -c jest.eval.config.cjs` over `tests/evals/*.eval.ts`; never picked up by the main Jest config) |
1534
+ | `npm run test:all` | Run the entire Jest suite (unit, integration, e2e) plus the `test:unit:pdf` lane |
1535
+ | `npm run test:dist` | Re-run the full suite against the compiled artifacts: a `TEST_TARGET=lib` pass retargets every source-relative import to `lib/cjs` through `scripts/jest-target-resolver.cjs` (run `npm run build` first — a missing emitted file fails loudly), then a `TEST_TARGET=dist` pass exercises the rolled-up `dist/as-graph.cjs` bundle through `tests/unit/ts-workspace.test.ts` (the bundle exposes only the package barrel, so the deep-import suites stay on the lib pass). See [Test target selection](#test-target-selection) |
1536
+ | `npm run prepare-pr` / `prepare-release` | Lint-fix, production build, coverage, and the docs build; `prepare-release` additionally runs both `test:dist` target passes so the release is certified against `lib` and `dist`, not just the sources |
793
1537
  | `npm run test:circular` | Check the source for circular dependencies |
794
1538
  | `npm run coverage` | Test run with coverage into `workdocs/reports/coverage` |
795
1539
  | `npm run lint` / `lint-fix` | ESLint |
@@ -797,6 +1541,92 @@ is absent.
797
1541
  | `npm run uml` / `drawings` | Render `workdocs/uml/*.puml` and `workdocs/drawings/*.drawio` into `workdocs/resources` |
798
1542
  | `repo:readme` | Regenerate `README.md` from `workdocs/Readme.md` |
799
1543
 
1544
+ ##### Test target selection
1545
+
1546
+ `TEST_TARGET` selects which build of the package a Jest run loads — the Decaf
1547
+ workspace convention `src | lib | dist`, resolved by
1548
+ `tests/workspace-target.ts`:
1549
+
1550
+ - `src` (the default, and any unset value) resolves the TypeScript sources —
1551
+ the historical source-mode resolution, unchanged.
1552
+ - `lib` retargets every source-relative import landing under `src/` to the
1553
+ matching emitted file under `lib/cjs` through
1554
+ `scripts/jest-target-resolver.cjs`, wired as the Jest `resolver` in
1555
+ `jest.config.cjs` (with `cjs` added to `moduleFileExtensions`). Run
1556
+ `npm run build` first: the resolver fails loudly instead of silently mixing
1557
+ sources into the lib pass.
1558
+ - `dist` loads the rolled-up `dist/as-graph.cjs` / `dist/as-graph.js` bundle
1559
+ through `tests/unit/ts-workspace.test.ts`. The bundle intentionally exposes
1560
+ only the package barrel, so the deep-import suites cannot run against it —
1561
+ the dist pass pins the public surface (exports, built-in kinds, engine
1562
+ wiring) while the lib pass exercises the emitted modules.
1563
+
1564
+ `npm run test:dist` runs the entire suite once per target (lib, then dist), and
1565
+ `npm run prepare-release` runs coverage plus both target passes before the docs
1566
+ build.
1567
+
1568
+ #### Integration service matrix
1569
+
1570
+ The integration suites and `npm run coverage` run against the
1571
+ production-grade service matrix booted by `npm run prepare-it-tests`
1572
+ (SAA-1142):
1573
+
1574
+ - **Compose file:** `docker/tests-compose.yml` (compose project
1575
+ `as-graph-it`), 12 services — Postgres 16, PGVector (pg 17), Apache AGE
1576
+ (pg 17), MySQL 8, SQL Server 2022, Redis, RabbitMQ 3.13 (AMQP on `55672`,
1577
+ `asgraph`/`asgraph`, management plugin), MinIO (S3), fake-gcs-server
1578
+ (GCS), Azurite (Azure Blob), SFTP (atmoz/sftp), and Mailpit (SMTP sink) —
1579
+ plus the pinned Dagster gateway fixture built by `tests/integration/dagster`
1580
+ and, when the sibling `integrations` checkout is present, its Postgres
1581
+ harness (`decaf-postgres-integration`, published on `:55435`; required by
1582
+ the RLS credential suites, skipped gracefully when the checkout is absent).
1583
+ - **Contract:** every endpoint is probed before the script succeeds, and the
1584
+ resolved endpoints are written to the git-ignored
1585
+ `var/as-graph-it/.it-env.json`, which `tests/integration/it-env.setup.cjs`
1586
+ loads for every Jest run (without overriding a value the caller already
1587
+ exported). The Dagster gateway is published at
1588
+ `http://127.0.0.1:3300/graphql` on a plain host
1589
+ (`http://127.0.0.1:3000/graphql` inside a containerized runner).
1590
+ - **Knobs:** `AS_GRAPH_IT_HOST` overrides the service host (a containerized
1591
+ runner defaults to the Docker bridge gateway `172.17.0.1`, a plain host to
1592
+ `127.0.0.1`), `AS_GRAPH_IT_SKIP_BUILD=1` reuses an existing `lib` build
1593
+ for a fast infra-only re-prepare, and `INTEGRATIONS_DIR` overrides the
1594
+ location of the sibling `integrations` checkout whose Postgres harness
1595
+ `prepare-it-tests` boots (default: `../integrations`).
1596
+ - **Teardown:** `npm run teardown-it-tests` stops the gateway, the service
1597
+ matrix, and the sibling integrations Postgres harness (when its checkout is
1598
+ present), keeping the named volumes so the next prepare is fast; pass
1599
+ `--volumes` for a full reset of service state.
1600
+ - **Honest skips:** without the booted matrix the live suites skip honestly.
1601
+ Suites needing a real external SaaS credential (GitHub, GitLab, Airtable,
1602
+ Gmail, Slack, Teams, Telegram, Google Sheets, and the Stage 5c vendor live
1603
+ cases — Discord, WhatsApp, Outlook, Confluence, Jira, Google Docs, Google
1604
+ Calendar, Microsoft Excel, Microsoft SharePoint) stay skipped until that
1605
+ credential is configured — the harness never fabricates one and never
1606
+ starts a vendor stub in place of live infrastructure, and each skip title
1607
+ names the exact missing env var. The Stage 5c vendor suites' behavioural
1608
+ cases always run against process-local loopback HTTP stubs (no provider is
1609
+ ever contacted), so only their read-only live cases depend on a credential.
1610
+
1611
+ Docker (with a reachable daemon) and devDependencies are the only
1612
+ prerequisites.
1613
+
1614
+ #### Test environment prerequisites
1615
+
1616
+ The test and documentation lanes need the declared `devDependencies` present in `node_modules`. An
1617
+ install made under `NODE_ENV=production` (where npm defaults to `--omit=dev`) leaves them out and
1618
+ produces module-resolution failures that are install gaps, not product regressions:
1619
+
1620
+ - `@nestjs/testing` missing — `tests/unit/graph/mastra/MastraCatalogueOwnership.test.ts` and
1621
+ `tests/unit/graph/GraphPortManifestElement.test.ts` cannot load.
1622
+ - `eslint` missing — `tests/unit/graph/boundary-wall.test.ts` cannot spawn
1623
+ `node_modules/.bin/eslint`.
1624
+ - `@decaf-ts/utils` missing — `npm run docs` fails with `build-scripts: not found` (and the
1625
+ JSDoc/README toolchain cannot run).
1626
+
1627
+ Run the install with devDependencies enabled (`NODE_ENV=development npm install`) before treating
1628
+ those failures as defects.
1629
+
800
1630
 
801
1631
  ### Related
802
1632