@db-lyon/flowkit 0.5.2 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.md +55 -0
  2. package/dist/config/schema.d.ts +247 -0
  3. package/dist/config/schema.d.ts.map +1 -1
  4. package/dist/config/schema.js +9 -0
  5. package/dist/config/schema.js.map +1 -1
  6. package/dist/flow/runner.d.ts +55 -0
  7. package/dist/flow/runner.d.ts.map +1 -1
  8. package/dist/flow/runner.js +169 -33
  9. package/dist/flow/runner.js.map +1 -1
  10. package/dist/task/shell-task.d.ts +11 -1
  11. package/dist/task/shell-task.d.ts.map +1 -1
  12. package/dist/task/shell-task.js +103 -16
  13. package/dist/task/shell-task.js.map +1 -1
  14. package/package.json +1 -1
package/dist/config/schema.d.ts CHANGED
@@ -33,6 +33,15 @@ export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
33
33
  retryDelay: z.ZodOptional<z.ZodNumber>;
34
34
  /** Only retry when the error message contains this substring. */
35
35
  retryOn: z.ZodOptional<z.ZodString>;
36
+ /**
37
+ * Conditional execution. A boolean runs/skips the step directly; a string is
38
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
39
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
40
+ * falsy result skips the step without failing the flow.
41
+ */
42
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
43
+ /** If true, a failure of this step is recorded but does not abort the flow. */
44
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
36
45
  }, "strip", z.ZodTypeAny, {
37
46
  options?: Record<string, unknown> | undefined;
38
47
  task?: string | undefined;
@@ -40,6 +49,8 @@ export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
40
49
  retries?: number | undefined;
41
50
  retryDelay?: number | undefined;
42
51
  retryOn?: string | undefined;
52
+ when?: string | boolean | undefined;
53
+ ignore_failure?: boolean | undefined;
43
54
  }, {
44
55
  options?: Record<string, unknown> | undefined;
45
56
  task?: string | undefined;
@@ -47,6 +58,8 @@ export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
47
58
  retries?: number | undefined;
48
59
  retryDelay?: number | undefined;
49
60
  retryOn?: string | undefined;
61
+ when?: string | boolean | undefined;
62
+ ignore_failure?: boolean | undefined;
50
63
  }>, {
51
64
  options?: Record<string, unknown> | undefined;
52
65
  task?: string | undefined;
@@ -54,6 +67,8 @@ export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
54
67
  retries?: number | undefined;
55
68
  retryDelay?: number | undefined;
56
69
  retryOn?: string | undefined;
70
+ when?: string | boolean | undefined;
71
+ ignore_failure?: boolean | undefined;
57
72
  }, {
58
73
  options?: Record<string, unknown> | undefined;
59
74
  task?: string | undefined;
@@ -61,6 +76,8 @@ export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
61
76
  retries?: number | undefined;
62
77
  retryDelay?: number | undefined;
63
78
  retryOn?: string | undefined;
79
+ when?: string | boolean | undefined;
80
+ ignore_failure?: boolean | undefined;
64
81
  }>;
65
82
  export declare const FlowDefinitionSchema: z.ZodObject<{
66
83
  description: z.ZodString;
@@ -74,6 +91,15 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
74
91
  retryDelay: z.ZodOptional<z.ZodNumber>;
75
92
  /** Only retry when the error message contains this substring. */
76
93
  retryOn: z.ZodOptional<z.ZodString>;
94
+ /**
95
+ * Conditional execution. A boolean runs/skips the step directly; a string is
96
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
97
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
98
+ * falsy result skips the step without failing the flow.
99
+ */
100
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
101
+ /** If true, a failure of this step is recorded but does not abort the flow. */
102
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
77
103
  }, "strip", z.ZodTypeAny, {
78
104
  options?: Record<string, unknown> | undefined;
79
105
  task?: string | undefined;
@@ -81,6 +107,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
81
107
  retries?: number | undefined;
82
108
  retryDelay?: number | undefined;
83
109
  retryOn?: string | undefined;
110
+ when?: string | boolean | undefined;
111
+ ignore_failure?: boolean | undefined;
84
112
  }, {
85
113
  options?: Record<string, unknown> | undefined;
86
114
  task?: string | undefined;
@@ -88,6 +116,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
88
116
  retries?: number | undefined;
89
117
  retryDelay?: number | undefined;
90
118
  retryOn?: string | undefined;
119
+ when?: string | boolean | undefined;
120
+ ignore_failure?: boolean | undefined;
91
121
  }>, {
92
122
  options?: Record<string, unknown> | undefined;
93
123
  task?: string | undefined;
@@ -95,6 +125,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
95
125
  retries?: number | undefined;
96
126
  retryDelay?: number | undefined;
97
127
  retryOn?: string | undefined;
128
+ when?: string | boolean | undefined;
129
+ ignore_failure?: boolean | undefined;
98
130
  }, {
99
131
  options?: Record<string, unknown> | undefined;
100
132
  task?: string | undefined;
@@ -102,6 +134,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
102
134
  retries?: number | undefined;
103
135
  retryDelay?: number | undefined;
104
136
  retryOn?: string | undefined;
137
+ when?: string | boolean | undefined;
138
+ ignore_failure?: boolean | undefined;
105
139
  }>>;
