@codemation/core 0.0.5 → 0.0.11

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 (215) hide show
  1. package/dist/{InMemoryLiveWorkflowRepository-DL7LmC9S.d.ts → InMemoryLiveWorkflowRepository-DxoualoC.d.ts} +6 -2
  2. package/dist/{InMemoryLiveWorkflowRepository-D6eiiXxF.d.cts → InMemoryLiveWorkflowRepository-orY1VsWG.d.cts} +6 -2
  3. package/dist/{RunIntentService-NKobsfMQ.d.cts → RunIntentService-ByuUYsAL.d.cts} +8 -3
  4. package/dist/{RunIntentService-BFVbsOcg.js → RunIntentService-CYnn140t.js} +9 -4
  5. package/dist/RunIntentService-CYnn140t.js.map +1 -0
  6. package/dist/{RunIntentService-2ivFmNQh.cjs → RunIntentService-DlQH5eZ2.cjs} +9 -4
  7. package/dist/RunIntentService-DlQH5eZ2.cjs.map +1 -0
  8. package/dist/{WorkflowSnapshotCodec-DTdWkoW_.d.cts → WorkflowSnapshotCodec-DSEzKyt3.d.cts} +2 -2
  9. package/dist/bootstrap/index.cjs +133 -4
  10. package/dist/bootstrap/index.cjs.map +1 -1
  11. package/dist/bootstrap/index.d.cts +4 -3
  12. package/dist/bootstrap/index.d.ts +3 -2
  13. package/dist/bootstrap/index.js +133 -4
  14. package/dist/bootstrap/index.js.map +1 -1
  15. package/dist/{index-9g6Pfe9Z.d.ts → index-CTjfVHJh.d.ts} +8 -3
  16. package/dist/index.cjs +1 -1
  17. package/dist/index.d.cts +3 -3
  18. package/dist/index.d.ts +3 -3
  19. package/dist/index.js +1 -1
  20. package/dist/testing.d.cts +2 -2
  21. package/dist/testing.d.ts +1 -1
  22. package/package.json +6 -1
  23. package/src/bootstrap/runtime/EngineRuntimeRegistrar.ts +10 -2
  24. package/src/contracts/runtimeTypes.ts +5 -0
  25. package/src/execution/NodeActivationRequestComposer.ts +15 -4
  26. package/src/orchestration/Engine.ts +12 -1
  27. package/src/orchestration/NodeExecutionRequestHandlerService.ts +179 -0
  28. package/src/runtime/EngineFactory.ts +13 -0
  29. package/dist/EngineExecutionLimitsPolicy-8MEFIYx1.d.cts +0 -160
  30. package/dist/EngineExecutionLimitsPolicy-BWAXW9D6.d.cts +0 -160
  31. package/dist/EngineExecutionLimitsPolicy-Bp8PS1Ss.d.cts +0 -159
  32. package/dist/EngineExecutionLimitsPolicy-CLxcN-D2.d.ts +0 -159
  33. package/dist/EngineExecutionLimitsPolicy-DZXuix51.d.ts +0 -160
  34. package/dist/EngineExecutionLimitsPolicy-Gfz6ngFd.d.ts +0 -160
  35. package/dist/EngineFactory-CBnntY3J.cjs +0 -3152
  36. package/dist/EngineFactory-CBnntY3J.cjs.map +0 -1
  37. package/dist/EngineFactory-Cwn3R2YA.js +0 -3087
  38. package/dist/EngineFactory-Cwn3R2YA.js.map +0 -1
  39. package/dist/EngineFactory-DWCnNocp.js +0 -3063
  40. package/dist/EngineFactory-DWCnNocp.js.map +0 -1
  41. package/dist/EngineFactory-DhPFou4p.cjs +0 -3188
  42. package/dist/EngineFactory-DhPFou4p.cjs.map +0 -1
  43. package/dist/EngineFactory-l_9xmBtv.cjs +0 -3190
  44. package/dist/EngineFactory-l_9xmBtv.cjs.map +0 -1
  45. package/dist/EngineFactory-w-aOWuqh.js +0 -3089
  46. package/dist/EngineFactory-w-aOWuqh.js.map +0 -1
  47. package/dist/InMemoryLiveWorkflowRepository-1J9MHN_I.js +0 -18
  48. package/dist/InMemoryLiveWorkflowRepository-1J9MHN_I.js.map +0 -1
  49. package/dist/InMemoryLiveWorkflowRepository-CULNqv96.d.ts +0 -1300
  50. package/dist/InMemoryLiveWorkflowRepository-D7l8cjdZ.d.cts +0 -1130
  51. package/dist/InMemoryLiveWorkflowRepository-jnv-OnOP.d.ts +0 -1300
  52. package/dist/InMemoryLiveWorkflowRepository-xny1_Z6i.cjs +0 -24
  53. package/dist/InMemoryLiveWorkflowRepository-xny1_Z6i.cjs.map +0 -1
  54. package/dist/InMemoryLiveWorkflowRepository-xr7b4kvi.d.ts +0 -1338
  55. package/dist/InMemoryWorkflowCatalog-BIdFpwbK.d.ts +0 -1205
  56. package/dist/InMemoryWorkflowCatalog-BW00_3N3.d.cts +0 -12
  57. package/dist/InMemoryWorkflowCatalog-BiYHGoPw.cjs +0 -24
  58. package/dist/InMemoryWorkflowCatalog-BiYHGoPw.cjs.map +0 -1
  59. package/dist/InMemoryWorkflowCatalog-BrG0ApMO.d.cts +0 -1115
  60. package/dist/InMemoryWorkflowCatalog-BzrAr--Y.js +0 -139
  61. package/dist/InMemoryWorkflowCatalog-BzrAr--Y.js.map +0 -1
  62. package/dist/InMemoryWorkflowCatalog-C-EJlJ7y.d.cts +0 -1120
  63. package/dist/InMemoryWorkflowCatalog-C4482bpw.cjs +0 -24
  64. package/dist/InMemoryWorkflowCatalog-C4482bpw.cjs.map +0 -1
  65. package/dist/InMemoryWorkflowCatalog-CZ0kZpOv.d.ts +0 -1289
  66. package/dist/InMemoryWorkflowCatalog-C_ACeLyW.d.cts +0 -1119
  67. package/dist/InMemoryWorkflowCatalog-CiHWIu5E.d.cts +0 -12
  68. package/dist/InMemoryWorkflowCatalog-CkH7gkya.js +0 -18
  69. package/dist/InMemoryWorkflowCatalog-CkH7gkya.js.map +0 -1
  70. package/dist/InMemoryWorkflowCatalog-CnpZVJM9.d.ts +0 -1205
  71. package/dist/InMemoryWorkflowCatalog-Cu68S8YR.js +0 -18
  72. package/dist/InMemoryWorkflowCatalog-Cu68S8YR.js.map +0 -1
  73. package/dist/InMemoryWorkflowCatalog-D2w9nMj2.cjs +0 -151
  74. package/dist/InMemoryWorkflowCatalog-D2w9nMj2.cjs.map +0 -1
  75. package/dist/InMemoryWorkflowCatalog-D5eMxEf7.js +0 -18
  76. package/dist/InMemoryWorkflowCatalog-D5eMxEf7.js.map +0 -1
  77. package/dist/InMemoryWorkflowCatalog-D5nCp2yZ.d.ts +0 -1267
  78. package/dist/InMemoryWorkflowCatalog-DIq0bjqN.d.ts +0 -12
  79. package/dist/InMemoryWorkflowCatalog-DLgaEaw_.d.ts +0 -1288
  80. package/dist/InMemoryWorkflowCatalog-DNBFdK-x.d.cts +0 -1120
  81. package/dist/InMemoryWorkflowCatalog-DQBkCzb7.cjs +0 -24
  82. package/dist/InMemoryWorkflowCatalog-DQBkCzb7.cjs.map +0 -1
  83. package/dist/InMemoryWorkflowCatalog-DS4-eX6i.d.cts +0 -1118
  84. package/dist/InMemoryWorkflowCatalog-DdVfy8MY.d.ts +0 -12
  85. package/dist/InMemoryWorkflowCatalog-DeVZu3g8.d.ts +0 -12
  86. package/dist/InMemoryWorkflowCatalog-GxkQjvt5.d.ts +0 -1200
  87. package/dist/InMemoryWorkflowCatalog-qaVRn1Lc.d.cts +0 -1115
  88. package/dist/InMemoryWorkflowCatalog-z1aIT4TC.d.cts +0 -12
  89. package/dist/InMemoryWorkflowRegistry-BBuOovLL.d.ts +0 -1007
  90. package/dist/InMemoryWorkflowRegistry-BIFnSl3k.d.ts +0 -1201
  91. package/dist/InMemoryWorkflowRegistry-BnGilthz.d.ts +0 -1137
  92. package/dist/InMemoryWorkflowRegistry-CEp5I8No.d.ts +0 -1146
  93. package/dist/InMemoryWorkflowRegistry-CHyMB9jW.d.cts +0 -976
  94. package/dist/InMemoryWorkflowRegistry-CUN7K86m.d.cts +0 -1061
  95. package/dist/InMemoryWorkflowRegistry-CVfHyELh.d.cts +0 -971
  96. package/dist/InMemoryWorkflowRegistry-CXXJrwAr.d.cts +0 -1052
  97. package/dist/InMemoryWorkflowRegistry-DDGfPTJy.d.ts +0 -1013
  98. package/dist/InMemoryWorkflowRegistry-DnYSOoT5.d.ts +0 -1120
  99. package/dist/InMemoryWorkflowRegistry-Dp5GiFF2.d.cts +0 -1035
  100. package/dist/InMemoryWorkflowRegistry-DypDBeOw.d.cts +0 -1116
  101. package/dist/InMemoryWorkflowRegistry-SzwJCAxT.d.ts +0 -1012
  102. package/dist/InMemoryWorkflowRegistry-jupvqyGc.d.cts +0 -977
  103. package/dist/InMemoryWorkflowRegistry-rAdKVWYT.d.ts +0 -1117
  104. package/dist/InProcessRetryRunner-BBNPkXjy.d.cts +0 -292
  105. package/dist/PersistedWorkflowSnapshotFactory-7RkOL3Kg.d.ts +0 -14
  106. package/dist/PersistedWorkflowSnapshotFactory-BmANa46W.cjs +0 -141
  107. package/dist/PersistedWorkflowSnapshotFactory-BmANa46W.cjs.map +0 -1
  108. package/dist/PersistedWorkflowSnapshotFactory-Bwb_etSt.js +0 -118
  109. package/dist/PersistedWorkflowSnapshotFactory-Bwb_etSt.js.map +0 -1
  110. package/dist/PersistedWorkflowSnapshotFactory-CRkKGNV6.js +0 -123
  111. package/dist/PersistedWorkflowSnapshotFactory-CRkKGNV6.js.map +0 -1
  112. package/dist/PersistedWorkflowSnapshotFactory-CZolnGy5.js +0 -101
  113. package/dist/PersistedWorkflowSnapshotFactory-CZolnGy5.js.map +0 -1
  114. package/dist/PersistedWorkflowSnapshotFactory-Ca_oysOv.cjs +0 -131
  115. package/dist/PersistedWorkflowSnapshotFactory-Ca_oysOv.cjs.map +0 -1
  116. package/dist/PersistedWorkflowSnapshotFactory-CqIcShnX.js +0 -103
  117. package/dist/PersistedWorkflowSnapshotFactory-CqIcShnX.js.map +0 -1
  118. package/dist/PersistedWorkflowSnapshotFactory-D-tBk4_G.js +0 -119
  119. package/dist/PersistedWorkflowSnapshotFactory-D-tBk4_G.js.map +0 -1
  120. package/dist/PersistedWorkflowSnapshotFactory-D4cXl2e2.cjs +0 -131
  121. package/dist/PersistedWorkflowSnapshotFactory-D4cXl2e2.cjs.map +0 -1
  122. package/dist/PersistedWorkflowSnapshotFactory-DINoP12r.cjs +0 -131
  123. package/dist/PersistedWorkflowSnapshotFactory-DINoP12r.cjs.map +0 -1
  124. package/dist/PersistedWorkflowSnapshotFactory-DJAwSuHU.js +0 -103
  125. package/dist/PersistedWorkflowSnapshotFactory-DJAwSuHU.js.map +0 -1
  126. package/dist/PersistedWorkflowSnapshotFactory-DSUjVCcf.cjs +0 -131
  127. package/dist/PersistedWorkflowSnapshotFactory-DSUjVCcf.cjs.map +0 -1
  128. package/dist/PersistedWorkflowSnapshotFactory-DdHuhkDb.cjs +0 -107
  129. package/dist/PersistedWorkflowSnapshotFactory-DdHuhkDb.cjs.map +0 -1
  130. package/dist/PersistedWorkflowSnapshotFactory-Dqc6NHis.js +0 -119
  131. package/dist/PersistedWorkflowSnapshotFactory-Dqc6NHis.js.map +0 -1
  132. package/dist/PersistedWorkflowSnapshotFactory-Dxa2dSrw.cjs +0 -130
  133. package/dist/PersistedWorkflowSnapshotFactory-Dxa2dSrw.cjs.map +0 -1
  134. package/dist/PersistedWorkflowSnapshotFactory-Ep79Ah1G.js +0 -123
  135. package/dist/PersistedWorkflowSnapshotFactory-Ep79Ah1G.js.map +0 -1
  136. package/dist/PersistedWorkflowSnapshotFactory-GyLfRuiJ.js +0 -119
  137. package/dist/PersistedWorkflowSnapshotFactory-GyLfRuiJ.js.map +0 -1
  138. package/dist/PersistedWorkflowSnapshotFactory-HTpBsBzn.js +0 -102
  139. package/dist/PersistedWorkflowSnapshotFactory-HTpBsBzn.js.map +0 -1
  140. package/dist/PersistedWorkflowSnapshotFactory-LVmaaf3t.cjs +0 -141
  141. package/dist/PersistedWorkflowSnapshotFactory-LVmaaf3t.cjs.map +0 -1
  142. package/dist/PersistedWorkflowSnapshotFactory-PZCpo2ZS.js +0 -119
  143. package/dist/PersistedWorkflowSnapshotFactory-PZCpo2ZS.js.map +0 -1
  144. package/dist/PersistedWorkflowSnapshotFactory-UjQ1SJev.cjs +0 -109
  145. package/dist/PersistedWorkflowSnapshotFactory-UjQ1SJev.cjs.map +0 -1
  146. package/dist/PersistedWorkflowSnapshotFactory-Y8kCrhcy.cjs +0 -109
  147. package/dist/PersistedWorkflowSnapshotFactory-Y8kCrhcy.cjs.map +0 -1
  148. package/dist/PersistedWorkflowSnapshotFactory-Z_nB-fmB.cjs +0 -108
  149. package/dist/PersistedWorkflowSnapshotFactory-Z_nB-fmB.cjs.map +0 -1
  150. package/dist/RunIntentService-1EE6N8ZL.cjs +0 -963
  151. package/dist/RunIntentService-1EE6N8ZL.cjs.map +0 -1
  152. package/dist/RunIntentService-2ivFmNQh.cjs.map +0 -1
  153. package/dist/RunIntentService-B0sUL5q-.js +0 -761
  154. package/dist/RunIntentService-B0sUL5q-.js.map +0 -1
  155. package/dist/RunIntentService-BFVbsOcg.js.map +0 -1
  156. package/dist/RunIntentService-BsBOwpVN.cjs +0 -1051
  157. package/dist/RunIntentService-BsBOwpVN.cjs.map +0 -1
  158. package/dist/RunIntentService-CSk3ETyn.js +0 -858
  159. package/dist/RunIntentService-CSk3ETyn.js.map +0 -1
  160. package/dist/RunIntentService-Ckn3u3tA.d.cts +0 -326
  161. package/dist/RunIntentService-DEo6GTTo.d.cts +0 -289
  162. package/dist/RunIntentService-DKrGtL0B.js +0 -782
  163. package/dist/RunIntentService-DKrGtL0B.js.map +0 -1
  164. package/dist/RunIntentService-DNOJc1R7.cjs +0 -942
  165. package/dist/RunIntentService-DNOJc1R7.cjs.map +0 -1
  166. package/dist/RunIntentService-Dq3pV53j.d.cts +0 -289
  167. package/dist/WorkflowSnapshotCodec-C3fuuS_R.d.cts +0 -22
  168. package/dist/WorkflowSnapshotCodec-CUudUo6f.js +0 -123
  169. package/dist/WorkflowSnapshotCodec-CUudUo6f.js.map +0 -1
  170. package/dist/WorkflowSnapshotCodec-CuCPQZTc.cjs +0 -129
  171. package/dist/WorkflowSnapshotCodec-CuCPQZTc.cjs.map +0 -1
  172. package/dist/WorkflowSnapshotCodec-DLiXQNvV.d.cts +0 -22
  173. package/dist/WorkflowSnapshotCodec-DNtdrZ7l.d.cts +0 -22
  174. package/dist/credentialTypes-B5h3dI7r.d.cts +0 -1107
  175. package/dist/credentialTypes-B9okPCVo.d.cts +0 -963
  176. package/dist/credentialTypes-BFL70rgZ.d.cts +0 -964
  177. package/dist/credentialTypes-BGkh1O07.d.ts +0 -1010
  178. package/dist/credentialTypes-BNLi4Q7u.d.ts +0 -1030
  179. package/dist/credentialTypes-CeSoZGj3.d.cts +0 -994
  180. package/dist/credentialTypes-CpHc32Ig.d.cts +0 -984
  181. package/dist/credentialTypes-D0m7MQQl.d.cts +0 -1107
  182. package/dist/credentialTypes-D4nL2sUd.d.ts +0 -1000
  183. package/dist/credentialTypes-DBYK2Qbu.d.ts +0 -999
  184. package/dist/credentialTypes-DMJVy0r1.d.ts +0 -1000
  185. package/dist/credentialTypes-DhUAjYQp.d.ts +0 -1020
  186. package/dist/credentialTypes-gGITj5KL.d.cts +0 -964
  187. package/dist/credentialTypes-r3KVBJBE.d.cts +0 -974
  188. package/dist/diTokens-ClO27tjK.cjs +0 -34
  189. package/dist/diTokens-ClO27tjK.cjs.map +0 -1
  190. package/dist/diTokens-CoHBkwG6.js +0 -28
  191. package/dist/diTokens-CoHBkwG6.js.map +0 -1
  192. package/dist/index-6Doxmfnd.d.ts +0 -857
  193. package/dist/index-AZ72Ej-K.d.ts +0 -920
  194. package/dist/index-BEk9V-q-.d.ts +0 -667
  195. package/dist/index-Bjt7_7oS.d.ts +0 -1192
  196. package/dist/index-CFGxsYXy.d.ts +0 -708
  197. package/dist/index-C_u8xFgn.d.ts +0 -690
  198. package/dist/index-CpbfsvOJ.d.ts +0 -1192
  199. package/dist/index-CsReNJN_.d.ts +0 -859
  200. package/dist/index-D5iNnXaW.d.ts +0 -667
  201. package/dist/index-DD_Eft1q.d.ts +0 -708
  202. package/dist/index-DiSYUe0G.d.ts +0 -1192
  203. package/dist/index-gIcH60sp.d.ts +0 -674
  204. package/dist/runtime-BIvd-1JA.cjs +0 -4112
  205. package/dist/runtime-BIvd-1JA.cjs.map +0 -1
  206. package/dist/runtime-D3eWKSQK.cjs +0 -3986
  207. package/dist/runtime-D3eWKSQK.cjs.map +0 -1
  208. package/dist/runtime-Dvp4xAjg.js +0 -3799
  209. package/dist/runtime-Dvp4xAjg.js.map +0 -1
  210. package/dist/runtime-vc76SSAa.js +0 -3685
  211. package/dist/runtime-vc76SSAa.js.map +0 -1
  212. package/dist/runtimeTypes-BK0b8SaG.d.cts +0 -884
  213. package/dist/runtimeTypes-CoYZkYQq.d.cts +0 -851
  214. package/dist/runtimeTypes-D-Pm0Uas.d.cts +0 -849
  215. package/dist/types-Cb5UK7Y6.d.ts +0 -857
