@superdoc-dev/sdk 1.0.0-alpha.46 → 1.0.0-alpha.48

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 (24) hide show
  1. package/dist/generated/client.cjs +12 -0
  2. package/dist/generated/client.d.ts +622 -82
  3. package/dist/generated/client.d.ts.map +1 -1
  4. package/dist/generated/client.js +12 -0
  5. package/dist/generated/contract.cjs +14903 -7755
  6. package/dist/generated/contract.d.ts.map +1 -1
  7. package/dist/generated/contract.js +14903 -7755
  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/dist/runtime/transport-common.cjs +8 -0
  12. package/dist/runtime/transport-common.d.ts.map +1 -1
  13. package/dist/runtime/transport-common.js +8 -0
  14. package/package.json +6 -6
  15. package/tools/__pycache__/__init__.cpython-312.pyc +0 -0
  16. package/tools/__pycache__/intent_dispatch_generated.cpython-312.pyc +0 -0
  17. package/tools/catalog.json +726 -1157
  18. package/tools/intent_dispatch_generated.py +2 -0
  19. package/tools/system-prompt.md +22 -3
  20. package/tools/tools-policy.json +1 -1
  21. package/tools/tools.anthropic.json +722 -1160
  22. package/tools/tools.generic.json +724 -1161
  23. package/tools/tools.openai.json +722 -1160
  24. package/tools/tools.vercel.json +722 -1160
package/tools/catalog.json CHANGED
@@ -20,13 +20,16 @@
20
20
  "description": "The action to perform. One of: html, info, markdown, text."
21
21
  },
22
22
  "doc": {
23
- "type": "string"
23
+ "type": "string",
24
+ "description": "Document path. Optional when a session is already open."
24
25
  },
25
26
  "sessionId": {
26
- "type": "string"
27
+ "type": "string",
28
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
27
29
  },
28
30
  "unflattenLists": {
29
- "type": "boolean"
31
+ "type": "boolean",
32
+ "description": "When true, flattens nested list structures in output. Default: false."
30
33
  }
31
34
  },
32
35
  "required": [
@@ -72,26 +75,28 @@
72
75
  "description": "The action to perform. One of: delete, insert, redo, replace, undo."
73
76
  },
74
77
  "doc": {
75
- "type": "string"
78
+ "type": "string",
79
+ "description": "Document path. Optional when a session is already open."
76
80
  },
77
81
  "sessionId": {
78
- "type": "string"
82
+ "type": "string",
83
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
79
84
  },
80
85
  "force": {
81
- "type": "boolean"
82
- },
83
- "expectedRevision": {
84
- "type": "number"
86
+ "type": "boolean",
87
+ "description": "Bypass confirmation checks."
85
88
  },
86
89
  "changeMode": {
87
90
  "type": "string",
88
91
  "enum": [
89
92
  "direct",
90
93
  "tracked"
91
- ]
94
+ ],
95
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
92
96
  },
93
97
  "dryRun": {
94
- "type": "boolean"
98
+ "type": "boolean",
99
+ "description": "Preview the result without applying changes."
95
100
  },
96
101
  "target": {
97
102
  "oneOf": [
@@ -157,13 +162,16 @@
157
162
  "nodeId"
158
163
  ]
159
164
  }
160
- ]
165
+ ],
166
+ "description": "Target address object. Use 'ref' instead if you have a search handle. Format: {kind:'text', blockId, range:{start,end}} or {kind:'block', nodeType, nodeId}."
161
167
  },
162
168
  "value": {
163
- "type": "string"
169
+ "type": "string",
170
+ "description": "Text content to insert."
164
171
  },
165
172
  "type": {
166
173
  "type": "string",
174
+ "description": "Content format: 'text' (default), 'markdown', or 'html'.",
167
175
  "enum": [
168
176
  "text",
169
177
  "markdown",
@@ -183,10 +191,12 @@
183
191
  "properties": {}
184
192
  }
185
193
  }
186
- ]
194
+ ],
195
+ "description": "Document fragment to insert (structured content)."
187
196
  },
188
197
  "placement": {
189
198
  "type": "string",
199
+ "description": "Where to place content relative to target: 'before', 'after', 'insideStart', or 'insideEnd'.",
190
200
  "enum": [
191
201
  "before",
192
202
  "after",
@@ -203,32 +213,40 @@
203
213
  "allow"
204
214
  ]
205
215
  }
206
- }
216
+ },
217
+ "description": "Controls nesting behavior. tables: 'allow' permits inserting tables inside other tables."
207
218
  },
208
219
  "blockId": {
209
- "type": "string"
220
+ "type": "string",
221
+ "description": "Block ID of the target paragraph."
210
222
  },
211
223
  "offset": {
212
- "type": "number"
224
+ "type": "number",
225
+ "description": "Character offset within the block for insertion."
213
226
  },
214
227
  "text": {
215
- "type": "string"
228
+ "type": "string",
229
+ "description": "Replacement text content."
216
230
  },
217
231
  "ref": {
218
- "type": "string"
232
+ "type": "string",
233
+ "description": "Handle ref string from a superdoc_search result. Pass the handle.ref value directly (e.g. 'text:eyJ...'). Preferred over 'target' for inline formatting."
219
234
  },
220
235
  "start": {
221
- "type": "number"
236
+ "type": "number",
237
+ "description": "Start offset within the block (character index)."
222
238
  },
223
239
  "end": {
224
- "type": "number"
240
+ "type": "number",
241
+ "description": "End offset within the block (character index)."
225
242
  },
226
243
  "behavior": {
227
244
  "type": "string",
228
245
  "enum": [
229
246
  "selection",
230
247
  "exact"
231
- ]
248
+ ],
249
+ "description": "Delete behavior: 'selection' (default) or 'exact'."
232
250
  }
233
251
  },
234
252
  "required": [
@@ -305,33 +323,36 @@
305
323
  "enum": [
306
324
  "inline",
307
325
  "set_alignment",
326
+ "set_direction",
308
327
  "set_indentation",
309
328
  "set_spacing",
310
329
  "set_style"
311
330
  ],
312
- "description": "The action to perform. One of: inline, set_alignment, set_indentation, set_spacing, set_style."
331
+ "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
313
332
  },
314
333
  "doc": {
315
- "type": "string"
334
+ "type": "string",
335
+ "description": "Document path. Optional when a session is already open."
316
336
  },
317
337
  "sessionId": {
318
- "type": "string"
338
+ "type": "string",
339
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
319
340
  },
320
341
  "force": {
321
- "type": "boolean"
322
- },
323
- "expectedRevision": {
324
- "type": "number"
342
+ "type": "boolean",
343
+ "description": "Bypass confirmation checks."
325
344
  },
326
345
  "changeMode": {
327
346
  "type": "string",
328
347
  "enum": [
329
348
  "direct",
330
349
  "tracked"
331
- ]
350
+ ],
351
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
332
352
  },
333
353
  "dryRun": {
334
- "type": "boolean"
354
+ "type": "boolean",
355
+ "description": "Preview the result without applying changes."
335
356
  },
336
357
  "target": {
337
358
  "type": "object",
@@ -409,7 +430,8 @@
409
430
  "edge"
410
431
  ]
411
432
  }
412
- ]
433
+ ],
434
+ "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."
413
435
  },
414
436
  "end": {
415
437
  "oneOf": [
@@ -480,645 +502,297 @@
480
502
  "edge"
481
503
  ]
482
504
  }
483
- ]
505
+ ],
506
+ "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."
484
507
  }
485
508
  },
486
509
  "required": [
487
510
  "kind",
488
511
  "start",
489
512
  "end"
490
- ]
513
+ ],
514
+ "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_direction'."
491
515
  },
