blockflow-mcp 0.0.0-stage → 1.0.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.
@@ -0,0 +1,3333 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/akib35/blockflow/docs/guide/script.schema.json",
4
+ "title": "BlockFlow script file",
5
+ "description": "A workflow as a list of steps (the recommended format to write by hand or with an LLM). A step continues to the next one from \"out\" (loops: \"done\"); after an If, the next step follows the end of each branch. Generated by scripts/scriptSchema.ts.",
6
+ "oneOf": [
7
+ {
8
+ "$ref": "#/$defs/script"
9
+ },
10
+ {
11
+ "type": "object",
12
+ "required": [
13
+ "format",
14
+ "scripts"
15
+ ],
16
+ "properties": {
17
+ "format": {
18
+ "const": "blockflow-script"
19
+ },
20
+ "version": {
21
+ "const": 1
22
+ },
23
+ "scripts": {
24
+ "type": "array",
25
+ "items": {
26
+ "$ref": "#/$defs/script"
27
+ }
28
+ }
29
+ },
30
+ "additionalProperties": false
31
+ }
32
+ ],
33
+ "$defs": {
34
+ "script": {
35
+ "type": "object",
36
+ "required": [
37
+ "steps"
38
+ ],
39
+ "properties": {
40
+ "format": {
41
+ "const": "blockflow-script"
42
+ },
43
+ "version": {
44
+ "const": 1
45
+ },
46
+ "id": {
47
+ "type": "string",
48
+ "description": "In a file of several scripts: lets Run Workflow name this script."
49
+ },
50
+ "name": {
51
+ "type": "string"
52
+ },
53
+ "steps": {
54
+ "$ref": "#/$defs/steps"
55
+ }
56
+ },
57
+ "additionalProperties": false
58
+ },
59
+ "steps": {
60
+ "type": "array",
61
+ "items": {
62
+ "$ref": "#/$defs/step"
63
+ }
64
+ },
65
+ "step": {
66
+ "oneOf": [
67
+ {
68
+ "type": "object",
69
+ "title": "Start",
70
+ "required": [
71
+ "start"
72
+ ],
73
+ "properties": {
74
+ "id": {
75
+ "type": "string",
76
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
77
+ },
78
+ "start": {
79
+ "$ref": "#/$defs/config/start"
80
+ },
81
+ "step": {
82
+ "$ref": "#/$defs/stepSettings"
83
+ },
84
+ "onError": {
85
+ "$ref": "#/$defs/steps",
86
+ "description": "Steps on the error output (sets step.onError to \"port\")."
87
+ }
88
+ },
89
+ "additionalProperties": false
90
+ },
91
+ {
92
+ "type": "object",
93
+ "title": "Timer",
94
+ "required": [
95
+ "timer"
96
+ ],
97
+ "properties": {
98
+ "id": {
99
+ "type": "string",
100
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
101
+ },
102
+ "timer": {
103
+ "$ref": "#/$defs/config/timer"
104
+ },
105
+ "step": {
106
+ "$ref": "#/$defs/stepSettings"
107
+ },
108
+ "onError": {
109
+ "$ref": "#/$defs/steps",
110
+ "description": "Steps on the error output (sets step.onError to \"port\")."
111
+ }
112
+ },
113
+ "additionalProperties": false
114
+ },
115
+ {
116
+ "type": "object",
117
+ "title": "Schedule",
118
+ "required": [
119
+ "schedule"
120
+ ],
121
+ "properties": {
122
+ "id": {
123
+ "type": "string",
124
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
125
+ },
126
+ "schedule": {
127
+ "$ref": "#/$defs/config/schedule"
128
+ },
129
+ "step": {
130
+ "$ref": "#/$defs/stepSettings"
131
+ },
132
+ "onError": {
133
+ "$ref": "#/$defs/steps",
134
+ "description": "Steps on the error output (sets step.onError to \"port\")."
135
+ }
136
+ },
137
+ "additionalProperties": false
138
+ },
139
+ {
140
+ "type": "object",
141
+ "title": "Page Visited",
142
+ "required": [
143
+ "page-visited"
144
+ ],
145
+ "properties": {
146
+ "id": {
147
+ "type": "string",
148
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
149
+ },
150
+ "page-visited": {
151
+ "$ref": "#/$defs/config/page-visited"
152
+ },
153
+ "step": {
154
+ "$ref": "#/$defs/stepSettings"
155
+ },
156
+ "onError": {
157
+ "$ref": "#/$defs/steps",
158
+ "description": "Steps on the error output (sets step.onError to \"port\")."
159
+ }
160
+ },
161
+ "additionalProperties": false
162
+ },
163
+ {
164
+ "type": "object",
165
+ "title": "Context Menu",
166
+ "required": [
167
+ "context-menu"
168
+ ],
169
+ "properties": {
170
+ "id": {
171
+ "type": "string",
172
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
173
+ },
174
+ "context-menu": {
175
+ "$ref": "#/$defs/config/context-menu"
176
+ },
177
+ "step": {
178
+ "$ref": "#/$defs/stepSettings"
179
+ },
180
+ "onError": {
181
+ "$ref": "#/$defs/steps",
182
+ "description": "Steps on the error output (sets step.onError to \"port\")."
183
+ }
184
+ },
185
+ "additionalProperties": false
186
+ },
187
+ {
188
+ "type": "object",
189
+ "title": "Watch Element",
190
+ "required": [
191
+ "watch-element"
192
+ ],
193
+ "properties": {
194
+ "id": {
195
+ "type": "string",
196
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
197
+ },
198
+ "watch-element": {
199
+ "$ref": "#/$defs/config/watch-element"
200
+ },
201
+ "step": {
202
+ "$ref": "#/$defs/stepSettings"
203
+ },
204
+ "onError": {
205
+ "$ref": "#/$defs/steps",
206
+ "description": "Steps on the error output (sets step.onError to \"port\")."
207
+ }
208
+ },
209
+ "additionalProperties": false
210
+ },
211
+ {
212
+ "type": "object",
213
+ "title": "Open Tab",
214
+ "required": [
215
+ "open-url"
216
+ ],
217
+ "properties": {
218
+ "id": {
219
+ "type": "string",
220
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
221
+ },
222
+ "open-url": {
223
+ "oneOf": [
224
+ {
225
+ "$ref": "#/$defs/config/open-url"
226
+ },
227
+ {
228
+ "description": "Shorthand for { \"url\": … }",
229
+ "type": "string"
230
+ }
231
+ ]
232
+ },
233
+ "step": {
234
+ "$ref": "#/$defs/stepSettings"
235
+ },
236
+ "onError": {
237
+ "$ref": "#/$defs/steps",
238
+ "description": "Steps on the error output (sets step.onError to \"port\")."
239
+ }
240
+ },
241
+ "additionalProperties": false
242
+ },
243
+ {
244
+ "type": "object",
245
+ "title": "Open Tab (alias \"open\")",
246
+ "required": [
247
+ "open"
248
+ ],
249
+ "properties": {
250
+ "id": {
251
+ "type": "string",
252
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
253
+ },
254
+ "open": {
255
+ "oneOf": [
256
+ {
257
+ "$ref": "#/$defs/config/open-url"
258
+ },
259
+ {
260
+ "description": "Shorthand for { \"url\": … }",
261
+ "type": "string"
262
+ }
263
+ ]
264
+ },
265
+ "step": {
266
+ "$ref": "#/$defs/stepSettings"
267
+ },
268
+ "onError": {
269
+ "$ref": "#/$defs/steps",
270
+ "description": "Steps on the error output (sets step.onError to \"port\")."
271
+ }
272
+ },
273
+ "additionalProperties": false
274
+ },
275
+ {
276
+ "type": "object",
277
+ "title": "Navigate",
278
+ "required": [
279
+ "navigate"
280
+ ],
281
+ "properties": {
282
+ "id": {
283
+ "type": "string",
284
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
285
+ },
286
+ "navigate": {
287
+ "oneOf": [
288
+ {
289
+ "$ref": "#/$defs/config/navigate"
290
+ },
291
+ {
292
+ "description": "Shorthand for { \"url\": … }",
293
+ "type": "string"
294
+ }
295
+ ]
296
+ },
297
+ "step": {
298
+ "$ref": "#/$defs/stepSettings"
299
+ },
300
+ "onError": {
301
+ "$ref": "#/$defs/steps",
302
+ "description": "Steps on the error output (sets step.onError to \"port\")."
303
+ }
304
+ },
305
+ "additionalProperties": false
306
+ },
307
+ {
308
+ "type": "object",
309
+ "title": "Navigate (alias \"goto\")",
310
+ "required": [
311
+ "goto"
312
+ ],
313
+ "properties": {
314
+ "id": {
315
+ "type": "string",
316
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
317
+ },
318
+ "goto": {
319
+ "oneOf": [
320
+ {
321
+ "$ref": "#/$defs/config/navigate"
322
+ },
323
+ {
324
+ "description": "Shorthand for { \"url\": … }",
325
+ "type": "string"
326
+ }
327
+ ]
328
+ },
329
+ "step": {
330
+ "$ref": "#/$defs/stepSettings"
331
+ },
332
+ "onError": {
333
+ "$ref": "#/$defs/steps",
334
+ "description": "Steps on the error output (sets step.onError to \"port\")."
335
+ }
336
+ },
337
+ "additionalProperties": false
338
+ },
339
+ {
340
+ "type": "object",
341
+ "title": "Wait for Popup",
342
+ "required": [
343
+ "wait-for-popup"
344
+ ],
345
+ "properties": {
346
+ "id": {
347
+ "type": "string",
348
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
349
+ },
350
+ "wait-for-popup": {
351
+ "$ref": "#/$defs/config/wait-for-popup"
352
+ },
353
+ "step": {
354
+ "$ref": "#/$defs/stepSettings"
355
+ },
356
+ "onError": {
357
+ "$ref": "#/$defs/steps",
358
+ "description": "Steps on the error output (sets step.onError to \"port\")."
359
+ }
360
+ },
361
+ "additionalProperties": false
362
+ },
363
+ {
364
+ "type": "object",
365
+ "title": "Wait for Download",
366
+ "required": [
367
+ "wait-for-download"
368
+ ],
369
+ "properties": {
370
+ "id": {
371
+ "type": "string",
372
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
373
+ },
374
+ "wait-for-download": {
375
+ "$ref": "#/$defs/config/wait-for-download"
376
+ },
377
+ "step": {
378
+ "$ref": "#/$defs/stepSettings"
379
+ },
380
+ "onError": {
381
+ "$ref": "#/$defs/steps",
382
+ "description": "Steps on the error output (sets step.onError to \"port\")."
383
+ }
384
+ },
385
+ "additionalProperties": false
386
+ },
387
+ {
388
+ "type": "object",
389
+ "title": "Cookies & Storage",
390
+ "required": [
391
+ "cookies-storage"
392
+ ],
393
+ "properties": {
394
+ "id": {
395
+ "type": "string",
396
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
397
+ },
398
+ "cookies-storage": {
399
+ "$ref": "#/$defs/config/cookies-storage"
400
+ },
401
+ "step": {
402
+ "$ref": "#/$defs/stepSettings"
403
+ },
404
+ "onError": {
405
+ "$ref": "#/$defs/steps",
406
+ "description": "Steps on the error output (sets step.onError to \"port\")."
407
+ }
408
+ },
409
+ "additionalProperties": false
410
+ },
411
+ {
412
+ "type": "object",
413
+ "title": "Route",
414
+ "required": [
415
+ "route"
416
+ ],
417
+ "properties": {
418
+ "id": {
419
+ "type": "string",
420
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
421
+ },
422
+ "route": {
423
+ "$ref": "#/$defs/config/route"
424
+ },
425
+ "step": {
426
+ "$ref": "#/$defs/stepSettings"
427
+ },
428
+ "onError": {
429
+ "$ref": "#/$defs/steps",
430
+ "description": "Steps on the error output (sets step.onError to \"port\")."
431
+ }
432
+ },
433
+ "additionalProperties": false
434
+ },
435
+ {
436
+ "type": "object",
437
+ "title": "HAR Record",
438
+ "required": [
439
+ "har-record"
440
+ ],
441
+ "properties": {
442
+ "id": {
443
+ "type": "string",
444
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
445
+ },
446
+ "har-record": {
447
+ "$ref": "#/$defs/config/har-record"
448
+ },
449
+ "step": {
450
+ "$ref": "#/$defs/stepSettings"
451
+ },
452
+ "onError": {
453
+ "$ref": "#/$defs/steps",
454
+ "description": "Steps on the error output (sets step.onError to \"port\")."
455
+ }
456
+ },
457
+ "additionalProperties": false
458
+ },
459
+ {
460
+ "type": "object",
461
+ "title": "Emulate",
462
+ "required": [
463
+ "emulate"
464
+ ],
465
+ "properties": {
466
+ "id": {
467
+ "type": "string",
468
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
469
+ },
470
+ "emulate": {
471
+ "$ref": "#/$defs/config/emulate"
472
+ },
473
+ "step": {
474
+ "$ref": "#/$defs/stepSettings"
475
+ },
476
+ "onError": {
477
+ "$ref": "#/$defs/steps",
478
+ "description": "Steps on the error output (sets step.onError to \"port\")."
479
+ }
480
+ },
481
+ "additionalProperties": false
482
+ },
483
+ {
484
+ "type": "object",
485
+ "title": "Clear Site Data",
486
+ "required": [
487
+ "clear-site-data"
488
+ ],
489
+ "properties": {
490
+ "id": {
491
+ "type": "string",
492
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
493
+ },
494
+ "clear-site-data": {
495
+ "$ref": "#/$defs/config/clear-site-data"
496
+ },
497
+ "step": {
498
+ "$ref": "#/$defs/stepSettings"
499
+ },
500
+ "onError": {
501
+ "$ref": "#/$defs/steps",
502
+ "description": "Steps on the error output (sets step.onError to \"port\")."
503
+ }
504
+ },
505
+ "additionalProperties": false
506
+ },
507
+ {
508
+ "type": "object",
509
+ "title": "Close Tab",
510
+ "required": [
511
+ "close-tab"
512
+ ],
513
+ "properties": {
514
+ "id": {
515
+ "type": "string",
516
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
517
+ },
518
+ "close-tab": {
519
+ "$ref": "#/$defs/config/close-tab"
520
+ },
521
+ "step": {
522
+ "$ref": "#/$defs/stepSettings"
523
+ },
524
+ "onError": {
525
+ "$ref": "#/$defs/steps",
526
+ "description": "Steps on the error output (sets step.onError to \"port\")."
527
+ }
528
+ },
529
+ "additionalProperties": false
530
+ },
531
+ {
532
+ "type": "object",
533
+ "title": "Click",
534
+ "required": [
535
+ "click"
536
+ ],
537
+ "properties": {
538
+ "id": {
539
+ "type": "string",
540
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
541
+ },
542
+ "click": {
543
+ "oneOf": [
544
+ {
545
+ "$ref": "#/$defs/config/click"
546
+ },
547
+ {
548
+ "description": "Shorthand for { \"locator\": … }",
549
+ "type": "string"
550
+ }
551
+ ]
552
+ },
553
+ "step": {
554
+ "$ref": "#/$defs/stepSettings"
555
+ },
556
+ "onError": {
557
+ "$ref": "#/$defs/steps",
558
+ "description": "Steps on the error output (sets step.onError to \"port\")."
559
+ }
560
+ },
561
+ "additionalProperties": false
562
+ },
563
+ {
564
+ "type": "object",
565
+ "title": "Fill",
566
+ "required": [
567
+ "fill"
568
+ ],
569
+ "properties": {
570
+ "id": {
571
+ "type": "string",
572
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
573
+ },
574
+ "fill": {
575
+ "$ref": "#/$defs/config/fill"
576
+ },
577
+ "step": {
578
+ "$ref": "#/$defs/stepSettings"
579
+ },
580
+ "onError": {
581
+ "$ref": "#/$defs/steps",
582
+ "description": "Steps on the error output (sets step.onError to \"port\")."
583
+ }
584
+ },
585
+ "additionalProperties": false
586
+ },
587
+ {
588
+ "type": "object",
589
+ "title": "Fill Form",
590
+ "required": [
591
+ "fill-form"
592
+ ],
593
+ "properties": {
594
+ "id": {
595
+ "type": "string",
596
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
597
+ },
598
+ "fill-form": {
599
+ "$ref": "#/$defs/config/fill-form"
600
+ },
601
+ "step": {
602
+ "$ref": "#/$defs/stepSettings"
603
+ },
604
+ "onError": {
605
+ "$ref": "#/$defs/steps",
606
+ "description": "Steps on the error output (sets step.onError to \"port\")."
607
+ }
608
+ },
609
+ "additionalProperties": false
610
+ },
611
+ {
612
+ "type": "object",
613
+ "title": "Select Option",
614
+ "required": [
615
+ "select-option"
616
+ ],
617
+ "properties": {
618
+ "id": {
619
+ "type": "string",
620
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
621
+ },
622
+ "select-option": {
623
+ "$ref": "#/$defs/config/select-option"
624
+ },
625
+ "step": {
626
+ "$ref": "#/$defs/stepSettings"
627
+ },
628
+ "onError": {
629
+ "$ref": "#/$defs/steps",
630
+ "description": "Steps on the error output (sets step.onError to \"port\")."
631
+ }
632
+ },
633
+ "additionalProperties": false
634
+ },
635
+ {
636
+ "type": "object",
637
+ "title": "Select Option (alias \"select\")",
638
+ "required": [
639
+ "select"
640
+ ],
641
+ "properties": {
642
+ "id": {
643
+ "type": "string",
644
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
645
+ },
646
+ "select": {
647
+ "$ref": "#/$defs/config/select-option"
648
+ },
649
+ "step": {
650
+ "$ref": "#/$defs/stepSettings"
651
+ },
652
+ "onError": {
653
+ "$ref": "#/$defs/steps",
654
+ "description": "Steps on the error output (sets step.onError to \"port\")."
655
+ }
656
+ },
657
+ "additionalProperties": false
658
+ },
659
+ {
660
+ "type": "object",
661
+ "title": "Check",
662
+ "required": [
663
+ "check"
664
+ ],
665
+ "properties": {
666
+ "id": {
667
+ "type": "string",
668
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
669
+ },
670
+ "check": {
671
+ "oneOf": [
672
+ {
673
+ "$ref": "#/$defs/config/check"
674
+ },
675
+ {
676
+ "description": "Shorthand for { \"locator\": … }",
677
+ "type": "string"
678
+ }
679
+ ]
680
+ },
681
+ "step": {
682
+ "$ref": "#/$defs/stepSettings"
683
+ },
684
+ "onError": {
685
+ "$ref": "#/$defs/steps",
686
+ "description": "Steps on the error output (sets step.onError to \"port\")."
687
+ }
688
+ },
689
+ "additionalProperties": false
690
+ },
691
+ {
692
+ "type": "object",
693
+ "title": "Press Key",
694
+ "required": [
695
+ "press-key"
696
+ ],
697
+ "properties": {
698
+ "id": {
699
+ "type": "string",
700
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
701
+ },
702
+ "press-key": {
703
+ "oneOf": [
704
+ {
705
+ "$ref": "#/$defs/config/press-key"
706
+ },
707
+ {
708
+ "description": "Shorthand for { \"key\": … }",
709
+ "type": "string"
710
+ }
711
+ ]
712
+ },
713
+ "step": {
714
+ "$ref": "#/$defs/stepSettings"
715
+ },
716
+ "onError": {
717
+ "$ref": "#/$defs/steps",
718
+ "description": "Steps on the error output (sets step.onError to \"port\")."
719
+ }
720
+ },
721
+ "additionalProperties": false
722
+ },
723
+ {
724
+ "type": "object",
725
+ "title": "Press Key (alias \"press\")",
726
+ "required": [
727
+ "press"
728
+ ],
729
+ "properties": {
730
+ "id": {
731
+ "type": "string",
732
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
733
+ },
734
+ "press": {
735
+ "oneOf": [
736
+ {
737
+ "$ref": "#/$defs/config/press-key"
738
+ },
739
+ {
740
+ "description": "Shorthand for { \"key\": … }",
741
+ "type": "string"
742
+ }
743
+ ]
744
+ },
745
+ "step": {
746
+ "$ref": "#/$defs/stepSettings"
747
+ },
748
+ "onError": {
749
+ "$ref": "#/$defs/steps",
750
+ "description": "Steps on the error output (sets step.onError to \"port\")."
751
+ }
752
+ },
753
+ "additionalProperties": false
754
+ },
755
+ {
756
+ "type": "object",
757
+ "title": "Drag",
758
+ "required": [
759
+ "drag"
760
+ ],
761
+ "properties": {
762
+ "id": {
763
+ "type": "string",
764
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
765
+ },
766
+ "drag": {
767
+ "$ref": "#/$defs/config/drag"
768
+ },
769
+ "step": {
770
+ "$ref": "#/$defs/stepSettings"
771
+ },
772
+ "onError": {
773
+ "$ref": "#/$defs/steps",
774
+ "description": "Steps on the error output (sets step.onError to \"port\")."
775
+ }
776
+ },
777
+ "additionalProperties": false
778
+ },
779
+ {
780
+ "type": "object",
781
+ "title": "Element Action",
782
+ "required": [
783
+ "element-action"
784
+ ],
785
+ "properties": {
786
+ "id": {
787
+ "type": "string",
788
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
789
+ },
790
+ "element-action": {
791
+ "$ref": "#/$defs/config/element-action"
792
+ },
793
+ "step": {
794
+ "$ref": "#/$defs/stepSettings"
795
+ },
796
+ "onError": {
797
+ "$ref": "#/$defs/steps",
798
+ "description": "Steps on the error output (sets step.onError to \"port\")."
799
+ }
800
+ },
801
+ "additionalProperties": false
802
+ },
803
+ {
804
+ "type": "object",
805
+ "title": "Upload File",
806
+ "required": [
807
+ "upload-file"
808
+ ],
809
+ "properties": {
810
+ "id": {
811
+ "type": "string",
812
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
813
+ },
814
+ "upload-file": {
815
+ "$ref": "#/$defs/config/upload-file"
816
+ },
817
+ "step": {
818
+ "$ref": "#/$defs/stepSettings"
819
+ },
820
+ "onError": {
821
+ "$ref": "#/$defs/steps",
822
+ "description": "Steps on the error output (sets step.onError to \"port\")."
823
+ }
824
+ },
825
+ "additionalProperties": false
826
+ },
827
+ {
828
+ "type": "object",
829
+ "title": "Scroll",
830
+ "required": [
831
+ "scroll"
832
+ ],
833
+ "properties": {
834
+ "id": {
835
+ "type": "string",
836
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
837
+ },
838
+ "scroll": {
839
+ "$ref": "#/$defs/config/scroll"
840
+ },
841
+ "step": {
842
+ "$ref": "#/$defs/stepSettings"
843
+ },
844
+ "onError": {
845
+ "$ref": "#/$defs/steps",
846
+ "description": "Steps on the error output (sets step.onError to \"port\")."
847
+ }
848
+ },
849
+ "additionalProperties": false
850
+ },
851
+ {
852
+ "type": "object",
853
+ "title": "Dialogs",
854
+ "required": [
855
+ "dialogs"
856
+ ],
857
+ "properties": {
858
+ "id": {
859
+ "type": "string",
860
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
861
+ },
862
+ "dialogs": {
863
+ "$ref": "#/$defs/config/dialogs"
864
+ },
865
+ "step": {
866
+ "$ref": "#/$defs/stepSettings"
867
+ },
868
+ "onError": {
869
+ "$ref": "#/$defs/steps",
870
+ "description": "Steps on the error output (sets step.onError to \"port\")."
871
+ }
872
+ },
873
+ "additionalProperties": false
874
+ },
875
+ {
876
+ "type": "object",
877
+ "title": "Wait For",
878
+ "required": [
879
+ "wait-for"
880
+ ],
881
+ "properties": {
882
+ "id": {
883
+ "type": "string",
884
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
885
+ },
886
+ "wait-for": {
887
+ "oneOf": [
888
+ {
889
+ "$ref": "#/$defs/config/wait-for"
890
+ },
891
+ {
892
+ "description": "Shorthand for { \"locator\": … }",
893
+ "type": "string"
894
+ }
895
+ ]
896
+ },
897
+ "step": {
898
+ "$ref": "#/$defs/stepSettings"
899
+ },
900
+ "onError": {
901
+ "$ref": "#/$defs/steps",
902
+ "description": "Steps on the error output (sets step.onError to \"port\")."
903
+ }
904
+ },
905
+ "additionalProperties": false
906
+ },
907
+ {
908
+ "type": "object",
909
+ "title": "Run Script",
910
+ "required": [
911
+ "run-script"
912
+ ],
913
+ "properties": {
914
+ "id": {
915
+ "type": "string",
916
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
917
+ },
918
+ "run-script": {
919
+ "oneOf": [
920
+ {
921
+ "$ref": "#/$defs/config/run-script"
922
+ },
923
+ {
924
+ "description": "Shorthand for { \"code\": … }",
925
+ "type": "string"
926
+ }
927
+ ]
928
+ },
929
+ "step": {
930
+ "$ref": "#/$defs/stepSettings"
931
+ },
932
+ "onError": {
933
+ "$ref": "#/$defs/steps",
934
+ "description": "Steps on the error output (sets step.onError to \"port\")."
935
+ }
936
+ },
937
+ "additionalProperties": false
938
+ },
939
+ {
940
+ "type": "object",
941
+ "title": "Read Element",
942
+ "required": [
943
+ "read-element"
944
+ ],
945
+ "properties": {
946
+ "id": {
947
+ "type": "string",
948
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
949
+ },
950
+ "read-element": {
951
+ "$ref": "#/$defs/config/read-element"
952
+ },
953
+ "step": {
954
+ "$ref": "#/$defs/stepSettings"
955
+ },
956
+ "onError": {
957
+ "$ref": "#/$defs/steps",
958
+ "description": "Steps on the error output (sets step.onError to \"port\")."
959
+ }
960
+ },
961
+ "additionalProperties": false
962
+ },
963
+ {
964
+ "type": "object",
965
+ "title": "Extract List",
966
+ "required": [
967
+ "extract-list"
968
+ ],
969
+ "properties": {
970
+ "id": {
971
+ "type": "string",
972
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
973
+ },
974
+ "extract-list": {
975
+ "$ref": "#/$defs/config/extract-list"
976
+ },
977
+ "step": {
978
+ "$ref": "#/$defs/stepSettings"
979
+ },
980
+ "onError": {
981
+ "$ref": "#/$defs/steps",
982
+ "description": "Steps on the error output (sets step.onError to \"port\")."
983
+ }
984
+ },
985
+ "additionalProperties": false
986
+ },
987
+ {
988
+ "type": "object",
989
+ "title": "Extract Table",
990
+ "required": [
991
+ "extract-table"
992
+ ],
993
+ "properties": {
994
+ "id": {
995
+ "type": "string",
996
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
997
+ },
998
+ "extract-table": {
999
+ "$ref": "#/$defs/config/extract-table"
1000
+ },
1001
+ "step": {
1002
+ "$ref": "#/$defs/stepSettings"
1003
+ },
1004
+ "onError": {
1005
+ "$ref": "#/$defs/steps",
1006
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1007
+ }
1008
+ },
1009
+ "additionalProperties": false
1010
+ },
1011
+ {
1012
+ "type": "object",
1013
+ "title": "Paginate",
1014
+ "required": [
1015
+ "paginate"
1016
+ ],
1017
+ "properties": {
1018
+ "id": {
1019
+ "type": "string",
1020
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1021
+ },
1022
+ "paginate": {
1023
+ "$ref": "#/$defs/config/paginate"
1024
+ },
1025
+ "step": {
1026
+ "$ref": "#/$defs/stepSettings"
1027
+ },
1028
+ "each": {
1029
+ "$ref": "#/$defs/steps",
1030
+ "description": "Steps on \"each\"; they do not continue to the next step."
1031
+ },
1032
+ "onError": {
1033
+ "$ref": "#/$defs/steps",
1034
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1035
+ }
1036
+ },
1037
+ "additionalProperties": false
1038
+ },
1039
+ {
1040
+ "type": "object",
1041
+ "title": "Page Info",
1042
+ "required": [
1043
+ "page-info"
1044
+ ],
1045
+ "properties": {
1046
+ "id": {
1047
+ "type": "string",
1048
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1049
+ },
1050
+ "page-info": {
1051
+ "$ref": "#/$defs/config/page-info"
1052
+ },
1053
+ "step": {
1054
+ "$ref": "#/$defs/stepSettings"
1055
+ },
1056
+ "onError": {
1057
+ "$ref": "#/$defs/steps",
1058
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1059
+ }
1060
+ },
1061
+ "additionalProperties": false
1062
+ },
1063
+ {
1064
+ "type": "object",
1065
+ "title": "Page Snapshot",
1066
+ "required": [
1067
+ "page-snapshot"
1068
+ ],
1069
+ "properties": {
1070
+ "id": {
1071
+ "type": "string",
1072
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1073
+ },
1074
+ "page-snapshot": {
1075
+ "$ref": "#/$defs/config/page-snapshot"
1076
+ },
1077
+ "step": {
1078
+ "$ref": "#/$defs/stepSettings"
1079
+ },
1080
+ "onError": {
1081
+ "$ref": "#/$defs/steps",
1082
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1083
+ }
1084
+ },
1085
+ "additionalProperties": false
1086
+ },
1087
+ {
1088
+ "type": "object",
1089
+ "title": "Screenshot",
1090
+ "required": [
1091
+ "screenshot"
1092
+ ],
1093
+ "properties": {
1094
+ "id": {
1095
+ "type": "string",
1096
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1097
+ },
1098
+ "screenshot": {
1099
+ "$ref": "#/$defs/config/screenshot"
1100
+ },
1101
+ "step": {
1102
+ "$ref": "#/$defs/stepSettings"
1103
+ },
1104
+ "onError": {
1105
+ "$ref": "#/$defs/steps",
1106
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1107
+ }
1108
+ },
1109
+ "additionalProperties": false
1110
+ },
1111
+ {
1112
+ "type": "object",
1113
+ "title": "Assert",
1114
+ "required": [
1115
+ "assert"
1116
+ ],
1117
+ "properties": {
1118
+ "id": {
1119
+ "type": "string",
1120
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1121
+ },
1122
+ "assert": {
1123
+ "$ref": "#/$defs/config/assert"
1124
+ },
1125
+ "step": {
1126
+ "$ref": "#/$defs/stepSettings"
1127
+ },
1128
+ "onError": {
1129
+ "$ref": "#/$defs/steps",
1130
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1131
+ }
1132
+ },
1133
+ "additionalProperties": false
1134
+ },
1135
+ {
1136
+ "type": "object",
1137
+ "title": "Manual Step",
1138
+ "required": [
1139
+ "manual-step"
1140
+ ],
1141
+ "properties": {
1142
+ "id": {
1143
+ "type": "string",
1144
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1145
+ },
1146
+ "manual-step": {
1147
+ "$ref": "#/$defs/config/manual-step"
1148
+ },
1149
+ "step": {
1150
+ "$ref": "#/$defs/stepSettings"
1151
+ },
1152
+ "onError": {
1153
+ "$ref": "#/$defs/steps",
1154
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1155
+ }
1156
+ },
1157
+ "additionalProperties": false
1158
+ },
1159
+ {
1160
+ "type": "object",
1161
+ "title": "Stop",
1162
+ "required": [
1163
+ "stop"
1164
+ ],
1165
+ "properties": {
1166
+ "id": {
1167
+ "type": "string",
1168
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1169
+ },
1170
+ "stop": {
1171
+ "$ref": "#/$defs/config/stop"
1172
+ },
1173
+ "step": {
1174
+ "$ref": "#/$defs/stepSettings"
1175
+ },
1176
+ "onError": {
1177
+ "$ref": "#/$defs/steps",
1178
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1179
+ }
1180
+ },
1181
+ "additionalProperties": false
1182
+ },
1183
+ {
1184
+ "type": "object",
1185
+ "title": "If",
1186
+ "required": [
1187
+ "if"
1188
+ ],
1189
+ "properties": {
1190
+ "id": {
1191
+ "type": "string",
1192
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1193
+ },
1194
+ "if": {
1195
+ "$ref": "#/$defs/config/if"
1196
+ },
1197
+ "step": {
1198
+ "$ref": "#/$defs/stepSettings"
1199
+ },
1200
+ "true": {
1201
+ "$ref": "#/$defs/steps",
1202
+ "description": "Steps on \"true\"; their end continues to the next step."
1203
+ },
1204
+ "false": {
1205
+ "$ref": "#/$defs/steps",
1206
+ "description": "Steps on \"false\"; their end continues to the next step."
1207
+ },
1208
+ "onError": {
1209
+ "$ref": "#/$defs/steps",
1210
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1211
+ }
1212
+ },
1213
+ "additionalProperties": false
1214
+ },
1215
+ {
1216
+ "type": "object",
1217
+ "title": "Switch",
1218
+ "required": [
1219
+ "switch"
1220
+ ],
1221
+ "properties": {
1222
+ "id": {
1223
+ "type": "string",
1224
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1225
+ },
1226
+ "switch": {
1227
+ "$ref": "#/$defs/config/switch"
1228
+ },
1229
+ "step": {
1230
+ "$ref": "#/$defs/stepSettings"
1231
+ },
1232
+ "default": {
1233
+ "$ref": "#/$defs/steps",
1234
+ "description": "Steps on \"default\"; their end continues to the next step."
1235
+ },
1236
+ "onError": {
1237
+ "$ref": "#/$defs/steps",
1238
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1239
+ }
1240
+ },
1241
+ "additionalProperties": {
1242
+ "$ref": "#/$defs/steps",
1243
+ "description": "Steps on the output of that name (a case's \"port\"); their end continues to the next step."
1244
+ }
1245
+ },
1246
+ {
1247
+ "type": "object",
1248
+ "title": "For Each",
1249
+ "required": [
1250
+ "for-each"
1251
+ ],
1252
+ "properties": {
1253
+ "id": {
1254
+ "type": "string",
1255
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1256
+ },
1257
+ "for-each": {
1258
+ "oneOf": [
1259
+ {
1260
+ "$ref": "#/$defs/config/for-each"
1261
+ },
1262
+ {
1263
+ "description": "Shorthand for { \"list\": … }",
1264
+ "type": "string"
1265
+ }
1266
+ ]
1267
+ },
1268
+ "step": {
1269
+ "$ref": "#/$defs/stepSettings"
1270
+ },
1271
+ "each": {
1272
+ "$ref": "#/$defs/steps",
1273
+ "description": "Steps on \"each\"; they do not continue to the next step."
1274
+ },
1275
+ "onError": {
1276
+ "$ref": "#/$defs/steps",
1277
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1278
+ }
1279
+ },
1280
+ "additionalProperties": false
1281
+ },
1282
+ {
1283
+ "type": "object",
1284
+ "title": "Repeat",
1285
+ "required": [
1286
+ "repeat"
1287
+ ],
1288
+ "properties": {
1289
+ "id": {
1290
+ "type": "string",
1291
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1292
+ },
1293
+ "repeat": {
1294
+ "oneOf": [
1295
+ {
1296
+ "$ref": "#/$defs/config/repeat"
1297
+ },
1298
+ {
1299
+ "description": "Shorthand for { \"times\": … }",
1300
+ "type": "number",
1301
+ "minimum": 1,
1302
+ "maximum": 1000
1303
+ }
1304
+ ]
1305
+ },
1306
+ "step": {
1307
+ "$ref": "#/$defs/stepSettings"
1308
+ },
1309
+ "each": {
1310
+ "$ref": "#/$defs/steps",
1311
+ "description": "Steps on \"each\"; they do not continue to the next step."
1312
+ },
1313
+ "onError": {
1314
+ "$ref": "#/$defs/steps",
1315
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1316
+ }
1317
+ },
1318
+ "additionalProperties": false
1319
+ },
1320
+ {
1321
+ "type": "object",
1322
+ "title": "Run Workflow",
1323
+ "required": [
1324
+ "run-workflow"
1325
+ ],
1326
+ "properties": {
1327
+ "id": {
1328
+ "type": "string",
1329
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1330
+ },
1331
+ "run-workflow": {
1332
+ "oneOf": [
1333
+ {
1334
+ "$ref": "#/$defs/config/run-workflow"
1335
+ },
1336
+ {
1337
+ "description": "Shorthand for { \"workflow\": … }",
1338
+ "type": "string"
1339
+ }
1340
+ ]
1341
+ },
1342
+ "step": {
1343
+ "$ref": "#/$defs/stepSettings"
1344
+ },
1345
+ "onError": {
1346
+ "$ref": "#/$defs/steps",
1347
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1348
+ }
1349
+ },
1350
+ "additionalProperties": false
1351
+ },
1352
+ {
1353
+ "type": "object",
1354
+ "title": "Set Variable",
1355
+ "required": [
1356
+ "set-variable"
1357
+ ],
1358
+ "properties": {
1359
+ "id": {
1360
+ "type": "string",
1361
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1362
+ },
1363
+ "set-variable": {
1364
+ "$ref": "#/$defs/config/set-variable"
1365
+ },
1366
+ "step": {
1367
+ "$ref": "#/$defs/stepSettings"
1368
+ },
1369
+ "onError": {
1370
+ "$ref": "#/$defs/steps",
1371
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1372
+ }
1373
+ },
1374
+ "additionalProperties": false
1375
+ },
1376
+ {
1377
+ "type": "object",
1378
+ "title": "Transform",
1379
+ "required": [
1380
+ "transform"
1381
+ ],
1382
+ "properties": {
1383
+ "id": {
1384
+ "type": "string",
1385
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1386
+ },
1387
+ "transform": {
1388
+ "$ref": "#/$defs/config/transform"
1389
+ },
1390
+ "step": {
1391
+ "$ref": "#/$defs/stepSettings"
1392
+ },
1393
+ "onError": {
1394
+ "$ref": "#/$defs/steps",
1395
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1396
+ }
1397
+ },
1398
+ "additionalProperties": false
1399
+ },
1400
+ {
1401
+ "type": "object",
1402
+ "title": "Filter",
1403
+ "required": [
1404
+ "filter"
1405
+ ],
1406
+ "properties": {
1407
+ "id": {
1408
+ "type": "string",
1409
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1410
+ },
1411
+ "filter": {
1412
+ "$ref": "#/$defs/config/filter"
1413
+ },
1414
+ "step": {
1415
+ "$ref": "#/$defs/stepSettings"
1416
+ },
1417
+ "onError": {
1418
+ "$ref": "#/$defs/steps",
1419
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1420
+ }
1421
+ },
1422
+ "additionalProperties": false
1423
+ },
1424
+ {
1425
+ "type": "object",
1426
+ "title": "Data Table",
1427
+ "required": [
1428
+ "data-table"
1429
+ ],
1430
+ "properties": {
1431
+ "id": {
1432
+ "type": "string",
1433
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1434
+ },
1435
+ "data-table": {
1436
+ "$ref": "#/$defs/config/data-table"
1437
+ },
1438
+ "step": {
1439
+ "$ref": "#/$defs/stepSettings"
1440
+ },
1441
+ "onError": {
1442
+ "$ref": "#/$defs/steps",
1443
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1444
+ }
1445
+ },
1446
+ "additionalProperties": false
1447
+ },
1448
+ {
1449
+ "type": "object",
1450
+ "title": "Save to Dataset",
1451
+ "required": [
1452
+ "save-dataset"
1453
+ ],
1454
+ "properties": {
1455
+ "id": {
1456
+ "type": "string",
1457
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1458
+ },
1459
+ "save-dataset": {
1460
+ "$ref": "#/$defs/config/save-dataset"
1461
+ },
1462
+ "step": {
1463
+ "$ref": "#/$defs/stepSettings"
1464
+ },
1465
+ "onError": {
1466
+ "$ref": "#/$defs/steps",
1467
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1468
+ }
1469
+ },
1470
+ "additionalProperties": false
1471
+ },
1472
+ {
1473
+ "type": "object",
1474
+ "title": "Download",
1475
+ "required": [
1476
+ "download"
1477
+ ],
1478
+ "properties": {
1479
+ "id": {
1480
+ "type": "string",
1481
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1482
+ },
1483
+ "download": {
1484
+ "$ref": "#/$defs/config/download"
1485
+ },
1486
+ "step": {
1487
+ "$ref": "#/$defs/stepSettings"
1488
+ },
1489
+ "onError": {
1490
+ "$ref": "#/$defs/steps",
1491
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1492
+ }
1493
+ },
1494
+ "additionalProperties": false
1495
+ },
1496
+ {
1497
+ "type": "object",
1498
+ "title": "Notify",
1499
+ "required": [
1500
+ "notify"
1501
+ ],
1502
+ "properties": {
1503
+ "id": {
1504
+ "type": "string",
1505
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1506
+ },
1507
+ "notify": {
1508
+ "oneOf": [
1509
+ {
1510
+ "$ref": "#/$defs/config/notify"
1511
+ },
1512
+ {
1513
+ "description": "Shorthand for { \"message\": … }",
1514
+ "type": "string"
1515
+ }
1516
+ ]
1517
+ },
1518
+ "step": {
1519
+ "$ref": "#/$defs/stepSettings"
1520
+ },
1521
+ "onError": {
1522
+ "$ref": "#/$defs/steps",
1523
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1524
+ }
1525
+ },
1526
+ "additionalProperties": false
1527
+ },
1528
+ {
1529
+ "type": "object",
1530
+ "title": "HTTP Request",
1531
+ "required": [
1532
+ "http-request"
1533
+ ],
1534
+ "properties": {
1535
+ "id": {
1536
+ "type": "string",
1537
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1538
+ },
1539
+ "http-request": {
1540
+ "$ref": "#/$defs/config/http-request"
1541
+ },
1542
+ "step": {
1543
+ "$ref": "#/$defs/stepSettings"
1544
+ },
1545
+ "onError": {
1546
+ "$ref": "#/$defs/steps",
1547
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1548
+ }
1549
+ },
1550
+ "additionalProperties": false
1551
+ },
1552
+ {
1553
+ "type": "object",
1554
+ "title": "Log",
1555
+ "required": [
1556
+ "log"
1557
+ ],
1558
+ "properties": {
1559
+ "id": {
1560
+ "type": "string",
1561
+ "description": "Optional step id (kept as the node id; shown in run reports). Default s<N> for the Nth step."
1562
+ },
1563
+ "log": {
1564
+ "oneOf": [
1565
+ {
1566
+ "$ref": "#/$defs/config/log"
1567
+ },
1568
+ {
1569
+ "description": "Shorthand for { \"message\": … }",
1570
+ "type": "string"
1571
+ }
1572
+ ]
1573
+ },
1574
+ "step": {
1575
+ "$ref": "#/$defs/stepSettings"
1576
+ },
1577
+ "onError": {
1578
+ "$ref": "#/$defs/steps",
1579
+ "description": "Steps on the error output (sets step.onError to \"port\")."
1580
+ }
1581
+ },
1582
+ "additionalProperties": false
1583
+ }
1584
+ ]
1585
+ },
1586
+ "stepSettings": {
1587
+ "type": "object",
1588
+ "properties": {
1589
+ "timeoutSeconds": {
1590
+ "type": "number",
1591
+ "minimum": 1
1592
+ },
1593
+ "retries": {
1594
+ "type": "integer",
1595
+ "minimum": 0,
1596
+ "maximum": 5
1597
+ },
1598
+ "onError": {
1599
+ "enum": [
1600
+ "stop",
1601
+ "continue",
1602
+ "port"
1603
+ ]
1604
+ },
1605
+ "disabled": {
1606
+ "type": "boolean"
1607
+ },
1608
+ "note": {
1609
+ "type": "string"
1610
+ },
1611
+ "screenshot": {
1612
+ "enum": [
1613
+ "error",
1614
+ "always",
1615
+ "never"
1616
+ ]
1617
+ },
1618
+ "realInput": {
1619
+ "type": "boolean"
1620
+ },
1621
+ "pause": {
1622
+ "type": "boolean"
1623
+ },
1624
+ "trace": {
1625
+ "type": "boolean"
1626
+ }
1627
+ },
1628
+ "additionalProperties": false
1629
+ },
1630
+ "config": {
1631
+ "start": {
1632
+ "type": "object",
1633
+ "description": "Start: Start here when you press Run, with some starting values (also defaults for Run Workflow).",
1634
+ "properties": {
1635
+ "inputs": {
1636
+ "description": "Starting values",
1637
+ "type": "array",
1638
+ "items": {
1639
+ "type": "object",
1640
+ "properties": {
1641
+ "name": {
1642
+ "type": "string",
1643
+ "description": "Name"
1644
+ },
1645
+ "value": {
1646
+ "type": "string",
1647
+ "description": "Value"
1648
+ }
1649
+ },
1650
+ "additionalProperties": false
1651
+ }
1652
+ }
1653
+ },
1654
+ "additionalProperties": false
1655
+ },
1656
+ "timer": {
1657
+ "type": "object",
1658
+ "description": "Timer: Start the flow on a schedule, or delay it when placed after another block.",
1659
+ "properties": {
1660
+ "seconds": {
1661
+ "description": "Under 30 seconds the extension keeps its background worker awake to fire on time (Chromium). 30 seconds or more uses browser alarms. After another block: waits up to 600 s inside the run; longer delays continue as a new run.",
1662
+ "type": "number",
1663
+ "minimum": 1
1664
+ },
1665
+ "repeat": {
1666
+ "description": "Only used when this block starts the flow. After another block it always fires once.",
1667
+ "type": "boolean"
1668
+ }
1669
+ },
1670
+ "additionalProperties": false
1671
+ },
1672
+ "schedule": {
1673
+ "type": "object",
1674
+ "description": "Schedule: Start the flow at set times: daily at 09:00, on weekdays, every hour, every N minutes.",
1675
+ "properties": {
1676
+ "every": {
1677
+ "description": "Every",
1678
+ "enum": [
1679
+ "day",
1680
+ "hour",
1681
+ "minutes"
1682
+ ]
1683
+ },
1684
+ "at": {
1685
+ "description": "For \"day\". Local time of this computer.",
1686
+ "type": "string"
1687
+ },
1688
+ "days": {
1689
+ "description": "For \"day\": every day, weekdays, weekends, or names: mon, wed, fri.",
1690
+ "type": "string"
1691
+ },
1692
+ "minute": {
1693
+ "description": "For \"hour\": minutes past the hour.",
1694
+ "type": "number",
1695
+ "minimum": 0,
1696
+ "maximum": 59
1697
+ },
1698
+ "minutes": {
1699
+ "description": "For \"N minutes\". Runs on the clock (:00, :15, :30…).",
1700
+ "type": "number",
1701
+ "minimum": 1,
1702
+ "maximum": 1440
1703
+ }
1704
+ },
1705
+ "additionalProperties": false
1706
+ },
1707
+ "page-visited": {
1708
+ "type": "object",
1709
+ "description": "Page Visited: Start when you open a matching page (in any tab). That tab becomes \"main\".",
1710
+ "properties": {
1711
+ "url": {
1712
+ "description": "Plain text = the URL contains it; * any part between slashes; ** anything; /…/ regex.",
1713
+ "type": "string"
1714
+ },
1715
+ "when": {
1716
+ "description": "When",
1717
+ "enum": [
1718
+ "load",
1719
+ "any"
1720
+ ]
1721
+ }
1722
+ },
1723
+ "additionalProperties": false
1724
+ },
1725
+ "context-menu": {
1726
+ "type": "object",
1727
+ "description": "Context Menu: Add an item to the right-click menu that starts the flow on that page.",
1728
+ "properties": {
1729
+ "title": {
1730
+ "description": "Menu item",
1731
+ "type": "string"
1732
+ },
1733
+ "contexts": {
1734
+ "description": "Show it when right-clicking",
1735
+ "enum": [
1736
+ "all",
1737
+ "page",
1738
+ "selection",
1739
+ "link",
1740
+ "image"
1741
+ ]
1742
+ }
1743
+ },
1744
+ "additionalProperties": false
1745
+ },
1746
+ "watch-element": {
1747
+ "type": "object",
1748
+ "description": "Watch Element: Fire when the text of a part of a web page changes.",
1749
+ "properties": {
1750
+ "locator": {
1751
+ "description": "Element",
1752
+ "type": "string"
1753
+ },
1754
+ "url": {
1755
+ "description": "Page URL",
1756
+ "type": "string"
1757
+ },
1758
+ "intervalSeconds": {
1759
+ "description": "Only used when this block starts the flow. After a Timer, the Timer decides. Under 30 seconds keeps the background worker awake.",
1760
+ "type": "number",
1761
+ "minimum": 1
1762
+ },
1763
+ "reload": {
1764
+ "description": "Needed to see server-side changes. Turn off for pages that update themselves.",
1765
+ "type": "boolean"
1766
+ },
1767
+ "emitOnFirstRead": {
1768
+ "description": "Off = the first read just records the starting value.",
1769
+ "type": "boolean"
1770
+ }
1771
+ },
1772
+ "additionalProperties": false
1773
+ },
1774
+ "open-url": {
1775
+ "type": "object",
1776
+ "description": "Open Tab: Open a web page, and remember the tab for the next blocks.",
1777
+ "properties": {
1778
+ "url": {
1779
+ "description": "Use {{name}} to insert a value from the previous block.",
1780
+ "type": "string"
1781
+ },
1782
+ "where": {
1783
+ "description": "Open in",
1784
+ "enum": [
1785
+ "new",
1786
+ "workflow",
1787
+ "window",
1788
+ "current"
1789
+ ]
1790
+ },
1791
+ "tab": {
1792
+ "description": "Later blocks find the tab by this name. Use another name (e.g. \"admin\") for a second tab.",
1793
+ "type": "string"
1794
+ },
1795
+ "active": {
1796
+ "description": "Off = open quietly in the background.",
1797
+ "type": "boolean"
1798
+ },
1799
+ "waitUntil": {
1800
+ "description": "Continue when",
1801
+ "enum": [
1802
+ "load",
1803
+ "networkidle",
1804
+ "none"
1805
+ ]
1806
+ }
1807
+ },
1808
+ "additionalProperties": false
1809
+ },
1810
+ "navigate": {
1811
+ "type": "object",
1812
+ "description": "Navigate: Go to a URL, back, forward, or reload, in a tab of this run.",
1813
+ "properties": {
1814
+ "tab": {
1815
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
1816
+ "type": "string"
1817
+ },
1818
+ "action": {
1819
+ "description": "Action",
1820
+ "enum": [
1821
+ "goto",
1822
+ "back",
1823
+ "forward",
1824
+ "reload"
1825
+ ]
1826
+ },
1827
+ "url": {
1828
+ "description": "URL",
1829
+ "type": "string"
1830
+ },
1831
+ "waitUntil": {
1832
+ "description": "Continue when",
1833
+ "enum": [
1834
+ "load",
1835
+ "networkidle",
1836
+ "none"
1837
+ ]
1838
+ }
1839
+ },
1840
+ "additionalProperties": false
1841
+ },
1842
+ "wait-for-popup": {
1843
+ "type": "object",
1844
+ "description": "Wait for Popup: Catch a new tab or window the page opened, and name it for the next blocks.",
1845
+ "properties": {
1846
+ "tab": {
1847
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
1848
+ "type": "string"
1849
+ },
1850
+ "name": {
1851
+ "description": "Call the new tab",
1852
+ "type": "string"
1853
+ },
1854
+ "waitUntil": {
1855
+ "description": "Continue when",
1856
+ "enum": [
1857
+ "load",
1858
+ "networkidle",
1859
+ "none"
1860
+ ]
1861
+ }
1862
+ },
1863
+ "additionalProperties": false
1864
+ },
1865
+ "wait-for-download": {
1866
+ "type": "object",
1867
+ "description": "Wait for Download: Wait until the page downloads a file (an export, a report) and get its name, size and type. Can read CSV / JSON / text files.",
1868
+ "properties": {
1869
+ "url": {
1870
+ "description": "Empty = the first download. Plain text: the address or file name contains it; * and /regex/ as in Wait For.",
1871
+ "type": "string"
1872
+ },
1873
+ "read": {
1874
+ "description": "Extensions cannot open files on disk, so the file is fetched again from its address (with the site's cookies). Fine for exports; a link that makes a new file each time gives that new file.",
1875
+ "enum": [
1876
+ "none",
1877
+ "text",
1878
+ "csv",
1879
+ "json"
1880
+ ]
1881
+ },
1882
+ "dataset": {
1883
+ "description": "CSV rows, or a JSON list, replace this dataset.",
1884
+ "type": "string"
1885
+ },
1886
+ "tab": {
1887
+ "description": "The tab that starts the download. Needed only to read files the page made itself (blob: addresses).",
1888
+ "type": "string"
1889
+ }
1890
+ },
1891
+ "additionalProperties": false
1892
+ },
1893
+ "cookies-storage": {
1894
+ "type": "object",
1895
+ "description": "Cookies & Storage: Read, set, delete or clear a site's cookies, or the page's localStorage / sessionStorage.",
1896
+ "properties": {
1897
+ "action": {
1898
+ "description": "Do",
1899
+ "enum": [
1900
+ "get",
1901
+ "set",
1902
+ "delete",
1903
+ "clear"
1904
+ ]
1905
+ },
1906
+ "area": {
1907
+ "description": "In",
1908
+ "enum": [
1909
+ "cookies",
1910
+ "local",
1911
+ "session"
1912
+ ]
1913
+ },
1914
+ "name": {
1915
+ "description": "Needed to set or delete. For get: empty = all of them.",
1916
+ "type": "string"
1917
+ },
1918
+ "value": {
1919
+ "description": "For set.",
1920
+ "type": "string"
1921
+ },
1922
+ "url": {
1923
+ "description": "Whose cookies. Empty = the page open in the tab.",
1924
+ "type": "string"
1925
+ },
1926
+ "domain": {
1927
+ "description": "With a leading dot the cookie is also sent to subdomains.",
1928
+ "type": "string"
1929
+ },
1930
+ "path": {
1931
+ "description": "Path (set, optional)",
1932
+ "type": "string"
1933
+ },
1934
+ "maxAgeSeconds": {
1935
+ "description": "0 = a session cookie, gone when the browser closes.",
1936
+ "type": "number",
1937
+ "minimum": 0
1938
+ },
1939
+ "httpOnly": {
1940
+ "description": "HttpOnly (set)",
1941
+ "type": "boolean"
1942
+ },
1943
+ "secure": {
1944
+ "description": "Secure (set)",
1945
+ "type": "boolean"
1946
+ },
1947
+ "sameSite": {
1948
+ "description": "SameSite (set)",
1949
+ "enum": [
1950
+ "",
1951
+ "Lax",
1952
+ "Strict",
1953
+ "None"
1954
+ ]
1955
+ },
1956
+ "tab": {
1957
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
1958
+ "type": "string"
1959
+ }
1960
+ },
1961
+ "additionalProperties": false
1962
+ },
1963
+ "route": {
1964
+ "type": "object",
1965
+ "description": "Route: Mock, block or modify page requests for this run. Newest matching rule wins; clear removes the tab’s rules.",
1966
+ "properties": {
1967
+ "action": {
1968
+ "description": "Do",
1969
+ "enum": [
1970
+ "add",
1971
+ "clear"
1972
+ ]
1973
+ },
1974
+ "backend": {
1975
+ "description": "Use",
1976
+ "enum": [
1977
+ "auto",
1978
+ "cdp",
1979
+ "dnr"
1980
+ ]
1981
+ },
1982
+ "rules": {
1983
+ "description": "An array: url pattern, optional method, action, optional status/headers/body/redirectUrl/delayMs. Last matching rule wins. CDP modify changes the outgoing request; browser rules support abort/redirect without delays.",
1984
+ "type": "string"
1985
+ },
1986
+ "tab": {
1987
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
1988
+ "type": "string"
1989
+ }
1990
+ },
1991
+ "additionalProperties": false
1992
+ },
1993
+ "har-record": {
1994
+ "type": "object",
1995
+ "description": "HAR Record: Start or stop recording network metadata as HAR 1.2. Chromium only; bodies, cookies and headers are excluded.",
1996
+ "properties": {
1997
+ "action": {
1998
+ "description": "Do",
1999
+ "enum": [
2000
+ "start",
2001
+ "stop"
2002
+ ]
2003
+ },
2004
+ "dataset": {
2005
+ "description": "Replaces this dataset with the HAR entries.",
2006
+ "type": "string"
2007
+ },
2008
+ "filename": {
2009
+ "description": "Leave blank to return the HAR without downloading it.",
2010
+ "type": "string"
2011
+ },
2012
+ "tab": {
2013
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2014
+ "type": "string"
2015
+ }
2016
+ },
2017
+ "additionalProperties": false
2018
+ },
2019
+ "emulate": {
2020
+ "type": "object",
2021
+ "description": "Emulate: Chromium only: change viewport/device, locale, timezone, location, media preferences or offline state until this run ends. Location still needs the site’s permission.",
2022
+ "properties": {
2023
+ "action": {
2024
+ "description": "Do",
2025
+ "enum": [
2026
+ "set",
2027
+ "clear"
2028
+ ]
2029
+ },
2030
+ "device": {
2031
+ "description": "Device preset",
2032
+ "enum": [
2033
+ "",
2034
+ "iphone",
2035
+ "pixel",
2036
+ "ipad",
2037
+ "desktop"
2038
+ ]
2039
+ },
2040
+ "width": {
2041
+ "description": "0 uses the preset/default. Supply width and height together.",
2042
+ "type": "number",
2043
+ "minimum": 0,
2044
+ "maximum": 10000
2045
+ },
2046
+ "height": {
2047
+ "description": "Viewport height",
2048
+ "type": "number",
2049
+ "minimum": 0,
2050
+ "maximum": 10000
2051
+ },
2052
+ "deviceScaleFactor": {
2053
+ "description": "0 uses the preset/default.",
2054
+ "type": "number",
2055
+ "minimum": 0,
2056
+ "maximum": 8
2057
+ },
2058
+ "userAgent": {
2059
+ "description": "Optional override of the preset user agent. Changes may need a later Navigate/reload.",
2060
+ "type": "string"
2061
+ },
2062
+ "locale": {
2063
+ "description": "Intl locale and language override; reload for page code that reads language at startup.",
2064
+ "type": "string"
2065
+ },
2066
+ "timezone": {
2067
+ "description": "Timezone",
2068
+ "type": "string"
2069
+ },
2070
+ "latitude": {
2071
+ "description": "Latitude",
2072
+ "type": "string"
2073
+ },
2074
+ "longitude": {
2075
+ "description": "Both coordinates required. This does not grant the site geolocation permission.",
2076
+ "type": "string"
2077
+ },
2078
+ "accuracy": {
2079
+ "description": "Location accuracy (metres)",
2080
+ "type": "number",
2081
+ "minimum": 0
2082
+ },
2083
+ "colorScheme": {
2084
+ "description": "Color scheme",
2085
+ "enum": [
2086
+ "",
2087
+ "light",
2088
+ "dark"
2089
+ ]
2090
+ },
2091
+ "reducedMotion": {
2092
+ "description": "Reduced motion",
2093
+ "enum": [
2094
+ "",
2095
+ "reduce",
2096
+ "no-preference"
2097
+ ]
2098
+ },
2099
+ "offline": {
2100
+ "description": "Blocks network requests from this tab. Cleared automatically at run end.",
2101
+ "type": "boolean"
2102
+ },
2103
+ "tab": {
2104
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2105
+ "type": "string"
2106
+ }
2107
+ },
2108
+ "additionalProperties": false
2109
+ },
2110
+ "clear-site-data": {
2111
+ "type": "object",
2112
+ "description": "Clear Site Data: Chromium only: delete cookies, local storage, IndexedDB, Cache Storage and service workers for listed sites. Cookie deletion affects the whole registrable domain, including its subdomains.",
2113
+ "properties": {
2114
+ "origins": {
2115
+ "description": "Explicit HTTP(S) origins only, separated by newlines or commas. Deletion is permanent. Cookies are cleared for each whole registrable domain, including subdomains; other storage is filtered by origin. Never clears history, downloads, passwords or extension data.",
2116
+ "type": "string"
2117
+ }
2118
+ },
2119
+ "additionalProperties": false
2120
+ },
2121
+ "close-tab": {
2122
+ "type": "object",
2123
+ "description": "Close Tab: Close a tab this run opened.",
2124
+ "properties": {
2125
+ "tab": {
2126
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2127
+ "type": "string"
2128
+ }
2129
+ },
2130
+ "additionalProperties": false
2131
+ },
2132
+ "click": {
2133
+ "type": "object",
2134
+ "description": "Click: Click (or double-click, right-click, hover) an element, with any button, modifier keys and position. Waits until it can be clicked.",
2135
+ "properties": {
2136
+ "locator": {
2137
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2138
+ "type": "string"
2139
+ },
2140
+ "action": {
2141
+ "description": "Action",
2142
+ "enum": [
2143
+ "click",
2144
+ "double",
2145
+ "right",
2146
+ "hover"
2147
+ ]
2148
+ },
2149
+ "button": {
2150
+ "description": "For \"click\". Right-click always uses the right button.",
2151
+ "enum": [
2152
+ "left",
2153
+ "middle",
2154
+ "right"
2155
+ ]
2156
+ },
2157
+ "modifiers": {
2158
+ "description": "Modifier keys held during the click: Alt, Control, Meta, Shift (joined with + or commas). Empty = none.",
2159
+ "type": "string"
2160
+ },
2161
+ "position": {
2162
+ "description": "Where to click: x,y in pixels from the element’s top-left corner. Empty = its center.",
2163
+ "type": "string"
2164
+ },
2165
+ "clickCount": {
2166
+ "description": "Presses in a row (3 = triple click, selects a paragraph). Double-click means at least 2.",
2167
+ "type": "number",
2168
+ "minimum": 1,
2169
+ "maximum": 10
2170
+ },
2171
+ "force": {
2172
+ "description": "Click even if the element looks hidden, disabled or covered. Only for stubborn pages.",
2173
+ "type": "boolean"
2174
+ },
2175
+ "tab": {
2176
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2177
+ "type": "string"
2178
+ }
2179
+ },
2180
+ "additionalProperties": false
2181
+ },
2182
+ "fill": {
2183
+ "type": "object",
2184
+ "description": "Fill: Type a value into a text field. Works with React, Vue and Angular forms.",
2185
+ "properties": {
2186
+ "locator": {
2187
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2188
+ "type": "string"
2189
+ },
2190
+ "value": {
2191
+ "description": "Value",
2192
+ "type": "string"
2193
+ },
2194
+ "mode": {
2195
+ "description": "How",
2196
+ "enum": [
2197
+ "fill",
2198
+ "type"
2199
+ ]
2200
+ },
2201
+ "tab": {
2202
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2203
+ "type": "string"
2204
+ }
2205
+ },
2206
+ "additionalProperties": false
2207
+ },
2208
+ "fill-form": {
2209
+ "type": "object",
2210
+ "description": "Fill Form: Fill several fields at once: text, selects, checkboxes. Optionally click submit.",
2211
+ "properties": {
2212
+ "fields": {
2213
+ "description": "Empty values are skipped. Selects take the option text or value; checkboxes take true or false.",
2214
+ "type": "array",
2215
+ "items": {
2216
+ "type": "object",
2217
+ "properties": {
2218
+ "locator": {
2219
+ "type": "string",
2220
+ "description": "Field"
2221
+ },
2222
+ "value": {
2223
+ "type": "string",
2224
+ "description": "Value"
2225
+ }
2226
+ },
2227
+ "additionalProperties": false
2228
+ }
2229
+ },
2230
+ "submit": {
2231
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2232
+ "type": "string"
2233
+ },
2234
+ "tab": {
2235
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2236
+ "type": "string"
2237
+ }
2238
+ },
2239
+ "additionalProperties": false
2240
+ },
2241
+ "select-option": {
2242
+ "type": "object",
2243
+ "description": "Select Option: Choose an option in a dropdown (<select>), by its text or value.",
2244
+ "properties": {
2245
+ "locator": {
2246
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2247
+ "type": "string"
2248
+ },
2249
+ "value": {
2250
+ "description": "Several for a multi-select: separate with |",
2251
+ "type": "string"
2252
+ },
2253
+ "tab": {
2254
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2255
+ "type": "string"
2256
+ }
2257
+ },
2258
+ "additionalProperties": false
2259
+ },
2260
+ "check": {
2261
+ "type": "object",
2262
+ "description": "Check: Tick or untick a checkbox, radio button or switch. Does nothing if it already is.",
2263
+ "properties": {
2264
+ "locator": {
2265
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2266
+ "type": "string"
2267
+ },
2268
+ "state": {
2269
+ "description": "Make it",
2270
+ "enum": [
2271
+ "check",
2272
+ "uncheck"
2273
+ ]
2274
+ },
2275
+ "tab": {
2276
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2277
+ "type": "string"
2278
+ }
2279
+ },
2280
+ "additionalProperties": false
2281
+ },
2282
+ "press-key": {
2283
+ "type": "object",
2284
+ "description": "Press Key: Press a key or shortcut (Enter, Tab, Escape, Control+A…), or insert text at the caret.",
2285
+ "properties": {
2286
+ "mode": {
2287
+ "description": "Do",
2288
+ "enum": [
2289
+ "key",
2290
+ "text"
2291
+ ]
2292
+ },
2293
+ "key": {
2294
+ "description": "Key names as on the keyboard: Enter, Tab, Escape, Backspace, ArrowDown, a, Control+A, Shift+Tab, Control+Shift+K. ControlOrMeta+A is ⌘A on a Mac, Ctrl+A elsewhere.",
2295
+ "type": "string"
2296
+ },
2297
+ "text": {
2298
+ "description": "For \"insert text\": typed at the caret in one go, like pasting.",
2299
+ "type": "string"
2300
+ },
2301
+ "locator": {
2302
+ "description": "Focus this element first. Empty = whatever has focus.",
2303
+ "type": "string"
2304
+ },
2305
+ "tab": {
2306
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2307
+ "type": "string"
2308
+ }
2309
+ },
2310
+ "additionalProperties": false
2311
+ },
2312
+ "drag": {
2313
+ "type": "object",
2314
+ "description": "Drag: Drag an element onto another one: sortable lists, kanban cards, sliders, drop targets.",
2315
+ "properties": {
2316
+ "from": {
2317
+ "description": "The element to pick up (a card, a list item, a slider handle).",
2318
+ "type": "string"
2319
+ },
2320
+ "to": {
2321
+ "description": "The element to drop it on (another item, a column, a spot on the slider track).",
2322
+ "type": "string"
2323
+ },
2324
+ "fromPosition": {
2325
+ "description": "x,y in pixels from the top-left corner of \"Drag this\". Empty = its center.",
2326
+ "type": "string"
2327
+ },
2328
+ "toPosition": {
2329
+ "description": "x,y in pixels from the top-left corner of \"Drop on\". Empty = its center.",
2330
+ "type": "string"
2331
+ },
2332
+ "modifiers": {
2333
+ "description": "Modifier keys held during the drag: Alt, Control, Meta, Shift.",
2334
+ "type": "string"
2335
+ },
2336
+ "tab": {
2337
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2338
+ "type": "string"
2339
+ }
2340
+ },
2341
+ "additionalProperties": false
2342
+ },
2343
+ "element-action": {
2344
+ "type": "object",
2345
+ "description": "Element Action: Focus, blur, clear, scroll into view, or dispatch an event (click, input, a custom event) on an element.",
2346
+ "properties": {
2347
+ "locator": {
2348
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2349
+ "type": "string"
2350
+ },
2351
+ "action": {
2352
+ "description": "Action",
2353
+ "enum": [
2354
+ "focus",
2355
+ "blur",
2356
+ "clear",
2357
+ "scroll-into-view",
2358
+ "dispatch-event"
2359
+ ]
2360
+ },
2361
+ "eventType": {
2362
+ "description": "For \"dispatch an event\". Bubbles, cancelable and composed.",
2363
+ "type": "string"
2364
+ },
2365
+ "detail": {
2366
+ "description": "For \"dispatch an event\". Built-in types (click, keydown, input, focus, drag…): the event’s properties. Other types are a CustomEvent and this is its event.detail.",
2367
+ "type": "string"
2368
+ },
2369
+ "tab": {
2370
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2371
+ "type": "string"
2372
+ }
2373
+ },
2374
+ "additionalProperties": false
2375
+ },
2376
+ "upload-file": {
2377
+ "type": "object",
2378
+ "description": "Upload File: Choose a file for a file input or drop it on a drop zone, without the file dialog: text you write, a file from a URL, or base64 data.",
2379
+ "properties": {
2380
+ "locator": {
2381
+ "description": "The <input type=\"file\"> (hidden ones work too) or its label; with \"drop zone\", the area files are dropped on.",
2382
+ "type": "string"
2383
+ },
2384
+ "target": {
2385
+ "description": "Put it",
2386
+ "enum": [
2387
+ "input",
2388
+ "dropzone"
2389
+ ]
2390
+ },
2391
+ "source": {
2392
+ "description": "File",
2393
+ "enum": [
2394
+ "text",
2395
+ "url",
2396
+ "data"
2397
+ ]
2398
+ },
2399
+ "content": {
2400
+ "description": "For \"text\".",
2401
+ "type": "string"
2402
+ },
2403
+ "url": {
2404
+ "description": "For \"download\".",
2405
+ "type": "string"
2406
+ },
2407
+ "data": {
2408
+ "description": "For \"base64 data\": base64 or a data: URL, usually {{body64}} from HTTP Request with \"Response as: base64\".",
2409
+ "type": "string"
2410
+ },
2411
+ "filename": {
2412
+ "description": "Empty with a URL = the name in the URL.",
2413
+ "type": "string"
2414
+ },
2415
+ "mime": {
2416
+ "description": "For \"text\" and \"base64 data\" ({{mime}} after HTTP Request; a data: URL brings its own). With a URL the server says.",
2417
+ "type": "string"
2418
+ },
2419
+ "tab": {
2420
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2421
+ "type": "string"
2422
+ }
2423
+ },
2424
+ "additionalProperties": false
2425
+ },
2426
+ "scroll": {
2427
+ "type": "object",
2428
+ "description": "Scroll: Scroll to the bottom, top or an element; or keep scrolling until no more content loads.",
2429
+ "properties": {
2430
+ "to": {
2431
+ "description": "Scroll",
2432
+ "enum": [
2433
+ "end",
2434
+ "bottom",
2435
+ "top",
2436
+ "element"
2437
+ ]
2438
+ },
2439
+ "locator": {
2440
+ "description": "Only for \"to an element\".",
2441
+ "type": "string"
2442
+ },
2443
+ "maxScrolls": {
2444
+ "description": "At most (scrolls)",
2445
+ "type": "number",
2446
+ "minimum": 1
2447
+ },
2448
+ "pauseMs": {
2449
+ "description": "Wait between scrolls (ms)",
2450
+ "type": "number",
2451
+ "minimum": 100
2452
+ },
2453
+ "tab": {
2454
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2455
+ "type": "string"
2456
+ }
2457
+ },
2458
+ "additionalProperties": false
2459
+ },
2460
+ "dialogs": {
2461
+ "type": "object",
2462
+ "description": "Dialogs: Answer alert / confirm / prompt boxes automatically, or read what they said.",
2463
+ "properties": {
2464
+ "action": {
2465
+ "description": "From now on",
2466
+ "enum": [
2467
+ "accept",
2468
+ "dismiss",
2469
+ "read"
2470
+ ]
2471
+ },
2472
+ "text": {
2473
+ "description": "Text for prompts",
2474
+ "type": "string"
2475
+ },
2476
+ "tab": {
2477
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2478
+ "type": "string"
2479
+ }
2480
+ },
2481
+ "additionalProperties": false
2482
+ },
2483
+ "wait-for": {
2484
+ "type": "object",
2485
+ "description": "Wait For: Wait until an element appears or goes, some text shows, the URL changes, or the page settles.",
2486
+ "properties": {
2487
+ "mode": {
2488
+ "description": "Wait until",
2489
+ "enum": [
2490
+ "visible",
2491
+ "hidden",
2492
+ "attached",
2493
+ "detached",
2494
+ "enabled",
2495
+ "text",
2496
+ "no-text",
2497
+ "url",
2498
+ "load",
2499
+ "networkidle",
2500
+ "response",
2501
+ "request"
2502
+ ]
2503
+ },
2504
+ "locator": {
2505
+ "description": "For the element modes. For text: only look inside this element (optional).",
2506
+ "type": "string"
2507
+ },
2508
+ "text": {
2509
+ "description": "Text",
2510
+ "type": "string"
2511
+ },
2512
+ "url": {
2513
+ "description": "Plain text: the URL contains it. * matches any part between slashes, ** anything. /…/ is a regular expression. Also the request address for the network modes.",
2514
+ "type": "string"
2515
+ },
2516
+ "status": {
2517
+ "description": "For \"a network request finishes\".",
2518
+ "type": "string"
2519
+ },
2520
+ "method": {
2521
+ "description": "For the network modes. Empty = any.",
2522
+ "type": "string"
2523
+ },
2524
+ "captureBody": {
2525
+ "description": "For \"a network request finishes\". Chrome, Edge, Brave only (debugger permission). Only responses that start after this block starts can be read, so it suits slow or later requests.",
2526
+ "type": "boolean"
2527
+ },
2528
+ "tab": {
2529
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2530
+ "type": "string"
2531
+ }
2532
+ },
2533
+ "additionalProperties": false
2534
+ },
2535
+ "run-script": {
2536
+ "type": "object",
2537
+ "description": "Run Script: Run your own JavaScript in the page; its return value is saved. Chrome 135+.",
2538
+ "properties": {
2539
+ "code": {
2540
+ "description": "An async function body: use await, read `data`, and `return` a JSON value.",
2541
+ "type": "string"
2542
+ },
2543
+ "into": {
2544
+ "description": "Save the result as",
2545
+ "type": "string"
2546
+ },
2547
+ "tab": {
2548
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2549
+ "type": "string"
2550
+ }
2551
+ },
2552
+ "additionalProperties": false
2553
+ },
2554
+ "read-element": {
2555
+ "type": "object",
2556
+ "description": "Read Element: Read a value from a page: text, attribute, class, whether it exists, or how many.",
2557
+ "properties": {
2558
+ "locator": {
2559
+ "description": "Element",
2560
+ "type": "string"
2561
+ },
2562
+ "url": {
2563
+ "description": "BlockFlow opens it in its own background tab. Leave empty to read the run's tab instead (see Tab).",
2564
+ "type": "string"
2565
+ },
2566
+ "tab": {
2567
+ "description": "Used when Page URL is empty: read from this tab of the run (from Open Tab), as it is now, without reloading.",
2568
+ "type": "string"
2569
+ },
2570
+ "read": {
2571
+ "description": "Read",
2572
+ "enum": [
2573
+ "text",
2574
+ "value",
2575
+ "attribute",
2576
+ "has-class",
2577
+ "exists",
2578
+ "count"
2579
+ ]
2580
+ },
2581
+ "name": {
2582
+ "description": "Only for \"an attribute\" and \"has a class\".",
2583
+ "type": "string"
2584
+ },
2585
+ "reload": {
2586
+ "description": "Reload page before reading",
2587
+ "type": "boolean"
2588
+ }
2589
+ },
2590
+ "additionalProperties": false
2591
+ },
2592
+ "extract-list": {
2593
+ "type": "object",
2594
+ "description": "Extract List: Scrape repeated items (cards, results, rows) into a list of objects.",
2595
+ "properties": {
2596
+ "locator": {
2597
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2598
+ "type": "string"
2599
+ },
2600
+ "fields": {
2601
+ "description": "No fields = each item's text as {text}. Links (href, src) come back as full URLs.",
2602
+ "type": "array",
2603
+ "items": {
2604
+ "type": "object",
2605
+ "properties": {
2606
+ "name": {
2607
+ "type": "string",
2608
+ "description": "Name"
2609
+ },
2610
+ "locator": {
2611
+ "type": "string",
2612
+ "description": "Inside the item"
2613
+ },
2614
+ "attribute": {
2615
+ "type": "string",
2616
+ "description": "Attribute"
2617
+ }
2618
+ },
2619
+ "additionalProperties": false
2620
+ }
2621
+ },
2622
+ "limit": {
2623
+ "description": "At most (0 = all)",
2624
+ "type": "number",
2625
+ "minimum": 0
2626
+ },
2627
+ "into": {
2628
+ "description": "Save the list as",
2629
+ "type": "string"
2630
+ },
2631
+ "source": {
2632
+ "description": "From",
2633
+ "enum": [
2634
+ "tab",
2635
+ "html"
2636
+ ]
2637
+ },
2638
+ "html": {
2639
+ "description": "Only for \"HTML in the data\".",
2640
+ "type": "string"
2641
+ },
2642
+ "baseUrl": {
2643
+ "description": "Makes relative links absolute (HTML mode).",
2644
+ "type": "string"
2645
+ },
2646
+ "tab": {
2647
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2648
+ "type": "string"
2649
+ }
2650
+ },
2651
+ "additionalProperties": false
2652
+ },
2653
+ "extract-table": {
2654
+ "type": "object",
2655
+ "description": "Extract Table: Read an HTML table into a list of rows, keyed by its column headers.",
2656
+ "properties": {
2657
+ "locator": {
2658
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2659
+ "type": "string"
2660
+ },
2661
+ "into": {
2662
+ "description": "Save the rows as",
2663
+ "type": "string"
2664
+ },
2665
+ "source": {
2666
+ "description": "From",
2667
+ "enum": [
2668
+ "tab",
2669
+ "html"
2670
+ ]
2671
+ },
2672
+ "html": {
2673
+ "description": "Only for \"HTML in the data\".",
2674
+ "type": "string"
2675
+ },
2676
+ "baseUrl": {
2677
+ "description": "Makes relative links absolute (HTML mode).",
2678
+ "type": "string"
2679
+ },
2680
+ "tab": {
2681
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2682
+ "type": "string"
2683
+ }
2684
+ },
2685
+ "additionalProperties": false
2686
+ },
2687
+ "paginate": {
2688
+ "type": "object",
2689
+ "description": "Paginate: Run \"each\" on every page of a paged list, clicking Next in between.",
2690
+ "properties": {
2691
+ "locator": {
2692
+ "description": "CSS, or text=…, role=…[name=\"…\"], label=…, placeholder=…, testid=…, A >> B, >> nth=0. Or press 🎯 Pick.",
2693
+ "type": "string"
2694
+ },
2695
+ "maxPages": {
2696
+ "description": "At most (pages)",
2697
+ "type": "number",
2698
+ "minimum": 1
2699
+ },
2700
+ "tab": {
2701
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2702
+ "type": "string"
2703
+ }
2704
+ },
2705
+ "additionalProperties": false
2706
+ },
2707
+ "page-info": {
2708
+ "type": "object",
2709
+ "description": "Page Info: Read the page itself: title, meta tags, JSON-LD, or its localStorage / cookies.",
2710
+ "properties": {
2711
+ "area": {
2712
+ "description": "Read",
2713
+ "enum": [
2714
+ "page",
2715
+ "local",
2716
+ "session",
2717
+ "cookies"
2718
+ ]
2719
+ },
2720
+ "key": {
2721
+ "description": "Storage and cookies: one key. Empty = all of them.",
2722
+ "type": "string"
2723
+ },
2724
+ "tab": {
2725
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2726
+ "type": "string"
2727
+ }
2728
+ },
2729
+ "additionalProperties": false
2730
+ },
2731
+ "page-snapshot": {
2732
+ "type": "object",
2733
+ "description": "Page Snapshot: Outline of what is on the page (roles, names, a locator for each element), to write steps from or keep with the run.",
2734
+ "properties": {
2735
+ "locator": {
2736
+ "description": "Only this element and what is inside it. Empty = the whole page.",
2737
+ "type": "string"
2738
+ },
2739
+ "maxLines": {
2740
+ "description": "Long pages are cut here, with a note.",
2741
+ "type": "number",
2742
+ "minimum": 10,
2743
+ "maximum": 10000
2744
+ },
2745
+ "tab": {
2746
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2747
+ "type": "string"
2748
+ }
2749
+ },
2750
+ "additionalProperties": false
2751
+ },
2752
+ "screenshot": {
2753
+ "type": "object",
2754
+ "description": "Screenshot: Take a picture of what the tab shows, the whole page, or one element. Shown on the step and in the report.",
2755
+ "properties": {
2756
+ "area": {
2757
+ "description": "Take",
2758
+ "enum": [
2759
+ "visible",
2760
+ "full",
2761
+ "element"
2762
+ ]
2763
+ },
2764
+ "locator": {
2765
+ "description": "For \"one element\". It is scrolled into view first.",
2766
+ "type": "string"
2767
+ },
2768
+ "format": {
2769
+ "description": "Format",
2770
+ "enum": [
2771
+ "png",
2772
+ "jpeg"
2773
+ ]
2774
+ },
2775
+ "quality": {
2776
+ "description": "JPEG quality",
2777
+ "type": "number",
2778
+ "minimum": 1,
2779
+ "maximum": 100
2780
+ },
2781
+ "compare": {
2782
+ "description": "Visual check: the first run keeps the picture as this block's baseline; later runs fail (visual.mismatch) when it looks different. PNG only.",
2783
+ "type": "boolean"
2784
+ },
2785
+ "threshold": {
2786
+ "description": "How different a pixel's colour must be to count, 0 to 1 (0.2 like Playwright; 0 = any change).",
2787
+ "type": "number",
2788
+ "minimum": 0,
2789
+ "maximum": 1
2790
+ },
2791
+ "maxDiffRatio": {
2792
+ "description": "Share of pixels that may differ, 0 to 1 (0.01 = 1%). 0 = none.",
2793
+ "type": "number",
2794
+ "minimum": 0,
2795
+ "maximum": 1
2796
+ },
2797
+ "mask": {
2798
+ "description": "Parts that change on their own (a clock, an ad): an element locator, or \"x, y, width, height\" in CSS pixels from the picture's top-left.",
2799
+ "type": "array",
2800
+ "items": {
2801
+ "type": "object",
2802
+ "properties": {
2803
+ "region": {
2804
+ "type": "string",
2805
+ "description": "Element or x, y, width, height"
2806
+ }
2807
+ },
2808
+ "additionalProperties": false
2809
+ }
2810
+ },
2811
+ "updateBaseline": {
2812
+ "description": "Save this run's picture as the new baseline and pass (like Playwright's --update-snapshots). Switch it off again after.",
2813
+ "type": "boolean"
2814
+ },
2815
+ "tab": {
2816
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2817
+ "type": "string"
2818
+ }
2819
+ },
2820
+ "additionalProperties": false
2821
+ },
2822
+ "assert": {
2823
+ "type": "object",
2824
+ "description": "Assert: Check that something is true. Fails the run (or just records it, if soft) when it is not.",
2825
+ "properties": {
2826
+ "subject": {
2827
+ "description": "Check",
2828
+ "enum": [
2829
+ "text",
2830
+ "input",
2831
+ "attribute",
2832
+ "count",
2833
+ "visible",
2834
+ "hidden",
2835
+ "checked",
2836
+ "unchecked",
2837
+ "enabled",
2838
+ "disabled",
2839
+ "focused",
2840
+ "editable",
2841
+ "in-viewport",
2842
+ "class",
2843
+ "css",
2844
+ "accessible-name",
2845
+ "accessible-description",
2846
+ "aria-snapshot",
2847
+ "url",
2848
+ "title",
2849
+ "console-errors",
2850
+ "value"
2851
+ ]
2852
+ },
2853
+ "locator": {
2854
+ "description": "For element checks. For \"ARIA snapshot\": the part of the page (empty = the whole page).",
2855
+ "type": "string"
2856
+ },
2857
+ "name": {
2858
+ "description": "The attribute name for \"attribute of an element\", the CSS property (color, display…) for \"CSS value\".",
2859
+ "type": "string"
2860
+ },
2861
+ "value": {
2862
+ "description": "Only for \"a value from the data\".",
2863
+ "type": "string"
2864
+ },
2865
+ "operator": {
2866
+ "description": "Not used by the yes/no checks (visible, checked…).",
2867
+ "enum": [
2868
+ "equals",
2869
+ "not-equals",
2870
+ "contains",
2871
+ "not-contains",
2872
+ "starts-with",
2873
+ "ends-with",
2874
+ "matches",
2875
+ "greater",
2876
+ "greater-equal",
2877
+ "less",
2878
+ "less-equal",
2879
+ "empty",
2880
+ "not-empty",
2881
+ "true",
2882
+ "false"
2883
+ ]
2884
+ },
2885
+ "expected": {
2886
+ "description": "For \"ARIA snapshot\": a template, one line per element, nested by indenting: - heading \"Welcome\" [level=1], - button /Sign (in|up)/, - listitem: Apples.",
2887
+ "type": "string"
2888
+ },
2889
+ "message": {
2890
+ "description": "Message when it fails",
2891
+ "type": "string"
2892
+ },
2893
+ "soft": {
2894
+ "description": "Soft: record the failure but keep going",
2895
+ "type": "boolean"
2896
+ },
2897
+ "tab": {
2898
+ "description": "The name an Open Tab block gave the tab earlier in this run. Usually \"main\".",
2899
+ "type": "string"
2900
+ }
2901
+ },
2902
+ "additionalProperties": false
2903
+ },
2904
+ "manual-step": {
2905
+ "type": "object",
2906
+ "description": "Manual Step: Pause until you press Continue: solve a CAPTCHA, type a 2FA code, take a look.",
2907
+ "properties": {
2908
+ "message": {
2909
+ "description": "What to do",
2910
+ "type": "string"
2911
+ }
2912
+ },
2913
+ "additionalProperties": false
2914
+ },
2915
+ "stop": {
2916
+ "type": "object",
2917
+ "description": "Stop: End this path here: as passed, or as failed with a message.",
2918
+ "properties": {
2919
+ "outcome": {
2920
+ "description": "End as",
2921
+ "enum": [
2922
+ "fail",
2923
+ "pass"
2924
+ ]
2925
+ },
2926
+ "message": {
2927
+ "description": "Message",
2928
+ "type": "string"
2929
+ }
2930
+ },
2931
+ "additionalProperties": false
2932
+ },
2933
+ "if": {
2934
+ "type": "object",
2935
+ "description": "If: Go one way when a condition is true, another when it is false.",
2936
+ "properties": {
2937
+ "left": {
2938
+ "description": "Value",
2939
+ "type": "string"
2940
+ },
2941
+ "operator": {
2942
+ "description": "Condition",
2943
+ "enum": [
2944
+ "equals",
2945
+ "not-equals",
2946
+ "contains",
2947
+ "not-contains",
2948
+ "starts-with",
2949
+ "ends-with",
2950
+ "matches",
2951
+ "greater",
2952
+ "greater-equal",
2953
+ "less",
2954
+ "less-equal",
2955
+ "empty",
2956
+ "not-empty",
2957
+ "true",
2958
+ "false"
2959
+ ]
2960
+ },
2961
+ "right": {
2962
+ "description": "Ignored by \"is empty\", \"is true\" and similar. For a pattern, write /text/i.",
2963
+ "type": "string"
2964
+ }
2965
+ },
2966
+ "additionalProperties": false
2967
+ },
2968
+ "switch": {
2969
+ "type": "object",
2970
+ "description": "Switch: Go one of several ways: the first case that matches the value picks the output, else \"default\".",
2971
+ "properties": {
2972
+ "value": {
2973
+ "description": "What the cases look at.",
2974
+ "type": "string"
2975
+ },
2976
+ "cases": {
2977
+ "description": "Each case is an output named after it (letters, digits, \"_\" and \"-\"; not \"default\", \"error\", \"out\" or \"done\"). No match goes to \"default\". For a pattern, write /text/i.",
2978
+ "type": "array",
2979
+ "items": {
2980
+ "type": "object",
2981
+ "properties": {
2982
+ "port": {
2983
+ "type": "string",
2984
+ "description": "Output"
2985
+ },
2986
+ "operator": {
2987
+ "enum": [
2988
+ "equals",
2989
+ "not-equals",
2990
+ "contains",
2991
+ "not-contains",
2992
+ "starts-with",
2993
+ "ends-with",
2994
+ "matches",
2995
+ "greater",
2996
+ "greater-equal",
2997
+ "less",
2998
+ "less-equal",
2999
+ "empty",
3000
+ "not-empty",
3001
+ "true",
3002
+ "false"
3003
+ ],
3004
+ "description": "Condition"
3005
+ },
3006
+ "value": {
3007
+ "type": "string",
3008
+ "description": "Compare to"
3009
+ }
3010
+ },
3011
+ "additionalProperties": false
3012
+ }
3013
+ }
3014
+ },
3015
+ "additionalProperties": false
3016
+ },
3017
+ "for-each": {
3018
+ "type": "object",
3019
+ "description": "For Each: Repeat the blocks on \"each\" for every item of a list, then continue from \"done\".",
3020
+ "properties": {
3021
+ "list": {
3022
+ "description": "Where the list is in the data, e.g. items or data.results (an expression, no {{ }}).",
3023
+ "type": "string"
3024
+ },
3025
+ "as": {
3026
+ "description": "Call each item",
3027
+ "type": "string"
3028
+ }
3029
+ },
3030
+ "additionalProperties": false
3031
+ },
3032
+ "repeat": {
3033
+ "type": "object",
3034
+ "description": "Repeat: Run the blocks on \"each\" a number of times, or until / while a condition holds, then continue from \"done\".",
3035
+ "properties": {
3036
+ "mode": {
3037
+ "description": "Repeat",
3038
+ "enum": [
3039
+ "times",
3040
+ "until",
3041
+ "while"
3042
+ ]
3043
+ },
3044
+ "times": {
3045
+ "description": "For \"a number of times\".",
3046
+ "type": "number",
3047
+ "minimum": 1,
3048
+ "maximum": 1000
3049
+ },
3050
+ "left": {
3051
+ "description": "Until / while: rendered at every check against the data the last time ended with ({{iteration}} = times run so far).",
3052
+ "type": "string"
3053
+ },
3054
+ "operator": {
3055
+ "description": "Condition",
3056
+ "enum": [
3057
+ "equals",
3058
+ "not-equals",
3059
+ "contains",
3060
+ "not-contains",
3061
+ "starts-with",
3062
+ "ends-with",
3063
+ "matches",
3064
+ "greater",
3065
+ "greater-equal",
3066
+ "less",
3067
+ "less-equal",
3068
+ "empty",
3069
+ "not-empty",
3070
+ "true",
3071
+ "false"
3072
+ ]
3073
+ },
3074
+ "right": {
3075
+ "description": "Compare to",
3076
+ "type": "string"
3077
+ },
3078
+ "max": {
3079
+ "description": "Until / while: a safety limit.",
3080
+ "type": "number",
3081
+ "minimum": 1,
3082
+ "maximum": 10000
3083
+ },
3084
+ "failAtMax": {
3085
+ "description": "Off: continue from \"done\" instead.",
3086
+ "type": "boolean"
3087
+ }
3088
+ },
3089
+ "additionalProperties": false
3090
+ },
3091
+ "run-workflow": {
3092
+ "type": "object",
3093
+ "description": "Run Workflow: Run another workflow with this data, and continue with what it returns.",
3094
+ "properties": {
3095
+ "workflow": {
3096
+ "description": "Its start blocks receive this data. It does not need to be On.",
3097
+ "type": "string"
3098
+ }
3099
+ },
3100
+ "additionalProperties": false
3101
+ },
3102
+ "set-variable": {
3103
+ "type": "object",
3104
+ "description": "Set Variable: Add a value to the data flowing through.",
3105
+ "properties": {
3106
+ "name": {
3107
+ "description": "Name",
3108
+ "type": "string"
3109
+ },
3110
+ "value": {
3111
+ "description": "Value",
3112
+ "type": "string"
3113
+ }
3114
+ },
3115
+ "additionalProperties": false
3116
+ },
3117
+ "transform": {
3118
+ "type": "object",
3119
+ "description": "Transform: Compute new values with expressions: math, text, lists (sum, sort, pluck…).",
3120
+ "properties": {
3121
+ "values": {
3122
+ "description": "Expressions without {{ }}. See docs/guide for the functions.",
3123
+ "type": "array",
3124
+ "items": {
3125
+ "type": "object",
3126
+ "properties": {
3127
+ "name": {
3128
+ "type": "string",
3129
+ "description": "Name"
3130
+ },
3131
+ "expression": {
3132
+ "type": "string",
3133
+ "description": "Expression"
3134
+ }
3135
+ },
3136
+ "additionalProperties": false
3137
+ }
3138
+ }
3139
+ },
3140
+ "additionalProperties": false
3141
+ },
3142
+ "filter": {
3143
+ "type": "object",
3144
+ "description": "Filter: Keep only the list items that match a condition.",
3145
+ "properties": {
3146
+ "list": {
3147
+ "description": "Where the list is in the data, e.g. items or data.results (an expression, no {{ }}).",
3148
+ "type": "string"
3149
+ },
3150
+ "left": {
3151
+ "description": "Rendered for each item: {{item.…}} is the item, other {{…}} the data.",
3152
+ "type": "string"
3153
+ },
3154
+ "operator": {
3155
+ "description": "Condition",
3156
+ "enum": [
3157
+ "equals",
3158
+ "not-equals",
3159
+ "contains",
3160
+ "not-contains",
3161
+ "starts-with",
3162
+ "ends-with",
3163
+ "matches",
3164
+ "greater",
3165
+ "greater-equal",
3166
+ "less",
3167
+ "less-equal",
3168
+ "empty",
3169
+ "not-empty",
3170
+ "true",
3171
+ "false"
3172
+ ]
3173
+ },
3174
+ "right": {
3175
+ "description": "Compare to",
3176
+ "type": "string"
3177
+ },
3178
+ "into": {
3179
+ "description": "Save as (empty = replace the list)",
3180
+ "type": "string"
3181
+ }
3182
+ },
3183
+ "additionalProperties": false
3184
+ },
3185
+ "data-table": {
3186
+ "type": "object",
3187
+ "description": "Data Table: Rows of data you paste in (CSV or JSON), e.g. logins to test one by one.",
3188
+ "properties": {
3189
+ "text": {
3190
+ "description": "CSV with a header row (comma, semicolon or tab), or a JSON list.",
3191
+ "type": "string"
3192
+ },
3193
+ "into": {
3194
+ "description": "Save the rows as",
3195
+ "type": "string"
3196
+ }
3197
+ },
3198
+ "additionalProperties": false
3199
+ },
3200
+ "save-dataset": {
3201
+ "type": "object",
3202
+ "description": "Save to Dataset: Add rows to a named dataset kept in the browser. See and download it on the Data page.",
3203
+ "properties": {
3204
+ "dataset": {
3205
+ "description": "Dataset",
3206
+ "type": "string"
3207
+ },
3208
+ "value": {
3209
+ "description": "An expression: a list adds one row per item, anything else one row. E.g. items, or item inside a For Each. Build objects with Transform first.",
3210
+ "type": "string"
3211
+ },
3212
+ "mode": {
3213
+ "description": "Mode",
3214
+ "enum": [
3215
+ "append",
3216
+ "replace"
3217
+ ]
3218
+ }
3219
+ },
3220
+ "additionalProperties": false
3221
+ },
3222
+ "download": {
3223
+ "type": "object",
3224
+ "description": "Download: Save a list or a dataset to a CSV or JSON file in Downloads.",
3225
+ "properties": {
3226
+ "from": {
3227
+ "description": "Save",
3228
+ "enum": [
3229
+ "value",
3230
+ "dataset"
3231
+ ]
3232
+ },
3233
+ "value": {
3234
+ "description": "An expression, for \"a value from the data\".",
3235
+ "type": "string"
3236
+ },
3237
+ "dataset": {
3238
+ "description": "Dataset",
3239
+ "type": "string"
3240
+ },
3241
+ "format": {
3242
+ "description": "Format",
3243
+ "enum": [
3244
+ "csv",
3245
+ "json",
3246
+ "text"
3247
+ ]
3248
+ },
3249
+ "filename": {
3250
+ "description": "File name",
3251
+ "type": "string"
3252
+ }
3253
+ },
3254
+ "additionalProperties": false
3255
+ },
3256
+ "notify": {
3257
+ "type": "object",
3258
+ "description": "Notify: Show a desktop notification.",
3259
+ "properties": {
3260
+ "title": {
3261
+ "description": "Title",
3262
+ "type": "string"
3263
+ },
3264
+ "message": {
3265
+ "description": "Message",
3266
+ "type": "string"
3267
+ }
3268
+ },
3269
+ "additionalProperties": false
3270
+ },
3271
+ "http-request": {
3272
+ "type": "object",
3273
+ "description": "HTTP Request: Call an API or webhook and use the response.",
3274
+ "properties": {
3275
+ "url": {
3276
+ "description": "URL",
3277
+ "type": "string"
3278
+ },
3279
+ "method": {
3280
+ "description": "Method",
3281
+ "enum": [
3282
+ "GET",
3283
+ "POST",
3284
+ "PUT",
3285
+ "PATCH",
3286
+ "DELETE"
3287
+ ]
3288
+ },
3289
+ "headers": {
3290
+ "description": "One per line, as Name: value",
3291
+ "type": "string"
3292
+ },
3293
+ "body": {
3294
+ "description": "Sent for POST, PUT, PATCH and DELETE.",
3295
+ "type": "string"
3296
+ },
3297
+ "failOnError": {
3298
+ "description": "Stop the flow on HTTP errors (4xx, 5xx)",
3299
+ "type": "boolean"
3300
+ },
3301
+ "responseType": {
3302
+ "description": "Response as",
3303
+ "enum": [
3304
+ "text",
3305
+ "base64"
3306
+ ]
3307
+ }
3308
+ },
3309
+ "additionalProperties": false
3310
+ },
3311
+ "log": {
3312
+ "type": "object",
3313
+ "description": "Log: Write a line to the run log, e.g. a value you want to see.",
3314
+ "properties": {
3315
+ "message": {
3316
+ "description": "Message",
3317
+ "type": "string"
3318
+ },
3319
+ "level": {
3320
+ "description": "Level",
3321
+ "enum": [
3322
+ "info",
3323
+ "warn",
3324
+ "error",
3325
+ "debug"
3326
+ ]
3327
+ }
3328
+ },
3329
+ "additionalProperties": false
3330
+ }
3331
+ }
3332
+ }
3333
+ }