@superdoc-dev/sdk 1.0.0-next.74 → 1.0.0-next.75

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.
@@ -293,8 +293,11 @@ export const CONTRACT = {
293
293
  "noteId"
294
294
  ]
295
295
  }
296
- ]
297
- }
296
+ ],
297
+ "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."
298
+ },
299
+ "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.",
300
+ "agentVisible": false
298
301
  },
299
302
  {
300
303
  "name": "within",
@@ -417,13 +420,6 @@ export const CONTRACT = {
417
420
  "flag": "case-sensitive",
418
421
  "description": "Case-sensitive matching. Default: false."
419
422
  },
420
- {
421
- "name": "select",
422
- "kind": "jsonFlag",
423
- "type": "json",
424
- "flag": "select-json",
425
- "description": "Search selector as JSON: {type:'text', pattern:'...'} or {type:'node', nodeType:'...'}."
426
- },
427
423
  {
428
424
  "name": "query",
429
425
  "kind": "jsonFlag",
@@ -1103,8 +1099,11 @@ export const CONTRACT = {
1103
1099
  "noteId"
1104
1100
  ]
1105
1101
  }
1106
- ]
1107
- }
1102
+ ],
1103
+ "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."
1104
+ },
1105
+ "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.",
1106
+ "agentVisible": false
1108
1107
  }
1109
1108
  ],
1110
1109
  "constraints": null,
@@ -1310,8 +1309,11 @@ export const CONTRACT = {
1310
1309
  "noteId"
1311
1310
  ]
1312
1311
  }
1313
- ]
1314
- }
1312
+ ],
1313
+ "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."
1314
+ },
1315
+ "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.",
1316
+ "agentVisible": false
1315
1317
  }
1316
1318
  ],
1317
1319
  "constraints": null,
@@ -1517,8 +1519,11 @@ export const CONTRACT = {
1517
1519
  "noteId"
1518
1520
  ]
1519
1521
  }
1520
- ]
1521
- }
1522
+ ],
1523
+ "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."
1524
+ },
1525
+ "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.",
1526
+ "agentVisible": false
1522
1527
  },
1523
1528
  {
1524
1529
  "name": "unflattenLists",
@@ -1765,6 +1770,25 @@ export const CONTRACT = {
1765
1770
  ],
1766
1771
  "type": "object"
1767
1772
  },
1773
+ "defaults": {
1774
+ "additionalProperties": false,
1775
+ "description": "Document's default body text formatting. Use these values when creating new content to match existing style.",
1776
+ "properties": {
1777
+ "fontFamily": {
1778
+ "description": "Most common body text font family.",
1779
+ "type": "string"
1780
+ },
1781
+ "fontSize": {
1782
+ "description": "Most common body text font size in half-points.",
1783
+ "type": "number"
1784
+ },
1785
+ "styleId": {
1786
+ "description": "Most common body paragraph style ID.",
1787
+ "type": "string"
1788
+ }
1789
+ },
1790
+ "type": "object"
1791
+ },
1768
1792
  "outline": {
1769
1793
  "items": {
1770
1794
  "additionalProperties": false,
@@ -1790,6 +1814,46 @@ export const CONTRACT = {
1790
1814
  },
1791
1815
  "revision": {
1792
1816
  "type": "string"
1817
+ },
1818
+ "styles": {
1819
+ "additionalProperties": false,
1820
+ "description": "Styles currently in use in the document.",
1821
+ "properties": {
1822
+ "paragraphStyles": {
1823
+ "description": "Paragraph styles in use, sorted by frequency (most common first).",
1824
+ "items": {
1825
+ "additionalProperties": false,
1826
+ "properties": {
1827
+ "count": {
1828
+ "description": "Number of paragraphs using this style.",
1829
+ "type": "integer"
1830
+ },
1831
+ "fontFamily": {
1832
+ "description": "Font family used by text in this style.",
1833
+ "type": "string"
1834
+ },
1835
+ "fontSize": {
1836
+ "description": "Font size in half-points used by text in this style.",
1837
+ "type": "number"
1838
+ },
1839
+ "styleId": {
1840
+ "description": "Style identifier (e.g. 'Normal', 'Heading1', 'BodyText').",
1841
+ "type": "string"
1842
+ }
1843
+ },
1844
+ "required": [
1845
+ "styleId",
1846
+ "count"
1847
+ ],
1848
+ "type": "object"
1849
+ },
1850
+ "type": "array"
1851
+ }
1852
+ },
1853
+ "required": [
1854
+ "paragraphStyles"
1855
+ ],
1856
+ "type": "object"
1793
1857
  }
1794
1858
  },
1795
1859
  "required": [
@@ -2408,8 +2472,11 @@ export const CONTRACT = {
2408
2472
  "noteId"
2409
2473
  ]
2410
2474
  }
2411
- ]
2412
- }
2475
+ ],
2476
+ "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."
2477
+ },
2478
+ "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.",
2479
+ "agentVisible": false
2413
2480
  },
2414
2481
  {
2415
2482
  "name": "value",
@@ -3622,8 +3689,11 @@ export const CONTRACT = {
3622
3689
  "noteId"
3623
3690
  ]
3624
3691
  }
3625
- ]
3626
- }
3692
+ ],
3693
+ "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."
3694
+ },
3695
+ "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.",
3696
+ "agentVisible": false
3627
3697
  },
3628
3698
  {
3629
3699
  "name": "text",
@@ -4566,8 +4636,11 @@ export const CONTRACT = {
4566
4636
  "noteId"
4567
4637
  ]
4568
4638
  }
4569
- ]
4570
- }
4639
+ ],
4640
+ "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."
4641
+ },
4642
+ "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.",
4643
+ "agentVisible": false
4571
4644
  },
4572
4645
  {
4573
4646
  "name": "behavior",
@@ -4774,12 +4847,14 @@ export const CONTRACT = {
4774
4847
  {
4775
4848
  "name": "offset",
4776
4849
  "kind": "flag",
4777
- "type": "number"
4850
+ "type": "number",
4851
+ "description": "Number of blocks to skip. Default: 0."
4778
4852
  },
4779
4853
  {
4780
4854
  "name": "limit",
4781
4855
  "kind": "flag",
4782
- "type": "number"
4856
+ "type": "number",
4857
+ "description": "Maximum blocks to return. Omit for all blocks."
4783
4858
  },
4784
4859
  {
4785
4860
  "name": "nodeTypes",
@@ -4818,8 +4893,10 @@ export const CONTRACT = {
4818
4893
  "const": "sdt"
4819
4894
  }
4820
4895
  ]
4821
- }
4822
- }
4896
+ },
4897
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
4898
+ },
4899
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
4823
4900
  }
4824
4901
  ],
4825
4902
  "constraints": null,
