@superdoc-dev/sdk 1.16.1 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/dist/generated/client.cjs +28 -0
  2. package/dist/generated/client.d.ts +72321 -18453
  3. package/dist/generated/client.d.ts.map +1 -1
  4. package/dist/generated/client.js +28 -0
  5. package/dist/generated/contract.cjs +131476 -35664
  6. package/dist/generated/contract.d.ts.map +1 -1
  7. package/dist/generated/contract.js +132855 -36860
  8. package/dist/generated/intent-dispatch.generated.cjs +1 -0
  9. package/dist/generated/intent-dispatch.generated.d.ts.map +1 -1
  10. package/dist/generated/intent-dispatch.generated.js +1 -0
  11. package/package.json +6 -6
  12. package/tools/__pycache__/__init__.cpython-312.pyc +0 -0
  13. package/tools/__pycache__/intent_dispatch_generated.cpython-312.pyc +0 -0
  14. package/tools/catalog.json +2817 -216
  15. package/tools/intent_dispatch_generated.py +2 -0
  16. package/tools/tools-policy.json +1 -1
  17. package/tools/tools.anthropic.json +2726 -131
  18. package/tools/tools.generic.json +2728 -132
  19. package/tools/tools.openai.json +2726 -131
  20. package/tools/tools.vercel.json +2726 -131
package/tools/catalog.json CHANGED
@@ -21,6 +21,10 @@
21
21
  ],
22
22
  "description": "The action to perform. One of: blocks, extract, html, info, markdown, text."
23
23
  },
24
+ "in": {
25
+ "$ref": "#/$defs/StoryLocator",
26
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
27
+ },
24
28
  "unflattenLists": {
25
29
  "type": "boolean",
26
30
  "description": "When true, flattens nested list structures in output. Default: false. Only for action 'html'. Omit for other actions."
@@ -154,6 +158,174 @@
154
158
  },
155
159
  "offset": {
156
160
  "type": "number"
161
+ },
162
+ "story": {
163
+ "oneOf": [
164
+ {
165
+ "type": "object",
166
+ "properties": {
167
+ "kind": {
168
+ "const": "story",
169
+ "type": "string"
170
+ },
171
+ "storyType": {
172
+ "const": "body",
173
+ "type": "string"
174
+ }
175
+ },
176
+ "required": [
177
+ "kind",
178
+ "storyType"
179
+ ]
180
+ },
181
+ {
182
+ "type": "object",
183
+ "properties": {
184
+ "kind": {
185
+ "const": "story",
186
+ "type": "string"
187
+ },
188
+ "storyType": {
189
+ "const": "headerFooterSlot",
190
+ "type": "string"
191
+ },
192
+ "section": {
193
+ "type": "object",
194
+ "properties": {
195
+ "kind": {
196
+ "const": "section",
197
+ "type": "string"
198
+ },
199
+ "sectionId": {
200
+ "type": "string"
201
+ }
202
+ },
203
+ "required": [
204
+ "kind",
205
+ "sectionId"
206
+ ]
207
+ },
208
+ "headerFooterKind": {
209
+ "enum": [
210
+ "header",
211
+ "footer"
212
+ ]
213
+ },
214
+ "variant": {
215
+ "enum": [
216
+ "default",
217
+ "first",
218
+ "even"
219
+ ]
220
+ },
221
+ "resolution": {
222
+ "enum": [
223
+ "effective",
224
+ "explicit"
225
+ ]
226
+ },
227
+ "onWrite": {
228
+ "enum": [
229
+ "materializeIfInherited",
230
+ "editResolvedPart",
231
+ "error"
232
+ ]
233
+ }
234
+ },
235
+ "required": [
236
+ "kind",
237
+ "storyType",
238
+ "section",
239
+ "headerFooterKind",
240
+ "variant"
241
+ ]
242
+ },
243
+ {
244
+ "type": "object",
245
+ "properties": {
246
+ "kind": {
247
+ "const": "story",
248
+ "type": "string"
249
+ },
250
+ "storyType": {
251
+ "const": "headerFooterPart",
252
+ "type": "string"
253
+ },
254
+ "refId": {
255
+ "type": "string"
256
+ }
257
+ },
258
+ "required": [
259
+ "kind",
260
+ "storyType",
261
+ "refId"
262
+ ]
263
+ },
264
+ {
265
+ "type": "object",
266
+ "properties": {
267
+ "kind": {
268
+ "const": "story",
269
+ "type": "string"
270
+ },
271
+ "storyType": {
272
+ "const": "footnote",
273
+ "type": "string"
274
+ },
275
+ "noteId": {
276
+ "type": "string"
277
+ }
278
+ },
279
+ "required": [
280
+ "kind",
281
+ "storyType",
282
+ "noteId"
283
+ ]
284
+ },
285
+ {
286
+ "type": "object",
287
+ "properties": {
288
+ "kind": {
289
+ "const": "story",
290
+ "type": "string"
291
+ },
292
+ "storyType": {
293
+ "const": "endnote",
294
+ "type": "string"
295
+ },
296
+ "noteId": {
297
+ "type": "string"
298
+ }
299
+ },
300
+ "required": [
301
+ "kind",
302
+ "storyType",
303
+ "noteId"
304
+ ]
305
+ },
306
+ {
307
+ "type": "object",
308
+ "properties": {
309
+ "kind": {
310
+ "const": "story",
311
+ "type": "string"
312
+ },
313
+ "storyType": {
314
+ "const": "textbox",
315
+ "type": "string"
316
+ },
317
+ "textboxId": {
318
+ "type": "string"
319
+ }
320
+ },
321
+ "required": [
322
+ "kind",
323
+ "storyType",
324
+ "textboxId"
325
+ ]
326
+ }
327
+ ],
328
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
157
329
  }
158
330
  },
159
331
  "required": [
@@ -188,6 +360,174 @@
188
360
  },
189
361
  "nodeId": {
190
362
  "type": "string"
363
+ },
364
+ "story": {
365
+ "oneOf": [
366
+ {
367
+ "type": "object",
368
+ "properties": {
369
+ "kind": {
370
+ "const": "story",
371
+ "type": "string"
372
+ },
373
+ "storyType": {
374
+ "const": "body",
375
+ "type": "string"
376
+ }
377
+ },
378
+ "required": [
379
+ "kind",
380
+ "storyType"
381
+ ]
382
+ },
383
+ {
384
+ "type": "object",
385
+ "properties": {
386
+ "kind": {
387
+ "const": "story",
388
+ "type": "string"
389
+ },
390
+ "storyType": {
391
+ "const": "headerFooterSlot",
392
+ "type": "string"
393
+ },
394
+ "section": {
395
+ "type": "object",
396
+ "properties": {
397
+ "kind": {
398
+ "const": "section",
399
+ "type": "string"
400
+ },
401
+ "sectionId": {
402
+ "type": "string"
403
+ }
404
+ },
405
+ "required": [
406
+ "kind",
407
+ "sectionId"
408
+ ]
409
+ },
410
+ "headerFooterKind": {
411
+ "enum": [
412
+ "header",
413
+ "footer"
414
+ ]
415
+ },
416
+ "variant": {
417
+ "enum": [
418
+ "default",
419
+ "first",
420
+ "even"
421
+ ]
422
+ },
423
+ "resolution": {
424
+ "enum": [
425
+ "effective",
426
+ "explicit"
427
+ ]
428
+ },
429
+ "onWrite": {
430
+ "enum": [
431
+ "materializeIfInherited",
432
+ "editResolvedPart",
433
+ "error"
434
+ ]
435
+ }
436
+ },
437
+ "required": [
438
+ "kind",
439
+ "storyType",
440
+ "section",
441
+ "headerFooterKind",
442
+ "variant"
443
+ ]
444
+ },
445
+ {
446
+ "type": "object",
447
+ "properties": {
448
+ "kind": {
449
+ "const": "story",
450
+ "type": "string"
451
+ },
452
+ "storyType": {
453
+ "const": "headerFooterPart",
454
+ "type": "string"
455
+ },
456
+ "refId": {
457
+ "type": "string"
458
+ }
459
+ },
460
+ "required": [
461
+ "kind",
462
+ "storyType",
463
+ "refId"
464
+ ]
465
+ },
466
+ {
467
+ "type": "object",
468
+ "properties": {
469
+ "kind": {
470
+ "const": "story",
471
+ "type": "string"
472
+ },
473
+ "storyType": {
474
+ "const": "footnote",
475
+ "type": "string"
476
+ },
477
+ "noteId": {
478
+ "type": "string"
479
+ }
480
+ },
481
+ "required": [
482
+ "kind",
483
+ "storyType",
484
+ "noteId"
485
+ ]
486
+ },
487
+ {
488
+ "type": "object",
489
+ "properties": {
490
+ "kind": {
491
+ "const": "story",
492
+ "type": "string"
493
+ },
494
+ "storyType": {
495
+ "const": "endnote",
496
+ "type": "string"
497
+ },
498
+ "noteId": {
499
+ "type": "string"
500
+ }
501
+ },
502
+ "required": [
503
+ "kind",
504
+ "storyType",
505
+ "noteId"
506
+ ]
507
+ },
508
+ {
509
+ "type": "object",
510
+ "properties": {
511
+ "kind": {
512
+ "const": "story",
513
+ "type": "string"
514
+ },
515
+ "storyType": {
516
+ "const": "textbox",
517
+ "type": "string"
518
+ },
519
+ "textboxId": {
520
+ "type": "string"
521
+ }
522
+ },
523
+ "required": [
524
+ "kind",
525
+ "storyType",
526
+ "textboxId"
527
+ ]
528
+ }
529
+ ],
530
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
191
531
  }
192
532
  },
193
533
  "required": [
@@ -226,6 +566,174 @@
226
566
  },
227
567
  "offset": {
228
568
  "type": "number"
569
+ },
570
+ "story": {
571
+ "oneOf": [
572
+ {
573
+ "type": "object",
574
+ "properties": {
575
+ "kind": {
576
+ "const": "story",
577
+ "type": "string"
578
+ },
579
+ "storyType": {
580
+ "const": "body",
581
+ "type": "string"
582
+ }
583
+ },
584
+ "required": [
585
+ "kind",
586
+ "storyType"
587
+ ]
588
+ },
589
+ {
590
+ "type": "object",
591
+ "properties": {
592
+ "kind": {
593
+ "const": "story",
594
+ "type": "string"
595
+ },
596
+ "storyType": {
597
+ "const": "headerFooterSlot",
598
+ "type": "string"
599
+ },
600
+ "section": {
601
+ "type": "object",
602
+ "properties": {
603
+ "kind": {
604
+ "const": "section",
605
+ "type": "string"
606
+ },
607
+ "sectionId": {
608
+ "type": "string"
609
+ }
610
+ },
611
+ "required": [
612
+ "kind",
613
+ "sectionId"
614
+ ]
615
+ },
616
+ "headerFooterKind": {
617
+ "enum": [
618
+ "header",
619
+ "footer"
620
+ ]
621
+ },
622
+ "variant": {
623
+ "enum": [
624
+ "default",
625
+ "first",
626
+ "even"
627
+ ]
628
+ },
629
+ "resolution": {
630
+ "enum": [
631
+ "effective",
632
+ "explicit"
633
+ ]
634
+ },
635
+ "onWrite": {
636
+ "enum": [
637
+ "materializeIfInherited",
638
+ "editResolvedPart",
639
+ "error"
640
+ ]
641
+ }
642
+ },
643
+ "required": [
644
+ "kind",
645
+ "storyType",
646
+ "section",
647
+ "headerFooterKind",
648
+ "variant"
649
+ ]
650
+ },
651
+ {
652
+ "type": "object",
653
+ "properties": {
654
+ "kind": {
655
+ "const": "story",
656
+ "type": "string"
657
+ },
658
+ "storyType": {
659
+ "const": "headerFooterPart",
660
+ "type": "string"
661
+ },
662
+ "refId": {
663
+ "type": "string"
664
+ }
665
+ },
666
+ "required": [
667
+ "kind",
668
+ "storyType",
669
+ "refId"
670
+ ]
671
+ },
672
+ {
673
+ "type": "object",
674
+ "properties": {
675
+ "kind": {
676
+ "const": "story",
677
+ "type": "string"
678
+ },
679
+ "storyType": {
680
+ "const": "footnote",
681
+ "type": "string"
682
+ },
683
+ "noteId": {
684
+ "type": "string"
685
+ }
686
+ },
687
+ "required": [
688
+ "kind",
689
+ "storyType",
690
+ "noteId"
691
+ ]
692
+ },
693
+ {
694
+ "type": "object",
695
+ "properties": {
696
+ "kind": {
697
+ "const": "story",
698
+ "type": "string"
699
+ },
700
+ "storyType": {
701
+ "const": "endnote",
702
+ "type": "string"
703
+ },
704
+ "noteId": {
705
+ "type": "string"
706
+ }
707
+ },
708
+ "required": [
709
+ "kind",
710
+ "storyType",
711
+ "noteId"
712
+ ]
713
+ },
714
+ {
715
+ "type": "object",
716
+ "properties": {
717
+ "kind": {
718
+ "const": "story",
719
+ "type": "string"
720
+ },
721
+ "storyType": {
722
+ "const": "textbox",
723
+ "type": "string"
724
+ },
725
+ "textboxId": {
726
+ "type": "string"
727
+ }
728
+ },
729
+ "required": [
730
+ "kind",
731
+ "storyType",
732
+ "textboxId"
733
+ ]
734
+ }
735
+ ],
736
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
229
737
  }
