@docsxai/engine 0.2.0 → 0.2.1-rc.1

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 (33) hide show
  1. package/README.md +8 -1
  2. package/dist/auth/api-login.d.ts +3 -3
  3. package/dist/auth/api-login.js +6 -2
  4. package/dist/auth/email-otp.d.ts +60 -60
  5. package/dist/auth/jwt-injection.d.ts +45 -45
  6. package/dist/auth/pat-header.d.ts +2 -2
  7. package/dist/auth/types.d.ts +2 -2
  8. package/dist/auth/ui-form.d.ts +54 -54
  9. package/dist/auth/webauthn.d.ts +22 -22
  10. package/dist/backend-client-contracts.d.ts +2 -2
  11. package/dist/calibrate.d.ts +2 -2
  12. package/dist/cli-commands-session.js +1 -0
  13. package/dist/cli-usage.d.ts +1 -1
  14. package/dist/cli-usage.js +1 -1
  15. package/dist/doc-pack.d.ts +268 -179
  16. package/dist/doc-pack.js +19 -1
  17. package/dist/doctor-checks.js +4 -4
  18. package/dist/flow-file.d.ts +2 -2
  19. package/dist/flow-runtime.d.ts +18 -2
  20. package/dist/flow-runtime.js +16 -0
  21. package/dist/index.d.ts +1 -0
  22. package/dist/index.js +1 -0
  23. package/dist/obstacles.d.ts +33 -0
  24. package/dist/obstacles.js +72 -0
  25. package/dist/page-nearby-boxes.d.ts +9 -0
  26. package/dist/page-nearby-boxes.js +92 -0
  27. package/dist/playwright-driver.d.ts +2 -0
  28. package/dist/playwright-driver.js +25 -0
  29. package/dist/plugins/manifest.d.ts +9 -9
  30. package/dist/style.d.ts +2 -2
  31. package/dist/workspace.d.ts +8 -0
  32. package/dist/zip.d.ts +2 -2
  33. package/package.json +6 -6
package/dist/doc-pack.d.ts CHANGED
@@ -126,21 +126,21 @@ export declare const EnvironmentSpec: z.ZodObject<{
126
126
  clock?: string | undefined;
127
127
  locale?: string | undefined;
128
128
  timezone?: string | undefined;
129
- viewport?: {
129
+ viewport?: "desktop" | "mobile" | "tablet" | {
130
130
  width: number;
131
131
  height: number;
132
- } | "desktop" | "tablet" | "mobile" | undefined;
133
- color_scheme?: "light" | "dark" | undefined;
132
+ } | undefined;
133
+ color_scheme?: "dark" | "light" | undefined;
134
134
  reduced_motion?: boolean | undefined;
135
135
  }, {
136
136
  clock?: string | undefined;
137
137
  locale?: string | undefined;
138
138
  timezone?: string | undefined;
139
- viewport?: {
139
+ viewport?: "desktop" | "mobile" | "tablet" | {
140
140
  width: number;
141
141
  height: number;
142
- } | "desktop" | "tablet" | "mobile" | undefined;
143
- color_scheme?: "light" | "dark" | undefined;
142
+ } | undefined;
143
+ color_scheme?: "dark" | "light" | undefined;
144
144
  reduced_motion?: boolean | undefined;
145
145
  }>;
146
146
  export type EnvironmentSpec = z.infer<typeof EnvironmentSpec>;