@@ -4831,10 +4908,12 @@ export const CONTRACT = {
4831
4908
  "additionalProperties": false,
4832
4909
  "properties": {
4833
4910
  "limit": {
4911
+ "description": "Maximum blocks to return. Omit for all blocks.",
4834
4912
  "minimum": 1,
4835
4913
  "type": "number"
4836
4914
  },
4837
4915
  "nodeTypes": {
4916
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types.",
4838
4917
  "items": {
4839
4918
  "enum": [
4840
4919
  "paragraph",
@@ -4851,6 +4930,7 @@ export const CONTRACT = {
4851
4930
  "type": "array"
4852
4931
  },
4853
4932
  "offset": {
4933
+ "description": "Number of blocks to skip. Default: 0.",
4854
4934
  "minimum": 0,
4855
4935
  "type": "number"
4856
4936
  }
@@ -4864,10 +4944,31 @@ export const CONTRACT = {
4864
4944
  "items": {
4865
4945
  "additionalProperties": false,
4866
4946
  "properties": {
4947
+ "alignment": {
4948
+ "description": "Paragraph alignment.",
4949
+ "type": "string"
4950
+ },
4951
+ "bold": {
4952
+ "description": "True if text is bold.",
4953
+ "type": "boolean"
4954
+ },
4955
+ "fontFamily": {
4956
+ "description": "Font family from first text run.",
4957
+ "type": "string"
4958
+ },
4959
+ "fontSize": {
4960
+ "description": "Font size from first text run.",
4961
+ "type": "number"
4962
+ },
4963
+ "headingLevel": {
4964
+ "description": "Heading level (1-6).",
4965
+ "type": "number"
4966
+ },
4867
4967
  "isEmpty": {
4868
4968
  "type": "boolean"
4869
4969
  },
4870
4970
  "nodeId": {
4971
+ "description": "Block ID for targeting with other tools.",
4871
4972
  "type": "string"
4872
4973
  },
4873
4974
  "nodeType": {
@@ -4886,6 +4987,17 @@ export const CONTRACT = {
4886
4987
  "ordinal": {
4887
4988
  "type": "number"
4888
4989
  },
4990
+ "styleId": {
4991
+ "description": "Named paragraph style.",
4992
+ "oneOf": [
4993
+ {
4994
+ "type": "string"
4995
+ },
4996
+ {
4997
+ "type": "null"
4998
+ }
4999
+ ]
5000
+ },
4889
5001
  "textPreview": {
4890
5002
  "oneOf": [
4891
5003
  {
@@ -4900,9 +5012,7 @@ export const CONTRACT = {
4900
5012
  "required": [
4901
5013
  "ordinal",
4902
5014
  "nodeId",
4903
- "nodeType",
4904
- "textPreview",
4905
- "isEmpty"
5015
+ "nodeType"
4906
5016
  ],
4907
5017
  "type": "object"
4908
5018
  },
@@ -4921,7 +5031,9 @@ export const CONTRACT = {
4921
5031
  "revision"
4922
5032
  ],
4923
5033
  "type": "object"
4924
- }
5034
+ },
5035
+ "intentGroup": "get_content",
5036
+ "intentAction": "blocks"
4925
5037
  },
4926
5038
  "doc.blocks.delete": {
4927
5039
  "operationId": "doc.blocks.delete",
@@ -5938,8 +6050,11 @@ export const CONTRACT = {
5938
6050
  "noteId"
5939
6051
  ]
5940
6052
  }
5941
- ]
5942
- }
6053
+ ],
6054
+ "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."
6055
+ },
6056
+ "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.",
6057
+ "agentVisible": false
5943
6058
  },
5944
6059
  {
5945
6060
  "name": "inline",
@@ -6726,19 +6841,22 @@ export const CONTRACT = {
6726
6841
  "kind": "flag",
6727
6842
  "type": "string",
6728
6843
  "flag": "block-id",
6729
- "description": "Block ID of the target paragraph."
6844
+ "description": "Block ID of the target paragraph.",
6845
+ "agentVisible": false
6730
6846
  },
6731
6847
  {
6732
6848
  "name": "start",
6733
6849
  "kind": "flag",
6734
6850
  "type": "number",
6735
- "description": "Start offset within the block (character index)."
6851
+ "description": "Start offset within the block (character index).",
6852
+ "agentVisible": false
6736
6853
  },
6737
6854
  {
6738
6855
  "name": "end",
6739
6856
  "kind": "flag",
6740
6857
  "type": "number",
6741
- "description": "End offset within the block (character index)."
6858
+ "description": "End offset within the block (character index).",
6859
+ "agentVisible": false
6742
6860
  }
6743
6861
  ],
6744
6862
  "constraints": null,
@@ -8771,19 +8889,22 @@ export const CONTRACT = {
8771
8889
  "kind": "flag",
8772
8890
  "type": "string",
8773
8891
  "flag": "block-id",
8774
- "description": "Block ID of the target paragraph."
8892
+ "description": "Block ID of the target paragraph.",
8893
+ "agentVisible": false
8775
8894
  },
8776
8895
  {
8777
8896
  "name": "start",
8778
8897
  "kind": "flag",
8779
8898
  "type": "number",
8780
- "description": "Start offset within the block (character index)."
8899
+ "description": "Start offset within the block (character index).",
8900
+ "agentVisible": false
8781
8901
  },
8782
8902
  {
8783
8903
  "name": "end",
8784
8904
  "kind": "flag",
8785
8905
  "type": "number",
8786
- "description": "End offset within the block (character index)."
8906
+ "description": "End offset within the block (character index).",
8907
+ "agentVisible": false
8787
8908
  }
8788
8909
  ],
8789
8910
  "constraints": null,
@@ -9207,19 +9328,22 @@ export const CONTRACT = {
9207
9328
  "kind": "flag",
9208
9329
  "type": "string",
9209
9330
  "flag": "block-id",
9210
- "description": "Block ID of the target paragraph."
9331
+ "description": "Block ID of the target paragraph.",
9332
+ "agentVisible": false
9211
9333
  },
9212
9334
  {
9213
9335
  "name": "start",
9214
9336
  "kind": "flag",
9215
9337
  "type": "number",
9216
- "description": "Start offset within the block (character index)."
9338
+ "description": "Start offset within the block (character index).",
9339
+ "agentVisible": false
9217
9340
  },
9218
9341
  {
9219
9342
  "name": "end",
9220
9343
  "kind": "flag",
9221
9344
  "type": "number",
9222
- "description": "End offset within the block (character index)."
9345
+ "description": "End offset within the block (character index).",
9346
+ "agentVisible": false
9223
9347
  }
9224
9348
  ],
9225
9349
  "constraints": null,
@@ -9643,19 +9767,22 @@ export const CONTRACT = {
9643
9767
  "kind": "flag",
9644
9768
  "type": "string",
9645
9769
  "flag": "block-id",
9646
- "description": "Block ID of the target paragraph."
9770
+ "description": "Block ID of the target paragraph.",
9771
+ "agentVisible": false
9647
9772
  },
9648
9773
  {
9649
9774
  "name": "start",
9650
9775
  "kind": "flag",
9651
9776
  "type": "number",
9652
- "description": "Start offset within the block (character index)."
9777
+ "description": "Start offset within the block (character index).",
9778
+ "agentVisible": false
9653
9779
  },
9654
9780
  {
9655
9781
  "name": "end",
9656
9782
  "kind": "flag",
9657
9783
  "type": "number",
9658
- "description": "End offset within the block (character index)."
9784
+ "description": "End offset within the block (character index).",
9785
+ "agentVisible": false
9659
9786
  }
9660
9787
  ],
9661
9788
  "constraints": null,
@@ -10114,19 +10241,22 @@ export const CONTRACT = {
10114
10241
  "kind": "flag",
10115
10242
  "type": "string",
10116
10243
  "flag": "block-id",
10117
- "description": "Block ID of the target paragraph."
10244
+ "description": "Block ID of the target paragraph.",
10245
+ "agentVisible": false
10118
10246
  },
10119
10247
  {
10120
10248
  "name": "start",
10121
10249
  "kind": "flag",
10122
10250
  "type": "number",
10123
- "description": "Start offset within the block (character index)."
10251
+ "description": "Start offset within the block (character index).",
10252
+ "agentVisible": false
10124
10253
  },
10125
10254
  {
10126
10255
  "name": "end",
10127
10256
  "kind": "flag",
10128
10257
  "type": "number",
10129
- "description": "End offset within the block (character index)."
10258
+ "description": "End offset within the block (character index).",
10259
+ "agentVisible": false
10130
10260
  }
10131
10261
  ],
10132
10262
  "constraints": null,
@@ -10630,19 +10760,22 @@ export const CONTRACT = {
10630
10760
  "kind": "flag",
10631
10761
  "type": "string",
10632
10762
  "flag": "block-id",
10633
- "description": "Block ID of the target paragraph."
10763
+ "description": "Block ID of the target paragraph.",
10764
+ "agentVisible": false
10634
10765
  },
10635
10766
  {
10636
10767
  "name": "start",
10637
10768
  "kind": "flag",
10638
10769
  "type": "number",
10639
- "description": "Start offset within the block (character index)."
10770
+ "description": "Start offset within the block (character index).",
10771
+ "agentVisible": false
10640
10772
  },
10641
10773
  {
10642
10774
  "name": "end",
10643
10775
  "kind": "flag",
10644
10776
  "type": "number",
10645
- "description": "End offset within the block (character index)."
10777
+ "description": "End offset within the block (character index).",
10778
+ "agentVisible": false
10646
10779
  }
10647
10780
  ],
10648
10781
  "constraints": null,
@@ -11070,19 +11203,22 @@ export const CONTRACT = {
11070
11203
  "kind": "flag",
11071
11204
  "type": "string",
11072
11205
  "flag": "block-id",
11073
- "description": "Block ID of the target paragraph."
11206
+ "description": "Block ID of the target paragraph.",
11207
+ "agentVisible": false
11074
11208
  },
11075
11209
  {
11076
11210
  "name": "start",
11077
11211
  "kind": "flag",
11078
11212
  "type": "number",
11079
- "description": "Start offset within the block (character index)."
11213
+ "description": "Start offset within the block (character index).",
11214
+ "agentVisible": false
11080
11215
  },
11081
11216
  {
11082
11217
  "name": "end",
11083
11218
  "kind": "flag",
11084
11219
  "type": "number",
11085
- "description": "End offset within the block (character index)."
11220
+ "description": "End offset within the block (character index).",
11221
+ "agentVisible": false
11086
11222
  }
11087
11223
  ],
11088
11224
  "constraints": null,
@@ -11510,19 +11646,22 @@ export const CONTRACT = {
11510
11646
  "kind": "flag",
11511
11647
  "type": "string",
11512
11648
  "flag": "block-id",
11513
- "description": "Block ID of the target paragraph."
11649
+ "description": "Block ID of the target paragraph.",
11650
+ "agentVisible": false
11514
11651
  },
11515
11652
  {
11516
11653
  "name": "start",
11517
11654
  "kind": "flag",
11518
11655
  "type": "number",
11519
- "description": "Start offset within the block (character index)."
11656
+ "description": "Start offset within the block (character index).",
11657
+ "agentVisible": false
11520
11658
  },
11521
11659
  {
11522
11660
  "name": "end",
11523
11661
  "kind": "flag",
11524
11662
  "type": "number",
11525
- "description": "End offset within the block (character index)."
11663
+ "description": "End offset within the block (character index).",
11664
+ "agentVisible": false
11526
11665
  }
11527
11666
  ],
11528
11667
  "constraints": null,
@@ -11948,19 +12087,22 @@ export const CONTRACT = {
11948
12087
  "kind": "flag",
11949
12088
  "type": "string",
11950
12089
  "flag": "block-id",
11951
- "description": "Block ID of the target paragraph."
12090
+ "description": "Block ID of the target paragraph.",
12091
+ "agentVisible": false
11952
12092
  },
11953
12093
  {
11954
12094
  "name": "start",
11955
12095
  "kind": "flag",
11956
12096
  "type": "number",
11957
- "description": "Start offset within the block (character index)."
12097
+ "description": "Start offset within the block (character index).",
12098
+ "agentVisible": false
11958
12099
  },
11959
12100
  {
11960
12101
  "name": "end",
11961
12102
  "kind": "flag",
11962
12103
  "type": "number",
11963
- "description": "End offset within the block (character index)."
12104
+ "description": "End offset within the block (character index).",
12105
+ "agentVisible": false
11964
12106
  }
11965
12107
  ],
11966
12108
  "constraints": null,
@@ -12388,19 +12530,22 @@ export const CONTRACT = {
12388
12530
  "kind": "flag",
12389
12531
  "type": "string",
12390
12532
  "flag": "block-id",
12391
- "description": "Block ID of the target paragraph."
12533
+ "description": "Block ID of the target paragraph.",
12534
+ "agentVisible": false
12392
12535
  },
12393
12536
  {
12394
12537
  "name": "start",
12395
12538
  "kind": "flag",
12396
12539
  "type": "number",
12397
- "description": "Start offset within the block (character index)."
12540
+ "description": "Start offset within the block (character index).",
12541
+ "agentVisible": false
12398
12542
  },
12399
12543
  {
12400
12544
  "name": "end",
12401
12545
  "kind": "flag",
12402
12546
  "type": "number",
12403
- "description": "End offset within the block (character index)."
12547
+ "description": "End offset within the block (character index).",
12548
+ "agentVisible": false
12404
12549
  }
12405
12550
  ],
12406
12551
  "constraints": null,