106
140
  /** Runs before the first step. Failure fails the flow before steps execute. */
107
141
  on_start: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -114,6 +148,15 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
114
148
  retryDelay: z.ZodOptional<z.ZodNumber>;
115
149
  /** Only retry when the error message contains this substring. */
116
150
  retryOn: z.ZodOptional<z.ZodString>;
151
+ /**
152
+ * Conditional execution. A boolean runs/skips the step directly; a string is
153
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
154
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
155
+ * falsy result skips the step without failing the flow.
156
+ */
157
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
158
+ /** If true, a failure of this step is recorded but does not abort the flow. */
159
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
117
160
  }, "strip", z.ZodTypeAny, {
118
161
  options?: Record<string, unknown> | undefined;
119
162
  task?: string | undefined;
@@ -121,6 +164,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
121
164
  retries?: number | undefined;
122
165
  retryDelay?: number | undefined;
123
166
  retryOn?: string | undefined;
167
+ when?: string | boolean | undefined;
168
+ ignore_failure?: boolean | undefined;
124
169
  }, {
125
170
  options?: Record<string, unknown> | undefined;
126
171
  task?: string | undefined;
@@ -128,6 +173,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
128
173
  retries?: number | undefined;
129
174
  retryDelay?: number | undefined;
130
175
  retryOn?: string | undefined;
176
+ when?: string | boolean | undefined;
177
+ ignore_failure?: boolean | undefined;
131
178
  }>, {
132
179
  options?: Record<string, unknown> | undefined;
133
180
  task?: string | undefined;
@@ -135,6 +182,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
135
182
  retries?: number | undefined;
136
183
  retryDelay?: number | undefined;
137
184
  retryOn?: string | undefined;
185
+ when?: string | boolean | undefined;
186
+ ignore_failure?: boolean | undefined;
138
187
  }, {
139
188
  options?: Record<string, unknown> | undefined;
140
189
  task?: string | undefined;
@@ -142,6 +191,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
142
191
  retries?: number | undefined;
143
192
  retryDelay?: number | undefined;
144
193
  retryOn?: string | undefined;
194
+ when?: string | boolean | undefined;
195
+ ignore_failure?: boolean | undefined;
145
196
  }>, "many">>;
146
197
  /** Runs after all steps succeed. */
147
198
  on_success: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -154,6 +205,15 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
154
205
  retryDelay: z.ZodOptional<z.ZodNumber>;
155
206
  /** Only retry when the error message contains this substring. */
156
207
  retryOn: z.ZodOptional<z.ZodString>;
208
+ /**
209
+ * Conditional execution. A boolean runs/skips the step directly; a string is
210
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
211
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
212
+ * falsy result skips the step without failing the flow.
213
+ */
214
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
215
+ /** If true, a failure of this step is recorded but does not abort the flow. */
216
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
157
217
  }, "strip", z.ZodTypeAny, {
158
218
  options?: Record<string, unknown> | undefined;
159
219
  task?: string | undefined;
@@ -161,6 +221,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
161
221
  retries?: number | undefined;
162
222
  retryDelay?: number | undefined;
163
223
  retryOn?: string | undefined;
224
+ when?: string | boolean | undefined;
225
+ ignore_failure?: boolean | undefined;
164
226
  }, {
165
227
  options?: Record<string, unknown> | undefined;
166
228
  task?: string | undefined;
@@ -168,6 +230,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
168
230
  retries?: number | undefined;
169
231
  retryDelay?: number | undefined;
170
232
  retryOn?: string | undefined;
233
+ when?: string | boolean | undefined;
234
+ ignore_failure?: boolean | undefined;
171
235
  }>, {
172
236
  options?: Record<string, unknown> | undefined;
173
237
  task?: string | undefined;
@@ -175,6 +239,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
175
239
  retries?: number | undefined;
176
240
  retryDelay?: number | undefined;
177
241
  retryOn?: string | undefined;
242
+ when?: string | boolean | undefined;
243
+ ignore_failure?: boolean | undefined;
178
244
  }, {
179
245
  options?: Record<string, unknown> | undefined;
180
246
  task?: string | undefined;
@@ -182,6 +248,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
182
248
  retries?: number | undefined;
183
249
  retryDelay?: number | undefined;
184
250
  retryOn?: string | undefined;
251
+ when?: string | boolean | undefined;
252
+ ignore_failure?: boolean | undefined;
185
253
  }>, "many">>;
