@superdoc-dev/sdk 1.16.0-next.35 → 1.16.0-next.37

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.
@@ -798,6 +798,9 @@ const CONTRACT = {
798
798
  },
799
799
  "wholeWord": {
800
800
  "type": "boolean"
801
+ },
802
+ "includeDeletedText": {
803
+ "type": "boolean"
801
804
  }
802
805
  },
803
806
  "additionalProperties": false,
@@ -13868,6 +13871,19 @@ const CONTRACT = {
13868
13871
  "type": "number",
13869
13872
  "description": "Heading level (1-6)."
13870
13873
  },
13874
+ "paragraphNumbering": {
13875
+ "type": "object",
13876
+ "description": "Numbering reference (numId + level) for numbered blocks, including numbered headings. Absent for non-numbered blocks.",
13877
+ "properties": {
13878
+ "numId": {
13879
+ "type": "number"
13880
+ },
13881
+ "level": {
13882
+ "type": "number"
13883
+ }
13884
+ },
13885
+ "additionalProperties": false
13886
+ },
13871
13887
  "ref": {
13872
13888
  "type": "string",
13873
13889
  "description": "Ref handle for this block. Pass directly to superdoc_format or superdoc_edit ref param. Only present for non-empty blocks."
@@ -112388,37 +112404,961 @@ const CONTRACT = {
112388
112404
  "nodeType",
112389
112405
  "nodeId"
112390
112406
  ]
112391
- }
112392
- ]
112393
- }
112394
- },
112395
- {
112396
- "name": "direction",
112397
- "kind": "flag",
112398
- "type": "string",
112399
- "schema": {
112400
- "oneOf": [
112401
- {
112402
- "const": "ltr"
112407
+ }
112408
+ ]
112409
+ }
112410
+ },
112411
+ {
112412
+ "name": "direction",
112413
+ "kind": "flag",
112414
+ "type": "string",
112415
+ "schema": {
112416
+ "oneOf": [
112417
+ {
112418
+ "const": "ltr"
112419
+ },
112420
+ {
112421
+ "const": "rtl"
112422
+ }
112423
+ ]
112424
+ }
112425
+ },
112426
+ {
112427
+ "name": "alignmentPolicy",
112428
+ "kind": "flag",
112429
+ "type": "string",
112430
+ "flag": "alignment-policy",
112431
+ "schema": {
112432
+ "oneOf": [
112433
+ {
112434
+ "const": "preserve"
112435
+ },
112436
+ {
112437
+ "const": "matchDirection"
112438
+ }
112439
+ ]
112440
+ }
112441
+ },
112442
+ {
112443
+ "name": "blockId",
112444
+ "kind": "flag",
112445
+ "type": "string",
112446
+ "flag": "block-id",
112447
+ "description": "Block ID of the target paragraph. Shortcut for a paragraph block target.",
112448
+ "agentVisible": false
112449
+ }
112450
+ ],
112451
+ "constraints": null,
112452
+ "mutates": true,
112453
+ "idempotency": "conditional",
112454
+ "supportsTrackedMode": true,
112455
+ "supportsDryRun": true,
112456
+ "inputSchema": {
112457
+ "type": "object",
112458
+ "properties": {
112459
+ "target": {
112460
+ "oneOf": [
112461
+ {
112462
+ "$ref": "#/$defs/ParagraphAddress"
112463
+ },
112464
+ {
112465
+ "$ref": "#/$defs/HeadingAddress"
112466
+ },
112467
+ {
112468
+ "$ref": "#/$defs/ListItemAddress"
112469
+ }
112470
+ ]
112471
+ },
112472
+ "direction": {
112473
+ "type": "string",
112474
+ "enum": [
112475
+ "ltr",
112476
+ "rtl"
112477
+ ]
112478
+ },
112479
+ "alignmentPolicy": {
112480
+ "type": "string",
112481
+ "enum": [
112482
+ "preserve",
112483
+ "matchDirection"
112484
+ ]
112485
+ }
112486
+ },
112487
+ "additionalProperties": false,
112488
+ "required": [
112489
+ "target",
112490
+ "direction"
112491
+ ]
112492
+ },
112493
+ "outputSchema": {
112494
+ "oneOf": [
112495
+ {
112496
+ "type": "object",
112497
+ "properties": {
112498
+ "success": {
112499
+ "const": true
112500
+ },
112501
+ "target": {
112502
+ "oneOf": [
112503
+ {
112504
+ "$ref": "#/$defs/ParagraphAddress"
112505
+ },
112506
+ {
112507
+ "$ref": "#/$defs/HeadingAddress"
112508
+ },
112509
+ {
112510
+ "$ref": "#/$defs/ListItemAddress"
112511
+ }
112512
+ ]
112513
+ },
112514
+ "resolution": {
112515
+ "type": "object",
112516
+ "properties": {
112517
+ "target": {
112518
+ "oneOf": [
112519
+ {
112520
+ "$ref": "#/$defs/ParagraphAddress"
112521
+ },
112522
+ {
112523
+ "$ref": "#/$defs/HeadingAddress"
112524
+ },
112525
+ {
112526
+ "$ref": "#/$defs/ListItemAddress"
112527
+ }
112528
+ ]
112529
+ }
112530
+ },
112531
+ "additionalProperties": false,
112532
+ "required": [
112533
+ "target"
112534
+ ]
112535
+ }
112536
+ },
112537
+ "additionalProperties": false,
112538
+ "required": [
112539
+ "success",
112540
+ "target",
112541
+ "resolution"
112542
+ ]
112543
+ },
112544
+ {
112545
+ "type": "object",
112546
+ "properties": {
112547
+ "success": {
112548
+ "const": false
112549
+ },
112550
+ "failure": {
112551
+ "type": "object",
112552
+ "properties": {
112553
+ "code": {
112554
+ "enum": [
112555
+ "NO_OP"
112556
+ ]
112557
+ },
112558
+ "message": {
112559
+ "type": "string"
112560
+ },
112561
+ "details": {}
112562
+ },
112563
+ "additionalProperties": false,
112564
+ "required": [
112565
+ "code",
112566
+ "message"
112567
+ ]
112568
+ },
112569
+ "resolution": {
112570
+ "type": "object",
112571
+ "properties": {
112572
+ "target": {
112573
+ "oneOf": [
112574
+ {
112575
+ "$ref": "#/$defs/ParagraphAddress"
112576
+ },
112577
+ {
112578
+ "$ref": "#/$defs/HeadingAddress"
112579
+ },
112580
+ {
112581
+ "$ref": "#/$defs/ListItemAddress"
112582
+ }
112583
+ ]
112584
+ }
112585
+ },
112586
+ "additionalProperties": false,
112587
+ "required": [
112588
+ "target"
112589
+ ]
112590
+ }
112591
+ },
112592
+ "additionalProperties": false,
112593
+ "required": [
112594
+ "success",
112595
+ "failure"
112596
+ ]
112597
+ }
112598
+ ]
112599
+ },
112600
+ "successSchema": {
112601
+ "type": "object",
112602
+ "properties": {
112603
+ "success": {
112604
+ "const": true
112605
+ },
112606
+ "target": {
112607
+ "oneOf": [
112608
+ {
112609
+ "$ref": "#/$defs/ParagraphAddress"
112610
+ },
112611
+ {
112612
+ "$ref": "#/$defs/HeadingAddress"
112613
+ },
112614
+ {
112615
+ "$ref": "#/$defs/ListItemAddress"
112616
+ }
112617
+ ]
112618
+ },
112619
+ "resolution": {
112620
+ "type": "object",
112621
+ "properties": {
112622
+ "target": {
112623
+ "oneOf": [
112624
+ {
112625
+ "$ref": "#/$defs/ParagraphAddress"
112626
+ },
112627
+ {
112628
+ "$ref": "#/$defs/HeadingAddress"
112629
+ },
112630
+ {
112631
+ "$ref": "#/$defs/ListItemAddress"
112632
+ }
112633
+ ]
112634
+ }
112635
+ },
112636
+ "additionalProperties": false,
112637
+ "required": [
112638
+ "target"
112639
+ ]
112640
+ }
112641
+ },
112642
+ "additionalProperties": false,
112643
+ "required": [
112644
+ "success",
112645
+ "target",
112646
+ "resolution"
112647
+ ]
112648
+ },
112649
+ "failureSchema": {
112650
+ "type": "object",
112651
+ "properties": {
112652
+ "success": {
112653
+ "const": false
112654
+ },
112655
+ "failure": {
112656
+ "type": "object",
112657
+ "properties": {
112658
+ "code": {
112659
+ "enum": [
112660
+ "NO_OP"
112661
+ ]
112662
+ },
112663
+ "message": {
112664
+ "type": "string"
112665
+ },
112666
+ "details": {}
112667
+ },
112668
+ "additionalProperties": false,
112669
+ "required": [
112670
+ "code",
112671
+ "message"
112672
+ ]
112673
+ },
112674
+ "resolution": {
112675
+ "type": "object",
112676
+ "properties": {
112677
+ "target": {
112678
+ "oneOf": [
112679
+ {
112680
+ "$ref": "#/$defs/ParagraphAddress"
112681
+ },
112682
+ {
112683
+ "$ref": "#/$defs/HeadingAddress"
112684
+ },
112685
+ {
112686
+ "$ref": "#/$defs/ListItemAddress"
112687
+ }
112688
+ ]
112689
+ }
112690
+ },
112691
+ "additionalProperties": false,
112692
+ "required": [
112693
+ "target"
112694
+ ]
112695
+ }
112696
+ },
112697
+ "additionalProperties": false,
112698
+ "required": [
112699
+ "success",
112700
+ "failure"
112701
+ ]
112702
+ },
112703
+ "intentGroup": "format",
112704
+ "intentAction": "set_direction"
112705
+ },
112706
+ "doc.format.paragraph.clearDirection": {
112707
+ "operationId": "doc.format.paragraph.clearDirection",
112708
+ "sdkSurface": "document",
112709
+ "command": "format paragraph clear-direction",
112710
+ "commandTokens": [
112711
+ "format",
112712
+ "paragraph",
112713
+ "clear-direction"
112714
+ ],
112715
+ "category": "format",
112716
+ "description": "Remove explicit paragraph direction, reverting to inherited or default (LTR).",
112717
+ "requiresDocumentContext": true,
112718
+ "docRequirement": "optional",
112719
+ "responseEnvelopeKey": "result",
112720
+ "params": [
112721
+ {
112722
+ "name": "doc",
112723
+ "kind": "doc",
112724
+ "type": "string",
112725
+ "description": "Document path. Optional when a session is already open."
112726
+ },
112727
+ {
112728
+ "name": "sessionId",
112729
+ "kind": "flag",
112730
+ "type": "string",
112731
+ "flag": "session",
112732
+ "description": "Session ID for multi-session workflows. Optional when only one session is open."
112733
+ },
112734
+ {
112735
+ "name": "out",
112736
+ "kind": "flag",
112737
+ "type": "string",
112738
+ "agentVisible": false
112739
+ },
112740
+ {
112741
+ "name": "force",
112742
+ "kind": "flag",
112743
+ "type": "boolean",
112744
+ "description": "Bypass confirmation checks."
112745
+ },
112746
+ {
112747
+ "name": "expectedRevision",
112748
+ "kind": "flag",
112749
+ "type": "number",
112750
+ "flag": "expected-revision",
112751
+ "agentVisible": false
112752
+ },
112753
+ {
112754
+ "name": "changeMode",
112755
+ "kind": "flag",
112756
+ "type": "string",
112757
+ "flag": "change-mode",
112758
+ "schema": {
112759
+ "type": "string",
112760
+ "enum": [
112761
+ "direct",
112762
+ "tracked"
112763
+ ]
112764
+ },
112765
+ "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
112766
+ },
112767
+ {
112768
+ "name": "dryRun",
112769
+ "kind": "flag",
112770
+ "type": "boolean",
112771
+ "flag": "dry-run",
112772
+ "description": "Preview the result without applying changes."
112773
+ },
112774
+ {
112775
+ "name": "target",
112776
+ "kind": "jsonFlag",
112777
+ "type": "json",
112778
+ "flag": "target-json",
112779
+ "schema": {
112780
+ "oneOf": [
112781
+ {
112782
+ "type": "object",
112783
+ "properties": {
112784
+ "kind": {
112785
+ "const": "block"
112786
+ },
112787
+ "nodeType": {
112788
+ "const": "paragraph"
112789
+ },
112790
+ "nodeId": {
112791
+ "type": "string"
112792
+ },
112793
+ "story": {
112794
+ "oneOf": [
112795
+ {
112796
+ "type": "object",
112797
+ "properties": {
112798
+ "kind": {
112799
+ "const": "story"
112800
+ },
112801
+ "storyType": {
112802
+ "const": "body"
112803
+ }
112804
+ },
112805
+ "required": [
112806
+ "kind",
112807
+ "storyType"
112808
+ ]
112809
+ },
112810
+ {
112811
+ "type": "object",
112812
+ "properties": {
112813
+ "kind": {
112814
+ "const": "story"
112815
+ },
112816
+ "storyType": {
112817
+ "const": "headerFooterSlot"
112818
+ },
112819
+ "section": {
112820
+ "type": "object",
112821
+ "properties": {
112822
+ "kind": {
112823
+ "const": "section"
112824
+ },
112825
+ "sectionId": {
112826
+ "type": "string"
112827
+ }
112828
+ },
112829
+ "required": [
112830
+ "kind",
112831
+ "sectionId"
112832
+ ]
112833
+ },
112834
+ "headerFooterKind": {
112835
+ "oneOf": [
112836
+ {
112837
+ "const": "header"
112838
+ },
112839
+ {
112840
+ "const": "footer"
112841
+ }
112842
+ ]
112843
+ },
112844
+ "variant": {
112845
+ "oneOf": [
112846
+ {
112847
+ "const": "default"
112848
+ },
112849
+ {
112850
+ "const": "first"
112851
+ },
112852
+ {
112853
+ "const": "even"
112854
+ }
112855
+ ]
112856
+ },
112857
+ "resolution": {
112858
+ "oneOf": [
112859
+ {
112860
+ "const": "effective"
112861
+ },
112862
+ {
112863
+ "const": "explicit"
112864
+ }
112865
+ ]
112866
+ },
112867
+ "onWrite": {
112868
+ "oneOf": [
112869
+ {
112870
+ "const": "materializeIfInherited"
112871
+ },
112872
+ {
112873
+ "const": "editResolvedPart"
112874
+ },
112875
+ {
112876
+ "const": "error"
112877
+ }
112878
+ ]
112879
+ }
112880
+ },
112881
+ "required": [
112882
+ "kind",
112883
+ "storyType",
112884
+ "section",
112885
+ "headerFooterKind",
112886
+ "variant"
112887
+ ]
112888
+ },
112889
+ {
112890
+ "type": "object",
112891
+ "properties": {
112892
+ "kind": {
112893
+ "const": "story"
112894
+ },
112895
+ "storyType": {
112896
+ "const": "headerFooterPart"
112897
+ },
112898
+ "refId": {
112899
+ "type": "string"
112900
+ }
112901
+ },
112902
+ "required": [
112903
+ "kind",
112904
+ "storyType",
112905
+ "refId"
112906
+ ]
112907
+ },
112908
+ {
112909
+ "type": "object",
112910
+ "properties": {
112911
+ "kind": {
112912
+ "const": "story"
112913
+ },
112914
+ "storyType": {
112915
+ "const": "footnote"
112916
+ },
112917
+ "noteId": {
112918
+ "type": "string"
112919
+ }
112920
+ },
112921
+ "required": [
112922
+ "kind",
112923
+ "storyType",
112924
+ "noteId"
112925
+ ]
112926
+ },
112927
+ {
112928
+ "type": "object",
112929
+ "properties": {
112930
+ "kind": {
112931
+ "const": "story"
112932
+ },
112933
+ "storyType": {
112934
+ "const": "endnote"
112935
+ },
112936
+ "noteId": {
112937
+ "type": "string"
112938
+ }
112939
+ },
112940
+ "required": [
112941
+ "kind",
112942
+ "storyType",
112943
+ "noteId"
112944
+ ]
112945
+ },
112946
+ {
112947
+ "type": "object",
112948
+ "properties": {
112949
+ "kind": {
112950
+ "const": "story"
112951
+ },
112952
+ "storyType": {
112953
+ "const": "textbox"
112954
+ },
112955
+ "textboxId": {
112956
+ "type": "string"
112957
+ }
112958
+ },
112959
+ "required": [
112960
+ "kind",
112961
+ "storyType",
112962
+ "textboxId"
112963
+ ]
112964
+ }
112965
+ ],
112966
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
112967
+ }
112968
+ },
112969
+ "required": [
112970
+ "kind",
112971
+ "nodeType",
112972
+ "nodeId"
112973
+ ]
112974
+ },
112975
+ {
112976
+ "type": "object",
112977
+ "properties": {
112978
+ "kind": {
112979
+ "const": "block"
112980
+ },
112981
+ "nodeType": {
112982
+ "const": "heading"
112983
+ },
112984
+ "nodeId": {
112985
+ "type": "string"
112986
+ },
112987
+ "story": {
112988
+ "oneOf": [
112989
+ {
112990
+ "type": "object",
112991
+ "properties": {
112992
+ "kind": {
112993
+ "const": "story"
112994
+ },
112995
+ "storyType": {
112996
+ "const": "body"
112997
+ }
112998
+ },
112999
+ "required": [
113000
+ "kind",
113001
+ "storyType"
113002
+ ]
113003
+ },
113004
+ {
113005
+ "type": "object",
113006
+ "properties": {
113007
+ "kind": {
113008
+ "const": "story"
113009
+ },
113010
+ "storyType": {
113011
+ "const": "headerFooterSlot"
113012
+ },
113013
+ "section": {
113014
+ "type": "object",
113015
+ "properties": {
113016
+ "kind": {
113017
+ "const": "section"
113018
+ },
113019
+ "sectionId": {
113020
+ "type": "string"
113021
+ }
113022
+ },
113023
+ "required": [
113024
+ "kind",
113025
+ "sectionId"
113026
+ ]
113027
+ },
113028
+ "headerFooterKind": {
113029
+ "oneOf": [
113030
+ {
113031
+ "const": "header"
113032
+ },
113033
+ {
113034
+ "const": "footer"
113035
+ }
113036
+ ]
113037
+ },
113038
+ "variant": {
113039
+ "oneOf": [
113040
+ {
113041
+ "const": "default"
113042
+ },
113043
+ {
113044
+ "const": "first"
113045
+ },
113046
+ {
113047
+ "const": "even"
113048
+ }
113049
+ ]
113050
+ },
113051
+ "resolution": {
113052
+ "oneOf": [
113053
+ {
113054
+ "const": "effective"
113055
+ },
113056
+ {
113057
+ "const": "explicit"
113058
+ }
113059
+ ]
113060
+ },
113061
+ "onWrite": {
113062
+ "oneOf": [
113063
+ {
113064
+ "const": "materializeIfInherited"
113065
+ },
113066
+ {
113067
+ "const": "editResolvedPart"
113068
+ },
113069
+ {
113070
+ "const": "error"
113071
+ }
113072
+ ]
113073
+ }
113074
+ },
113075
+ "required": [
113076
+ "kind",
113077
+ "storyType",
113078
+ "section",
113079
+ "headerFooterKind",
113080
+ "variant"
113081
+ ]
113082
+ },
113083
+ {
113084
+ "type": "object",
113085
+ "properties": {
113086
+ "kind": {
113087
+ "const": "story"
113088
+ },
113089
+ "storyType": {
113090
+ "const": "headerFooterPart"
113091
+ },
113092
+ "refId": {
113093
+ "type": "string"
113094
+ }
113095
+ },
113096
+ "required": [
113097
+ "kind",
113098
+ "storyType",
113099
+ "refId"
113100
+ ]
113101
+ },
113102
+ {
113103
+ "type": "object",
113104
+ "properties": {
113105
+ "kind": {
113106
+ "const": "story"
113107
+ },
113108
+ "storyType": {
113109
+ "const": "footnote"
113110
+ },
113111
+ "noteId": {
113112
+ "type": "string"
113113
+ }
113114
+ },
113115
+ "required": [
113116
+ "kind",
113117
+ "storyType",
113118
+ "noteId"
113119
+ ]
113120
+ },
113121
+ {
113122
+ "type": "object",
113123
+ "properties": {
113124
+ "kind": {
113125
+ "const": "story"
113126
+ },
113127
+ "storyType": {
113128
+ "const": "endnote"
113129
+ },
113130
+ "noteId": {
113131
+ "type": "string"
113132
+ }
113133
+ },
113134
+ "required": [
113135
+ "kind",
113136
+ "storyType",
113137
+ "noteId"
113138
+ ]
113139
+ },
113140
+ {
113141
+ "type": "object",
113142
+ "properties": {
113143
+ "kind": {
113144
+ "const": "story"
113145
+ },
113146
+ "storyType": {
113147
+ "const": "textbox"
113148
+ },
113149
+ "textboxId": {
113150
+ "type": "string"
113151
+ }
113152
+ },
113153
+ "required": [
113154
+ "kind",
113155
+ "storyType",
113156
+ "textboxId"
113157
+ ]
113158
+ }
113159
+ ],
113160
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
113161
+ }
113162
+ },
113163
+ "required": [
113164
+ "kind",
113165
+ "nodeType",
113166
+ "nodeId"
113167
+ ]
112403
113168
  },
112404
113169
  {
112405
- "const": "rtl"
112406
- }
112407
- ]
112408
- }
112409
- },
112410
- {
112411
- "name": "alignmentPolicy",
112412
- "kind": "flag",
112413
- "type": "string",
112414
- "flag": "alignment-policy",
112415
- "schema": {
112416
- "oneOf": [
112417
- {
112418
- "const": "preserve"
112419
- },
112420
- {
112421
- "const": "matchDirection"
113170
+ "type": "object",
113171
+ "properties": {
113172
+ "kind": {
113173
+ "const": "block"
113174
+ },
113175
+ "nodeType": {
113176
+ "const": "listItem"
113177
+ },
113178
+ "nodeId": {
113179
+ "type": "string"
113180
+ },
113181
+ "story": {
113182
+ "oneOf": [
113183
+ {
113184
+ "type": "object",
113185
+ "properties": {
113186
+ "kind": {
113187
+ "const": "story"
113188
+ },
113189
+ "storyType": {
113190
+ "const": "body"
113191
+ }
113192
+ },
113193
+ "required": [
113194
+ "kind",
113195
+ "storyType"
113196
+ ]
113197
+ },
113198
+ {
113199
+ "type": "object",
113200
+ "properties": {
113201
+ "kind": {
113202
+ "const": "story"
113203
+ },
113204
+ "storyType": {
113205
+ "const": "headerFooterSlot"
113206
+ },
113207
+ "section": {
113208
+ "type": "object",
113209
+ "properties": {
113210
+ "kind": {
113211
+ "const": "section"
113212
+ },
113213
+ "sectionId": {
113214
+ "type": "string"
113215
+ }
113216
+ },
113217
+ "required": [
113218
+ "kind",
113219
+ "sectionId"
113220
+ ]
113221
+ },
113222
+ "headerFooterKind": {
113223
+ "oneOf": [
113224
+ {
113225
+ "const": "header"
113226
+ },
113227
+ {
113228
+ "const": "footer"
113229
+ }
113230
+ ]
113231
+ },
113232
+ "variant": {
113233
+ "oneOf": [
113234
+ {
113235
+ "const": "default"
113236
+ },
113237
+ {
113238
+ "const": "first"
113239
+ },
113240
+ {
113241
+ "const": "even"
113242
+ }
113243
+ ]
113244
+ },
113245
+ "resolution": {
113246
+ "oneOf": [
113247
+ {
113248
+ "const": "effective"
113249
+ },
113250
+ {
113251
+ "const": "explicit"
113252
+ }
113253
+ ]
113254
+ },
113255
+ "onWrite": {
113256
+ "oneOf": [
113257
+ {
113258
+ "const": "materializeIfInherited"
113259
+ },
113260
+ {
113261
+ "const": "editResolvedPart"
113262
+ },
113263
+ {
113264
+ "const": "error"
113265
+ }
113266
+ ]
113267
+ }
113268
+ },
113269
+ "required": [
113270
+ "kind",
113271
+ "storyType",
113272
+ "section",
113273
+ "headerFooterKind",
113274
+ "variant"
113275
+ ]
113276
+ },
113277
+ {
113278
+ "type": "object",
113279
+ "properties": {
113280
+ "kind": {
113281
+ "const": "story"
113282
+ },
113283
+ "storyType": {
113284
+ "const": "headerFooterPart"
113285
+ },
113286
+ "refId": {
113287
+ "type": "string"
113288
+ }
113289
+ },
113290
+ "required": [
113291
+ "kind",
113292
+ "storyType",
113293
+ "refId"
113294
+ ]
113295
+ },
113296
+ {
113297
+ "type": "object",
113298
+ "properties": {
113299
+ "kind": {
113300
+ "const": "story"
113301
+ },
113302
+ "storyType": {
113303
+ "const": "footnote"
113304
+ },
113305
+ "noteId": {
113306
+ "type": "string"
113307
+ }
113308
+ },
113309
+ "required": [
113310
+ "kind",
113311
+ "storyType",
113312
+ "noteId"
113313
+ ]
113314
+ },
113315
+ {
113316
+ "type": "object",
113317
+ "properties": {
113318
+ "kind": {
113319
+ "const": "story"
113320
+ },
113321
+ "storyType": {
113322
+ "const": "endnote"
113323
+ },
113324
+ "noteId": {
113325
+ "type": "string"
113326
+ }
113327
+ },
113328
+ "required": [
113329
+ "kind",
113330
+ "storyType",
113331
+ "noteId"
113332
+ ]
113333
+ },
113334
+ {
113335
+ "type": "object",
113336
+ "properties": {
113337
+ "kind": {
113338
+ "const": "story"
113339
+ },
113340
+ "storyType": {
113341
+ "const": "textbox"
113342
+ },
113343
+ "textboxId": {
113344
+ "type": "string"
113345
+ }
113346
+ },
113347
+ "required": [
113348
+ "kind",
113349
+ "storyType",
113350
+ "textboxId"
113351
+ ]
113352
+ }
113353
+ ],
113354
+ "description": "Story scope. Defaults to document body when omitted. Use {kind:'story', storyType:'body'} for body, or other storyType values for headers, footers, footnotes, endnotes."
113355
+ }
113356
+ },
113357
+ "required": [
113358
+ "kind",
113359
+ "nodeType",
113360
+ "nodeId"
113361
+ ]
112422
113362
  }
112423
113363
  ]
112424
113364
  }
@@ -112452,26 +113392,11 @@ const CONTRACT = {
112452
113392
  "$ref": "#/$defs/ListItemAddress"
112453
113393
  }
112454
113394
  ]
112455
- },
112456
- "direction": {
112457
- "type": "string",
112458
- "enum": [
112459
- "ltr",
112460
- "rtl"
112461
- ]
112462
- },
112463
- "alignmentPolicy": {
112464
- "type": "string",
112465
- "enum": [
112466
- "preserve",
112467
- "matchDirection"
112468
- ]
112469
113395
  }
112470
113396
  },