@@ -12836,19 +12981,22 @@ export const CONTRACT = {
12836
12981
  "kind": "flag",
12837
12982
  "type": "string",
12838
12983
  "flag": "block-id",
12839
- "description": "Block ID of the target paragraph."
12984
+ "description": "Block ID of the target paragraph.",
12985
+ "agentVisible": false
12840
12986
  },
12841
12987
  {
12842
12988
  "name": "start",
12843
12989
  "kind": "flag",
12844
12990
  "type": "number",
12845
- "description": "Start offset within the block (character index)."
12991
+ "description": "Start offset within the block (character index).",
12992
+ "agentVisible": false
12846
12993
  },
12847
12994
  {
12848
12995
  "name": "end",
12849
12996
  "kind": "flag",
12850
12997
  "type": "number",
12851
- "description": "End offset within the block (character index)."
12998
+ "description": "End offset within the block (character index).",
12999
+ "agentVisible": false
12852
13000
  }
12853
13001
  ],
12854
13002
  "constraints": null,
@@ -13282,19 +13430,22 @@ export const CONTRACT = {
13282
13430
  "kind": "flag",
13283
13431
  "type": "string",
13284
13432
  "flag": "block-id",
13285
- "description": "Block ID of the target paragraph."
13433
+ "description": "Block ID of the target paragraph.",
13434
+ "agentVisible": false
13286
13435
  },
13287
13436
  {
13288
13437
  "name": "start",
13289
13438
  "kind": "flag",
13290
13439
  "type": "number",
13291
- "description": "Start offset within the block (character index)."
13440
+ "description": "Start offset within the block (character index).",
13441
+ "agentVisible": false
13292
13442
  },
13293
13443
  {
13294
13444
  "name": "end",
13295
13445
  "kind": "flag",
13296
13446
  "type": "number",
13297
- "description": "End offset within the block (character index)."
13447
+ "description": "End offset within the block (character index).",
13448
+ "agentVisible": false
13298
13449
  }
13299
13450
  ],
13300
13451
  "constraints": null,
@@ -13720,19 +13871,22 @@ export const CONTRACT = {
13720
13871
  "kind": "flag",
13721
13872
  "type": "string",
13722
13873
  "flag": "block-id",
13723
- "description": "Block ID of the target paragraph."
13874
+ "description": "Block ID of the target paragraph.",
13875
+ "agentVisible": false
13724
13876
  },
13725
13877
  {
13726
13878
  "name": "start",
13727
13879
  "kind": "flag",
13728
13880
  "type": "number",
13729
- "description": "Start offset within the block (character index)."
13881
+ "description": "Start offset within the block (character index).",
13882
+ "agentVisible": false
13730
13883
  },
13731
13884
  {
13732
13885
  "name": "end",
13733
13886
  "kind": "flag",
13734
13887
  "type": "number",
13735
- "description": "End offset within the block (character index)."
13888
+ "description": "End offset within the block (character index).",
13889
+ "agentVisible": false
13736
13890
  }
13737
13891
  ],
13738
13892
  "constraints": null,
@@ -14156,19 +14310,22 @@ export const CONTRACT = {
14156
14310
  "kind": "flag",
14157
14311
  "type": "string",
14158
14312
  "flag": "block-id",
14159
- "description": "Block ID of the target paragraph."
14313
+ "description": "Block ID of the target paragraph.",
14314
+ "agentVisible": false
14160
14315
  },
14161
14316
  {
14162
14317
  "name": "start",
14163
14318
  "kind": "flag",
14164
14319
  "type": "number",
14165
- "description": "Start offset within the block (character index)."
14320
+ "description": "Start offset within the block (character index).",
14321
+ "agentVisible": false
14166
14322
  },
14167
14323
  {
14168
14324
  "name": "end",
14169
14325
  "kind": "flag",
14170
14326
  "type": "number",
14171
- "description": "End offset within the block (character index)."
14327
+ "description": "End offset within the block (character index).",
14328
+ "agentVisible": false
14172
14329
  }
14173
14330
  ],
14174
14331
  "constraints": null,
@@ -14592,19 +14749,22 @@ export const CONTRACT = {
14592
14749
  "kind": "flag",
14593
14750
  "type": "string",
14594
14751
  "flag": "block-id",
14595
- "description": "Block ID of the target paragraph."
14752
+ "description": "Block ID of the target paragraph.",
14753
+ "agentVisible": false
14596
14754
  },
14597
14755
  {
14598
14756
  "name": "start",
14599
14757
  "kind": "flag",
14600
14758
  "type": "number",
14601
- "description": "Start offset within the block (character index)."
14759
+ "description": "Start offset within the block (character index).",
14760
+ "agentVisible": false
14602
14761
  },
14603
14762
  {
14604
14763
  "name": "end",
14605
14764
  "kind": "flag",
14606
14765
  "type": "number",
14607
- "description": "End offset within the block (character index)."
14766
+ "description": "End offset within the block (character index).",
14767
+ "agentVisible": false
14608
14768
  }
14609
14769
  ],
14610
14770
  "constraints": null,
@@ -15060,19 +15220,22 @@ export const CONTRACT = {
15060
15220
  "kind": "flag",
15061
15221
  "type": "string",
15062
15222
  "flag": "block-id",
15063
- "description": "Block ID of the target paragraph."
15223
+ "description": "Block ID of the target paragraph.",
15224
+ "agentVisible": false
15064
15225
  },
15065
15226
  {
15066
15227
  "name": "start",
15067
15228
  "kind": "flag",
15068
15229
  "type": "number",
15069
- "description": "Start offset within the block (character index)."
15230
+ "description": "Start offset within the block (character index).",
15231
+ "agentVisible": false
15070
15232
  },
15071
15233
  {
15072
15234
  "name": "end",
15073
15235
  "kind": "flag",
15074
15236
  "type": "number",
15075
- "description": "End offset within the block (character index)."
15237
+ "description": "End offset within the block (character index).",
15238
+ "agentVisible": false
15076
15239
  }
15077
15240
  ],
15078
15241
  "constraints": null,
@@ -15614,19 +15777,22 @@ export const CONTRACT = {
15614
15777
  "kind": "flag",
15615
15778
  "type": "string",
15616
15779
  "flag": "block-id",
15617
- "description": "Block ID of the target paragraph."
15780
+ "description": "Block ID of the target paragraph.",
15781
+ "agentVisible": false
15618
15782
  },
15619
15783
  {
15620
15784
  "name": "start",
15621
15785
  "kind": "flag",
15622
15786
  "type": "number",
15623
- "description": "Start offset within the block (character index)."
15787
+ "description": "Start offset within the block (character index).",
15788
+ "agentVisible": false
15624
15789
  },
15625
15790
  {
15626
15791
  "name": "end",
15627
15792
  "kind": "flag",
15628
15793
  "type": "number",
15629
- "description": "End offset within the block (character index)."
15794
+ "description": "End offset within the block (character index).",
15795
+ "agentVisible": false
15630
15796
  }
15631
15797
  ],
15632
15798
  "constraints": null,
@@ -16144,19 +16310,22 @@ export const CONTRACT = {
16144
16310
  "kind": "flag",
16145
16311
  "type": "string",
16146
16312
  "flag": "block-id",
16147
- "description": "Block ID of the target paragraph."
16313
+ "description": "Block ID of the target paragraph.",
16314
+ "agentVisible": false
16148
16315
  },
16149
16316
  {
16150
16317
  "name": "start",
16151
16318
  "kind": "flag",
16152
16319
  "type": "number",
16153
- "description": "Start offset within the block (character index)."
16320
+ "description": "Start offset within the block (character index).",
16321
+ "agentVisible": false
16154
16322
  },
16155
16323
  {
16156
16324
  "name": "end",
16157
16325
  "kind": "flag",
16158
16326
  "type": "number",
16159
- "description": "End offset within the block (character index)."
16327
+ "description": "End offset within the block (character index).",
16328
+ "agentVisible": false
16160
16329
  }
16161
16330
  ],
16162
16331
  "constraints": null,
@@ -16580,19 +16749,22 @@ export const CONTRACT = {
16580
16749
  "kind": "flag",
16581
16750
  "type": "string",
16582
16751
  "flag": "block-id",
16583
- "description": "Block ID of the target paragraph."
16752
+ "description": "Block ID of the target paragraph.",
16753
+ "agentVisible": false
16584
16754
  },
16585
16755
  {
16586
16756
  "name": "start",
16587
16757
  "kind": "flag",
16588
16758
  "type": "number",
16589
- "description": "Start offset within the block (character index)."
16759
+ "description": "Start offset within the block (character index).",
16760
+ "agentVisible": false
16590
16761
  },
16591
16762
  {
16592
16763
  "name": "end",
16593
16764
  "kind": "flag",
16594
16765
  "type": "number",
16595
- "description": "End offset within the block (character index)."
16766
+ "description": "End offset within the block (character index).",
16767
+ "agentVisible": false
16596
16768
  }
16597
16769
  ],
16598
16770
  "constraints": null,
@@ -17016,19 +17188,22 @@ export const CONTRACT = {
17016
17188
  "kind": "flag",
17017
17189
  "type": "string",
17018
17190
  "flag": "block-id",
17019
- "description": "Block ID of the target paragraph."
17191
+ "description": "Block ID of the target paragraph.",
17192
+ "agentVisible": false
17020
17193
  },
17021
17194
  {
17022
17195
  "name": "start",
17023
17196
  "kind": "flag",
17024
17197
  "type": "number",
17025
- "description": "Start offset within the block (character index)."
17198
+ "description": "Start offset within the block (character index).",
17199
+ "agentVisible": false
17026
17200
  },
17027
17201
  {
17028
17202
  "name": "end",
17029
17203
  "kind": "flag",
17030
17204
  "type": "number",
17031
- "description": "End offset within the block (character index)."
17205
+ "description": "End offset within the block (character index).",
17206
+ "agentVisible": false
17032
17207
  }
17033
17208
  ],
17034
17209
  "constraints": null,
@@ -17452,19 +17627,22 @@ export const CONTRACT = {
17452
17627
  "kind": "flag",
17453
17628
  "type": "string",
17454
17629
  "flag": "block-id",
17455
- "description": "Block ID of the target paragraph."
17630
+ "description": "Block ID of the target paragraph.",
17631
+ "agentVisible": false
17456
17632
  },
