@decaf-ts/as-graph 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (968) hide show
  1. package/README.md +834 -38
  2. package/assets/i18n/en.json +2527 -32
  3. package/dist/as-graph.cjs +1 -1
  4. package/dist/as-graph.cjs.map +1 -1
  5. package/dist/as-graph.js +1 -1
  6. package/dist/as-graph.js.map +1 -1
  7. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +102 -11
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
  9. package/lib/cjs/engine/auth/GraphAuthValidator.cjs +19 -0
  10. package/lib/cjs/engine/auth/GraphAuthValidator.cjs.map +1 -1
  11. package/lib/cjs/engine/constants.cjs +61 -1
  12. package/lib/cjs/engine/constants.cjs.map +1 -1
  13. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs +158 -0
  14. package/lib/cjs/engine/credentials/GraphNodeCredentials.cjs.map +1 -0
  15. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +235 -67
  16. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  17. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs +33 -0
  18. package/lib/cjs/engine/execution/GraphNodeEngineRequirements.cjs.map +1 -0
  19. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs +108 -0
  20. package/lib/cjs/engine/execution/GraphWebhookResponseRegistry.cjs.map +1 -0
  21. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +92 -1
  22. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -1
  23. package/lib/cjs/engine/execution/index.cjs +1 -0
  24. package/lib/cjs/engine/execution/index.cjs.map +1 -1
  25. package/lib/cjs/engine/index.cjs +5 -0
  26. package/lib/cjs/engine/index.cjs.map +1 -1
  27. package/lib/cjs/engine/services/GraphNodeModelService.cjs +129 -0
  28. package/lib/cjs/engine/services/GraphNodeModelService.cjs.map +1 -0
  29. package/lib/cjs/engine/services/GraphWorkflowService.cjs +33 -0
  30. package/lib/cjs/engine/services/GraphWorkflowService.cjs.map +1 -1
  31. package/lib/cjs/engine/store/GraphDataTableModel.cjs +76 -0
  32. package/lib/cjs/engine/store/GraphDataTableModel.cjs.map +1 -0
  33. package/lib/cjs/engine/store/GraphDataTableRepository.cjs +324 -0
  34. package/lib/cjs/engine/store/GraphDataTableRepository.cjs.map +1 -0
  35. package/lib/cjs/engine/store/index.cjs +2 -0
  36. package/lib/cjs/engine/store/index.cjs.map +1 -1
  37. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs +28 -0
  38. package/lib/cjs/engine/validation/GraphConnectionPolicyValidator.cjs.map +1 -1
  39. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs +4 -2
  40. package/lib/cjs/engine/validation/GraphCredentialReferenceValidator.cjs.map +1 -1
  41. package/lib/cjs/engine/validation/GraphParameterValidator.cjs +6 -0
  42. package/lib/cjs/engine/validation/GraphParameterValidator.cjs.map +1 -1
  43. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs +298 -0
  44. package/lib/cjs/mastra/MastraAgeVectorDriver.cjs.map +1 -0
  45. package/lib/cjs/mastra/MastraAgentBuilder.cjs +249 -0
  46. package/lib/cjs/mastra/MastraAgentBuilder.cjs.map +1 -0
  47. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs +65 -0
  48. package/lib/cjs/mastra/MastraAgentModelAdapter.cjs.map +1 -0
  49. package/lib/cjs/mastra/MastraAgentProcessors.cjs +397 -0
  50. package/lib/cjs/mastra/MastraAgentProcessors.cjs.map +1 -0
  51. package/lib/cjs/mastra/MastraAgentStepHandler.cjs +332 -0
  52. package/lib/cjs/mastra/MastraAgentStepHandler.cjs.map +1 -0
  53. package/lib/cjs/mastra/MastraCapabilities.cjs +115 -0
  54. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -1
  55. package/lib/cjs/mastra/MastraChannelResponse.cjs +162 -0
  56. package/lib/cjs/mastra/MastraChannelResponse.cjs.map +1 -0
  57. package/lib/cjs/mastra/MastraChannelTrigger.cjs +124 -0
  58. package/lib/cjs/mastra/MastraChannelTrigger.cjs.map +1 -0
  59. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs +435 -0
  60. package/lib/cjs/mastra/MastraDefaultStepHandlers.cjs.map +1 -0
  61. package/lib/cjs/mastra/MastraEnvironment.cjs +297 -0
  62. package/lib/cjs/mastra/MastraEnvironment.cjs.map +1 -0
  63. package/lib/cjs/mastra/MastraEvalModels.cjs +546 -0
  64. package/lib/cjs/mastra/MastraEvalModels.cjs.map +1 -0
  65. package/lib/cjs/mastra/MastraEventBridge.cjs +31 -4
  66. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -1
  67. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +513 -20
  68. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -1
  69. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs +148 -0
  70. package/lib/cjs/mastra/MastraGraphExecutionModule.cjs.map +1 -0
  71. package/lib/cjs/mastra/MastraHitlStepHandler.cjs +67 -0
  72. package/lib/cjs/mastra/MastraHitlStepHandler.cjs.map +1 -0
  73. package/lib/cjs/mastra/MastraMcpTrigger.cjs +254 -0
  74. package/lib/cjs/mastra/MastraMcpTrigger.cjs.map +1 -0
  75. package/lib/cjs/mastra/MastraMemory.cjs +467 -0
  76. package/lib/cjs/mastra/MastraMemory.cjs.map +1 -0
  77. package/lib/cjs/mastra/MastraMetricsAdapter.cjs +279 -0
  78. package/lib/cjs/mastra/MastraMetricsAdapter.cjs.map +1 -0
  79. package/lib/cjs/mastra/MastraMetricsGateway.cjs +404 -0
  80. package/lib/cjs/mastra/MastraMetricsGateway.cjs.map +1 -0
  81. package/lib/cjs/mastra/MastraMetricsModels.cjs +498 -0
  82. package/lib/cjs/mastra/MastraMetricsModels.cjs.map +1 -0
  83. package/lib/cjs/mastra/MastraMetricsStatement.cjs +220 -0
  84. package/lib/cjs/mastra/MastraMetricsStatement.cjs.map +1 -0
  85. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs +84 -0
  86. package/lib/cjs/mastra/MastraModelSchemaConverter.cjs.map +1 -0
  87. package/lib/cjs/mastra/MastraObservability.cjs +335 -0
  88. package/lib/cjs/mastra/MastraObservability.cjs.map +1 -0
  89. package/lib/cjs/mastra/MastraPersistence.cjs +545 -0
  90. package/lib/cjs/mastra/MastraPersistence.cjs.map +1 -0
  91. package/lib/cjs/mastra/MastraRagStepHandlers.cjs +927 -0
  92. package/lib/cjs/mastra/MastraRagStepHandlers.cjs.map +1 -0
  93. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs +153 -0
  94. package/lib/cjs/mastra/MastraRunMetricsEndpoint.cjs.map +1 -0
  95. package/lib/cjs/mastra/MastraRunRecovery.cjs +94 -0
  96. package/lib/cjs/mastra/MastraRunRecovery.cjs.map +1 -0
  97. package/lib/cjs/mastra/MastraScheduleTrigger.cjs +115 -0
  98. package/lib/cjs/mastra/MastraScheduleTrigger.cjs.map +1 -0
  99. package/lib/cjs/mastra/MastraStorageWiring.cjs +125 -0
  100. package/lib/cjs/mastra/MastraStorageWiring.cjs.map +1 -0
  101. package/lib/cjs/mastra/MastraStructuredOutput.cjs +152 -0
  102. package/lib/cjs/mastra/MastraStructuredOutput.cjs.map +1 -0
  103. package/lib/cjs/mastra/MastraToolBuilder.cjs +73 -0
  104. package/lib/cjs/mastra/MastraToolBuilder.cjs.map +1 -0
  105. package/lib/cjs/mastra/MastraToolConfig.cjs +42 -0
  106. package/lib/cjs/mastra/MastraToolConfig.cjs.map +1 -0
  107. package/lib/cjs/mastra/MastraToolDecorator.cjs +99 -0
  108. package/lib/cjs/mastra/MastraToolDecorator.cjs.map +1 -0
  109. package/lib/cjs/mastra/MastraVectorStore.cjs +618 -0
  110. package/lib/cjs/mastra/MastraVectorStore.cjs.map +1 -0
  111. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs +90 -0
  112. package/lib/cjs/mastra/MastraVoiceStepHandler.cjs.map +1 -0
  113. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +41 -9
  114. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  115. package/lib/cjs/mastra/MastraWorkflowManager.cjs +100 -50
  116. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -1
  117. package/lib/cjs/mastra/index.cjs +41 -1
  118. package/lib/cjs/mastra/index.cjs.map +1 -1
  119. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs +232 -0
  120. package/lib/cjs/mastra/nodes/MastraNodeRegistry.cjs.map +1 -0
  121. package/lib/cjs/mastra/nodes/index.cjs +29 -0
  122. package/lib/cjs/mastra/nodes/index.cjs.map +1 -0
  123. package/lib/cjs/mastra/nodes/types.cjs +4 -0
  124. package/lib/cjs/mastra/nodes/types.cjs.map +1 -0
  125. package/lib/cjs/mastra/types.cjs +130 -1
  126. package/lib/cjs/mastra/types.cjs.map +1 -1
  127. package/lib/cjs/nest/graph/GraphBackendHost.cjs +117 -23
  128. package/lib/cjs/nest/graph/GraphBackendHost.cjs.map +1 -1
  129. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +72 -2
  130. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  131. package/lib/cjs/nest/graph/GraphRunController.cjs +47 -6
  132. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  133. package/lib/cjs/nest/graph/main.cjs +99 -2
  134. package/lib/cjs/nest/graph/main.cjs.map +1 -1
  135. package/lib/cjs/node/agents/agent/node.cjs +189 -31
  136. package/lib/cjs/node/agents/agent/node.cjs.map +1 -1
  137. package/lib/cjs/node/agents/hitl/node.cjs +115 -0
  138. package/lib/cjs/node/agents/hitl/node.cjs.map +1 -0
  139. package/lib/cjs/node/agents/hooks/delegation/node.cjs +122 -0
  140. package/lib/cjs/node/agents/hooks/delegation/node.cjs.map +1 -0
  141. package/lib/cjs/node/agents/hooks/hook/node.cjs +120 -0
  142. package/lib/cjs/node/agents/hooks/hook/node.cjs.map +1 -0
  143. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs +104 -0
  144. package/lib/cjs/node/agents/hooks/tool-deny/node.cjs.map +1 -0
  145. package/lib/cjs/node/agents/memory/memory/node.cjs +231 -0
  146. package/lib/cjs/node/agents/memory/memory/node.cjs.map +1 -0
  147. package/lib/cjs/node/agents/memory/memory-selector/node.cjs +101 -0
  148. package/lib/cjs/node/agents/memory/memory-selector/node.cjs.map +1 -0
  149. package/lib/cjs/node/agents/processors/guardrail/node.cjs +126 -0
  150. package/lib/cjs/node/agents/processors/guardrail/node.cjs.map +1 -0
  151. package/lib/cjs/node/agents/processors/input-processor/node.cjs +118 -0
  152. package/lib/cjs/node/agents/processors/input-processor/node.cjs.map +1 -0
  153. package/lib/cjs/node/agents/processors/output-processor/node.cjs +108 -0
  154. package/lib/cjs/node/agents/processors/output-processor/node.cjs.map +1 -0
  155. package/lib/cjs/node/agents/processors/types.cjs +68 -0
  156. package/lib/cjs/node/agents/processors/types.cjs.map +1 -0
  157. package/lib/cjs/node/agents/rag/chains/basic/node.cjs +103 -0
  158. package/lib/cjs/node/agents/rag/chains/basic/node.cjs.map +1 -0
  159. package/lib/cjs/node/agents/rag/chains/qa/node.cjs +124 -0
  160. package/lib/cjs/node/agents/rag/chains/qa/node.cjs.map +1 -0
  161. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs +116 -0
  162. package/lib/cjs/node/agents/rag/chains/summarization/node.cjs.map +1 -0
  163. package/lib/cjs/node/agents/rag/chunking/node.cjs +222 -0
  164. package/lib/cjs/node/agents/rag/chunking/node.cjs.map +1 -0
  165. package/lib/cjs/node/agents/rag/embedding/node.cjs +110 -0
  166. package/lib/cjs/node/agents/rag/embedding/node.cjs.map +1 -0
  167. package/lib/cjs/node/agents/rag/information-extractor/node.cjs +115 -0
  168. package/lib/cjs/node/agents/rag/information-extractor/node.cjs.map +1 -0
  169. package/lib/cjs/node/agents/rag/langchain-code/node.cjs +113 -0
  170. package/lib/cjs/node/agents/rag/langchain-code/node.cjs.map +1 -0
  171. package/lib/cjs/node/agents/rag/rerank/node.cjs +112 -0
  172. package/lib/cjs/node/agents/rag/rerank/node.cjs.map +1 -0
  173. package/lib/cjs/node/agents/rag/retriever/node.cjs +120 -0
  174. package/lib/cjs/node/agents/rag/retriever/node.cjs.map +1 -0
  175. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs +121 -0
  176. package/lib/cjs/node/agents/rag/structured-output-parser/node.cjs.map +1 -0
  177. package/lib/cjs/node/agents/rag/vector-store/node.cjs +187 -0
  178. package/lib/cjs/node/agents/rag/vector-store/node.cjs.map +1 -0
  179. package/lib/cjs/node/agents/responses/discord/node.cjs +101 -0
  180. package/lib/cjs/node/agents/responses/discord/node.cjs.map +1 -0
  181. package/lib/cjs/node/agents/responses/slack/node.cjs +101 -0
  182. package/lib/cjs/node/agents/responses/slack/node.cjs.map +1 -0
  183. package/lib/cjs/node/agents/responses/teams/node.cjs +101 -0
  184. package/lib/cjs/node/agents/responses/teams/node.cjs.map +1 -0
  185. package/lib/cjs/node/agents/responses/telegram/node.cjs +101 -0
  186. package/lib/cjs/node/agents/responses/telegram/node.cjs.map +1 -0
  187. package/lib/cjs/node/agents/sandbox/node.cjs +135 -0
  188. package/lib/cjs/node/agents/sandbox/node.cjs.map +1 -0
  189. package/lib/cjs/node/agents/scorers/scorer/node.cjs +107 -0
  190. package/lib/cjs/node/agents/scorers/scorer/node.cjs.map +1 -0
  191. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs +100 -0
  192. package/lib/cjs/node/agents/scorers/scorer-selector/node.cjs.map +1 -0
  193. package/lib/cjs/node/agents/skills/skill/node.cjs +105 -0
  194. package/lib/cjs/node/agents/skills/skill/node.cjs.map +1 -0
  195. package/lib/cjs/node/agents/skills/skill-selector/node.cjs +98 -0
  196. package/lib/cjs/node/agents/skills/skill-selector/node.cjs.map +1 -0
  197. package/lib/cjs/node/agents/tools/tool/node.cjs +100 -0
  198. package/lib/cjs/node/agents/tools/tool/node.cjs.map +1 -0
  199. package/lib/cjs/node/agents/tools/tool-selector/node.cjs +99 -0
  200. package/lib/cjs/node/agents/tools/tool-selector/node.cjs.map +1 -0
  201. package/lib/cjs/node/agents/triggers/discord/node.cjs +101 -0
  202. package/lib/cjs/node/agents/triggers/discord/node.cjs.map +1 -0
  203. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs +147 -0
  204. package/lib/cjs/node/agents/triggers/mcp-server/node.cjs.map +1 -0
  205. package/lib/cjs/node/agents/triggers/slack/node.cjs +101 -0
  206. package/lib/cjs/node/agents/triggers/slack/node.cjs.map +1 -0
  207. package/lib/cjs/node/agents/triggers/teams/node.cjs +101 -0
  208. package/lib/cjs/node/agents/triggers/teams/node.cjs.map +1 -0
  209. package/lib/cjs/node/agents/triggers/telegram/node.cjs +101 -0
  210. package/lib/cjs/node/agents/triggers/telegram/node.cjs.map +1 -0
  211. package/lib/cjs/node/agents/voice/node.cjs +107 -0
  212. package/lib/cjs/node/agents/voice/node.cjs.map +1 -0
  213. package/lib/cjs/node/agents/zones.cjs +43 -0
  214. package/lib/cjs/node/agents/zones.cjs.map +1 -0
  215. package/lib/cjs/node/comms/email-send/node.cjs +340 -0
  216. package/lib/cjs/node/comms/email-send/node.cjs.map +1 -0
  217. package/lib/cjs/node/comms/gmail/node.cjs +287 -0
  218. package/lib/cjs/node/comms/gmail/node.cjs.map +1 -0
  219. package/lib/cjs/node/comms/slack/node.cjs +276 -0
  220. package/lib/cjs/node/comms/slack/node.cjs.map +1 -0
  221. package/lib/cjs/node/comms/teams/node.cjs +231 -0
  222. package/lib/cjs/node/comms/teams/node.cjs.map +1 -0
  223. package/lib/cjs/node/comms/telegram/node.cjs +260 -0
  224. package/lib/cjs/node/comms/telegram/node.cjs.map +1 -0
  225. package/lib/cjs/node/credentials.cjs +103 -0
  226. package/lib/cjs/node/credentials.cjs.map +1 -0
  227. package/lib/cjs/node/data/data-table/node.cjs +265 -0
  228. package/lib/cjs/node/data/data-table/node.cjs.map +1 -0
  229. package/lib/cjs/node/data/date-time/node.cjs +180 -0
  230. package/lib/cjs/node/data/date-time/node.cjs.map +1 -0
  231. package/lib/cjs/node/data/filter/node.cjs +134 -0
  232. package/lib/cjs/node/data/filter/node.cjs.map +1 -0
  233. package/lib/cjs/node/data/limit/node.cjs +104 -0
  234. package/lib/cjs/node/data/limit/node.cjs.map +1 -0
  235. package/lib/cjs/node/data/merge/node.cjs +251 -0
  236. package/lib/cjs/node/data/merge/node.cjs.map +1 -0
  237. package/lib/cjs/node/data/rename-keys/node.cjs +139 -0
  238. package/lib/cjs/node/data/rename-keys/node.cjs.map +1 -0
  239. package/lib/cjs/node/data/set/node.cjs +148 -0
  240. package/lib/cjs/node/data/set/node.cjs.map +1 -0
  241. package/lib/cjs/node/data/sort/node.cjs +125 -0
  242. package/lib/cjs/node/data/sort/node.cjs.map +1 -0
  243. package/lib/cjs/node/data/split-out/node.cjs +140 -0
  244. package/lib/cjs/node/data/split-out/node.cjs.map +1 -0
  245. package/lib/cjs/node/data/support.cjs +398 -0
  246. package/lib/cjs/node/data/support.cjs.map +1 -0
  247. package/lib/cjs/node/devops/crypto/node.cjs +364 -0
  248. package/lib/cjs/node/devops/crypto/node.cjs.map +1 -0
  249. package/lib/cjs/node/devops/execute-command/node.cjs +201 -0
  250. package/lib/cjs/node/devops/execute-command/node.cjs.map +1 -0
  251. package/lib/cjs/node/devops/ftp/node.cjs +241 -0
  252. package/lib/cjs/node/devops/ftp/node.cjs.map +1 -0
  253. package/lib/cjs/node/devops/github/node.cjs +282 -0
  254. package/lib/cjs/node/devops/github/node.cjs.map +1 -0
  255. package/lib/cjs/node/devops/gitlab/node.cjs +273 -0
  256. package/lib/cjs/node/devops/gitlab/node.cjs.map +1 -0
  257. package/lib/cjs/node/devops/jwt/node.cjs +204 -0
  258. package/lib/cjs/node/devops/jwt/node.cjs.map +1 -0
  259. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs +223 -0
  260. package/lib/cjs/node/flow/execute-sub-workflow/node.cjs.map +1 -0
  261. package/lib/cjs/node/index.cjs +402 -66
  262. package/lib/cjs/node/index.cjs.map +1 -1
  263. package/lib/cjs/node/io/airtable/node.cjs +318 -0
  264. package/lib/cjs/node/io/airtable/node.cjs.map +1 -0
  265. package/lib/cjs/node/io/extract-from-file/node.cjs +269 -0
  266. package/lib/cjs/node/io/extract-from-file/node.cjs.map +1 -0
  267. package/lib/cjs/node/io/google-sheets/node.cjs +267 -0
  268. package/lib/cjs/node/io/google-sheets/node.cjs.map +1 -0
  269. package/lib/cjs/node/io/graphql/node.cjs +169 -0
  270. package/lib/cjs/node/io/graphql/node.cjs.map +1 -0
  271. package/lib/cjs/node/io/http-request/node.cjs +415 -0
  272. package/lib/cjs/node/io/http-request/node.cjs.map +1 -0
  273. package/lib/cjs/node/io/read-pdf/node.cjs +206 -0
  274. package/lib/cjs/node/io/read-pdf/node.cjs.map +1 -0
  275. package/lib/cjs/node/io/read-write-file/node.cjs +314 -0
  276. package/lib/cjs/node/io/read-write-file/node.cjs.map +1 -0
  277. package/lib/cjs/node/io/respond-to-webhook/node.cjs +183 -0
  278. package/lib/cjs/node/io/respond-to-webhook/node.cjs.map +1 -0
  279. package/lib/cjs/node/io/spreadsheet-file/node.cjs +192 -0
  280. package/lib/cjs/node/io/spreadsheet-file/node.cjs.map +1 -0
  281. package/lib/cjs/node/manifests.cjs +264 -36
  282. package/lib/cjs/node/manifests.cjs.map +1 -1
  283. package/lib/cjs/node/storage/blob/azure/node.cjs +138 -0
  284. package/lib/cjs/node/storage/blob/azure/node.cjs.map +1 -0
  285. package/lib/cjs/node/storage/blob/base.cjs +321 -0
  286. package/lib/cjs/node/storage/blob/base.cjs.map +1 -0
  287. package/lib/cjs/node/storage/blob/gcs/node.cjs +126 -0
  288. package/lib/cjs/node/storage/blob/gcs/node.cjs.map +1 -0
  289. package/lib/cjs/node/storage/blob/s3/node.cjs +186 -0
  290. package/lib/cjs/node/storage/blob/s3/node.cjs.map +1 -0
  291. package/lib/cjs/node/storage/database/base.cjs +301 -0
  292. package/lib/cjs/node/storage/database/base.cjs.map +1 -0
  293. package/lib/cjs/node/storage/database/mssql/node.cjs +50 -0
  294. package/lib/cjs/node/storage/database/mssql/node.cjs.map +1 -0
  295. package/lib/cjs/node/storage/database/mysql/node.cjs +50 -0
  296. package/lib/cjs/node/storage/database/mysql/node.cjs.map +1 -0
  297. package/lib/cjs/node/storage/database/postgres/node.cjs +50 -0
  298. package/lib/cjs/node/storage/database/postgres/node.cjs.map +1 -0
  299. package/lib/cjs/node/storage/redis/node.cjs +340 -0
  300. package/lib/cjs/node/storage/redis/node.cjs.map +1 -0
  301. package/lib/cjs/node/storage/support.cjs +81 -0
  302. package/lib/cjs/node/storage/support.cjs.map +1 -0
  303. package/lib/cjs/node/triggers/execute-workflow/node.cjs +94 -0
  304. package/lib/cjs/node/triggers/execute-workflow/node.cjs.map +1 -0
  305. package/lib/cjs/ram/GraphNodeRepository.cjs +40 -0
  306. package/lib/cjs/ram/GraphNodeRepository.cjs.map +1 -0
  307. package/lib/cjs/ram/GraphRunEventModel.cjs +4 -0
  308. package/lib/cjs/ram/GraphRunEventModel.cjs.map +1 -1
  309. package/lib/cjs/ram/index.cjs +1 -0
  310. package/lib/cjs/ram/index.cjs.map +1 -1
  311. package/lib/cjs/shared/graph/GraphNodeConverters.cjs +43 -0
  312. package/lib/cjs/shared/graph/GraphNodeConverters.cjs.map +1 -0
  313. package/lib/cjs/shared/graph/GraphNodeModel.cjs +78 -0
  314. package/lib/cjs/shared/graph/GraphNodeModel.cjs.map +1 -0
  315. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs +4 -0
  316. package/lib/cjs/shared/graph/GraphWorkflowModel.cjs.map +1 -1
  317. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +40 -0
  318. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  319. package/lib/cjs/shared/graph/category-styles.cjs +12 -0
  320. package/lib/cjs/shared/graph/category-styles.cjs.map +1 -1
  321. package/lib/cjs/shared/graph/index.cjs +2 -0
  322. package/lib/cjs/shared/graph/index.cjs.map +1 -1
  323. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs +250 -0
  324. package/lib/cjs/typeorm/TypeormGraphAdapter.cjs.map +1 -0
  325. package/lib/cjs/typeorm/index.cjs +29 -0
  326. package/lib/cjs/typeorm/index.cjs.map +1 -0
  327. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +102 -11
  328. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
  329. package/lib/esm/engine/auth/GraphAuthValidator.js +19 -0
  330. package/lib/esm/engine/auth/GraphAuthValidator.js.map +1 -1
  331. package/lib/esm/engine/constants.js +60 -0
  332. package/lib/esm/engine/constants.js.map +1 -1
  333. package/lib/esm/engine/credentials/GraphNodeCredentials.js +152 -0
  334. package/lib/esm/engine/credentials/GraphNodeCredentials.js.map +1 -0
  335. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
  336. package/lib/esm/engine/execution/GraphExecutionEngine.js +236 -68
  337. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  338. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js +28 -0
  339. package/lib/esm/engine/execution/GraphNodeEngineRequirements.js.map +1 -0
  340. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js +103 -0
  341. package/lib/esm/engine/execution/GraphWebhookResponseRegistry.js.map +1 -0
  342. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +93 -2
  343. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -1
  344. package/lib/esm/engine/execution/index.js +1 -0
  345. package/lib/esm/engine/execution/index.js.map +1 -1
  346. package/lib/esm/engine/index.js +5 -0
  347. package/lib/esm/engine/index.js.map +1 -1
  348. package/lib/esm/engine/services/GraphNodeModelService.js +120 -0
  349. package/lib/esm/engine/services/GraphNodeModelService.js.map +1 -0
  350. package/lib/esm/engine/services/GraphWorkflowService.js +34 -1
  351. package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
  352. package/lib/esm/engine/store/GraphDataTableModel.js +67 -0
  353. package/lib/esm/engine/store/GraphDataTableModel.js.map +1 -0
  354. package/lib/esm/engine/store/GraphDataTableRepository.js +314 -0
  355. package/lib/esm/engine/store/GraphDataTableRepository.js.map +1 -0
  356. package/lib/esm/engine/store/index.js +2 -0
  357. package/lib/esm/engine/store/index.js.map +1 -1
  358. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js +28 -0
  359. package/lib/esm/engine/validation/GraphConnectionPolicyValidator.js.map +1 -1
  360. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js +4 -2
  361. package/lib/esm/engine/validation/GraphCredentialReferenceValidator.js.map +1 -1
  362. package/lib/esm/engine/validation/GraphParameterValidator.js +6 -0
  363. package/lib/esm/engine/validation/GraphParameterValidator.js.map +1 -1
  364. package/lib/esm/mastra/MastraAgeVectorDriver.js +294 -0
  365. package/lib/esm/mastra/MastraAgeVectorDriver.js.map +1 -0
  366. package/lib/esm/mastra/MastraAgentBuilder.js +244 -0
  367. package/lib/esm/mastra/MastraAgentBuilder.js.map +1 -0
  368. package/lib/esm/mastra/MastraAgentModelAdapter.js +59 -0
  369. package/lib/esm/mastra/MastraAgentModelAdapter.js.map +1 -0
  370. package/lib/esm/mastra/MastraAgentProcessors.js +391 -0
  371. package/lib/esm/mastra/MastraAgentProcessors.js.map +1 -0
  372. package/lib/esm/mastra/MastraAgentStepHandler.js +327 -0
  373. package/lib/esm/mastra/MastraAgentStepHandler.js.map +1 -0
  374. package/lib/esm/mastra/MastraCapabilities.js +115 -0
  375. package/lib/esm/mastra/MastraCapabilities.js.map +1 -1
  376. package/lib/esm/mastra/MastraChannelResponse.js +154 -0
  377. package/lib/esm/mastra/MastraChannelResponse.js.map +1 -0
  378. package/lib/esm/mastra/MastraChannelTrigger.js +116 -0
  379. package/lib/esm/mastra/MastraChannelTrigger.js.map +1 -0
  380. package/lib/esm/mastra/MastraDefaultStepHandlers.js +430 -0
  381. package/lib/esm/mastra/MastraDefaultStepHandlers.js.map +1 -0
  382. package/lib/esm/mastra/MastraEnvironment.js +287 -0
  383. package/lib/esm/mastra/MastraEnvironment.js.map +1 -0
  384. package/lib/esm/mastra/MastraEvalModels.js +535 -0
  385. package/lib/esm/mastra/MastraEvalModels.js.map +1 -0
  386. package/lib/esm/mastra/MastraEventBridge.js +31 -4
  387. package/lib/esm/mastra/MastraEventBridge.js.map +1 -1
  388. package/lib/esm/mastra/MastraGraphExecutionBackend.js +514 -21
  389. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -1
  390. package/lib/esm/mastra/MastraGraphExecutionModule.js +139 -0
  391. package/lib/esm/mastra/MastraGraphExecutionModule.js.map +1 -0
  392. package/lib/esm/mastra/MastraHitlStepHandler.js +62 -0
  393. package/lib/esm/mastra/MastraHitlStepHandler.js.map +1 -0
  394. package/lib/esm/mastra/MastraMcpTrigger.js +246 -0
  395. package/lib/esm/mastra/MastraMcpTrigger.js.map +1 -0
  396. package/lib/esm/mastra/MastraMemory.js +455 -0
  397. package/lib/esm/mastra/MastraMemory.js.map +1 -0
  398. package/lib/esm/mastra/MastraMetricsAdapter.js +273 -0
  399. package/lib/esm/mastra/MastraMetricsAdapter.js.map +1 -0
  400. package/lib/esm/mastra/MastraMetricsGateway.js +394 -0
  401. package/lib/esm/mastra/MastraMetricsGateway.js.map +1 -0
  402. package/lib/esm/mastra/MastraMetricsModels.js +486 -0
  403. package/lib/esm/mastra/MastraMetricsModels.js.map +1 -0
  404. package/lib/esm/mastra/MastraMetricsStatement.js +213 -0
  405. package/lib/esm/mastra/MastraMetricsStatement.js.map +1 -0
  406. package/lib/esm/mastra/MastraModelSchemaConverter.js +78 -0
  407. package/lib/esm/mastra/MastraModelSchemaConverter.js.map +1 -0
  408. package/lib/esm/mastra/MastraObservability.js +327 -0
  409. package/lib/esm/mastra/MastraObservability.js.map +1 -0
  410. package/lib/esm/mastra/MastraPersistence.js +530 -0
  411. package/lib/esm/mastra/MastraPersistence.js.map +1 -0
  412. package/lib/esm/mastra/MastraRagStepHandlers.js +920 -0
  413. package/lib/esm/mastra/MastraRagStepHandlers.js.map +1 -0
  414. package/lib/esm/mastra/MastraRunMetricsEndpoint.js +147 -0
  415. package/lib/esm/mastra/MastraRunMetricsEndpoint.js.map +1 -0
  416. package/lib/esm/mastra/MastraRunRecovery.js +89 -0
  417. package/lib/esm/mastra/MastraRunRecovery.js.map +1 -0
  418. package/lib/esm/mastra/MastraScheduleTrigger.js +110 -0
  419. package/lib/esm/mastra/MastraScheduleTrigger.js.map +1 -0
  420. package/lib/esm/mastra/MastraStorageWiring.js +119 -0
  421. package/lib/esm/mastra/MastraStorageWiring.js.map +1 -0
  422. package/lib/esm/mastra/MastraStructuredOutput.js +144 -0
  423. package/lib/esm/mastra/MastraStructuredOutput.js.map +1 -0
  424. package/lib/esm/mastra/MastraToolBuilder.js +68 -0
  425. package/lib/esm/mastra/MastraToolBuilder.js.map +1 -0
  426. package/lib/esm/mastra/MastraToolConfig.js +37 -0
  427. package/lib/esm/mastra/MastraToolConfig.js.map +1 -0
  428. package/lib/esm/mastra/MastraToolDecorator.js +92 -0
  429. package/lib/esm/mastra/MastraToolDecorator.js.map +1 -0
  430. package/lib/esm/mastra/MastraVectorStore.js +605 -0
  431. package/lib/esm/mastra/MastraVectorStore.js.map +1 -0
  432. package/lib/esm/mastra/MastraVoiceStepHandler.js +84 -0
  433. package/lib/esm/mastra/MastraVoiceStepHandler.js.map +1 -0
  434. package/lib/esm/mastra/MastraWorkflowCompiler.js +41 -9
  435. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  436. package/lib/esm/mastra/MastraWorkflowManager.js +101 -51
  437. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -1
  438. package/lib/esm/mastra/index.js +41 -1
  439. package/lib/esm/mastra/index.js.map +1 -1
  440. package/lib/esm/mastra/nodes/MastraNodeRegistry.js +225 -0
  441. package/lib/esm/mastra/nodes/MastraNodeRegistry.js.map +1 -0
  442. package/lib/esm/mastra/nodes/index.js +12 -0
  443. package/lib/esm/mastra/nodes/index.js.map +1 -0
  444. package/lib/esm/mastra/nodes/types.js +2 -0
  445. package/lib/esm/mastra/nodes/types.js.map +1 -0
  446. package/lib/esm/mastra/types.js +129 -0
  447. package/lib/esm/mastra/types.js.map +1 -1
  448. package/lib/esm/nest/graph/GraphBackendHost.js +79 -20
  449. package/lib/esm/nest/graph/GraphBackendHost.js.map +1 -1
  450. package/lib/esm/nest/graph/GraphExecutionModule.js +73 -3
  451. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  452. package/lib/esm/nest/graph/GraphRunController.js +47 -6
  453. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  454. package/lib/esm/nest/graph/main.js +100 -3
  455. package/lib/esm/nest/graph/main.js.map +1 -1
  456. package/lib/esm/node/agents/agent/node.js +189 -31
  457. package/lib/esm/node/agents/agent/node.js.map +1 -1
  458. package/lib/esm/node/agents/hitl/node.js +106 -0
  459. package/lib/esm/node/agents/hitl/node.js.map +1 -0
  460. package/lib/esm/node/agents/hooks/delegation/node.js +113 -0
  461. package/lib/esm/node/agents/hooks/delegation/node.js.map +1 -0
  462. package/lib/esm/node/agents/hooks/hook/node.js +111 -0
  463. package/lib/esm/node/agents/hooks/hook/node.js.map +1 -0
  464. package/lib/esm/node/agents/hooks/tool-deny/node.js +95 -0
  465. package/lib/esm/node/agents/hooks/tool-deny/node.js.map +1 -0
  466. package/lib/esm/node/agents/memory/memory/node.js +222 -0
  467. package/lib/esm/node/agents/memory/memory/node.js.map +1 -0
  468. package/lib/esm/node/agents/memory/memory-selector/node.js +92 -0
  469. package/lib/esm/node/agents/memory/memory-selector/node.js.map +1 -0
  470. package/lib/esm/node/agents/processors/guardrail/node.js +117 -0
  471. package/lib/esm/node/agents/processors/guardrail/node.js.map +1 -0
  472. package/lib/esm/node/agents/processors/input-processor/node.js +109 -0
  473. package/lib/esm/node/agents/processors/input-processor/node.js.map +1 -0
  474. package/lib/esm/node/agents/processors/output-processor/node.js +99 -0
  475. package/lib/esm/node/agents/processors/output-processor/node.js.map +1 -0
  476. package/lib/esm/node/agents/processors/types.js +64 -0
  477. package/lib/esm/node/agents/processors/types.js.map +1 -0
  478. package/lib/esm/node/agents/rag/chains/basic/node.js +94 -0
  479. package/lib/esm/node/agents/rag/chains/basic/node.js.map +1 -0
  480. package/lib/esm/node/agents/rag/chains/qa/node.js +115 -0
  481. package/lib/esm/node/agents/rag/chains/qa/node.js.map +1 -0
  482. package/lib/esm/node/agents/rag/chains/summarization/node.js +107 -0
  483. package/lib/esm/node/agents/rag/chains/summarization/node.js.map +1 -0
  484. package/lib/esm/node/agents/rag/chunking/node.js +211 -0
  485. package/lib/esm/node/agents/rag/chunking/node.js.map +1 -0
  486. package/lib/esm/node/agents/rag/embedding/node.js +101 -0
  487. package/lib/esm/node/agents/rag/embedding/node.js.map +1 -0
  488. package/lib/esm/node/agents/rag/information-extractor/node.js +106 -0
  489. package/lib/esm/node/agents/rag/information-extractor/node.js.map +1 -0
  490. package/lib/esm/node/agents/rag/langchain-code/node.js +104 -0
  491. package/lib/esm/node/agents/rag/langchain-code/node.js.map +1 -0
  492. package/lib/esm/node/agents/rag/rerank/node.js +103 -0
  493. package/lib/esm/node/agents/rag/rerank/node.js.map +1 -0
  494. package/lib/esm/node/agents/rag/retriever/node.js +111 -0
  495. package/lib/esm/node/agents/rag/retriever/node.js.map +1 -0
  496. package/lib/esm/node/agents/rag/structured-output-parser/node.js +112 -0
  497. package/lib/esm/node/agents/rag/structured-output-parser/node.js.map +1 -0
  498. package/lib/esm/node/agents/rag/vector-store/node.js +178 -0
  499. package/lib/esm/node/agents/rag/vector-store/node.js.map +1 -0
  500. package/lib/esm/node/agents/responses/discord/node.js +92 -0
  501. package/lib/esm/node/agents/responses/discord/node.js.map +1 -0
  502. package/lib/esm/node/agents/responses/slack/node.js +92 -0
  503. package/lib/esm/node/agents/responses/slack/node.js.map +1 -0
  504. package/lib/esm/node/agents/responses/teams/node.js +92 -0
  505. package/lib/esm/node/agents/responses/teams/node.js.map +1 -0
  506. package/lib/esm/node/agents/responses/telegram/node.js +92 -0
  507. package/lib/esm/node/agents/responses/telegram/node.js.map +1 -0
  508. package/lib/esm/node/agents/sandbox/node.js +125 -0
  509. package/lib/esm/node/agents/sandbox/node.js.map +1 -0
  510. package/lib/esm/node/agents/scorers/scorer/node.js +98 -0
  511. package/lib/esm/node/agents/scorers/scorer/node.js.map +1 -0
  512. package/lib/esm/node/agents/scorers/scorer-selector/node.js +91 -0
  513. package/lib/esm/node/agents/scorers/scorer-selector/node.js.map +1 -0
  514. package/lib/esm/node/agents/skills/skill/node.js +96 -0
  515. package/lib/esm/node/agents/skills/skill/node.js.map +1 -0
  516. package/lib/esm/node/agents/skills/skill-selector/node.js +89 -0
  517. package/lib/esm/node/agents/skills/skill-selector/node.js.map +1 -0
  518. package/lib/esm/node/agents/tools/tool/node.js +91 -0
  519. package/lib/esm/node/agents/tools/tool/node.js.map +1 -0
  520. package/lib/esm/node/agents/tools/tool-selector/node.js +90 -0
  521. package/lib/esm/node/agents/tools/tool-selector/node.js.map +1 -0
  522. package/lib/esm/node/agents/triggers/discord/node.js +92 -0
  523. package/lib/esm/node/agents/triggers/discord/node.js.map +1 -0
  524. package/lib/esm/node/agents/triggers/mcp-server/node.js +138 -0
  525. package/lib/esm/node/agents/triggers/mcp-server/node.js.map +1 -0
  526. package/lib/esm/node/agents/triggers/slack/node.js +92 -0
  527. package/lib/esm/node/agents/triggers/slack/node.js.map +1 -0
  528. package/lib/esm/node/agents/triggers/teams/node.js +92 -0
  529. package/lib/esm/node/agents/triggers/teams/node.js.map +1 -0
  530. package/lib/esm/node/agents/triggers/telegram/node.js +92 -0
  531. package/lib/esm/node/agents/triggers/telegram/node.js.map +1 -0
  532. package/lib/esm/node/agents/voice/node.js +98 -0
  533. package/lib/esm/node/agents/voice/node.js.map +1 -0
  534. package/lib/esm/node/agents/zones.js +39 -0
  535. package/lib/esm/node/agents/zones.js.map +1 -0
  536. package/lib/esm/node/comms/email-send/node.js +331 -0
  537. package/lib/esm/node/comms/email-send/node.js.map +1 -0
  538. package/lib/esm/node/comms/gmail/node.js +278 -0
  539. package/lib/esm/node/comms/gmail/node.js.map +1 -0
  540. package/lib/esm/node/comms/slack/node.js +267 -0
  541. package/lib/esm/node/comms/slack/node.js.map +1 -0
  542. package/lib/esm/node/comms/teams/node.js +222 -0
  543. package/lib/esm/node/comms/teams/node.js.map +1 -0
  544. package/lib/esm/node/comms/telegram/node.js +251 -0
  545. package/lib/esm/node/comms/telegram/node.js.map +1 -0
  546. package/lib/esm/node/credentials.js +96 -0
  547. package/lib/esm/node/credentials.js.map +1 -0
  548. package/lib/esm/node/data/data-table/node.js +256 -0
  549. package/lib/esm/node/data/data-table/node.js.map +1 -0
  550. package/lib/esm/node/data/date-time/node.js +171 -0
  551. package/lib/esm/node/data/date-time/node.js.map +1 -0
  552. package/lib/esm/node/data/filter/node.js +125 -0
  553. package/lib/esm/node/data/filter/node.js.map +1 -0
  554. package/lib/esm/node/data/limit/node.js +95 -0
  555. package/lib/esm/node/data/limit/node.js.map +1 -0
  556. package/lib/esm/node/data/merge/node.js +242 -0
  557. package/lib/esm/node/data/merge/node.js.map +1 -0
  558. package/lib/esm/node/data/rename-keys/node.js +130 -0
  559. package/lib/esm/node/data/rename-keys/node.js.map +1 -0
  560. package/lib/esm/node/data/set/node.js +139 -0
  561. package/lib/esm/node/data/set/node.js.map +1 -0
  562. package/lib/esm/node/data/sort/node.js +116 -0
  563. package/lib/esm/node/data/sort/node.js.map +1 -0
  564. package/lib/esm/node/data/split-out/node.js +131 -0
  565. package/lib/esm/node/data/split-out/node.js.map +1 -0
  566. package/lib/esm/node/data/support.js +382 -0
  567. package/lib/esm/node/data/support.js.map +1 -0
  568. package/lib/esm/node/devops/crypto/node.js +355 -0
  569. package/lib/esm/node/devops/crypto/node.js.map +1 -0
  570. package/lib/esm/node/devops/execute-command/node.js +192 -0
  571. package/lib/esm/node/devops/execute-command/node.js.map +1 -0
  572. package/lib/esm/node/devops/ftp/node.js +232 -0
  573. package/lib/esm/node/devops/ftp/node.js.map +1 -0
  574. package/lib/esm/node/devops/github/node.js +273 -0
  575. package/lib/esm/node/devops/github/node.js.map +1 -0
  576. package/lib/esm/node/devops/gitlab/node.js +264 -0
  577. package/lib/esm/node/devops/gitlab/node.js.map +1 -0
  578. package/lib/esm/node/devops/jwt/node.js +195 -0
  579. package/lib/esm/node/devops/jwt/node.js.map +1 -0
  580. package/lib/esm/node/flow/execute-sub-workflow/node.js +214 -0
  581. package/lib/esm/node/flow/execute-sub-workflow/node.js.map +1 -0
  582. package/lib/esm/node/index.js +338 -2
  583. package/lib/esm/node/index.js.map +1 -1
  584. package/lib/esm/node/io/airtable/node.js +309 -0
  585. package/lib/esm/node/io/airtable/node.js.map +1 -0
  586. package/lib/esm/node/io/extract-from-file/node.js +260 -0
  587. package/lib/esm/node/io/extract-from-file/node.js.map +1 -0
  588. package/lib/esm/node/io/google-sheets/node.js +258 -0
  589. package/lib/esm/node/io/google-sheets/node.js.map +1 -0
  590. package/lib/esm/node/io/graphql/node.js +160 -0
  591. package/lib/esm/node/io/graphql/node.js.map +1 -0
  592. package/lib/esm/node/io/http-request/node.js +406 -0
  593. package/lib/esm/node/io/http-request/node.js.map +1 -0
  594. package/lib/esm/node/io/read-pdf/node.js +164 -0
  595. package/lib/esm/node/io/read-pdf/node.js.map +1 -0
  596. package/lib/esm/node/io/read-write-file/node.js +305 -0
  597. package/lib/esm/node/io/read-write-file/node.js.map +1 -0
  598. package/lib/esm/node/io/respond-to-webhook/node.js +174 -0
  599. package/lib/esm/node/io/respond-to-webhook/node.js.map +1 -0
  600. package/lib/esm/node/io/spreadsheet-file/node.js +183 -0
  601. package/lib/esm/node/io/spreadsheet-file/node.js.map +1 -0
  602. package/lib/esm/node/manifests.js +228 -0
  603. package/lib/esm/node/manifests.js.map +1 -1
  604. package/lib/esm/node/storage/blob/azure/node.js +129 -0
  605. package/lib/esm/node/storage/blob/azure/node.js.map +1 -0
  606. package/lib/esm/node/storage/blob/base.js +311 -0
  607. package/lib/esm/node/storage/blob/base.js.map +1 -0
  608. package/lib/esm/node/storage/blob/gcs/node.js +117 -0
  609. package/lib/esm/node/storage/blob/gcs/node.js.map +1 -0
  610. package/lib/esm/node/storage/blob/s3/node.js +176 -0
  611. package/lib/esm/node/storage/blob/s3/node.js.map +1 -0
  612. package/lib/esm/node/storage/database/base.js +291 -0
  613. package/lib/esm/node/storage/database/base.js.map +1 -0
  614. package/lib/esm/node/storage/database/mssql/node.js +42 -0
  615. package/lib/esm/node/storage/database/mssql/node.js.map +1 -0
  616. package/lib/esm/node/storage/database/mysql/node.js +42 -0
  617. package/lib/esm/node/storage/database/mysql/node.js.map +1 -0
  618. package/lib/esm/node/storage/database/postgres/node.js +42 -0
  619. package/lib/esm/node/storage/database/postgres/node.js.map +1 -0
  620. package/lib/esm/node/storage/redis/node.js +331 -0
  621. package/lib/esm/node/storage/redis/node.js.map +1 -0
  622. package/lib/esm/node/storage/support.js +69 -0
  623. package/lib/esm/node/storage/support.js.map +1 -0
  624. package/lib/esm/node/triggers/execute-workflow/node.js +85 -0
  625. package/lib/esm/node/triggers/execute-workflow/node.js.map +1 -0
  626. package/lib/esm/ram/GraphNodeRepository.js +31 -0
  627. package/lib/esm/ram/GraphNodeRepository.js.map +1 -0
  628. package/lib/esm/ram/GraphRunEventModel.js +5 -1
  629. package/lib/esm/ram/GraphRunEventModel.js.map +1 -1
  630. package/lib/esm/ram/index.js +1 -0
  631. package/lib/esm/ram/index.js.map +1 -1
  632. package/lib/esm/shared/graph/GraphNodeConverters.js +38 -0
  633. package/lib/esm/shared/graph/GraphNodeConverters.js.map +1 -0
  634. package/lib/esm/shared/graph/GraphNodeModel.js +69 -0
  635. package/lib/esm/shared/graph/GraphNodeModel.js.map +1 -0
  636. package/lib/esm/shared/graph/GraphWorkflowModel.js +5 -1
  637. package/lib/esm/shared/graph/GraphWorkflowModel.js.map +1 -1
  638. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +40 -0
  639. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  640. package/lib/esm/shared/graph/catalog/GraphPortManifest.js.map +1 -1
  641. package/lib/esm/shared/graph/category-styles.js +12 -0
  642. package/lib/esm/shared/graph/category-styles.js.map +1 -1
  643. package/lib/esm/shared/graph/constants.js.map +1 -1
  644. package/lib/esm/shared/graph/index.js +2 -0
  645. package/lib/esm/shared/graph/index.js.map +1 -1
  646. package/lib/esm/typeorm/TypeormGraphAdapter.js +213 -0
  647. package/lib/esm/typeorm/TypeormGraphAdapter.js.map +1 -0
  648. package/lib/esm/typeorm/index.js +12 -0
  649. package/lib/esm/typeorm/index.js.map +1 -0
  650. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +40 -4
  651. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +40 -4
  652. package/lib/types/engine/auth/GraphAuthValidator.d.cts +13 -0
  653. package/lib/types/engine/auth/GraphAuthValidator.d.mts +13 -0
  654. package/lib/types/engine/constants.d.cts +60 -0
  655. package/lib/types/engine/constants.d.mts +60 -0
  656. package/lib/types/engine/credentials/GraphNodeCredentials.d.cts +145 -0
  657. package/lib/types/engine/credentials/GraphNodeCredentials.d.mts +145 -0
  658. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +27 -0
  659. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +27 -0
  660. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +97 -1
  661. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +97 -1
  662. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.cts +24 -0
  663. package/lib/types/engine/execution/GraphNodeEngineRequirements.d.mts +24 -0
  664. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.cts +67 -0
  665. package/lib/types/engine/execution/GraphWebhookResponseRegistry.d.mts +67 -0
  666. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +26 -3
  667. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +26 -3
  668. package/lib/types/engine/execution/index.d.cts +1 -0
  669. package/lib/types/engine/execution/index.d.mts +1 -0
  670. package/lib/types/engine/index.d.cts +5 -0
  671. package/lib/types/engine/index.d.mts +5 -0
  672. package/lib/types/engine/services/GraphNodeModelService.d.cts +54 -0
  673. package/lib/types/engine/services/GraphNodeModelService.d.mts +54 -0
  674. package/lib/types/engine/services/GraphWorkflowService.d.cts +21 -0
  675. package/lib/types/engine/services/GraphWorkflowService.d.mts +21 -0
  676. package/lib/types/engine/store/GraphDataTableModel.d.cts +24 -0
  677. package/lib/types/engine/store/GraphDataTableModel.d.mts +24 -0
  678. package/lib/types/engine/store/GraphDataTableRepository.d.cts +136 -0
  679. package/lib/types/engine/store/GraphDataTableRepository.d.mts +136 -0
  680. package/lib/types/engine/store/index.d.cts +2 -0
  681. package/lib/types/engine/store/index.d.mts +2 -0
  682. package/lib/types/engine/types.d.cts +12 -0
  683. package/lib/types/engine/types.d.mts +12 -0
  684. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.cts +10 -0
  685. package/lib/types/engine/validation/GraphConnectionPolicyValidator.d.mts +10 -0
  686. package/lib/types/engine/validation/GraphParameterValidator.d.cts +1 -1
  687. package/lib/types/engine/validation/GraphParameterValidator.d.mts +1 -1
  688. package/lib/types/mastra/MastraAgeVectorDriver.d.cts +55 -0
  689. package/lib/types/mastra/MastraAgeVectorDriver.d.mts +55 -0
  690. package/lib/types/mastra/MastraAgentBuilder.d.cts +188 -0
  691. package/lib/types/mastra/MastraAgentBuilder.d.mts +188 -0
  692. package/lib/types/mastra/MastraAgentModelAdapter.d.cts +76 -0
  693. package/lib/types/mastra/MastraAgentModelAdapter.d.mts +76 -0
  694. package/lib/types/mastra/MastraAgentProcessors.d.cts +50 -0
  695. package/lib/types/mastra/MastraAgentProcessors.d.mts +50 -0
  696. package/lib/types/mastra/MastraAgentStepHandler.d.cts +128 -0
  697. package/lib/types/mastra/MastraAgentStepHandler.d.mts +128 -0
  698. package/lib/types/mastra/MastraCapabilities.d.cts +20 -0
  699. package/lib/types/mastra/MastraCapabilities.d.mts +20 -0
  700. package/lib/types/mastra/MastraChannelResponse.d.cts +64 -0
  701. package/lib/types/mastra/MastraChannelResponse.d.mts +64 -0
  702. package/lib/types/mastra/MastraChannelTrigger.d.cts +57 -0
  703. package/lib/types/mastra/MastraChannelTrigger.d.mts +57 -0
  704. package/lib/types/mastra/MastraDefaultStepHandlers.d.cts +121 -0
  705. package/lib/types/mastra/MastraDefaultStepHandlers.d.mts +121 -0
  706. package/lib/types/mastra/MastraEnvironment.d.cts +270 -0
  707. package/lib/types/mastra/MastraEnvironment.d.mts +270 -0
  708. package/lib/types/mastra/MastraEvalModels.d.cts +191 -0
  709. package/lib/types/mastra/MastraEvalModels.d.mts +191 -0
  710. package/lib/types/mastra/MastraEventBridge.d.cts +17 -0
  711. package/lib/types/mastra/MastraEventBridge.d.mts +17 -0
  712. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +137 -1
  713. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +137 -1
  714. package/lib/types/mastra/MastraGraphExecutionModule.d.cts +114 -0
  715. package/lib/types/mastra/MastraGraphExecutionModule.d.mts +114 -0
  716. package/lib/types/mastra/MastraHitlStepHandler.d.cts +18 -0
  717. package/lib/types/mastra/MastraHitlStepHandler.d.mts +18 -0
  718. package/lib/types/mastra/MastraMcpTrigger.d.cts +133 -0
  719. package/lib/types/mastra/MastraMcpTrigger.d.mts +133 -0
  720. package/lib/types/mastra/MastraMemory.d.cts +362 -0
  721. package/lib/types/mastra/MastraMemory.d.mts +362 -0
  722. package/lib/types/mastra/MastraMetricsAdapter.d.cts +216 -0
  723. package/lib/types/mastra/MastraMetricsAdapter.d.mts +216 -0
  724. package/lib/types/mastra/MastraMetricsGateway.d.cts +265 -0
  725. package/lib/types/mastra/MastraMetricsGateway.d.mts +265 -0
  726. package/lib/types/mastra/MastraMetricsModels.d.cts +175 -0
  727. package/lib/types/mastra/MastraMetricsModels.d.mts +175 -0
  728. package/lib/types/mastra/MastraMetricsStatement.d.cts +116 -0
  729. package/lib/types/mastra/MastraMetricsStatement.d.mts +116 -0
  730. package/lib/types/mastra/MastraModelSchemaConverter.d.cts +45 -0
  731. package/lib/types/mastra/MastraModelSchemaConverter.d.mts +45 -0
  732. package/lib/types/mastra/MastraObservability.d.cts +197 -0
  733. package/lib/types/mastra/MastraObservability.d.mts +197 -0
  734. package/lib/types/mastra/MastraPersistence.d.cts +241 -0
  735. package/lib/types/mastra/MastraPersistence.d.mts +241 -0
  736. package/lib/types/mastra/MastraRagStepHandlers.d.cts +137 -0
  737. package/lib/types/mastra/MastraRagStepHandlers.d.mts +137 -0
  738. package/lib/types/mastra/MastraRunMetricsEndpoint.d.cts +53 -0
  739. package/lib/types/mastra/MastraRunMetricsEndpoint.d.mts +53 -0
  740. package/lib/types/mastra/MastraRunRecovery.d.cts +26 -0
  741. package/lib/types/mastra/MastraRunRecovery.d.mts +26 -0
  742. package/lib/types/mastra/MastraScheduleTrigger.d.cts +20 -0
  743. package/lib/types/mastra/MastraScheduleTrigger.d.mts +20 -0
  744. package/lib/types/mastra/MastraStorageWiring.d.cts +71 -0
  745. package/lib/types/mastra/MastraStorageWiring.d.mts +71 -0
  746. package/lib/types/mastra/MastraStructuredOutput.d.cts +165 -0
  747. package/lib/types/mastra/MastraStructuredOutput.d.mts +165 -0
  748. package/lib/types/mastra/MastraToolBuilder.d.cts +70 -0
  749. package/lib/types/mastra/MastraToolBuilder.d.mts +70 -0
  750. package/lib/types/mastra/MastraToolConfig.d.cts +136 -0
  751. package/lib/types/mastra/MastraToolConfig.d.mts +136 -0
  752. package/lib/types/mastra/MastraToolDecorator.d.cts +47 -0
  753. package/lib/types/mastra/MastraToolDecorator.d.mts +47 -0
  754. package/lib/types/mastra/MastraVectorStore.d.cts +383 -0
  755. package/lib/types/mastra/MastraVectorStore.d.mts +383 -0
  756. package/lib/types/mastra/MastraVoiceStepHandler.d.cts +40 -0
  757. package/lib/types/mastra/MastraVoiceStepHandler.d.mts +40 -0
  758. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +3 -3
  759. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +3 -3
  760. package/lib/types/mastra/MastraWorkflowManager.d.cts +36 -28
  761. package/lib/types/mastra/MastraWorkflowManager.d.mts +36 -28
  762. package/lib/types/mastra/index.d.cts +41 -1
  763. package/lib/types/mastra/index.d.mts +41 -1
  764. package/lib/types/mastra/nodes/MastraNodeRegistry.d.cts +41 -0
  765. package/lib/types/mastra/nodes/MastraNodeRegistry.d.mts +41 -0
  766. package/lib/types/mastra/nodes/index.d.cts +11 -0
  767. package/lib/types/mastra/nodes/index.d.mts +11 -0
  768. package/lib/types/mastra/nodes/types.d.cts +57 -0
  769. package/lib/types/mastra/nodes/types.d.mts +57 -0
  770. package/lib/types/mastra/types.d.cts +377 -6
  771. package/lib/types/mastra/types.d.mts +377 -6
  772. package/lib/types/nest/graph/GraphBackendHost.d.cts +52 -0
  773. package/lib/types/nest/graph/GraphBackendHost.d.mts +52 -0
  774. package/lib/types/nest/graph/GraphExecutionModule.d.cts +28 -0
  775. package/lib/types/nest/graph/GraphExecutionModule.d.mts +28 -0
  776. package/lib/types/nest/graph/GraphRunController.d.cts +24 -4
  777. package/lib/types/nest/graph/GraphRunController.d.mts +24 -4
  778. package/lib/types/node/agents/agent/node.d.cts +72 -16
  779. package/lib/types/node/agents/agent/node.d.mts +72 -16
  780. package/lib/types/node/agents/hitl/node.d.cts +45 -0
  781. package/lib/types/node/agents/hitl/node.d.mts +45 -0
  782. package/lib/types/node/agents/hooks/delegation/node.d.cts +48 -0
  783. package/lib/types/node/agents/hooks/delegation/node.d.mts +48 -0
  784. package/lib/types/node/agents/hooks/hook/node.d.cts +45 -0
  785. package/lib/types/node/agents/hooks/hook/node.d.mts +45 -0
  786. package/lib/types/node/agents/hooks/tool-deny/node.d.cts +39 -0
  787. package/lib/types/node/agents/hooks/tool-deny/node.d.mts +39 -0
  788. package/lib/types/node/agents/memory/memory/node.d.cts +73 -0
  789. package/lib/types/node/agents/memory/memory/node.d.mts +73 -0
  790. package/lib/types/node/agents/memory/memory-selector/node.d.cts +34 -0
  791. package/lib/types/node/agents/memory/memory-selector/node.d.mts +34 -0
  792. package/lib/types/node/agents/processors/guardrail/node.d.cts +47 -0
  793. package/lib/types/node/agents/processors/guardrail/node.d.mts +47 -0
  794. package/lib/types/node/agents/processors/input-processor/node.d.cts +40 -0
  795. package/lib/types/node/agents/processors/input-processor/node.d.mts +40 -0
  796. package/lib/types/node/agents/processors/output-processor/node.d.cts +34 -0
  797. package/lib/types/node/agents/processors/output-processor/node.d.mts +34 -0
  798. package/lib/types/node/agents/processors/types.d.cts +45 -0
  799. package/lib/types/node/agents/processors/types.d.mts +45 -0
  800. package/lib/types/node/agents/rag/chains/basic/node.d.cts +36 -0
  801. package/lib/types/node/agents/rag/chains/basic/node.d.mts +36 -0
  802. package/lib/types/node/agents/rag/chains/qa/node.d.cts +44 -0
  803. package/lib/types/node/agents/rag/chains/qa/node.d.mts +44 -0
  804. package/lib/types/node/agents/rag/chains/summarization/node.d.cts +39 -0
  805. package/lib/types/node/agents/rag/chains/summarization/node.d.mts +39 -0
  806. package/lib/types/node/agents/rag/chunking/node.d.cts +73 -0
  807. package/lib/types/node/agents/rag/chunking/node.d.mts +73 -0
  808. package/lib/types/node/agents/rag/embedding/node.d.cts +37 -0
  809. package/lib/types/node/agents/rag/embedding/node.d.mts +37 -0
  810. package/lib/types/node/agents/rag/information-extractor/node.d.cts +39 -0
  811. package/lib/types/node/agents/rag/information-extractor/node.d.mts +39 -0
  812. package/lib/types/node/agents/rag/langchain-code/node.d.cts +36 -0
  813. package/lib/types/node/agents/rag/langchain-code/node.d.mts +36 -0
  814. package/lib/types/node/agents/rag/rerank/node.d.cts +39 -0
  815. package/lib/types/node/agents/rag/rerank/node.d.mts +39 -0
  816. package/lib/types/node/agents/rag/retriever/node.d.cts +42 -0
  817. package/lib/types/node/agents/rag/retriever/node.d.mts +42 -0
  818. package/lib/types/node/agents/rag/structured-output-parser/node.d.cts +35 -0
  819. package/lib/types/node/agents/rag/structured-output-parser/node.d.mts +35 -0
  820. package/lib/types/node/agents/rag/vector-store/node.d.cts +59 -0
  821. package/lib/types/node/agents/rag/vector-store/node.d.mts +59 -0
  822. package/lib/types/node/agents/responses/discord/node.d.cts +34 -0
  823. package/lib/types/node/agents/responses/discord/node.d.mts +34 -0
  824. package/lib/types/node/agents/responses/slack/node.d.cts +34 -0
  825. package/lib/types/node/agents/responses/slack/node.d.mts +34 -0
  826. package/lib/types/node/agents/responses/teams/node.d.cts +34 -0
  827. package/lib/types/node/agents/responses/teams/node.d.mts +34 -0
  828. package/lib/types/node/agents/responses/telegram/node.d.cts +34 -0
  829. package/lib/types/node/agents/responses/telegram/node.d.mts +34 -0
  830. package/lib/types/node/agents/sandbox/node.d.cts +47 -0
  831. package/lib/types/node/agents/sandbox/node.d.mts +47 -0
  832. package/lib/types/node/agents/scorers/scorer/node.d.cts +33 -0
  833. package/lib/types/node/agents/scorers/scorer/node.d.mts +33 -0
  834. package/lib/types/node/agents/scorers/scorer-selector/node.d.cts +33 -0
  835. package/lib/types/node/agents/scorers/scorer-selector/node.d.mts +33 -0
  836. package/lib/types/node/agents/skills/skill/node.d.cts +32 -0
  837. package/lib/types/node/agents/skills/skill/node.d.mts +32 -0
  838. package/lib/types/node/agents/skills/skill-selector/node.d.cts +33 -0
  839. package/lib/types/node/agents/skills/skill-selector/node.d.mts +33 -0
  840. package/lib/types/node/agents/tools/tool/node.d.cts +33 -0
  841. package/lib/types/node/agents/tools/tool/node.d.mts +33 -0
  842. package/lib/types/node/agents/tools/tool-selector/node.d.cts +33 -0
  843. package/lib/types/node/agents/tools/tool-selector/node.d.mts +33 -0
  844. package/lib/types/node/agents/triggers/discord/node.d.cts +40 -0
  845. package/lib/types/node/agents/triggers/discord/node.d.mts +40 -0
  846. package/lib/types/node/agents/triggers/mcp-server/node.d.cts +51 -0
  847. package/lib/types/node/agents/triggers/mcp-server/node.d.mts +51 -0
  848. package/lib/types/node/agents/triggers/slack/node.d.cts +40 -0
  849. package/lib/types/node/agents/triggers/slack/node.d.mts +40 -0
  850. package/lib/types/node/agents/triggers/teams/node.d.cts +40 -0
  851. package/lib/types/node/agents/triggers/teams/node.d.mts +40 -0
  852. package/lib/types/node/agents/triggers/telegram/node.d.cts +40 -0
  853. package/lib/types/node/agents/triggers/telegram/node.d.mts +40 -0
  854. package/lib/types/node/agents/voice/node.d.cts +34 -0
  855. package/lib/types/node/agents/voice/node.d.mts +34 -0
  856. package/lib/types/node/agents/zones.d.cts +30 -0
  857. package/lib/types/node/agents/zones.d.mts +30 -0
  858. package/lib/types/node/comms/email-send/node.d.cts +85 -0
  859. package/lib/types/node/comms/email-send/node.d.mts +85 -0
  860. package/lib/types/node/comms/gmail/node.d.cts +67 -0
  861. package/lib/types/node/comms/gmail/node.d.mts +67 -0
  862. package/lib/types/node/comms/slack/node.d.cts +65 -0
  863. package/lib/types/node/comms/slack/node.d.mts +65 -0
  864. package/lib/types/node/comms/teams/node.d.cts +49 -0
  865. package/lib/types/node/comms/teams/node.d.mts +49 -0
  866. package/lib/types/node/comms/telegram/node.d.cts +61 -0
  867. package/lib/types/node/comms/telegram/node.d.mts +61 -0
  868. package/lib/types/node/credentials.d.cts +43 -0
  869. package/lib/types/node/credentials.d.mts +43 -0
  870. package/lib/types/node/data/data-table/node.d.cts +86 -0
  871. package/lib/types/node/data/data-table/node.d.mts +86 -0
  872. package/lib/types/node/data/date-time/node.d.cts +49 -0
  873. package/lib/types/node/data/date-time/node.d.mts +49 -0
  874. package/lib/types/node/data/filter/node.d.cts +31 -0
  875. package/lib/types/node/data/filter/node.d.mts +31 -0
  876. package/lib/types/node/data/limit/node.d.cts +28 -0
  877. package/lib/types/node/data/limit/node.d.mts +28 -0
  878. package/lib/types/node/data/merge/node.d.cts +63 -0
  879. package/lib/types/node/data/merge/node.d.mts +63 -0
  880. package/lib/types/node/data/rename-keys/node.d.cts +35 -0
  881. package/lib/types/node/data/rename-keys/node.d.mts +35 -0
  882. package/lib/types/node/data/set/node.d.cts +52 -0
  883. package/lib/types/node/data/set/node.d.mts +52 -0
  884. package/lib/types/node/data/sort/node.d.cts +40 -0
  885. package/lib/types/node/data/sort/node.d.mts +40 -0
  886. package/lib/types/node/data/split-out/node.d.cts +30 -0
  887. package/lib/types/node/data/split-out/node.d.mts +30 -0
  888. package/lib/types/node/data/support.d.cts +164 -0
  889. package/lib/types/node/data/support.d.mts +164 -0
  890. package/lib/types/node/devops/crypto/node.d.cts +65 -0
  891. package/lib/types/node/devops/crypto/node.d.mts +65 -0
  892. package/lib/types/node/devops/execute-command/node.d.cts +55 -0
  893. package/lib/types/node/devops/execute-command/node.d.mts +55 -0
  894. package/lib/types/node/devops/ftp/node.d.cts +55 -0
  895. package/lib/types/node/devops/ftp/node.d.mts +55 -0
  896. package/lib/types/node/devops/github/node.d.cts +61 -0
  897. package/lib/types/node/devops/github/node.d.mts +61 -0
  898. package/lib/types/node/devops/gitlab/node.d.cts +61 -0
  899. package/lib/types/node/devops/gitlab/node.d.mts +61 -0
  900. package/lib/types/node/devops/jwt/node.d.cts +53 -0
  901. package/lib/types/node/devops/jwt/node.d.mts +53 -0
  902. package/lib/types/node/flow/execute-sub-workflow/node.d.cts +63 -0
  903. package/lib/types/node/flow/execute-sub-workflow/node.d.mts +63 -0
  904. package/lib/types/node/index.d.cts +182 -2
  905. package/lib/types/node/index.d.mts +182 -2
  906. package/lib/types/node/io/airtable/node.d.cts +73 -0
  907. package/lib/types/node/io/airtable/node.d.mts +73 -0
  908. package/lib/types/node/io/extract-from-file/node.d.cts +38 -0
  909. package/lib/types/node/io/extract-from-file/node.d.mts +38 -0
  910. package/lib/types/node/io/google-sheets/node.d.cts +77 -0
  911. package/lib/types/node/io/google-sheets/node.d.mts +77 -0
  912. package/lib/types/node/io/graphql/node.d.cts +46 -0
  913. package/lib/types/node/io/graphql/node.d.mts +46 -0
  914. package/lib/types/node/io/http-request/node.d.cts +107 -0
  915. package/lib/types/node/io/http-request/node.d.mts +107 -0
  916. package/lib/types/node/io/read-pdf/node.d.cts +40 -0
  917. package/lib/types/node/io/read-pdf/node.d.mts +40 -0
  918. package/lib/types/node/io/read-write-file/node.d.cts +41 -0
  919. package/lib/types/node/io/read-write-file/node.d.mts +41 -0
  920. package/lib/types/node/io/respond-to-webhook/node.d.cts +45 -0
  921. package/lib/types/node/io/respond-to-webhook/node.d.mts +45 -0
  922. package/lib/types/node/io/spreadsheet-file/node.d.cts +51 -0
  923. package/lib/types/node/io/spreadsheet-file/node.d.mts +51 -0
  924. package/lib/types/node/storage/blob/azure/node.d.cts +27 -0
  925. package/lib/types/node/storage/blob/azure/node.d.mts +27 -0
  926. package/lib/types/node/storage/blob/base.d.cts +83 -0
  927. package/lib/types/node/storage/blob/base.d.mts +83 -0
  928. package/lib/types/node/storage/blob/gcs/node.d.cts +27 -0
  929. package/lib/types/node/storage/blob/gcs/node.d.mts +27 -0
  930. package/lib/types/node/storage/blob/s3/node.d.cts +39 -0
  931. package/lib/types/node/storage/blob/s3/node.d.mts +39 -0
  932. package/lib/types/node/storage/database/base.d.cts +97 -0
  933. package/lib/types/node/storage/database/base.d.mts +97 -0
  934. package/lib/types/node/storage/database/mssql/node.d.cts +8 -0
  935. package/lib/types/node/storage/database/mssql/node.d.mts +8 -0
  936. package/lib/types/node/storage/database/mysql/node.d.cts +8 -0
  937. package/lib/types/node/storage/database/mysql/node.d.mts +8 -0
  938. package/lib/types/node/storage/database/postgres/node.d.cts +8 -0
  939. package/lib/types/node/storage/database/postgres/node.d.mts +8 -0
  940. package/lib/types/node/storage/redis/node.d.cts +68 -0
  941. package/lib/types/node/storage/redis/node.d.mts +68 -0
  942. package/lib/types/node/storage/support.d.cts +36 -0
  943. package/lib/types/node/storage/support.d.mts +36 -0
  944. package/lib/types/node/triggers/execute-workflow/node.d.cts +25 -0
  945. package/lib/types/node/triggers/execute-workflow/node.d.mts +25 -0
  946. package/lib/types/ram/GraphNodeRepository.d.cts +13 -0
  947. package/lib/types/ram/GraphNodeRepository.d.mts +13 -0
  948. package/lib/types/ram/GraphRunEventModel.d.cts +6 -0
  949. package/lib/types/ram/GraphRunEventModel.d.mts +6 -0
  950. package/lib/types/ram/index.d.cts +1 -0
  951. package/lib/types/ram/index.d.mts +1 -0
  952. package/lib/types/shared/graph/GraphNodeConverters.d.cts +15 -0
  953. package/lib/types/shared/graph/GraphNodeConverters.d.mts +15 -0
  954. package/lib/types/shared/graph/GraphNodeModel.d.cts +30 -0
  955. package/lib/types/shared/graph/GraphNodeModel.d.mts +30 -0
  956. package/lib/types/shared/graph/GraphWorkflowModel.d.cts +6 -0
  957. package/lib/types/shared/graph/GraphWorkflowModel.d.mts +6 -0
  958. package/lib/types/shared/graph/catalog/GraphPortManifest.d.cts +7 -0
  959. package/lib/types/shared/graph/catalog/GraphPortManifest.d.mts +7 -0
  960. package/lib/types/shared/graph/constants.d.cts +39 -0
  961. package/lib/types/shared/graph/constants.d.mts +39 -0
  962. package/lib/types/shared/graph/index.d.cts +2 -0
  963. package/lib/types/shared/graph/index.d.mts +2 -0
  964. package/lib/types/typeorm/TypeormGraphAdapter.d.cts +32 -0
  965. package/lib/types/typeorm/TypeormGraphAdapter.d.mts +32 -0
  966. package/lib/types/typeorm/index.d.cts +11 -0
  967. package/lib/types/typeorm/index.d.mts +11 -0
  968. package/package.json +59 -13