492
516
  "inline": {
493
517
  "type": "object",
494
518
  "properties": {
495
519
  "bold": {
496
- "oneOf": [
497
- {
498
- "type": "boolean"
499
- },
500
- {}
501
- ]
520
+ "type": "boolean"
502
521
  },
503
522
  "italic": {
504
- "oneOf": [
505
- {
506
- "type": "boolean"
507
- },
508
- {}
509
- ]
523
+ "type": "boolean"
510
524
  },
511
525
  "strike": {
512
- "oneOf": [
513
- {
514
- "type": "boolean"
515
- },
516
- {}
517
- ]
526
+ "type": "boolean"
518
527
  },
519
528
  "underline": {
520
529
  "oneOf": [
521
530
  {
522
531
  "type": "boolean"
523
532
  },
524
- {},
525
533
  {
526
534
  "type": "object",
527
535
  "properties": {
528
536
  "style": {
529
- "oneOf": [
530
- {
531
- "type": "string"
532
- },
533
- {}
534
- ]
537
+ "type": "string"
535
538
  },
536
539
  "color": {
537
- "oneOf": [
538
- {
539
- "type": "string"
540
- },
541
- {}
542
- ]
540
+ "type": "string"
543
541
  },
544
542
  "themeColor": {
545
- "oneOf": [
546
- {
547
- "type": "string"
548
- },
549
- {}
550
- ]
543
+ "type": "string"
551
544
  }
552
545
  }
553
546
  }
554
547
  ]
555
548
  },
556
549
  "highlight": {
557
- "oneOf": [
558
- {
559
- "type": "string"
560
- },
561
- {}
562
- ]
550
+ "type": "string"
563
551
  },
564
552
  "color": {
565
- "oneOf": [
566
- {
567
- "type": "string"
568
- },
569
- {}
570
- ]
553
+ "type": "string"
571
554
  },
572
555
  "fontSize": {
573
- "oneOf": [
574
- {
575
- "type": "number"
576
- },
577
- {}
578
- ]
556
+ "type": "number"
579
557
  },
580
558
  "fontFamily": {
581
- "oneOf": [
582
- {
583
- "type": "string"
584
- },
585
- {}
586
- ]
559
+ "type": "string"
587
560
  },
588
561
  "letterSpacing": {
589
- "oneOf": [
590
- {
591
- "type": "number"
592
- },
593
- {}
594
- ]
562
+ "type": "number"
595
563
  },
596
564
  "vertAlign": {
597
- "oneOf": [
598
- {
599
- "enum": [
600
- "superscript",
601
- "subscript",
602
- "baseline"
603
- ]
604
- },
605
- {}
565
+ "enum": [
566
+ "superscript",
567
+ "subscript",
568
+ "baseline"
606
569
  ]
607
570
  },
608
571
  "position": {
609
- "oneOf": [
610
- {
611
- "type": "number"
612
- },
613
- {}
614
- ]
572
+ "type": "number"
615
573
  },
616
574
  "dstrike": {
617
- "oneOf": [
618
- {
619
- "type": "boolean"
620
- },
621
- {}
622
- ]
575
+ "type": "boolean"
623
576
  },
624
577
  "smallCaps": {
625
- "oneOf": [
626
- {
627
- "type": "boolean"
628
- },
629
- {}
630
- ]
578
+ "type": "boolean"
631
579
  },
632
580
  "caps": {
633
- "oneOf": [
634
- {
635
- "type": "boolean"
636
- },
637
- {}
638
- ]
581
+ "type": "boolean"
639
582
  },
640
583
  "shading": {
641
- "oneOf": [
642
- {
643
- "type": "object",
644
- "properties": {
645
- "fill": {
646
- "oneOf": [
647
- {
648
- "type": "string"
649
- },
650
- {}
651
- ]
652
- },
653
- "color": {
654
- "oneOf": [
655
- {
656
- "type": "string"
657
- },
658
- {}
659
- ]
660
- },
661
- "val": {
662
- "oneOf": [
663
- {
664
- "type": "string"
665
- },
666
- {}
667
- ]
668
- }
669
- }
584
+ "type": "object",
585
+ "properties": {
586
+ "fill": {
587
+ "type": "string"
670
588
  },
671
- {}
672
- ]
589
+ "color": {
590
+ "type": "string"
591
+ },
592
+ "val": {
593
+ "type": "string"
594
+ }
595
+ }
673
596
  },
674
597
  "border": {
675
- "oneOf": [
676
- {
677
- "type": "object",
678
- "properties": {
679
- "val": {
680
- "oneOf": [
681
- {
682
- "type": "string"
683
- },
684
- {}
685
- ]
686
- },
687
- "sz": {
688
- "oneOf": [
689
- {
690
- "type": "number"
691
- },
692
- {}
693
- ]
694
- },
695
- "color": {
696
- "oneOf": [
697
- {
698
- "type": "string"
699
- },
700
- {}
701
- ]
702
- },
703
- "space": {
704
- "oneOf": [
705
- {
706
- "type": "number"
707
- },
708
- {}
709
- ]
710
- }
711
- }
598
+ "type": "object",
599
+ "properties": {
600
+ "val": {
601
+ "type": "string"
712
602
  },
713
- {}
714
- ]
603
+ "sz": {
604
+ "type": "number"
605
+ },
606
+ "color": {
607
+ "type": "string"
608
+ },
609
+ "space": {
610
+ "type": "number"
611
+ }
612
+ }
715
613
  },
716
614
  "outline": {
717
- "oneOf": [
718
- {
719
- "type": "boolean"
720
- },
721
- {}
722
- ]
615
+ "type": "boolean"
723
616
  },
724
617
  "shadow": {
725
- "oneOf": [
726
- {
727
- "type": "boolean"
728
- },
729
- {}
730
- ]
618
+ "type": "boolean"
731
619
  },
732
620
  "emboss": {
733
- "oneOf": [
734
- {
735
- "type": "boolean"
736
- },
737
- {}
738
- ]
621
+ "type": "boolean"
739
622
  },
740
623
  "imprint": {
741
- "oneOf": [
742
- {
743
- "type": "boolean"
744
- },
745
- {}
746
- ]
624
+ "type": "boolean"
747
625
  },
748
626
  "charScale": {
749
- "oneOf": [
750
- {
751
- "type": "number"
752
- },
753
- {}
754
- ]
627
+ "type": "number"
755
628
  },
756
629
  "kerning": {
757
- "oneOf": [
758
- {
759
- "type": "number"
760
- },
761
- {}
762
- ]
630
+ "type": "number"
763
631
  },
764
632
  "vanish": {
765
- "oneOf": [
766
- {
767
- "type": "boolean"
768
- },
769
- {}
770
- ]
633
+ "type": "boolean"
771
634
  },
772
635
  "webHidden": {
773
- "oneOf": [
774
- {
775
- "type": "boolean"
776
- },
777
- {}
778
- ]
636
+ "type": "boolean"
779
637
  },
780
638
  "specVanish": {
781
- "oneOf": [
782
- {
783
- "type": "boolean"
784
- },
785
- {}
786
- ]
639
+ "type": "boolean"
787
640
  },
788
641
  "rtl": {
789
- "oneOf": [
790
- {
791
- "type": "boolean"
792
- },
793
- {}
794
- ]
642
+ "type": "boolean"
795
643
  },
796
644
  "cs": {
797
- "oneOf": [
798
- {
799
- "type": "boolean"
800
- },
801
- {}
802
- ]
645
+ "type": "boolean"
803
646
  },
804
647
  "bCs": {
805
- "oneOf": [
806
- {
807
- "type": "boolean"
808
- },
809
- {}
810
- ]
648
+ "type": "boolean"
811
649
  },
812
650
  "iCs": {
813
- "oneOf": [
814
- {
651
+ "type": "boolean"
652
+ },
653
+ "eastAsianLayout": {
654
+ "type": "object",
655
+ "properties": {
656
+ "id": {
657
+ "type": "string"
658
+ },
659
+ "combine": {
815
660
  "type": "boolean"
816
661
  },
817
- {}
818
- ]
819
- },
820
- "eastAsianLayout": {
821
- "oneOf": [
822
- {
823
- "type": "object",
824
- "properties": {
825
- "id": {
826
- "oneOf": [
827
- {
828
- "type": "string"
829
- },
830
- {}
831
- ]
832
- },
833
- "combine": {
834
- "oneOf": [
835
- {
836
- "type": "boolean"
837
- },
838
- {}
839
- ]
840
- },
841
- "combineBrackets": {
842
- "oneOf": [
843
- {
844
- "type": "string"
845
- },
846
- {}
847
- ]
848
- },
849
- "vert": {
850
- "oneOf": [
851
- {
852
- "type": "boolean"
853
- },
854
- {}
855
- ]
856
- },
857
- "vertCompress": {
858
- "oneOf": [
859
- {
860
- "type": "boolean"
861
- },
862
- {}
863
- ]
864
- }
865
- }
866
- },
867
- {}
868
- ]
662
+ "combineBrackets": {
663
+ "type": "string"
664
+ },
665
+ "vert": {
666
+ "type": "boolean"
667
+ },
668
+ "vertCompress": {
669
+ "type": "boolean"
670
+ }
671
+ }
869
672
  },
870
673
  "em": {
871
- "oneOf": [
872
- {
873
- "type": "string"
874
- },
875
- {}
876
- ]
674
+ "type": "string"
877
675
  },
878
676
  "fitText": {
879
- "oneOf": [
880
- {
881
- "type": "object",
882
- "properties": {
883
- "val": {
884
- "oneOf": [
885
- {
886
- "type": "number"
887
- },
888
- {}
889
- ]
890
- },
891
- "id": {
892
- "oneOf": [
893
- {
894
- "type": "string"
895
- },
896
- {}
897
- ]
898
- }
899
- }
677
+ "type": "object",
678
+ "properties": {
679
+ "val": {
680
+ "type": "number"
900
681
  },
901
- {}
902
- ]
682
+ "id": {
683
+ "type": "string"
684
+ }
685
+ }
903
686
  },
904
687
  "snapToGrid": {
905
- "oneOf": [
906
- {
907
- "type": "boolean"
908
- },
909
- {}
910
- ]
688
+ "type": "boolean"
911
689
  },
912
690
  "lang": {
913
- "oneOf": [
914
- {
915
- "type": "object",
916
- "properties": {
917
- "val": {
918
- "oneOf": [
919
- {
920
- "type": "string"
921
- },
922
- {}
923
- ]
924
- },
925
- "eastAsia": {
926
- "oneOf": [
927
- {
928
- "type": "string"
929
- },
930
- {}
931
- ]
932
- },
933
- "bidi": {
934
- "oneOf": [
935
- {
936
- "type": "string"
937
- },
938
- {}
939
- ]
940
- }
941
- }
691
+ "type": "object",
692
+ "properties": {
693
+ "val": {
694
+ "type": "string"
942
695
  },
943
- {}
944
- ]
696
+ "eastAsia": {
697
+ "type": "string"
698
+ },
699
+ "bidi": {
700
+ "type": "string"
701
+ }
702
+ }
945
703
  },
946
704
  "oMath": {
947
- "oneOf": [
948
- {
949
- "type": "boolean"
950
- },
951
- {}
952
- ]
705
+ "type": "boolean"
953
706
  },
954
707
  "rStyle": {
955
- "oneOf": [
956
- {
957
- "type": "string"
958
- },
959
- {}
960
- ]
708
+ "type": "string"
961
709
  },
962
710
  "rFonts": {
963
- "oneOf": [
964
- {
965
- "type": "object",
966
- "properties": {
967
- "ascii": {
968
- "oneOf": [
969
- {
970
- "type": "string"
971
- },
972
- {}
973
- ]
974
- },
975
- "hAnsi": {
976
- "oneOf": [
977
- {
978
- "type": "string"
979
- },
980
- {}
981
- ]
982
- },
983
- "eastAsia": {
984
- "oneOf": [
985
- {
986
- "type": "string"
987
- },
988
- {}
989
- ]
990
- },
991
- "cs": {
992
- "oneOf": [
993
- {
994
- "type": "string"
995
- },
996
- {}
997
- ]
998
- },
999
- "asciiTheme": {
1000
- "oneOf": [
1001
- {
1002
- "type": "string"
1003
- },
1004
- {}
1005
- ]
1006
- },
1007
- "hAnsiTheme": {
1008
- "oneOf": [
1009
- {
1010
- "type": "string"
1011
- },
1012
- {}
1013
- ]
1014
- },
1015
- "eastAsiaTheme": {
1016
- "oneOf": [
1017
- {
1018
- "type": "string"
1019
- },
1020
- {}
1021
- ]
1022
- },
1023
- "csTheme": {
1024
- "oneOf": [
1025
- {
1026
- "type": "string"
1027
- },
1028
- {}
1029
- ]
1030
- },
1031
- "hint": {
1032
- "oneOf": [
1033
- {
1034
- "type": "string"
1035
- },
1036
- {}
1037
- ]
1038
- }
1039
- }
711
+ "type": "object",
712
+ "properties": {
713
+ "ascii": {
714
+ "type": "string"
1040
715
  },
1041
- {}
1042
- ]
716
+ "hAnsi": {
717
+ "type": "string"
718
+ },
719
+ "eastAsia": {
720
+ "type": "string"
721
+ },
722
+ "cs": {
723
+ "type": "string"
724
+ },
725
+ "asciiTheme": {
726
+ "type": "string"
727
+ },
728
+ "hAnsiTheme": {
729
+ "type": "string"
730
+ },
731
+ "eastAsiaTheme": {
732
+ "type": "string"
733
+ },
734
+ "csTheme": {
735
+ "type": "string"
736
+ },
737
+ "hint": {
738
+ "type": "string"
739
+ }
740
+ }
1043
741
  },
1044
742
  "fontSizeCs": {
1045
- "oneOf": [
1046
- {
1047
- "type": "number"
1048
- },
1049
- {}
1050
- ]
743
+ "type": "number"
1051
744
  },
1052
745
  "ligatures": {
1053
- "oneOf": [
1054
- {
1055
- "type": "string"
1056
- },
1057
- {}
1058
- ]
746
+ "type": "string"
1059
747
  },
1060
748
  "numForm": {
1061
- "oneOf": [
1062
- {
1063
- "type": "string"
1064
- },
1065
- {}
1066
- ]
749
+ "type": "string"
1067
750
  },
1068
751
  "numSpacing": {
1069
- "oneOf": [
1070
- {
1071
- "type": "string"
1072
- },
1073
- {}
1074
- ]
752
+ "type": "string"
1075
753
  },
1076
754
  "stylisticSets": {
1077
- "oneOf": [
1078
- {
1079
- "type": "array",
1080
- "items": {
1081
- "type": "object",
1082
- "properties": {
1083
- "id": {
1084
- "type": "number"
1085
- },
1086
- "val": {
1087
- "type": "boolean"
1088
- }
1089
- },
1090
- "required": [
1091
- "id"
1092
- ]
755
+ "type": "array",
756
+ "items": {
757
+ "type": "object",
758
+ "properties": {
759
+ "id": {
760
+ "type": "number"
761
+ },
762
+ "val": {
763
+ "type": "boolean"
1093
764
  }
1094
765
  },
1095
- {}
1096
- ]
766
+ "required": [
767
+ "id"
768
+ ]
769
+ }
1097
770
  },
1098
771
  "contextualAlternates": {
1099
- "oneOf": [
1100
- {
1101
- "type": "boolean"
1102
- },
1103
- {}
1104
- ]
772
+ "type": "boolean"
1105
773
  }
1106
- }
774
+ },
775
+ "description": "Inline formatting properties to apply. Set a property to apply it, use null to clear it. Example: {bold: true, italic: true} or {bold: null} to remove bold."
1107
776
  },
1108
777
  "ref": {
1109
- "type": "string"
778
+ "type": "string",
779
+ "description": "Handle ref string from a superdoc_search result. Pass the handle.ref value directly (e.g. 'text:eyJ...'). Preferred over 'target' for inline formatting."
1110
780
  },
1111
781
  "blockId": {
1112
- "type": "string"
782
+ "type": "string",
783
+ "description": "Block ID of the target paragraph."
1113
784
  },
1114
785
  "start": {
1115
- "type": "number"
786
+ "type": "number",
787
+ "description": "Start offset within the block (character index)."
1116
788
  },
1117
789
  "end": {
1118
- "type": "number"
790
+ "type": "number",
791
+ "description": "End offset within the block (character index)."
1119
792
  },
1120
793
  "styleId": {
1121
- "type": "string"
794
+ "type": "string",
795
+ "description": "Required for action 'set_style'."
1122
796
  },
1123
797
  "alignment": {
1124
798
  "type": "string",
@@ -1127,36 +801,60 @@
1127
801
  "center",
1128
802
  "right",
1129
803
  "justify"
1130
- ]
804
+ ],
805
+ "description": "Required for action 'set_alignment'."
1131
806
  },
1132
807
  "left": {
1133
- "type": "number"
808
+ "type": "number",
809
+ "description": "Left indentation in twips (1440 = 1 inch)."
1134
810
  },
1135
811
  "right": {
1136
- "type": "number"
812
+ "type": "number",
813
+ "description": "Right indentation in twips (1440 = 1 inch)."
1137
814
  },
1138
815
  "firstLine": {
1139
- "type": "number"
816
+ "type": "number",
817
+ "description": "First line indent in twips. Cannot be combined with hanging."
1140
818
  },
1141
819
  "hanging": {
1142
- "type": "number"
820
+ "type": "number",
821
+ "description": "Hanging indent in twips. Cannot be combined with firstLine."
1143
822
  },
1144
823
  "before": {
1145
- "type": "number"
824
+ "type": "number",
825
+ "description": "Space before paragraph in twips (20 twips = 1pt)."
1146
826
  },
1147
827
  "after": {
1148
- "type": "number"
828
+ "type": "number",
829
+ "description": "Space after paragraph in twips (20 twips = 1pt)."
1149
830
  },
1150
831
  "line": {
1151
- "type": "number"
832
+ "type": "number",
833
+ "description": "Line spacing value. Meaning depends on lineRule. Must be provided together with lineRule."
1152
834
  },
1153
835
  "lineRule": {
1154
836
  "type": "string",
837
+ "description": "Line spacing rule. Required when 'line' is set.",
1155
838
  "enum": [
1156
839
  "auto",
1157
840
  "exact",
1158
841
  "atLeast"
1159
842
  ]
843
+ },
844
+ "direction": {
845
+ "type": "string",
846
+ "enum": [
847
+ "ltr",
848
+ "rtl"
849
+ ],
850
+ "description": "Required for action 'set_direction'."
851
+ },
852
+ "alignmentPolicy": {
853
+ "type": "string",
854
+ "enum": [
855
+ "preserve",
856
+ "matchDirection"
857
+ ]
1160
858
  }
1161
859
  },
1162
860
  "required": [
@@ -1209,6 +907,14 @@
1209
907
  "required": [
1210
908
  "target"
1211
909
  ]
910
+ },
911
+ {
912
+ "operationId": "doc.format.paragraph.setDirection",
913
+ "intentAction": "set_direction",
914
+ "required": [
915
+ "target",
916
+ "direction"
917
+ ]
1212
918
  }
1213
919
  ]
1214
920
  },
@@ -1227,26 +933,28 @@
1227
933
  "description": "The action to perform. One of: heading, paragraph."
1228
934
  },
1229
935
  "doc": {
1230
- "type": "string"
936
+ "type": "string",
937
+ "description": "Document path. Optional when a session is already open."
1231
938
  },
1232
939
  "sessionId": {
1233
- "type": "string"
940
+ "type": "string",
941
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1234
942
  },
1235
943
  "force": {
1236
- "type": "boolean"
1237
- },
1238
- "expectedRevision": {
1239
- "type": "number"
944
+ "type": "boolean",
945
+ "description": "Bypass confirmation checks."
1240
946
  },
1241
947
  "changeMode": {
1242
948
  "type": "string",
1243
949
  "enum": [
1244
950
  "direct",
1245
951
  "tracked"
1246
- ]
952
+ ],
953
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1247
954
  },
1248
955
  "dryRun": {
1249
- "type": "boolean"
956
+ "type": "boolean",
957
+ "description": "Preview the result without applying changes."
1250
958
  },
1251
959
  "at": {
1252
960
  "oneOf": [
@@ -1360,16 +1068,20 @@
1360
1068
  "target"
1361
1069
  ]
1362
1070
  }
1363
- ]
1071
+ ],
1072
+ "description": "Position: {kind:'documentEnd'} to append, {kind:'documentStart'} to prepend, or {kind:'before'|'after', target:{kind:'block', nodeType:'...', nodeId:'...'}} for relative placement."
1364
1073
  },
