@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.generic.json CHANGED
@@ -18,13 +18,16 @@
18
18
  "description": "The action to perform. One of: html, info, markdown, text."
19
19
  },
20
20
  "doc": {
21
- "type": "string"
21
+ "type": "string",
22
+ "description": "Document path. Optional when a session is already open."
22
23
  },
23
24
  "sessionId": {
24
- "type": "string"
25
+ "type": "string",
26
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
25
27
  },
26
28
  "unflattenLists": {
27
- "type": "boolean"
29
+ "type": "boolean",
30
+ "description": "When true, flattens nested list structures in output. Default: false."
28
31
  }
29
32
  },
30
33
  "required": [
@@ -61,26 +64,28 @@
61
64
  "description": "The action to perform. One of: delete, insert, redo, replace, undo."
62
65
  },
63
66
  "doc": {
64
- "type": "string"
67
+ "type": "string",
68
+ "description": "Document path. Optional when a session is already open."
65
69
  },
66
70
  "sessionId": {
67
- "type": "string"
71
+ "type": "string",
72
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
68
73
  },
69
74
  "force": {
70
- "type": "boolean"
71
- },
72
- "expectedRevision": {
73
- "type": "number"
75
+ "type": "boolean",
76
+ "description": "Bypass confirmation checks."
74
77
  },
75
78
  "changeMode": {
76
79
  "type": "string",
77
80
  "enum": [
78
81
  "direct",
79
82
  "tracked"
80
- ]
83
+ ],
84
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
81
85
  },
82
86
  "dryRun": {
83
- "type": "boolean"
87
+ "type": "boolean",
88
+ "description": "Preview the result without applying changes."
84
89
  },
85
90
  "target": {
86
91
  "oneOf": [
@@ -146,13 +151,16 @@
146
151
  "nodeId"
147
152
  ]
148
153
  }
149
- ]
154
+ ],
155
+ "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}."
150
156
  },
151
157
  "value": {
152
- "type": "string"
158
+ "type": "string",
159
+ "description": "Text content to insert."
153
160
  },
154
161
  "type": {
155
162
  "type": "string",
163
+ "description": "Content format: 'text' (default), 'markdown', or 'html'.",
156
164
  "enum": [
157
165
  "text",
158
166
  "markdown",
@@ -172,10 +180,12 @@
172
180
  "properties": {}
173
181
  }
174
182
  }
175
- ]
183
+ ],
184
+ "description": "Document fragment to insert (structured content)."
176
185
  },
177
186
  "placement": {
178
187
  "type": "string",
188
+ "description": "Where to place content relative to target: 'before', 'after', 'insideStart', or 'insideEnd'.",
179
189
  "enum": [
180
190
  "before",
181
191
  "after",
@@ -192,32 +202,40 @@
192
202
  "allow"
193
203
  ]
194
204
  }
195
- }
205
+ },
206
+ "description": "Controls nesting behavior. tables: 'allow' permits inserting tables inside other tables."
196
207
  },
197
208
  "blockId": {
198
- "type": "string"
209
+ "type": "string",
210
+ "description": "Block ID of the target paragraph."
199
211
  },
200
212
  "offset": {
201
- "type": "number"
213
+ "type": "number",
214
+ "description": "Character offset within the block for insertion."
202
215
  },
203
216
  "text": {
204
- "type": "string"
217
+ "type": "string",
218
+ "description": "Replacement text content."
205
219
  },
206
220
  "ref": {
207
- "type": "string"
221
+ "type": "string",
222
+ "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."
208
223
  },
209
224
  "start": {
210
- "type": "number"
225
+ "type": "number",
226
+ "description": "Start offset within the block (character index)."
211
227
  },
212
228
  "end": {
213
- "type": "number"
229
+ "type": "number",
230
+ "description": "End offset within the block (character index)."
214
231
  },
215
232
  "behavior": {
216
233
  "type": "string",
217
234
  "enum": [
218
235
  "selection",
219
236
  "exact"
220
- ]
237
+ ],
238
+ "description": "Delete behavior: 'selection' (default) or 'exact'."
221
239
  }
222
240
  },
223
241
  "required": [
@@ -248,33 +266,36 @@
248
266
  "enum": [
249
267
  "inline",
250
268
  "set_alignment",
269
+ "set_direction",
251
270
  "set_indentation",
252
271
  "set_spacing",
253
272
  "set_style"
254
273
  ],
255
- "description": "The action to perform. One of: inline, set_alignment, set_indentation, set_spacing, set_style."
274
+ "description": "The action to perform. One of: inline, set_alignment, set_direction, set_indentation, set_spacing, set_style."
256
275
  },
257
276
  "doc": {
258
- "type": "string"
277
+ "type": "string",
278
+ "description": "Document path. Optional when a session is already open."
259
279
  },
260
280
  "sessionId": {
261
- "type": "string"
281
+ "type": "string",
282
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
262
283
  },
263
284
  "force": {
264
- "type": "boolean"
265
- },
266
- "expectedRevision": {
267
- "type": "number"
285
+ "type": "boolean",
286
+ "description": "Bypass confirmation checks."
268
287
  },
269
288
  "changeMode": {
270
289
  "type": "string",
271
290
  "enum": [
272
291
  "direct",
273
292
  "tracked"
274
- ]
293
+ ],
294
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
275
295
  },
276
296
  "dryRun": {
277
- "type": "boolean"
297
+ "type": "boolean",
298
+ "description": "Preview the result without applying changes."
278
299
  },
279
300
  "target": {
280
301
  "type": "object",
@@ -352,7 +373,8 @@
352
373
  "edge"
353
374
  ]
354
375
  }
355
- ]
376
+ ],
377
+ "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."
356
378
  },
357
379
  "end": {
358
380
  "oneOf": [
@@ -423,645 +445,297 @@
423
445
  "edge"
424
446
  ]
425
447
  }
426
- ]
448
+ ],
449
+ "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."
427
450
  }
428
451
  },
429
452
  "required": [
430
453
  "kind",
431
454
  "start",
432
455
  "end"
433
- ]
456
+ ],
457
+ "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'."
434
458
  },