186
254
  /** Runs on any step failure. */
187
255
  on_failure: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -194,6 +262,15 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
194
262
  retryDelay: z.ZodOptional<z.ZodNumber>;
195
263
  /** Only retry when the error message contains this substring. */
196
264
  retryOn: z.ZodOptional<z.ZodString>;
265
+ /**
266
+ * Conditional execution. A boolean runs/skips the step directly; a string is
267
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
268
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
269
+ * falsy result skips the step without failing the flow.
270
+ */
271
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
272
+ /** If true, a failure of this step is recorded but does not abort the flow. */
273
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
197
274
  }, "strip", z.ZodTypeAny, {
198
275
  options?: Record<string, unknown> | undefined;
199
276
  task?: string | undefined;
@@ -201,6 +278,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
201
278
  retries?: number | undefined;
202
279
  retryDelay?: number | undefined;
203
280
  retryOn?: string | undefined;
281
+ when?: string | boolean | undefined;
282
+ ignore_failure?: boolean | undefined;
204
283
  }, {
205
284
  options?: Record<string, unknown> | undefined;
206
285
  task?: string | undefined;
@@ -208,6 +287,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
208
287
  retries?: number | undefined;
209
288
  retryDelay?: number | undefined;
210
289
  retryOn?: string | undefined;
290
+ when?: string | boolean | undefined;
291
+ ignore_failure?: boolean | undefined;
211
292
  }>, {
212
293
  options?: Record<string, unknown> | undefined;
213
294
  task?: string | undefined;
@@ -215,6 +296,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
215
296
  retries?: number | undefined;
216
297
  retryDelay?: number | undefined;
217
298
  retryOn?: string | undefined;
299
+ when?: string | boolean | undefined;
300
+ ignore_failure?: boolean | undefined;
218
301
  }, {
219
302
  options?: Record<string, unknown> | undefined;
220
303
  task?: string | undefined;
@@ -222,6 +305,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
222
305
  retries?: number | undefined;
223
306
  retryDelay?: number | undefined;
224
307
  retryOn?: string | undefined;
308
+ when?: string | boolean | undefined;
309
+ ignore_failure?: boolean | undefined;
225
310
  }>, "many">>;
226
311
  /** Runs after success or failure, after on_success/on_failure. */
227
312
  finally: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -234,6 +319,15 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
234
319
  retryDelay: z.ZodOptional<z.ZodNumber>;
235
320
  /** Only retry when the error message contains this substring. */
236
321
  retryOn: z.ZodOptional<z.ZodString>;
322
+ /**
323
+ * Conditional execution. A boolean runs/skips the step directly; a string is
324
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
325
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
326
+ * falsy result skips the step without failing the flow.
327
+ */
328
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
329
+ /** If true, a failure of this step is recorded but does not abort the flow. */
330
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
237
331
  }, "strip", z.ZodTypeAny, {
238
332
  options?: Record<string, unknown> | undefined;
239
333
  task?: string | undefined;
@@ -241,6 +335,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
241
335
  retries?: number | undefined;
242
336
  retryDelay?: number | undefined;
243
337
  retryOn?: string | undefined;
338
+ when?: string | boolean | undefined;
339
+ ignore_failure?: boolean | undefined;
244
340
  }, {
245
341
  options?: Record<string, unknown> | undefined;
246
342
  task?: string | undefined;
@@ -248,6 +344,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
248
344
  retries?: number | undefined;
249
345
  retryDelay?: number | undefined;
250
346
  retryOn?: string | undefined;
347
+ when?: string | boolean | undefined;
348
+ ignore_failure?: boolean | undefined;
251
349
  }>, {
252
350
  options?: Record<string, unknown> | undefined;
253
351
  task?: string | undefined;
@@ -255,6 +353,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
255
353
  retries?: number | undefined;
256
354
  retryDelay?: number | undefined;
257
355
  retryOn?: string | undefined;
356
+ when?: string | boolean | undefined;
357
+ ignore_failure?: boolean | undefined;
258
358
  }, {
259
359
  options?: Record<string, unknown> | undefined;
260
360
  task?: string | undefined;
@@ -262,6 +362,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
262
362
  retries?: number | undefined;
263
363
  retryDelay?: number | undefined;
264
364
  retryOn?: string | undefined;
365
+ when?: string | boolean | undefined;
366
+ ignore_failure?: boolean | undefined;
265
367
  }>, "many">>;