17457
17633
  {
17458
17634
  "name": "start",
17459
17635
  "kind": "flag",
17460
17636
  "type": "number",
17461
- "description": "Start offset within the block (character index)."
17637
+ "description": "Start offset within the block (character index).",
17638
+ "agentVisible": false
17462
17639
  },
17463
17640
  {
17464
17641
  "name": "end",
17465
17642
  "kind": "flag",
17466
17643
  "type": "number",
17467
- "description": "End offset within the block (character index)."
17644
+ "description": "End offset within the block (character index).",
17645
+ "agentVisible": false
17468
17646
  }
17469
17647
  ],
17470
17648
  "constraints": null,
@@ -17888,19 +18066,22 @@ export const CONTRACT = {
17888
18066
  "kind": "flag",
17889
18067
  "type": "string",
17890
18068
  "flag": "block-id",
17891
- "description": "Block ID of the target paragraph."
18069
+ "description": "Block ID of the target paragraph.",
18070
+ "agentVisible": false
17892
18071
  },
17893
18072
  {
17894
18073
  "name": "start",
17895
18074
  "kind": "flag",
17896
18075
  "type": "number",
17897
- "description": "Start offset within the block (character index)."
18076
+ "description": "Start offset within the block (character index).",
18077
+ "agentVisible": false
17898
18078
  },
17899
18079
  {
17900
18080
  "name": "end",
17901
18081
  "kind": "flag",
17902
18082
  "type": "number",
17903
- "description": "End offset within the block (character index)."
18083
+ "description": "End offset within the block (character index).",
18084
+ "agentVisible": false
17904
18085
  }
17905
18086
  ],
17906
18087
  "constraints": null,
@@ -18326,19 +18507,22 @@ export const CONTRACT = {
18326
18507
  "kind": "flag",
18327
18508
  "type": "string",
18328
18509
  "flag": "block-id",
18329
- "description": "Block ID of the target paragraph."
18510
+ "description": "Block ID of the target paragraph.",
18511
+ "agentVisible": false
18330
18512
  },
18331
18513
  {
18332
18514
  "name": "start",
18333
18515
  "kind": "flag",
18334
18516
  "type": "number",
18335
- "description": "Start offset within the block (character index)."
18517
+ "description": "Start offset within the block (character index).",
18518
+ "agentVisible": false
18336
18519
  },
18337
18520
  {
18338
18521
  "name": "end",
18339
18522
  "kind": "flag",
18340
18523
  "type": "number",
18341
- "description": "End offset within the block (character index)."
18524
+ "description": "End offset within the block (character index).",
18525
+ "agentVisible": false
18342
18526
  }
18343
18527
  ],
18344
18528
  "constraints": null,
@@ -18764,19 +18948,22 @@ export const CONTRACT = {
18764
18948
  "kind": "flag",
18765
18949
  "type": "string",
18766
18950
  "flag": "block-id",
18767
- "description": "Block ID of the target paragraph."
18951
+ "description": "Block ID of the target paragraph.",
18952
+ "agentVisible": false
18768
18953
  },
18769
18954
  {
18770
18955
  "name": "start",
18771
18956
  "kind": "flag",
18772
18957
  "type": "number",
18773
- "description": "Start offset within the block (character index)."
18958
+ "description": "Start offset within the block (character index).",
18959
+ "agentVisible": false
18774
18960
  },
18775
18961
  {
18776
18962
  "name": "end",
18777
18963
  "kind": "flag",
18778
18964
  "type": "number",
18779
- "description": "End offset within the block (character index)."
18965
+ "description": "End offset within the block (character index).",
18966
+ "agentVisible": false
18780
18967
  }
18781
18968
  ],
18782
18969
  "constraints": null,
@@ -19200,19 +19387,22 @@ export const CONTRACT = {
19200
19387
  "kind": "flag",
19201
19388
  "type": "string",
19202
19389
  "flag": "block-id",
19203
- "description": "Block ID of the target paragraph."
19390
+ "description": "Block ID of the target paragraph.",
19391
+ "agentVisible": false
19204
19392
  },
19205
19393
  {
19206
19394
  "name": "start",
19207
19395
  "kind": "flag",
19208
19396
  "type": "number",
19209
- "description": "Start offset within the block (character index)."
19397
+ "description": "Start offset within the block (character index).",
19398
+ "agentVisible": false
19210
19399
  },
19211
19400
  {
19212
19401
  "name": "end",
19213
19402
  "kind": "flag",
19214
19403
  "type": "number",
19215
- "description": "End offset within the block (character index)."
19404
+ "description": "End offset within the block (character index).",
19405
+ "agentVisible": false
19216
19406
  }
19217
19407
  ],
19218
19408
  "constraints": null,
@@ -19636,19 +19826,22 @@ export const CONTRACT = {
19636
19826
  "kind": "flag",
19637
19827
  "type": "string",
19638
19828
  "flag": "block-id",
19639
- "description": "Block ID of the target paragraph."
19829
+ "description": "Block ID of the target paragraph.",
19830
+ "agentVisible": false
19640
19831
  },
19641
19832
  {
19642
19833
  "name": "start",
19643
19834
  "kind": "flag",
19644
19835
  "type": "number",
19645
- "description": "Start offset within the block (character index)."
19836
+ "description": "Start offset within the block (character index).",
19837
+ "agentVisible": false
19646
19838
  },
19647
19839
  {
19648
19840
  "name": "end",
19649
19841
  "kind": "flag",
19650
19842
  "type": "number",
19651
- "description": "End offset within the block (character index)."
19843
+ "description": "End offset within the block (character index).",
19844
+ "agentVisible": false
19652
19845
  }
19653
19846
  ],
19654
19847
  "constraints": null,
@@ -20072,19 +20265,22 @@ export const CONTRACT = {
20072
20265
  "kind": "flag",
20073
20266
  "type": "string",
20074
20267
  "flag": "block-id",
20075
- "description": "Block ID of the target paragraph."
20268
+ "description": "Block ID of the target paragraph.",
20269
+ "agentVisible": false
20076
20270
  },
20077
20271
  {
20078
20272
  "name": "start",
20079
20273
  "kind": "flag",
20080
20274
  "type": "number",
20081
- "description": "Start offset within the block (character index)."
20275
+ "description": "Start offset within the block (character index).",
20276
+ "agentVisible": false
20082
20277
  },
20083
20278
  {
20084
20279
  "name": "end",
20085
20280
  "kind": "flag",
20086
20281
  "type": "number",
20087
- "description": "End offset within the block (character index)."
20282
+ "description": "End offset within the block (character index).",
20283
+ "agentVisible": false
20088
20284
  }
20089
20285
  ],
20090
20286
  "constraints": null,
@@ -20508,19 +20704,22 @@ export const CONTRACT = {
20508
20704
  "kind": "flag",
20509
20705
  "type": "string",
20510
20706
  "flag": "block-id",
20511
- "description": "Block ID of the target paragraph."
20707
+ "description": "Block ID of the target paragraph.",
20708
+ "agentVisible": false
20512
20709
  },
20513
20710
  {
20514
20711
  "name": "start",
20515
20712
  "kind": "flag",
20516
20713
  "type": "number",
20517
- "description": "Start offset within the block (character index)."
20714
+ "description": "Start offset within the block (character index).",
20715
+ "agentVisible": false
20518
20716
  },
20519
20717
  {
20520
20718
  "name": "end",
20521
20719
  "kind": "flag",
20522
20720
  "type": "number",
20523
- "description": "End offset within the block (character index)."
20721
+ "description": "End offset within the block (character index).",
20722
+ "agentVisible": false
20524
20723
  }
20525
20724
  ],
20526
20725
  "constraints": null,
@@ -20944,19 +21143,22 @@ export const CONTRACT = {
20944
21143
  "kind": "flag",
20945
21144
  "type": "string",
20946
21145
  "flag": "block-id",
20947
- "description": "Block ID of the target paragraph."
21146
+ "description": "Block ID of the target paragraph.",
21147
+ "agentVisible": false
20948
21148
  },
20949
21149
  {
20950
21150
  "name": "start",
20951
21151
  "kind": "flag",
20952
21152
  "type": "number",
20953
- "description": "Start offset within the block (character index)."
21153
+ "description": "Start offset within the block (character index).",
21154
+ "agentVisible": false
20954
21155
  },
20955
21156
  {
20956
21157
  "name": "end",
20957
21158
  "kind": "flag",
20958
21159
  "type": "number",
20959
- "description": "End offset within the block (character index)."
21160
+ "description": "End offset within the block (character index).",
21161
+ "agentVisible": false
20960
21162
  }
20961
21163
  ],
20962
21164
  "constraints": null,
@@ -21380,19 +21582,22 @@ export const CONTRACT = {
21380
21582
  "kind": "flag",
21381
21583
  "type": "string",
21382
21584
  "flag": "block-id",
21383
- "description": "Block ID of the target paragraph."
21585
+ "description": "Block ID of the target paragraph.",
21586
+ "agentVisible": false
21384
21587
  },
21385
21588
  {
21386
21589
  "name": "start",
21387
21590
  "kind": "flag",
21388
21591
  "type": "number",
21389
- "description": "Start offset within the block (character index)."
21592
+ "description": "Start offset within the block (character index).",
21593
+ "agentVisible": false
21390
21594
  },
21391
21595
  {
21392
21596
  "name": "end",
21393
21597
  "kind": "flag",
21394
21598
  "type": "number",
21395
- "description": "End offset within the block (character index)."
21599
+ "description": "End offset within the block (character index).",
21600
+ "agentVisible": false
21396
21601
  }
21397
21602
  ],
21398
21603
  "constraints": null,
@@ -21868,19 +22073,22 @@ export const CONTRACT = {
21868
22073
  "kind": "flag",
21869
22074
  "type": "string",
21870
22075
  "flag": "block-id",
21871
- "description": "Block ID of the target paragraph."
22076
+ "description": "Block ID of the target paragraph.",
22077
+ "agentVisible": false
21872
22078
  },
