@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
@@ -23,6 +23,13 @@ export declare function graphWorkflowOwnerOf(ctx: Context | undefined): string |
23
23
  * (`allowAnonymousAccess`) is set for reads (SAA-595 F3). Overwriting an
24
24
  * existing row is a write and is authorized by strict owner equality, so the
25
25
  * read tolerance never grants an overwrite (SAA-105 R3).
26
+ *
27
+ * @remarks The overwrite gate is a read-then-write check, so it depends on the
28
+ * persistence adapter's contract (SAA-105 R3-b): `read` must throw
29
+ * `NotFoundError` for an absent row, and `create` must be create-only — it must
30
+ * reject a duplicate primary key rather than upsert. An adapter whose `create`
31
+ * upserts (or whose `read` hides an existing row) would let a named caller
32
+ * silently overwrite an owner-less row and bypass the owner-equality gate.
26
33
  */
27
34
  export declare class GraphWorkflowService extends ModelService<GraphWorkflowModel> {
28
35
  protected catalogue: GraphNodeCatalogue | undefined;
@@ -50,6 +57,10 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
50
57
  * (SAA-105 R3): a named caller cannot overwrite an owner-less workflow and
51
58
  * the `allowAnonymousAccess` read tolerance never grants an overwrite.
52
59
  *
60
+ * @remarks Relies on the class-level adapter contract that `read` throws
61
+ * `NotFoundError` for an absent row and `create` rejects a duplicate primary
62
+ * key instead of upserting (SAA-105 R3-b).
63
+ *
53
64
  * @param {string} workflowId - Workflow id from the request path.
54
65
  * @param {GraphWorkflowDocument} document - Canonical document to persist (its `id` must equal `workflowId`).
55
66
  * @param args - An optional decaf `Context` carrying the owning principal.
@@ -119,6 +130,10 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
119
130
  * authorized by strict owner equality (SAA-105 R3) — see
120
131
  * {@link saveDocument}.
121
132
  *
133
+ * @remarks Relies on the class-level adapter contract that `read` throws
134
+ * `NotFoundError` for an absent row and `create` rejects a duplicate primary
135
+ * key instead of upserting (SAA-105 R3-b).
136
+ *
122
137
  * @param {string} workflowId - Workflow id from the request path.
123
138
  * @param {Record<string, unknown>} snapshot - JSON-safe canonical snapshot wrapper.
124
139
  * @param args - An optional decaf `Context` carrying the owning principal.
@@ -135,6 +150,13 @@ export declare class GraphWorkflowService extends ModelService<GraphWorkflowMode
135
150
  * @return {Promise<GraphWorkflowModel | null>} The workflow row, or `null` when it does not exist or ownership fails.
136
151
  */
137
152
  loadSnapshot(workflowId: string, ...args: MaybeContextualArg<Context>): Promise<GraphWorkflowModel | null>;
153
+ /**
154
+ * Existence probe for the owner-equality overwrite gate (SAA-105 R3-a): only a
155
+ * genuine absence (`NotFoundError`) resolves to `null`; every other read
156
+ * failure propagates so a transient store fault is never mistaken for absence
157
+ * and downgraded into an unconditional create.
158
+ */
159
+ private readExistingForWrite;
138
160
  /**
139
161
  * Read-visibility guard for a persisted workflow record via the centralized
140
162
  * {@link assertGraphResourceOwnership} check, honouring this service's
@@ -0,0 +1,91 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraCapabilities
3
+ * @summary Exported Mastra capability table (SAA-196).
4
+ * @description The Mastra wrapper declares, per feature, whether the backend
5
+ * supports it natively, not at all, or only through an extension point. The
6
+ * table is exported alongside the engine-agnostic
7
+ * {@link GraphBackendCapabilities} projection (code-mode + workflow
8
+ * listing/lookup) so hosts and servers can surface honest limitations without
9
+ * probing the backend.
10
+ */
11
+ import type { GraphBackendCapabilities, GraphBackendCapabilityStatus } from "../engine/execution/GraphExecutionBackend.d.cts";
12
+ /**
13
+ * Whether Mastra supports a feature natively, not at all, only partially, or
14
+ * exclusively through a declared extension point.
15
+ */
16
+ export type MastraFeatureVerdict = "SUPPORTED" | "NOT-SUPPORTED" | "EXTENSION-POINT" | "PARTIAL";
17
+ /** A single row of the exported Mastra capability table (SAA-196). */
18
+ export interface MastraFeatureCapability {
19
+ /** The engine feature being described. */
20
+ feature: string;
21
+ /** The declared Mastra verdict for the feature. */
22
+ verdict: MastraFeatureVerdict;
23
+ /** Human-readable detail for the verdict. */
24
+ detail?: string;
25
+ }
26
+ /**
27
+ * The exported Mastra capability table (SAA-196). Every row names a feature and
28
+ * whether Mastra supports it natively, not at all, or through a declared
29
+ * extension point. `parallel` and `pinning` are declared NOT-SUPPORTED, and
30
+ * code-mode conditions fail closed, so the wrapper fails loudly rather than
31
+ * silently degrading behaviour.
32
+ */
33
+ export declare const MASTRA_FEATURE_CAPABILITIES: readonly MastraFeatureCapability[];
34
+ /**
35
+ * The three-valued management status a Mastra workflow-management capability row
36
+ * resolves to. Extends the engine-agnostic two-valued
37
+ * {@link GraphBackendCapabilityStatus} with the honest `extension_point` state.
38
+ */
39
+ export type MastraWorkflowCapabilityStatus = GraphBackendCapabilityStatus | "extension_point";
40
+ /**
41
+ * The Mastra workflow-management capability projection (SAA-346): the real
42
+ * `@mastra/core` management operations the driver exposes, each resolved honestly
43
+ * from the exported feature table.
44
+ */
45
+ export interface MastraWorkflowManagementCapabilities {
46
+ /** Create (register a translated canonical document) support. */
47
+ create: MastraWorkflowCapabilityStatus;
48
+ /** Update/edit (recompile and replace the registration) support. */
49
+ update: MastraWorkflowCapabilityStatus;
50
+ /** Delete (remove the registration) support. */
51
+ delete: MastraWorkflowCapabilityStatus;
52
+ /** Serialization (real `serializedStepGraph`) support. */
53
+ serialize: MastraWorkflowCapabilityStatus;
54
+ /** Persistence (real `addDynamicWorkflow`) support. */
55
+ persist: MastraWorkflowCapabilityStatus;
56
+ /** Native workflow versioning support. */
57
+ version: MastraWorkflowCapabilityStatus;
58
+ }
59
+ /**
60
+ * The full Mastra backend capability projection: the engine-agnostic
61
+ * {@link GraphBackendCapabilities} plus the Mastra-specific workflow-management
62
+ * statuses.
63
+ */
64
+ export interface MastraBackendCapabilities extends GraphBackendCapabilities {
65
+ /** Workflow list/lookup plus the management statuses. */
66
+ workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
67
+ }
68
+ /**
69
+ * Resolves a feature row's three-valued management status from the exported
70
+ * table, mapping the wrapper's `SUPPORTED`/`NOT-SUPPORTED`/`EXTENSION-POINT`
71
+ * verdicts onto the projection's lowercase vocabulary.
72
+ *
73
+ * @param feature - The feature row name to resolve.
74
+ * @returns The three-valued management status.
75
+ */
76
+ export declare function mastraCapabilityStatusOf(feature: string): MastraWorkflowCapabilityStatus;
77
+ /**
78
+ * Engine-agnostic capability projection of the Mastra backend: no in-process
79
+ * code execution, workflow list/lookup supported over the compiled-workflow cache,
80
+ * and the SAA-346 workflow-management statuses resolved from the exported table.
81
+ *
82
+ * @returns The {@link MastraBackendCapabilities} served by the Mastra backend.
83
+ */
84
+ export declare function resolveMastraCapabilities(): MastraBackendCapabilities;
85
+ /**
86
+ * Looks up one capability row by feature name.
87
+ *
88
+ * @param feature - The engine feature name to look up.
89
+ * @returns The capability row, or `undefined` for an unknown feature.
90
+ */
91
+ export declare function mastraCapabilityOf(feature: string): MastraFeatureCapability | undefined;
@@ -0,0 +1,91 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraCapabilities
3
+ * @summary Exported Mastra capability table (SAA-196).
4
+ * @description The Mastra wrapper declares, per feature, whether the backend
5
+ * supports it natively, not at all, or only through an extension point. The
6
+ * table is exported alongside the engine-agnostic
7
+ * {@link GraphBackendCapabilities} projection (code-mode + workflow
8
+ * listing/lookup) so hosts and servers can surface honest limitations without
9
+ * probing the backend.
10
+ */
11
+ import type { GraphBackendCapabilities, GraphBackendCapabilityStatus } from "../engine/execution/GraphExecutionBackend.d.mts";
12
+ /**
13
+ * Whether Mastra supports a feature natively, not at all, only partially, or
14
+ * exclusively through a declared extension point.
15
+ */
16
+ export type MastraFeatureVerdict = "SUPPORTED" | "NOT-SUPPORTED" | "EXTENSION-POINT" | "PARTIAL";
17
+ /** A single row of the exported Mastra capability table (SAA-196). */
18
+ export interface MastraFeatureCapability {
19
+ /** The engine feature being described. */
20
+ feature: string;
21
+ /** The declared Mastra verdict for the feature. */
22
+ verdict: MastraFeatureVerdict;
23
+ /** Human-readable detail for the verdict. */
24
+ detail?: string;
25
+ }
26
+ /**
27
+ * The exported Mastra capability table (SAA-196). Every row names a feature and
28
+ * whether Mastra supports it natively, not at all, or through a declared
29
+ * extension point. `parallel` and `pinning` are declared NOT-SUPPORTED, and
30
+ * code-mode conditions fail closed, so the wrapper fails loudly rather than
31
+ * silently degrading behaviour.
32
+ */
33
+ export declare const MASTRA_FEATURE_CAPABILITIES: readonly MastraFeatureCapability[];
34
+ /**
35
+ * The three-valued management status a Mastra workflow-management capability row
36
+ * resolves to. Extends the engine-agnostic two-valued
37
+ * {@link GraphBackendCapabilityStatus} with the honest `extension_point` state.
38
+ */
39
+ export type MastraWorkflowCapabilityStatus = GraphBackendCapabilityStatus | "extension_point";
40
+ /**
41
+ * The Mastra workflow-management capability projection (SAA-346): the real
42
+ * `@mastra/core` management operations the driver exposes, each resolved honestly
43
+ * from the exported feature table.
44
+ */
45
+ export interface MastraWorkflowManagementCapabilities {
46
+ /** Create (register a translated canonical document) support. */
47
+ create: MastraWorkflowCapabilityStatus;
48
+ /** Update/edit (recompile and replace the registration) support. */
49
+ update: MastraWorkflowCapabilityStatus;
50
+ /** Delete (remove the registration) support. */
51
+ delete: MastraWorkflowCapabilityStatus;
52
+ /** Serialization (real `serializedStepGraph`) support. */
53
+ serialize: MastraWorkflowCapabilityStatus;
54
+ /** Persistence (real `addDynamicWorkflow`) support. */
55
+ persist: MastraWorkflowCapabilityStatus;
56
+ /** Native workflow versioning support. */
57
+ version: MastraWorkflowCapabilityStatus;
58
+ }
59
+ /**
60
+ * The full Mastra backend capability projection: the engine-agnostic
61
+ * {@link GraphBackendCapabilities} plus the Mastra-specific workflow-management
62
+ * statuses.
63
+ */
64
+ export interface MastraBackendCapabilities extends GraphBackendCapabilities {
65
+ /** Workflow list/lookup plus the management statuses. */
66
+ workflows: GraphBackendCapabilities["workflows"] & MastraWorkflowManagementCapabilities;
67
+ }
68
+ /**
69
+ * Resolves a feature row's three-valued management status from the exported
70
+ * table, mapping the wrapper's `SUPPORTED`/`NOT-SUPPORTED`/`EXTENSION-POINT`
71
+ * verdicts onto the projection's lowercase vocabulary.
72
+ *
73
+ * @param feature - The feature row name to resolve.
74
+ * @returns The three-valued management status.
75
+ */
76
+ export declare function mastraCapabilityStatusOf(feature: string): MastraWorkflowCapabilityStatus;
77
+ /**
78
+ * Engine-agnostic capability projection of the Mastra backend: no in-process
79
+ * code execution, workflow list/lookup supported over the compiled-workflow cache,
80
+ * and the SAA-346 workflow-management statuses resolved from the exported table.
81
+ *
82
+ * @returns The {@link MastraBackendCapabilities} served by the Mastra backend.
83
+ */
84
+ export declare function resolveMastraCapabilities(): MastraBackendCapabilities;
85
+ /**
86
+ * Looks up one capability row by feature name.
87
+ *
88
+ * @param feature - The engine feature name to look up.
89
+ * @returns The capability row, or `undefined` for an unknown feature.
90
+ */
91
+ export declare function mastraCapabilityOf(feature: string): MastraFeatureCapability | undefined;
@@ -0,0 +1,38 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraConditionBridge
3
+ * @summary Bridge between canonical graph conditions and Mastra branch
4
+ * predicates (SAA-196).
5
+ * @description Mastra cannot represent code-mode conditions, so translation
6
+ * fails closed for them; every other canonical condition is wrapped into a
7
+ * synchronous predicate that delegates to the engine's shared condition
8
+ * evaluator, keeping branch semantics identical to the local backend.
9
+ */
10
+ import type { Condition } from "../shared/graph/index.d.cts";
11
+ /** Arguments the Mastra runtime passes into a branch predicate. */
12
+ export interface MastraBranchPredicateArgs {
13
+ /** The step input data of the branch step. */
14
+ inputData?: unknown;
15
+ /** The workflow state available to the branch step. */
16
+ state?: unknown;
17
+ }
18
+ /**
19
+ * Guards that a flow-control node's condition is translatable by the Mastra
20
+ * backend: it must exist and must not be a code-mode condition.
21
+ *
22
+ * @param condition - The condition attached to the flow-control node.
23
+ * @param nodeId - The document node id used in error payloads.
24
+ * @returns Nothing; returns only when the condition is translatable.
25
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_UNSUPPORTED_KIND} when the
26
+ * condition is missing or is a code-mode condition.
27
+ */
28
+ export declare function assertMastraConditionSupported(condition: Condition | undefined, nodeId: string): void;
29
+ /**
30
+ * Wraps a canonical condition into a synchronous Mastra branch predicate. The
31
+ * predicate receives the runtime's step arguments and evaluates the condition
32
+ * against the step input data, falling back to the workflow state.
33
+ *
34
+ * @param condition - The canonical condition to evaluate.
35
+ * @param label - Diagnostic label used in evaluation errors.
36
+ * @returns The synchronous predicate Mastra branch steps call.
37
+ */
38
+ export declare function mastraConditionPredicate(condition: Condition, label: string): (args: MastraBranchPredicateArgs) => boolean;
@@ -0,0 +1,38 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraConditionBridge
3
+ * @summary Bridge between canonical graph conditions and Mastra branch
4
+ * predicates (SAA-196).
5
+ * @description Mastra cannot represent code-mode conditions, so translation
6
+ * fails closed for them; every other canonical condition is wrapped into a
7
+ * synchronous predicate that delegates to the engine's shared condition
8
+ * evaluator, keeping branch semantics identical to the local backend.
9
+ */
10
+ import type { Condition } from "../shared/graph/index.d.mts";
11
+ /** Arguments the Mastra runtime passes into a branch predicate. */
12
+ export interface MastraBranchPredicateArgs {
13
+ /** The step input data of the branch step. */
14
+ inputData?: unknown;
15
+ /** The workflow state available to the branch step. */
16
+ state?: unknown;
17
+ }
18
+ /**
19
+ * Guards that a flow-control node's condition is translatable by the Mastra
20
+ * backend: it must exist and must not be a code-mode condition.
21
+ *
22
+ * @param condition - The condition attached to the flow-control node.
23
+ * @param nodeId - The document node id used in error payloads.
24
+ * @returns Nothing; returns only when the condition is translatable.
25
+ * @throws {GraphExecutionError} {@link GRAPH_MASTRA_UNSUPPORTED_KIND} when the
26
+ * condition is missing or is a code-mode condition.
27
+ */
28
+ export declare function assertMastraConditionSupported(condition: Condition | undefined, nodeId: string): void;
29
+ /**
30
+ * Wraps a canonical condition into a synchronous Mastra branch predicate. The
31
+ * predicate receives the runtime's step arguments and evaluates the condition
32
+ * against the step input data, falling back to the workflow state.
33
+ *
34
+ * @param condition - The canonical condition to evaluate.
35
+ * @param label - Diagnostic label used in evaluation errors.
36
+ * @returns The synchronous predicate Mastra branch steps call.
37
+ */
38
+ export declare function mastraConditionPredicate(condition: Condition, label: string): (args: MastraBranchPredicateArgs) => boolean;
@@ -0,0 +1,189 @@
1
+ /**
2
+ * @module as-graph/mastra/MastraEventBridge
3
+ * @summary Bridges Mastra's `fullStream` events onto the facade event sink
4
+ * (SAA-196).
5
+ * @description The bridge consumes the async event stream a Mastra run emits,
6
+ * translates workflow/step/log lifecycle events into canonical
7
+ * {@link GraphExecutionEvent} emissions, and mirrors node/edge visual-state and
8
+ * routed edge values so the canvas renders a Mastra run exactly like a local
9
+ * one. Unrecognised events are ignored unless they look like log entries.
10
+ */
11
+ import type { GraphWorkflowDocument } from "../shared/graph/document/GraphWorkflowDocument.d.cts";
12
+ import type { GraphExecutionEventSink } from "../engine/execution/GraphExecutionBackend.d.cts";
13
+ /** Options a {@link MastraEventBridge} is created with. */
14
+ export interface MastraEventBridgeOptions {
15
+ /** The canonical run id the bridged events belong to. */
16
+ runId: string;
17
+ /** The parent run id, when the run is a nested execution. */
18
+ parentRunId?: string;
19
+ /** The canonical workflow id the bridged events belong to. */
20
+ workflowId: string;
21
+ /** The canonical document the Mastra workflow was compiled from. */
22
+ document: GraphWorkflowDocument;
23
+ /** The frame-aware facade event sink every event is emitted onto. */
24
+ sink: GraphExecutionEventSink;
25
+ /** The node path prefix events are reported under. */
26
+ path?: string[];
27
+ }
28
+ /** One raw Mastra `fullStream` event; shape is runtime-defined. */
29
+ export type MastraFullStreamEvent = Record<string, unknown>;
30
+ /**
31
+ * Translates Mastra `fullStream` events into canonical facade events. The
32
+ * bridge indexes the document's data edges by node endpoint so step results can
33
+ * be routed as edge values and step lifecycles can drive node/edge visual
34
+ * states. Log events (`log`, `writer`, `console`) are surfaced as
35
+ * `GRAPH_RUN_LOG` entries with a known log level.
36
+ */
37
+ export declare class MastraEventBridge {
38
+ private readonly options;
39
+ /** Data edges leaving each node, keyed by source node id. */
40
+ private readonly outgoing;
41
+ /** Data edges entering each node, keyed by target node id. */
42
+ private readonly incoming;
43
+ /**
44
+ * Creates the bridge and indexes the document's node-scoped data edges.
45
+ *
46
+ * @param options - Run identity, document, and event sink options.
47
+ */
48
+ constructor(options: MastraEventBridgeOptions);
49
+ /**
50
+ * Consumes a Mastra run's full event stream until it ends.
51
+ *
52
+ * @param stream - The async iterable of Mastra `fullStream` events.
53
+ * @returns Resolves when the stream is exhausted.
54
+ */
55
+ attach(stream: AsyncIterable<MastraFullStreamEvent>): Promise<void>;
56
+ /**
57
+ * Translates one raw Mastra event and emits the matching canonical events.
58
+ * Unrecognised event types are ignored unless they look like log entries.
59
+ *
60
+ * @param event - The raw Mastra `fullStream` event.
61
+ * @returns Resolves once the derived events have been emitted.
62
+ */
63
+ handle(event: MastraFullStreamEvent): Promise<void>;
64
+ /**
65
+ * Emits the node-started lifecycle, node visual state, and running edge
66
+ * states for the incoming data edges of a started step.
67
+ *
68
+ * @param event - The raw `workflow-step-start` event.
69
+ * @returns Resolves once the derived events have been emitted.
70
+ */
71
+ private onStepStart;
72
+ /**
73
+ * Emits the step's incremental output as a node-output event.
74
+ *
75
+ * @param event - The raw `workflow-step-output` event.
76
+ * @returns Resolves once the derived events have been emitted.
77
+ */
78
+ private onStepOutput;
79
+ /**
80
+ * Emits one loop-iteration progress event for a foreach/while step.
81
+ *
82
+ * @param event - The raw `workflow-step-progress` event.
83
+ * @returns Resolves once the derived events have been emitted.
84
+ */
85
+ private onStepProgress;
86
+ /**
87
+ * Emits the terminal lifecycle of a finished step: failure, suspension
88
+ * block, or completion (including routed outgoing edge values).
89
+ *
90
+ * @param event - The raw `workflow-step-result` event.
91
+ * @returns Resolves once the derived events have been emitted.
92
+ */
93
+ private onStepResult;
94
+ /**
95
+ * Emits the suspension state of a suspended step and the workflow-suspended
96
+ * event carrying Mastra's suspend payload.
97
+ *
98
+ * @param event - The raw `workflow-step-suspended` event.
99
+ * @returns Resolves once the derived events have been emitted.
100
+ */
101
+ private onStepSuspended;
102
+ /**
103
+ * Emits the terminal workflow event: failed, cancelled, or completed with
104
+ * the final workflow result.
105
+ *
106
+ * @param event - The raw `workflow-finish` event.
107
+ * @returns Resolves once the derived events have been emitted.
108
+ */
109
+ private onWorkflowFinish;
110
+ /**
111
+ * Emits a run-log entry for a bridged log event; unknown levels are dropped.
112
+ *
113
+ * @param event - The raw log/writer/console event.
114
+ * @returns Resolves once the log entry has been emitted.
115
+ */
116
+ private onLog;
117
+ /**
118
+ * Heuristic check whether an unrecognised event is a log entry.
119
+ *
120
+ * @param event - The raw Mastra event.
121
+ * @returns `true` when the event carries a level and a message.
122
+ */
123
+ private looksLikeLog;
124
+ /**
125
+ * Routes one finished node's output values along its outgoing data edges,
126
+ * emitting edge-value and edge-state events per routed edge.
127
+ *
128
+ * @param nodeId - The finished node id.
129
+ * @param output - The node's output record.
130
+ * @param path - The node path the events are reported under.
131
+ * @returns Resolves once the routed edge events have been emitted.
132
+ */
133
+ private routeEdges;
134
+ /**
135
+ * Emits a node visual-state change for the bridged run.
136
+ *
137
+ * @param nodeId - The node whose state changed.
138
+ * @param state - The new visual state.
139
+ * @param path - The node path the event is reported under.
140
+ * @returns Resolves once the event has been emitted.
141
+ */
142
+ private emitNodeState;
143
+ /**
144
+ * Emits an edge visual-state change for the bridged run.
145
+ *
146
+ * @param edge - The edge whose state changed.
147
+ * @param state - The new visual state.
148
+ * @param status - The execution status carried by the event.
149
+ * @returns Resolves once the event has been emitted.
150
+ */
151
+ private emitEdgeState;
152
+ /**
153
+ * Maps a visual state to the execution status its event carries.
154
+ *
155
+ * @param state - The node visual state.
156
+ * @returns The matching execution status.
157
+ */
158
+ private statusFor;
159
+ /**
160
+ * Resolves the Mastra step id of an event (the canonical node id).
161
+ *
162
+ * @param event - The raw Mastra event.
163
+ * @returns The step id, or `undefined` when the event has none.
164
+ */
165
+ private stepId;
166
+ /**
167
+ * Extracts an event's payload record, tolerating missing or non-object
168
+ * payloads.
169
+ *
170
+ * @param event - The raw Mastra event.
171
+ * @returns The payload record, or an empty record.
172
+ */
173
+ private payloadOf;
174
+ /**
175
+ * Normalises an arbitrary error into the canonical error payload shape.
176
+ *
177
+ * @param error - The thrown error or value.
178
+ * @returns The normalised name/message/code payload.
179
+ */
180
+ private errorPayload;
181
+ /**
182
+ * Forwards one canonical event onto the configured facade event sink.
183
+ *
184
+ * @param partial - The event to emit (run identity fields are supplied by
185
+ * the sink's frame awareness).
186
+ * @returns Resolves once the sink accepted the event.
187
+ */
188
+ private emit;
189
+ }