435
459
  "inline": {
436
460
  "type": "object",
437
461
  "properties": {
438
462
  "bold": {
439
- "oneOf": [
440
- {
441
- "type": "boolean"
442
- },
443
- {}
444
- ]
463
+ "type": "boolean"
445
464
  },
446
465
  "italic": {
447
- "oneOf": [
448
- {
449
- "type": "boolean"
450
- },
451
- {}
452
- ]
466
+ "type": "boolean"
453
467
  },
454
468
  "strike": {
455
- "oneOf": [
456
- {
457
- "type": "boolean"
458
- },
459
- {}
460
- ]
469
+ "type": "boolean"
461
470
  },
462
471
  "underline": {
463
472
  "oneOf": [
464
473
  {
465
474
  "type": "boolean"
466
475
  },
467
- {},
468
476
  {
469
477
  "type": "object",
470
478
  "properties": {
471
479
  "style": {
472
- "oneOf": [
473
- {
474
- "type": "string"
475
- },
476
- {}
477
- ]
480
+ "type": "string"
478
481
  },
479
482
  "color": {
480
- "oneOf": [
481
- {
482
- "type": "string"
483
- },
484
- {}
485
- ]
483
+ "type": "string"
486
484
  },
487
485
  "themeColor": {
488
- "oneOf": [
489
- {
490
- "type": "string"
491
- },
492
- {}
493
- ]
486
+ "type": "string"
494
487
  }
495
488
  }
496
489
  }
497
490
  ]
498
491
  },
499
492
  "highlight": {
500
- "oneOf": [
501
- {
502
- "type": "string"
503
- },
504
- {}
505
- ]
493
+ "type": "string"
506
494
  },
507
495
  "color": {
508
- "oneOf": [
509
- {
510
- "type": "string"
511
- },
512
- {}
513
- ]
496
+ "type": "string"
514
497
  },
515
498
  "fontSize": {
516
- "oneOf": [
517
- {
518
- "type": "number"
519
- },
520
- {}
521
- ]
499
+ "type": "number"
522
500
  },
523
501
  "fontFamily": {
524
- "oneOf": [
525
- {
526
- "type": "string"
527
- },
528
- {}
529
- ]
502
+ "type": "string"
530
503
  },
531
504
  "letterSpacing": {
532
- "oneOf": [
533
- {
534
- "type": "number"
535
- },
536
- {}
537
- ]
505
+ "type": "number"
538
506
  },
539
507
  "vertAlign": {
540
- "oneOf": [
541
- {
542
- "enum": [
543
- "superscript",
544
- "subscript",
545
- "baseline"
546
- ]
547
- },
548
- {}
508
+ "enum": [
509
+ "superscript",
510
+ "subscript",
511
+ "baseline"
549
512
  ]
550
513
  },
551
514
  "position": {
552
- "oneOf": [
553
- {
554
- "type": "number"
555
- },
556
- {}
557
- ]
515
+ "type": "number"
558
516
  },
559
517
  "dstrike": {
560
- "oneOf": [
561
- {
562
- "type": "boolean"
563
- },
564
- {}
565
- ]
518
+ "type": "boolean"
566
519
  },
567
520
  "smallCaps": {
568
- "oneOf": [
569
- {
570
- "type": "boolean"
571
- },
572
- {}
573
- ]
521
+ "type": "boolean"
574
522
  },
575
523
  "caps": {
576
- "oneOf": [
577
- {
578
- "type": "boolean"
579
- },
580
- {}
581
- ]
524
+ "type": "boolean"
582
525
  },
583
526
  "shading": {
584
- "oneOf": [
585
- {
586
- "type": "object",
587
- "properties": {
588
- "fill": {
589
- "oneOf": [
590
- {
591
- "type": "string"
592
- },
593
- {}
594
- ]
595
- },
596
- "color": {
597
- "oneOf": [
598
- {
599
- "type": "string"
600
- },
601
- {}
602
- ]
603
- },
604
- "val": {
605
- "oneOf": [
606
- {
607
- "type": "string"
608
- },
609
- {}
610
- ]
611
- }
612
- }
527
+ "type": "object",
528
+ "properties": {
529
+ "fill": {
530
+ "type": "string"
613
531
  },
614
- {}
615
- ]
532
+ "color": {
533
+ "type": "string"
534
+ },
535
+ "val": {
536
+ "type": "string"
537
+ }
538
+ }
616
539
  },
617
540
  "border": {
618
- "oneOf": [
619
- {
620
- "type": "object",
621
- "properties": {
622
- "val": {
623
- "oneOf": [
624
- {
625
- "type": "string"
626
- },
627
- {}
628
- ]
629
- },
630
- "sz": {
631
- "oneOf": [
632
- {
633
- "type": "number"
634
- },
635
- {}
636
- ]
637
- },
638
- "color": {
639
- "oneOf": [
640
- {
641
- "type": "string"
642
- },
643
- {}
644
- ]
645
- },
646
- "space": {
647
- "oneOf": [
648
- {
649
- "type": "number"
650
- },
651
- {}
652
- ]
653
- }
654
- }
541
+ "type": "object",
542
+ "properties": {
543
+ "val": {
544
+ "type": "string"
655
545
  },
656
- {}
657
- ]
546
+ "sz": {
547
+ "type": "number"
548
+ },
549
+ "color": {
550
+ "type": "string"
551
+ },
552
+ "space": {
553
+ "type": "number"
554
+ }
555
+ }
658
556
  },
659
557
  "outline": {
660
- "oneOf": [
661
- {
662
- "type": "boolean"
663
- },
664
- {}
665
- ]
558
+ "type": "boolean"
666
559
  },
667
560
  "shadow": {
668
- "oneOf": [
669
- {
670
- "type": "boolean"
671
- },
672
- {}
673
- ]
561
+ "type": "boolean"
674
562
  },
675
563
  "emboss": {
676
- "oneOf": [
677
- {
678
- "type": "boolean"
679
- },
680
- {}
681
- ]
564
+ "type": "boolean"
682
565
  },
683
566
  "imprint": {
684
- "oneOf": [
685
- {
686
- "type": "boolean"
687
- },
688
- {}
689
- ]
567
+ "type": "boolean"
690
568
  },
691
569
  "charScale": {
692
- "oneOf": [
693
- {
694
- "type": "number"
695
- },
696
- {}
697
- ]
570
+ "type": "number"
698
571
  },
699
572
  "kerning": {
700
- "oneOf": [
701
- {
702
- "type": "number"
703
- },
704
- {}
705
- ]
573
+ "type": "number"
706
574
  },
707
575
  "vanish": {
708
- "oneOf": [
709
- {
710
- "type": "boolean"
711
- },
712
- {}
713
- ]
576
+ "type": "boolean"
714
577
  },
715
578
  "webHidden": {
716
- "oneOf": [
717
- {
718
- "type": "boolean"
719
- },
720
- {}
721
- ]
579
+ "type": "boolean"
722
580
  },
723
581
  "specVanish": {
724
- "oneOf": [
725
- {
726
- "type": "boolean"
727
- },
728
- {}
729
- ]
582
+ "type": "boolean"
730
583
  },
731
584
  "rtl": {
732
- "oneOf": [
733
- {
734
- "type": "boolean"
735
- },
736
- {}
737
- ]
585
+ "type": "boolean"
738
586
  },
739
587
  "cs": {
740
- "oneOf": [
741
- {
742
- "type": "boolean"
743
- },
744
- {}
745
- ]
588
+ "type": "boolean"
746
589
  },
747
590
  "bCs": {
748
- "oneOf": [
749
- {
750
- "type": "boolean"
751
- },
752
- {}
753
- ]
591
+ "type": "boolean"
754
592
  },
755
593
  "iCs": {
756
- "oneOf": [
757
- {
594
+ "type": "boolean"
595
+ },
596
+ "eastAsianLayout": {
597
+ "type": "object",
598
+ "properties": {
599
+ "id": {
600
+ "type": "string"
601
+ },
602
+ "combine": {
758
603
  "type": "boolean"
759
604
  },
760
- {}
761
- ]
762
- },
763
- "eastAsianLayout": {
764
- "oneOf": [
765
- {
766
- "type": "object",
767
- "properties": {
768
- "id": {
769
- "oneOf": [
770
- {
771
- "type": "string"
772
- },
773
- {}
774
- ]
775
- },
776
- "combine": {
777
- "oneOf": [
778
- {
779
- "type": "boolean"
780
- },
781
- {}
782
- ]
783
- },
784
- "combineBrackets": {
785
- "oneOf": [
786
- {
787
- "type": "string"
788
- },
789
- {}
790
- ]
791
- },
792
- "vert": {
793
- "oneOf": [
794
- {
795
- "type": "boolean"
796
- },
797
- {}
798
- ]
799
- },
800
- "vertCompress": {
801
- "oneOf": [
802
- {
803
- "type": "boolean"
804
- },
805
- {}
806
- ]
807
- }
808
- }
809
- },
810
- {}
811
- ]
605
+ "combineBrackets": {
606
+ "type": "string"
607
+ },
608
+ "vert": {
609
+ "type": "boolean"
610
+ },
611
+ "vertCompress": {
612
+ "type": "boolean"
613
+ }
614
+ }
812
615
  },
813
616
  "em": {
814
- "oneOf": [
815
- {
816
- "type": "string"
817
- },
818
- {}
819
- ]
617
+ "type": "string"
820
618
  },
821
619
  "fitText": {
822
- "oneOf": [
823
- {
824
- "type": "object",
825
- "properties": {
826
- "val": {
827
- "oneOf": [
828
- {
829
- "type": "number"
830
- },
831
- {}
832
- ]
833
- },
834
- "id": {
835
- "oneOf": [
836
- {
837
- "type": "string"
838
- },
839
- {}
840
- ]
841
- }
842
- }
620
+ "type": "object",
621
+ "properties": {
622
+ "val": {
623
+ "type": "number"
843
624
  },
844
- {}
845
- ]
625
+ "id": {
626
+ "type": "string"
627
+ }
628
+ }
846
629
  },
847
630
  "snapToGrid": {
848
- "oneOf": [
849
- {
850
- "type": "boolean"
851
- },
852
- {}
853
- ]
631
+ "type": "boolean"
854
632
  },
855
633
  "lang": {
856
- "oneOf": [
857
- {
858
- "type": "object",
859
- "properties": {
860
- "val": {
861
- "oneOf": [
862
- {
863
- "type": "string"
864
- },
865
- {}
866
- ]
867
- },
868
- "eastAsia": {
869
- "oneOf": [
870
- {
871
- "type": "string"
872
- },
873
- {}
874
- ]
875
- },
876
- "bidi": {
877
- "oneOf": [
878
- {
879
- "type": "string"
880
- },
881
- {}
882
- ]
883
- }
884
- }
634
+ "type": "object",
635
+ "properties": {
636
+ "val": {
637
+ "type": "string"
885
638
  },
886
- {}
887
- ]
639
+ "eastAsia": {
640
+ "type": "string"
641
+ },
642
+ "bidi": {
643
+ "type": "string"
644
+ }
645
+ }
888
646
  },
889
647
  "oMath": {
890
- "oneOf": [
891
- {
892
- "type": "boolean"
893
- },
894
- {}
895
- ]
648
+ "type": "boolean"
896
649
  },
897
650
  "rStyle": {
898
- "oneOf": [
899
- {
900
- "type": "string"
901
- },
902
- {}
903
- ]
651
+ "type": "string"
904
652
  },
905
653
  "rFonts": {
906
- "oneOf": [
907
- {
908
- "type": "object",
909
- "properties": {
910
- "ascii": {
911
- "oneOf": [
912
- {
913
- "type": "string"
914
- },
915
- {}
916
- ]
917
- },
918
- "hAnsi": {
919
- "oneOf": [
920
- {
921
- "type": "string"
922
- },
923
- {}
924
- ]
925
- },
926
- "eastAsia": {
927
- "oneOf": [
928
- {
929
- "type": "string"
930
- },
931
- {}
932
- ]
933
- },
934
- "cs": {
935
- "oneOf": [
936
- {
937
- "type": "string"
938
- },
939
- {}
940
- ]
941
- },
942
- "asciiTheme": {
943
- "oneOf": [
944
- {
945
- "type": "string"
946
- },
947
- {}
948
- ]
949
- },
950
- "hAnsiTheme": {
951
- "oneOf": [
952
- {
953
- "type": "string"
954
- },
955
- {}
956
- ]
957
- },
958
- "eastAsiaTheme": {
959
- "oneOf": [
960
- {
961
- "type": "string"
962
- },
963
- {}
964
- ]
965
- },
966
- "csTheme": {
967
- "oneOf": [
968
- {
969
- "type": "string"
970
- },
971
- {}
972
- ]
973
- },
974
- "hint": {
975
- "oneOf": [
976
- {
977
- "type": "string"
978
- },
979
- {}
980
- ]
981
- }
982
- }
654
+ "type": "object",
655
+ "properties": {
656
+ "ascii": {
657
+ "type": "string"
983
658
  },
984
- {}
985
- ]
659
+ "hAnsi": {
660
+ "type": "string"
661
+ },
662
+ "eastAsia": {
663
+ "type": "string"
664
+ },
665
+ "cs": {
666
+ "type": "string"
667
+ },
668
+ "asciiTheme": {
669
+ "type": "string"
670
+ },
671
+ "hAnsiTheme": {
672
+ "type": "string"
673
+ },
674
+ "eastAsiaTheme": {
675
+ "type": "string"
676
+ },
677
+ "csTheme": {
678
+ "type": "string"
679
+ },
680
+ "hint": {
681
+ "type": "string"
682
+ }
683
+ }
986
684
  },
987
685
  "fontSizeCs": {
988
- "oneOf": [
989
- {
990
- "type": "number"
991
- },
992
- {}
993
- ]
686
+ "type": "number"
994
687
  },
995
688
  "ligatures": {
996
- "oneOf": [
997
- {
998
- "type": "string"
999
- },
1000
- {}
1001
- ]
689
+ "type": "string"
1002
690
  },
1003
691
  "numForm": {
1004
- "oneOf": [
1005
- {
1006
- "type": "string"
1007
- },
1008
- {}
1009
- ]
692
+ "type": "string"
1010
693
  },
1011
694
  "numSpacing": {
1012
- "oneOf": [
1013
- {
1014
- "type": "string"
1015
- },
1016
- {}
1017
- ]
695
+ "type": "string"
1018
696
  },
1019
697
  "stylisticSets": {
1020
- "oneOf": [
1021
- {
1022
- "type": "array",
1023
- "items": {
1024
- "type": "object",
1025
- "properties": {
1026
- "id": {
1027
- "type": "number"
1028
- },
1029
- "val": {
1030
- "type": "boolean"
1031
- }
1032
- },
1033
- "required": [
1034
- "id"
1035
- ]
698
+ "type": "array",
699
+ "items": {
700
+ "type": "object",
701
+ "properties": {
702
+ "id": {
703
+ "type": "number"
704
+ },
705
+ "val": {
706
+ "type": "boolean"
1036
707
  }
1037
708
  },
1038
- {}
1039
- ]
709
+ "required": [
710
+ "id"
711
+ ]
712
+ }
1040
713
  },
1041
714
  "contextualAlternates": {
1042
- "oneOf": [
1043
- {
1044
- "type": "boolean"
1045
- },
1046
- {}
1047
- ]
715
+ "type": "boolean"
1048
716
  }
1049
- }
717
+ },
718
+ "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."
1050
719
  },
1051
720
  "ref": {
1052
- "type": "string"
721
+ "type": "string",
722
+ "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."
1053
723
  },
1054
724
  "blockId": {
1055
- "type": "string"
725
+ "type": "string",
726
+ "description": "Block ID of the target paragraph."
1056
727
  },
1057
728
  "start": {
1058
- "type": "number"
729
+ "type": "number",
730
+ "description": "Start offset within the block (character index)."
1059
731
  },
1060
732
  "end": {
1061
- "type": "number"
733
+ "type": "number",
734
+ "description": "End offset within the block (character index)."
1062
735
  },
1063
736
  "styleId": {
1064
- "type": "string"
737
+ "type": "string",
738
+ "description": "Required for action 'set_style'."
1065
739
  },
1066
740
  "alignment": {
1067
741
  "type": "string",
@@ -1070,36 +744,60 @@
1070
744
  "center",
1071
745
  "right",
1072
746
  "justify"
1073
- ]
747
+ ],
748
+ "description": "Required for action 'set_alignment'."
1074
749
  },
1075
750
  "left": {
1076
- "type": "number"
751
+ "type": "number",
752
+ "description": "Left indentation in twips (1440 = 1 inch)."
1077
753
  },
1078
754
  "right": {
1079
- "type": "number"
755
+ "type": "number",
756
+ "description": "Right indentation in twips (1440 = 1 inch)."
1080
757
  },
1081
758
  "firstLine": {
1082
- "type": "number"
759
+ "type": "number",
760
+ "description": "First line indent in twips. Cannot be combined with hanging."
1083
761
  },
1084
762
  "hanging": {
1085
- "type": "number"
763
+ "type": "number",
764
+ "description": "Hanging indent in twips. Cannot be combined with firstLine."
1086
765
  },
1087
766
  "before": {
1088
- "type": "number"
767
+ "type": "number",
768
+ "description": "Space before paragraph in twips (20 twips = 1pt)."
1089
769
  },
1090
770
  "after": {
1091
- "type": "number"
771
+ "type": "number",
772
+ "description": "Space after paragraph in twips (20 twips = 1pt)."
1092
773
  },
1093
774
  "line": {
1094
- "type": "number"
775
+ "type": "number",
776
+ "description": "Line spacing value. Meaning depends on lineRule. Must be provided together with lineRule."
1095
777
  },
1096
778
  "lineRule": {
1097
779
  "type": "string",
780
+ "description": "Line spacing rule. Required when 'line' is set.",
1098
781
  "enum": [
1099
782
  "auto",
1100
783
  "exact",
1101
784
  "atLeast"
1102
785
  ]
786
+ },
787
+ "direction": {
788
+ "type": "string",
789
+ "enum": [
790
+ "ltr",
791
+ "rtl"
792
+ ],
793
+ "description": "Required for action 'set_direction'."
794
+ },
795
+ "alignmentPolicy": {
796
+ "type": "string",
797
+ "enum": [
798
+ "preserve",
799
+ "matchDirection"
800
+ ]
1103
801
  }
1104
802
  },
1105
803
  "required": [
@@ -1109,13 +807,14 @@
1109
807
  },
1110
808
  "metadata": {
1111
809
  "mutates": true,
1112
- "operationCount": 5,
810
+ "operationCount": 6,
1113
811
  "operations": [
1114
812
  "doc.format.apply",
1115
813
  "doc.styles.paragraph.setStyle",
1116
814
  "doc.format.paragraph.setAlignment",
1117
815
  "doc.format.paragraph.setIndentation",
1118
- "doc.format.paragraph.setSpacing"
816
+ "doc.format.paragraph.setSpacing",
817
+ "doc.format.paragraph.setDirection"
1119
818
  ]
1120
819
  }
1121
820
  },
@@ -1134,26 +833,28 @@
1134
833
  "description": "The action to perform. One of: heading, paragraph."
1135
834
  },
1136
835
  "doc": {
1137
- "type": "string"
836
+ "type": "string",
837
+ "description": "Document path. Optional when a session is already open."
1138
838
  },
1139
839
  "sessionId": {
1140
- "type": "string"
840
+ "type": "string",
841
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1141
842
  },
1142
843
  "force": {
1143
- "type": "boolean"
1144
- },
1145
- "expectedRevision": {
1146
- "type": "number"
844
+ "type": "boolean",
845
+ "description": "Bypass confirmation checks."
1147
846
  },
1148
847
  "changeMode": {
1149
848
  "type": "string",
1150
849
  "enum": [
1151
850
  "direct",
1152
851
  "tracked"
1153
- ]
852
+ ],
853
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1154
854
  },
1155
855
  "dryRun": {
1156
- "type": "boolean"
856
+ "type": "boolean",
857
+ "description": "Preview the result without applying changes."
1157
858
  },
1158
859
  "at": {
1159
860
  "oneOf": [
@@ -1267,16 +968,20 @@
1267
968
  "target"
1268
969
  ]
1269
970
  }
1270
- ]
971
+ ],
972
+ "description": "Position: {kind:'documentEnd'} to append, {kind:'documentStart'} to prepend, or {kind:'before'|'after', target:{kind:'block', nodeType:'...', nodeId:'...'}} for relative placement."
1271
973
  },