21873
22079
  {
21874
22080
  "name": "start",
21875
22081
  "kind": "flag",
21876
22082
  "type": "number",
21877
- "description": "Start offset within the block (character index)."
22083
+ "description": "Start offset within the block (character index).",
22084
+ "agentVisible": false
21878
22085
  },
21879
22086
  {
21880
22087
  "name": "end",
21881
22088
  "kind": "flag",
21882
22089
  "type": "number",
21883
- "description": "End offset within the block (character index)."
22090
+ "description": "End offset within the block (character index).",
22091
+ "agentVisible": false
21884
22092
  }
21885
22093
  ],
21886
22094
  "constraints": null,
@@ -22418,19 +22626,22 @@ export const CONTRACT = {
22418
22626
  "kind": "flag",
22419
22627
  "type": "string",
22420
22628
  "flag": "block-id",
22421
- "description": "Block ID of the target paragraph."
22629
+ "description": "Block ID of the target paragraph.",
22630
+ "agentVisible": false
22422
22631
  },
22423
22632
  {
22424
22633
  "name": "start",
22425
22634
  "kind": "flag",
22426
22635
  "type": "number",
22427
- "description": "Start offset within the block (character index)."
22636
+ "description": "Start offset within the block (character index).",
22637
+ "agentVisible": false
22428
22638
  },
22429
22639
  {
22430
22640
  "name": "end",
22431
22641
  "kind": "flag",
22432
22642
  "type": "number",
22433
- "description": "End offset within the block (character index)."
22643
+ "description": "End offset within the block (character index).",
22644
+ "agentVisible": false
22434
22645
  }
22435
22646
  ],
22436
22647
  "constraints": null,
@@ -22880,19 +23091,22 @@ export const CONTRACT = {
22880
23091
  "kind": "flag",
22881
23092
  "type": "string",
22882
23093
  "flag": "block-id",
22883
- "description": "Block ID of the target paragraph."
23094
+ "description": "Block ID of the target paragraph.",
23095
+ "agentVisible": false
22884
23096
  },
22885
23097
  {
22886
23098
  "name": "start",
22887
23099
  "kind": "flag",
22888
23100
  "type": "number",
22889
- "description": "Start offset within the block (character index)."
23101
+ "description": "Start offset within the block (character index).",
23102
+ "agentVisible": false
22890
23103
  },
22891
23104
  {
22892
23105
  "name": "end",
22893
23106
  "kind": "flag",
22894
23107
  "type": "number",
22895
- "description": "End offset within the block (character index)."
23108
+ "description": "End offset within the block (character index).",
23109
+ "agentVisible": false
22896
23110
  }
22897
23111
  ],
22898
23112
  "constraints": null,
@@ -23368,19 +23582,22 @@ export const CONTRACT = {
23368
23582
  "kind": "flag",
23369
23583
  "type": "string",
23370
23584
  "flag": "block-id",
23371
- "description": "Block ID of the target paragraph."
23585
+ "description": "Block ID of the target paragraph.",
23586
+ "agentVisible": false
23372
23587
  },
23373
23588
  {
23374
23589
  "name": "start",
23375
23590
  "kind": "flag",
23376
23591
  "type": "number",
23377
- "description": "Start offset within the block (character index)."
23592
+ "description": "Start offset within the block (character index).",
23593
+ "agentVisible": false
23378
23594
  },
23379
23595
  {
23380
23596
  "name": "end",
23381
23597
  "kind": "flag",
23382
23598
  "type": "number",
23383
- "description": "End offset within the block (character index)."
23599
+ "description": "End offset within the block (character index).",
23600
+ "agentVisible": false
23384
23601
  }
23385
23602
  ],
23386
23603
  "constraints": null,
@@ -23836,19 +24053,22 @@ export const CONTRACT = {
23836
24053
  "kind": "flag",
23837
24054
  "type": "string",
23838
24055
  "flag": "block-id",
23839
- "description": "Block ID of the target paragraph."
24056
+ "description": "Block ID of the target paragraph.",
24057
+ "agentVisible": false
23840
24058
  },
23841
24059
  {
23842
24060
  "name": "start",
23843
24061
  "kind": "flag",
23844
24062
  "type": "number",
23845
- "description": "Start offset within the block (character index)."
24063
+ "description": "Start offset within the block (character index).",
24064
+ "agentVisible": false
23846
24065
  },
23847
24066
  {
23848
24067
  "name": "end",
23849
24068
  "kind": "flag",
23850
24069
  "type": "number",
23851
- "description": "End offset within the block (character index)."
24070
+ "description": "End offset within the block (character index).",
24071
+ "agentVisible": false
23852
24072
  }
23853
24073
  ],
23854
24074
  "constraints": null,
@@ -24348,19 +24568,22 @@ export const CONTRACT = {
24348
24568
  "kind": "flag",
24349
24569
  "type": "string",
24350
24570
  "flag": "block-id",
24351
- "description": "Block ID of the target paragraph."
24571
+ "description": "Block ID of the target paragraph.",
24572
+ "agentVisible": false
24352
24573
  },
24353
24574
  {
24354
24575
  "name": "start",
24355
24576
  "kind": "flag",
24356
24577
  "type": "number",
24357
- "description": "Start offset within the block (character index)."
24578
+ "description": "Start offset within the block (character index).",
24579
+ "agentVisible": false
24358
24580
  },
24359
24581
  {
24360
24582
  "name": "end",
24361
24583
  "kind": "flag",
24362
24584
  "type": "number",
24363
- "description": "End offset within the block (character index)."
24585
+ "description": "End offset within the block (character index).",
24586
+ "agentVisible": false
24364
24587
  }
24365
24588
  ],
24366
24589
  "constraints": null,
@@ -24784,19 +25007,22 @@ export const CONTRACT = {
24784
25007
  "kind": "flag",
24785
25008
  "type": "string",
24786
25009
  "flag": "block-id",
24787
- "description": "Block ID of the target paragraph."
25010
+ "description": "Block ID of the target paragraph.",
25011
+ "agentVisible": false
24788
25012
  },
24789
25013
  {
24790
25014
  "name": "start",
24791
25015
  "kind": "flag",
24792
25016
  "type": "number",
24793
- "description": "Start offset within the block (character index)."
25017
+ "description": "Start offset within the block (character index).",
25018
+ "agentVisible": false
24794
25019
  },
24795
25020
  {
24796
25021
  "name": "end",
24797
25022
  "kind": "flag",
24798
25023
  "type": "number",
24799
- "description": "End offset within the block (character index)."
25024
+ "description": "End offset within the block (character index).",
25025
+ "agentVisible": false
24800
25026
  }
24801
25027
  ],
24802
25028
  "constraints": null,
@@ -25316,19 +25542,22 @@ export const CONTRACT = {
25316
25542
  "kind": "flag",
25317
25543
  "type": "string",
25318
25544
  "flag": "block-id",
25319
- "description": "Block ID of the target paragraph."
25545
+ "description": "Block ID of the target paragraph.",
25546
+ "agentVisible": false
25320
25547
  },
25321
25548
  {
25322
25549
  "name": "start",
25323
25550
  "kind": "flag",
25324
25551
  "type": "number",
25325
- "description": "Start offset within the block (character index)."
25552
+ "description": "Start offset within the block (character index).",
25553
+ "agentVisible": false
25326
25554
  },
25327
25555
  {
25328
25556
  "name": "end",
25329
25557
  "kind": "flag",
25330
25558
  "type": "number",
25331
- "description": "End offset within the block (character index)."
25559
+ "description": "End offset within the block (character index).",
25560
+ "agentVisible": false
25332
25561
  }
25333
25562
  ],
25334
25563
  "constraints": null,
@@ -25960,19 +26189,22 @@ export const CONTRACT = {
25960
26189
  "kind": "flag",
25961
26190
  "type": "string",
25962
26191
  "flag": "block-id",
25963
- "description": "Block ID of the target paragraph."
26192
+ "description": "Block ID of the target paragraph.",
26193
+ "agentVisible": false
25964
26194
  },
25965
26195
  {
25966
26196
  "name": "start",
25967
26197
  "kind": "flag",
25968
26198
  "type": "number",
25969
- "description": "Start offset within the block (character index)."
26199
+ "description": "Start offset within the block (character index).",
26200
+ "agentVisible": false
25970
26201
  },
25971
26202
  {
25972
26203
  "name": "end",
25973
26204
  "kind": "flag",
25974
26205
  "type": "number",
25975
- "description": "End offset within the block (character index)."
26206
+ "description": "End offset within the block (character index).",
26207
+ "agentVisible": false
25976
26208
  }
25977
26209
  ],
25978
26210
  "constraints": null,
@@ -26398,19 +26630,22 @@ export const CONTRACT = {
26398
26630
  "kind": "flag",
26399
26631
  "type": "string",
26400
26632
  "flag": "block-id",
26401
- "description": "Block ID of the target paragraph."
26633
+ "description": "Block ID of the target paragraph.",
26634
+ "agentVisible": false
26402
26635
  },
26403
26636
  {
26404
26637
  "name": "start",
26405
26638
  "kind": "flag",
26406
26639
  "type": "number",
26407
- "description": "Start offset within the block (character index)."
26640
+ "description": "Start offset within the block (character index).",
26641
+ "agentVisible": false
26408
26642
  },
26409
26643
  {
26410
26644
  "name": "end",
26411
26645
  "kind": "flag",
26412
26646
  "type": "number",
26413
- "description": "End offset within the block (character index)."
26647
+ "description": "End offset within the block (character index).",
26648
+ "agentVisible": false
26414
26649
  }
26415
26650
  ],
26416
26651
  "constraints": null,
@@ -26838,19 +27073,22 @@ export const CONTRACT = {
26838
27073
  "kind": "flag",
26839
27074
  "type": "string",
26840
27075
  "flag": "block-id",
26841
- "description": "Block ID of the target paragraph."
27076
+ "description": "Block ID of the target paragraph.",
27077
+ "agentVisible": false
26842
27078
  },
26843
27079
  {
26844
27080
  "name": "start",
26845
27081
  "kind": "flag",
26846
27082
  "type": "number",
26847
- "description": "Start offset within the block (character index)."
27083
+ "description": "Start offset within the block (character index).",
27084
+ "agentVisible": false
26848
27085
  },