230
738
  },
231
739
  "required": [
@@ -260,6 +768,174 @@
260
768
  },
261
769
  "nodeId": {
262
770
  "type": "string"
771
+ },
772
+ "story": {
773
+ "oneOf": [
774
+ {
775
+ "type": "object",
776
+ "properties": {
777
+ "kind": {
778
+ "const": "story",
779
+ "type": "string"
780
+ },
781
+ "storyType": {
782
+ "const": "body",
783
+ "type": "string"
784
+ }
785
+ },
786
+ "required": [
787
+ "kind",
788
+ "storyType"
789
+ ]
790
+ },
791
+ {
792
+ "type": "object",
793
+ "properties": {
794
+ "kind": {
795
+ "const": "story",
796
+ "type": "string"
797
+ },
798
+ "storyType": {
799
+ "const": "headerFooterSlot",
800
+ "type": "string"
801
+ },
802
+ "section": {
803
+ "type": "object",
804
+ "properties": {
805
+ "kind": {
806
+ "const": "section",
807
+ "type": "string"
808
+ },
809
+ "sectionId": {
810
+ "type": "string"
811
+ }
812
+ },
813
+ "required": [
814
+ "kind",
815
+ "sectionId"
816
+ ]
817
+ },
818
+ "headerFooterKind": {
819
+ "enum": [
820
+ "header",
821
+ "footer"
822
+ ]
823
+ },
824
+ "variant": {
825
+ "enum": [
826
+ "default",
827
+ "first",
828
+ "even"
829
+ ]
830
+ },
831
+ "resolution": {
832
+ "enum": [
833
+ "effective",
834
+ "explicit"
835
+ ]
836
+ },
837
+ "onWrite": {
838
+ "enum": [
839
+ "materializeIfInherited",
840
+ "editResolvedPart",
841
+ "error"
842
+ ]
843
+ }
844
+ },
845
+ "required": [
846
+ "kind",
847
+ "storyType",
848
+ "section",
849
+ "headerFooterKind",
850
+ "variant"
851
+ ]
852
+ },
853
+ {
854
+ "type": "object",
855
+ "properties": {
856
+ "kind": {
857
+ "const": "story",
858
+ "type": "string"
859
+ },
860
+ "storyType": {
861
+ "const": "headerFooterPart",
862
+ "type": "string"
863
+ },
864
+ "refId": {
865
+ "type": "string"
866
+ }
867
+ },
868
+ "required": [
869
+ "kind",
870
+ "storyType",
871
+ "refId"
872
+ ]
873
+ },
874
+ {
875
+ "type": "object",
876
+ "properties": {
877
+ "kind": {
878
+ "const": "story",
879
+ "type": "string"
880
+ },
881
+ "storyType": {
882
+ "const": "footnote",
883
+ "type": "string"
884
+ },
885
+ "noteId": {
886
+ "type": "string"
887
+ }
888
+ },
889
+ "required": [
890
+ "kind",
891
+ "storyType",
892
+ "noteId"
893
+ ]
894
+ },
895
+ {
896
+ "type": "object",
897
+ "properties": {
898
+ "kind": {
899
+ "const": "story",
900
+ "type": "string"
901
+ },
902
+ "storyType": {
903
+ "const": "endnote",
904
+ "type": "string"
905
+ },
906
+ "noteId": {
907
+ "type": "string"
908
+ }
909
+ },
910
+ "required": [
911
+ "kind",
912
+ "storyType",
913
+ "noteId"
914
+ ]
915
+ },
916
+ {
917
+ "type": "object",
918
+ "properties": {
919
+ "kind": {
920
+ "const": "story",
921
+ "type": "string"
922
+ },
923
+ "storyType": {
924
+ "const": "textbox",
925
+ "type": "string"
926
+ },
927
+ "textboxId": {
928
+ "type": "string"
929
+ }
930
+ },
931
+ "required": [
932
+ "kind",
933
+ "storyType",
934
+ "textboxId"
935
+ ]
936
+ }
937
+ ],
938
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
263
939
  }
264
940
  },
265
941
  "required": [
@@ -283,213 +959,1575 @@
283
959
  }
284
960
  ],
285
961
  "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
