@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,87 @@
1
+ /**
2
+ * @module as-graph/loops/ConditionEvaluator
3
+ * @summary Shared dispatch for graphical and code conditions (DECAF-32 §22.3–22.4).
4
+ * @description The single authority that evaluates a condition carried by any
5
+ * flow-control node (if, elseIf, while, until, switch):
6
+ *
7
+ * - a `ConditionExpression` (graphical mode) is dispatched to the
8
+ * {@link ConditionExpressionEvaluator};
9
+ * - a `CodeCondition` (code mode) is dispatched to the pluggable
10
+ * `CodeSandboxEvaluator` registered on `GraphExecutionEngineConfig`.
11
+ *
12
+ * Extracted from the switch node so the if node and the loop condition evaluator
13
+ * reuse exactly the same semantics — including the
14
+ * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` failure mode — instead of duplicating it.
15
+ */
16
+ import type { Condition, ConditionExpression, CodeCondition } from "../../shared/graph/index.d.mts";
17
+ import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
18
+ /**
19
+ * Detects whether a condition is a {@link CodeCondition} (code mode) by checking
20
+ * for a `type` field equal to `"code"`.
21
+ *
22
+ * @param condition - The condition to inspect.
23
+ * @returns `true` when the condition is a `CodeCondition`.
24
+ */
25
+ export declare function isCodeCondition(condition: unknown): condition is CodeCondition;
26
+ /**
27
+ * Detects whether a condition is a {@link ConditionExpression} (graphical mode) by
28
+ * checking for a string `op` field.
29
+ *
30
+ * @param condition - The condition to inspect.
31
+ * @returns `true` when the condition is a `ConditionExpression`.
32
+ */
33
+ export declare function isConditionExpression(condition: unknown): condition is ConditionExpression;
34
+ /**
35
+ * Evaluates a {@link CodeCondition} through the `CodeSandboxEvaluator` registered
36
+ * on the execution engine (DECAF-32 §22.4).
37
+ *
38
+ * The sandbox context exposes the run's `$input`, `$vars`, `$item`, `$index`, and
39
+ * `$node` values, mirroring the switch node. When no evaluator is registered the
40
+ * call fails with `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`, the same failure mode as
41
+ * every other code-mode condition path.
42
+ *
43
+ * @param condition - The code condition to evaluate.
44
+ * @param input - The value map exposed to the sandbox as `$input`.
45
+ * @param context - The run-scoped execution context.
46
+ * @returns `true` when the sandbox result is truthy.
47
+ * @throws {GraphExecutionError} When no evaluator is registered or the sandbox fails.
48
+ */
49
+ export declare function evaluateCodeCondition(condition: CodeCondition, input: Record<string, unknown>, context: GraphExecutionContext): Promise<boolean>;
50
+ /**
51
+ * Options for {@link evaluateCondition}.
52
+ */
53
+ export interface ConditionEvaluationOptions {
54
+ /** The value map exposed to code conditions as `$input`. */
55
+ input: Record<string, unknown>;
56
+ /** The state a graphical `ConditionExpression` resolves against. */
57
+ state: unknown;
58
+ /**
59
+ * Human label for the carrier used in the unknown-condition error message
60
+ * (e.g. `"switch case"`, `"if"`, `"loop"`).
61
+ */
62
+ label?: string;
63
+ }
64
+ /**
65
+ * Evaluates a graphical {@link ConditionExpression} synchronously, throwing for
66
+ * any other shape. Used by synchronous executors that must preserve their
67
+ * synchronous throw contract for graphical conditions.
68
+ *
69
+ * @param condition - The condition to evaluate.
70
+ * @param state - The state a graphical `ConditionExpression` resolves against.
71
+ * @param label - Human label for the carrier used in the unknown-condition error.
72
+ * @returns `true` when the expression matches.
73
+ * @throws {GraphExecutionError} When the condition is not a `ConditionExpression`.
74
+ */
75
+ export declare function evaluateConditionSync(condition: unknown, state: unknown, label?: string): boolean;
76
+ /**
77
+ * Evaluates a {@link Condition} carried by any flow-control node, dispatching
78
+ * graphical expressions to the {@link ConditionExpressionEvaluator} and code
79
+ * conditions to the registered `CodeSandboxEvaluator`.
80
+ *
81
+ * @param condition - The condition to evaluate.
82
+ * @param options - The sandbox input, graphical state, and error label.
83
+ * @param context - The run-scoped execution context.
84
+ * @returns `true` when the condition matches.
85
+ * @throws {GraphExecutionError} When the condition shape is unknown.
86
+ */
87
+ export declare function evaluateCondition(condition: Condition, options: ConditionEvaluationOptions, context: GraphExecutionContext): Promise<boolean>;
@@ -1,15 +1,18 @@
1
1
  /**
2
2
  * @module as-graph/loops/GraphConditionEvaluator
3
- * @summary Evaluator for built-in loop condition types and the `ConditionExpression` DSL.
4
- * @description Supports safe, built-in condition types only. Does NOT evaluate arbitrary JavaScript expressions.
5
- * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
6
- * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
3
+ * @summary Evaluator for built-in loop condition types, the `ConditionExpression` DSL, and `CodeCondition` code mode.
4
+ * @description Supports safe, built-in condition types, the declarative `ConditionExpression` DSL, and — through the
5
+ * shared {@link evaluateCondition} dispatch — pluggable `CodeCondition` code mode. When the condition object carries an
6
+ * `op` field (ALFRED-5 §8 / DECAF-32 §22.3) it dispatches to the {@link ConditionExpressionEvaluator}; when it carries
7
+ * `type: "code"` (DECAF-32 §22.4) it dispatches to the registered `CodeSandboxEvaluator`; otherwise the built-in
8
+ * `type`-based switch is used.
7
9
  */