266
368
  /** If true, invoke rollback records from completed steps in reverse order on failure. */
267
369
  rollback_on_failure: z.ZodOptional<z.ZodBoolean>;
@@ -274,6 +376,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
274
376
  retries?: number | undefined;
275
377
  retryDelay?: number | undefined;
276
378
  retryOn?: string | undefined;
379
+ when?: string | boolean | undefined;
380
+ ignore_failure?: boolean | undefined;
277
381
  }>;
278
382
  on_start?: {
279
383
  options?: Record<string, unknown> | undefined;
@@ -282,6 +386,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
282
386
  retries?: number | undefined;
283
387
  retryDelay?: number | undefined;
284
388
  retryOn?: string | undefined;
389
+ when?: string | boolean | undefined;
390
+ ignore_failure?: boolean | undefined;
285
391
  }[] | undefined;
286
392
  on_success?: {
287
393
  options?: Record<string, unknown> | undefined;
@@ -290,6 +396,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
290
396
  retries?: number | undefined;
291
397
  retryDelay?: number | undefined;
292
398
  retryOn?: string | undefined;
399
+ when?: string | boolean | undefined;
400
+ ignore_failure?: boolean | undefined;
293
401
  }[] | undefined;
294
402
  on_failure?: {
295
403
  options?: Record<string, unknown> | undefined;
@@ -298,6 +406,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
298
406
  retries?: number | undefined;
299
407
  retryDelay?: number | undefined;
300
408
  retryOn?: string | undefined;
409
+ when?: string | boolean | undefined;
410
+ ignore_failure?: boolean | undefined;
301
411
  }[] | undefined;
302
412
  finally?: {
303
413
  options?: Record<string, unknown> | undefined;
@@ -306,6 +416,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
306
416
  retries?: number | undefined;
307
417
  retryDelay?: number | undefined;
308
418
  retryOn?: string | undefined;
419
+ when?: string | boolean | undefined;
420
+ ignore_failure?: boolean | undefined;
309
421
  }[] | undefined;
310
422
  rollback_on_failure?: boolean | undefined;
311
423
  }, {
@@ -317,6 +429,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
317
429
  retries?: number | undefined;
318
430
  retryDelay?: number | undefined;
319
431
  retryOn?: string | undefined;
432
+ when?: string | boolean | undefined;
433
+ ignore_failure?: boolean | undefined;
320
434
  }>;
321
435
  on_start?: {
322
436
  options?: Record<string, unknown> | undefined;
@@ -325,6 +439,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
325
439
  retries?: number | undefined;
326
440
  retryDelay?: number | undefined;
327
441
  retryOn?: string | undefined;
442
+ when?: string | boolean | undefined;
443
+ ignore_failure?: boolean | undefined;
328
444
  }[] | undefined;
329
445
  on_success?: {
330
446
  options?: Record<string, unknown> | undefined;
@@ -333,6 +449,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
333
449
  retries?: number | undefined;
334
450
  retryDelay?: number | undefined;
335
451
  retryOn?: string | undefined;
452
+ when?: string | boolean | undefined;
453
+ ignore_failure?: boolean | undefined;
336
454
  }[] | undefined;
337
455
  on_failure?: {
338
456
  options?: Record<string, unknown> | undefined;
@@ -341,6 +459,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
341
459
  retries?: number | undefined;
342
460
  retryDelay?: number | undefined;
343
461
  retryOn?: string | undefined;
462
+ when?: string | boolean | undefined;
463
+ ignore_failure?: boolean | undefined;
344
464
  }[] | undefined;
345
465
  finally?: {
346
466
  options?: Record<string, unknown> | undefined;
@@ -349,6 +469,8 @@ export declare const FlowDefinitionSchema: z.ZodObject<{
349
469
  retries?: number | undefined;
350
470
  retryDelay?: number | undefined;
351
471
  retryOn?: string | undefined;
472
+ when?: string | boolean | undefined;
473
+ ignore_failure?: boolean | undefined;
352
474
  }[] | undefined;
353
475
  rollback_on_failure?: boolean | undefined;
354
476
  }>;