1272
974
  "text": {
1273
- "type": "string"
975
+ "type": "string",
976
+ "description": "Paragraph text content."
1274
977
  },
1275
978
  "input": {
1276
- "type": "object"
979
+ "type": "object",
980
+ "description": "Full paragraph input as JSON (alternative to individual text/at params)."
1277
981
  },
1278
982
  "level": {
1279
- "type": "number"
983
+ "type": "number",
984
+ "description": "Heading level (1-6). Required for action 'heading'."
1280
985
  }
1281
986
  },
1282
987
  "required": [
@@ -1313,26 +1018,28 @@
1313
1018
  "description": "The action to perform. One of: create, detach, indent, insert, outdent, set_level, set_type."
1314
1019
  },
1315
1020
  "doc": {
1316
- "type": "string"
1021
+ "type": "string",
1022
+ "description": "Document path. Optional when a session is already open."
1317
1023
  },
1318
1024
  "sessionId": {
1319
- "type": "string"
1025
+ "type": "string",
1026
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1320
1027
  },
1321
1028
  "force": {
1322
- "type": "boolean"
1323
- },
1324
- "expectedRevision": {
1325
- "type": "number"
1029
+ "type": "boolean",
1030
+ "description": "Bypass confirmation checks."
1326
1031
  },
1327
1032
  "changeMode": {
1328
1033
  "type": "string",
1329
1034
  "enum": [
1330
1035
  "direct",
1331
1036
  "tracked"
1332
- ]
1037
+ ],
1038
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1333
1039
  },
