@decaf-ts/as-graph 0.2.0 → 0.4.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 (374) hide show
  1. package/README.md +160 -2
  2. package/dist/as-graph.cjs +1 -1
  3. package/dist/as-graph.cjs.map +1 -1
  4. package/dist/as-graph.js +1 -1
  5. package/dist/as-graph.js.map +1 -1
  6. package/lib/cjs/dagster/DagsterGraphEventBridge.cjs +344 -0
  7. package/lib/cjs/dagster/DagsterGraphEventBridge.cjs.map +1 -0
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +789 -0
  9. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -0
  10. package/lib/cjs/dagster/DagsterResultMapper.cjs +56 -0
  11. package/lib/cjs/dagster/DagsterResultMapper.cjs.map +1 -0
  12. package/lib/cjs/dagster/DagsterTypes.cjs +4 -0
  13. package/lib/cjs/dagster/DagsterTypes.cjs.map +1 -0
  14. package/lib/cjs/dagster/capabilities.cjs +102 -0
  15. package/lib/cjs/dagster/capabilities.cjs.map +1 -0
  16. package/lib/cjs/dagster/constants.cjs +92 -0
  17. package/lib/cjs/dagster/constants.cjs.map +1 -0
  18. package/lib/cjs/dagster/index.cjs +32 -0
  19. package/lib/cjs/dagster/index.cjs.map +1 -0
  20. package/lib/cjs/engine/constants.cjs +6 -1
  21. package/lib/cjs/engine/constants.cjs.map +1 -1
  22. package/lib/cjs/engine/execution/GraphCodeMode.cjs +137 -0
  23. package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -0
  24. package/lib/cjs/engine/execution/GraphExecutionBackend.cjs +89 -0
  25. package/lib/cjs/engine/execution/GraphExecutionBackend.cjs.map +1 -0
  26. package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs +107 -0
  27. package/lib/cjs/engine/execution/GraphExecutionBackendRegistry.cjs.map +1 -0
  28. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +250 -733
  29. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  30. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs +804 -0
  31. package/lib/cjs/engine/execution/LocalGraphExecutionBackend.cjs.map +1 -0
  32. package/lib/cjs/engine/execution/index.cjs +4 -0
  33. package/lib/cjs/engine/execution/index.cjs.map +1 -1
  34. package/lib/cjs/engine/index.cjs +5 -0
  35. package/lib/cjs/engine/index.cjs.map +1 -1
  36. package/lib/cjs/engine/loops/ConditionEvaluator.cjs +116 -0
  37. package/lib/cjs/engine/loops/ConditionEvaluator.cjs.map +1 -0
  38. package/lib/cjs/engine/loops/GraphConditionEvaluator.cjs +25 -2
  39. package/lib/cjs/engine/loops/GraphConditionEvaluator.cjs.map +1 -1
  40. package/lib/cjs/engine/loops/index.cjs +1 -0
  41. package/lib/cjs/engine/loops/index.cjs.map +1 -1
  42. package/lib/cjs/engine/runs/GraphRunService.cjs +121 -3
  43. package/lib/cjs/engine/runs/GraphRunService.cjs.map +1 -1
  44. package/lib/cjs/engine/runs/InMemoryGraphRunStore.cjs +33 -0
  45. package/lib/cjs/engine/runs/InMemoryGraphRunStore.cjs.map +1 -1
  46. package/lib/cjs/engine/runs/ownership.cjs +100 -11
  47. package/lib/cjs/engine/runs/ownership.cjs.map +1 -1
  48. package/lib/cjs/engine/services/GraphRunModelService.cjs +16 -0
  49. package/lib/cjs/engine/services/GraphRunModelService.cjs.map +1 -1
  50. package/lib/cjs/engine/services/GraphWorkflowService.cjs +153 -16
  51. package/lib/cjs/engine/services/GraphWorkflowService.cjs.map +1 -1
  52. package/lib/cjs/mastra/MastraCapabilities.cjs +171 -0
  53. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -0
  54. package/lib/cjs/mastra/MastraConditionBridge.cjs +39 -0
  55. package/lib/cjs/mastra/MastraConditionBridge.cjs.map +1 -0
  56. package/lib/cjs/mastra/MastraEventBridge.cjs +486 -0
  57. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -0
  58. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +351 -0
  59. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -0
  60. package/lib/cjs/mastra/MastraResumeGuard.cjs +127 -0
  61. package/lib/cjs/mastra/MastraResumeGuard.cjs.map +1 -0
  62. package/lib/cjs/mastra/MastraSchemaConverter.cjs +124 -0
  63. package/lib/cjs/mastra/MastraSchemaConverter.cjs.map +1 -0
  64. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +461 -0
  65. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -0
  66. package/lib/cjs/mastra/MastraWorkflowManager.cjs +401 -0
  67. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -0
  68. package/lib/cjs/mastra/index.cjs +35 -0
  69. package/lib/cjs/mastra/index.cjs.map +1 -0
  70. package/lib/cjs/mastra/types.cjs +34 -0
  71. package/lib/cjs/mastra/types.cjs.map +1 -0
  72. package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs +136 -0
  73. package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs.map +1 -0
  74. package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs +140 -0
  75. package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs.map +1 -0
  76. package/lib/cjs/nest/graph/GraphEngineController.cjs +227 -0
  77. package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -0
  78. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +30 -2
  79. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  80. package/lib/cjs/nest/graph/GraphRunController.cjs +208 -28
  81. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  82. package/lib/cjs/nest/graph/GraphWorkflowController.cjs +97 -14
  83. package/lib/cjs/nest/graph/GraphWorkflowController.cjs.map +1 -1
  84. package/lib/cjs/nest/graph/index.cjs +3 -0
  85. package/lib/cjs/nest/graph/index.cjs.map +1 -1
  86. package/lib/cjs/nest/graph/main.cjs +54 -0
  87. package/lib/cjs/nest/graph/main.cjs.map +1 -0
  88. package/lib/cjs/nest/graph/servingDates.cjs +53 -0
  89. package/lib/cjs/nest/graph/servingDates.cjs.map +1 -0
  90. package/lib/cjs/nest/graph/servingErrors.cjs +68 -0
  91. package/lib/cjs/nest/graph/servingErrors.cjs.map +1 -0
  92. package/lib/cjs/node/flow/if/node.cjs +27 -9
  93. package/lib/cjs/node/flow/if/node.cjs.map +1 -1
  94. package/lib/cjs/node/flow/loop/until/node.cjs +5 -2
  95. package/lib/cjs/node/flow/loop/until/node.cjs.map +1 -1
  96. package/lib/cjs/node/flow/loop/while/node.cjs +8 -2
  97. package/lib/cjs/node/flow/loop/while/node.cjs.map +1 -1
  98. package/lib/cjs/node/flow/switch/node.cjs +2 -37
  99. package/lib/cjs/node/flow/switch/node.cjs.map +1 -1
  100. package/lib/cjs/node/utility/code/node.cjs +11 -3
  101. package/lib/cjs/node/utility/code/node.cjs.map +1 -1
  102. package/lib/cjs/ram/GraphRunStore.cjs +14 -0
  103. package/lib/cjs/ram/GraphRunStore.cjs.map +1 -1
  104. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +2 -3
  105. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  106. package/lib/cjs/shared/graph/constants.cjs +8 -0
  107. package/lib/cjs/shared/graph/constants.cjs.map +1 -1
  108. package/lib/cjs/shared/graph/index.cjs +2 -1
  109. package/lib/cjs/shared/graph/index.cjs.map +1 -1
  110. package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs +146 -0
  111. package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs.map +1 -0
  112. package/lib/cjs/shared/graph/layout/index.cjs +23 -0
  113. package/lib/cjs/shared/graph/layout/index.cjs.map +1 -0
  114. package/lib/cjs/shared/graph/layout/layout-options.cjs +93 -0
  115. package/lib/cjs/shared/graph/layout/layout-options.cjs.map +1 -0
  116. package/lib/cjs/shared/ui/index.cjs +8 -10
  117. package/lib/cjs/shared/ui/index.cjs.map +1 -1
  118. package/lib/esm/dagster/DagsterGraphEventBridge.js +339 -0
  119. package/lib/esm/dagster/DagsterGraphEventBridge.js.map +1 -0
  120. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +781 -0
  121. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -0
  122. package/lib/esm/dagster/DagsterResultMapper.js +51 -0
  123. package/lib/esm/dagster/DagsterResultMapper.js.map +1 -0
  124. package/lib/esm/dagster/DagsterTypes.js +2 -0
  125. package/lib/esm/dagster/DagsterTypes.js.map +1 -0
  126. package/lib/esm/dagster/capabilities.js +97 -0
  127. package/lib/esm/dagster/capabilities.js.map +1 -0
  128. package/lib/esm/dagster/constants.js +88 -0
  129. package/lib/esm/dagster/constants.js.map +1 -0
  130. package/lib/esm/dagster/index.js +15 -0
  131. package/lib/esm/dagster/index.js.map +1 -0
  132. package/lib/esm/engine/constants.js +5 -0
  133. package/lib/esm/engine/constants.js.map +1 -1
  134. package/lib/esm/engine/execution/GraphCodeMode.js +132 -0
  135. package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -0
  136. package/lib/esm/engine/execution/GraphExecutionBackend.js +83 -0
  137. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -0
  138. package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js +102 -0
  139. package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js.map +1 -0
  140. package/lib/esm/engine/execution/GraphExecutionEngine.js +232 -716
  141. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  142. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +799 -0
  143. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -0
  144. package/lib/esm/engine/execution/index.js +4 -0
  145. package/lib/esm/engine/execution/index.js.map +1 -1
  146. package/lib/esm/engine/index.js +5 -0
  147. package/lib/esm/engine/index.js.map +1 -1
  148. package/lib/esm/engine/loops/ConditionEvaluator.js +108 -0
  149. package/lib/esm/engine/loops/ConditionEvaluator.js.map +1 -0
  150. package/lib/esm/engine/loops/GraphConditionEvaluator.js +25 -2
  151. package/lib/esm/engine/loops/GraphConditionEvaluator.js.map +1 -1
  152. package/lib/esm/engine/loops/index.js +1 -0
  153. package/lib/esm/engine/loops/index.js.map +1 -1
  154. package/lib/esm/engine/runs/GraphRunService.js +123 -5
  155. package/lib/esm/engine/runs/GraphRunService.js.map +1 -1
  156. package/lib/esm/engine/runs/InMemoryGraphRunStore.js +33 -0
  157. package/lib/esm/engine/runs/InMemoryGraphRunStore.js.map +1 -1
  158. package/lib/esm/engine/runs/ownership.js +97 -11
  159. package/lib/esm/engine/runs/ownership.js.map +1 -1
  160. package/lib/esm/engine/services/GraphRunModelService.js +16 -0
  161. package/lib/esm/engine/services/GraphRunModelService.js.map +1 -1
  162. package/lib/esm/engine/services/GraphWorkflowService.js +155 -18
  163. package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
  164. package/lib/esm/mastra/MastraCapabilities.js +164 -0
  165. package/lib/esm/mastra/MastraCapabilities.js.map +1 -0
  166. package/lib/esm/mastra/MastraConditionBridge.js +34 -0
  167. package/lib/esm/mastra/MastraConditionBridge.js.map +1 -0
  168. package/lib/esm/mastra/MastraEventBridge.js +481 -0
  169. package/lib/esm/mastra/MastraEventBridge.js.map +1 -0
  170. package/lib/esm/mastra/MastraGraphExecutionBackend.js +346 -0
  171. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -0
  172. package/lib/esm/mastra/MastraResumeGuard.js +123 -0
  173. package/lib/esm/mastra/MastraResumeGuard.js.map +1 -0
  174. package/lib/esm/mastra/MastraSchemaConverter.js +119 -0
  175. package/lib/esm/mastra/MastraSchemaConverter.js.map +1 -0
  176. package/lib/esm/mastra/MastraWorkflowCompiler.js +456 -0
  177. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -0
  178. package/lib/esm/mastra/MastraWorkflowManager.js +396 -0
  179. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -0
  180. package/lib/esm/mastra/index.js +18 -0
  181. package/lib/esm/mastra/index.js.map +1 -0
  182. package/lib/esm/mastra/types.js +30 -0
  183. package/lib/esm/mastra/types.js.map +1 -0
  184. package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js +129 -0
  185. package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js.map +1 -0
  186. package/lib/esm/nest/graph/GraphEngineCapabilityService.js +131 -0
  187. package/lib/esm/nest/graph/GraphEngineCapabilityService.js.map +1 -0
  188. package/lib/esm/nest/graph/GraphEngineController.js +218 -0
  189. package/lib/esm/nest/graph/GraphEngineController.js.map +1 -0
  190. package/lib/esm/nest/graph/GraphExecutionModule.js +30 -2
  191. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  192. package/lib/esm/nest/graph/GraphRunController.js +209 -29
  193. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  194. package/lib/esm/nest/graph/GraphWorkflowController.js +98 -15
  195. package/lib/esm/nest/graph/GraphWorkflowController.js.map +1 -1
  196. package/lib/esm/nest/graph/index.js +3 -0
  197. package/lib/esm/nest/graph/index.js.map +1 -1
  198. package/lib/esm/nest/graph/main.js +51 -0
  199. package/lib/esm/nest/graph/main.js.map +1 -0
  200. package/lib/esm/nest/graph/servingDates.js +49 -0
  201. package/lib/esm/nest/graph/servingDates.js.map +1 -0
  202. package/lib/esm/nest/graph/servingErrors.js +63 -0
  203. package/lib/esm/nest/graph/servingErrors.js.map +1 -0
  204. package/lib/esm/node/flow/if/node.js +27 -9
  205. package/lib/esm/node/flow/if/node.js.map +1 -1
  206. package/lib/esm/node/flow/loop/until/node.js +5 -2
  207. package/lib/esm/node/flow/loop/until/node.js.map +1 -1
  208. package/lib/esm/node/flow/loop/while/node.js +8 -2
  209. package/lib/esm/node/flow/loop/while/node.js.map +1 -1
  210. package/lib/esm/node/flow/switch/node.js +2 -37
  211. package/lib/esm/node/flow/switch/node.js.map +1 -1
  212. package/lib/esm/node/utility/code/node.js +11 -3
  213. package/lib/esm/node/utility/code/node.js.map +1 -1
  214. package/lib/esm/ram/GraphRunStore.js +14 -0
  215. package/lib/esm/ram/GraphRunStore.js.map +1 -1
  216. package/lib/esm/shared/graph/GraphExecutionStateMapper.js.map +1 -1
  217. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +2 -3
  218. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  219. package/lib/esm/shared/graph/constants.js +8 -0
  220. package/lib/esm/shared/graph/constants.js.map +1 -1
  221. package/lib/esm/shared/graph/document/GraphFlowBuilder.js.map +1 -1
  222. package/lib/esm/shared/graph/index.js +2 -1
  223. package/lib/esm/shared/graph/index.js.map +1 -1
  224. package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js +107 -0
  225. package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js.map +1 -0
  226. package/lib/esm/shared/graph/layout/index.js +6 -0
  227. package/lib/esm/shared/graph/layout/index.js.map +1 -0
  228. package/lib/esm/shared/graph/layout/layout-options.js +96 -0
  229. package/lib/esm/shared/graph/layout/layout-options.js.map +1 -0
  230. package/lib/esm/shared/ui/index.js +8 -10
  231. package/lib/esm/shared/ui/index.js.map +1 -1
  232. package/lib/types/dagster/DagsterGraphEventBridge.d.cts +142 -0
  233. package/lib/types/dagster/DagsterGraphEventBridge.d.mts +142 -0
  234. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +323 -0
  235. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +323 -0
  236. package/lib/types/dagster/DagsterResultMapper.d.cts +50 -0
  237. package/lib/types/dagster/DagsterResultMapper.d.mts +50 -0
  238. package/lib/types/dagster/DagsterTypes.d.cts +355 -0
  239. package/lib/types/dagster/DagsterTypes.d.mts +355 -0
  240. package/lib/types/dagster/capabilities.d.cts +34 -0
  241. package/lib/types/dagster/capabilities.d.mts +34 -0
  242. package/lib/types/dagster/constants.d.cts +87 -0
  243. package/lib/types/dagster/constants.d.mts +87 -0
  244. package/lib/types/dagster/index.d.cts +14 -0
  245. package/lib/types/dagster/index.d.mts +14 -0
  246. package/lib/types/engine/constants.d.cts +5 -0
  247. package/lib/types/engine/constants.d.mts +5 -0
  248. package/lib/types/engine/execution/GraphCodeMode.d.cts +52 -0
  249. package/lib/types/engine/execution/GraphCodeMode.d.mts +52 -0
  250. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +306 -0
  251. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +306 -0
  252. package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.cts +59 -0
  253. package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.mts +59 -0
  254. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -135
  255. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -135
  256. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +232 -0
  257. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +232 -0
  258. package/lib/types/engine/execution/index.d.cts +4 -0
  259. package/lib/types/engine/execution/index.d.mts +4 -0
  260. package/lib/types/engine/index.d.cts +5 -0
  261. package/lib/types/engine/index.d.mts +5 -0
  262. package/lib/types/engine/loops/ConditionEvaluator.d.cts +87 -0
  263. package/lib/types/engine/loops/ConditionEvaluator.d.mts +87 -0
  264. package/lib/types/engine/loops/GraphConditionEvaluator.d.cts +27 -7
  265. package/lib/types/engine/loops/GraphConditionEvaluator.d.mts +27 -7
  266. package/lib/types/engine/loops/index.d.cts +1 -0
  267. package/lib/types/engine/loops/index.d.mts +1 -0
  268. package/lib/types/engine/runs/GraphRunService.d.cts +60 -1
  269. package/lib/types/engine/runs/GraphRunService.d.mts +60 -1
  270. package/lib/types/engine/runs/InMemoryGraphRunStore.d.cts +29 -0
  271. package/lib/types/engine/runs/InMemoryGraphRunStore.d.mts +29 -0
  272. package/lib/types/engine/runs/ownership.d.cts +89 -4
  273. package/lib/types/engine/runs/ownership.d.mts +89 -4
  274. package/lib/types/engine/runs/types.d.cts +12 -1
  275. package/lib/types/engine/runs/types.d.mts +12 -1
  276. package/lib/types/engine/services/GraphRunModelService.d.cts +13 -0
  277. package/lib/types/engine/services/GraphRunModelService.d.mts +13 -0
  278. package/lib/types/engine/services/GraphWorkflowService.d.cts +74 -2
  279. package/lib/types/engine/services/GraphWorkflowService.d.mts +74 -2
  280. package/lib/types/engine/types.d.cts +11 -4
  281. package/lib/types/engine/types.d.mts +11 -4
  282. package/lib/types/mastra/MastraCapabilities.d.cts +91 -0
  283. package/lib/types/mastra/MastraCapabilities.d.mts +91 -0
  284. package/lib/types/mastra/MastraConditionBridge.d.cts +38 -0
  285. package/lib/types/mastra/MastraConditionBridge.d.mts +38 -0
  286. package/lib/types/mastra/MastraEventBridge.d.cts +189 -0
  287. package/lib/types/mastra/MastraEventBridge.d.mts +189 -0
  288. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +119 -0
  289. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +119 -0
  290. package/lib/types/mastra/MastraResumeGuard.d.cts +58 -0
  291. package/lib/types/mastra/MastraResumeGuard.d.mts +58 -0
  292. package/lib/types/mastra/MastraSchemaConverter.d.cts +39 -0
  293. package/lib/types/mastra/MastraSchemaConverter.d.mts +39 -0
  294. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +218 -0
  295. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +218 -0
  296. package/lib/types/mastra/MastraWorkflowManager.d.cts +220 -0
  297. package/lib/types/mastra/MastraWorkflowManager.d.mts +220 -0
  298. package/lib/types/mastra/index.d.cts +17 -0
  299. package/lib/types/mastra/index.d.mts +17 -0
  300. package/lib/types/mastra/types.d.cts +222 -0
  301. package/lib/types/mastra/types.d.mts +222 -0
  302. package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.cts +87 -0
  303. package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.mts +87 -0
  304. package/lib/types/nest/graph/GraphEngineCapabilityService.d.cts +98 -0
  305. package/lib/types/nest/graph/GraphEngineCapabilityService.d.mts +98 -0
  306. package/lib/types/nest/graph/GraphEngineController.d.cts +74 -0
  307. package/lib/types/nest/graph/GraphEngineController.d.mts +74 -0
  308. package/lib/types/nest/graph/GraphExecutionModule.d.cts +14 -1
  309. package/lib/types/nest/graph/GraphExecutionModule.d.mts +14 -1
  310. package/lib/types/nest/graph/GraphRunController.d.cts +69 -14
  311. package/lib/types/nest/graph/GraphRunController.d.mts +69 -14
  312. package/lib/types/nest/graph/GraphWorkflowController.d.cts +50 -17
  313. package/lib/types/nest/graph/GraphWorkflowController.d.mts +50 -17
  314. package/lib/types/nest/graph/index.d.cts +3 -0
  315. package/lib/types/nest/graph/index.d.mts +3 -0
  316. package/lib/types/nest/graph/main.d.cts +1 -0
  317. package/lib/types/nest/graph/main.d.mts +1 -0
  318. package/lib/types/nest/graph/servingDates.d.cts +35 -0
  319. package/lib/types/nest/graph/servingDates.d.mts +35 -0
  320. package/lib/types/nest/graph/servingErrors.d.cts +44 -0
  321. package/lib/types/nest/graph/servingErrors.d.mts +44 -0
  322. package/lib/types/node/flow/if/node.d.cts +20 -8
  323. package/lib/types/node/flow/if/node.d.mts +20 -8
  324. package/lib/types/node/flow/loop/until/node.d.cts +4 -1
  325. package/lib/types/node/flow/loop/until/node.d.mts +4 -1
  326. package/lib/types/node/flow/loop/while/node.d.cts +4 -1
  327. package/lib/types/node/flow/loop/while/node.d.mts +4 -1
  328. package/lib/types/node/utility/code/node.d.cts +1 -1
  329. package/lib/types/node/utility/code/node.d.mts +1 -1
  330. package/lib/types/ram/GraphRunStore.d.cts +12 -0
  331. package/lib/types/ram/GraphRunStore.d.mts +12 -0
  332. package/lib/types/shared/graph/GraphExecutionStateMapper.d.cts +5 -5
  333. package/lib/types/shared/graph/GraphExecutionStateMapper.d.mts +5 -5
  334. package/lib/types/shared/graph/constants.d.cts +8 -0
  335. package/lib/types/shared/graph/constants.d.mts +8 -0
  336. package/lib/types/shared/graph/document/GraphFlowBuilder.d.cts +5 -5
  337. package/lib/types/shared/graph/document/GraphFlowBuilder.d.mts +5 -5
  338. package/lib/types/shared/graph/index.d.cts +2 -1
  339. package/lib/types/shared/graph/index.d.mts +2 -1
  340. package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.cts +49 -0
  341. package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.mts +49 -0
  342. package/lib/types/shared/graph/layout/index.d.cts +5 -0
  343. package/lib/types/shared/graph/layout/index.d.mts +5 -0
  344. package/lib/types/shared/graph/layout/layout-options.d.cts +46 -0
  345. package/lib/types/shared/graph/layout/layout-options.d.mts +46 -0
  346. package/lib/types/shared/graph/types.d.cts +12 -4
  347. package/lib/types/shared/graph/types.d.mts +12 -4
  348. package/lib/types/shared/ui/index.d.cts +8 -10
  349. package/lib/types/shared/ui/index.d.mts +8 -10
  350. package/package.json +49 -6
  351. package/lib/cjs/shared/ui/GraphNodeView.cjs +0 -114
  352. package/lib/cjs/shared/ui/GraphNodeView.cjs.map +0 -1
  353. package/lib/cjs/shared/ui/GraphRunView.cjs +0 -96
  354. package/lib/cjs/shared/ui/GraphRunView.cjs.map +0 -1
  355. package/lib/cjs/shared/ui/GraphWorkflowView.cjs +0 -78
  356. package/lib/cjs/shared/ui/GraphWorkflowView.cjs.map +0 -1
  357. package/lib/cjs/shared/ui/types.cjs +0 -4
  358. package/lib/cjs/shared/ui/types.cjs.map +0 -1
  359. package/lib/esm/shared/ui/GraphNodeView.js +0 -107
  360. package/lib/esm/shared/ui/GraphNodeView.js.map +0 -1
  361. package/lib/esm/shared/ui/GraphRunView.js +0 -90
  362. package/lib/esm/shared/ui/GraphRunView.js.map +0 -1
  363. package/lib/esm/shared/ui/GraphWorkflowView.js +0 -72
  364. package/lib/esm/shared/ui/GraphWorkflowView.js.map +0 -1
  365. package/lib/esm/shared/ui/types.js +0 -2
  366. package/lib/esm/shared/ui/types.js.map +0 -1
  367. package/lib/types/shared/ui/GraphNodeView.d.cts +0 -48
  368. package/lib/types/shared/ui/GraphNodeView.d.mts +0 -48
  369. package/lib/types/shared/ui/GraphRunView.d.cts +0 -88
  370. package/lib/types/shared/ui/GraphRunView.d.mts +0 -88
  371. package/lib/types/shared/ui/GraphWorkflowView.d.cts +0 -18
  372. package/lib/types/shared/ui/GraphWorkflowView.d.mts +0 -18
  373. package/lib/types/shared/ui/types.d.cts +0 -200
  374. package/lib/types/shared/ui/types.d.mts +0 -200
