@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,6 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.MastraGraphExecutionBackend = void 0;
4
+ const logging_1 = require("@decaf-ts/logging");
4
5
  const db_decorators_1 = require("@decaf-ts/db-decorators");
5
6
  const constants_js_1 = require("./../shared/graph/constants.cjs");
6
7
  const GraphExecutionBackendRegistry_js_1 = require("./../engine/execution/GraphExecutionBackendRegistry.cjs");
@@ -12,14 +13,54 @@ const GraphExecutionResult_js_1 = require("./../engine/execution/GraphExecutionR
12
13
  const MastraWorkflowCompiler_js_1 = require("./MastraWorkflowCompiler.cjs");
13
14
  const MastraWorkflowManager_js_1 = require("./MastraWorkflowManager.cjs");
14
15
  const MastraEventBridge_js_1 = require("./MastraEventBridge.cjs");
16
+ const MastraRunRecovery_js_1 = require("./MastraRunRecovery.cjs");
17
+ const MastraStorageWiring_js_1 = require("./MastraStorageWiring.cjs");
15
18
  const MastraResumeGuard_js_1 = require("./MastraResumeGuard.cjs");
16
19
  const MastraSchemaConverter_js_1 = require("./MastraSchemaConverter.cjs");
17
20
  const MastraCapabilities_js_1 = require("./MastraCapabilities.cjs");
21
+ const MastraAgentStepHandler_js_1 = require("./MastraAgentStepHandler.cjs");
22
+ const MastraEnvironment_js_1 = require("./MastraEnvironment.cjs");
23
+ const index_js_1 = require("./nodes/index.cjs");
24
+ const MastraObservability_js_1 = require("./MastraObservability.cjs");
25
+ const MastraPersistence_js_1 = require("./MastraPersistence.cjs");
26
+ const MastraMetricsGateway_js_1 = require("./MastraMetricsGateway.cjs");
18
27
  const types_js_1 = require("./types.cjs");
19
28
  const DEFAULT_MAX_RESUME_BYTES = 64 * 1024;
20
29
  function isRecord(value) {
21
30
  return !!value && typeof value === "object" && !Array.isArray(value);
22
31
  }
32
+ /**
33
+ * Maps a Mastra run's terminal status (from the resolved run result
34
+ * `{ status }` or the stream's raw `status`) onto a canonical
35
+ * GraphExecutionStatus. A tripwire guardrail abort and an explicit failure both
36
+ * map to FAILED.
37
+ *
38
+ * @param {unknown} value - The run result object (with a `status` string) or a
39
+ * raw status string.
40
+ * @return {GraphExecutionStatus | undefined} The canonical terminal status, or
41
+ * `undefined` for a non-terminal status (suspended/paused) so the caller keeps
42
+ * its prior disposition.
43
+ */
44
+ function mastraRunTerminalStatus(value) {
45
+ const raw = typeof value === "string"
46
+ ? value
47
+ : isRecord(value) && typeof value["status"] === "string"
48
+ ? value["status"]
49
+ : undefined;
50
+ switch (raw) {
51
+ case "success":
52
+ case "succeeded":
53
+ return constants_js_1.GraphExecutionStatus.SUCCEEDED;
54
+ case "failed":
55
+ case "tripwire":
56
+ return constants_js_1.GraphExecutionStatus.FAILED;
57
+ case "canceled":
58
+ case "cancelled":
59
+ return constants_js_1.GraphExecutionStatus.CANCELLED;
60
+ default:
61
+ return undefined;
62
+ }
63
+ }
23
64
  /**
24
65
  * Structural check for a Decaf execution {@link Context} inside a
25
66
  * {@link MaybeContextualArg} argument list. Mirrors `@decaf-ts/core`'s own
@@ -57,6 +98,10 @@ function mastraCallerOwnerOf(args) {
57
98
  }
58
99
  return undefined;
59
100
  }
101
+ // Guarantees a unique adapter alias per metrics gateway construction: the Decaf
102
+ // adapter registry rejects duplicate aliases, and a backend rebind builds a new
103
+ // gateway over a new runtime.
104
+ let MASTRA_METRICS_ADAPTER_SEQUENCE = 0;
60
105
  /**
61
106
  * `@mastra/core`-translated execution backend (SAA-196). Translates the
62
107
  * canonical document into a Mastra workflow, runs it through the injected Mastra
@@ -74,23 +119,162 @@ class MastraGraphExecutionBackend {
74
119
  this.documents = new Map();
75
120
  this.runWorkflows = new Map();
76
121
  this.maxResumeBytes = DEFAULT_MAX_RESUME_BYTES;
122
+ this.terminalTimeoutMs = MastraEnvironment_js_1.MastraEnvironment.mastra.engine.terminalTimeoutMs;
77
123
  this.initialized = false;
124
+ this.persistenceOwned = false;
125
+ this.persistenceBroken = false;
126
+ this.logger = logging_1.Logging.for("MastraGraphExecutionBackend");
78
127
  GraphExecutionBackendRegistry_js_1.GraphExecutionBackendRegistry.register(types_js_1.MASTRA_BACKEND_FLAVOUR, this);
79
128
  }
129
+ /**
130
+ * Initializes the backend from the host configuration (SAA-836 S1: the
131
+ * engine boots from Environment config only). Fails closed with
132
+ * {@link GRAPH_MASTRA_ENGINE_DISABLED} when the mastra lane is disabled in
133
+ * the environment (`MASTRA__ENGINE__ENABLED=false`). The run-level terminal
134
+ * timeout defaults to the environment-derived
135
+ * `MASTRA__ENGINE__TERMINAL_TIMEOUT_MS` unless the host config sets its own
136
+ * positive value. The `core.agent` step handler is registered from an
137
+ * explicit {@link MastraBackendConfig.agentRuntime}, else from the agent
138
+ * map/factory — with the host decaf-model registry
139
+ * {@link MastraBackendConfig.resolveStructuredOutputModel} passed through so
140
+ * structured-output definitions referencing a model name convert through
141
+ * `@decaf-ts/as-zod`; when none is supplied the kind is left to fail closed,
142
+ * never to a fabricated echo.
143
+ *
144
+ * When the host declares `MastraBackendConfig.storage` (SAA-926 §6.2), it is
145
+ * wired onto the runtime through {@link wireMastraStorage} before any step
146
+ * handler registration; the wiring fails closed on an unwired runtime or a
147
+ * non-durable workflows domain, and the resolved outcome is exposed via
148
+ * {@link MastraGraphExecutionBackend.storageStatus}.
149
+ *
150
+ * @param config - The host-injected backend configuration.
151
+ * @throws {GraphExecutionError} when the mastra lane is disabled by the
152
+ * environment, when the declared storage cannot be wired
153
+ * ({@link GRAPH_MASTRA_STORAGE_UNWIRED}), or when the wired storage does
154
+ * not resolve a durable workflows domain
155
+ * ({@link GRAPH_MASTRA_STORAGE_DOMAIN_INMEMORY}).
156
+ */
80
157
  async initialize(config) {
158
+ // SAA-836 S1: the engine boots from Environment config only, and fails
159
+ // closed when the mastra lane is disabled (`MASTRA__ENGINE__ENABLED=false`).
160
+ if (!MastraEnvironment_js_1.MastraEnvironment.mastra.engine.enabled) {
161
+ throw new GraphExecutionError_js_1.GraphExecutionError("The mastra engine lane is disabled by the environment (MASTRA__ENGINE__ENABLED=false)", MastraEnvironment_js_1.GRAPH_MASTRA_ENGINE_DISABLED);
162
+ }
81
163
  this._config = config;
82
164
  this.runtime = config.mastra;
83
165
  // Re-initializing rewires the runtime/compiler, so a previously cached
84
166
  // management surface must not survive the rebind (C7).
85
167
  this.managementManager = undefined;
86
168
  this.suspendStateReader = config.suspendStateReader;
169
+ this.metricsGateway = undefined;
170
+ // SAA-926 §6.2: `MastraBackendConfig.storage` was declared but never read,
171
+ // so a host declaring durable storage silently persisted in-memory. Wire the
172
+ // declared storage onto the runtime and fail closed when the runtime cannot
173
+ // accept it or the resolved workflows domain is not durable.
174
+ this._storageStatus = undefined;
175
+ if (config.storage !== undefined) {
176
+ this._storageStatus = await (0, MastraStorageWiring_js_1.wireMastraStorage)(this.runtime, config.storage);
177
+ }
87
178
  if (typeof config.maxResumeBytes === "number" && config.maxResumeBytes > 0) {
88
179
  this.maxResumeBytes = config.maxResumeBytes;
89
180
  }
90
- const stepHandlers = Array.isArray(config.stepHandlers)
91
- ? [...config.stepHandlers]
181
+ this.terminalTimeoutMs =
182
+ typeof config.terminalTimeoutMs === "number" &&
183
+ config.terminalTimeoutMs > 0
184
+ ? config.terminalTimeoutMs
185
+ // SAA-836 S1: the engine boots from Environment config only — the
186
+ // default terminal timeout comes from the accumulated mastra
187
+ // environment (`MASTRA__ENGINE__TERMINAL_TIMEOUT_MS`), not a constant.
188
+ : MastraEnvironment_js_1.MastraEnvironment.mastra.engine.terminalTimeoutMs;
189
+ const agentRuntime = config.agentRuntime ??
190
+ (config.agents ||
191
+ config.createAgent ||
192
+ config.memories ||
193
+ config.createMemory ||
194
+ config.memoryStorageBindings ||
195
+ config.memoryVectorStore ||
196
+ config.memoryEmbedder !== undefined
197
+ ? (0, MastraAgentStepHandler_js_1.createMastraAgentRuntimeFromConfig)({
198
+ agents: config.agents,
199
+ createAgent: config.createAgent,
200
+ memories: config.memories,
201
+ createMemory: config.createMemory,
202
+ ...(config.memoryStorageBindings
203
+ ? { memoryStorageBindings: config.memoryStorageBindings }
204
+ : {}),
205
+ ...(config.memoryVectorStore
206
+ ? { memoryVectorStore: config.memoryVectorStore }
207
+ : {}),
208
+ ...(config.memoryEmbedder !== undefined
209
+ ? { memoryEmbedder: config.memoryEmbedder }
210
+ : {}),
211
+ })
212
+ : undefined);
213
+ const hostStepHandlers = Array.isArray(config.stepHandlers)
214
+ ? config.stepHandlers
92
215
  : [];
216
+ const registeredStepHandlers = (0, index_js_1.createMastraNodeStepHandlers)({
217
+ agent: {
218
+ ...(agentRuntime ? { runtime: agentRuntime } : {}),
219
+ ...(config.resolveProcessorModel
220
+ ? { resolveProcessorModel: config.resolveProcessorModel }
221
+ : {}),
222
+ ...(config.resolveStructuredOutputModel
223
+ ? { resolveModel: config.resolveStructuredOutputModel }
224
+ : {}),
225
+ },
226
+ mcp: {
227
+ ...(config.createMcpServer
228
+ ? { createMcpServer: config.createMcpServer }
229
+ : {}),
230
+ },
231
+ channelTrigger: {
232
+ ...(config.resolveChannelAdapter
233
+ ? { resolveChannelAdapter: config.resolveChannelAdapter }
234
+ : {}),
235
+ },
236
+ channelResponse: {
237
+ ...(config.sendChannelResponse
238
+ ? { sendChannelResponse: config.sendChannelResponse }
239
+ : {}),
240
+ },
241
+ voice: {
242
+ ...(config.resolveVoice ? { resolveVoice: config.resolveVoice } : {}),
243
+ },
244
+ rag: {
245
+ ...(config.embedText ? { embedText: config.embedText } : {}),
246
+ ...(config.generateText
247
+ ? { generateText: config.generateText }
248
+ : {}),
249
+ ...(config.runSandboxedCode
250
+ ? { runSandboxedCode: config.runSandboxedCode }
251
+ : {}),
252
+ ...(config.embedding ? { embedding: config.embedding } : {}),
253
+ ...(config.vectorStoreBindings
254
+ ? { vectorStoreBindings: config.vectorStoreBindings }
255
+ : {}),
256
+ ...(config.vectorStoreDrivers
257
+ ? { vectorStoreDrivers: config.vectorStoreDrivers }
258
+ : {}),
259
+ ...(config.resolveVectorStore
260
+ ? { resolveVectorStore: config.resolveVectorStore }
261
+ : {}),
262
+ },
263
+ });
264
+ const stepHandlers = [
265
+ ...hostStepHandlers,
266
+ ...(agentRuntime
267
+ ? registeredStepHandlers
268
+ : registeredStepHandlers.filter((handler) => handler.kind !== "core.agent")),
269
+ ];
93
270
  this.compiler = new MastraWorkflowCompiler_js_1.MastraWorkflowCompiler({ stepHandlers });
271
+ // SAA-836 O1: wire the mastra engine's observability layer onto the real
272
+ // runtime — langfuse as the default and always-present export target plus
273
+ // the OUR-node isolation exporter. Fails closed on credentials (gate C)
274
+ // when the observability lane is enabled on a mastra-native runtime;
275
+ // duck-typed runtimes without a mastra `registerExporter` surface (test
276
+ // doubles) are skipped so the general engine keeps booting them unchanged.
277
+ this.observability = await (0, MastraObservability_js_1.wireMastraObservability)(this.runtime);
94
278
  this.initialized = true;
95
279
  }
96
280
  get capabilities() {
@@ -115,6 +299,33 @@ class MastraGraphExecutionBackend {
115
299
  }
116
300
  return this.managementManager;
117
301
  }
302
+ /**
303
+ * The owner-scoped metrics gateway over the wired runtime's real mastra
304
+ * storage (SAA-836 S2): read-only agent run/score/trace metrics served
305
+ * through the dedicated decaf adapter/statement/paginator, with C23
306
+ * foreign-owner deny resolved against the same catalogue ownership map the
307
+ * workflow lookups use. Storage resolution itself fails closed inside the
308
+ * gateway when the runtime exposes no storage or the queried domain is absent.
309
+ */
310
+ get metrics() {
311
+ // Cache per backend (C7): `initialize` rewires the runtime, so a gateway
312
+ // bound to a previous runtime must not survive the rebind.
313
+ if (!this.metricsGateway) {
314
+ this.metricsGateway = new MastraMetricsGateway_js_1.MastraMetricsGateway({
315
+ mastra: this.runtime,
316
+ ownership: {
317
+ resolveWorkflow: (workflowId) => {
318
+ const entry = this.documents.get(workflowId);
319
+ if (!entry)
320
+ return undefined;
321
+ return { known: true, ...(entry.owner ? { owner: entry.owner } : {}) };
322
+ },
323
+ },
324
+ alias: `mastra-metrics-${++MASTRA_METRICS_ADAPTER_SEQUENCE}`,
325
+ });
326
+ }
327
+ return this.metricsGateway;
328
+ }
118
329
  /**
119
330
  * Lists the translated workflows visible to the requesting caller (C23). The
120
331
  * catalogue is ownership-filtered with the same
@@ -161,6 +372,31 @@ class MastraGraphExecutionBackend {
161
372
  }
162
373
  return entry.document;
163
374
  }
375
+ /**
376
+ * Seeds canonical workflow documents into the translated-workflow catalogue so
377
+ * they are served by {@link listWorkflows}/{@link getWorkflow} exactly like a
378
+ * document recorded by {@link execute}. Seeded entries are owner-less, so the
379
+ * C23 filter keeps them visible to every caller (the owner-less visibility
380
+ * rule). Fails closed when the backend has not been initialized.
381
+ *
382
+ * @param documents - The canonical documents to register.
383
+ * @returns The seeded workflow summaries.
384
+ * @throws {GraphExecutionError} when the backend is not initialized.
385
+ */
386
+ async seedWorkflows(documents) {
387
+ if (!this.initialized) {
388
+ throw new GraphExecutionError_js_1.GraphExecutionError("MastraGraphExecutionBackend must be initialized before seeding workflows", types_js_1.GRAPH_MASTRA_UNSUPPORTED_KIND);
389
+ }
390
+ const summaries = [];
391
+ for (const document of documents) {
392
+ this.documents.set(document.id, { document });
393
+ summaries.push({
394
+ id: document.id,
395
+ ...(document.name ? { name: document.name } : {}),
396
+ });
397
+ }
398
+ return summaries;
399
+ }
164
400
  async execute(request, ...args) {
165
401
  const sink = request.events;
166
402
  const frame = sink.frame;
@@ -175,7 +411,24 @@ class MastraGraphExecutionBackend {
175
411
  });
176
412
  this.runWorkflows.set(runId, request.document.id);
177
413
  const compiled = this.compiler.compile(request.document);
178
- const workflow = compiled.workflow;
414
+ // SAA-836 O1: record the cache ledger entry and atomically invalidate
415
+ // stale entries for this document (gate A: recompilation only on
416
+ // document change). Never fails the run.
417
+ await this.recordCacheLedger(compiled, request.document.id);
418
+ // SAA-836 O1: bind the compiled workflow to the wired runtime before the
419
+ // run starts, so the run executes under the mastra engine's own
420
+ // observability context (the root `workflow_run` span is created against
421
+ // the registered runtime's observability) and every engine signal reaches
422
+ // the configured exporters — langfuse by default. A runtime without the
423
+ // mastra workflow-registration surface (a duck-typed test double) keeps
424
+ // the direct compiled-workflow run path.
425
+ const workflow = this.bindCompiledWorkflow(compiled);
426
+ // SAA-836 O1: the OUR-node isolation exporter attributes mastra's
427
+ // workflow-step spans to the canonical nodes of this document.
428
+ this.observability?.decafExporter.trackNodes((request.document.nodes ?? []).map((node) => ({
429
+ id: node.id,
430
+ kind: node.kind,
431
+ })));
179
432
  if (typeof workflow.createRun !== "function") {
180
433
  throw new GraphExecutionError_js_1.GraphExecutionError("Mastra backend received a workflow without a createRun method", types_js_1.GRAPH_MASTRA_AGENT_UNAVAILABLE, { workflowId: request.document.id });
181
434
  }
@@ -188,18 +441,37 @@ class MastraGraphExecutionBackend {
188
441
  path: [],
189
442
  });
