@decaf-ts/as-graph 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (968) hide show
  1. package/README.md +834 -38
  2. package/assets/i18n/en.json +2527 -32
  3. package/dist/as-graph.cjs +1 -1
  4. package/dist/as-graph.cjs.map +1 -1
  5. package/dist/as-graph.js +1 -1
  6. package/dist/as-graph.js.map +1 -1
  7. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +102 -11
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
  9. package/lib/cjs/engine/auth/GraphAuthValidator.cjs +19 -0
  10. package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
  11. package/lib/cjs/engine/constants.cjs +61 -1
  12. package/lib/cjs/engine/constants.cjs.map +1 -1
  13. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
  14. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
  15. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +235 -67
  16. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  17. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
  18. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
  19. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
  20. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
  21. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +92 -1
  22. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
  23. package/lib/cjs/engine/execution/index.cjs +1 -0
  24. package/lib/cjs/engine/execution/index.cjs.map +1 -1
  25. package/lib/cjs/engine/index.cjs +5 -0
  26. package/lib/cjs/engine/index.cjs.map +1 -1
  27. package/lib/cjs/engine/services/GraphNodeModelService.cjs +129 -0
  28. package/lib/cjs/engine/services/GraphNodeModelService.cjs.map +1 -0
  29. package/lib/cjs/engine/services/GraphWorkflowService.cjs +33 -0
  30. package/lib/cjs/engine/services/GraphWorkflowService.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/GraphParameterValidator.cjs +6 -0
  42. package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
  43. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
  44. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
  45. package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
  46. package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
  47. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
  48. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
  49. package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
  50. package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
  51. package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
  52. package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
  53. package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
  54. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
  55. package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
  56. package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
  57. package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
  58. package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
  59. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +435 -0
  60. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -0
  61. package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
  62. package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
  63. package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
  64. package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
  65. package/lib/cjs/mastra/MastraEventBridge.cjs +31 -4
  66. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
  67. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +513 -20
  68. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
  69. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
  70. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
  71. package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
  72. package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
  73. package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
  74. package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
  75. package/lib/cjs/mastra/MastraMemory.cjs +467 -0
  76. package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
  77. package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
  78. package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
  79. package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
  80. package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
  81. package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
  82. package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
  83. package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
  84. package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
  85. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
  86. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
  87. package/lib/cjs/mastra/MastraObservability.cjs +335 -0
  88. package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
  89. package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
  90. package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
  91. package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
  92. package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
  93. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
  94. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
  95. package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
  96. package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
  97. package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
  98. package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
  99. package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
  100. package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
  101. package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
  102. package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
  103. package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
  104. package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
  105. package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
  106. package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
  107. package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
  108. package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
  109. package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
  110. package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
  111. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
  112. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
  113. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +41 -9
  114. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  115. package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
  116. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
  117. package/lib/cjs/mastra/index.cjs +41 -1
  118. package/lib/cjs/mastra/index.cjs.map +1 -1
  119. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
  120. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
  121. package/lib/cjs/mastra/nodes/index.cjs +29 -0
  122. package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
  123. package/lib/cjs/mastra/nodes/types.cjs +4 -0
  124. package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
  125. package/lib/cjs/mastra/types.cjs +130 -1
  126. package/lib/cjs/mastra/types.cjs.map +1 -1
  127. package/lib/cjs/nest/graph/GraphBackendHost.cjs +117 -23
  128. package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
  129. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +72 -2
  130. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  131. package/lib/cjs/nest/graph/GraphRunController.cjs +47 -6
  132. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  133. package/lib/cjs/nest/graph/main.cjs +99 -2
  134. package/lib/cjs/nest/graph/main.cjs.map +1 -1
  135. package/lib/cjs/node/agents/agent/node.cjs +189 -31
  136. package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
  137. package/lib/cjs/node/agents/hitl/node.cjs +115 -0
  138. package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
  139. package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
  140. package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
  141. package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
  142. package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
  143. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
  144. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
  145. package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
  146. package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
  147. package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
  148. package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
  149. package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
  150. package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
  151. package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
  152. package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
  153. package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
  154. package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
  155. package/lib/cjs/node/agents/processors/types.cjs +68 -0
  156. package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
  157. package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
  158. package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
  159. package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
  160. package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
  161. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
  162. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
  163. package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
  164. package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
  165. package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
  166. package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
  167. package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
  168. package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
  169. package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
  170. package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
  171. package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
  172. package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
  173. package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
  174. package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
  175. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
  176. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
  177. package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
  178. package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
  179. package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
  180. package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
  181. package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
  182. package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
  183. package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
  184. package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
  185. package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
  186. package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
  187. package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
  188. package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
  189. package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
  190. package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
  191. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
  192. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
  193. package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
  194. package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
  195. package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
  196. package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
  197. package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
  198. package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
  199. package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
  200. package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
  201. package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
  202. package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
  203. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
  204. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
  205. package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
  206. package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
  207. package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
  208. package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
  209. package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
  210. package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
  211. package/lib/cjs/node/agents/voice/node.cjs +107 -0
  212. package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
  213. package/lib/cjs/node/agents/zones.cjs +43 -0
  214. package/lib/cjs/node/agents/zones.cjs.map +1 -0
  215. package/lib/cjs/node/comms/email-send/node.cjs +340 -0
  216. package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
  217. package/lib/cjs/node/comms/gmail/node.cjs +287 -0
  218. package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
  219. package/lib/cjs/node/comms/slack/node.cjs +276 -0
  220. package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
  221. package/lib/cjs/node/comms/teams/node.cjs +231 -0
  222. package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
  223. package/lib/cjs/node/comms/telegram/node.cjs +260 -0
  224. package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
  225. package/lib/cjs/node/credentials.cjs +103 -0
  226. package/lib/cjs/node/credentials.cjs.map +1 -0
  227. package/lib/cjs/node/data/data-table/node.cjs +265 -0
  228. package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
  229. package/lib/cjs/node/data/date-time/node.cjs +180 -0
  230. package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
  231. package/lib/cjs/node/data/filter/node.cjs +134 -0
  232. package/lib/cjs/node/data/filter/node.cjs.map +1 -0
  233. package/lib/cjs/node/data/limit/node.cjs +104 -0
  234. package/lib/cjs/node/data/limit/node.cjs.map +1 -0
  235. package/lib/cjs/node/data/merge/node.cjs +251 -0
  236. package/lib/cjs/node/data/merge/node.cjs.map +1 -0
  237. package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
  238. package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
  239. package/lib/cjs/node/data/set/node.cjs +148 -0
  240. package/lib/cjs/node/data/set/node.cjs.map +1 -0
  241. package/lib/cjs/node/data/sort/node.cjs +125 -0
  242. package/lib/cjs/node/data/sort/node.cjs.map +1 -0
  243. package/lib/cjs/node/data/split-out/node.cjs +140 -0
  244. package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
  245. package/lib/cjs/node/data/support.cjs +398 -0
  246. package/lib/cjs/node/data/support.cjs.map +1 -0
  247. package/lib/cjs/node/devops/crypto/node.cjs +364 -0
  248. package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
  249. package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
  250. package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
  251. package/lib/cjs/node/devops/ftp/node.cjs +241 -0
  252. package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
  253. package/lib/cjs/node/devops/github/node.cjs +282 -0
  254. package/lib/cjs/node/devops/github/node.cjs.map +1 -0
  255. package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
  256. package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
  257. package/lib/cjs/node/devops/jwt/node.cjs +204 -0
  258. package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
  259. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
  260. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
  261. package/lib/cjs/node/index.cjs +402 -66
  262. package/lib/cjs/node/index.cjs.map +1 -1
  263. package/lib/cjs/node/io/airtable/node.cjs +318 -0
  264. package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
  265. package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
  266. package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
  267. package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
  268. package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
  269. package/lib/cjs/node/io/graphql/node.cjs +169 -0
  270. package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
  271. package/lib/cjs/node/io/http-request/node.cjs +415 -0
  272. package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
  273. package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
  274. package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
  275. package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
  276. package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
  277. package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
  278. package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
  279. package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
  280. package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
  281. package/lib/cjs/node/manifests.cjs +264 -36
  282. package/lib/cjs/node/manifests.cjs.map +1 -1
  283. package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
  284. package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
  285. package/lib/cjs/node/storage/blob/base.cjs +321 -0
  286. package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
  287. package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
  288. package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
  289. package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
  290. package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
  291. package/lib/cjs/node/storage/database/base.cjs +301 -0
  292. package/lib/cjs/node/storage/database/base.cjs.map +1 -0
  293. package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
  294. package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
  295. package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
  296. package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
  297. package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
  298. package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
  299. package/lib/cjs/node/storage/redis/node.cjs +340 -0
  300. package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
  301. package/lib/cjs/node/storage/support.cjs +81 -0
  302. package/lib/cjs/node/storage/support.cjs.map +1 -0
  303. package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
  304. package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
  305. package/lib/cjs/ram/GraphNodeRepository.cjs +40 -0
  306. package/lib/cjs/ram/GraphNodeRepository.cjs.map +1 -0
  307. package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
  308. package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
  309. package/lib/cjs/ram/index.cjs +1 -0
  310. package/lib/cjs/ram/index.cjs.map +1 -1
  311. package/lib/cjs/shared/graph/GraphNodeConverters.cjs +43 -0
  312. package/lib/cjs/shared/graph/GraphNodeConverters.cjs.map +1 -0
  313. package/lib/cjs/shared/graph/GraphNodeModel.cjs +78 -0
  314. package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -0
  315. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
  316. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
  317. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
  318. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  319. package/lib/cjs/shared/graph/category-styles.cjs +12 -0
  320. package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
  321. package/lib/cjs/shared/graph/index.cjs +2 -0
  322. package/lib/cjs/shared/graph/index.cjs.map +1 -1
  323. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
  324. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
  325. package/lib/cjs/typeorm/index.cjs +29 -0
  326. package/lib/cjs/typeorm/index.cjs.map +1 -0
  327. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +102 -11
  328. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
  329. package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
  330. package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
  331. package/lib/esm/engine/constants.js +60 -0
  332. package/lib/esm/engine/constants.js.map +1 -1
  333. package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
  334. package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
  335. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
  336. package/lib/esm/engine/execution/GraphExecutionEngine.js +236 -68
  337. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  338. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
  339. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
  340. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
  341. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
  342. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +93 -2
  343. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
  344. package/lib/esm/engine/execution/index.js +1 -0
  345. package/lib/esm/engine/execution/index.js.map +1 -1
  346. package/lib/esm/engine/index.js +5 -0
  347. package/lib/esm/engine/index.js.map +1 -1
  348. package/lib/esm/engine/services/GraphNodeModelService.js +120 -0
  349. package/lib/esm/engine/services/GraphNodeModelService.js.map +1 -0
  350. package/lib/esm/engine/services/GraphWorkflowService.js +34 -1
  351. package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
  352. package/lib/esm/engine/store/GraphDataTableModel.js +67 -0
  353. package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
  354. package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
  355. package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
  356. package/lib/esm/engine/store/index.js +2 -0
  357. package/lib/esm/engine/store/index.js.map +1 -1
  358. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
  359. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
  360. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
  361. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
  362. package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
  363. package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
  364. package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
  365. package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
  366. package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
  367. package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
  368. package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
  369. package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
  370. package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
  371. package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
  372. package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
  373. package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
  374. package/lib/esm/mastra/MastraCapabilities.js +115 -0
  375. package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
  376. package/lib/esm/mastra/MastraChannelResponse.js +154 -0
  377. package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
  378. package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
  379. package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
  380. package/lib/esm/mastra/MastraDefaultStepHandlers.js +430 -0
  381. package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -0
  382. package/lib/esm/mastra/MastraEnvironment.js +287 -0
  383. package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
  384. package/lib/esm/mastra/MastraEvalModels.js +535 -0
  385. package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
  386. package/lib/esm/mastra/MastraEventBridge.js +31 -4
  387. package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
  388. package/lib/esm/mastra/MastraGraphExecutionBackend.js +514 -21
  389. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
  390. package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
  391. package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
  392. package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
  393. package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
  394. package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
  395. package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
  396. package/lib/esm/mastra/MastraMemory.js +455 -0
  397. package/lib/esm/mastra/MastraMemory.js.map +1 -0
  398. package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
  399. package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
  400. package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
  401. package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
  402. package/lib/esm/mastra/MastraMetricsModels.js +486 -0
  403. package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
  404. package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
  405. package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
  406. package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
  407. package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
  408. package/lib/esm/mastra/MastraObservability.js +327 -0
  409. package/lib/esm/mastra/MastraObservability.js.map +1 -0
  410. package/lib/esm/mastra/MastraPersistence.js +530 -0
  411. package/lib/esm/mastra/MastraPersistence.js.map +1 -0
  412. package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
  413. package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
  414. package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
  415. package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
  416. package/lib/esm/mastra/MastraRunRecovery.js +89 -0
  417. package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
  418. package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
  419. package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
  420. package/lib/esm/mastra/MastraStorageWiring.js +119 -0
  421. package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
  422. package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
  423. package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
  424. package/lib/esm/mastra/MastraToolBuilder.js +68 -0
  425. package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
  426. package/lib/esm/mastra/MastraToolConfig.js +37 -0
  427. package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
  428. package/lib/esm/mastra/MastraToolDecorator.js +92 -0
  429. package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
  430. package/lib/esm/mastra/MastraVectorStore.js +605 -0
  431. package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
  432. package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
  433. package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
  434. package/lib/esm/mastra/MastraWorkflowCompiler.js +41 -9
  435. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  436. package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
  437. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
  438. package/lib/esm/mastra/index.js +41 -1
  439. package/lib/esm/mastra/index.js.map +1 -1
  440. package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
  441. package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
  442. package/lib/esm/mastra/nodes/index.js +12 -0
  443. package/lib/esm/mastra/nodes/index.js.map +1 -0
  444. package/lib/esm/mastra/nodes/types.js +2 -0
  445. package/lib/esm/mastra/nodes/types.js.map +1 -0
  446. package/lib/esm/mastra/types.js +129 -0
  447. package/lib/esm/mastra/types.js.map +1 -1
  448. package/lib/esm/nest/graph/GraphBackendHost.js +79 -20
  449. package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
  450. package/lib/esm/nest/graph/GraphExecutionModule.js +73 -3
  451. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  452. package/lib/esm/nest/graph/GraphRunController.js +47 -6
  453. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  454. package/lib/esm/nest/graph/main.js +100 -3
  455. package/lib/esm/nest/graph/main.js.map +1 -1
  456. package/lib/esm/node/agents/agent/node.js +189 -31
  457. package/lib/esm/node/agents/agent/node.js.map +1 -1
  458. package/lib/esm/node/agents/hitl/node.js +106 -0
  459. package/lib/esm/node/agents/hitl/node.js.map +1 -0
  460. package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
  461. package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
  462. package/lib/esm/node/agents/hooks/hook/node.js +111 -0
  463. package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
  464. package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
  465. package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
  466. package/lib/esm/node/agents/memory/memory/node.js +222 -0
  467. package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
  468. package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
  469. package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
  470. package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
  471. package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
  472. package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
  473. package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
  474. package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
  475. package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
  476. package/lib/esm/node/agents/processors/types.js +64 -0
  477. package/lib/esm/node/agents/processors/types.js.map +1 -0
  478. package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
  479. package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
  480. package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
  481. package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
  482. package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
  483. package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
  484. package/lib/esm/node/agents/rag/chunking/node.js +211 -0
  485. package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
  486. package/lib/esm/node/agents/rag/embedding/node.js +101 -0
  487. package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
  488. package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
  489. package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
  490. package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
  491. package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
  492. package/lib/esm/node/agents/rag/rerank/node.js +103 -0
  493. package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
  494. package/lib/esm/node/agents/rag/retriever/node.js +111 -0
  495. package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
  496. package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
  497. package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
  498. package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
  499. package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
  500. package/lib/esm/node/agents/responses/discord/node.js +92 -0
  501. package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
  502. package/lib/esm/node/agents/responses/slack/node.js +92 -0
  503. package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
  504. package/lib/esm/node/agents/responses/teams/node.js +92 -0
  505. package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
  506. package/lib/esm/node/agents/responses/telegram/node.js +92 -0
  507. package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
  508. package/lib/esm/node/agents/sandbox/node.js +125 -0
  509. package/lib/esm/node/agents/sandbox/node.js.map +1 -0
  510. package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
  511. package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
  512. package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
  513. package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
  514. package/lib/esm/node/agents/skills/skill/node.js +96 -0
  515. package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
  516. package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
  517. package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
  518. package/lib/esm/node/agents/tools/tool/node.js +91 -0
  519. package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
  520. package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
  521. package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
  522. package/lib/esm/node/agents/triggers/discord/node.js +92 -0
  523. package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
  524. package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
  525. package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
  526. package/lib/esm/node/agents/triggers/slack/node.js +92 -0
  527. package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
  528. package/lib/esm/node/agents/triggers/teams/node.js +92 -0
  529. package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
  530. package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
  531. package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
  532. package/lib/esm/node/agents/voice/node.js +98 -0
  533. package/lib/esm/node/agents/voice/node.js.map +1 -0
  534. package/lib/esm/node/agents/zones.js +39 -0
  535. package/lib/esm/node/agents/zones.js.map +1 -0
  536. package/lib/esm/node/comms/email-send/node.js +331 -0
  537. package/lib/esm/node/comms/email-send/node.js.map +1 -0
  538. package/lib/esm/node/comms/gmail/node.js +278 -0
  539. package/lib/esm/node/comms/gmail/node.js.map +1 -0
  540. package/lib/esm/node/comms/slack/node.js +267 -0
  541. package/lib/esm/node/comms/slack/node.js.map +1 -0
  542. package/lib/esm/node/comms/teams/node.js +222 -0
  543. package/lib/esm/node/comms/teams/node.js.map +1 -0
  544. package/lib/esm/node/comms/telegram/node.js +251 -0
  545. package/lib/esm/node/comms/telegram/node.js.map +1 -0
  546. package/lib/esm/node/credentials.js +96 -0
  547. package/lib/esm/node/credentials.js.map +1 -0
  548. package/lib/esm/node/data/data-table/node.js +256 -0
  549. package/lib/esm/node/data/data-table/node.js.map +1 -0
  550. package/lib/esm/node/data/date-time/node.js +171 -0
  551. package/lib/esm/node/data/date-time/node.js.map +1 -0
  552. package/lib/esm/node/data/filter/node.js +125 -0
  553. package/lib/esm/node/data/filter/node.js.map +1 -0
  554. package/lib/esm/node/data/limit/node.js +95 -0
  555. package/lib/esm/node/data/limit/node.js.map +1 -0
  556. package/lib/esm/node/data/merge/node.js +242 -0
  557. package/lib/esm/node/data/merge/node.js.map +1 -0
  558. package/lib/esm/node/data/rename-keys/node.js +130 -0
  559. package/lib/esm/node/data/rename-keys/node.js.map +1 -0
  560. package/lib/esm/node/data/set/node.js +139 -0
  561. package/lib/esm/node/data/set/node.js.map +1 -0
  562. package/lib/esm/node/data/sort/node.js +116 -0
  563. package/lib/esm/node/data/sort/node.js.map +1 -0
  564. package/lib/esm/node/data/split-out/node.js +131 -0
  565. package/lib/esm/node/data/split-out/node.js.map +1 -0
  566. package/lib/esm/node/data/support.js +382 -0
  567. package/lib/esm/node/data/support.js.map +1 -0
  568. package/lib/esm/node/devops/crypto/node.js +355 -0
  569. package/lib/esm/node/devops/crypto/node.js.map +1 -0
  570. package/lib/esm/node/devops/execute-command/node.js +192 -0
  571. package/lib/esm/node/devops/execute-command/node.js.map +1 -0
  572. package/lib/esm/node/devops/ftp/node.js +232 -0
  573. package/lib/esm/node/devops/ftp/node.js.map +1 -0
  574. package/lib/esm/node/devops/github/node.js +273 -0
  575. package/lib/esm/node/devops/github/node.js.map +1 -0
  576. package/lib/esm/node/devops/gitlab/node.js +264 -0
  577. package/lib/esm/node/devops/gitlab/node.js.map +1 -0
  578. package/lib/esm/node/devops/jwt/node.js +195 -0
  579. package/lib/esm/node/devops/jwt/node.js.map +1 -0
  580. package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
  581. package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
  582. package/lib/esm/node/index.js +338 -2
  583. package/lib/esm/node/index.js.map +1 -1
  584. package/lib/esm/node/io/airtable/node.js +309 -0
  585. package/lib/esm/node/io/airtable/node.js.map +1 -0
  586. package/lib/esm/node/io/extract-from-file/node.js +260 -0
  587. package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
  588. package/lib/esm/node/io/google-sheets/node.js +258 -0
  589. package/lib/esm/node/io/google-sheets/node.js.map +1 -0
  590. package/lib/esm/node/io/graphql/node.js +160 -0
  591. package/lib/esm/node/io/graphql/node.js.map +1 -0
  592. package/lib/esm/node/io/http-request/node.js +406 -0
  593. package/lib/esm/node/io/http-request/node.js.map +1 -0
  594. package/lib/esm/node/io/read-pdf/node.js +164 -0
  595. package/lib/esm/node/io/read-pdf/node.js.map +1 -0
  596. package/lib/esm/node/io/read-write-file/node.js +305 -0
  597. package/lib/esm/node/io/read-write-file/node.js.map +1 -0
  598. package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
  599. package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
  600. package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
  601. package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
  602. package/lib/esm/node/manifests.js +228 -0
  603. package/lib/esm/node/manifests.js.map +1 -1
  604. package/lib/esm/node/storage/blob/azure/node.js +129 -0
  605. package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
  606. package/lib/esm/node/storage/blob/base.js +311 -0
  607. package/lib/esm/node/storage/blob/base.js.map +1 -0
  608. package/lib/esm/node/storage/blob/gcs/node.js +117 -0
  609. package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
  610. package/lib/esm/node/storage/blob/s3/node.js +176 -0
  611. package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
  612. package/lib/esm/node/storage/database/base.js +291 -0
  613. package/lib/esm/node/storage/database/base.js.map +1 -0
  614. package/lib/esm/node/storage/database/mssql/node.js +42 -0
  615. package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
  616. package/lib/esm/node/storage/database/mysql/node.js +42 -0
  617. package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
  618. package/lib/esm/node/storage/database/postgres/node.js +42 -0
  619. package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
  620. package/lib/esm/node/storage/redis/node.js +331 -0
  621. package/lib/esm/node/storage/redis/node.js.map +1 -0
  622. package/lib/esm/node/storage/support.js +69 -0
  623. package/lib/esm/node/storage/support.js.map +1 -0
  624. package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
  625. package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
  626. package/lib/esm/ram/GraphNodeRepository.js +31 -0
  627. package/lib/esm/ram/GraphNodeRepository.js.map +1 -0
  628. package/lib/esm/ram/GraphRunEventModel.js +5 -1
  629. package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
  630. package/lib/esm/ram/index.js +1 -0
  631. package/lib/esm/ram/index.js.map +1 -1
  632. package/lib/esm/shared/graph/GraphNodeConverters.js +38 -0
  633. package/lib/esm/shared/graph/GraphNodeConverters.js.map +1 -0
  634. package/lib/esm/shared/graph/GraphNodeModel.js +69 -0
  635. package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -0
  636. package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
  637. package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
  638. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
  639. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  640. package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
  641. package/lib/esm/shared/graph/category-styles.js +12 -0
  642. package/lib/esm/shared/graph/category-styles.js.map +1 -1
  643. package/lib/esm/shared/graph/constants.js.map +1 -1
  644. package/lib/esm/shared/graph/index.js +2 -0
  645. package/lib/esm/shared/graph/index.js.map +1 -1
  646. package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
  647. package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
  648. package/lib/esm/typeorm/index.js +12 -0
  649. package/lib/esm/typeorm/index.js.map +1 -0
  650. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +40 -4
  651. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +40 -4
  652. package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
  653. package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
  654. package/lib/types/engine/constants.d.cts +60 -0
  655. package/lib/types/engine/constants.d.mts +60 -0
  656. package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
  657. package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
  658. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +27 -0
  659. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +27 -0
  660. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +97 -1
  661. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +97 -1
  662. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
  663. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
  664. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
  665. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
  666. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +26 -3
  667. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +26 -3
  668. package/lib/types/engine/execution/index.d.cts +1 -0
  669. package/lib/types/engine/execution/index.d.mts +1 -0
  670. package/lib/types/engine/index.d.cts +5 -0
  671. package/lib/types/engine/index.d.mts +5 -0
  672. package/lib/types/engine/services/GraphNodeModelService.d.cts +54 -0
  673. package/lib/types/engine/services/GraphNodeModelService.d.mts +54 -0
  674. package/lib/types/engine/services/GraphWorkflowService.d.cts +21 -0
  675. package/lib/types/engine/services/GraphWorkflowService.d.mts +21 -0
  676. package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
  677. package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
  678. package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
  679. package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
  680. package/lib/types/engine/store/index.d.cts +2 -0
  681. package/lib/types/engine/store/index.d.mts +2 -0
  682. package/lib/types/engine/types.d.cts +12 -0
  683. package/lib/types/engine/types.d.mts +12 -0
  684. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
  685. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
  686. package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
  687. package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
  688. package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
  689. package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
  690. package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
  691. package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
  692. package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
  693. package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
  694. package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
  695. package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
  696. package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
  697. package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
  698. package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
  699. package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
  700. package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
  701. package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
  702. package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
  703. package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
  704. package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +121 -0
  705. package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +121 -0
  706. package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
  707. package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
  708. package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
  709. package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
  710. package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
  711. package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
  712. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +137 -1
  713. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +137 -1
  714. package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
  715. package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
  716. package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
  717. package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
  718. package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
  719. package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
  720. package/lib/types/mastra/MastraMemory.d.cts +362 -0
  721. package/lib/types/mastra/MastraMemory.d.mts +362 -0
  722. package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
  723. package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
  724. package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
  725. package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
  726. package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
  727. package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
  728. package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
  729. package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
  730. package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
  731. package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
  732. package/lib/types/mastra/MastraObservability.d.cts +197 -0
  733. package/lib/types/mastra/MastraObservability.d.mts +197 -0
  734. package/lib/types/mastra/MastraPersistence.d.cts +241 -0
  735. package/lib/types/mastra/MastraPersistence.d.mts +241 -0
  736. package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
  737. package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
  738. package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
  739. package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
  740. package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
  741. package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
  742. package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
  743. package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
  744. package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
  745. package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
  746. package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
  747. package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
  748. package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
  749. package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
  750. package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
  751. package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
  752. package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
  753. package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
  754. package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
  755. package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
  756. package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
  757. package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
  758. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +3 -3
  759. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +3 -3
  760. package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
  761. package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
  762. package/lib/types/mastra/index.d.cts +41 -1
  763. package/lib/types/mastra/index.d.mts +41 -1
  764. package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
  765. package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
  766. package/lib/types/mastra/nodes/index.d.cts +11 -0
  767. package/lib/types/mastra/nodes/index.d.mts +11 -0
  768. package/lib/types/mastra/nodes/types.d.cts +57 -0
  769. package/lib/types/mastra/nodes/types.d.mts +57 -0
  770. package/lib/types/mastra/types.d.cts +377 -6
  771. package/lib/types/mastra/types.d.mts +377 -6
  772. package/lib/types/nest/graph/GraphBackendHost.d.cts +52 -0
  773. package/lib/types/nest/graph/GraphBackendHost.d.mts +52 -0
  774. package/lib/types/nest/graph/GraphExecutionModule.d.cts +28 -0
  775. package/lib/types/nest/graph/GraphExecutionModule.d.mts +28 -0
  776. package/lib/types/nest/graph/GraphRunController.d.cts +24 -4
  777. package/lib/types/nest/graph/GraphRunController.d.mts +24 -4
  778. package/lib/types/node/agents/agent/node.d.cts +72 -16
  779. package/lib/types/node/agents/agent/node.d.mts +72 -16
  780. package/lib/types/node/agents/hitl/node.d.cts +45 -0
  781. package/lib/types/node/agents/hitl/node.d.mts +45 -0
  782. package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
  783. package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
  784. package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
  785. package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
  786. package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
  787. package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
  788. package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
  789. package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
  790. package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
  791. package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
  792. package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
  793. package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
  794. package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
  795. package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
  796. package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
  797. package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
  798. package/lib/types/node/agents/processors/types.d.cts +45 -0
  799. package/lib/types/node/agents/processors/types.d.mts +45 -0
  800. package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
  801. package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
  802. package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
  803. package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
  804. package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
  805. package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
  806. package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
  807. package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
  808. package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
  809. package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
  810. package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
  811. package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
  812. package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
  813. package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
  814. package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
  815. package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
  816. package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
  817. package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
  818. package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
  819. package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
  820. package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
  821. package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
  822. package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
  823. package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
  824. package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
  825. package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
  826. package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
  827. package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
  828. package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
  829. package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
  830. package/lib/types/node/agents/sandbox/node.d.cts +47 -0
  831. package/lib/types/node/agents/sandbox/node.d.mts +47 -0
  832. package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
  833. package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
  834. package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
  835. package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
  836. package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
  837. package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
  838. package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
  839. package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
  840. package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
  841. package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
  842. package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
  843. package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
  844. package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
  845. package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
  846. package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
  847. package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
  848. package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
  849. package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
  850. package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
  851. package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
  852. package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
  853. package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
  854. package/lib/types/node/agents/voice/node.d.cts +34 -0
  855. package/lib/types/node/agents/voice/node.d.mts +34 -0
  856. package/lib/types/node/agents/zones.d.cts +30 -0
  857. package/lib/types/node/agents/zones.d.mts +30 -0
  858. package/lib/types/node/comms/email-send/node.d.cts +85 -0
  859. package/lib/types/node/comms/email-send/node.d.mts +85 -0
  860. package/lib/types/node/comms/gmail/node.d.cts +67 -0
  861. package/lib/types/node/comms/gmail/node.d.mts +67 -0
  862. package/lib/types/node/comms/slack/node.d.cts +65 -0
  863. package/lib/types/node/comms/slack/node.d.mts +65 -0
  864. package/lib/types/node/comms/teams/node.d.cts +49 -0
  865. package/lib/types/node/comms/teams/node.d.mts +49 -0
  866. package/lib/types/node/comms/telegram/node.d.cts +61 -0
  867. package/lib/types/node/comms/telegram/node.d.mts +61 -0
  868. package/lib/types/node/credentials.d.cts +43 -0
  869. package/lib/types/node/credentials.d.mts +43 -0
  870. package/lib/types/node/data/data-table/node.d.cts +86 -0
  871. package/lib/types/node/data/data-table/node.d.mts +86 -0
  872. package/lib/types/node/data/date-time/node.d.cts +49 -0
  873. package/lib/types/node/data/date-time/node.d.mts +49 -0
  874. package/lib/types/node/data/filter/node.d.cts +31 -0
  875. package/lib/types/node/data/filter/node.d.mts +31 -0
  876. package/lib/types/node/data/limit/node.d.cts +28 -0
  877. package/lib/types/node/data/limit/node.d.mts +28 -0
  878. package/lib/types/node/data/merge/node.d.cts +63 -0
  879. package/lib/types/node/data/merge/node.d.mts +63 -0
  880. package/lib/types/node/data/rename-keys/node.d.cts +35 -0
  881. package/lib/types/node/data/rename-keys/node.d.mts +35 -0
  882. package/lib/types/node/data/set/node.d.cts +52 -0
  883. package/lib/types/node/data/set/node.d.mts +52 -0
  884. package/lib/types/node/data/sort/node.d.cts +40 -0
  885. package/lib/types/node/data/sort/node.d.mts +40 -0
  886. package/lib/types/node/data/split-out/node.d.cts +30 -0
  887. package/lib/types/node/data/split-out/node.d.mts +30 -0
  888. package/lib/types/node/data/support.d.cts +164 -0
  889. package/lib/types/node/data/support.d.mts +164 -0
  890. package/lib/types/node/devops/crypto/node.d.cts +65 -0
  891. package/lib/types/node/devops/crypto/node.d.mts +65 -0
  892. package/lib/types/node/devops/execute-command/node.d.cts +55 -0
  893. package/lib/types/node/devops/execute-command/node.d.mts +55 -0
  894. package/lib/types/node/devops/ftp/node.d.cts +55 -0
  895. package/lib/types/node/devops/ftp/node.d.mts +55 -0
  896. package/lib/types/node/devops/github/node.d.cts +61 -0
  897. package/lib/types/node/devops/github/node.d.mts +61 -0
  898. package/lib/types/node/devops/gitlab/node.d.cts +61 -0
  899. package/lib/types/node/devops/gitlab/node.d.mts +61 -0
  900. package/lib/types/node/devops/jwt/node.d.cts +53 -0
  901. package/lib/types/node/devops/jwt/node.d.mts +53 -0
  902. package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
  903. package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
  904. package/lib/types/node/index.d.cts +182 -2
  905. package/lib/types/node/index.d.mts +182 -2
  906. package/lib/types/node/io/airtable/node.d.cts +73 -0
  907. package/lib/types/node/io/airtable/node.d.mts +73 -0
  908. package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
  909. package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
  910. package/lib/types/node/io/google-sheets/node.d.cts +77 -0
  911. package/lib/types/node/io/google-sheets/node.d.mts +77 -0
  912. package/lib/types/node/io/graphql/node.d.cts +46 -0
  913. package/lib/types/node/io/graphql/node.d.mts +46 -0
  914. package/lib/types/node/io/http-request/node.d.cts +107 -0
  915. package/lib/types/node/io/http-request/node.d.mts +107 -0
  916. package/lib/types/node/io/read-pdf/node.d.cts +40 -0
  917. package/lib/types/node/io/read-pdf/node.d.mts +40 -0
  918. package/lib/types/node/io/read-write-file/node.d.cts +41 -0
  919. package/lib/types/node/io/read-write-file/node.d.mts +41 -0
  920. package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
  921. package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
  922. package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
  923. package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
  924. package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
  925. package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
  926. package/lib/types/node/storage/blob/base.d.cts +83 -0
  927. package/lib/types/node/storage/blob/base.d.mts +83 -0
  928. package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
  929. package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
  930. package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
  931. package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
  932. package/lib/types/node/storage/database/base.d.cts +97 -0
  933. package/lib/types/node/storage/database/base.d.mts +97 -0
  934. package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
  935. package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
  936. package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
  937. package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
  938. package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
  939. package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
  940. package/lib/types/node/storage/redis/node.d.cts +68 -0
  941. package/lib/types/node/storage/redis/node.d.mts +68 -0
  942. package/lib/types/node/storage/support.d.cts +36 -0
  943. package/lib/types/node/storage/support.d.mts +36 -0
  944. package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
  945. package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
  946. package/lib/types/ram/GraphNodeRepository.d.cts +13 -0
  947. package/lib/types/ram/GraphNodeRepository.d.mts +13 -0
  948. package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
  949. package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
  950. package/lib/types/ram/index.d.cts +1 -0
  951. package/lib/types/ram/index.d.mts +1 -0
  952. package/lib/types/shared/graph/GraphNodeConverters.d.cts +15 -0
  953. package/lib/types/shared/graph/GraphNodeConverters.d.mts +15 -0
  954. package/lib/types/shared/graph/GraphNodeModel.d.cts +30 -0
  955. package/lib/types/shared/graph/GraphNodeModel.d.mts +30 -0
  956. package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
  957. package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
  958. package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
  959. package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
  960. package/lib/types/shared/graph/constants.d.cts +39 -0
  961. package/lib/types/shared/graph/constants.d.mts +39 -0
  962. package/lib/types/shared/graph/index.d.cts +2 -0
  963. package/lib/types/shared/graph/index.d.mts +2 -0
  964. package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
  965. package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
  966. package/lib/types/typeorm/index.d.cts +11 -0
  967. package/lib/types/typeorm/index.d.mts +11 -0
  968. package/package.json +59 -13