@@ -0,0 +1,17 @@
1
+ /**
2
+ * @module as-graph/mastra
3
+ * @summary Mastra graph execution backend barrel (SAA-196).
4
+ * @description Public surface of the `@decaf-ts/as-graph/mastra` entrypoint:
5
+ * the Mastra execution backend, the workflow compiler, the event bridge, the
6
+ * condition bridge, the schema converter, the resume guard, the capability
7
+ * table, and the shared types/ports.
8
+ */
9
+ export * from "./types.d.mts";
10
+ export * from "./MastraCapabilities.d.mts";
11
+ export * from "./MastraSchemaConverter.d.mts";
12
+ export * from "./MastraConditionBridge.d.mts";
13
+ export * from "./MastraEventBridge.d.mts";
14
+ export * from "./MastraWorkflowCompiler.d.mts";
15
+ export * from "./MastraWorkflowManager.d.mts";
16
+ export * from "./MastraResumeGuard.d.mts";
17
+ export * from "./MastraGraphExecutionBackend.d.mts";
@@ -0,0 +1,222 @@
1
+ /**
2
+ * @module as-graph/mastra/types
3
+ * @summary Mastra backend shared types, ports, and error codes (SAA-196).
4
+ * @description Contract surface of the `@mastra/core`-translated execution
5
+ * backend: the registered backend flavour, the fail-closed error codes, the
6
+ * host-provided node step handlers that own `createStep` translation, the
7
+ * backend configuration, and the suspend-state reader port Mastra resume relies
8
+ * on. Mastra owns execution state for suspended runs; these types only describe
9
+ * what the host injects and what resume auditing returns.
10
+ */
11
+ import type { Context, MaybeContextualArg } from "@decaf-ts/core";
12
+ import type { GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "../engine/execution/GraphExecutionBackend.d.cts";
13
+ import type { GraphExecutionValues, GraphRunId } from "../engine/types.d.cts";
14
+ import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.cts";
15
+ import type { MastraWorkflowCompiler } from "./MastraWorkflowCompiler.d.cts";
16
+ /** The flavour id the Mastra backend registers under in the backend registry. */
17
+ export declare const MASTRA_BACKEND_FLAVOUR = "mastra";
18
+ /** A document node kind the Mastra translator cannot represent. */
19
+ export declare const GRAPH_MASTRA_UNSUPPORTED_KIND = "GRAPH_MASTRA_UNSUPPORTED_KIND";
20
+ /** A suspendable step declared a missing or degraded resume schema. */
21
+ export declare const GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE = "GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE";
22
+ /** A resume request failed validation (size, JSON safety, schema, or step). */
23
+ export declare const GRAPH_MASTRA_RESUME_INVALID = "GRAPH_MASTRA_RESUME_INVALID";
24
+ /** The resume step or iteration index is not allowlisted by the document. */
25
+ export declare const GRAPH_MASTRA_RESUME_STEP_UNKNOWN = "GRAPH_MASTRA_RESUME_STEP_UNKNOWN";
26
+ /** The Mastra snapshot is not a suspended run of the current document. */
27
+ export declare const GRAPH_MASTRA_RESUME_STATE_INVALID = "GRAPH_MASTRA_RESUME_STATE_INVALID";
28
+ /** The document translation emitted non-JSON-safe Mastra config. */
29
+ export declare const GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE = "GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE";
30
+ /** No Mastra agent is available for an agent-backed node. */
31
+ export declare const GRAPH_MASTRA_AGENT_UNAVAILABLE = "GRAPH_MASTRA_AGENT_UNAVAILABLE";
32
+ /** The wired Mastra runtime exposes no workflow-management surface. */
33
+ export declare const GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE = "GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE";
34
+ /** A managed workflow id has no workflow registered on the runtime. */
35
+ export declare const GRAPH_MASTRA_WORKFLOW_NOT_FOUND = "GRAPH_MASTRA_WORKFLOW_NOT_FOUND";
36
+ /** Persisting a translated workflow to Mastra storage is not supported. */
37
+ export declare const GRAPH_MASTRA_PERSIST_NOT_SUPPORTED = "GRAPH_MASTRA_PERSIST_NOT_SUPPORTED";
38
+ /** A registered workflow exposes no serializable step graph. */
39
+ export declare const GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED = "GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED";
40
+ /**
41
+ * A management mutation targeted a workflow the caller may not write, or a host
42
+ * registration the wrapper did not create (C3 complete-mediation guard).
43
+ */
44
+ export declare const GRAPH_MASTRA_WORKFLOW_FORBIDDEN = "GRAPH_MASTRA_WORKFLOW_FORBIDDEN";
45
+ /**
46
+ * Execution context handed to a Mastra step handler for one node execution.
47
+ * The handler receives everything the document resolved for the node plus the
48
+ * Mastra-native suspension affordances.
49
+ */
50
+ export interface MastraNodeStepContext {
51
+ /** The document node being executed. */
52
+ nodeId: string;
53
+ /** The document node kind. */
54
+ kind: string;
55
+ /** Resolved node input values keyed by input port. */
56
+ inputData: GraphExecutionValues;
57
+ /** The workflow-level state accumulated so far. */
58
+ state: Record<string, unknown>;
59
+ /** Payload offered to a suspending step. */
60
+ suspendPayload?: unknown;
61
+ /** Resume payload supplied when a suspended step continues. */
62
+ resumeData?: unknown;
63
+ /** The Mastra-native runtime handle, when one is available. */
64
+ mastra?: unknown;
65
+ /** Mastra-native suspension callback for human-in-the-loop steps. */
66
+ suspend?: (payload?: unknown) => unknown;
67
+ }
68
+ /**
69
+ * Host-provided translator for one node kind. The backend has no built-in node
70
+ * executors: hosts register one handler per supported kind, and translation
71
+ * fails closed with {@link GRAPH_MASTRA_UNSUPPORTED_KIND} otherwise.
72
+ */
73
+ export interface MastraNodeStepHandler {
74
+ /** The document node kind this handler translates. */
75
+ kind: string;
76
+ /**
77
+ * Builds the Mastra step for one node instance.
78
+ * @param node - The document node instance to translate.
79
+ * @param options - Step options (`stepId` names the Mastra step).
80
+ * @returns The Mastra step object.
81
+ */
82
+ createStep(node: GraphNodeInstance, options: {
83
+ stepId: string;
84
+ }): unknown;
85
+ }
86
+ /**
87
+ * Configuration the host passes to {@link MastraGraphExecutionBackend.initialize}.
88
+ * Everything is host-injected; the backend never constructs Mastra primitives.
89
+ */
90
+ export interface MastraBackendConfig extends Record<string, unknown> {
91
+ /** The Mastra runtime used to create and load runs. */
92
+ mastra?: unknown;
93
+ /** Optional Mastra storage configuration. */
94
+ storage?: unknown;
95
+ /** Optional named agent map used by agent-backed node handlers. */
96
+ agents?: Record<string, unknown>;
97
+ /** Node-kind step handlers; replaces the compiler's default (empty) set. */
98
+ stepHandlers?: MastraNodeStepHandler[];
99
+ /** Optional workflow catalogue port backing list/lookup capabilities. */
100
+ workflowStore?: GraphBackendWorkflowStore;
101
+ /** Reader for Mastra-authoritative suspended-run snapshots (resume port). */
102
+ suspendStateReader?: MastraSuspendStateReader;
103
+ /** Maximum accepted serialised `resumeData` size, in bytes. */
104
+ maxResumeBytes?: number;
105
+ }
106
+ /**
107
+ * Mastra-authoritative snapshot of a suspended run as exposed by the host's
108
+ * suspend-state reader. Fields mirror {@link MastraResumeSnapshot} at the seam
109
+ * where the backend reads run state for resume.
110
+ */
111
+ export interface MastraRunSnapshotState {
112
+ /** Canonical run id. */
113
+ runId: GraphRunId;
114
+ /** Canonical workflow id. */
115
+ workflowId: string;
116
+ /** Fingerprint of the document the run was launched from. */
117
+ documentFingerprint: string;
118
+ /** Mastra run status; resume is only legal from `suspended`. */
119
+ status: string;
120
+ /** Mastra step ids the run suspended on. */
121
+ suspendedSteps: string[];
122
+ /** Per-iteration suspend index, keyed by suspended step id. */
123
+ suspendedForEachIndexes?: Record<string, number>;
124
+ }
125
+ /**
126
+ * Host port that reads the Mastra-authoritative suspended-run snapshot.
127
+ * Mastra owns execution state for suspended runs (gap-1); `GraphRunStore` is
128
+ * never consulted for resume.
129
+ */
130
+ export interface MastraSuspendStateReader {
131
+ /**
132
+ * Reads the suspended-run snapshot for a run.
133
+ * @param runId - The canonical run id.
134
+ * @param args - Optional decaf context arguments.
135
+ * @returns The snapshot, or `undefined` when the run has none.
136
+ */
137
+ readRunState(runId: GraphRunId, ...args: MaybeContextualArg<Context>): Promise<MastraRunSnapshotState | undefined>;
138
+ }
139
+ /** Host request to resume a suspended Mastra run. */
140
+ export interface MastraResumeRequest {
141
+ /** The suspended step to resume; defaults to the first suspended step. */
142
+ step?: string;
143
+ /** Resume payload validated against the suspended step's resume schema. */
144
+ resumeData?: Record<string, unknown>;
145
+ /** Iteration index to resume, for suspensions inside a `foreach`. */
146
+ forEachIndex?: number;
147
+ }
148
+ /**
149
+ * C18 audit record returned by a successful resume. Carries identity and
150
+ * provenance only; the raw `resumeData` is never logged or echoed.
151
+ */
152
+ export interface MastraResumeAudit {
153
+ /** Authenticated caller, when the host provided one. */
154
+ caller?: string | null;
155
+ /** The resumed run id. */
156
+ runId: GraphRunId;
157
+ /** The workflow id of the resumed run. */
158
+ workflowId?: string;
159
+ /** The resumed step id. */
160
+ step?: string;
161
+ /** The resumed iteration index, when the step is inside a `foreach`. */
162
+ forEachIndex?: number;
163
+ /** Stable hash of the accepted `resumeData`. */
164
+ resumeDataHash?: string;
165
+ /** Serialised size, in bytes, of the accepted `resumeData`. */
166
+ resumeDataBytes?: number;
167
+ /** ISO timestamp of the audit entry. */
168
+ at?: string;
169
+ }
170
+ /** How Mastra registered a workflow: declared in code or persisted dynamically. */
171
+ export type MastraWorkflowOrigin = "code" | "dynamic";
172
+ /**
173
+ * Structural port over the real `@mastra/core` `Mastra` workflow-management
174
+ * surface (1.74.0). Every method mirrors a real instance method; the wrapper
175
+ * never synthesizes one and fails closed when the wired runtime omits it.
176
+ */
177
+ export interface MastraWorkflowManagementRuntime {
178
+ /** Registers a committed workflow on the instance (real `addWorkflow`). */
179
+ addWorkflow?(workflow: unknown, key?: string): void;
180
+ /** Removes a registered workflow by key or id (real `removeWorkflow`). */
181
+ removeWorkflow?(keyOrId: string): boolean;
182
+ /** Reads a registered workflow by id (real `getWorkflow`). */
183
+ getWorkflow?(id: string, options?: {
184
+ serialized?: boolean;
185
+ }): unknown;
186
+ /** Lists the registered workflows (real `listWorkflows`). */
187
+ listWorkflows?(options?: {
188
+ serialized?: boolean;
189
+ }): Record<string, unknown>;
190
+ /** Reads how a workflow was registered (real `getWorkflowOrigin`). */
191
+ getWorkflowOrigin?(keyOrId: string): MastraWorkflowOrigin | undefined;
192
+ }
193
+ /** A managed workflow as surfaced by the management surface. */
194
+ export interface MastraWorkflowDescriptor {
195
+ /** Canonical workflow id. */
196
+ id: string;
197
+ /** Display name, when the registered workflow exposes one. */
198
+ name?: string;
199
+ /** How the workflow was registered, when the runtime reports it. */
200
+ origin?: MastraWorkflowOrigin;
201
+ /** Canonical document revision (fingerprint), when the wrapper tracked one. */
202
+ revision?: string;
203
+ }
204
+ /** The JSON-safe serialized form of a registered workflow. */
205
+ export interface MastraSerializedWorkflow {
206
+ /** Canonical workflow id. */
207
+ id: string;
208
+ /** Canonical document revision (fingerprint), when known. */
209
+ revision?: string;
210
+ /** The real Mastra `serializedStepGraph`. */
211
+ steps: unknown;
212
+ }
213
+ /** Options a {@link MastraWorkflowManager} is created with. */
214
+ export interface MastraWorkflowManagerOptions {
215
+ /** The wired real `@mastra/core` runtime (or `undefined` when unwired). */
216
+ runtime?: unknown;
217
+ /** The compiler used to translate canonical documents. */
218
+ compiler?: MastraWorkflowCompiler;
219
+ }
220
+ /** The Mastra backend specialised over its configuration type. */
221
+ export type MastraBackend = GraphExecutionBackend<MastraBackendConfig>;
222
+ export type { GraphBackendWorkflowSummary };
@@ -0,0 +1,222 @@
1
+ /**
2
+ * @module as-graph/mastra/types
3
+ * @summary Mastra backend shared types, ports, and error codes (SAA-196).
4
+ * @description Contract surface of the `@mastra/core`-translated execution
5
+ * backend: the registered backend flavour, the fail-closed error codes, the
6
+ * host-provided node step handlers that own `createStep` translation, the
7
+ * backend configuration, and the suspend-state reader port Mastra resume relies
8
+ * on. Mastra owns execution state for suspended runs; these types only describe
9
+ * what the host injects and what resume auditing returns.
10
+ */
11
+ import type { Context, MaybeContextualArg } from "@decaf-ts/core";
12
+ import type { GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "../engine/execution/GraphExecutionBackend.d.mts";
13
+ import type { GraphExecutionValues, GraphRunId } from "../engine/types.d.mts";
14
+ import type { GraphNodeInstance } from "../shared/graph/document/GraphNodeInstance.d.mts";
15
+ import type { MastraWorkflowCompiler } from "./MastraWorkflowCompiler.d.mts";
16
+ /** The flavour id the Mastra backend registers under in the backend registry. */
17
+ export declare const MASTRA_BACKEND_FLAVOUR = "mastra";
18
+ /** A document node kind the Mastra translator cannot represent. */
19
+ export declare const GRAPH_MASTRA_UNSUPPORTED_KIND = "GRAPH_MASTRA_UNSUPPORTED_KIND";
20
+ /** A suspendable step declared a missing or degraded resume schema. */
21
+ export declare const GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE = "GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE";
22
+ /** A resume request failed validation (size, JSON safety, schema, or step). */
23
+ export declare const GRAPH_MASTRA_RESUME_INVALID = "GRAPH_MASTRA_RESUME_INVALID";
24
+ /** The resume step or iteration index is not allowlisted by the document. */
25
+ export declare const GRAPH_MASTRA_RESUME_STEP_UNKNOWN = "GRAPH_MASTRA_RESUME_STEP_UNKNOWN";
26
+ /** The Mastra snapshot is not a suspended run of the current document. */
27
+ export declare const GRAPH_MASTRA_RESUME_STATE_INVALID = "GRAPH_MASTRA_RESUME_STATE_INVALID";
28
+ /** The document translation emitted non-JSON-safe Mastra config. */
29
+ export declare const GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE = "GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE";
30
+ /** No Mastra agent is available for an agent-backed node. */
31
+ export declare const GRAPH_MASTRA_AGENT_UNAVAILABLE = "GRAPH_MASTRA_AGENT_UNAVAILABLE";
32
+ /** The wired Mastra runtime exposes no workflow-management surface. */
33
+ export declare const GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE = "GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE";
34
+ /** A managed workflow id has no workflow registered on the runtime. */
35
+ export declare const GRAPH_MASTRA_WORKFLOW_NOT_FOUND = "GRAPH_MASTRA_WORKFLOW_NOT_FOUND";
36
+ /** Persisting a translated workflow to Mastra storage is not supported. */
37
+ export declare const GRAPH_MASTRA_PERSIST_NOT_SUPPORTED = "GRAPH_MASTRA_PERSIST_NOT_SUPPORTED";
38
+ /** A registered workflow exposes no serializable step graph. */
39
+ export declare const GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED = "GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED";
40
+ /**
41
+ * A management mutation targeted a workflow the caller may not write, or a host
42
+ * registration the wrapper did not create (C3 complete-mediation guard).
43
+ */
44
+ export declare const GRAPH_MASTRA_WORKFLOW_FORBIDDEN = "GRAPH_MASTRA_WORKFLOW_FORBIDDEN";
45
+ /**
46
+ * Execution context handed to a Mastra step handler for one node execution.
47
+ * The handler receives everything the document resolved for the node plus the
48
+ * Mastra-native suspension affordances.
49
+ */
50
+ export interface MastraNodeStepContext {
51
+ /** The document node being executed. */
52
+ nodeId: string;
53
+ /** The document node kind. */
54
+ kind: string;
55
+ /** Resolved node input values keyed by input port. */
56
+ inputData: GraphExecutionValues;
57
+ /** The workflow-level state accumulated so far. */
58
+ state: Record<string, unknown>;
59
+ /** Payload offered to a suspending step. */
60
+ suspendPayload?: unknown;
61
+ /** Resume payload supplied when a suspended step continues. */
62
+ resumeData?: unknown;
63
+ /** The Mastra-native runtime handle, when one is available. */
64
+ mastra?: unknown;
65
+ /** Mastra-native suspension callback for human-in-the-loop steps. */
66
+ suspend?: (payload?: unknown) => unknown;
67
+ }
68
+ /**
69
+ * Host-provided translator for one node kind. The backend has no built-in node
70
+ * executors: hosts register one handler per supported kind, and translation
71
+ * fails closed with {@link GRAPH_MASTRA_UNSUPPORTED_KIND} otherwise.
72
+ */
73
+ export interface MastraNodeStepHandler {
74
+ /** The document node kind this handler translates. */
75
+ kind: string;
76
+ /**
77
+ * Builds the Mastra step for one node instance.
78
+ * @param node - The document node instance to translate.
79
+ * @param options - Step options (`stepId` names the Mastra step).
80
+ * @returns The Mastra step object.
81
+ */
82
+ createStep(node: GraphNodeInstance, options: {
83
+ stepId: string;
84
+ }): unknown;
85
+ }
86
+ /**
87
+ * Configuration the host passes to {@link MastraGraphExecutionBackend.initialize}.
88
+ * Everything is host-injected; the backend never constructs Mastra primitives.
89
+ */
90
+ export interface MastraBackendConfig extends Record<string, unknown> {
91
+ /** The Mastra runtime used to create and load runs. */
92
+ mastra?: unknown;
93
+ /** Optional Mastra storage configuration. */
94
+ storage?: unknown;
95
+ /** Optional named agent map used by agent-backed node handlers. */
96
+ agents?: Record<string, unknown>;
97
+ /** Node-kind step handlers; replaces the compiler's default (empty) set. */
98
+ stepHandlers?: MastraNodeStepHandler[];
99
+ /** Optional workflow catalogue port backing list/lookup capabilities. */
100
+ workflowStore?: GraphBackendWorkflowStore;
101
+ /** Reader for Mastra-authoritative suspended-run snapshots (resume port). */
102
+ suspendStateReader?: MastraSuspendStateReader;
103
+ /** Maximum accepted serialised `resumeData` size, in bytes. */
104
+ maxResumeBytes?: number;
105
+ }
106
+ /**
107
+ * Mastra-authoritative snapshot of a suspended run as exposed by the host's
108
+ * suspend-state reader. Fields mirror {@link MastraResumeSnapshot} at the seam
109
+ * where the backend reads run state for resume.
110
+ */
111
+ export interface MastraRunSnapshotState {
112
+ /** Canonical run id. */
113
+ runId: GraphRunId;
114
+ /** Canonical workflow id. */
115
+ workflowId: string;
116
+ /** Fingerprint of the document the run was launched from. */
117
+ documentFingerprint: string;
118
+ /** Mastra run status; resume is only legal from `suspended`. */
119
+ status: string;
120
+ /** Mastra step ids the run suspended on. */
121
+ suspendedSteps: string[];
122
+ /** Per-iteration suspend index, keyed by suspended step id. */
123
+ suspendedForEachIndexes?: Record<string, number>;
124
+ }
125
+ /**
126
+ * Host port that reads the Mastra-authoritative suspended-run snapshot.
127
+ * Mastra owns execution state for suspended runs (gap-1); `GraphRunStore` is
128
+ * never consulted for resume.
129
+ */
130
+ export interface MastraSuspendStateReader {
131
+ /**
132
+ * Reads the suspended-run snapshot for a run.
133
+ * @param runId - The canonical run id.
134
+ * @param args - Optional decaf context arguments.
135
+ * @returns The snapshot, or `undefined` when the run has none.
136
+ */
137
+ readRunState(runId: GraphRunId, ...args: MaybeContextualArg<Context>): Promise<MastraRunSnapshotState | undefined>;
138
+ }
139
+ /** Host request to resume a suspended Mastra run. */
140
+ export interface MastraResumeRequest {
141
+ /** The suspended step to resume; defaults to the first suspended step. */
142
+ step?: string;
143
+ /** Resume payload validated against the suspended step's resume schema. */
144
+ resumeData?: Record<string, unknown>;
145
+ /** Iteration index to resume, for suspensions inside a `foreach`. */
146
+ forEachIndex?: number;
147
+ }
148
+ /**
149
+ * C18 audit record returned by a successful resume. Carries identity and
150
+ * provenance only; the raw `resumeData` is never logged or echoed.
151
+ */
152
+ export interface MastraResumeAudit {
153
+ /** Authenticated caller, when the host provided one. */
154
+ caller?: string | null;
155
+ /** The resumed run id. */
156
+ runId: GraphRunId;
157
+ /** The workflow id of the resumed run. */
158
+ workflowId?: string;
159
+ /** The resumed step id. */
160
+ step?: string;
161
+ /** The resumed iteration index, when the step is inside a `foreach`. */
162
+ forEachIndex?: number;
163
+ /** Stable hash of the accepted `resumeData`. */
164
+ resumeDataHash?: string;
165
+ /** Serialised size, in bytes, of the accepted `resumeData`. */
166
+ resumeDataBytes?: number;
167
+ /** ISO timestamp of the audit entry. */
168
+ at?: string;
169
+ }
170
+ /** How Mastra registered a workflow: declared in code or persisted dynamically. */
171
+ export type MastraWorkflowOrigin = "code" | "dynamic";
172
+ /**
173
+ * Structural port over the real `@mastra/core` `Mastra` workflow-management
174
+ * surface (1.74.0). Every method mirrors a real instance method; the wrapper
175
+ * never synthesizes one and fails closed when the wired runtime omits it.
176
+ */
177
+ export interface MastraWorkflowManagementRuntime {
178
+ /** Registers a committed workflow on the instance (real `addWorkflow`). */
179
+ addWorkflow?(workflow: unknown, key?: string): void;
180
+ /** Removes a registered workflow by key or id (real `removeWorkflow`). */
181
+ removeWorkflow?(keyOrId: string): boolean;
182
+ /** Reads a registered workflow by id (real `getWorkflow`). */
183
+ getWorkflow?(id: string, options?: {
184
+ serialized?: boolean;
185
+ }): unknown;
186
+ /** Lists the registered workflows (real `listWorkflows`). */
187
+ listWorkflows?(options?: {
188
+ serialized?: boolean;
189
+ }): Record<string, unknown>;
190
+ /** Reads how a workflow was registered (real `getWorkflowOrigin`). */
191
+ getWorkflowOrigin?(keyOrId: string): MastraWorkflowOrigin | undefined;
192
+ }
193
+ /** A managed workflow as surfaced by the management surface. */
194
+ export interface MastraWorkflowDescriptor {
195
+ /** Canonical workflow id. */
196
+ id: string;
197
+ /** Display name, when the registered workflow exposes one. */
198
+ name?: string;
199
+ /** How the workflow was registered, when the runtime reports it. */
200
+ origin?: MastraWorkflowOrigin;
201
+ /** Canonical document revision (fingerprint), when the wrapper tracked one. */
202
+ revision?: string;
203
+ }
204
+ /** The JSON-safe serialized form of a registered workflow. */
205
+ export interface MastraSerializedWorkflow {
206
+ /** Canonical workflow id. */
207
+ id: string;
208
+ /** Canonical document revision (fingerprint), when known. */
209
+ revision?: string;
210
+ /** The real Mastra `serializedStepGraph`. */
211
+ steps: unknown;
212
+ }
213
+ /** Options a {@link MastraWorkflowManager} is created with. */
214
+ export interface MastraWorkflowManagerOptions {
215
+ /** The wired real `@mastra/core` runtime (or `undefined` when unwired). */
216
+ runtime?: unknown;
217
+ /** The compiler used to translate canonical documents. */
218
+ compiler?: MastraWorkflowCompiler;
219
+ }
220
+ /** The Mastra backend specialised over its configuration type. */
221
+ export type MastraBackend = GraphExecutionBackend<MastraBackendConfig>;
222
+ export type { GraphBackendWorkflowSummary };
@@ -0,0 +1,87 @@
1
+ /**
2
+ * @module as-graph/nest/graph/GraphEngineCapabilityManifest
3
+ * @summary Server-side engine capability manifest (SAA-197, SAA-193 C20).
4
+ * @description Builds the read-only, statically-derived capability manifest the
5
+ * frontend consumes to toggle per-engine features/buttons. The manifest is derived
6
+ * exclusively from engine metadata — the registered
7
+ * {@link GraphExecutionBackend}s and the capability tables the Dagster/Mastra
8
+ * wrappers export — and is never probed against a remote engine and never read from
9
+ * the environment. Every `detail` is a static, reviewed literal (C20): no secrets,
10
+ * endpoints/DSNs, sandbox internals, infrastructure topology, or authorization
11
+ * internals are exposed.
12
+ */
13
+ import type { GraphBackendCapabilities, GraphExecutionBackend } from "../../engine/execution/GraphExecutionBackend.d.cts";
14
+ /**
15
+ * The normalized per-feature verdict served by the manifest. C20 defines exactly
16
+ * three verdicts; the wrapper tables' source spellings are normalized onto them
17
+ * (`supported`/`SUPPORTED` → `SUPPORTED`, `not_supported`/`NOT-SUPPORTED` →
18
+ * `NOT_SUPPORTED`, `extension_point`/`EXTENSION-POINT` → `EXTENSION_POINT`).
19
+ */
20
+ export type GraphEngineFeatureVerdict = "SUPPORTED" | "NOT_SUPPORTED" | "EXTENSION_POINT";
21
+ /** One engine feature row served by the manifest (C20). */
22
+ export interface GraphEngineFeature {
23
+ /** Feature identifier as declared by the engine's capability metadata. */
24
+ feature: string;
25
+ /** Normalized verdict (C20 three-value vocabulary). */
26
+ verdict: GraphEngineFeatureVerdict;
27
+ /** Static, reviewed human-readable detail; never dynamic engine output. */
28
+ detail?: string;
29
+ }
30
+ /** One engine entry served by the manifest (exact C20 shape). */
31
+ export interface GraphEngineDescriptor {
32
+ /** Allowlisted engine id (the backend flavour). */
33
+ engineId: string;
34
+ /** Human-readable engine name. */
35
+ displayName: string;
36
+ /** Whether the engine executes in-process. */
37
+ local: boolean;
38
+ /** Pinned engine version the wrapper targets. */
39
+ pinnedEngineVersion: string;
40
+ /** Feature/verdict rows derived from the engine's capability metadata. */
41
+ capabilities: GraphEngineFeature[];
42
+ }
43
+ /** The top-level capability manifest served to the frontend (exact C20 shape). */
44
+ export interface GraphEngineCapabilityManifest {
45
+ /** One entry per available (registered) engine. */
46
+ engines: GraphEngineDescriptor[];
47
+ /** Engine id the server defaults to. */
48
+ defaultEngineId: string;
49
+ }
50
+ /**
51
+ * Pinned `@mastra/core` engine version. Kept here because the Mastra wrapper
52
+ * exports only its feature table, not a version constant; the value mirrors the
53
+ * `@mastra/core` dependency pin in `as-graph/package.json` (`1.74.0`).
54
+ */
55
+ export declare const MASTRA_PINNED_VERSION = "1.74.0";
56
+ /**
57
+ * Normalizes a wrapper capability verdict onto the C20 three-value vocabulary.
58
+ * `PARTIAL` is deliberately downgraded to `NOT_SUPPORTED` (fail-closed): a
59
+ * partially-supported feature must never be advertised as a usable toggle.
60
+ *
61
+ * @param verdict - The wrapper table verdict string.
62
+ * @returns The normalized C20 verdict.
63
+ */
64
+ export declare function toGraphEngineFeatureVerdict(verdict: string): GraphEngineFeatureVerdict;
65
+ /**
66
+ * Derives the local engine's feature rows from the engine-agnostic
67
+ * {@link GraphBackendCapabilities} the built-in backend exposes, so the manifest
68
+ * never hand-maintains a separate local table.
69
+ *
70
+ * @param capabilities - The active backend's effective capability metadata.
71
+ * @returns The normalized feature rows for the local engine.
72
+ */
73
+ export declare function localEngineFeatures(capabilities: GraphBackendCapabilities): GraphEngineFeature[];
74
+ /**
75
+ * Builds the capability manifest from the registered backends, statically at boot.
76
+ * Only allowlisted flavours are advertised; the descriptors' `local` flag is read
77
+ * from the registered backend, and no remote engine is ever probed. The returned
78
+ * object is a fresh snapshot so a caller cannot mutate the served manifest.
79
+ *
80
+ * @param registered - The registered flavour/backend entries.
81
+ * @param defaultEngineId - Optional host-preferred default engine id.
82
+ * @returns The C20 capability manifest.
83
+ */
84
+ export declare function buildGraphEngineCapabilityManifest(registered: ReadonlyArray<{
85
+ flavour: string;
86
+ backend: GraphExecutionBackend<any>;
87
+ }>, defaultEngineId?: string): GraphEngineCapabilityManifest;
@@ -0,0 +1,87 @@
1
+ /**
2
+ * @module as-graph/nest/graph/GraphEngineCapabilityManifest
3
+ * @summary Server-side engine capability manifest (SAA-197, SAA-193 C20).
4
+ * @description Builds the read-only, statically-derived capability manifest the
5
+ * frontend consumes to toggle per-engine features/buttons. The manifest is derived
6
+ * exclusively from engine metadata — the registered
7
+ * {@link GraphExecutionBackend}s and the capability tables the Dagster/Mastra
8
+ * wrappers export — and is never probed against a remote engine and never read from
9
+ * the environment. Every `detail` is a static, reviewed literal (C20): no secrets,
10
+ * endpoints/DSNs, sandbox internals, infrastructure topology, or authorization
11
+ * internals are exposed.
12
+ */
13
+ import type { GraphBackendCapabilities, GraphExecutionBackend } from "../../engine/execution/GraphExecutionBackend.d.mts";
14
+ /**
15
+ * The normalized per-feature verdict served by the manifest. C20 defines exactly
16
+ * three verdicts; the wrapper tables' source spellings are normalized onto them
17
+ * (`supported`/`SUPPORTED` → `SUPPORTED`, `not_supported`/`NOT-SUPPORTED` →
18
+ * `NOT_SUPPORTED`, `extension_point`/`EXTENSION-POINT` → `EXTENSION_POINT`).
19
+ */
20
+ export type GraphEngineFeatureVerdict = "SUPPORTED" | "NOT_SUPPORTED" | "EXTENSION_POINT";
21
+ /** One engine feature row served by the manifest (C20). */
22
+ export interface GraphEngineFeature {
23
+ /** Feature identifier as declared by the engine's capability metadata. */
24
+ feature: string;
25
+ /** Normalized verdict (C20 three-value vocabulary). */
26
+ verdict: GraphEngineFeatureVerdict;
27
+ /** Static, reviewed human-readable detail; never dynamic engine output. */
28
+ detail?: string;
29
+ }
30
+ /** One engine entry served by the manifest (exact C20 shape). */
31
+ export interface GraphEngineDescriptor {
32
+ /** Allowlisted engine id (the backend flavour). */
33
+ engineId: string;
34
+ /** Human-readable engine name. */
35
+ displayName: string;
36
+ /** Whether the engine executes in-process. */
37
+ local: boolean;
38
+ /** Pinned engine version the wrapper targets. */
39
+ pinnedEngineVersion: string;
40
+ /** Feature/verdict rows derived from the engine's capability metadata. */
41
+ capabilities: GraphEngineFeature[];
42
+ }
43
+ /** The top-level capability manifest served to the frontend (exact C20 shape). */
44
+ export interface GraphEngineCapabilityManifest {
45
+ /** One entry per available (registered) engine. */
46
+ engines: GraphEngineDescriptor[];
47
+ /** Engine id the server defaults to. */
48
+ defaultEngineId: string;
49
+ }
50
+ /**
51
+ * Pinned `@mastra/core` engine version. Kept here because the Mastra wrapper
52
+ * exports only its feature table, not a version constant; the value mirrors the
53
+ * `@mastra/core` dependency pin in `as-graph/package.json` (`1.74.0`).
54
+ */
55
+ export declare const MASTRA_PINNED_VERSION = "1.74.0";
56
+ /**
57
+ * Normalizes a wrapper capability verdict onto the C20 three-value vocabulary.
58
+ * `PARTIAL` is deliberately downgraded to `NOT_SUPPORTED` (fail-closed): a
59
+ * partially-supported feature must never be advertised as a usable toggle.
60
+ *
61
+ * @param verdict - The wrapper table verdict string.
62
+ * @returns The normalized C20 verdict.
63
+ */
64
+ export declare function toGraphEngineFeatureVerdict(verdict: string): GraphEngineFeatureVerdict;
65
+ /**
66
+ * Derives the local engine's feature rows from the engine-agnostic
67
+ * {@link GraphBackendCapabilities} the built-in backend exposes, so the manifest
68
+ * never hand-maintains a separate local table.
69
+ *
70
+ * @param capabilities - The active backend's effective capability metadata.
71
+ * @returns The normalized feature rows for the local engine.
72
+ */
73
+ export declare function localEngineFeatures(capabilities: GraphBackendCapabilities): GraphEngineFeature[];
74
+ /**
75
+ * Builds the capability manifest from the registered backends, statically at boot.
76
+ * Only allowlisted flavours are advertised; the descriptors' `local` flag is read
77
+ * from the registered backend, and no remote engine is ever probed. The returned
78
+ * object is a fresh snapshot so a caller cannot mutate the served manifest.
79
+ *
80
+ * @param registered - The registered flavour/backend entries.
81
+ * @param defaultEngineId - Optional host-preferred default engine id.
82
+ * @returns The C20 capability manifest.
83
+ */
84
+ export declare function buildGraphEngineCapabilityManifest(registered: ReadonlyArray<{
85
+ flavour: string;
86
+ backend: GraphExecutionBackend<any>;
87
+ }>, defaultEngineId?: string): GraphEngineCapabilityManifest;