1365
1074
  "text": {
1366
- "type": "string"
1075
+ "type": "string",
1076
+ "description": "Paragraph text content."
1367
1077
  },
1368
1078
  "input": {
1369
- "type": "object"
1079
+ "type": "object",
1080
+ "description": "Full paragraph input as JSON (alternative to individual text/at params)."
1370
1081
  },
1371
1082
  "level": {
1372
- "type": "number"
1083
+ "type": "number",
1084
+ "description": "Heading level (1-6). Required for action 'heading'."
1373
1085
  }
1374
1086
  },
1375
1087
  "required": [
@@ -1412,26 +1124,28 @@
1412
1124
  "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
1413
1125
  },
1414
1126
  "doc": {
1415
- "type": "string"
1127
+ "type": "string",
1128
+ "description": "Document path. Optional when a session is already open."
1416
1129
  },
1417
1130
  "sessionId": {
1418
- "type": "string"
1131
+ "type": "string",
1132
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1419
1133
  },
1420
1134
  "force": {
1421
- "type": "boolean"
1422
- },
1423
- "expectedRevision": {
1424
- "type": "number"
1135
+ "type": "boolean",
1136
+ "description": "Bypass confirmation checks."
1425
1137
  },
1426
1138
  "changeMode": {
1427
1139
  "type": "string",
1428
1140
  "enum": [
1429
1141
  "direct",
1430
1142
  "tracked"
1431
- ]
1143
+ ],
1144
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1432
1145
  },
