@decaf-ts/as-graph 0.2.1 → 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 (285) hide show
  1. package/README.md +158 -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 +4 -0
  35. package/lib/cjs/engine/index.cjs.map +1 -1
  36. package/lib/cjs/engine/runs/GraphRunService.cjs +61 -0
  37. package/lib/cjs/engine/runs/GraphRunService.cjs.map +1 -1
  38. package/lib/cjs/engine/services/GraphWorkflowService.cjs +33 -14
  39. package/lib/cjs/engine/services/GraphWorkflowService.cjs.map +1 -1
  40. package/lib/cjs/mastra/MastraCapabilities.cjs +171 -0
  41. package/lib/cjs/mastra/MastraCapabilities.cjs.map +1 -0
  42. package/lib/cjs/mastra/MastraConditionBridge.cjs +39 -0
  43. package/lib/cjs/mastra/MastraConditionBridge.cjs.map +1 -0
  44. package/lib/cjs/mastra/MastraEventBridge.cjs +486 -0
  45. package/lib/cjs/mastra/MastraEventBridge.cjs.map +1 -0
  46. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs +351 -0
  47. package/lib/cjs/mastra/MastraGraphExecutionBackend.cjs.map +1 -0
  48. package/lib/cjs/mastra/MastraResumeGuard.cjs +127 -0
  49. package/lib/cjs/mastra/MastraResumeGuard.cjs.map +1 -0
  50. package/lib/cjs/mastra/MastraSchemaConverter.cjs +124 -0
  51. package/lib/cjs/mastra/MastraSchemaConverter.cjs.map +1 -0
  52. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +461 -0
  53. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -0
  54. package/lib/cjs/mastra/MastraWorkflowManager.cjs +401 -0
  55. package/lib/cjs/mastra/MastraWorkflowManager.cjs.map +1 -0
  56. package/lib/cjs/mastra/index.cjs +35 -0
  57. package/lib/cjs/mastra/index.cjs.map +1 -0
  58. package/lib/cjs/mastra/types.cjs +34 -0
  59. package/lib/cjs/mastra/types.cjs.map +1 -0
  60. package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs +136 -0
  61. package/lib/cjs/nest/graph/GraphEngineCapabilityManifest.cjs.map +1 -0
  62. package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs +140 -0
  63. package/lib/cjs/nest/graph/GraphEngineCapabilityService.cjs.map +1 -0
  64. package/lib/cjs/nest/graph/GraphEngineController.cjs +227 -0
  65. package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -0
  66. package/lib/cjs/nest/graph/GraphExecutionModule.cjs +30 -2
  67. package/lib/cjs/nest/graph/GraphExecutionModule.cjs.map +1 -1
  68. package/lib/cjs/nest/graph/index.cjs +3 -0
  69. package/lib/cjs/nest/graph/index.cjs.map +1 -1
  70. package/lib/cjs/nest/graph/main.cjs +54 -0
  71. package/lib/cjs/nest/graph/main.cjs.map +1 -0
  72. package/lib/cjs/nest/graph/servingErrors.cjs +3 -0
  73. package/lib/cjs/nest/graph/servingErrors.cjs.map +1 -1
  74. package/lib/cjs/node/utility/code/node.cjs +11 -3
  75. package/lib/cjs/node/utility/code/node.cjs.map +1 -1
  76. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs +2 -3
  77. package/lib/cjs/shared/graph/catalog/GraphManifestCompiler.cjs.map +1 -1
  78. package/lib/cjs/shared/graph/constants.cjs +8 -0
  79. package/lib/cjs/shared/graph/constants.cjs.map +1 -1
  80. package/lib/cjs/shared/graph/index.cjs +2 -1
  81. package/lib/cjs/shared/graph/index.cjs.map +1 -1
  82. package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs +146 -0
  83. package/lib/cjs/shared/graph/layout/GraphWorkflowLayout.cjs.map +1 -0
  84. package/lib/cjs/shared/graph/layout/index.cjs +23 -0
  85. package/lib/cjs/shared/graph/layout/index.cjs.map +1 -0
  86. package/lib/cjs/shared/graph/layout/layout-options.cjs +93 -0
  87. package/lib/cjs/shared/graph/layout/layout-options.cjs.map +1 -0
  88. package/lib/cjs/shared/ui/index.cjs +8 -10
  89. package/lib/cjs/shared/ui/index.cjs.map +1 -1
  90. package/lib/esm/dagster/DagsterGraphEventBridge.js +339 -0
  91. package/lib/esm/dagster/DagsterGraphEventBridge.js.map +1 -0
  92. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +781 -0
  93. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -0
  94. package/lib/esm/dagster/DagsterResultMapper.js +51 -0
  95. package/lib/esm/dagster/DagsterResultMapper.js.map +1 -0
  96. package/lib/esm/dagster/DagsterTypes.js +2 -0
  97. package/lib/esm/dagster/DagsterTypes.js.map +1 -0
  98. package/lib/esm/dagster/capabilities.js +97 -0
  99. package/lib/esm/dagster/capabilities.js.map +1 -0
  100. package/lib/esm/dagster/constants.js +88 -0
  101. package/lib/esm/dagster/constants.js.map +1 -0
  102. package/lib/esm/dagster/index.js +15 -0
  103. package/lib/esm/dagster/index.js.map +1 -0
  104. package/lib/esm/engine/constants.js +5 -0
  105. package/lib/esm/engine/constants.js.map +1 -1
  106. package/lib/esm/engine/execution/GraphCodeMode.js +132 -0
  107. package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -0
  108. package/lib/esm/engine/execution/GraphExecutionBackend.js +83 -0
  109. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -0
  110. package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js +102 -0
  111. package/lib/esm/engine/execution/GraphExecutionBackendRegistry.js.map +1 -0
  112. package/lib/esm/engine/execution/GraphExecutionEngine.js +232 -716
  113. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  114. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js +799 -0
  115. package/lib/esm/engine/execution/LocalGraphExecutionBackend.js.map +1 -0
  116. package/lib/esm/engine/execution/index.js +4 -0
  117. package/lib/esm/engine/execution/index.js.map +1 -1
  118. package/lib/esm/engine/index.js +4 -0
  119. package/lib/esm/engine/index.js.map +1 -1
  120. package/lib/esm/engine/runs/GraphRunService.js +62 -1
  121. package/lib/esm/engine/runs/GraphRunService.js.map +1 -1
  122. package/lib/esm/engine/services/GraphWorkflowService.js +33 -14
  123. package/lib/esm/engine/services/GraphWorkflowService.js.map +1 -1
  124. package/lib/esm/mastra/MastraCapabilities.js +164 -0
  125. package/lib/esm/mastra/MastraCapabilities.js.map +1 -0
  126. package/lib/esm/mastra/MastraConditionBridge.js +34 -0
  127. package/lib/esm/mastra/MastraConditionBridge.js.map +1 -0
  128. package/lib/esm/mastra/MastraEventBridge.js +481 -0
  129. package/lib/esm/mastra/MastraEventBridge.js.map +1 -0
  130. package/lib/esm/mastra/MastraGraphExecutionBackend.js +346 -0
  131. package/lib/esm/mastra/MastraGraphExecutionBackend.js.map +1 -0
  132. package/lib/esm/mastra/MastraResumeGuard.js +123 -0
  133. package/lib/esm/mastra/MastraResumeGuard.js.map +1 -0
  134. package/lib/esm/mastra/MastraSchemaConverter.js +119 -0
  135. package/lib/esm/mastra/MastraSchemaConverter.js.map +1 -0
  136. package/lib/esm/mastra/MastraWorkflowCompiler.js +456 -0
  137. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -0
  138. package/lib/esm/mastra/MastraWorkflowManager.js +396 -0
  139. package/lib/esm/mastra/MastraWorkflowManager.js.map +1 -0
  140. package/lib/esm/mastra/index.js +18 -0
  141. package/lib/esm/mastra/index.js.map +1 -0
  142. package/lib/esm/mastra/types.js +30 -0
  143. package/lib/esm/mastra/types.js.map +1 -0
  144. package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js +129 -0
  145. package/lib/esm/nest/graph/GraphEngineCapabilityManifest.js.map +1 -0
  146. package/lib/esm/nest/graph/GraphEngineCapabilityService.js +131 -0
  147. package/lib/esm/nest/graph/GraphEngineCapabilityService.js.map +1 -0
  148. package/lib/esm/nest/graph/GraphEngineController.js +218 -0
  149. package/lib/esm/nest/graph/GraphEngineController.js.map +1 -0
  150. package/lib/esm/nest/graph/GraphExecutionModule.js +30 -2
  151. package/lib/esm/nest/graph/GraphExecutionModule.js.map +1 -1
  152. package/lib/esm/nest/graph/index.js +3 -0
  153. package/lib/esm/nest/graph/index.js.map +1 -1
  154. package/lib/esm/nest/graph/main.js +51 -0
  155. package/lib/esm/nest/graph/main.js.map +1 -0
  156. package/lib/esm/nest/graph/servingErrors.js +3 -0
  157. package/lib/esm/nest/graph/servingErrors.js.map +1 -1
  158. package/lib/esm/node/utility/code/node.js +11 -3
  159. package/lib/esm/node/utility/code/node.js.map +1 -1
  160. package/lib/esm/shared/graph/GraphExecutionStateMapper.js.map +1 -1
  161. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js +2 -3
  162. package/lib/esm/shared/graph/catalog/GraphManifestCompiler.js.map +1 -1
  163. package/lib/esm/shared/graph/constants.js +8 -0
  164. package/lib/esm/shared/graph/constants.js.map +1 -1
  165. package/lib/esm/shared/graph/index.js +2 -1
  166. package/lib/esm/shared/graph/index.js.map +1 -1
  167. package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js +107 -0
  168. package/lib/esm/shared/graph/layout/GraphWorkflowLayout.js.map +1 -0
  169. package/lib/esm/shared/graph/layout/index.js +6 -0
  170. package/lib/esm/shared/graph/layout/index.js.map +1 -0
  171. package/lib/esm/shared/graph/layout/layout-options.js +96 -0
  172. package/lib/esm/shared/graph/layout/layout-options.js.map +1 -0
  173. package/lib/esm/shared/ui/index.js +8 -10
  174. package/lib/esm/shared/ui/index.js.map +1 -1
  175. package/lib/types/dagster/DagsterGraphEventBridge.d.cts +142 -0
  176. package/lib/types/dagster/DagsterGraphEventBridge.d.mts +142 -0
  177. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +323 -0
  178. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +323 -0
  179. package/lib/types/dagster/DagsterResultMapper.d.cts +50 -0
  180. package/lib/types/dagster/DagsterResultMapper.d.mts +50 -0
  181. package/lib/types/dagster/DagsterTypes.d.cts +355 -0
  182. package/lib/types/dagster/DagsterTypes.d.mts +355 -0
  183. package/lib/types/dagster/capabilities.d.cts +34 -0
  184. package/lib/types/dagster/capabilities.d.mts +34 -0
  185. package/lib/types/dagster/constants.d.cts +87 -0
  186. package/lib/types/dagster/constants.d.mts +87 -0
  187. package/lib/types/dagster/index.d.cts +14 -0
  188. package/lib/types/dagster/index.d.mts +14 -0
  189. package/lib/types/engine/constants.d.cts +5 -0
  190. package/lib/types/engine/constants.d.mts +5 -0
  191. package/lib/types/engine/execution/GraphCodeMode.d.cts +52 -0
  192. package/lib/types/engine/execution/GraphCodeMode.d.mts +52 -0
  193. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +306 -0
  194. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +306 -0
  195. package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.cts +59 -0
  196. package/lib/types/engine/execution/GraphExecutionBackendRegistry.d.mts +59 -0
  197. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +116 -135
  198. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +116 -135
  199. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.cts +232 -0
  200. package/lib/types/engine/execution/LocalGraphExecutionBackend.d.mts +232 -0
  201. package/lib/types/engine/execution/index.d.cts +4 -0
  202. package/lib/types/engine/execution/index.d.mts +4 -0
  203. package/lib/types/engine/index.d.cts +4 -0
  204. package/lib/types/engine/index.d.mts +4 -0
  205. package/lib/types/engine/runs/GraphRunService.d.cts +19 -0
  206. package/lib/types/engine/runs/GraphRunService.d.mts +19 -0
  207. package/lib/types/engine/services/GraphWorkflowService.d.cts +22 -0
  208. package/lib/types/engine/services/GraphWorkflowService.d.mts +22 -0
  209. package/lib/types/mastra/MastraCapabilities.d.cts +91 -0
  210. package/lib/types/mastra/MastraCapabilities.d.mts +91 -0
  211. package/lib/types/mastra/MastraConditionBridge.d.cts +38 -0
  212. package/lib/types/mastra/MastraConditionBridge.d.mts +38 -0
  213. package/lib/types/mastra/MastraEventBridge.d.cts +189 -0
  214. package/lib/types/mastra/MastraEventBridge.d.mts +189 -0
  215. package/lib/types/mastra/MastraGraphExecutionBackend.d.cts +119 -0
  216. package/lib/types/mastra/MastraGraphExecutionBackend.d.mts +119 -0
  217. package/lib/types/mastra/MastraResumeGuard.d.cts +58 -0
  218. package/lib/types/mastra/MastraResumeGuard.d.mts +58 -0
  219. package/lib/types/mastra/MastraSchemaConverter.d.cts +39 -0
  220. package/lib/types/mastra/MastraSchemaConverter.d.mts +39 -0
  221. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +218 -0
  222. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +218 -0
  223. package/lib/types/mastra/MastraWorkflowManager.d.cts +220 -0
  224. package/lib/types/mastra/MastraWorkflowManager.d.mts +220 -0
  225. package/lib/types/mastra/index.d.cts +17 -0
  226. package/lib/types/mastra/index.d.mts +17 -0
  227. package/lib/types/mastra/types.d.cts +222 -0
  228. package/lib/types/mastra/types.d.mts +222 -0
  229. package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.cts +87 -0
  230. package/lib/types/nest/graph/GraphEngineCapabilityManifest.d.mts +87 -0
  231. package/lib/types/nest/graph/GraphEngineCapabilityService.d.cts +98 -0
  232. package/lib/types/nest/graph/GraphEngineCapabilityService.d.mts +98 -0
  233. package/lib/types/nest/graph/GraphEngineController.d.cts +74 -0
  234. package/lib/types/nest/graph/GraphEngineController.d.mts +74 -0
  235. package/lib/types/nest/graph/GraphExecutionModule.d.cts +8 -0
  236. package/lib/types/nest/graph/GraphExecutionModule.d.mts +8 -0
  237. package/lib/types/nest/graph/index.d.cts +3 -0
  238. package/lib/types/nest/graph/index.d.mts +3 -0
  239. package/lib/types/nest/graph/main.d.cts +1 -0
  240. package/lib/types/nest/graph/main.d.mts +1 -0
  241. package/lib/types/nest/graph/servingErrors.d.cts +3 -1
  242. package/lib/types/nest/graph/servingErrors.d.mts +3 -1
  243. package/lib/types/node/utility/code/node.d.cts +1 -1
  244. package/lib/types/node/utility/code/node.d.mts +1 -1
  245. package/lib/types/shared/graph/GraphExecutionStateMapper.d.cts +5 -5
  246. package/lib/types/shared/graph/GraphExecutionStateMapper.d.mts +5 -5
  247. package/lib/types/shared/graph/constants.d.cts +8 -0
  248. package/lib/types/shared/graph/constants.d.mts +8 -0
  249. package/lib/types/shared/graph/index.d.cts +2 -1
  250. package/lib/types/shared/graph/index.d.mts +2 -1
  251. package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.cts +49 -0
  252. package/lib/types/shared/graph/layout/GraphWorkflowLayout.d.mts +49 -0
  253. package/lib/types/shared/graph/layout/index.d.cts +5 -0
  254. package/lib/types/shared/graph/layout/index.d.mts +5 -0
  255. package/lib/types/shared/graph/layout/layout-options.d.cts +46 -0
  256. package/lib/types/shared/graph/layout/layout-options.d.mts +46 -0
  257. package/lib/types/shared/graph/types.d.cts +4 -3
  258. package/lib/types/shared/graph/types.d.mts +4 -3
  259. package/lib/types/shared/ui/index.d.cts +8 -10
  260. package/lib/types/shared/ui/index.d.mts +8 -10
  261. package/package.json +49 -6
  262. package/lib/cjs/shared/ui/GraphNodeView.cjs +0 -114
  263. package/lib/cjs/shared/ui/GraphNodeView.cjs.map +0 -1
  264. package/lib/cjs/shared/ui/GraphRunView.cjs +0 -96
  265. package/lib/cjs/shared/ui/GraphRunView.cjs.map +0 -1
  266. package/lib/cjs/shared/ui/GraphWorkflowView.cjs +0 -78
  267. package/lib/cjs/shared/ui/GraphWorkflowView.cjs.map +0 -1
  268. package/lib/cjs/shared/ui/types.cjs +0 -4
  269. package/lib/cjs/shared/ui/types.cjs.map +0 -1
  270. package/lib/esm/shared/ui/GraphNodeView.js +0 -107
  271. package/lib/esm/shared/ui/GraphNodeView.js.map +0 -1
  272. package/lib/esm/shared/ui/GraphRunView.js +0 -90
  273. package/lib/esm/shared/ui/GraphRunView.js.map +0 -1
  274. package/lib/esm/shared/ui/GraphWorkflowView.js +0 -72
  275. package/lib/esm/shared/ui/GraphWorkflowView.js.map +0 -1
  276. package/lib/esm/shared/ui/types.js +0 -2
  277. package/lib/esm/shared/ui/types.js.map +0 -1
  278. package/lib/types/shared/ui/GraphNodeView.d.cts +0 -48
  279. package/lib/types/shared/ui/GraphNodeView.d.mts +0 -48
  280. package/lib/types/shared/ui/GraphRunView.d.cts +0 -88
  281. package/lib/types/shared/ui/GraphRunView.d.mts +0 -88
  282. package/lib/types/shared/ui/GraphWorkflowView.d.cts +0 -18
  283. package/lib/types/shared/ui/GraphWorkflowView.d.mts +0 -18
  284. package/lib/types/shared/ui/types.d.cts +0 -200
  285. package/lib/types/shared/ui/types.d.mts +0 -200
