@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,362 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraMemory
3
+ * @summary Mastra memory layer for the agent `memory` zone (SAA-836 M2).
4
+ * @description The memory provider node resolves its **config** into a live
5
+ * mastra-native `Memory`, selecting a storage backend by config. Mastra-first
6
+ * (R3): `libsql` and `pg` are mastra's **native** memory storage backends
7
+ * (`@mastra/libsql`'s `LibSQLStore` and `@mastra/pg`'s `PostgresStore`), and
8
+ * `memory` is mastra's own `InMemoryStore` baseline (no external service — the
9
+ * offline path the memory driver tests and the config-only fallback use). The
10
+ * concrete `Memory` class is mastra's `@mastra/memory` package: `@mastra/core`
11
+ * 1.x ships only the abstract `MastraMemory` base, so wrapping the concrete
12
+ * implementation is the direct-library wrap (R2) — reimplementing memory
13
+ * semantics (conversation history, semantic recall, working memory) in as-graph
14
+ * would be invention. Every path fails closed with
15
+ * {@link GRAPH_MASTRA_MEMORY_UNAVAILABLE} when a provider's connection options
16
+ * are incomplete, so no engine fabricates a memory.
17
+ *
18
+ * Credential gate (SAA-911 F4, gate C): backend configs never carry credential
19
+ * values. Plaintext credential members in `connection` options are refused —
20
+ * never stripped — with {@link GRAPH_MASTRA_PLAIN_CREDENTIAL_REFUSED}, and `pg`
21
+ * requires a `credentialRef` whose `credentialId` NAMES the environment
22
+ * variable (user-supplied `.env.secret`) carrying the password; the value is
23
+ * resolved from the host environment only at backend-construction time and is
24
+ * never logged, persisted, or held by the graph layer.
25
+ *
26
+ * R9 resource-output semantics: the node's step emits the JSON-safe, secret-free
27
+ * {@link MastraMemoryDescriptor} on its `resource` output; the live `Memory`
28
+ * instance is resolved in-process where it is consumed (the agent runtime) and
29
+ * is **never** persisted — the run store carries the descriptor only.
30
+ *
31
+ * The mastra memory packages are declared peer dependencies and statically
32
+ * imported — C11 forbids dynamic imports under `src/mastra/**` — exactly like
33
+ * `@mastra/core` itself: the `core.agent.memory`/`core.agent.memorySelector`
34
+ * kinds are mastra-only (`graphNodeRequiresMastraEngine`), so every surface
35
+ * that can reach this module already runs on the mastra engine.
36
+ */
37
+ import { type MastraCompositeStore } from "@mastra/core/storage";
38
+ import type { MastraMemory, SharedMemoryConfig } from "@mastra/core/memory";
39
+ import type { MastraVector } from "@mastra/core/vector";
40
+ import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
41
+ import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.mts";
42
+ import { type GraphCredentialReference } from "../shared/graph/catalog/GraphCredentialReference.d.mts";
43
+ /**
44
+ * The mastra-native memory storage providers the memory node can be
45
+ * configured with, beyond the in-memory baseline. Every entry is backed by a
46
+ * package exporting a mastra `MastraCompositeStore` subtype; the host binds
47
+ * the constructor (see {@link MastraMemoryStorageBindings}) so as-graph never
48
+ * imports an optional backend package.
49
+ */
50
+ export type MastraNativeMemoryProvider = "libsql" | "pg" | "mongodb" | "upstash" | "cloud" | "d1" | "dynamodb" | "convex" | "astra" | "redis";
51
+ /** The memory storage providers the memory node can be configured with. */
52
+ export type MastraMemoryProvider = "memory" | MastraNativeMemoryProvider;
53
+ /** Every supported memory provider, in palette order. */
54
+ export declare const MASTRA_MEMORY_PROVIDERS: readonly MastraMemoryProvider[];
55
+ /** The mastra-native memory providers (everything the host may bind). */
56
+ export declare const MASTRA_NATIVE_MEMORY_PROVIDERS: readonly MastraNativeMemoryProvider[];
57
+ /**
58
+ * The package/class a mastra-native memory provider binds, used in fail-closed
59
+ * error messages so a missing host binding names the constructor to supply.
60
+ */
61
+ export declare const MASTRA_NATIVE_MEMORY_BINDING_HINTS: Readonly<Record<MastraNativeMemoryProvider, string>>;
62
+ /**
63
+ * The default `connection` member a provider's resolved credential is injected
64
+ * into. A config may override the name with
65
+ * {@link MastraMemoryConfig.credentialKey}.
66
+ */
67
+ export declare const MASTRA_MEMORY_DEFAULT_CREDENTIAL_KEYS: Readonly<Record<MastraNativeMemoryProvider, string>>;
68
+ /**
69
+ * Whether a provider names a mastra-native storage backend bound by the host.
70
+ *
71
+ * @param provider - The provider discriminator to test.
72
+ * @returns `true` when the provider requires a host-bound constructor.
73
+ */
74
+ export declare function isMastraNativeMemoryProvider(provider: string): provider is MastraNativeMemoryProvider;
75
+ /**
76
+ * The memory configuration a `core.agent.memory` node carries. It is **config**,
77
+ * never a live memory: the host (or the agent runtime) resolves it through
78
+ * {@link resolveMastraMemory} at execution time. Secrets are never carried here
79
+ * as plain values — a backend that needs credentials declares a `credentialRef`
80
+ * instead (gate C).
81
+ */
82
+ export interface MastraMemoryConfig {
83
+ /** The selected storage provider. */
84
+ provider: MastraMemoryProvider;
85
+ /** Optional memory id (defaults to the provider). */
86
+ id?: string;
87
+ /** The conversation thread id the agent's invocations bind to. */
88
+ threadId?: string;
89
+ /** The resource id scoping resource-level memory (working memory scope). */
90
+ resourceId?: string;
91
+ /** How many recent messages the agent context keeps (mastra `lastMessages`). */
92
+ lastMessages?: number;
93
+ /** Whether semantic recall is enabled (mastra `semanticRecall`). */
94
+ semanticRecall?: boolean;
95
+ /**
96
+ * The working-memory template (mastra `workingMemory.template`). Setting it
97
+ * enables mastra working memory with this template.
98
+ */
99
+ workingMemoryTemplate?: string;
100
+ /** Whether mastra generates thread titles (mastra `generateTitle`). */
101
+ generateTitle?: boolean;
102
+ /**
103
+ * Advanced mastra `MemoryConfig` options not surfaced as named fields,
104
+ * forwarded verbatim. Named fields override the same key here.
105
+ */
106
+ memoryOptions?: Record<string, unknown>;
107
+ /**
108
+ * Provider connection options. Never carries credential material (gate C,
109
+ * SAA-911 F4): plaintext credential members are refused at resolution time.
110
+ */
111
+ connection?: Record<string, unknown>;
112
+ /**
113
+ * The `connection` member the resolved credential is injected into. Defaults
114
+ * to the provider's native option name (see
115
+ * {@link MASTRA_MEMORY_DEFAULT_CREDENTIAL_KEYS}); only used when a
116
+ * {@link credentialRef} is configured.
117
+ */
118
+ credentialKey?: string;
119
+ /**
120
+ * Credential reference resolved by document validation stage 8 (SAA-911
121
+ * F4, gate C): `credentialId` names the environment variable that carries
122
+ * the provider credential; the value is resolved from the host environment
123
+ * (`.env.secret`) only at backend-construction time and is never carried by
124
+ * the config.
125
+ */
126
+ credentialRef?: GraphCredentialReference;
127
+ }
128
+ /**
129
+ * Structural guard for {@link MastraMemoryConfig}: requires a known provider
130
+ * and, when present, well-formed optional fields.
131
+ *
132
+ * @param value - The candidate memory config.
133
+ * @returns `true` when the value is a valid memory configuration.
134
+ */
135
+ export declare function isMastraMemoryConfig(value: unknown): value is MastraMemoryConfig;
136
+ /**
137
+ * Reads the memory config carried by a document node. Looks at the canonical
138
+ * `memory` parameter first, then the flat node parameter shape; a node that
139
+ * omits `provider` defaults to the in-memory baseline. An absent or malformed
140
+ * value (including an unknown provider) returns `undefined` so the caller
141
+ * fails closed instead of resolving a bogus memory.
142
+ *
143
+ * @param node - The canonical node instance.
144
+ * @returns The validated memory config, or `undefined` when none is present.
145
+ */
146
+ export declare function mastraMemoryConfigOf(node: GraphNodeInstance): MastraMemoryConfig | undefined;
147
+ /**
148
+ * The JSON-safe, secret-free descriptor of a resolved memory (R9): the live
149
+ * `MastraMemory` instance is never persisted, only this reference is.
150
+ */
151
+ export interface MastraMemoryDescriptor {
152
+ /** Stable discriminator for the resolved-reference descriptor. */
153
+ type: "mastra.memory";
154
+ /** The selected storage provider. */
155
+ provider: MastraMemoryProvider;
156
+ /** The resolved memory id. */
157
+ id: string;
158
+ /** The configured conversation thread id. */
159
+ threadId?: string;
160
+ /** The configured resource id. */
161
+ resourceId?: string;
162
+ /** The configured recent-message window. */
163
+ lastMessages?: number;
164
+ /** The configured semantic-recall flag. */
165
+ semanticRecall?: boolean;
166
+ /** The configured working memory (enabled plus the template, when set). */
167
+ workingMemory?: {
168
+ enabled: boolean;
169
+ template?: string;
170
+ };
171
+ /** The configured thread-title generation flag. */
172
+ generateTitle?: boolean;
173
+ /** The credential reference, when one is configured (a reference, not a secret). */
174
+ credentialRef?: GraphCredentialReference;
175
+ }
176
+ /**
177
+ * Builds the JSON-safe descriptor for a memory config without resolving a live
178
+ * memory. Used by the node's `execute` projection and the step handler so no
179
+ * non-JSON value or secret ever reaches a persisted result.
180
+ *
181
+ * @param config - The validated memory config.
182
+ * @returns The resolved-reference descriptor.
183
+ */
184
+ export declare function mastraMemoryDescriptorOf(config: MastraMemoryConfig): MastraMemoryDescriptor;
185
+ /**
186
+ * Assembles the mastra `MemoryConfig` options object a resolved `Memory` is
187
+ * constructed with. The named config fields override the same key in the
188
+ * advanced {@link MastraMemoryConfig.memoryOptions} passthrough; a configured
189
+ * working-memory template enables mastra working memory with that template.
190
+ *
191
+ * @param config - The validated memory config.
192
+ * @returns The mastra memory options, or `undefined` when nothing is configured.
193
+ */
194
+ export declare function mastraMemoryOptionsOf(config: MastraMemoryConfig): Record<string, unknown> | undefined;
195
+ /**
196
+ * A mastra-native memory-storage constructor the host binds for a provider
197
+ * (`@mastra/mongodb`'s `MongoStore`, `@mastra/upstash`'s `UpstashStore`, …).
198
+ * The store is constructed with the config's connection options and id.
199
+ */
200
+ export type MastraMemoryStorageConstructor = new (options: Record<string, unknown>) => MastraCompositeStore;
201
+ /**
202
+ * Host-provided mastra-native memory-storage bindings, keyed by provider.
203
+ * `memory`, `libsql`, and `pg` have built-in resolution; every other provider
204
+ * requires its binding here and fails closed without it. The index signature
205
+ * keeps the map open to a host extension.
206
+ */
207
+ export interface MastraMemoryStorageBindings {
208
+ /** Reserved: libsql resolves through the built-in `LibSQLStore` path. */
209
+ libsql?: MastraMemoryStorageConstructor;
210
+ /** Reserved: pg resolves through the built-in `PostgresStore` path. */
211
+ pg?: MastraMemoryStorageConstructor;
212
+ /** The `@mastra/mongodb` `MongoStore` binding. */
213
+ mongodb?: MastraMemoryStorageConstructor;
214
+ /** The `@mastra/upstash` `UpstashStore` binding. */
215
+ upstash?: MastraMemoryStorageConstructor;
216
+ /** The `@mastra/cloud` cloud storage binding. */
217
+ cloud?: MastraMemoryStorageConstructor;
218
+ /** The `@mastra/cloudflare-d1` `D1Store` binding. */
219
+ d1?: MastraMemoryStorageConstructor;
220
+ /** The `@mastra/dynamodb` `DynamoDBStore` binding. */
221
+ dynamodb?: MastraMemoryStorageConstructor;
222
+ /** The `@mastra/convex` `ConvexStore` binding. */
223
+ convex?: MastraMemoryStorageConstructor;
224
+ /** The `@mastra/astra` `AstraStore` binding. */
225
+ astra?: MastraMemoryStorageConstructor;
226
+ /** The `@mastra/redis` `RedisStore` binding. */
227
+ redis?: MastraMemoryStorageConstructor;
228
+ /** Additional host-native provider bindings. */
229
+ [provider: string]: MastraMemoryStorageConstructor | undefined;
230
+ }
231
+ /** Options {@link resolveMastraMemoryStorage} resolves a store with. */
232
+ export interface MastraMemoryStorageResolveOptions {
233
+ /** Host-provided native storage bindings for the non-built-in providers. */
234
+ storageBindings?: MastraMemoryStorageBindings;
235
+ }
236
+ /**
237
+ * Resolves a memory config into a live mastra storage backend.
238
+ *
239
+ * Mastra-first (R3): `memory` uses mastra's own `InMemoryStore`; `libsql` and
240
+ * `pg` construct mastra's native memory storage stores (`@mastra/libsql`'s
241
+ * `LibSQLStore` / `@mastra/pg`'s `PostgresStore`); every other native backend
242
+ * (Mongo, Upstash, cloud, D1, DynamoDB, Convex, Astra, Redis) is constructed
243
+ * from the host's {@link MastraMemoryStorageBindings} entry — never imported by
244
+ * as-graph. Every path fails closed with
245
+ * {@link GRAPH_MASTRA_MEMORY_UNAVAILABLE} when the connection options or host
246
+ * binding are incomplete; an unknown provider fails with
247
+ * {@link GRAPH_MASTRA_MEMORY_PROVIDER_UNKNOWN} — never a fabricated store.
248
+ *
249
+ * Credential gate (SAA-911 F4, gate C): the `pg` connection options must carry
250
+ * a complete non-secret host config (`host`, `port`, `database`, `user`) and a
251
+ * `credentialRef` naming the environment variable that carries the pg
252
+ * password — plaintext credential members in the connection are refused and
253
+ * the credential value is host-resolved from the git-ignored `.env.secret`
254
+ * only at construction time. A host-bound native provider resolves a
255
+ * credential the same way when a `credentialRef` is configured, injecting the
256
+ * value into the member named by {@link MastraMemoryConfig.credentialKey} or
257
+ * the provider's default key (see {@link MASTRA_MEMORY_DEFAULT_CREDENTIAL_KEYS}).
258
+ * `libsql` stays credential-free by configuration (its `url` member is
259
+ * required; credentials embedded in the URL are a host-owned residual risk
260
+ * this resolution does not validate).
261
+ *
262
+ * @param config - The validated memory config.
263
+ * @param id - The resolved memory id the store is constructed with.
264
+ * @param options - The host-provided native storage bindings.
265
+ * @returns The live storage instance.
266
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_PLAIN_CREDENTIAL_REFUSED}
267
+ * when the connection options carry plaintext credential material.
268
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_CREDENTIALS_UNAVAILABLE}
269
+ * when a required credential reference is absent, malformed, or its
270
+ * environment variable is unset or empty.
271
+ * @throws {GraphExecutionError} when the backend options are incomplete, the
272
+ * host binding is missing, or the provider is unknown.
273
+ */
274
+ export declare function resolveMastraMemoryStorage(config: MastraMemoryConfig, id: string, options?: MastraMemoryStorageResolveOptions): Promise<MastraCompositeStore>;
275
+ /**
276
+ * The mastra embedding model semantic recall consumes: a registered model id
277
+ * string or a live mastra/AI-SDK embedding model.
278
+ */
279
+ export type MastraMemoryEmbedder = SharedMemoryConfig["embedder"];
280
+ /** Options {@link resolveMastraMemory} resolves a memory with. */
281
+ export interface MastraMemoryResolveOptions {
282
+ /**
283
+ * A pre-resolved storage instance to construct the memory with, instead of
284
+ * resolving one from the config's provider. Used by hosts that own their
285
+ * storage lifecycle.
286
+ */
287
+ storage?: MastraCompositeStore;
288
+ /** Host-provided native storage bindings for non-built-in providers. */
289
+ storageBindings?: MastraMemoryStorageBindings;
290
+ /**
291
+ * A live mastra vector store the memory uses for semantic recall (R1
292
+ * adapter-in-config: the store carries its own embedding adapter). Required
293
+ * when the config enables {@link MastraMemoryConfig.semanticRecall}; the
294
+ * resolver fails closed with {@link GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED}
295
+ * without it instead of surfacing mastra's raw error.
296
+ */
297
+ vector?: MastraVector;
298
+ /**
299
+ * The mastra embedding model semantic recall uses. Required when the vector
300
+ * store does not generate embeddings itself; forwarded to mastra verbatim.
301
+ */
302
+ embedder?: MastraMemoryEmbedder;
303
+ }
304
+ /** A resolved memory: the live mastra `Memory` plus its JSON-safe descriptor. */
305
+ export interface ResolvedMastraMemory {
306
+ /** The live mastra memory. */
307
+ memory: MastraMemory;
308
+ /** The JSON-safe, secret-free descriptor (R9). */
309
+ descriptor: MastraMemoryDescriptor;
310
+ }
311
+ /**
312
+ * Resolves a memory config into a live mastra-native `Memory`.
313
+ *
314
+ * The concrete `Memory` class is mastra's `@mastra/memory` package (R2 direct
315
+ * wrap: `@mastra/core` 1.x ships only the abstract `MastraMemory` base, and
316
+ * reimplementing memory semantics in as-graph would be invention). The package
317
+ * is a declared peer dependency, statically imported like `@mastra/core`
318
+ * itself (C11).
319
+ *
320
+ * Semantic recall requires a live vector store (mastra's `MemoryConstructorConfig.vector`);
321
+ * the host supplies it through {@link MastraMemoryResolveOptions.vector}. A
322
+ * config that enables semantic recall without one fails closed with
323
+ * {@link GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED} instead of forwarding the request
324
+ * and surfacing mastra's raw `Error`.
325
+ *
326
+ * @param config - The validated memory config.
327
+ * @param options - Optional pre-resolved storage/vector overrides.
328
+ * @returns The live memory and its JSON-safe descriptor.
329
+ * @throws {GraphExecutionError} when the storage backend cannot be resolved,
330
+ * when semantic recall is enabled without a vector store
331
+ * ({@link GRAPH_MASTRA_MEMORY_VECTOR_REQUIRED}), or when the vector store does
332
+ * not embed itself and no embedder is supplied
333
+ * ({@link GRAPH_MASTRA_MEMORY_EMBEDDER_REQUIRED}).
334
+ */
335
+ export declare function resolveMastraMemory(config: MastraMemoryConfig, options?: MastraMemoryResolveOptions): Promise<ResolvedMastraMemory>;
336
+ /**
337
+ * The memory wiring one memory provider node contributes to an agent node:
338
+ * the source node instance plus its validated memory config.
339
+ */
340
+ export interface MastraAgentMemoryWiring {
341
+ /** The memory provider node wired to the agent. */
342
+ node: GraphNodeInstance;
343
+ /** The node's validated memory config. */
344
+ config: MastraMemoryConfig;
345
+ }
346
+ /**
347
+ * Resolves the memory provider nodes wired to an agent node through the
348
+ * `memory` zone: every connection edge whose target is the agent node's
349
+ * `memory` port and whose source is a `core.agent.memory` node carrying a
350
+ * valid memory config. Connection edges are structural and never route
351
+ * values — this compile-time walk is how the agent runtime learns which memory
352
+ * to resolve and bind. A wired `core.agent.memory` node whose config is absent
353
+ * or malformed fails closed instead of being silently dropped.
354
+ *
355
+ * @param document - The document being compiled.
356
+ * @param agentNode - The agent node whose `memory` zone to resolve.
357
+ * @returns The wired memory nodes with their validated configs.
358
+ * @throws {GraphExecutionError}
359
+ * {@link GRAPH_MASTRA_MEMORY_PROVIDER_UNKNOWN} when a wired
360
+ * `core.agent.memory` node declares an unknown or malformed memory provider.
361
+ */
362
+ export declare function connectedMastraMemoryWiringOf(document: GraphWorkflowDocument, agentNode: GraphNodeInstance): MastraAgentMemoryWiring[];
@@ -0,0 +1,216 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraMetricsAdapter
3
+ * @summary Dedicated read-only Decaf adapter over the mastra storage (SAA-836 S2).
4
+ * @description The S2 adapter is the persistence seam between the read-only
5
+ * mastra metrics models and the host-provided `@mastra/core` storage. It is
6
+ * deliberately a direct-library wrap (SAA-836 R2 justification): mastra owns
7
+ * runs, scores and traces as the source of truth (R3 mastra-first, R9
8
+ * resource-output preferred), so the adapter delegates every read to the real
9
+ * mastra storage domains instead of mirroring them. Writes fail closed: the
10
+ * models are read-only projections and the adapter refuses every mutation.
11
+ *
12
+ * Read flow: {@link MastraMetricsStatement} builds a {@link MastraMetricsQuery},
13
+ * the adapter executes it against the mastra `workflows`/`scores`/`observability`
14
+ * domains and projects every returned row into its read-only model shape; rows
15
+ * that cannot be projected are skipped, never fabricated.
16
+ */
17
+ import { Adapter, RawResult, type AdapterFlags, type Context, type ContextualArgs, type PreparedStatement } from "@decaf-ts/core";
18
+ import { Model } from "@decaf-ts/decorator-validation";
19
+ import type { Constructor } from "@decaf-ts/decoration";
20
+ import { type PrimaryKeyType } from "@decaf-ts/db-decorators";
21
+ import { MastraMetricsStatement } from "./MastraMetricsStatement.d.cts";
22
+ import { MastraMetricsPaginator } from "./MastraMetricsStatement.d.cts";
23
+ /** The flavour id the read-only mastra metrics adapter registers under. */
24
+ export declare const MASTRA_METRICS_FLAVOUR = "mastra-metrics";
25
+ /** The mastra runtime structural surface the adapter reads through. */
26
+ export interface MastraMetricsRuntimeLike {
27
+ /** Real mastra runtime accessor returning the composite storage, when present. */
28
+ getStorage?: () => unknown;
29
+ }
30
+ /**
31
+ * Host-provided mastra storage composite store (structural subset of the real
32
+ * `@mastra/core` storage contract). Domains are resolved lazily per read.
33
+ */
34
+ export interface MastraMetricsCompositeStoreLike {
35
+ /** Resolves one storage domain by name, or `undefined` when absent. */
36
+ getStore: (domain: string) => Promise<unknown | undefined>;
37
+ }
38
+ /** Mastra workflows storage domain (structural subset of the real contract). */
39
+ export interface MastraMetricsWorkflowsStoreLike {
40
+ listWorkflowRuns: (args: {
41
+ workflowName?: string;
42
+ perPage?: number | false;
43
+ page?: number;
44
+ }) => Promise<{
45
+ runs: unknown[];
46
+ total: number;
47
+ }>;
48
+ getWorkflowRunById: (args: {
49
+ runId: string;
50
+ workflowName?: string;
51
+ }) => Promise<unknown | null>;
52
+ }
53
+ /** Mastra scores storage domain (structural subset of the real contract). */
54
+ export interface MastraMetricsScoresStoreLike {
55
+ listScoresByRunId: (input: {
56
+ runId: string;
57
+ pagination: {
58
+ page: number;
59
+ perPage: number | false;
60
+ };
61
+ }) => Promise<{
62
+ scores: unknown[];
63
+ pagination: {
64
+ total: number;
65
+ };
66
+ }>;
67
+ }
68
+ /** Mastra observability storage domain (structural subset of the real contract). */
69
+ export interface MastraMetricsObservabilityStoreLike {
70
+ listTraces: (args: {
71
+ mode?: string;
72
+ filters?: {
73
+ runId?: string;
74
+ };
75
+ pagination?: {
76
+ page?: number;
77
+ perPage?: number;
78
+ };
79
+ }) => Promise<{
80
+ spans: unknown[];
81
+ pagination?: {
82
+ total?: number;
83
+ page?: number;
84
+ perPage?: number;
85
+ hasMore?: boolean;
86
+ };
87
+ }>;
88
+ }
89
+ /** The raw query the metrics statement builds and the adapter executes. */
90
+ export interface MastraMetricsQuery {
91
+ /** Which mastra storage domain the query targets. */
92
+ kind: "runs" | "scores" | "traces";
93
+ /** Canonical workflow id the query is scoped to (mastra workflow_name). */
94
+ workflowName: string;
95
+ /** The single run id scores/traces queries are narrowed to. */
96
+ runId?: string;
97
+ /** Optional status narrowing (runs only). */
98
+ status?: string;
99
+ /** Zero-indexed mastra-native page (runs) / one-indexed page (scores, traces). */
100
+ page?: number;
101
+ /** Records per page; `false` fetches all rows the domain can return. */
102
+ perPage?: number | false;
103
+ }
104
+ /**
105
+ * Resolves the mastra storage composite store from a wired runtime; fails
106
+ * closed when the runtime exposes no storage at all.
107
+ *
108
+ * @param runtime - The host-wired mastra runtime (or any value).
109
+ * @returns The composite storage store.
110
+ * @throws {GraphExecutionError} with {@link GRAPH_MASTRA_METRICS_UNAVAILABLE} when the runtime exposes no storage.
111
+ */
112
+ export declare function mastraMetricsStorageOf(runtime: unknown): MastraMetricsCompositeStoreLike;
113
+ /**
114
+ * Dedicated read-only Decaf adapter over the host-provided mastra storage
115
+ * (SAA-836 S2). Every mutation fails closed with a read-only error; every read
116
+ * delegates to the real mastra storage domains and projects rows into the
117
+ * read-only metric models. R7: converters never emit null rows — a row that
118
+ * cannot be projected is skipped, never fabricated.
119
+ */
120
+ export declare class MastraMetricsAdapter extends Adapter<{
121
+ mastra: unknown;
122
+ }, unknown, MastraMetricsQuery, Context> {
123
+ /**
124
+ * Builds the adapter over the host-provided mastra runtime.
125
+ *
126
+ * @param config - Adapter configuration carrying the wired mastra runtime.
127
+ * @param alias - Optional adapter alias (the backend supplies a unique one per gateway).
128
+ */
129
+ constructor(config: {
130
+ mastra: unknown;
131
+ }, alias?: string);
132
+ /**
133
+ * Builds the dedicated read-only metrics statement.
134
+ *
135
+ * @param overrides - Optional adapter flag overrides.
136
+ * @returns The statement bound to this adapter.
137
+ */
138
+ Statement<M extends Model>(overrides?: Partial<AdapterFlags>): MastraMetricsStatement<M>;
139
+ /**
140
+ * Builds the dedicated mastra-native paginator.
141
+ *
142
+ * @param query - The metrics query (or prepared statement) to page over.
143
+ * @param size - Records per page.
144
+ * @param clazz - The metric model class being paged.
145
+ * @returns The paginator bound to this adapter.
146
+ */
147
+ Paginator<M extends Model>(query: MastraMetricsQuery | PreparedStatement<M>, size: number, clazz: Constructor<M>): MastraMetricsPaginator<M>;
148
+ /**
149
+ * Passes storage/transport errors through unchanged: the mastra domains
150
+ * already raise decaf-compatible errors and the adapter adds no mapping.
151
+ *
152
+ * @param err - The error raised by the storage read.
153
+ * @returns The same error, typed for the adapter contract.
154
+ */
155
+ parseError<E extends Error>(err: Error): E;
156
+ /**
157
+ * Writes fail closed: the metrics models are read-only projections.
158
+ *
159
+ * @throws {UnsupportedError} always, with {@link GRAPH_MASTRA_METRICS_READ_ONLY}.
160
+ */
161
+ create(): Promise<Record<string, any>>;
162
+ /**
163
+ * Writes fail closed: the metrics models are read-only projections.
164
+ *
165
+ * @throws {UnsupportedError} always, with {@link GRAPH_MASTRA_METRICS_READ_ONLY}.
166
+ */
167
+ update(): Promise<Record<string, any>>;
168
+ /**
169
+ * Writes fail closed: the metrics models are read-only projections.
170
+ *
171
+ * @throws {UnsupportedError} always, with {@link GRAPH_MASTRA_METRICS_READ_ONLY}.
172
+ */
173
+ delete(): Promise<Record<string, any>>;
174
+ /**
175
+ * Reads one metric row by id through the real mastra storage. Runs resolve
176
+ * via `getWorkflowRunById` and scores via `getScoreById`; unsupported model
177
+ * kinds fail closed. Trace rows are not addressable by id (mastra serves
178
+ * them per run), so only run and score lookups are supported.
179
+ *
180
+ * @param clazz - The metric model class being read.
181
+ * @param id - The mastra row id.
182
+ * @param _args - Variadic decaf contextual arguments accepted for
183
+ * signature compatibility with the base adapter contract only; the
184
+ * mastra storage reads carry no context of their own, so the value is
185
+ * intentionally unused (`void _args;` keeps the lint rule quiet without
186
+ * changing the forwarded signature).
187
+ * @returns The projected model record.
188
+ * @throws {GraphExecutionError} when the domain is unavailable or the kind is unsupported.
189
+ * @throws {NotFoundError} when the row is absent or not projectable.
190
+ */
191
+ read<M extends Model>(clazz: Constructor<M>, id: PrimaryKeyType, ..._args: ContextualArgs<Context>): Promise<Record<string, any>>;
192
+ /**
193
+ * Executes a metrics query against the real mastra storage domains and
194
+ * projects every returned row into its read-only model shape. Runs are
195
+ * optionally narrowed by `status`; scores and traces require a run id (the
196
+ * gateway resolves and verifies it first). Projecting rows never emits nulls
197
+ * (R7): non-projectable rows are skipped.
198
+ *
199
+ * @param query - The metrics query to execute.
200
+ * @param docsOnly - When true, returns the projected rows directly; otherwise a {@link RawResult} with the row count.
201
+ * @param _args - Variadic decaf contextual arguments accepted for
202
+ * signature compatibility with the base adapter contract only; the
203
+ * mastra storage reads carry no context of their own, so the value is
204
+ * intentionally unused (`void _args;` keeps the lint rule quiet without
205
+ * changing the forwarded signature).
206
+ * @returns The projected rows, or a {@link RawResult} carrying them plus the storage-reported count.
207
+ * @throws {GraphExecutionError} when the storage/domain is unavailable, the kind is unknown, or a required run id is missing.
208
+ */
209
+ raw<R, D extends boolean>(query: MastraMetricsQuery, docsOnly: D, ..._args: ContextualArgs<Context>): Promise<RawResult<R, D>>;
210
+ /**
211
+ * The raw mastra client surface the adapter was built over.
212
+ *
213
+ * @returns The wired mastra runtime (untyped: the adapter reads it structurally).
214
+ */
215
+ protected getClient(): unknown;
216
+ }