@superdoc-dev/sdk 1.0.0-alpha.47 → 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/tools.vercel.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": [
@@ -56,26 +59,28 @@
56
59
  "description": "The action to perform. One of: delete, insert, redo, replace, undo."
57
60
  },
58
61
  "doc": {
59
- "type": "string"
62
+ "type": "string",
63
+ "description": "Document path. Optional when a session is already open."
60
64
  },
61
65
  "sessionId": {
62
- "type": "string"
66
+ "type": "string",
67
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
63
68
  },
64
69
  "force": {
65
- "type": "boolean"
66
- },
67
- "expectedRevision": {
68
- "type": "number"
70
+ "type": "boolean",
71
+ "description": "Bypass confirmation checks."
69
72
  },
70
73
  "changeMode": {
71
74
  "type": "string",
72
75
  "enum": [
73
76
  "direct",
74
77
  "tracked"
75
- ]
78
+ ],
79
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
76
80
  },
77
81
  "dryRun": {
78
- "type": "boolean"
82
+ "type": "boolean",
83
+ "description": "Preview the result without applying changes."
79
84
  },
80
85
  "target": {
81
86
  "oneOf": [
@@ -141,13 +146,16 @@
141
146
  "nodeId"
142
147
  ]
143
148
  }
144
- ]
149
+ ],
150
+ "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}."
145
151
  },
146
152
  "value": {
147
- "type": "string"
153
+ "type": "string",
154
+ "description": "Text content to insert."
148
155
  },
149
156
  "type": {
150
157
  "type": "string",
158
+ "description": "Content format: 'text' (default), 'markdown', or 'html'.",
151
159
  "enum": [
152
160
  "text",
153
161
  "markdown",
@@ -167,10 +175,12 @@
167
175
  "properties": {}
168
176
  }
169
177
  }
170
- ]
178
+ ],
179
+ "description": "Document fragment to insert (structured content)."
171
180
  },
172
181
  "placement": {
173
182
  "type": "string",
183
+ "description": "Where to place content relative to target: 'before', 'after', 'insideStart', or 'insideEnd'.",
174
184
  "enum": [
175
185
  "before",
176
186
  "after",
@@ -187,32 +197,40 @@
187
197
  "allow"
188
198
  ]
189
199
  }
190
- }
200
+ },
201
+ "description": "Controls nesting behavior. tables: 'allow' permits inserting tables inside other tables."
191
202
  },
192
203
  "blockId": {
193
- "type": "string"
204
+ "type": "string",
205
+ "description": "Block ID of the target paragraph."
194
206
  },
195
207
  "offset": {
196
- "type": "number"
208
+ "type": "number",
209
+ "description": "Character offset within the block for insertion."
197
210
  },
198
211
  "text": {
199
- "type": "string"
212
+ "type": "string",
213
+ "description": "Replacement text content."
200
214
  },
201
215
  "ref": {
202
- "type": "string"
216
+ "type": "string",
217
+ "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."
203
218
  },
204
219
  "start": {
205
- "type": "number"
220
+ "type": "number",
221
+ "description": "Start offset within the block (character index)."
206
222
  },
207
223
  "end": {
208
- "type": "number"
224
+ "type": "number",
225
+ "description": "End offset within the block (character index)."
209
226
  },
210
227
  "behavior": {
211
228
  "type": "string",
212
229
  "enum": [
213
230
  "selection",
214
231
  "exact"
215
- ]
232
+ ],
233
+ "description": "Delete behavior: 'selection' (default) or 'exact'."
216
234
  }
217
235
  },
218
236
  "required": [
@@ -235,33 +253,36 @@
235
253
  "enum": [
236
254
  "inline",
237
255
  "set_alignment",
256
+ "set_direction",
238
257
  "set_indentation",
239
258
  "set_spacing",
240
259
  "set_style"
241
260
  ],
242
- "description": "The action to perform. One of: inline, set_alignment, set_indentation, set_spacing, set_style."
261
+ "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
243
262
  },
244
263
  "doc": {
245
- "type": "string"
264
+ "type": "string",
265
+ "description": "Document path. Optional when a session is already open."
246
266
  },
247
267
  "sessionId": {
248
- "type": "string"
268
+ "type": "string",
269
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
249
270
  },
250
271
  "force": {
251
- "type": "boolean"
252
- },
253
- "expectedRevision": {
254
- "type": "number"
272
+ "type": "boolean",
273
+ "description": "Bypass confirmation checks."
255
274
  },
256
275
  "changeMode": {
257
276
  "type": "string",
258
277
  "enum": [
259
278
  "direct",
260
279
  "tracked"
261
- ]
280
+ ],
281
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
262
282
  },
263
283
  "dryRun": {
264
- "type": "boolean"
284
+ "type": "boolean",
285
+ "description": "Preview the result without applying changes."
265
286
  },
266
287
  "target": {
267
288
  "type": "object",
@@ -339,7 +360,8 @@
339
360
  "edge"
340
361
  ]
341
362
  }
342
- ]
363
+ ],
364
+ "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."
343
365
  },
344
366
  "end": {
345
367
  "oneOf": [
@@ -410,645 +432,297 @@
410
432
  "edge"
411
433
  ]
412
434
  }
413
- ]
435
+ ],
436
+ "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."
414
437
  }
415
438
  },
416
439
  "required": [
417
440
  "kind",
418
441
  "start",
419
442
  "end"
420
- ]
443
+ ],
444
+ "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'."
421
445
  },
