@decaf-ts/as-graph 0.7.0 → 0.8.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 (383) hide show
  1. package/README.md +92 -12
  2. package/assets/i18n/en.json +1519 -130
  3. package/dist/as-graph.cjs +1 -1
  4. package/dist/as-graph.cjs.map +1 -1
  5. package/dist/as-graph.js +1 -1
  6. package/dist/as-graph.js.map +1 -1
  7. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs +13 -0
  8. package/lib/cjs/dagster/DagsterGraphExecutionBackend.cjs.map +1 -1
  9. package/lib/cjs/dagster/capabilities.cjs +5 -0
  10. package/lib/cjs/dagster/capabilities.cjs.map +1 -1
  11. package/lib/cjs/engine/execution/GraphCodeMode.cjs +42 -0
  12. package/lib/cjs/engine/execution/GraphCodeMode.cjs.map +1 -1
  13. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs +35 -4
  14. package/lib/cjs/engine/execution/GraphExecutionEngine.cjs.map +1 -1
  15. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs +29 -1
  16. package/lib/cjs/engine/validation/GraphNodeInstanceValidator.cjs.map +1 -1
  17. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs +6 -2
  18. package/lib/cjs/engine/validation/GraphWorkflowDocumentValidator.cjs.map +1 -1
  19. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs +41 -9
  20. package/lib/cjs/mastra/MastraWorkflowCompiler.cjs.map +1 -1
  21. package/lib/cjs/nest/graph/GraphEngineController.cjs +18 -0
  22. package/lib/cjs/nest/graph/GraphEngineController.cjs.map +1 -1
  23. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs +14 -0
  24. package/lib/cjs/nest/graph/GraphNodeCatalogueController.cjs.map +1 -1
  25. package/lib/cjs/nest/graph/GraphRunController.cjs +17 -0
  26. package/lib/cjs/nest/graph/GraphRunController.cjs.map +1 -1
  27. package/lib/cjs/nest/graph/GraphWorkflowController.cjs +34 -5
  28. package/lib/cjs/nest/graph/GraphWorkflowController.cjs.map +1 -1
  29. package/lib/cjs/node/comms/discord/node.cjs +384 -0
  30. package/lib/cjs/node/comms/discord/node.cjs.map +1 -0
  31. package/lib/cjs/node/comms/outlook/node.cjs +395 -0
  32. package/lib/cjs/node/comms/outlook/node.cjs.map +1 -0
  33. package/lib/cjs/node/comms/whatsapp/node.cjs +341 -0
  34. package/lib/cjs/node/comms/whatsapp/node.cjs.map +1 -0
  35. package/lib/cjs/node/data/aggregate/node.cjs +196 -0
  36. package/lib/cjs/node/data/aggregate/node.cjs.map +1 -0
  37. package/lib/cjs/node/data/compare-datasets/node.cjs +331 -0
  38. package/lib/cjs/node/data/compare-datasets/node.cjs.map +1 -0
  39. package/lib/cjs/node/data/item-lists/node.cjs +416 -0
  40. package/lib/cjs/node/data/item-lists/node.cjs.map +1 -0
  41. package/lib/cjs/node/data/remove-duplicates/node.cjs +141 -0
  42. package/lib/cjs/node/data/remove-duplicates/node.cjs.map +1 -0
  43. package/lib/cjs/node/data/summarize/node.cjs +155 -0
  44. package/lib/cjs/node/data/summarize/node.cjs.map +1 -0
  45. package/lib/cjs/node/data/support.cjs +5 -0
  46. package/lib/cjs/node/data/support.cjs.map +1 -1
  47. package/lib/cjs/node/data/transform-utils.cjs +719 -0
  48. package/lib/cjs/node/data/transform-utils.cjs.map +1 -0
  49. package/lib/cjs/node/index.cjs +216 -110
  50. package/lib/cjs/node/index.cjs.map +1 -1
  51. package/lib/cjs/node/io/confluence/node.cjs +253 -0
  52. package/lib/cjs/node/io/confluence/node.cjs.map +1 -0
  53. package/lib/cjs/node/io/convert-to-file/node.cjs +349 -0
  54. package/lib/cjs/node/io/convert-to-file/node.cjs.map +1 -0
  55. package/lib/cjs/node/io/file-support.cjs +311 -0
  56. package/lib/cjs/node/io/file-support.cjs.map +1 -0
  57. package/lib/cjs/node/io/google-calendar/node.cjs +359 -0
  58. package/lib/cjs/node/io/google-calendar/node.cjs.map +1 -0
  59. package/lib/cjs/node/io/google-docs/node.cjs +272 -0
  60. package/lib/cjs/node/io/google-docs/node.cjs.map +1 -0
  61. package/lib/cjs/node/io/html/node.cjs +275 -0
  62. package/lib/cjs/node/io/html/node.cjs.map +1 -0
  63. package/lib/cjs/node/io/html-extract/node.cjs +162 -0
  64. package/lib/cjs/node/io/html-extract/node.cjs.map +1 -0
  65. package/lib/cjs/node/io/html-support.cjs +246 -0
  66. package/lib/cjs/node/io/html-support.cjs.map +1 -0
  67. package/lib/cjs/node/io/jira/node.cjs +351 -0
  68. package/lib/cjs/node/io/jira/node.cjs.map +1 -0
  69. package/lib/cjs/node/io/markdown/node.cjs +229 -0
  70. package/lib/cjs/node/io/markdown/node.cjs.map +1 -0
  71. package/lib/cjs/node/io/microsoft-excel/node.cjs +261 -0
  72. package/lib/cjs/node/io/microsoft-excel/node.cjs.map +1 -0
  73. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs +274 -0
  74. package/lib/cjs/node/io/microsoft-sharepoint/node.cjs.map +1 -0
  75. package/lib/cjs/node/io/read-binary-file/node.cjs +114 -0
  76. package/lib/cjs/node/io/read-binary-file/node.cjs.map +1 -0
  77. package/lib/cjs/node/io/read-binary-files/node.cjs +113 -0
  78. package/lib/cjs/node/io/read-binary-files/node.cjs.map +1 -0
  79. package/lib/cjs/node/io/write-binary-file/node.cjs +164 -0
  80. package/lib/cjs/node/io/write-binary-file/node.cjs.map +1 -0
  81. package/lib/cjs/node/io/xml/node.cjs +322 -0
  82. package/lib/cjs/node/io/xml/node.cjs.map +1 -0
  83. package/lib/cjs/node/manifests.cjs +137 -79
  84. package/lib/cjs/node/manifests.cjs.map +1 -1
  85. package/lib/cjs/node/storage/rabbitmq/node.cjs +252 -0
  86. package/lib/cjs/node/storage/rabbitmq/node.cjs.map +1 -0
  87. package/lib/cjs/node/triggers/error/node.cjs +108 -0
  88. package/lib/cjs/node/triggers/error/node.cjs.map +1 -0
  89. package/lib/cjs/node/triggers/postgres/node.cjs +244 -0
  90. package/lib/cjs/node/triggers/postgres/node.cjs.map +1 -0
  91. package/lib/cjs/node/triggers/rabbitmq/node.cjs +284 -0
  92. package/lib/cjs/node/triggers/rabbitmq/node.cjs.map +1 -0
  93. package/lib/cjs/node/triggers/redis/node.cjs +233 -0
  94. package/lib/cjs/node/triggers/redis/node.cjs.map +1 -0
  95. package/lib/cjs/node/triggers/sse/node.cjs +196 -0
  96. package/lib/cjs/node/triggers/sse/node.cjs.map +1 -0
  97. package/lib/cjs/node/triggers/support.cjs +107 -0
  98. package/lib/cjs/node/triggers/support.cjs.map +1 -0
  99. package/lib/cjs/node/triggers/workflow/node.cjs +193 -0
  100. package/lib/cjs/node/triggers/workflow/node.cjs.map +1 -0
  101. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs +20 -3
  102. package/lib/cjs/shared/graph/catalog/GraphValueSchemaDerivation.cjs.map +1 -1
  103. package/lib/cjs/workflows/boundary-value.workflow.cjs +38 -0
  104. package/lib/cjs/workflows/boundary-value.workflow.cjs.map +1 -0
  105. package/lib/cjs/workflows/builders.cjs +47 -0
  106. package/lib/cjs/workflows/builders.cjs.map +1 -0
  107. package/lib/cjs/workflows/chat-agent.workflow.cjs +40 -0
  108. package/lib/cjs/workflows/chat-agent.workflow.cjs.map +1 -0
  109. package/lib/cjs/workflows/error-boundary.workflow.cjs +54 -0
  110. package/lib/cjs/workflows/error-boundary.workflow.cjs.map +1 -0
  111. package/lib/cjs/workflows/event-map.workflow.cjs +37 -0
  112. package/lib/cjs/workflows/event-map.workflow.cjs.map +1 -0
  113. package/lib/cjs/workflows/foreach-break.workflow.cjs +58 -0
  114. package/lib/cjs/workflows/foreach-break.workflow.cjs.map +1 -0
  115. package/lib/cjs/workflows/human-approval.workflow.cjs +44 -0
  116. package/lib/cjs/workflows/human-approval.workflow.cjs.map +1 -0
  117. package/lib/cjs/workflows/if-switch.workflow.cjs +66 -0
  118. package/lib/cjs/workflows/if-switch.workflow.cjs.map +1 -0
  119. package/lib/cjs/workflows/index.cjs +135 -0
  120. package/lib/cjs/workflows/index.cjs.map +1 -0
  121. package/lib/cjs/workflows/loops-while-until.workflow.cjs +76 -0
  122. package/lib/cjs/workflows/loops-while-until.workflow.cjs.map +1 -0
  123. package/lib/cjs/workflows/manual-log.workflow.cjs +52 -0
  124. package/lib/cjs/workflows/manual-log.workflow.cjs.map +1 -0
  125. package/lib/cjs/workflows/schedule-code.workflow.cjs +42 -0
  126. package/lib/cjs/workflows/schedule-code.workflow.cjs.map +1 -0
  127. package/lib/cjs/workflows/types.cjs +4 -0
  128. package/lib/cjs/workflows/types.cjs.map +1 -0
  129. package/lib/cjs/workflows/value-templates.workflow.cjs +43 -0
  130. package/lib/cjs/workflows/value-templates.workflow.cjs.map +1 -0
  131. package/lib/cjs/workflows/webhook-form.workflow.cjs +48 -0
  132. package/lib/cjs/workflows/webhook-form.workflow.cjs.map +1 -0
  133. package/lib/esm/dagster/DagsterGraphExecutionBackend.js +13 -0
  134. package/lib/esm/dagster/DagsterGraphExecutionBackend.js.map +1 -1
  135. package/lib/esm/dagster/capabilities.js +5 -0
  136. package/lib/esm/dagster/capabilities.js.map +1 -1
  137. package/lib/esm/engine/execution/GraphCodeMode.js +40 -0
  138. package/lib/esm/engine/execution/GraphCodeMode.js.map +1 -1
  139. package/lib/esm/engine/execution/GraphExecutionBackend.js.map +1 -1
  140. package/lib/esm/engine/execution/GraphExecutionEngine.js +36 -5
  141. package/lib/esm/engine/execution/GraphExecutionEngine.js.map +1 -1
  142. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js +29 -1
  143. package/lib/esm/engine/validation/GraphNodeInstanceValidator.js.map +1 -1
  144. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js +6 -2
  145. package/lib/esm/engine/validation/GraphWorkflowDocumentValidator.js.map +1 -1
  146. package/lib/esm/mastra/MastraMemory.js.map +1 -1
  147. package/lib/esm/mastra/MastraWorkflowCompiler.js +41 -9
  148. package/lib/esm/mastra/MastraWorkflowCompiler.js.map +1 -1
  149. package/lib/esm/nest/graph/GraphEngineController.js +19 -1
  150. package/lib/esm/nest/graph/GraphEngineController.js.map +1 -1
  151. package/lib/esm/nest/graph/GraphNodeCatalogueController.js +15 -1
  152. package/lib/esm/nest/graph/GraphNodeCatalogueController.js.map +1 -1
  153. package/lib/esm/nest/graph/GraphRunController.js +18 -1
  154. package/lib/esm/nest/graph/GraphRunController.js.map +1 -1
  155. package/lib/esm/nest/graph/GraphWorkflowController.js +35 -6
  156. package/lib/esm/nest/graph/GraphWorkflowController.js.map +1 -1
  157. package/lib/esm/node/comms/discord/node.js +375 -0
  158. package/lib/esm/node/comms/discord/node.js.map +1 -0
  159. package/lib/esm/node/comms/outlook/node.js +386 -0
  160. package/lib/esm/node/comms/outlook/node.js.map +1 -0
  161. package/lib/esm/node/comms/whatsapp/node.js +332 -0
  162. package/lib/esm/node/comms/whatsapp/node.js.map +1 -0
  163. package/lib/esm/node/data/aggregate/node.js +187 -0
  164. package/lib/esm/node/data/aggregate/node.js.map +1 -0
  165. package/lib/esm/node/data/compare-datasets/node.js +322 -0
  166. package/lib/esm/node/data/compare-datasets/node.js.map +1 -0
  167. package/lib/esm/node/data/item-lists/node.js +407 -0
  168. package/lib/esm/node/data/item-lists/node.js.map +1 -0
  169. package/lib/esm/node/data/remove-duplicates/node.js +132 -0
  170. package/lib/esm/node/data/remove-duplicates/node.js.map +1 -0
  171. package/lib/esm/node/data/summarize/node.js +146 -0
  172. package/lib/esm/node/data/summarize/node.js.map +1 -0
  173. package/lib/esm/node/data/support.js +5 -1
  174. package/lib/esm/node/data/support.js.map +1 -1
  175. package/lib/esm/node/data/transform-utils.js +702 -0
  176. package/lib/esm/node/data/transform-utils.js.map +1 -0
  177. package/lib/esm/node/index.js +110 -4
  178. package/lib/esm/node/index.js.map +1 -1
  179. package/lib/esm/node/io/confluence/node.js +244 -0
  180. package/lib/esm/node/io/confluence/node.js.map +1 -0
  181. package/lib/esm/node/io/convert-to-file/node.js +340 -0
  182. package/lib/esm/node/io/convert-to-file/node.js.map +1 -0
  183. package/lib/esm/node/io/file-support.js +299 -0
  184. package/lib/esm/node/io/file-support.js.map +1 -0
  185. package/lib/esm/node/io/google-calendar/node.js +350 -0
  186. package/lib/esm/node/io/google-calendar/node.js.map +1 -0
  187. package/lib/esm/node/io/google-docs/node.js +263 -0
  188. package/lib/esm/node/io/google-docs/node.js.map +1 -0
  189. package/lib/esm/node/io/html/node.js +266 -0
  190. package/lib/esm/node/io/html/node.js.map +1 -0
  191. package/lib/esm/node/io/html-extract/node.js +153 -0
  192. package/lib/esm/node/io/html-extract/node.js.map +1 -0
  193. package/lib/esm/node/io/html-support.js +206 -0
  194. package/lib/esm/node/io/html-support.js.map +1 -0
  195. package/lib/esm/node/io/jira/node.js +342 -0
  196. package/lib/esm/node/io/jira/node.js.map +1 -0
  197. package/lib/esm/node/io/markdown/node.js +217 -0
  198. package/lib/esm/node/io/markdown/node.js.map +1 -0
  199. package/lib/esm/node/io/microsoft-excel/node.js +252 -0
  200. package/lib/esm/node/io/microsoft-excel/node.js.map +1 -0
  201. package/lib/esm/node/io/microsoft-sharepoint/node.js +265 -0
  202. package/lib/esm/node/io/microsoft-sharepoint/node.js.map +1 -0
  203. package/lib/esm/node/io/read-binary-file/node.js +105 -0
  204. package/lib/esm/node/io/read-binary-file/node.js.map +1 -0
  205. package/lib/esm/node/io/read-binary-files/node.js +104 -0
  206. package/lib/esm/node/io/read-binary-files/node.js.map +1 -0
  207. package/lib/esm/node/io/write-binary-file/node.js +155 -0
  208. package/lib/esm/node/io/write-binary-file/node.js.map +1 -0
  209. package/lib/esm/node/io/xml/node.js +313 -0
  210. package/lib/esm/node/io/xml/node.js.map +1 -0
  211. package/lib/esm/node/manifests.js +58 -0
  212. package/lib/esm/node/manifests.js.map +1 -1
  213. package/lib/esm/node/storage/rabbitmq/node.js +243 -0
  214. package/lib/esm/node/storage/rabbitmq/node.js.map +1 -0
  215. package/lib/esm/node/triggers/error/node.js +99 -0
  216. package/lib/esm/node/triggers/error/node.js.map +1 -0
  217. package/lib/esm/node/triggers/postgres/node.js +235 -0
  218. package/lib/esm/node/triggers/postgres/node.js.map +1 -0
  219. package/lib/esm/node/triggers/rabbitmq/node.js +275 -0
  220. package/lib/esm/node/triggers/rabbitmq/node.js.map +1 -0
  221. package/lib/esm/node/triggers/redis/node.js +224 -0
  222. package/lib/esm/node/triggers/redis/node.js.map +1 -0
  223. package/lib/esm/node/triggers/sse/node.js +187 -0
  224. package/lib/esm/node/triggers/sse/node.js.map +1 -0
  225. package/lib/esm/node/triggers/support.js +99 -0
  226. package/lib/esm/node/triggers/support.js.map +1 -0
  227. package/lib/esm/node/triggers/workflow/node.js +184 -0
  228. package/lib/esm/node/triggers/workflow/node.js.map +1 -0
  229. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js +20 -3
  230. package/lib/esm/shared/graph/catalog/GraphValueSchemaDerivation.js.map +1 -1
  231. package/lib/esm/workflows/boundary-value.workflow.js +34 -0
  232. package/lib/esm/workflows/boundary-value.workflow.js.map +1 -0
  233. package/lib/esm/workflows/builders.js +40 -0
  234. package/lib/esm/workflows/builders.js.map +1 -0
  235. package/lib/esm/workflows/chat-agent.workflow.js +36 -0
  236. package/lib/esm/workflows/chat-agent.workflow.js.map +1 -0
  237. package/lib/esm/workflows/error-boundary.workflow.js +50 -0
  238. package/lib/esm/workflows/error-boundary.workflow.js.map +1 -0
  239. package/lib/esm/workflows/event-map.workflow.js +33 -0
  240. package/lib/esm/workflows/event-map.workflow.js.map +1 -0
  241. package/lib/esm/workflows/foreach-break.workflow.js +54 -0
  242. package/lib/esm/workflows/foreach-break.workflow.js.map +1 -0
  243. package/lib/esm/workflows/human-approval.workflow.js +40 -0
  244. package/lib/esm/workflows/human-approval.workflow.js.map +1 -0
  245. package/lib/esm/workflows/if-switch.workflow.js +62 -0
  246. package/lib/esm/workflows/if-switch.workflow.js.map +1 -0
  247. package/lib/esm/workflows/index.js +116 -0
  248. package/lib/esm/workflows/index.js.map +1 -0
  249. package/lib/esm/workflows/loops-while-until.workflow.js +72 -0
  250. package/lib/esm/workflows/loops-while-until.workflow.js.map +1 -0
  251. package/lib/esm/workflows/manual-log.workflow.js +48 -0
  252. package/lib/esm/workflows/manual-log.workflow.js.map +1 -0
  253. package/lib/esm/workflows/schedule-code.workflow.js +38 -0
  254. package/lib/esm/workflows/schedule-code.workflow.js.map +1 -0
  255. package/lib/esm/workflows/types.js +2 -0
  256. package/lib/esm/workflows/types.js.map +1 -0
  257. package/lib/esm/workflows/value-templates.workflow.js +39 -0
  258. package/lib/esm/workflows/value-templates.workflow.js.map +1 -0
  259. package/lib/esm/workflows/webhook-form.workflow.js +44 -0
  260. package/lib/esm/workflows/webhook-form.workflow.js.map +1 -0
  261. package/lib/types/dagster/DagsterGraphExecutionBackend.d.cts +7 -0
  262. package/lib/types/dagster/DagsterGraphExecutionBackend.d.mts +7 -0
  263. package/lib/types/engine/execution/GraphCodeMode.d.cts +46 -0
  264. package/lib/types/engine/execution/GraphCodeMode.d.mts +46 -0
  265. package/lib/types/engine/execution/GraphExecutionBackend.d.cts +21 -0
  266. package/lib/types/engine/execution/GraphExecutionBackend.d.mts +21 -0
  267. package/lib/types/engine/execution/GraphExecutionEngine.d.cts +28 -3
  268. package/lib/types/engine/execution/GraphExecutionEngine.d.mts +28 -3
  269. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.cts +11 -1
  270. package/lib/types/engine/validation/GraphNodeInstanceValidator.d.mts +11 -1
  271. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.cts +7 -0
  272. package/lib/types/engine/validation/GraphWorkflowDocumentValidator.d.mts +7 -0
  273. package/lib/types/mastra/MastraWorkflowCompiler.d.cts +23 -8
  274. package/lib/types/mastra/MastraWorkflowCompiler.d.mts +23 -8
  275. package/lib/types/nest/graph/GraphEngineController.d.cts +19 -0
  276. package/lib/types/nest/graph/GraphEngineController.d.mts +19 -0
  277. package/lib/types/nest/graph/GraphNodeCatalogueController.d.cts +13 -0
  278. package/lib/types/nest/graph/GraphNodeCatalogueController.d.mts +13 -0
  279. package/lib/types/nest/graph/GraphRunController.d.cts +16 -0
  280. package/lib/types/nest/graph/GraphRunController.d.mts +16 -0
  281. package/lib/types/nest/graph/GraphWorkflowController.d.cts +26 -3
  282. package/lib/types/nest/graph/GraphWorkflowController.d.mts +26 -3
  283. package/lib/types/node/comms/discord/node.d.cts +67 -0
  284. package/lib/types/node/comms/discord/node.d.mts +67 -0
  285. package/lib/types/node/comms/outlook/node.d.cts +77 -0
  286. package/lib/types/node/comms/outlook/node.d.mts +77 -0
  287. package/lib/types/node/comms/whatsapp/node.d.cts +71 -0
  288. package/lib/types/node/comms/whatsapp/node.d.mts +71 -0
  289. package/lib/types/node/data/aggregate/node.d.cts +58 -0
  290. package/lib/types/node/data/aggregate/node.d.mts +58 -0
  291. package/lib/types/node/data/compare-datasets/node.d.cts +72 -0
  292. package/lib/types/node/data/compare-datasets/node.d.mts +72 -0
  293. package/lib/types/node/data/item-lists/node.d.cts +92 -0
  294. package/lib/types/node/data/item-lists/node.d.mts +92 -0
  295. package/lib/types/node/data/remove-duplicates/node.d.cts +47 -0
  296. package/lib/types/node/data/remove-duplicates/node.d.mts +47 -0
  297. package/lib/types/node/data/summarize/node.d.cts +44 -0
  298. package/lib/types/node/data/summarize/node.d.mts +44 -0
  299. package/lib/types/node/data/support.d.cts +13 -0
  300. package/lib/types/node/data/support.d.mts +13 -0
  301. package/lib/types/node/data/transform-utils.d.cts +236 -0
  302. package/lib/types/node/data/transform-utils.d.mts +236 -0
  303. package/lib/types/node/index.d.cts +54 -6
  304. package/lib/types/node/index.d.mts +54 -6
  305. package/lib/types/node/io/confluence/node.d.cts +49 -0
  306. package/lib/types/node/io/confluence/node.d.mts +49 -0
  307. package/lib/types/node/io/convert-to-file/node.d.cts +75 -0
  308. package/lib/types/node/io/convert-to-file/node.d.mts +75 -0
  309. package/lib/types/node/io/file-support.d.cts +118 -0
  310. package/lib/types/node/io/file-support.d.mts +118 -0
  311. package/lib/types/node/io/google-calendar/node.d.cts +65 -0
  312. package/lib/types/node/io/google-calendar/node.d.mts +65 -0
  313. package/lib/types/node/io/google-docs/node.d.cts +51 -0
  314. package/lib/types/node/io/google-docs/node.d.mts +51 -0
  315. package/lib/types/node/io/html/node.d.cts +68 -0
  316. package/lib/types/node/io/html/node.d.mts +68 -0
  317. package/lib/types/node/io/html-extract/node.d.cts +42 -0
  318. package/lib/types/node/io/html-extract/node.d.mts +42 -0
  319. package/lib/types/node/io/html-support.d.cts +69 -0
  320. package/lib/types/node/io/html-support.d.mts +69 -0
  321. package/lib/types/node/io/jira/node.d.cts +57 -0
  322. package/lib/types/node/io/jira/node.d.mts +57 -0
  323. package/lib/types/node/io/markdown/node.d.cts +61 -0
  324. package/lib/types/node/io/markdown/node.d.mts +61 -0
  325. package/lib/types/node/io/microsoft-excel/node.d.cts +45 -0
  326. package/lib/types/node/io/microsoft-excel/node.d.mts +45 -0
  327. package/lib/types/node/io/microsoft-sharepoint/node.d.cts +47 -0
  328. package/lib/types/node/io/microsoft-sharepoint/node.d.mts +47 -0
  329. package/lib/types/node/io/read-binary-file/node.d.cts +45 -0
  330. package/lib/types/node/io/read-binary-file/node.d.mts +45 -0
  331. package/lib/types/node/io/read-binary-files/node.d.cts +41 -0
  332. package/lib/types/node/io/read-binary-files/node.d.mts +41 -0
  333. package/lib/types/node/io/write-binary-file/node.d.cts +55 -0
  334. package/lib/types/node/io/write-binary-file/node.d.mts +55 -0
  335. package/lib/types/node/io/xml/node.d.cts +67 -0
  336. package/lib/types/node/io/xml/node.d.mts +67 -0
  337. package/lib/types/node/storage/rabbitmq/node.d.cts +55 -0
  338. package/lib/types/node/storage/rabbitmq/node.d.mts +55 -0
  339. package/lib/types/node/triggers/error/node.d.cts +34 -0
  340. package/lib/types/node/triggers/error/node.d.mts +34 -0
  341. package/lib/types/node/triggers/postgres/node.d.cts +54 -0
  342. package/lib/types/node/triggers/postgres/node.d.mts +54 -0
  343. package/lib/types/node/triggers/rabbitmq/node.d.cts +59 -0
  344. package/lib/types/node/triggers/rabbitmq/node.d.mts +59 -0
  345. package/lib/types/node/triggers/redis/node.d.cts +53 -0
  346. package/lib/types/node/triggers/redis/node.d.mts +53 -0
  347. package/lib/types/node/triggers/sse/node.d.cts +43 -0
  348. package/lib/types/node/triggers/sse/node.d.mts +43 -0
  349. package/lib/types/node/triggers/support.d.cts +41 -0
  350. package/lib/types/node/triggers/support.d.mts +41 -0
  351. package/lib/types/node/triggers/workflow/node.d.cts +46 -0
  352. package/lib/types/node/triggers/workflow/node.d.mts +46 -0
  353. package/lib/types/workflows/boundary-value.workflow.d.cts +3 -0
  354. package/lib/types/workflows/boundary-value.workflow.d.mts +3 -0
  355. package/lib/types/workflows/builders.d.cts +31 -0
  356. package/lib/types/workflows/builders.d.mts +31 -0
  357. package/lib/types/workflows/chat-agent.workflow.d.cts +3 -0
  358. package/lib/types/workflows/chat-agent.workflow.d.mts +3 -0
  359. package/lib/types/workflows/error-boundary.workflow.d.cts +3 -0
  360. package/lib/types/workflows/error-boundary.workflow.d.mts +3 -0
  361. package/lib/types/workflows/event-map.workflow.d.cts +3 -0
  362. package/lib/types/workflows/event-map.workflow.d.mts +3 -0
  363. package/lib/types/workflows/foreach-break.workflow.d.cts +3 -0
  364. package/lib/types/workflows/foreach-break.workflow.d.mts +3 -0
  365. package/lib/types/workflows/human-approval.workflow.d.cts +3 -0
  366. package/lib/types/workflows/human-approval.workflow.d.mts +3 -0
  367. package/lib/types/workflows/if-switch.workflow.d.cts +3 -0
  368. package/lib/types/workflows/if-switch.workflow.d.mts +3 -0
  369. package/lib/types/workflows/index.d.cts +37 -0
  370. package/lib/types/workflows/index.d.mts +37 -0
  371. package/lib/types/workflows/loops-while-until.workflow.d.cts +3 -0
  372. package/lib/types/workflows/loops-while-until.workflow.d.mts +3 -0
  373. package/lib/types/workflows/manual-log.workflow.d.cts +3 -0
  374. package/lib/types/workflows/manual-log.workflow.d.mts +3 -0
  375. package/lib/types/workflows/schedule-code.workflow.d.cts +3 -0
  376. package/lib/types/workflows/schedule-code.workflow.d.mts +3 -0
  377. package/lib/types/workflows/types.d.cts +32 -0
  378. package/lib/types/workflows/types.d.mts +32 -0
  379. package/lib/types/workflows/value-templates.workflow.d.cts +16 -0
  380. package/lib/types/workflows/value-templates.workflow.d.mts +16 -0
  381. package/lib/types/workflows/webhook-form.workflow.d.cts +3 -0
  382. package/lib/types/workflows/webhook-form.workflow.d.mts +3 -0
  383. package/package.json +247 -25