@@ -389,6 +511,15 @@ export declare const EngineConfigSchema: z.ZodObject<{
389
511
  retryDelay: z.ZodOptional<z.ZodNumber>;
390
512
  /** Only retry when the error message contains this substring. */
391
513
  retryOn: z.ZodOptional<z.ZodString>;
514
+ /**
515
+ * Conditional execution. A boolean runs/skips the step directly; a string is
516
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
517
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
518
+ * falsy result skips the step without failing the flow.
519
+ */
520
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
521
+ /** If true, a failure of this step is recorded but does not abort the flow. */
522
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
392
523
  }, "strip", z.ZodTypeAny, {
393
524
  options?: Record<string, unknown> | undefined;
394
525
  task?: string | undefined;
@@ -396,6 +527,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
396
527
  retries?: number | undefined;
397
528
  retryDelay?: number | undefined;
398
529
  retryOn?: string | undefined;
530
+ when?: string | boolean | undefined;
531
+ ignore_failure?: boolean | undefined;
399
532
  }, {
400
533
  options?: Record<string, unknown> | undefined;
401
534
  task?: string | undefined;
@@ -403,6 +536,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
403
536
  retries?: number | undefined;
404
537
  retryDelay?: number | undefined;
405
538
  retryOn?: string | undefined;
539
+ when?: string | boolean | undefined;
540
+ ignore_failure?: boolean | undefined;
406
541
  }>, {
407
542
  options?: Record<string, unknown> | undefined;
408
543
  task?: string | undefined;
@@ -410,6 +545,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
410
545
  retries?: number | undefined;
411
546
  retryDelay?: number | undefined;
412
547
  retryOn?: string | undefined;
548
+ when?: string | boolean | undefined;
549
+ ignore_failure?: boolean | undefined;
413
550
  }, {
414
551
  options?: Record<string, unknown> | undefined;
415
552
  task?: string | undefined;
@@ -417,6 +554,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
417
554
  retries?: number | undefined;
418
555
  retryDelay?: number | undefined;
419
556
  retryOn?: string | undefined;
557
+ when?: string | boolean | undefined;
558
+ ignore_failure?: boolean | undefined;
420
559
  }>>;
421
560
  /** Runs before the first step. Failure fails the flow before steps execute. */
422
561
  on_start: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -429,6 +568,15 @@ export declare const EngineConfigSchema: z.ZodObject<{
429
568
  retryDelay: z.ZodOptional<z.ZodNumber>;
430
569
  /** Only retry when the error message contains this substring. */
431
570
  retryOn: z.ZodOptional<z.ZodString>;
571
+ /**
572
+ * Conditional execution. A boolean runs/skips the step directly; a string is
573
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
574
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
575
+ * falsy result skips the step without failing the flow.
576
+ */
577
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
578
+ /** If true, a failure of this step is recorded but does not abort the flow. */
579
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
432
580
  }, "strip", z.ZodTypeAny, {
433
581
  options?: Record<string, unknown> | undefined;
434
582
  task?: string | undefined;
@@ -436,6 +584,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
436
584
  retries?: number | undefined;
437
585
  retryDelay?: number | undefined;
438
586
  retryOn?: string | undefined;
587
+ when?: string | boolean | undefined;
588
+ ignore_failure?: boolean | undefined;
439
589
  }, {
440
590
  options?: Record<string, unknown> | undefined;
441
591
  task?: string | undefined;
@@ -443,6 +593,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
443
593
  retries?: number | undefined;
444
594
  retryDelay?: number | undefined;
445
595
  retryOn?: string | undefined;
596
+ when?: string | boolean | undefined;
597
+ ignore_failure?: boolean | undefined;
446
598
  }>, {
447
599
  options?: Record<string, unknown> | undefined;
448
600
  task?: string | undefined;
@@ -450,6 +602,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
450
602
  retries?: number | undefined;
451
603
  retryDelay?: number | undefined;
452
604
  retryOn?: string | undefined;
605
+ when?: string | boolean | undefined;
606
+ ignore_failure?: boolean | undefined;
453
607
  }, {
454
608
  options?: Record<string, unknown> | undefined;
455
609
  task?: string | undefined;
@@ -457,6 +611,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
457
611
  retries?: number | undefined;
458
612
  retryDelay?: number | undefined;
459
613
  retryOn?: string | undefined;
614
+ when?: string | boolean | undefined;
615
+ ignore_failure?: boolean | undefined;
460
616
  }>, "many">>;
461
617
  /** Runs after all steps succeed. */