422
446
  "inline": {
423
447
  "type": "object",
424
448
  "properties": {
425
449
  "bold": {
426
- "oneOf": [
427
- {
428
- "type": "boolean"
429
- },
430
- {}
431
- ]
450
+ "type": "boolean"
432
451
  },
433
452
  "italic": {
434
- "oneOf": [
435
- {
436
- "type": "boolean"
437
- },
438
- {}
439
- ]
453
+ "type": "boolean"
440
454
  },
441
455
  "strike": {
442
- "oneOf": [
443
- {
444
- "type": "boolean"
445
- },
446
- {}
447
- ]
456
+ "type": "boolean"
448
457
  },
449
458
  "underline": {
450
459
  "oneOf": [
451
460
  {
452
461
  "type": "boolean"
453
462
  },
454
- {},
455
463
  {
456
464
  "type": "object",
457
465
  "properties": {
458
466
  "style": {
459
- "oneOf": [
460
- {
461
- "type": "string"
462
- },
463
- {}
464
- ]
467
+ "type": "string"
465
468
  },
466
469
  "color": {
467
- "oneOf": [
468
- {
469
- "type": "string"
470
- },
471
- {}
472
- ]
470
+ "type": "string"
473
471
  },
474
472
  "themeColor": {
475
- "oneOf": [
476
- {
477
- "type": "string"
478
- },
479
- {}
480
- ]
473
+ "type": "string"
481
474
  }
482
475
  }
483
476
  }
484
477
  ]
485
478
  },
486
479
  "highlight": {
487
- "oneOf": [
488
- {
489
- "type": "string"
490
- },
491
- {}
492
- ]
480
+ "type": "string"
493
481
  },
494
482
  "color": {
495
- "oneOf": [
496
- {
497
- "type": "string"
498
- },
499
- {}
500
- ]
483
+ "type": "string"
501
484
  },
502
485
  "fontSize": {
503
- "oneOf": [
504
- {
505
- "type": "number"
506
- },
507
- {}
508
- ]
486
+ "type": "number"
509
487
  },
510
488
  "fontFamily": {
511
- "oneOf": [
512
- {
513
- "type": "string"
514
- },
515
- {}
516
- ]
489
+ "type": "string"
517
490
  },
518
491
  "letterSpacing": {
519
- "oneOf": [
520
- {
521
- "type": "number"
522
- },
523
- {}
524
- ]
492
+ "type": "number"
525
493
  },
526
494
  "vertAlign": {
527
- "oneOf": [
528
- {
529
- "enum": [
530
- "superscript",
531
- "subscript",
532
- "baseline"
533
- ]
534
- },
535
- {}
495
+ "enum": [
496
+ "superscript",
497
+ "subscript",
498
+ "baseline"
536
499
  ]
537
500
  },
538
501
  "position": {
539
- "oneOf": [
540
- {
541
- "type": "number"
542
- },
543
- {}
544
- ]
502
+ "type": "number"
545
503
  },
546
504
  "dstrike": {
547
- "oneOf": [
548
- {
549
- "type": "boolean"
550
- },
551
- {}
552
- ]
505
+ "type": "boolean"
553
506
  },
554
507
  "smallCaps": {
555
- "oneOf": [
556
- {
557
- "type": "boolean"
558
- },
559
- {}
560
- ]
508
+ "type": "boolean"
561
509
  },
562
510
  "caps": {
563
- "oneOf": [
564
- {
565
- "type": "boolean"
566
- },
567
- {}
568
- ]
511
+ "type": "boolean"
569
512
  },
570
513
  "shading": {
571
- "oneOf": [
572
- {
573
- "type": "object",
574
- "properties": {
575
- "fill": {
576
- "oneOf": [
577
- {
578
- "type": "string"
579
- },
580
- {}
581
- ]
582
- },
583
- "color": {
584
- "oneOf": [
585
- {
586
- "type": "string"
587
- },
588
- {}
589
- ]
590
- },
591
- "val": {
592
- "oneOf": [
593
- {
594
- "type": "string"
595
- },
596
- {}
597
- ]
598
- }
599
- }
514
+ "type": "object",
515
+ "properties": {
516
+ "fill": {
517
+ "type": "string"
600
518
  },
601
- {}
602
- ]
519
+ "color": {
520
+ "type": "string"
521
+ },
522
+ "val": {
523
+ "type": "string"
524
+ }
525
+ }
603
526
  },
604
527
  "border": {
605
- "oneOf": [
606
- {
607
- "type": "object",
608
- "properties": {
609
- "val": {
610
- "oneOf": [
611
- {
612
- "type": "string"
613
- },
614
- {}
615
- ]
616
- },
617
- "sz": {
618
- "oneOf": [
619
- {
620
- "type": "number"
621
- },
622
- {}
623
- ]
624
- },
625
- "color": {
626
- "oneOf": [
627
- {
628
- "type": "string"
629
- },
630
- {}
631
- ]
632
- },
633
- "space": {
634
- "oneOf": [
635
- {
636
- "type": "number"
637
- },
638
- {}
639
- ]
640
- }
641
- }
528
+ "type": "object",
529
+ "properties": {
530
+ "val": {
531
+ "type": "string"
642
532
  },
643
- {}
644
- ]
533
+ "sz": {
534
+ "type": "number"
535
+ },
536
+ "color": {
537
+ "type": "string"
538
+ },
539
+ "space": {
540
+ "type": "number"
541
+ }
542
+ }
645
543
  },
646
544
  "outline": {
647
- "oneOf": [
648
- {
649
- "type": "boolean"
650
- },
651
- {}
652
- ]
545
+ "type": "boolean"
653
546
  },
654
547
  "shadow": {
655
- "oneOf": [
656
- {
657
- "type": "boolean"
658
- },
659
- {}
660
- ]
548
+ "type": "boolean"
661
549
  },
662
550
  "emboss": {
663
- "oneOf": [
664
- {
665
- "type": "boolean"
666
- },
667
- {}
668
- ]
551
+ "type": "boolean"
669
552
  },
670
553
  "imprint": {
671
- "oneOf": [
672
- {
673
- "type": "boolean"
674
- },
675
- {}
676
- ]
554
+ "type": "boolean"
677
555
  },
678
556
  "charScale": {
679
- "oneOf": [
680
- {
681
- "type": "number"
682
- },
683
- {}
684
- ]
557
+ "type": "number"
685
558
  },
686
559
  "kerning": {
687
- "oneOf": [
688
- {
689
- "type": "number"
690
- },
691
- {}
692
- ]
560
+ "type": "number"
693
561
  },
694
562
  "vanish": {
695
- "oneOf": [
696
- {
697
- "type": "boolean"
698
- },
699
- {}
700
- ]
563
+ "type": "boolean"
701
564
  },
702
565
  "webHidden": {
703
- "oneOf": [
704
- {
705
- "type": "boolean"
706
- },
707
- {}
708
- ]
566
+ "type": "boolean"
709
567
  },
710
568
  "specVanish": {
711
- "oneOf": [
712
- {
713
- "type": "boolean"
714
- },
715
- {}
716
- ]
569
+ "type": "boolean"
717
570
  },
718
571
  "rtl": {
719
- "oneOf": [
720
- {
721
- "type": "boolean"
722
- },
723
- {}
724
- ]
572
+ "type": "boolean"
725
573
  },
726
574
  "cs": {
727
- "oneOf": [
728
- {
729
- "type": "boolean"
730
- },
731
- {}
732
- ]
575
+ "type": "boolean"
733
576
  },
734
577
  "bCs": {
735
- "oneOf": [
736
- {
737
- "type": "boolean"
738
- },
739
- {}
740
- ]
578
+ "type": "boolean"
741
579
  },
742
580
  "iCs": {
743
- "oneOf": [
744
- {
581
+ "type": "boolean"
582
+ },
583
+ "eastAsianLayout": {
584
+ "type": "object",
585
+ "properties": {
586
+ "id": {
587
+ "type": "string"
588
+ },
589
+ "combine": {
745
590
  "type": "boolean"
746
591
  },
747
- {}
748
- ]
749
- },
750
- "eastAsianLayout": {
751
- "oneOf": [
752
- {
753
- "type": "object",
754
- "properties": {
755
- "id": {
756
- "oneOf": [
757
- {
758
- "type": "string"
759
- },
760
- {}
761
- ]
762
- },
763
- "combine": {
764
- "oneOf": [
765
- {
766
- "type": "boolean"
767
- },
768
- {}
769
- ]
770
- },
771
- "combineBrackets": {
772
- "oneOf": [
773
- {
774
- "type": "string"
775
- },
776
- {}
777
- ]
778
- },
779
- "vert": {
780
- "oneOf": [
781
- {
782
- "type": "boolean"
783
- },
784
- {}
785
- ]
786
- },
787
- "vertCompress": {
788
- "oneOf": [
789
- {
790
- "type": "boolean"
791
- },
792
- {}
793
- ]
794
- }
795
- }
796
- },
797
- {}
798
- ]
592
+ "combineBrackets": {
593
+ "type": "string"
594
+ },
595
+ "vert": {
596
+ "type": "boolean"
597
+ },
598
+ "vertCompress": {
599
+ "type": "boolean"
600
+ }
601
+ }
799
602
  },
800
603
  "em": {
801
- "oneOf": [
802
- {
803
- "type": "string"
804
- },
805
- {}
806
- ]
604
+ "type": "string"
807
605
  },
808
606
  "fitText": {
809
- "oneOf": [
810
- {
811
- "type": "object",
812
- "properties": {
813
- "val": {
814
- "oneOf": [
815
- {
816
- "type": "number"
817
- },
818
- {}
819
- ]
820
- },
821
- "id": {
822
- "oneOf": [
823
- {
824
- "type": "string"
825
- },
826
- {}
827
- ]
828
- }
829
- }
607
+ "type": "object",
608
+ "properties": {
609
+ "val": {
610
+ "type": "number"
830
611
  },
831
- {}
832
- ]
612
+ "id": {
613
+ "type": "string"
614
+ }
615
+ }
833
616
  },
834
617
  "snapToGrid": {
835
- "oneOf": [
836
- {
837
- "type": "boolean"
838
- },
839
- {}
840
- ]
618
+ "type": "boolean"
841
619
  },
842
620
  "lang": {
843
- "oneOf": [
844
- {
845
- "type": "object",
846
- "properties": {
847
- "val": {
848
- "oneOf": [
849
- {
850
- "type": "string"
851
- },
852
- {}
853
- ]
854
- },
855
- "eastAsia": {
856
- "oneOf": [
857
- {
858
- "type": "string"
859
- },
860
- {}
861
- ]
862
- },
863
- "bidi": {
864
- "oneOf": [
865
- {
866
- "type": "string"
867
- },
868
- {}
869
- ]
870
- }
871
- }
621
+ "type": "object",
622
+ "properties": {
623
+ "val": {
624
+ "type": "string"
872
625
  },
873
- {}
874
- ]
626
+ "eastAsia": {
627
+ "type": "string"
628
+ },
629
+ "bidi": {
630
+ "type": "string"
631
+ }
632
+ }
875
633
  },
876
634
  "oMath": {
877
- "oneOf": [
878
- {
879
- "type": "boolean"
880
- },
881
- {}
882
- ]
635
+ "type": "boolean"
883
636
  },
884
637
  "rStyle": {
885
- "oneOf": [
886
- {
887
- "type": "string"
888
- },
889
- {}
890
- ]
638
+ "type": "string"
891
639
  },
892
640
  "rFonts": {
893
- "oneOf": [
894
- {
895
- "type": "object",
896
- "properties": {
897
- "ascii": {
898
- "oneOf": [
899
- {
900
- "type": "string"
901
- },
902
- {}
903
- ]
904
- },
905
- "hAnsi": {
906
- "oneOf": [
907
- {
908
- "type": "string"
909
- },
910
- {}
911
- ]
912
- },
913
- "eastAsia": {
914
- "oneOf": [
915
- {
916
- "type": "string"
917
- },
918
- {}
919
- ]
920
- },
921
- "cs": {
922
- "oneOf": [
923
- {
924
- "type": "string"
925
- },
926
- {}
927
- ]
928
- },
929
- "asciiTheme": {
930
- "oneOf": [
931
- {
932
- "type": "string"
933
- },
934
- {}
935
- ]
936
- },
937
- "hAnsiTheme": {
938
- "oneOf": [
939
- {
940
- "type": "string"
941
- },
942
- {}
943
- ]
944
- },
945
- "eastAsiaTheme": {
946
- "oneOf": [
947
- {
948
- "type": "string"
949
- },
950
- {}
951
- ]
952
- },
953
- "csTheme": {
954
- "oneOf": [
955
- {
956
- "type": "string"
957
- },
958
- {}
959
- ]
960
- },
961
- "hint": {
962
- "oneOf": [
963
- {
964
- "type": "string"
965
- },
966
- {}
967
- ]
968
- }
969
- }
641
+ "type": "object",
642
+ "properties": {
643
+ "ascii": {
644
+ "type": "string"
970
645
  },
971
- {}
972
- ]
646
+ "hAnsi": {
647
+ "type": "string"
648
+ },
649
+ "eastAsia": {
650
+ "type": "string"
651
+ },
652
+ "cs": {
653
+ "type": "string"
654
+ },
655
+ "asciiTheme": {
656
+ "type": "string"
657
+ },
658
+ "hAnsiTheme": {
659
+ "type": "string"
660
+ },
661
+ "eastAsiaTheme": {
662
+ "type": "string"
663
+ },
664
+ "csTheme": {
665
+ "type": "string"
666
+ },
667
+ "hint": {
668
+ "type": "string"
669
+ }
670
+ }
973
671
  },
974
672
  "fontSizeCs": {
975
- "oneOf": [
976
- {
977
- "type": "number"
978
- },
979
- {}
980
- ]
673
+ "type": "number"
981
674
  },
982
675
  "ligatures": {
983
- "oneOf": [
984
- {
985
- "type": "string"
986
- },
987
- {}
988
- ]
676
+ "type": "string"
989
677
  },
990
678
  "numForm": {
991
- "oneOf": [
992
- {
993
- "type": "string"
994
- },
995
- {}
996
- ]
679
+ "type": "string"
997
680
  },
998
681
  "numSpacing": {
999
- "oneOf": [
1000
- {
1001
- "type": "string"
1002
- },
1003
- {}
1004
- ]
682
+ "type": "string"
1005
683
  },
1006
684
  "stylisticSets": {
1007
- "oneOf": [
1008
- {
1009
- "type": "array",
1010
- "items": {
1011
- "type": "object",
1012
- "properties": {
1013
- "id": {
1014
- "type": "number"
1015
- },
1016
- "val": {
1017
- "type": "boolean"
1018
- }
1019
- },
1020
- "required": [
1021
- "id"
1022
- ]
685
+ "type": "array",
686
+ "items": {
687
+ "type": "object",
688
+ "properties": {
689
+ "id": {
690
+ "type": "number"
691
+ },
692
+ "val": {
693
+ "type": "boolean"
1023
694
  }
1024
695
  },
1025
- {}
1026
- ]
696
+ "required": [
697
+ "id"
698
+ ]
699
+ }
1027
700
  },
1028
701
  "contextualAlternates": {
1029
- "oneOf": [
1030
- {
1031
- "type": "boolean"
1032
- },
1033
- {}
1034
- ]
702
+ "type": "boolean"
1035
703
  }
1036
- }
704
+ },
705
+ "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."
1037
706
  },
1038
707
  "ref": {
1039
- "type": "string"
708
+ "type": "string",
709
+ "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."
1040
710
  },
1041
711
  "blockId": {
1042
- "type": "string"
712
+ "type": "string",
713
+ "description": "Block ID of the target paragraph."
1043
714
  },
1044
715
  "start": {
1045
- "type": "number"
716
+ "type": "number",
717
+ "description": "Start offset within the block (character index)."
1046
718
  },
1047
719
  "end": {
1048
- "type": "number"
720
+ "type": "number",
721
+ "description": "End offset within the block (character index)."
1049
722
  },
1050
723
  "styleId": {
1051
- "type": "string"
724
+ "type": "string",
725
+ "description": "Required for action 'set_style'."
1052
726
  },
1053
727
  "alignment": {
1054
728
  "type": "string",
@@ -1057,36 +731,60 @@
1057
731
  "center",
1058
732
  "right",
1059
733
  "justify"
1060
- ]
734
+ ],
735
+ "description": "Required for action 'set_alignment'."
1061
736
  },
1062
737
  "left": {
1063
- "type": "number"
738
+ "type": "number",
739
+ "description": "Left indentation in twips (1440 = 1 inch)."
1064
740
  },
1065
741
  "right": {
1066
- "type": "number"
742
+ "type": "number",
743
+ "description": "Right indentation in twips (1440 = 1 inch)."
1067
744
  },
1068
745
  "firstLine": {
1069
- "type": "number"
746
+ "type": "number",
747
+ "description": "First line indent in twips. Cannot be combined with hanging."
1070
748
  },
1071
749
  "hanging": {
1072
- "type": "number"
750
+ "type": "number",
751
+ "description": "Hanging indent in twips. Cannot be combined with firstLine."
1073
752
  },
1074
753
  "before": {
1075
- "type": "number"
754
+ "type": "number",
755
+ "description": "Space before paragraph in twips (20 twips = 1pt)."
1076
756
  },
1077
757
  "after": {
1078
- "type": "number"
758
+ "type": "number",
759
+ "description": "Space after paragraph in twips (20 twips = 1pt)."
1079
760
  },
1080
761
  "line": {
1081
- "type": "number"
762
+ "type": "number",
763
+ "description": "Line spacing value. Meaning depends on lineRule. Must be provided together with lineRule."
1082
764
  },
1083
765
  "lineRule": {
1084
766
  "type": "string",
767
+ "description": "Line spacing rule. Required when 'line' is set.",
1085
768
  "enum": [
1086
769
  "auto",
1087
770
  "exact",
1088
771
  "atLeast"
1089
772
  ]
773
+ },
774
+ "direction": {
775
+ "type": "string",
776
+ "enum": [
777
+ "ltr",
778
+ "rtl"
779
+ ],
780
+ "description": "Required for action 'set_direction'."
781
+ },
782
+ "alignmentPolicy": {
783
+ "type": "string",
784
+ "enum": [
785
+ "preserve",
786
+ "matchDirection"
787
+ ]
1090
788
  }
1091
789
  },
1092
790
  "required": [
@@ -1113,26 +811,28 @@
1113
811
  "description": "The action to perform. One of: heading, paragraph."
1114
812
  },
1115
813
  "doc": {
1116
- "type": "string"
814
+ "type": "string",
815
+ "description": "Document path. Optional when a session is already open."
1117
816
  },
1118
817
  "sessionId": {
1119
- "type": "string"
818
+ "type": "string",
819
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1120
820
  },
1121
821
  "force": {
1122
- "type": "boolean"
1123
- },
1124
- "expectedRevision": {
1125
- "type": "number"
822
+ "type": "boolean",
823
+ "description": "Bypass confirmation checks."
1126
824
  },
1127
825
  "changeMode": {
1128
826
  "type": "string",
1129
827
  "enum": [
1130
828
  "direct",
1131
829
  "tracked"
1132
- ]
830
+ ],
831
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1133
832
  },
1134
833
  "dryRun": {
1135
- "type": "boolean"
834
+ "type": "boolean",
835
+ "description": "Preview the result without applying changes."
1136
836
  },
1137
837
  "at": {
1138
838
  "oneOf": [
@@ -1246,16 +946,20 @@
1246
946
  "target"
1247
947
  ]
1248
948
  }
1249
- ]
949
+ ],
950
+ "description": "Position: {kind:'documentEnd'} to append, {kind:'documentStart'} to prepend, or {kind:'before'|'after', target:{kind:'block', nodeType:'...', nodeId:'...'}} for relative placement."
1250
951
  },
1251
952
  "text": {
1252
- "type": "string"
953
+ "type": "string",
954
+ "description": "Paragraph text content."
1253
955
  },
1254
956
  "input": {
1255
- "type": "object"
957
+ "type": "object",
958
+ "description": "Full paragraph input as JSON (alternative to individual text/at params)."
1256
959
  },
1257
960
  "level": {
1258
- "type": "number"
961
+ "type": "number",
962
+ "description": "Heading level (1-6). Required for action 'heading'."
1259
963
  }
1260
964
  },