286
- }
287
- },
288
- "required": [
289
- "kind",
290
- "start",
291
- "end"
292
- ]
293
- },
294
- {
295
- "type": "object",
296
- "properties": {
297
- "kind": {
298
- "const": "block",
299
- "type": "string"
300
- },
301
- "nodeType": {
302
- "enum": [
303
- "paragraph",
304
- "heading",
305
- "listItem",
306
- "table",
307
- "tableRow",
308
- "tableCell",
309
- "tableOfContents",
310
- "image",
311
- "sdt"
312
- ]
313
- },
314
- "nodeId": {
315
- "type": "string"
316
- }
317
- },
318
- "required": [
319
- "kind",
320
- "nodeType",
321
- "nodeId"
322
- ]
323
- },
324
- {
325
- "type": "object",
326
- "properties": {
327
- "kind": {
328
- "const": "selection",
329
- "type": "string"
330
962
  },
331
- "start": {
963
+ "story": {
332
964
  "oneOf": [
333
965
  {
334
966
  "type": "object",
335
967
  "properties": {
336
968
  "kind": {
337
- "const": "text",
969
+ "const": "story",
338
970
  "type": "string"
339
971
  },
340
- "blockId": {
972
+ "storyType": {
973
+ "const": "body",
341
974
  "type": "string"
975
+ }
976
+ },
977
+ "required": [
978
+ "kind",
979
+ "storyType"
980
+ ]
981
+ },
982
+ {
983
+ "type": "object",
984
+ "properties": {
985
+ "kind": {
986
+ "const": "story",
987
+ "type": "string"
988
+ },
989
+ "storyType": {
990
+ "const": "headerFooterSlot",
991
+ "type": "string"
992
+ },
993
+ "section": {
994
+ "type": "object",
995
+ "properties": {
996
+ "kind": {
997
+ "const": "section",
998
+ "type": "string"
999
+ },
1000
+ "sectionId": {
1001
+ "type": "string"
1002
+ }
1003
+ },
1004
+ "required": [
1005
+ "kind",
1006
+ "sectionId"
1007
+ ]
1008
+ },
1009
+ "headerFooterKind": {
1010
+ "enum": [
1011
+ "header",
1012
+ "footer"
1013
+ ]
1014
+ },
1015
+ "variant": {
1016
+ "enum": [
1017
+ "default",
1018
+ "first",
1019
+ "even"
1020
+ ]
1021
+ },
1022
+ "resolution": {
1023
+ "enum": [
1024
+ "effective",
1025
+ "explicit"
1026
+ ]
1027
+ },
1028
+ "onWrite": {
1029
+ "enum": [
1030
+ "materializeIfInherited",
1031
+ "editResolvedPart",
1032
+ "error"
1033
+ ]
1034
+ }
1035
+ },
1036
+ "required": [
1037
+ "kind",
1038
+ "storyType",
1039
+ "section",
1040
+ "headerFooterKind",
1041
+ "variant"
1042
+ ]
1043
+ },
1044
+ {
1045
+ "type": "object",
1046
+ "properties": {
1047
+ "kind": {
1048
+ "const": "story",
1049
+ "type": "string"
1050
+ },
1051
+ "storyType": {
1052
+ "const": "headerFooterPart",
1053
+ "type": "string"
1054
+ },
1055
+ "refId": {
1056
+ "type": "string"
1057
+ }
1058
+ },
1059
+ "required": [
1060
+ "kind",
1061
+ "storyType",
1062
+ "refId"
1063
+ ]
1064
+ },
1065
+ {
1066
+ "type": "object",
1067
+ "properties": {
1068
+ "kind": {
1069
+ "const": "story",
1070
+ "type": "string"
1071
+ },
1072
+ "storyType": {
1073
+ "const": "footnote",
1074
+ "type": "string"
1075
+ },
1076
+ "noteId": {
1077
+ "type": "string"
1078
+ }
1079
+ },
1080
+ "required": [
1081
+ "kind",
1082
+ "storyType",
1083
+ "noteId"
1084
+ ]
1085
+ },
1086
+ {
1087
+ "type": "object",
1088
+ "properties": {
1089
+ "kind": {
1090
+ "const": "story",
1091
+ "type": "string"
1092
+ },
1093
+ "storyType": {
1094
+ "const": "endnote",
1095
+ "type": "string"
1096
+ },
1097
+ "noteId": {
1098
+ "type": "string"
1099
+ }
1100
+ },
1101
+ "required": [
1102
+ "kind",
1103
+ "storyType",
1104
+ "noteId"
1105
+ ]
1106
+ },
1107
+ {
1108
+ "type": "object",
1109
+ "properties": {
1110
+ "kind": {
1111
+ "const": "story",
1112
+ "type": "string"
1113
+ },
1114
+ "storyType": {
1115
+ "const": "textbox",
1116
+ "type": "string"
1117
+ },
1118
+ "textboxId": {
1119
+ "type": "string"
1120
+ }
1121
+ },
1122
+ "required": [
1123
+ "kind",
1124
+ "storyType",
1125
+ "textboxId"
1126
+ ]
1127
+ }
1128
+ ],
1129
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
1130
+ }
1131
+ },
1132
+ "required": [
1133
+ "kind",
1134
+ "start",
1135
+ "end"
1136
+ ]
1137
+ },
1138
+ {
1139
+ "type": "object",
1140
+ "properties": {
1141
+ "kind": {
1142
+ "const": "block",
1143
+ "type": "string"
1144
+ },
1145
+ "nodeType": {
1146
+ "enum": [
1147
+ "paragraph",
1148
+ "heading",
1149
+ "listItem",
1150
+ "table",
1151
+ "tableRow",
1152
+ "tableCell",
1153
+ "tableOfContents",
1154
+ "image",
1155
+ "sdt"
1156
+ ]
1157
+ },
1158
+ "nodeId": {
1159
+ "type": "string"
1160
+ },
1161
+ "story": {
1162
+ "oneOf": [
1163
+ {
1164
+ "type": "object",
1165
+ "properties": {
1166
+ "kind": {
1167
+ "const": "story",
1168
+ "type": "string"
1169
+ },
1170
+ "storyType": {
1171
+ "const": "body",
1172
+ "type": "string"
1173
+ }
1174
+ },
1175
+ "required": [
1176
+ "kind",
1177
+ "storyType"
1178
+ ]
1179
+ },
1180
+ {
1181
+ "type": "object",
1182
+ "properties": {
1183
+ "kind": {
1184
+ "const": "story",
1185
+ "type": "string"
1186
+ },
1187
+ "storyType": {
1188
+ "const": "headerFooterSlot",
1189
+ "type": "string"
1190
+ },
1191
+ "section": {
1192
+ "type": "object",
1193
+ "properties": {
1194
+ "kind": {
1195
+ "const": "section",
1196
+ "type": "string"
1197
+ },
1198
+ "sectionId": {
1199
+ "type": "string"
1200
+ }
1201
+ },
1202
+ "required": [
1203
+ "kind",
1204
+ "sectionId"
1205
+ ]
1206
+ },
1207
+ "headerFooterKind": {
1208
+ "enum": [
1209
+ "header",
1210
+ "footer"
1211
+ ]
1212
+ },
1213
+ "variant": {
1214
+ "enum": [
1215
+ "default",
1216
+ "first",
1217
+ "even"
1218
+ ]
1219
+ },
1220
+ "resolution": {
1221
+ "enum": [
1222
+ "effective",
1223
+ "explicit"
1224
+ ]
1225
+ },
1226
+ "onWrite": {
1227
+ "enum": [
1228
+ "materializeIfInherited",
1229
+ "editResolvedPart",
1230
+ "error"
1231
+ ]
1232
+ }
1233
+ },
1234
+ "required": [
1235
+ "kind",
1236
+ "storyType",
1237
+ "section",
1238
+ "headerFooterKind",
1239
+ "variant"
1240
+ ]
1241
+ },
1242
+ {
1243
+ "type": "object",
1244
+ "properties": {
1245
+ "kind": {
1246
+ "const": "story",
1247
+ "type": "string"
1248
+ },
1249
+ "storyType": {
1250
+ "const": "headerFooterPart",
1251
+ "type": "string"
1252
+ },
1253
+ "refId": {
1254
+ "type": "string"
1255
+ }
1256
+ },
1257
+ "required": [
1258
+ "kind",
1259
+ "storyType",
1260
+ "refId"
1261
+ ]
1262
+ },
1263
+ {
1264
+ "type": "object",
1265
+ "properties": {
1266
+ "kind": {
1267
+ "const": "story",
1268
+ "type": "string"
1269
+ },
1270
+ "storyType": {
1271
+ "const": "footnote",
1272
+ "type": "string"
1273
+ },
1274
+ "noteId": {
1275
+ "type": "string"
1276
+ }
1277
+ },
1278
+ "required": [
1279
+ "kind",
1280
+ "storyType",
1281
+ "noteId"
1282
+ ]
1283
+ },
1284
+ {
1285
+ "type": "object",
1286
+ "properties": {
1287
+ "kind": {
1288
+ "const": "story",
1289
+ "type": "string"
1290
+ },
1291
+ "storyType": {
1292
+ "const": "endnote",
1293
+ "type": "string"
1294
+ },
1295
+ "noteId": {
1296
+ "type": "string"
1297
+ }
1298
+ },
1299
+ "required": [
1300
+ "kind",
1301
+ "storyType",
1302
+ "noteId"
1303
+ ]
1304
+ },
1305
+ {
1306
+ "type": "object",
1307
+ "properties": {
1308
+ "kind": {
1309
+ "const": "story",
1310
+ "type": "string"
1311
+ },
1312
+ "storyType": {
1313
+ "const": "textbox",
1314
+ "type": "string"
1315
+ },
1316
+ "textboxId": {
1317
+ "type": "string"
1318
+ }
1319
+ },
1320
+ "required": [
1321
+ "kind",
1322
+ "storyType",
1323
+ "textboxId"
1324
+ ]
1325
+ }
1326
+ ],
1327
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
1328
+ }
1329
+ },
1330
+ "required": [
1331
+ "kind",
1332
+ "nodeType",
1333
+ "nodeId"
1334
+ ]
1335
+ },
1336
+ {
1337
+ "type": "object",
1338
+ "properties": {
1339
+ "kind": {
1340
+ "const": "selection",
1341
+ "type": "string"
1342
+ },
1343
+ "start": {
1344
+ "oneOf": [
1345
+ {
1346
+ "type": "object",
1347
+ "properties": {
1348
+ "kind": {
1349
+ "const": "text",
1350
+ "type": "string"
1351
+ },
1352
+ "blockId": {
1353
+ "type": "string"
1354
+ },
1355
+ "offset": {
1356
+ "type": "number"
1357
+ },
1358
+ "story": {
1359
+ "oneOf": [
1360
+ {
1361
+ "type": "object",
1362
+ "properties": {
1363
+ "kind": {
1364
+ "const": "story",
1365
+ "type": "string"
1366
+ },
1367
+ "storyType": {
1368
+ "const": "body",
1369
+ "type": "string"
1370
+ }
1371
+ },
1372
+ "required": [
1373
+ "kind",
1374
+ "storyType"
1375
+ ]
1376
+ },
1377
+ {
1378
+ "type": "object",
1379
+ "properties": {
1380
+ "kind": {
1381
+ "const": "story",
1382
+ "type": "string"
1383
+ },
1384
+ "storyType": {
1385
+ "const": "headerFooterSlot",
1386
+ "type": "string"
1387
+ },
1388
+ "section": {
1389
+ "type": "object",
1390
+ "properties": {
1391
+ "kind": {
1392
+ "const": "section",
1393
+ "type": "string"
1394
+ },
1395
+ "sectionId": {
1396
+ "type": "string"
1397
+ }
1398
+ },
1399
+ "required": [
1400
+ "kind",
1401
+ "sectionId"
1402
+ ]
1403
+ },
1404
+ "headerFooterKind": {
1405
+ "enum": [
1406
+ "header",
1407
+ "footer"
1408
+ ]
1409
+ },
1410
+ "variant": {
1411
+ "enum": [
1412
+ "default",
1413
+ "first",
1414
+ "even"
1415
+ ]
1416
+ },
1417
+ "resolution": {
1418
+ "enum": [
1419
+ "effective",
1420
+ "explicit"
1421
+ ]
1422
+ },
1423
+ "onWrite": {
1424
+ "enum": [
1425
+ "materializeIfInherited",
1426
+ "editResolvedPart",
1427
+ "error"
1428
+ ]
1429
+ }
1430
+ },
1431
+ "required": [
1432
+ "kind",
1433
+ "storyType",
1434
+ "section",
1435
+ "headerFooterKind",
1436
+ "variant"
1437
+ ]
1438
+ },
1439
+ {
1440
+ "type": "object",
1441
+ "properties": {
1442
+ "kind": {
1443
+ "const": "story",
1444
+ "type": "string"
1445
+ },
1446
+ "storyType": {
1447
+ "const": "headerFooterPart",
1448
+ "type": "string"
1449
+ },
1450
+ "refId": {
1451
+ "type": "string"
1452
+ }
1453
+ },
1454
+ "required": [
1455
+ "kind",
1456
+ "storyType",
1457
+ "refId"
1458
+ ]
1459
+ },
1460
+ {
1461
+ "type": "object",
1462
+ "properties": {
1463
+ "kind": {
1464
+ "const": "story",
1465
+ "type": "string"
1466
+ },
1467
+ "storyType": {
1468
+ "const": "footnote",
1469
+ "type": "string"
1470
+ },
1471
+ "noteId": {
1472
+ "type": "string"
1473
+ }
1474
+ },
1475
+ "required": [
1476
+ "kind",
1477
+ "storyType",
1478
+ "noteId"
1479
+ ]
1480
+ },
1481
+ {
1482
+ "type": "object",
1483
+ "properties": {
1484
+ "kind": {
1485
+ "const": "story",
1486
+ "type": "string"
1487
+ },
1488
+ "storyType": {
1489
+ "const": "endnote",
1490
+ "type": "string"
1491
+ },
1492
+ "noteId": {
1493
+ "type": "string"
1494
+ }
1495
+ },
1496
+ "required": [
1497
+ "kind",
1498
+ "storyType",
1499
+ "noteId"
1500
+ ]
1501
+ },
1502
+ {
1503
+ "type": "object",
1504
+ "properties": {
1505
+ "kind": {
1506
+ "const": "story",
1507
+ "type": "string"
1508
+ },
1509
+ "storyType": {
1510
+ "const": "textbox",
1511
+ "type": "string"
1512
+ },
1513
+ "textboxId": {
1514
+ "type": "string"
1515
+ }
1516
+ },
1517
+ "required": [
1518
+ "kind",
1519
+ "storyType",
1520
+ "textboxId"
1521
+ ]
1522
+ }
1523
+ ],
1524
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
1525
+ }
1526
+ },
1527
+ "required": [
1528
+ "kind",
1529
+ "blockId",
1530
+ "offset"
1531
+ ]
1532
+ },
1533
+ {
1534
+ "type": "object",
1535
+ "properties": {
1536
+ "kind": {
1537
+ "const": "nodeEdge",
1538
+ "type": "string"
1539
+ },
1540
+ "node": {
1541
+ "type": "object",
1542
+ "properties": {
1543
+ "kind": {
1544
+ "const": "block",
1545
+ "type": "string"
1546
+ },
1547
+ "nodeType": {
1548
+ "enum": [
1549
+ "paragraph",
1550
+ "heading",
1551
+ "table",
1552
+ "tableOfContents",
1553
+ "sdt",
1554
+ "image"
1555
+ ]
1556
+ },
1557
+ "nodeId": {
1558
+ "type": "string"
1559
+ },
1560
+ "story": {
1561
+ "oneOf": [
1562
+ {
1563
+ "type": "object",
1564
+ "properties": {
1565
+ "kind": {
1566
+ "const": "story",
1567
+ "type": "string"
1568
+ },
1569
+ "storyType": {
1570
+ "const": "body",
1571
+ "type": "string"
1572
+ }
1573
+ },
1574
+ "required": [
1575
+ "kind",
1576
+ "storyType"
1577
+ ]
1578
+ },
1579
+ {
1580
+ "type": "object",
1581
+ "properties": {
1582
+ "kind": {
1583
+ "const": "story",
1584
+ "type": "string"
1585
+ },
1586
+ "storyType": {
1587
+ "const": "headerFooterSlot",
1588
+ "type": "string"
1589
+ },
1590
+ "section": {
1591
+ "type": "object",
1592
+ "properties": {
1593
+ "kind": {
1594
+ "const": "section",
1595
+ "type": "string"
1596
+ },
1597
+ "sectionId": {
1598
+ "type": "string"
1599
+ }
1600
+ },
1601
+ "required": [
1602
+ "kind",
1603
+ "sectionId"
1604
+ ]
1605
+ },
1606
+ "headerFooterKind": {
1607
+ "enum": [
1608
+ "header",
1609
+ "footer"
1610
+ ]
1611
+ },
1612
+ "variant": {
1613
+ "enum": [
1614
+ "default",
1615
+ "first",
1616
+ "even"
1617
+ ]
1618
+ },
1619
+ "resolution": {
1620
+ "enum": [
1621
+ "effective",
1622
+ "explicit"
1623
+ ]
1624
+ },
1625
+ "onWrite": {
1626
+ "enum": [
1627
+ "materializeIfInherited",
1628
+ "editResolvedPart",
1629
+ "error"
1630
+ ]
1631
+ }
1632
+ },
1633
+ "required": [
1634
+ "kind",
1635
+ "storyType",
1636
+ "section",
1637
+ "headerFooterKind",
1638
+ "variant"
1639
+ ]
1640
+ },
1641
+ {
1642
+ "type": "object",
1643
+ "properties": {
1644
+ "kind": {
1645
+ "const": "story",
1646
+ "type": "string"
1647
+ },
1648
+ "storyType": {
1649
+ "const": "headerFooterPart",
1650
+ "type": "string"
1651
+ },
1652
+ "refId": {
1653
+ "type": "string"
1654
+ }
1655
+ },
1656
+ "required": [
1657
+ "kind",
1658
+ "storyType",
1659
+ "refId"
1660
+ ]
1661
+ },
1662
+ {
1663
+ "type": "object",
1664
+ "properties": {
1665
+ "kind": {
1666
+ "const": "story",
1667
+ "type": "string"
1668
+ },
1669
+ "storyType": {
1670
+ "const": "footnote",
1671
+ "type": "string"
1672
+ },
1673
+ "noteId": {
1674
+ "type": "string"
1675
+ }
1676
+ },
1677
+ "required": [
1678
+ "kind",
1679
+ "storyType",
1680
+ "noteId"
1681
+ ]
1682
+ },
1683
+ {
1684
+ "type": "object",
1685
+ "properties": {
1686
+ "kind": {
1687
+ "const": "story",
1688
+ "type": "string"
1689
+ },
1690
+ "storyType": {
1691
+ "const": "endnote",
1692
+ "type": "string"
1693
+ },
1694
+ "noteId": {
1695
+ "type": "string"
1696
+ }
1697
+ },
1698
+ "required": [
1699
+ "kind",
1700
+ "storyType",
1701
+ "noteId"
1702
+ ]
1703
+ },
1704
+ {
1705
+ "type": "object",
1706
+ "properties": {
1707
+ "kind": {
1708
+ "const": "story",
1709
+ "type": "string"
1710
+ },
1711
+ "storyType": {
1712
+ "const": "textbox",
1713
+ "type": "string"
1714
+ },
1715
+ "textboxId": {
1716
+ "type": "string"
1717
+ }
1718
+ },
1719
+ "required": [
1720
+ "kind",
1721
+ "storyType",
1722
+ "textboxId"
1723
+ ]
1724
+ }
1725
+ ],
1726
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
1727
+ }
1728
+ },
1729
+ "required": [
1730
+ "kind",
1731
+ "nodeType",
1732
+ "nodeId"
1733
+ ]
1734
+ },
1735
+ "edge": {
1736
+ "enum": [
1737
+ "before",
1738
+ "after"
1739
+ ]
1740
+ }
1741
+ },
1742
+ "required": [
1743
+ "kind",
1744
+ "node",
1745
+ "edge"
1746
+ ]
1747
+ }
1748
+ ],
1749
+ "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
1750
+ },
1751
+ "end": {
1752
+ "oneOf": [
1753
+ {
1754
+ "type": "object",
1755
+ "properties": {
1756
+ "kind": {
1757
+ "const": "text",
1758
+ "type": "string"
1759
+ },
1760
+ "blockId": {
1761
+ "type": "string"
1762
+ },
1763
+ "offset": {
1764
+ "type": "number"
1765
+ },
1766
+ "story": {
1767
+ "oneOf": [
1768
+ {
1769
+ "type": "object",
1770
+ "properties": {
1771
+ "kind": {
1772
+ "const": "story",
1773
+ "type": "string"
1774
+ },
1775
+ "storyType": {
1776
+ "const": "body",
1777
+ "type": "string"
1778
+ }
1779
+ },
1780
+ "required": [
1781
+ "kind",
1782
+ "storyType"
1783
+ ]
1784
+ },
1785
+ {
1786
+ "type": "object",
1787
+ "properties": {
1788
+ "kind": {
1789
+ "const": "story",
1790
+ "type": "string"
1791
+ },
1792
+ "storyType": {
1793
+ "const": "headerFooterSlot",
1794
+ "type": "string"
1795
+ },
1796
+ "section": {
1797
+ "type": "object",
1798
+ "properties": {
1799
+ "kind": {
1800
+ "const": "section",
1801
+ "type": "string"
1802
+ },
1803
+ "sectionId": {
1804
+ "type": "string"
1805
+ }
1806
+ },
1807
+ "required": [
1808
+ "kind",
1809
+ "sectionId"
1810
+ ]
1811
+ },
1812
+ "headerFooterKind": {
1813
+ "enum": [
1814
+ "header",
1815
+ "footer"
1816
+ ]
1817
+ },
1818
+ "variant": {
1819
+ "enum": [
1820
+ "default",
1821
+ "first",
1822
+ "even"
1823
+ ]
1824
+ },
1825
+ "resolution": {
1826
+ "enum": [
1827
+ "effective",
1828
+ "explicit"
1829
+ ]
1830
+ },
1831
+ "onWrite": {
1832
+ "enum": [
1833
+ "materializeIfInherited",
1834
+ "editResolvedPart",
1835
+ "error"
1836
+ ]
1837
+ }
1838
+ },
1839
+ "required": [
1840
+ "kind",
1841
+ "storyType",
1842
+ "section",
1843
+ "headerFooterKind",
1844
+ "variant"
1845
+ ]
1846
+ },
1847
+ {
1848
+ "type": "object",
1849
+ "properties": {
1850
+ "kind": {
1851
+ "const": "story",
1852
+ "type": "string"
1853
+ },
1854
+ "storyType": {
1855
+ "const": "headerFooterPart",
1856
+ "type": "string"
1857
+ },
1858
+ "refId": {
1859
+ "type": "string"
1860
+ }
1861
+ },
1862
+ "required": [
1863
+ "kind",
1864
+ "storyType",
1865
+ "refId"
1866
+ ]
1867
+ },
1868
+ {
1869
+ "type": "object",
1870
+ "properties": {
1871
+ "kind": {
1872
+ "const": "story",
1873
+ "type": "string"
1874
+ },
1875
+ "storyType": {
1876
+ "const": "footnote",
1877
+ "type": "string"
1878
+ },
1879
+ "noteId": {
1880
+ "type": "string"
1881
+ }
1882
+ },
1883
+ "required": [
1884
+ "kind",
1885
+ "storyType",
1886
+ "noteId"
1887
+ ]
1888
+ },
1889
+ {
1890
+ "type": "object",
1891
+ "properties": {
1892
+ "kind": {
1893
+ "const": "story",
1894
+ "type": "string"
1895
+ },
1896
+ "storyType": {
1897
+ "const": "endnote",
1898
+ "type": "string"
1899
+ },
1900
+ "noteId": {
1901
+ "type": "string"
1902
+ }
1903
+ },
1904
+ "required": [
1905
+ "kind",
1906
+ "storyType",
1907
+ "noteId"
1908
+ ]
1909
+ },
1910
+ {
1911
+ "type": "object",
1912
+ "properties": {
1913
+ "kind": {
1914
+ "const": "story",
1915
+ "type": "string"
1916
+ },
1917
+ "storyType": {
1918
+ "const": "textbox",
1919
+ "type": "string"
1920
+ },
1921
+ "textboxId": {
1922
+ "type": "string"
1923
+ }
1924
+ },
1925
+ "required": [
1926
+ "kind",
1927
+ "storyType",
1928
+ "textboxId"
1929
+ ]
1930
+ }
1931
+ ],
1932
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
1933
+ }
1934
+ },
1935
+ "required": [
1936
+ "kind",
1937
+ "blockId",
1938
+ "offset"
1939
+ ]
1940
+ },
1941
+ {
1942
+ "type": "object",
1943
+ "properties": {
1944
+ "kind": {
1945
+ "const": "nodeEdge",
1946
+ "type": "string"
1947
+ },
1948
+ "node": {
1949
+ "type": "object",
1950
+ "properties": {
1951
+ "kind": {
1952
+ "const": "block",
1953
+ "type": "string"
1954
+ },
1955
+ "nodeType": {
1956
+ "enum": [
1957
+ "paragraph",
1958
+ "heading",
1959
+ "table",
1960
+ "tableOfContents",
1961
+ "sdt",
1962
+ "image"
1963
+ ]
1964
+ },
1965
+ "nodeId": {
1966
+ "type": "string"
1967
+ },
1968
+ "story": {
1969
+ "oneOf": [
1970
+ {
1971
+ "type": "object",
1972
+ "properties": {
1973
+ "kind": {
1974
+ "const": "story",
1975
+ "type": "string"
1976
+ },
1977
+ "storyType": {
1978
+ "const": "body",
1979
+ "type": "string"
1980
+ }
1981
+ },
1982
+ "required": [
1983
+ "kind",
1984
+ "storyType"
1985
+ ]
1986
+ },
1987
+ {
1988
+ "type": "object",
1989
+ "properties": {
1990
+ "kind": {
1991
+ "const": "story",
1992
+ "type": "string"
1993
+ },
1994
+ "storyType": {
1995
+ "const": "headerFooterSlot",
1996
+ "type": "string"
1997
+ },
1998
+ "section": {
1999
+ "type": "object",
2000
+ "properties": {
2001
+ "kind": {
2002
+ "const": "section",
2003
+ "type": "string"
2004
+ },
2005
+ "sectionId": {
2006
+ "type": "string"
2007
+ }
2008
+ },
2009
+ "required": [
2010
+ "kind",
2011
+ "sectionId"
2012
+ ]
2013
+ },
2014
+ "headerFooterKind": {
2015
+ "enum": [
2016
+ "header",
2017
+ "footer"
2018
+ ]
2019
+ },
2020
+ "variant": {
2021
+ "enum": [
2022
+ "default",
2023
+ "first",
2024
+ "even"
2025
+ ]
2026
+ },
2027
+ "resolution": {
2028
+ "enum": [
2029
+ "effective",
2030
+ "explicit"
2031
+ ]
2032
+ },
2033
+ "onWrite": {
2034
+ "enum": [
2035
+ "materializeIfInherited",
2036
+ "editResolvedPart",
2037
+ "error"
2038
+ ]
2039
+ }
2040
+ },
2041
+ "required": [
2042
+ "kind",
2043
+ "storyType",
2044
+ "section",
2045
+ "headerFooterKind",
2046
+ "variant"
2047
+ ]
2048
+ },
2049
+ {
2050
+ "type": "object",
2051
+ "properties": {
2052
+ "kind": {
2053
+ "const": "story",
2054
+ "type": "string"
2055
+ },
2056
+ "storyType": {
2057
+ "const": "headerFooterPart",
2058
+ "type": "string"
2059
+ },
2060
+ "refId": {
2061
+ "type": "string"
2062
+ }
2063
+ },
2064
+ "required": [
2065
+ "kind",
2066
+ "storyType",
2067
+ "refId"
2068
+ ]
2069
+ },
2070
+ {
2071
+ "type": "object",
2072
+ "properties": {
2073
+ "kind": {
2074
+ "const": "story",
2075
+ "type": "string"
2076
+ },
2077
+ "storyType": {
2078
+ "const": "footnote",
2079
+ "type": "string"
2080
+ },
2081
+ "noteId": {
2082
+ "type": "string"
2083
+ }
2084
+ },
2085
+ "required": [
2086
+ "kind",
2087
+ "storyType",
2088
+ "noteId"
2089
+ ]
2090
+ },
2091
+ {
2092
+ "type": "object",
2093
+ "properties": {
2094
+ "kind": {
2095
+ "const": "story",
2096
+ "type": "string"
2097
+ },
2098
+ "storyType": {
2099
+ "const": "endnote",
2100
+ "type": "string"
2101
+ },
2102
+ "noteId": {
2103
+ "type": "string"
2104
+ }
2105
+ },
2106
+ "required": [
2107
+ "kind",
2108
+ "storyType",
2109
+ "noteId"
2110
+ ]
2111
+ },
2112
+ {
2113
+ "type": "object",
2114
+ "properties": {
2115
+ "kind": {
2116
+ "const": "story",
2117
+ "type": "string"
2118
+ },
2119
+ "storyType": {
2120
+ "const": "textbox",
2121
+ "type": "string"
2122
+ },
2123
+ "textboxId": {
2124
+ "type": "string"
2125
+ }
2126
+ },
2127
+ "required": [
2128
+ "kind",
2129
+ "storyType",
2130
+ "textboxId"
2131
+ ]
2132
+ }
2133
+ ],
2134
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
2135
+ }
2136
+ },
2137
+ "required": [
2138
+ "kind",
2139
+ "nodeType",
2140
+ "nodeId"
2141
+ ]
342
2142
  },
343
- "offset": {
344
- "type": "number"
2143
+ "edge": {
2144
+ "enum": [
2145
+ "before",
2146
+ "after"
2147
+ ]
345
2148
  }
346
2149
  },
347
2150
  "required": [
348
2151
  "kind",
349
- "blockId",
350
- "offset"
2152
+ "node",
2153
+ "edge"
2154
+ ]
2155
+ }
2156
+ ],
2157
+ "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
2158
+ },
2159
+ "story": {
2160
+ "oneOf": [
2161
+ {
2162
+ "type": "object",
2163
+ "properties": {
2164
+ "kind": {
2165
+ "const": "story",
2166
+ "type": "string"
2167
+ },
2168
+ "storyType": {
2169
+ "const": "body",
2170
+ "type": "string"
2171
+ }
2172
+ },
2173
+ "required": [
2174
+ "kind",
2175
+ "storyType"
351
2176
  ]
352
2177
  },
353
2178
  {
354
2179
  "type": "object",
355
2180
  "properties": {
356
2181
  "kind": {
357
- "const": "nodeEdge",
2182
+ "const": "story",
358
2183
  "type": "string"
359
2184
  },
360
- "node": {
2185
+ "storyType": {
2186
+ "const": "headerFooterSlot",
2187
+ "type": "string"
2188
+ },
2189
+ "section": {
361
2190
  "type": "object",
362
2191
  "properties": {
363
2192
  "kind": {
364
- "const": "block",
2193
+ "const": "section",
365
2194
  "type": "string"
366
2195
  },
367
- "nodeType": {
368
- "enum": [
369
- "paragraph",
370
- "heading",
371
- "table",
372
- "tableOfContents",
373
- "sdt",
374
- "image"
375
- ]
376
- },
377
- "nodeId": {
2196
+ "sectionId": {
378
2197
  "type": "string"
379
2198
  }
380
2199
  },
381
2200
  "required": [
382
2201
  "kind",
383
- "nodeType",
384
- "nodeId"
2202
+ "sectionId"
385
2203
  ]
386
2204
  },
387
- "edge": {
2205
+ "headerFooterKind": {
388
2206
  "enum": [
389
- "before",
390
- "after"
2207
+ "header",
2208
+ "footer"
2209
+ ]
2210
+ },
2211
+ "variant": {
2212
+ "enum": [
2213
+ "default",
2214
+ "first",
2215
+ "even"
2216
+ ]
2217
+ },
2218
+ "resolution": {
2219
+ "enum": [
2220
+ "effective",
2221
+ "explicit"
2222
+ ]
2223
+ },
2224
+ "onWrite": {
2225
+ "enum": [
2226
+ "materializeIfInherited",
2227
+ "editResolvedPart",
2228
+ "error"
391
2229
  ]
392
2230
  }
393
2231
  },
394
2232
  "required": [
395
2233
  "kind",
396
- "node",
397
- "edge"
2234
+ "storyType",
2235
+ "section",
2236
+ "headerFooterKind",
2237
+ "variant"
2238
+ ]
2239
+ },
2240
+ {
2241
+ "type": "object",
2242
+ "properties": {
2243
+ "kind": {
2244
+ "const": "story",
2245
+ "type": "string"
2246
+ },
2247
+ "storyType": {
2248
+ "const": "headerFooterPart",
2249
+ "type": "string"
2250
+ },
2251
+ "refId": {
2252
+ "type": "string"
2253
+ }
2254
+ },
2255
+ "required": [
2256
+ "kind",
2257
+ "storyType",
2258
+ "refId"
2259
+ ]
2260
+ },
2261
+ {
2262
+ "type": "object",
2263
+ "properties": {
2264
+ "kind": {
2265
+ "const": "story",
2266
+ "type": "string"
2267
+ },
2268
+ "storyType": {
2269
+ "const": "footnote",
2270
+ "type": "string"
2271
+ },
2272
+ "noteId": {
2273
+ "type": "string"
2274
+ }
2275
+ },
2276
+ "required": [
2277
+ "kind",
2278
+ "storyType",
2279
+ "noteId"
2280
+ ]
2281
+ },
2282
+ {
2283
+ "type": "object",
2284
+ "properties": {
2285
+ "kind": {
2286
+ "const": "story",
2287
+ "type": "string"
2288
+ },
2289
+ "storyType": {
2290
+ "const": "endnote",
2291
+ "type": "string"
2292
+ },
2293
+ "noteId": {
2294
+ "type": "string"
2295
+ }
2296
+ },
2297
+ "required": [
2298
+ "kind",
2299
+ "storyType",
2300
+ "noteId"
2301
+ ]
2302
+ },
2303
+ {
2304
+ "type": "object",
2305
+ "properties": {
2306
+ "kind": {
2307
+ "const": "story",
2308
+ "type": "string"
2309
+ },
2310
+ "storyType": {
2311
+ "const": "textbox",
2312
+ "type": "string"
2313
+ },
2314
+ "textboxId": {
2315
+ "type": "string"
2316
+ }
2317
+ },
2318
+ "required": [
2319
+ "kind",
2320
+ "storyType",
2321
+ "textboxId"
398
2322
  ]
399
2323
  }
400
2324
  ],
401
- "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
2325
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
2326
+ }
2327
+ },
2328
+ "required": [
2329
+ "kind",
2330
+ "start",
2331
+ "end"
2332
+ ]
2333
+ }
2334
+ ]
2335
+ }
2336
+ ],
2337
+ "description": "Block address for structural insertion: {kind:'block', nodeType:'...', nodeId:'...'}."
2338
+ },
2339
+ {
2340
+ "$ref": "#/$defs/SelectionTarget",
2341
+ "description": "Selection target: {kind:'selection', start:{kind:'text', blockId, offset}, end:{kind:'text', blockId, offset}}. Use 'ref' instead when you have a search result handle."
2342
+ }
2343
+ ],
2344
+ "description": "Block address for structural insertion: {kind:'block', nodeType:'...', nodeId:'...'}."
2345
+ },
2346
+ "in": {
2347
+ "oneOf": [
2348
+ {
2349
+ "oneOf": [
2350
+ {
2351
+ "$ref": "#/$defs/StoryLocator",
2352
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
2353
+ },
2354
+ {
2355
+ "oneOf": [
2356
+ {
2357
+ "type": "object",
2358
+ "properties": {
2359
+ "kind": {
2360
+ "const": "story",
2361
+ "type": "string"
2362
+ },
2363
+ "storyType": {
2364
+ "const": "body",
2365
+ "type": "string"
2366
+ }
2367
+ },
2368
+ "required": [
2369
+ "kind",
2370
+ "storyType"
2371
+ ]
2372
+ },
2373
+ {
2374
+ "type": "object",
2375
+ "properties": {
2376
+ "kind": {
2377
+ "const": "story",
2378
+ "type": "string"
2379
+ },
2380
+ "storyType": {
2381
+ "const": "headerFooterSlot",
2382
+ "type": "string"
2383
+ },
2384
+ "section": {
2385
+ "type": "object",
2386
+ "properties": {
2387
+ "kind": {
2388
+ "const": "section",
2389
+ "type": "string"
2390
+ },
2391
+ "sectionId": {
2392
+ "type": "string"
2393
+ }
2394
+ },
2395
+ "required": [
2396
+ "kind",
2397
+ "sectionId"
2398
+ ]
2399
+ },
2400
+ "headerFooterKind": {
2401
+ "enum": [
2402
+ "header",
2403
+ "footer"
2404
+ ]
2405
+ },
2406
+ "variant": {
2407
+ "enum": [
2408
+ "default",
2409
+ "first",
2410
+ "even"
2411
+ ]
2412
+ },
2413
+ "resolution": {
2414
+ "enum": [
2415
+ "effective",
2416
+ "explicit"
2417
+ ]
2418
+ },
2419
+ "onWrite": {
2420
+ "enum": [
2421
+ "materializeIfInherited",
2422
+ "editResolvedPart",
2423
+ "error"
2424
+ ]
2425
+ }
2426
+ },
2427
+ "required": [
2428
+ "kind",
2429
+ "storyType",
2430
+ "section",
2431
+ "headerFooterKind",
2432
+ "variant"
2433
+ ]
2434
+ },
2435
+ {
2436
+ "type": "object",
2437
+ "properties": {
2438
+ "kind": {
2439
+ "const": "story",
2440
+ "type": "string"
2441
+ },
2442
+ "storyType": {
2443
+ "const": "headerFooterPart",
2444
+ "type": "string"
2445
+ },
2446
+ "refId": {
2447
+ "type": "string"
2448
+ }
2449
+ },
2450
+ "required": [
2451
+ "kind",
2452
+ "storyType",
2453
+ "refId"
2454
+ ]
2455
+ },
2456
+ {
2457
+ "type": "object",
2458
+ "properties": {
2459
+ "kind": {
2460
+ "const": "story",
2461
+ "type": "string"
2462
+ },
2463
+ "storyType": {
2464
+ "const": "footnote",
2465
+ "type": "string"
2466
+ },
2467
+ "noteId": {
2468
+ "type": "string"
2469
+ }
2470
+ },
2471
+ "required": [
2472
+ "kind",
2473
+ "storyType",
2474
+ "noteId"
2475
+ ]
2476
+ },
2477
+ {
2478
+ "type": "object",
2479
+ "properties": {
2480
+ "kind": {
2481
+ "const": "story",
2482
+ "type": "string"
2483
+ },
2484
+ "storyType": {
2485
+ "const": "endnote",
2486
+ "type": "string"
2487
+ },
2488
+ "noteId": {
2489
+ "type": "string"
2490
+ }
2491
+ },
2492
+ "required": [
2493
+ "kind",
2494
+ "storyType",
2495
+ "noteId"
2496
+ ]
2497
+ },
2498
+ {
2499
+ "type": "object",
2500
+ "properties": {
2501
+ "kind": {
2502
+ "const": "story",
2503
+ "type": "string"
402
2504
  },
403
- "end": {
404
- "oneOf": [
405
- {
406
- "type": "object",
407
- "properties": {
408
- "kind": {
409
- "const": "text",
410
- "type": "string"
411
- },
412
- "blockId": {
413
- "type": "string"
414
- },
415
- "offset": {
416
- "type": "number"
417
- }
418
- },
419
- "required": [
420
- "kind",
421
- "blockId",
422
- "offset"
423
- ]
424
- },
425
- {
426
- "type": "object",
427
- "properties": {
428
- "kind": {
429
- "const": "nodeEdge",
430
- "type": "string"
431
- },
432
- "node": {
433
- "type": "object",
434
- "properties": {
435
- "kind": {
436
- "const": "block",
437
- "type": "string"
438
- },
439
- "nodeType": {
440
- "enum": [
441
- "paragraph",
442
- "heading",
443
- "table",
444
- "tableOfContents",
445
- "sdt",
446
- "image"
447
- ]
448
- },
449
- "nodeId": {
450
- "type": "string"
451
- }
452
- },
453
- "required": [
454
- "kind",
455
- "nodeType",
456
- "nodeId"
457
- ]
458
- },
459
- "edge": {
460
- "enum": [
461
- "before",
462
- "after"
463
- ]
464
- }
465
- },
466
- "required": [
467
- "kind",
468
- "node",
469
- "edge"
470
- ]
471
- }
472
- ],
473
- "description": "A point in the document. Use {kind:'text', blockId, offset} for character positions or {kind:'nodeEdge', node:{kind:'block', nodeType, nodeId}, edge:'before'|'after'} for block boundaries."
2505
+ "storyType": {
2506
+ "const": "textbox",
2507
+ "type": "string"
2508
+ },
2509
+ "textboxId": {
2510
+ "type": "string"
474
2511
  }
475
2512
  },
476
2513
  "required": [
477
2514
  "kind",
478
- "start",
479
- "end"
2515
+ "storyType",
2516
+ "textboxId"
480
2517
  ]
481
2518
  }
482
- ]
2519
+ ],
2520
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
483
2521
  }
484
2522
  ],
485
- "description": "Block address for structural insertion: {kind:'block', nodeType:'...', nodeId:'...'}."
2523
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
486
2524
  },
487
2525
  {
488
- "$ref": "#/$defs/SelectionTarget",
489
- "description": "Selection target: {kind:'selection', start:{kind:'text', blockId, offset}, end:{kind:'text', blockId, offset}}. Use 'ref' instead when you have a search result handle."
2526
+ "$ref": "#/$defs/StoryLocator",
2527
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
490
2528
  }
491
2529
  ],
492
- "description": "Block address for structural insertion: {kind:'block', nodeType:'...', nodeId:'...'}."
2530
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
493
2531
  },