@@ -0,0 +1,116 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraMetricsStatement
3
+ * @summary Dedicated Decaf statement + paginator over the mastra metrics
4
+ * adapter (SAA-836 S2).
5
+ * @description The statement builds the raw {@link MastraMetricsQuery} the
6
+ * read-only adapter executes against the real mastra storage, and the paginator
7
+ * pages its results with mastra-native pagination where the domain supports it.
8
+ * Both fail closed: unsupported attributes, operators, or orderings raise a
9
+ * `QueryError` instead of silently degrading the query.
10
+ */
11
+ import { Condition, Statement, Paginator, type AdapterFlags, type Context, type ContextualArgs } from "@decaf-ts/core";
12
+ import { Model } from "@decaf-ts/decorator-validation";
13
+ import type { Constructor } from "@decaf-ts/decoration";
14
+ import type { MastraMetricModel } from "./MastraMetricsModels.d.cts";
15
+ import type { MastraMetricsAdapter, MastraMetricsQuery } from "./MastraMetricsAdapter.d.cts";
16
+ /**
17
+ * Maps a metric model class onto the mastra storage kind its query targets.
18
+ *
19
+ * @param clazz - The metric model class to map.
20
+ * @returns The mastra storage kind (`runs`, `scores`, or `traces`).
21
+ * @throws {QueryError} when the class is not one of the three metric models.
22
+ */
23
+ export declare function mastraMetricsKindOf(clazz: Constructor<MastraMetricModel>): "runs" | "scores" | "traces";
24
+ /**
25
+ * Dedicated read-only statement over the mastra metrics adapter (SAA-836 S2).
26
+ *
27
+ * `from()` selects one of the three metric models, `where()` accepts only the
28
+ * documented filterable attributes of the selected kind, and `execute()`
29
+ * delegates to the adapter's real mastra storage read. `paginate(size)` returns
30
+ * a {@link MastraMetricsPaginator} that serves the query pages.
31
+ */
32
+ export declare class MastraMetricsStatement<M extends Model> extends Statement<M, MastraMetricsAdapter, M[], MastraMetricsQuery> {
33
+ /** The canonical workflow id (mastra workflow_name) the query is scoped to. */
34
+ private metricsWorkflowName?;
35
+ /** The optional run id the query is narrowed to (scores/traces). */
36
+ private metricsRunId?;
37
+ /**
38
+ * Builds the statement over the read-only metrics adapter.
39
+ *
40
+ * @param adapter - The mastra metrics adapter the statement executes against.
41
+ * @param overrides - Optional adapter flag overrides.
42
+ */
43
+ constructor(adapter: MastraMetricsAdapter, overrides?: Partial<AdapterFlags>);
44
+ /**
45
+ * Scopes the statement to one canonical workflow (mastra storage
46
+ * workflow_name). The caller (the metrics gateway) has already resolved the
47
+ * workflow's ownership; the statement only carries the scope.
48
+ *
49
+ * @param workflowId - The canonical workflow id to scope the query to.
50
+ * @returns This statement, for chaining.
51
+ */
52
+ forWorkflow(workflowId: string): this;
53
+ /**
54
+ * Narrows the statement to one mastra run (required for score and trace
55
+ * reads, which mastra serves per run).
56
+ *
57
+ * @param runId - The mastra run id to narrow to.
58
+ * @returns This statement, for chaining.
59
+ */
60
+ forRun(runId: string): this;
61
+ /**
62
+ * Parses the statement's single `where` condition into its query fragment.
63
+ * Only equality on a documented filterable attribute of the selected kind is
64
+ * accepted; everything else fails closed.
65
+ *
66
+ * @param condition - The decaf condition built by the statement chain.
67
+ * @returns The query fragment carrying the validated status filter.
68
+ * @throws {QueryError} when the operator is not `eq`, the attribute is not filterable for the kind, or the comparison is not a non-empty string.
69
+ */
70
+ protected parseCondition(condition: Condition<M>): MastraMetricsQuery;
71
+ /**
72
+ * Builds the raw {@link MastraMetricsQuery} the adapter executes. Rejects
73
+ * aggregations, grouping, distinct, and non-`createdAt` orderings; the
74
+ * workflow scope and optional run narrowing are appended to the parsed
75
+ * condition fragment, and decaf `limit`/`offset` map onto the mastra-native
76
+ * `perPage`/`page`.
77
+ *
78
+ * @returns The raw metrics query.
79
+ * @throws {QueryError} when the statement uses an unsupported shape.
80
+ */
81
+ protected build(): MastraMetricsQuery;
82
+ }
83
+ /**
84
+ * Dedicated paginator over the mastra metrics adapter (SAA-836 S2). Pages are
85
+ * mastra-native: the paginator maps the one-indexed decaf page onto the
86
+ * zero-indexed mastra page and derives the record count and page total from
87
+ * the storage response. R7: a page never resolves to nil rows — an empty
88
+ * result is an empty array, never null/undefined.
89
+ */
90
+ export declare class MastraMetricsPaginator<M extends Model> extends Paginator<M, M[], MastraMetricsQuery> {
91
+ /**
92
+ * Builds the paginator over the read-only metrics adapter.
93
+ *
94
+ * @param adapter - The mastra metrics adapter the paginator reads through.
95
+ * @param query - The raw metrics query to page over.
96
+ * @param size - Records per page.
97
+ * @param clazz - The metric model class being paged.
98
+ */
99
+ constructor(adapter: MastraMetricsAdapter, query: MastraMetricsQuery, size: number, clazz: Constructor<M>);
100
+ /**
101
+ * Copies the raw query unmodified: the mastra query already carries the
102
+ * mastra-native pagination fields the adapter expects.
103
+ *
104
+ * @param rawStatement - The query the paginator was built with.
105
+ * @returns The prepared query.
106
+ */
107
+ protected prepare(rawStatement: MastraMetricsQuery): MastraMetricsQuery;
108
+ /**
109
+ * Reads one page through the adapter's real mastra storage read.
110
+ *
111
+ * @param page - The one-indexed page number to read.
112
+ * @returns The page's model rows, newest first as mastra returns them.
113
+ * @throws {PagingError} when the page is out of the known range.
114
+ */
115
+ page(page?: number, ...args: ContextualArgs<Context>): Promise<M[]>;
116
+ }
@@ -0,0 +1,116 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraMetricsStatement
3
+ * @summary Dedicated Decaf statement + paginator over the mastra metrics
4
+ * adapter (SAA-836 S2).
5
+ * @description The statement builds the raw {@link MastraMetricsQuery} the
6
+ * read-only adapter executes against the real mastra storage, and the paginator
7
+ * pages its results with mastra-native pagination where the domain supports it.
8
+ * Both fail closed: unsupported attributes, operators, or orderings raise a
9
+ * `QueryError` instead of silently degrading the query.
10
+ */
11
+ import { Condition, Statement, Paginator, type AdapterFlags, type Context, type ContextualArgs } from "@decaf-ts/core";
12
+ import { Model } from "@decaf-ts/decorator-validation";
13
+ import type { Constructor } from "@decaf-ts/decoration";
14
+ import type { MastraMetricModel } from "./MastraMetricsModels.d.mts";
15
+ import type { MastraMetricsAdapter, MastraMetricsQuery } from "./MastraMetricsAdapter.d.mts";
16
+ /**
17
+ * Maps a metric model class onto the mastra storage kind its query targets.
18
+ *
19
+ * @param clazz - The metric model class to map.
20
+ * @returns The mastra storage kind (`runs`, `scores`, or `traces`).
21
+ * @throws {QueryError} when the class is not one of the three metric models.
22
+ */
23
+ export declare function mastraMetricsKindOf(clazz: Constructor<MastraMetricModel>): "runs" | "scores" | "traces";
24
+ /**
25
+ * Dedicated read-only statement over the mastra metrics adapter (SAA-836 S2).
26
+ *
27
+ * `from()` selects one of the three metric models, `where()` accepts only the
28
+ * documented filterable attributes of the selected kind, and `execute()`
29
+ * delegates to the adapter's real mastra storage read. `paginate(size)` returns
30
+ * a {@link MastraMetricsPaginator} that serves the query pages.
31
+ */
32
+ export declare class MastraMetricsStatement<M extends Model> extends Statement<M, MastraMetricsAdapter, M[], MastraMetricsQuery> {
33
+ /** The canonical workflow id (mastra workflow_name) the query is scoped to. */
34
+ private metricsWorkflowName?;
35
+ /** The optional run id the query is narrowed to (scores/traces). */
36
+ private metricsRunId?;
37
+ /**
38
+ * Builds the statement over the read-only metrics adapter.
39
+ *
40
+ * @param adapter - The mastra metrics adapter the statement executes against.
41
+ * @param overrides - Optional adapter flag overrides.
42
+ */
43
+ constructor(adapter: MastraMetricsAdapter, overrides?: Partial<AdapterFlags>);
44
+ /**
45
+ * Scopes the statement to one canonical workflow (mastra storage
46
+ * workflow_name). The caller (the metrics gateway) has already resolved the
47
+ * workflow's ownership; the statement only carries the scope.
48
+ *
49
+ * @param workflowId - The canonical workflow id to scope the query to.
50
+ * @returns This statement, for chaining.
51
+ */
52
+ forWorkflow(workflowId: string): this;
53
+ /**
54
+ * Narrows the statement to one mastra run (required for score and trace
55
+ * reads, which mastra serves per run).
56
+ *
57
+ * @param runId - The mastra run id to narrow to.
58
+ * @returns This statement, for chaining.
59
+ */
60
+ forRun(runId: string): this;
61
+ /**
62
+ * Parses the statement's single `where` condition into its query fragment.
63
+ * Only equality on a documented filterable attribute of the selected kind is
64
+ * accepted; everything else fails closed.
65
+ *
66
+ * @param condition - The decaf condition built by the statement chain.
67
+ * @returns The query fragment carrying the validated status filter.
68
+ * @throws {QueryError} when the operator is not `eq`, the attribute is not filterable for the kind, or the comparison is not a non-empty string.
69
+ */
70
+ protected parseCondition(condition: Condition<M>): MastraMetricsQuery;
71
+ /**
72
+ * Builds the raw {@link MastraMetricsQuery} the adapter executes. Rejects
73
+ * aggregations, grouping, distinct, and non-`createdAt` orderings; the
74
+ * workflow scope and optional run narrowing are appended to the parsed
75
+ * condition fragment, and decaf `limit`/`offset` map onto the mastra-native
76
+ * `perPage`/`page`.
77
+ *
78
+ * @returns The raw metrics query.
79
+ * @throws {QueryError} when the statement uses an unsupported shape.
80
+ */
81
+ protected build(): MastraMetricsQuery;
82
+ }
83
+ /**
84
+ * Dedicated paginator over the mastra metrics adapter (SAA-836 S2). Pages are
85
+ * mastra-native: the paginator maps the one-indexed decaf page onto the
86
+ * zero-indexed mastra page and derives the record count and page total from
87
+ * the storage response. R7: a page never resolves to nil rows — an empty
88
+ * result is an empty array, never null/undefined.
89
+ */
90
+ export declare class MastraMetricsPaginator<M extends Model> extends Paginator<M, M[], MastraMetricsQuery> {
91
+ /**
92
+ * Builds the paginator over the read-only metrics adapter.
93
+ *
94
+ * @param adapter - The mastra metrics adapter the paginator reads through.
95
+ * @param query - The raw metrics query to page over.
96
+ * @param size - Records per page.
97
+ * @param clazz - The metric model class being paged.
98
+ */
99
+ constructor(adapter: MastraMetricsAdapter, query: MastraMetricsQuery, size: number, clazz: Constructor<M>);
100
+ /**
101
+ * Copies the raw query unmodified: the mastra query already carries the
102
+ * mastra-native pagination fields the adapter expects.
103
+ *
104
+ * @param rawStatement - The query the paginator was built with.
105
+ * @returns The prepared query.
106
+ */
107
+ protected prepare(rawStatement: MastraMetricsQuery): MastraMetricsQuery;
108
+ /**
109
+ * Reads one page through the adapter's real mastra storage read.
110
+ *
111
+ * @param page - The one-indexed page number to read.
112
+ * @returns The page's model rows, newest first as mastra returns them.
113
+ * @throws {PagingError} when the page is out of the known range.
114
+ */
115
+ page(page?: number, ...args: ContextualArgs<Context>): Promise<M[]>;
116
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraModelSchemaConverter
3
+ * @summary The single decaf↔mastra schema conversion path (SAA-836 S1).
4
+ * @description Every decaf Model → mastra Zod schema conversion (and the
5
+ * reverse) goes through `@decaf-ts/as-zod` — this module is the mastra-side
6
+ * adapter over it, never a second metadata walker. The converted schemas are
7
+ * what mastra agents and workflow steps consume for structured output/input
8
+ * (see {@link MastraStructuredOutput}). Both directions fail closed with
9
+ * {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE} when the conversion cannot
10
+ * produce a usable schema, instead of handing the engine a degraded schema.
11
+ */
12
+ import type { Constructor } from "@decaf-ts/decoration";
13
+ import type { Model } from "@decaf-ts/decorator-validation";
14
+ import type { z } from "zod";
15
+ /**
16
+ * The schema conversion failed or produced no usable schema: the model carries
17
+ * no convertible attributes, or the Zod schema is not an object schema that can
18
+ * drive structured output (SAA-836 S1).
19
+ */
20
+ export declare const GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE = "GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE";
21
+ /**
22
+ * Converts a decaf Model constructor into the mastra Zod object schema through
23
+ * `@decaf-ts/as-zod` (SAA-836 S1: the single conversion path). The result is
24
+ * what mastra agents consume as their structured-output schema.
25
+ *
26
+ * @param model - The decaf Model constructor to convert.
27
+ * @returns The converted Zod object schema.
28
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE}
29
+ * when the model is not a decaf Model, or the conversion does not produce a
30
+ * Zod object schema.
31
+ */
32
+ export declare function mastraSchemaFromModel<M extends Model>(model: Constructor<M>): z.ZodTypeAny;
33
+ /**
34
+ * Converts a mastra Zod object schema back into a decaf Model constructor
35
+ * through `@decaf-ts/as-zod` (SAA-836 S1: the single conversion path, reverse
36
+ * direction).
37
+ *
38
+ * @param schema - The Zod schema to convert back.
39
+ * @param name - Optional decaf model name the generated constructor registers.
40
+ * @returns The generated decaf Model constructor.
41
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE}
42
+ * when the schema is not convertible, or the generated constructor is not a
43
+ * decaf Model.
44
+ */
45
+ export declare function mastraModelFromSchema(schema: z.ZodTypeAny, name?: string): Constructor<Model>;
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraModelSchemaConverter
3
+ * @summary The single decaf↔mastra schema conversion path (SAA-836 S1).
4
+ * @description Every decaf Model → mastra Zod schema conversion (and the
5
+ * reverse) goes through `@decaf-ts/as-zod` — this module is the mastra-side
6
+ * adapter over it, never a second metadata walker. The converted schemas are
7
+ * what mastra agents and workflow steps consume for structured output/input
8
+ * (see {@link MastraStructuredOutput}). Both directions fail closed with
9
+ * {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE} when the conversion cannot
10
+ * produce a usable schema, instead of handing the engine a degraded schema.
11
+ */
12
+ import type { Constructor } from "@decaf-ts/decoration";
13
+ import type { Model } from "@decaf-ts/decorator-validation";
14
+ import type { z } from "zod";
15
+ /**
16
+ * The schema conversion failed or produced no usable schema: the model carries
17
+ * no convertible attributes, or the Zod schema is not an object schema that can
18
+ * drive structured output (SAA-836 S1).
19
+ */
20
+ export declare const GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE = "GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE";
21
+ /**
22
+ * Converts a decaf Model constructor into the mastra Zod object schema through
23
+ * `@decaf-ts/as-zod` (SAA-836 S1: the single conversion path). The result is
24
+ * what mastra agents consume as their structured-output schema.
25
+ *
26
+ * @param model - The decaf Model constructor to convert.
27
+ * @returns The converted Zod object schema.
28
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE}
29
+ * when the model is not a decaf Model, or the conversion does not produce a
30
+ * Zod object schema.
31
+ */
32
+ export declare function mastraSchemaFromModel<M extends Model>(model: Constructor<M>): z.ZodTypeAny;
33
+ /**
34
+ * Converts a mastra Zod object schema back into a decaf Model constructor
35
+ * through `@decaf-ts/as-zod` (SAA-836 S1: the single conversion path, reverse
36
+ * direction).
37
+ *
38
+ * @param schema - The Zod schema to convert back.
39
+ * @param name - Optional decaf model name the generated constructor registers.
40
+ * @returns The generated decaf Model constructor.
41
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MODEL_SCHEMA_UNAVAILABLE}
42
+ * when the schema is not convertible, or the generated constructor is not a
43
+ * decaf Model.
44
+ */
45
+ export declare function mastraModelFromSchema(schema: z.ZodTypeAny, name?: string): Constructor<Model>;
@@ -0,0 +1,197 @@
1
+ import type { Logger } from "@decaf-ts/logging";
2
+ /** The mastra runtime surface the observability layer attaches through
3
+ * (`@mastra/core`'s `Mastra.registerExporter`). Real mastra runtimes always
4
+ * expose it; duck-typed test doubles do not, and for those the wiring is
5
+ * skipped so the general engine keeps booting them unchanged.
6
+ */
7
+ export declare const GRAPH_MASTRA_OBSERVABILITY_RUNTIME_METHOD = "registerExporter";
8
+ /** Canonical attribute key the compiler stamps onto every translated mastra
9
+ * step so exported spans carry the OUR-node origin. */
10
+ export declare const MASTRA_DECAF_NODE_ORIGIN_KEY = "decafNode";
11
+ /** Resolved mastra observability configuration (SAA-836 O1). */
12
+ export interface MastraObservabilityConfig {
13
+ /** Whether the observability layer is wired at engine boot. */
14
+ enabled: boolean;
15
+ /** The service name attached to every exported trace. */
16
+ serviceName: string;
17
+ /** Optional deployment environment tag attached to exported traces. */
18
+ environment: string;
19
+ langfuse: {
20
+ /** The langfuse endpoint traces are exported to (non-secret). */
21
+ endpoint: string;
22
+ /** The name of the `.env.secret` variable carrying the langfuse public key. */
23
+ publicKeyEnv: string;
24
+ /** The name of the `.env.secret` variable carrying the langfuse secret key. */
25
+ secretKeyEnv: string;
26
+ };
27
+ }
28
+ /**
29
+ * Reads the mastra observability configuration from the accumulated mastra
30
+ * environment (the `MASTRA__OBSERVABILITY__*` overrides are already applied by
31
+ * {@link MastraEnvironment}).
32
+ *
33
+ * @returns The resolved observability configuration.
34
+ */
35
+ export declare function resolveMastraObservabilityConfig(): MastraObservabilityConfig;
36
+ /** The OUR-node origin the compiler stamps onto a translated mastra step. */
37
+ export interface MastraDecafNodeOrigin {
38
+ /** The canonical graph node id the step was translated from. */
39
+ id: string;
40
+ /** The canonical graph node kind the step was translated from. */
41
+ kind: string;
42
+ }
43
+ /** A minimal exported-span surface the isolation classifier reads (duck-typed
44
+ * against `@mastra/core/observability`'s `AnyExportedSpan` so the classifier
45
+ * stays usable without importing the mastra runtime). */
46
+ export interface MastraExportedSpanLike {
47
+ id: string;
48
+ traceId: string;
49
+ name: string;
50
+ type?: string;
51
+ entityType?: string;
52
+ entityId?: string;
53
+ attributes?: Record<string, unknown>;
54
+ metadata?: Record<string, unknown>;
55
+ [key: string]: unknown;
56
+ }
57
+ /**
58
+ * Resolves the OUR-node origin an exported span carries **by metadata**, when
59
+ * any. The origin is stamped by the workflow compiler under
60
+ * {@link MASTRA_DECAF_NODE_ORIGIN_KEY} on the step's entry metadata.
61
+ *
62
+ * @param span - The exported span to classify.
63
+ * @returns The OUR-node origin, or `undefined` for engine-internal spans.
64
+ */
65
+ export declare function decafNodeOriginOf(span: MastraExportedSpanLike | undefined): MastraDecafNodeOrigin | undefined;
66
+ /**
67
+ * The OUR-node isolation exporter (SAA-836 O1). Implements mastra's
68
+ * `ObservabilityExporter` contract on top of OUR observability layer: every
69
+ * event the mastra engine exports is received here and logged through the
70
+ * decaf logger, attributed to the canonical graph node it belongs to when the
71
+ * span carries the compiler-stamped `decafNode` origin — so OUR-node signals
72
+ * are isolatable in OUR observability (`decaf-node` scope) from
73
+ * engine-internal signals (`decaf-engine` scope) while mastra still catches
74
+ * everything on its engine.
75
+ *
76
+ * The exporter never throws into the engine's export pipeline: a logging
77
+ * failure is swallowed so observability cannot break a run.
78
+ */
79
+ export declare class DecafNodeObservabilityExporter {
80
+ /** The exporter name mastra registers. */
81
+ readonly name = "decaf-node-observability";
82
+ private readonly logger;
83
+ /** Canonical node origins known to the isolation classifier, keyed by node
84
+ * id. The backend tracks the executed document's nodes per run. */
85
+ private readonly knownNodes;
86
+ constructor(logger?: Logger);
87
+ /**
88
+ * Tracks the canonical nodes of a document about to run, so the isolation
89
+ * classifier can attribute mastra's `workflow step: '<stepId>'` spans (the
90
+ * step id is the canonical node id) to their OUR-node origin.
91
+ *
92
+ * @param nodes - The canonical nodes of the document being executed.
93
+ */
94
+ trackNodes(nodes: readonly {
95
+ id: string;
96
+ kind: string;
97
+ }[]): void;
98
+ /**
99
+ * Classifies an exported span: the OUR-node origin when the span belongs to
100
+ * a canonical graph node (via the compiler-stamped entry metadata or a
101
+ * mastra workflow-step span naming a tracked canonical node id),
102
+ * `undefined` for engine-internal spans.
103
+ *
104
+ * @param span - The exported span to classify.
105
+ * @returns The OUR-node origin, or `undefined`.
106
+ */
107
+ originOf(span: MastraExportedSpanLike | undefined): MastraDecafNodeOrigin | undefined;
108
+ /** The engine-scope logger for signals without an OUR-node origin. */
109
+ private engineFor;
110
+ /**
111
+ * Exports a tracing event into OUR observability layer, attributed to the
112
+ * canonical node when the span belongs to one.
113
+ *
114
+ * @param event - The tracing event mastra's export pipeline emitted.
115
+ */
116
+ exportTracingEvent(event: {
117
+ type: string;
118
+ exportedSpan?: MastraExportedSpanLike;
119
+ }): Promise<void>;
120
+ /** Aliased mastra tracing-event hook (pipeline calls both spellings). */
121
+ onTracingEvent(event: {
122
+ type: string;
123
+ exportedSpan?: MastraExportedSpanLike;
124
+ }): Promise<void>;
125
+ /**
126
+ * Exports a log event into OUR observability layer.
127
+ *
128
+ * @param event - The log event mastra's export pipeline emitted.
129
+ */
130
+ onLogEvent(event: {
131
+ message?: unknown;
132
+ [key: string]: unknown;
133
+ }): Promise<void>;
134
+ /**
135
+ * Exports a metric event into OUR observability layer.
136
+ *
137
+ * @param event - The metric event mastra's export pipeline emitted.
138
+ */
139
+ onMetricEvent(event: {
140
+ [key: string]: unknown;
141
+ }): Promise<void>;
142
+ /**
143
+ * Exports a score event into OUR observability layer.
144
+ *
145
+ * @param event - The score event mastra's export pipeline emitted.
146
+ */
147
+ onScoreEvent(event: {
148
+ [key: string]: unknown;
149
+ }): Promise<void>;
150
+ /**
151
+ * Exports an exporter-pipeline drop event into OUR observability layer.
152
+ *
153
+ * @param event - The drop event mastra's export pipeline emitted.
154
+ */
155
+ onDroppedEvent(event: {
156
+ [key: string]: unknown;
157
+ }): Promise<void>;
158
+ /** No buffered state: flush resolves immediately. */
159
+ flush(): Promise<void>;
160
+ /** No external resources held: shutdown resolves immediately. */
161
+ shutdown(): Promise<void>;
162
+ }
163
+ /** The live observability wiring attached to a mastra runtime. */
164
+ export interface MastraObservabilityHandle {
165
+ /** The OUR-node isolation exporter registered on the runtime. */
166
+ decafExporter: DecafNodeObservabilityExporter;
167
+ /** Flushes every registered exporter (used at engine dispose). */
168
+ flush(): Promise<void>;
169
+ /** Shuts every registered exporter down and releases their resources. */
170
+ shutdown(): Promise<void>;
171
+ }
172
+ /**
173
+ * Wires the mastra observability layer onto a real mastra runtime
174
+ * (SAA-836 O1). When the observability lane is disabled, or when the runtime
175
+ * exposes no mastra `registerExporter` surface (a duck-typed test double,
176
+ * never a real `@mastra/core` runtime), the runtime is left untouched and
177
+ * `undefined` is returned. When enabled on a mastra-native runtime, wiring
178
+ * fails closed on credentials: without the user-supplied langfuse
179
+ * `.env.secret` credentials the layer throws
180
+ * {@link GRAPH_MASTRA_OBSERVABILITY_CREDENTIALS_UNAVAILABLE} (gate C) —
181
+ * langfuse is the default and always-present target, so no degraded
182
+ * unauthenticated export path exists.
183
+ *
184
+ * The langfuse exporter is mastra's official `@mastra/langfuse`
185
+ * `LangfuseExporter` (R2 wrap justification recorded in the module docs). The
186
+ * OUR-node isolation exporter is registered alongside it so OUR nodes stay
187
+ * isolatable in OUR observability layer.
188
+ *
189
+ * @param runtime - The wired mastra runtime (a real `@mastra/core` `Mastra`).
190
+ * @param env - The runtime environment bag the credentials are read from;
191
+ * defaults to `process.env`.
192
+ * @returns The observability handle, or `undefined` when the lane is disabled
193
+ * or the runtime is not mastra-native.
194
+ * @throws {GraphExecutionError} when the lane is enabled on a mastra-native
195
+ * runtime but the langfuse credentials are unavailable.
196
+ */
197
+ export declare function wireMastraObservability(runtime: unknown, env?: Record<string, string | undefined>): Promise<MastraObservabilityHandle | undefined>;