462
618
  on_success: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -469,6 +625,15 @@ export declare const EngineConfigSchema: z.ZodObject<{
469
625
  retryDelay: z.ZodOptional<z.ZodNumber>;
470
626
  /** Only retry when the error message contains this substring. */
471
627
  retryOn: z.ZodOptional<z.ZodString>;
628
+ /**
629
+ * Conditional execution. A boolean runs/skips the step directly; a string is
630
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
631
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
632
+ * falsy result skips the step without failing the flow.
633
+ */
634
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
635
+ /** If true, a failure of this step is recorded but does not abort the flow. */
636
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
472
637
  }, "strip", z.ZodTypeAny, {
473
638
  options?: Record<string, unknown> | undefined;
474
639
  task?: string | undefined;
@@ -476,6 +641,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
476
641
  retries?: number | undefined;
477
642
  retryDelay?: number | undefined;
478
643
  retryOn?: string | undefined;
644
+ when?: string | boolean | undefined;
645
+ ignore_failure?: boolean | undefined;
479
646
  }, {
480
647
  options?: Record<string, unknown> | undefined;
481
648
  task?: string | undefined;
@@ -483,6 +650,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
483
650
  retries?: number | undefined;
484
651
  retryDelay?: number | undefined;
485
652
  retryOn?: string | undefined;
653
+ when?: string | boolean | undefined;
654
+ ignore_failure?: boolean | undefined;
486
655
  }>, {
487
656
  options?: Record<string, unknown> | undefined;
488
657
  task?: string | undefined;
@@ -490,6 +659,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
490
659
  retries?: number | undefined;
491
660
  retryDelay?: number | undefined;
492
661
  retryOn?: string | undefined;
662
+ when?: string | boolean | undefined;
663
+ ignore_failure?: boolean | undefined;
493
664
  }, {
494
665
  options?: Record<string, unknown> | undefined;
495
666
  task?: string | undefined;
@@ -497,6 +668,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
497
668
  retries?: number | undefined;
498
669
  retryDelay?: number | undefined;
499
670
  retryOn?: string | undefined;
671
+ when?: string | boolean | undefined;
672
+ ignore_failure?: boolean | undefined;
500
673
  }>, "many">>;
501
674
  /** Runs on any step failure. */
502
675
  on_failure: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -509,6 +682,15 @@ export declare const EngineConfigSchema: z.ZodObject<{
509
682
  retryDelay: z.ZodOptional<z.ZodNumber>;
510
683
  /** Only retry when the error message contains this substring. */
511
684
  retryOn: z.ZodOptional<z.ZodString>;
685
+ /**
686
+ * Conditional execution. A boolean runs/skips the step directly; a string is
687
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
688
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
689
+ * falsy result skips the step without failing the flow.
690
+ */
691
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
692
+ /** If true, a failure of this step is recorded but does not abort the flow. */
693
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
512
694
  }, "strip", z.ZodTypeAny, {
513
695
  options?: Record<string, unknown> | undefined;
514
696
  task?: string | undefined;
@@ -516,6 +698,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
516
698
  retries?: number | undefined;
517
699
  retryDelay?: number | undefined;
518
700
  retryOn?: string | undefined;
701
+ when?: string | boolean | undefined;
702
+ ignore_failure?: boolean | undefined;
519
703
  }, {
520
704
  options?: Record<string, unknown> | undefined;
521
705
  task?: string | undefined;
@@ -523,6 +707,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
523
707
  retries?: number | undefined;
524
708
  retryDelay?: number | undefined;
525
709
  retryOn?: string | undefined;
710
+ when?: string | boolean | undefined;
711
+ ignore_failure?: boolean | undefined;
526
712
  }>, {
527
713
  options?: Record<string, unknown> | undefined;
528
714
  task?: string | undefined;
@@ -530,6 +716,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
530
716
  retries?: number | undefined;
531
717
  retryDelay?: number | undefined;
532
718
  retryOn?: string | undefined;
719
+ when?: string | boolean | undefined;
720
+ ignore_failure?: boolean | undefined;
533
721
  }, {
534
722
  options?: Record<string, unknown> | undefined;
535
723
  task?: string | undefined;
@@ -537,6 +725,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
537
725
  retries?: number | undefined;
538
726
  retryDelay?: number | undefined;
539
727
  retryOn?: string | undefined;
728
+ when?: string | boolean | undefined;
729
+ ignore_failure?: boolean | undefined;
540
730
  }>, "many">>;
541
731
  /** Runs after success or failure, after on_success/on_failure. */
542
732
  finally: z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