494
2532
  "value": {
495
2533
  "type": "string",
@@ -827,6 +2865,10 @@
827
2865
  ],
828
2866
  "description": "Selection target: {kind:'selection', start:{kind:'text', blockId, offset}, end:{kind:'text', blockId, offset}}. Use 'ref' instead when you have a search result handle. Required for actions 'set_style', 'set_alignment', 'set_indentation', 'set_spacing', 'set_flow_options', 'set_direction'."
829
2867
  },
2868
+ "in": {
2869
+ "$ref": "#/$defs/StoryLocator",
2870
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes. Only for action 'inline'. Omit for other actions."
2871
+ },
830
2872
  "inline": {
831
2873
  "type": "object",
832
2874
  "properties": {
@@ -1657,12 +3699,10 @@
1657
3699
  },
1658
3700
  "left": {
1659
3701
  "type": "integer",
1660
- "minimum": 0,
1661
3702
  "description": "Left indentation in twips (1440 = 1 inch). Only for action 'set_indentation'. Omit for other actions."
1662
3703
  },
1663
3704
  "right": {
1664
3705
  "type": "integer",
1665
- "minimum": 0,
1666
3706
  "description": "Right indentation in twips (1440 = 1 inch). Only for action 'set_indentation'. Omit for other actions."
1667
3707
  },
1668
3708
  "firstLine": {
@@ -1710,6 +3750,22 @@
1710
3750
  "type": "boolean",
1711
3751
  "description": "Only for action 'set_flow_options'. Omit for other actions."
1712
3752
  },
3753
+ "autoSpaceDE": {
3754
+ "type": "boolean",
3755
+ "description": "Only for action 'set_flow_options'. Omit for other actions."
3756
+ },
3757
+ "autoSpaceDN": {
3758
+ "type": "boolean",
3759
+ "description": "Only for action 'set_flow_options'. Omit for other actions."
3760
+ },
3761
+ "adjustRightInd": {
3762
+ "type": "boolean",
3763
+ "description": "Only for action 'set_flow_options'. Omit for other actions."
3764
+ },
3765
+ "snapToGrid": {
3766
+ "type": "boolean",
3767
+ "description": "Only for action 'set_flow_options'. Omit for other actions."
3768
+ },
1713
3769
  "direction": {
1714
3770
  "type": "string",
1715
3771
  "enum": [
@@ -1781,19 +3837,8 @@
1781
3837
  {
1782
3838
  "operationId": "doc.format.paragraph.setFlowOptions",
1783
3839
  "intentAction": "set_flow_options",
1784
- "requiredOneOf": [
1785
- [
1786
- "target",
1787
- "contextualSpacing"
1788
- ],
1789
- [
1790
- "target",
1791
- "pageBreakBefore"
1792
- ],
1793
- [
1794
- "target",
1795
- "suppressAutoHyphens"
1796
- ]
3840
+ "required": [
3841
+ "target"
1797
3842
  ]
1798
3843
  },
1799
3844
  {
@@ -1837,6 +3882,10 @@
1837
3882
  "type": "boolean",
1838
3883
  "description": "Preview the result without applying changes."
1839
3884
  },
3885
+ "in": {
3886
+ "$ref": "#/$defs/StoryLocator",
3887
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
3888
+ },
1840
3889
  "at": {
1841
3890
  "oneOf": [
1842
3891
  {
@@ -2551,7 +4600,7 @@
2551
4600
  },
2552
4601
  {
2553
4602
  "toolName": "superdoc_comment",
2554
- "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes status to \"resolved\" or marks as internal. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n 1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n 2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n 3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n 4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
4603
+ "description": "Manage document comment threads: create, read, update, and delete. To create a comment, first use superdoc_search to find the target text, then pass action \"create\" with the comment text and a target built from items[0].blocks. For a single-block match use {kind:\"text\", blockId: items[0].blocks[0].blockId, range: items[0].blocks[0].range}. For a cross-block match use {kind:\"text\", segments: items[0].blocks.map(b => ({blockId: b.blockId, range: b.range}))}. Do NOT use items[0].highlightRange (snippet-relative, not block-relative) or items[0].target (a SelectionTarget, not accepted by comments.create). For threaded replies, pass \"parentId\" with the parent comment ID. Action \"list\" returns all comments with optional pagination (limit, offset) and filtering (includeResolved:true to include resolved). Action \"get\" retrieves a single comment by ID. Action \"update\" changes comment text, re-anchors the thread, or changes status to \"resolved\". The legacy `isInternal` field remains in schema for v1 compatibility but the v2 surface rejects it with `CAPABILITY_UNAVAILABLE`. Action \"delete\" removes a comment or reply by ID. Do NOT pass \"ref\", \"id\", or \"parentId\" when creating a new top-level comment; only \"action\", \"text\", and \"target\" are needed.\n\nEXAMPLES:\n 1. {\"action\":\"create\",\"text\":\"Please review this section.\",\"target\":{\"kind\":\"text\",\"blockId\":\"<blockId>\",\"range\":{\"start\":5,\"end\":25}}}\n 2. {\"action\":\"list\",\"limit\":20,\"offset\":0}\n 3. {\"action\":\"update\",\"id\":\"<commentId>\",\"status\":\"resolved\"}\n 4. {\"action\":\"delete\",\"id\":\"<commentId>\"}",
2555
4604
  "inputSchema": {
2556
4605
  "type": "object",
2557
4606
  "properties": {
@@ -2594,6 +4643,7 @@
2594
4643
  "target": {
2595
4644
  "oneOf": [
2596
4645
  {
4646
+ "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range}, a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks, a SelectionTarget {kind:'selection', start, end} returned by query.match, a TextSearchCommentTarget {text, story?}, or a TrackedChangeCommentTarget ({kind:'trackedChange', trackedChangeId, side?} or {trackedChangeId, side?}) that names a logical tracked-change id as a convenience anchor .",
2597
4647
  "oneOf": [
2598
4648
  {
2599
4649
  "$ref": "#/$defs/TextAddress"
@@ -2606,28 +4656,74 @@
2606
4656
  },
2607
4657
  {
2608
4658
  "$ref": "#/$defs/CommentTrackedChangeTarget"
4659
+ },
4660
+ {
4661
+ "type": "object",
4662
+ "properties": {
4663
+ "text": {
4664
+ "type": "string",
4665
+ "description": "Text to find and anchor the comment to. The adapter resolves the first body/story match."
4666
+ },
4667
+ "story": {
4668
+ "$ref": "#/$defs/StoryLocator"
4669
+ }
4670
+ },
4671
+ "additionalProperties": false,
4672
+ "required": [
4673
+ "text"
4674
+ ]
2609
4675
  }
2610
- ],
2611
- "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content."
4676
+ ]
2612
4677
  },
2613
4678
  {
2614
4679
  "oneOf": [
2615
4680
  {
2616
4681
  "$ref": "#/$defs/TextAddress"
2617
4682
  },
2618
- {
2619
- "$ref": "#/$defs/TextTarget"
2620
- },
2621
4683
  {
2622
4684
  "$ref": "#/$defs/SelectionTarget"
2623
4685
  },
2624
4686
  {
2625
4687
  "$ref": "#/$defs/CommentTrackedChangeTarget"
4688
+ },
4689
+ {
4690
+ "type": "object",
4691
+ "properties": {
4692
+ "text": {
4693
+ "type": "string",
4694
+ "description": "Text to find and anchor the comment to. The adapter resolves the first body/story match."
4695
+ },
4696
+ "story": {
4697
+ "$ref": "#/$defs/StoryLocator"
4698
+ }
4699
+ },
4700
+ "additionalProperties": false,
4701
+ "required": [
4702
+ "text"
4703
+ ]
2626
4704
  }
2627
- ]
4705
+ ],
4706
+ "description": "New anchor for the comment. Accepts a plain TextAddress, a SelectionTarget {kind:'selection', start, end}, a TextSearchCommentTarget {text, story?}, or a TrackedChangeCommentTarget, with or without kind, that names a logical tracked-change id as a convenience re-anchor target ."
2628
4707
  }
2629
4708
  ],
2630
- "description": "Comment target. Accepts a TextAddress, TextTarget, SelectionTarget, or {trackedChangeId, kind?:'trackedChange'} to anchor directly on tracked content. Only for actions 'create', 'update'. Omit for other actions."
4709
+ "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range}, a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks, a SelectionTarget {kind:'selection', start, end} returned by query.match, a TextSearchCommentTarget {text, story?}, or a TrackedChangeCommentTarget ({kind:'trackedChange', trackedChangeId, side?} or {trackedChangeId, side?}) that names a logical tracked-change id as a convenience anchor . Only for actions 'create', 'update'. Omit for other actions."
4710
+ },
4711
+ "trackedChangeId": {
4712
+ "type": "string",
4713
+ "description": "Compatibility shorthand for target: { trackedChangeId }. Used only when target is omitted. Only for action 'create'. Omit for other actions."
4714
+ },
4715
+ "side": {
4716
+ "enum": [
4717
+ "inserted",
4718
+ "deleted",
4719
+ "source",
4720
+ "destination"
4721
+ ],
4722
+ "description": "Optional side for the top-level trackedChangeId shorthand. Only for action 'create'. Omit for other actions."
4723
+ },
4724
+ "story": {
4725
+ "$ref": "#/$defs/StoryLocator",
4726
+ "description": "Optional story for the top-level trackedChangeId shorthand. Only for action 'create'. Omit for other actions."
2631
4727
  },
2632
4728
  "parentId": {
2633
4729
  "type": "string",
@@ -2646,7 +4742,7 @@
2646
4742
  },
2647
4743
  "isInternal": {
2648
4744
  "type": "boolean",
2649
- "description": "When true, marks the comment as internal (hidden from external collaborators). Only for action 'update'. Omit for other actions."
4745
+ "description": "Legacy v1/document-api compatibility field. Not a supported v2 behavior. V2 adapters MUST reject a `comments.patch` request containing `isInternal` with `CAPABILITY_UNAVAILABLE` (kernel reason `internal-comments-unsupported`). The field is preserved in the schema only so v1 callers keep their input shape (`comments-spec.md` §7, §14.6). Only for action 'update'. Omit for other actions."
2650
4746
  },
2651
4747
  "includeResolved": {
2652
4748
  "type": "boolean",
@@ -2701,7 +4797,7 @@
2701
4797
  },
2702
4798
  {
2703
4799
  "toolName": "superdoc_track_changes",
2704
- "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n 1. {\"action\":\"list\"}\n 2. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n 3. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n 4. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n 5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
4800
+ "description": "Review and resolve tracked changes (insertions, deletions, replacements, format changes) in the document. Action \"list\" returns all tracked changes with optional filtering by type (insert, delete, replacement, format) and pagination (limit, offset). Each change includes an ID, type, author, timestamp, and content preview. Action \"decide\" accepts or rejects changes. Pass decision:\"accept\" to apply the change permanently, or decision:\"reject\" to discard it. Target a single change with {id:\"<changeId>\"}, a partial selection with {kind:\"range\", range:{...}}, or all changes at once with {scope:\"all\"} (optionally plus story). Do NOT use this tool unless the document has tracked changes. Use superdoc_get_content info to check the tracked change count first.\n\nEXAMPLES:\n 1. {\"action\":\"list\"}\n 2. {\"action\":\"list\",\"type\":\"insertion\",\"limit\":10}\n 3. {\"action\":\"list\",\"type\":\"replacement\",\"limit\":10}\n 4. {\"action\":\"decide\",\"decision\":\"accept\",\"target\":{\"id\":\"<changeId>\"}}\n 5. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"kind\":\"range\",\"range\":{\"kind\":\"text\",\"segments\":[{\"blockId\":\"<blockId>\",\"range\":{\"start\":0,\"end\":5}}]}}}\n 6. {\"action\":\"decide\",\"decision\":\"reject\",\"target\":{\"scope\":\"all\"}}",
2705
4801
  "inputSchema": {
2706
4802
  "type": "object",
2707
4803
  "properties": {
@@ -2723,12 +4819,29 @@
2723
4819
  },
2724
4820
  "type": {
2725
4821
  "enum": [
4822
+ "insertion",
4823
+ "deletion",
4824
+ "replacement",
4825
+ "formatting",
4826
+ "move",
4827
+ "structural",
2726
4828
  "insert",
2727
4829
  "delete",
2728
- "replacement",
2729
4830
  "format"
2730
4831
  ],
2731
- "description": "Filter by change type: 'insert', 'delete', 'replacement', or 'format'. Only for action 'list'. Omit for other actions."
4832
+ "description": "Filter by change type. Canonical values: 'insertion', 'deletion', 'replacement', 'formatting', 'move', 'structural'. Legacy aliases 'insert', 'delete', and 'format' remain accepted during migration. Only for action 'list'. Omit for other actions."
4833
+ },
4834
+ "in": {
4835
+ "oneOf": [
4836
+ {
4837
+ "$ref": "#/$defs/StoryLocator"
4838
+ },
4839
+ {
4840
+ "const": "all",
4841
+ "type": "string"
4842
+ }
4843
+ ],
4844
+ "description": "Story scope. Omit for body only, pass a StoryLocator for a single story, or 'all' for body + every revision-capable non-body story. Only for action 'list'. Omit for other actions."
2732
4845
  },
2733
4846
  "force": {
2734
4847
  "type": "boolean",
@@ -2749,8 +4862,215 @@
2749
4862
  ],
2750
4863
  "description": "Required for action 'decide'."
2751
4864
  },
4865
+ "expectedRevision": {
4866
+ "type": "string",
4867
+ "description": "Backward-compatible alias for options.expectedRevision. Explicit mutation options take precedence when both are supplied. Only for action 'decide'. Omit for other actions."
4868
+ },
2752
4869
  "target": {
4870
+ "description": "Decision target. Canonical shapes: { kind: 'id', id, story? } (whole logical tracked change), { kind: 'range', range: TextTarget, overlap?, side?, story?, part? } or { kind: 'range', range: { anchor, relativeStart, relativeEnd }, overlap?, side?, story?, part? } (resolves only the selected overlap; may split fragments), { kind: 'all' } (every active tracked change). Legacy { id, story? } / { id, range: { kind: 'partial', start, end } } / { scope: 'all' } shapes are accepted and transparently promoted to canonical targets. Required for action 'decide'.",
2753
4871
  "oneOf": [
4872
+ {
4873
+ "type": "object",
4874
+ "properties": {
4875
+ "kind": {
4876
+ "const": "id",
4877
+ "type": "string"
4878
+ },
4879
+ "id": {
4880
+ "type": "string"
4881
+ },
4882
+ "story": {
4883
+ "$ref": "#/$defs/StoryLocator"
4884
+ },
4885
+ "moveRole": {
4886
+ "enum": [
4887
+ "pair",
4888
+ "source",
4889
+ "destination"
4890
+ ],
4891
+ "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
4892
+ }
4893
+ },
4894
+ "additionalProperties": false,
4895
+ "required": [
4896
+ "kind",
4897
+ "id"
4898
+ ]
4899
+ },
4900
+ {
4901
+ "type": "object",
4902
+ "properties": {
4903
+ "kind": {
4904
+ "const": "range",
4905
+ "type": "string"
4906
+ },
4907
+ "range": {
4908
+ "$ref": "#/$defs/TextTarget"
4909
+ },
4910
+ "overlap": {
4911
+ "type": "string",
4912
+ "description": "Optional logical overlap selector for callers that already resolved an ambiguous overlap surface. Adapter-owned interpretation."
4913
+ },
4914
+ "side": {
4915
+ "enum": [
4916
+ "insert",
4917
+ "inserted",
4918
+ "delete",
4919
+ "deleted",
4920
+ "source",
4921
+ "destination"
4922
+ ],
4923
+ "description": "Optional revision side for paired replacement or move targets."
4924
+ },
4925
+ "story": {
4926
+ "$ref": "#/$defs/StoryLocator",
4927
+ "description": "Optional story containing the range target."
4928
+ },
4929
+ "part": {
4930
+ "type": "string",
4931
+ "description": "Compatibility alias used by older range callers; interpretation is adapter-owned."
4932
+ }
4933
+ },
4934
+ "additionalProperties": false,
4935
+ "required": [
4936
+ "kind",
4937
+ "range"
4938
+ ]
4939
+ },
4940
+ {
4941
+ "type": "object",
4942
+ "properties": {
4943
+ "kind": {
4944
+ "const": "range",
4945
+ "type": "string"
4946
+ },
4947
+ "range": {
4948
+ "type": "object",
4949
+ "properties": {
4950
+ "anchor": {
4951
+ "type": "string"
4952
+ },
4953
+ "relativeStart": {
4954
+ "type": "integer",
4955
+ "minimum": 0
4956
+ },
4957
+ "relativeEnd": {
4958
+ "type": "integer",
4959
+ "minimum": 0
4960
+ }
4961
+ },
4962
+ "additionalProperties": false,
4963
+ "required": [
4964
+ "anchor",
4965
+ "relativeStart",
4966
+ "relativeEnd"
4967
+ ]
4968
+ },
4969
+ "overlap": {
4970
+ "type": "string",
4971
+ "description": "Optional logical overlap selector for callers that already resolved an ambiguous overlap surface. Adapter-owned interpretation."
4972
+ },
4973
+ "side": {
4974
+ "enum": [
4975
+ "insert",
4976
+ "inserted",
4977
+ "delete",
4978
+ "deleted",
4979
+ "source",
4980
+ "destination"
4981
+ ],
4982
+ "description": "Optional revision side for paired replacement or move targets."
4983
+ },
4984
+ "story": {
4985
+ "$ref": "#/$defs/StoryLocator",
4986
+ "description": "Optional story containing the range target."
4987
+ },
4988
+ "part": {
4989
+ "type": "string",
4990
+ "description": "Compatibility alias used by older range callers; interpretation is adapter-owned."
4991
+ }
4992
+ },
4993
+ "additionalProperties": false,
4994
+ "required": [
4995
+ "kind",
4996
+ "range"
4997
+ ]
4998
+ },
4999
+ {
5000
+ "type": "object",
5001
+ "properties": {
5002
+ "kind": {
5003
+ "const": "range",
5004
+ "type": "string"
5005
+ },
5006
+ "anchor": {
5007
+ "type": "string"
5008
+ },
5009
+ "relativeStart": {
5010
+ "type": "integer",
5011
+ "minimum": 0
5012
+ },
5013
+ "relativeEnd": {
5014
+ "type": "integer",
5015
+ "minimum": 0
5016
+ },
5017
+ "overlap": {
5018
+ "type": "string",
5019
+ "description": "Optional logical overlap selector for callers that already resolved an ambiguous overlap surface. Adapter-owned interpretation."
5020
+ },
5021
+ "side": {
5022
+ "enum": [
5023
+ "insert",
5024
+ "inserted",
5025
+ "delete",
5026
+ "deleted",
5027
+ "source",
5028
+ "destination"
5029
+ ],
5030
+ "description": "Optional revision side for paired replacement or move targets."
5031
+ },
5032
+ "story": {
5033
+ "$ref": "#/$defs/StoryLocator",
5034
+ "description": "Optional story containing the range target."
5035
+ },
5036
+ "part": {
5037
+ "type": "string",
5038
+ "description": "Compatibility alias used by older range callers; interpretation is adapter-owned."
5039
+ }
5040
+ },
5041
+ "additionalProperties": false,
5042
+ "required": [
5043
+ "kind",
5044
+ "anchor",
5045
+ "relativeStart",
5046
+ "relativeEnd"
5047
+ ]
5048
+ },
5049
+ {
5050
+ "type": "object",
5051
+ "properties": {
5052
+ "kind": {
5053
+ "const": "all",
5054
+ "type": "string"
5055
+ },
5056
+ "story": {
5057
+ "oneOf": [
5058
+ {
5059
+ "$ref": "#/$defs/StoryLocator"
5060
+ },
5061
+ {
5062
+ "const": "all",
5063
+ "type": "string"
5064
+ }
5065
+ ],
5066
+ "description": "Optional explicit bulk filter. Omit or pass 'all' to target every revision-capable story, or pass a StoryLocator to scope the decision to one story."
5067
+ }
5068
+ },
5069
+ "additionalProperties": false,
5070
+ "required": [
5071
+ "kind"
5072
+ ]
5073
+ },
2754
5074
  {
2755
5075
  "type": "object",
2756
5076
  "properties": {
@@ -2760,9 +5080,13 @@
2760
5080
  "story": {
2761
5081
  "$ref": "#/$defs/StoryLocator"
2762
5082
  },
2763
- "range": {
2764
- "type": "object",
2765
- "description": "Partial-range qualifier on an id target. Rejected with INVALID_INPUT for indivisible (e.g. structural) revisions."
5083
+ "moveRole": {
5084
+ "enum": [
5085
+ "pair",
5086
+ "source",
5087
+ "destination"
5088
+ ],
5089
+ "description": "Optional move pairing assertion. 'pair' requires the resolved tracked change to be a paired move; 'source' / 'destination' further narrow to a specific half. When the assertion does not hold the decide adapter fails closed."
2766
5090
  }
2767
5091
  },
2768
5092
  "additionalProperties": false,
@@ -2773,24 +5097,39 @@
2773
5097
  {
2774
5098
  "type": "object",
2775
5099
  "properties": {
2776
- "kind": {
2777
- "const": "range",
5100
+ "id": {
2778
5101
  "type": "string"
2779
5102
  },
2780
5103
  "range": {
2781
- "$ref": "#/$defs/TextTarget"
5104
+ "type": "object",
5105
+ "properties": {
5106
+ "kind": {
5107
+ "const": "partial",
5108
+ "type": "string"
5109
+ },
5110
+ "start": {
5111
+ "type": "integer",
5112
+ "minimum": 0
5113
+ },
5114
+ "end": {
5115
+ "type": "integer",
5116
+ "minimum": 0
5117
+ }
5118
+ },
5119
+ "additionalProperties": false,
5120
+ "required": [
5121
+ "kind",
5122
+ "start",
5123
+ "end"
5124
+ ]
2782
5125
  },
2783
5126
  "story": {
2784
5127
  "$ref": "#/$defs/StoryLocator"
2785
- },
2786
- "part": {
2787
- "type": "string",
2788
- "description": "Optional part discriminator for the range target."
2789
5128
  }
2790
5129
  },
2791
5130
  "additionalProperties": false,
2792
5131
  "required": [
2793
- "kind",
5132
+ "id",
2794
5133
  "range"
2795
5134
  ]
2796
5135
  },
@@ -2820,8 +5159,7 @@
2820
5159
  "scope"
2821
5160
  ]
2822
5161
  }
2823
- ],
2824
- "description": "Required for action 'decide'."
5162
+ ]
2825
5163
  }
2826
5164
  },
2827
5165
  "required": [
@@ -2851,6 +5189,10 @@
2851
5189
  "inputSchema": {
2852
5190
  "type": "object",
2853
5191
  "properties": {
5192
+ "in": {
5193
+ "$ref": "#/$defs/StoryLocator",
5194
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
5195
+ },
2854
5196
  "select": {
2855
5197
  "description": "Search selector. Use {type:'text', pattern:'...'} for text search or {type:'node', nodeType:'paragraph'|'heading'|...} for node search.",
2856
5198
  "oneOf": [
@@ -2864,18 +5206,22 @@
2864
5206
  },
2865
5207
  "pattern": {
2866
5208
  "type": "string",
2867
- "description": "Text or regex pattern to match."
5209
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
2868
5210
  },
2869
5211
  "mode": {
2870
5212
  "enum": [
2871
5213
  "contains",
2872
5214
  "regex"
2873
5215
  ],
2874
- "description": "Match mode: 'contains' (substring) or 'regex'."
5216
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
2875
5217
  },
2876
5218
  "caseSensitive": {
2877
5219
  "type": "boolean",
2878
5220
  "description": "Case-sensitive matching. Default: false."
5221
+ },
5222
+ "wholeWord": {
5223
+ "type": "boolean",
5224
+ "description": "Require word-boundary matches. Default: false."
2879
5225
  }
2880
5226
  },
2881
5227
  "additionalProperties": false,
@@ -2999,6 +5345,10 @@
2999
5345
  ],
3000
5346
  "description": "The action to perform. One of: apply, preview."
3001
5347
  },
5348
+ "in": {
5349
+ "$ref": "#/$defs/StoryLocator",
5350
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
5351
+ },
3002
5352
  "expectedRevision": {
3003
5353
  "type": "string",
3004
5354
  "description": "Document revision for optimistic concurrency. Mutation fails if document was modified since this revision. Only for action 'preview'. Omit for other actions."
@@ -3050,18 +5400,22 @@
3050
5400
  },
3051
5401
  "pattern": {
3052
5402
  "type": "string",
3053
- "description": "Text or regex pattern to match."
5403
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
3054
5404
  },
3055
5405
  "mode": {
3056
5406
  "enum": [
3057
5407
  "contains",
3058
5408
  "regex"
3059
5409
  ],
3060
- "description": "Match mode: 'contains' (substring) or 'regex'."
5410
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
3061
5411
  },
3062
5412
  "caseSensitive": {
3063
5413
  "type": "boolean",
3064
5414
  "description": "Case-sensitive matching. Default: false."
5415
+ },
5416
+ "wholeWord": {
5417
+ "type": "boolean",
5418
+ "description": "Require word-boundary matches. Default: false."
3065
5419
  }
3066
5420
  },
3067
5421
  "additionalProperties": false,
@@ -3386,18 +5740,22 @@
3386
5740
  },
3387
5741
  "pattern": {
3388
5742
  "type": "string",
3389
- "description": "Text or regex pattern to match."
5743
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
3390
5744
  },
3391
5745
  "mode": {
3392
5746
  "enum": [
3393
5747
  "contains",
3394
5748
  "regex"
3395
5749
  ],
3396
- "description": "Match mode: 'contains' (substring) or 'regex'."
5750
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
3397
5751
  },
3398
5752
  "caseSensitive": {
3399
5753
  "type": "boolean",
3400
5754
  "description": "Case-sensitive matching. Default: false."
5755
+ },
5756
+ "wholeWord": {
5757
+ "type": "boolean",
5758
+ "description": "Require word-boundary matches. Default: false."
3401
5759
  }
3402
5760
  },
3403
5761
  "additionalProperties": false,
@@ -3671,18 +6029,22 @@
3671
6029
  },
3672
6030
  "pattern": {
3673
6031
  "type": "string",
3674
- "description": "Text or regex pattern to match."
6032
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
3675
6033
  },
3676
6034
  "mode": {
3677
6035
  "enum": [
3678
6036
  "contains",
3679
6037
  "regex"
3680
6038
  ],
3681
- "description": "Match mode: 'contains' (substring) or 'regex'."
6039
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
3682
6040
  },
3683
6041
  "caseSensitive": {
3684
6042
  "type": "boolean",
3685
6043
  "description": "Case-sensitive matching. Default: false."
6044
+ },
6045
+ "wholeWord": {
6046
+ "type": "boolean",
6047
+ "description": "Require word-boundary matches. Default: false."
3686
6048
  }
3687
6049
  },
3688
6050
  "additionalProperties": false,
@@ -3878,18 +6240,22 @@
3878
6240
  },
3879
6241
  "pattern": {
3880
6242
  "type": "string",
3881
- "description": "Text or regex pattern to match."
6243
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
3882
6244
  },
3883
6245
  "mode": {
3884
6246
  "enum": [
3885
6247
  "contains",
3886
6248
  "regex"
3887
6249
  ],
3888
- "description": "Match mode: 'contains' (substring) or 'regex'."
6250
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
3889
6251
  },
3890
6252
  "caseSensitive": {
3891
6253
  "type": "boolean",
3892
6254
  "description": "Case-sensitive matching. Default: false."
6255
+ },
6256
+ "wholeWord": {
6257
+ "type": "boolean",
6258
+ "description": "Require word-boundary matches. Default: false."
3893
6259
  }
3894
6260
  },
3895
6261
  "additionalProperties": false,
@@ -4908,18 +7274,22 @@
4908
7274
  },