1261
965
  "required": [
@@ -1287,26 +991,28 @@
1287
991
  "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
1288
992
  },
1289
993
  "doc": {
1290
- "type": "string"
994
+ "type": "string",
995
+ "description": "Document path. Optional when a session is already open."
1291
996
  },
1292
997
  "sessionId": {
1293
- "type": "string"
998
+ "type": "string",
999
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1294
1000
  },
1295
1001
  "force": {
1296
- "type": "boolean"
1297
- },
1298
- "expectedRevision": {
1299
- "type": "number"
1002
+ "type": "boolean",
1003
+ "description": "Bypass confirmation checks."
1300
1004
  },
1301
1005
  "changeMode": {
1302
1006
  "type": "string",
1303
1007
  "enum": [
1304
1008
  "direct",
1305
1009
  "tracked"
1306
- ]
1010
+ ],
1011
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1307
1012
  },
1308
1013
  "dryRun": {
1309
- "type": "boolean"
1014
+ "type": "boolean",
1015
+ "description": "Preview the result without applying changes."
1310
1016
  },
1311
1017
  "target": {
1312
1018
  "type": "object",
@@ -1327,26 +1033,32 @@
1327
1033
  "kind",
1328
1034
  "nodeType",
1329
1035
  "nodeId"
1330
- ]
1036
+ ],
1037
+ "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'."
1331
1038
  },