@@ -1,1300 +0,0 @@
1
- import "reflect-metadata";
2
- import { DependencyContainer, DependencyContainer as Container, Disposable, InjectionToken, InjectionToken as TypeToken, Lifecycle, RegistrationOptions, container, delay, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, predicateAwareClassFactory, registry, singleton } from "tsyringe";
3
- import { ReadableStream } from "node:stream/web";
4
-
5
- //#region src/contracts/retryPolicySpec.types.d.ts
6
-
7
- /**
8
- * In-process retry policy for runnable nodes. Serialized configs use the same
9
- * `kind` discriminator (`JSON.stringify` / persisted workflows).
10
- *
11
- * `maxAttempts` is the total number of tries including the first (e.g. 3 means up to 2 delays after failures).
12
- */
13
- type RetryPolicySpec = NoneRetryPolicySpec | FixedRetryPolicySpec | ExponentialRetryPolicySpec;
14
- interface NoneRetryPolicySpec {
15
- readonly kind: "none";
16
- }
17
- interface FixedRetryPolicySpec {
18
- readonly kind: "fixed";
19
- /** Total attempts including the first execution. Must be >= 1. */
20
- readonly maxAttempts: number;
21
- readonly delayMs: number;
22
- }
23
- interface ExponentialRetryPolicySpec {
24
- readonly kind: "exponential";
25
- /** Total attempts including the first execution. Must be >= 1. */
26
- readonly maxAttempts: number;
27
- readonly initialDelayMs: number;
28
- readonly multiplier: number;
29
- readonly maxDelayMs?: number;
30
- /** When true, each delay is multiplied by a random factor in [1, 1.2). */
31
- readonly jitter?: boolean;
32
- }
33
- //#endregion
34
- //#region src/contracts/NoRetryPolicy.d.ts
35
- declare class NoRetryPolicy implements NoneRetryPolicySpec {
36
- readonly kind: "none";
37
- }
38
- //#endregion
39
- //#region src/contracts/RetryPolicy.d.ts
40
- declare class RetryPolicy implements FixedRetryPolicySpec {
41
- readonly maxAttempts: number;
42
- readonly delayMs: number;
43
- readonly kind: "fixed";
44
- constructor(maxAttempts: number, delayMs: number);
45
- /** Default for HTTP-style transient failures: 3 tries, 1s between attempts. */
46
- static readonly defaultForHttp: FixedRetryPolicySpec;
47
- /** Default for LLM / agent calls: 3 tries, 2s fixed backoff. */
48
- static readonly defaultForAiAgent: FixedRetryPolicySpec;
49
- }
50
- //#endregion
51
- //#region src/contracts/ExpRetryPolicy.d.ts
52
- declare class ExpRetryPolicy implements ExponentialRetryPolicySpec {
53
- readonly maxAttempts: number;
54
- readonly initialDelayMs: number;
55
- readonly multiplier: number;
56
- readonly maxDelayMs?: number | undefined;
57
- readonly jitter?: boolean | undefined;
58
- readonly kind: "exponential";
59
- constructor(maxAttempts: number, initialDelayMs: number, multiplier: number, maxDelayMs?: number | undefined, jitter?: boolean | undefined);
60
- }
61
- //#endregion
62
- //#region src/events/runEvents.d.ts
63
- type RunEvent = Readonly<{
64
- kind: "runCreated";
65
- runId: RunId;
66
- workflowId: WorkflowId;
67
- parent?: ParentExecutionRef;
68
- at: string;
69
- }> | Readonly<{
70
- kind: "runSaved";
71
- runId: RunId;
72
- workflowId: WorkflowId;
73
- parent?: ParentExecutionRef;
74
- at: string;
75
- state: PersistedRunState;
76
- }> | Readonly<{
77
- kind: "nodeQueued";
78
- runId: RunId;
79
- workflowId: WorkflowId;
80
- parent?: ParentExecutionRef;
81
- at: string;
82
- snapshot: NodeExecutionSnapshot;
83
- }> | Readonly<{
84
- kind: "nodeStarted";
85
- runId: RunId;
86
- workflowId: WorkflowId;
87
- parent?: ParentExecutionRef;
88
- at: string;
89
- snapshot: NodeExecutionSnapshot;
90
- }> | Readonly<{
91
- kind: "nodeCompleted";
92
- runId: RunId;
93
- workflowId: WorkflowId;
94
- parent?: ParentExecutionRef;
95
- at: string;
96
- snapshot: NodeExecutionSnapshot;
97
- }> | Readonly<{
98
- kind: "nodeFailed";
99
- runId: RunId;
100
- workflowId: WorkflowId;
101
- parent?: ParentExecutionRef;
102
- at: string;
103
- snapshot: NodeExecutionSnapshot;
104
- }>;
105
- interface RunEventSubscription {
106
- close(): Promise<void>;
107
- }
108
- interface RunEventBus {
109
- publish(event: RunEvent): Promise<void>;
110
- subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
111
- subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
112
- }
113
- //#endregion
114
- //#region src/contracts/runTypes.d.ts
115
- interface RunExecutionOptions {
116
- /** Run-intent override: force the inline scheduler and bypass node-level offload decisions. */
117
- localOnly?: boolean;
118
- /** Marks runs started from webhook handling so orchestration can apply webhook-specific continuation rules. */
119
- webhook?: boolean;
120
- mode?: "manual" | "debug";
121
- sourceWorkflowId?: WorkflowId;
122
- sourceRunId?: RunId;
123
- derivedFromRunId?: RunId;
124
- isMutable?: boolean;
125
- /** Set by the engine for this run: 0 = root, 1 = first child subworkflow, … */
126
- subworkflowDepth?: number;
127
- /** Effective cap after engine policy merge (successful node completions per run). */
128
- maxNodeActivations?: number;
129
- /** Effective cap after engine policy merge (subworkflow nesting). */
130
- maxSubworkflowDepth?: number;
131
- }
132
- /** Engine-owned counters persisted with the run (worker-safe). */
133
- interface EngineRunCounters {
134
- completedNodeActivations: number;
135
- }
136
- type RunStopCondition = Readonly<{
137
- kind: "workflowCompleted";
138
- }> | Readonly<{
139
- kind: "nodeCompleted";
140
- nodeId: NodeId;
141
- }>;
142
- interface RunStateResetRequest {
143
- clearFromNodeId: NodeId;
144
- }
145
- interface PersistedRunControlState {
146
- stopCondition?: RunStopCondition;
147
- }
148
- interface PersistedWorkflowSnapshotNode {
149
- id: NodeId;
150
- kind: NodeKind;
151
- name?: string;
152
- nodeTokenId: PersistedTokenId;
153
- configTokenId: PersistedTokenId;
154
- tokenName?: string;
155
- configTokenName?: string;
156
- config: unknown;
157
- }
158
- interface PersistedWorkflowSnapshot {
159
- id: WorkflowId;
160
- name: string;
161
- nodes: ReadonlyArray<PersistedWorkflowSnapshotNode>;
162
- edges: ReadonlyArray<Edge>;
163
- /** When the snapshot was built from a live workflow definition that configured a workflow error handler. */
164
- workflowErrorHandlerConfigured?: boolean;
165
- /** Connection metadata for child nodes not in the execution graph (e.g. AI agent attachments). */
166
- connections?: ReadonlyArray<WorkflowNodeConnection>;
167
- }
168
- type PinnedNodeOutputsByPort = Readonly<Record<OutputPortKey, Items>>;
169
- interface PersistedMutableNodeState {
170
- pinnedOutputsByPort?: PinnedNodeOutputsByPort;
171
- lastDebugInput?: Items;
172
- }
173
- interface PersistedMutableRunState {
174
- nodesById: Readonly<Record<NodeId, PersistedMutableNodeState>>;
175
- }
176
- type NodeInputsByPort = Readonly<Record<InputPortKey, Items>>;
177
- interface RunQueueEntry {
178
- nodeId: NodeId;
179
- input: Items;
180
- toInput?: InputPortKey;
181
- batchId?: string;
182
- from?: Readonly<{
183
- nodeId: NodeId;
184
- output: OutputPortKey;
185
- }>;
186
- collect?: Readonly<{
187
- expectedInputs: ReadonlyArray<InputPortKey>;
188
- received: Readonly<Record<InputPortKey, Items>>;
189
- }>;
190
- }
191
- type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
192
- interface NodeExecutionError {
193
- message: string;
194
- name?: string;
195
- stack?: string;
196
- }
197
- interface NodeExecutionSnapshot {
198
- runId: RunId;
199
- workflowId: WorkflowId;
200
- nodeId: NodeId;
201
- activationId?: NodeActivationId;
202
- parent?: ParentExecutionRef;
203
- status: NodeExecutionStatus;
204
- usedPinnedOutput?: boolean;
205
- queuedAt?: string;
206
- startedAt?: string;
207
- finishedAt?: string;
208
- updatedAt: string;
209
- inputsByPort?: NodeInputsByPort;
210
- outputs?: NodeOutputs;
211
- error?: NodeExecutionError;
212
- }
213
- /** Stable id for a single connection invocation row in {@link ConnectionInvocationRecord}. */
214
- type ConnectionInvocationId = string;
215
- /**
216
- * One logical LLM or tool call under an owning workflow node (e.g. AI agent).
217
- * The owning node defines what {@link managedInput} and {@link managedOutput} contain.
218
- */
219
- interface ConnectionInvocationRecord {
220
- readonly invocationId: ConnectionInvocationId;
221
- readonly runId: RunId;
222
- readonly workflowId: WorkflowId;
223
- readonly connectionNodeId: NodeId;
224
- readonly parentAgentNodeId: NodeId;
225
- readonly parentAgentActivationId: NodeActivationId;
226
- readonly status: NodeExecutionStatus;
227
- readonly managedInput?: JsonValue;
228
- readonly managedOutput?: JsonValue;
229
- readonly error?: NodeExecutionError;
230
- readonly queuedAt?: string;
231
- readonly startedAt?: string;
232
- readonly finishedAt?: string;
233
- readonly updatedAt: string;
234
- }
235
- /** Arguments for appending a {@link ConnectionInvocationRecord} (engine fills run/workflow ids and timestamps). */
236
- type ConnectionInvocationAppendArgs = Readonly<{
237
- invocationId: ConnectionInvocationId;
238
- connectionNodeId: NodeId;
239
- parentAgentNodeId: NodeId;
240
- parentAgentActivationId: NodeActivationId;
241
- status: NodeExecutionStatus;
242
- managedInput?: JsonValue;
243
- managedOutput?: JsonValue;
244
- error?: NodeExecutionError;
245
- queuedAt?: string;
246
- startedAt?: string;
247
- finishedAt?: string;
248
- }>;
249
- interface RunCurrentState {
250
- outputsByNode: Record<NodeId, NodeOutputs>;
251
- nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
252
- /** Append-only history of connection-scoped invocations (LLM/tool) for inspector and canvas. */
253
- connectionInvocations?: ReadonlyArray<ConnectionInvocationRecord>;
254
- mutableState?: PersistedMutableRunState;
255
- }
256
- interface CurrentStateExecutionRequest {
257
- workflow: WorkflowDefinition;
258
- items?: Items;
259
- parent?: ParentExecutionRef;
260
- executionOptions?: RunExecutionOptions;
261
- workflowSnapshot?: PersistedWorkflowSnapshot;
262
- mutableState?: PersistedMutableRunState;
263
- currentState?: RunCurrentState;
264
- stopCondition?: RunStopCondition;
265
- reset?: RunStateResetRequest;
266
- }
267
- interface ExecutionFrontierPlan {
268
- rootNodeId?: NodeId;
269
- rootNodeInput?: Items;
270
- queue: RunQueueEntry[];
271
- currentState: RunCurrentState;
272
- stopCondition: RunStopCondition;
273
- satisfiedNodeIds: ReadonlyArray<NodeId>;
274
- skippedNodeIds: ReadonlyArray<NodeId>;
275
- clearedNodeIds: ReadonlyArray<NodeId>;
276
- preservedPinnedNodeIds: ReadonlyArray<NodeId>;
277
- }
278
- type RunStatus = "running" | "pending" | "completed" | "failed";
279
- interface RunSummary {
280
- runId: RunId;
281
- workflowId: WorkflowId;
282
- startedAt: string;
283
- status: RunStatus;
284
- /** ISO timestamp when the run finished (derived from node snapshots or store `updatedAt`); omit while running/pending. */
285
- finishedAt?: string;
286
- parent?: ParentExecutionRef;
287
- executionOptions?: RunExecutionOptions;
288
- }
289
- interface PendingNodeExecution {
290
- runId: RunId;
291
- activationId: NodeActivationId;
292
- workflowId: WorkflowId;
293
- nodeId: NodeId;
294
- itemsIn: number;
295
- inputsByPort: NodeInputsByPort;
296
- receiptId: string;
297
- queue?: string;
298
- batchId?: string;
299
- enqueuedAt: string;
300
- }
301
- interface PersistedRunState {
302
- runId: RunId;
303
- workflowId: WorkflowId;
304
- startedAt: string;
305
- parent?: ParentExecutionRef;
306
- executionOptions?: RunExecutionOptions;
307
- control?: PersistedRunControlState;
308
- workflowSnapshot?: PersistedWorkflowSnapshot;
309
- mutableState?: PersistedMutableRunState;
310
- /** Frozen at createRun from workflow + runtime defaults for prune/storage decisions. */
311
- policySnapshot?: PersistedRunPolicySnapshot;
312
- /** Successful node completions so far (for activation budget). */
313
- engineCounters?: EngineRunCounters;
314
- status: RunStatus;
315
- pending?: PendingNodeExecution;
316
- queue: RunQueueEntry[];
317
- outputsByNode: Record<NodeId, NodeOutputs>;
318
- nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
319
- /** Append-only history of connection invocations (LLM/tool) nested under owning nodes. */
320
- connectionInvocations?: ReadonlyArray<ConnectionInvocationRecord>;
321
- }
322
- interface WorkflowExecutionRepository {
323
- createRun(args: {
324
- runId: RunId;
325
- workflowId: WorkflowId;
326
- startedAt: string;
327
- parent?: ParentExecutionRef;
328
- executionOptions?: RunExecutionOptions;
329
- control?: PersistedRunControlState;
330
- workflowSnapshot?: PersistedWorkflowSnapshot;
331
- mutableState?: PersistedMutableRunState;
332
- policySnapshot?: PersistedRunPolicySnapshot;
333
- engineCounters?: EngineRunCounters;
334
- }): Promise<void>;
335
- load(runId: RunId): Promise<PersistedRunState | undefined>;
336
- save(state: PersistedRunState): Promise<void>;
337
- deleteRun?(runId: RunId): Promise<void>;
338
- }
339
- /** @deprecated Prefer {@link WorkflowExecutionRepository}. */
340
- type RunStateStore = WorkflowExecutionRepository;
341
- interface WorkflowExecutionListingRepository {
342
- listRuns(args?: Readonly<{
343
- workflowId?: WorkflowId;
344
- limit?: number;
345
- }>): Promise<ReadonlyArray<RunSummary>>;
346
- }
347
- /** @deprecated Prefer {@link WorkflowExecutionListingRepository}. */
348
- type RunListingStore = WorkflowExecutionListingRepository;
349
- /** Runs eligible for retention-based pruning (completed or failed, older than cutoff). */
350
- interface RunPruneCandidate {
351
- readonly runId: RunId;
352
- readonly workflowId: WorkflowId;
353
- readonly startedAt: string;
354
- readonly finishedAt: string;
355
- }
356
- interface WorkflowExecutionPruneRepository {
357
- listRunsOlderThan(args: Readonly<{
358
- beforeIso: string;
359
- limit?: number;
360
- }>): Promise<ReadonlyArray<RunPruneCandidate>>;
361
- }
362
- /** @deprecated Prefer {@link WorkflowExecutionPruneRepository}. */
363
- type RunPruneListingStore = WorkflowExecutionPruneRepository;
364
- type RunResult = {
365
- runId: RunId;
366
- workflowId: WorkflowId;
367
- startedAt: string;
368
- status: "completed";
369
- outputs: Items;
370
- } | {
371
- runId: RunId;
372
- workflowId: WorkflowId;
373
- startedAt: string;
374
- status: "pending";
375
- pending: PendingNodeExecution;
376
- } | {
377
- runId: RunId;
378
- workflowId: WorkflowId;
379
- startedAt: string;
380
- status: "failed";
381
- error: {
382
- message: string;
383
- };
384
- };
385
- type WebhookRunResult = Readonly<{
386
- runId: RunId;
387
- workflowId: WorkflowId;
388
- startedAt: string;
389
- runStatus: "pending" | "completed";
390
- response: Items;
391
- }>;
392
- interface PersistedWorkflowTokenRegistryLike {
393
- register(type: TypeToken<unknown>, packageId: string, persistedNameOverride?: string): string;
394
- getTokenId(type: TypeToken<unknown>): string | undefined;
395
- resolve(tokenId: string): TypeToken<unknown> | undefined;
396
- registerFromWorkflows?(workflows: ReadonlyArray<WorkflowDefinition>): void;
397
- }
398
- interface RunCompletionNotifier {
399
- resolveRunCompletion(result: RunResult): void;
400
- resolveWebhookResponse(result: WebhookRunResult): void;
401
- }
402
- interface RunEventPublisherDeps {
403
- eventBus?: RunEventBus;
404
- }
405
- //#endregion
406
- //#region src/contracts/workflowActivationPolicy.d.ts
407
- /**
408
- * Host-controlled policy: when false, trigger {@link TriggerNode} setup is skipped and webhook routes
409
- * for that workflow are not registered (see engine trigger runtime + webhook matcher).
410
- */
411
- interface WorkflowActivationPolicy {
412
- isActive(workflowId: WorkflowId): boolean;
413
- }
414
- /** Default for tests and harnesses: every workflow is treated as active (legacy behavior). */
415
- declare class AllWorkflowsActiveWorkflowActivationPolicy implements WorkflowActivationPolicy {
416
- isActive(_workflowId: WorkflowId): boolean;
417
- }
418
- //#endregion
419
- //#region src/contracts/webhookTypes.d.ts
420
- type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
421
- interface WebhookControlSignal {
422
- readonly __webhookControl: true;
423
- readonly kind: "respondNow" | "respondNowAndContinue";
424
- readonly responseItems: Items;
425
- readonly continueItems?: Items;
426
- }
427
- interface WebhookTriggerRoutingDiagnostics {
428
- warn(message: string): void;
429
- /** Inactive workflows omitted from the webhook route index (optional; host should wire for clarity at boot/reload). */
430
- info?(message: string): void;
431
- }
432
- interface TriggerInstanceId {
433
- workflowId: WorkflowId;
434
- nodeId: NodeId;
435
- }
436
- /** Match for an incoming HTTP request: user-defined URL segment + workflow trigger node. */
437
- interface WebhookInvocationMatch {
438
- /** Same value as the webhook trigger's configured endpoint key (URL segment under the webhook base path). */
439
- endpointPath: string;
440
- workflowId: WorkflowId;
441
- nodeId: NodeId;
442
- methods: ReadonlyArray<HttpMethod>;
443
- parseJsonBody?: (body: unknown) => unknown;
444
- }
445
- /** Result of resolving an HTTP method + endpoint path against the catalog webhook index (404 vs 405 vs match). */
446
- type WebhookTriggerResolution = {
447
- status: "notFound";
448
- } | {
449
- status: "methodNotAllowed";
450
- match: WebhookInvocationMatch;
451
- } | {
452
- status: "ok";
453
- match: WebhookInvocationMatch;
454
- };
455
- /**
456
- * Resolves webhook routes from workflow definitions (catalog-backed index, no registration at trigger setup).
457
- */
458
- interface WebhookTriggerMatcher {
459
- match(args: {
460
- endpointPath: string;
461
- method: HttpMethod;
462
- }): WebhookInvocationMatch | undefined;
463
- lookup(endpointPath: string): WebhookInvocationMatch | undefined;
464
- onEngineWorkflowsLoaded?(): void;
465
- onEngineStopped?(): void;
466
- /** Rebuild route index after activation changes without stopping the engine. */
467
- reloadWebhookRoutes?(): void;
468
- }
469
- //#endregion
470
- //#region src/contracts/runtimeTypes.d.ts
471
- interface WorkflowRunnerService {
472
- runById(args: {
473
- workflowId: WorkflowId;
474
- startAt?: NodeId;
475
- items: Items;
476
- parent?: ParentExecutionRef;
477
- }): Promise<RunResult>;
478
- }
479
- interface WorkflowRunnerResolver {
480
- resolve(): WorkflowRunnerService | undefined;
481
- }
482
- interface WorkflowRepository {
483
- list(): ReadonlyArray<WorkflowDefinition>;
484
- get(workflowId: WorkflowId): WorkflowDefinition | undefined;
485
- }
486
- interface LiveWorkflowRepository extends WorkflowRepository {
487
- setWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
488
- }
489
- /** @deprecated Prefer {@link LiveWorkflowRepository}. */
490
- type WorkflowCatalog = LiveWorkflowRepository;
491
- interface NodeResolver {
492
- resolve<T>(token: TypeToken<T>): T;
493
- getContainer(): Container | undefined;
494
- }
495
- interface NodeExecutionStatePublisher {
496
- markQueued(args: {
497
- nodeId: NodeId;
498
- activationId?: NodeActivationId;
499
- inputsByPort?: NodeInputsByPort;
500
- }): Promise<void>;
501
- markRunning(args: {
502
- nodeId: NodeId;
503
- activationId?: NodeActivationId;
504
- inputsByPort?: NodeInputsByPort;
505
- }): Promise<void>;
506
- markCompleted(args: {
507
- nodeId: NodeId;
508
- activationId?: NodeActivationId;
509
- inputsByPort?: NodeInputsByPort;
510
- outputs?: NodeOutputs;
511
- }): Promise<void>;
512
- markFailed(args: {
513
- nodeId: NodeId;
514
- activationId?: NodeActivationId;
515
- inputsByPort?: NodeInputsByPort;
516
- error: Error;
517
- }): Promise<void>;
518
- appendConnectionInvocation(args: ConnectionInvocationAppendArgs): Promise<void>;
519
- }
520
- type BinaryBody = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array> | Uint8Array | ArrayBuffer;
521
- interface BinaryStorageWriteRequest {
522
- storageKey: string;
523
- body: BinaryBody;
524
- }
525
- interface BinaryStorageWriteResult {
526
- storageKey: string;
527
- size: number;
528
- sha256?: string;
529
- }
530
- interface BinaryStorageReadResult {
531
- body: ReadableStream<Uint8Array>;
532
- size?: number;
533
- }
534
- interface BinaryStorageStatResult {
535
- exists: boolean;
536
- size?: number;
537
- }
538
- interface BinaryStorage {
539
- readonly driverName: string;
540
- write(args: BinaryStorageWriteRequest): Promise<BinaryStorageWriteResult>;
541
- openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
542
- stat(storageKey: string): Promise<BinaryStorageStatResult>;
543
- delete(storageKey: string): Promise<void>;
544
- }
545
- interface BinaryAttachmentCreateRequest {
546
- name: string;
547
- body: BinaryBody;
548
- mimeType: string;
549
- filename?: string;
550
- previewKind?: BinaryAttachment["previewKind"];
551
- }
552
- interface NodeBinaryAttachmentService extends ExecutionBinaryService {
553
- attach(args: BinaryAttachmentCreateRequest): Promise<BinaryAttachment>;
554
- withAttachment<TJson>(item: Item<TJson>, name: string, attachment: BinaryAttachment): Item<TJson>;
555
- }
556
- interface ExecutionBinaryService {
557
- forNode(args: {
558
- nodeId: NodeId;
559
- activationId: NodeActivationId;
560
- }): NodeBinaryAttachmentService;
561
- openReadStream(attachment: BinaryAttachment): Promise<BinaryStorageReadResult | undefined>;
562
- }
563
- interface ExecutionContext {
564
- runId: RunId;
565
- workflowId: WorkflowId;
566
- parent?: ParentExecutionRef;
567
- /** This run's subworkflow depth (0 = root). */
568
- subworkflowDepth: number;
569
- /** Effective activation budget cap for this run (after policy merge). */
570
- engineMaxNodeActivations: number;
571
- /** Effective subworkflow nesting cap for this run (after policy merge). */
572
- engineMaxSubworkflowDepth: number;
573
- now: () => Date;
574
- data: RunDataSnapshot;
575
- nodeState?: NodeExecutionStatePublisher;
576
- binary: ExecutionBinaryService;
577
- getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
578
- }
579
- interface ExecutionContextFactory {
580
- create(args: {
581
- runId: RunId;
582
- workflowId: WorkflowId;
583
- parent?: ParentExecutionRef;
584
- subworkflowDepth: number;
585
- engineMaxNodeActivations: number;
586
- engineMaxSubworkflowDepth: number;
587
- data: RunDataSnapshot;
588
- nodeState?: NodeExecutionStatePublisher;
589
- getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
590
- }): ExecutionContext;
591
- }
592
- interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase> extends ExecutionContext {
593
- nodeId: NodeId;
594
- activationId: NodeActivationId;
595
- config: TConfig;
596
- binary: NodeBinaryAttachmentService;
597
- }
598
- interface TriggerSetupContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
599
- trigger: TriggerInstanceId;
600
- config: TConfig;
601
- previousState: TSetupState$1;
602
- registerCleanup(cleanup: TriggerCleanupHandle): void;
603
- emit(items: Items): Promise<void>;
604
- }
605
- interface TriggerTestItemsContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
606
- trigger: TriggerInstanceId;
607
- nodeId: NodeId;
608
- config: TConfig;
609
- previousState: TSetupState$1;
610
- }
611
- /**
612
- * Trigger setup state is intentionally engine-owned so future ownership and
613
- * leader-election metadata can be coordinated centrally rather than pushed into
614
- * package-level setup code.
615
- */
616
- interface PersistedTriggerSetupState<TState extends JsonValue | undefined = JsonValue | undefined> {
617
- trigger: TriggerInstanceId;
618
- updatedAt: string;
619
- state: TState;
620
- }
621
- interface TriggerSetupStateRepository {
622
- load(trigger: TriggerInstanceId): Promise<PersistedTriggerSetupState | undefined>;
623
- save(state: PersistedTriggerSetupState): Promise<void>;
624
- delete(trigger: TriggerInstanceId): Promise<void>;
625
- }
626
- /** @deprecated Prefer {@link TriggerSetupStateRepository}. */
627
- type TriggerSetupStateStore = TriggerSetupStateRepository;
628
- interface TriggerCleanupHandle {
629
- stop(): Promise<void> | void;
630
- }
631
- interface EngineHost {
632
- credentialSessions: CredentialSessionService;
633
- workflows?: WorkflowRunnerService;
634
- }
635
- interface Node<TConfig extends NodeConfigBase = NodeConfigBase> {
636
- kind: "node";
637
- outputPorts: ReadonlyArray<OutputPortKey>;
638
- execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
639
- }
640
- interface MultiInputNode<TConfig extends NodeConfigBase = NodeConfigBase> {
641
- kind: "node";
642
- outputPorts: ReadonlyArray<OutputPortKey>;
643
- executeMulti(inputsByPort: NodeInputsByPort, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
644
- }
645
- type TriggerSetupStateFor<TConfig extends TriggerNodeConfig<any, any>> = TriggerNodeSetupState<TConfig>;
646
- interface TriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> {
647
- kind: "trigger";
648
- outputPorts: readonly ["main"];
649
- setup(ctx: TriggerSetupContext<TConfig>): Promise<TriggerSetupStateFor<TConfig>>;
650
- execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
651
- }
652
- interface TestableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> extends TriggerNode<TConfig> {
653
- getTestItems(ctx: TriggerTestItemsContext<TConfig>): Promise<Items>;
654
- }
655
- type ExecutableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> = TriggerNode<TConfig>;
656
- interface NodeExecutionRequest {
657
- runId: RunId;
658
- activationId: NodeActivationId;
659
- workflowId: WorkflowId;
660
- nodeId: NodeId;
661
- input: Items;
662
- parent?: ParentExecutionRef;
663
- queue?: string;
664
- executionOptions?: RunExecutionOptions;
665
- }
666
- interface NodeExecutionScheduler {
667
- enqueue(request: NodeExecutionRequest): Promise<{
668
- receiptId: string;
669
- }>;
670
- cancel?(receiptId: string): Promise<void>;
671
- }
672
- type NodeActivationRequestBase = Readonly<{
673
- runId: RunId;
674
- activationId: NodeActivationId;
675
- workflowId: WorkflowId;
676
- nodeId: NodeId;
677
- parent?: ParentExecutionRef;
678
- executionOptions?: RunExecutionOptions;
679
- batchId?: string;
680
- ctx: NodeExecutionContext;
681
- }>;
682
- type NodeActivationRequest = (NodeActivationRequestBase & Readonly<{
683
- kind: "single";
684
- input: Items;
685
- }>) | (NodeActivationRequestBase & Readonly<{
686
- kind: "multi";
687
- inputsByPort: NodeInputsByPort;
688
- }>);
689
- interface NodeActivationReceipt {
690
- receiptId: string;
691
- mode?: "local" | "worker";
692
- queue?: string;
693
- }
694
- interface NodeActivationContinuation {
695
- markNodeRunning(args: {
696
- runId: RunId;
697
- activationId: NodeActivationId;
698
- nodeId: NodeId;
699
- inputsByPort: NodeInputsByPort;
700
- }): Promise<void>;
701
- resumeFromNodeResult(args: {
702
- runId: RunId;
703
- activationId: NodeActivationId;
704
- nodeId: NodeId;
705
- outputs: NodeOutputs;
706
- }): Promise<RunResult>;
707
- resumeFromNodeError(args: {
708
- runId: RunId;
709
- activationId: NodeActivationId;
710
- nodeId: NodeId;
711
- error: Error;
712
- }): Promise<RunResult>;
713
- }
714
- interface NodeActivationScheduler {
715
- setContinuation?(continuation: NodeActivationContinuation): void;
716
- enqueue(request: NodeActivationRequest): Promise<NodeActivationReceipt>;
717
- notifyPendingStatePersisted?(runId: RunId): void;
718
- cancel?(receiptId: string): Promise<void>;
719
- }
720
- interface WorkflowNodeInstanceFactory {
721
- createNodes(workflow: WorkflowDefinition): ReadonlyMap<NodeId, unknown>;
722
- createByType(type: TypeToken<unknown>): unknown;
723
- }
724
- interface NodeExecutor {
725
- execute(request: NodeActivationRequest): Promise<NodeOutputs>;
726
- }
727
- interface WorkflowSnapshotFactory {
728
- create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
729
- }
730
- interface WorkflowSnapshotResolver {
731
- resolve(args: {
732
- workflowId: WorkflowId;
733
- workflowSnapshot?: PersistedWorkflowSnapshot;
734
- }): WorkflowDefinition | undefined;
735
- }
736
- /** Optional host wiring for trigger lifecycle logs (boot skip + activation sync). */
737
- interface TriggerRuntimeDiagnostics {
738
- info(message: string): void;
739
- warn(message: string): void;
740
- }
741
- interface EngineDeps {
742
- credentialSessions: CredentialSessionService;
743
- workflowCatalog: WorkflowCatalog;
744
- workflowRepository: WorkflowRepository;
745
- /** When {@link AllWorkflowsActiveWorkflowActivationPolicy}, all workflows behave as active (tests). */
746
- workflowActivationPolicy: WorkflowActivationPolicy;
747
- nodeResolver: NodeResolver;
748
- triggerSetupStateStore: TriggerSetupStateStore;
749
- webhookTriggerMatcher: WebhookTriggerMatcher;
750
- runIdFactory: RunIdFactory;
751
- activationIdFactory: ActivationIdFactory;
752
- runStore: RunStateStore;
753
- activationScheduler: NodeActivationScheduler;
754
- runDataFactory: RunDataFactory;
755
- executionContextFactory: ExecutionContextFactory;
756
- eventBus?: RunEventBus;
757
- tokenRegistry: PersistedWorkflowTokenRegistryLike;
758
- workflowNodeInstanceFactory: WorkflowNodeInstanceFactory;
759
- /** Defaults for prune/storage snapshot when workflow omits explicit policy fields. */
760
- workflowPolicyRuntimeDefaults?: WorkflowPolicyRuntimeDefaults;
761
- /** When set, logs inactive-workflow skips at boot and trigger start/stop on activation changes. */
762
- triggerRuntimeDiagnostics?: TriggerRuntimeDiagnostics;
763
- }
764
- //#endregion
765
- //#region src/contracts/workflowTypes.d.ts
766
- type WorkflowId = string;
767
- type NodeId = string;
768
- type OutputPortKey = string;
769
- type InputPortKey = string;
770
- type PersistedTokenId = string;
771
- type NodeKind = "trigger" | "node";
772
- type JsonPrimitive = string | number | boolean | null;
773
- interface JsonObject {
774
- readonly [key: string]: JsonValue;
775
- }
776
- type JsonValue = JsonPrimitive | JsonObject | JsonArray;
777
- type JsonArray = ReadonlyArray<JsonValue>;
778
- interface Edge {
779
- from: {
780
- nodeId: NodeId;
781
- output: OutputPortKey;
782
- };
783
- to: {
784
- nodeId: NodeId;
785
- input: InputPortKey;
786
- };
787
- }
788
- type NodeConnectionName = string;
789
- /**
790
- * Named connection from an executable parent node to child nodes that exist in {@link WorkflowDefinition.nodes}
791
- * but are not traversed by the main execution graph.
792
- */
793
- interface WorkflowNodeConnection {
794
- readonly parentNodeId: NodeId;
795
- readonly connectionName: NodeConnectionName;
796
- readonly childNodeIds: ReadonlyArray<NodeId>;
797
- }
798
- interface WorkflowDefinition {
799
- id: WorkflowId;
800
- name: string;
801
- nodes: NodeDefinition[];
802
- edges: Edge[];
803
- /**
804
- * Optional metadata: which nodes are connection-owned children (e.g. AI agent `llm` / `tools` slots).
805
- * When omitted, all nodes in {@link nodes} are treated as executable for topology.
806
- */
807
- readonly connections?: ReadonlyArray<WorkflowNodeConnection>;
808
- /** Directory + file-stem path under a workflow discovery root (for UI grouping only). */
809
- discoveryPathSegments?: readonly string[];
810
- /** Retention for run JSON and binaries (seconds). Host/env may supply defaults when omitted. */
811
- readonly prunePolicy?: WorkflowPrunePolicySpec;
812
- /** Whether to keep run data after completion. Host/env may supply defaults when omitted. */
813
- readonly storagePolicy?: WorkflowStoragePolicySpec;
814
- /** Invoked after a node fails permanently (retries exhausted) and node error handler did not recover. */
815
- readonly workflowErrorHandler?: WorkflowErrorHandlerSpec;
816
- }
817
- interface WorkflowGraph {
818
- next(nodeId: NodeId, output: OutputPortKey): ReadonlyArray<Readonly<{
819
- nodeId: NodeId;
820
- input: InputPortKey;
821
- }>>;
822
- }
823
- interface WorkflowGraphFactory {
824
- create(def: WorkflowDefinition): WorkflowGraph;
825
- }
826
- interface NodeConfigBase {
827
- readonly kind: NodeKind;
828
- readonly type: TypeToken<unknown>;
829
- readonly name?: string;
830
- readonly id?: NodeId;
831
- readonly icon?: string;
832
- readonly execution?: Readonly<{
833
- hint?: "local" | "worker";
834
- queue?: string;
835
- }>;
836
- /** In-process execute retries (runnable nodes). Triggers typically omit this. */
837
- readonly retryPolicy?: RetryPolicySpec;
838
- /** Recover from execute failures; return outputs to continue, or rethrow to fail the node. */
839
- readonly nodeErrorHandler?: NodeErrorHandlerSpec;
840
- /**
841
- * When true, edges carrying zero items on an output port still schedule single-input downstream nodes.
842
- * Decided from the **source** node that produced the (empty) output. Default (false/undefined): empty
843
- * main batches skip downstream execution and propagate the empty path.
844
- */
845
- readonly continueWhenEmptyOutput?: boolean;
846
- getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
847
- }
848
- declare const runnableNodeInputType: unique symbol;
849
- declare const runnableNodeOutputType: unique symbol;
850
- declare const triggerNodeOutputType: unique symbol;
851
- interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> extends NodeConfigBase {
852
- readonly kind: "node";
853
- readonly [runnableNodeInputType]?: TInputJson$1;
854
- readonly [runnableNodeOutputType]?: TOutputJson$1;
855
- }
856
- declare const triggerNodeSetupStateType: unique symbol;
857
- interface TriggerNodeConfig<TOutputJson$1 = unknown, TSetupState$1 extends JsonValue | undefined = undefined> extends NodeConfigBase {
858
- readonly kind: "trigger";
859
- readonly [triggerNodeOutputType]?: TOutputJson$1;
860
- readonly [triggerNodeSetupStateType]?: TSetupState$1;
861
- }
862
- type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;
863
- type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;
864
- type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;
865
- type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;
866
- interface NodeDefinition {
867
- id: NodeId;
868
- kind: NodeKind;
869
- type: TypeToken<unknown>;
870
- name?: string;
871
- config: NodeConfigBase;
872
- }
873
- interface NodeRef {
874
- id: NodeId;
875
- kind: NodeKind;
876
- name?: string;
877
- }
878
- type PairedItemRef = Readonly<{
879
- nodeId: NodeId;
880
- output: OutputPortKey;
881
- itemIndex: number;
882
- }>;
883
- type BinaryPreviewKind = "image" | "audio" | "video" | "download";
884
- type BinaryAttachment = Readonly<{
885
- id: string;
886
- storageKey: string;
887
- mimeType: string;
888
- size: number;
889
- storageDriver: string;
890
- previewKind: BinaryPreviewKind;
891
- createdAt: string;
892
- runId: RunId;
893
- workflowId: WorkflowId;
894
- nodeId: NodeId;
895
- activationId: NodeActivationId;
896
- filename?: string;
897
- sha256?: string;
898
- }>;
899
- type ItemBinary = Readonly<Record<string, BinaryAttachment>>;
900
- type Item<TJson = unknown> = Readonly<{
901
- json: TJson;
902
- binary?: ItemBinary;
903
- meta?: Readonly<Record<string, unknown>>;
904
- paired?: ReadonlyArray<PairedItemRef>;
905
- }>;
906
- type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;
907
- type NodeOutputs = Partial<Record<OutputPortKey, Items>>;
908
- type RunId = string;
909
- type NodeActivationId = string;
910
- interface ParentExecutionRef {
911
- runId: RunId;
912
- workflowId: WorkflowId;
913
- nodeId: NodeId;
914
- /** Subworkflow depth of the **spawning** run (0 = root). Passed when starting a child run. */
915
- subworkflowDepth?: number;
916
- /** Effective max node activations from the parent run (propagated to child policy merge). */
917
- engineMaxNodeActivations?: number;
918
- /** Effective max subworkflow depth from the parent run (propagated to child policy merge). */
919
- engineMaxSubworkflowDepth?: number;
920
- }
921
- interface RunDataSnapshot {
922
- getOutputs(nodeId: NodeId): NodeOutputs | undefined;
923
- getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
924
- getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
925
- }
926
- interface MutableRunData extends RunDataSnapshot {
927
- setOutputs(nodeId: NodeId, outputs: NodeOutputs): void;
928
- dump(): Record<NodeId, NodeOutputs>;
929
- }
930
- interface RunDataFactory {
931
- create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
932
- }
933
- interface RunIdFactory {
934
- makeRunId(): RunId;
935
- }
936
- interface ActivationIdFactory {
937
- makeActivationId(): NodeActivationId;
938
- }
939
- type UpstreamRefPlaceholder = `$${number}`;
940
- declare const branchRef: (index: number) => UpstreamRefPlaceholder;
941
- type ExecutionMode = "local" | "worker";
942
- interface NodeSchedulerDecision {
943
- mode: ExecutionMode;
944
- queue?: string;
945
- }
946
- interface NodeOffloadPolicy {
947
- decide(args: {
948
- workflowId: WorkflowId;
949
- nodeId: NodeId;
950
- config: NodeConfigBase;
951
- }): NodeSchedulerDecision;
952
- }
953
- /** Whether to persist run execution data after the workflow finishes. */
954
- type WorkflowStoragePolicyMode = "ALL" | "SUCCESS" | "ERROR" | "NEVER";
955
- type WorkflowStoragePolicySpec = WorkflowStoragePolicyMode | TypeToken<WorkflowStoragePolicyResolver>;
956
- interface WorkflowStoragePolicyResolver {
957
- shouldPersist(args: WorkflowStoragePolicyDecisionArgs): boolean | Promise<boolean>;
958
- }
959
- interface WorkflowStoragePolicyDecisionArgs {
960
- readonly runId: RunId;
961
- readonly workflowId: WorkflowId;
962
- readonly workflow: WorkflowDefinition;
963
- readonly finalStatus: "completed" | "failed";
964
- readonly startedAt: string;
965
- readonly finishedAt: string;
966
- }
967
- interface WorkflowPrunePolicySpec {
968
- readonly runDataRetentionSeconds?: number;
969
- readonly binaryRetentionSeconds?: number;
970
- }
971
- interface PersistedRunPolicySnapshot {
972
- readonly retentionSeconds?: number;
973
- readonly binaryRetentionSeconds?: number;
974
- readonly storagePolicy: WorkflowStoragePolicyMode;
975
- }
976
- interface WorkflowErrorHandler {
977
- onError(ctx: WorkflowErrorContext): void | Promise<void>;
978
- }
979
- interface WorkflowErrorContext {
980
- readonly runId: RunId;
981
- readonly workflowId: WorkflowId;
982
- readonly workflow: WorkflowDefinition;
983
- readonly failedNodeId: NodeId;
984
- readonly error: Error;
985
- readonly startedAt: string;
986
- readonly finishedAt: string;
987
- }
988
- type WorkflowErrorHandlerSpec = TypeToken<WorkflowErrorHandler> | WorkflowErrorHandler;
989
- interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {
990
- readonly kind: "single" | "multi";
991
- readonly items: Items;
992
- readonly inputsByPort: Readonly<Record<InputPortKey, Items>> | undefined;
993
- readonly ctx: NodeExecutionContext<TConfig>;
994
- readonly error: Error;
995
- }
996
- interface NodeErrorHandler {
997
- handle<TConfig extends NodeConfigBase>(args: NodeErrorHandlerArgs<TConfig>): Promise<NodeOutputs>;
998
- }
999
- type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;
1000
- /** Runtime defaults when workflow omits prune/storage fields (typically from host env). */
1001
- interface WorkflowPolicyRuntimeDefaults {
1002
- readonly retentionSeconds?: number;
1003
- readonly binaryRetentionSeconds?: number;
1004
- readonly storagePolicy?: WorkflowStoragePolicyMode;
1005
- }
1006
- //#endregion
1007
- //#region src/contracts/credentialTypes.d.ts
1008
- type CredentialTypeId = string;
1009
- type CredentialInstanceId = string;
1010
- type CredentialMaterialSourceKind = "db" | "env" | "code";
1011
- type CredentialSetupStatus = "draft" | "ready";
1012
- type CredentialHealthStatus = "unknown" | "healthy" | "failing";
1013
- type CredentialFieldSchema = Readonly<{
1014
- key: string;
1015
- label: string;
1016
- type: "string" | "password" | "textarea" | "json" | "boolean";
1017
- required?: true;
1018
- order?: number;
1019
- placeholder?: string;
1020
- helpText?: string;
1021
- /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
1022
- envVarName?: string;
1023
- /**
1024
- * When set, the dialog shows a copy action for this exact string (e.g. a static OAuth redirect URI
1025
- * pattern or documentation URL). Do not use for secret values.
1026
- */
1027
- copyValue?: string;
1028
- /** Accessible label for the copy control (default: Copy). */
1029
- copyButtonLabel?: string;
1030
- }>;
1031
- type CredentialRequirement = Readonly<{
1032
- slotKey: string;
1033
- label: string;
1034
- acceptedTypes: ReadonlyArray<CredentialTypeId>;
1035
- optional?: true;
1036
- helpText?: string;
1037
- helpUrl?: string;
1038
- }>;
1039
- type CredentialBindingKey = Readonly<{
1040
- workflowId: WorkflowId;
1041
- nodeId: NodeId;
1042
- slotKey: string;
1043
- }>;
1044
- type CredentialBinding = Readonly<{
1045
- key: CredentialBindingKey;
1046
- instanceId: CredentialInstanceId;
1047
- updatedAt: string;
1048
- }>;
1049
- type CredentialHealth = Readonly<{
1050
- status: CredentialHealthStatus;
1051
- message?: string;
1052
- testedAt?: string;
1053
- expiresAt?: string;
1054
- details?: Readonly<Record<string, unknown>>;
1055
- }>;
1056
- type OAuth2ProviderFromPublicConfig = Readonly<{
1057
- authorizeUrlFieldKey: string;
1058
- tokenUrlFieldKey: string;
1059
- userInfoUrlFieldKey?: string;
1060
- }>;
1061
- type CredentialOAuth2AuthDefinition = Readonly<{
1062
- kind: "oauth2";
1063
- providerId: string;
1064
- scopes: ReadonlyArray<string>;
1065
- clientIdFieldKey?: string;
1066
- clientSecretFieldKey?: string;
1067
- } | {
1068
- kind: "oauth2";
1069
- providerFromPublicConfig: OAuth2ProviderFromPublicConfig;
1070
- scopes: ReadonlyArray<string>;
1071
- clientIdFieldKey?: string;
1072
- clientSecretFieldKey?: string;
1073
- }>;
1074
- type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
1075
- type CredentialTypeDefinition = Readonly<{
1076
- typeId: CredentialTypeId;
1077
- displayName: string;
1078
- description?: string;
1079
- publicFields?: ReadonlyArray<CredentialFieldSchema>;
1080
- secretFields?: ReadonlyArray<CredentialFieldSchema>;
1081
- supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
1082
- auth?: CredentialAuthDefinition;
1083
- }>;
1084
- /**
1085
- * JSON-shaped credential field bag (public config, resolved secret material, etc.).
1086
- */
1087
- type CredentialJsonRecord = Readonly<Record<string, unknown>>;
1088
- /**
1089
- * Persisted credential instance with typed `publicConfig`.
1090
- * Hosts may specialize `secretRef` with a stricter union while remaining
1091
- * assignable here for session/test callbacks.
1092
- */
1093
- type CredentialInstanceRecord<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{
1094
- instanceId: CredentialInstanceId;
1095
- typeId: CredentialTypeId;
1096
- displayName: string;
1097
- sourceKind: CredentialMaterialSourceKind;
1098
- publicConfig: TPublicConfig;
1099
- secretRef: CredentialJsonRecord;
1100
- tags: ReadonlyArray<string>;
1101
- setupStatus: CredentialSetupStatus;
1102
- createdAt: string;
1103
- updatedAt: string;
1104
- }>;
1105
- /**
1106
- * Arguments passed to `CredentialType.createSession` and `CredentialType.test`.
1107
- * Declare `TPublicConfig` / `TMaterial` on `CredentialType` so implementations are checked
1108
- * against your credential shapes (similar to `NodeExecutionContext.config` for nodes).
1109
- */
1110
- type CredentialSessionFactoryArgs<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord> = Readonly<{
1111
- instance: CredentialInstanceRecord<TPublicConfig>;
1112
- material: TMaterial;
1113
- publicConfig: TPublicConfig;
1114
- }>;
1115
- type CredentialSessionFactory<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord, TSession = unknown> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<TSession>;
1116
- type CredentialHealthTester<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord> = (args: CredentialSessionFactoryArgs<TPublicConfig, TMaterial>) => Promise<CredentialHealth>;
1117
- /**
1118
- * Full credential type implementation: `definition` (UI/schema), `createSession`, and `test`.
1119
- * Use this at registration and config boundaries; `CredentialTypeDefinition` is only the schema slice.
1120
- */
1121
- type CredentialType<TPublicConfig extends CredentialJsonRecord = CredentialJsonRecord, TMaterial extends CredentialJsonRecord = CredentialJsonRecord, TSession = unknown> = Readonly<{
1122
- definition: CredentialTypeDefinition;
1123
- createSession: CredentialSessionFactory<TPublicConfig, TMaterial, TSession>;
1124
- test: CredentialHealthTester<TPublicConfig, TMaterial>;
1125
- }>;
1126
- /**
1127
- * Credential type with unspecified generics — used for `CodemationConfig.credentialTypes`, the host registry,
1128
- * and anywhere a concrete `CredentialType<YourPublic, YourMaterial, YourSession>` is placed in a heterogeneous list.
1129
- * Using `any` here avoids unsafe `as` casts while keeping typed `satisfies CredentialType<…>` definitions.
1130
- */
1131
- type AnyCredentialType = CredentialType<any, any, unknown>;
1132
- interface CredentialSessionService {
1133
- getSession<TSession = unknown>(args: Readonly<{
1134
- workflowId: WorkflowId;
1135
- nodeId: NodeId;
1136
- slotKey: string;
1137
- }>): Promise<TSession>;
1138
- }
1139
- interface CredentialTypeRegistry {
1140
- listTypes(): ReadonlyArray<CredentialTypeDefinition>;
1141
- getType(typeId: CredentialTypeId): CredentialTypeDefinition | undefined;
1142
- }
1143
- declare class CredentialUnboundError extends Error {
1144
- readonly bindingKey: CredentialBindingKey;
1145
- readonly acceptedTypes: ReadonlyArray<CredentialTypeId>;
1146
- constructor(bindingKey: CredentialBindingKey, acceptedTypes?: ReadonlyArray<CredentialTypeId>);
1147
- private static createMessage;
1148
- }
1149
- //#endregion
1150
- //#region src/contracts/runFinishedAtFactory.d.ts
1151
- type RunFinishedAtSource = Pick<PersistedRunState, "status" | "nodeSnapshotsByNodeId">;
1152
- /** Derives workflow end time from node snapshots for run listings. */
1153
- declare class RunFinishedAtFactory {
1154
- static resolveIso(state: RunFinishedAtSource): string | undefined;
1155
- }
1156
- //#endregion
1157
- //#region src/workflow/dsl/workflowBuilderTypes.d.ts
1158
- type AnyRunnableNodeConfig = RunnableNodeConfig<any, any>;
1159
- type AnyTriggerNodeConfig = TriggerNodeConfig<any>;
1160
- type ValidStepSequence<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TSteps extends readonly [] ? readonly [] : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<TCurrentJson, infer TNextJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? readonly [TFirst, ...ValidStepSequence<TNextJson, TRest>] : never : never : TSteps;
1161
- type StepSequenceOutput<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined> = TSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? TSteps extends readonly [] ? TCurrentJson : TSteps extends readonly [infer TFirst, ...infer TRest] ? TFirst extends RunnableNodeConfig<TCurrentJson, infer TNextJson> ? TRest extends ReadonlyArray<AnyRunnableNodeConfig> ? StepSequenceOutput<TNextJson, TRest> : never : never : TCurrentJson : TCurrentJson;
1162
- type TypesMatch<TLeft, TRight> = [TLeft] extends [TRight] ? ([TRight] extends [TLeft] ? true : false) : false;
1163
- type BranchOutputGuard<TCurrentJson, TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined, TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined> = TypesMatch<StepSequenceOutput<TCurrentJson, TTrueSteps>, StepSequenceOutput<TCurrentJson, TFalseSteps>> extends true ? unknown : never;
1164
- type BranchStepsArg<TCurrentJson, TSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TSteps & ValidStepSequence<TCurrentJson, TSteps>;
1165
- type BranchMoreArgs<TCurrentJson, TFirstStep extends RunnableNodeConfig<TCurrentJson, any>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>> = TRestSteps & ValidStepSequence<RunnableNodeOutputJson<TFirstStep>, TRestSteps>;
1166
- type BooleanWhenOverloads<TCurrentJson, TReturn> = {
1167
- <TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(branch: boolean, steps: BranchStepsArg<TCurrentJson, TSteps>): TReturn;
1168
- <TFirstStep extends RunnableNodeConfig<TCurrentJson, any>, TRestSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(branch: boolean, step: TFirstStep, ...more: BranchMoreArgs<TCurrentJson, TFirstStep, TRestSteps>): TReturn;
1169
- };
1170
- //#endregion
1171
- //#region src/workflow/dsl/WhenBuilder.d.ts
1172
- declare class WhenBuilder<TCurrentJson> {
1173
- private readonly wf;
1174
- private readonly from;
1175
- private readonly branchPort;
1176
- constructor(wf: WorkflowBuilder, from: NodeRef, branchPort: OutputPortKey);
1177
- addBranch<TSteps extends ReadonlyArray<AnyRunnableNodeConfig>>(steps: TSteps & ValidStepSequence<TCurrentJson, TSteps>): this;
1178
- readonly when: BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>>;
1179
- build(): WorkflowDefinition;
1180
- }
1181
- //#endregion
1182
- //#region src/workflow/dsl/ChainCursorResolver.d.ts
1183
- type ChainCursorWhenOverloads<TCurrentJson> = BooleanWhenOverloads<TCurrentJson, WhenBuilder<TCurrentJson>> & {
1184
- <TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined, TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> | undefined>(branches: Readonly<{
1185
- true?: TTrueSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TTrueSteps> : never;
1186
- false?: TFalseSteps extends ReadonlyArray<AnyRunnableNodeConfig> ? BranchStepsArg<TCurrentJson, TFalseSteps> : never;
1187
- }> & BranchOutputGuard<TCurrentJson, TTrueSteps, TFalseSteps>): ChainCursor<StepSequenceOutput<TCurrentJson, TTrueSteps>>;
1188
- };
1189
- declare class ChainCursor<TCurrentJson> {
1190
- private readonly wf;
1191
- private readonly cursor;
1192
- private readonly cursorOutput;
1193
- constructor(wf: WorkflowBuilder, cursor: NodeRef, cursorOutput: OutputPortKey);
1194
- then<TConfig extends RunnableNodeConfig<TCurrentJson, any>>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
1195
- readonly when: ChainCursorWhenOverloads<TCurrentJson>;
1196
- build(): WorkflowDefinition;
1197
- }
1198
- //#endregion
1199
- //#region src/workflow/dsl/WorkflowBuilder.d.ts
1200
- declare class WorkflowBuilder {
1201
- private readonly meta;
1202
- private readonly options?;
1203
- private readonly nodes;
1204
- private readonly edges;
1205
- private seq;
1206
- constructor(meta: {
1207
- id: WorkflowId;
1208
- name: string;
1209
- }, options?: Readonly<{
1210
- makeMergeNode?: (name: string) => AnyRunnableNodeConfig;
1211
- }> | undefined);
1212
- private add;
1213
- private connect;
1214
- trigger<TConfig extends AnyTriggerNodeConfig>(config: TConfig): ChainCursor<TriggerNodeOutputJson<TConfig>>;
1215
- start<TConfig extends AnyRunnableNodeConfig>(config: TConfig): ChainCursor<RunnableNodeOutputJson<TConfig>>;
1216
- build(): WorkflowDefinition;
1217
- }
1218
- //#endregion
1219
- //#region src/workflow/definition/ConnectionInvocationIdFactory.d.ts
1220
- /**
1221
- * Unique ids for persisted connection invocation history rows (LLM/tool calls under an owning node).
1222
- */
1223
- declare class ConnectionInvocationIdFactory {
1224
- static create(): string;
1225
- /** Deterministic id for tests when a stable sequence is needed. */
1226
- static createForTest(runId: string, connectionNodeId: NodeId, sequence: number): string;
1227
- }
1228
- //#endregion
1229
- //#region src/workflow/definition/ConnectionNodeIdFactory.d.ts
1230
- /**
1231
- * Deterministic ids for workflow connection-owned child nodes (LLM slot, tools, etc.).
1232
- * These are stable across loads.
1233
- */
1234
- declare class ConnectionNodeIdFactory {
1235
- static readonly connectionSegment: "__conn__";
1236
- static languageModelConnectionNodeId(parentNodeId: NodeId): NodeId;
1237
- static toolConnectionNodeId(parentNodeId: NodeId, toolName: string): NodeId;
1238
- static isLanguageModelConnectionNodeId(nodeId: NodeId): boolean;
1239
- static isToolConnectionNodeId(nodeId: NodeId): boolean;
1240
- /** True when `nodeId` is a connection-owned child of `parentNodeId` (LLM or tool slot). */
1241
- static isConnectionOwnedDescendantOf(parentNodeId: NodeId, nodeId: NodeId): boolean;
1242
- /** Normalizes a tool display name to a stable id segment. */
1243
- static normalizeToolName(toolName: string): string;
1244
- }
1245
- //#endregion
1246
- //#region src/workflow/definition/WorkflowExecutableNodeClassifier.d.ts
1247
- /**
1248
- * Derives which workflow nodes participate in the main execution graph vs connection-only children.
1249
- */
1250
- declare class WorkflowExecutableNodeClassifier {
1251
- private readonly connectionOwnedIds;
1252
- constructor(workflow: WorkflowDefinition);
1253
- isConnectionOwnedNodeId(nodeId: NodeId): boolean;
1254
- isExecutableNodeId(nodeId: NodeId): boolean;
1255
- filterExecutableNodeDefinitions(nodes: ReadonlyArray<NodeDefinition>): ReadonlyArray<NodeDefinition>;
1256
- private collectConnectionOwnedIds;
1257
- /**
1258
- * Resolves the default start node: first trigger, else first executable node with no incoming edges from executable nodes.
1259
- */
1260
- findDefaultExecutableStartNodeId(workflow: WorkflowDefinition): NodeId;
1261
- firstExecutableNodeIdInDefinitionOrder(workflow: WorkflowDefinition): NodeId | undefined;
1262
- lastExecutableNodeIdInDefinitionOrder(workflow: WorkflowDefinition): NodeId;
1263
- }
1264
- //#endregion
1265
- //#region src/workflow/definition/WorkflowExecutableNodeClassifierFactory.d.ts
1266
- declare function createWorkflowExecutableNodeClassifier(workflow: WorkflowDefinition): WorkflowExecutableNodeClassifier;
1267
- //#endregion
1268
- //#region src/workflow/graph/DefaultWorkflowGraphFactory.d.ts
1269
- declare class DefaultWorkflowGraphFactory implements WorkflowGraphFactory {
1270
- create(def: WorkflowDefinition): WorkflowGraph;
1271
- }
1272
- //#endregion
1273
- //#region src/workflowSnapshots/WorkflowSnapshotCodec.d.ts
1274
- declare class WorkflowSnapshotCodec {
1275
- private readonly tokenRegistry;
1276
- constructor(tokenRegistry: PersistedWorkflowTokenRegistryLike);
1277
- create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
1278
- hydrate(snapshotNode: PersistedWorkflowSnapshotNode, liveConfig: NodeConfigBase): NodeConfigBase;
1279
- private serializeConfig;
1280
- private injectTokenIds;
1281
- private mergeValue;
1282
- private mergeNestedValue;
1283
- private restoreNonSerializableProperties;
1284
- private restoreTypeProperty;
1285
- private resolveTokenId;
1286
- private resolveTokenName;
1287
- private asTypeToken;
1288
- private asRecord;
1289
- }
1290
- //#endregion
1291
- //#region src/runtime/InMemoryLiveWorkflowRepository.d.ts
1292
- declare class InMemoryLiveWorkflowRepository implements LiveWorkflowRepository {
1293
- private readonly workflowsById;
1294
- setWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
1295
- list(): ReadonlyArray<WorkflowDefinition>;
1296
- get(workflowId: WorkflowId): WorkflowDefinition | undefined;
1297
- }
1298
- //#endregion
1299
- export { JsonArray as $, ConnectionInvocationId as $n, registry as $r, BinaryBody as $t, CredentialJsonRecord as A, TriggerRuntimeDiagnostics as An, RunSummary as Ar, TriggerNodeOutputJson as At, CredentialTypeId as B, WorkflowRunnerService as Bn, Disposable as Br, WorkflowNodeConnection as Bt, CredentialBindingKey as C, NodeExecutionStatePublisher as Cn, RunPruneListingStore as Cr, RunDataSnapshot as Ct, CredentialHealthTester as D, TestableTriggerNode as Dn, RunStateStore as Dr, RunnableNodeInputJson as Dt, CredentialHealthStatus as E, PersistedTriggerSetupState as En, RunStateResetRequest as Er, RunnableNodeConfig as Et, CredentialSessionFactoryArgs as F, TriggerTestItemsContext as Fn, RunEvent as Fr, WorkflowErrorHandler as Ft, BinaryAttachment as G, WebhookControlSignal as Gn, container as Gr, WorkflowStoragePolicyResolver as Gt, CredentialUnboundError as H, WorkflowSnapshotResolver as Hn, Lifecycle as Hr, WorkflowPrunePolicySpec as Ht, CredentialSessionService as I, WorkflowCatalog as In, RunEventBus as Ir, WorkflowErrorHandlerSpec as It, ExecutionMode as J, WebhookTriggerResolution as Jn, injectAll as Jr, runnableNodeInputType as Jt, BinaryPreviewKind as K, WebhookInvocationMatch as Kn, delay as Kr, WorkflowStoragePolicySpec as Kt, CredentialSetupStatus as L, WorkflowNodeInstanceFactory as Ln, RunEventSubscription as Lr, WorkflowGraph as Lt, CredentialOAuth2AuthDefinition as M, TriggerSetupStateFor as Mn, WorkflowExecutionListingRepository as Mr, UpstreamRefPlaceholder as Mt, CredentialRequirement as N, TriggerSetupStateRepository as Nn, WorkflowExecutionPruneRepository as Nr, WorkflowDefinition as Nt, CredentialInstanceId as O, TriggerCleanupHandle as On, RunStatus as Or, RunnableNodeOutputJson as Ot, CredentialSessionFactory as P, TriggerSetupStateStore as Pn, WorkflowExecutionRepository as Pr, WorkflowErrorContext as Pt, Items as Q, ConnectionInvocationAppendArgs as Qn, predicateAwareClassFactory as Qr, BinaryAttachmentCreateRequest as Qt, CredentialType as R, WorkflowRepository as Rn, Container as Rr, WorkflowGraphFactory as Rt, CredentialBinding as S, NodeExecutionScheduler as Sn, RunPruneCandidate as Sr, RunDataFactory as St, CredentialHealth as T, NodeResolver as Tn, RunResult as Tr, RunIdFactory as Tt, OAuth2ProviderFromPublicConfig as U, HttpMethod as Un, RegistrationOptions as Ur, WorkflowStoragePolicyDecisionArgs as Ut, CredentialTypeRegistry as V, WorkflowSnapshotFactory as Vn, InjectionToken as Vr, WorkflowPolicyRuntimeDefaults as Vt, ActivationIdFactory as W, TriggerInstanceId as Wn, TypeToken as Wr, WorkflowStoragePolicyMode as Wt, Item as X, AllWorkflowsActiveWorkflowActivationPolicy as Xn, instanceCachingFactory as Xr, triggerNodeOutputType as Xt, InputPortKey as Y, WebhookTriggerRoutingDiagnostics as Yn, injectable as Yr, runnableNodeOutputType as Yt, ItemBinary as Z, WorkflowActivationPolicy as Zn, instancePerContainerCachingFactory as Zr, triggerNodeSetupStateType as Zt, StepSequenceOutput as _, NodeActivationRequestBase as _n, RunCompletionNotifier as _r, OutputPortKey as _t, WorkflowExecutableNodeClassifier as a, FixedRetryPolicySpec as ai, EngineDeps as an, NodeExecutionSnapshot as ar, NodeConfigBase as at, AnyCredentialType as b, NodeExecutionContext as bn, RunExecutionOptions as br, PersistedRunPolicySnapshot as bt, WorkflowBuilder as c, ExecutionBinaryService as cn, PendingNodeExecution as cr, NodeErrorHandler as ct, AnyRunnableNodeConfig as d, LiveWorkflowRepository as dn, PersistedRunControlState as dr, NodeId as dt, singleton as ei, BinaryStorage as en, ConnectionInvocationRecord as er, JsonObject as et, AnyTriggerNodeConfig as f, MultiInputNode as fn, PersistedRunState as fr, NodeKind as ft, BranchStepsArg as g, NodeActivationRequest as gn, PinnedNodeOutputsByPort as gr, NodeSchedulerDecision as gt, BranchOutputGuard as h, NodeActivationReceipt as hn, PersistedWorkflowTokenRegistryLike as hr, NodeRef as ht, createWorkflowExecutableNodeClassifier as i, ExponentialRetryPolicySpec as ii, BinaryStorageWriteResult as in, NodeExecutionError as ir, NodeActivationId as it, CredentialMaterialSourceKind as j, TriggerSetupContext as jn, WebhookRunResult as jr, TriggerNodeSetupState as jt, CredentialInstanceRecord as k, TriggerNode as kn, RunStopCondition as kr, TriggerNodeConfig as kt, ChainCursor as l, ExecutionContext as ln, PersistedMutableNodeState as lr, NodeErrorHandlerArgs as lt, BranchMoreArgs as m, NodeActivationContinuation as mn, PersistedWorkflowSnapshotNode as mr, NodeOutputs as mt, WorkflowSnapshotCodec as n, RetryPolicy as ni, BinaryStorageStatResult as nn, EngineRunCounters as nr, JsonValue as nt, ConnectionNodeIdFactory as o, NoneRetryPolicySpec as oi, EngineHost as on, NodeExecutionStatus as or, NodeConnectionName as ot, BooleanWhenOverloads as p, Node as pn, PersistedWorkflowSnapshot as pr, NodeOffloadPolicy as pt, Edge as q, WebhookTriggerMatcher as qn, inject as qr, branchRef as qt, DefaultWorkflowGraphFactory as r, NoRetryPolicy as ri, BinaryStorageWriteRequest as rn, ExecutionFrontierPlan as rr, MutableRunData as rt, ConnectionInvocationIdFactory as s, RetryPolicySpec as si, ExecutableTriggerNode as sn, NodeInputsByPort as sr, NodeDefinition as st, InMemoryLiveWorkflowRepository as t, ExpRetryPolicy as ti, BinaryStorageReadResult as tn, CurrentStateExecutionRequest as tr, JsonPrimitive as tt, WhenBuilder as u, ExecutionContextFactory as un, PersistedMutableRunState as ur, NodeErrorHandlerSpec as ut, ValidStepSequence as v, NodeActivationScheduler as vn, RunCurrentState as vr, PairedItemRef as vt, CredentialFieldSchema as w, NodeExecutor as wn, RunQueueEntry as wr, RunId as wt, CredentialAuthDefinition as x, NodeExecutionRequest as xn, RunListingStore as xr, PersistedTokenId as xt, RunFinishedAtFactory as y, NodeBinaryAttachmentService as yn, RunEventPublisherDeps as yr, ParentExecutionRef as yt, CredentialTypeDefinition as z, WorkflowRunnerResolver as zn, DependencyContainer as zr, WorkflowId as zt };
1300
- //# sourceMappingURL=InMemoryLiveWorkflowRepository-jnv-OnOP.d.ts.map