@@ -1,3 +1,4 @@
1
+ import { Logging } from "@decaf-ts/logging";
1
2
  import { NotFoundError } from "@decaf-ts/db-decorators";
2
3
  import { GraphExecutionEventType, GraphExecutionStatus } from "./../shared/graph/constants.js";
3
4
  import { GraphExecutionBackendRegistry } from "./../engine/execution/GraphExecutionBackendRegistry.js";
@@ -9,14 +10,54 @@ import { buildGraphExecutionResult } from "./../engine/execution/GraphExecutionR
9
10
  import { MastraWorkflowCompiler } from "./MastraWorkflowCompiler.js";
10
11
  import { MastraWorkflowManager } from "./MastraWorkflowManager.js";
11
12
  import { MastraEventBridge } from "./MastraEventBridge.js";
13
+ import { recoverMastraRunHandle } from "./MastraRunRecovery.js";
14
+ import { wireMastraStorage, } from "./MastraStorageWiring.js";
12
15
  import { assertMastraResumeAllowed } from "./MastraResumeGuard.js";
13
16
  import { assertMastraResumeSchemaSafe } from "./MastraSchemaConverter.js";
14
17
  import { resolveMastraCapabilities, } from "./MastraCapabilities.js";
15
- import { GRAPH_MASTRA_AGENT_UNAVAILABLE, GRAPH_MASTRA_UNSUPPORTED_KIND, MASTRA_BACKEND_FLAVOUR, } from "./types.js";
18
+ import { createMastraAgentRuntimeFromConfig } from "./MastraAgentStepHandler.js";
19
+ import { GRAPH_MASTRA_ENGINE_DISABLED, MastraEnvironment, } from "./MastraEnvironment.js";
20
+ import { createMastraNodeStepHandlers } from "./nodes/index.js";
21
+ import { wireMastraObservability, } from "./MastraObservability.js";
22
+ import { createMastraPersistence, jsonSafeProjection, } from "./MastraPersistence.js";
23
+ import { MastraMetricsGateway } from "./MastraMetricsGateway.js";
24
+ import { GRAPH_MASTRA_AGENT_UNAVAILABLE, GRAPH_MASTRA_EXECUTE_ABORTED, GRAPH_MASTRA_EXECUTE_TIMEOUT, GRAPH_MASTRA_UNSUPPORTED_KIND, MASTRA_BACKEND_FLAVOUR, } from "./types.js";
16
25
  const DEFAULT_MAX_RESUME_BYTES = 64 * 1024;