1332
1039
  "position": {
1333
1040
  "type": "string",
1041
+ "description": "Required. Insert position relative to target: 'before' or 'after'. Required for action 'insert'.",
1334
1042
  "enum": [
1335
1043
  "before",
1336
1044
  "after"
1337
1045
  ]
1338
1046
  },
1339
1047
  "text": {
1340
- "type": "string"
1048
+ "type": "string",
1049
+ "description": "Text content for the new list item."
1341
1050
  },
1342
1051
  "input": {
1343
- "type": "object"
1052
+ "type": "object",
1053
+ "description": "Operation input as JSON object."
1344
1054
  },
1345
1055
  "nodeId": {
1346
- "type": "string"
1056
+ "type": "string",
1057
+ "description": "Node ID of the target list item."
1347
1058
  },
1348
1059
  "mode": {
1349
1060
  "type": "string",
1061
+ "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'.",
1350
1062
  "enum": [
1351
1063
  "empty",
1352
1064
  "fromParagraphs"
@@ -1371,46 +1083,168 @@
1371
1083
  "kind",
1372
1084
  "nodeType",
1373
1085
  "nodeId"
1374
- ]
1086
+ ],
1087
+ "description": "Required when mode is 'empty'. The paragraph to create the list at. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
1375
1088
  },
1376
1089
  "kind": {
1377
1090
  "type": "string",
1091
+ "description": "List type: 'bullet' for bullet points, 'ordered' for numbered lists. Required for action 'set_type'.",
1378
1092
  "enum": [
1379
1093
  "ordered",
1380
1094
  "bullet"
1381
1095
  ]
1382
1096
  },
1383
1097
  "level": {
1384
- "type": "number"
1098
+ "type": "number",
1099
+ "description": "List nesting level (0-8). 0 is the top level. Required for action 'set_level'."
1385
1100
  },
1386
- "continuity": {
1101
+ "preset": {
1387
1102
  "type": "string",
1103
+ "description": "Predefined list style preset. Overrides 'kind' with a specific numbering or bullet format.",
1388
1104
  "enum": [
1389
- "preserve",
1390
- "none"
1105
+ "decimal",
1106
+ "decimalParenthesis",
1107
+ "lowerLetter",
1108
+ "upperLetter",
1109
+ "lowerRoman",
1110
+ "upperRoman",
1111
+ "disc",
1112
+ "circle",
1113
+ "square",
1114
+ "dash"
1391
1115
  ]
1392
- }
1393
- },
1394
- "required": [
1395
- "action"
1396
- ],
1397
- "additionalProperties": false
1398
- }
1399
- }
1400
- },
1401
- {
1402
- "type": "function",
1403
- "function": {
1404
- "name": "superdoc_comment",
1405
- "description": "Comment threads — create, edit, delete",
1406
- "parameters": {
1407
- "type": "object",
1408
- "properties": {
1409
- "action": {
1410
- "type": "string",
1411
- "enum": [
1412
- "create",
1413
- "delete",
1116
+ },
1117
+ "style": {
1118
+ "type": "object",
1119
+ "properties": {
1120
+ "version": {
1121
+ "const": 1,
1122
+ "type": "number"
1123
+ },
1124
+ "levels": {
1125
+ "type": "array",
1126
+ "items": {
1127
+ "type": "object",
1128
+ "properties": {
1129
+ "level": {
1130
+ "type": "number"
1131
+ },
1132
+ "numFmt": {
1133
+ "type": "string"
1134
+ },
1135
+ "lvlText": {
1136
+ "type": "string"
1137
+ },
1138
+ "start": {
1139
+ "type": "number"
1140
+ },
1141
+ "alignment": {
1142
+ "enum": [
1143
+ "left",
1144
+ "center",
1145
+ "right"
1146
+ ]
1147
+ },
1148
+ "indents": {
1149
+ "type": "object",
1150
+ "properties": {
1151
+ "left": {
1152
+ "type": "number"
1153
+ },
1154
+ "hanging": {
1155
+ "type": "number"
1156
+ },
1157
+ "firstLine": {
1158
+ "type": "number"
1159
+ }
1160
+ }
1161
+ },
1162
+ "trailingCharacter": {
1163
+ "enum": [
1164
+ "tab",
1165
+ "space",
1166
+ "nothing"
1167
+ ]
1168
+ },
1169
+ "markerFont": {
1170
+ "type": "string"
1171
+ },
1172
+ "pictureBulletId": {
1173
+ "type": "number"
1174
+ },
1175
+ "tabStopAt": {}
1176
+ },
1177
+ "required": [
1178
+ "level"
1179
+ ]
1180
+ }
1181
+ }
1182
+ },
1183
+ "required": [
1184
+ "version",
1185
+ "levels"
1186
+ ]
1187
+ },
1188
+ "sequence": {
1189
+ "oneOf": [
1190
+ {
1191
+ "type": "object",
1192
+ "properties": {
1193
+ "mode": {
1194
+ "const": "new",
1195
+ "type": "string"
1196
+ },
1197
+ "startAt": {
1198
+ "type": "number"
1199
+ }
1200
+ },
1201
+ "required": [
1202
+ "mode"
1203
+ ]
1204
+ },
1205
+ {
1206
+ "type": "object",
1207
+ "properties": {
1208
+ "mode": {
1209
+ "const": "continuePrevious",
1210
+ "type": "string"
1211
+ }
1212
+ },
1213
+ "required": [
1214
+ "mode"
1215
+ ]
1216
+ }
1217
+ ]
1218
+ },
1219
+ "continuity": {
1220
+ "type": "string",
1221
+ "description": "Numbering continuity: 'preserve' keeps numbering; 'none' restarts.",
1222
+ "enum": [
1223
+ "preserve",
1224
+ "none"
1225
+ ]
1226
+ }
1227
+ },
1228
+ "required": [
1229
+ "action"
1230
+ ],
1231
+ "additionalProperties": false
1232
+ }
1233
+ }
1234
+ },
1235
+ {
1236
+ "type": "function",
1237
+ "function": {
1238
+ "name": "superdoc_comment",
1239
+ "description": "Comment threads — create, edit, delete",
1240
+ "parameters": {
1241
+ "type": "object",
1242
+ "properties": {
1243
+ "action": {
1244
+ "type": "string",
1245
+ "enum": [
1246
+ "create",
1247
+ "delete",
1414
1248
  "get",
1415
1249
  "list",
1416
1250
  "update"
@@ -1418,26 +1252,28 @@
1418
1252
  "description": "The action to perform. One of: create, delete, get, list, update."
1419
1253
  },
1420
1254
  "doc": {
1421
- "type": "string"
1255
+ "type": "string",
1256
+ "description": "Document path. Optional when a session is already open."
1422
1257
  },
1423
1258
  "sessionId": {
1424
- "type": "string"
1259
+ "type": "string",
1260
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1425
1261
  },
1426
1262
  "force": {
1427
- "type": "boolean"
1428
- },
1429
- "expectedRevision": {
1430
- "type": "number"
1263
+ "type": "boolean",
1264
+ "description": "Bypass confirmation checks."
1431
1265
  },
1432
1266
  "changeMode": {
1433
1267
  "type": "string",
1434
1268
  "enum": [
1435
1269
  "direct",
1436
1270
  "tracked"
1437
- ]
1271
+ ],
1272
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1438
1273
  },
1439
1274
  "text": {
1440
- "type": "string"
1275
+ "type": "string",
1276
+ "description": "Comment text content. Required for action 'create'."
1441
1277
  },
1442
1278
  "target": {
1443
1279
  "type": "object",
@@ -1469,40 +1305,51 @@
1469
1305
  "kind",
1470
1306
  "blockId",
1471
1307
  "range"
1472
- ]
1308
+ ],
1309
+ "description": "Text range to anchor the comment: {kind:'text', blockId:'...', range:{start:N, end:N}}."
1473
1310
  },
1474
1311
  "parentId": {
1475
- "type": "string"
1312
+ "type": "string",
1313
+ "description": "Parent comment ID for creating a threaded reply."
1476
1314
  },
1477
1315
  "blockId": {
1478
- "type": "string"
1316
+ "type": "string",
1317
+ "description": "Block ID of the target paragraph."
1479
1318
  },
1480
1319
  "start": {
1481
- "type": "number"
1320
+ "type": "number",
1321
+ "description": "Start offset within the block (character index)."
1482
1322
  },
1483
1323
  "end": {
1484
- "type": "number"
1324
+ "type": "number",
1325
+ "description": "End offset within the block (character index)."
1485
1326
  },
1486
1327
  "id": {
1487
- "type": "string"
1328
+ "type": "string",
1329
+ "description": "Required for actions 'delete', 'get'."
1488
1330
  },
1489
1331
  "status": {
1490
1332
  "type": "string",
1333
+ "description": "Set comment status. Use 'resolved' to mark as resolved.",
1491
1334
  "enum": [
1492
1335
  "resolved"
1493
1336
  ]
1494
1337
  },
1495
1338
  "isInternal": {
1496
- "type": "boolean"
1339
+ "type": "boolean",
1340
+ "description": "When true, marks the comment as internal (hidden from external collaborators)."
1497
1341
  },
1498
1342
  "includeResolved": {
1499
- "type": "boolean"
1343
+ "type": "boolean",
1344
+ "description": "When true, includes resolved comments in results. Default: false."
1500
1345
  },
1501
1346
  "limit": {
1502
- "type": "number"
1347
+ "type": "number",
1348
+ "description": "Maximum number of comments to return."
1503
1349
  },
1504
1350
  "offset": {
1505
- "type": "number"
1351
+ "type": "number",
1352
+ "description": "Number of comments to skip for pagination."
1506
1353
  }
1507
1354
  },
1508
1355
  "required": [
@@ -1529,19 +1376,24 @@
1529
1376
  "description": "The action to perform. One of: decide, list."
1530
1377
  },
1531
1378
  "doc": {
1532
- "type": "string"
1379
+ "type": "string",
1380
+ "description": "Document path. Optional when a session is already open."
1533
1381
  },
1534
1382
  "sessionId": {
1535
- "type": "string"
1383
+ "type": "string",
1384
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1536
1385
  },
1537
1386
  "limit": {
1538
- "type": "number"
1387
+ "type": "number",
1388
+ "description": "Maximum number of tracked changes to return."
1539
1389
  },
1540
1390
  "offset": {
1541
- "type": "number"
1391
+ "type": "number",
1392
+ "description": "Number of tracked changes to skip for pagination."
1542
1393
  },
1543
1394
  "type": {
1544
1395
  "type": "string",
1396
+ "description": "Filter by change type: 'insert', 'delete', or 'format'.",
1545
1397
  "enum": [
1546
1398
  "insert",
1547
1399
  "delete",
@@ -1549,24 +1401,24 @@
1549
1401
  ]
1550
1402
  },
1551
1403
  "force": {
1552
- "type": "boolean"
1553
- },
1554
- "expectedRevision": {
1555
- "type": "number"
1404
+ "type": "boolean",
1405
+ "description": "Bypass confirmation checks."
1556
1406
  },
1557
1407
  "changeMode": {
1558
1408
  "type": "string",
1559
1409
  "enum": [
1560
1410
  "direct",
1561
1411
  "tracked"
1562
- ]
1412
+ ],
1413
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1563
1414
  },
1564
1415
  "decision": {
1565
1416
  "type": "string",
1566
1417
  "enum": [
1567
1418
  "accept",
1568
1419
  "reject"
1569
- ]
1420
+ ],
1421
+ "description": "Required for action 'decide'."
1570
1422
  },
