@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,232 @@
1
+ /**
2
+ * @module as-graph/execution/LocalGraphExecutionBackend
3
+ * @summary Built-in reference graph execution backend (DECAF-50 §4.9).
4
+ * @description The `RamAdapter` analogue of the engine abstraction seam: the
5
+ * reference interpreter extracted verbatim from {@link GraphExecutionEngine}.
6
+ * Given a resolved, topologically layered plan (and the canonical document for
7
+ * translation parity), it executes nodes layer-by-layer, honours disabled-node
8
+ * semantics, builds node inputs from routed edges/literal/expression bindings/
9
+ * manifest defaults, validates executor outputs against the effective manifest,
10
+ * routes values along activated data edges, and reports every transition through
11
+ * the facade-owned {@link GraphExecutionEventSink}. All per-run state lives in
12
+ * the facade-created {@link GraphExecutionFrame} carried by the sink; the backend
13
+ * holds only the facade-provided collaborators (value adapter, optional code
14
+ * sandbox evaluator, and owning engine reference).
15
+ */
16
+ import type { Adapter, Context, MaybeContextualArg } from "@decaf-ts/core";
17
+ import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.cts";
18
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
19
+ import type { GraphExecutionResult } from "../types.d.cts";
20
+ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
21
+ import type { GraphBackendCapabilities, GraphBackendExecutionRequest, GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
22
+ /**
23
+ * Configuration for the {@link LocalGraphExecutionBackend}.
24
+ */
25
+ export interface LocalGraphExecutionBackendConfig extends Record<string, unknown> {
26
+ /** Decaf adapter backing cached/pinned value persistence. */
27
+ valueAdapter: Adapter<any, any, any, any>;
28
+ /** Optional pluggable code sandbox evaluator. */
29
+ codeSandboxEvaluator?: CodeSandboxEvaluator;
30
+ /**
31
+ * Optional workflow catalogue port backing the listing/lookup capability.
32
+ * Hosts pass their `GraphWorkflowService` here; when absent the backend
33
+ * reports the capability as `not_supported` instead of returning an empty list.
34
+ */
35
+ workflowStore?: GraphBackendWorkflowStore;
36
+ /** The facade engine, exposed to node contexts. */
37
+ engine: GraphExecutionEngine;
38
+ }
39
+ /**
40
+ * Built-in reference graph execution backend. Registers itself under
41
+ * {@link GRAPH_LOCAL_EXECUTION_BACKEND} on construction.
42
+ */
43
+ export declare class LocalGraphExecutionBackend implements GraphExecutionBackend<LocalGraphExecutionBackendConfig> {
44
+ /** This backend executes locally, in-process. */
45
+ readonly local = true;
46
+ /**
47
+ * This backend executes code-mode surfaces host-side through the
48
+ * facade-owned `CodeSandboxEvaluator` (SAA-193 C1).
49
+ */
50
+ readonly codeMode: "hostSide";
51
+ private valueAdapter;
52
+ private codeSandboxEvaluator?;
53
+ private workflowStore?;
54
+ private engine;
55
+ constructor();
56
+ /**
57
+ * Resolves the backend's runtime collaborators. Called by the facade during
58
+ * `GraphExecutionEngine.initialize`.
59
+ *
60
+ * @param config - The facade-provided collaborators.
61
+ */
62
+ initialize(config: LocalGraphExecutionBackendConfig): Promise<void>;
63
+ /**
64
+ * Effective capability metadata: code-mode is host-side and workflow
65
+ * listing/lookup is supported exactly when a catalogue port is wired in.
66
+ */
67
+ get capabilities(): GraphBackendCapabilities;
68
+ /**
69
+ * Lists the workflows visible to the requesting principal through the wired
70
+ * `GraphWorkflowStore` port.
71
+ *
72
+ * @param args - Optional decaf contextual arguments forwarded to the store.
73
+ * @returns Workflow summaries, newest first when the store orders them.
74
+ * @throws {GraphExecutionError} when no workflow store is wired in.
75
+ */
76
+ listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
77
+ /**
78
+ * Reads a single canonical workflow document through the wired
79
+ * `GraphWorkflowStore` port.
80
+ *
81
+ * @param workflowId - The workflow id to read.
82
+ * @param args - Optional decaf contextual arguments forwarded to the store.
83
+ * @returns The canonical workflow document.
84
+ * @throws {GraphExecutionError} when no workflow store is wired in.
85
+ */
86
+ getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
87
+ /**
88
+ * Executes a validated/resolved workflow's plan against the facade-owned
89
+ * frame carried by the request's event sink.
90
+ *
91
+ * @param request - The execution request.
92
+ * @returns The complete execution result.
93
+ * @throws {GraphExecutionError} when the request's sink is not the
94
+ * facade-created frame-aware sink.
95
+ */
96
+ execute(request: GraphBackendExecutionRequest): Promise<GraphExecutionResult>;
97
+ /**
98
+ * Executes a layer of nodes with the configured concurrency.
99
+ */
100
+ private executeLayer;
101
+ /**
102
+ * Executes a single node, honouring disabled-node semantics (§4.9).
103
+ */
104
+ private executeNode;
105
+ /**
106
+ * Resolves whether a plan node is activated for execution under the
107
+ * DECAF-50 §4.9 branch semantics. A node with no incoming data edges is
108
+ * a root/source node and always runs. A node fed by one or more data
109
+ * edges runs only when at least one of those edges was activated by a
110
+ * routed upstream output port — a branch the upstream switch (or any
111
+ * partial-output node) did not select leaves its downstream edges
112
+ * unactivated, so the branch is never executed. Workflow-boundary edges
113
+ * are active from the start because workflow inputs are seeded before
114
+ * execution begins.
115
+ */
116
+ private isNodeActivated;
117
+ /**
118
+ * Skips a node whose incoming data edges were all left unactivated by an
119
+ * upstream branch selection. The node is not executed and its outputs are
120
+ * never routed or collected into workflow outputs (DECAF-50 §4.9).
121
+ */
122
+ private skipInactiveNode;
123
+ /**
124
+ * Applies the explicit disabled-node semantics (§4.9):
125
+ * `skip`, `passThroughFirstInput`, or `emitDefaults`, resolved from the
126
+ * instance metadata, document settings, and the default.
127
+ */
128
+ private executeDisabledNode;
129
+ /**
130
+ * Invokes the node's catalogue-resolved executor (§4.9 request contract,
131
+ * post-cutover: every executor receives the full request with
132
+ * configuration and input data separated).
133
+ */
134
+ private invokeExecutor;
135
+ /**
136
+ * Validates executor outputs against the effective output manifest
137
+ * (§4.9): unknown outputs are rejected by default; missing required
138
+ * outputs fail the node. Lenient transition manifests (legacy
139
+ * executor-only registrations) are exempt until cutover.
140
+ */
141
+ private validateNodeOutputs;
142
+ /**
143
+ * Collects the resolved credential references for a node: credential-type
144
+ * parameter values plus the `credentials` record in instance metadata.
145
+ * Documents carry references only — secret material never enters requests.
146
+ */
147
+ private collectCredentials;
148
+ /**
149
+ * Resolves a node's input values from routed data edges, literal bindings,
150
+ * allowed expression bindings, and manifest port defaults (§4.9).
151
+ *
152
+ * When multiple edges target the same port, their values are spread into the
153
+ * top-level inputs keyed by each edge's `sourcePort`. This allows multiple
154
+ * workflow input badges to connect to a single port (e.g. the Code node's
155
+ * `data` port) and have all values accessible directly as
156
+ * `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
157
+ */
158
+ private resolveNodeInputs;
159
+ /**
160
+ * Resolves a node's persisted parameters at execution time, evaluating any
161
+ * `GraphValueTemplate` user property through the code-evaluator VM and
162
+ * leaving straight literal values unchanged.
163
+ */
164
+ private resolveNodeParameters;
165
+ /**
166
+ * Evaluates a persisted `GraphValueTemplate` with the pluggable
167
+ * {@link CodeSandboxEvaluator} (DECAF-32 §22.4) — no new evaluator.
168
+ * `expression` mode evaluates the body directly; `template` mode compiles its
169
+ * `{{ ... }}` placeholders into a JavaScript template literal evaluated in
170
+ * the same sandbox, so both modes share the code-evaluator VM.
171
+ */
172
+ private evaluateValueTemplate;
173
+ /**
174
+ * Evaluates an expression binding with the EXISTING allowed-expression
175
+ * machinery only (the pluggable {@link CodeSandboxEvaluator}, DECAF-32
176
+ * §22.4) — no new evaluator. The expression sees the already-routed input
177
+ * values as `$input` and the run metadata as context.
178
+ */
179
+ private evaluateExpressionBinding;
180
+ /**
181
+ * Attempts to read a pinned value for the node. Returns the cached outputs
182
+ * when a valid pinned value exists, or `undefined` to proceed with normal
183
+ * execution.
184
+ */
185
+ private tryPinnedValue;
186
+ /**
187
+ * Recursively computes fingerprints for all upstream dependencies of a node
188
+ * using the results already accumulated in the frame.
189
+ */
190
+ private computeDependencyFingerprints;
191
+ /**
192
+ * Routes a node's outputs to downstream inputs and workflow outputs along
193
+ * data edges (connection edges are structural and never route values).
194
+ *
195
+ * An edge is traversed only when the source node actually emitted the
196
+ * edge's `sourcePort` (DECAF-50 §4.9 branch semantics). A node that
197
+ * emitted a subset of its declared outputs — e.g. a switch that selected
198
+ * one case — therefore activates only the downstream branch edges of the
199
+ * emitted ports; unselected branch edges are left unactivated, so their
200
+ * downstream nodes are skipped and never contribute to workflow outputs.
201
+ * Emitting an output port explicitly with `undefined` still counts as
202
+ * activated (the port was produced by the executor).
203
+ */
204
+ private routeOutgoingEdges;
205
+ /**
206
+ * Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
207
+ * visual state for the node. Rides the existing Observable pipeline; no
208
+ * second out-of-band channel.
209
+ */
210
+ private emitNodeStateChanged;
211
+ /**
212
+ * Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
213
+ * visual state for a routed edge.
214
+ */
215
+ private emitEdgeStateChanged;
216
+ /**
217
+ * Creates a {@link GraphPinningService} backed by the run's value store
218
+ * adapter.
219
+ */
220
+ private createPinningService;
221
+ /**
222
+ * Resolves the effective loop-iteration ceilings for a run. A node-level
223
+ * `maxIterations` can never exceed these; loop executors read them from the
224
+ * node context.
225
+ */
226
+ private executionLimits;
227
+ private assertNotAborted;
228
+ /**
229
+ * Converts an error into a serialized payload.
230
+ */
231
+ private toErrorPayload;
232
+ }
@@ -0,0 +1,232 @@
1
+ /**
2
+ * @module as-graph/execution/LocalGraphExecutionBackend
3
+ * @summary Built-in reference graph execution backend (DECAF-50 §4.9).
4
+ * @description The `RamAdapter` analogue of the engine abstraction seam: the
5
+ * reference interpreter extracted verbatim from {@link GraphExecutionEngine}.
6
+ * Given a resolved, topologically layered plan (and the canonical document for
7
+ * translation parity), it executes nodes layer-by-layer, honours disabled-node
8
+ * semantics, builds node inputs from routed edges/literal/expression bindings/
9
+ * manifest defaults, validates executor outputs against the effective manifest,
10
+ * routes values along activated data edges, and reports every transition through
11
+ * the facade-owned {@link GraphExecutionEventSink}. All per-run state lives in
12
+ * the facade-created {@link GraphExecutionFrame} carried by the sink; the backend
13
+ * holds only the facade-provided collaborators (value adapter, optional code
14
+ * sandbox evaluator, and owning engine reference).
15
+ */
16
+ import type { Adapter, Context, MaybeContextualArg } from "@decaf-ts/core";
17
+ import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.mts";
18
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
19
+ import type { GraphExecutionResult } from "../types.d.mts";
20
+ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
21
+ import type { GraphBackendCapabilities, GraphBackendExecutionRequest, GraphBackendWorkflowStore, GraphBackendWorkflowSummary, GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
22
+ /**
23
+ * Configuration for the {@link LocalGraphExecutionBackend}.
24
+ */
25
+ export interface LocalGraphExecutionBackendConfig extends Record<string, unknown> {
26
+ /** Decaf adapter backing cached/pinned value persistence. */
27
+ valueAdapter: Adapter<any, any, any, any>;
28
+ /** Optional pluggable code sandbox evaluator. */
29
+ codeSandboxEvaluator?: CodeSandboxEvaluator;
30
+ /**
31
+ * Optional workflow catalogue port backing the listing/lookup capability.
32
+ * Hosts pass their `GraphWorkflowService` here; when absent the backend
33
+ * reports the capability as `not_supported` instead of returning an empty list.
34
+ */
35
+ workflowStore?: GraphBackendWorkflowStore;
36
+ /** The facade engine, exposed to node contexts. */
37
+ engine: GraphExecutionEngine;
38
+ }
39
+ /**
40
+ * Built-in reference graph execution backend. Registers itself under
41
+ * {@link GRAPH_LOCAL_EXECUTION_BACKEND} on construction.
42
+ */
43
+ export declare class LocalGraphExecutionBackend implements GraphExecutionBackend<LocalGraphExecutionBackendConfig> {
44
+ /** This backend executes locally, in-process. */
45
+ readonly local = true;
46
+ /**
47
+ * This backend executes code-mode surfaces host-side through the
48
+ * facade-owned `CodeSandboxEvaluator` (SAA-193 C1).
49
+ */
50
+ readonly codeMode: "hostSide";
51
+ private valueAdapter;
52
+ private codeSandboxEvaluator?;
53
+ private workflowStore?;
54
+ private engine;
55
+ constructor();
56
+ /**
57
+ * Resolves the backend's runtime collaborators. Called by the facade during
58
+ * `GraphExecutionEngine.initialize`.
59
+ *
60
+ * @param config - The facade-provided collaborators.
61
+ */
62
+ initialize(config: LocalGraphExecutionBackendConfig): Promise<void>;
63
+ /**
64
+ * Effective capability metadata: code-mode is host-side and workflow
65
+ * listing/lookup is supported exactly when a catalogue port is wired in.
66
+ */
67
+ get capabilities(): GraphBackendCapabilities;
68
+ /**
69
+ * Lists the workflows visible to the requesting principal through the wired
70
+ * `GraphWorkflowStore` port.
71
+ *
72
+ * @param args - Optional decaf contextual arguments forwarded to the store.
73
+ * @returns Workflow summaries, newest first when the store orders them.
74
+ * @throws {GraphExecutionError} when no workflow store is wired in.
75
+ */
76
+ listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
77
+ /**
78
+ * Reads a single canonical workflow document through the wired
79
+ * `GraphWorkflowStore` port.
80
+ *
81
+ * @param workflowId - The workflow id to read.
82
+ * @param args - Optional decaf contextual arguments forwarded to the store.
83
+ * @returns The canonical workflow document.
84
+ * @throws {GraphExecutionError} when no workflow store is wired in.
85
+ */
86
+ getWorkflow(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
87
+ /**
88
+ * Executes a validated/resolved workflow's plan against the facade-owned
89
+ * frame carried by the request's event sink.
90
+ *
91
+ * @param request - The execution request.
92
+ * @returns The complete execution result.
93
+ * @throws {GraphExecutionError} when the request's sink is not the
94
+ * facade-created frame-aware sink.
95
+ */
96
+ execute(request: GraphBackendExecutionRequest): Promise<GraphExecutionResult>;
97
+ /**
98
+ * Executes a layer of nodes with the configured concurrency.
99
+ */
100
+ private executeLayer;
101
+ /**
102
+ * Executes a single node, honouring disabled-node semantics (§4.9).
103
+ */
104
+ private executeNode;
105
+ /**
106
+ * Resolves whether a plan node is activated for execution under the
107
+ * DECAF-50 §4.9 branch semantics. A node with no incoming data edges is
108
+ * a root/source node and always runs. A node fed by one or more data
109
+ * edges runs only when at least one of those edges was activated by a
110
+ * routed upstream output port — a branch the upstream switch (or any
111
+ * partial-output node) did not select leaves its downstream edges
112
+ * unactivated, so the branch is never executed. Workflow-boundary edges
113
+ * are active from the start because workflow inputs are seeded before
114
+ * execution begins.
115
+ */
116
+ private isNodeActivated;
117
+ /**
118
+ * Skips a node whose incoming data edges were all left unactivated by an
119
+ * upstream branch selection. The node is not executed and its outputs are
120
+ * never routed or collected into workflow outputs (DECAF-50 §4.9).
121
+ */
122
+ private skipInactiveNode;
123
+ /**
124
+ * Applies the explicit disabled-node semantics (§4.9):
125
+ * `skip`, `passThroughFirstInput`, or `emitDefaults`, resolved from the
126
+ * instance metadata, document settings, and the default.
127
+ */
128
+ private executeDisabledNode;
129
+ /**
130
+ * Invokes the node's catalogue-resolved executor (§4.9 request contract,
131
+ * post-cutover: every executor receives the full request with
132
+ * configuration and input data separated).
133
+ */
134
+ private invokeExecutor;
135
+ /**
136
+ * Validates executor outputs against the effective output manifest
137
+ * (§4.9): unknown outputs are rejected by default; missing required
138
+ * outputs fail the node. Lenient transition manifests (legacy
139
+ * executor-only registrations) are exempt until cutover.
140
+ */
141
+ private validateNodeOutputs;
142
+ /**
143
+ * Collects the resolved credential references for a node: credential-type
144
+ * parameter values plus the `credentials` record in instance metadata.
145
+ * Documents carry references only — secret material never enters requests.
146
+ */
147
+ private collectCredentials;
148
+ /**
149
+ * Resolves a node's input values from routed data edges, literal bindings,
150
+ * allowed expression bindings, and manifest port defaults (§4.9).
151
+ *
152
+ * When multiple edges target the same port, their values are spread into the
153
+ * top-level inputs keyed by each edge's `sourcePort`. This allows multiple
154
+ * workflow input badges to connect to a single port (e.g. the Code node's
155
+ * `data` port) and have all values accessible directly as
156
+ * `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
157
+ */
158
+ private resolveNodeInputs;
159
+ /**
160
+ * Resolves a node's persisted parameters at execution time, evaluating any
161
+ * `GraphValueTemplate` user property through the code-evaluator VM and
162
+ * leaving straight literal values unchanged.
163
+ */
164
+ private resolveNodeParameters;
165
+ /**
166
+ * Evaluates a persisted `GraphValueTemplate` with the pluggable
167
+ * {@link CodeSandboxEvaluator} (DECAF-32 §22.4) — no new evaluator.
168
+ * `expression` mode evaluates the body directly; `template` mode compiles its
169
+ * `{{ ... }}` placeholders into a JavaScript template literal evaluated in
170
+ * the same sandbox, so both modes share the code-evaluator VM.
171
+ */
172
+ private evaluateValueTemplate;
173
+ /**
174
+ * Evaluates an expression binding with the EXISTING allowed-expression
175
+ * machinery only (the pluggable {@link CodeSandboxEvaluator}, DECAF-32
176
+ * §22.4) — no new evaluator. The expression sees the already-routed input
177
+ * values as `$input` and the run metadata as context.
178
+ */
179
+ private evaluateExpressionBinding;
180
+ /**
181
+ * Attempts to read a pinned value for the node. Returns the cached outputs
182
+ * when a valid pinned value exists, or `undefined` to proceed with normal
183
+ * execution.
184
+ */
185
+ private tryPinnedValue;
186
+ /**
187
+ * Recursively computes fingerprints for all upstream dependencies of a node
188
+ * using the results already accumulated in the frame.
189
+ */
190
+ private computeDependencyFingerprints;
191
+ /**
192
+ * Routes a node's outputs to downstream inputs and workflow outputs along
193
+ * data edges (connection edges are structural and never route values).
194
+ *
195
+ * An edge is traversed only when the source node actually emitted the
196
+ * edge's `sourcePort` (DECAF-50 §4.9 branch semantics). A node that
197
+ * emitted a subset of its declared outputs — e.g. a switch that selected
198
+ * one case — therefore activates only the downstream branch edges of the
199
+ * emitted ports; unselected branch edges are left unactivated, so their
200
+ * downstream nodes are skipped and never contribute to workflow outputs.
201
+ * Emitting an output port explicitly with `undefined` still counts as
202
+ * activated (the port was produced by the executor).
203
+ */
204
+ private routeOutgoingEdges;
205
+ /**
206
+ * Emits a `NODE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
207
+ * visual state for the node. Rides the existing Observable pipeline; no
208
+ * second out-of-band channel.
209
+ */
210
+ private emitNodeStateChanged;
211
+ /**
212
+ * Emits an `EDGE_STATE_CHANGED` event (DECAF-48 §4.4) carrying the given
213
+ * visual state for a routed edge.
214
+ */
215
+ private emitEdgeStateChanged;
216
+ /**
217
+ * Creates a {@link GraphPinningService} backed by the run's value store
218
+ * adapter.
219
+ */
220
+ private createPinningService;
221
+ /**
222
+ * Resolves the effective loop-iteration ceilings for a run. A node-level
223
+ * `maxIterations` can never exceed these; loop executors read them from the
224
+ * node context.
225
+ */
226
+ private executionLimits;
227
+ private assertNotAborted;
228
+ /**
229
+ * Converts an error into a serialized payload.
230
+ */
231
+ private toErrorPayload;
232
+ }
@@ -7,6 +7,10 @@ export * from "./GraphExecutionContext.d.cts";
7
7
  export * from "./GraphNodeExecutor.d.cts";
8
8
  export * from "./GraphExecutionResult.d.cts";
9
9
  export * from "./GraphExecutionFrame.d.cts";
10
+ export * from "./GraphExecutionBackend.d.cts";
11
+ export * from "./GraphExecutionBackendRegistry.d.cts";
12
+ export * from "./GraphCodeMode.d.cts";
13
+ export * from "./LocalGraphExecutionBackend.d.cts";
10
14
  export * from "./GraphExecutionEngine.d.cts";
11
15
  export * from "./CodeSandboxEvaluator.d.cts";
12
16
  export * from "./IsolatedVmCodeSandboxEvaluator.d.cts";
@@ -7,6 +7,10 @@ export * from "./GraphExecutionContext.d.mts";
7
7
  export * from "./GraphNodeExecutor.d.mts";
8
8
  export * from "./GraphExecutionResult.d.mts";
9
9
  export * from "./GraphExecutionFrame.d.mts";
10
+ export * from "./GraphExecutionBackend.d.mts";
11
+ export * from "./GraphExecutionBackendRegistry.d.mts";
12
+ export * from "./GraphCodeMode.d.mts";
13
+ export * from "./LocalGraphExecutionBackend.d.mts";
10
14
  export * from "./GraphExecutionEngine.d.mts";
11
15
  export * from "./CodeSandboxEvaluator.d.mts";
12
16
  export * from "./IsolatedVmCodeSandboxEvaluator.d.mts";
@@ -29,6 +29,10 @@ export * from "./execution/GraphExecutionContext.d.cts";
29
29
  export * from "./execution/GraphNodeExecutor.d.cts";
30
30
  export * from "./execution/GraphExecutionFrame.d.cts";
31
31
  export * from "./execution/GraphExecutionResult.d.cts";
32
+ export * from "./execution/GraphExecutionBackend.d.cts";
33
+ export * from "./execution/GraphExecutionBackendRegistry.d.cts";
34
+ export * from "./execution/GraphCodeMode.d.cts";
35
+ export * from "./execution/LocalGraphExecutionBackend.d.cts";
32
36
  export * from "./execution/GraphExecutionEngine.d.cts";
33
37
  export * from "./execution/CodeSandboxEvaluator.d.cts";
34
38
  export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.cts";
@@ -47,6 +51,7 @@ export * from "./planning/GraphExecutionPlanner.d.cts";
47
51
  export * from "./planning/GraphTopology.d.cts";
48
52
  export * from "./validation/index.d.cts";
49
53
  export * from "./loops/GraphConditionEvaluator.d.cts";
54
+ export * from "./loops/ConditionEvaluator.d.cts";
50
55
  export * from "./loops/ConditionExpressionEvaluator.d.cts";
51
56
  export * from "./loops/GraphLoopExecutionContext.d.cts";
52
57
  export * from "./pinning/GraphPinningMetadata.d.cts";
@@ -29,6 +29,10 @@ export * from "./execution/GraphExecutionContext.d.mts";
29
29
  export * from "./execution/GraphNodeExecutor.d.mts";
30
30
  export * from "./execution/GraphExecutionFrame.d.mts";
31
31
  export * from "./execution/GraphExecutionResult.d.mts";
32
+ export * from "./execution/GraphExecutionBackend.d.mts";
33
+ export * from "./execution/GraphExecutionBackendRegistry.d.mts";
34
+ export * from "./execution/GraphCodeMode.d.mts";
35
+ export * from "./execution/LocalGraphExecutionBackend.d.mts";
32
36
  export * from "./execution/GraphExecutionEngine.d.mts";
33
37
  export * from "./execution/CodeSandboxEvaluator.d.mts";
34
38
  export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.mts";
@@ -47,6 +51,7 @@ export * from "./planning/GraphExecutionPlanner.d.mts";
47
51
  export * from "./planning/GraphTopology.d.mts";
48
52
  export * from "./validation/index.d.mts";
49
53
  export * from "./loops/GraphConditionEvaluator.d.mts";
54
+ export * from "./loops/ConditionEvaluator.d.mts";
50
55
  export * from "./loops/ConditionExpressionEvaluator.d.mts";
51
56
  export * from "./loops/GraphLoopExecutionContext.d.mts";
52
57
  export * from "./pinning/GraphPinningMetadata.d.mts";
@@ -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.cts";
17
+ import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
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>;