1334
1040
  "dryRun": {
1335
- "type": "boolean"
1041
+ "type": "boolean",
1042
+ "description": "Preview the result without applying changes."
1336
1043
  },
1337
1044
  "target": {
1338
1045
  "type": "object",
@@ -1353,26 +1060,32 @@
1353
1060
  "kind",
1354
1061
  "nodeType",
1355
1062
  "nodeId"
1356
- ]
1063
+ ],
1064
+ "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'."
1357
1065
  },
1358
1066
  "position": {
1359
1067
  "type": "string",
1068
+ "description": "Required. Insert position relative to target: 'before' or 'after'. Required for action 'insert'.",
1360
1069
  "enum": [
1361
1070
  "before",
1362
1071
  "after"
1363
1072
  ]
1364
1073
  },
1365
1074
  "text": {
1366
- "type": "string"
1075
+ "type": "string",
1076
+ "description": "Text content for the new list item."
1367
1077
  },
1368
1078
  "input": {
1369
- "type": "object"
1079
+ "type": "object",
1080
+ "description": "Operation input as JSON object."
1370
1081
  },
1371
1082
  "nodeId": {
1372
- "type": "string"
1083
+ "type": "string",
1084
+ "description": "Node ID of the target list item."
1373
1085
  },
1374
1086
  "mode": {
1375
1087
  "type": "string",
1088
+ "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'.",
1376
1089
  "enum": [
1377
1090
  "empty",
1378
1091
  "fromParagraphs"
@@ -1397,45 +1110,167 @@
1397
1110
  "kind",
1398
1111
  "nodeType",
1399
1112
  "nodeId"
1400
- ]
1113
+ ],
1114
+ "description": "Required when mode is 'empty'. The paragraph to create the list at. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
1401
1115
  },
1402
1116
  "kind": {
1403
1117
  "type": "string",
1118
+ "description": "List type: 'bullet' for bullet points, 'ordered' for numbered lists. Required for action 'set_type'.",
1404
1119
  "enum": [
1405
1120
  "ordered",
1406
1121
  "bullet"
1407
1122
  ]
1408
1123
  },
1409
1124
  "level": {
1410
- "type": "number"
1125
+ "type": "number",
1126
+ "description": "List nesting level (0-8). 0 is the top level. Required for action 'set_level'."
1411
1127
  },
1412
- "continuity": {
1128
+ "preset": {
1413
1129
  "type": "string",
1130
+ "description": "Predefined list style preset. Overrides 'kind' with a specific numbering or bullet format.",
1414
1131
  "enum": [
1415
- "preserve",
1416
- "none"
1132
+ "decimal",
1133
+ "decimalParenthesis",
1134
+ "lowerLetter",
1135
+ "upperLetter",
1136
+ "lowerRoman",
1137
+ "upperRoman",
1138
+ "disc",
1139
+ "circle",
1140
+ "square",
1141
+ "dash"
1417
1142
  ]
1418
- }
1419
- },
1420
- "required": [
1421
- "action"
1422
- ],
1423
- "additionalProperties": false
1424
- },
1425
- "metadata": {
1426
- "mutates": true,
1427
- "operationCount": 7,
1428
- "operations": [
1429
- "doc.lists.insert",
1430
- "doc.lists.create",
1431
- "doc.lists.detach",
1432
- "doc.lists.indent",
1433
- "doc.lists.outdent",
1434
- "doc.lists.setLevel",
1435
- "doc.lists.setType"
1436
- ]
1437
- }
1438
- },
1143
+ },
1144
+ "style": {
1145
+ "type": "object",
1146
+ "properties": {
1147
+ "version": {
1148
+ "const": 1,
1149
+ "type": "number"
1150
+ },
1151
+ "levels": {
1152
+ "type": "array",
1153
+ "items": {
1154
+ "type": "object",
1155
+ "properties": {
1156
+ "level": {
1157
+ "type": "number"
1158
+ },
1159
+ "numFmt": {
1160
+ "type": "string"
1161
+ },
1162
+ "lvlText": {
1163
+ "type": "string"
1164
+ },
1165
+ "start": {
1166
+ "type": "number"
1167
+ },
1168
+ "alignment": {
1169
+ "enum": [
1170
+ "left",
1171
+ "center",
1172
+ "right"
1173
+ ]
1174
+ },
1175
+ "indents": {
1176
+ "type": "object",
1177
+ "properties": {
1178
+ "left": {
1179
+ "type": "number"
1180
+ },
1181
+ "hanging": {
1182
+ "type": "number"
1183
+ },
1184
+ "firstLine": {
1185
+ "type": "number"
1186
+ }
1187
+ }
1188
+ },
1189
+ "trailingCharacter": {
1190
+ "enum": [
1191
+ "tab",
1192
+ "space",
1193
+ "nothing"
1194
+ ]
1195
+ },
1196
+ "markerFont": {
1197
+ "type": "string"
1198
+ },
1199
+ "pictureBulletId": {
1200
+ "type": "number"
1201
+ },
1202
+ "tabStopAt": {}
1203
+ },
1204
+ "required": [
1205
+ "level"
1206
+ ]
1207
+ }
1208
+ }
1209
+ },
1210
+ "required": [
1211
+ "version",
1212
+ "levels"
1213
+ ]
1214
+ },
1215
+ "sequence": {
1216
+ "oneOf": [
1217
+ {
1218
+ "type": "object",
1219
+ "properties": {
1220
+ "mode": {
1221
+ "const": "new",
1222
+ "type": "string"
1223
+ },
1224
+ "startAt": {
1225
+ "type": "number"
1226
+ }
1227
+ },
1228
+ "required": [
1229
+ "mode"
1230
+ ]
1231
+ },
1232
+ {
1233
+ "type": "object",
1234
+ "properties": {
1235
+ "mode": {
1236
+ "const": "continuePrevious",
1237
+ "type": "string"
1238
+ }
1239
+ },
1240
+ "required": [
1241
+ "mode"
1242
+ ]
1243
+ }
1244
+ ]
1245
+ },
1246
+ "continuity": {
1247
+ "type": "string",
1248
+ "description": "Numbering continuity: 'preserve' keeps numbering; 'none' restarts.",
1249
+ "enum": [
1250
+ "preserve",
1251
+ "none"
1252
+ ]
1253
+ }
1254
+ },
1255
+ "required": [
1256
+ "action"
1257
+ ],
1258
+ "additionalProperties": false
1259
+ },
1260
+ "metadata": {
1261
+ "mutates": true,
1262
+ "operationCount": 7,
1263
+ "operations": [
1264
+ "doc.lists.insert",
1265
+ "doc.lists.create",
1266
+ "doc.lists.detach",
1267
+ "doc.lists.indent",
1268
+ "doc.lists.outdent",
1269
+ "doc.lists.setLevel",
1270
+ "doc.lists.setType"
1271
+ ]
1272
+ }
1273
+ },
1439
1274
  {
1440
1275
  "name": "superdoc_comment",
1441
1276
  "description": "Comment threads — create, edit, delete",
@@ -1454,26 +1289,28 @@
1454
1289
  "description": "The action to perform. One of: create, delete, get, list, update."
1455
1290
  },
1456
1291
  "doc": {
1457
- "type": "string"
1292
+ "type": "string",
1293
+ "description": "Document path. Optional when a session is already open."
1458
1294
  },
1459
1295
  "sessionId": {
1460
- "type": "string"
1296
+ "type": "string",
1297
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1461
1298
  },
1462
1299
  "force": {
1463
- "type": "boolean"
1464
- },
1465
- "expectedRevision": {
1466
- "type": "number"
1300
+ "type": "boolean",
1301
+ "description": "Bypass confirmation checks."
1467
1302
  },
1468
1303
  "changeMode": {
1469
1304
  "type": "string",
1470
1305
  "enum": [
1471
1306
  "direct",
1472
1307
  "tracked"
1473
- ]
1308
+ ],
1309
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1474
1310
  },
1475
1311
  "text": {
1476
- "type": "string"
1312
+ "type": "string",
1313
+ "description": "Comment text content. Required for action 'create'."
1477
1314
  },
1478
1315
  "target": {
1479
1316
  "type": "object",
@@ -1505,40 +1342,51 @@
1505
1342
  "kind",
1506
1343
  "blockId",
1507
1344
  "range"
1508
- ]
1345
+ ],
1346
+ "description": "Text range to anchor the comment: {kind:'text', blockId:'...', range:{start:N, end:N}}."
1509
1347
  },