1433
1146
  "dryRun": {
1434
- "type": "boolean"
1147
+ "type": "boolean",
1148
+ "description": "Preview the result without applying changes."
1435
1149
  },
1436
1150
  "target": {
1437
1151
  "type": "object",
@@ -1452,26 +1166,32 @@
1452
1166
  "kind",
1453
1167
  "nodeType",
1454
1168
  "nodeId"
1455
- ]
1169
+ ],
1170
+ "description": "The target list item. For 'insert': the item to insert relative to. For 'create' with mode 'fromParagraphs': use nodeType 'paragraph' instead. Format: {kind:'block', nodeType:'listItem', nodeId:'<id>'}. Required for actions 'insert', 'detach', 'indent', 'outdent', 'set_level', 'set_type'."
1456
1171
  },
1457
1172
  "position": {
1458
1173
  "type": "string",
1174
+ "description": "Required. Insert position relative to target: 'before' or 'after'. Required for action 'insert'.",
1459
1175
  "enum": [
1460
1176
  "before",
1461
1177
  "after"
1462
1178
  ]
1463
1179
  },
1464
1180
  "text": {
1465
- "type": "string"
1181
+ "type": "string",
1182
+ "description": "Text content for the new list item."
1466
1183
  },
1467
1184
  "input": {
1468
- "type": "object"
1185
+ "type": "object",
1186
+ "description": "Operation input as JSON object."
1469
1187
  },
1470
1188
  "nodeId": {
1471
- "type": "string"
1189
+ "type": "string",
1190
+ "description": "Node ID of the target list item."
1472
1191
  },
1473
1192
  "mode": {
1474
1193
  "type": "string",
1194
+ "description": "Required. Creation mode: 'empty' creates a new empty list at the paragraph specified by 'at'; 'fromParagraphs' converts existing paragraph(s) specified by 'target' into list items. Required for action 'create'.",
1475
1195
  "enum": [
1476
1196
  "empty",
1477
1197
  "fromParagraphs"
@@ -1496,47 +1216,168 @@
1496
1216
  "kind",
1497
1217
  "nodeType",
1498
1218
  "nodeId"
1499
- ]
1219
+ ],
1220
+ "description": "Required when mode is 'empty'. The paragraph to create the list at. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
1500
1221
  },
1501
1222
  "kind": {
1502
1223
  "type": "string",
1224
+ "description": "List type: 'bullet' for bullet points, 'ordered' for numbered lists. Required for action 'set_type'.",
1503
1225
  "enum": [
1504
1226
  "ordered",
1505
1227
  "bullet"
1506
1228
  ]
1507
1229
  },
1508
1230
  "level": {
1509
- "type": "number"
1231
+ "type": "number",
1232
+ "description": "List nesting level (0-8). 0 is the top level. Required for action 'set_level'."
1510
1233
  },
1511
- "continuity": {
1234
+ "preset": {
1512
1235
  "type": "string",
1236
+ "description": "Predefined list style preset. Overrides 'kind' with a specific numbering or bullet format.",
1513
1237
  "enum": [
1514
- "preserve",
1515
- "none"
1238
+ "decimal",
1239
+ "decimalParenthesis",
1240
+ "lowerLetter",
1241
+ "upperLetter",
1242
+ "lowerRoman",
1243
+ "upperRoman",
1244
+ "disc",
1245
+ "circle",
1246
+ "square",
1247
+ "dash"
1516
1248
  ]
1517
- }
1518
- },
1519
- "required": [
1520
- "action"
1521
- ],
1522
- "additionalProperties": false
1523
- },
1524
- "mutates": true,
1525
- "operations": [
1526
- {
1527
- "operationId": "doc.lists.insert",
1528
- "intentAction": "insert",
1529
- "required": [
1530
- "target",
1531
- "position"
1532
- ]
1533
- },
1249
+ },
1250
+ "style": {
1251
+ "type": "object",
1252
+ "properties": {
1253
+ "version": {
1254
+ "const": 1,
1255
+ "type": "number"
1256
+ },
1257
+ "levels": {
1258
+ "type": "array",
1259
+ "items": {
1260
+ "type": "object",
1261
+ "properties": {
1262
+ "level": {
1263
+ "type": "number"
1264
+ },
1265
+ "numFmt": {
1266
+ "type": "string"
1267
+ },
1268
+ "lvlText": {
1269
+ "type": "string"
1270
+ },
1271
+ "start": {
1272
+ "type": "number"
1273
+ },
1274
+ "alignment": {
1275
+ "enum": [
1276
+ "left",
1277
+ "center",
1278
+ "right"
1279
+ ]
1280
+ },
1281
+ "indents": {
1282
+ "type": "object",
1283
+ "properties": {
1284
+ "left": {
1285
+ "type": "number"
1286
+ },
1287
+ "hanging": {
1288
+ "type": "number"
1289
+ },
1290
+ "firstLine": {
1291
+ "type": "number"
1292
+ }
1293
+ }
1294
+ },
1295
+ "trailingCharacter": {
1296
+ "enum": [
1297
+ "tab",
1298
+ "space",
1299
+ "nothing"
1300
+ ]
1301
+ },
1302
+ "markerFont": {
1303
+ "type": "string"
1304
+ },
1305
+ "pictureBulletId": {
1306
+ "type": "number"
1307
+ },
1308
+ "tabStopAt": {}
1309
+ },
1310
+ "required": [
1311
+ "level"
1312
+ ]
1313
+ }
1314
+ }
1315
+ },
1316
+ "required": [
1317
+ "version",
1318
+ "levels"
1319
+ ]
1320
+ },
1321
+ "sequence": {
1322
+ "oneOf": [
1323
+ {
1324
+ "type": "object",
1325
+ "properties": {
1326
+ "mode": {
1327
+ "const": "new",
1328
+ "type": "string"
1329
+ },
1330
+ "startAt": {
1331
+ "type": "number"
1332
+ }
1333
+ },
1334
+ "required": [
1335
+ "mode"
1336
+ ]
1337
+ },
1338
+ {
1339
+ "type": "object",
1340
+ "properties": {
1341
+ "mode": {
1342
+ "const": "continuePrevious",
1343
+ "type": "string"
1344
+ }
1345
+ },
1346
+ "required": [
1347
+ "mode"
1348
+ ]
1349
+ }
1350
+ ]
1351
+ },
1352
+ "continuity": {
1353
+ "type": "string",
1354
+ "description": "Numbering continuity: 'preserve' keeps numbering; 'none' restarts.",
1355
+ "enum": [
1356
+ "preserve",
1357
+ "none"
1358
+ ]
1359
+ }
1360
+ },
1361
+ "required": [
1362
+ "action"
1363
+ ],
1364
+ "additionalProperties": false
1365
+ },
1366
+ "mutates": true,
1367
+ "operations": [
1368
+ {
1369
+ "operationId": "doc.lists.insert",
1370
+ "intentAction": "insert",
1371
+ "required": [
1372
+ "target",
1373
+ "position"
1374
+ ]
1375
+ },
1534
1376
  {
1535
1377
  "operationId": "doc.lists.create",
1536
1378
  "intentAction": "create",
1537
1379
  "required": [
1538
- "mode",
1539
- "kind"
1380
+ "mode"
1540
1381
  ]
1541
1382
  },
1542
1383
  {
@@ -1596,26 +1437,28 @@
1596
1437
  "description": "The action to perform. One of: create, delete, get, list, update."
1597
1438
  },
1598
1439
  "doc": {
1599
- "type": "string"
1440
+ "type": "string",
1441
+ "description": "Document path. Optional when a session is already open."
1600
1442
  },
1601
1443
  "sessionId": {
1602
- "type": "string"
1444
+ "type": "string",
1445
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1603
1446
  },
1604
1447
  "force": {
1605
- "type": "boolean"
1606
- },
1607
- "expectedRevision": {
1608
- "type": "number"
1448
+ "type": "boolean",
1449
+ "description": "Bypass confirmation checks."
1609
1450
  },
1610
1451
  "changeMode": {
1611
1452
  "type": "string",
1612
1453
  "enum": [
1613
1454
  "direct",
1614
1455
  "tracked"
1615
- ]
1456
+ ],
1457
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1616
1458
  },