17
26
  function isRecord(value) {
18
27
  return !!value && typeof value === "object" && !Array.isArray(value);
19
28
  }
29
+ /**
30
+ * Maps a Mastra run's terminal status (from the resolved run result
31
+ * `{ status }` or the stream's raw `status`) onto a canonical
32
+ * GraphExecutionStatus. A tripwire guardrail abort and an explicit failure both
33
+ * map to FAILED.
34
+ *
35
+ * @param {unknown} value - The run result object (with a `status` string) or a
36
+ * raw status string.
37
+ * @return {GraphExecutionStatus | undefined} The canonical terminal status, or
38
+ * `undefined` for a non-terminal status (suspended/paused) so the caller keeps
39
+ * its prior disposition.
40
+ */
41
+ function mastraRunTerminalStatus(value) {
42
+ const raw = typeof value === "string"
43
+ ? value
44
+ : isRecord(value) && typeof value["status"] === "string"
45
+ ? value["status"]
46
+ : undefined;
47
+ switch (raw) {
48
+ case "success":
49
+ case "succeeded":
50
+ return GraphExecutionStatus.SUCCEEDED;
51
+ case "failed":
52
+ case "tripwire":
53
+ return GraphExecutionStatus.FAILED;
54
+ case "canceled":
55
+ case "cancelled":
56
+ return GraphExecutionStatus.CANCELLED;
57
+ default:
58
+ return undefined;
59
+ }
60
+ }
20
61
  /**
21
62
  * Structural check for a Decaf execution {@link Context} inside a
22
63
  * {@link MaybeContextualArg} argument list. Mirrors `@decaf-ts/core`'s own
@@ -54,6 +95,10 @@ function mastraCallerOwnerOf(args) {
54
95
  }
55
96
  return undefined;
56
97
  }
98
+ // Guarantees a unique adapter alias per metrics gateway construction: the Decaf
99
+ // adapter registry rejects duplicate aliases, and a backend rebind builds a new
100
+ // gateway over a new runtime.
101
+ let MASTRA_METRICS_ADAPTER_SEQUENCE = 0;
57
102
  /**
58
103
  * `@mastra/core`-translated execution backend (SAA-196). Translates the
59
104
  * canonical document into a Mastra workflow, runs it through the injected Mastra
@@ -71,23 +116,162 @@ export class MastraGraphExecutionBackend {
71
116
  this.documents = new Map();
72
117
  this.runWorkflows = new Map();
73
118
  this.maxResumeBytes = DEFAULT_MAX_RESUME_BYTES;
119
+ this.terminalTimeoutMs = MastraEnvironment.mastra.engine.terminalTimeoutMs;
74
120
  this.initialized = false;
121
+ this.persistenceOwned = false;
122
+ this.persistenceBroken = false;
123
+ this.logger = Logging.for("MastraGraphExecutionBackend");
75
124
  GraphExecutionBackendRegistry.register(MASTRA_BACKEND_FLAVOUR, this);
76
125
  }
126
+ /**
127
+ * Initializes the backend from the host configuration (SAA-836 S1: the
128
+ * engine boots from Environment config only). Fails closed with
129
+ * {@link GRAPH_MASTRA_ENGINE_DISABLED} when the mastra lane is disabled in
130
+ * the environment (`MASTRA__ENGINE__ENABLED=false`). The run-level terminal
131
+ * timeout defaults to the environment-derived
132
+ * `MASTRA__ENGINE__TERMINAL_TIMEOUT_MS` unless the host config sets its own
133
+ * positive value. The `core.agent` step handler is registered from an
134
+ * explicit {@link MastraBackendConfig.agentRuntime}, else from the agent
135
+ * map/factory — with the host decaf-model registry
136
+ * {@link MastraBackendConfig.resolveStructuredOutputModel} passed through so
137
+ * structured-output definitions referencing a model name convert through
138
+ * `@decaf-ts/as-zod`; when none is supplied the kind is left to fail closed,
139
+ * never to a fabricated echo.
140
+ *
141
+ * When the host declares `MastraBackendConfig.storage` (SAA-926 §6.2), it is
142
+ * wired onto the runtime through {@link wireMastraStorage} before any step
143
+ * handler registration; the wiring fails closed on an unwired runtime or a
144
+ * non-durable workflows domain, and the resolved outcome is exposed via
145
+ * {@link MastraGraphExecutionBackend.storageStatus}.
146
+ *
147
+ * @param config - The host-injected backend configuration.
148
+ * @throws {GraphExecutionError} when the mastra lane is disabled by the
149
+ * environment, when the declared storage cannot be wired
150
+ * ({@link GRAPH_MASTRA_STORAGE_UNWIRED}), or when the wired storage does
151
+ * not resolve a durable workflows domain
152
+ * ({@link GRAPH_MASTRA_STORAGE_DOMAIN_INMEMORY}).
153
+ */
77
154
  async initialize(config) {
155
+ // SAA-836 S1: the engine boots from Environment config only, and fails
156
+ // closed when the mastra lane is disabled (`MASTRA__ENGINE__ENABLED=false`).
157
+ if (!MastraEnvironment.mastra.engine.enabled) {
158
+ throw new GraphExecutionError("The mastra engine lane is disabled by the environment (MASTRA__ENGINE__ENABLED=false)", GRAPH_MASTRA_ENGINE_DISABLED);
159
+ }
78
160
  this._config = config;
79
161
  this.runtime = config.mastra;
80
162
  // Re-initializing rewires the runtime/compiler, so a previously cached
81
163
  // management surface must not survive the rebind (C7).
82
164
  this.managementManager = undefined;
83
165
  this.suspendStateReader = config.suspendStateReader;
166
+ this.metricsGateway = undefined;
167
+ // SAA-926 §6.2: `MastraBackendConfig.storage` was declared but never read,
168
+ // so a host declaring durable storage silently persisted in-memory. Wire the
169
+ // declared storage onto the runtime and fail closed when the runtime cannot
170
+ // accept it or the resolved workflows domain is not durable.
171
+ this._storageStatus = undefined;
172
+ if (config.storage !== undefined) {
173
+ this._storageStatus = await wireMastraStorage(this.runtime, config.storage);
174
+ }
84
175
  if (typeof config.maxResumeBytes === "number" && config.maxResumeBytes > 0) {
85
176
  this.maxResumeBytes = config.maxResumeBytes;
86
177
  }
87
- const stepHandlers = Array.isArray(config.stepHandlers)
88
- ? [...config.stepHandlers]
178
+ this.terminalTimeoutMs =
179
+ typeof config.terminalTimeoutMs === "number" &&
180
+ config.terminalTimeoutMs > 0
181
+ ? config.terminalTimeoutMs
182
+ // SAA-836 S1: the engine boots from Environment config only — the
183
+ // default terminal timeout comes from the accumulated mastra
184
+ // environment (`MASTRA__ENGINE__TERMINAL_TIMEOUT_MS`), not a constant.
185
+ : MastraEnvironment.mastra.engine.terminalTimeoutMs;
186
+ const agentRuntime = config.agentRuntime ??
187
+ (config.agents ||
188
+ config.createAgent ||
189
+ config.memories ||
190
+ config.createMemory ||
191
+ config.memoryStorageBindings ||
192
+ config.memoryVectorStore ||
193
+ config.memoryEmbedder !== undefined
194
+ ? createMastraAgentRuntimeFromConfig({
195
+ agents: config.agents,
196
+ createAgent: config.createAgent,
197
+ memories: config.memories,
198
+ createMemory: config.createMemory,
199
+ ...(config.memoryStorageBindings
200
+ ? { memoryStorageBindings: config.memoryStorageBindings }
201
+ : {}),
202
+ ...(config.memoryVectorStore
203
+ ? { memoryVectorStore: config.memoryVectorStore }
204
+ : {}),
205
+ ...(config.memoryEmbedder !== undefined
206
+ ? { memoryEmbedder: config.memoryEmbedder }
207
+ : {}),
208
+ })
209
+ : undefined);
210
+ const hostStepHandlers = Array.isArray(config.stepHandlers)
211
+ ? config.stepHandlers
89
212
  : [];
213
+ const registeredStepHandlers = createMastraNodeStepHandlers({
214
+ agent: {
215
+ ...(agentRuntime ? { runtime: agentRuntime } : {}),
216
+ ...(config.resolveProcessorModel
217
+ ? { resolveProcessorModel: config.resolveProcessorModel }
218
+ : {}),
219
+ ...(config.resolveStructuredOutputModel
220
+ ? { resolveModel: config.resolveStructuredOutputModel }
221
+ : {}),
222
+ },
223
+ mcp: {
224
+ ...(config.createMcpServer
225
+ ? { createMcpServer: config.createMcpServer }
226
+ : {}),
227
+ },
228
+ channelTrigger: {
229
+ ...(config.resolveChannelAdapter
230
+ ? { resolveChannelAdapter: config.resolveChannelAdapter }
231
+ : {}),
232
+ },
233
+ channelResponse: {
234
+ ...(config.sendChannelResponse
235
+ ? { sendChannelResponse: config.sendChannelResponse }
236
+ : {}),
237
+ },
238
+ voice: {
239
+ ...(config.resolveVoice ? { resolveVoice: config.resolveVoice } : {}),
240
+ },
241
+ rag: {
242
+ ...(config.embedText ? { embedText: config.embedText } : {}),
243
+ ...(config.generateText
244
+ ? { generateText: config.generateText }
245
+ : {}),
246
+ ...(config.runSandboxedCode
247
+ ? { runSandboxedCode: config.runSandboxedCode }
248
+ : {}),
249
+ ...(config.embedding ? { embedding: config.embedding } : {}),
250
+ ...(config.vectorStoreBindings
251
+ ? { vectorStoreBindings: config.vectorStoreBindings }
252
+ : {}),
253
+ ...(config.vectorStoreDrivers
254
+ ? { vectorStoreDrivers: config.vectorStoreDrivers }
255
+ : {}),
256
+ ...(config.resolveVectorStore
257
+ ? { resolveVectorStore: config.resolveVectorStore }
258
+ : {}),
259
+ },
260
+ });
261
+ const stepHandlers = [
262
+ ...hostStepHandlers,
263
+ ...(agentRuntime
264
+ ? registeredStepHandlers
265
+ : registeredStepHandlers.filter((handler) => handler.kind !== "core.agent")),
266
+ ];
90
267
  this.compiler = new MastraWorkflowCompiler({ stepHandlers });
268
+ // SAA-836 O1: wire the mastra engine's observability layer onto the real
269
+ // runtime — langfuse as the default and always-present export target plus
270
+ // the OUR-node isolation exporter. Fails closed on credentials (gate C)
271
+ // when the observability lane is enabled on a mastra-native runtime;
272
+ // duck-typed runtimes without a mastra `registerExporter` surface (test
273
+ // doubles) are skipped so the general engine keeps booting them unchanged.
274
+ this.observability = await wireMastraObservability(this.runtime);
91
275
  this.initialized = true;
92
276
  }