190
443
  let status = constants_js_1.GraphExecutionStatus.SUCCEEDED;
444
+ let resolvedRunOutput = undefined;
445
+ const signal = request.options?.abortSignal;
191
446
  try {
192
447
  const run = await workflow.createRun({ runId });
193
- const stream = await run.stream({ inputData: request.inputs });
194
- if (stream.fullStream) {
195
- await bridge.attach(stream.fullStream);
196
- }
197
- if (typeof run.getResult === "function") {
198
- await run.getResult();
199
- }
200
- else if (stream.result) {
201
- await stream.result;
202
- }
448
+ const stream = await run.stream({
449
+ inputData: request.inputs,
450
+ ...(signal ? { abortSignal: signal } : {}),
451
+ });
452
+ const execution = (async () => {
453
+ if (stream.fullStream) {
454
+ await bridge.attach(stream.fullStream);
455
+ }
456
+ if (typeof run.getResult === "function") {
457
+ resolvedRunOutput = await run.getResult();
458
+ }
459
+ else if (stream.result) {
460
+ resolvedRunOutput = await stream.result;
461
+ }
462
+ })();
463
+ await this.awaitTerminal(execution, signal, request.document.id);
464
+ // A Mastra run does not reject on a step failure: it resolves with a
465
+ // terminal result and closes the stream with a `workflow-finish` event. The
466
+ // returned status must therefore be read from that terminal outcome, never
467
+ // assumed from the bare fact that the await resolved. The bridge is the
468
+ // authority because it emitted the matching terminal event; the run's own
469
+ // result/status is the fallback when the stream was not observed.
470
+ const terminal = bridge.terminalStatus ??
471
+ mastraRunTerminalStatus(resolvedRunOutput) ??
472
+ mastraRunTerminalStatus(stream.status);
473
+ if (terminal)
474
+ status = terminal;
203
475
  }