1617
1459
  "text": {
1618
- "type": "string"
1460
+ "type": "string",
1461
+ "description": "Comment text content. Required for action 'create'."
1619
1462
  },
1620
1463
  "target": {
1621
1464
  "type": "object",
@@ -1647,40 +1490,51 @@
1647
1490
  "kind",
1648
1491
  "blockId",
1649
1492
  "range"
1650
- ]
1493
+ ],
1494
+ "description": "Text range to anchor the comment: {kind:'text', blockId:'...', range:{start:N, end:N}}."
1651
1495
  },
1652
1496
  "parentId": {
1653
- "type": "string"
1497
+ "type": "string",
1498
+ "description": "Parent comment ID for creating a threaded reply."
1654
1499
  },
1655
1500
  "blockId": {
1656
- "type": "string"
1501
+ "type": "string",
1502
+ "description": "Block ID of the target paragraph."
1657
1503
  },
1658
1504
  "start": {
1659
- "type": "number"
1505
+ "type": "number",
1506
+ "description": "Start offset within the block (character index)."
1660
1507
  },
1661
1508
  "end": {
1662
- "type": "number"
1509
+ "type": "number",
1510
+ "description": "End offset within the block (character index)."
1663
1511
  },
1664
1512
  "id": {
1665
- "type": "string"
1513
+ "type": "string",
1514
+ "description": "Required for actions 'delete', 'get'."
1666
1515
  },
1667
1516
  "status": {
1668
1517
  "type": "string",
1518
+ "description": "Set comment status. Use 'resolved' to mark as resolved.",
1669
1519
  "enum": [
1670
1520
  "resolved"
1671
1521
  ]
1672
1522
  },
1673
1523
  "isInternal": {
1674
- "type": "boolean"
1524
+ "type": "boolean",
1525
+ "description": "When true, marks the comment as internal (hidden from external collaborators)."
1675
1526
  },
1676
1527
  "includeResolved": {
1677
- "type": "boolean"
1528
+ "type": "boolean",
1529
+ "description": "When true, includes resolved comments in results. Default: false."
1678
1530
  },
1679
1531
  "limit": {
1680
- "type": "number"
1532
+ "type": "number",
1533
+ "description": "Maximum number of comments to return."
1681
1534
  },
1682
1535
  "offset": {
1683
- "type": "number"
1536
+ "type": "number",
1537
+ "description": "Number of comments to skip for pagination."
1684
1538
  }
1685
1539
  },
1686
1540
  "required": [
@@ -1736,19 +1590,24 @@
1736
1590
  "description": "The action to perform. One of: decide, list."
1737
1591
  },
1738
1592
  "doc": {
1739
- "type": "string"
1593
+ "type": "string",
1594
+ "description": "Document path. Optional when a session is already open."
1740
1595
  },
1741
1596
  "sessionId": {
1742
- "type": "string"
1597
+ "type": "string",
1598
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1743
1599
  },
1744
1600
  "limit": {
1745
- "type": "number"
1601
+ "type": "number",
1602
+ "description": "Maximum number of tracked changes to return."
1746
1603
  },
1747
1604
  "offset": {
1748
- "type": "number"
1605
+ "type": "number",
1606
+ "description": "Number of tracked changes to skip for pagination."
1749
1607
  },
1750
1608
  "type": {
1751
1609
  "type": "string",
1610
+ "description": "Filter by change type: 'insert', 'delete', or 'format'.",
1752
1611
  "enum": [
1753
1612
  "insert",
1754
1613
  "delete",
@@ -1756,24 +1615,24 @@
1756
1615
  ]
1757
1616
  },
1758
1617
  "force": {
1759
- "type": "boolean"
1760
- },
1761
- "expectedRevision": {
1762
- "type": "number"
1618
+ "type": "boolean",
1619
+ "description": "Bypass confirmation checks."
1763
1620
  },
1764
1621
  "changeMode": {
1765
1622
  "type": "string",
1766
1623
  "enum": [
1767
1624
  "direct",
1768
1625
  "tracked"
1769
- ]
1626
+ ],
1627
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1770
1628
  },
1771
1629
  "decision": {
1772
1630
  "type": "string",
1773
1631
  "enum": [
1774
1632
  "accept",
1775
1633
  "reject"
1776
- ]
1634
+ ],
1635
+ "description": "Required for action 'decide'."
1777
1636
  },
1778
1637
  "target": {
1779
1638
  "oneOf": [
@@ -1801,7 +1660,8 @@
1801
1660
  "scope"
1802
1661
  ]
1803
1662
  }
1804
- ]
1663
+ ],
1664
+ "description": "Required for action 'decide'."
1805
1665
  }
1806
1666
  },
1807
1667
  "required": [
@@ -1832,10 +1692,12 @@
1832
1692
  "type": "object",
1833
1693
  "properties": {
1834
1694
  "doc": {
1835
- "type": "string"
1695
+ "type": "string",
1696
+ "description": "Document path. Optional when a session is already open."
1836
1697
  },
1837
1698
  "sessionId": {
1838
- "type": "string"
1699
+ "type": "string",
1700
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1839
1701
  },
1840
1702
  "select": {
1841
1703
  "oneOf": [
@@ -1844,19 +1706,23 @@
1844
1706
  "properties": {
1845
1707
  "type": {
1846
1708
  "const": "text",
1709
+ "description": "Must be 'text' for text pattern search.",
1847
1710
  "type": "string"
1848
1711
  },
1849
1712
  "pattern": {
1850
- "type": "string"
1713
+ "type": "string",
1714
+ "description": "Text or regex pattern to match."
1851
1715
  },
1852
1716
  "mode": {
1717
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
1853
1718
  "enum": [
1854
1719
  "contains",
1855
1720
  "regex"
1856
1721
  ]
1857
1722
  },
1858
1723
  "caseSensitive": {
1859
- "type": "boolean"
1724
+ "type": "boolean",
1725
+ "description": "Case-sensitive matching. Default: false."
1860
1726
  }
1861
1727
  },
1862
1728
  "required": [
@@ -1869,9 +1735,11 @@
1869
1735
  "properties": {
1870
1736
  "type": {
1871
1737
  "const": "node",
1738
+ "description": "Must be 'node' for node type search.",
1872
1739
  "type": "string"
1873
1740
  },
1874
1741
  "nodeType": {
1742
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
1875
1743
  "enum": [
1876
1744
  "paragraph",
1877
1745
  "heading",
@@ -1898,6 +1766,7 @@
1898
1766
  ]
1899
1767
  },
1900
1768
  "kind": {
1769
+ "description": "Filter: 'block' or 'inline'.",
1901
1770
  "enum": [
1902
1771
  "block",
1903
1772
  "inline"
@@ -1908,7 +1777,8 @@
1908
1777
  "type"
1909
1778
  ]
1910
1779
  }
1911
- ]
1780
+ ],
1781
+ "description": "Search selector. Use {type:'text', pattern:'...'} for text search or {type:'node', nodeType:'paragraph'|'heading'|...} for node search."
1912
1782
  },
1913
1783
  "within": {
1914
1784
  "type": "object",
@@ -1938,10 +1808,12 @@
1938
1808
  "kind",
1939
1809
  "nodeType",
1940
1810
  "nodeId"
1941
- ]
1811
+ ],
1812
+ "description": "Limit search scope to within a specific block: {kind:'block', nodeType:'...', nodeId:'...'}."
1942
1813
  },
1943
1814
  "require": {
1944
1815
  "type": "string",
1816
+ "description": "Match cardinality: 'any' (all matches), 'first' (only first), 'exactlyOne' (fail if != 1), 'all' (fail if 0).",
1945
1817
  "enum": [
1946
1818
  "any",
1947
1819
  "first",
@@ -1951,19 +1823,23 @@
1951
1823
  },
1952
1824
  "mode": {
1953
1825
  "type": "string",
1826
+ "description": "Search mode: 'strict' (default, exact matching) or 'candidates' (returns scored potential matches).",
1954
1827
  "enum": [
1955
1828
  "strict",
1956
1829
  "candidates"
1957
1830
  ]
1958
1831
  },
1959
1832
  "includeNodes": {
1960
- "type": "boolean"
1833
+ "type": "boolean",
1834
+ "description": "When true, includes full node data in results. Default: false."
1961
1835
  },
1962
1836
  "limit": {
1963
- "type": "number"
1837
+ "type": "number",
1838
+ "description": "Maximum number of matches to return."
1964
1839
  },
1965
1840
  "offset": {
1966
- "type": "number"
1841
+ "type": "number",
1842
+ "description": "Number of matches to skip for pagination."
1967
1843
  }
1968
1844
  },
1969
1845
  "required": [
@@ -1997,19 +1873,24 @@
1997
1873
  "description": "The action to perform. One of: apply, preview."
1998
1874
  },
1999
1875
  "doc": {
2000
- "type": "string"
1876
+ "type": "string",
1877
+ "description": "Document path. Optional when a session is already open."
2001
1878
  },
2002
1879
  "sessionId": {
2003
- "type": "string"
1880
+ "type": "string",
1881
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
2004
1882
  },
2005
1883
  "expectedRevision": {
2006
- "type": "string"
1884
+ "type": "string",
1885
+ "description": "Document revision for optimistic concurrency. Mutation fails if document was modified since this revision."
2007
1886
  },
2008
1887
  "atomic": {
2009
- "type": "boolean"
1888
+ "type": "boolean",
1889
+ "description": "Must be true. All steps execute as one atomic transaction."
2010
1890
  },
2011
1891
  "changeMode": {
2012
1892
  "type": "string",
1893
+ "description": "Required. Use 'direct' for immediate edits or 'tracked' for suggestions. Must always be provided.",
2013
1894
  "enum": [
2014
1895
  "direct",
2015
1896
  "tracked"
@@ -2045,19 +1926,23 @@
2045
1926
  "properties": {
2046
1927
  "type": {
2047
1928
  "const": "text",
1929
+ "description": "Must be 'text' for text pattern search.",
2048
1930
  "type": "string"
2049
1931
  },
2050
1932
  "pattern": {
2051
- "type": "string"
1933
+ "type": "string",
1934
+ "description": "Text or regex pattern to match."
2052
1935
  },
2053
1936
  "mode": {
1937
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2054
1938
  "enum": [
2055
1939
  "contains",
2056
1940
  "regex"
2057
1941
  ]
2058
1942
  },
2059
1943
  "caseSensitive": {
2060
- "type": "boolean"
1944
+ "type": "boolean",
1945
+ "description": "Case-sensitive matching. Default: false."
2061
1946
  }
2062
1947
  },
2063
1948
  "required": [
@@ -2070,9 +1955,11 @@
2070
1955
  "properties": {
2071
1956
  "type": {
2072
1957
  "const": "node",
1958
+ "description": "Must be 'node' for node type search.",
2073
1959
  "type": "string"
2074
1960
  },
2075
1961
  "nodeType": {
1962
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2076
1963
  "enum": [
2077
1964
  "paragraph",
2078
1965
  "heading",
@@ -2099,6 +1986,7 @@
2099
1986
  ]
2100
1987
  },
2101
1988
  "kind": {
1989
+ "description": "Filter: 'block' or 'inline'.",
2102
1990
  "enum": [
2103
1991
  "block",
2104
1992
  "inline"
@@ -2284,7 +2172,8 @@
2284
2172
  "edge"
2285
2173
  ]
2286
2174
  }
2287
- ]
2175
+ ],
2176
+ "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."
2288
2177
  },
2289
2178
  "end": {
2290
2179
  "oneOf": [
@@ -2355,7 +2244,8 @@
2355
2244
  "edge"
2356
2245
  ]
2357
2246
  }
2358
- ]
2247
+ ],
2248
+ "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."
2359
2249
  }