1510
1348
  "parentId": {
1511
- "type": "string"
1349
+ "type": "string",
1350
+ "description": "Parent comment ID for creating a threaded reply."
1512
1351
  },
1513
1352
  "blockId": {
1514
- "type": "string"
1353
+ "type": "string",
1354
+ "description": "Block ID of the target paragraph."
1515
1355
  },
1516
1356
  "start": {
1517
- "type": "number"
1357
+ "type": "number",
1358
+ "description": "Start offset within the block (character index)."
1518
1359
  },
1519
1360
  "end": {
1520
- "type": "number"
1361
+ "type": "number",
1362
+ "description": "End offset within the block (character index)."
1521
1363
  },
1522
1364
  "id": {
1523
- "type": "string"
1365
+ "type": "string",
1366
+ "description": "Required for actions 'delete', 'get'."
1524
1367
  },
1525
1368
  "status": {
1526
1369
  "type": "string",
1370
+ "description": "Set comment status. Use 'resolved' to mark as resolved.",
1527
1371
  "enum": [
1528
1372
  "resolved"
1529
1373
  ]
1530
1374
  },
1531
1375
  "isInternal": {
1532
- "type": "boolean"
1376
+ "type": "boolean",
1377
+ "description": "When true, marks the comment as internal (hidden from external collaborators)."
1533
1378
  },
1534
1379
  "includeResolved": {
1535
- "type": "boolean"
1380
+ "type": "boolean",
1381
+ "description": "When true, includes resolved comments in results. Default: false."
1536
1382
  },
1537
1383
  "limit": {
1538
- "type": "number"
1384
+ "type": "number",
1385
+ "description": "Maximum number of comments to return."
1539
1386
  },
1540
1387
  "offset": {
1541
- "type": "number"
1388
+ "type": "number",
1389
+ "description": "Number of comments to skip for pagination."
1542
1390
  }
1543
1391
  },
1544
1392
  "required": [
@@ -1573,19 +1421,24 @@
1573
1421
  "description": "The action to perform. One of: decide, list."
1574
1422
  },
1575
1423
  "doc": {
1576
- "type": "string"
1424
+ "type": "string",
1425
+ "description": "Document path. Optional when a session is already open."
1577
1426
  },
1578
1427
  "sessionId": {
1579
- "type": "string"
1428
+ "type": "string",
1429
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1580
1430
  },
1581
1431
  "limit": {
1582
- "type": "number"
1432
+ "type": "number",
1433
+ "description": "Maximum number of tracked changes to return."
1583
1434
  },
1584
1435
  "offset": {
1585
- "type": "number"
1436
+ "type": "number",
1437
+ "description": "Number of tracked changes to skip for pagination."
1586
1438
  },
1587
1439
  "type": {
1588
1440
  "type": "string",
1441
+ "description": "Filter by change type: 'insert', 'delete', or 'format'.",
1589
1442
  "enum": [
1590
1443
  "insert",
1591
1444
  "delete",
@@ -1593,24 +1446,24 @@
1593
1446
  ]
1594
1447
  },
1595
1448
  "force": {
1596
- "type": "boolean"
1597
- },
1598
- "expectedRevision": {
1599
- "type": "number"
1449
+ "type": "boolean",
1450
+ "description": "Bypass confirmation checks."
1600
1451
  },
1601
1452
  "changeMode": {
1602
1453
  "type": "string",
1603
1454
  "enum": [
1604
1455
  "direct",
1605
1456
  "tracked"
1606
- ]
1457
+ ],
1458
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
1607
1459
  },
1608
1460
  "decision": {
1609
1461
  "type": "string",
1610
1462
  "enum": [
1611
1463
  "accept",
1612
1464
  "reject"
1613
- ]
1465
+ ],
1466
+ "description": "Required for action 'decide'."
1614
1467
  },
1615
1468
  "target": {
1616
1469
  "oneOf": [
@@ -1638,7 +1491,8 @@
1638
1491
  "scope"
1639
1492
  ]
1640
1493
  }
1641
- ]
1494
+ ],
1495
+ "description": "Required for action 'decide'."
1642
1496
  }
1643
1497
  },
1644
1498
  "required": [
@@ -1662,10 +1516,12 @@
1662
1516
  "type": "object",
1663
1517
  "properties": {
1664
1518
  "doc": {
1665
- "type": "string"
1519
+ "type": "string",
1520
+ "description": "Document path. Optional when a session is already open."
1666
1521
  },
1667
1522
  "sessionId": {
1668
- "type": "string"
1523
+ "type": "string",
1524
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1669
1525
  },
1670
1526
  "select": {
1671
1527
  "oneOf": [
@@ -1674,19 +1530,23 @@
1674
1530
  "properties": {
1675
1531
  "type": {
1676
1532
  "const": "text",
1533
+ "description": "Must be 'text' for text pattern search.",
1677
1534
  "type": "string"
1678
1535
  },
1679
1536
  "pattern": {
1680
- "type": "string"
1537
+ "type": "string",
1538
+ "description": "Text or regex pattern to match."
1681
1539
  },
1682
1540
  "mode": {
1541
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
1683
1542
  "enum": [
1684
1543
  "contains",
1685
1544
  "regex"
1686
1545
  ]
1687
1546
  },
1688
1547
  "caseSensitive": {
1689
- "type": "boolean"
1548
+ "type": "boolean",
1549
+ "description": "Case-sensitive matching. Default: false."
1690
1550
  }
1691
1551
  },
1692
1552
  "required": [
@@ -1699,9 +1559,11 @@
1699
1559
  "properties": {
1700
1560
  "type": {
1701
1561
  "const": "node",
1562
+ "description": "Must be 'node' for node type search.",
1702
1563
  "type": "string"
1703
1564
  },
1704
1565
  "nodeType": {
1566
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
1705
1567
  "enum": [
1706
1568
  "paragraph",
1707
1569
  "heading",
@@ -1728,6 +1590,7 @@
1728
1590
  ]
1729
1591
  },
1730
1592
  "kind": {
1593
+ "description": "Filter: 'block' or 'inline'.",
1731
1594
  "enum": [
1732
1595
  "block",
1733
1596
  "inline"
@@ -1738,7 +1601,8 @@
1738
1601
  "type"
1739
1602
  ]
1740
1603
  }
1741
- ]
1604
+ ],
1605
+ "description": "Search selector. Use {type:'text', pattern:'...'} for text search or {type:'node', nodeType:'paragraph'|'heading'|...} for node search."
1742
1606
  },
1743
1607
  "within": {
1744
1608
  "type": "object",
@@ -1768,10 +1632,12 @@
1768
1632
  "kind",
1769
1633
  "nodeType",
1770
1634
  "nodeId"
1771
- ]
1635
+ ],
1636
+ "description": "Limit search scope to within a specific block: {kind:'block', nodeType:'...', nodeId:'...'}."
1772
1637
  },
1773
1638
  "require": {
1774
1639
  "type": "string",
1640
+ "description": "Match cardinality: 'any' (all matches), 'first' (only first), 'exactlyOne' (fail if != 1), 'all' (fail if 0).",
1775
1641
  "enum": [
1776
1642
  "any",
1777
1643
  "first",
@@ -1781,19 +1647,23 @@
1781
1647
  },
1782
1648
  "mode": {
1783
1649
  "type": "string",
1650
+ "description": "Search mode: 'strict' (default, exact matching) or 'candidates' (returns scored potential matches).",
1784
1651
  "enum": [
1785
1652
  "strict",
1786
1653
  "candidates"
1787
1654
  ]
1788
1655
  },
1789
1656
  "includeNodes": {
1790
- "type": "boolean"
1657
+ "type": "boolean",
1658
+ "description": "When true, includes full node data in results. Default: false."
1791
1659
  },
1792
1660
  "limit": {
1793
- "type": "number"
1661
+ "type": "number",
1662
+ "description": "Maximum number of matches to return."
1794
1663
  },
1795
1664
  "offset": {
1796
- "type": "number"
1665
+ "type": "number",
1666
+ "description": "Number of matches to skip for pagination."
1797
1667
  }
1798
1668
  },
1799
1669
  "required": [
@@ -1824,19 +1694,24 @@
1824
1694
  "description": "The action to perform. One of: apply, preview."
1825
1695
  },
1826
1696
  "doc": {
1827
- "type": "string"
1697
+ "type": "string",
1698
+ "description": "Document path. Optional when a session is already open."
1828
1699
  },
1829
1700
  "sessionId": {
1830
- "type": "string"
1701
+ "type": "string",
1702
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
1831
1703
  },
1832
1704
  "expectedRevision": {
1833
- "type": "string"
1705
+ "type": "string",
1706
+ "description": "Document revision for optimistic concurrency. Mutation fails if document was modified since this revision."
1834
1707
  },
1835
1708
  "atomic": {
1836
- "type": "boolean"
1709
+ "type": "boolean",
1710
+ "description": "Must be true. All steps execute as one atomic transaction."
1837
1711
  },
1838
1712
  "changeMode": {
1839
1713
  "type": "string",
1714
+ "description": "Required. Use 'direct' for immediate edits or 'tracked' for suggestions. Must always be provided.",
1840
1715
  "enum": [
1841
1716
  "direct",
1842
1717
  "tracked"
@@ -1872,19 +1747,23 @@
1872
1747
  "properties": {
1873
1748
  "type": {
1874
1749
  "const": "text",
1750
+ "description": "Must be 'text' for text pattern search.",
1875
1751
  "type": "string"
1876
1752
  },
1877
1753
  "pattern": {
1878
- "type": "string"
1754
+ "type": "string",
1755
+ "description": "Text or regex pattern to match."
1879
1756
  },
1880
1757
  "mode": {
1758
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
1881
1759
  "enum": [
1882
1760
  "contains",
1883
1761
  "regex"
1884
1762
  ]
1885
1763
  },
1886
1764
  "caseSensitive": {
1887
- "type": "boolean"
1765
+ "type": "boolean",
1766
+ "description": "Case-sensitive matching. Default: false."
1888
1767
  }
1889
1768
  },
1890
1769
  "required": [
@@ -1897,9 +1776,11 @@
1897
1776
  "properties": {
1898
1777
  "type": {
1899
1778
  "const": "node",
1779
+ "description": "Must be 'node' for node type search.",
1900
1780
  "type": "string"
1901
1781
  },
1902
1782
  "nodeType": {
1783
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
1903
1784
  "enum": [
1904
1785
  "paragraph",
1905
1786
  "heading",
@@ -1926,6 +1807,7 @@
1926
1807
  ]
1927
1808
  },
1928
1809
  "kind": {
1810
+ "description": "Filter: 'block' or 'inline'.",
1929
1811
  "enum": [
1930
1812
  "block",
1931
1813
  "inline"
@@ -2111,7 +1993,8 @@
2111
1993
  "edge"
2112
1994
  ]
2113
1995
  }
2114
- ]
1996
+ ],
1997
+ "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."
2115
1998
  },
2116
1999
  "end": {
2117
2000
  "oneOf": [
@@ -2182,7 +2065,8 @@
2182
2065
  "edge"
2183
2066
  ]
2184
2067
  }
2185
- ]
2068
+ ],
2069
+ "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."
2186
2070
  }