112471
113397
  "additionalProperties": false,
112472
113398
  "required": [
112473
- "target",
112474
- "direction"
113399
+ "target"
112475
113400
  ]
112476
113401
  },
112477
113402
  "outputSchema": {
@@ -112683,21 +113608,19 @@ const CONTRACT = {
112683
113608
  "success",
112684
113609
  "failure"
112685
113610
  ]
112686
- },
112687
- "intentGroup": "format",
112688
- "intentAction": "set_direction"
113611
+ }
112689
113612
  },
112690
- "doc.format.paragraph.clearDirection": {
112691
- "operationId": "doc.format.paragraph.clearDirection",
113613
+ "doc.format.paragraph.setNumbering": {
113614
+ "operationId": "doc.format.paragraph.setNumbering",
112692
113615
  "sdkSurface": "document",
112693
- "command": "format paragraph clear-direction",
113616
+ "command": "format paragraph set-numbering",
112694
113617
  "commandTokens": [
112695
113618
  "format",
112696
113619
  "paragraph",
112697
- "clear-direction"
113620
+ "set-numbering"
112698
113621
  ],
112699
113622
  "category": "format",
112700
- "description": "Remove explicit paragraph direction, reverting to inherited or default (LTR).",
113623
+ "description": "Attach numbering (numId + level) to an existing paragraph or heading so it joins a numbered sequence. Numbering is a paragraph property; the node and its style are otherwise unchanged, though any direct paragraph indent is cleared so the numbering level controls indentation. Direct edits only; tracked mode is unsupported.",
112701
113624
  "requiresDocumentContext": true,
112702
113625
  "docRequirement": "optional",
112703
113626
  "responseEnvelopeKey": "result",
@@ -113347,6 +114270,17 @@ const CONTRACT = {
113347
114270
  ]
113348
114271
  }
113349
114272
  },