93
277
  get capabilities() {
@@ -112,6 +296,33 @@ export class MastraGraphExecutionBackend {
112
296
  }
113
297
  return this.managementManager;
114
298
  }
299
+ /**
300
+ * The owner-scoped metrics gateway over the wired runtime's real mastra
301
+ * storage (SAA-836 S2): read-only agent run/score/trace metrics served
302
+ * through the dedicated decaf adapter/statement/paginator, with C23
303
+ * foreign-owner deny resolved against the same catalogue ownership map the
304
+ * workflow lookups use. Storage resolution itself fails closed inside the
305
+ * gateway when the runtime exposes no storage or the queried domain is absent.
306
+ */
307
+ get metrics() {
308
+ // Cache per backend (C7): `initialize` rewires the runtime, so a gateway
309
+ // bound to a previous runtime must not survive the rebind.
310
+ if (!this.metricsGateway) {
311
+ this.metricsGateway = new MastraMetricsGateway({
312
+ mastra: this.runtime,
313
+ ownership: {
314
+ resolveWorkflow: (workflowId) => {
315
+ const entry = this.documents.get(workflowId);
316
+ if (!entry)
317
+ return undefined;
318
+ return { known: true, ...(entry.owner ? { owner: entry.owner } : {}) };
319
+ },
320
+ },
321
+ alias: `mastra-metrics-${++MASTRA_METRICS_ADAPTER_SEQUENCE}`,
322
+ });
323
+ }
324
+ return this.metricsGateway;
325
+ }
115
326
  /**
116
327
  * Lists the translated workflows visible to the requesting caller (C23). The
117
328
  * catalogue is ownership-filtered with the same
@@ -158,6 +369,31 @@ export class MastraGraphExecutionBackend {
158
369
  }
159
370
  return entry.document;
160
371
  }
372
+ /**
373
+ * Seeds canonical workflow documents into the translated-workflow catalogue so
374
+ * they are served by {@link listWorkflows}/{@link getWorkflow} exactly like a
375
+ * document recorded by {@link execute}. Seeded entries are owner-less, so the
376
+ * C23 filter keeps them visible to every caller (the owner-less visibility
377
+ * rule). Fails closed when the backend has not been initialized.
378
+ *
379
+ * @param documents - The canonical documents to register.
380
+ * @returns The seeded workflow summaries.
381
+ * @throws {GraphExecutionError} when the backend is not initialized.
382
+ */
383
+ async seedWorkflows(documents) {
384
+ if (!this.initialized) {
385
+ throw new GraphExecutionError("MastraGraphExecutionBackend must be initialized before seeding workflows", GRAPH_MASTRA_UNSUPPORTED_KIND);
386
+ }
387
+ const summaries = [];
388
+ for (const document of documents) {
389
+ this.documents.set(document.id, { document });
390
+ summaries.push({
391
+ id: document.id,
392
+ ...(document.name ? { name: document.name } : {}),
393
+ });
394
+ }
395
+ return summaries;
396
+ }
161
397
  async execute(request, ...args) {
162
398
  const sink = request.events;
163
399
  const frame = sink.frame;
@@ -172,7 +408,24 @@ export class MastraGraphExecutionBackend {
172
408
  });