26849
27086
  {
26850
27087
  "name": "end",
26851
27088
  "kind": "flag",
26852
27089
  "type": "number",
26853
- "description": "End offset within the block (character index)."
27090
+ "description": "End offset within the block (character index).",
27091
+ "agentVisible": false
26854
27092
  }
26855
27093
  ],
26856
27094
  "constraints": null,
@@ -27278,19 +27516,22 @@ export const CONTRACT = {
27278
27516
  "kind": "flag",
27279
27517
  "type": "string",
27280
27518
  "flag": "block-id",
27281
- "description": "Block ID of the target paragraph."
27519
+ "description": "Block ID of the target paragraph.",
27520
+ "agentVisible": false
27282
27521
  },
27283
27522
  {
27284
27523
  "name": "start",
27285
27524
  "kind": "flag",
27286
27525
  "type": "number",
27287
- "description": "Start offset within the block (character index)."
27526
+ "description": "Start offset within the block (character index).",
27527
+ "agentVisible": false
27288
27528
  },
27289
27529
  {
27290
27530
  "name": "end",
27291
27531
  "kind": "flag",
27292
27532
  "type": "number",
27293
- "description": "End offset within the block (character index)."
27533
+ "description": "End offset within the block (character index).",
27534
+ "agentVisible": false
27294
27535
  }
27295
27536
  ],
27296
27537
  "constraints": null,
@@ -27732,19 +27973,22 @@ export const CONTRACT = {
27732
27973
  "kind": "flag",
27733
27974
  "type": "string",
27734
27975
  "flag": "block-id",
27735
- "description": "Block ID of the target paragraph."
27976
+ "description": "Block ID of the target paragraph.",
27977
+ "agentVisible": false
27736
27978
  },
27737
27979
  {
27738
27980
  "name": "start",
27739
27981
  "kind": "flag",
27740
27982
  "type": "number",
27741
- "description": "Start offset within the block (character index)."
27983
+ "description": "Start offset within the block (character index).",
27984
+ "agentVisible": false
27742
27985
  },
27743
27986
  {
27744
27987
  "name": "end",
27745
27988
  "kind": "flag",
27746
27989
  "type": "number",
27747
- "description": "End offset within the block (character index)."
27990
+ "description": "End offset within the block (character index).",
27991
+ "agentVisible": false
27748
27992
  }
27749
27993
  ],
27750
27994
  "constraints": null,
@@ -28202,19 +28446,22 @@ export const CONTRACT = {
28202
28446
  "kind": "flag",
28203
28447
  "type": "string",
28204
28448
  "flag": "block-id",
28205
- "description": "Block ID of the target paragraph."
28449
+ "description": "Block ID of the target paragraph.",
28450
+ "agentVisible": false
28206
28451
  },
28207
28452
  {
28208
28453
  "name": "start",
28209
28454
  "kind": "flag",
28210
28455
  "type": "number",
28211
- "description": "Start offset within the block (character index)."
28456
+ "description": "Start offset within the block (character index).",
28457
+ "agentVisible": false
28212
28458
  },
28213
28459
  {
28214
28460
  "name": "end",
28215
28461
  "kind": "flag",
28216
28462
  "type": "number",
28217
- "description": "End offset within the block (character index)."
28463
+ "description": "End offset within the block (character index).",
28464
+ "agentVisible": false
28218
28465
  }
28219
28466
  ],
28220
28467
  "constraints": null,
@@ -32860,8 +33107,11 @@ export const CONTRACT = {
32860
33107
  "noteId"
32861
33108
  ]
32862
33109
  }
32863
- ]
32864
- }
33110
+ ],
33111
+ "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."
33112
+ },
33113
+ "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.",
33114
+ "agentVisible": false
32865
33115
  },
32866
33116
  {
32867
33117
  "name": "at",
@@ -33019,7 +33269,7 @@ export const CONTRACT = {
33019
33269
  "name": "text",
33020
33270
  "kind": "flag",
33021
33271
  "type": "string",
33022
- "description": "Paragraph text content."
33272
+ "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item — do NOT use newlines to put multiple items in one paragraph."
33023
33273
  },
33024
33274
  {
33025
33275
  "name": "input",
@@ -33102,7 +33352,7 @@ export const CONTRACT = {
33102
33352
  "$ref": "#/$defs/StoryLocator"
33103
33353
  },
33104
33354
  "text": {
33105
- "description": "Paragraph text content.",
33355
+ "description": "Paragraph text content. Each call creates ONE paragraph. For multiple items (e.g. list items), call superdoc_create separately for each item — do NOT use newlines to put multiple items in one paragraph.",
33106
33356
  "type": "string"
33107
33357
  }
33108
33358
  },
@@ -33454,8 +33704,11 @@ export const CONTRACT = {
33454
33704
  "noteId"
33455
33705
  ]
33456
33706
  }
33457
- ]
33458
- }
33707
+ ],
33708
+ "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."
33709
+ },
33710
+ "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.",
33711
+ "agentVisible": false
33459
33712
  },
33460
33713
  {
33461
33714
  "name": "level",
@@ -39983,7 +40236,8 @@ export const CONTRACT = {
39983
40236
  "kind": "flag",
39984
40237
  "type": "string",
39985
40238
  "flag": "style-id",
39986
- "required": true
40239
+ "required": true,
40240
+ "description": "Named paragraph style ID (e.g. 'Normal', 'Heading1', 'BodyText'). Use superdoc_search to find a nearby paragraph, then inspect its style to determine the correct styleId."
39987
40241
  }
39988
40242
  ],
39989
40243
  "constraints": null,
@@ -39995,6 +40249,7 @@ export const CONTRACT = {
39995
40249
  "additionalProperties": false,
39996
40250
  "properties": {
39997
40251
  "styleId": {
40252
+ "description": "Named paragraph style ID (e.g. 'Normal', 'Heading1', 'BodyText'). Use superdoc_search to find a nearby paragraph, then inspect its style to determine the correct styleId.",
39998
40253
  "minLength": 1,
39999
40254
  "type": "string"
40000
40255
  },
@@ -40742,19 +40997,22 @@ export const CONTRACT = {
40742
40997
  "kind": "flag",
40743
40998
  "type": "string",
40744
40999
  "flag": "block-id",
40745
- "description": "Block ID of the target paragraph."
41000
+ "description": "Block ID of the target paragraph.",
41001
+ "agentVisible": false
40746
41002
  },
40747
41003
  {
40748
41004
  "name": "start",
40749
41005
  "kind": "flag",
40750
41006
  "type": "number",
40751
- "description": "Start offset within the block (character index)."
41007
+ "description": "Start offset within the block (character index).",
41008
+ "agentVisible": false
40752
41009
  },
40753
41010
  {
40754
41011
  "name": "end",
40755
41012
  "kind": "flag",
40756
41013
  "type": "number",
40757
- "description": "End offset within the block (character index)."
41014
+ "description": "End offset within the block (character index).",
41015
+ "agentVisible": false
40758
41016
  }
40759
41017
  ],
40760
41018
  "constraints": null,
@@ -41154,19 +41412,22 @@ export const CONTRACT = {
41154
41412
  "kind": "flag",
41155
41413
  "type": "string",
41156
41414
  "flag": "block-id",
41157
- "description": "Block ID of the target paragraph."
41415
+ "description": "Block ID of the target paragraph.",
41416
+ "agentVisible": false
41158
41417
  },
41159
41418
  {
41160
41419
  "name": "start",
41161
41420
  "kind": "flag",
41162
41421
  "type": "number",
41163
- "description": "Start offset within the block (character index)."
41422
+ "description": "Start offset within the block (character index).",
41423
+ "agentVisible": false
41164
41424
  },
41165
41425
  {
41166
41426
  "name": "end",
41167
41427
  "kind": "flag",
41168
41428
  "type": "number",
41169
- "description": "End offset within the block (character index)."
41429
+ "description": "End offset within the block (character index).",
41430
+ "agentVisible": false
41170
41431
  }
41171
41432
  ],
41172
41433
  "constraints": null,
@@ -41556,19 +41817,22 @@ export const CONTRACT = {
41556
41817
  "kind": "flag",
41557
41818
  "type": "string",
41558
41819
  "flag": "block-id",
41559
- "description": "Block ID of the target paragraph."
41820
+ "description": "Block ID of the target paragraph.",
41821
+ "agentVisible": false
41560
41822
  },
41561
41823
  {
41562
41824
  "name": "start",
41563
41825
  "kind": "flag",
41564
41826
  "type": "number",
41565
- "description": "Start offset within the block (character index)."
41827
+ "description": "Start offset within the block (character index).",
41828
+ "agentVisible": false
41566
41829
  },
41567
41830
  {
41568
41831
  "name": "end",
41569
41832
  "kind": "flag",
41570
41833
  "type": "number",
41571
- "description": "End offset within the block (character index)."
41834
+ "description": "End offset within the block (character index).",
41835
+ "agentVisible": false
41572
41836
  }
41573
41837
  ],
41574
41838
  "constraints": null,
@@ -41972,19 +42236,22 @@ export const CONTRACT = {
41972
42236
  "kind": "flag",
41973
42237
  "type": "string",
41974
42238
  "flag": "block-id",
41975
- "description": "Block ID of the target paragraph."
42239
+ "description": "Block ID of the target paragraph.",
42240
+ "agentVisible": false
41976
42241
  },
41977
42242
  {
41978
42243
  "name": "start",
41979
42244
  "kind": "flag",
41980
42245
  "type": "number",
41981
- "description": "Start offset within the block (character index)."
42246
+ "description": "Start offset within the block (character index).",
42247
+ "agentVisible": false
41982
42248
  },
41983
42249
  {
41984
42250
  "name": "end",
41985
42251
  "kind": "flag",
41986
42252
  "type": "number",
41987
- "description": "End offset within the block (character index)."
42253
+ "description": "End offset within the block (character index).",
42254
+ "agentVisible": false
41988
42255
  }
41989
42256
  ],
41990
42257
  "constraints": null,