114273
+ {
114274
+ "name": "numId",
114275
+ "kind": "flag",
114276
+ "type": "number",
114277
+ "flag": "num-id"
114278
+ },
114279
+ {
114280
+ "name": "level",
114281
+ "kind": "flag",
114282
+ "type": "number"
114283
+ },
113350
114284
  {
113351
114285
  "name": "blockId",
113352
114286
  "kind": "flag",
@@ -113359,7 +114293,7 @@ const CONTRACT = {
113359
114293
  "constraints": null,
113360
114294
  "mutates": true,
113361
114295
  "idempotency": "conditional",
113362
- "supportsTrackedMode": true,
114296
+ "supportsTrackedMode": false,
113363
114297
  "supportsDryRun": true,
113364
114298
  "inputSchema": {
113365
114299
  "type": "object",
@@ -113376,11 +114310,21 @@ const CONTRACT = {
113376
114310
  "$ref": "#/$defs/ListItemAddress"
113377
114311
  }
113378
114312
  ]
114313
+ },
114314
+ "numId": {
114315
+ "type": "integer",
114316
+ "minimum": 1
114317
+ },
114318
+ "level": {
114319
+ "type": "integer",
114320
+ "minimum": 0,
114321
+ "maximum": 8
113379
114322
  }
113380
114323
  },