1571
1423
  "target": {
1572
1424
  "oneOf": [
@@ -1594,7 +1446,8 @@
1594
1446
  "scope"
1595
1447
  ]
1596
1448
  }
1597
- ]
1449
+ ],
1450
+ "description": "Required for action 'decide'."
1598
1451
  }
1599
1452
  },
1600
1453
  "required": [
@@ -1613,10 +1466,12 @@
1613
1466
  "type": "object",
1614
1467
  "properties": {
1615
1468
  "doc": {
1616
- "type": "string"
1469
+ "type": "string",
1470
+ "description": "Document path. Optional when a session is already open."
1617
1471
  },
1618
1472
  "sessionId": {
1619
- "type": "string"
1473
+ "type": "string",
1474
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1620
1475
  },
1621
1476
  "select": {
1622
1477
  "oneOf": [
@@ -1625,19 +1480,23 @@
1625
1480
  "properties": {
1626
1481
  "type": {
1627
1482
  "const": "text",
1483
+ "description": "Must be 'text' for text pattern search.",
1628
1484
  "type": "string"
1629
1485
  },
1630
1486
  "pattern": {
1631
- "type": "string"
1487
+ "type": "string",
1488
+ "description": "Text or regex pattern to match."
1632
1489
  },
1633
1490
  "mode": {
1491
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
1634
1492
  "enum": [
1635
1493
  "contains",
1636
1494
  "regex"
1637
1495
  ]
1638
1496
  },
1639
1497
  "caseSensitive": {
1640
- "type": "boolean"
1498
+ "type": "boolean",
1499
+ "description": "Case-sensitive matching. Default: false."
1641
1500
  }
1642
1501
  },
1643
1502
  "required": [
@@ -1650,9 +1509,11 @@
1650
1509
  "properties": {
1651
1510
  "type": {
1652
1511
  "const": "node",
1512
+ "description": "Must be 'node' for node type search.",
1653
1513
  "type": "string"
1654
1514
  },
1655
1515
  "nodeType": {
1516
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
1656
1517
  "enum": [
1657
1518
  "paragraph",
1658
1519
  "heading",
@@ -1679,6 +1540,7 @@
1679
1540
  ]
1680
1541
  },
1681
1542
  "kind": {
1543
+ "description": "Filter: 'block' or 'inline'.",
1682
1544
  "enum": [
1683
1545
  "block",
1684
1546
  "inline"
@@ -1689,7 +1551,8 @@
1689
1551
  "type"
1690
1552
  ]
1691
1553
  }
1692
- ]
1554
+ ],
1555
+ "description": "Search selector. Use {type:'text', pattern:'...'} for text search or {type:'node', nodeType:'paragraph'|'heading'|...} for node search."
1693
1556
  },
1694
1557
  "within": {
1695
1558
  "type": "object",
@@ -1719,10 +1582,12 @@
1719
1582
  "kind",
1720
1583
  "nodeType",
1721
1584
  "nodeId"
1722
- ]
1585
+ ],
1586
+ "description": "Limit search scope to within a specific block: {kind:'block', nodeType:'...', nodeId:'...'}."
1723
1587
  },
1724
1588
  "require": {
1725
1589
  "type": "string",
1590
+ "description": "Match cardinality: 'any' (all matches), 'first' (only first), 'exactlyOne' (fail if != 1), 'all' (fail if 0).",
1726
1591
  "enum": [
1727
1592
  "any",
1728
1593
  "first",
@@ -1732,19 +1597,23 @@
1732
1597
  },
1733
1598
  "mode": {
1734
1599
  "type": "string",
1600
+ "description": "Search mode: 'strict' (default, exact matching) or 'candidates' (returns scored potential matches).",
1735
1601
  "enum": [
1736
1602
  "strict",
1737
1603
  "candidates"
1738
1604
  ]
1739
1605
  },
1740
1606
  "includeNodes": {
1741
- "type": "boolean"
1607
+ "type": "boolean",
1608
+ "description": "When true, includes full node data in results. Default: false."
1742
1609
  },
1743
1610
  "limit": {
1744
- "type": "number"
1611
+ "type": "number",
1612
+ "description": "Maximum number of matches to return."
1745
1613
  },
1746
1614
  "offset": {
1747
- "type": "number"
1615
+ "type": "number",
1616
+ "description": "Number of matches to skip for pagination."
1748
1617
  }
1749
1618
  },
1750
1619
  "required": [
@@ -1771,19 +1640,24 @@
1771
1640
  "description": "The action to perform. One of: apply, preview."
1772
1641
  },
1773
1642
  "doc": {
1774
- "type": "string"
1643
+ "type": "string",
1644
+ "description": "Document path. Optional when a session is already open."
1775
1645
  },
1776
1646
  "sessionId": {
1777
- "type": "string"
1647
+ "type": "string",
1648
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1778
1649
  },
1779
1650
  "expectedRevision": {
1780
- "type": "string"
1651
+ "type": "string",
1652
+ "description": "Document revision for optimistic concurrency. Mutation fails if document was modified since this revision."
1781
1653
  },
1782
1654
  "atomic": {
1783
- "type": "boolean"
1655
+ "type": "boolean",
1656
+ "description": "Must be true. All steps execute as one atomic transaction."
1784
1657
  },
1785
1658
  "changeMode": {
1786
1659
  "type": "string",
1660
+ "description": "Required. Use 'direct' for immediate edits or 'tracked' for suggestions. Must always be provided.",
1787
1661
  "enum": [
1788
1662
  "direct",
1789
1663
  "tracked"
@@ -1819,19 +1693,23 @@
1819
1693
  "properties": {
1820
1694
  "type": {
1821
1695
  "const": "text",
1696
+ "description": "Must be 'text' for text pattern search.",
1822
1697
  "type": "string"
1823
1698
  },
1824
1699
  "pattern": {
1825
- "type": "string"
1700
+ "type": "string",
1701
+ "description": "Text or regex pattern to match."
1826
1702
  },
1827
1703
  "mode": {
1704
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
1828
1705
  "enum": [
1829
1706
  "contains",
1830
1707
  "regex"
1831
1708
  ]
1832
1709
  },
1833
1710
  "caseSensitive": {
1834
- "type": "boolean"
1711
+ "type": "boolean",
1712
+ "description": "Case-sensitive matching. Default: false."
1835
1713
  }
1836
1714
  },
1837
1715
  "required": [
@@ -1844,9 +1722,11 @@
1844
1722
  "properties": {
1845
1723
  "type": {
1846
1724
  "const": "node",
1725
+ "description": "Must be 'node' for node type search.",
1847
1726
  "type": "string"
1848
1727
  },
1849
1728
  "nodeType": {
1729
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
1850
1730
  "enum": [
1851
1731
  "paragraph",
1852
1732
  "heading",
@@ -1873,6 +1753,7 @@
1873
1753
  ]
1874
1754
  },
1875
1755
  "kind": {
1756
+ "description": "Filter: 'block' or 'inline'.",
1876
1757
  "enum": [
1877
1758
  "block",
1878
1759
  "inline"
@@ -2058,7 +1939,8 @@
2058
1939
  "edge"
2059
1940
  ]
2060
1941
  }
2061
- ]
1942
+ ],
1943
+ "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."
2062
1944
  },
2063
1945
  "end": {
2064
1946
  "oneOf": [
@@ -2129,7 +2011,8 @@
2129
2011
  "edge"
2130
2012
  ]
2131
2013
  }
2132
- ]
2014
+ ],
2015
+ "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."
2133
2016
  }