@@ -549,6 +739,15 @@ export declare const EngineConfigSchema: z.ZodObject<{
549
739
  retryDelay: z.ZodOptional<z.ZodNumber>;
550
740
  /** Only retry when the error message contains this substring. */
551
741
  retryOn: z.ZodOptional<z.ZodString>;
742
+ /**
743
+ * Conditional execution. A boolean runs/skips the step directly; a string is
744
+ * an expression evaluated at runtime by the runner's `conditionEvaluator`
745
+ * (or the built-in `${...}`-reference truthiness check if none is set). A
746
+ * falsy result skips the step without failing the flow.
747
+ */
748
+ when: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
749
+ /** If true, a failure of this step is recorded but does not abort the flow. */
750
+ ignore_failure: z.ZodOptional<z.ZodBoolean>;
552
751
  }, "strip", z.ZodTypeAny, {
553
752
  options?: Record<string, unknown> | undefined;
554
753
  task?: string | undefined;
@@ -556,6 +755,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
556
755
  retries?: number | undefined;
557
756
  retryDelay?: number | undefined;
558
757
  retryOn?: string | undefined;
758
+ when?: string | boolean | undefined;
759
+ ignore_failure?: boolean | undefined;
559
760
  }, {
560
761
  options?: Record<string, unknown> | undefined;
561
762
  task?: string | undefined;
@@ -563,6 +764,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
563
764
  retries?: number | undefined;
564
765
  retryDelay?: number | undefined;
565
766
  retryOn?: string | undefined;
767
+ when?: string | boolean | undefined;
768
+ ignore_failure?: boolean | undefined;
566
769
  }>, {
567
770
  options?: Record<string, unknown> | undefined;
568
771
  task?: string | undefined;
@@ -570,6 +773,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
570
773
  retries?: number | undefined;
571
774
  retryDelay?: number | undefined;
572
775
  retryOn?: string | undefined;
776
+ when?: string | boolean | undefined;
777
+ ignore_failure?: boolean | undefined;
573
778
  }, {
574
779
  options?: Record<string, unknown> | undefined;
575
780
  task?: string | undefined;
@@ -577,6 +782,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
577
782
  retries?: number | undefined;
578
783
  retryDelay?: number | undefined;
579
784
  retryOn?: string | undefined;
785
+ when?: string | boolean | undefined;
786
+ ignore_failure?: boolean | undefined;
580
787
  }>, "many">>;
581
788
  /** If true, invoke rollback records from completed steps in reverse order on failure. */
582
789
  rollback_on_failure: z.ZodOptional<z.ZodBoolean>;
@@ -589,6 +796,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
589
796
  retries?: number | undefined;
590
797
  retryDelay?: number | undefined;
591
798
  retryOn?: string | undefined;
799
+ when?: string | boolean | undefined;
800
+ ignore_failure?: boolean | undefined;
592
801
  }>;
593
802
  on_start?: {
594
803
  options?: Record<string, unknown> | undefined;
@@ -597,6 +806,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
597
806
  retries?: number | undefined;
598
807
  retryDelay?: number | undefined;
599
808
  retryOn?: string | undefined;
809
+ when?: string | boolean | undefined;
810
+ ignore_failure?: boolean | undefined;
600
811
  }[] | undefined;
601
812
  on_success?: {
602
813
  options?: Record<string, unknown> | undefined;
@@ -605,6 +816,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
605
816
  retries?: number | undefined;
606
817
  retryDelay?: number | undefined;
607
818
  retryOn?: string | undefined;
819
+ when?: string | boolean | undefined;
820
+ ignore_failure?: boolean | undefined;
608
821
  }[] | undefined;
609
822
  on_failure?: {
610
823
  options?: Record<string, unknown> | undefined;
@@ -613,6 +826,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
613
826
  retries?: number | undefined;
614
827
  retryDelay?: number | undefined;
615
828
  retryOn?: string | undefined;
829
+ when?: string | boolean | undefined;
830
+ ignore_failure?: boolean | undefined;
616
831
  }[] | undefined;
617
832
  finally?: {
618
833
  options?: Record<string, unknown> | undefined;
@@ -621,6 +836,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
621
836
  retries?: number | undefined;
622
837
  retryDelay?: number | undefined;
623
838
  retryOn?: string | undefined;
839
+ when?: string | boolean | undefined;
840
+ ignore_failure?: boolean | undefined;
624
841
  }[] | undefined;
625
842
  rollback_on_failure?: boolean | undefined;
626
843
  }, {
@@ -632,6 +849,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
632
849
  retries?: number | undefined;
633
850
  retryDelay?: number | undefined;
634
851
  retryOn?: string | undefined;
852
+ when?: string | boolean | undefined;
853
+ ignore_failure?: boolean | undefined;
635
854
  }>;
636
855
  on_start?: {
637
856
  options?: Record<string, unknown> | undefined;
@@ -640,6 +859,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
640
859
  retries?: number | undefined;
641
860
  retryDelay?: number | undefined;
642
861
  retryOn?: string | undefined;
862
+ when?: string | boolean | undefined;
863
+ ignore_failure?: boolean | undefined;
643
864
  }[] | undefined;
644
865
  on_success?: {
645
866
  options?: Record<string, unknown> | undefined;
@@ -648,6 +869,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
648
869
  retries?: number | undefined;
649
870
  retryDelay?: number | undefined;
650
871
  retryOn?: string | undefined;
872
+ when?: string | boolean | undefined;
873
+ ignore_failure?: boolean | undefined;
651
874
  }[] | undefined;
