@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,98 @@
1
+ import type { Context, MaybeContextualArg } from "@decaf-ts/core";
2
+ import type { GraphBackendWorkflowSummary } from "../../engine/execution/GraphExecutionBackend.d.cts";
3
+ import type { GraphExecutionEngine } from "../../engine/execution/GraphExecutionEngine.d.cts";
4
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
5
+ import { type GraphEngineCapabilityManifest, type GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.cts";
6
+ /** DI token for {@link GraphEngineCapabilityOptions}. */
7
+ export declare const GRAPH_ENGINE_CAPABILITY_OPTIONS = "GRAPH_ENGINE_CAPABILITY_OPTIONS";
8
+ /** Rate-limit configuration for the engine capability routes: window and request cap. */
9
+ export interface GraphEngineRateLimitOptions {
10
+ windowMs?: number;
11
+ maxRequests?: number;
12
+ }
13
+ /**
14
+ * Default rate limit for the engine capability routes: 120 requests per 60-second
15
+ * window, applied by the `@nestjs/throttler` guard on the `engines` bucket.
16
+ */
17
+ export declare const DEFAULT_GRAPH_ENGINE_RATE_LIMIT: Required<GraphEngineRateLimitOptions>;
18
+ /**
19
+ * Options for the engine capability HTTP API (SAA-193 C20/C21): authentication
20
+ * mode, the host-preferred default engine id, and the engine-route rate limit.
21
+ */
22
+ export interface GraphEngineCapabilityOptions {
23
+ /**
24
+ * `"required"` (default) rejects a request with no request context, or with a
25
+ * context that carries no resolved owner user, with `401`, matching the other
26
+ * graph read routes; `"optional"` tolerates anonymous/system callers for
27
+ * standalone module runs.
28
+ */
29
+ auth?: "required" | "optional";
30
+ /**
31
+ * Engine id the manifest advertises as the default. Ignored when it is not one of
32
+ * the registered, allowlisted engine ids; the current backend flavour is used
33
+ * instead.
34
+ */
35
+ defaultEngineId?: string;
36
+ /** Rate limit for the engine capability routes (the `engines` throttler bucket). */
37
+ rateLimit?: GraphEngineRateLimitOptions;
38
+ }
39
+ /**
40
+ * Owns the boot-time capability manifest and resolves engine-scoped workflow
41
+ * listing/lookup. The manifest is built once in the constructor from the
42
+ * registered backends; request handling never mutates it and never probes a remote
43
+ * engine.
44
+ */
45
+ export declare class GraphEngineCapabilityService {
46
+ private readonly engine?;
47
+ private readonly manifest;
48
+ private readonly engineIds;
49
+ /**
50
+ * @param options - Controller options (auth, default engine id, rate limit).
51
+ * @param engine - The engine facade resolving flavour-scoped listing/lookup.
52
+ */
53
+ constructor(options?: GraphEngineCapabilityOptions, engine?: GraphExecutionEngine | undefined);
54
+ /**
55
+ * Returns a defensive copy of the statically-derived capability manifest.
56
+ *
57
+ * @returns The C20 capability manifest snapshot.
58
+ */
59
+ manifestSnapshot(): GraphEngineCapabilityManifest;
60
+ /**
61
+ * Returns a defensive copy of a single allowlisted engine descriptor.
62
+ *
63
+ * @param engineId - The engine id to look up.
64
+ * @returns The engine descriptor, or `undefined` when not allowlisted.
65
+ */
66
+ descriptor(engineId: string): GraphEngineDescriptor | undefined;
67
+ /**
68
+ * Whether the engine id is registered and allowlisted.
69
+ *
70
+ * @param engineId - The engine id to check.
71
+ * @returns `true` when the id is an available engine.
72
+ */
73
+ isKnownEngine(engineId: string): boolean;
74
+ /**
75
+ * Lists the workflows a registered engine can surface through the engine-agnostic
76
+ * facade, which applies the fail-closed capability gate and the
77
+ * `GRAPH_BACKEND_WORKFLOWS_NOT_SUPPORTED` error code.
78
+ *
79
+ * @param engineId - The allowlisted engine id to list for.
80
+ * @param args - Optional decaf contextual arguments forwarded to the backend.
81
+ * @returns Workflow summaries.
82
+ * @throws {GraphExecutionError} when the engine declares no listing support.
83
+ */
84
+ listWorkflows(engineId: string, ...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
85
+ /**
86
+ * Looks up a single canonical workflow document on a registered engine through
87
+ * the engine-agnostic facade.
88
+ *
89
+ * @param engineId - The allowlisted engine id to read from.
90
+ * @param workflowId - The canonical workflow id to read.
91
+ * @param args - Optional decaf contextual arguments forwarded to the backend.
92
+ * @returns The canonical workflow document.
93
+ * @throws {GraphExecutionError} when the engine declares no lookup support.
94
+ */
95
+ getWorkflow(engineId: string, workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
96
+ /** Resolves the engine facade, failing closed when it is not wired. */
97
+ private requireEngine;
98
+ }
@@ -0,0 +1,98 @@
1
+ import type { Context, MaybeContextualArg } from "@decaf-ts/core";
2
+ import type { GraphBackendWorkflowSummary } from "../../engine/execution/GraphExecutionBackend.d.mts";
3
+ import type { GraphExecutionEngine } from "../../engine/execution/GraphExecutionEngine.d.mts";
4
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
5
+ import { type GraphEngineCapabilityManifest, type GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.mts";
6
+ /** DI token for {@link GraphEngineCapabilityOptions}. */
7
+ export declare const GRAPH_ENGINE_CAPABILITY_OPTIONS = "GRAPH_ENGINE_CAPABILITY_OPTIONS";
8
+ /** Rate-limit configuration for the engine capability routes: window and request cap. */
9
+ export interface GraphEngineRateLimitOptions {
10
+ windowMs?: number;
11
+ maxRequests?: number;
12
+ }
13
+ /**
14
+ * Default rate limit for the engine capability routes: 120 requests per 60-second
15
+ * window, applied by the `@nestjs/throttler` guard on the `engines` bucket.
16
+ */
17
+ export declare const DEFAULT_GRAPH_ENGINE_RATE_LIMIT: Required<GraphEngineRateLimitOptions>;
18
+ /**
19
+ * Options for the engine capability HTTP API (SAA-193 C20/C21): authentication
20
+ * mode, the host-preferred default engine id, and the engine-route rate limit.
21
+ */
22
+ export interface GraphEngineCapabilityOptions {
23
+ /**
24
+ * `"required"` (default) rejects a request with no request context, or with a
25
+ * context that carries no resolved owner user, with `401`, matching the other
26
+ * graph read routes; `"optional"` tolerates anonymous/system callers for
27
+ * standalone module runs.
28
+ */
29
+ auth?: "required" | "optional";
30
+ /**
31
+ * Engine id the manifest advertises as the default. Ignored when it is not one of
32
+ * the registered, allowlisted engine ids; the current backend flavour is used
33
+ * instead.
34
+ */
35
+ defaultEngineId?: string;
36
+ /** Rate limit for the engine capability routes (the `engines` throttler bucket). */
37
+ rateLimit?: GraphEngineRateLimitOptions;
38
+ }
39
+ /**
40
+ * Owns the boot-time capability manifest and resolves engine-scoped workflow
41
+ * listing/lookup. The manifest is built once in the constructor from the
42
+ * registered backends; request handling never mutates it and never probes a remote
43
+ * engine.
44
+ */
45
+ export declare class GraphEngineCapabilityService {
46
+ private readonly engine?;
47
+ private readonly manifest;
48
+ private readonly engineIds;
49
+ /**
50
+ * @param options - Controller options (auth, default engine id, rate limit).
51
+ * @param engine - The engine facade resolving flavour-scoped listing/lookup.
52
+ */
53
+ constructor(options?: GraphEngineCapabilityOptions, engine?: GraphExecutionEngine | undefined);
54
+ /**
55
+ * Returns a defensive copy of the statically-derived capability manifest.
56
+ *
57
+ * @returns The C20 capability manifest snapshot.
58
+ */
59
+ manifestSnapshot(): GraphEngineCapabilityManifest;
60
+ /**
61
+ * Returns a defensive copy of a single allowlisted engine descriptor.
62
+ *
63
+ * @param engineId - The engine id to look up.
64
+ * @returns The engine descriptor, or `undefined` when not allowlisted.
65
+ */
66
+ descriptor(engineId: string): GraphEngineDescriptor | undefined;
67
+ /**
68
+ * Whether the engine id is registered and allowlisted.
69
+ *
70
+ * @param engineId - The engine id to check.
71
+ * @returns `true` when the id is an available engine.
72
+ */
73
+ isKnownEngine(engineId: string): boolean;
74
+ /**
75
+ * Lists the workflows a registered engine can surface through the engine-agnostic
76
+ * facade, which applies the fail-closed capability gate and the
77
+ * `GRAPH_BACKEND_WORKFLOWS_NOT_SUPPORTED` error code.
78
+ *
79
+ * @param engineId - The allowlisted engine id to list for.
80
+ * @param args - Optional decaf contextual arguments forwarded to the backend.
81
+ * @returns Workflow summaries.
82
+ * @throws {GraphExecutionError} when the engine declares no listing support.
83
+ */
84
+ listWorkflows(engineId: string, ...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
85
+ /**
86
+ * Looks up a single canonical workflow document on a registered engine through
87
+ * the engine-agnostic facade.
88
+ *
89
+ * @param engineId - The allowlisted engine id to read from.
90
+ * @param workflowId - The canonical workflow id to read.
91
+ * @param args - Optional decaf contextual arguments forwarded to the backend.
92
+ * @returns The canonical workflow document.
93
+ * @throws {GraphExecutionError} when the engine declares no lookup support.
94
+ */
95
+ getWorkflow(engineId: string, workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
96
+ /** Resolves the engine facade, failing closed when it is not wired. */
97
+ private requireEngine;
98
+ }
@@ -0,0 +1,74 @@
1
+ import { DecafRequestContext } from "@decaf-ts/for-nest";
2
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
3
+ import type { GraphEngineCapabilityManifest, GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.cts";
4
+ import { GraphEngineCapabilityService, type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.cts";
5
+ /** One row of the engine workflow list: the serving summary a list binds to. */
6
+ export interface GraphEngineWorkflowSummary {
7
+ /** Canonical workflow id. */
8
+ workflowId: string;
9
+ /** Display name mirrored from the document, when present. */
10
+ name?: string;
11
+ /** ISO timestamp of the last update, when the backend exposes one. */
12
+ updatedAt?: string;
13
+ }
14
+ /**
15
+ * Engine capability manifest and engine-scoped workflow catalogue endpoints:
16
+ *
17
+ * - `GET /graph/engines` — the C20 capability manifest for every available
18
+ * (registered, allowlisted) engine.
19
+ * - `GET /graph/engines/{engineId}` — one engine descriptor.
20
+ * - `GET /graph/engines/{engineId}/workflows` — the workflows that engine
21
+ * surfaces through the engine-agnostic facade.
22
+ * - `GET /graph/engines/{engineId}/workflows/{workflowId}` — one canonical
23
+ * workflow document from that engine.
24
+ *
25
+ * All routes are read-only `GET`s, select engines by allowlisted id only, and
26
+ * never reflect arbitrary query input.
27
+ */
28
+ export declare class GraphEngineController {
29
+ private readonly capabilityService;
30
+ private readonly requestContext?;
31
+ private readonly options;
32
+ constructor(capabilityService: GraphEngineCapabilityService, requestContext?: DecafRequestContext | undefined, options?: GraphEngineCapabilityOptions);
33
+ /**
34
+ * Enforces the configured authentication mode: `auth` defaults to `"required"`
35
+ * and rejects a request with no request context, or with a context that carries
36
+ * no resolved owner user, with `401`; `"optional"` admits anonymous requests.
37
+ */
38
+ private requireAuthenticatedContext;
39
+ private assertKnownEngine;
40
+ /**
41
+ * Returns the capability manifest for every available engine.
42
+ *
43
+ * @return {Promise<GraphEngineCapabilityManifest>} The C20 capability manifest.
44
+ * @throws {HttpException} 401 without an authenticated caller.
45
+ */
46
+ getManifest(): Promise<GraphEngineCapabilityManifest>;
47
+ /**
48
+ * Returns one allowlisted engine's capability descriptor.
49
+ *
50
+ * @param {string} engineId - Allowlisted engine id path parameter.
51
+ * @return {Promise<GraphEngineDescriptor>} The engine descriptor.
52
+ * @throws {HttpException} 404 when the engine id is not available.
53
+ */
54
+ getEngine(engineId: string): Promise<GraphEngineDescriptor>;
55
+ /**
56
+ * Lists the workflows the selected engine surfaces through the
57
+ * engine-agnostic facade.
58
+ *
59
+ * @param {string} engineId - Allowlisted engine id path parameter.
60
+ * @return {Promise<GraphEngineWorkflowSummary[]>} Workflow summaries.
61
+ * @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no listing support.
62
+ */
63
+ listWorkflows(engineId: string): Promise<GraphEngineWorkflowSummary[]>;
64
+ /**
65
+ * Returns one canonical workflow document from the selected engine through the
66
+ * engine-agnostic facade.
67
+ *
68
+ * @param {string} engineId - Allowlisted engine id path parameter.
69
+ * @param {string} workflowId - Canonical workflow id path parameter.
70
+ * @return {Promise<GraphWorkflowDocument>} The canonical workflow document.
71
+ * @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no lookup support.
72
+ */
73
+ getWorkflow(engineId: string, workflowId: string): Promise<GraphWorkflowDocument>;
74
+ }
@@ -0,0 +1,74 @@
1
+ import { DecafRequestContext } from "@decaf-ts/for-nest";
2
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
3
+ import type { GraphEngineCapabilityManifest, GraphEngineDescriptor } from "./GraphEngineCapabilityManifest.d.mts";
4
+ import { GraphEngineCapabilityService, type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.mts";
5
+ /** One row of the engine workflow list: the serving summary a list binds to. */
6
+ export interface GraphEngineWorkflowSummary {
7
+ /** Canonical workflow id. */
8
+ workflowId: string;
9
+ /** Display name mirrored from the document, when present. */
10
+ name?: string;
11
+ /** ISO timestamp of the last update, when the backend exposes one. */
12
+ updatedAt?: string;
13
+ }
14
+ /**
15
+ * Engine capability manifest and engine-scoped workflow catalogue endpoints:
16
+ *
17
+ * - `GET /graph/engines` — the C20 capability manifest for every available
18
+ * (registered, allowlisted) engine.
19
+ * - `GET /graph/engines/{engineId}` — one engine descriptor.
20
+ * - `GET /graph/engines/{engineId}/workflows` — the workflows that engine
21
+ * surfaces through the engine-agnostic facade.
22
+ * - `GET /graph/engines/{engineId}/workflows/{workflowId}` — one canonical
23
+ * workflow document from that engine.
24
+ *
25
+ * All routes are read-only `GET`s, select engines by allowlisted id only, and
26
+ * never reflect arbitrary query input.
27
+ */
28
+ export declare class GraphEngineController {
29
+ private readonly capabilityService;
30
+ private readonly requestContext?;
31
+ private readonly options;
32
+ constructor(capabilityService: GraphEngineCapabilityService, requestContext?: DecafRequestContext | undefined, options?: GraphEngineCapabilityOptions);
33
+ /**
34
+ * Enforces the configured authentication mode: `auth` defaults to `"required"`
35
+ * and rejects a request with no request context, or with a context that carries
36
+ * no resolved owner user, with `401`; `"optional"` admits anonymous requests.
37
+ */
38
+ private requireAuthenticatedContext;
39
+ private assertKnownEngine;
40
+ /**
41
+ * Returns the capability manifest for every available engine.
42
+ *
43
+ * @return {Promise<GraphEngineCapabilityManifest>} The C20 capability manifest.
44
+ * @throws {HttpException} 401 without an authenticated caller.
45
+ */
46
+ getManifest(): Promise<GraphEngineCapabilityManifest>;
47
+ /**
48
+ * Returns one allowlisted engine's capability descriptor.
49
+ *
50
+ * @param {string} engineId - Allowlisted engine id path parameter.
51
+ * @return {Promise<GraphEngineDescriptor>} The engine descriptor.
52
+ * @throws {HttpException} 404 when the engine id is not available.
53
+ */
54
+ getEngine(engineId: string): Promise<GraphEngineDescriptor>;
55
+ /**
56
+ * Lists the workflows the selected engine surfaces through the
57
+ * engine-agnostic facade.
58
+ *
59
+ * @param {string} engineId - Allowlisted engine id path parameter.
60
+ * @return {Promise<GraphEngineWorkflowSummary[]>} Workflow summaries.
61
+ * @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no listing support.
62
+ */
63
+ listWorkflows(engineId: string): Promise<GraphEngineWorkflowSummary[]>;
64
+ /**
65
+ * Returns one canonical workflow document from the selected engine through the
66
+ * engine-agnostic facade.
67
+ *
68
+ * @param {string} engineId - Allowlisted engine id path parameter.
69
+ * @param {string} workflowId - Canonical workflow id path parameter.
70
+ * @return {Promise<GraphWorkflowDocument>} The canonical workflow document.
71
+ * @throws {HttpException} 404 for an unknown engine id, 501 when the engine declares no lookup support.
72
+ */
73
+ getWorkflow(engineId: string, workflowId: string): Promise<GraphWorkflowDocument>;
74
+ }
@@ -15,7 +15,9 @@ import { type GraphCredentialAuthorizer, type GraphNamespaceMatchOptions } from
15
15
  import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.cts";
16
16
  import { type GraphRunControllerOptions } from "./GraphRunController.d.cts";
17
17
  import type { GraphWorkflowServiceOptions } from "../../engine/services/GraphEnvironment.d.cts";
18
+ import type { GraphRunServiceOptions } from "../../engine/runs/GraphRunService.d.cts";
18
19
  import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.cts";
20
+ import { type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.cts";
19
21
  /**
20
22
  * Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
21
23
  * plus per-API (catalogue, workflows, runs) authentication and limit
@@ -51,8 +53,19 @@ export interface GraphExecutionModuleOptions {
51
53
  /**
52
54
  * Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
53
55
  * authentication enforcement and backend-enforced run resource limits.
56
+ * The service-level `allowAnonymousAccess` tolerance is supplied through the
57
+ * intersected {@link GraphRunServiceOptions} and forwarded to
58
+ * {@link GraphRunService}; it is intentionally not a controller option
59
+ * (SAA-93 F3).
54
60
  */
55
- runs?: GraphRunControllerOptions;
61
+ runs?: GraphRunControllerOptions & GraphRunServiceOptions;
62
+ /**
63
+ * Options for the engine capability HTTP API (SAA-197, SAA-193 C20/C21):
64
+ * authentication mode, the advertised default engine id, and the engine-route
65
+ * rate limit. The capability manifest is derived statically at boot from the
66
+ * registered backends and never read from the environment or a remote engine.
67
+ */
68
+ engines?: GraphEngineCapabilityOptions;
56
69
  /**
57
70
  * Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
58
71
  * their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
@@ -15,7 +15,9 @@ import { type GraphCredentialAuthorizer, type GraphNamespaceMatchOptions } from
15
15
  import { type GraphCatalogueControllerOptions } from "./GraphNodeCatalogueController.d.mts";
16
16
  import { type GraphRunControllerOptions } from "./GraphRunController.d.mts";
17
17
  import type { GraphWorkflowServiceOptions } from "../../engine/services/GraphEnvironment.d.mts";
18
+ import type { GraphRunServiceOptions } from "../../engine/runs/GraphRunService.d.mts";
18
19
  import { type GraphWorkflowControllerOptions } from "./GraphWorkflowController.d.mts";
20
+ import { type GraphEngineCapabilityOptions } from "./GraphEngineCapabilityService.d.mts";
19
21
  /**
20
22
  * Options for {@link GraphExecutionModule.forRoot}: adapter bootstrapping
21
23
  * plus per-API (catalogue, workflows, runs) authentication and limit
@@ -51,8 +53,19 @@ export interface GraphExecutionModuleOptions {
51
53
  /**
52
54
  * Options for the asynchronous run lifecycle API (DECAF-50 §4.14–§4.15):
53
55
  * authentication enforcement and backend-enforced run resource limits.
56
+ * The service-level `allowAnonymousAccess` tolerance is supplied through the
57
+ * intersected {@link GraphRunServiceOptions} and forwarded to
58
+ * {@link GraphRunService}; it is intentionally not a controller option
59
+ * (SAA-93 F3).
54
60
  */
55
- runs?: GraphRunControllerOptions;
61
+ runs?: GraphRunControllerOptions & GraphRunServiceOptions;
62
+ /**
63
+ * Options for the engine capability HTTP API (SAA-197, SAA-193 C20/C21):
64
+ * authentication mode, the advertised default engine id, and the engine-route
65
+ * rate limit. The capability manifest is derived statically at boot from the
66
+ * registered backends and never read from the environment or a remote engine.
67
+ */
68
+ engines?: GraphEngineCapabilityOptions;
56
69
  /**
57
70
  * Production hosts MUST wire a {@link GraphCredentialAuthorizer} backed by
58
71
  * their credential store (DECAF-50 §4.8 stage 8). Without it, stage-8
@@ -5,7 +5,8 @@
5
5
  * (`GET /graph/runs/:runId`), cancels (`DELETE /graph/runs/:runId`), and
6
6
  * replays (`SSE /graph/runs/:runId/events`) graph runs on top of
7
7
  * {@link GraphRunService}, enforcing authentication, run limits, and
8
- * ownership; engine errors surface as `500` with their message while Nest
8
+ * ownership; unmapped engine errors surface as a constant generic `500`
9
+ * (the underlying error is logged server-side only) while Nest
9
10
  * {@link HttpException}s pass through unchanged.
10
11
  */
11
12
  import { MessageEvent } from "@nestjs/common";
@@ -15,38 +16,46 @@ import { DecafRequestContext } from "@decaf-ts/for-nest";
15
16
  import type { GraphRunLimits } from "../../shared/graph/index.d.cts";
16
17
  import type { GraphExecutionValues } from "../..//index.d.cts";
17
18
  import { GraphRunService } from "../..//index.d.cts";
19
+ import { GraphWorkflowService } from "../../engine/services/GraphWorkflowService.d.cts";
18
20
  /** DI token for {@link GraphRunControllerOptions}. */
19
21
  export declare const GRAPH_RUN_OPTIONS = "GRAPH_RUN_OPTIONS";
20
22
  /** Options for the run lifecycle HTTP API (DECAF-50 §4.14–§4.15): authentication mode and run limits. */
21
23
  export interface GraphRunControllerOptions {
22
24
  /**
23
25
  * Whether an authenticated request context is required (default
24
- * `"required"`, SAA-595 secure-defaults alignment). `"optional"` admits
25
- * anonymous requests for standalone module runs (DECAF-48 §4.15) — pair it
26
- * with an explicit `allowAnonymousAccess` decision.
26
+ * `"required"`, SAA-595 secure-defaults alignment). `"required"` rejects a
27
+ * request with no request context **and** a request whose context carries no
28
+ * resolved owner user with `401` (SAA-93 F2): in a host that installs the
29
+ * request-context machinery a context exists for every request, so gating on
30
+ * context existence alone would admit unauthenticated callers as anonymous.
31
+ * `"optional"` admits anonymous requests for standalone module runs
32
+ * (DECAF-48 §4.15) — pair it with an explicit `allowAnonymousAccess`
33
+ * decision on the run service options.
27
34
  */
28
35
  auth?: "required" | "optional";
29
- /**
30
- * Explicit DECAF-48 §4.15 standalone tolerance: when `true`, anonymous
31
- * callers are tolerated on owned runs. Defaults to `false` — ownership
32
- * checks fail closed for absent identities (SAA-595 F3).
33
- */
34
- allowAnonymousAccess?: boolean;
35
36
  /** Run limits forwarded to {@link GraphRunService}. */
36
37
  limits?: GraphRunLimits;
37
38
  }
38
39
  /** Response of `POST /graph/runs`: the queued run's identity and its event/result URLs. */
39
40
  export interface GraphRunCreatedResponse {
41
+ /** Queued run's id. */
40
42
  runId: string;
43
+ /** Id of the workflow the run executes. */
41
44
  workflowId: string;
45
+ /** Constant `"queued"`: the run is scheduled, not yet started. */
42
46
  status: "queued";
47
+ /** SSE stream URL for the run's event envelopes. */
43
48
  eventsUrl: string;
49
+ /** Read URL for the run's lifecycle state. */
44
50
  resultUrl: string;
45
51
  }
46
52
  /** Request body for creating a run: an inline workflow document or a saved `workflowId`, plus optional inputs. */
47
53
  export interface GraphRunRequestBody {
54
+ /** Inline workflow document to execute, when not referencing a saved workflow. */
48
55
  workflow?: GraphWorkflowDocument;
56
+ /** Saved workflow id to execute, when no inline document is provided. */
49
57
  workflowId?: string;
58
+ /** Optional execution inputs forwarded to the run. */
50
59
  inputs?: GraphExecutionValues;
51
60
  }
52
61
  /**
@@ -59,16 +68,24 @@ export interface GraphRunRequestBody {
59
68
  */
60
69
  export declare class GraphRunController {
61
70
  private readonly runService;
71
+ private readonly workflowService;
62
72
  private readonly requestContext?;
63
73
  private readonly options;
64
- constructor(runService: GraphRunService, requestContext?: DecafRequestContext | undefined, options?: GraphRunControllerOptions);
74
+ constructor(runService: GraphRunService, workflowService: GraphWorkflowService, requestContext?: DecafRequestContext | undefined, options?: GraphRunControllerOptions);
65
75
  /**
66
76
  * Enforces the configured authentication mode: `auth` defaults to
67
- * `"required"` (SAA-595 secure-defaults alignment) and rejects
68
- * unauthenticated calls with `401`; `"optional"` admits anonymous
69
- * requests for standalone module runs (DECAF-48 §4.15).
77
+ * `"required"` (SAA-595 secure-defaults alignment) and rejects a request
78
+ * with no request context, or with a context that carries no resolved owner
79
+ * user, with `401` (SAA-93 F2); `"optional"` admits anonymous requests
80
+ * for standalone module runs (DECAF-48 §4.15).
70
81
  */
71
82
  private requireAuthenticatedContext;
83
+ /**
84
+ * Resolves the requesting caller's identity from the injected request
85
+ * context via {@link graphWorkflowOwnerOf}; `null` for anonymous callers.
86
+ *
87
+ * @return {string | null} The authenticated owner user, or `null` when absent.
88
+ */
72
89
  private ownerUserOf;
73
90
  /**
74
91
  * Concurrency-bucket key for the per-caller run cap: the authenticated
@@ -87,9 +104,34 @@ export declare class GraphRunController {
87
104
  * else a single shared anonymous bucket (SAA-595 F4, SAA-1950 F7).
88
105
  */
89
106
  createRun(body: GraphRunRequestBody): Promise<GraphRunCreatedResponse>;
107
+ /**
108
+ * Lists a workflow's past runs, newest first (DECAF-50 §4.14).
109
+ *
110
+ * The workflow itself is access-checked first (unknown → `404`, foreign
111
+ * owner → `403`), then the persisted `GraphRunModel` rows for that workflow
112
+ * are ownership-filtered and returned as their JSON rows. Each row carries
113
+ * `runId`, `workflowId`, `owner`, `status`, `documentFingerprint`,
114
+ * `inputs`, `result`, `error`, `createdAt`, `updatedAt`, `startedAt` and
115
+ * `finishedAt` (dates as ISO strings; optional members are omitted when
116
+ * unset). The `inputs`/`result`/`error` payload members are served only
117
+ * for rows the caller owns (SAA-93 F1): a caller that may see an
118
+ * owner-less row by the documented owner-less visibility contract but does
119
+ * not own it receives the summary-only projection. Rows whose required
120
+ * dates cannot be projected are skipped per row (SAA-93 F4). Auth follows
121
+ * the controller's configured `auth` mode.
122
+ *
123
+ * @param {string} workflowId - Workflow id path parameter.
124
+ * @return {Promise<Array<Record<string, unknown>>>} The workflow's runs, newest first.
125
+ * @throws {HttpException} The mapped graph-run HTTP error (404 for unknown workflows/runs, 403 for foreign owners, 401 without an authenticated caller).
126
+ */
127
+ listRuns(workflowId: string): Promise<Record<string, unknown>[]>;
90
128
  /**
91
129
  * Reads a run and maps it to its HTTP representation.
92
130
  *
131
+ * The run's `result`/`error` payload is projected out for a caller that
132
+ * does not own the run (SAA-93 F1): the summary-only projection the list
133
+ * path applies cannot be bypassed by reading the run by id.
134
+ *
93
135
  * @param {string} runId - Run id path parameter.
94
136
  * @return {Promise<Record<string, unknown>>} The run's HTTP shape.
95
137
  * @throws {HttpException} The mapped graph-run HTTP error (404 for unknown runs, 403 for foreign owners).
@@ -108,11 +150,24 @@ export declare class GraphRunController {
108
150
  * `afterSequence`, then streams live events until the terminal event type
109
151
  * completes the stream.
110
152
  *
153
+ * SAA-93 F1: a caller that may see an owner-less run by the documented
154
+ * owner-less visibility contract but does not own it receives envelopes with
155
+ * the `payload`/`error` members projected out, matching the list and
156
+ * single-read projections.
157
+ *
111
158
  * @param {string} runId - Run id path parameter.
112
159
  * @param {string} [afterSequence] - Sequence number to replay events after.
113
160
  * @return {Promise<Observable<MessageEvent>>} The SSE event stream.
114
161
  * @throws {HttpException} The mapped graph-run HTTP error (404 for unknown runs, 403 for foreign owners).
115
162
  */
116
163
  events(runId: string, afterSequence?: string): Promise<Observable<MessageEvent>>;
164
+ /**
165
+ * Parses the SSE replay cursor: `0` for absent/empty values, otherwise the
166
+ * parsed non-negative integer.
167
+ *
168
+ * @param {string | undefined} afterSequence - Raw `afterSequence` query parameter.
169
+ * @return {number} The sequence number to replay events after.
170
+ * @throws {HttpException} `400` when the value is not a non-negative integer.
171
+ */
117
172
  private parseAfterSequence;
118
173
  }