204
476
  catch (error) {
205
477
  status = constants_js_1.GraphExecutionStatus.FAILED;
@@ -209,9 +481,105 @@ class MastraGraphExecutionBackend {
209
481
  error: this.errorPayload(error),
210
482
  });
211
483
  }
484
+ // SAA-836 O1: persist a versioned replay snapshot of the terminal
485
+ // outcome (replays layer) before the frame closes. Never fails the run.
486
+ await this.recordReplaySnapshot({
487
+ runId,
488
+ workflowId: request.document.id,
489
+ documentFingerprint: compiled.fingerprint,
490
+ status,
491
+ resolvedRunOutput,
492
+ });
212
493
  frame.finish();
213
494
  return (0, GraphExecutionResult_js_1.buildGraphExecutionResult)(frame, request.document, request.inputs, status, { backend: types_js_1.MASTRA_BACKEND_FLAVOUR, documentFingerprint: compiled.fingerprint });
214
495
  }
496
+ /**
497
+ * Bounds the translated run's terminal wait by the backend's run-level
498
+ * `terminalTimeoutMs` and the caller's cancellation signal, mirroring the
499
+ * Dagster observation bound. Exceeding the timeout fails closed with
500
+ * {@link GRAPH_MASTRA_EXECUTE_TIMEOUT}; an abort fails closed with
501
+ * {@link GRAPH_MASTRA_EXECUTE_ABORTED}. The underlying run is not force-killed
502
+ * (Mastra owns run lifecycle), but the backend stops awaiting it so the run
503
+ * slot and event bridge are released and the run cannot pin the process.
504
+ *
505
+ * @param execution - The in-flight run/stream/result promise.
506
+ * @param signal - The caller's cancellation signal, when supplied.
507
+ * @param workflowId - The workflow id the run belongs to (for error details).
508
+ * @returns Resolves once the run terminates normally.
509
+ * @throws {GraphExecutionError} on timeout or abort.
510
+ */
511
+ async awaitTerminal(execution, signal, workflowId) {
512
+ const timeoutMs = this.terminalTimeoutMs;
513
+ await new Promise((resolve, reject) => {
514
+ let settled = false;
515
+ let timer;
516
+ const cleanup = () => {
517
+ if (timer)
518
+ clearTimeout(timer);
519
+ signal?.removeEventListener("abort", onAbort);
520
+ };
521
+ const finish = (settle) => {
522
+ if (settled)
523
+ return;
524
+ settled = true;
525
+ cleanup();
526
+ settle();
527
+ };
528
+ const onAbort = () => finish(() => reject(new GraphExecutionError_js_1.GraphExecutionError(`Mastra run for workflow '${workflowId}' was aborted`, types_js_1.GRAPH_MASTRA_EXECUTE_ABORTED, { workflowId })));
529
+ if (signal?.aborted) {
530
+ onAbort();
531
+ return;
532
+ }
533
+ if (signal)
534
+ signal.addEventListener("abort", onAbort, { once: true });
535
+ if (timeoutMs > 0) {
536
+ timer = setTimeout(() => finish(() => reject(new GraphExecutionError_js_1.GraphExecutionError(`Mastra run for workflow '${workflowId}' did not terminate within ${timeoutMs}ms`, types_js_1.GRAPH_MASTRA_EXECUTE_TIMEOUT, { workflowId, terminalTimeoutMs: timeoutMs }))), timeoutMs);
537
+ }
538
+ execution.then(() => finish(resolve), (error) => finish(() => reject(error)));
539
+ });
540
+ }
541
+ /**
542
+ * Binds a compiled workflow to the wired mastra runtime so its runs execute
543
+ * under the runtime's own observability context (SAA-836 O1). The compiler
544
+ * caches by document id and fingerprint, so a recompiled document either
545
+ * matches the registered instance (no-op) or replaces it (`removeWorkflow`
546
+ * + `addWorkflow`) before the run starts. Runtimes without the mastra
547
+ * workflow-registration surface (duck-typed test doubles) return the
548
+ * unbound compiled workflow, keeping the direct run path.
549
+ *
550
+ * @param compiled - The compilation to bind.
551
+ * @returns The workflow to run: the runtime-bound compiled workflow when
552
+ * the runtime is mastra-native, else the unbound compiled workflow.
553
+ */
554
+ bindCompiledWorkflow(compiled) {
555
+ const workflow = compiled.workflow;
556
+ const runtime = this.runtime;
557
+ if (!isRecord(runtime))
558
+ return workflow;
559
+ const addWorkflow = runtime["addWorkflow"];
560
+ const getWorkflow = runtime["getWorkflow"];
561
+ if (typeof addWorkflow !== "function" || typeof getWorkflow !== "function") {
562
+ return workflow;
563
+ }
564
+ const existing = (() => {
565
+ // A real mastra runtime throws `MASTRA_GET_WORKFLOW_BY_ID_NOT_FOUND`
566
+ // for an unregistered id; treat that as "not registered".
567
+ try {
568
+ return getWorkflow.call(runtime, compiled.workflowId);
569
+ }
570
+ catch {
571
+ return undefined;
572
+ }
573
+ })();
574
+ if (existing !== workflow) {
575
+ const removeWorkflow = runtime["removeWorkflow"];
576
+ if (typeof removeWorkflow === "function" && existing !== undefined) {
577
+ removeWorkflow.call(runtime, compiled.workflowId);
578
+ }
579
+ addWorkflow.call(runtime, workflow, compiled.workflowId);
580
+ }
581
+ return workflow;
582
+ }
215
583
  /**
216
584
  * Resumes a suspended Mastra run after enforcing the SAA-193 resume guard
217
585
  * (C13/C15/C16/C17/C18). The Mastra run snapshot is authoritative for the
@@ -308,8 +676,108 @@ class MastraGraphExecutionBackend {
308
676
  this.runWorkflows.clear();
309
677
  this.runtime = undefined;
310
678
  this.managementManager = undefined;
679
+ if (this.observability) {
680
+ await this.observability.flush();
681
+ await this.observability.shutdown();
682
+ this.observability = undefined;
683
+ }
684
+ if (this.persistenceInstance && this.persistenceOwned) {
685
+ await this.persistenceInstance.shutdown();
686
+ }
687
+ this.persistenceInstance = undefined;
688
+ this.persistenceOwned = false;
689
+ this.persistenceBroken = false;
690
+ this.terminalTimeoutMs = MastraEnvironment_js_1.MastraEnvironment.mastra.engine.terminalTimeoutMs;
311
691
  this.initialized = false;
312
692
  }
693
+ /**
694
+ * The routed per-layer persistence surface (SAA-836 O1), when it resolved.
695
+ * The host-supplied surface ({@link MastraBackendConfig.persistence}) takes
696
+ * precedence; otherwise the Environment-routed surface
697
+ * (`MASTRA__PERSISTENCE__*`: replays → `fs`, cache → `ram`, pins → `fs`)
698
+ * is created lazily on first use so hosts that never record pay nothing.
699
+ * Undefined after a routing failure: persistence recording is auxiliary
700
+ * (fail-open), while a restore of a missing snapshot still fails closed
701
+ * inside the repository (R7).
702
+ */
703
+ get persistence() {
704
+ return this.persistenceInstance;
705
+ }
706
+ /** Resolves the persistence surface, memoized and fail-open on routing failure. */
707
+ async persistenceFor() {
708
+ if (this.persistenceBroken)
709
+ return undefined;
710
+ if (this.persistenceInstance)
711
+ return this.persistenceInstance;
712
+ const hostPersistence = this._config?.persistence;
713
+ if (hostPersistence) {
714
+ this.persistenceInstance = hostPersistence;
715
+ this.persistenceOwned = false;
716
+ return this.persistenceInstance;
717
+ }
718
+ try {
719
+ this.persistenceInstance = await (0, MastraPersistence_js_1.createMastraPersistence)();
720
+ this.persistenceOwned = true;
721
+ return this.persistenceInstance;
722
+ }
723
+ catch (error) {
724
+ this.persistenceBroken = true;
725
+ this.logger
726
+ ?.for({ scope: "persistence" })
727
+ .warn(`[mastra-persistence] routing failed; recording disabled: ${String(error)}`);
728
+ return undefined;
729
+ }
730
+ }
731
+ /**
732
+ * Records the compiled-workflow cache ledger entry for a document (cache
733
+ * layer, `ram` by default) and invalidates stale entries compiled from a
734
+ * different fingerprint — the atomic cache invalidation on document change
735
+ * (gate A: recompilation only when the document changes, never per run).
736
+ * Ledger failures never fail the run (fail-open recording).
737
+ */
738
+ async recordCacheLedger(compiled, workflowId) {
739
+ const persistence = await this.persistenceFor();
740
+ if (!persistence)
741
+ return;
742
+ try {
743
+ await persistence.cache.record(workflowId, compiled.fingerprint);
744
+ await persistence.cache.invalidate(workflowId, compiled.fingerprint);
745
+ }
746
+ catch (error) {
747
+ this.logger
748
+ ?.for({ scope: "persistence", layer: "cache" })
749
+ .warn(`[mastra-persistence] cache ledger recording failed: ${String(error)}`);
750
+ }
751
+ }
752
+ /**
753
+ * Records a versioned replay snapshot of a run's terminal outcome (replays
754
+ * layer, `fs` by default): a JSON-safe projection of the resolved run
755
+ * output, status and fingerprint — restorable through
756
+ * `persistence.replays.restore(runId, version?)`. Recording failures never
757
+ * fail the run (fail-open recording).
758
+ */
759
+ async recordReplaySnapshot(params) {
760
+ const persistence = await this.persistenceFor();
761
+ if (!persistence)
762
+ return;
763
+ try {
764
+ await persistence.replays.record({
765
+ runId: params.runId,
766
+ workflowId: params.workflowId,
767
+ documentFingerprint: params.documentFingerprint,
768
+ status: params.status,
769
+ payload: {
770
+ status: params.status,
771
+ output: (0, MastraPersistence_js_1.jsonSafeProjection)(params.resolvedRunOutput),
772
+ },
773
+ });
774
+ }
775
+ catch (error) {
776
+ this.logger
777
+ ?.for({ scope: "persistence", layer: "replays" })
778
+ .warn(`[mastra-persistence] replay recording failed: ${String(error)}`);
779
+ }
780
+ }
313
781
  /**
314
782
  * The configuration most recently resolved by {@link initialize}. Exposed so
315
783
  * `GraphExecutionEngine.initialize` can merge its facade-owned collaborators
@@ -323,24 +791,49 @@ class MastraGraphExecutionBackend {
323
791
  get ready() {
324
792
  return this.initialized;
325
793
  }
794
+ /**
795
+ * The storage-wiring status resolved by the last {@link initialize} when the
796
+ * host declared `MastraBackendConfig.storage` (SAA-926 §6.2); `undefined`
797
+ * when the host declared no storage config. The acceptance seam for the
798
+ * "storage configured and durable" check: `domains.workflows` must not be
799
+ * `in-memory`/`absent` on a production host.
800
+ */
801
+ get storageStatus() {
802
+ return this._storageStatus;
803
+ }
326
804
  async loadRun(runId) {
327
805
  const runtime = this.runtime;
328
806
  if (!isRecord(runtime))
329
807
  return undefined;
330
808
  const getRun = runtime["getRun"];
331
- if (typeof getRun !== "function")
332
- return undefined;
333
- const run = await getRun.call(runtime, runId);
334
- return isRecord(run) ? run : undefined;
809
+ if (typeof getRun === "function") {
810
+ const run = await getRun.call(runtime, runId);
811
+ return isRecord(run) ? run : undefined;
812
+ }
813
+ // SAA-926 §6.3: @mastra/core 1.77.0 exposes no public `getRun` on the
814
+ // `Mastra` class, so a plain runtime left resume failing closed. Recover
815
+ // the resumable run handle through mastra's own restart-recovery pattern:
816
+ // resolve the persisted run record from the configured storage workflows
817
+ // domain, then rebind the run id onto the live workflow via
818
+ // `createRun({ runId })`.
819
+ const recovered = await (0, MastraRunRecovery_js_1.recoverMastraRunHandle)(runtime, runId);
820
+ return isRecord(recovered) ? recovered : undefined;
335
821
  }
336
822
  errorPayload(error) {
337
823
  if (error instanceof Error) {
824
+ const graphCode = error.graphCode;
825
+ const code = error.code;
826
+ const normalised = typeof graphCode === "string"
827
+ ? graphCode
828
+ : typeof code === "number"
829
+ ? String(code)
830
+ : typeof code === "string"
831
+ ? code
832
+ : undefined;
338
833
  return {
339
834
  name: error.name,
340
835
  message: error.message,
341
- ...(typeof error.code === "string"
342
- ? { code: error.code }
343
- : {}),
836
+ ...(normalised !== undefined ? { code: normalised } : {}),
344
837
  };
345
838
  }
346
839
  return { name: "MastraError", message: String(error) };