package/README.md CHANGED
@@ -298,13 +298,13 @@ The built-in kinds are declared one folder per node under
298
298
 
299
299
  | Group | Kinds |
300
300
  | --- | --- |
301
- | Triggers | `core.trigger.manual`, `core.trigger.webhook`, `core.trigger.schedule`, `core.trigger.event`, `core.trigger.form`, `core.trigger.chat`, `core.trigger.executeWorkflow` |
301
+ | Triggers | `core.trigger.manual`, `core.trigger.webhook`, `core.trigger.schedule`, `core.trigger.event`, `core.trigger.form`, `core.trigger.chat`, `core.trigger.executeWorkflow`, `core.trigger.error`, `core.trigger.workflow`, `core.trigger.rabbitmq`, `core.trigger.redis`, `core.trigger.sse`, `core.trigger.postgres` |
302
302
  | Flow | `core.flow.if`, `core.flow.switch`, `core.flow.delay`, `core.flow.errorBoundary`, `core.flow.humanApproval`, `core.flow.log`, `core.flow.break`, `core.flow.executeSubWorkflow` |
303
- | Data | `core.data.set`, `core.data.merge`, `core.data.filter`, `core.data.splitOut`, `core.data.dateTime`, `core.data.dataTable`, `core.data.limit`, `core.data.sort`, `core.data.renameKeys` |
304
- | IO | `core.io.httpRequest`, `core.io.respondToWebhook`, `core.io.extractFromFile`, `core.io.readPDF`, `core.io.readWriteFile`, `core.io.googleSheets`, `core.io.airtable`, `core.io.spreadsheetFile`, `core.io.graphql` |
305
- | Storage | `core.storage.postgres`, `core.storage.mySql`, `core.storage.microsoftSql`, `core.storage.redis`, `core.storage.s3`, `core.storage.awsS3`, `core.storage.googleCloudStorage`, `core.storage.azureStorage` |
303
+ | Data | `core.data.set`, `core.data.merge`, `core.data.filter`, `core.data.splitOut`, `core.data.dateTime`, `core.data.dataTable`, `core.data.limit`, `core.data.sort`, `core.data.renameKeys`, `core.data.aggregate`, `core.data.itemLists`, `core.data.compareDatasets`, `core.data.summarize`, `core.data.removeDuplicates` |
304
+ | IO | `core.io.httpRequest`, `core.io.respondToWebhook`, `core.io.extractFromFile`, `core.io.readPDF`, `core.io.readWriteFile`, `core.io.googleSheets`, `core.io.airtable`, `core.io.spreadsheetFile`, `core.io.graphql`, `core.io.convertToFile`, `core.io.html`, `core.io.htmlExtract`, `core.io.markdown`, `core.io.xml`, `core.io.readBinaryFile`, `core.io.readBinaryFiles`, `core.io.writeBinaryFile`, `core.io.microsoftExcel`, `core.io.confluence`, `core.io.jira`, `core.io.googleDocs`, `core.io.microsoftSharePoint`, `core.io.googleCalendar` |
305
+ | Storage | `core.storage.postgres`, `core.storage.mySql`, `core.storage.microsoftSql`, `core.storage.redis`, `core.storage.rabbitmq`, `core.storage.s3`, `core.storage.awsS3`, `core.storage.googleCloudStorage`, `core.storage.azureStorage` |
306
306
  | DevOps | `core.devops.crypto`, `core.devops.jwt`, `core.devops.executeCommand`, `core.devops.ftp`, `core.devops.github`, `core.devops.gitlab` |
