@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,964 +0,0 @@
1
- import { DependencyContainer, DependencyContainer as Container, Disposable, InjectionToken, InjectionToken as TypeToken, Lifecycle, RegistrationOptions, container, delay, inject, injectAll, injectable, instanceCachingFactory, instancePerContainerCachingFactory, predicateAwareClassFactory, registry, singleton } from "tsyringe";
2
- import { ReadableStream } from "node:stream/web";
3
-
4
- //#region src/contracts/retryPolicySpec.types.d.ts
5
-
6
- /**
7
- * In-process retry policy for runnable nodes. Serialized configs use the same
8
- * `kind` discriminator (`JSON.stringify` / persisted workflows).
9
- *
10
- * `maxAttempts` is the total number of tries including the first (e.g. 3 means up to 2 delays after failures).
11
- */
12
- type RetryPolicySpec = NoneRetryPolicySpec | FixedRetryPolicySpec | ExponentialRetryPolicySpec;
13
- interface NoneRetryPolicySpec {
14
- readonly kind: "none";
15
- }
16
- interface FixedRetryPolicySpec {
17
- readonly kind: "fixed";
18
- /** Total attempts including the first execution. Must be >= 1. */
19
- readonly maxAttempts: number;
20
- readonly delayMs: number;
21
- }
22
- interface ExponentialRetryPolicySpec {
23
- readonly kind: "exponential";
24
- /** Total attempts including the first execution. Must be >= 1. */
25
- readonly maxAttempts: number;
26
- readonly initialDelayMs: number;
27
- readonly multiplier: number;
28
- readonly maxDelayMs?: number;
29
- /** When true, each delay is multiplied by a random factor in [1, 1.2). */
30
- readonly jitter?: boolean;
31
- }
32
- //#endregion
33
- //#region src/contracts/runTypes.d.ts
34
- interface RunExecutionOptions {
35
- localOnly?: boolean;
36
- webhook?: boolean;
37
- mode?: "manual" | "debug";
38
- sourceWorkflowId?: WorkflowId;
39
- sourceRunId?: RunId;
40
- derivedFromRunId?: RunId;
41
- isMutable?: boolean;
42
- }
43
- type RunStopCondition = Readonly<{
44
- kind: "workflowCompleted";
45
- }> | Readonly<{
46
- kind: "nodeCompleted";
47
- nodeId: NodeId;
48
- }>;
49
- interface RunStateResetRequest {
50
- clearFromNodeId: NodeId;
51
- }
52
- interface PersistedRunControlState {
53
- stopCondition?: RunStopCondition;
54
- }
55
- interface PersistedWorkflowSnapshotNode {
56
- id: NodeId;
57
- kind: NodeKind;
58
- name?: string;
59
- nodeTokenId: PersistedTokenId;
60
- configTokenId: PersistedTokenId;
61
- tokenName?: string;
62
- configTokenName?: string;
63
- config: unknown;
64
- }
65
- interface PersistedWorkflowSnapshot {
66
- id: WorkflowId;
67
- name: string;
68
- nodes: ReadonlyArray<PersistedWorkflowSnapshotNode>;
69
- edges: ReadonlyArray<Edge>;
70
- }
71
- type PinnedNodeOutputsByPort = Readonly<Record<OutputPortKey, Items>>;
72
- interface PersistedMutableNodeState {
73
- pinnedOutputsByPort?: PinnedNodeOutputsByPort;
74
- lastDebugInput?: Items;
75
- }
76
- interface PersistedMutableRunState {
77
- nodesById: Readonly<Record<NodeId, PersistedMutableNodeState>>;
78
- }
79
- type NodeInputsByPort = Readonly<Record<InputPortKey, Items>>;
80
- interface RunQueueEntry {
81
- nodeId: NodeId;
82
- input: Items;
83
- toInput?: InputPortKey;
84
- batchId?: string;
85
- from?: Readonly<{
86
- nodeId: NodeId;
87
- output: OutputPortKey;
88
- }>;
89
- collect?: Readonly<{
90
- expectedInputs: ReadonlyArray<InputPortKey>;
91
- received: Readonly<Record<InputPortKey, Items>>;
92
- }>;
93
- }
94
- type NodeExecutionStatus = "pending" | "queued" | "running" | "completed" | "failed" | "skipped";
95
- interface NodeExecutionError {
96
- message: string;
97
- name?: string;
98
- stack?: string;
99
- }
100
- interface NodeExecutionSnapshot {
101
- runId: RunId;
102
- workflowId: WorkflowId;
103
- nodeId: NodeId;
104
- activationId?: NodeActivationId;
105
- parent?: ParentExecutionRef;
106
- status: NodeExecutionStatus;
107
- usedPinnedOutput?: boolean;
108
- queuedAt?: string;
109
- startedAt?: string;
110
- finishedAt?: string;
111
- updatedAt: string;
112
- inputsByPort?: NodeInputsByPort;
113
- outputs?: NodeOutputs;
114
- error?: NodeExecutionError;
115
- }
116
- interface RunCurrentState {
117
- outputsByNode: Record<NodeId, NodeOutputs>;
118
- nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
119
- mutableState?: PersistedMutableRunState;
120
- }
121
- interface CurrentStateExecutionRequest {
122
- workflow: WorkflowDefinition;
123
- items?: Items;
124
- parent?: ParentExecutionRef;
125
- executionOptions?: RunExecutionOptions;
126
- workflowSnapshot?: PersistedWorkflowSnapshot;
127
- mutableState?: PersistedMutableRunState;
128
- currentState?: RunCurrentState;
129
- stopCondition?: RunStopCondition;
130
- reset?: RunStateResetRequest;
131
- }
132
- interface ExecutionFrontierPlan {
133
- rootNodeId?: NodeId;
134
- rootNodeInput?: Items;
135
- queue: RunQueueEntry[];
136
- currentState: RunCurrentState;
137
- stopCondition: RunStopCondition;
138
- satisfiedNodeIds: ReadonlyArray<NodeId>;
139
- skippedNodeIds: ReadonlyArray<NodeId>;
140
- clearedNodeIds: ReadonlyArray<NodeId>;
141
- preservedPinnedNodeIds: ReadonlyArray<NodeId>;
142
- }
143
- type RunStatus = "running" | "pending" | "completed" | "failed";
144
- interface RunSummary {
145
- runId: RunId;
146
- workflowId: WorkflowId;
147
- startedAt: string;
148
- status: RunStatus;
149
- /** ISO timestamp when the run finished (derived from node snapshots or store `updatedAt`); omit while running/pending. */
150
- finishedAt?: string;
151
- parent?: ParentExecutionRef;
152
- executionOptions?: RunExecutionOptions;
153
- }
154
- interface PendingNodeExecution {
155
- runId: RunId;
156
- activationId: NodeActivationId;
157
- workflowId: WorkflowId;
158
- nodeId: NodeId;
159
- itemsIn: number;
160
- inputsByPort: NodeInputsByPort;
161
- receiptId: string;
162
- queue?: string;
163
- batchId?: string;
164
- enqueuedAt: string;
165
- }
166
- interface PersistedRunState {
167
- runId: RunId;
168
- workflowId: WorkflowId;
169
- startedAt: string;
170
- parent?: ParentExecutionRef;
171
- executionOptions?: RunExecutionOptions;
172
- control?: PersistedRunControlState;
173
- workflowSnapshot?: PersistedWorkflowSnapshot;
174
- mutableState?: PersistedMutableRunState;
175
- /** Frozen at createRun from workflow + runtime defaults for prune/storage decisions. */
176
- policySnapshot?: PersistedRunPolicySnapshot;
177
- status: RunStatus;
178
- pending?: PendingNodeExecution;
179
- queue: RunQueueEntry[];
180
- outputsByNode: Record<NodeId, NodeOutputs>;
181
- nodeSnapshotsByNodeId: Record<NodeId, NodeExecutionSnapshot>;
182
- }
183
- interface RunStateStore {
184
- createRun(args: {
185
- runId: RunId;
186
- workflowId: WorkflowId;
187
- startedAt: string;
188
- parent?: ParentExecutionRef;
189
- executionOptions?: RunExecutionOptions;
190
- control?: PersistedRunControlState;
191
- workflowSnapshot?: PersistedWorkflowSnapshot;
192
- mutableState?: PersistedMutableRunState;
193
- policySnapshot?: PersistedRunPolicySnapshot;
194
- }): Promise<void>;
195
- load(runId: RunId): Promise<PersistedRunState | undefined>;
196
- save(state: PersistedRunState): Promise<void>;
197
- deleteRun?(runId: RunId): Promise<void>;
198
- }
199
- interface RunListingStore {
200
- listRuns(args?: Readonly<{
201
- workflowId?: WorkflowId;
202
- limit?: number;
203
- }>): Promise<ReadonlyArray<RunSummary>>;
204
- }
205
- /** Runs eligible for retention-based pruning (completed or failed, older than cutoff). */
206
- interface RunPruneCandidate {
207
- readonly runId: RunId;
208
- readonly workflowId: WorkflowId;
209
- readonly startedAt: string;
210
- readonly finishedAt: string;
211
- }
212
- interface RunPruneListingStore {
213
- listRunsOlderThan(args: Readonly<{
214
- beforeIso: string;
215
- limit?: number;
216
- }>): Promise<ReadonlyArray<RunPruneCandidate>>;
217
- }
218
- type RunResult = {
219
- runId: RunId;
220
- workflowId: WorkflowId;
221
- startedAt: string;
222
- status: "completed";
223
- outputs: Items;
224
- } | {
225
- runId: RunId;
226
- workflowId: WorkflowId;
227
- startedAt: string;
228
- status: "pending";
229
- pending: PendingNodeExecution;
230
- } | {
231
- runId: RunId;
232
- workflowId: WorkflowId;
233
- startedAt: string;
234
- status: "failed";
235
- error: {
236
- message: string;
237
- };
238
- };
239
- type WebhookRunResult = Readonly<{
240
- runId: RunId;
241
- workflowId: WorkflowId;
242
- startedAt: string;
243
- runStatus: "pending" | "completed";
244
- response: Items;
245
- }>;
246
- interface PersistedWorkflowTokenRegistryLike {
247
- register(type: TypeToken<unknown>, packageId: string, persistedNameOverride?: string): string;
248
- getTokenId(type: TypeToken<unknown>): string | undefined;
249
- resolve(tokenId: string): TypeToken<unknown> | undefined;
250
- registerFromWorkflows?(workflows: ReadonlyArray<WorkflowDefinition>): void;
251
- }
252
- interface RunCompletionNotifier {
253
- resolveRunCompletion(result: RunResult): void;
254
- resolveWebhookResponse(result: WebhookRunResult): void;
255
- }
256
- interface RunEventPublisherDeps {
257
- eventBus?: RunEventBus;
258
- }
259
- //#endregion
260
- //#region src/contracts/webhookTypes.d.ts
261
- type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
262
- interface WebhookControlSignal {
263
- readonly __webhookControl: true;
264
- readonly kind: "respondNow" | "respondNowAndContinue";
265
- readonly responseItems: Items;
266
- readonly continueItems?: Items;
267
- }
268
- interface WebhookSpec {
269
- endpointKey: string;
270
- methods: ReadonlyArray<HttpMethod>;
271
- parseJsonBody?: (body: unknown) => unknown;
272
- }
273
- interface WebhookRegistration {
274
- endpointId: string;
275
- methods: ReadonlyArray<HttpMethod>;
276
- path: string;
277
- }
278
- interface TriggerInstanceId {
279
- workflowId: WorkflowId;
280
- nodeId: NodeId;
281
- }
282
- interface WebhookInvocationMatch {
283
- endpointId: string;
284
- workflowId: WorkflowId;
285
- nodeId: NodeId;
286
- methods: ReadonlyArray<HttpMethod>;
287
- parseJsonBody?: (body: unknown) => unknown;
288
- }
289
- interface WebhookTriggerMatcher {
290
- register(args: {
291
- workflowId: WorkflowId;
292
- nodeId: NodeId;
293
- endpointId: string;
294
- methods: ReadonlyArray<HttpMethod>;
295
- parseJsonBody?: (body: unknown) => unknown;
296
- }): void;
297
- clear?(): void;
298
- lookup(endpointId: string): WebhookInvocationMatch | undefined;
299
- match(args: {
300
- endpointId: string;
301
- method: HttpMethod;
302
- }): WebhookInvocationMatch | undefined;
303
- }
304
- //#endregion
305
- //#region src/events/runEvents.d.ts
306
- type RunEvent = Readonly<{
307
- kind: "runCreated";
308
- runId: RunId;
309
- workflowId: WorkflowId;
310
- parent?: ParentExecutionRef;
311
- at: string;
312
- }> | Readonly<{
313
- kind: "runSaved";
314
- runId: RunId;
315
- workflowId: WorkflowId;
316
- parent?: ParentExecutionRef;
317
- at: string;
318
- state: PersistedRunState;
319
- }> | Readonly<{
320
- kind: "nodeQueued";
321
- runId: RunId;
322
- workflowId: WorkflowId;
323
- parent?: ParentExecutionRef;
324
- at: string;
325
- snapshot: NodeExecutionSnapshot;
326
- }> | Readonly<{
327
- kind: "nodeStarted";
328
- runId: RunId;
329
- workflowId: WorkflowId;
330
- parent?: ParentExecutionRef;
331
- at: string;
332
- snapshot: NodeExecutionSnapshot;
333
- }> | Readonly<{
334
- kind: "nodeCompleted";
335
- runId: RunId;
336
- workflowId: WorkflowId;
337
- parent?: ParentExecutionRef;
338
- at: string;
339
- snapshot: NodeExecutionSnapshot;
340
- }> | Readonly<{
341
- kind: "nodeFailed";
342
- runId: RunId;
343
- workflowId: WorkflowId;
344
- parent?: ParentExecutionRef;
345
- at: string;
346
- snapshot: NodeExecutionSnapshot;
347
- }>;
348
- interface RunEventSubscription {
349
- close(): Promise<void>;
350
- }
351
- interface RunEventBus {
352
- publish(event: RunEvent): Promise<void>;
353
- subscribe(onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
354
- subscribeToWorkflow(workflowId: WorkflowId, onEvent: (event: RunEvent) => void): Promise<RunEventSubscription>;
355
- }
356
- //#endregion
357
- //#region src/contracts/runtimeTypes.d.ts
358
- interface WorkflowRunnerService {
359
- runById(args: {
360
- workflowId: WorkflowId;
361
- startAt?: NodeId;
362
- items: Items;
363
- parent?: ParentExecutionRef;
364
- }): Promise<RunResult>;
365
- }
366
- interface WorkflowRunnerResolver {
367
- resolve(): WorkflowRunnerService | undefined;
368
- }
369
- interface WorkflowRepository {
370
- list(): ReadonlyArray<WorkflowDefinition>;
371
- get(workflowId: WorkflowId): WorkflowDefinition | undefined;
372
- }
373
- interface WorkflowCatalog extends WorkflowRepository {
374
- setWorkflows(workflows: ReadonlyArray<WorkflowDefinition>): void;
375
- }
376
- type WorkflowRegistry = WorkflowCatalog;
377
- interface NodeResolver {
378
- resolve<T>(token: TypeToken<T>): T;
379
- getContainer(): Container | undefined;
380
- }
381
- interface WebhookRegistrar {
382
- registerWebhook(spec: {
383
- workflowId: WorkflowId;
384
- nodeId: NodeId;
385
- endpointKey: string;
386
- methods: ReadonlyArray<HttpMethod>;
387
- parseJsonBody?: (body: unknown) => unknown;
388
- basePath: string;
389
- }): WebhookRegistration;
390
- clear?(): Promise<void> | void;
391
- }
392
- interface NodeActivationObserver {
393
- onNodeActivation(stats: NodeActivationStats): void;
394
- }
395
- interface NodeExecutionStatePublisher {
396
- markQueued(args: {
397
- nodeId: NodeId;
398
- activationId?: NodeActivationId;
399
- inputsByPort?: NodeInputsByPort;
400
- }): Promise<void>;
401
- markRunning(args: {
402
- nodeId: NodeId;
403
- activationId?: NodeActivationId;
404
- inputsByPort?: NodeInputsByPort;
405
- }): Promise<void>;
406
- markCompleted(args: {
407
- nodeId: NodeId;
408
- activationId?: NodeActivationId;
409
- inputsByPort?: NodeInputsByPort;
410
- outputs?: NodeOutputs;
411
- }): Promise<void>;
412
- markFailed(args: {
413
- nodeId: NodeId;
414
- activationId?: NodeActivationId;
415
- inputsByPort?: NodeInputsByPort;
416
- error: Error;
417
- }): Promise<void>;
418
- }
419
- type BinaryBody = ReadableStream<Uint8Array> | AsyncIterable<Uint8Array> | Uint8Array | ArrayBuffer;
420
- interface BinaryStorageWriteRequest {
421
- storageKey: string;
422
- body: BinaryBody;
423
- }
424
- interface BinaryStorageWriteResult {
425
- storageKey: string;
426
- size: number;
427
- sha256?: string;
428
- }
429
- interface BinaryStorageReadResult {
430
- body: ReadableStream<Uint8Array>;
431
- size?: number;
432
- }
433
- interface BinaryStorageStatResult {
434
- exists: boolean;
435
- size?: number;
436
- }
437
- interface BinaryStorage {
438
- readonly driverName: string;
439
- write(args: BinaryStorageWriteRequest): Promise<BinaryStorageWriteResult>;
440
- openReadStream(storageKey: string): Promise<BinaryStorageReadResult | undefined>;
441
- stat(storageKey: string): Promise<BinaryStorageStatResult>;
442
- delete(storageKey: string): Promise<void>;
443
- }
444
- interface BinaryAttachmentCreateRequest {
445
- name: string;
446
- body: BinaryBody;
447
- mimeType: string;
448
- filename?: string;
449
- previewKind?: BinaryAttachment["previewKind"];
450
- }
451
- interface NodeBinaryAttachmentService extends ExecutionBinaryService {
452
- attach(args: BinaryAttachmentCreateRequest): Promise<BinaryAttachment>;
453
- withAttachment<TJson>(item: Item<TJson>, name: string, attachment: BinaryAttachment): Item<TJson>;
454
- }
455
- interface ExecutionBinaryService {
456
- forNode(args: {
457
- nodeId: NodeId;
458
- activationId: NodeActivationId;
459
- }): NodeBinaryAttachmentService;
460
- openReadStream(attachment: BinaryAttachment): Promise<BinaryStorageReadResult | undefined>;
461
- }
462
- interface ExecutionContext {
463
- runId: RunId;
464
- workflowId: WorkflowId;
465
- parent?: ParentExecutionRef;
466
- now: () => Date;
467
- data: RunDataSnapshot;
468
- nodeState?: NodeExecutionStatePublisher;
469
- binary: ExecutionBinaryService;
470
- getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
471
- }
472
- interface ExecutionContextFactory {
473
- create(args: {
474
- runId: RunId;
475
- workflowId: WorkflowId;
476
- parent?: ParentExecutionRef;
477
- data: RunDataSnapshot;
478
- nodeState?: NodeExecutionStatePublisher;
479
- getCredential<TSession = unknown>(slotKey: string): Promise<TSession>;
480
- }): ExecutionContext;
481
- }
482
- interface NodeExecutionContext<TConfig extends NodeConfigBase = NodeConfigBase> extends ExecutionContext {
483
- nodeId: NodeId;
484
- activationId: NodeActivationId;
485
- config: TConfig;
486
- binary: NodeBinaryAttachmentService;
487
- }
488
- interface TriggerSetupContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
489
- trigger: TriggerInstanceId;
490
- config: TConfig;
491
- previousState: TSetupState$1;
492
- registerWebhook(spec: WebhookSpec): WebhookRegistration;
493
- registerCleanup(cleanup: TriggerCleanupHandle): void;
494
- emit(items: Items): Promise<void>;
495
- }
496
- interface TriggerTestItemsContext<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>, TSetupState$1 extends JsonValue | undefined = TriggerNodeSetupState<TConfig>> extends ExecutionContext {
497
- trigger: TriggerInstanceId;
498
- nodeId: NodeId;
499
- config: TConfig;
500
- previousState: TSetupState$1;
501
- }
502
- /**
503
- * Trigger setup state is intentionally engine-owned so future ownership and
504
- * leader-election metadata can be coordinated centrally rather than pushed into
505
- * package-level setup code.
506
- */
507
- interface PersistedTriggerSetupState<TState extends JsonValue | undefined = JsonValue | undefined> {
508
- trigger: TriggerInstanceId;
509
- updatedAt: string;
510
- state: TState;
511
- }
512
- interface TriggerSetupStateStore {
513
- load(trigger: TriggerInstanceId): Promise<PersistedTriggerSetupState | undefined>;
514
- save(state: PersistedTriggerSetupState): Promise<void>;
515
- delete(trigger: TriggerInstanceId): Promise<void>;
516
- }
517
- interface TriggerCleanupHandle {
518
- stop(): Promise<void> | void;
519
- }
520
- interface NodeActivationStats {
521
- activationId: NodeActivationId;
522
- nodeId: NodeId;
523
- itemsIn: number;
524
- itemsOutByPort: Readonly<Record<OutputPortKey, number>>;
525
- }
526
- interface EngineHost {
527
- credentialSessions: CredentialSessionService;
528
- workflows?: WorkflowRunnerService;
529
- registerWebhook(spec: {
530
- workflowId: WorkflowId;
531
- nodeId: NodeId;
532
- endpointKey: string;
533
- methods: ReadonlyArray<HttpMethod>;
534
- parseJsonBody?: (body: unknown) => unknown;
535
- basePath: string;
536
- }): WebhookRegistration;
537
- onNodeActivation(stats: NodeActivationStats): void;
538
- }
539
- interface Node<TConfig extends NodeConfigBase = NodeConfigBase> {
540
- kind: "node";
541
- outputPorts: ReadonlyArray<OutputPortKey>;
542
- execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
543
- }
544
- interface MultiInputNode<TConfig extends NodeConfigBase = NodeConfigBase> {
545
- kind: "node";
546
- outputPorts: ReadonlyArray<OutputPortKey>;
547
- executeMulti(inputsByPort: NodeInputsByPort, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
548
- }
549
- type TriggerSetupStateFor<TConfig extends TriggerNodeConfig<any, any>> = TriggerNodeSetupState<TConfig>;
550
- interface TriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> {
551
- kind: "trigger";
552
- outputPorts: readonly ["main"];
553
- setup(ctx: TriggerSetupContext<TConfig>): Promise<TriggerSetupStateFor<TConfig>>;
554
- execute(items: Items, ctx: NodeExecutionContext<TConfig>): Promise<NodeOutputs>;
555
- }
556
- interface TestableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> extends TriggerNode<TConfig> {
557
- getTestItems(ctx: TriggerTestItemsContext<TConfig>): Promise<Items>;
558
- }
559
- type ExecutableTriggerNode<TConfig extends TriggerNodeConfig<any, any> = TriggerNodeConfig<any, any>> = TriggerNode<TConfig>;
560
- interface NodeExecutionRequest {
561
- runId: RunId;
562
- activationId: NodeActivationId;
563
- workflowId: WorkflowId;
564
- nodeId: NodeId;
565
- input: Items;
566
- parent?: ParentExecutionRef;
567
- queue?: string;
568
- executionOptions?: RunExecutionOptions;
569
- }
570
- interface NodeExecutionScheduler {
571
- enqueue(request: NodeExecutionRequest): Promise<{
572
- receiptId: string;
573
- }>;
574
- cancel?(receiptId: string): Promise<void>;
575
- }
576
- type NodeActivationRequestBase = Readonly<{
577
- runId: RunId;
578
- activationId: NodeActivationId;
579
- workflowId: WorkflowId;
580
- nodeId: NodeId;
581
- parent?: ParentExecutionRef;
582
- executionOptions?: RunExecutionOptions;
583
- batchId?: string;
584
- ctx: NodeExecutionContext;
585
- }>;
586
- type NodeActivationRequest = (NodeActivationRequestBase & Readonly<{
587
- kind: "single";
588
- input: Items;
589
- }>) | (NodeActivationRequestBase & Readonly<{
590
- kind: "multi";
591
- inputsByPort: NodeInputsByPort;
592
- }>);
593
- interface NodeActivationReceipt {
594
- receiptId: string;
595
- mode?: "local" | "worker";
596
- queue?: string;
597
- }
598
- interface NodeActivationContinuation {
599
- markNodeRunning(args: {
600
- runId: RunId;
601
- activationId: NodeActivationId;
602
- nodeId: NodeId;
603
- inputsByPort: NodeInputsByPort;
604
- }): Promise<void>;
605
- resumeFromNodeResult(args: {
606
- runId: RunId;
607
- activationId: NodeActivationId;
608
- nodeId: NodeId;
609
- outputs: NodeOutputs;
610
- }): Promise<RunResult>;
611
- resumeFromNodeError(args: {
612
- runId: RunId;
613
- activationId: NodeActivationId;
614
- nodeId: NodeId;
615
- error: Error;
616
- }): Promise<RunResult>;
617
- }
618
- interface NodeActivationScheduler {
619
- setContinuation?(continuation: NodeActivationContinuation): void;
620
- enqueue(request: NodeActivationRequest): Promise<NodeActivationReceipt>;
621
- notifyPendingStatePersisted?(runId: RunId): void;
622
- cancel?(receiptId: string): Promise<void>;
623
- }
624
- interface WorkflowNodeInstanceFactory {
625
- createNodes(workflow: WorkflowDefinition): ReadonlyMap<NodeId, unknown>;
626
- }
627
- interface WorkflowSnapshotFactory {
628
- create(workflow: WorkflowDefinition): PersistedWorkflowSnapshot;
629
- }
630
- interface WorkflowSnapshotResolver {
631
- resolve(args: {
632
- workflowId: WorkflowId;
633
- workflowSnapshot?: PersistedWorkflowSnapshot;
634
- }): WorkflowDefinition | undefined;
635
- }
636
- interface EngineDeps {
637
- credentialSessions: CredentialSessionService;
638
- workflowRunnerResolver: WorkflowRunnerResolver;
639
- workflowCatalog: WorkflowCatalog;
640
- workflowRepository: WorkflowRepository;
641
- nodeResolver: NodeResolver;
642
- webhookRegistrar: WebhookRegistrar;
643
- triggerSetupStateStore: TriggerSetupStateStore;
644
- webhookTriggerMatcher: WebhookTriggerMatcher;
645
- nodeActivationObserver: NodeActivationObserver;
646
- runIdFactory: RunIdFactory;
647
- activationIdFactory: ActivationIdFactory;
648
- webhookBasePath?: string;
649
- runStore: RunStateStore;
650
- activationScheduler: NodeActivationScheduler;
651
- runDataFactory: RunDataFactory;
652
- executionContextFactory: ExecutionContextFactory;
653
- eventBus?: RunEventBus;
654
- tokenRegistry: PersistedWorkflowTokenRegistryLike;
655
- workflowNodeInstanceFactory: WorkflowNodeInstanceFactory;
656
- /** Defaults for prune/storage snapshot when workflow omits explicit policy fields. */
657
- workflowPolicyRuntimeDefaults?: WorkflowPolicyRuntimeDefaults;
658
- }
659
- //#endregion
660
- //#region src/contracts/workflowTypes.d.ts
661
- type WorkflowId = string;
662
- type NodeId = string;
663
- type OutputPortKey = string;
664
- type InputPortKey = string;
665
- type PersistedTokenId = string;
666
- type NodeKind = "trigger" | "node";
667
- type JsonPrimitive = string | number | boolean | null;
668
- interface JsonObject {
669
- readonly [key: string]: JsonValue;
670
- }
671
- type JsonValue = JsonPrimitive | JsonObject | JsonArray;
672
- type JsonArray = ReadonlyArray<JsonValue>;
673
- interface Edge {
674
- from: {
675
- nodeId: NodeId;
676
- output: OutputPortKey;
677
- };
678
- to: {
679
- nodeId: NodeId;
680
- input: InputPortKey;
681
- };
682
- }
683
- interface WorkflowDefinition {
684
- id: WorkflowId;
685
- name: string;
686
- nodes: NodeDefinition[];
687
- edges: Edge[];
688
- /** Directory + file-stem path under a workflow discovery root (for UI grouping only). */
689
- discoveryPathSegments?: readonly string[];
690
- /** Retention for run JSON and binaries (seconds). Host/env may supply defaults when omitted. */
691
- readonly prunePolicy?: WorkflowPrunePolicySpec;
692
- /** Whether to keep run data after completion. Host/env may supply defaults when omitted. */
693
- readonly storagePolicy?: WorkflowStoragePolicySpec;
694
- /** Invoked after a node fails permanently (retries exhausted) and node error handler did not recover. */
695
- readonly workflowErrorHandler?: WorkflowErrorHandlerSpec;
696
- }
697
- interface WorkflowGraph {
698
- next(nodeId: NodeId, output: OutputPortKey): ReadonlyArray<Readonly<{
699
- nodeId: NodeId;
700
- input: InputPortKey;
701
- }>>;
702
- }
703
- interface WorkflowGraphFactory {
704
- create(def: WorkflowDefinition): WorkflowGraph;
705
- }
706
- interface NodeConfigBase {
707
- readonly kind: NodeKind;
708
- readonly type: TypeToken<unknown>;
709
- readonly name?: string;
710
- readonly id?: NodeId;
711
- readonly icon?: string;
712
- readonly execution?: Readonly<{
713
- hint?: "local" | "worker";
714
- queue?: string;
715
- }>;
716
- /** In-process execute retries (runnable nodes). Triggers typically omit this. */
717
- readonly retryPolicy?: RetryPolicySpec;
718
- /** Recover from execute failures; return outputs to continue, or rethrow to fail the node. */
719
- readonly nodeErrorHandler?: NodeErrorHandlerSpec;
720
- getCredentialRequirements?(): ReadonlyArray<CredentialRequirement>;
721
- }
722
- declare const runnableNodeInputType: unique symbol;
723
- declare const runnableNodeOutputType: unique symbol;
724
- declare const triggerNodeOutputType: unique symbol;
725
- interface RunnableNodeConfig<TInputJson$1 = unknown, TOutputJson$1 = unknown> extends NodeConfigBase {
726
- readonly kind: "node";
727
- readonly [runnableNodeInputType]?: TInputJson$1;
728
- readonly [runnableNodeOutputType]?: TOutputJson$1;
729
- }
730
- declare const triggerNodeSetupStateType: unique symbol;
731
- interface TriggerNodeConfig<TOutputJson$1 = unknown, TSetupState$1 extends JsonValue | undefined = undefined> extends NodeConfigBase {
732
- readonly kind: "trigger";
733
- readonly [triggerNodeOutputType]?: TOutputJson$1;
734
- readonly [triggerNodeSetupStateType]?: TSetupState$1;
735
- }
736
- type RunnableNodeInputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<infer TInputJson, any> ? TInputJson : never;
737
- type RunnableNodeOutputJson<TConfig extends RunnableNodeConfig<any, any>> = TConfig extends RunnableNodeConfig<any, infer TOutputJson> ? TOutputJson : never;
738
- type TriggerNodeOutputJson<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<infer TOutputJson, any> ? TOutputJson : never;
739
- type TriggerNodeSetupState<TConfig extends TriggerNodeConfig<any, any>> = TConfig extends TriggerNodeConfig<any, infer TSetupState> ? TSetupState : never;
740
- interface NodeDefinition {
741
- id: NodeId;
742
- kind: NodeKind;
743
- type: TypeToken<unknown>;
744
- name?: string;
745
- config: NodeConfigBase;
746
- }
747
- interface NodeRef {
748
- id: NodeId;
749
- kind: NodeKind;
750
- name?: string;
751
- }
752
- type PairedItemRef = Readonly<{
753
- nodeId: NodeId;
754
- output: OutputPortKey;
755
- itemIndex: number;
756
- }>;
757
- type BinaryPreviewKind = "image" | "audio" | "video" | "download";
758
- type BinaryAttachment = Readonly<{
759
- id: string;
760
- storageKey: string;
761
- mimeType: string;
762
- size: number;
763
- storageDriver: string;
764
- previewKind: BinaryPreviewKind;
765
- createdAt: string;
766
- runId: RunId;
767
- workflowId: WorkflowId;
768
- nodeId: NodeId;
769
- activationId: NodeActivationId;
770
- filename?: string;
771
- sha256?: string;
772
- }>;
773
- type ItemBinary = Readonly<Record<string, BinaryAttachment>>;
774
- type Item<TJson = unknown> = Readonly<{
775
- json: TJson;
776
- binary?: ItemBinary;
777
- meta?: Readonly<Record<string, unknown>>;
778
- paired?: ReadonlyArray<PairedItemRef>;
779
- }>;
780
- type Items<TJson = unknown> = ReadonlyArray<Item<TJson>>;
781
- type NodeOutputs = Partial<Record<OutputPortKey, Items>>;
782
- type RunId = string;
783
- type NodeActivationId = string;
784
- interface ParentExecutionRef {
785
- runId: RunId;
786
- workflowId: WorkflowId;
787
- nodeId: NodeId;
788
- }
789
- interface RunDataSnapshot {
790
- getOutputs(nodeId: NodeId): NodeOutputs | undefined;
791
- getOutputItems(nodeId: NodeId, output?: OutputPortKey): Items;
792
- getOutputItem(nodeId: NodeId, itemIndex: number, output?: OutputPortKey): Item | undefined;
793
- }
794
- interface MutableRunData extends RunDataSnapshot {
795
- setOutputs(nodeId: NodeId, outputs: NodeOutputs): void;
796
- dump(): Record<NodeId, NodeOutputs>;
797
- }
798
- interface RunDataFactory {
799
- create(initial?: Record<NodeId, NodeOutputs>): MutableRunData;
800
- }
801
- interface RunIdFactory {
802
- makeRunId(): RunId;
803
- }
804
- interface ActivationIdFactory {
805
- makeActivationId(): NodeActivationId;
806
- }
807
- type UpstreamRefPlaceholder = `$${number}`;
808
- declare const branchRef: (index: number) => UpstreamRefPlaceholder;
809
- type ExecutionMode = "local" | "worker";
810
- interface NodeSchedulerDecision {
811
- mode: ExecutionMode;
812
- queue?: string;
813
- }
814
- interface NodeOffloadPolicy {
815
- decide(args: {
816
- workflowId: WorkflowId;
817
- nodeId: NodeId;
818
- config: NodeConfigBase;
819
- }): NodeSchedulerDecision;
820
- }
821
- /** Whether to persist run execution data after the workflow finishes. */
822
- type WorkflowStoragePolicyMode = "ALL" | "SUCCESS" | "ERROR" | "NEVER";
823
- type WorkflowStoragePolicySpec = WorkflowStoragePolicyMode | TypeToken<WorkflowStoragePolicyResolver>;
824
- interface WorkflowStoragePolicyResolver {
825
- shouldPersist(args: WorkflowStoragePolicyDecisionArgs): boolean | Promise<boolean>;
826
- }
827
- interface WorkflowStoragePolicyDecisionArgs {
828
- readonly runId: RunId;
829
- readonly workflowId: WorkflowId;
830
- readonly workflow: WorkflowDefinition;
831
- readonly finalStatus: "completed" | "failed";
832
- readonly startedAt: string;
833
- readonly finishedAt: string;
834
- }
835
- interface WorkflowPrunePolicySpec {
836
- readonly runDataRetentionSeconds?: number;
837
- readonly binaryRetentionSeconds?: number;
838
- }
839
- interface PersistedRunPolicySnapshot {
840
- readonly retentionSeconds?: number;
841
- readonly binaryRetentionSeconds?: number;
842
- readonly storagePolicy: WorkflowStoragePolicyMode;
843
- }
844
- interface WorkflowErrorHandler {
845
- onError(ctx: WorkflowErrorContext): void | Promise<void>;
846
- }
847
- interface WorkflowErrorContext {
848
- readonly runId: RunId;
849
- readonly workflowId: WorkflowId;
850
- readonly workflow: WorkflowDefinition;
851
- readonly failedNodeId: NodeId;
852
- readonly error: Error;
853
- readonly startedAt: string;
854
- readonly finishedAt: string;
855
- }
856
- type WorkflowErrorHandlerSpec = TypeToken<WorkflowErrorHandler> | WorkflowErrorHandler;
857
- interface NodeErrorHandlerArgs<TConfig extends NodeConfigBase = NodeConfigBase> {
858
- readonly kind: "single" | "multi";
859
- readonly items: Items;
860
- readonly inputsByPort: Readonly<Record<InputPortKey, Items>> | undefined;
861
- readonly ctx: NodeExecutionContext<TConfig>;
862
- readonly error: Error;
863
- }
864
- interface NodeErrorHandler {
865
- handle<TConfig extends NodeConfigBase>(args: NodeErrorHandlerArgs<TConfig>): Promise<NodeOutputs>;
866
- }
867
- type NodeErrorHandlerSpec = TypeToken<NodeErrorHandler> | NodeErrorHandler;
868
- /** Runtime defaults when workflow omits prune/storage fields (typically from host env). */
869
- interface WorkflowPolicyRuntimeDefaults {
870
- readonly retentionSeconds?: number;
871
- readonly binaryRetentionSeconds?: number;
872
- readonly storagePolicy?: WorkflowStoragePolicyMode;
873
- }
874
- //#endregion
875
- //#region src/contracts/credentialTypes.d.ts
876
- type CredentialTypeId = string;
877
- type CredentialInstanceId = string;
878
- type CredentialMaterialSourceKind = "db" | "env" | "code";
879
- type CredentialSetupStatus = "draft" | "ready";
880
- type CredentialHealthStatus = "unknown" | "healthy" | "failing";
881
- type CredentialFieldSchema = Readonly<{
882
- key: string;
883
- label: string;
884
- type: "string" | "password" | "textarea" | "json" | "boolean";
885
- required?: true;
886
- order?: number;
887
- placeholder?: string;
888
- helpText?: string;
889
- /** When set, host resolves this field from process.env at runtime; env wins over stored values. */
890
- envVarName?: string;
891
- }>;
892
- type CredentialRequirement = Readonly<{
893
- slotKey: string;
894
- label: string;
895
- acceptedTypes: ReadonlyArray<CredentialTypeId>;
896
- optional?: true;
897
- helpText?: string;
898
- helpUrl?: string;
899
- }>;
900
- type CredentialBindingKey = Readonly<{
901
- workflowId: WorkflowId;
902
- nodeId: NodeId;
903
- slotKey: string;
904
- }>;
905
- type CredentialBinding = Readonly<{
906
- key: CredentialBindingKey;
907
- instanceId: CredentialInstanceId;
908
- updatedAt: string;
909
- }>;
910
- type CredentialHealth = Readonly<{
911
- status: CredentialHealthStatus;
912
- message?: string;
913
- testedAt?: string;
914
- expiresAt?: string;
915
- details?: Readonly<Record<string, unknown>>;
916
- }>;
917
- type OAuth2ProviderFromPublicConfig = Readonly<{
918
- authorizeUrlFieldKey: string;
919
- tokenUrlFieldKey: string;
920
- userInfoUrlFieldKey?: string;
921
- }>;
922
- type CredentialOAuth2AuthDefinition = Readonly<{
923
- kind: "oauth2";
924
- providerId: string;
925
- scopes: ReadonlyArray<string>;
926
- clientIdFieldKey?: string;
927
- clientSecretFieldKey?: string;
928
- } | {
929
- kind: "oauth2";
930
- providerFromPublicConfig: OAuth2ProviderFromPublicConfig;
931
- scopes: ReadonlyArray<string>;
932
- clientIdFieldKey?: string;
933
- clientSecretFieldKey?: string;
934
- }>;
935
- type CredentialAuthDefinition = CredentialOAuth2AuthDefinition;
936
- type CredentialTypeDefinition = Readonly<{
937
- typeId: CredentialTypeId;
938
- displayName: string;
939
- description?: string;
940
- publicFields?: ReadonlyArray<CredentialFieldSchema>;
941
- secretFields?: ReadonlyArray<CredentialFieldSchema>;
942
- supportedSourceKinds?: ReadonlyArray<CredentialMaterialSourceKind>;
943
- auth?: CredentialAuthDefinition;
944
- }>;
945
- interface CredentialSessionService {
946
- getSession<TSession = unknown>(args: Readonly<{
947
- workflowId: WorkflowId;
948
- nodeId: NodeId;
949
- slotKey: string;
950
- }>): Promise<TSession>;
951
- }
952
- interface CredentialTypeRegistry {
953
- listTypes(): ReadonlyArray<CredentialTypeDefinition>;
954
- getType(typeId: CredentialTypeId): CredentialTypeDefinition | undefined;
955
- }
956
- declare class CredentialUnboundError extends Error {
957
- readonly bindingKey: CredentialBindingKey;
958
- readonly acceptedTypes: ReadonlyArray<CredentialTypeId>;
959
- constructor(bindingKey: CredentialBindingKey, acceptedTypes?: ReadonlyArray<CredentialTypeId>);
960
- private static createMessage;
961
- }
962
- //#endregion
963
- export { RunnableNodeConfig as $, RunSummary as $n, TestableTriggerNode as $t, JsonValue as A, NodeInputsByPort as An, BinaryStorageWriteResult as At, NodeOffloadPolicy as B, RunCompletionNotifier as Bn, NodeActivationObserver as Bt, InputPortKey as C, WebhookSpec as Cn, triggerNodeSetupStateType as Ct, JsonArray as D, NodeExecutionError as Dn, BinaryStorageReadResult as Dt, Items as E, ExecutionFrontierPlan as En, BinaryStorage as Et, NodeErrorHandler as F, PersistedRunState as Fn, ExecutionContext as Ft, PairedItemRef as G, RunPruneCandidate as Gn, NodeActivationStats as Gt, NodeRef as H, RunEventPublisherDeps as Hn, NodeActivationRequest as Ht, NodeErrorHandlerArgs as I, PersistedWorkflowSnapshot as In, ExecutionContextFactory as It, PersistedTokenId as J, RunResult as Jn, NodeExecutionRequest as Jt, ParentExecutionRef as K, RunPruneListingStore as Kn, NodeBinaryAttachmentService as Kt, NodeErrorHandlerSpec as L, PersistedWorkflowSnapshotNode as Ln, MultiInputNode as Lt, NodeActivationId as M, PersistedMutableNodeState as Mn, EngineHost as Mt, NodeConfigBase as N, PersistedMutableRunState as Nn, ExecutableTriggerNode as Nt, JsonObject as O, NodeExecutionSnapshot as On, BinaryStorageStatResult as Ot, NodeDefinition as P, PersistedRunControlState as Pn, ExecutionBinaryService as Pt, RunIdFactory as Q, RunStopCondition as Qn, PersistedTriggerSetupState as Qt, NodeId as R, PersistedWorkflowTokenRegistryLike as Rn, Node as Rt, ExecutionMode as S, WebhookRegistration as Sn, triggerNodeOutputType as St, ItemBinary as T, CurrentStateExecutionRequest as Tn, BinaryBody as Tt, NodeSchedulerDecision as U, RunExecutionOptions as Un, NodeActivationRequestBase as Ut, NodeOutputs as V, RunCurrentState as Vn, NodeActivationReceipt as Vt, OutputPortKey as W, RunListingStore as Wn, NodeActivationScheduler as Wt, RunDataSnapshot as X, RunStateStore as Xn, NodeExecutionStatePublisher as Xt, RunDataFactory as Y, RunStateResetRequest as Yn, NodeExecutionScheduler as Yt, RunId as Z, RunStatus as Zn, NodeResolver as Zt, OAuth2ProviderFromPublicConfig as _, RunEventSubscription as _n, instanceCachingFactory as _r, WorkflowStoragePolicyResolver as _t, CredentialHealth as a, TriggerTestItemsContext as an, Container as ar, UpstreamRefPlaceholder as at, BinaryPreviewKind as b, WebhookControlSignal as bn, registry as br, runnableNodeInputType as bt, CredentialMaterialSourceKind as c, WorkflowNodeInstanceFactory as cn, InjectionToken as cr, WorkflowErrorHandler as ct, CredentialSessionService as d, WorkflowRunnerResolver as dn, TypeToken as dr, WorkflowGraphFactory as dt, TriggerCleanupHandle as en, WebhookRunResult as er, RunnableNodeInputJson as et, CredentialSetupStatus as f, WorkflowRunnerService as fn, container as fr, WorkflowId as ft, CredentialUnboundError as g, RunEventBus as gn, injectable as gr, WorkflowStoragePolicyMode as gt, CredentialTypeRegistry as h, RunEvent as hn, injectAll as hr, WorkflowStoragePolicyDecisionArgs as ht, CredentialFieldSchema as i, TriggerSetupStateStore as in, RetryPolicySpec as ir, TriggerNodeSetupState as it, MutableRunData as j, PendingNodeExecution as jn, EngineDeps as jt, JsonPrimitive as k, NodeExecutionStatus as kn, BinaryStorageWriteRequest as kt, CredentialOAuth2AuthDefinition as l, WorkflowRegistry as ln, Lifecycle as lr, WorkflowErrorHandlerSpec as lt, CredentialTypeId as m, WorkflowSnapshotResolver as mn, inject as mr, WorkflowPrunePolicySpec as mt, CredentialBinding as n, TriggerSetupContext as nn, FixedRetryPolicySpec as nr, TriggerNodeConfig as nt, CredentialHealthStatus as o, WebhookRegistrar as on, DependencyContainer as or, WorkflowDefinition as ot, CredentialTypeDefinition as p, WorkflowSnapshotFactory as pn, delay as pr, WorkflowPolicyRuntimeDefaults as pt, PersistedRunPolicySnapshot as q, RunQueueEntry as qn, NodeExecutionContext as qt, CredentialBindingKey as r, TriggerSetupStateFor as rn, NoneRetryPolicySpec as rr, TriggerNodeOutputJson as rt, CredentialInstanceId as s, WorkflowCatalog as sn, Disposable as sr, WorkflowErrorContext as st, CredentialAuthDefinition as t, TriggerNode as tn, ExponentialRetryPolicySpec as tr, RunnableNodeOutputJson as tt, CredentialRequirement as u, WorkflowRepository as un, RegistrationOptions as ur, WorkflowGraph as ut, ActivationIdFactory as v, HttpMethod as vn, instancePerContainerCachingFactory as vr, WorkflowStoragePolicySpec as vt, Item as w, WebhookTriggerMatcher as wn, BinaryAttachmentCreateRequest as wt, Edge as x, WebhookInvocationMatch as xn, singleton as xr, runnableNodeOutputType as xt, BinaryAttachment as y, TriggerInstanceId as yn, predicateAwareClassFactory as yr, branchRef as yt, NodeKind as z, PinnedNodeOutputsByPort as zn, NodeActivationContinuation as zt };
964
- //# sourceMappingURL=credentialTypes-BFL70rgZ.d.cts.map