@@ -42413,19 +42680,22 @@ export const CONTRACT = {
42413
42680
  "kind": "flag",
42414
42681
  "type": "string",
42415
42682
  "flag": "block-id",
42416
- "description": "Block ID of the target paragraph."
42683
+ "description": "Block ID of the target paragraph.",
42684
+ "agentVisible": false
42417
42685
  },
42418
42686
  {
42419
42687
  "name": "start",
42420
42688
  "kind": "flag",
42421
42689
  "type": "number",
42422
- "description": "Start offset within the block (character index)."
42690
+ "description": "Start offset within the block (character index).",
42691
+ "agentVisible": false
42423
42692
  },
42424
42693
  {
42425
42694
  "name": "end",
42426
42695
  "kind": "flag",
42427
42696
  "type": "number",
42428
- "description": "End offset within the block (character index)."
42697
+ "description": "End offset within the block (character index).",
42698
+ "agentVisible": false
42429
42699
  }
42430
42700
  ],
42431
42701
  "constraints": null,
@@ -42843,19 +43113,22 @@ export const CONTRACT = {
42843
43113
  "kind": "flag",
42844
43114
  "type": "string",
42845
43115
  "flag": "block-id",
42846
- "description": "Block ID of the target paragraph."
43116
+ "description": "Block ID of the target paragraph.",
43117
+ "agentVisible": false
42847
43118
  },
42848
43119
  {
42849
43120
  "name": "start",
42850
43121
  "kind": "flag",
42851
43122
  "type": "number",
42852
- "description": "Start offset within the block (character index)."
43123
+ "description": "Start offset within the block (character index).",
43124
+ "agentVisible": false
42853
43125
  },
42854
43126
  {
42855
43127
  "name": "end",
42856
43128
  "kind": "flag",
42857
43129
  "type": "number",
42858
- "description": "End offset within the block (character index)."
43130
+ "description": "End offset within the block (character index).",
43131
+ "agentVisible": false
42859
43132
  }
42860
43133
  ],
42861
43134
  "constraints": null,
@@ -43291,19 +43564,22 @@ export const CONTRACT = {
43291
43564
  "kind": "flag",
43292
43565
  "type": "string",
43293
43566
  "flag": "block-id",
43294
- "description": "Block ID of the target paragraph."
43567
+ "description": "Block ID of the target paragraph.",
43568
+ "agentVisible": false
43295
43569
  },
43296
43570
  {
43297
43571
  "name": "start",
43298
43572
  "kind": "flag",
43299
43573
  "type": "number",
43300
- "description": "Start offset within the block (character index)."
43574
+ "description": "Start offset within the block (character index).",
43575
+ "agentVisible": false
43301
43576
  },
43302
43577
  {
43303
43578
  "name": "end",
43304
43579
  "kind": "flag",
43305
43580
  "type": "number",
43306
- "description": "End offset within the block (character index)."
43581
+ "description": "End offset within the block (character index).",
43582
+ "agentVisible": false
43307
43583
  }
43308
43584
  ],
43309
43585
  "constraints": null,
@@ -43700,19 +43976,22 @@ export const CONTRACT = {
43700
43976
  "kind": "flag",
43701
43977
  "type": "string",
43702
43978
  "flag": "block-id",
43703
- "description": "Block ID of the target paragraph."
43979
+ "description": "Block ID of the target paragraph.",
43980
+ "agentVisible": false
43704
43981
  },
43705
43982
  {
43706
43983
  "name": "start",
43707
43984
  "kind": "flag",
43708
43985
  "type": "number",
43709
- "description": "Start offset within the block (character index)."
43986
+ "description": "Start offset within the block (character index).",
43987
+ "agentVisible": false
43710
43988
  },
43711
43989
  {
43712
43990
  "name": "end",
43713
43991
  "kind": "flag",
43714
43992
  "type": "number",
43715
- "description": "End offset within the block (character index)."
43993
+ "description": "End offset within the block (character index).",
43994
+ "agentVisible": false
43716
43995
  }
43717
43996
  ],
43718
43997
  "constraints": null,
@@ -44136,19 +44415,22 @@ export const CONTRACT = {
44136
44415
  "kind": "flag",
44137
44416
  "type": "string",
44138
44417
  "flag": "block-id",
44139
- "description": "Block ID of the target paragraph."
44418
+ "description": "Block ID of the target paragraph.",
44419
+ "agentVisible": false
44140
44420
  },
44141
44421
  {
44142
44422
  "name": "start",
44143
44423
  "kind": "flag",
44144
44424
  "type": "number",
44145
- "description": "Start offset within the block (character index)."
44425
+ "description": "Start offset within the block (character index).",
44426
+ "agentVisible": false
44146
44427
  },
44147
44428
  {
44148
44429
  "name": "end",
44149
44430
  "kind": "flag",
44150
44431
  "type": "number",
44151
- "description": "End offset within the block (character index)."
44432
+ "description": "End offset within the block (character index).",
44433
+ "agentVisible": false
44152
44434
  }
44153
44435
  ],
44154
44436
  "constraints": null,
@@ -44558,19 +44840,22 @@ export const CONTRACT = {
44558
44840
  "kind": "flag",
44559
44841
  "type": "string",
44560
44842
  "flag": "block-id",
44561
- "description": "Block ID of the target paragraph."
44843
+ "description": "Block ID of the target paragraph.",
44844
+ "agentVisible": false
44562
44845
  },
44563
44846
  {
44564
44847
  "name": "start",
44565
44848
  "kind": "flag",
44566
44849
  "type": "number",
44567
- "description": "Start offset within the block (character index)."
44850
+ "description": "Start offset within the block (character index).",
44851
+ "agentVisible": false
44568
44852
  },
44569
44853
  {
44570
44854
  "name": "end",
44571
44855
  "kind": "flag",
44572
44856
  "type": "number",
44573
- "description": "End offset within the block (character index)."
44857
+ "description": "End offset within the block (character index).",
44858
+ "agentVisible": false
44574
44859
  }
44575
44860
  ],
44576
44861
  "constraints": null,
@@ -45034,19 +45319,22 @@ export const CONTRACT = {
45034
45319
  "kind": "flag",
45035
45320
  "type": "string",
45036
45321
  "flag": "block-id",
45037
- "description": "Block ID of the target paragraph."
45322
+ "description": "Block ID of the target paragraph.",
45323
+ "agentVisible": false
45038
45324
  },
45039
45325
  {
45040
45326
  "name": "start",
45041
45327
  "kind": "flag",
45042
45328
  "type": "number",
45043
- "description": "Start offset within the block (character index)."
45329
+ "description": "Start offset within the block (character index).",
45330
+ "agentVisible": false
45044
45331
  },
45045
45332
  {
45046
45333
  "name": "end",
45047
45334
  "kind": "flag",
45048
45335
  "type": "number",
45049
- "description": "End offset within the block (character index)."
45336
+ "description": "End offset within the block (character index).",
45337
+ "agentVisible": false
45050
45338
  }
45051
45339
  ],
45052
45340
  "constraints": null,
@@ -45455,19 +45743,22 @@ export const CONTRACT = {
45455
45743
  "kind": "flag",
45456
45744
  "type": "string",
45457
45745
  "flag": "block-id",
45458
- "description": "Block ID of the target paragraph."
45746
+ "description": "Block ID of the target paragraph.",
45747
+ "agentVisible": false
45459
45748
  },
45460
45749
  {
45461
45750
  "name": "start",
45462
45751
  "kind": "flag",
45463
45752
  "type": "number",
45464
- "description": "Start offset within the block (character index)."
45753
+ "description": "Start offset within the block (character index).",
45754
+ "agentVisible": false
45465
45755
  },
45466
45756
  {
45467
45757
  "name": "end",
45468
45758
  "kind": "flag",
45469
45759
  "type": "number",
45470
- "description": "End offset within the block (character index)."
45760
+ "description": "End offset within the block (character index).",
45761
+ "agentVisible": false
45471
45762
  }
45472
45763
  ],
45473
45764
  "constraints": null,
@@ -45851,19 +46142,22 @@ export const CONTRACT = {
45851
46142
  "kind": "flag",
45852
46143
  "type": "string",
45853
46144
  "flag": "block-id",
45854
- "description": "Block ID of the target paragraph."
46145
+ "description": "Block ID of the target paragraph.",
46146
+ "agentVisible": false
45855
46147
  },
45856
46148
  {
45857
46149
  "name": "start",
45858
46150
  "kind": "flag",
45859
46151
  "type": "number",
45860
- "description": "Start offset within the block (character index)."
46152
+ "description": "Start offset within the block (character index).",
46153
+ "agentVisible": false
45861
46154
  },
45862
46155
  {
45863
46156
  "name": "end",
45864
46157
  "kind": "flag",
45865
46158
  "type": "number",
45866
- "description": "End offset within the block (character index)."
46159
+ "description": "End offset within the block (character index).",
46160
+ "agentVisible": false
45867
46161
  }
45868
46162
  ],
45869
46163
  "constraints": null,
@@ -46289,19 +46583,22 @@ export const CONTRACT = {
46289
46583
  "kind": "flag",
46290
46584
  "type": "string",
46291
46585
  "flag": "block-id",
46292
- "description": "Block ID of the target paragraph."
46586
+ "description": "Block ID of the target paragraph.",
46587
+ "agentVisible": false
46293
46588
  },
46294
46589
  {
46295
46590
  "name": "start",
46296
46591
  "kind": "flag",
46297
46592
  "type": "number",
46298
- "description": "Start offset within the block (character index)."
46593
+ "description": "Start offset within the block (character index).",
46594
+ "agentVisible": false
46299
46595
  },
46300
46596
  {
46301
46597
  "name": "end",
46302
46598
  "kind": "flag",
46303
46599
  "type": "number",
46304
- "description": "End offset within the block (character index)."
46600
+ "description": "End offset within the block (character index).",
46601
+ "agentVisible": false
46305
46602
  }
46306
46603
  ],
46307
46604
  "constraints": null,
@@ -46738,19 +47035,22 @@ export const CONTRACT = {
46738
47035
  "kind": "flag",
46739
47036
  "type": "string",
46740
47037
  "flag": "block-id",
46741
- "description": "Block ID of the target paragraph."
47038
+ "description": "Block ID of the target paragraph.",
47039
+ "agentVisible": false
46742
47040
  },