307
- | Comms | `core.comms.slack`, `core.comms.telegram`, `core.comms.teams`, `core.comms.gmail`, `core.comms.emailSend` |
307
+ | Comms | `core.comms.slack`, `core.comms.telegram`, `core.comms.teams`, `core.comms.gmail`, `core.comms.emailSend`, `core.comms.discord`, `core.comms.whatsApp`, `core.comms.microsoftOutlook` |
308
308
  | Utility | `core.utility.code`, `core.utility.map`, `core.utility.log` |
309
309
  | Loops | `core.loop.foreach`, `core.loop.while`, `core.loop.until` |
310
310
  | Agent | `core.agent` (the agent node) and its `core.agent.*` family kinds: `core.agent.tool|toolSelector` (tools), `core.agent.hook|toolDeny|delegationHook` (hooks), `core.agent.skill|skillSelector` (skills), `core.agent.sandbox` (sandbox), `core.agent.scorer|scorerSelector` (scorers), `core.agent.memory|memorySelector` (memory), `core.agent.embedding|vectorStore|retriever|rerank|chunking` (RAG), `core.agent.chain.basic|qa|summarization` (RAG chains), `core.agent.inputProcessor|outputProcessor|guardrail|structuredOutputParser|informationExtractor|langchainCode` (processors), `core.agent.hitl` (human-in-the-loop), `core.agent.voice` (voice), `core.agent.trigger.mcp|slack|discord|telegram|teams` (triggers), `core.agent.response.slack|discord|telegram|teams` (channel responses). Every `core.agent[.*]` kind requires the mastra engine — the general (local) engine fails closed with `GRAPH_LOCAL_UNSUPPORTED_NODE_KIND` |