@@ -245,7 +245,7 @@ export declare const StepAnnotation: z.ZodObject<{
245
245
  target: z.ZodOptional<z.ZodString>;
246
246
  }, "strict", z.ZodTypeAny, {
247
247
  copy: string;
248
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
248
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
249
249
  nudge?: {
250
250
  x: number;
251
251
  y: number;
@@ -253,7 +253,7 @@ export declare const StepAnnotation: z.ZodObject<{
253
253
  target?: string | undefined;
254
254
  }, {
255
255
  copy: string;
256
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
256
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
257
257
  nudge?: {
258
258
  x: number;
259
259
  y: number;
@@ -361,7 +361,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
361
361
  target: z.ZodOptional<z.ZodString>;
362
362
  }, "strict", z.ZodTypeAny, {
363
363
  copy: string;
364
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
364
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
365
365
  nudge?: {
366
366
  x: number;
367
367
  y: number;
@@ -369,7 +369,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
369
369
  target?: string | undefined;
370
370
  }, {
371
371
  copy: string;
372
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
372
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
373
373
  nudge?: {
374
374
  x: number;
375
375
  y: number;
@@ -410,7 +410,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
410
410
  target: z.ZodOptional<z.ZodString>;
411
411
  }, "strict", z.ZodTypeAny, {
412
412
  copy: string;
413
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
413
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
414
414
  nudge?: {
415
415
  x: number;
416
416
  y: number;
@@ -418,7 +418,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
418
418
  target?: string | undefined;
419
419
  }, {
420
420
  copy: string;
421
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
421
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
422
422
  nudge?: {
423
423
  x: number;
424
424
  y: number;
@@ -472,11 +472,11 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
472
472
  }>]>, "many">>;
473
473
  }, "strict", z.ZodTypeAny, {
474
474
  id: string;
475
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
476
- value?: string | undefined;
477
- target?: string | undefined;
475
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
478
476
  optional?: boolean | undefined;
479
- wait_for?: "network_idle" | "element_stable" | "load" | {
477
+ target?: string | undefined;
478
+ value?: string | undefined;
479
+ wait_for?: "element_stable" | "load" | "network_idle" | {
480
480
  timeout_ms: number;
481
481
  } | {
482
482
  selector: string;
@@ -496,7 +496,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
496
496
  } | undefined;
497
497
  annotation?: {
498
498
  copy: string;
499
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
499
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
500
500
  nudge?: {
501
501
  x: number;
502
502
  y: number;
@@ -505,7 +505,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
505
505
  } | undefined;
506
506
  annotations?: {
507
507
  copy: string;
508
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
508
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
509
509
  nudge?: {
510
510
  x: number;
511
511
  y: number;
@@ -526,11 +526,11 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
526
526
  })[] | undefined;
527
527
  }, {
528
528
  id: string;
529
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
530
- value?: string | undefined;
531
- target?: string | undefined;
529
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
532
530
  optional?: boolean | undefined;
533
- wait_for?: "network_idle" | "element_stable" | "load" | {
531
+ target?: string | undefined;
532
+ value?: string | undefined;
533
+ wait_for?: "element_stable" | "load" | "network_idle" | {
534
534
  timeout_ms: number;
535
535
  } | {
536
536
  selector: string;
@@ -550,7 +550,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
550
550
  } | undefined;
551
551
  annotation?: {
552
552
  copy: string;
553
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
553
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
554
554
  nudge?: {
555
555
  x: number;
556
556
  y: number;
@@ -559,7 +559,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
559
559
  } | undefined;
560
560
  annotations?: {
561
561
  copy: string;
562
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
562
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
563
563
  nudge?: {
564
564
  x: number;
565
565
  y: number;
@@ -580,11 +580,11 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
580
580
  })[] | undefined;
581
581
  }>, {
582
582
  id: string;
583
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
584
- value?: string | undefined;
585
- target?: string | undefined;
583
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
586
584
  optional?: boolean | undefined;
587
- wait_for?: "network_idle" | "element_stable" | "load" | {
585
+ target?: string | undefined;
586
+ value?: string | undefined;
587
+ wait_for?: "element_stable" | "load" | "network_idle" | {
588
588
  timeout_ms: number;
589
589
  } | {
590
590
  selector: string;
@@ -604,7 +604,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
604
604
  } | undefined;
605
605
  annotation?: {
606
606
  copy: string;
607
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
607
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
608
608
  nudge?: {
609
609
  x: number;
610
610
  y: number;
@@ -613,7 +613,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
613
613
  } | undefined;
614
614
  annotations?: {
615
615
  copy: string;
616
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
616
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
617
617
  nudge?: {
618
618
  x: number;
619
619
  y: number;
@@ -634,11 +634,11 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
634
634
  })[] | undefined;
635
635
  }, {
636
636
  id: string;
637
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
638
- value?: string | undefined;
639
- target?: string | undefined;
637
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
640
638
  optional?: boolean | undefined;
641
- wait_for?: "network_idle" | "element_stable" | "load" | {
639
+ target?: string | undefined;
640
+ value?: string | undefined;
641
+ wait_for?: "element_stable" | "load" | "network_idle" | {
642
642
  timeout_ms: number;
643
643
  } | {
644
644
  selector: string;
@@ -658,7 +658,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
658
658
  } | undefined;
659
659
  annotation?: {
660
660
  copy: string;
661
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
661
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
662
662
  nudge?: {
663
663
  x: number;
664
664
  y: number;
@@ -667,7 +667,7 @@ export declare const Step: z.ZodEffects<z.ZodObject<{
667
667
  } | undefined;
668
668
  annotations?: {
669
669
  copy: string;
670
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
670
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
671
671
  nudge?: {
672
672
  x: number;
673
673
  y: number;
@@ -729,21 +729,21 @@ export declare const FlowFile: z.ZodObject<{
729
729
  clock?: string | undefined;
730
730
  locale?: string | undefined;
731
731
  timezone?: string | undefined;
732
- viewport?: {
732
+ viewport?: "desktop" | "mobile" | "tablet" | {
733
733
  width: number;
734
734
  height: number;
735
- } | "desktop" | "tablet" | "mobile" | undefined;
736
- color_scheme?: "light" | "dark" | undefined;
735
+ } | undefined;
736
+ color_scheme?: "dark" | "light" | undefined;
737
737
  reduced_motion?: boolean | undefined;
738
738
  }, {
739
739
  clock?: string | undefined;
740
740
  locale?: string | undefined;
741
741
  timezone?: string | undefined;
742
- viewport?: {
742
+ viewport?: "desktop" | "mobile" | "tablet" | {
743
743
  width: number;
744
744
  height: number;
745
- } | "desktop" | "tablet" | "mobile" | undefined;
746
- color_scheme?: "light" | "dark" | undefined;
745
+ } | undefined;
746
+ color_scheme?: "dark" | "light" | undefined;
747
747
  reduced_motion?: boolean | undefined;
748
748
  }>>;
749
749
  /** Areas masked on every screenshot this flow produces (incl. halt shots). See {@link RedactionSpec}. */
@@ -894,7 +894,7 @@ export declare const FlowFile: z.ZodObject<{
894
894
  target: z.ZodOptional<z.ZodString>;
895
895
  }, "strict", z.ZodTypeAny, {
896
896
  copy: string;
897
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
897
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
898
898
  nudge?: {
899
899
  x: number;
900
900
  y: number;
@@ -902,7 +902,7 @@ export declare const FlowFile: z.ZodObject<{
902
902
  target?: string | undefined;
903
903
  }, {
904
904
  copy: string;
905
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
905
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
906
906
  nudge?: {
907
907
  x: number;
908
908
  y: number;
@@ -943,7 +943,7 @@ export declare const FlowFile: z.ZodObject<{
943
943
  target: z.ZodOptional<z.ZodString>;
944
944
  }, "strict", z.ZodTypeAny, {
945
945
  copy: string;
946
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
946
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
947
947
  nudge?: {
948
948
  x: number;
949
949
  y: number;
@@ -951,7 +951,7 @@ export declare const FlowFile: z.ZodObject<{
951
951
  target?: string | undefined;
952
952
  }, {
953
953
  copy: string;
954
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
954
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
955
955
  nudge?: {
956
956
  x: number;
957
957
  y: number;
@@ -1005,11 +1005,11 @@ export declare const FlowFile: z.ZodObject<{
1005
1005
  }>]>, "many">>;
1006
1006
  }, "strict", z.ZodTypeAny, {
1007
1007
  id: string;
1008
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1009
- value?: string | undefined;
1010
- target?: string | undefined;
1008
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1011
1009
  optional?: boolean | undefined;
1012
- wait_for?: "network_idle" | "element_stable" | "load" | {
1010
+ target?: string | undefined;
1011
+ value?: string | undefined;
1012
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1013
1013
  timeout_ms: number;
1014
1014
  } | {
1015
1015
  selector: string;
@@ -1029,7 +1029,7 @@ export declare const FlowFile: z.ZodObject<{
1029
1029
  } | undefined;
1030
1030
  annotation?: {
1031
1031
  copy: string;
1032
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1032
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1033
1033
  nudge?: {
1034
1034
  x: number;
1035
1035
  y: number;
@@ -1038,7 +1038,7 @@ export declare const FlowFile: z.ZodObject<{
1038
1038
  } | undefined;
1039
1039
  annotations?: {
1040
1040
  copy: string;
1041
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1041
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1042
1042
  nudge?: {
1043
1043
  x: number;
1044
1044
  y: number;
@@ -1059,11 +1059,11 @@ export declare const FlowFile: z.ZodObject<{
1059
1059
  })[] | undefined;
1060
1060
  }, {
1061
1061
  id: string;
1062
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1063
- value?: string | undefined;
1064
- target?: string | undefined;
1062
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1065
1063
  optional?: boolean | undefined;
1066
- wait_for?: "network_idle" | "element_stable" | "load" | {
1064
+ target?: string | undefined;
1065
+ value?: string | undefined;
1066
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1067
1067
  timeout_ms: number;
1068
1068
  } | {
1069
1069
  selector: string;
@@ -1083,7 +1083,7 @@ export declare const FlowFile: z.ZodObject<{
1083
1083
  } | undefined;
1084
1084
  annotation?: {
1085
1085
  copy: string;
1086
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1086
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1087
1087
  nudge?: {
1088
1088
  x: number;
1089
1089
  y: number;
@@ -1092,7 +1092,7 @@ export declare const FlowFile: z.ZodObject<{
1092
1092
  } | undefined;
1093
1093
  annotations?: {
1094
1094
  copy: string;
1095
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1095
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1096
1096
  nudge?: {
1097
1097
  x: number;
1098
1098
  y: number;
@@ -1113,11 +1113,11 @@ export declare const FlowFile: z.ZodObject<{
1113
1113
  })[] | undefined;
1114
1114
  }>, {
1115
1115
  id: string;
1116
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1117
- value?: string | undefined;
1118
- target?: string | undefined;
1116
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1119
1117
  optional?: boolean | undefined;
1120
- wait_for?: "network_idle" | "element_stable" | "load" | {
1118
+ target?: string | undefined;
1119
+ value?: string | undefined;
1120
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1121
1121
  timeout_ms: number;
1122
1122
  } | {
1123
1123
  selector: string;
@@ -1137,7 +1137,7 @@ export declare const FlowFile: z.ZodObject<{
1137
1137
  } | undefined;
1138
1138
  annotation?: {
1139
1139
  copy: string;
1140
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1140
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1141
1141
  nudge?: {
1142
1142
  x: number;
1143
1143
  y: number;
@@ -1146,7 +1146,7 @@ export declare const FlowFile: z.ZodObject<{
1146
1146
  } | undefined;
1147
1147
  annotations?: {
1148
1148
  copy: string;
1149
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1149
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1150
1150
  nudge?: {
1151
1151
  x: number;
1152
1152
  y: number;
@@ -1167,11 +1167,11 @@ export declare const FlowFile: z.ZodObject<{
1167
1167
  })[] | undefined;
1168
1168
  }, {
1169
1169
  id: string;
1170
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1171
- value?: string | undefined;
1172
- target?: string | undefined;
1170
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1173
1171
  optional?: boolean | undefined;
1174
- wait_for?: "network_idle" | "element_stable" | "load" | {
1172
+ target?: string | undefined;
1173
+ value?: string | undefined;
1174
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1175
1175
  timeout_ms: number;
1176
1176
  } | {
1177
1177
  selector: string;
@@ -1191,7 +1191,7 @@ export declare const FlowFile: z.ZodObject<{
1191
1191
  } | undefined;
1192
1192
  annotation?: {
1193
1193
  copy: string;
1194
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1194
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1195
1195
  nudge?: {
1196
1196
  x: number;
1197
1197
  y: number;
@@ -1200,7 +1200,7 @@ export declare const FlowFile: z.ZodObject<{
1200
1200
  } | undefined;
1201
1201
  annotations?: {
1202
1202
  copy: string;
1203
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1203
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1204
1204
  nudge?: {
1205
1205
  x: number;
1206
1206
  y: number;
@@ -1222,15 +1222,39 @@ export declare const FlowFile: z.ZodObject<{
1222
1222
  }>, "many">;
1223
1223
  }, "strict", z.ZodTypeAny, {
1224
1224
  name: string;
1225
+ extends?: string | undefined;
1226
+ environment?: {
1227
+ clock?: string | undefined;
1228
+ locale?: string | undefined;
1229
+ timezone?: string | undefined;
1230
+ viewport?: "desktop" | "mobile" | "tablet" | {
1231
+ width: number;
1232
+ height: number;
1233
+ } | undefined;
1234
+ color_scheme?: "dark" | "light" | undefined;
1235
+ reduced_motion?: boolean | undefined;
1236
+ } | undefined;
1237
+ redactions?: ({
1238
+ selector: string;
1239
+ style?: "box" | "pixelate" | undefined;
1240
+ } | {
1241
+ region: {
1242
+ x: number;
1243
+ y: number;
1244
+ width: number;
1245
+ height: number;
1246
+ };
1247
+ style?: "box" | "pixelate" | undefined;
1248
+ })[] | undefined;
1225
1249
  prerequisites: Record<string, string | boolean>[];
1226
1250
  locators: Record<string, string>;
1227
1251
  steps: {
1228
1252
  id: string;
1229
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1230
- value?: string | undefined;
1231
- target?: string | undefined;
1253
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1232
1254
  optional?: boolean | undefined;
1233
- wait_for?: "network_idle" | "element_stable" | "load" | {
1255
+ target?: string | undefined;
1256
+ value?: string | undefined;
1257
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1234
1258
  timeout_ms: number;
1235
1259
  } | {
1236
1260
  selector: string;
@@ -1250,7 +1274,7 @@ export declare const FlowFile: z.ZodObject<{
1250
1274
  } | undefined;
1251
1275
  annotation?: {
1252
1276
  copy: string;
1253
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1277
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1254
1278
  nudge?: {
1255
1279
  x: number;
1256
1280
  y: number;
@@ -1259,7 +1283,7 @@ export declare const FlowFile: z.ZodObject<{
1259
1283
  } | undefined;
1260
1284
  annotations?: {
1261
1285
  copy: string;
1262
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1286
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1263
1287
  nudge?: {
1264
1288
  x: number;
1265
1289
  y: number;
@@ -1279,6 +1303,20 @@ export declare const FlowFile: z.ZodObject<{
1279
1303
  style?: "box" | "pixelate" | undefined;
1280
1304
  })[] | undefined;
1281
1305
  }[];
1306
+ }, {
1307
+ name: string;
1308
+ extends?: string | undefined;
1309
+ environment?: {
1310
+ clock?: string | undefined;
1311
+ locale?: string | undefined;
1312
+ timezone?: string | undefined;
1313
+ viewport?: "desktop" | "mobile" | "tablet" | {
1314
+ width: number;
1315
+ height: number;
1316
+ } | undefined;
1317
+ color_scheme?: "dark" | "light" | undefined;
1318
+ reduced_motion?: boolean | undefined;
1319
+ } | undefined;
1282
1320
  redactions?: ({
1283
1321
  selector: string;
1284
1322
  style?: "box" | "pixelate" | undefined;
@@ -1291,27 +1329,15 @@ export declare const FlowFile: z.ZodObject<{
1291
1329
  };
1292
1330
  style?: "box" | "pixelate" | undefined;
1293
1331
  })[] | undefined;
1294
- extends?: string | undefined;
1295
- environment?: {
1296
- clock?: string | undefined;
1297
- locale?: string | undefined;
1298
- timezone?: string | undefined;
1299
- viewport?: {
1300
- width: number;
1301
- height: number;
1302
- } | "desktop" | "tablet" | "mobile" | undefined;
1303
- color_scheme?: "light" | "dark" | undefined;
1304
- reduced_motion?: boolean | undefined;
1305
- } | undefined;
1306
- }, {
1307
- name: string;
1332
+ prerequisites?: Record<string, string | boolean>[] | undefined;
1333
+ locators?: Record<string, string> | undefined;
1308
1334
  steps: {
1309
1335
  id: string;
1310
- action: "fill" | "navigate" | "click" | "upload" | "press" | "hover" | "select" | "check" | "uncheck" | "wait";
1311
- value?: string | undefined;
1312
- target?: string | undefined;
1336
+ action: "check" | "click" | "fill" | "hover" | "navigate" | "press" | "select" | "uncheck" | "upload" | "wait";
1313
1337
  optional?: boolean | undefined;
1314
- wait_for?: "network_idle" | "element_stable" | "load" | {
1338
+ target?: string | undefined;
1339
+ value?: string | undefined;
1340
+ wait_for?: "element_stable" | "load" | "network_idle" | {
1315
1341
  timeout_ms: number;
1316
1342
  } | {
1317
1343
  selector: string;
@@ -1331,7 +1357,7 @@ export declare const FlowFile: z.ZodObject<{
1331
1357
  } | undefined;
1332
1358
  annotation?: {
1333
1359
  copy: string;
1334
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1360
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1335
1361
  nudge?: {
1336
1362
  x: number;
1337
1363
  y: number;
@@ -1340,7 +1366,7 @@ export declare const FlowFile: z.ZodObject<{
1340
1366
  } | undefined;
1341
1367
  annotations?: {
1342
1368
  copy: string;
1343
- arrow?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1369
+ arrow?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1344
1370
  nudge?: {
1345
1371
  x: number;
1346
1372
  y: number;
@@ -1360,34 +1386,9 @@ export declare const FlowFile: z.ZodObject<{
1360
1386
  style?: "box" | "pixelate" | undefined;
1361
1387
  })[] | undefined;
1362
1388
  }[];
1363
- redactions?: ({
1364
- selector: string;
1365
- style?: "box" | "pixelate" | undefined;
1366
- } | {
1367
- region: {
1368
- x: number;
1369
- y: number;
1370
- width: number;
1371
- height: number;
1372
- };
1373
- style?: "box" | "pixelate" | undefined;
1374
- })[] | undefined;
1375
- extends?: string | undefined;
1376
- environment?: {
1377
- clock?: string | undefined;
1378
- locale?: string | undefined;
1379
- timezone?: string | undefined;
1380
- viewport?: {
1381
- width: number;
1382
- height: number;
1383
- } | "desktop" | "tablet" | "mobile" | undefined;
1384
- color_scheme?: "light" | "dark" | undefined;
1385
- reduced_motion?: boolean | undefined;
1386
- } | undefined;
1387
- prerequisites?: Record<string, string | boolean>[] | undefined;
1388
- locators?: Record<string, string> | undefined;
1389
1389
  }>;
1390
1390
  export type FlowFile = z.infer<typeof FlowFile>;
1391
+ /** A rectangle in screenshot pixels: finite position, finite non-negative size. */
1391
1392
  export declare const BoundingBox: z.ZodObject<{
1392
1393
  x: z.ZodNumber;
1393
1394
  y: z.ZodNumber;
@@ -1405,6 +1406,8 @@ export declare const BoundingBox: z.ZodObject<{
1405
1406
  height: number;
1406
1407
  }>;
1407
1408
  export type BoundingBox = z.infer<typeof BoundingBox>;
1409
+ /** Most `obstacles` one annotation record may carry (the writer keeps the nearest this many). */
1410
+ export declare const MAX_OBSTACLES = 40;
1408
1411
  export declare const AnnotationRecord: z.ZodObject<{
1409
1412
  step: z.ZodString;
1410
1413
  selector: z.ZodString;
@@ -1437,39 +1440,76 @@ export declare const AnnotationRecord: z.ZodObject<{
1437
1440
  x: number;
1438
1441
  y: number;
1439
1442
  }>>;
1443
+ /**
1444
+ * Optional boxes of page content (text, controls), in screenshot pixels, that the burner keeps this
1445
+ * annotation's callout from covering. The target itself is not listed. `docsxai run` writes it when
1446
+ * the workspace sets `annotations.obstacles`; a pipeline that knows the page layout may add it by
1447
+ * hand. At most {@link MAX_OBSTACLES} boxes. The engine measures them right after the screenshot, so
1448
+ * on a page that animates continuously they can differ slightly from what the image shows. Absent or
1449
+ * empty: the callout goes next to the target. The structural mirror in `packages/viewer/src/annotations.ts`
1450
+ * carries the same field.
1451
+ */
1452
+ obstacles: z.ZodOptional<z.ZodArray<z.ZodObject<{
1453
+ x: z.ZodNumber;
1454
+ y: z.ZodNumber;
1455
+ width: z.ZodNumber;
1456
+ height: z.ZodNumber;
1457
+ }, "strict", z.ZodTypeAny, {
1458
+ x: number;
1459
+ y: number;
1460
+ width: number;
1461
+ height: number;
1462
+ }, {
1463
+ x: number;
1464
+ y: number;
1465
+ width: number;
1466
+ height: number;
1467
+ }>, "many">>;
1440
1468
  /** 1-based index of this annotation *within its step's screenshot* — set only when the step has > 1 annotation, so the viewer can render a numbered badge. Absent → render as a plain (un-numbered) halo. */
1441
1469
  index: z.ZodOptional<z.ZodNumber>;
1442
1470
  }, "strict", z.ZodTypeAny, {
1471
+ step: string;
1443
1472
  selector: string;
1473
+ bounding_box?: {
1474
+ x: number;
1475
+ y: number;
1476
+ width: number;
1477
+ height: number;
1478
+ } | undefined;
1444
1479
  copy: string;
1445
- step: string;
1480
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1446
1481
  nudge?: {
1447
1482
  x: number;
1448
1483
  y: number;
1449
1484
  } | undefined;
1450
- bounding_box?: {
1485
+ obstacles?: {
1451
1486
  x: number;
1452
1487
  y: number;
1453
1488
  width: number;
1454
1489
  height: number;
1455
- } | undefined;
1456
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1490
+ }[] | undefined;
1457
1491
  index?: number | undefined;
1458
1492
  }, {
1493
+ step: string;
1459
1494
  selector: string;
1495
+ bounding_box?: {
1496
+ x: number;
1497
+ y: number;
1498
+ width: number;
1499
+ height: number;
1500
+ } | undefined;
1460
1501
  copy: string;
1461
- step: string;
1502
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1462
1503
  nudge?: {
1463
1504
  x: number;
1464
1505
  y: number;
1465
1506
  } | undefined;
1466
- bounding_box?: {
1507
+ obstacles?: {
1467
1508
  x: number;
1468
1509
  y: number;
1469
1510
  width: number;
1470
1511
  height: number;
1471
- } | undefined;
1472
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1512
+ }[] | undefined;
1473
1513
  index?: number | undefined;
1474
1514
  }>;
1475
1515
  export type AnnotationRecord = z.infer<typeof AnnotationRecord>;
@@ -1508,81 +1548,130 @@ export declare const AnnotationsFile: z.ZodObject<{
1508
1548
  x: number;
1509
1549
  y: number;
1510
1550
  }>>;
1551
+ /**
1552
+ * Optional boxes of page content (text, controls), in screenshot pixels, that the burner keeps this
1553
+ * annotation's callout from covering. The target itself is not listed. `docsxai run` writes it when
1554
+ * the workspace sets `annotations.obstacles`; a pipeline that knows the page layout may add it by
1555
+ * hand. At most {@link MAX_OBSTACLES} boxes. The engine measures them right after the screenshot, so
1556
+ * on a page that animates continuously they can differ slightly from what the image shows. Absent or
1557
+ * empty: the callout goes next to the target. The structural mirror in `packages/viewer/src/annotations.ts`
1558
+ * carries the same field.
1559
+ */
1560
+ obstacles: z.ZodOptional<z.ZodArray<z.ZodObject<{
1561
+ x: z.ZodNumber;
1562
+ y: z.ZodNumber;
1563
+ width: z.ZodNumber;
1564
+ height: z.ZodNumber;
1565
+ }, "strict", z.ZodTypeAny, {
1566
+ x: number;
1567
+ y: number;
1568
+ width: number;
1569
+ height: number;
1570
+ }, {
1571
+ x: number;
1572
+ y: number;
1573
+ width: number;
1574
+ height: number;
1575
+ }>, "many">>;
1511
1576
  /** 1-based index of this annotation *within its step's screenshot* — set only when the step has > 1 annotation, so the viewer can render a numbered badge. Absent → render as a plain (un-numbered) halo. */
1512
1577
  index: z.ZodOptional<z.ZodNumber>;
1513
1578
  }, "strict", z.ZodTypeAny, {
1579
+ step: string;
1514
1580
  selector: string;
1581
+ bounding_box?: {
1582
+ x: number;
1583
+ y: number;
1584
+ width: number;
1585
+ height: number;
1586
+ } | undefined;
1515
1587
  copy: string;
1516
- step: string;
1588
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1517
1589
  nudge?: {
1518
1590
  x: number;
1519
1591
  y: number;
1520
1592
  } | undefined;
1521
- bounding_box?: {
1593
+ obstacles?: {
1522
1594
  x: number;
1523
1595
  y: number;
1524
1596
  width: number;
1525
1597
  height: number;
1526
- } | undefined;
1527
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1598
+ }[] | undefined;
1528
1599
  index?: number | undefined;
1529
1600
  }, {
1601
+ step: string;
1530
1602
  selector: string;
1603
+ bounding_box?: {
1604
+ x: number;
1605
+ y: number;
1606
+ width: number;
1607
+ height: number;
1608
+ } | undefined;
1531
1609
  copy: string;
1532
- step: string;
1610
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1533
1611
  nudge?: {
1534
1612
  x: number;
1535
1613
  y: number;
1536
1614
  } | undefined;
1537
- bounding_box?: {
1615
+ obstacles?: {
1538
1616
  x: number;
1539
1617
  y: number;
1540
1618
  width: number;
1541
1619
  height: number;
1542
- } | undefined;
1543
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1620
+ }[] | undefined;
1544
1621
  index?: number | undefined;
1545
1622
  }>, "many">;
1546
1623
  }, "strict", z.ZodTypeAny, {
1624
+ schema: "docsxai/annotations@1";
1625
+ flow: string;
1547
1626
  annotations: {
1627
+ step: string;
1548
1628
  selector: string;
1629
+ bounding_box?: {
1630
+ x: number;
1631
+ y: number;
1632
+ width: number;
1633
+ height: number;
1634
+ } | undefined;
1549
1635
  copy: string;
1550
- step: string;
1636
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1551
1637
  nudge?: {
1552
1638
  x: number;
1553
1639
  y: number;
1554
1640
  } | undefined;
1555
- bounding_box?: {
1641
+ obstacles?: {
1556
1642
  x: number;
1557
1643
  y: number;
1558
1644
  width: number;
1559
1645
  height: number;
1560
- } | undefined;
1561
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1646
+ }[] | undefined;
1562
1647
  index?: number | undefined;
1563
1648
  }[];
1649
+ }, {
1564
1650
  schema: "docsxai/annotations@1";
1565
1651
  flow: string;
1566
- }, {
1567
1652
  annotations: {
1653
+ step: string;
1568
1654
  selector: string;
1655
+ bounding_box?: {
1656
+ x: number;
1657
+ y: number;
1658
+ width: number;
1659
+ height: number;
1660
+ } | undefined;
1569
1661
  copy: string;
1570
- step: string;
1662
+ arrow_style?: "bottom" | "bottom-left" | "bottom-right" | "left" | "right" | "top" | "top-left" | "top-right" | undefined;
1571
1663
  nudge?: {
1572
1664
  x: number;
1573
1665
  y: number;
1574
1666
  } | undefined;
1575
- bounding_box?: {
1667
+ obstacles?: {
1576
1668
  x: number;
1577
1669
  y: number;
1578
1670
  width: number;
1579
1671
  height: number;
1580
- } | undefined;
1581
- arrow_style?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top" | "bottom" | "left" | "right" | undefined;
1672
+ }[] | undefined;
1582
1673
  index?: number | undefined;
1583
1674
  }[];
1584
- schema: "docsxai/annotations@1";
1585
- flow: string;
1586
1675
  }>;
1587
1676
  export type AnnotationsFile = z.infer<typeof AnnotationsFile>;
1588
1677
  export declare const StyleArtifact: z.ZodObject<{
@@ -1648,32 +1737,32 @@ export declare const RoleAuth: z.ZodObject<{
1648
1737
  auth_cookie: z.ZodOptional<z.ZodString>;
1649
1738
  }, "strict", z.ZodTypeAny, {
1650
1739
  enabled: boolean;
1651
- store: "local" | "backend";
1740
+ store: "backend" | "local";
1652
1741
  ttl: string | number;
1653
1742
  auth_cookie?: string | undefined;
1654
1743
  }, {
1655
1744
  enabled?: boolean | undefined;
1656
- store?: "local" | "backend" | undefined;
1745
+ store?: "backend" | "local" | undefined;
1657
1746
  ttl?: string | number | undefined;
1658
1747
  auth_cookie?: string | undefined;
1659
1748
  }>>;
1660
1749
  }, "strict", z.ZodTypeAny, {
1661
- options: Record<string, unknown>;
1662
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1750
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1663
1751
  creds_env: Record<string, string>;
1752
+ options: Record<string, unknown>;
1664
1753
  cache: {
1665
1754
  enabled: boolean;
1666
- store: "local" | "backend";
1755
+ store: "backend" | "local";
1667
1756
  ttl: string | number;
1668
1757
  auth_cookie?: string | undefined;
1669
1758
  };
1670
1759
  }, {
1671
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1672
- options?: Record<string, unknown> | undefined;
1760
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1673
1761
  creds_env?: Record<string, string> | undefined;
1762
+ options?: Record<string, unknown> | undefined;
1674
1763
  cache?: {
1675
1764
  enabled?: boolean | undefined;
1676
- store?: "local" | "backend" | undefined;
1765
+ store?: "backend" | "local" | undefined;
1677
1766
  ttl?: string | number | undefined;
1678
1767
  auth_cookie?: string | undefined;
1679
1768
  } | undefined;
@@ -1701,32 +1790,32 @@ export declare const AuthStrategyDescriptor: z.ZodEffects<z.ZodObject<{
1701
1790
  auth_cookie: z.ZodOptional<z.ZodString>;
1702
1791
  }, "strict", z.ZodTypeAny, {
1703
1792
  enabled: boolean;
1704
- store: "local" | "backend";
1793
+ store: "backend" | "local";
1705
1794
  ttl: string | number;
1706
1795
  auth_cookie?: string | undefined;
1707
1796
  }, {
1708
1797
  enabled?: boolean | undefined;
1709
- store?: "local" | "backend" | undefined;
1798
+ store?: "backend" | "local" | undefined;
1710
1799
  ttl?: string | number | undefined;
1711
1800
  auth_cookie?: string | undefined;
1712
1801
  }>>;
1713
1802
  }, "strict", z.ZodTypeAny, {
1714
- options: Record<string, unknown>;
1715
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1803
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1716
1804
  creds_env: Record<string, string>;
1805
+ options: Record<string, unknown>;
1717
1806
  cache: {
1718
1807
  enabled: boolean;
1719
- store: "local" | "backend";
1808
+ store: "backend" | "local";
1720
1809
  ttl: string | number;
1721
1810
  auth_cookie?: string | undefined;
1722
1811
  };
1723
1812
  }, {
1724
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1725
- options?: Record<string, unknown> | undefined;
1813
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1726
1814
  creds_env?: Record<string, string> | undefined;
1815
+ options?: Record<string, unknown> | undefined;
1727
1816
  cache?: {
1728
1817
  enabled?: boolean | undefined;
1729
- store?: "local" | "backend" | undefined;
1818
+ store?: "backend" | "local" | undefined;
1730
1819
  ttl?: string | number | undefined;
1731
1820
  auth_cookie?: string | undefined;
1732
1821
  } | undefined;
@@ -1735,12 +1824,12 @@ export declare const AuthStrategyDescriptor: z.ZodEffects<z.ZodObject<{
1735
1824
  schema: "docsxai/auth-strategy@1";
1736
1825
  default_role: string;
1737
1826
  roles: Record<string, {
1738
- options: Record<string, unknown>;
1739
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1827
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1740
1828
  creds_env: Record<string, string>;
1829
+ options: Record<string, unknown>;
1741
1830
  cache: {
1742
1831
  enabled: boolean;
1743
- store: "local" | "backend";
1832
+ store: "backend" | "local";
1744
1833
  ttl: string | number;
1745
1834
  auth_cookie?: string | undefined;
1746
1835
  };
@@ -1749,12 +1838,12 @@ export declare const AuthStrategyDescriptor: z.ZodEffects<z.ZodObject<{
1749
1838
  schema: "docsxai/auth-strategy@1";
1750
1839
  default_role: string;
1751
1840
  roles: Record<string, {
1752
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1753
- options?: Record<string, unknown> | undefined;
1841
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1754
1842
  creds_env?: Record<string, string> | undefined;
1843
+ options?: Record<string, unknown> | undefined;
1755
1844
  cache?: {
1756
1845
  enabled?: boolean | undefined;
1757
- store?: "local" | "backend" | undefined;
1846
+ store?: "backend" | "local" | undefined;
1758
1847
  ttl?: string | number | undefined;
1759
1848
  auth_cookie?: string | undefined;
1760
1849
  } | undefined;
@@ -1763,12 +1852,12 @@ export declare const AuthStrategyDescriptor: z.ZodEffects<z.ZodObject<{
1763
1852
  schema: "docsxai/auth-strategy@1";
1764
1853
  default_role: string;
1765
1854
  roles: Record<string, {
1766
- options: Record<string, unknown>;
1767
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1855
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1768
1856
  creds_env: Record<string, string>;
1857
+ options: Record<string, unknown>;
1769
1858
  cache: {
1770
1859
  enabled: boolean;
1771
- store: "local" | "backend";
1860
+ store: "backend" | "local";
1772
1861
  ttl: string | number;
1773
1862
  auth_cookie?: string | undefined;
1774
1863
  };
@@ -1777,12 +1866,12 @@ export declare const AuthStrategyDescriptor: z.ZodEffects<z.ZodObject<{
1777
1866
  schema: "docsxai/auth-strategy@1";
1778
1867
  default_role: string;
1779
1868
  roles: Record<string, {
1780
- strategy: "api-login" | "jwt-injection" | "ui-form" | "http-basic" | "mtls" | "pat-header" | "email-otp" | "totp" | "webauthn" | "manual-capture" | "test-backdoor";
1781
- options?: Record<string, unknown> | undefined;
1869
+ strategy: "api-login" | "email-otp" | "http-basic" | "jwt-injection" | "manual-capture" | "mtls" | "pat-header" | "test-backdoor" | "totp" | "ui-form" | "webauthn";
1782
1870
  creds_env?: Record<string, string> | undefined;
1871
+ options?: Record<string, unknown> | undefined;
1783
1872
  cache?: {
1784
1873
  enabled?: boolean | undefined;
1785
- store?: "local" | "backend" | undefined;
1874
+ store?: "backend" | "local" | undefined;
1786
1875
  ttl?: string | number | undefined;
1787
1876
  auth_cookie?: string | undefined;
1788
1877
  } | undefined;
@@ -1801,13 +1890,13 @@ export declare const RevisionMeta: z.ZodObject<{
1801
1890
  }, "strict", z.ZodTypeAny, {
1802
1891
  rev_id: string;
1803
1892
  parent_rev_id: string | null;
1804
- kind: "calibrate" | "run" | "edit";
1893
+ kind: "calibrate" | "edit" | "run";
1805
1894
  author: string;
1806
1895
  timestamp: string;
1807
1896
  }, {
1808
1897
  rev_id: string;
1809
1898
  parent_rev_id: string | null;
1810
- kind: "calibrate" | "run" | "edit";
1899
+ kind: "calibrate" | "edit" | "run";
1811
1900
  author: string;
1812
1901
  timestamp: string;
1813
1902
  }>;