8
- import type { GraphConditionDefinition } from "../types.d.cts";
10
+ import type { GraphConditionDefinition, LoopCondition } from "../types.d.cts";
9
11
  import type { ConditionExpression } from "../../shared/graph/index.d.cts";
12
+ import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
10
13
  /**
11
- * Evaluates loop conditions using built-in comparison types or the
12
- * `ConditionExpression` DSL.
14
+ * Evaluates loop conditions using built-in comparison types, the
15
+ * `ConditionExpression` DSL, or the pluggable code sandbox.
13
16
  */
14
17
  export declare class GraphConditionEvaluator {
15
18
  private readonly expressionEvaluator;
@@ -26,6 +29,23 @@ export declare class GraphConditionEvaluator {
26
29
  * @returns `true` when the condition passes.
27
30
  */
28
31
  evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
32
+ /**
33
+ * Evaluates a loop condition that may be a built-in `GraphConditionDefinition`,
34
+ * a graphical `ConditionExpression`, or a code `CodeCondition`.
35
+ *
36
+ * `CodeCondition` evaluation is asynchronous (it runs through the pluggable
37
+ * `CodeSandboxEvaluator`), so the loop nodes call this method instead of the
38
+ * synchronous {@link evaluate}. Graphical and built-in conditions delegate to
39
+ * {@link evaluate} unchanged.
40
+ *
41
+ * @param condition - The condition definition.
42
+ * @param state - The current loop state (the graphical resolution root).
43
+ * @param context - The run-scoped execution context.
44
+ * @param input - The value map exposed to code conditions as `$input`.
45
+ * @returns `true` when the condition passes.
46
+ * @throws {GraphExecutionError} When no code sandbox evaluator is registered.
47
+ */
48
+ evaluateAsync(condition: LoopCondition, state: unknown, context: GraphExecutionContext, input: Record<string, unknown>): Promise<boolean>;
29
49
  /**
30
50
  * Resolves a value that may be a dotted path into the state object.
31
51
  */
@@ -1,15 +1,18 @@
1
1
  /**
2
2
  * @module as-graph/loops/GraphConditionEvaluator
3
- * @summary Evaluator for built-in loop condition types and the `ConditionExpression` DSL.
4
- * @description Supports safe, built-in condition types only. Does NOT evaluate arbitrary JavaScript expressions.
5
- * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
6
- * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
3
+ * @summary Evaluator for built-in loop condition types, the `ConditionExpression` DSL, and `CodeCondition` code mode.
4
+ * @description Supports safe, built-in condition types, the declarative `ConditionExpression` DSL, and — through the
5
+ * shared {@link evaluateCondition} dispatch — pluggable `CodeCondition` code mode. When the condition object carries an
6
+ * `op` field (ALFRED-5 §8 / DECAF-32 §22.3) it dispatches to the {@link ConditionExpressionEvaluator}; when it carries
7
+ * `type: "code"` (DECAF-32 §22.4) it dispatches to the registered `CodeSandboxEvaluator`; otherwise the built-in
8
+ * `type`-based switch is used.
7
9
  */
8
- import type { GraphConditionDefinition } from "../types.d.mts";
10
+ import type { GraphConditionDefinition, LoopCondition } from "../types.d.mts";
9
11
  import type { ConditionExpression } from "../../shared/graph/index.d.mts";
12
+ import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
10
13
  /**
11
- * Evaluates loop conditions using built-in comparison types or the
12
- * `ConditionExpression` DSL.
14
+ * Evaluates loop conditions using built-in comparison types, the
15
+ * `ConditionExpression` DSL, or the pluggable code sandbox.
13
16
  */
14
17
  export declare class GraphConditionEvaluator {
15
18
  private readonly expressionEvaluator;
@@ -26,6 +29,23 @@ export declare class GraphConditionEvaluator {
26
29
  * @returns `true` when the condition passes.
27
30
  */
28
31
  evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
32
+ /**
33
+ * Evaluates a loop condition that may be a built-in `GraphConditionDefinition`,
34
+ * a graphical `ConditionExpression`, or a code `CodeCondition`.
35
+ *
36
+ * `CodeCondition` evaluation is asynchronous (it runs through the pluggable
37
+ * `CodeSandboxEvaluator`), so the loop nodes call this method instead of the
38
+ * synchronous {@link evaluate}. Graphical and built-in conditions delegate to
39
+ * {@link evaluate} unchanged.
40
+ *
41
+ * @param condition - The condition definition.
42
+ * @param state - The current loop state (the graphical resolution root).
43
+ * @param context - The run-scoped execution context.
44
+ * @param input - The value map exposed to code conditions as `$input`.
45
+ * @returns `true` when the condition passes.
46
+ * @throws {GraphExecutionError} When no code sandbox evaluator is registered.
47
+ */
48
+ evaluateAsync(condition: LoopCondition, state: unknown, context: GraphExecutionContext, input: Record<string, unknown>): Promise<boolean>;
29
49
  /**
30
50
  * Resolves a value that may be a dotted path into the state object.
31
51
  */
@@ -4,5 +4,6 @@
4
4
  * @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
5
5
  */
6
6
  export * from "./GraphConditionEvaluator.d.cts";
7
+ export * from "./ConditionEvaluator.d.cts";
7
8
  export * from "./ConditionExpressionEvaluator.d.cts";
8
9
  export * from "./GraphLoopExecutionContext.d.cts";
@@ -4,5 +4,6 @@
4
4
  * @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
5
5
  */
6
6
  export * from "./GraphConditionEvaluator.d.mts";
7
+ export * from "./ConditionEvaluator.d.mts";
7
8
  export * from "./ConditionExpressionEvaluator.d.mts";
8
9
  export * from "./GraphLoopExecutionContext.d.mts";
@@ -1,7 +1,9 @@
1
1
  import type { Context, MaybeContextualArg } from "@decaf-ts/core";
2
2
  import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
3
+ import type { GraphResumeAudit, GraphResumeRequest } from "../execution/GraphExecutionBackend.d.cts";
3
4
  import { type GraphRunEventEnvelope, type GraphRunLimits } from "../../shared/graph/index.d.cts";
4
5
  import { type GraphRun, type GraphRunCreateRequest, type GraphRunDocumentResolver, type GraphRunEventStore, type GraphRunStore } from "./types.d.cts";
6
+ import type { GraphRunModel } from "../../shared/graph/index.d.cts";
5
7
  /** Construction options for {@link GraphRunService}. */
6
8
  export interface GraphRunServiceOptions {
7
9
  /** Run limits (timeouts, event payload caps, concurrency); defaults from {@link DEFAULT_GRAPH_RUN_LIMITS}. */
@@ -22,7 +24,8 @@ export interface GraphRunServiceOptions {
22
24
  * observes graph runs on top of a {@link GraphRunStore} and
23
25
  * {@link GraphRunEventStore}. Enforces per-caller run limits (concurrency
24
26
  * buckets keyed by owner or caller key, timeout, event payload size), scopes
25
- * every read/cancel to the owning user, auto-releases retained event state
27
+ * every read to the owning user, authorizes cancellation by strict owner
28
+ * equality (SAA-105 R3), auto-releases retained event state
26
29
  * after the configured replay window (SAA-595), and exposes the sequenced
27
30
  * event stream the SSE controller replays.
28
31
  */
@@ -56,11 +59,58 @@ export declare class GraphRunService {
56
59
  createRun(request: GraphRunCreateRequest, ownerUser: string | null, concurrencyKey?: string, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
57
60
  /** Reads a run, asserting it belongs to `ownerUser`. */
58
61
  getRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
62
+ /**
63
+ * Lists the persisted run rows for a workflow document, scoped to the
64
+ * requesting owner and ordered newest first.
65
+ *
66
+ * The collection is ownership-filtered with
67
+ * {@link canAccessGraphResource}: owner-less runs stay visible to everyone,
68
+ * a named caller sees their own plus owner-less runs, and an anonymous caller
69
+ * without the explicit `allowAnonymousAccess` tolerance sees only owner-less
70
+ * runs (SAA-595). The persisted {@link GraphRunModel} rows are returned so
71
+ * the HTTP boundary can serve the frontend-safe listing shape.
72
+ *
73
+ * The newest-first sort is corrupt-date-safe (SAA-93 R2): a row whose
74
+ * `updatedAt` is missing or not a valid `Date` is treated as oldest
75
+ * (epoch `0`) instead of producing `NaN` comparisons that would make the
76
+ * ordering of adjacent rows undefined.
77
+ *
78
+ * @param {string} workflowId - Workflow document id to list runs for.
79
+ * @param {string | null} ownerUser - Identity of the requesting caller.
80
+ * @param args - An optional decaf `Context` forwarded to the store.
81
+ * @return {Promise<GraphRunModel[]>} The workflow's runs, newest first.
82
+ * @throws Re-throws any store failure from {@link GraphRunStore.listRuns}.
83
+ */
84
+ listRunsByWorkflow(workflowId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunModel[]>;
59
85
  /**
60
86
  * Cancels a non-terminal run: aborts in-flight execution and persists the
61
87
  * `cancelled` status. Terminal runs are returned unchanged.
88
+ *
89
+ * Cancellation is a write and is authorized by strict owner equality
90
+ * ({@link assertGraphResourceWriteOwnership}, SAA-105 R3): only the run's
91
+ * recorded owner may cancel it. A named caller can no longer cancel an
92
+ * owner-less run, and the read-visibility tolerance `allowAnonymousAccess`
93
+ * never grants a cancellation.
62
94
  */
63
95
  cancelRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
96
+ /**
97
+ * Resumes a suspended run: resolves the run, asserts strict owner equality on
98
+ * the write path ({@link assertGraphResourceWriteOwnership}, SAA-105 R3), then
99
+ * delegates to the active backend's optional SAA-196 `resume?()` extension and
100
+ * audits the accepted resume through the event publisher (C18). A backend without
101
+ * the extension fails closed rather than silently no-op.
102
+ *
103
+ * C14: resume is exposed only through this service, behind the owner-equality
104
+ * write gate — never from an HTTP route. The standing SAA-200 hardening rule
105
+ * holds here too: a {@link GraphExecutionError} thrown by the backend is
106
+ * re-thrown without its `details` so no server-side state leaks to clients.
107
+ *
108
+ * @throws NotFoundError when no run exists for `runId`.
109
+ * @throws ForbiddenError when the caller is not the run's recorded owner.
110
+ * @throws GraphExecutionError when the active backend does not support resume
111
+ * or the backend rejects the resume.
112
+ */
113
+ resumeRun(runId: string, request: GraphResumeRequest, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
64
114
  /** Lists a run's event envelopes after the given sequence (ownership-checked). */
65
115
  listEvents(runId: string, afterSequence: number, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunEventEnvelope[]>;
66
116
  /** Subscribes a live listener to a run's event stream (ownership-checked); returns an unsubscribe function. */
@@ -88,7 +138,16 @@ export declare class GraphRunService {
88
138
  private finishActiveRun;
89
139
  private validateCreateRequest;
90
140
  private documentProviderFor;
141
+ /**
142
+ * Read-visibility check for a run: honours the owner-less visibility contract
143
+ * and the explicit `allowAnonymousAccess` tolerance (SAA-595/SAA-93 F1).
144
+ */
91
145
  private assertOwnership;
146
+ /**
147
+ * Write-path check for a run: strict owner equality, never the read tolerance
148
+ * (SAA-105 R3).
149
+ */
150
+ private assertWriteOwnership;
92
151
  /**
93
152
  * Generates a cryptographically random run id. `crypto.randomUUID` is always
94
153
  * available in the backend runtimes as-graph targets; the frontend never
@@ -1,7 +1,9 @@
1
1
  import type { Context, MaybeContextualArg } from "@decaf-ts/core";
2
2
  import { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
3
+ import type { GraphResumeAudit, GraphResumeRequest } from "../execution/GraphExecutionBackend.d.mts";
3
4
  import { type GraphRunEventEnvelope, type GraphRunLimits } from "../../shared/graph/index.d.mts";
4
5
  import { type GraphRun, type GraphRunCreateRequest, type GraphRunDocumentResolver, type GraphRunEventStore, type GraphRunStore } from "./types.d.mts";
6
+ import type { GraphRunModel } from "../../shared/graph/index.d.mts";
5
7
  /** Construction options for {@link GraphRunService}. */
6
8
  export interface GraphRunServiceOptions {
7
9
  /** Run limits (timeouts, event payload caps, concurrency); defaults from {@link DEFAULT_GRAPH_RUN_LIMITS}. */
@@ -22,7 +24,8 @@ export interface GraphRunServiceOptions {
22
24
  * observes graph runs on top of a {@link GraphRunStore} and
23
25
  * {@link GraphRunEventStore}. Enforces per-caller run limits (concurrency
24
26
  * buckets keyed by owner or caller key, timeout, event payload size), scopes
25
- * every read/cancel to the owning user, auto-releases retained event state
27
+ * every read to the owning user, authorizes cancellation by strict owner
28
+ * equality (SAA-105 R3), auto-releases retained event state
26
29
  * after the configured replay window (SAA-595), and exposes the sequenced
27
30
  * event stream the SSE controller replays.
28
31
  */
@@ -56,11 +59,58 @@ export declare class GraphRunService {
56
59
  createRun(request: GraphRunCreateRequest, ownerUser: string | null, concurrencyKey?: string, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
57
60
  /** Reads a run, asserting it belongs to `ownerUser`. */
58
61
  getRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
62
+ /**
63
+ * Lists the persisted run rows for a workflow document, scoped to the
64
+ * requesting owner and ordered newest first.
65
+ *
66
+ * The collection is ownership-filtered with
67
+ * {@link canAccessGraphResource}: owner-less runs stay visible to everyone,
68
+ * a named caller sees their own plus owner-less runs, and an anonymous caller
69
+ * without the explicit `allowAnonymousAccess` tolerance sees only owner-less
70
+ * runs (SAA-595). The persisted {@link GraphRunModel} rows are returned so
71
+ * the HTTP boundary can serve the frontend-safe listing shape.
72
+ *
73
+ * The newest-first sort is corrupt-date-safe (SAA-93 R2): a row whose
74
+ * `updatedAt` is missing or not a valid `Date` is treated as oldest
75
+ * (epoch `0`) instead of producing `NaN` comparisons that would make the
76
+ * ordering of adjacent rows undefined.
77
+ *
78
+ * @param {string} workflowId - Workflow document id to list runs for.
79
+ * @param {string | null} ownerUser - Identity of the requesting caller.
80
+ * @param args - An optional decaf `Context` forwarded to the store.
81
+ * @return {Promise<GraphRunModel[]>} The workflow's runs, newest first.
82
+ * @throws Re-throws any store failure from {@link GraphRunStore.listRuns}.
83
+ */
84
+ listRunsByWorkflow(workflowId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunModel[]>;
59
85
  /**
60
86
  * Cancels a non-terminal run: aborts in-flight execution and persists the
61
87
  * `cancelled` status. Terminal runs are returned unchanged.
88
+ *
89
+ * Cancellation is a write and is authorized by strict owner equality
90
+ * ({@link assertGraphResourceWriteOwnership}, SAA-105 R3): only the run's
91
+ * recorded owner may cancel it. A named caller can no longer cancel an
92
+ * owner-less run, and the read-visibility tolerance `allowAnonymousAccess`
93
+ * never grants a cancellation.
62
94
  */
63
95
  cancelRun(runId: string, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRun>;
96
+ /**
97
+ * Resumes a suspended run: resolves the run, asserts strict owner equality on
98
+ * the write path ({@link assertGraphResourceWriteOwnership}, SAA-105 R3), then
99
+ * delegates to the active backend's optional SAA-196 `resume?()` extension and
100
+ * audits the accepted resume through the event publisher (C18). A backend without
101
+ * the extension fails closed rather than silently no-op.
102
+ *
103
+ * C14: resume is exposed only through this service, behind the owner-equality
104
+ * write gate — never from an HTTP route. The standing SAA-200 hardening rule
105
+ * holds here too: a {@link GraphExecutionError} thrown by the backend is
106
+ * re-thrown without its `details` so no server-side state leaks to clients.
107
+ *
108
+ * @throws NotFoundError when no run exists for `runId`.
109
+ * @throws ForbiddenError when the caller is not the run's recorded owner.
110
+ * @throws GraphExecutionError when the active backend does not support resume
111
+ * or the backend rejects the resume.
112
+ */
113
+ resumeRun(runId: string, request: GraphResumeRequest, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
64
114
  /** Lists a run's event envelopes after the given sequence (ownership-checked). */
65
115
  listEvents(runId: string, afterSequence: number, ownerUser: string | null, ...args: MaybeContextualArg<Context>): Promise<GraphRunEventEnvelope[]>;
66
116
  /** Subscribes a live listener to a run's event stream (ownership-checked); returns an unsubscribe function. */
@@ -88,7 +138,16 @@ export declare class GraphRunService {
88
138
  private finishActiveRun;
89
139
  private validateCreateRequest;
90
140
  private documentProviderFor;
141
+ /**
142
+ * Read-visibility check for a run: honours the owner-less visibility contract
143
+ * and the explicit `allowAnonymousAccess` tolerance (SAA-595/SAA-93 F1).
144
+ */
91
145
  private assertOwnership;
146
+ /**
147
+ * Write-path check for a run: strict owner equality, never the read tolerance
148
+ * (SAA-105 R3).
149
+ */
150
+ private assertWriteOwnership;
92
151
  /**
93
152
  * Generates a cryptographically random run id. `crypto.randomUUID` is always
94
153
  * available in the backend runtimes as-graph targets; the frontend never
@@ -1,4 +1,5 @@
1
1
  import type { GraphRun, GraphRunStore } from "./types.d.cts";
2
+ import type { GraphRunModel } from "../../shared/graph/index.d.cts";
2
3
  /**
3
4
  * Non-persistent {@link GraphRunStore} backed by a `Map`: serves tests and
4
5
  * in-process deployments. Runs are cloned on save/read so callers never
@@ -6,7 +7,35 @@ import type { GraphRun, GraphRunStore } from "./types.d.cts";
6
7
  */
7
8
  export declare class InMemoryGraphRunStore implements GraphRunStore {
8
9
  private readonly runs;
10
+ /**
11
+ * Clones and stores the run by its id (upsert semantics).
12
+ *
13
+ * @param {GraphRun} run - Engine-side run to persist.
14
+ * @return {Promise<void>} Resolves once the run is stored.
15
+ */
9
16
  saveRun(run: GraphRun): Promise<void>;
17
+ /**
18
+ * Reads a run and returns a clone, so callers never share mutable
19
+ * references with the store.
20
+ *
21
+ * @param {string} runId - Id of the run to read.
22
+ * @return {Promise<GraphRun | null>} The run, or `null` when no row exists.
23
+ */
10
24
  readRun(runId: string): Promise<GraphRun | null>;
25
+ /**
26
+ * Lists every in-memory run that executed the given workflow, converted to
27
+ * its persisted {@link GraphRunModel} shape so the serving list keeps the
28
+ * storage-derived fields (`updatedAt`, `inputs`). Unordered; the run
29
+ * service orders the serving result.
30
+ *
31
+ * @param {string} workflowId - Workflow document id the runs executed.
32
+ * @return {Promise<GraphRunModel[]>} The matching rows (empty when none exist).
33
+ */
34
+ listRuns(workflowId: string): Promise<GraphRunModel[]>;
35
+ /**
36
+ * Deletes a run's row, mirroring the event-store `release?` contract.
37
+ *
38
+ * @param {string} runId - Id of the run to release.
39
+ */
11
40
  release(runId: string): void;
12
41
  }
@@ -1,4 +1,5 @@
1
1
  import type { GraphRun, GraphRunStore } from "./types.d.mts";
2
+ import type { GraphRunModel } from "../../shared/graph/index.d.mts";
2
3
  /**
3
4
  * Non-persistent {@link GraphRunStore} backed by a `Map`: serves tests and
4
5
  * in-process deployments. Runs are cloned on save/read so callers never
@@ -6,7 +7,35 @@ import type { GraphRun, GraphRunStore } from "./types.d.mts";
6
7
  */
7
8
  export declare class InMemoryGraphRunStore implements GraphRunStore {
8
9
  private readonly runs;
10
+ /**
11
+ * Clones and stores the run by its id (upsert semantics).
12
+ *
13
+ * @param {GraphRun} run - Engine-side run to persist.
14
+ * @return {Promise<void>} Resolves once the run is stored.
15
+ */
9
16
  saveRun(run: GraphRun): Promise<void>;
17
+ /**
18
+ * Reads a run and returns a clone, so callers never share mutable
19
+ * references with the store.
20
+ *
21
+ * @param {string} runId - Id of the run to read.
22
+ * @return {Promise<GraphRun | null>} The run, or `null` when no row exists.
23
+ */
10
24
  readRun(runId: string): Promise<GraphRun | null>;
25
+ /**
26
+ * Lists every in-memory run that executed the given workflow, converted to
27
+ * its persisted {@link GraphRunModel} shape so the serving list keeps the
28
+ * storage-derived fields (`updatedAt`, `inputs`). Unordered; the run
29
+ * service orders the serving result.
30
+ *
31
+ * @param {string} workflowId - Workflow document id the runs executed.
32
+ * @return {Promise<GraphRunModel[]>} The matching rows (empty when none exist).
33
+ */
34
+ listRuns(workflowId: string): Promise<GraphRunModel[]>;
35
+ /**
36
+ * Deletes a run's row, mirroring the event-store `release?` contract.
37
+ *
38
+ * @param {string} runId - Id of the run to release.
39
+ */
11
40
  release(runId: string): void;
12
41
  }
@@ -1,10 +1,95 @@
1
1
  /**
2
- * Centralized graph resource ownership check (SAA-595 security hardening).
2
+ * Centralized graph resource access predicate (SAA-595 security hardening).
3
3
  *
4
- * Fail-closed by default: a resource that carries an owner is only accessible
5
- * to that owner; an absent caller identity is denied unless the explicit
4
+ * Fail-closed by default: a resource that carries an owner is only visible to
5
+ * that owner; an absent caller identity is denied unless the explicit
6
6
  * `allowAnonymousAccess` tolerance (DECAF-48 §4.15 standalone runs) is set.
7
- * Owner-less resources remain accessible to everyone.
7
+ * Owner-less resources remain accessible to everyone. Returns a boolean so list
8
+ * endpoints can filter a collection without aborting on the first foreign row.
9
+ *
10
+ * @param resource - The guarded resource (or its persisted record); only its
11
+ * `owner` member is read. `null`/`undefined` counts as owner-less.
12
+ * @param callerOwner - Identity of the caller resolved from the request
13
+ * context; `null`/`undefined`/`""` represent anonymous callers.
14
+ * @param options - `allowAnonymousAccess` opts in to the DECAF-48 §4.15
15
+ * standalone tolerance (default `false`).
16
+ * @return `true` when the caller may access the resource.
17
+ */
18
+ export declare function canAccessGraphResource(resource: {
19
+ owner?: string | null;
20
+ } | null | undefined, callerOwner: string | null | undefined, options?: {
21
+ allowAnonymousAccess?: boolean;
22
+ }): boolean;
23
+ /**
24
+ * Payload-scoped companion to {@link canAccessGraphResource} (SAA-93 F1).
25
+ *
26
+ * Read *visibility* of an owner-less resource is intentionally open to every
27
+ * caller, but the sensitive payload members a list projection serves
28
+ * (`inputs`/`result`/`error` on run rows) must not be. This predicate is
29
+ * fail-closed: a caller may see a row's payload only when the row's recorded
30
+ * owner equals the caller's resolved owner. An owner-less row (no recorded
31
+ * owner) therefore exposes its payload only to an owner-less caller (an
32
+ * anonymous/standalone caller); a named caller — even one allowed to see the row
33
+ * by {@link canAccessGraphResource} — receives the summary-only projection.
34
+ * That closes the cross-caller exposure where an unrelated authenticated caller
35
+ * could read another anonymous caller's `inputs`/`result`/`error` through
36
+ * `GET /graph/workflows/{workflowId}/runs`.
37
+ *
38
+ * @param resource - The guarded resource (or its persisted record); only its
39
+ * `owner` member is read. `null`/`undefined` counts as owner-less.
40
+ * @param callerOwner - Identity of the caller resolved from the request
41
+ * context; `null`/`undefined`/`""` represent owner-less callers.
42
+ * @return `true` when the caller may see the resource's payload members.
43
+ */
44
+ export declare function canAccessGraphResourcePayload(resource: {
45
+ owner?: string | null;
46
+ } | null | undefined, callerOwner: string | null | undefined): boolean;
47
+ /**
48
+ * Write-path ownership assertion for graph resources (SAA-105 R3).
49
+ *
50
+ * Mutation authorization is strict owner equality, deliberately stricter than the
51
+ * read-visibility predicate {@link canAccessGraphResource}: the owner-less
52
+ * visibility branch that lets any caller *read* an owner-less resource must never
53
+ * authorize a write. Concretely this denies a named caller mutating an owner-less
54
+ * resource (the R3 cross-caller hole) and denies an anonymous caller mutating an
55
+ * owned resource even when the read tolerance `allowAnonymousAccess` is set.
56
+ *
57
+ * The normative effects are:
58
+ * - owner-less resource + owner-less (anonymous) caller → allow;
59
+ * - owner-less resource + named caller → `ForbiddenError`;
60
+ * - owned resource + its owner → allow;
61
+ * - owned resource + any other caller (including anonymous with the read
62
+ * tolerance) → `ForbiddenError`.
63
+ *
64
+ * `allowAnonymousAccess` is intentionally not a parameter here: it is a
65
+ * read-visibility tolerance and never grants a write.
66
+ *
67
+ * @param resource - The guarded resource (or its persisted record); only its
68
+ * `owner` member is read. `null`/`undefined` counts as owner-less.
69
+ * @param callerOwner - Identity of the caller resolved from the request
70
+ * context; `null`/`undefined`/`""` represent owner-less callers.
71
+ * @param options - `resourceKind`/`resourceId` name the resource in the
72
+ * denial message.
73
+ * @throws ForbiddenError when the caller is not the resource's recorded owner
74
+ * (owner equality).
75
+ */
76
+ export declare function assertGraphResourceWriteOwnership(resource: {
77
+ owner?: string | null;
78
+ } | null | undefined, callerOwner: string | null | undefined, options: {
79
+ resourceKind: string;
80
+ resourceId: string;
81
+ }): void;
82
+ /**
83
+ * Centralized graph resource ownership check (SAA-595 security hardening).
84
+ *
85
+ * Read-visibility check. Fail-closed by default: a resource that carries an
86
+ * owner is only accessible to that owner; an absent caller identity is denied
87
+ * unless the explicit `allowAnonymousAccess` tolerance (DECAF-48 §4.15 standalone
88
+ * runs) is set. Owner-less resources remain accessible to everyone.
89
+ *
90
+ * Writes must NOT use this predicate; use
91
+ * {@link assertGraphResourceWriteOwnership} so the owner-less visibility branch
92
+ * and the `allowAnonymousAccess` tolerance cannot authorize a mutation.
8
93
  *
9
94
  * @param resource - The guarded resource (or its persisted record); only its
10
95
  * `owner` member is read. `null`/`undefined` counts as owner-less.