2360
2250
  },
2361
2251
  "required": [
@@ -2532,19 +2422,23 @@
2532
2422
  "properties": {
2533
2423
  "type": {
2534
2424
  "const": "text",
2425
+ "description": "Must be 'text' for text pattern search.",
2535
2426
  "type": "string"
2536
2427
  },
2537
2428
  "pattern": {
2538
- "type": "string"
2429
+ "type": "string",
2430
+ "description": "Text or regex pattern to match."
2539
2431
  },
2540
2432
  "mode": {
2433
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2541
2434
  "enum": [
2542
2435
  "contains",
2543
2436
  "regex"
2544
2437
  ]
2545
2438
  },
2546
2439
  "caseSensitive": {
2547
- "type": "boolean"
2440
+ "type": "boolean",
2441
+ "description": "Case-sensitive matching. Default: false."
2548
2442
  }
2549
2443
  },
2550
2444
  "required": [
@@ -2557,9 +2451,11 @@
2557
2451
  "properties": {
2558
2452
  "type": {
2559
2453
  "const": "node",
2454
+ "description": "Must be 'node' for node type search.",
2560
2455
  "type": "string"
2561
2456
  },
2562
2457
  "nodeType": {
2458
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2563
2459
  "enum": [
2564
2460
  "paragraph",
2565
2461
  "heading",
@@ -2586,6 +2482,7 @@
2586
2482
  ]
2587
2483
  },
2588
2484
  "kind": {
2485
+ "description": "Filter: 'block' or 'inline'.",
2589
2486
  "enum": [
2590
2487
  "block",
2591
2488
  "inline"
@@ -2757,19 +2654,23 @@
2757
2654
  "properties": {
2758
2655
  "type": {
2759
2656
  "const": "text",
2657
+ "description": "Must be 'text' for text pattern search.",
2760
2658
  "type": "string"
2761
2659
  },
2762
2660
  "pattern": {
2763
- "type": "string"
2661
+ "type": "string",
2662
+ "description": "Text or regex pattern to match."
2764
2663
  },
2765
2664
  "mode": {
2665
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2766
2666
  "enum": [
2767
2667
  "contains",
2768
2668
  "regex"
2769
2669
  ]
2770
2670
  },
2771
2671
  "caseSensitive": {
2772
- "type": "boolean"
2672
+ "type": "boolean",
2673
+ "description": "Case-sensitive matching. Default: false."
2773
2674
  }
2774
2675
  },
2775
2676
  "required": [
@@ -2782,9 +2683,11 @@
2782
2683
  "properties": {
2783
2684
  "type": {
2784
2685
  "const": "node",
2686
+ "description": "Must be 'node' for node type search.",
2785
2687
  "type": "string"
2786
2688
  },
2787
2689
  "nodeType": {
2690
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2788
2691
  "enum": [
2789
2692
  "paragraph",
2790
2693
  "heading",
@@ -2811,6 +2714,7 @@
2811
2714
  ]
2812
2715
  },
2813
2716
  "kind": {
2717
+ "description": "Filter: 'block' or 'inline'.",
2814
2718
  "enum": [
2815
2719
  "block",
2816
2720
  "inline"
@@ -2996,7 +2900,8 @@
2996
2900
  "edge"
2997
2901
  ]
2998
2902
  }
2999
- ]
2903
+ ],
2904
+ "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."
3000
2905
  },
3001
2906
  "end": {
3002
2907
  "oneOf": [
@@ -3067,7 +2972,8 @@
3067
2972
  "edge"
3068
2973
  ]
3069
2974
  }
3070
- ]
2975
+ ],
2976
+ "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."
3071
2977
  }
3072
2978
  },
3073
2979
  "required": [
@@ -3129,19 +3035,23 @@
3129
3035
  "properties": {
3130
3036
  "type": {
3131
3037
  "const": "text",
3038
+ "description": "Must be 'text' for text pattern search.",
3132
3039
  "type": "string"
3133
3040
  },
3134
3041
  "pattern": {
3135
- "type": "string"
3042
+ "type": "string",
3043
+ "description": "Text or regex pattern to match."
3136
3044
  },
3137
3045
  "mode": {
3046
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
3138
3047
  "enum": [
3139
3048
  "contains",
3140
3049
  "regex"
3141
3050
  ]
3142
3051
  },
3143
3052
  "caseSensitive": {
3144
- "type": "boolean"
3053
+ "type": "boolean",
3054
+ "description": "Case-sensitive matching. Default: false."
3145
3055
  }
3146
3056
  },
3147
3057
  "required": [
@@ -3154,9 +3064,11 @@
3154
3064
  "properties": {
3155
3065
  "type": {
3156
3066
  "const": "node",
3067
+ "description": "Must be 'node' for node type search.",
3157
3068
  "type": "string"
3158
3069
  },
3159
3070
  "nodeType": {
3071
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
3160
3072
  "enum": [
3161
3073
  "paragraph",
3162
3074
  "heading",
@@ -3183,6 +3095,7 @@
3183
3095
  ]
3184
3096
  },
3185
3097
  "kind": {
3098
+ "description": "Filter: 'block' or 'inline'.",
3186
3099
  "enum": [
3187
3100
  "block",
3188
3101
  "inline"
@@ -3368,7 +3281,8 @@
3368
3281
  "edge"
3369
3282
  ]
3370
3283
  }
3371
- ]
3284
+ ],
3285
+ "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."
3372
3286
  },
3373
3287
  "end": {
3374
3288
  "oneOf": [
@@ -3439,7 +3353,8 @@
3439
3353
  "edge"
3440
3354
  ]
3441
3355
  }
3442
- ]
3356
+ ],
3357
+ "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."
3443
3358
  }
3444
3359
  },
