@decaf-ts/as-graph 0.6.0 → 0.7.0

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