2187
2071
  },
2188
2072
  "required": [
@@ -2359,19 +2243,23 @@
2359
2243
  "properties": {
2360
2244
  "type": {
2361
2245
  "const": "text",
2246
+ "description": "Must be 'text' for text pattern search.",
2362
2247
  "type": "string"
2363
2248
  },
2364
2249
  "pattern": {
2365
- "type": "string"
2250
+ "type": "string",
2251
+ "description": "Text or regex pattern to match."
2366
2252
  },
2367
2253
  "mode": {
2254
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2368
2255
  "enum": [
2369
2256
  "contains",
2370
2257
  "regex"
2371
2258
  ]
2372
2259
  },
2373
2260
  "caseSensitive": {
2374
- "type": "boolean"
2261
+ "type": "boolean",
2262
+ "description": "Case-sensitive matching. Default: false."
2375
2263
  }
2376
2264
  },
2377
2265
  "required": [
@@ -2384,9 +2272,11 @@
2384
2272
  "properties": {
2385
2273
  "type": {
2386
2274
  "const": "node",
2275
+ "description": "Must be 'node' for node type search.",
2387
2276
  "type": "string"
2388
2277
  },
2389
2278
  "nodeType": {
2279
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2390
2280
  "enum": [
2391
2281
  "paragraph",
2392
2282
  "heading",
@@ -2413,6 +2303,7 @@
2413
2303
  ]
2414
2304
  },
2415
2305
  "kind": {
2306
+ "description": "Filter: 'block' or 'inline'.",
2416
2307
  "enum": [
2417
2308
  "block",
2418
2309
  "inline"
@@ -2584,19 +2475,23 @@
2584
2475
  "properties": {
2585
2476
  "type": {
2586
2477
  "const": "text",
2478
+ "description": "Must be 'text' for text pattern search.",
2587
2479
  "type": "string"
2588
2480
  },
2589
2481
  "pattern": {
2590
- "type": "string"
2482
+ "type": "string",
2483
+ "description": "Text or regex pattern to match."
2591
2484
  },
2592
2485
  "mode": {
2486
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2593
2487
  "enum": [
2594
2488
  "contains",
2595
2489
  "regex"
2596
2490
  ]
2597
2491
  },
2598
2492
  "caseSensitive": {
2599
- "type": "boolean"
2493
+ "type": "boolean",
2494
+ "description": "Case-sensitive matching. Default: false."
2600
2495
  }
2601
2496
  },
2602
2497
  "required": [
@@ -2609,9 +2504,11 @@
2609
2504
  "properties": {
2610
2505
  "type": {
2611
2506
  "const": "node",
2507
+ "description": "Must be 'node' for node type search.",
2612
2508
  "type": "string"
2613
2509
  },
2614
2510
  "nodeType": {
2511
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2615
2512
  "enum": [
2616
2513
  "paragraph",
2617
2514
  "heading",
@@ -2638,6 +2535,7 @@
2638
2535
  ]
2639
2536
  },
2640
2537
  "kind": {
2538
+ "description": "Filter: 'block' or 'inline'.",
2641
2539
  "enum": [
2642
2540
  "block",
2643
2541
  "inline"
@@ -2823,7 +2721,8 @@
2823
2721
  "edge"
2824
2722
  ]
2825
2723
  }
2826
- ]
2724
+ ],
2725
+ "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."
2827
2726
  },
2828
2727
  "end": {
2829
2728
  "oneOf": [
@@ -2894,7 +2793,8 @@
2894
2793
  "edge"
2895
2794
  ]
2896
2795
  }
2897
- ]
2796
+ ],
2797
+ "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."
2898
2798
  }
2899
2799
  },
2900
2800
  "required": [
@@ -2956,19 +2856,23 @@
2956
2856
  "properties": {
2957
2857
  "type": {
2958
2858
  "const": "text",
2859
+ "description": "Must be 'text' for text pattern search.",
2959
2860
  "type": "string"
2960
2861
  },
2961
2862
  "pattern": {
2962
- "type": "string"
2863
+ "type": "string",
2864
+ "description": "Text or regex pattern to match."
2963
2865
  },
2964
2866
  "mode": {
2867
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
2965
2868
  "enum": [
2966
2869
  "contains",
2967
2870
  "regex"
2968
2871
  ]
2969
2872
  },
2970
2873
  "caseSensitive": {
2971
- "type": "boolean"
2874
+ "type": "boolean",
2875
+ "description": "Case-sensitive matching. Default: false."
2972
2876
  }
2973
2877
  },
2974
2878
  "required": [
@@ -2981,9 +2885,11 @@
2981
2885
  "properties": {
2982
2886
  "type": {
2983
2887
  "const": "node",
2888
+ "description": "Must be 'node' for node type search.",
2984
2889
  "type": "string"
2985
2890
  },
2986
2891
  "nodeType": {
2892
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
2987
2893
  "enum": [
2988
2894
  "paragraph",
2989
2895
  "heading",
@@ -3010,6 +2916,7 @@
3010
2916
  ]
3011
2917
  },
3012
2918
  "kind": {
2919
+ "description": "Filter: 'block' or 'inline'.",
3013
2920
  "enum": [
3014
2921
  "block",
3015
2922
  "inline"
@@ -3195,7 +3102,8 @@
3195
3102
  "edge"
3196
3103
  ]
3197
3104
  }
3198
- ]
3105
+ ],
3106
+ "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."
3199
3107
  },
3200
3108
  "end": {
3201
3109
  "oneOf": [
@@ -3266,7 +3174,8 @@
3266
3174
  "edge"
3267
3175
  ]
3268
3176
  }
3269
- ]
3177
+ ],
3178
+ "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."
3270
3179
  }
3271
3180
  },