@@ -316,7 +316,7 @@ secret services. A node's `credentialRef` parameter holds a `{ credentialId, cre
316
316
  credential record, validates its type, enabled state and expiry, then retrieves the secret by `secretName` through the model-backed
317
317
  or filesystem-backed secret service. A missing/unconfigured resolver fails closed with `GRAPH_CREDENTIAL_SERVICE_UNAVAILABLE` and an
318
318
  unsupported provider with `GRAPH_CREDENTIAL_PROVIDER_UNSUPPORTED`; secrets are never stored in workflow documents. The
319
- PostgreSQL, MySQL, and Microsoft SQL kinds require the matching TypeORM driver (`pg`, `mysql2`, `mssql`), all three declared as optional dependencies. The Comms, DevOps, and IO kinds delegate to the service classes in `@decaf-ts/integrations` where applicable (`comms/{slack,telegram,teams,gmail,email}`, `devops/{github,gitlab}`, `core.devops.ftp` via `@decaf-ts/integrations/sftp`, `io/{google-sheets,airtable,graphql}`); `core.devops.crypto` and `core.devops.jwt` use `@decaf-ts/crypto`, `core.devops.executeCommand` runs a local `child_process`, and `core.io.spreadsheetFile` is local parsing/writing with no network service.
319
+ PostgreSQL, MySQL, and Microsoft SQL kinds require the matching TypeORM driver (`pg`, `mysql2`, `mssql`), all three declared as optional dependencies. The Comms, DevOps, and IO kinds delegate to the service classes in `@decaf-ts/integrations` where applicable (`comms/{slack,telegram,teams,gmail,email,discord,whatsapp,outlook}`, `devops/{github,gitlab}`, `core.devops.ftp` via `@decaf-ts/integrations/sftp`, `io/{google-sheets,airtable,graphql,confluence,jira,google-docs,microsoft-excel,microsoft-sharepoint}`, and `core.io.googleCalendar` via `@decaf-ts/integrations/calendar/google-calendar`); the Stage 5 stream triggers connect directly through their thin client libraries — `core.trigger.rabbitmq`/`core.storage.rabbitmq` over `amqplib`, `core.trigger.redis` over the `@decaf-ts/integrations/redis` adapter (same connection handling as `core.storage.redis`), `core.trigger.sse` over the `eventsource` client, and `core.trigger.postgres` over `pg` with the same TLS policy as `core.storage.postgres`. `core.devops.crypto` and `core.devops.jwt` use `@decaf-ts/crypto`, `core.devops.executeCommand` runs a local `child_process`, and `core.io.spreadsheetFile` is local parsing/writing with no network service.
320
320
 