4909
7275
  "pattern": {
4910
7276
  "type": "string",
4911
- "description": "Text or regex pattern to match."
7277
+ "description": "Text to match. In regex mode, patterns are validated for syntax, maximum length, and safety before execution."
4912
7278
  },
4913
7279
  "mode": {
4914
7280
  "enum": [
4915
7281
  "contains",
4916
7282
  "regex"
4917
7283
  ],
4918
- "description": "Match mode: 'contains' (substring) or 'regex'."
7284
+ "description": "Match mode: 'contains' (literal substring, recommended for literal text) or 'regex' (validated regular expression)."
4919
7285
  },
4920
7286
  "caseSensitive": {
4921
7287
  "type": "boolean",
4922
7288
  "description": "Case-sensitive matching. Default: false."
7289
+ },
7290
+ "wholeWord": {
7291
+ "type": "boolean",
7292
+ "description": "Require word-boundary matches. Default: false."
4923
7293
  }
4924
7294
  },
4925
7295
  "additionalProperties": false,
@@ -5063,6 +7433,7 @@
5063
7433
  "insert_column",
5064
7434
  "insert_row",
5065
7435
  "merge_cells",
7436
+ "move_row",
5066
7437
  "set_borders",
5067
7438
  "set_cell",
5068
7439
  "set_cell_text",