173
409
  this.runWorkflows.set(runId, request.document.id);
174
410
  const compiled = this.compiler.compile(request.document);
175
- const workflow = compiled.workflow;
411
+ // SAA-836 O1: record the cache ledger entry and atomically invalidate
412
+ // stale entries for this document (gate A: recompilation only on
413
+ // document change). Never fails the run.
414
+ await this.recordCacheLedger(compiled, request.document.id);
415
+ // SAA-836 O1: bind the compiled workflow to the wired runtime before the
416
+ // run starts, so the run executes under the mastra engine's own
417
+ // observability context (the root `workflow_run` span is created against
418
+ // the registered runtime's observability) and every engine signal reaches
419
+ // the configured exporters — langfuse by default. A runtime without the
420
+ // mastra workflow-registration surface (a duck-typed test double) keeps
421
+ // the direct compiled-workflow run path.
422
+ const workflow = this.bindCompiledWorkflow(compiled);
423
+ // SAA-836 O1: the OUR-node isolation exporter attributes mastra's
424
+ // workflow-step spans to the canonical nodes of this document.
425
+ this.observability?.decafExporter.trackNodes((request.document.nodes ?? []).map((node) => ({
426
+ id: node.id,
427
+ kind: node.kind,
428
+ })));
176
429
  if (typeof workflow.createRun !== "function") {
177
430
  throw new GraphExecutionError("Mastra backend received a workflow without a createRun method", GRAPH_MASTRA_AGENT_UNAVAILABLE, { workflowId: request.document.id });
178
431
  }