321
321
  There is no structural `parallel` node kind: the graph itself parallelizes on multiple connections
322
322
  to an output port (native fan-out) and syncs on multiple connections into an input port (native
@@ -347,6 +347,28 @@ persists cross-run rows through the engine's data-table repository, and
347
347
  bottom-right, `hooks`/`sandbox` top-middle, `tools`/`skill` bottom-middle, and the processor
348
348
  zones `inputProcessors`/`outputProcessors` — each accepting only
349
349
  the matching family node's connection (same-category rule).
350
+ - Stream triggers (`core.trigger.rabbitmq`, `core.trigger.redis`, `core.trigger.sse`,
351
+ `core.trigger.postgres`) — wait for exactly one event inside the executor: the run
352
+ service starts the run, the trigger subscribes (queue consume, pub/sub channel
353
+ patterns, SSE endpoint, Postgres `LISTEN`), and the run continues on the first
354
+ event. The wait honours `timeoutMs` (default 30 s) and the run's abort signal
355
+ (`GRAPH_TRIGGER_ABORTED`), the subscription is always cleaned up, and one
356
+ message per run is consumed and acknowledged immediately.
357
+ - `core.storage.rabbitmq` — the producer pairing node for `core.trigger.rabbitmq`:
358
+ publishes a message to a queue or a topic exchange (exchange type defaults to
359
+ `topic`) over `amqplib`; a message published to the same queue/exchange fires
360
+ the trigger. `core.storage.redis` with `operation: "publish"` is the producer
361
+ side of `core.trigger.redis` (same channel prefix scoping).
362
+ - `core.trigger.error` — payloadless entrypoint of an error workflow; normalizes
363
+ the failure payload delivered through the run/event boundary into the
364
+ `execution`/`workflow`/`error` blocks. `core.trigger.workflow` — starts a run
365
+ on the workflow's own `activate`/`update` lifecycle events; a delivered event
366
+ outside the configured list fails closed.
367
+ - `core.io.readBinaryFile` / `core.io.readBinaryFiles` (glob) / `core.io.writeBinaryFile` —
368
+ binary payloads (`base64` data + mime type, `utf8`/`base64`/`auto` decoding)
369
+ confined to the same `GRAPH_FILE_IO_BASE` root as `core.io.readWriteFile`
370
+ (traversal and forbidden-directory escapes fail closed with
371
+ `GRAPH_FILE_PATH_FORBIDDEN`).
350
372
 
351
373
  `@uielement` labels and placeholders are locale keys, not hardcoded strings: the strings live in
352
374
  `assets/i18n/en.json`, shipped in the published package.
@@ -1322,6 +1344,34 @@ import { KeycloakAuthHandler } from "@decaf-ts/integrations/nest";
1322
1344
  export class AppModule {}
1323
1345
  ```
1324
1346
 
1347
+ ##### Graph serving authentication (`@Public()` and the enforcement chain)
1348
+
1349
+ All four graph serving controllers — `GraphRunController`, `GraphWorkflowController`,
1350
+ `GraphNodeCatalogueController`, and `GraphEngineController` — carry `@Public()` from
1351
+ `@decaf-ts/for-nest`, opting their routes out of the global `AuthInterceptor` that
1352
+ `DecafAuthModule.forRoot` installs when `authGlobal` is `true`. Without the marker, that
1353
+ interceptor's `authHandler.authorize(...)` gate ran before the controllers' own
1354
+ route-level policy could apply, and its `AuthorizationError` — a decaf error, not a Nest
1355
+ `HttpException` — surfaced the intended `401` as a generic `500`.
1356
+
1357
+ `@Public()` is not an anonymous-access grant. The authoritative enforcement chain is:
1358
+
1359
+ 1. **Context priming** — the for-nest `AuthMiddleware` still runs and calls
1360
+ `authHandler.prime(...)`, putting the authenticated `user`, `roles`, `namespaces`,
1361
+ and `organization` on the `DecafRequestContext`.
1362
+ 2. **Surface policy** — each controller's `requireAuthenticatedContext()` enforces the
1363
+ per-API `auth` option: the `"required"` default rejects a request with no request
1364
+ context or no resolved owner user with `401`; `"optional"` admits anonymous callers
1365
+ for standalone runs.
1366
+ 3. **Engine authorization** — `GraphAuthValidator` authorizes the workflow-level
1367
+ requirements and every plan node's required namespaces/roles against the primed
1368
+ principal and fails closed with `ForbiddenError` before any node executes.
1369
+ 4. **Ownership checks** — service-level rules (never a controller option) gate the
1370
+ data: the `allowAnonymousAccess` tolerance widens *read* visibility of owner-less
1371
+ resources only, payload projection (`inputs`/`result`/`error` on run rows) is served
1372
+ on owner equality, and writes (workflow overwrites, run cancellation) require strict
1373
+ owner equality.
1374
+
1325
1375
  #### Running each backend + UI combination
1326
1376
 
1327
1377
  The standalone host (`bin.as-graph-server`, `lib/cjs/nest/graph/main.cjs`) boots exactly one engine
@@ -1477,12 +1527,13 @@ infra is skipped honestly rather than faked.
1477
1527
  | `npm run start:backend:dagster` | Boot the standalone host with the Dagster engine (`GRAPH_BACKEND_ENGINE=dagster`) |
1478
1528
  | `npm run test:integration:standard` / `:mastra` / `:dagster` | Run one engine variant's integration suite |
1479
1529
  | `npm run test:integration:backend` | Run the host-boot integration suite (all variants + standalone binary) |
1480
- | `npm run prepare-it-tests` / `teardown-it-tests` | Boot / stop the integration service matrix (`docker/tests-compose.yml`, 11 services), the pinned Dagster gateway fixture, and — when the sibling `integrations` checkout is present — its Postgres harness on `:55435` — see [Integration service matrix](#integration-service-matrix) |
1530
+ | `npm run prepare-it-tests` / `teardown-it-tests` | Boot / stop the integration service matrix (`docker/tests-compose.yml`, 12 services), the pinned Dagster gateway fixture, and — when the sibling `integrations` checkout is present — its Postgres harness on `:55435` — see [Integration service matrix](#integration-service-matrix) |
1481
1531
  | `npm run test:unit` / `test:integration` / `test:e2e` | Run the Jest unit / integration / e2e suites |
1482
1532
  | `npm run test:unit:pdf` | Run the `ReadPDFNode` unit suite through `jest.pdf.config.cjs`; `pdf-parse`'s `pdfjs-dist` fake worker needs the Node `--experimental-vm-modules` runtime, so the file stays excluded from the default Jest config and runs first in `test:all` (and therefore in `test`, `test:dist`, `coverage`, `prepare-pr`, and `prepare-release`) |
1483
1533
  | `npm run test:evals` | Run the standalone eval suite (`jest -c jest.eval.config.cjs` over `tests/evals/*.eval.ts`; never picked up by the main Jest config) |
1484
1534
  | `npm run test:all` | Run the entire Jest suite (unit, integration, e2e) plus the `test:unit:pdf` lane |
1485
- | `npm run test:dist` | Re-run the full suite against the compiled `lib` and `dist` outputs |
1535
+ | `npm run test:dist` | Re-run the full suite against the compiled artifacts: a `TEST_TARGET=lib` pass retargets every source-relative import to `lib/cjs` through `scripts/jest-target-resolver.cjs` (run `npm run build` first — a missing emitted file fails loudly), then a `TEST_TARGET=dist` pass exercises the rolled-up `dist/as-graph.cjs` bundle through `tests/unit/ts-workspace.test.ts` (the bundle exposes only the package barrel, so the deep-import suites stay on the lib pass). See [Test target selection](#test-target-selection) |
1536
+ | `npm run prepare-pr` / `prepare-release` | Lint-fix, production build, coverage, and the docs build; `prepare-release` additionally runs both `test:dist` target passes so the release is certified against `lib` and `dist`, not just the sources |
1486
1537
  | `npm run test:circular` | Check the source for circular dependencies |
1487
1538
  | `npm run coverage` | Test run with coverage into `workdocs/reports/coverage` |
1488
1539
  | `npm run lint` / `lint-fix` | ESLint |
@@ -1490,6 +1541,30 @@ infra is skipped honestly rather than faked.
1490
1541
  | `npm run uml` / `drawings` | Render `workdocs/uml/*.puml` and `workdocs/drawings/*.drawio` into `workdocs/resources` |
1491
1542
  | `repo:readme` | Regenerate `README.md` from `workdocs/Readme.md` |
1492
1543
 
1544
+ ##### Test target selection
1545
+
1546
+ `TEST_TARGET` selects which build of the package a Jest run loads — the Decaf
1547
+ workspace convention `src | lib | dist`, resolved by
1548
+ `tests/workspace-target.ts`:
1549
+
1550
+ - `src` (the default, and any unset value) resolves the TypeScript sources —
1551
+ the historical source-mode resolution, unchanged.
1552
+ - `lib` retargets every source-relative import landing under `src/` to the
1553
+ matching emitted file under `lib/cjs` through
1554
+ `scripts/jest-target-resolver.cjs`, wired as the Jest `resolver` in
1555
+ `jest.config.cjs` (with `cjs` added to `moduleFileExtensions`). Run
1556
+ `npm run build` first: the resolver fails loudly instead of silently mixing
1557
+ sources into the lib pass.
1558
+ - `dist` loads the rolled-up `dist/as-graph.cjs` / `dist/as-graph.js` bundle
1559
+ through `tests/unit/ts-workspace.test.ts`. The bundle intentionally exposes
1560
+ only the package barrel, so the deep-import suites cannot run against it —
1561
+ the dist pass pins the public surface (exports, built-in kinds, engine
1562
+ wiring) while the lib pass exercises the emitted modules.
1563
+
1564
+ `npm run test:dist` runs the entire suite once per target (lib, then dist), and
1565
+ `npm run prepare-release` runs coverage plus both target passes before the docs
1566
+ build.
1567
+
1493
1568
  #### Integration service matrix
1494
1569
 
1495
1570
  The integration suites and `npm run coverage` run against the
@@ -1497,8 +1572,9 @@ production-grade service matrix booted by `npm run prepare-it-tests`
1497
1572
  (SAA-1142):
1498
1573
 
1499
1574
  - **Compose file:** `docker/tests-compose.yml` (compose project
1500
- `as-graph-it`), 11 services — Postgres 16, PGVector (pg 17), Apache AGE
1501
- (pg 17), MySQL 8, SQL Server 2022, Redis, MinIO (S3), fake-gcs-server
1575
+ `as-graph-it`), 12 services — Postgres 16, PGVector (pg 17), Apache AGE
1576
+ (pg 17), MySQL 8, SQL Server 2022, Redis, RabbitMQ 3.13 (AMQP on `55672`,
1577
+ `asgraph`/`asgraph`, management plugin), MinIO (S3), fake-gcs-server
1502
1578
  (GCS), Azurite (Azure Blob), SFTP (atmoz/sftp), and Mailpit (SMTP sink) —
1503
1579
  plus the pinned Dagster gateway fixture built by `tests/integration/dagster`
1504
1580
  and, when the sibling `integrations` checkout is present, its Postgres
@@ -1523,10 +1599,14 @@ production-grade service matrix booted by `npm run prepare-it-tests`
1523
1599
  `--volumes` for a full reset of service state.
1524
1600
  - **Honest skips:** without the booted matrix the live suites skip honestly.
1525
1601
  Suites needing a real external SaaS credential (GitHub, GitLab, Airtable,
1526
- Gmail, Slack, Teams, Telegram, Google Sheets) stay skipped until that
1602
+ Gmail, Slack, Teams, Telegram, Google Sheets, and the Stage 5c vendor live
1603
+ cases — Discord, WhatsApp, Outlook, Confluence, Jira, Google Docs, Google
1604
+ Calendar, Microsoft Excel, Microsoft SharePoint) stay skipped until that
1527
1605
  credential is configured — the harness never fabricates one and never
1528
1606
  starts a vendor stub in place of live infrastructure, and each skip title
1529
- names the exact missing env var.
1607
+ names the exact missing env var. The Stage 5c vendor suites' behavioural
1608
+ cases always run against process-local loopback HTTP stubs (no provider is
1609
+ ever contacted), so only their read-only live cases depend on a credential.
1530
1610
 
1531
1611
  Docker (with a reachable daemon) and devDependencies are the only
1532
1612
  prerequisites.