3445
3360
  "required": [
@@ -3463,615 +3378,259 @@
3463
3378
  "type": "object",
3464
3379
  "properties": {
3465
3380
  "bold": {
3466
- "oneOf": [
3467
- {
3468
- "type": "boolean"
3469
- },
3470
- {}
3471
- ]
3381
+ "type": "boolean"
3472
3382
  },
3473
3383
  "italic": {
3474
- "oneOf": [
3475
- {
3476
- "type": "boolean"
3477
- },
3478
- {}
3479
- ]
3384
+ "type": "boolean"
3480
3385
  },
3481
3386
  "strike": {
3482
- "oneOf": [
3483
- {
3484
- "type": "boolean"
3485
- },
3486
- {}
3487
- ]
3387
+ "type": "boolean"
3488
3388
  },
3489
3389
  "underline": {
3490
3390
  "oneOf": [
3491
3391
  {
3492
3392
  "type": "boolean"
3493
3393
  },
3494
- {},
3495
3394
  {
3496
3395
  "type": "object",
3497
3396
  "properties": {
3498
3397
  "style": {
3499
- "oneOf": [
3500
- {
3501
- "type": "string"
3502
- },
3503
- {}
3504
- ]
3398
+ "type": "string"
3505
3399
  },
3506
3400
  "color": {
3507
- "oneOf": [
3508
- {
3509
- "type": "string"
3510
- },
3511
- {}
3512
- ]
3401
+ "type": "string"
3513
3402
  },
3514
3403
  "themeColor": {
3515
- "oneOf": [
3516
- {
3517
- "type": "string"
3518
- },
3519
- {}
3520
- ]
3404
+ "type": "string"
3521
3405
  }
3522
3406
  }
3523
3407
  }
3524
3408
  ]
3525
3409
  },
3526
3410
  "highlight": {
3527
- "oneOf": [
3528
- {
3529
- "type": "string"
3530
- },
3531
- {}
3532
- ]
3411
+ "type": "string"
3533
3412
  },
3534
3413
  "color": {
3535
- "oneOf": [
3536
- {
3537
- "type": "string"
3538
- },
3539
- {}
3540
- ]
3414
+ "type": "string"
3541
3415
  },
3542
3416
  "fontSize": {
3543
- "oneOf": [
3544
- {
3545
- "type": "number"
3546
- },
3547
- {}
3548
- ]
3417
+ "type": "number"
3549
3418
  },
3550
3419
  "fontFamily": {
3551
- "oneOf": [
3552
- {
3553
- "type": "string"
3554
- },
3555
- {}
3556
- ]
3420
+ "type": "string"
3557
3421
  },
3558
3422
  "letterSpacing": {
3559
- "oneOf": [
3560
- {
3561
- "type": "number"
3562
- },
3563
- {}
3564
- ]
3423
+ "type": "number"
3565
3424
  },
3566
3425
  "vertAlign": {
3567
- "oneOf": [
3568
- {
3569
- "enum": [
3570
- "superscript",
3571
- "subscript",
3572
- "baseline"
3573
- ]
3574
- },
3575
- {}
3426
+ "enum": [
3427
+ "superscript",
3428
+ "subscript",
3429
+ "baseline"
3576
3430
  ]
3577
3431
  },
3578
3432
  "position": {
3579
- "oneOf": [
3580
- {
3581
- "type": "number"
3582
- },
3583
- {}
3584
- ]
3433
+ "type": "number"
3585
3434
  },
3586
3435
  "dstrike": {
3587
- "oneOf": [
3588
- {
3589
- "type": "boolean"
3590
- },
3591
- {}
3592
- ]
3436
+ "type": "boolean"
3593
3437
  },
3594
3438
  "smallCaps": {
3595
- "oneOf": [
3596
- {
3597
- "type": "boolean"
3598
- },
3599
- {}
3600
- ]
3439
+ "type": "boolean"
3601
3440
  },
3602
3441
  "caps": {
3603
- "oneOf": [
3604
- {
3605
- "type": "boolean"
3606
- },
3607
- {}
3608
- ]
3442
+ "type": "boolean"
3609
3443
  },
3610
3444
  "shading": {
3611
- "oneOf": [
3612
- {
3613
- "type": "object",
3614
- "properties": {
3615
- "fill": {
3616
- "oneOf": [
3617
- {
3618
- "type": "string"
3619
- },
3620
- {}
3621
- ]
3622
- },
3623
- "color": {
3624
- "oneOf": [
3625
- {
3626
- "type": "string"
3627
- },
3628
- {}
3629
- ]
3630
- },
3631
- "val": {
3632
- "oneOf": [
3633
- {
3634
- "type": "string"
3635
- },
3636
- {}
3637
- ]
3638
- }
3639
- }
3445
+ "type": "object",
3446
+ "properties": {
3447
+ "fill": {
3448
+ "type": "string"
3640
3449
  },
3641
- {}
3642
- ]
3450
+ "color": {
3451
+ "type": "string"
3452
+ },
3453
+ "val": {
3454
+ "type": "string"
3455
+ }
3456
+ }
3643
3457
  },
3644
3458
  "border": {
3645
- "oneOf": [
3646
- {
3647
- "type": "object",
3648
- "properties": {
3649
- "val": {
3650
- "oneOf": [
3651
- {
3652
- "type": "string"
3653
- },
3654
- {}
3655
- ]
3656
- },
3657
- "sz": {
3658
- "oneOf": [
3659
- {
3660
- "type": "number"
3661
- },
3662
- {}
3663
- ]
3664
- },
3665
- "color": {
3666
- "oneOf": [
3667
- {
3668
- "type": "string"
3669
- },
3670
- {}
3671
- ]
3672
- },
3673
- "space": {
3674
- "oneOf": [
3675
- {
3676
- "type": "number"
3677
- },
3678
- {}
3679
- ]
3680
- }
3681
- }
3459
+ "type": "object",
3460
+ "properties": {
3461
+ "val": {
3462
+ "type": "string"
3682
3463
  },
3683
- {}
3684
- ]
3464
+ "sz": {
3465
+ "type": "number"
3466
+ },
3467
+ "color": {
3468
+ "type": "string"
3469
+ },
3470
+ "space": {
3471
+ "type": "number"
3472
+ }
3473
+ }
3685
3474
  },
3686
3475
  "outline": {
3687
- "oneOf": [
3688
- {
3689
- "type": "boolean"
3690
- },
3691
- {}
3692
- ]
3476
+ "type": "boolean"
3693
3477
  },
3694
3478
  "shadow": {
3695
- "oneOf": [
3696
- {
3697
- "type": "boolean"
3698
- },
3699
- {}
3700
- ]
3479
+ "type": "boolean"
3701
3480
  },
3702
3481
  "emboss": {
3703
- "oneOf": [
3704
- {
3705
- "type": "boolean"
3706
- },
3707
- {}
3708
- ]
3482
+ "type": "boolean"
3709
3483
  },
3710
3484
  "imprint": {
3711
- "oneOf": [
3712
- {
3713
- "type": "boolean"
3714
- },
3715
- {}
3716
- ]
3485
+ "type": "boolean"
3717
3486
  },
3718
3487
  "charScale": {
3719
- "oneOf": [
3720
- {
3721
- "type": "number"
3722
- },
3723
- {}
3724
- ]
3488
+ "type": "number"
3725
3489
  },
3726
3490
  "kerning": {
3727
- "oneOf": [
3728
- {
3729
- "type": "number"
3730
- },
3731
- {}
3732
- ]
3491
+ "type": "number"
3733
3492
  },
3734
3493
  "vanish": {
3735
- "oneOf": [
3736
- {
3737
- "type": "boolean"
3738
- },
3739
- {}
3740
- ]
3494
+ "type": "boolean"
3741
3495
  },
3742
3496
  "webHidden": {
3743
- "oneOf": [
3744
- {
3745
- "type": "boolean"
3746
- },
3747
- {}
3748
- ]
3497
+ "type": "boolean"
3749
3498
  },
3750
3499
  "specVanish": {
3751
- "oneOf": [
3752
- {
3753
- "type": "boolean"
3754
- },
3755
- {}
3756
- ]
3500
+ "type": "boolean"
3757
3501
  },
3758
3502
  "rtl": {
3759
- "oneOf": [
3760
- {
3761
- "type": "boolean"
3762
- },
3763
- {}
3764
- ]
3503
+ "type": "boolean"
3765
3504
  },
3766
3505
  "cs": {
3767
- "oneOf": [
3768
- {
3769
- "type": "boolean"
3770
- },
3771
- {}
3772
- ]
3506
+ "type": "boolean"
3773
3507
  },
3774
3508
  "bCs": {
3775
- "oneOf": [
3776
- {
3777
- "type": "boolean"
3778
- },
3779
- {}
3780
- ]
3509
+ "type": "boolean"
3781
3510
  },
3782
3511
  "iCs": {
3783
- "oneOf": [
3784
- {
3785
- "type": "boolean"
3786
- },
3787
- {}
3788
- ]
3512
+ "type": "boolean"
3789
3513
  },
3790
3514
  "eastAsianLayout": {
3791
- "oneOf": [
3792
- {
3793
- "type": "object",
3794
- "properties": {
3795
- "id": {
3796
- "oneOf": [
3797
- {
3798
- "type": "string"
3799
- },
3800
- {}
3801
- ]
3802
- },
3803
- "combine": {
3804
- "oneOf": [
3805
- {
3806
- "type": "boolean"
3807
- },
3808
- {}
3809
- ]
3810
- },
3811
- "combineBrackets": {
3812
- "oneOf": [
3813
- {
3814
- "type": "string"
3815
- },
3816
- {}
3817
- ]
3818
- },
3819
- "vert": {
3820
- "oneOf": [
3821
- {
3822
- "type": "boolean"
3823
- },
3824
- {}
3825
- ]
3826
- },
3827
- "vertCompress": {
3828
- "oneOf": [
3829
- {
3830
- "type": "boolean"
3831
- },
3832
- {}
3833
- ]
3834
- }
3835
- }
3515
+ "type": "object",
3516
+ "properties": {
3517
+ "id": {
3518
+ "type": "string"
3836
3519
  },
3837
- {}
3838
- ]
3839
- },
3840
- "em": {
3841
- "oneOf": [
3842
- {
3520
+ "combine": {
3521
+ "type": "boolean"
3522
+ },
3523
+ "combineBrackets": {
3843
3524
  "type": "string"
3844
3525
  },
3845
- {}
3846
- ]
3526
+ "vert": {
3527
+ "type": "boolean"
3528
+ },
3529
+ "vertCompress": {
3530
+ "type": "boolean"
3531
+ }
3532
+ }
3533
+ },
3534
+ "em": {
3535
+ "type": "string"
3847
3536
  },
3848
3537
  "fitText": {
3849
- "oneOf": [
3850
- {
3851
- "type": "object",
3852
- "properties": {
3853
- "val": {
3854
- "oneOf": [
3855
- {
3856
- "type": "number"
3857
- },
3858
- {}
3859
- ]
3860
- },
3861
- "id": {
3862
- "oneOf": [
3863
- {
3864
- "type": "string"
3865
- },
3866
- {}
3867
- ]
3868
- }
3869
- }
3538
+ "type": "object",
3539
+ "properties": {
3540
+ "val": {
3541
+ "type": "number"
3870
3542
  },
3871
- {}
3872
- ]
3543
+ "id": {
3544
+ "type": "string"
3545
+ }
3546
+ }
3873
3547
  },
3874
3548
  "snapToGrid": {
3875
- "oneOf": [
3876
- {
3877
- "type": "boolean"
3878
- },
3879
- {}
3880
- ]
3549
+ "type": "boolean"
3881
3550
  },
3882
3551
  "lang": {
3883
- "oneOf": [
3884
- {
3885
- "type": "object",
3886
- "properties": {
3887
- "val": {
3888
- "oneOf": [
3889
- {
3890
- "type": "string"
3891
- },
3892
- {}
3893
- ]
3894
- },
3895
- "eastAsia": {
3896
- "oneOf": [
3897
- {
3898
- "type": "string"
3899
- },
3900
- {}
3901
- ]
3902
- },
3903
- "bidi": {
3904
- "oneOf": [
3905
- {
3906
- "type": "string"
3907
- },
3908
- {}
3909
- ]
3910
- }
3911
- }
3552
+ "type": "object",
3553
+ "properties": {
3554
+ "val": {
3555
+ "type": "string"
3912
3556
  },
3913
- {}
3914
- ]
3557
+ "eastAsia": {
3558
+ "type": "string"
3559
+ },
3560
+ "bidi": {
3561
+ "type": "string"
3562
+ }
3563
+ }
3915
3564
  },
3916
3565
  "oMath": {
3917
- "oneOf": [
3918
- {
3919
- "type": "boolean"
3920
- },
3921
- {}
3922
- ]
3566
+ "type": "boolean"
3923
3567
  },
3924
3568
  "rStyle": {
3925
- "oneOf": [
3926
- {
3927
- "type": "string"
3928
- },
3929
- {}
3930
- ]
3569
+ "type": "string"
3931
3570
  },
3932
3571
  "rFonts": {
3933
- "oneOf": [
3934
- {
3935
- "type": "object",
3936
- "properties": {
3937
- "ascii": {
3938
- "oneOf": [
3939
- {
3940
- "type": "string"
3941
- },
3942
- {}
3943
- ]
3944
- },
3945
- "hAnsi": {
3946
- "oneOf": [
3947
- {
3948
- "type": "string"
3949
- },
3950
- {}
3951
- ]
3952
- },
3953
- "eastAsia": {
3954
- "oneOf": [
3955
- {
3956
- "type": "string"
3957
- },
3958
- {}
3959
- ]
3960
- },
3961
- "cs": {
3962
- "oneOf": [
3963
- {
3964
- "type": "string"
3965
- },
3966
- {}
3967
- ]
3968
- },
3969
- "asciiTheme": {
3970
- "oneOf": [
3971
- {
3972
- "type": "string"
3973
- },
3974
- {}
3975
- ]
3976
- },
3977
- "hAnsiTheme": {
3978
- "oneOf": [
3979
- {
3980
- "type": "string"
3981
- },
3982
- {}
3983
- ]
3984
- },
3985
- "eastAsiaTheme": {
3986
- "oneOf": [
3987
- {
3988
- "type": "string"
3989
- },
3990
- {}
3991
- ]
3992
- },
3993
- "csTheme": {
3994
- "oneOf": [
3995
- {
3996
- "type": "string"
3997
- },
3998
- {}
3999
- ]
4000
- },
4001
- "hint": {
4002
- "oneOf": [
4003
- {
4004
- "type": "string"
4005
- },
4006
- {}
4007
- ]
4008
- }
4009
- }
3572
+ "type": "object",
3573
+ "properties": {
3574
+ "ascii": {
3575
+ "type": "string"
4010
3576
  },
4011
- {}
4012
- ]
3577
+ "hAnsi": {
3578
+ "type": "string"
3579
+ },
3580
+ "eastAsia": {
3581
+ "type": "string"
3582
+ },
3583
+ "cs": {
3584
+ "type": "string"
3585
+ },
3586
+ "asciiTheme": {
3587
+ "type": "string"
3588
+ },
3589
+ "hAnsiTheme": {
3590
+ "type": "string"
3591
+ },
3592
+ "eastAsiaTheme": {
3593
+ "type": "string"
3594
+ },
3595
+ "csTheme": {
3596
+ "type": "string"
3597
+ },
3598
+ "hint": {
3599
+ "type": "string"
3600
+ }
3601
+ }
4013
3602
  },
4014
3603
  "fontSizeCs": {
4015
- "oneOf": [
4016
- {
4017
- "type": "number"
4018
- },
4019
- {}
4020
- ]
3604
+ "type": "number"
4021
3605
  },
4022
3606
  "ligatures": {
4023
- "oneOf": [
4024
- {
4025
- "type": "string"
4026
- },
4027
- {}
4028
- ]
3607
+ "type": "string"
4029
3608
  },
4030
3609
  "numForm": {
4031
- "oneOf": [
4032
- {
4033
- "type": "string"
4034
- },
4035
- {}
4036
- ]
3610
+ "type": "string"
4037
3611
  },
4038
3612
  "numSpacing": {
4039
- "oneOf": [
4040
- {
4041
- "type": "string"
4042
- },
4043
- {}
4044
- ]
3613
+ "type": "string"
4045
3614
  },
4046
3615
  "stylisticSets": {
4047
- "oneOf": [
4048
- {
4049
- "type": "array",
4050
- "items": {
4051
- "type": "object",
4052
- "properties": {
4053
- "id": {
4054
- "type": "number"
4055
- },
4056
- "val": {
4057
- "type": "boolean"
4058
- }
4059
- },
4060
- "required": [
4061
- "id"
4062
- ]
3616
+ "type": "array",
3617
+ "items": {
3618
+ "type": "object",
3619
+ "properties": {
3620
+ "id": {
3621
+ "type": "number"
3622
+ },
3623
+ "val": {
3624
+ "type": "boolean"
4063
3625
  }
4064
3626
  },
4065
- {}
4066
- ]
3627
+ "required": [
3628
+ "id"
3629
+ ]
3630
+ }
4067
3631
  },
4068
3632
  "contextualAlternates": {
4069
- "oneOf": [
4070
- {
4071
- "type": "boolean"
4072
- },
4073
- {}
4074
- ]
3633
+ "type": "boolean"
4075
3634
  }
4076
3635
  }
4077
3636
  }
@@ -4112,19 +3671,23 @@
4112
3671
  "properties": {
4113
3672
  "type": {
4114
3673
  "const": "text",
3674
+ "description": "Must be 'text' for text pattern search.",
4115
3675
  "type": "string"
4116
3676
  },
4117
3677
  "pattern": {
4118
- "type": "string"
3678
+ "type": "string",
3679
+ "description": "Text or regex pattern to match."
4119
3680
  },
4120
3681
  "mode": {
3682
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
4121
3683
  "enum": [
4122
3684
  "contains",
4123
3685
  "regex"
4124
3686
  ]
4125
3687
  },
4126
3688
  "caseSensitive": {
4127
- "type": "boolean"
3689
+ "type": "boolean",
3690
+ "description": "Case-sensitive matching. Default: false."
4128
3691
  }
4129
3692
  },
4130
3693
  "required": [
@@ -4137,9 +3700,11 @@
4137
3700
  "properties": {
4138
3701
  "type": {
4139
3702
  "const": "node",
3703
+ "description": "Must be 'node' for node type search.",
4140
3704
  "type": "string"
4141
3705
  },
4142
3706
  "nodeType": {
3707
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
4143
3708
  "enum": [
4144
3709
  "paragraph",
4145
3710
  "heading",
@@ -4166,6 +3731,7 @@
4166
3731
  ]
4167
3732
  },
4168
3733
  "kind": {
3734
+ "description": "Filter: 'block' or 'inline'.",
4169
3735
  "enum": [
4170
3736
  "block",
4171
3737
  "inline"
@@ -4234,15 +3800,18 @@
4234
3800
  ]
4235
3801
  }
4236
3802
  ]
4237
- }
3803
+ },
3804
+ "description": "Ordered array of mutation steps. Each step needs 'op' (text.rewrite, text.insert, text.delete, format.apply, or assert) and a 'where' targeting clause."
4238
3805
  },
4239
3806
  "force": {
4240
- "type": "boolean"
3807
+ "type": "boolean",
3808
+ "description": "Bypass confirmation checks."
4241
3809
  }
4242
3810
  },
4243
3811
  "required": [
4244
3812
  "action",
4245
3813
  "atomic",
3814
+ "changeMode",
4246
3815
  "steps"
4247
3816
  ],
4248
3817
  "additionalProperties": false