@@ -185,18 +438,37 @@ export class MastraGraphExecutionBackend {
185
438
  path: [],
186
439
  });
187
440
  let status = GraphExecutionStatus.SUCCEEDED;
441
+ let resolvedRunOutput = undefined;
442
+ const signal = request.options?.abortSignal;
188
443
  try {
189
444
  const run = await workflow.createRun({ runId });
190
- const stream = await run.stream({ inputData: request.inputs });
191
- if (stream.fullStream) {
192
- await bridge.attach(stream.fullStream);
193
- }
194
- if (typeof run.getResult === "function") {
195
- await run.getResult();
196
- }
197
- else if (stream.result) {
198
- await stream.result;
199
- }
445
+ const stream = await run.stream({
446
+ inputData: request.inputs,
447
+ ...(signal ? { abortSignal: signal } : {}),
448
+ });
449
+ const execution = (async () => {
450
+ if (stream.fullStream) {
451
+ await bridge.attach(stream.fullStream);
452
+ }
453
+ if (typeof run.getResult === "function") {
454
+ resolvedRunOutput = await run.getResult();
455
+ }
456
+ else if (stream.result) {
457
+ resolvedRunOutput = await stream.result;
458
+ }
459
+ })();
460
+ await this.awaitTerminal(execution, signal, request.document.id);
461
+ // A Mastra run does not reject on a step failure: it resolves with a
462
+ // terminal result and closes the stream with a `workflow-finish` event. The
463
+ // returned status must therefore be read from that terminal outcome, never
464
+ // assumed from the bare fact that the await resolved. The bridge is the
465
+ // authority because it emitted the matching terminal event; the run's own
466
+ // result/status is the fallback when the stream was not observed.
467
+ const terminal = bridge.terminalStatus ??
468
+ mastraRunTerminalStatus(resolvedRunOutput) ??
469
+ mastraRunTerminalStatus(stream.status);
470
+ if (terminal)
471
+ status = terminal;
200
472
  }