@@ -5075,7 +7446,7 @@
5075
7446
  "set_style_options",
5076
7447
  "unmerge_cells"
5077
7448
  ],
5078
- "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
7449
+ "description": "The action to perform. One of: delete, delete_column, delete_row, insert_column, insert_row, merge_cells, move_row, set_borders, set_cell, set_cell_text, set_column, set_layout, set_options, set_row, set_row_options, set_shading, set_style_options, unmerge_cells."
5079
7450
  },
5080
7451
  "force": {
5081
7452
  "type": "boolean",
@@ -5123,20 +7494,34 @@
5123
7494
  "oneOf": [
5124
7495
  {
5125
7496
  "oneOf": [
5126
- {
5127
- "$ref": "#/$defs/TableAddress"
5128
- },
5129
7497
  {
5130
7498
  "oneOf": [
7499
+ {
7500
+ "$ref": "#/$defs/TableAddress"
7501
+ },
5131
7502
  {
5132
7503
  "oneOf": [
5133
7504
  {
5134
- "$ref": "#/$defs/TableRowAddress"
7505
+ "oneOf": [
7506
+ {
7507
+ "$ref": "#/$defs/TableRowAddress"
7508
+ },
7509
+ {
7510
+ "$ref": "#/$defs/TableAddress"
7511
+ }
7512
+ ]
5135
7513
  },
5136
7514
  {
5137
7515
  "$ref": "#/$defs/TableAddress"
5138
7516
  }
5139
7517
  ]
7518
+ }
7519
+ ]
7520
+ },
7521
+ {
7522
+ "oneOf": [
7523
+ {
7524
+ "$ref": "#/$defs/TableRowAddress"
5140
7525
  },
5141
7526
  {
5142
7527
  "$ref": "#/$defs/TableAddress"
@@ -5258,6 +7643,14 @@
5258
7643
  "type": "number",
5259
7644
  "description": "Only for action 'set_layout'. Omit for other actions."
5260
7645
  },
7646
+ "preferredWidthType": {
7647
+ "enum": [
7648
+ "dxa",
7649
+ "auto",
7650
+ "pct"
7651
+ ],
7652
+ "description": "Only for action 'set_layout'. Omit for other actions."
7653
+ },
5261
7654
  "alignment": {
5262
7655
  "enum": [
5263
7656
  "left",
@@ -5304,7 +7697,142 @@
5304
7697
  "rowIndex": {
5305
7698
  "type": "integer",
5306
7699
  "minimum": 0,
5307
- "description": "Only for actions 'insert_row', 'delete_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
7700
+ "description": "Only for actions 'insert_row', 'delete_row', 'move_row', 'set_row', 'set_row_options', 'unmerge_cells', 'set_cell_text'. Omit for other actions."
7701
+ },
7702
+ "destination": {
7703
+ "oneOf": [
7704
+ {
7705
+ "type": "object",
7706
+ "properties": {
7707
+ "kind": {
7708
+ "const": "first",
7709
+ "type": "string"
7710
+ }
7711
+ },
7712
+ "additionalProperties": false,
7713
+ "required": [
7714
+ "kind"
7715
+ ]
7716
+ },
7717
+ {
7718
+ "type": "object",
7719
+ "properties": {
7720
+ "kind": {
7721
+ "const": "last",
7722
+ "type": "string"
7723
+ }
7724
+ },
7725
+ "additionalProperties": false,
7726
+ "required": [
7727
+ "kind"
7728
+ ]
7729
+ },
7730
+ {
7731
+ "type": "object",
7732
+ "properties": {
7733
+ "kind": {
7734
+ "const": "before",
7735
+ "type": "string"
7736
+ },
7737
+ "rowIndex": {
7738
+ "type": "integer",
7739
+ "minimum": 0
7740
+ }
7741
+ },
7742
+ "additionalProperties": false,
7743
+ "required": [
7744
+ "kind",
7745
+ "rowIndex"
7746
+ ]
7747
+ },
7748
+ {
7749
+ "type": "object",
7750
+ "properties": {
7751
+ "kind": {
7752
+ "const": "after",
7753
+ "type": "string"
7754
+ },
7755
+ "rowIndex": {
7756
+ "type": "integer",
7757
+ "minimum": 0
7758
+ }
7759
+ },
7760
+ "additionalProperties": false,
7761
+ "required": [
7762
+ "kind",
7763
+ "rowIndex"
7764
+ ]
7765
+ },
7766
+ {
7767
+ "type": "object",
7768
+ "properties": {
7769
+ "kind": {
7770
+ "const": "before",
7771
+ "type": "string"
7772
+ },
7773
+ "target": {
7774
+ "$ref": "#/$defs/TableRowAddress"
7775
+ }
7776
+ },
7777
+ "additionalProperties": false,
7778
+ "required": [
7779
+ "kind",
7780
+ "target"
7781
+ ]
7782
+ },
7783
+ {
7784
+ "type": "object",
7785
+ "properties": {
7786
+ "kind": {
7787
+ "const": "after",
7788
+ "type": "string"
7789
+ },
7790
+ "target": {
7791
+ "$ref": "#/$defs/TableRowAddress"
7792
+ }
7793
+ },
7794
+ "additionalProperties": false,
7795
+ "required": [
7796
+ "kind",
7797
+ "target"
7798
+ ]
7799
+ },
7800
+ {
7801
+ "type": "object",
7802
+ "properties": {
7803
+ "kind": {
7804
+ "const": "before",
7805
+ "type": "string"
7806
+ },
7807
+ "nodeId": {
7808
+ "type": "string"
7809
+ }
7810
+ },
7811
+ "additionalProperties": false,
7812
+ "required": [
7813
+ "kind",
7814
+ "nodeId"
7815
+ ]
7816
+ },
7817
+ {
7818
+ "type": "object",
7819
+ "properties": {
7820
+ "kind": {
7821
+ "const": "after",
7822
+ "type": "string"
7823
+ },
7824
+ "nodeId": {
7825
+ "type": "string"
7826
+ }
7827
+ },
7828
+ "additionalProperties": false,
7829
+ "required": [
7830
+ "kind",
7831
+ "nodeId"
7832
+ ]
7833
+ }
7834
+ ],
7835
+ "description": "Required for action 'move_row'."
5308
7836
  },
5309
7837
  "heightPt": {
5310
7838
  "type": "number",
@@ -5317,7 +7845,7 @@
5317
7845
  "exact",
5318
7846
  "auto"
5319
7847
  ],
5320
- "description": "Required for action 'set_row'."
7848
+ "description": "Only for action 'set_row'. Omit for other actions."
5321
7849
  },
5322
7850
  "allowBreakAcrossPages": {
5323
7851
  "type": "boolean",
@@ -5327,6 +7855,62 @@
5327
7855
  "type": "boolean",
5328
7856
  "description": "Only for action 'set_row_options'. Omit for other actions."
5329
7857
  },
7858
+ "gridBefore": {
7859
+ "type": "integer",
7860
+ "minimum": 0,
7861
+ "description": "Only for action 'set_row_options'. Omit for other actions."
7862
+ },
7863
+ "gridAfter": {
7864
+ "type": "integer",
7865
+ "minimum": 0,
7866
+ "description": "Only for action 'set_row_options'. Omit for other actions."
7867
+ },
7868
+ "wBefore": {
7869
+ "type": "object",
7870
+ "properties": {
7871
+ "value": {
7872
+ "type": "integer",
7873
+ "minimum": 0
7874
+ },
7875
+ "type": {
7876
+ "enum": [
7877
+ "auto",
7878
+ "dxa",
7879
+ "nil",
7880
+ "pct"
7881
+ ]
7882
+ }
7883
+ },
7884
+ "additionalProperties": false,
7885
+ "required": [
7886
+ "value",
7887
+ "type"
7888
+ ],
7889
+ "description": "Only for action 'set_row_options'. Omit for other actions."
7890
+ },
7891
+ "wAfter": {
7892
+ "type": "object",
7893
+ "properties": {
7894
+ "value": {
7895
+ "type": "integer",
7896
+ "minimum": 0
7897
+ },
7898
+ "type": {
7899
+ "enum": [
7900
+ "auto",
7901
+ "dxa",
7902
+ "nil",
7903
+ "pct"
7904
+ ]
7905
+ }
7906
+ },
7907
+ "additionalProperties": false,
7908
+ "required": [
7909
+ "value",
7910
+ "type"
7911
+ ],
7912
+ "description": "Only for action 'set_row_options'. Omit for other actions."
7913
+ },
5330
7914
  "columnIndex": {
5331
7915
  "type": "integer",
5332
7916
  "minimum": 0,
@@ -5791,26 +8375,43 @@
5791
8375
  ]
5792
8376
  ]
5793
8377
  },
8378
+ {
8379
+ "operationId": "doc.tables.moveRow",
8380
+ "intentAction": "move_row",
8381
+ "requiredOneOf": [
8382
+ [
8383
+ "target",
8384
+ "destination"
8385
+ ],
8386
+ [
8387
+ "target",
8388
+ "rowIndex",
8389
+ "destination"
8390
+ ],
8391
+ [
8392
+ "nodeId",
8393
+ "rowIndex",
8394
+ "destination"
8395
+ ]
8396
+ ]
8397
+ },
5794
8398
  {
5795
8399
  "operationId": "doc.tables.setRowHeight",
5796
8400
  "intentAction": "set_row",
5797
8401
  "requiredOneOf": [
5798
8402
  [
5799
8403
  "target",
5800
- "heightPt",
5801
- "rule"
8404
+ "heightPt"
5802
8405
  ],
5803
8406
  [
5804
8407
  "target",
5805
8408
  "rowIndex",
5806
- "heightPt",
5807
- "rule"
8409
+ "heightPt"
5808
8410
  ],
5809
8411
  [
5810
8412
  "nodeId",
5811
8413
  "rowIndex",
5812
- "heightPt",
5813
- "rule"
8414
+ "heightPt"
5814
8415
  ]
5815
8416
  ]
5816
8417
  },