@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,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.mts";
17
+ import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.mts";
18
+ import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphRunId } from "../types.d.mts";
19
+ import type { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.mts";
20
+ import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.mts";
21
+ import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.mts";
22
+ import type { GraphExecutionEngine } from "./GraphExecutionEngine.d.mts";
23
+ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
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;
@@ -0,0 +1,59 @@
1
+ import type { GraphExecutionBackend } from "./GraphExecutionBackend.d.cts";
2
+ /**
3
+ * Static registry mapping backend flavours to their singleton instances, mirroring
4
+ * Decaf's `Adapter` flavour registry.
5
+ */
6
+ export declare class GraphExecutionBackendRegistry {
7
+ private static _currentFlavour?;
8
+ private static readonly _cache;
9
+ /**
10
+ * Registers a backend under a flavour. Re-registering the same flavour
11
+ * replaces the previous entry (the engine may create several local backends
12
+ * across its lifetime). The current flavour is never changed implicitly:
13
+ * hosts select a non-default backend with {@link setCurrent}, so the engine's
14
+ * default stays a fresh local backend per engine and never shares per-run
15
+ * state between concurrently booted engines.
16
+ *
17
+ * @param flavour - The backend flavour name.
18
+ * @param backend - The backend instance.
19
+ * @returns The registered backend.
20
+ */
21
+ static register<B extends GraphExecutionBackend<any>>(flavour: string, backend: B): B;
22
+ /**
23
+ * Resolves a registered backend by flavour, or the current backend when no
24
+ * flavour is given. Returns `undefined` when nothing is registered.
25
+ *
26
+ * @param flavour - The backend flavour to resolve, if any.
27
+ * @returns The backend instance, or `undefined`.
28
+ */
29
+ static get<B extends GraphExecutionBackend<any>>(flavour?: string): B | undefined;
30
+ /**
31
+ * Resolves a registered backend by flavour, throwing when absent.
32
+ *
33
+ * @param flavour - The backend flavour to resolve.
34
+ * @returns The backend instance.
35
+ * @throws {GraphExecutionError} when no backend is registered under the flavour.
36
+ */
37
+ static getOrFail<B extends GraphExecutionBackend<any>>(flavour: string): B;
38
+ /** The current default backend, when one is registered. */
39
+ static get current(): GraphExecutionBackend<any> | undefined;
40
+ /** The current default backend flavour, defaulting to `local`. */
41
+ static get currentFlavour(): string;
42
+ /** Sets the current default backend flavour. */
43
+ static setCurrent(flavour: string): void;
44
+ /**
45
+ * Lists every registered backend with its flavour, in registration order.
46
+ * Used by the capability manifest to enumerate the available engines without
47
+ * probing them; a flavour is an allowlisted engine id.
48
+ *
49
+ * @returns A snapshot array of registered flavour/backend entries.
50
+ */
51
+ static list(): Array<{
52
+ flavour: string;
53
+ backend: GraphExecutionBackend<any>;
54
+ }>;
55
+ /** Unregisters a backend by flavour. */
56
+ static unregister(flavour?: string): void;
57
+ /** Clears every registered backend (test isolation). */
58
+ static clear(): void;
59
+ }
@@ -0,0 +1,59 @@
1
+ import type { GraphExecutionBackend } from "./GraphExecutionBackend.d.mts";
2
+ /**
3
+ * Static registry mapping backend flavours to their singleton instances, mirroring
4
+ * Decaf's `Adapter` flavour registry.
5
+ */
6
+ export declare class GraphExecutionBackendRegistry {
7
+ private static _currentFlavour?;
8
+ private static readonly _cache;
9
+ /**
10
+ * Registers a backend under a flavour. Re-registering the same flavour
11
+ * replaces the previous entry (the engine may create several local backends
12
+ * across its lifetime). The current flavour is never changed implicitly:
13
+ * hosts select a non-default backend with {@link setCurrent}, so the engine's
14
+ * default stays a fresh local backend per engine and never shares per-run
15
+ * state between concurrently booted engines.
16
+ *
17
+ * @param flavour - The backend flavour name.
18
+ * @param backend - The backend instance.
19
+ * @returns The registered backend.
20
+ */
21
+ static register<B extends GraphExecutionBackend<any>>(flavour: string, backend: B): B;
22
+ /**
23
+ * Resolves a registered backend by flavour, or the current backend when no
24
+ * flavour is given. Returns `undefined` when nothing is registered.
25
+ *
26
+ * @param flavour - The backend flavour to resolve, if any.
27
+ * @returns The backend instance, or `undefined`.
28
+ */
29
+ static get<B extends GraphExecutionBackend<any>>(flavour?: string): B | undefined;
30
+ /**
31
+ * Resolves a registered backend by flavour, throwing when absent.
32
+ *
33
+ * @param flavour - The backend flavour to resolve.
34
+ * @returns The backend instance.
35
+ * @throws {GraphExecutionError} when no backend is registered under the flavour.
36
+ */
37
+ static getOrFail<B extends GraphExecutionBackend<any>>(flavour: string): B;
38
+ /** The current default backend, when one is registered. */
39
+ static get current(): GraphExecutionBackend<any> | undefined;
40
+ /** The current default backend flavour, defaulting to `local`. */
41
+ static get currentFlavour(): string;
42
+ /** Sets the current default backend flavour. */
43
+ static setCurrent(flavour: string): void;
44
+ /**
45
+ * Lists every registered backend with its flavour, in registration order.
46
+ * Used by the capability manifest to enumerate the available engines without
47
+ * probing them; a flavour is an allowlisted engine id.
48
+ *
49
+ * @returns A snapshot array of registered flavour/backend entries.
50
+ */
51
+ static list(): Array<{
52
+ flavour: string;
53
+ backend: GraphExecutionBackend<any>;
54
+ }>;
55
+ /** Unregisters a backend by flavour. */
56
+ static unregister(flavour?: string): void;
57
+ /** Clears every registered backend (test isolation). */
58
+ static clear(): void;
59
+ }