2134
2017
  },
2135
2018
  "required": [
@@ -2306,19 +2189,23 @@
2306
2189
  "properties": {
2307
2190
  "type": {
2308
2191
  "const": "text",
2192
+ "description": "Must be 'text' for text pattern search.",
2309
2193
  "type": "string"
2310
2194
  },
2311
2195
  "pattern": {
2312
- "type": "string"
2196
+ "type": "string",
2197
+ "description": "Text or regex pattern to match."
2313
2198
  },
2314
2199
  "mode": {
2200
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2315
2201
  "enum": [
2316
2202
  "contains",
2317
2203
  "regex"
2318
2204
  ]
2319
2205
  },
2320
2206
  "caseSensitive": {
2321
- "type": "boolean"
2207
+ "type": "boolean",
2208
+ "description": "Case-sensitive matching. Default: false."
2322
2209
  }
2323
2210
  },
2324
2211
  "required": [
@@ -2331,9 +2218,11 @@
2331
2218
  "properties": {
2332
2219
  "type": {
2333
2220
  "const": "node",
2221
+ "description": "Must be 'node' for node type search.",
2334
2222
  "type": "string"
2335
2223
  },
2336
2224
  "nodeType": {
2225
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2337
2226
  "enum": [
2338
2227
  "paragraph",
2339
2228
  "heading",
@@ -2360,6 +2249,7 @@
2360
2249
  ]
2361
2250
  },
2362
2251
  "kind": {
2252
+ "description": "Filter: 'block' or 'inline'.",
2363
2253
  "enum": [
2364
2254
  "block",
2365
2255
  "inline"
@@ -2531,19 +2421,23 @@
2531
2421
  "properties": {
2532
2422
  "type": {
2533
2423
  "const": "text",
2424
+ "description": "Must be 'text' for text pattern search.",
2534
2425
  "type": "string"
2535
2426
  },
2536
2427
  "pattern": {
2537
- "type": "string"
2428
+ "type": "string",
2429
+ "description": "Text or regex pattern to match."
2538
2430
  },
2539
2431
  "mode": {
2432
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2540
2433
  "enum": [
2541
2434
  "contains",
2542
2435
  "regex"
2543
2436
  ]
2544
2437
  },
2545
2438
  "caseSensitive": {
2546
- "type": "boolean"
2439
+ "type": "boolean",
2440
+ "description": "Case-sensitive matching. Default: false."
2547
2441
  }
2548
2442
  },
2549
2443
  "required": [
@@ -2556,9 +2450,11 @@
2556
2450
  "properties": {
2557
2451
  "type": {
2558
2452
  "const": "node",
2453
+ "description": "Must be 'node' for node type search.",
2559
2454
  "type": "string"
2560
2455
  },
2561
2456
  "nodeType": {
2457
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2562
2458
  "enum": [
2563
2459
  "paragraph",
2564
2460
  "heading",
@@ -2585,6 +2481,7 @@
2585
2481
  ]
2586
2482
  },
2587
2483
  "kind": {
2484
+ "description": "Filter: 'block' or 'inline'.",
2588
2485
  "enum": [
2589
2486
  "block",
2590
2487
  "inline"
@@ -2770,7 +2667,8 @@
2770
2667
  "edge"
2771
2668
  ]
2772
2669
  }
2773
- ]
2670
+ ],
2671
+ "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."
2774
2672
  },
2775
2673
  "end": {
2776
2674
  "oneOf": [
@@ -2841,7 +2739,8 @@
2841
2739
  "edge"
2842
2740
  ]
2843
2741
  }
2844
- ]
2742
+ ],
2743
+ "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."
2845
2744
  }
2846
2745
  },
2847
2746
  "required": [
@@ -2903,19 +2802,23 @@
2903
2802
  "properties": {
2904
2803
  "type": {
2905
2804
  "const": "text",
2805
+ "description": "Must be 'text' for text pattern search.",
2906
2806
  "type": "string"
2907
2807
  },
2908
2808
  "pattern": {
2909
- "type": "string"
2809
+ "type": "string",
2810
+ "description": "Text or regex pattern to match."
2910
2811
  },
2911
2812
  "mode": {
2813
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2912
2814
  "enum": [
2913
2815
  "contains",
2914
2816
  "regex"
2915
2817
  ]
2916
2818
  },
2917
2819
  "caseSensitive": {
2918
- "type": "boolean"
2820
+ "type": "boolean",
2821
+ "description": "Case-sensitive matching. Default: false."
2919
2822
  }
2920
2823
  },
2921
2824
  "required": [
@@ -2928,9 +2831,11 @@
2928
2831
  "properties": {
2929
2832
  "type": {
2930
2833
  "const": "node",
2834
+ "description": "Must be 'node' for node type search.",
2931
2835
  "type": "string"
2932
2836
  },
2933
2837
  "nodeType": {
2838
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2934
2839
  "enum": [
2935
2840
  "paragraph",
2936
2841
  "heading",
@@ -2957,6 +2862,7 @@
2957
2862
  ]
2958
2863
  },
2959
2864
  "kind": {
2865
+ "description": "Filter: 'block' or 'inline'.",
2960
2866
  "enum": [
2961
2867
  "block",
2962
2868
  "inline"
@@ -3142,7 +3048,8 @@
3142
3048
  "edge"
3143
3049
  ]
3144
3050
  }
3145
- ]
3051
+ ],
3052
+ "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."
3146
3053
  },
3147
3054
  "end": {
3148
3055
  "oneOf": [
@@ -3213,7 +3120,8 @@
3213
3120
  "edge"
3214
3121
  ]
3215
3122
  }
3216
- ]
3123
+ ],
3124
+ "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."
3217
3125
  }
3218
3126
  },