@@ -0,0 +1,396 @@
1
+ import { GraphExecutionError } from "./../engine/errors/GraphExecutionError.js";
2
+ import { graphRunDocumentFingerprint } from "./../engine/runs/GraphRunFingerprint.js";
3
+ import { canAccessGraphResource } from "./../engine/runs/ownership.js";
4
+ import { graphWorkflowOwnerOf } from "./../engine/services/GraphWorkflowService.js";
5
+ import { MastraWorkflowCompiler } from "./MastraWorkflowCompiler.js";
6
+ import { GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE, GRAPH_MASTRA_PERSIST_NOT_SUPPORTED, GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED, GRAPH_MASTRA_WORKFLOW_FORBIDDEN, GRAPH_MASTRA_WORKFLOW_NOT_FOUND, } from "./types.js";
7
+ /**
8
+ * Structural check for a Decaf execution {@link Context} inside a
9
+ * {@link MaybeContextualArg} argument list. Mirrors `@decaf-ts/core`'s own
10
+ * realm-safe duck-typing (multiple linked core builds defeat `instanceof`).
11
+ *
12
+ * @param value - A candidate argument.
13
+ * @returns `true` when the value is a Decaf execution context.
14
+ */
15
+ function isMastraManagerContextLike(value) {
16
+ if (!value || typeof value !== "object")
17
+ return false;
18
+ const candidate = value;
19
+ return (typeof candidate.get === "function" &&
20
+ typeof candidate.accumulate === "function" &&
21
+ typeof candidate.override === "function" &&
22
+ typeof candidate.toOverrides === "function" &&
23
+ candidate.cache !== undefined);
24
+ }
25
+ /**
26
+ * Resolves the caller owner from the forwarded contextual arguments, matching the
27
+ * backend's C23 resolution. The trailing context, when present, carries the
28
+ * authenticated principal resolved with {@link graphWorkflowOwnerOf}.
29
+ *
30
+ * @param args - The forwarded contextual arguments.
31
+ * @returns The caller owner, or `undefined` for owner-less callers.
32
+ */
33
+ function mastraManagerCallerOwnerOf(args) {
34
+ for (let index = args.length - 1; index >= 0; index -= 1) {
35
+ const candidate = args[index];
36
+ if (isMastraManagerContextLike(candidate)) {
37
+ return graphWorkflowOwnerOf(candidate);
38
+ }
39
+ }
40
+ return undefined;
41
+ }
42
+ /**
43
+ * Management surface over real `@mastra/core` workflows (SAA-346). Holds only the
44
+ * wired runtime reference and the canonical-document compiler; it never constructs a
45
+ * Mastra primitive itself and never synthesizes a method the pinned library does not
46
+ * expose. Every method validates the runtime surface it needs first and fails
47
+ * closed with {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE} otherwise.
48
+ */
49
+ export class MastraWorkflowManager {
50
+ /**
51
+ * @param options - The wired runtime and optional shared compiler.
52
+ */
53
+ constructor(options = {}) {
54
+ this.options = options;
55
+ /** Canonical document revision (fingerprint) by managed workflow id. */
56
+ this.revisions = new Map();
57
+ /**
58
+ * Wrapper-managed provenance: the owner recorded when the wrapper created or
59
+ * updated a workflow. An id absent from this map is not wrapper-managed, so a
60
+ * host `origin: "code"` registration is protected from overwrite/delete (C3).
61
+ */
62
+ this.owners = new Map();
63
+ /** Standalone compiler used when the host does not inject one. */
64
+ this.fallbackCompiler = new MastraWorkflowCompiler();
65
+ }
66
+ /** The wired real `@mastra/core` runtime, when any. */
67
+ get runtime() {
68
+ return this.options.runtime;
69
+ }
70
+ /**
71
+ * Registers a workflow translated from a canonical document on the real Mastra
72
+ * instance (real `addWorkflow`). This is the honest "create" operation: the
73
+ * pinned library registers live, it does not persist a translated code-step
74
+ * definition (see {@link persist}).
75
+ *
76
+ * @param document - The canonical document to translate and register.
77
+ * @returns The managed workflow descriptor.
78
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
79
+ * when the runtime exposes no `addWorkflow`.
80
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_UNSUPPORTED_KIND} when the
81
+ * document cannot be translated.
82
+ */
83
+ async create(document, ...args) {
84
+ const runtime = this.requireRuntime("addWorkflow");
85
+ const owner = mastraManagerCallerOwnerOf(args);
86
+ this.assertWritableProvenance(runtime, document.id);
87
+ const compiled = this.compilerOf().compile(document);
88
+ this.revisions.set(document.id, compiled.fingerprint);
89
+ this.owners.set(document.id, owner);
90
+ runtime.addWorkflow?.(compiled.workflow, document.id);
91
+ return this.describe(document.id);
92
+ }
93
+ /**
94
+ * Edits a managed workflow by recompiling the updated canonical document and
95
+ * replacing the live registration (real `removeWorkflow` then `addWorkflow`). The
96
+ * pinned library documents `removeWorkflow` as the update/delete path so a
97
+ * subsequent save can re-register the same id cleanly.
98
+ *
99
+ * @param document - The updated canonical document.
100
+ * @returns The managed workflow descriptor with its new revision.
101
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
102
+ * when the runtime exposes no `addWorkflow`/`removeWorkflow`.
103
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_NOT_FOUND} when
104
+ * no workflow is registered under the document id.
105
+ */
106
+ async update(document, ...args) {
107
+ const runtime = this.requireRuntime("addWorkflow", "removeWorkflow");
108
+ const owner = mastraManagerCallerOwnerOf(args);
109
+ this.assertWritableProvenance(runtime, document.id);
110
+ this.assertOwnerAccess(document.id, owner);
111
+ const compiled = this.compilerOf().compile(document);
112
+ const removed = runtime.removeWorkflow?.(document.id) === true;
113
+ if (!removed) {
114
+ throw new GraphExecutionError(`Mastra runtime has no managed workflow '${document.id}' to update`, GRAPH_MASTRA_WORKFLOW_NOT_FOUND, { workflowId: document.id });
115
+ }
116
+ this.revisions.set(document.id, compiled.fingerprint);
117
+ this.owners.set(document.id, owner);
118
+ runtime.addWorkflow?.(compiled.workflow, document.id);
119
+ return this.describe(document.id);
120
+ }
121
+ /**
122
+ * Deletes a managed workflow from the live Mastra registry (real
123
+ * `removeWorkflow`).
124
+ *
125
+ * @param workflowId - The managed workflow id to remove.
126
+ * @returns `true` when a workflow was removed.
127
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
128
+ * when the runtime exposes no `removeWorkflow`.
129
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_NOT_FOUND} when no
130
+ * workflow is registered under the id.
131
+ */
132
+ async delete(workflowId, ...args) {
133
+ const runtime = this.requireRuntime("removeWorkflow");
134
+ const owner = mastraManagerCallerOwnerOf(args);
135
+ this.assertWritableProvenance(runtime, workflowId);
136
+ this.assertOwnerAccess(workflowId, owner);
137
+ const removed = runtime.removeWorkflow?.(workflowId) === true;
138
+ if (!removed) {
139
+ throw new GraphExecutionError(`Mastra runtime has no managed workflow '${workflowId}' to delete`, GRAPH_MASTRA_WORKFLOW_NOT_FOUND, { workflowId });
140
+ }
141
+ this.revisions.delete(workflowId);
142
+ this.owners.delete(workflowId);
143
+ return true;
144
+ }
145
+ /**
146
+ * Lists the managed workflows registered on the real Mastra instance (real
147
+ * `listWorkflows`).
148
+ *
149
+ * @returns The managed workflow descriptors, in registry order.
150
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
151
+ * when the runtime exposes no `listWorkflows`.
152
+ */
153
+ async list() {
154
+ const runtime = this.requireRuntime("listWorkflows");
155
+ const registered = runtime.listWorkflows?.() ?? {};
156
+ return Object.entries(registered).map(([id, workflow]) => this.describeWorkflow(id, workflow));
157
+ }
158
+ /**
159
+ * Reads one managed workflow registered on the real Mastra instance (real
160
+ * `getWorkflow`).
161
+ *
162
+ * @param workflowId - The managed workflow id to read.
163
+ * @returns The managed workflow descriptor.
164
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
165
+ * when the runtime exposes no `getWorkflow`.
166
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_NOT_FOUND} when no
167
+ * workflow is registered under the id.
168
+ */
169
+ async get(workflowId) {
170
+ const runtime = this.requireRuntime("getWorkflow");
171
+ const workflow = this.registeredWorkflow(runtime, workflowId);
172
+ return this.describeWorkflow(workflowId, workflow);
173
+ }
174
+ /**
175
+ * Serializes a managed workflow through the real Mastra
176
+ * `Workflow.serializedStepGraph` surface.
177
+ *
178
+ * @param workflowId - The managed workflow id to serialize.
179
+ * @returns The JSON-safe serialized workflow.
180
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
181
+ * when the runtime exposes no `getWorkflow`.
182
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_NOT_FOUND} when no
183
+ * workflow is registered under the id.
184
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED}
185
+ * when the registered workflow exposes no serializable step graph.
186
+ */
187
+ async serialize(workflowId) {
188
+ const runtime = this.requireRuntime("getWorkflow");
189
+ const workflow = this.registeredWorkflow(runtime, workflowId);
190
+ const steps = workflow
191
+ .serializedStepGraph;
192
+ if (!Array.isArray(steps)) {
193
+ throw new GraphExecutionError(`Mastra workflow '${workflowId}' exposes no serialized step graph`, GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED, { workflowId });
194
+ }
195
+ const revision = this.revisions.get(workflowId);
196
+ return {
197
+ id: workflowId,
198
+ ...(revision !== undefined ? { revision } : {}),
199
+ steps,
200
+ };
201
+ }
202
+ /**
203
+ * The canonical document revision (fingerprint) the wrapper tracks for a
204
+ * document. Mastra has no native workflow version, so this is the honest
205
+ * `EXTENSION-POINT` revision identity: it is computed from the canonical
206
+ * document alone and requires no runtime.
207
+ *
208
+ * @param document - The canonical document to fingerprint.
209
+ * @returns The stable revision fingerprint.
210
+ */
211
+ revision(document) {
212
+ return graphRunDocumentFingerprint(document);
213
+ }
214
+ /**
215
+ * Persists a translated workflow to Mastra storage. The pinned real
216
+ * `Mastra.addDynamicWorkflow` persists only agent/tool-referenced steps, while
217
+ * the canonical translation emits host code steps, so this operation is
218
+ * `NOT-SUPPORTED` and fails closed rather than faking a persisted definition.
219
+ *
220
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_PERSIST_NOT_SUPPORTED}
221
+ * always.
222
+ */
223
+ async persist() {
224
+ throw new GraphExecutionError("Mastra addDynamicWorkflow persists only agent/tool-referenced steps; the canonical translation emits host code steps", GRAPH_MASTRA_PERSIST_NOT_SUPPORTED);
225
+ }
226
+ /** The compiler the surface translates canonical documents with. */
227
+ compilerOf() {
228
+ return this.options.compiler ?? this.fallbackCompiler;
229
+ }
230
+ /**
231
+ * Resolves the wired runtime after asserting it exposes every required real
232
+ * Mastra method.
233
+ *
234
+ * @param methods - The real method names the operation needs.
235
+ * @returns The wired runtime.
236
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE}
237
+ * when the runtime is unwired or omits a required method.
238
+ */
239
+ requireRuntime(...methods) {
240
+ const runtime = this.options.runtime;
241
+ if (!runtime || typeof runtime !== "object") {
242
+ throw new GraphExecutionError("Mastra runtime is not wired; workflow management is unavailable", GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE);
243
+ }
244
+ const candidate = runtime;
245
+ for (const method of methods) {
246
+ if (typeof candidate[method] !== "function") {
247
+ throw new GraphExecutionError(`Mastra runtime exposes no '${method}' method; workflow management is unavailable`, GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE, { method });
248
+ }
249
+ }
250
+ return runtime;
251
+ }
252
+ /**
253
+ * Fails closed when a management mutation targets a workflow the wrapper did not
254
+ * create (C3 complete mediation). A wrapper-managed id is writable; any
255
+ * pre-existing registration — including a host `origin: "code"` workflow — is
256
+ * protected from overwrite/delete, and an existing workflow whose provenance
257
+ * cannot be determined is refused rather than mutated.
258
+ *
259
+ * @param runtime - The validated runtime.
260
+ * @param workflowId - The managed workflow id.
261
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_FORBIDDEN} when the
262
+ * workflow is not wrapper-managed.
263
+ */
264
+ assertWritableProvenance(runtime, workflowId) {
265
+ if (this.revisions.has(workflowId))
266
+ return;
267
+ const origin = this.originOf(runtime, workflowId);
268
+ if (origin !== undefined) {
269
+ throw new GraphExecutionError(`Mastra workflow '${workflowId}' is a host registration (origin '${origin}'); the wrapper only manages workflows it created`, GRAPH_MASTRA_WORKFLOW_FORBIDDEN, { workflowId, origin });
270
+ }
271
+ if (this.registered(runtime, workflowId)) {
272
+ throw new GraphExecutionError(`Mastra workflow '${workflowId}' exists but is not wrapper-managed; refusing to modify a foreign registration`, GRAPH_MASTRA_WORKFLOW_FORBIDDEN, { workflowId });
273
+ }
274
+ }
275
+ /**
276
+ * Enforces the C23 ownership predicate on a wrapper-managed workflow before a
277
+ * management mutation, mirroring the backend's `canAccessGraphResource`
278
+ * enforcement. Owner-less workflows stay writable by every caller.
279
+ *
280
+ * @param workflowId - The managed workflow id.
281
+ * @param callerOwner - The caller owner resolved from the context.
282
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_FORBIDDEN} when the
283
+ * caller may not write the workflow.
284
+ */
285
+ assertOwnerAccess(workflowId, callerOwner) {
286
+ const owner = this.owners.get(workflowId);
287
+ if (!canAccessGraphResource({ owner }, callerOwner)) {
288
+ throw new GraphExecutionError(`Mastra workflow '${workflowId}' is not writable by the caller`, GRAPH_MASTRA_WORKFLOW_FORBIDDEN, { workflowId });
289
+ }
290
+ }
291
+ /**
292
+ * Reads how the runtime reports a workflow's registration origin.
293
+ *
294
+ * @param runtime - The validated runtime.
295
+ * @param workflowId - The workflow id.
296
+ * @returns The origin, or `undefined` when the runtime reports none.
297
+ */
298
+ originOf(runtime, workflowId) {
299
+ if (typeof runtime.getWorkflowOrigin !== "function")
300
+ return undefined;
301
+ try {
302
+ return runtime.getWorkflowOrigin(workflowId);
303
+ }
304
+ catch {
305
+ return undefined;
306
+ }
307
+ }
308
+ /**
309
+ * Whether the runtime already has a workflow registered under the id.
310
+ *
311
+ * @param runtime - The validated runtime.
312
+ * @param workflowId - The workflow id.
313
+ * @returns `true` when a workflow is registered under the id.
314
+ */
315
+ registered(runtime, workflowId) {
316
+ if (typeof runtime.getWorkflow !== "function")
317
+ return false;
318
+ try {
319
+ const workflow = runtime.getWorkflow(workflowId);
320
+ return workflow !== undefined && workflow !== null;
321
+ }
322
+ catch {
323
+ return false;
324
+ }
325
+ }
326
+ /**
327
+ * Reads a registered workflow, mapping the real not-found failure onto the
328
+ * canonical error code.
329
+ *
330
+ * @param runtime - The validated runtime.
331
+ * @param workflowId - The managed workflow id to read.
332
+ * @returns The registered workflow object.
333
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_WORKFLOW_NOT_FOUND} when no
334
+ * workflow is registered under the id.
335
+ */
336
+ registeredWorkflow(runtime, workflowId) {
337
+ let workflow;
338
+ try {
339
+ workflow = runtime.getWorkflow?.(workflowId);
340
+ }
341
+ catch {
342
+ workflow = undefined;
343
+ }
344
+ if (workflow === undefined || workflow === null) {
345
+ throw new GraphExecutionError(`Mastra runtime has no managed workflow '${workflowId}'`, GRAPH_MASTRA_WORKFLOW_NOT_FOUND, { workflowId });
346
+ }
347
+ return workflow;
348
+ }
349
+ /**
350
+ * Builds a managed workflow descriptor, reading the real registration origin
351
+ * and the wrapper-tracked revision when available.
352
+ *
353
+ * @param workflowId - The managed workflow id.
354
+ * @param workflow - The registered workflow object.
355
+ * @returns The managed workflow descriptor.
356
+ */
357
+ describeWorkflow(workflowId, workflow) {
358
+ const name = workflow?.name;
359
+ let origin;
360
+ const runtime = this.options.runtime;
361
+ try {
362
+ origin = runtime?.getWorkflowOrigin?.(workflowId);
363
+ }
364
+ catch {
365
+ origin = undefined;
366
+ }
367
+ const revision = this.revisions.get(workflowId);
368
+ return {
369
+ id: workflowId,
370
+ ...(typeof name === "string" ? { name } : {}),
371
+ ...(origin ? { origin } : {}),
372
+ ...(revision !== undefined ? { revision } : {}),
373
+ };
374
+ }
375
+ /**
376
+ * Builds a descriptor for a workflow the wrapper has just registered or
377
+ * updated.
378
+ *
379
+ * @param workflowId - The managed workflow id.
380
+ * @returns The managed workflow descriptor.
381
+ */
382
+ describe(workflowId) {
383
+ const runtime = this.options.runtime;
384
+ let workflow;
385
+ if (typeof runtime?.getWorkflow === "function") {
386
+ try {
387
+ workflow = runtime.getWorkflow(workflowId);
388
+ }
389
+ catch {
390
+ workflow = undefined;
391
+ }
392
+ }
393
+ return this.describeWorkflow(workflowId, workflow);
394
+ }
395
+ }
396
+ //# sourceMappingURL=MastraWorkflowManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"MastraWorkflowManager.js","sourceRoot":"","sources":["../../../src/mastra/MastraWorkflowManager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @module as-graph/mastra
3
+ * @summary Mastra graph execution backend barrel (SAA-196).
4
+ * @description Public surface of the `@decaf-ts/as-graph/mastra` entrypoint:
5
+ * the Mastra execution backend, the workflow compiler, the event bridge, the
6
+ * condition bridge, the schema converter, the resume guard, the capability
7
+ * table, and the shared types/ports.
8
+ */
9
+ export * from "./types.js";
10
+ export * from "./MastraCapabilities.js";
11
+ export * from "./MastraSchemaConverter.js";
12
+ export * from "./MastraConditionBridge.js";
13
+ export * from "./MastraEventBridge.js";
14
+ export * from "./MastraWorkflowCompiler.js";
15
+ export * from "./MastraWorkflowManager.js";
16
+ export * from "./MastraResumeGuard.js";
17
+ export * from "./MastraGraphExecutionBackend.js";
18
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mastra/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,2BAAwB;AACxB,wCAAqC;AACrC,2CAAwC;AACxC,2CAAwC;AACxC,uCAAoC;AACpC,4CAAyC;AACzC,2CAAwC;AACxC,uCAAoC;AACpC,iDAA8C"}
@@ -0,0 +1,30 @@
1
+ /** The flavour id the Mastra backend registers under in the backend registry. */
2
+ export const MASTRA_BACKEND_FLAVOUR = "mastra";
3
+ /** A document node kind the Mastra translator cannot represent. */
4
+ export const GRAPH_MASTRA_UNSUPPORTED_KIND = "GRAPH_MASTRA_UNSUPPORTED_KIND";
5
+ /** A suspendable step declared a missing or degraded resume schema. */
6
+ export const GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE = "GRAPH_MASTRA_RESUME_SCHEMA_UNSAFE";
7
+ /** A resume request failed validation (size, JSON safety, schema, or step). */
8
+ export const GRAPH_MASTRA_RESUME_INVALID = "GRAPH_MASTRA_RESUME_INVALID";
9
+ /** The resume step or iteration index is not allowlisted by the document. */
10
+ export const GRAPH_MASTRA_RESUME_STEP_UNKNOWN = "GRAPH_MASTRA_RESUME_STEP_UNKNOWN";
11
+ /** The Mastra snapshot is not a suspended run of the current document. */
12
+ export const GRAPH_MASTRA_RESUME_STATE_INVALID = "GRAPH_MASTRA_RESUME_STATE_INVALID";
13
+ /** The document translation emitted non-JSON-safe Mastra config. */
14
+ export const GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE = "GRAPH_MASTRA_TRANSLATION_JSON_UNSAFE";
15
+ /** No Mastra agent is available for an agent-backed node. */
16
+ export const GRAPH_MASTRA_AGENT_UNAVAILABLE = "GRAPH_MASTRA_AGENT_UNAVAILABLE";
17
+ /** The wired Mastra runtime exposes no workflow-management surface. */
18
+ export const GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE = "GRAPH_MASTRA_MANAGEMENT_UNAVAILABLE";
19
+ /** A managed workflow id has no workflow registered on the runtime. */
20
+ export const GRAPH_MASTRA_WORKFLOW_NOT_FOUND = "GRAPH_MASTRA_WORKFLOW_NOT_FOUND";
21
+ /** Persisting a translated workflow to Mastra storage is not supported. */
22
+ export const GRAPH_MASTRA_PERSIST_NOT_SUPPORTED = "GRAPH_MASTRA_PERSIST_NOT_SUPPORTED";
23
+ /** A registered workflow exposes no serializable step graph. */
24
+ export const GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED = "GRAPH_MASTRA_SERIALIZE_NOT_SUPPORTED";
25
+ /**
26
+ * A management mutation targeted a workflow the caller may not write, or a host
27
+ * registration the wrapper did not create (C3 complete-mediation guard).
28
+ */
29
+ export const GRAPH_MASTRA_WORKFLOW_FORBIDDEN = "GRAPH_MASTRA_WORKFLOW_FORBIDDEN";
30
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/mastra/types.ts"],"names":[],"mappings":"AAuBA,iFAAiF;AACjF,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAE/C,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,+BAA+B,CAAC;AAC7E,uEAAuE;AACvE,MAAM,CAAC,MAAM,iCAAiC,GAC5C,mCAAmC,CAAC;AACtC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AACzE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gCAAgC,GAC3C,kCAAkC,CAAC;AACrC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iCAAiC,GAC5C,mCAAmC,CAAC;AACtC,oEAAoE;AACpE,MAAM,CAAC,MAAM,oCAAoC,GAC/C,sCAAsC,CAAC;AACzC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,8BAA8B,GACzC,gCAAgC,CAAC;AACnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,mCAAmC,GAC9C,qCAAqC,CAAC;AACxC,uEAAuE;AACvE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,iCAAiC,CAAC;AACpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAC7C,oCAAoC,CAAC;AACvC,gEAAgE;AAChE,MAAM,CAAC,MAAM,oCAAoC,GAC/C,sCAAsC,CAAC;AACzC;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAC1C,iCAAiC,CAAC"}
@@ -0,0 +1,129 @@
1
+ import { resolveGraphBackendCapabilities } from "./../../engine/execution/GraphExecutionBackend.js";
2
+ import { GraphExecutionBackendRegistry } from "./../../engine/execution/GraphExecutionBackendRegistry.js";
3
+ import { GRAPH_LOCAL_EXECUTION_BACKEND } from "./../../engine/constants.js";
4
+ import { DAGSTER_CAPABILITY_TABLE } from "./../../dagster/capabilities.js";
5
+ import { DAGSTER_BACKEND_FLAVOUR, DAGSTER_PINNED_VERSION, } from "./../../dagster/constants.js";
6
+ import { MASTRA_FEATURE_CAPABILITIES } from "./../../mastra/MastraCapabilities.js";
7
+ import { MASTRA_BACKEND_FLAVOUR } from "./../../mastra/types.js";
8
+ /**
9
+ * Pinned `@mastra/core` engine version. Kept here because the Mastra wrapper
10
+ * exports only its feature table, not a version constant; the value mirrors the
11
+ * `@mastra/core` dependency pin in `as-graph/package.json` (`1.74.0`).
12
+ */
13
+ export const MASTRA_PINNED_VERSION = "1.74.0";
14
+ /**
15
+ * Normalizes a wrapper capability verdict onto the C20 three-value vocabulary.
16
+ * `PARTIAL` is deliberately downgraded to `NOT_SUPPORTED` (fail-closed): a
17
+ * partially-supported feature must never be advertised as a usable toggle.
18
+ *
19
+ * @param verdict - The wrapper table verdict string.
20
+ * @returns The normalized C20 verdict.
21
+ */
22
+ export function toGraphEngineFeatureVerdict(verdict) {
23
+ const normalized = verdict.trim().toUpperCase().replace(/[-\s]+/g, "_");
24
+ if (normalized === "SUPPORTED")
25
+ return "SUPPORTED";
26
+ if (normalized === "EXTENSION_POINT")
27
+ return "EXTENSION_POINT";
28
+ return "NOT_SUPPORTED";
29
+ }
30
+ /** The Dagster feature rows, derived from the exported capability table. */
31
+ const DAGSTER_ENGINE_FEATURES = DAGSTER_CAPABILITY_TABLE.map((row) => ({
32
+ feature: row.feature,
33
+ verdict: toGraphEngineFeatureVerdict(row.verdict),
34
+ ...(row.detail !== undefined ? { detail: row.detail } : {}),
35
+ }));
36
+ /** The Mastra feature rows, derived from the exported capability table. */
37
+ const MASTRA_ENGINE_FEATURES = MASTRA_FEATURE_CAPABILITIES.map((row) => ({
38
+ feature: row.feature,
39
+ verdict: toGraphEngineFeatureVerdict(row.verdict),
40
+ ...(row.detail !== undefined ? { detail: row.detail } : {}),
41
+ }));
42
+ /**
43
+ * Derives the local engine's feature rows from the engine-agnostic
44
+ * {@link GraphBackendCapabilities} the built-in backend exposes, so the manifest
45
+ * never hand-maintains a separate local table.
46
+ *
47
+ * @param capabilities - The active backend's effective capability metadata.
48
+ * @returns The normalized feature rows for the local engine.
49
+ */
50
+ export function localEngineFeatures(capabilities) {
51
+ return [
52
+ {
53
+ feature: "codeMode",
54
+ verdict: capabilities.codeMode === "hostSide" ? "SUPPORTED" : "NOT_SUPPORTED",
55
+ detail: "Host-side sandbox execution.",
56
+ },
57
+ {
58
+ feature: "workflowList",
59
+ verdict: capabilities.workflows.list === "supported"
60
+ ? "SUPPORTED"
61
+ : "NOT_SUPPORTED",
62
+ },
63
+ {
64
+ feature: "workflowLookup",
65
+ verdict: capabilities.workflows.get === "supported"
66
+ ? "SUPPORTED"
67
+ : "NOT_SUPPORTED",
68
+ },
69
+ ];
70
+ }
71
+ /**
72
+ * The allowlisted engine capability sources, keyed by backend flavour. An engine
73
+ * absent from this map is never advertised (C21: engine selection is by
74
+ * allowlisted ids only), even when a backend is registered under its flavour.
75
+ */
76
+ const BUILT_IN_ENGINE_CAPABILITY_SOURCES = {
77
+ [GRAPH_LOCAL_EXECUTION_BACKEND]: {
78
+ engineId: GRAPH_LOCAL_EXECUTION_BACKEND,
79
+ displayName: "Local (built-in)",
80
+ pinnedEngineVersion: "built-in",
81
+ features: (backend) => localEngineFeatures(resolveGraphBackendCapabilities(backend)),
82
+ },
83
+ [DAGSTER_BACKEND_FLAVOUR]: {
84
+ engineId: DAGSTER_BACKEND_FLAVOUR,
85
+ displayName: "Dagster",
86
+ pinnedEngineVersion: DAGSTER_PINNED_VERSION,
87
+ features: () => DAGSTER_ENGINE_FEATURES,
88
+ },
89
+ [MASTRA_BACKEND_FLAVOUR]: {
90
+ engineId: MASTRA_BACKEND_FLAVOUR,
91
+ displayName: "Mastra",
92
+ pinnedEngineVersion: MASTRA_PINNED_VERSION,
93
+ features: () => MASTRA_ENGINE_FEATURES,
94
+ },
95
+ };
96
+ /**
97
+ * Builds the capability manifest from the registered backends, statically at boot.
98
+ * Only allowlisted flavours are advertised; the descriptors' `local` flag is read
99
+ * from the registered backend, and no remote engine is ever probed. The returned
100
+ * object is a fresh snapshot so a caller cannot mutate the served manifest.
101
+ *
102
+ * @param registered - The registered flavour/backend entries.
103
+ * @param defaultEngineId - Optional host-preferred default engine id.
104
+ * @returns The C20 capability manifest.
105
+ */
106
+ export function buildGraphEngineCapabilityManifest(registered, defaultEngineId) {
107
+ const engines = [];
108
+ for (const { flavour, backend } of registered) {
109
+ const source = BUILT_IN_ENGINE_CAPABILITY_SOURCES[flavour];
110
+ if (!source)
111
+ continue;
112
+ engines.push({
113
+ engineId: source.engineId,
114
+ displayName: source.displayName,
115
+ local: backend.local === true,
116
+ pinnedEngineVersion: source.pinnedEngineVersion,
117
+ capabilities: source.features(backend).map((row) => ({ ...row })),
118
+ });
119
+ }
120
+ const ids = new Set(engines.map((engine) => engine.engineId));
121
+ const currentFlavour = GraphExecutionBackendRegistry.currentFlavour;
122
+ const resolvedDefault = defaultEngineId && ids.has(defaultEngineId)
123
+ ? defaultEngineId
124
+ : ids.has(currentFlavour)
125
+ ? currentFlavour
126
+ : (engines[0]?.engineId ?? currentFlavour);
127
+ return { engines, defaultEngineId: resolvedDefault };
128
+ }
129
+ //# sourceMappingURL=GraphEngineCapabilityManifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GraphEngineCapabilityManifest.js","sourceRoot":"","sources":["../../../../src/nest/graph/GraphEngineCapabilityManifest.ts"],"names":[],"mappings":"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"}