@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,52 @@
1
+ /**
2
+ * @module as-graph/execution/GraphCodeMode
3
+ * @summary Code-mode surface detection for the pluggable backend gate (SAA-193 C1).
4
+ * @description The security gate requires the facade to detect every code-mode
5
+ * surface in a workflow before delegating to a non-local backend, so it can fail
6
+ * closed instead of launching a remote run that cannot execute it. This module is
7
+ * the single detection authority. It walks the canonical
8
+ * {@link GraphWorkflowDocument} and reports every surface the reference engine
9
+ * would evaluate through the code sandbox:
10
+ *
11
+ * - a `CodeCondition` (`{ type: "code" }`) on any flow-control carrier —
12
+ * if / elseIf / while / until conditions and switch-case conditions, in either
13
+ * the `parameters` or the `metadata` carrier;
14
+ * - a `core.utility.code` node;
15
+ * - a `GraphValueTemplate` parameter;
16
+ * - an expression input binding (`mode: "expression"`) and an expression
17
+ * {@link GraphValueReference} in a loop input/output mapping.
18
+ *
19
+ * Nested loop-body documents are scanned recursively, so a code-mode surface
20
+ * buried inside a loop body is caught before any remote launch.
21
+ */
22
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
23
+ /**
24
+ * The kind of code-mode surface detected in a workflow document.
25
+ */
26
+ export type GraphCodeModeSurfaceKind = "code-condition" | "code-node" | "value-template" | "expression-binding";
27
+ /**
28
+ * A single code-mode surface found in a workflow document.
29
+ */
30
+ export interface GraphCodeModeSurface {
31
+ /** The node carrying the surface. */
32
+ nodeId: string;
33
+ /** The kind of surface detected. */
34
+ kind: GraphCodeModeSurfaceKind;
35
+ /** Optional carrier detail (e.g. the bound input port). */
36
+ detail?: string;
37
+ }
38
+ /**
39
+ * Detects every code-mode surface in a canonical workflow document (SAA-193 C1).
40
+ *
41
+ * @param document - The canonical document to inspect.
42
+ * @returns One entry per code-mode surface found; empty when the workflow is
43
+ * fully graphical and host-executable.
44
+ */
45
+ export declare function detectGraphCodeModeSurfaces(document: GraphWorkflowDocument): GraphCodeModeSurface[];
46
+ /**
47
+ * Reports whether a canonical workflow document carries any code-mode surface.
48
+ *
49
+ * @param document - The canonical document to inspect.
50
+ * @returns `true` when at least one code-mode surface is present.
51
+ */
52
+ export declare function graphDocumentHasCodeMode(document: GraphWorkflowDocument): boolean;
@@ -0,0 +1,52 @@
1
+ /**
2
+ * @module as-graph/execution/GraphCodeMode
3
+ * @summary Code-mode surface detection for the pluggable backend gate (SAA-193 C1).
4
+ * @description The security gate requires the facade to detect every code-mode
5
+ * surface in a workflow before delegating to a non-local backend, so it can fail
6
+ * closed instead of launching a remote run that cannot execute it. This module is
7
+ * the single detection authority. It walks the canonical
8
+ * {@link GraphWorkflowDocument} and reports every surface the reference engine
9
+ * would evaluate through the code sandbox:
10
+ *
11
+ * - a `CodeCondition` (`{ type: "code" }`) on any flow-control carrier —
12
+ * if / elseIf / while / until conditions and switch-case conditions, in either
13
+ * the `parameters` or the `metadata` carrier;
14
+ * - a `core.utility.code` node;
15
+ * - a `GraphValueTemplate` parameter;
16
+ * - an expression input binding (`mode: "expression"`) and an expression
17
+ * {@link GraphValueReference} in a loop input/output mapping.
18
+ *
19
+ * Nested loop-body documents are scanned recursively, so a code-mode surface
20
+ * buried inside a loop body is caught before any remote launch.
21
+ */
22
+ import type { GraphWorkflowDocument } from "../../shared/graph/index.d.mts";
23
+ /**
24
+ * The kind of code-mode surface detected in a workflow document.
25
+ */
26
+ export type GraphCodeModeSurfaceKind = "code-condition" | "code-node" | "value-template" | "expression-binding";
27
+ /**
28
+ * A single code-mode surface found in a workflow document.
29
+ */
30
+ export interface GraphCodeModeSurface {
31
+ /** The node carrying the surface. */
32
+ nodeId: string;
33
+ /** The kind of surface detected. */
34
+ kind: GraphCodeModeSurfaceKind;
35
+ /** Optional carrier detail (e.g. the bound input port). */
36
+ detail?: string;
37
+ }
38
+ /**
39
+ * Detects every code-mode surface in a canonical workflow document (SAA-193 C1).
40
+ *
41
+ * @param document - The canonical document to inspect.
42
+ * @returns One entry per code-mode surface found; empty when the workflow is
43
+ * fully graphical and host-executable.
44
+ */
45
+ export declare function detectGraphCodeModeSurfaces(document: GraphWorkflowDocument): GraphCodeModeSurface[];
46
+ /**
47
+ * Reports whether a canonical workflow document carries any code-mode surface.
48
+ *
49
+ * @param document - The canonical document to inspect.
50
+ * @returns `true` when at least one code-mode surface is present.
51
+ */
52
+ export declare function graphDocumentHasCodeMode(document: GraphWorkflowDocument): boolean;
@@ -0,0 +1,306 @@
1
+ /**
2
+ * @module as-graph/execution/GraphExecutionBackend
3
+ * @summary Pluggable graph execution backend seam (DECAF-50 §4.9).
4
+ * @description Defines the engine-agnostic execution seam that
5
+ * {@link GraphExecutionEngine} delegates to after validation, catalogue
6
+ * resolution, authorization, and topological planning. The contract is patterned
7
+ * on Decaf's persistence adapters: `GraphExecutionBackend` is the `Adapter`
8
+ * analogue and {@link LocalGraphExecutionBackend} is the built-in `RamAdapter`
9
+ * analogue (the extracted reference interpreter). Remote/translated backends
10
+ * (Dagster, Mastra) receive the canonical document for translation and the
11
+ * resolved plan for built-in execution, but can never bypass the facade's
12
+ * pre-execution gate: validation/resolution/auth always happen against the
13
+ * trusted catalogue before any backend runs.
14
+ */
15
+ import type { Context, MaybeContextualArg } from "@decaf-ts/core";
16
+ import type { GraphExecutionEvent, GraphWorkflowDocument } from "../../shared/graph/index.d.cts";
17
+ import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.cts";
18
+ import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphRunId } from "../types.d.cts";
19
+ import type { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.cts";
20
+ import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.cts";
21
+ import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.cts";
22
+ import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.cts";
23
+ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
24
+ /**
25
+ * How a {@link GraphExecutionBackend} handles code-mode workflow surfaces.
26
+ *
27
+ * Code-mode surfaces are `CodeCondition`s on any flow-control carrier,
28
+ * `core.utility.code` nodes, `GraphValueTemplate` parameters, and expression
29
+ * input bindings (SAA-193 C1). The facade detects them and fails closed before
30
+ * delegating to any backend with `local === false`:
31
+ *
32
+ * - `hostSide`: the host executes code-mode surfaces through the facade-owned
33
+ * `CodeSandboxEvaluator`; the facade rejects the run with
34
+ * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` when no evaluator is configured.
35
+ * - `unsupported`: the backend cannot execute code-mode surfaces at all; the
36
+ * facade rejects the run with `GRAPH_CODE_MODE_UNSUPPORTED_BACKEND` before any
37
+ * remote launch.
38
+ */
39
+ export type GraphCodeMode = "hostSide" | "unsupported";
40
+ /** Whether an optional backend capability is supported. */
41
+ export type GraphBackendCapabilityStatus = "supported" | "not_supported";
42
+ /**
43
+ * Engine-agnostic capability metadata a backend declares. Hosts and servers read
44
+ * this to surface what the active backend can do without probing it.
45
+ */
46
+ export interface GraphBackendCapabilities {
47
+ /** Code-mode handling (mirrors {@link GraphExecutionBackend.codeMode}). */
48
+ codeMode: GraphCodeMode;
49
+ /** Backend workflow listing/lookup support. */
50
+ workflows: {
51
+ list: GraphBackendCapabilityStatus;
52
+ get: GraphBackendCapabilityStatus;
53
+ };
54
+ }
55
+ /** A workflow summary surfaced by backend workflow listing. */
56
+ export interface GraphBackendWorkflowSummary {
57
+ /** Canonical workflow id. */
58
+ id: string;
59
+ /** Display name. */
60
+ name?: string;
61
+ /** Last update timestamp, when the backing store exposes one. */
62
+ updatedAt?: Date;
63
+ }
64
+ /**
65
+ * Minimal workflow catalogue record a {@link GraphBackendWorkflowStore} lists.
66
+ * `GraphWorkflowModel` structurally satisfies it.
67
+ */
68
+ export interface GraphBackendWorkflowRecord {
69
+ /** Canonical workflow id. */
70
+ workflowId: string;
71
+ /** Display name. */
72
+ name?: string;
73
+ /** Last update timestamp, when the backing store exposes one. */
74
+ updatedAt?: Date;
75
+ }
76
+ /**
77
+ * Workflow listing/lookup port the built-in local backend reads through. The
78
+ * existing `GraphWorkflowService` structurally satisfies it; hosts pass their
79
+ * service instance into `GraphExecutionEngineConfig.workflowStore`.
80
+ */
81
+ export interface GraphBackendWorkflowStore {
82
+ /** Lists the workflows visible to the requesting principal. */
83
+ listWorkflows(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowRecord[]>;
84
+ /** Reads a single canonical workflow document. */
85
+ getDocument(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
86
+ }
87
+ /**
88
+ * Facade-owned event sink handed to a backend. The facade owns event
89
+ * sequencing (id/sequence/timestamp) and observer dispatch; a backend reports
90
+ * every transition by calling {@link GraphExecutionEventSink.emit} with a
91
+ * partial event.
92
+ */
93
+ export interface GraphExecutionEventSink {
94
+ /** Enriches, sequences, records, and dispatches a partial event. */
95
+ emit(event: Partial<GraphExecutionEvent>): Promise<void>;
96
+ /** Dispatches an already-built event to all registered observers. */
97
+ updateObservers(event: GraphExecutionEvent): Promise<void>;
98
+ }
99
+ /**
100
+ * Request passed to a {@link GraphExecutionBackend}. Carries both the canonical
101
+ * document (the translation source for remote backends) and the resolved plan
102
+ * (what built-in backends execute).
103
+ */
104
+ export interface GraphBackendExecutionRequest {
105
+ /** The canonical workflow document (translation source). */
106
+ document: GraphWorkflowDocument;
107
+ /** The resolved, topologically layered execution plan. */
108
+ plan: GraphExecutionPlan;
109
+ /** Workflow input values keyed by input port id. */
110
+ inputs: GraphExecutionValues;
111
+ /** Effective execution options (already merged with engine defaults). */
112
+ options: GraphExecutionOptions;
113
+ /** Facade-owned event sink: the backend reports all transitions here. */
114
+ events: GraphExecutionEventSink;
115
+ }
116
+ /**
117
+ * Engine-agnostic resume request for a suspended run (SAA-196 C14). The payload
118
+ * is untrusted: a resume-capable backend validates it (JSON-safe, byte-capped,
119
+ * schema-checked against the suspended revision) before handing it to the engine.
120
+ */
121
+ export interface GraphResumeRequest {
122
+ /** Step id to resume; defaults to the snapshot's single suspended step. */
123
+ step?: string;
124
+ /** Untrusted resume payload supplied by the caller. */
125
+ resumeData?: Record<string, unknown>;
126
+ /** Per-iteration index when resuming inside a `foreach`. */
127
+ forEachIndex?: number;
128
+ }
129
+ /**
130
+ * Engine-agnostic C18 audit record returned by a resume. Carries the caller, run
131
+ * and step identity plus a hash/size of the resume payload — never the raw
132
+ * `resumeData` — so every resume is auditable without leaking secrets.
133
+ */
134
+ export interface GraphResumeAudit {
135
+ /** Resolved caller identity; `null` for anonymous callers. */
136
+ caller?: string | null;
137
+ /** Canonical run id that was resumed. */
138
+ runId: GraphRunId;
139
+ /** Workflow id the resumed run belongs to. */
140
+ workflowId?: string;
141
+ /** Step id the run was resumed at. */
142
+ step?: string;
143
+ /** Per-iteration index when the run resumed inside a `foreach`. */
144
+ forEachIndex?: number;
145
+ /** Stable hash of the resume payload (never the raw payload). */
146
+ resumeDataHash?: string;
147
+ /** Serialized byte size of the resume payload. */
148
+ resumeDataBytes?: number;
149
+ /** ISO timestamp of the accepted resume. */
150
+ at?: string;
151
+ }
152
+ /**
153
+ * The pluggable graph execution seam (the Decaf `Adapter` analogue). Owns
154
+ * exactly one responsibility: given the resolved plan and/or canonical document,
155
+ * run it and report results/events through the request's sink.
156
+ *
157
+ * @typeParam CONFIG - Backend-specific initialization configuration.
158
+ */
159
+ export interface GraphExecutionBackend<CONFIG extends Record<string, unknown> = Record<string, unknown>> {
160
+ /**
161
+ * Resolves the backend's runtime configuration. Called by the facade during
162
+ * `GraphExecutionEngine.initialize`.
163
+ *
164
+ * @param config - Backend-specific configuration.
165
+ * @param args - Optional decaf contextual arguments.
166
+ */
167
+ initialize(config: CONFIG, ...args: MaybeContextualArg<Context>): Promise<void>;
168
+ /**
169
+ * The backend-specific configuration most recently resolved by
170
+ * {@link initialize}, when the backend retains it. The facade reads this during
171
+ * `GraphExecutionEngine.initialize` and merges its own facade-owned keys over
172
+ * it, so a host that configured the backend directly before booting the engine
173
+ * (e.g. `backend.initialize({ mastra, stepHandlers, suspendStateReader })`) does
174
+ * not lose that wiring when the facade initializes the backend.
175
+ *
176
+ * Facade-owned keys (`engine`, `valueAdapter`, `codeSandboxEvaluator`,
177
+ * `workflowStore`) win on collision: the facade is the authority for the
178
+ * collaborators it owns, while every other host key survives. Backends without
179
+ * host-supplied configuration (the built-in local backend) may omit this.
180
+ */
181
+ readonly config?: CONFIG;
182
+ /** Whether this backend executes locally (in-process). */
183
+ readonly local: boolean;
184
+ /**
185
+ * How this backend handles code-mode surfaces (SAA-193 C1). Required so the
186
+ * facade can fail closed before delegating a code-mode workflow to a non-local
187
+ * backend instead of launching it and discovering the limitation remotely.
188
+ */
189
+ readonly codeMode: GraphCodeMode;
190
+ /**
191
+ * Optional capability metadata. When omitted the facade derives capabilities
192
+ * from the declared `codeMode` and the presence of the optional catalogue
193
+ * methods, so an unsupported operation is reported as `not_supported` rather
194
+ * than silently returning an empty result.
195
+ */
196
+ readonly capabilities?: GraphBackendCapabilities;
197
+ /**
198
+ * Lists the workflows this backend can surface, when supported. Backends
199
+ * without a catalogue omit this method (or declare `not_supported`).
200
+ */
201
+ listWorkflows?(...args: MaybeContextualArg<Context>): Promise<GraphBackendWorkflowSummary[]>;
202
+ /**
203
+ * Looks up a single canonical workflow document, when supported. Backends
204
+ * without a catalogue omit this method (or declare `not_supported`).
205
+ */
206
+ getWorkflow?(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowDocument>;
207
+ /**
208
+ * Executes a validated/resolved workflow.
209
+ *
210
+ * @param request - The execution request (document, plan, inputs, options, sink).
211
+ * @param args - Optional decaf contextual arguments.
212
+ * @returns The complete execution result.
213
+ */
214
+ execute(request: GraphBackendExecutionRequest, ...args: MaybeContextualArg<Context>): Promise<GraphExecutionResult>;
215
+ /** Cancels a run, when the backend supports it. */
216
+ cancel?(runId: GraphRunId, reason?: string): boolean | Promise<boolean>;
217
+ /**
218
+ * Resumes a suspended run, when the backend supports suspend/resume (SAA-196
219
+ * extension point). Returns the C18 audit record. A backend that cannot resume
220
+ * omits this method; the facade fails closed rather than silently no-op.
221
+ */
222
+ resume?(runId: GraphRunId, request: GraphResumeRequest, ...args: MaybeContextualArg<Context>): Promise<GraphResumeAudit>;
223
+ /** Releases resources associated with a run, when supported. */
224
+ release?(runId: GraphRunId): void | Promise<void>;
225
+ /** Disposes the backend and its resources, when supported. */
226
+ dispose?(): void | Promise<void>;
227
+ }
228
+ /**
229
+ * Facade-owned sink extension carrying the per-run execution frame, the shared
230
+ * event factory, the owning engine, and the code sandbox evaluator. The built-in
231
+ * {@link LocalGraphExecutionBackend} reads these to execute the plan without
232
+ * duplicating facade-owned run state or event sequencing. This is an internal
233
+ * extension of the public {@link GraphExecutionEventSink} contract: remote
234
+ * backends only ever need the two public methods.
235
+ */
236
+ export interface GraphFrameAwareEventSink extends GraphExecutionEventSink {
237
+ /** The facade's stateful event factory (single sequencing authority). */
238
+ readonly eventFactory: GraphExecutionEventFactory;
239
+ /** The owning execution engine, exposed to node contexts. */
240
+ readonly engine: GraphExecutionEngine;
241
+ /** The facade's code sandbox evaluator, when configured. */
242
+ readonly codeSandboxEvaluator?: CodeSandboxEvaluator;
243
+ /** The run frame, once the facade has bound it. */
244
+ readonly frame?: GraphExecutionFrame;
245
+ /** Binds the run frame after planning; workflow events are then recorded. */
246
+ bindFrame(frame: GraphExecutionFrame): void;
247
+ }
248
+ /**
249
+ * Options used to construct a {@link GraphEngineEventSink}.
250
+ */
251
+ export interface GraphEngineEventSinkOptions {
252
+ /** Unique id of the current run. */
253
+ runId: GraphRunId;
254
+ /** Run id of the parent execution, for nested loop bodies. */
255
+ parentRunId?: GraphRunId;
256
+ /** Canonical workflow id. */
257
+ workflowId: string;
258
+ /** Dotted path from the workflow root. */
259
+ path?: string[];
260
+ /** The owning execution engine. */
261
+ engine: GraphExecutionEngine;
262
+ /** The facade's code sandbox evaluator, when configured. */
263
+ codeSandboxEvaluator?: CodeSandboxEvaluator;
264
+ }
265
+ /**
266
+ * Facade-owned {@link GraphExecutionEventSink} implementation. Enriches each
267
+ * partial event with the run's identity, a factory-assigned id/sequence/
268
+ * timestamp, appends it to the bound frame (when present), and dispatches it to
269
+ * all observers. Validation events emitted before the frame is bound are dispatched
270
+ * but not recorded, matching the reference engine's behaviour.
271
+ */
272
+ export declare class GraphEngineEventSink implements GraphFrameAwareEventSink {
273
+ private readonly emitter;
274
+ readonly eventFactory: GraphExecutionEventFactory;
275
+ private readonly options;
276
+ private _frame?;
277
+ /**
278
+ * @param emitter - The engine's observer emitter.
279
+ * @param eventFactory - The facade's single event factory (sequencing authority).
280
+ * @param options - Run identity, owner, and evaluator defaults.
281
+ */
282
+ constructor(emitter: GraphExecutionEventEmitter, eventFactory: GraphExecutionEventFactory, options: GraphEngineEventSinkOptions);
283
+ /** The owning execution engine. */
284
+ get engine(): GraphExecutionEngine;
285
+ /** The facade's code sandbox evaluator, when configured. */
286
+ get codeSandboxEvaluator(): CodeSandboxEvaluator | undefined;
287
+ /** The run frame, once bound by the facade. */
288
+ get frame(): GraphExecutionFrame | undefined;
289
+ /** Binds the run frame after planning; subsequent events are recorded. */
290
+ bindFrame(frame: GraphExecutionFrame): void;
291
+ /** Enriches, records (when bound), and dispatches a partial event. */
292
+ emit(event: Partial<GraphExecutionEvent>): Promise<void>;
293
+ /** Dispatches an already-built event to all observers. */
294
+ updateObservers(event: GraphExecutionEvent): Promise<void>;
295
+ }
296
+ /**
297
+ * Resolves a backend's effective capability metadata, falling back to what its
298
+ * declared `codeMode` and optional catalogue methods imply. A declared
299
+ * `capabilities` object always wins, so a backend can explicitly mark an
300
+ * operation `not_supported` even when it exposes a method, and an omitted
301
+ * capability never degrades to a silently empty result.
302
+ *
303
+ * @param backend - The backend to inspect.
304
+ * @returns The effective engine-agnostic capability metadata.
305
+ */
306
+ export declare function resolveGraphBackendCapabilities(backend: GraphExecutionBackend): GraphBackendCapabilities;