113381
114324
  "additionalProperties": false,
113382
114325
  "required": [
113383
- "target"
114326
+ "target",
114327
+ "numId"
113384
114328
  ]
113385
114329
  },
113386
114330
  "outputSchema": {
@@ -170698,6 +171642,41 @@ const CONTRACT = {
170698
171642
  "dryRun"
170699
171643
  ]
170700
171644
  },
171645
+ "format.paragraph.setNumbering": {
171646
+ "type": "object",
171647
+ "properties": {
171648
+ "available": {
171649
+ "type": "boolean"
171650
+ },
171651
+ "tracked": {
171652
+ "type": "boolean"
171653
+ },
171654
+ "dryRun": {
171655
+ "type": "boolean"
171656
+ },
171657
+ "reasons": {
171658
+ "type": "array",
171659
+ "items": {
171660
+ "enum": [
171661
+ "COMMAND_UNAVAILABLE",
171662
+ "HELPER_UNAVAILABLE",
171663
+ "OPERATION_UNAVAILABLE",
171664
+ "TRACKED_MODE_UNAVAILABLE",
171665
+ "DRY_RUN_UNAVAILABLE",
171666
+ "NAMESPACE_UNAVAILABLE",
171667
+ "STYLES_PART_MISSING",
171668
+ "COLLABORATION_ACTIVE"
171669
+ ]
171670
+ }
171671
+ }
171672
+ },
171673
+ "additionalProperties": false,
171674
+ "required": [
171675
+ "available",
171676
+ "tracked",
171677
+ "dryRun"
171678
+ ]
171679
+ },
170701
171680
  "lists.list": {
170702
171681
  "type": "object",
170703
171682
  "properties": {
@@ -181521,6 +182500,7 @@ const CONTRACT = {
181521
182500
  "format.paragraph.setMarkRunProps",
181522
182501
  "format.paragraph.setDirection",
181523
182502
  "format.paragraph.clearDirection",
182503
+ "format.paragraph.setNumbering",
181524
182504
  "lists.list",
181525
182505
  "lists.get",
181526
182506
  "lists.insert",
@@ -231516,7 +232496,7 @@ const CONTRACT = {
231516
232496
  "insert"
231517
232497
  ],
231518
232498
  "category": "core",
231519
- "description": "Insert a new footnote or endnote at a target location. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.",
232499
+ "description": "Insert a new footnote or endnote at a target location or the current selection. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.",
231520
232500
  "requiresDocumentContext": true,
231521
232501
  "docRequirement": "optional",
231522
232502
  "responseEnvelopeKey": "result",
@@ -231579,7 +232559,6 @@ const CONTRACT = {
231579
232559
  "kind": "jsonFlag",
231580
232560
  "type": "json",
231581
232561
  "flag": "at-json",
231582
- "required": true,
231583
232562
  "schema": {
231584
232563
  "type": "object",
231585
232564
  "properties": {
@@ -231868,7 +232847,6 @@ const CONTRACT = {
231868
232847
  },
231869
232848
  "additionalProperties": false,
231870
232849
  "required": [
231871
- "at",
231872
232850
  "type",
231873
232851
  "content"
231874
232852
  ]
@@ -231902,7 +232880,6 @@ const CONTRACT = {
231902
232880
  },
231903
232881
  "additionalProperties": false,
231904
232882
  "required": [
231905
- "at",
231906
232883
  "type",
231907
232884
  "body"
231908
232885
  ]