201
473
  catch (error) {
202
474
  status = GraphExecutionStatus.FAILED;
@@ -206,9 +478,105 @@ export class MastraGraphExecutionBackend {
206
478
  error: this.errorPayload(error),
207
479
  });
208
480
  }
481
+ // SAA-836 O1: persist a versioned replay snapshot of the terminal
482
+ // outcome (replays layer) before the frame closes. Never fails the run.
483
+ await this.recordReplaySnapshot({
484
+ runId,
485
+ workflowId: request.document.id,
486
+ documentFingerprint: compiled.fingerprint,
487
+ status,
488
+ resolvedRunOutput,
489
+ });
209
490
  frame.finish();
210
491
  return buildGraphExecutionResult(frame, request.document, request.inputs, status, { backend: MASTRA_BACKEND_FLAVOUR, documentFingerprint: compiled.fingerprint });
211
492
  }
493
+ /**
494
+ * Bounds the translated run's terminal wait by the backend's run-level
495
+ * `terminalTimeoutMs` and the caller's cancellation signal, mirroring the
496
+ * Dagster observation bound. Exceeding the timeout fails closed with
497
+ * {@link GRAPH_MASTRA_EXECUTE_TIMEOUT}; an abort fails closed with
498
+ * {@link GRAPH_MASTRA_EXECUTE_ABORTED}. The underlying run is not force-killed
499
+ * (Mastra owns run lifecycle), but the backend stops awaiting it so the run
500
+ * slot and event bridge are released and the run cannot pin the process.
501
+ *
502
+ * @param execution - The in-flight run/stream/result promise.
503
+ * @param signal - The caller's cancellation signal, when supplied.
504
+ * @param workflowId - The workflow id the run belongs to (for error details).
505
+ * @returns Resolves once the run terminates normally.
506
+ * @throws {GraphExecutionError} on timeout or abort.
507
+ */
508
+ async awaitTerminal(execution, signal, workflowId) {
509
+ const timeoutMs = this.terminalTimeoutMs;
510
+ await new Promise((resolve, reject) => {
511
+ let settled = false;
512
+ let timer;
513
+ const cleanup = () => {
514
+ if (timer)
515
+ clearTimeout(timer);
516
+ signal?.removeEventListener("abort", onAbort);
517
+ };
518
+ const finish = (settle) => {
519
+ if (settled)
520
+ return;
521
+ settled = true;
522
+ cleanup();
523
+ settle();
524
+ };
525
+ const onAbort = () => finish(() => reject(new GraphExecutionError(`Mastra run for workflow '${workflowId}' was aborted`, GRAPH_MASTRA_EXECUTE_ABORTED, { workflowId })));
526
+ if (signal?.aborted) {
527
+ onAbort();
528
+ return;
529
+ }
530
+ if (signal)
531
+ signal.addEventListener("abort", onAbort, { once: true });
532
+ if (timeoutMs > 0) {
533
+ timer = setTimeout(() => finish(() => reject(new GraphExecutionError(`Mastra run for workflow '${workflowId}' did not terminate within ${timeoutMs}ms`, GRAPH_MASTRA_EXECUTE_TIMEOUT, { workflowId, terminalTimeoutMs: timeoutMs }))), timeoutMs);
534
+ }
535
+ execution.then(() => finish(resolve), (error) => finish(() => reject(error)));
536
+ });
537
+ }
538
+ /**
539
+ * Binds a compiled workflow to the wired mastra runtime so its runs execute
540
+ * under the runtime's own observability context (SAA-836 O1). The compiler
541
+ * caches by document id and fingerprint, so a recompiled document either
542
+ * matches the registered instance (no-op) or replaces it (`removeWorkflow`
543
+ * + `addWorkflow`) before the run starts. Runtimes without the mastra
544
+ * workflow-registration surface (duck-typed test doubles) return the
545
+ * unbound compiled workflow, keeping the direct run path.
546
+ *
547
+ * @param compiled - The compilation to bind.
548
+ * @returns The workflow to run: the runtime-bound compiled workflow when
549
+ * the runtime is mastra-native, else the unbound compiled workflow.
550
+ */
551
+ bindCompiledWorkflow(compiled) {
552
+ const workflow = compiled.workflow;
553
+ const runtime = this.runtime;
554
+ if (!isRecord(runtime))
555
+ return workflow;
556
+ const addWorkflow = runtime["addWorkflow"];
557
+ const getWorkflow = runtime["getWorkflow"];
558
+ if (typeof addWorkflow !== "function" || typeof getWorkflow !== "function") {
559
+ return workflow;
560
+ }
561
+ const existing = (() => {
562
+ // A real mastra runtime throws `MASTRA_GET_WORKFLOW_BY_ID_NOT_FOUND`
563
+ // for an unregistered id; treat that as "not registered".
564
+ try {
565
+ return getWorkflow.call(runtime, compiled.workflowId);
566
+ }
567
+ catch {
568
+ return undefined;
569
+ }
570
+ })();
571
+ if (existing !== workflow) {
572
+ const removeWorkflow = runtime["removeWorkflow"];
573
+ if (typeof removeWorkflow === "function" && existing !== undefined) {
574
+ removeWorkflow.call(runtime, compiled.workflowId);
575
+ }
576
+ addWorkflow.call(runtime, workflow, compiled.workflowId);
577
+ }
578
+ return workflow;
579
+ }
212
580
  /**
213
581
  * Resumes a suspended Mastra run after enforcing the SAA-193 resume guard
214
582
  * (C13/C15/C16/C17/C18). The Mastra run snapshot is authoritative for the
@@ -305,8 +673,108 @@ export class MastraGraphExecutionBackend {
305
673
  this.runWorkflows.clear();
306
674
  this.runtime = undefined;
307
675
  this.managementManager = undefined;
676
+ if (this.observability) {
677
+ await this.observability.flush();
678
+ await this.observability.shutdown();
679
+ this.observability = undefined;
680
+ }
681
+ if (this.persistenceInstance && this.persistenceOwned) {
682
+ await this.persistenceInstance.shutdown();
683
+ }
684
+ this.persistenceInstance = undefined;
685
+ this.persistenceOwned = false;
686
+ this.persistenceBroken = false;
687
+ this.terminalTimeoutMs = MastraEnvironment.mastra.engine.terminalTimeoutMs;
308
688
  this.initialized = false;
309
689
  }
690
+ /**
691
+ * The routed per-layer persistence surface (SAA-836 O1), when it resolved.
692
+ * The host-supplied surface ({@link MastraBackendConfig.persistence}) takes
693
+ * precedence; otherwise the Environment-routed surface
694
+ * (`MASTRA__PERSISTENCE__*`: replays → `fs`, cache → `ram`, pins → `fs`)
695
+ * is created lazily on first use so hosts that never record pay nothing.
696
+ * Undefined after a routing failure: persistence recording is auxiliary
697
+ * (fail-open), while a restore of a missing snapshot still fails closed
698
+ * inside the repository (R7).
699
+ */
700
+ get persistence() {
701
+ return this.persistenceInstance;
702
+ }
703
+ /** Resolves the persistence surface, memoized and fail-open on routing failure. */
704
+ async persistenceFor() {
705
+ if (this.persistenceBroken)
706
+ return undefined;
707
+ if (this.persistenceInstance)
708
+ return this.persistenceInstance;
709
+ const hostPersistence = this._config?.persistence;
710
+ if (hostPersistence) {
711
+ this.persistenceInstance = hostPersistence;
712
+ this.persistenceOwned = false;
713
+ return this.persistenceInstance;
714
+ }
715
+ try {
716
+ this.persistenceInstance = await createMastraPersistence();
717
+ this.persistenceOwned = true;
718
+ return this.persistenceInstance;
719
+ }
720
+ catch (error) {
721
+ this.persistenceBroken = true;
722
+ this.logger
723
+ ?.for({ scope: "persistence" })
724
+ .warn(`[mastra-persistence] routing failed; recording disabled: ${String(error)}`);
725
+ return undefined;
726
+ }
727
+ }
728
+ /**
729
+ * Records the compiled-workflow cache ledger entry for a document (cache
730
+ * layer, `ram` by default) and invalidates stale entries compiled from a
731
+ * different fingerprint — the atomic cache invalidation on document change
732
+ * (gate A: recompilation only when the document changes, never per run).
733
+ * Ledger failures never fail the run (fail-open recording).
734
+ */
735
+ async recordCacheLedger(compiled, workflowId) {
736
+ const persistence = await this.persistenceFor();
737
+ if (!persistence)
738
+ return;
739
+ try {
740
+ await persistence.cache.record(workflowId, compiled.fingerprint);
741
+ await persistence.cache.invalidate(workflowId, compiled.fingerprint);
742
+ }
743
+ catch (error) {
744
+ this.logger
745
+ ?.for({ scope: "persistence", layer: "cache" })
746
+ .warn(`[mastra-persistence] cache ledger recording failed: ${String(error)}`);
747
+ }
748
+ }
749
+ /**
750
+ * Records a versioned replay snapshot of a run's terminal outcome (replays
751
+ * layer, `fs` by default): a JSON-safe projection of the resolved run
752
+ * output, status and fingerprint — restorable through
753
+ * `persistence.replays.restore(runId, version?)`. Recording failures never
754
+ * fail the run (fail-open recording).
755
+ */
756
+ async recordReplaySnapshot(params) {
757
+ const persistence = await this.persistenceFor();
758
+ if (!persistence)
759
+ return;
760
+ try {
761
+ await persistence.replays.record({
762
+ runId: params.runId,
763
+ workflowId: params.workflowId,
764
+ documentFingerprint: params.documentFingerprint,
765
+ status: params.status,
766
+ payload: {
767
+ status: params.status,
768
+ output: jsonSafeProjection(params.resolvedRunOutput),
769
+ },
770
+ });
771
+ }
772
+ catch (error) {
773
+ this.logger
774
+ ?.for({ scope: "persistence", layer: "replays" })
775
+ .warn(`[mastra-persistence] replay recording failed: ${String(error)}`);
776
+ }
777
+ }
310
778
  /**
311
779
  * The configuration most recently resolved by {@link initialize}. Exposed so
312
780
  * `GraphExecutionEngine.initialize` can merge its facade-owned collaborators
@@ -320,24 +788,49 @@ export class MastraGraphExecutionBackend {
320
788
  get ready() {
321
789
  return this.initialized;
322
790
  }
791
+ /**
792
+ * The storage-wiring status resolved by the last {@link initialize} when the
793
+ * host declared `MastraBackendConfig.storage` (SAA-926 §6.2); `undefined`
794
+ * when the host declared no storage config. The acceptance seam for the
795
+ * "storage configured and durable" check: `domains.workflows` must not be
796
+ * `in-memory`/`absent` on a production host.
797
+ */
798
+ get storageStatus() {
799
+ return this._storageStatus;
800
+ }
323
801
  async loadRun(runId) {
324
802
  const runtime = this.runtime;
325
803
  if (!isRecord(runtime))
326
804
  return undefined;
327
805
  const getRun = runtime["getRun"];
328
- if (typeof getRun !== "function")
329
- return undefined;
330
- const run = await getRun.call(runtime, runId);
331
- return isRecord(run) ? run : undefined;
806
+ if (typeof getRun === "function") {
807
+ const run = await getRun.call(runtime, runId);
808
+ return isRecord(run) ? run : undefined;
809
+ }
810
+ // SAA-926 §6.3: @mastra/core 1.77.0 exposes no public `getRun` on the
811
+ // `Mastra` class, so a plain runtime left resume failing closed. Recover
812
+ // the resumable run handle through mastra's own restart-recovery pattern:
813
+ // resolve the persisted run record from the configured storage workflows
814
+ // domain, then rebind the run id onto the live workflow via
815
+ // `createRun({ runId })`.
816
+ const recovered = await recoverMastraRunHandle(runtime, runId);
817
+ return isRecord(recovered) ? recovered : undefined;
332
818
  }
333
819
  errorPayload(error) {
334
820
  if (error instanceof Error) {
821
+ const graphCode = error.graphCode;
822
+ const code = error.code;
823
+ const normalised = typeof graphCode === "string"
824
+ ? graphCode
825
+ : typeof code === "number"
826
+ ? String(code)
827
+ : typeof code === "string"
828
+ ? code
829
+ : undefined;
335
830
  return {
336
831
  name: error.name,
337
832
  message: error.message,
338
- ...(typeof error.code === "string"
339
- ? { code: error.code }
340
- : {}),
833
+ ...(normalised !== undefined ? { code: normalised } : {}),
341
834
  };
342
835
  }
343
836
  return { name: "MastraError", message: String(error) };