652
875
  on_failure?: {
653
876
  options?: Record<string, unknown> | undefined;
@@ -656,6 +879,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
656
879
  retries?: number | undefined;
657
880
  retryDelay?: number | undefined;
658
881
  retryOn?: string | undefined;
882
+ when?: string | boolean | undefined;
883
+ ignore_failure?: boolean | undefined;
659
884
  }[] | undefined;
660
885
  finally?: {
661
886
  options?: Record<string, unknown> | undefined;
@@ -664,6 +889,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
664
889
  retries?: number | undefined;
665
890
  retryDelay?: number | undefined;
666
891
  retryOn?: string | undefined;
892
+ when?: string | boolean | undefined;
893
+ ignore_failure?: boolean | undefined;
667
894
  }[] | undefined;
668
895
  rollback_on_failure?: boolean | undefined;
669
896
  }>>>;
@@ -685,6 +912,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
685
912
  retries?: number | undefined;
686
913
  retryDelay?: number | undefined;
687
914
  retryOn?: string | undefined;
915
+ when?: string | boolean | undefined;
916
+ ignore_failure?: boolean | undefined;
688
917
  }>;
689
918
  on_start?: {
690
919
  options?: Record<string, unknown> | undefined;
@@ -693,6 +922,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
693
922
  retries?: number | undefined;
694
923
  retryDelay?: number | undefined;
695
924
  retryOn?: string | undefined;
925
+ when?: string | boolean | undefined;
926
+ ignore_failure?: boolean | undefined;
696
927
  }[] | undefined;
697
928
  on_success?: {
698
929
  options?: Record<string, unknown> | undefined;
@@ -701,6 +932,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
701
932
  retries?: number | undefined;
702
933
  retryDelay?: number | undefined;
703
934
  retryOn?: string | undefined;
935
+ when?: string | boolean | undefined;
936
+ ignore_failure?: boolean | undefined;
704
937
  }[] | undefined;
705
938
  on_failure?: {
706
939
  options?: Record<string, unknown> | undefined;
@@ -709,6 +942,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
709
942
  retries?: number | undefined;
710
943
  retryDelay?: number | undefined;
711
944
  retryOn?: string | undefined;
945
+ when?: string | boolean | undefined;
946
+ ignore_failure?: boolean | undefined;
712
947
  }[] | undefined;
713
948
  finally?: {
714
949
  options?: Record<string, unknown> | undefined;
@@ -717,6 +952,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
717
952
  retries?: number | undefined;
718
953
  retryDelay?: number | undefined;
719
954
  retryOn?: string | undefined;
955
+ when?: string | boolean | undefined;
956
+ ignore_failure?: boolean | undefined;
720
957
  }[] | undefined;
721
958
  rollback_on_failure?: boolean | undefined;
722
959
  }>;
@@ -738,6 +975,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
738
975
  retries?: number | undefined;
739
976
  retryDelay?: number | undefined;
740
977
  retryOn?: string | undefined;
978
+ when?: string | boolean | undefined;
979
+ ignore_failure?: boolean | undefined;
741
980
  }>;
742
981
  on_start?: {
743
982
  options?: Record<string, unknown> | undefined;
@@ -746,6 +985,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
746
985
  retries?: number | undefined;
747
986
  retryDelay?: number | undefined;
748
987
  retryOn?: string | undefined;
988
+ when?: string | boolean | undefined;
989
+ ignore_failure?: boolean | undefined;
749
990
  }[] | undefined;
750
991
  on_success?: {
751
992
  options?: Record<string, unknown> | undefined;
@@ -754,6 +995,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
754
995
  retries?: number | undefined;
755
996
  retryDelay?: number | undefined;
756
997
  retryOn?: string | undefined;
998
+ when?: string | boolean | undefined;
999
+ ignore_failure?: boolean | undefined;
757
1000
  }[] | undefined;
758
1001
  on_failure?: {
759
1002
  options?: Record<string, unknown> | undefined;
@@ -762,6 +1005,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
762
1005
  retries?: number | undefined;
763
1006
  retryDelay?: number | undefined;
764
1007
  retryOn?: string | undefined;
1008
+ when?: string | boolean | undefined;
1009
+ ignore_failure?: boolean | undefined;
765
1010
  }[] | undefined;
766
1011
  finally?: {
767
1012
  options?: Record<string, unknown> | undefined;
@@ -770,6 +1015,8 @@ export declare const EngineConfigSchema: z.ZodObject<{
770
1015
  retries?: number | undefined;
771
1016
  retryDelay?: number | undefined;
772
1017
  retryOn?: string | undefined;
1018
+ when?: string | boolean | undefined;
1019
+ ignore_failure?: boolean | undefined;
773
1020
  }[] | undefined;
774
1021
  rollback_on_failure?: boolean | undefined;
775
1022
  }> | undefined;