46743
47041
  {
46744
47042
  "name": "start",
46745
47043
  "kind": "flag",
46746
47044
  "type": "number",
46747
- "description": "Start offset within the block (character index)."
47045
+ "description": "Start offset within the block (character index).",
47046
+ "agentVisible": false
46748
47047
  },
46749
47048
  {
46750
47049
  "name": "end",
46751
47050
  "kind": "flag",
46752
47051
  "type": "number",
46753
- "description": "End offset within the block (character index)."
47052
+ "description": "End offset within the block (character index).",
47053
+ "agentVisible": false
46754
47054
  }
46755
47055
  ],
46756
47056
  "constraints": null,
@@ -47156,19 +47456,22 @@ export const CONTRACT = {
47156
47456
  "kind": "flag",
47157
47457
  "type": "string",
47158
47458
  "flag": "block-id",
47159
- "description": "Block ID of the target paragraph."
47459
+ "description": "Block ID of the target paragraph.",
47460
+ "agentVisible": false
47160
47461
  },
47161
47462
  {
47162
47463
  "name": "start",
47163
47464
  "kind": "flag",
47164
47465
  "type": "number",
47165
- "description": "Start offset within the block (character index)."
47466
+ "description": "Start offset within the block (character index).",
47467
+ "agentVisible": false
47166
47468
  },
47167
47469
  {
47168
47470
  "name": "end",
47169
47471
  "kind": "flag",
47170
47472
  "type": "number",
47171
- "description": "End offset within the block (character index)."
47473
+ "description": "End offset within the block (character index).",
47474
+ "agentVisible": false
47172
47475
  }
47173
47476
  ],
47174
47477
  "constraints": null,
@@ -47579,19 +47882,22 @@ export const CONTRACT = {
47579
47882
  "kind": "flag",
47580
47883
  "type": "string",
47581
47884
  "flag": "block-id",
47582
- "description": "Block ID of the target paragraph."
47885
+ "description": "Block ID of the target paragraph.",
47886
+ "agentVisible": false
47583
47887
  },
47584
47888
  {
47585
47889
  "name": "start",
47586
47890
  "kind": "flag",
47587
47891
  "type": "number",
47588
- "description": "Start offset within the block (character index)."
47892
+ "description": "Start offset within the block (character index).",
47893
+ "agentVisible": false
47589
47894
  },
47590
47895
  {
47591
47896
  "name": "end",
47592
47897
  "kind": "flag",
47593
47898
  "type": "number",
47594
- "description": "End offset within the block (character index)."
47899
+ "description": "End offset within the block (character index).",
47900
+ "agentVisible": false
47595
47901
  }
47596
47902
  ],
47597
47903
  "constraints": null,
@@ -48001,19 +48307,22 @@ export const CONTRACT = {
48001
48307
  "kind": "flag",
48002
48308
  "type": "string",
48003
48309
  "flag": "block-id",
48004
- "description": "Block ID of the target paragraph."
48310
+ "description": "Block ID of the target paragraph.",
48311
+ "agentVisible": false
48005
48312
  },
48006
48313
  {
48007
48314
  "name": "start",
48008
48315
  "kind": "flag",
48009
48316
  "type": "number",
48010
- "description": "Start offset within the block (character index)."
48317
+ "description": "Start offset within the block (character index).",
48318
+ "agentVisible": false
48011
48319
  },
48012
48320
  {
48013
48321
  "name": "end",
48014
48322
  "kind": "flag",
48015
48323
  "type": "number",
48016
- "description": "End offset within the block (character index)."
48324
+ "description": "End offset within the block (character index).",
48325
+ "agentVisible": false
48017
48326
  }
48018
48327
  ],
48019
48328
  "constraints": null,
@@ -48409,19 +48718,22 @@ export const CONTRACT = {
48409
48718
  "kind": "flag",
48410
48719
  "type": "string",
48411
48720
  "flag": "block-id",
48412
- "description": "Block ID of the target paragraph."
48721
+ "description": "Block ID of the target paragraph.",
48722
+ "agentVisible": false
48413
48723
  },
48414
48724
  {
48415
48725
  "name": "start",
48416
48726
  "kind": "flag",
48417
48727
  "type": "number",
48418
- "description": "Start offset within the block (character index)."
48728
+ "description": "Start offset within the block (character index).",
48729
+ "agentVisible": false
48419
48730
  },
48420
48731
  {
48421
48732
  "name": "end",
48422
48733
  "kind": "flag",
48423
48734
  "type": "number",
48424
- "description": "End offset within the block (character index)."
48735
+ "description": "End offset within the block (character index).",
48736
+ "agentVisible": false
48425
48737
  }
48426
48738
  ],
48427
48739
  "constraints": null,
@@ -49387,9 +49699,9 @@ export const CONTRACT = {
49387
49699
  "const": "fromParagraphs"
49388
49700
  }
49389
49701
  ],
49390
- "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."
49702
+ "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
49391
49703
  },
49392
- "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."
49704
+ "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'."
49393
49705
  },
49394
49706
  {
49395
49707
  "name": "at",
@@ -49492,7 +49804,7 @@ export const CONTRACT = {
49492
49804
  }
49493
49805
  ]
49494
49806
  },
49495
- "description": "Required when mode is 'fromParagraphs'. The paragraph(s) to convert into list items. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
49807
+ "description": "Required when mode is 'fromParagraphs'. Each call converts ONE paragraph into a list item. To make a list with N items, create N separate paragraphs first, then call superdoc_list create for EACH one. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
49496
49808
  },
49497
49809
  {
49498
49810
  "name": "kind",
@@ -49775,7 +50087,7 @@ export const CONTRACT = {
49775
50087
  "type": "integer"
49776
50088
  },
49777
50089
  "mode": {
49778
- "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.",
50090
+ "description": "Required. 'fromParagraphs' converts existing paragraphs into list items — each paragraph becomes one item, so create one paragraph per item first. 'empty' creates a new empty list at 'at'.",
49779
50091
  "enum": [
49780
50092
  "empty",
49781
50093
  "fromParagraphs"
@@ -49910,7 +50222,7 @@ export const CONTRACT = {
49910
50222
  },
49911
50223
  "target": {
49912
50224
  "$ref": "#/$defs/BlockAddressOrRange",
49913
- "description": "Required when mode is 'fromParagraphs'. The paragraph(s) to convert into list items. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
50225
+ "description": "Required when mode is 'fromParagraphs'. Each call converts ONE paragraph into a list item. To make a list with N items, create N separate paragraphs first, then call superdoc_list create for EACH one. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
49914
50226
  }
49915
50227
  },
49916
50228
  "required": [
@@ -58408,19 +58720,22 @@ export const CONTRACT = {
58408
58720
  "kind": "flag",
58409
58721
  "type": "string",
58410
58722
  "flag": "block-id",
58411
- "description": "Block ID of the target paragraph."
58723
+ "description": "Block ID of the target paragraph.",
58724
+ "agentVisible": false
58412
58725
  },
58413
58726
  {
58414
58727
  "name": "start",
58415
58728
  "kind": "flag",
58416
58729
  "type": "number",
58417
- "description": "Start offset within the block (character index)."
58730
+ "description": "Start offset within the block (character index).",
58731
+ "agentVisible": false
58418
58732
  },
58419
58733
  {
58420
58734
  "name": "end",
58421
58735
  "kind": "flag",
58422
58736
  "type": "number",
58423
- "description": "End offset within the block (character index)."
58737
+ "description": "End offset within the block (character index).",
58738
+ "agentVisible": false
58424
58739
  }
58425
58740
  ],
58426
58741
  "constraints": null,
@@ -58660,19 +58975,22 @@ export const CONTRACT = {
58660
58975
  "kind": "flag",
58661
58976
  "type": "string",
58662
58977
  "flag": "block-id",
58663
- "description": "Block ID of the target paragraph."
58978
+ "description": "Block ID of the target paragraph.",
58979
+ "agentVisible": false
58664
58980
  },
58665
58981
  {
58666
58982
  "name": "start",
58667
58983
  "kind": "flag",
58668
58984
  "type": "number",
58669
- "description": "Start offset within the block (character index)."
58985
+ "description": "Start offset within the block (character index).",
58986
+ "agentVisible": false
58670
58987
  },
58671
58988
  {
58672
58989
  "name": "end",
58673
58990
  "kind": "flag",
58674
58991
  "type": "number",
58675
- "description": "End offset within the block (character index)."
58992
+ "description": "End offset within the block (character index).",
58993
+ "agentVisible": false
58676
58994
  }
58677
58995
  ],
58678
58996
  "constraints": null,
@@ -59872,8 +60190,11 @@ export const CONTRACT = {
59872
60190
  "noteId"
59873
60191
  ]
59874
60192
  }
59875
- ]
59876
- }
60193
+ ],
60194
+ "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."
60195
+ },
60196
+ "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.",
60197
+ "agentVisible": false
59877
60198
  },
59878
60199
  {
59879
60200
  "name": "select",
@@ -61150,8 +61471,11 @@ export const CONTRACT = {
61150
61471
  "noteId"
61151
61472
  ]
61152
61473
  }
61153
- ]
61154
- }
61474
+ ],
61475
+ "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."
61476
+ },
61477
+ "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.",
61478
+ "agentVisible": false
61155
61479
  },
61156
61480
  {
61157
61481
  "name": "expectedRevision",
@@ -66249,8 +66573,11 @@ export const CONTRACT = {
66249
66573
  "noteId"
66250
66574
  ]
66251
66575
  }
66252
- ]
66253
- }
66576
+ ],
66577
+ "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."
66578
+ },
66579
+ "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.",
66580
+ "agentVisible": false
66254
66581
  },
66255
66582
  {
66256
66583
  "name": "atomic",
@@ -103899,8 +104226,11 @@ export const CONTRACT = {
103899
104226
  "noteId"
103900
104227
  ]
103901
104228
  }
103902
- ]
103903
- }
104229
+ ],
104230
+ "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."
104231
+ },
104232
+ "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.",
104233
+ "agentVisible": false
103904
104234
  },
103905
104235
  {
103906
104236
  "name": "src",