3219
3127
  "required": [
@@ -3237,615 +3145,259 @@
3237
3145
  "type": "object",
3238
3146
  "properties": {
3239
3147
  "bold": {
3240
- "oneOf": [
3241
- {
3242
- "type": "boolean"
3243
- },
3244
- {}
3245
- ]
3148
+ "type": "boolean"
3246
3149
  },
3247
3150
  "italic": {
3248
- "oneOf": [
3249
- {
3250
- "type": "boolean"
3251
- },
3252
- {}
3253
- ]
3151
+ "type": "boolean"
3254
3152
  },
3255
3153
  "strike": {
3256
- "oneOf": [
3257
- {
3258
- "type": "boolean"
3259
- },
3260
- {}
3261
- ]
3154
+ "type": "boolean"
3262
3155
  },
3263
3156
  "underline": {
3264
3157
  "oneOf": [
3265
3158
  {
3266
3159
  "type": "boolean"
3267
3160
  },
3268
- {},
3269
3161
  {
3270
3162
  "type": "object",
3271
3163
  "properties": {
3272
3164
  "style": {
3273
- "oneOf": [
3274
- {
3275
- "type": "string"
3276
- },
3277
- {}
3278
- ]
3165
+ "type": "string"
3279
3166
  },
3280
3167
  "color": {
3281
- "oneOf": [
3282
- {
3283
- "type": "string"
3284
- },
3285
- {}
3286
- ]
3168
+ "type": "string"
3287
3169
  },
3288
3170
  "themeColor": {
3289
- "oneOf": [
3290
- {
3291
- "type": "string"
3292
- },
3293
- {}
3294
- ]
3171
+ "type": "string"
3295
3172
  }
3296
3173
  }
3297
3174
  }
3298
3175
  ]
3299
3176
  },
3300
3177
  "highlight": {
3301
- "oneOf": [
3302
- {
3303
- "type": "string"
3304
- },
3305
- {}
3306
- ]
3178
+ "type": "string"
3307
3179
  },
3308
3180
  "color": {
3309
- "oneOf": [
3310
- {
3311
- "type": "string"
3312
- },
3313
- {}
3314
- ]
3181
+ "type": "string"
3315
3182
  },
3316
3183
  "fontSize": {
3317
- "oneOf": [
3318
- {
3319
- "type": "number"
3320
- },
3321
- {}
3322
- ]
3184
+ "type": "number"
3323
3185
  },
3324
3186
  "fontFamily": {
3325
- "oneOf": [
3326
- {
3327
- "type": "string"
3328
- },
3329
- {}
3330
- ]
3187
+ "type": "string"
3331
3188
  },
3332
3189
  "letterSpacing": {
3333
- "oneOf": [
3334
- {
3335
- "type": "number"
3336
- },
3337
- {}
3338
- ]
3190
+ "type": "number"
3339
3191
  },
3340
3192
  "vertAlign": {
3341
- "oneOf": [
3342
- {
3343
- "enum": [
3344
- "superscript",
3345
- "subscript",
3346
- "baseline"
3347
- ]
3348
- },
3349
- {}
3193
+ "enum": [
3194
+ "superscript",
3195
+ "subscript",
3196
+ "baseline"
3350
3197
  ]
3351
3198
  },
3352
3199
  "position": {
3353
- "oneOf": [
3354
- {
3355
- "type": "number"
3356
- },
3357
- {}
3358
- ]
3200
+ "type": "number"
3359
3201
  },
3360
3202
  "dstrike": {
3361
- "oneOf": [
3362
- {
3363
- "type": "boolean"
3364
- },
3365
- {}
3366
- ]
3203
+ "type": "boolean"
3367
3204
  },
3368
3205
  "smallCaps": {
3369
- "oneOf": [
3370
- {
3371
- "type": "boolean"
3372
- },
3373
- {}
3374
- ]
3206
+ "type": "boolean"
3375
3207
  },
3376
3208
  "caps": {
3377
- "oneOf": [
3378
- {
3379
- "type": "boolean"
3380
- },
3381
- {}
3382
- ]
3209
+ "type": "boolean"
3383
3210
  },
3384
3211
  "shading": {
3385
- "oneOf": [
3386
- {
3387
- "type": "object",
3388
- "properties": {
3389
- "fill": {
3390
- "oneOf": [
3391
- {
3392
- "type": "string"
3393
- },
3394
- {}
3395
- ]
3396
- },
3397
- "color": {
3398
- "oneOf": [
3399
- {
3400
- "type": "string"
3401
- },
3402
- {}
3403
- ]
3404
- },
3405
- "val": {
3406
- "oneOf": [
3407
- {
3408
- "type": "string"
3409
- },
3410
- {}
3411
- ]
3412
- }
3413
- }
3212
+ "type": "object",
3213
+ "properties": {
3214
+ "fill": {
3215
+ "type": "string"
3414
3216
  },
3415
- {}
3416
- ]
3217
+ "color": {
3218
+ "type": "string"
3219
+ },
3220
+ "val": {
3221
+ "type": "string"
3222
+ }
3223
+ }
3417
3224
  },
3418
3225
  "border": {
3419
- "oneOf": [
3420
- {
3421
- "type": "object",
3422
- "properties": {
3423
- "val": {
3424
- "oneOf": [
3425
- {
3426
- "type": "string"
3427
- },
3428
- {}
3429
- ]
3430
- },
3431
- "sz": {
3432
- "oneOf": [
3433
- {
3434
- "type": "number"
3435
- },
3436
- {}
3437
- ]
3438
- },
3439
- "color": {
3440
- "oneOf": [
3441
- {
3442
- "type": "string"
3443
- },
3444
- {}
3445
- ]
3446
- },
3447
- "space": {
3448
- "oneOf": [
3449
- {
3450
- "type": "number"
3451
- },
3452
- {}
3453
- ]
3454
- }
3455
- }
3226
+ "type": "object",
3227
+ "properties": {
3228
+ "val": {
3229
+ "type": "string"
3456
3230
  },
3457
- {}
3458
- ]
3231
+ "sz": {
3232
+ "type": "number"
3233
+ },
3234
+ "color": {
3235
+ "type": "string"
3236
+ },
3237
+ "space": {
3238
+ "type": "number"
3239
+ }
3240
+ }
3459
3241
  },
3460
3242
  "outline": {
3461
- "oneOf": [
3462
- {
3463
- "type": "boolean"
3464
- },
3465
- {}
3466
- ]
3243
+ "type": "boolean"
3467
3244
  },
3468
3245
  "shadow": {
3469
- "oneOf": [
3470
- {
3471
- "type": "boolean"
3472
- },
3473
- {}
3474
- ]
3246
+ "type": "boolean"
3475
3247
  },
3476
3248
  "emboss": {
3477
- "oneOf": [
3478
- {
3479
- "type": "boolean"
3480
- },
3481
- {}
3482
- ]
3249
+ "type": "boolean"
3483
3250
  },
3484
3251
  "imprint": {
3485
- "oneOf": [
3486
- {
3487
- "type": "boolean"
3488
- },
3489
- {}
3490
- ]
3252
+ "type": "boolean"
3491
3253
  },
3492
3254
  "charScale": {
3493
- "oneOf": [
3494
- {
3495
- "type": "number"
3496
- },
3497
- {}
3498
- ]
3255
+ "type": "number"
3499
3256
  },
3500
3257
  "kerning": {
3501
- "oneOf": [
3502
- {
3503
- "type": "number"
3504
- },
3505
- {}
3506
- ]
3258
+ "type": "number"
3507
3259
  },
3508
3260
  "vanish": {
3509
- "oneOf": [
3510
- {
3511
- "type": "boolean"
3512
- },
3513
- {}
3514
- ]
3261
+ "type": "boolean"
3515
3262
  },
3516
3263
  "webHidden": {
3517
- "oneOf": [
3518
- {
3519
- "type": "boolean"
3520
- },
3521
- {}
3522
- ]
3264
+ "type": "boolean"
3523
3265
  },
3524
3266
  "specVanish": {
3525
- "oneOf": [
3526
- {
3527
- "type": "boolean"
3528
- },
3529
- {}
3530
- ]
3267
+ "type": "boolean"
3531
3268
  },
3532
3269
  "rtl": {
3533
- "oneOf": [
3534
- {
3535
- "type": "boolean"
3536
- },
3537
- {}
3538
- ]
3270
+ "type": "boolean"
3539
3271
  },
3540
3272
  "cs": {
3541
- "oneOf": [
3542
- {
3543
- "type": "boolean"
3544
- },
3545
- {}
3546
- ]
3273
+ "type": "boolean"
3547
3274
  },
3548
3275
  "bCs": {
3549
- "oneOf": [
3550
- {
3551
- "type": "boolean"
3552
- },
3553
- {}
3554
- ]
3276
+ "type": "boolean"
3555
3277
  },
3556
3278
  "iCs": {
3557
- "oneOf": [
3558
- {
3559
- "type": "boolean"
3560
- },
3561
- {}
3562
- ]
3279
+ "type": "boolean"
3563
3280
  },
3564
3281
  "eastAsianLayout": {
3565
- "oneOf": [
3566
- {
3567
- "type": "object",
3568
- "properties": {
3569
- "id": {
3570
- "oneOf": [
3571
- {
3572
- "type": "string"
3573
- },
3574
- {}
3575
- ]
3576
- },
3577
- "combine": {
3578
- "oneOf": [
3579
- {
3580
- "type": "boolean"
3581
- },
3582
- {}
3583
- ]
3584
- },
3585
- "combineBrackets": {
3586
- "oneOf": [
3587
- {
3588
- "type": "string"
3589
- },
3590
- {}
3591
- ]
3592
- },
3593
- "vert": {
3594
- "oneOf": [
3595
- {
3596
- "type": "boolean"
3597
- },
3598
- {}
3599
- ]
3600
- },
3601
- "vertCompress": {
3602
- "oneOf": [
3603
- {
3604
- "type": "boolean"
3605
- },
3606
- {}
3607
- ]
3608
- }
3609
- }
3282
+ "type": "object",
3283
+ "properties": {
3284
+ "id": {
3285
+ "type": "string"
3610
3286
  },
3611
- {}
3612
- ]
3613
- },
3614
- "em": {
3615
- "oneOf": [
3616
- {
3287
+ "combine": {
3288
+ "type": "boolean"
3289
+ },
3290
+ "combineBrackets": {
3617
3291
  "type": "string"
3618
3292
  },
3619
- {}
3620
- ]
3293
+ "vert": {
3294
+ "type": "boolean"
3295
+ },
3296
+ "vertCompress": {
3297
+ "type": "boolean"
3298
+ }
3299
+ }
3300
+ },
3301
+ "em": {
3302
+ "type": "string"
3621
3303
  },
3622
3304
  "fitText": {
3623
- "oneOf": [
3624
- {
3625
- "type": "object",
3626
- "properties": {
3627
- "val": {
3628
- "oneOf": [
3629
- {
3630
- "type": "number"
3631
- },
3632
- {}
3633
- ]
3634
- },
3635
- "id": {
3636
- "oneOf": [
3637
- {
3638
- "type": "string"
3639
- },
3640
- {}
3641
- ]
3642
- }
3643
- }
3305
+ "type": "object",
3306
+ "properties": {
3307
+ "val": {
3308
+ "type": "number"
3644
3309
  },
3645
- {}
3646
- ]
3310
+ "id": {
3311
+ "type": "string"
3312
+ }
3313
+ }
3647
3314
  },
3648
3315
  "snapToGrid": {
3649
- "oneOf": [
3650
- {
3651
- "type": "boolean"
3652
- },
3653
- {}
3654
- ]
3316
+ "type": "boolean"
3655
3317
  },
3656
3318
  "lang": {
3657
- "oneOf": [
3658
- {
3659
- "type": "object",
3660
- "properties": {
3661
- "val": {
3662
- "oneOf": [
3663
- {
3664
- "type": "string"
3665
- },
3666
- {}
3667
- ]
3668
- },
3669
- "eastAsia": {
3670
- "oneOf": [
3671
- {
3672
- "type": "string"
3673
- },
3674
- {}
3675
- ]
3676
- },
3677
- "bidi": {
3678
- "oneOf": [
3679
- {
3680
- "type": "string"
3681
- },
3682
- {}
3683
- ]
3684
- }
3685
- }
3319
+ "type": "object",
3320
+ "properties": {
3321
+ "val": {
3322
+ "type": "string"
3686
3323
  },
3687
- {}
3688
- ]
3324
+ "eastAsia": {
3325
+ "type": "string"
3326
+ },
3327
+ "bidi": {
3328
+ "type": "string"
3329
+ }
3330
+ }
3689
3331
  },
3690
3332
  "oMath": {
3691
- "oneOf": [
3692
- {
3693
- "type": "boolean"
3694
- },
3695
- {}
3696
- ]
3333
+ "type": "boolean"
3697
3334
  },
3698
3335
  "rStyle": {
3699
- "oneOf": [
3700
- {
3701
- "type": "string"
3702
- },
3703
- {}
3704
- ]
3336
+ "type": "string"
3705
3337
  },
3706
3338
  "rFonts": {
3707
- "oneOf": [
3708
- {
3709
- "type": "object",
3710
- "properties": {
3711
- "ascii": {
3712
- "oneOf": [
3713
- {
3714
- "type": "string"
3715
- },
3716
- {}
3717
- ]
3718
- },
3719
- "hAnsi": {
3720
- "oneOf": [
3721
- {
3722
- "type": "string"
3723
- },
3724
- {}
3725
- ]
3726
- },
3727
- "eastAsia": {
3728
- "oneOf": [
3729
- {
3730
- "type": "string"
3731
- },
3732
- {}
3733
- ]
3734
- },
3735
- "cs": {
3736
- "oneOf": [
3737
- {
3738
- "type": "string"
3739
- },
3740
- {}
3741
- ]
3742
- },
3743
- "asciiTheme": {
3744
- "oneOf": [
3745
- {
3746
- "type": "string"
3747
- },
3748
- {}
3749
- ]
3750
- },
3751
- "hAnsiTheme": {
3752
- "oneOf": [
3753
- {
3754
- "type": "string"
3755
- },
3756
- {}
3757
- ]
3758
- },
3759
- "eastAsiaTheme": {
3760
- "oneOf": [
3761
- {
3762
- "type": "string"
3763
- },
3764
- {}
3765
- ]
3766
- },
3767
- "csTheme": {
3768
- "oneOf": [
3769
- {
3770
- "type": "string"
3771
- },
3772
- {}
3773
- ]
3774
- },
3775
- "hint": {
3776
- "oneOf": [
3777
- {
3778
- "type": "string"
3779
- },
3780
- {}
3781
- ]
3782
- }
3783
- }
3339
+ "type": "object",
3340
+ "properties": {
3341
+ "ascii": {
3342
+ "type": "string"
3784
3343
  },
3785
- {}
3786
- ]
3344
+ "hAnsi": {
3345
+ "type": "string"
3346
+ },
3347
+ "eastAsia": {
3348
+ "type": "string"
3349
+ },
3350
+ "cs": {
3351
+ "type": "string"
3352
+ },
3353
+ "asciiTheme": {
3354
+ "type": "string"
3355
+ },
3356
+ "hAnsiTheme": {
3357
+ "type": "string"
3358
+ },
3359
+ "eastAsiaTheme": {
3360
+ "type": "string"
3361
+ },
3362
+ "csTheme": {
3363
+ "type": "string"
3364
+ },
3365
+ "hint": {
3366
+ "type": "string"
3367
+ }
3368
+ }
3787
3369
  },
3788
3370
  "fontSizeCs": {
3789
- "oneOf": [
3790
- {
3791
- "type": "number"
3792
- },
3793
- {}
3794
- ]
3371
+ "type": "number"
3795
3372
  },
3796
3373
  "ligatures": {
3797
- "oneOf": [
3798
- {
3799
- "type": "string"
3800
- },
3801
- {}
3802
- ]
3374
+ "type": "string"
3803
3375
  },
3804
3376
  "numForm": {
3805
- "oneOf": [
3806
- {
3807
- "type": "string"
3808
- },
3809
- {}
3810
- ]
3377
+ "type": "string"
3811
3378
  },
3812
3379
  "numSpacing": {
3813
- "oneOf": [
3814
- {
3815
- "type": "string"
3816
- },
3817
- {}
3818
- ]
3380
+ "type": "string"
3819
3381
  },
3820
3382
  "stylisticSets": {
3821
- "oneOf": [
3822
- {
3823
- "type": "array",
3824
- "items": {
3825
- "type": "object",
3826
- "properties": {
3827
- "id": {
3828
- "type": "number"
3829
- },
3830
- "val": {
3831
- "type": "boolean"
3832
- }
3833
- },
3834
- "required": [
3835
- "id"
3836
- ]
3383
+ "type": "array",
3384
+ "items": {
3385
+ "type": "object",
3386
+ "properties": {
3387
+ "id": {
3388
+ "type": "number"
3389
+ },
3390
+ "val": {
3391
+ "type": "boolean"
3837
3392
  }
3838
3393
  },
3839
- {}
3840
- ]
3394
+ "required": [
3395
+ "id"
3396
+ ]
3397
+ }
3841
3398
  },
3842
3399
  "contextualAlternates": {
3843
- "oneOf": [
3844
- {
3845
- "type": "boolean"
3846
- },
3847
- {}
3848
- ]
3400
+ "type": "boolean"
3849
3401
  }
3850
3402
  }
3851
3403
  }
@@ -3886,19 +3438,23 @@
3886
3438
  "properties": {
3887
3439
  "type": {
3888
3440
  "const": "text",
3441
+ "description": "Must be 'text' for text pattern search.",
3889
3442
  "type": "string"
3890
3443
  },
3891
3444
  "pattern": {
3892
- "type": "string"
3445
+ "type": "string",
3446
+ "description": "Text or regex pattern to match."
3893
3447
  },
3894
3448
  "mode": {
3449
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
3895
3450
  "enum": [
3896
3451
  "contains",
3897
3452
  "regex"
3898
3453
  ]
3899
3454
  },
3900
3455
  "caseSensitive": {
3901
- "type": "boolean"
3456
+ "type": "boolean",
3457
+ "description": "Case-sensitive matching. Default: false."
3902
3458
  }
3903
3459
  },
3904
3460
  "required": [
@@ -3911,9 +3467,11 @@
3911
3467
  "properties": {
3912
3468
  "type": {
3913
3469
  "const": "node",
3470
+ "description": "Must be 'node' for node type search.",
3914
3471
  "type": "string"
3915
3472
  },
3916
3473
  "nodeType": {
3474
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
3917
3475
  "enum": [
3918
3476
  "paragraph",
3919
3477
  "heading",
@@ -3940,6 +3498,7 @@
3940
3498
  ]
3941
3499
  },
3942
3500
  "kind": {
3501
+ "description": "Filter: 'block' or 'inline'.",
3943
3502
  "enum": [
3944
3503
  "block",
3945
3504
  "inline"
@@ -4008,15 +3567,18 @@
4008
3567
  ]
4009
3568
  }
4010
3569
  ]
4011
- }
3570
+ },
3571
+ "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."
4012
3572
  },
4013
3573
  "force": {
4014
- "type": "boolean"
3574
+ "type": "boolean",
3575
+ "description": "Bypass confirmation checks."
4015
3576
  }
4016
3577
  },
4017
3578
  "required": [
4018
3579
  "action",
4019
3580
  "atomic",
3581
+ "changeMode",
4020
3582
  "steps"
4021
3583
  ],
4022
3584
  "additionalProperties": false