@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
@@ -0,0 +1,920 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraRagStepHandlers
3
+ * @summary Real RAG execution for the mastra engine (SAA-747 Stage 2).
4
+ * @description Implements the RAG family as real `@mastra/core` workflow steps
5
+ * on top of the mastra-native vector/embedding/model bindings: the vector-store
6
+ * step creates its index and inserts embedded documents (or queries it when a
7
+ * query is supplied), the retriever embeds the query and reads the wired store,
8
+ * the three chains generate through a mastra agent, the structured-output
9
+ * parser/information extractor parse and validate model output, and the LangChain
10
+ * Code/Sandbox kinds run user code through a host sandbox runner with the same
11
+ * ceiling guard as the verified `CodeNode`.
12
+ *
13
+ * The nodes keep their config-only descriptor projection (R9) as the fallback:
14
+ * when a host has not supplied the corresponding execution surface (or the node
15
+ * carries no work), the step emits the JSON-safe `kind` descriptor exactly like
16
+ * the default handler set. Real execution is selected only when the document
17
+ * wires the inputs the kind needs, so an authored config-only node never makes a
18
+ * model or database call by accident.
19
+ *
20
+ * Embedding and text generation are carried as **config** on the node (R1):
21
+ * `embedding`/`modelAdapter` objects with `provider`/`modelId` (and an optional
22
+ * credential reference). The default paths use mastra's own
23
+ * `ModelRouterEmbeddingModel` and `Agent` bindings; a host may inject
24
+ * `embedText`/`generateText` ports (deterministic tests, custom providers)
25
+ * without changing the graph document. Every path fails closed with a typed
26
+ * error rather than fabricating vectors, answers, or code results.
27
+ */
28
+ import { Agent } from "@mastra/core/agent";
29
+ import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
30
+ import { createStep } from "@mastra/core/workflows";
31
+ import { z } from "zod";
32
+ import { GraphExecutionError } from "./../engine/errors/GraphExecutionError.js";
33
+ import { GRAPH_CODE_MAX_TIMEOUT_MS } from "./../engine/constants.js";
34
+ import { clampGraphCodeTimeoutMs } from "./../node/utility/code/node.js";
35
+ import { isGraphCredentialReference, } from "./../shared/graph/catalog/GraphCredentialReference.js";
36
+ import { graphModelAdapterOf, } from "./MastraAgentModelAdapter.js";
37
+ import { mastraVectorStoreConfigOf, resolveMastraVectorStore, } from "./MastraVectorStore.js";
38
+ import { GRAPH_MASTRA_EMBEDDING_UNAVAILABLE, GRAPH_MASTRA_RAG_UNAVAILABLE, GRAPH_MASTRA_SANDBOX_TIMEOUT, GRAPH_MASTRA_SANDBOX_UNAVAILABLE, GRAPH_MASTRA_VECTOR_PROVIDER_UNKNOWN, } from "./types.js";
39
+ /** The RAG node kinds this handler set executes. */
40
+ export const MASTRA_RAG_EXECUTION_KINDS = [
41
+ "core.agent.embedding",
42
+ "core.agent.vectorStore",
43
+ "core.agent.retriever",
44
+ "core.agent.chain.qa",
45
+ "core.agent.chain.basic",
46
+ "core.agent.chain.summarization",
47
+ "core.agent.structuredOutputParser",
48
+ "core.agent.informationExtractor",
49
+ ];
50
+ /** The sandbox/code kinds this handler set executes. */
51
+ export const MASTRA_SANDBOX_EXECUTION_KINDS = [
52
+ "core.agent.sandbox",
53
+ "core.agent.langchainCode",
54
+ ];
55
+ /** Default number of documents a vector-store query returns. */
56
+ const DEFAULT_TOP_K = 4;
57
+ /** Default number of texts embedded per embedding request. */
58
+ const DEFAULT_BATCH_SIZE = 64;
59
+ /**
60
+ * Type guard accepting plain, non-array objects only.
61
+ *
62
+ * @param value - The value to test.
63
+ * @returns {boolean} `true` when `value` is a plain object.
64
+ */
65
+ function isRecord(value) {
66
+ return !!value && typeof value === "object" && !Array.isArray(value);
67
+ }
68
+ /** Coerces an unknown value to a record, returning `{}` for anything else. */
69
+ function asRecord(value) {
70
+ return isRecord(value) ? value : {};
71
+ }
72
+ /** Returns the value when it is a non-blank string, else `undefined`. */
73
+ function nonEmptyString(value) {
74
+ return typeof value === "string" && value.trim().length > 0
75
+ ? value
76
+ : undefined;
77
+ }
78
+ /** Returns the value floored when it is a positive finite integer, else `undefined`. */
79
+ function positiveInteger(value) {
80
+ return typeof value === "number" && Number.isFinite(value) && value > 0
81
+ ? Math.floor(value)
82
+ : undefined;
83
+ }
84
+ /**
85
+ * Reads the embedding config a node carries (R1). Looks at the dedicated
86
+ * `embedding` parameter first, then a `modelAdapter` (the embedding node uses
87
+ * that handle), and finally root `provider`/`modelId` fields. Returns
88
+ * `undefined` when no usable provider/model pair is present, so a config-only
89
+ * node never triggers an embedding call.
90
+ *
91
+ * @param node - The canonical node instance.
92
+ * @returns The validated embedding config, or `undefined`.
93
+ */
94
+ export function mastraEmbeddingConfigOf(node) {
95
+ return mastraEmbeddingConfigOfRecord(node.parameters);
96
+ }
97
+ /**
98
+ * Reads an embedding config carried by a runtime input value (a data edge can
99
+ * feed the embedding model config into an insert/retrieval step). Returns
100
+ * `undefined` when the value is not a usable provider/model pair.
101
+ *
102
+ * @param value - The runtime input value.
103
+ * @returns The validated embedding config, or `undefined`.
104
+ */
105
+ function mastraEmbeddingConfigOfInput(value) {
106
+ return mastraEmbeddingConfigOfRecord(value);
107
+ }
108
+ /**
109
+ * Shared reader behind {@link mastraEmbeddingConfigOf} and
110
+ * {@link mastraEmbeddingConfigOfInput}. Probes the candidate handles in order
111
+ * and validates the first usable provider/model pair it finds.
112
+ *
113
+ * @param value - The record to read the embedding config from.
114
+ * @returns The validated embedding config, or `undefined`.
115
+ */
116
+ function mastraEmbeddingConfigOfRecord(value) {
117
+ const parameters = asRecord(value);
118
+ const candidates = [
119
+ parameters["embedding"],
120
+ parameters["modelAdapter"],
121
+ parameters,
122
+ ];
123
+ for (const candidate of candidates) {
124
+ if (!isRecord(candidate))
125
+ continue;
126
+ const provider = nonEmptyString(candidate["provider"]);
127
+ const modelId = nonEmptyString(candidate["modelId"]);
128
+ if (!provider || !modelId)
129
+ continue;
130
+ const config = { provider, modelId };
131
+ const credentialRef = candidate["credentialRef"];
132
+ if (credentialRef !== undefined) {
133
+ if (!isGraphCredentialReference(credentialRef))
134
+ continue;
135
+ config.credentialRef = credentialRef;
136
+ }
137
+ const dimension = positiveInteger(candidate["dimension"]);
138
+ if (dimension !== undefined)
139
+ config.dimension = dimension;
140
+ const batchSize = positiveInteger(candidate["batchSize"]);
141
+ if (batchSize !== undefined)
142
+ config.batchSize = batchSize;
143
+ return config;
144
+ }
145
+ return undefined;
146
+ }
147
+ /** The deterministic, secret-free document id used for a fallback descriptor. */
148
+ function descriptorFallback(node, inputData, extra = {}) {
149
+ return {
150
+ ...inputData,
151
+ ...extra,
152
+ resource: {
153
+ kind: node.kind,
154
+ nodeId: node.id,
155
+ parameters: asRecord(node.parameters),
156
+ ...(isRecord(extra["resource"]) ? extra["resource"] : {}),
157
+ },
158
+ };
159
+ }
160
+ /**
161
+ * Finds the node wired as the source of a data edge into `targetPort`. Used by
162
+ * the retriever to resolve the vector-store provider node it reads from.
163
+ *
164
+ * @param document - The document being compiled, when available.
165
+ * @param targetNodeId - The consuming node id.
166
+ * @param targetPort - The consumer input port.
167
+ * @returns The source node, or `undefined` when no data edge matches.
168
+ */
169
+ function sourceNodeOf(document, targetNodeId, targetPort) {
170
+ if (!document)
171
+ return undefined;
172
+ const byId = new Map((document.nodes ?? []).map((n) => [n.id, n]));
173
+ for (const edge of document.edges ?? []) {
174
+ if (edge.type !== "data")
175
+ continue;
176
+ if (edge.target.scope === "node" &&
177
+ edge.target.nodeId === targetNodeId &&
178
+ edge.target.port === targetPort &&
179
+ edge.source.scope === "node") {
180
+ return byId.get(edge.source.nodeId);
181
+ }
182
+ }
183
+ return undefined;
184
+ }
185
+ /**
186
+ * Normalizes a `documents` value (strings or `{ text, metadata }` objects) into
187
+ * the parallel text/metadata arrays a vector upsert needs. Entries without a
188
+ * usable text are skipped.
189
+ *
190
+ * @param documents - The raw documents input.
191
+ * @returns The normalized texts and metadata.
192
+ */
193
+ export function documentTextsOf(documents) {
194
+ const texts = [];
195
+ const metadata = [];
196
+ if (!Array.isArray(documents))
197
+ return { texts, metadata };
198
+ for (const entry of documents) {
199
+ let text;
200
+ let meta = {};
201
+ if (typeof entry === "string") {
202
+ text = entry;
203
+ }
204
+ else if (isRecord(entry)) {
205
+ text =
206
+ nonEmptyString(entry["text"]) ??
207
+ nonEmptyString(entry["content"]) ??
208
+ nonEmptyString(entry["pageContent"]);
209
+ meta = isRecord(entry["metadata"]) ? { ...entry["metadata"] } : {};
210
+ }
211
+ if (!text)
212
+ continue;
213
+ texts.push(text);
214
+ metadata.push({ ...meta, text });
215
+ }
216
+ return { texts, metadata };
217
+ }
218
+ /** Extracts the text from a query/prompt input, accepting strings or records. */
219
+ function textOf(value) {
220
+ if (typeof value === "string")
221
+ return value;
222
+ if (isRecord(value)) {
223
+ return (nonEmptyString(value["query"]) ??
224
+ nonEmptyString(value["text"]) ??
225
+ nonEmptyString(value["input"]));
226
+ }
227
+ return undefined;
228
+ }
229
+ /** Interpolates `{{ input }}`/`{{ query }}`/`{{ context }}` in a template. */
230
+ function interpolate(template, values) {
231
+ return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (match, key) => key in values ? String(values[key] ?? "") : match);
232
+ }
233
+ /**
234
+ * The default mastra-native embedding path. Builds a
235
+ * `ModelRouterEmbeddingModel` from `provider/modelId`, embeds the batch, and
236
+ * fails closed with {@link GRAPH_MASTRA_EMBEDDING_UNAVAILABLE} when the model
237
+ * returns no embeddings.
238
+ *
239
+ * @param {object} request - The embedding request.
240
+ * @param {string[]} request.values - The texts to embed.
241
+ * @param {MastraEmbeddingConfig} request.config - The node's embedding config.
242
+ * @param {GraphNodeInstance} request.node - The canonical node instance.
243
+ * @returns {Promise.<number[][]>} One vector per input text, in order.
244
+ */
245
+ async function defaultEmbed(request) {
246
+ const { config, values } = request;
247
+ if (!values.length)
248
+ return [];
249
+ try {
250
+ const model = new ModelRouterEmbeddingModel(`${config.provider}/${config.modelId}`);
251
+ const result = (await model.doEmbed({ values }));
252
+ if (!Array.isArray(result?.embeddings)) {
253
+ throw new Error("embedding model returned no embeddings");
254
+ }
255
+ return result.embeddings;
256
+ }
257
+ catch (error) {
258
+ throw new GraphExecutionError(`Embedding model '${config.provider}/${config.modelId}' failed for node '${request.node.id}': ${String(error)}`, GRAPH_MASTRA_EMBEDDING_UNAVAILABLE, {
259
+ nodeId: request.node.id,
260
+ provider: config.provider,
261
+ modelId: config.modelId,
262
+ });
263
+ }
264
+ }
265
+ /** The default mastra-native generation path. */
266
+ async function defaultGenerate(request) {
267
+ const adapter = request.modelAdapter;
268
+ if (!adapter) {
269
+ throw new GraphExecutionError(`Chain node '${request.node.id}' has no modelAdapter config, so no mastra agent can be built`, GRAPH_MASTRA_RAG_UNAVAILABLE, { nodeId: request.node.id });
270
+ }
271
+ try {
272
+ const AgentCtor = Agent;
273
+ const agent = new AgentCtor({
274
+ name: `graph-${request.node.id}`,
275
+ instructions: request.instructions ?? "",
276
+ model: `${adapter.provider}/${adapter.modelId}`,
277
+ });
278
+ const result = await agent.generate(request.prompt, request.abortSignal ? { abortSignal: request.abortSignal } : undefined);
279
+ const text = typeof result?.text === "string"
280
+ ? result.text
281
+ : typeof result?.response === "string"
282
+ ? result.response
283
+ : "";
284
+ return result?.object !== undefined
285
+ ? { text, object: result.object }
286
+ : { text };
287
+ }
288
+ catch (error) {
289
+ throw new GraphExecutionError(`Chain node '${request.node.id}' generation failed on '${adapter.provider}/${adapter.modelId}': ${String(error)}`, GRAPH_MASTRA_RAG_UNAVAILABLE, { nodeId: request.node.id });
290
+ }
291
+ }
292
+ /** Parses JSON text, returning `undefined` for invalid/empty input. */
293
+ function parseJsonObject(text) {
294
+ if (typeof text !== "string" || text.trim().length === 0)
295
+ return undefined;
296
+ const trimmed = text.trim();
297
+ const withoutFence = trimmed
298
+ .replace(/^```(?:json)?\s*/i, "")
299
+ .replace(/\s*```$/i, "");
300
+ try {
301
+ return JSON.parse(withoutFence);
302
+ }
303
+ catch {
304
+ return undefined;
305
+ }
306
+ }
307
+ /** Runs a promise with a hard timeout, clearing the timer on settle. */
308
+ async function withTimeout(work, timeoutMs, nodeId) {
309
+ let timer;
310
+ const timeout = new Promise((_, reject) => {
311
+ timer = setTimeout(() => {
312
+ reject(new GraphExecutionError(`Sandboxed code on node '${nodeId}' exceeded its ${timeoutMs}ms ceiling`, GRAPH_MASTRA_SANDBOX_TIMEOUT, { nodeId, timeoutMs }));
313
+ }, timeoutMs);
314
+ });
315
+ try {
316
+ return await Promise.race([work, timeout]);
317
+ }
318
+ finally {
319
+ if (timer)
320
+ clearTimeout(timer);
321
+ }
322
+ }
323
+ /** The effective index name for a vector-store config. */
324
+ function indexNameOf(config, fallback) {
325
+ return (config?.indexName ??
326
+ nonEmptyString(fallback) ??
327
+ config?.id ??
328
+ "default");
329
+ }
330
+ /**
331
+ * Builds the real RAG/sandbox step handler set. Handlers are registered by the
332
+ * backend after the host default set, so they override the config-only
333
+ * pass-through for the kinds they implement while leaving the fallback output
334
+ * identical when no real execution applies.
335
+ *
336
+ * @param options - Host ports (embeddings, generation, sandbox) and bindings.
337
+ * @returns One {@link MastraNodeStepHandler} per executed kind.
338
+ */
339
+ export function createMastraRagStepHandlers(options = {}) {
340
+ const storeCache = options.storeCache ?? new Map();
341
+ const embedder = options.embedText ?? defaultEmbed;
342
+ const generator = options.generateText ?? defaultGenerate;
343
+ const resolveStore = async (config) => {
344
+ const resolved = options.resolveVectorStore
345
+ ? await options.resolveVectorStore(config)
346
+ : resolveMastraVectorStore(config, {
347
+ ...(options.vectorStoreBindings
348
+ ? { bindings: options.vectorStoreBindings }
349
+ : {}),
350
+ ...(options.vectorStoreDrivers
351
+ ? { drivers: options.vectorStoreDrivers }
352
+ : {}),
353
+ });
354
+ const key = `${resolved.descriptor.provider}:${resolved.descriptor.id}:${resolved.descriptor.indexName ?? ""}`;
355
+ const cached = storeCache.get(key);
356
+ if (cached)
357
+ return { store: cached, descriptor: resolved.descriptor };
358
+ storeCache.set(key, resolved.store);
359
+ return resolved;
360
+ };
361
+ const liveStoreOf = async (descriptor) => {
362
+ const key = `${descriptor.provider}:${descriptor.id}:${descriptor.indexName ?? ""}`;
363
+ const cached = storeCache.get(key);
364
+ if (cached)
365
+ return cached;
366
+ const { store } = await resolveStore({
367
+ provider: descriptor.provider,
368
+ ...(descriptor.id ? { id: descriptor.id } : {}),
369
+ ...(descriptor.indexName ? { indexName: descriptor.indexName } : {}),
370
+ ...(descriptor.dimension !== undefined
371
+ ? { dimension: descriptor.dimension }
372
+ : {}),
373
+ ...(descriptor.metric ? { metric: descriptor.metric } : {}),
374
+ ...(descriptor.credentialRef
375
+ ? { credentialRef: descriptor.credentialRef }
376
+ : {}),
377
+ });
378
+ storeCache.set(key, store);
379
+ return store;
380
+ };
381
+ const ensureIndex = async (store, indexName, dimension, metric) => {
382
+ const indexes = await store.listIndexes();
383
+ if (indexes.includes(indexName))
384
+ return;
385
+ await store.createIndex({
386
+ indexName,
387
+ dimension,
388
+ ...(metric ? { metric } : {}),
389
+ });
390
+ };
391
+ const embedValues = async (node, values, config) => {
392
+ const batchSize = config.batchSize ?? DEFAULT_BATCH_SIZE;
393
+ const vectors = [];
394
+ for (let start = 0; start < values.length; start += batchSize) {
395
+ const batch = values.slice(start, start + batchSize);
396
+ const embedded = await embedder({ values: batch, config, node });
397
+ if (!Array.isArray(embedded) ||
398
+ embedded.length !== batch.length ||
399
+ embedded.some((vector) => !Array.isArray(vector) ||
400
+ vector.some((value) => typeof value !== "number"))) {
401
+ throw new GraphExecutionError(`Embedding port returned an invalid vector batch for node '${node.id}'`, GRAPH_MASTRA_EMBEDDING_UNAVAILABLE, { nodeId: node.id, expected: batch.length });
402
+ }
403
+ vectors.push(...embedded);
404
+ }
405
+ return vectors;
406
+ };
407
+ const handlers = [];
408
+ const handler = (kind, execute) => {
409
+ handlers.push({
410
+ kind,
411
+ createStep: (node, stepOptions) => createStep({
412
+ id: stepOptions.stepId,
413
+ inputSchema: z.any(),
414
+ outputSchema: z.any(),
415
+ execute: async (args) => {
416
+ const inputData = asRecord(args.inputData);
417
+ return execute(node, inputData, stepOptions.document, args.abortSignal);
418
+ },
419
+ }),
420
+ });
421
+ };
422
+ // --- embedding ---------------------------------------------------------
423
+ handler("core.agent.embedding", async (node, inputData) => {
424
+ const config = mastraEmbeddingConfigOf(node) ?? options.embedding;
425
+ const input = inputData["values"] ?? inputData["input"] ?? inputData["text"];
426
+ const values = Array.isArray(input)
427
+ ? input.filter((entry) => typeof entry === "string")
428
+ : typeof input === "string"
429
+ ? [input]
430
+ : [];
431
+ if (!config || values.length === 0) {
432
+ return descriptorFallback(node, inputData, {
433
+ resource: {
434
+ type: "mastra.embedding",
435
+ provider: config?.provider,
436
+ modelId: config?.modelId,
437
+ dimension: config?.dimension,
438
+ batchSize: config?.batchSize,
439
+ },
440
+ });
441
+ }
442
+ const vectors = await embedValues(node, values, config);
443
+ return {
444
+ ...inputData,
445
+ vectors,
446
+ resource: {
447
+ kind: node.kind,
448
+ nodeId: node.id,
449
+ type: "mastra.embedding",
450
+ provider: config.provider,
451
+ modelId: config.modelId,
452
+ dimension: config.dimension ?? vectors[0]?.length,
453
+ batchSize: config.batchSize,
454
+ },
455
+ };
456
+ });
457
+ // --- vector store ------------------------------------------------------
458
+ handler("core.agent.vectorStore", async (node, inputData) => {
459
+ const parameters = asRecord(node.parameters);
460
+ const rawConfig = mastraVectorStoreConfigOf(node);
461
+ if (!rawConfig) {
462
+ const nested = parameters["vectorStore"];
463
+ const declared = isRecord(nested)
464
+ ? nested["provider"] ?? parameters["provider"]
465
+ : parameters["provider"];
466
+ if (nested !== undefined || declared !== undefined) {
467
+ throw new GraphExecutionError(`Vector-store node '${node.id}' declares an unknown or malformed vector-store config`, GRAPH_MASTRA_VECTOR_PROVIDER_UNKNOWN, {
468
+ nodeId: node.id,
469
+ provider: declared === undefined ? undefined : String(declared),
470
+ });
471
+ }
472
+ }
473
+ const raw = rawConfig ?? { provider: "memory" };
474
+ const embedding = mastraEmbeddingConfigOfInput(raw.embedding) ??
475
+ mastraEmbeddingConfigOf(node) ??
476
+ mastraEmbeddingConfigOfInput(inputData["embedding"]) ??
477
+ mastraEmbeddingConfigOfInput(inputData["modelAdapter"]) ??
478
+ options.embedding;
479
+ const indexName = indexNameOf(raw, parameters["indexName"]);
480
+ const documents = inputData["documents"] ?? parameters["documents"];
481
+ const { texts, metadata } = documentTextsOf(documents);
482
+ const queryText = textOf(inputData["query"] ?? parameters["query"]);
483
+ const queryVector = Array.isArray(inputData["queryVector"])
484
+ ? inputData["queryVector"]
485
+ : Array.isArray(parameters["queryVector"])
486
+ ? parameters["queryVector"]
487
+ : undefined;
488
+ const descriptorBase = {
489
+ kind: node.kind,
490
+ nodeId: node.id,
491
+ type: "mastra.vectorStore",
492
+ provider: raw.provider,
493
+ id: raw.id ?? raw.indexName ?? raw.provider,
494
+ indexName,
495
+ ...(raw.dimension !== undefined ? { dimension: raw.dimension } : {}),
496
+ ...(raw.metric !== undefined ? { metric: raw.metric } : {}),
497
+ ...(raw.credentialRef ? { credentialRef: raw.credentialRef } : {}),
498
+ ...(embedding
499
+ ? {
500
+ embedding: {
501
+ provider: embedding.provider,
502
+ modelId: embedding.modelId,
503
+ ...(embedding.dimension !== undefined
504
+ ? { dimension: embedding.dimension }
505
+ : {}),
506
+ ...(embedding.batchSize !== undefined
507
+ ? { batchSize: embedding.batchSize }
508
+ : {}),
509
+ },
510
+ }
511
+ : {}),
512
+ };
513
+ const wantsInsert = texts.length > 0;
514
+ const wantsQuery = queryText !== undefined || queryVector !== undefined;
515
+ if (!wantsInsert && !wantsQuery) {
516
+ return {
517
+ ...inputData,
518
+ resource: descriptorBase,
519
+ inserted: Array.isArray(inputData["ids"]) ? inputData["ids"] : [],
520
+ documents: Array.isArray(documents) ? documents : [],
521
+ };
522
+ }
523
+ const resolved = await resolveStore(raw);
524
+ const store = resolved.store;
525
+ if (wantsInsert) {
526
+ if (!embedding) {
527
+ throw new GraphExecutionError(`Vector-store node '${node.id}' has documents to insert but no embedding config`, GRAPH_MASTRA_EMBEDDING_UNAVAILABLE, { nodeId: node.id });
528
+ }
529
+ const vectors = await embedValues(node, texts, embedding);
530
+ const dimension = raw.dimension ?? vectors[0]?.length;
531
+ if (!dimension) {
532
+ throw new GraphExecutionError(`Vector-store node '${node.id}' could not resolve the index dimension`, GRAPH_MASTRA_RAG_UNAVAILABLE, { nodeId: node.id });
533
+ }
534
+ await ensureIndex(store, indexName, dimension, raw.metric);
535
+ const ids = Array.isArray(inputData["ids"])
536
+ ? inputData["ids"].map((id) => String(id))
537
+ : texts.map((_, index) => `${node.id}-${index}`);
538
+ const inserted = await store.upsert({
539
+ indexName,
540
+ vectors,
541
+ ids,
542
+ metadata,
543
+ });
544
+ return {
545
+ ...inputData,
546
+ resource: { ...descriptorBase, dimension },
547
+ inserted,
548
+ documents: Array.isArray(documents) ? documents : [],
549
+ };
550
+ }
551
+ const queryEmbedding = queryVector ??
552
+ (await embedValues(node, [queryText], embedding))[0];
553
+ const results = await store.query({
554
+ indexName,
555
+ queryVector: queryEmbedding,
556
+ topK: positiveInteger(inputData["topK"] ?? parameters["topK"]) ?? DEFAULT_TOP_K,
557
+ ...(isRecord(inputData["filter"] ?? parameters["filter"])
558
+ ? {
559
+ filter: (inputData["filter"] ??
560
+ parameters["filter"]),
561
+ }
562
+ : {}),
563
+ });
564
+ return {
565
+ ...inputData,
566
+ resource: descriptorBase,
567
+ documents: results.map((result) => ({
568
+ id: result.id,
569
+ score: result.score,
570
+ text: nonEmptyString(result.metadata?.["text"]) ??
571
+ result.document ??
572
+ "",
573
+ metadata: result.metadata ?? {},
574
+ })),
575
+ };
576
+ });
577
+ // --- retriever ---------------------------------------------------------
578
+ handler("core.agent.retriever", async (node, inputData, document) => {
579
+ const parameters = asRecord(node.parameters);
580
+ const source = sourceNodeOf(document, node.id, "store");
581
+ const sourceConfig = source ? mastraVectorStoreConfigOf(source) : undefined;
582
+ const embedding = (source ? mastraEmbeddingConfigOf(source) : undefined) ??
583
+ mastraEmbeddingConfigOf(node) ??
584
+ mastraEmbeddingConfigOfInput(inputData["embedding"]) ??
585
+ mastraEmbeddingConfigOfInput(inputData["modelAdapter"]) ??
586
+ options.embedding;
587
+ const descriptor = isRecord(inputData["store"])
588
+ ? inputData["store"]
589
+ : undefined;
590
+ const indexName = indexNameOf(sourceConfig, nonEmptyString(parameters["indexName"]) ?? descriptor?.indexName);
591
+ const queryText = textOf(inputData["query"] ?? parameters["query"]);
592
+ const queryVector = Array.isArray(inputData["queryVector"])
593
+ ? inputData["queryVector"]
594
+ : undefined;
595
+ if ((!sourceConfig && !descriptor) ||
596
+ (queryText === undefined && queryVector === undefined)) {
597
+ return descriptorFallback(node, inputData, {
598
+ documents: Array.isArray(inputData["documents"])
599
+ ? inputData["documents"]
600
+ : [],
601
+ resource: {
602
+ type: "mastra.retriever",
603
+ topK: positiveInteger(parameters["topK"]),
604
+ indexName,
605
+ store: inputData["store"],
606
+ },
607
+ });
608
+ }
609
+ const store = sourceConfig
610
+ ? (await resolveStore(sourceConfig)).store
611
+ : await liveStoreOf(descriptor);
612
+ if (queryText !== undefined && queryVector === undefined && !embedding) {
613
+ throw new GraphExecutionError(`Retriever node '${node.id}' has a text query but no embedding config on the wired vector store`, GRAPH_MASTRA_EMBEDDING_UNAVAILABLE, { nodeId: node.id });
614
+ }
615
+ const vector = queryVector ??
616
+ (await embedValues(node, [queryText], embedding))[0];
617
+ const results = await store.query({
618
+ indexName,
619
+ queryVector: vector,
620
+ topK: positiveInteger(parameters["topK"]) ?? DEFAULT_TOP_K,
621
+ ...(isRecord(parameters["filter"])
622
+ ? { filter: parameters["filter"] }
623
+ : {}),
624
+ });
625
+ const documents = results.map((result) => ({
626
+ id: result.id,
627
+ score: result.score,
628
+ text: nonEmptyString(result.metadata?.["text"]) ??
629
+ result.document ??
630
+ "",
631
+ metadata: result.metadata ?? {},
632
+ }));
633
+ return {
634
+ ...inputData,
635
+ documents,
636
+ resource: {
637
+ kind: node.kind,
638
+ nodeId: node.id,
639
+ type: "mastra.retriever",
640
+ topK: positiveInteger(parameters["topK"]) ?? DEFAULT_TOP_K,
641
+ indexName,
642
+ store: descriptor ??
643
+ (sourceConfig
644
+ ? {
645
+ type: "mastra.vectorStore",
646
+ provider: sourceConfig.provider,
647
+ id: sourceConfig.id ??
648
+ sourceConfig.indexName ??
649
+ sourceConfig.provider,
650
+ indexName,
651
+ }
652
+ : undefined),
653
+ embedding: embedding
654
+ ? { provider: embedding.provider, modelId: embedding.modelId }
655
+ : undefined,
656
+ },
657
+ };
658
+ });
659
+ // --- chains ------------------------------------------------------------
660
+ handler("core.agent.chain.basic", async (node, inputData, _document, signal) => {
661
+ const parameters = asRecord(node.parameters);
662
+ const adapter = graphModelAdapterOf(node);
663
+ const input = textOf(inputData["input"] ?? inputData["text"] ?? parameters["input"]) ??
664
+ "";
665
+ const template = nonEmptyString(parameters["promptTemplate"]);
666
+ const prompt = template ? interpolate(template, { input }) : input;
667
+ if (!adapter || prompt.length === 0) {
668
+ return descriptorFallback(node, inputData, {
669
+ text: typeof inputData["text"] === "string" ? inputData["text"] : "",
670
+ resource: {
671
+ type: "mastra.chain.basic",
672
+ provider: adapter?.provider,
673
+ modelId: adapter?.modelId,
674
+ promptTemplate: parameters["promptTemplate"],
675
+ },
676
+ });
677
+ }
678
+ const result = await generator({
679
+ node,
680
+ modelAdapter: adapter,
681
+ prompt,
682
+ ...(signal ? { abortSignal: signal } : {}),
683
+ });
684
+ return {
685
+ ...inputData,
686
+ text: result.text,
687
+ resource: {
688
+ kind: node.kind,
689
+ nodeId: node.id,
690
+ type: "mastra.chain.basic",
691
+ provider: adapter.provider,
692
+ modelId: adapter.modelId,
693
+ promptTemplate: parameters["promptTemplate"],
694
+ },
695
+ };
696
+ });
697
+ handler("core.agent.chain.qa", async (node, inputData, _document, signal) => {
698
+ const parameters = asRecord(node.parameters);
699
+ const adapter = graphModelAdapterOf(node);
700
+ const question = textOf(inputData["query"] ?? inputData["input"] ?? parameters["query"]) ??
701
+ "";
702
+ const contextValue = inputData["context"] ?? inputData["documents"];
703
+ const contextDocuments = Array.isArray(contextValue)
704
+ ? contextValue
705
+ : contextValue !== undefined
706
+ ? [contextValue]
707
+ : [];
708
+ const contextText = contextDocuments
709
+ .map((entry) => {
710
+ if (typeof entry === "string")
711
+ return entry;
712
+ if (isRecord(entry))
713
+ return textOf(entry) ?? "";
714
+ return "";
715
+ })
716
+ .filter((entry) => entry.length > 0)
717
+ .join("\n\n");
718
+ const template = nonEmptyString(parameters["promptTemplate"]);
719
+ const prompt = template
720
+ ? interpolate(template, { query: question, context: contextText })
721
+ : `Use the context below to answer the question.\n\nContext:\n${contextText}\n\nQuestion: ${question}\n\nAnswer:`;
722
+ if (!adapter || question.length === 0) {
723
+ return descriptorFallback(node, inputData, {
724
+ text: typeof inputData["text"] === "string" ? inputData["text"] : "",
725
+ sourceDocuments: parameters["returnSourceDocuments"]
726
+ ? contextDocuments
727
+ : [],
728
+ resource: {
729
+ type: "mastra.chain.qa",
730
+ provider: adapter?.provider,
731
+ modelId: adapter?.modelId,
732
+ returnSourceDocuments: parameters["returnSourceDocuments"] ?? false,
733
+ },
734
+ });
735
+ }
736
+ const result = await generator({
737
+ node,
738
+ modelAdapter: adapter,
739
+ prompt,
740
+ ...(signal ? { abortSignal: signal } : {}),
741
+ });
742
+ return {
743
+ ...inputData,
744
+ text: result.text,
745
+ sourceDocuments: parameters["returnSourceDocuments"]
746
+ ? contextDocuments
747
+ : [],
748
+ resource: {
749
+ kind: node.kind,
750
+ nodeId: node.id,
751
+ type: "mastra.chain.qa",
752
+ provider: adapter.provider,
753
+ modelId: adapter.modelId,
754
+ returnSourceDocuments: parameters["returnSourceDocuments"] ?? false,
755
+ },
756
+ };
757
+ });
758
+ handler("core.agent.chain.summarization", async (node, inputData, _document, signal) => {
759
+ const parameters = asRecord(node.parameters);
760
+ const adapter = graphModelAdapterOf(node);
761
+ const { texts } = documentTextsOf(inputData["documents"] ?? parameters["documents"]);
762
+ const instructions = nonEmptyString(parameters["instructions"]) ??
763
+ "Summarize the following documents concisely.";
764
+ if (!adapter || texts.length === 0) {
765
+ return descriptorFallback(node, inputData, {
766
+ text: typeof inputData["text"] === "string" ? inputData["text"] : "",
767
+ resource: {
768
+ type: "mastra.chain.summarization",
769
+ provider: adapter?.provider,
770
+ modelId: adapter?.modelId,
771
+ strategy: parameters["strategy"] ?? "stuff",
772
+ documentCount: texts.length,
773
+ },
774
+ });
775
+ }
776
+ const result = await generator({
777
+ node,
778
+ modelAdapter: adapter,
779
+ instructions,
780
+ prompt: texts.join("\n\n---\n\n"),
781
+ ...(signal ? { abortSignal: signal } : {}),
782
+ });
783
+ return {
784
+ ...inputData,
785
+ text: result.text,
786
+ resource: {
787
+ kind: node.kind,
788
+ nodeId: node.id,
789
+ type: "mastra.chain.summarization",
790
+ provider: adapter.provider,
791
+ modelId: adapter.modelId,
792
+ strategy: parameters["strategy"] ?? "stuff",
793
+ documentCount: texts.length,
794
+ },
795
+ };
796
+ });
797
+ // --- structured output / extractor ------------------------------------
798
+ handler("core.agent.structuredOutputParser", async (node, inputData) => {
799
+ const text = inputData["text"] ?? inputData["input"];
800
+ const object = parseJsonObject(text);
801
+ return {
802
+ ...inputData,
803
+ object: object ?? null,
804
+ resource: {
805
+ kind: node.kind,
806
+ nodeId: node.id,
807
+ type: "mastra.structuredOutputParser",
808
+ strict: asRecord(node.parameters)["strict"] ?? false,
809
+ hasSchema: asRecord(node.parameters)["structuredOutput"] !== undefined,
810
+ },
811
+ };
812
+ });
813
+ handler("core.agent.informationExtractor", async (node, inputData, _document, signal) => {
814
+ const parameters = asRecord(node.parameters);
815
+ const adapter = graphModelAdapterOf(node);
816
+ const text = textOf(inputData["text"] ?? parameters["text"]);
817
+ if (!adapter || !text) {
818
+ return descriptorFallback(node, inputData, {
819
+ data: inputData["data"] ?? null,
820
+ resource: {
821
+ type: "mastra.informationExtractor",
822
+ provider: adapter?.provider,
823
+ modelId: adapter?.modelId,
824
+ instructions: parameters["instructions"],
825
+ hasSchema: parameters["structuredOutput"] !== undefined,
826
+ },
827
+ });
828
+ }
829
+ const instructions = nonEmptyString(parameters["instructions"]) ??
830
+ "Extract the requested structured information from the text and answer with a single JSON object.";
831
+ const result = await generator({
832
+ node,
833
+ modelAdapter: adapter,
834
+ instructions,
835
+ prompt: text,
836
+ ...(signal ? { abortSignal: signal } : {}),
837
+ });
838
+ const data = result.object ?? parseJsonObject(result.text) ?? null;
839
+ return {
840
+ ...inputData,
841
+ data,
842
+ resource: {
843
+ kind: node.kind,
844
+ nodeId: node.id,
845
+ type: "mastra.informationExtractor",
846
+ provider: adapter.provider,
847
+ modelId: adapter.modelId,
848
+ instructions: parameters["instructions"],
849
+ hasSchema: parameters["structuredOutput"] !== undefined,
850
+ },
851
+ };
852
+ });
853
+ // --- sandbox / LangChain Code -----------------------------------------
854
+ const runCode = async (node, inputData, kind) => {
855
+ const parameters = asRecord(node.parameters);
856
+ const code = nonEmptyString(parameters["code"]);
857
+ const timeoutMs = clampGraphCodeTimeoutMs(parameters["timeoutMs"], GRAPH_CODE_MAX_TIMEOUT_MS);
858
+ if (!code) {
859
+ return descriptorFallback(node, inputData, {
860
+ ...(kind === "langchainCode"
861
+ ? {
862
+ output: inputData["input"] ?? null,
863
+ resource: {
864
+ type: "mastra.langchainCode",
865
+ language: parameters["language"] ?? "javascript",
866
+ mode: parameters["mode"] ?? "runOnce",
867
+ hasCode: code !== undefined,
868
+ },
869
+ }
870
+ : {
871
+ resource: {
872
+ type: "mastra.sandbox",
873
+ workingDirectory: parameters["workingDirectory"],
874
+ isolation: parameters["isolation"],
875
+ timeoutMs,
876
+ },
877
+ }),
878
+ });
879
+ }
880
+ if (!options.runSandboxedCode) {
881
+ if (kind !== "langchainCode") {
882
+ return descriptorFallback(node, inputData, {
883
+ resource: {
884
+ type: "mastra.sandbox",
885
+ workingDirectory: parameters["workingDirectory"],
886
+ isolation: parameters["isolation"],
887
+ timeoutMs,
888
+ },
889
+ });
890
+ }
891
+ throw new GraphExecutionError(`Sandboxed code kind '${node.kind}' on node '${node.id}' has code but no host sandbox runner`, GRAPH_MASTRA_SANDBOX_UNAVAILABLE, { nodeId: node.id, kind: node.kind });
892
+ }
893
+ const output = await withTimeout(Promise.resolve(options.runSandboxedCode({
894
+ node,
895
+ code,
896
+ language: parameters["language"] === "typescript"
897
+ ? "typescript"
898
+ : "javascript",
899
+ input: inputData["input"] ?? inputData,
900
+ timeoutMs,
901
+ ...(nonEmptyString(parameters["isolation"])
902
+ ? { isolation: parameters["isolation"] }
903
+ : {}),
904
+ ...(nonEmptyString(parameters["workingDirectory"])
905
+ ? { workingDirectory: parameters["workingDirectory"] }
906
+ : {}),
907
+ })), timeoutMs, node.id);
908
+ return descriptorFallback(node, inputData, {
909
+ ...(kind === "langchainCode" ? { output } : { result: output }),
910
+ resource: {
911
+ type: kind === "langchainCode" ? "mastra.langchainCode" : "mastra.sandbox",
912
+ timeoutMs,
913
+ },
914
+ });
915
+ };
916
+ handler("core.agent.sandbox", (node, inputData) => runCode(node, inputData, "sandbox"));
917
+ handler("core.agent.langchainCode", (node, inputData) => runCode(node, inputData, "langchainCode"));
918
+ return handlers;
919
+ }
920
+ //# sourceMappingURL=MastraRagStepHandlers.js.map