3272
3181
  "required": [
@@ -3290,615 +3199,259 @@
3290
3199
  "type": "object",
3291
3200
  "properties": {
3292
3201
  "bold": {
3293
- "oneOf": [
3294
- {
3295
- "type": "boolean"
3296
- },
3297
- {}
3298
- ]
3202
+ "type": "boolean"
3299
3203
  },
3300
3204
  "italic": {
3301
- "oneOf": [
3302
- {
3303
- "type": "boolean"
3304
- },
3305
- {}
3306
- ]
3205
+ "type": "boolean"
3307
3206
  },
3308
3207
  "strike": {
3309
- "oneOf": [
3310
- {
3311
- "type": "boolean"
3312
- },
3313
- {}
3314
- ]
3208
+ "type": "boolean"
3315
3209
  },
3316
3210
  "underline": {
3317
3211
  "oneOf": [
3318
3212
  {
3319
3213
  "type": "boolean"
3320
3214
  },
3321
- {},
3322
3215
  {
3323
3216
  "type": "object",
3324
3217
  "properties": {
3325
3218
  "style": {
3326
- "oneOf": [
3327
- {
3328
- "type": "string"
3329
- },
3330
- {}
3331
- ]
3219
+ "type": "string"
3332
3220
  },
3333
3221
  "color": {
3334
- "oneOf": [
3335
- {
3336
- "type": "string"
3337
- },
3338
- {}
3339
- ]
3222
+ "type": "string"
3340
3223
  },
3341
3224
  "themeColor": {
3342
- "oneOf": [
3343
- {
3344
- "type": "string"
3345
- },
3346
- {}
3347
- ]
3225
+ "type": "string"
3348
3226
  }
3349
3227
  }
3350
3228
  }
3351
3229
  ]
3352
3230
  },
3353
3231
  "highlight": {
3354
- "oneOf": [
3355
- {
3356
- "type": "string"
3357
- },
3358
- {}
3359
- ]
3232
+ "type": "string"
3360
3233
  },
3361
3234
  "color": {
3362
- "oneOf": [
3363
- {
3364
- "type": "string"
3365
- },
3366
- {}
3367
- ]
3235
+ "type": "string"
3368
3236
  },
3369
3237
  "fontSize": {
3370
- "oneOf": [
3371
- {
3372
- "type": "number"
3373
- },
3374
- {}
3375
- ]
3238
+ "type": "number"
3376
3239
  },
3377
3240
  "fontFamily": {
3378
- "oneOf": [
3379
- {
3380
- "type": "string"
3381
- },
3382
- {}
3383
- ]
3241
+ "type": "string"
3384
3242
  },
3385
3243
  "letterSpacing": {
3386
- "oneOf": [
3387
- {
3388
- "type": "number"
3389
- },
3390
- {}
3391
- ]
3244
+ "type": "number"
3392
3245
  },
3393
3246
  "vertAlign": {
3394
- "oneOf": [
3395
- {
3396
- "enum": [
3397
- "superscript",
3398
- "subscript",
3399
- "baseline"
3400
- ]
3401
- },
3402
- {}
3247
+ "enum": [
3248
+ "superscript",
3249
+ "subscript",
3250
+ "baseline"
3403
3251
  ]
3404
3252
  },
3405
3253
  "position": {
3406
- "oneOf": [
3407
- {
3408
- "type": "number"
3409
- },
3410
- {}
3411
- ]
3254
+ "type": "number"
3412
3255
  },
3413
3256
  "dstrike": {
3414
- "oneOf": [
3415
- {
3416
- "type": "boolean"
3417
- },
3418
- {}
3419
- ]
3257
+ "type": "boolean"
3420
3258
  },
3421
3259
  "smallCaps": {
3422
- "oneOf": [
3423
- {
3424
- "type": "boolean"
3425
- },
3426
- {}
3427
- ]
3260
+ "type": "boolean"
3428
3261
  },
3429
3262
  "caps": {
3430
- "oneOf": [
3431
- {
3432
- "type": "boolean"
3433
- },
3434
- {}
3435
- ]
3263
+ "type": "boolean"
3436
3264
  },
3437
3265
  "shading": {
3438
- "oneOf": [
3439
- {
3440
- "type": "object",
3441
- "properties": {
3442
- "fill": {
3443
- "oneOf": [
3444
- {
3445
- "type": "string"
3446
- },
3447
- {}
3448
- ]
3449
- },
3450
- "color": {
3451
- "oneOf": [
3452
- {
3453
- "type": "string"
3454
- },
3455
- {}
3456
- ]
3457
- },
3458
- "val": {
3459
- "oneOf": [
3460
- {
3461
- "type": "string"
3462
- },
3463
- {}
3464
- ]
3465
- }
3466
- }
3266
+ "type": "object",
3267
+ "properties": {
3268
+ "fill": {
3269
+ "type": "string"
3467
3270
  },
3468
- {}
3469
- ]
3271
+ "color": {
3272
+ "type": "string"
3273
+ },
3274
+ "val": {
3275
+ "type": "string"
3276
+ }
3277
+ }
3470
3278
  },
3471
3279
  "border": {
3472
- "oneOf": [
3473
- {
3474
- "type": "object",
3475
- "properties": {
3476
- "val": {
3477
- "oneOf": [
3478
- {
3479
- "type": "string"
3480
- },
3481
- {}
3482
- ]
3483
- },
3484
- "sz": {
3485
- "oneOf": [
3486
- {
3487
- "type": "number"
3488
- },
3489
- {}
3490
- ]
3491
- },
3492
- "color": {
3493
- "oneOf": [
3494
- {
3495
- "type": "string"
3496
- },
3497
- {}
3498
- ]
3499
- },
3500
- "space": {
3501
- "oneOf": [
3502
- {
3503
- "type": "number"
3504
- },
3505
- {}
3506
- ]
3507
- }
3508
- }
3280
+ "type": "object",
3281
+ "properties": {
3282
+ "val": {
3283
+ "type": "string"
3509
3284
  },
3510
- {}
3511
- ]
3285
+ "sz": {
3286
+ "type": "number"
3287
+ },
3288
+ "color": {
3289
+ "type": "string"
3290
+ },
3291
+ "space": {
3292
+ "type": "number"
3293
+ }
3294
+ }
3512
3295
  },
3513
3296
  "outline": {
3514
- "oneOf": [
3515
- {
3516
- "type": "boolean"
3517
- },
3518
- {}
3519
- ]
3297
+ "type": "boolean"
3520
3298
  },
3521
3299
  "shadow": {
3522
- "oneOf": [
3523
- {
3524
- "type": "boolean"
3525
- },
3526
- {}
3527
- ]
3300
+ "type": "boolean"
3528
3301
  },
3529
3302
  "emboss": {
3530
- "oneOf": [
3531
- {
3532
- "type": "boolean"
3533
- },
3534
- {}
3535
- ]
3303
+ "type": "boolean"
3536
3304
  },
3537
3305
  "imprint": {
3538
- "oneOf": [
3539
- {
3540
- "type": "boolean"
3541
- },
3542
- {}
3543
- ]
3306
+ "type": "boolean"
3544
3307
  },
3545
3308
  "charScale": {
3546
- "oneOf": [
3547
- {
3548
- "type": "number"
3549
- },
3550
- {}
3551
- ]
3309
+ "type": "number"
3552
3310
  },
3553
3311
  "kerning": {
3554
- "oneOf": [
3555
- {
3556
- "type": "number"
3557
- },
3558
- {}
3559
- ]
3312
+ "type": "number"
3560
3313
  },
3561
3314
  "vanish": {
3562
- "oneOf": [
3563
- {
3564
- "type": "boolean"
3565
- },
3566
- {}
3567
- ]
3315
+ "type": "boolean"
3568
3316
  },
3569
3317
  "webHidden": {
3570
- "oneOf": [
3571
- {
3572
- "type": "boolean"
3573
- },
3574
- {}
3575
- ]
3318
+ "type": "boolean"
3576
3319
  },
3577
3320
  "specVanish": {
3578
- "oneOf": [
3579
- {
3580
- "type": "boolean"
3581
- },
3582
- {}
3583
- ]
3321
+ "type": "boolean"
3584
3322
  },
3585
3323
  "rtl": {
3586
- "oneOf": [
3587
- {
3588
- "type": "boolean"
3589
- },
3590
- {}
3591
- ]
3324
+ "type": "boolean"
3592
3325
  },
3593
3326
  "cs": {
3594
- "oneOf": [
3595
- {
3596
- "type": "boolean"
3597
- },
3598
- {}
3599
- ]
3327
+ "type": "boolean"
3600
3328
  },
3601
3329
  "bCs": {
3602
- "oneOf": [
3603
- {
3604
- "type": "boolean"
3605
- },
3606
- {}
3607
- ]
3330
+ "type": "boolean"
3608
3331
  },
3609
3332
  "iCs": {
3610
- "oneOf": [
3611
- {
3612
- "type": "boolean"
3613
- },
3614
- {}
3615
- ]
3333
+ "type": "boolean"
3616
3334
  },
3617
3335
  "eastAsianLayout": {
3618
- "oneOf": [
3619
- {
3620
- "type": "object",
3621
- "properties": {
3622
- "id": {
3623
- "oneOf": [
3624
- {
3625
- "type": "string"
3626
- },
3627
- {}
3628
- ]
3629
- },
3630
- "combine": {
3631
- "oneOf": [
3632
- {
3633
- "type": "boolean"
3634
- },
3635
- {}
3636
- ]
3637
- },
3638
- "combineBrackets": {
3639
- "oneOf": [
3640
- {
3641
- "type": "string"
3642
- },
3643
- {}
3644
- ]
3645
- },
3646
- "vert": {
3647
- "oneOf": [
3648
- {
3649
- "type": "boolean"
3650
- },
3651
- {}
3652
- ]
3653
- },
3654
- "vertCompress": {
3655
- "oneOf": [
3656
- {
3657
- "type": "boolean"
3658
- },
3659
- {}
3660
- ]
3661
- }
3662
- }
3336
+ "type": "object",
3337
+ "properties": {
3338
+ "id": {
3339
+ "type": "string"
3663
3340
  },
3664
- {}
3665
- ]
3666
- },
3667
- "em": {
3668
- "oneOf": [
3669
- {
3341
+ "combine": {
3342
+ "type": "boolean"
3343
+ },
3344
+ "combineBrackets": {
3670
3345
  "type": "string"
3671
3346
  },
3672
- {}
3673
- ]
3347
+ "vert": {
3348
+ "type": "boolean"
3349
+ },
3350
+ "vertCompress": {
3351
+ "type": "boolean"
3352
+ }
3353
+ }
3354
+ },
3355
+ "em": {
3356
+ "type": "string"
3674
3357
  },
3675
3358
  "fitText": {
3676
- "oneOf": [
3677
- {
3678
- "type": "object",
3679
- "properties": {
3680
- "val": {
3681
- "oneOf": [
3682
- {
3683
- "type": "number"
3684
- },
3685
- {}
3686
- ]
3687
- },
3688
- "id": {
3689
- "oneOf": [
3690
- {
3691
- "type": "string"
3692
- },
3693
- {}
3694
- ]
3695
- }
3696
- }
3359
+ "type": "object",
3360
+ "properties": {
3361
+ "val": {
3362
+ "type": "number"
3697
3363
  },
3698
- {}
3699
- ]
3364
+ "id": {
3365
+ "type": "string"
3366
+ }
3367
+ }
3700
3368
  },
3701
3369
  "snapToGrid": {
3702
- "oneOf": [
3703
- {
3704
- "type": "boolean"
3705
- },
3706
- {}
3707
- ]
3370
+ "type": "boolean"
3708
3371
  },
3709
3372
  "lang": {
3710
- "oneOf": [
3711
- {
3712
- "type": "object",
3713
- "properties": {
3714
- "val": {
3715
- "oneOf": [
3716
- {
3717
- "type": "string"
3718
- },
3719
- {}
3720
- ]
3721
- },
3722
- "eastAsia": {
3723
- "oneOf": [
3724
- {
3725
- "type": "string"
3726
- },
3727
- {}
3728
- ]
3729
- },
3730
- "bidi": {
3731
- "oneOf": [
3732
- {
3733
- "type": "string"
3734
- },
3735
- {}
3736
- ]
3737
- }
3738
- }
3373
+ "type": "object",
3374
+ "properties": {
3375
+ "val": {
3376
+ "type": "string"
3739
3377
  },
3740
- {}
3741
- ]
3378
+ "eastAsia": {
3379
+ "type": "string"
3380
+ },
3381
+ "bidi": {
3382
+ "type": "string"
3383
+ }
3384
+ }
3742
3385
  },
3743
3386
  "oMath": {
3744
- "oneOf": [
3745
- {
3746
- "type": "boolean"
3747
- },
3748
- {}
3749
- ]
3387
+ "type": "boolean"
3750
3388
  },
3751
3389
  "rStyle": {
3752
- "oneOf": [
3753
- {
3754
- "type": "string"
3755
- },
3756
- {}
3757
- ]
3390
+ "type": "string"
3758
3391
  },
3759
3392
  "rFonts": {
3760
- "oneOf": [
3761
- {
3762
- "type": "object",
3763
- "properties": {
3764
- "ascii": {
3765
- "oneOf": [
3766
- {
3767
- "type": "string"
3768
- },
3769
- {}
3770
- ]
3771
- },
3772
- "hAnsi": {
3773
- "oneOf": [
3774
- {
3775
- "type": "string"
3776
- },
3777
- {}
3778
- ]
3779
- },
3780
- "eastAsia": {
3781
- "oneOf": [
3782
- {
3783
- "type": "string"
3784
- },
3785
- {}
3786
- ]
3787
- },
3788
- "cs": {
3789
- "oneOf": [
3790
- {
3791
- "type": "string"
3792
- },
3793
- {}
3794
- ]
3795
- },
3796
- "asciiTheme": {
3797
- "oneOf": [
3798
- {
3799
- "type": "string"
3800
- },
3801
- {}
3802
- ]
3803
- },
3804
- "hAnsiTheme": {
3805
- "oneOf": [
3806
- {
3807
- "type": "string"
3808
- },
3809
- {}
3810
- ]
3811
- },
3812
- "eastAsiaTheme": {
3813
- "oneOf": [
3814
- {
3815
- "type": "string"
3816
- },
3817
- {}
3818
- ]
3819
- },
3820
- "csTheme": {
3821
- "oneOf": [
3822
- {
3823
- "type": "string"
3824
- },
3825
- {}
3826
- ]
3827
- },
3828
- "hint": {
3829
- "oneOf": [
3830
- {
3831
- "type": "string"
3832
- },
3833
- {}
3834
- ]
3835
- }
3836
- }
3393
+ "type": "object",
3394
+ "properties": {
3395
+ "ascii": {
3396
+ "type": "string"
3837
3397
  },
3838
- {}
3839
- ]
3398
+ "hAnsi": {
3399
+ "type": "string"
3400
+ },
3401
+ "eastAsia": {
3402
+ "type": "string"
3403
+ },
3404
+ "cs": {
3405
+ "type": "string"
3406
+ },
3407
+ "asciiTheme": {
3408
+ "type": "string"
3409
+ },
3410
+ "hAnsiTheme": {
3411
+ "type": "string"
3412
+ },
3413
+ "eastAsiaTheme": {
3414
+ "type": "string"
3415
+ },
3416
+ "csTheme": {
3417
+ "type": "string"
3418
+ },
3419
+ "hint": {
3420
+ "type": "string"
3421
+ }
3422
+ }
3840
3423
  },
3841
3424
  "fontSizeCs": {
3842
- "oneOf": [
3843
- {
3844
- "type": "number"
3845
- },
3846
- {}
3847
- ]
3425
+ "type": "number"
3848
3426
  },
3849
3427
  "ligatures": {
3850
- "oneOf": [
3851
- {
3852
- "type": "string"
3853
- },
3854
- {}
3855
- ]
3428
+ "type": "string"
3856
3429
  },
3857
3430
  "numForm": {
3858
- "oneOf": [
3859
- {
3860
- "type": "string"
3861
- },
3862
- {}
3863
- ]
3431
+ "type": "string"
3864
3432
  },
3865
3433
  "numSpacing": {
3866
- "oneOf": [
3867
- {
3868
- "type": "string"
3869
- },
3870
- {}
3871
- ]
3434
+ "type": "string"
3872
3435
  },
3873
3436
  "stylisticSets": {
3874
- "oneOf": [
3875
- {
3876
- "type": "array",
3877
- "items": {
3878
- "type": "object",
3879
- "properties": {
3880
- "id": {
3881
- "type": "number"
3882
- },
3883
- "val": {
3884
- "type": "boolean"
3885
- }
3886
- },
3887
- "required": [
3888
- "id"
3889
- ]
3437
+ "type": "array",
3438
+ "items": {
3439
+ "type": "object",
3440
+ "properties": {
3441
+ "id": {
3442
+ "type": "number"
3443
+ },
3444
+ "val": {
3445
+ "type": "boolean"
3890
3446
  }
3891
3447
  },
3892
- {}
3893
- ]
3448
+ "required": [
3449
+ "id"
3450
+ ]
3451
+ }
3894
3452
  },
3895
3453
  "contextualAlternates": {
3896
- "oneOf": [
3897
- {
3898
- "type": "boolean"
3899
- },
3900
- {}
3901
- ]
3454
+ "type": "boolean"
3902
3455
  }
3903
3456
  }
3904
3457
  }
@@ -3939,19 +3492,23 @@
3939
3492
  "properties": {
3940
3493
  "type": {
3941
3494
  "const": "text",
3495
+ "description": "Must be 'text' for text pattern search.",
3942
3496
  "type": "string"
3943
3497
  },
3944
3498
  "pattern": {
3945
- "type": "string"
3499
+ "type": "string",
3500
+ "description": "Text or regex pattern to match."
3946
3501
  },
3947
3502
  "mode": {
3503
+ "description": "Match mode: 'contains' (substring) or 'regex'.",
3948
3504
  "enum": [
3949
3505
  "contains",
3950
3506
  "regex"
3951
3507
  ]
3952
3508
  },
3953
3509
  "caseSensitive": {
3954
- "type": "boolean"
3510
+ "type": "boolean",
3511
+ "description": "Case-sensitive matching. Default: false."
3955
3512
  }
3956
3513
  },
3957
3514
  "required": [
@@ -3964,9 +3521,11 @@
3964
3521
  "properties": {
3965
3522
  "type": {
3966
3523
  "const": "node",
3524
+ "description": "Must be 'node' for node type search.",
3967
3525
  "type": "string"
3968
3526
  },
3969
3527
  "nodeType": {
3528
+ "description": "Block type to match (paragraph, heading, table, listItem, etc.).",
3970
3529
  "enum": [
3971
3530
  "paragraph",
3972
3531
  "heading",
@@ -3993,6 +3552,7 @@
3993
3552
  ]
3994
3553
  },
3995
3554
  "kind": {
3555
+ "description": "Filter: 'block' or 'inline'.",
3996
3556
  "enum": [
3997
3557
  "block",
3998
3558
  "inline"
@@ -4061,15 +3621,18 @@
4061
3621
  ]
4062
3622
  }
4063
3623
  ]
4064
- }
3624
+ },
3625
+ "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."
4065
3626
  },
4066
3627
  "force": {
4067
- "type": "boolean"
3628
+ "type": "boolean",
3629
+ "description": "Bypass confirmation checks."
4068
3630
  }
4069
3631
  },
4070
3632
  "required": [
4071
3633
  "action",
4072
3634
  "atomic",
3635
+ "changeMode",
4073
3636
  "steps"
4074
3637
  ],
4075
3638
  "additionalProperties": false