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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/dist/generated/client.d.ts +21 -4
  2. package/dist/generated/client.d.ts.map +1 -1
  3. package/dist/generated/contract.cjs +576 -246
  4. package/dist/generated/contract.d.ts.map +1 -1
  5. package/dist/generated/contract.js +576 -246
  6. package/dist/generated/intent-dispatch.generated.cjs +1 -0
  7. package/dist/generated/intent-dispatch.generated.d.ts.map +1 -1
  8. package/dist/generated/intent-dispatch.generated.js +1 -0
  9. package/dist/tools.cjs +10 -1
  10. package/dist/tools.d.ts.map +1 -1
  11. package/dist/tools.js +10 -1
  12. package/package.json +6 -6
  13. package/tools/__pycache__/__init__.cpython-313.pyc +0 -0
  14. package/tools/__pycache__/intent_dispatch_generated.cpython-313.pyc +0 -0
  15. package/tools/catalog.json +121 -988
  16. package/tools/system-prompt.md +47 -11
  17. package/tools/tools-policy.json +1 -1
  18. package/tools/tools.anthropic.json +116 -987
  19. package/tools/tools.generic.json +120 -990
  20. package/tools/tools.openai.json +116 -987
  21. package/tools/tools.vercel.json +116 -987
  22. package/tools/__pycache__/__init__.cpython-312.pyc +0 -0
  23. package/tools/__pycache__/intent_dispatch_generated.cpython-312.pyc +0 -0
package/dist/generated/contract.cjs CHANGED
@@ -276,8 +276,11 @@ const CONTRACT = {
276
276
  "noteId"
277
277
  ]
278
278
  }
279
- ]
280
- }
279
+ ],
280
+ "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."
281
+ },
282
+ "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.",
283
+ "agentVisible": false
281
284
  },
282
285
  {
283
286
  "name": "within",
@@ -400,13 +403,6 @@ const CONTRACT = {
400
403
  "flag": "case-sensitive",
401
404
  "description": "Case-sensitive matching. Default: false."
402
405
  },
403
- {
404
- "name": "select",
405
- "kind": "jsonFlag",
406
- "type": "json",
407
- "flag": "select-json",
408
- "description": "Search selector as JSON: {type:'text', pattern:'...'} or {type:'node', nodeType:'...'}."
409
- },
410
406
  {
411
407
  "name": "query",
412
408
  "kind": "jsonFlag",
@@ -1086,8 +1082,11 @@ const CONTRACT = {
1086
1082
  "noteId"
1087
1083
  ]
1088
1084
  }
1089
- ]
1090
- }
1085
+ ],
1086
+ "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."
1087
+ },
1088
+ "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.",
1089
+ "agentVisible": false
1091
1090
  }
1092
1091
  ],
1093
1092
  "constraints": null,
@@ -1293,8 +1292,11 @@ const CONTRACT = {
1293
1292
  "noteId"
1294
1293
  ]
1295
1294
  }
1296
- ]
1297
- }
1295
+ ],
1296
+ "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."
1297
+ },
1298
+ "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.",
1299
+ "agentVisible": false
1298
1300
  }
1299
1301
  ],
1300
1302
  "constraints": null,
@@ -1500,8 +1502,11 @@ const CONTRACT = {
1500
1502
  "noteId"
1501
1503
  ]
1502
1504
  }
1503
- ]
1504
- }
1505
+ ],
1506
+ "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."
1507
+ },
1508
+ "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.",
1509
+ "agentVisible": false
1505
1510
  },
1506
1511
  {
1507
1512
  "name": "unflattenLists",
@@ -1748,6 +1753,25 @@ const CONTRACT = {
1748
1753
  ],
1749
1754
  "type": "object"
1750
1755
  },
1756
+ "defaults": {
1757
+ "additionalProperties": false,
1758
+ "description": "Document's default body text formatting. Use these values when creating new content to match existing style.",
1759
+ "properties": {
1760
+ "fontFamily": {
1761
+ "description": "Most common body text font family.",
1762
+ "type": "string"
1763
+ },
1764
+ "fontSize": {
1765
+ "description": "Most common body text font size in half-points.",
1766
+ "type": "number"
1767
+ },
1768
+ "styleId": {
1769
+ "description": "Most common body paragraph style ID.",
1770
+ "type": "string"
1771
+ }
1772
+ },
1773
+ "type": "object"
1774
+ },
1751
1775
  "outline": {
1752
1776
  "items": {
1753
1777
  "additionalProperties": false,
@@ -1773,6 +1797,46 @@ const CONTRACT = {
1773
1797
  },
1774
1798
  "revision": {
1775
1799
  "type": "string"
1800
+ },
1801
+ "styles": {
1802
+ "additionalProperties": false,
1803
+ "description": "Styles currently in use in the document.",
1804
+ "properties": {
1805
+ "paragraphStyles": {
1806
+ "description": "Paragraph styles in use, sorted by frequency (most common first).",
1807
+ "items": {
1808
+ "additionalProperties": false,
1809
+ "properties": {
1810
+ "count": {
1811
+ "description": "Number of paragraphs using this style.",
1812
+ "type": "integer"
1813
+ },
1814
+ "fontFamily": {
1815
+ "description": "Font family used by text in this style.",
1816
+ "type": "string"
1817
+ },
1818
+ "fontSize": {
1819
+ "description": "Font size in half-points used by text in this style.",
1820
+ "type": "number"
1821
+ },
1822
+ "styleId": {
1823
+ "description": "Style identifier (e.g. 'Normal', 'Heading1', 'BodyText').",
1824
+ "type": "string"
1825
+ }
1826
+ },
1827
+ "required": [
1828
+ "styleId",
1829
+ "count"
1830
+ ],
1831
+ "type": "object"
1832
+ },
1833
+ "type": "array"
1834
+ }
1835
+ },
1836
+ "required": [
1837
+ "paragraphStyles"
1838
+ ],
1839
+ "type": "object"
1776
1840
  }
1777
1841
  },
1778
1842
  "required": [
@@ -2391,8 +2455,11 @@ const CONTRACT = {
2391
2455
  "noteId"
2392
2456
  ]
2393
2457
  }
2394
- ]
2395
- }
2458
+ ],
2459
+ "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."
2460
+ },
2461
+ "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.",
2462
+ "agentVisible": false
2396
2463
  },
2397
2464
  {
2398
2465
  "name": "value",
@@ -3605,8 +3672,11 @@ const CONTRACT = {
3605
3672
  "noteId"
3606
3673
  ]
3607
3674
  }
3608
- ]
3609
- }
3675
+ ],
3676
+ "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."
3677
+ },
3678
+ "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.",
3679
+ "agentVisible": false
3610
3680
  },
3611
3681
  {
3612
3682
  "name": "text",
@@ -4549,8 +4619,11 @@ const CONTRACT = {
4549
4619
  "noteId"
4550
4620
  ]
4551
4621
  }
4552
- ]
4553
- }
4622
+ ],
4623
+ "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."
4624
+ },
4625
+ "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.",
4626
+ "agentVisible": false
4554
4627
  },
4555
4628
  {
4556
4629
  "name": "behavior",
@@ -4757,12 +4830,14 @@ const CONTRACT = {
4757
4830
  {
4758
4831
  "name": "offset",
4759
4832
  "kind": "flag",
4760
- "type": "number"
4833
+ "type": "number",
4834
+ "description": "Number of blocks to skip. Default: 0."
4761
4835
  },
4762
4836
  {
4763
4837
  "name": "limit",
4764
4838
  "kind": "flag",
4765
- "type": "number"
4839
+ "type": "number",
4840
+ "description": "Maximum blocks to return. Omit for all blocks."
4766
4841
  },
4767
4842
  {
4768
4843
  "name": "nodeTypes",
@@ -4801,8 +4876,10 @@ const CONTRACT = {
4801
4876
  "const": "sdt"
4802
4877
  }
4803
4878
  ]
4804
- }
4805
- }
4879
+ },
4880
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
4881
+ },
4882
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types."
4806
4883
  }
4807
4884
  ],
4808
4885
  "constraints": null,
@@ -4814,10 +4891,12 @@ const CONTRACT = {
4814
4891
  "additionalProperties": false,
4815
4892
  "properties": {
4816
4893
  "limit": {
4894
+ "description": "Maximum blocks to return. Omit for all blocks.",
4817
4895
  "minimum": 1,
4818
4896
  "type": "number"
4819
4897
  },
4820
4898
  "nodeTypes": {
4899
+ "description": "Filter by block types (e.g. ['paragraph', 'heading']). Omit for all types.",
4821
4900
  "items": {
4822
4901
  "enum": [
4823
4902
  "paragraph",
@@ -4834,6 +4913,7 @@ const CONTRACT = {
4834
4913
  "type": "array"
4835
4914
  },
4836
4915
  "offset": {
4916
+ "description": "Number of blocks to skip. Default: 0.",
4837
4917
  "minimum": 0,
4838
4918
  "type": "number"
4839
4919
  }
@@ -4847,10 +4927,31 @@ const CONTRACT = {
4847
4927
  "items": {
4848
4928
  "additionalProperties": false,
4849
4929
  "properties": {
4930
+ "alignment": {
4931
+ "description": "Paragraph alignment.",
4932
+ "type": "string"
4933
+ },
4934
+ "bold": {
4935
+ "description": "True if text is bold.",
4936
+ "type": "boolean"
4937
+ },
4938
+ "fontFamily": {
4939
+ "description": "Font family from first text run.",
4940
+ "type": "string"
4941
+ },
4942
+ "fontSize": {
4943
+ "description": "Font size from first text run.",
4944
+ "type": "number"
4945
+ },
4946
+ "headingLevel": {
4947
+ "description": "Heading level (1-6).",
4948
+ "type": "number"
4949
+ },
4850
4950
  "isEmpty": {
4851
4951
  "type": "boolean"
4852
4952
  },
4853
4953
  "nodeId": {
4954
+ "description": "Block ID for targeting with other tools.",
4854
4955
  "type": "string"
4855
4956
  },
4856
4957
  "nodeType": {
@@ -4869,6 +4970,17 @@ const CONTRACT = {
4869
4970
  "ordinal": {
4870
4971
  "type": "number"
4871
4972
  },
4973
+ "styleId": {
4974
+ "description": "Named paragraph style.",
4975
+ "oneOf": [
4976
+ {
4977
+ "type": "string"
4978
+ },
4979
+ {
4980
+ "type": "null"
4981
+ }
4982
+ ]
4983
+ },
4872
4984
  "textPreview": {
4873
4985
  "oneOf": [
4874
4986
  {
@@ -4883,9 +4995,7 @@ const CONTRACT = {
4883
4995
  "required": [
4884
4996
  "ordinal",
4885
4997
  "nodeId",
4886
- "nodeType",
4887
- "textPreview",
4888
- "isEmpty"
4998
+ "nodeType"
4889
4999
  ],
4890
5000
  "type": "object"
4891
5001
  },
@@ -4904,7 +5014,9 @@ const CONTRACT = {
4904
5014
  "revision"
4905
5015
  ],
4906
5016
  "type": "object"
4907
- }
5017
+ },
5018
+ "intentGroup": "get_content",
5019
+ "intentAction": "blocks"
4908
5020
  },
4909
5021
  "doc.blocks.delete": {
4910
5022
  "operationId": "doc.blocks.delete",
@@ -5921,8 +6033,11 @@ const CONTRACT = {
5921
6033
  "noteId"
5922
6034
  ]
5923
6035
  }
5924
- ]
5925
- }
6036
+ ],
6037
+ "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."
6038
+ },
6039
+ "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.",
6040
+ "agentVisible": false
5926
6041
  },
5927
6042
  {
5928
6043
  "name": "inline",
@@ -6709,19 +6824,22 @@ const CONTRACT = {
6709
6824
  "kind": "flag",
6710
6825
  "type": "string",
6711
6826
  "flag": "block-id",
6712
- "description": "Block ID of the target paragraph."
6827
+ "description": "Block ID of the target paragraph.",
6828
+ "agentVisible": false
6713
6829
  },
6714
6830
  {
6715
6831
  "name": "start",
6716
6832
  "kind": "flag",
6717
6833
  "type": "number",
6718
- "description": "Start offset within the block (character index)."
6834
+ "description": "Start offset within the block (character index).",
6835
+ "agentVisible": false
6719
6836
  },
6720
6837
  {
6721
6838
  "name": "end",
6722
6839
  "kind": "flag",
6723
6840
  "type": "number",
6724
- "description": "End offset within the block (character index)."
6841
+ "description": "End offset within the block (character index).",
6842
+ "agentVisible": false
6725
6843
  }
6726
6844
  ],
6727
6845
  "constraints": null,
@@ -8754,19 +8872,22 @@ const CONTRACT = {
8754
8872
  "kind": "flag",
8755
8873
  "type": "string",
8756
8874
  "flag": "block-id",
8757
- "description": "Block ID of the target paragraph."
8875
+ "description": "Block ID of the target paragraph.",
8876
+ "agentVisible": false
8758
8877
  },
8759
8878
  {
8760
8879
  "name": "start",
8761
8880
  "kind": "flag",
8762
8881
  "type": "number",
8763
- "description": "Start offset within the block (character index)."
8882
+ "description": "Start offset within the block (character index).",
8883
+ "agentVisible": false
8764
8884
  },
8765
8885
  {
8766
8886
  "name": "end",
8767
8887
  "kind": "flag",
8768
8888
  "type": "number",
8769
- "description": "End offset within the block (character index)."
8889
+ "description": "End offset within the block (character index).",
8890
+ "agentVisible": false
8770
8891
  }
8771
8892
  ],
8772
8893
  "constraints": null,
@@ -9190,19 +9311,22 @@ const CONTRACT = {
9190
9311
  "kind": "flag",
9191
9312
  "type": "string",
9192
9313
  "flag": "block-id",
9193
- "description": "Block ID of the target paragraph."
9314
+ "description": "Block ID of the target paragraph.",
9315
+ "agentVisible": false
9194
9316
  },
9195
9317
  {
9196
9318
  "name": "start",
9197
9319
  "kind": "flag",
9198
9320
  "type": "number",
9199
- "description": "Start offset within the block (character index)."
9321
+ "description": "Start offset within the block (character index).",
9322
+ "agentVisible": false
9200
9323
  },
9201
9324
  {
9202
9325
  "name": "end",
9203
9326
  "kind": "flag",
9204
9327
  "type": "number",
9205
- "description": "End offset within the block (character index)."
9328
+ "description": "End offset within the block (character index).",
9329
+ "agentVisible": false
9206
9330
  }
9207
9331
  ],
9208
9332
  "constraints": null,
@@ -9626,19 +9750,22 @@ const CONTRACT = {
9626
9750
  "kind": "flag",
9627
9751
  "type": "string",
9628
9752
  "flag": "block-id",
9629
- "description": "Block ID of the target paragraph."
9753
+ "description": "Block ID of the target paragraph.",
9754
+ "agentVisible": false
9630
9755
  },
9631
9756
  {
9632
9757
  "name": "start",
9633
9758
  "kind": "flag",
9634
9759
  "type": "number",
9635
- "description": "Start offset within the block (character index)."
9760
+ "description": "Start offset within the block (character index).",
9761
+ "agentVisible": false
9636
9762
  },
9637
9763
  {
9638
9764
  "name": "end",
9639
9765
  "kind": "flag",
9640
9766
  "type": "number",
9641
- "description": "End offset within the block (character index)."
9767
+ "description": "End offset within the block (character index).",
9768
+ "agentVisible": false
9642
9769
  }
9643
9770
  ],
9644
9771
  "constraints": null,
@@ -10097,19 +10224,22 @@ const CONTRACT = {
10097
10224
  "kind": "flag",
10098
10225
  "type": "string",
10099
10226
  "flag": "block-id",
10100
- "description": "Block ID of the target paragraph."
10227
+ "description": "Block ID of the target paragraph.",
10228
+ "agentVisible": false
10101
10229
  },
10102
10230
  {
10103
10231
  "name": "start",
10104
10232
  "kind": "flag",
10105
10233
  "type": "number",
10106
- "description": "Start offset within the block (character index)."
10234
+ "description": "Start offset within the block (character index).",
10235
+ "agentVisible": false
10107
10236
  },
10108
10237
  {
10109
10238
  "name": "end",
10110
10239
  "kind": "flag",
10111
10240
  "type": "number",
10112
- "description": "End offset within the block (character index)."
10241
+ "description": "End offset within the block (character index).",
10242
+ "agentVisible": false
10113
10243
  }
10114
10244
  ],
10115
10245
  "constraints": null,
@@ -10613,19 +10743,22 @@ const CONTRACT = {
10613
10743
  "kind": "flag",
10614
10744
  "type": "string",
10615
10745
  "flag": "block-id",
10616
- "description": "Block ID of the target paragraph."
10746
+ "description": "Block ID of the target paragraph.",
10747
+ "agentVisible": false
10617
10748
  },
10618
10749
  {
10619
10750
  "name": "start",
10620
10751
  "kind": "flag",
10621
10752
  "type": "number",
10622
- "description": "Start offset within the block (character index)."
10753
+ "description": "Start offset within the block (character index).",
10754
+ "agentVisible": false
10623
10755
  },
10624
10756
  {
10625
10757
  "name": "end",
10626
10758
  "kind": "flag",
10627
10759
  "type": "number",
10628
- "description": "End offset within the block (character index)."
10760
+ "description": "End offset within the block (character index).",
10761
+ "agentVisible": false
10629
10762
  }
10630
10763
  ],
10631
10764
  "constraints": null,
@@ -11053,19 +11186,22 @@ const CONTRACT = {
11053
11186
  "kind": "flag",
11054
11187
  "type": "string",
11055
11188
  "flag": "block-id",
11056
- "description": "Block ID of the target paragraph."
11189
+ "description": "Block ID of the target paragraph.",
11190
+ "agentVisible": false
11057
11191
  },
11058
11192
  {
11059
11193
  "name": "start",
11060
11194
  "kind": "flag",
11061
11195
  "type": "number",
11062
- "description": "Start offset within the block (character index)."
11196
+ "description": "Start offset within the block (character index).",
11197
+ "agentVisible": false
11063
11198
  },
11064
11199
  {
11065
11200
  "name": "end",
11066
11201
  "kind": "flag",
11067
11202
  "type": "number",
11068
- "description": "End offset within the block (character index)."
11203
+ "description": "End offset within the block (character index).",
11204
+ "agentVisible": false
11069
11205
  }
11070
11206
  ],
11071
11207
  "constraints": null,
@@ -11493,19 +11629,22 @@ const CONTRACT = {
11493
11629
  "kind": "flag",
11494
11630
  "type": "string",
11495
11631
  "flag": "block-id",
11496
- "description": "Block ID of the target paragraph."
11632
+ "description": "Block ID of the target paragraph.",
11633
+ "agentVisible": false
11497
11634
  },
11498
11635
  {
11499
11636
  "name": "start",
11500
11637
  "kind": "flag",
11501
11638
  "type": "number",
11502
- "description": "Start offset within the block (character index)."
11639
+ "description": "Start offset within the block (character index).",
11640
+ "agentVisible": false
11503
11641
  },
11504
11642
  {
11505
11643
  "name": "end",
11506
11644
  "kind": "flag",
11507
11645
  "type": "number",
11508
- "description": "End offset within the block (character index)."
11646
+ "description": "End offset within the block (character index).",
11647
+ "agentVisible": false
11509
11648
  }
11510
11649
  ],
11511
11650
  "constraints": null,
@@ -11931,19 +12070,22 @@ const CONTRACT = {
11931
12070
  "kind": "flag",
11932
12071
  "type": "string",
11933
12072
  "flag": "block-id",
11934
- "description": "Block ID of the target paragraph."
12073
+ "description": "Block ID of the target paragraph.",
12074
+ "agentVisible": false
11935
12075
  },
11936
12076
  {
11937
12077
  "name": "start",
11938
12078
  "kind": "flag",
11939
12079
  "type": "number",
11940
- "description": "Start offset within the block (character index)."
12080
+ "description": "Start offset within the block (character index).",
12081
+ "agentVisible": false
11941
12082
  },
11942
12083
  {
11943
12084
  "name": "end",
11944
12085
  "kind": "flag",
11945
12086
  "type": "number",
11946
- "description": "End offset within the block (character index)."
12087
+ "description": "End offset within the block (character index).",
12088
+ "agentVisible": false
11947
12089
  }
11948
12090
  ],
11949
12091
  "constraints": null,
@@ -12371,19 +12513,22 @@ const CONTRACT = {
12371
12513
  "kind": "flag",
12372
12514
  "type": "string",
12373
12515
  "flag": "block-id",
12374
- "description": "Block ID of the target paragraph."
12516
+ "description": "Block ID of the target paragraph.",
12517
+ "agentVisible": false
12375
12518
  },
12376
12519
  {
12377
12520
  "name": "start",
12378
12521
  "kind": "flag",
12379
12522
  "type": "number",
12380
- "description": "Start offset within the block (character index)."
12523
+ "description": "Start offset within the block (character index).",
12524
+ "agentVisible": false
12381
12525
  },
12382
12526
  {
12383
12527
  "name": "end",
12384
12528
  "kind": "flag",
12385
12529
  "type": "number",
12386
- "description": "End offset within the block (character index)."
12530
+ "description": "End offset within the block (character index).",
12531
+ "agentVisible": false
12387
12532
  }
12388
12533
  ],
12389
12534
  "constraints": null,
@@ -12819,19 +12964,22 @@ const CONTRACT = {
12819
12964
  "kind": "flag",
12820
12965
  "type": "string",
12821
12966
  "flag": "block-id",
12822
- "description": "Block ID of the target paragraph."
12967
+ "description": "Block ID of the target paragraph.",
12968
+ "agentVisible": false
12823
12969
  },
12824
12970
  {
12825
12971
  "name": "start",
12826
12972
  "kind": "flag",
12827
12973
  "type": "number",
12828
- "description": "Start offset within the block (character index)."
12974
+ "description": "Start offset within the block (character index).",
12975
+ "agentVisible": false
12829
12976
  },
12830
12977
  {
12831
12978
  "name": "end",
12832
12979
  "kind": "flag",
12833
12980
  "type": "number",
12834
- "description": "End offset within the block (character index)."
12981
+ "description": "End offset within the block (character index).",
12982
+ "agentVisible": false
12835
12983
  }
12836
12984
  ],
12837
12985
  "constraints": null,
@@ -13265,19 +13413,22 @@ const CONTRACT = {
13265
13413
  "kind": "flag",
13266
13414
  "type": "string",
13267
13415
  "flag": "block-id",
13268
- "description": "Block ID of the target paragraph."
13416
+ "description": "Block ID of the target paragraph.",
13417
+ "agentVisible": false
13269
13418
  },
13270
13419
  {
13271
13420
  "name": "start",
13272
13421
  "kind": "flag",
13273
13422
  "type": "number",
13274
- "description": "Start offset within the block (character index)."
13423
+ "description": "Start offset within the block (character index).",
13424
+ "agentVisible": false
13275
13425
  },
13276
13426
  {
13277
13427
  "name": "end",
13278
13428
  "kind": "flag",
13279
13429
  "type": "number",
13280
- "description": "End offset within the block (character index)."
13430
+ "description": "End offset within the block (character index).",
13431
+ "agentVisible": false
13281
13432
  }
13282
13433
  ],
13283
13434
  "constraints": null,
@@ -13703,19 +13854,22 @@ const CONTRACT = {
13703
13854
  "kind": "flag",
13704
13855
  "type": "string",
13705
13856
  "flag": "block-id",
13706
- "description": "Block ID of the target paragraph."
13857
+ "description": "Block ID of the target paragraph.",
13858
+ "agentVisible": false
13707
13859
  },
13708
13860
  {
13709
13861
  "name": "start",
13710
13862
  "kind": "flag",
13711
13863
  "type": "number",
13712
- "description": "Start offset within the block (character index)."
13864
+ "description": "Start offset within the block (character index).",
13865
+ "agentVisible": false
13713
13866
  },
13714
13867
  {
13715
13868
  "name": "end",
13716
13869
  "kind": "flag",
13717
13870
  "type": "number",
13718
- "description": "End offset within the block (character index)."
13871
+ "description": "End offset within the block (character index).",
13872
+ "agentVisible": false
13719
13873
  }
13720
13874
  ],
13721
13875
  "constraints": null,
@@ -14139,19 +14293,22 @@ const CONTRACT = {
14139
14293
  "kind": "flag",
14140
14294
  "type": "string",
14141
14295
  "flag": "block-id",
14142
- "description": "Block ID of the target paragraph."
14296
+ "description": "Block ID of the target paragraph.",
14297
+ "agentVisible": false
14143
14298
  },
14144
14299
  {
14145
14300
  "name": "start",
14146
14301
  "kind": "flag",
14147
14302
  "type": "number",
14148
- "description": "Start offset within the block (character index)."
14303
+ "description": "Start offset within the block (character index).",
14304
+ "agentVisible": false
14149
14305
  },
14150
14306
  {
14151
14307
  "name": "end",
14152
14308
  "kind": "flag",
14153
14309
  "type": "number",
14154
- "description": "End offset within the block (character index)."
14310
+ "description": "End offset within the block (character index).",
14311
+ "agentVisible": false
14155
14312
  }
14156
14313
  ],
14157
14314
  "constraints": null,
@@ -14575,19 +14732,22 @@ const CONTRACT = {
14575
14732
  "kind": "flag",
14576
14733
  "type": "string",
14577
14734
  "flag": "block-id",
14578
- "description": "Block ID of the target paragraph."
14735
+ "description": "Block ID of the target paragraph.",
14736
+ "agentVisible": false
14579
14737
  },
14580
14738
  {
14581
14739
  "name": "start",
14582
14740
  "kind": "flag",
14583
14741
  "type": "number",
14584
- "description": "Start offset within the block (character index)."
14742
+ "description": "Start offset within the block (character index).",
14743
+ "agentVisible": false
14585
14744
  },
14586
14745
  {
14587
14746
  "name": "end",
14588
14747
  "kind": "flag",
14589
14748
  "type": "number",
14590
- "description": "End offset within the block (character index)."
14749
+ "description": "End offset within the block (character index).",
14750
+ "agentVisible": false
14591
14751
  }
14592
14752
  ],
14593
14753
  "constraints": null,
@@ -15043,19 +15203,22 @@ const CONTRACT = {
15043
15203
  "kind": "flag",
15044
15204
  "type": "string",
15045
15205
  "flag": "block-id",
15046
- "description": "Block ID of the target paragraph."
15206
+ "description": "Block ID of the target paragraph.",
15207
+ "agentVisible": false
15047
15208
  },
15048
15209
  {
15049
15210
  "name": "start",
15050
15211
  "kind": "flag",
15051
15212
  "type": "number",
15052
- "description": "Start offset within the block (character index)."
15213
+ "description": "Start offset within the block (character index).",
15214
+ "agentVisible": false
15053
15215
  },
15054
15216
  {
15055
15217
  "name": "end",
15056
15218
  "kind": "flag",
15057
15219
  "type": "number",
15058
- "description": "End offset within the block (character index)."
15220
+ "description": "End offset within the block (character index).",
15221
+ "agentVisible": false
15059
15222
  }
15060
15223
  ],
15061
15224
  "constraints": null,
@@ -15597,19 +15760,22 @@ const CONTRACT = {
15597
15760
  "kind": "flag",
15598
15761
  "type": "string",
15599
15762
  "flag": "block-id",
15600
- "description": "Block ID of the target paragraph."
15763
+ "description": "Block ID of the target paragraph.",
15764
+ "agentVisible": false
15601
15765
  },
15602
15766
  {
15603
15767
  "name": "start",
15604
15768
  "kind": "flag",
15605
15769
  "type": "number",
15606
- "description": "Start offset within the block (character index)."
15770
+ "description": "Start offset within the block (character index).",
15771
+ "agentVisible": false
15607
15772
  },
15608
15773
  {
15609
15774
  "name": "end",
15610
15775
  "kind": "flag",
15611
15776
  "type": "number",
15612
- "description": "End offset within the block (character index)."
15777
+ "description": "End offset within the block (character index).",
15778
+ "agentVisible": false
15613
15779
  }
15614
15780
  ],
15615
15781
  "constraints": null,
@@ -16127,19 +16293,22 @@ const CONTRACT = {
16127
16293
  "kind": "flag",
16128
16294
  "type": "string",
16129
16295
  "flag": "block-id",
16130
- "description": "Block ID of the target paragraph."
16296
+ "description": "Block ID of the target paragraph.",
16297
+ "agentVisible": false
16131
16298
  },
16132
16299
  {
16133
16300
  "name": "start",
16134
16301
  "kind": "flag",
16135
16302
  "type": "number",
16136
- "description": "Start offset within the block (character index)."
16303
+ "description": "Start offset within the block (character index).",
16304
+ "agentVisible": false
16137
16305
  },
16138
16306
  {
16139
16307
  "name": "end",
16140
16308
  "kind": "flag",
16141
16309
  "type": "number",
16142
- "description": "End offset within the block (character index)."
16310
+ "description": "End offset within the block (character index).",
16311
+ "agentVisible": false
16143
16312
  }
16144
16313
  ],
16145
16314
  "constraints": null,
@@ -16563,19 +16732,22 @@ const CONTRACT = {
16563
16732
  "kind": "flag",
16564
16733
  "type": "string",
16565
16734
  "flag": "block-id",
16566
- "description": "Block ID of the target paragraph."
16735
+ "description": "Block ID of the target paragraph.",
16736
+ "agentVisible": false
16567
16737
  },
16568
16738
  {
16569
16739
  "name": "start",
16570
16740
  "kind": "flag",
16571
16741
  "type": "number",
16572
- "description": "Start offset within the block (character index)."
16742
+ "description": "Start offset within the block (character index).",
16743
+ "agentVisible": false
16573
16744
  },
16574
16745
  {
16575
16746
  "name": "end",
16576
16747
  "kind": "flag",
16577
16748
  "type": "number",
16578
- "description": "End offset within the block (character index)."
16749
+ "description": "End offset within the block (character index).",
16750
+ "agentVisible": false
16579
16751
  }
16580
16752
  ],
16581
16753
  "constraints": null,
@@ -16999,19 +17171,22 @@ const CONTRACT = {
16999
17171
  "kind": "flag",
17000
17172
  "type": "string",
17001
17173
  "flag": "block-id",
17002
- "description": "Block ID of the target paragraph."
17174
+ "description": "Block ID of the target paragraph.",
17175
+ "agentVisible": false
17003
17176
  },
17004
17177
  {
17005
17178
  "name": "start",
17006
17179
  "kind": "flag",
17007
17180
  "type": "number",
17008
- "description": "Start offset within the block (character index)."
17181
+ "description": "Start offset within the block (character index).",
17182
+ "agentVisible": false
17009
17183
  },
17010
17184
  {
17011
17185
  "name": "end",
17012
17186
  "kind": "flag",
17013
17187
  "type": "number",
17014
- "description": "End offset within the block (character index)."
17188
+ "description": "End offset within the block (character index).",
17189
+ "agentVisible": false
17015
17190
  }
17016
17191
  ],
17017
17192
  "constraints": null,
@@ -17435,19 +17610,22 @@ const CONTRACT = {
17435
17610
  "kind": "flag",
17436
17611
  "type": "string",
17437
17612
  "flag": "block-id",
17438
- "description": "Block ID of the target paragraph."
17613
+ "description": "Block ID of the target paragraph.",
17614
+ "agentVisible": false
17439
17615
  },
17440
17616
  {
17441
17617
  "name": "start",
17442
17618
  "kind": "flag",
17443
17619
  "type": "number",
17444
- "description": "Start offset within the block (character index)."
17620
+ "description": "Start offset within the block (character index).",
17621
+ "agentVisible": false
17445
17622
  },
17446
17623
  {
17447
17624
  "name": "end",
17448
17625
  "kind": "flag",
17449
17626
  "type": "number",
17450
- "description": "End offset within the block (character index)."
17627
+ "description": "End offset within the block (character index).",
17628
+ "agentVisible": false
17451
17629
  }
17452
17630
  ],
17453
17631
  "constraints": null,
@@ -17871,19 +18049,22 @@ const CONTRACT = {
17871
18049
  "kind": "flag",
17872
18050
  "type": "string",
17873
18051
  "flag": "block-id",
17874
- "description": "Block ID of the target paragraph."
18052
+ "description": "Block ID of the target paragraph.",
18053
+ "agentVisible": false
17875
18054
  },
17876
18055
  {
17877
18056
  "name": "start",
17878
18057
  "kind": "flag",
17879
18058
  "type": "number",
17880
- "description": "Start offset within the block (character index)."
18059
+ "description": "Start offset within the block (character index).",
18060
+ "agentVisible": false
17881
18061
  },
17882
18062
  {
17883
18063
  "name": "end",
17884
18064
  "kind": "flag",
17885
18065
  "type": "number",
17886
- "description": "End offset within the block (character index)."
18066
+ "description": "End offset within the block (character index).",
18067
+ "agentVisible": false
17887
18068
  }
17888
18069
  ],
17889
18070
  "constraints": null,
@@ -18309,19 +18490,22 @@ const CONTRACT = {
18309
18490
  "kind": "flag",
18310
18491
  "type": "string",
18311
18492
  "flag": "block-id",
18312
- "description": "Block ID of the target paragraph."
18493
+ "description": "Block ID of the target paragraph.",
18494
+ "agentVisible": false
18313
18495
  },
18314
18496
  {
18315
18497
  "name": "start",
18316
18498
  "kind": "flag",
18317
18499
  "type": "number",
18318
- "description": "Start offset within the block (character index)."
18500
+ "description": "Start offset within the block (character index).",
18501
+ "agentVisible": false
18319
18502
  },
18320
18503
  {
18321
18504
  "name": "end",
18322
18505
  "kind": "flag",
18323
18506
  "type": "number",
18324
- "description": "End offset within the block (character index)."
18507
+ "description": "End offset within the block (character index).",
18508
+ "agentVisible": false
18325
18509
  }
18326
18510
  ],
18327
18511
  "constraints": null,
@@ -18747,19 +18931,22 @@ const CONTRACT = {
18747
18931
  "kind": "flag",
18748
18932
  "type": "string",
18749
18933
  "flag": "block-id",
18750
- "description": "Block ID of the target paragraph."
18934
+ "description": "Block ID of the target paragraph.",
18935
+ "agentVisible": false
18751
18936
  },
18752
18937
  {
18753
18938
  "name": "start",
18754
18939
  "kind": "flag",
18755
18940
  "type": "number",
18756
- "description": "Start offset within the block (character index)."
18941
+ "description": "Start offset within the block (character index).",
18942
+ "agentVisible": false
18757
18943
  },
18758
18944
  {
18759
18945
  "name": "end",
18760
18946
  "kind": "flag",
18761
18947
  "type": "number",
18762
- "description": "End offset within the block (character index)."
18948
+ "description": "End offset within the block (character index).",
18949
+ "agentVisible": false
18763
18950
  }
18764
18951
  ],
18765
18952
  "constraints": null,
@@ -19183,19 +19370,22 @@ const CONTRACT = {
19183
19370
  "kind": "flag",
19184
19371
  "type": "string",
19185
19372
  "flag": "block-id",
19186
- "description": "Block ID of the target paragraph."
19373
+ "description": "Block ID of the target paragraph.",
19374
+ "agentVisible": false
19187
19375
  },
19188
19376
  {
19189
19377
  "name": "start",
19190
19378
  "kind": "flag",
19191
19379
  "type": "number",
19192
- "description": "Start offset within the block (character index)."
19380
+ "description": "Start offset within the block (character index).",
19381
+ "agentVisible": false
19193
19382
  },
19194
19383
  {
19195
19384
  "name": "end",
19196
19385
  "kind": "flag",
19197
19386
  "type": "number",
19198
- "description": "End offset within the block (character index)."
19387
+ "description": "End offset within the block (character index).",
19388
+ "agentVisible": false
19199
19389
  }
19200
19390
  ],
19201
19391
  "constraints": null,
@@ -19619,19 +19809,22 @@ const CONTRACT = {
19619
19809
  "kind": "flag",
19620
19810
  "type": "string",
19621
19811
  "flag": "block-id",
19622
- "description": "Block ID of the target paragraph."
19812
+ "description": "Block ID of the target paragraph.",
19813
+ "agentVisible": false
19623
19814
  },
19624
19815
  {
19625
19816
  "name": "start",
19626
19817
  "kind": "flag",
19627
19818
  "type": "number",
19628
- "description": "Start offset within the block (character index)."
19819
+ "description": "Start offset within the block (character index).",
19820
+ "agentVisible": false
19629
19821
  },
19630
19822
  {
19631
19823
  "name": "end",
19632
19824
  "kind": "flag",
19633
19825
  "type": "number",
19634
- "description": "End offset within the block (character index)."
19826
+ "description": "End offset within the block (character index).",
19827
+ "agentVisible": false
19635
19828
  }
19636
19829
  ],
19637
19830
  "constraints": null,
@@ -20055,19 +20248,22 @@ const CONTRACT = {
20055
20248
  "kind": "flag",
20056
20249
  "type": "string",
20057
20250
  "flag": "block-id",
20058
- "description": "Block ID of the target paragraph."
20251
+ "description": "Block ID of the target paragraph.",
20252
+ "agentVisible": false
20059
20253
  },
20060
20254
  {
20061
20255
  "name": "start",
20062
20256
  "kind": "flag",
20063
20257
  "type": "number",
20064
- "description": "Start offset within the block (character index)."
20258
+ "description": "Start offset within the block (character index).",
20259
+ "agentVisible": false
20065
20260
  },
20066
20261
  {
20067
20262
  "name": "end",
20068
20263
  "kind": "flag",
20069
20264
  "type": "number",
20070
- "description": "End offset within the block (character index)."
20265
+ "description": "End offset within the block (character index).",
20266
+ "agentVisible": false
20071
20267
  }
20072
20268
  ],
20073
20269
  "constraints": null,
@@ -20491,19 +20687,22 @@ const CONTRACT = {
20491
20687
  "kind": "flag",
20492
20688
  "type": "string",
20493
20689
  "flag": "block-id",
20494
- "description": "Block ID of the target paragraph."
20690
+ "description": "Block ID of the target paragraph.",
20691
+ "agentVisible": false
20495
20692
  },
20496
20693
  {
20497
20694
  "name": "start",
20498
20695
  "kind": "flag",
20499
20696
  "type": "number",
20500
- "description": "Start offset within the block (character index)."
20697
+ "description": "Start offset within the block (character index).",
20698
+ "agentVisible": false
20501
20699
  },
20502
20700
  {
20503
20701
  "name": "end",
20504
20702
  "kind": "flag",
20505
20703
  "type": "number",
20506
- "description": "End offset within the block (character index)."
20704
+ "description": "End offset within the block (character index).",
20705
+ "agentVisible": false
20507
20706
  }
20508
20707
  ],
20509
20708
  "constraints": null,
@@ -20927,19 +21126,22 @@ const CONTRACT = {
20927
21126
  "kind": "flag",
20928
21127
  "type": "string",
20929
21128
  "flag": "block-id",
20930
- "description": "Block ID of the target paragraph."
21129
+ "description": "Block ID of the target paragraph.",
21130
+ "agentVisible": false
20931
21131
  },
20932
21132
  {
20933
21133
  "name": "start",
20934
21134
  "kind": "flag",
20935
21135
  "type": "number",
20936
- "description": "Start offset within the block (character index)."
21136
+ "description": "Start offset within the block (character index).",
21137
+ "agentVisible": false
20937
21138
  },
20938
21139
  {
20939
21140
  "name": "end",
20940
21141
  "kind": "flag",
20941
21142
  "type": "number",
20942
- "description": "End offset within the block (character index)."
21143
+ "description": "End offset within the block (character index).",
21144
+ "agentVisible": false
20943
21145
  }
20944
21146
  ],
20945
21147
  "constraints": null,
@@ -21363,19 +21565,22 @@ const CONTRACT = {
21363
21565
  "kind": "flag",
21364
21566
  "type": "string",
21365
21567
  "flag": "block-id",
21366
- "description": "Block ID of the target paragraph."
21568
+ "description": "Block ID of the target paragraph.",
21569
+ "agentVisible": false
21367
21570
  },
21368
21571
  {
21369
21572
  "name": "start",
21370
21573
  "kind": "flag",
21371
21574
  "type": "number",
21372
- "description": "Start offset within the block (character index)."
21575
+ "description": "Start offset within the block (character index).",
21576
+ "agentVisible": false
21373
21577
  },
21374
21578
  {
21375
21579
  "name": "end",
21376
21580
  "kind": "flag",
21377
21581
  "type": "number",
21378
- "description": "End offset within the block (character index)."
21582
+ "description": "End offset within the block (character index).",
21583
+ "agentVisible": false
21379
21584
  }
21380
21585
  ],
21381
21586
  "constraints": null,
@@ -21851,19 +22056,22 @@ const CONTRACT = {
21851
22056
  "kind": "flag",
21852
22057
  "type": "string",
21853
22058
  "flag": "block-id",
21854
- "description": "Block ID of the target paragraph."
22059
+ "description": "Block ID of the target paragraph.",
22060
+ "agentVisible": false
21855
22061
  },
21856
22062
  {
21857
22063
  "name": "start",
21858
22064
  "kind": "flag",
21859
22065
  "type": "number",
21860
- "description": "Start offset within the block (character index)."
22066
+ "description": "Start offset within the block (character index).",
22067
+ "agentVisible": false
21861
22068
  },
21862
22069
  {
21863
22070
  "name": "end",
21864
22071
  "kind": "flag",
21865
22072
  "type": "number",
21866
- "description": "End offset within the block (character index)."
22073
+ "description": "End offset within the block (character index).",
22074
+ "agentVisible": false
21867
22075
  }
21868
22076
  ],
21869
22077
  "constraints": null,
@@ -22401,19 +22609,22 @@ const CONTRACT = {
22401
22609
  "kind": "flag",
22402
22610
  "type": "string",
22403
22611
  "flag": "block-id",
22404
- "description": "Block ID of the target paragraph."
22612
+ "description": "Block ID of the target paragraph.",
22613
+ "agentVisible": false
22405
22614
  },
22406
22615
  {
22407
22616
  "name": "start",
22408
22617
  "kind": "flag",
22409
22618
  "type": "number",
22410
- "description": "Start offset within the block (character index)."
22619
+ "description": "Start offset within the block (character index).",
22620
+ "agentVisible": false
22411
22621
  },
22412
22622
  {
22413
22623
  "name": "end",
22414
22624
  "kind": "flag",
22415
22625
  "type": "number",
22416
- "description": "End offset within the block (character index)."
22626
+ "description": "End offset within the block (character index).",
22627
+ "agentVisible": false
22417
22628
  }
22418
22629
  ],
22419
22630
  "constraints": null,
@@ -22863,19 +23074,22 @@ const CONTRACT = {
22863
23074
  "kind": "flag",
22864
23075
  "type": "string",
22865
23076
  "flag": "block-id",
22866
- "description": "Block ID of the target paragraph."
23077
+ "description": "Block ID of the target paragraph.",
23078
+ "agentVisible": false
22867
23079
  },
22868
23080
  {
22869
23081
  "name": "start",
22870
23082
  "kind": "flag",
22871
23083
  "type": "number",
22872
- "description": "Start offset within the block (character index)."
23084
+ "description": "Start offset within the block (character index).",
23085
+ "agentVisible": false
22873
23086
  },
22874
23087
  {
22875
23088
  "name": "end",
22876
23089
  "kind": "flag",
22877
23090
  "type": "number",
22878
- "description": "End offset within the block (character index)."
23091
+ "description": "End offset within the block (character index).",
23092
+ "agentVisible": false
22879
23093
  }
22880
23094
  ],
22881
23095
  "constraints": null,
@@ -23351,19 +23565,22 @@ const CONTRACT = {
23351
23565
  "kind": "flag",
23352
23566
  "type": "string",
23353
23567
  "flag": "block-id",
23354
- "description": "Block ID of the target paragraph."
23568
+ "description": "Block ID of the target paragraph.",
23569
+ "agentVisible": false
23355
23570
  },
23356
23571
  {
23357
23572
  "name": "start",
23358
23573
  "kind": "flag",
23359
23574
  "type": "number",
23360
- "description": "Start offset within the block (character index)."
23575
+ "description": "Start offset within the block (character index).",
23576
+ "agentVisible": false
23361
23577
  },
23362
23578
  {
23363
23579
  "name": "end",
23364
23580
  "kind": "flag",
23365
23581
  "type": "number",
23366
- "description": "End offset within the block (character index)."
23582
+ "description": "End offset within the block (character index).",
23583
+ "agentVisible": false
23367
23584
  }
23368
23585
  ],
23369
23586
  "constraints": null,
@@ -23819,19 +24036,22 @@ const CONTRACT = {
23819
24036
  "kind": "flag",
23820
24037
  "type": "string",
23821
24038
  "flag": "block-id",
23822
- "description": "Block ID of the target paragraph."
24039
+ "description": "Block ID of the target paragraph.",
24040
+ "agentVisible": false
23823
24041
  },
23824
24042
  {
23825
24043
  "name": "start",
23826
24044
  "kind": "flag",
23827
24045
  "type": "number",
23828
- "description": "Start offset within the block (character index)."
24046
+ "description": "Start offset within the block (character index).",
24047
+ "agentVisible": false
23829
24048
  },
23830
24049
  {
23831
24050
  "name": "end",
23832
24051
  "kind": "flag",
23833
24052
  "type": "number",
23834
- "description": "End offset within the block (character index)."
24053
+ "description": "End offset within the block (character index).",
24054
+ "agentVisible": false
23835
24055
  }
23836
24056
  ],
23837
24057
  "constraints": null,
@@ -24331,19 +24551,22 @@ const CONTRACT = {
24331
24551
  "kind": "flag",
24332
24552
  "type": "string",
24333
24553
  "flag": "block-id",
24334
- "description": "Block ID of the target paragraph."
24554
+ "description": "Block ID of the target paragraph.",
24555
+ "agentVisible": false
24335
24556
  },
24336
24557
  {
24337
24558
  "name": "start",
24338
24559
  "kind": "flag",
24339
24560
  "type": "number",
24340
- "description": "Start offset within the block (character index)."
24561
+ "description": "Start offset within the block (character index).",
24562
+ "agentVisible": false
24341
24563
  },
24342
24564
  {
24343
24565
  "name": "end",
24344
24566
  "kind": "flag",
24345
24567
  "type": "number",
24346
- "description": "End offset within the block (character index)."
24568
+ "description": "End offset within the block (character index).",
24569
+ "agentVisible": false
24347
24570
  }
24348
24571
  ],
24349
24572
  "constraints": null,
@@ -24767,19 +24990,22 @@ const CONTRACT = {
24767
24990
  "kind": "flag",
24768
24991
  "type": "string",
24769
24992
  "flag": "block-id",
24770
- "description": "Block ID of the target paragraph."
24993
+ "description": "Block ID of the target paragraph.",
24994
+ "agentVisible": false
24771
24995
  },
24772
24996
  {
24773
24997
  "name": "start",
24774
24998
  "kind": "flag",
24775
24999
  "type": "number",
24776
- "description": "Start offset within the block (character index)."
25000
+ "description": "Start offset within the block (character index).",
25001
+ "agentVisible": false
24777
25002
  },
24778
25003
  {
24779
25004
  "name": "end",
24780
25005
  "kind": "flag",
24781
25006
  "type": "number",
24782
- "description": "End offset within the block (character index)."
25007
+ "description": "End offset within the block (character index).",
25008
+ "agentVisible": false
24783
25009
  }
24784
25010
  ],
24785
25011
  "constraints": null,
@@ -25299,19 +25525,22 @@ const CONTRACT = {
25299
25525
  "kind": "flag",
25300
25526
  "type": "string",
25301
25527
  "flag": "block-id",
25302
- "description": "Block ID of the target paragraph."
25528
+ "description": "Block ID of the target paragraph.",
25529
+ "agentVisible": false
25303
25530
  },
25304
25531
  {
25305
25532
  "name": "start",
25306
25533
  "kind": "flag",
25307
25534
  "type": "number",
25308
- "description": "Start offset within the block (character index)."
25535
+ "description": "Start offset within the block (character index).",
25536
+ "agentVisible": false
25309
25537
  },
25310
25538
  {
25311
25539
  "name": "end",
25312
25540
  "kind": "flag",
25313
25541
  "type": "number",
25314
- "description": "End offset within the block (character index)."
25542
+ "description": "End offset within the block (character index).",
25543
+ "agentVisible": false
25315
25544
  }
25316
25545
  ],
25317
25546
  "constraints": null,
@@ -25943,19 +26172,22 @@ const CONTRACT = {
25943
26172
  "kind": "flag",
25944
26173
  "type": "string",
25945
26174
  "flag": "block-id",
25946
- "description": "Block ID of the target paragraph."
26175
+ "description": "Block ID of the target paragraph.",
26176
+ "agentVisible": false
25947
26177
  },
25948
26178
  {
25949
26179
  "name": "start",
25950
26180
  "kind": "flag",
25951
26181
  "type": "number",
25952
- "description": "Start offset within the block (character index)."
26182
+ "description": "Start offset within the block (character index).",
26183
+ "agentVisible": false
25953
26184
  },
25954
26185
  {
25955
26186
  "name": "end",
25956
26187
  "kind": "flag",
25957
26188
  "type": "number",
25958
- "description": "End offset within the block (character index)."
26189
+ "description": "End offset within the block (character index).",
26190
+ "agentVisible": false
25959
26191
  }
25960
26192
  ],
25961
26193
  "constraints": null,
@@ -26381,19 +26613,22 @@ const CONTRACT = {
26381
26613
  "kind": "flag",
26382
26614
  "type": "string",
26383
26615
  "flag": "block-id",
26384
- "description": "Block ID of the target paragraph."
26616
+ "description": "Block ID of the target paragraph.",
26617
+ "agentVisible": false
26385
26618
  },
26386
26619
  {
26387
26620
  "name": "start",
26388
26621
  "kind": "flag",
26389
26622
  "type": "number",
26390
- "description": "Start offset within the block (character index)."
26623
+ "description": "Start offset within the block (character index).",
26624
+ "agentVisible": false
26391
26625
  },
26392
26626
  {
26393
26627
  "name": "end",
26394
26628
  "kind": "flag",
26395
26629
  "type": "number",
26396
- "description": "End offset within the block (character index)."
26630
+ "description": "End offset within the block (character index).",
26631
+ "agentVisible": false
26397
26632
  }
26398
26633
  ],
26399
26634
  "constraints": null,
@@ -26821,19 +27056,22 @@ const CONTRACT = {
26821
27056
  "kind": "flag",
26822
27057
  "type": "string",
26823
27058
  "flag": "block-id",
26824
- "description": "Block ID of the target paragraph."
27059
+ "description": "Block ID of the target paragraph.",
27060
+ "agentVisible": false
26825
27061
  },
26826
27062
  {
26827
27063
  "name": "start",
26828
27064
  "kind": "flag",
26829
27065
  "type": "number",
26830
- "description": "Start offset within the block (character index)."
27066
+ "description": "Start offset within the block (character index).",
27067
+ "agentVisible": false
26831
27068
  },
26832
27069
  {
26833
27070
  "name": "end",
26834
27071
  "kind": "flag",
26835
27072
  "type": "number",
26836
- "description": "End offset within the block (character index)."
27073
+ "description": "End offset within the block (character index).",
27074
+ "agentVisible": false
26837
27075
  }
26838
27076
  ],
26839
27077
  "constraints": null,
@@ -27261,19 +27499,22 @@ const CONTRACT = {
27261
27499
  "kind": "flag",
27262
27500
  "type": "string",
27263
27501
  "flag": "block-id",
27264
- "description": "Block ID of the target paragraph."
27502
+ "description": "Block ID of the target paragraph.",
27503
+ "agentVisible": false
27265
27504
  },
27266
27505
  {
27267
27506
  "name": "start",
27268
27507
  "kind": "flag",
27269
27508
  "type": "number",
27270
- "description": "Start offset within the block (character index)."
27509
+ "description": "Start offset within the block (character index).",
27510
+ "agentVisible": false
27271
27511
  },
27272
27512
  {
27273
27513
  "name": "end",
27274
27514
  "kind": "flag",
27275
27515
  "type": "number",
27276
- "description": "End offset within the block (character index)."
27516
+ "description": "End offset within the block (character index).",
27517
+ "agentVisible": false
27277
27518
  }
27278
27519
  ],
27279
27520
  "constraints": null,
@@ -27715,19 +27956,22 @@ const CONTRACT = {
27715
27956
  "kind": "flag",
27716
27957
  "type": "string",
27717
27958
  "flag": "block-id",
27718
- "description": "Block ID of the target paragraph."
27959
+ "description": "Block ID of the target paragraph.",
27960
+ "agentVisible": false
27719
27961
  },
27720
27962
  {
27721
27963
  "name": "start",
27722
27964
  "kind": "flag",
27723
27965
  "type": "number",
27724
- "description": "Start offset within the block (character index)."
27966
+ "description": "Start offset within the block (character index).",
27967
+ "agentVisible": false
27725
27968
  },
27726
27969
  {
27727
27970
  "name": "end",
27728
27971
  "kind": "flag",
27729
27972
  "type": "number",
27730
- "description": "End offset within the block (character index)."
27973
+ "description": "End offset within the block (character index).",
27974
+ "agentVisible": false
27731
27975
  }
27732
27976
  ],
27733
27977
  "constraints": null,
@@ -28185,19 +28429,22 @@ const CONTRACT = {
28185
28429
  "kind": "flag",
28186
28430
  "type": "string",
28187
28431
  "flag": "block-id",
28188
- "description": "Block ID of the target paragraph."
28432
+ "description": "Block ID of the target paragraph.",
28433
+ "agentVisible": false
28189
28434
  },
28190
28435
  {
28191
28436
  "name": "start",
28192
28437
  "kind": "flag",
28193
28438
  "type": "number",
28194
- "description": "Start offset within the block (character index)."
28439
+ "description": "Start offset within the block (character index).",
28440
+ "agentVisible": false
28195
28441
  },
28196
28442
  {
28197
28443
  "name": "end",
28198
28444
  "kind": "flag",
28199
28445
  "type": "number",
28200
- "description": "End offset within the block (character index)."
28446
+ "description": "End offset within the block (character index).",
28447
+ "agentVisible": false
28201
28448
  }
28202
28449
  ],
28203
28450
  "constraints": null,
@@ -32843,8 +33090,11 @@ const CONTRACT = {
32843
33090
  "noteId"
32844
33091
  ]
32845
33092
  }
32846
- ]
32847
- }
33093
+ ],
33094
+ "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."
33095
+ },
33096
+ "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.",
33097
+ "agentVisible": false
32848
33098
  },
32849
33099
  {
32850
33100
  "name": "at",
@@ -33002,7 +33252,7 @@ const CONTRACT = {
33002
33252
  "name": "text",
33003
33253
  "kind": "flag",
33004
33254
  "type": "string",
33005
- "description": "Paragraph text content."
33255
+ "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."
33006
33256
  },
33007
33257
  {
33008
33258
  "name": "input",
@@ -33085,7 +33335,7 @@ const CONTRACT = {
33085
33335
  "$ref": "#/$defs/StoryLocator"
33086
33336
  },
33087
33337
  "text": {
33088
- "description": "Paragraph text content.",
33338
+ "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.",
33089
33339
  "type": "string"
33090
33340
  }
33091
33341
  },
@@ -33437,8 +33687,11 @@ const CONTRACT = {
33437
33687
  "noteId"
33438
33688
  ]
33439
33689
  }
33440
- ]
33441
- }
33690
+ ],
33691
+ "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."
33692
+ },
33693
+ "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.",
33694
+ "agentVisible": false
33442
33695
  },
33443
33696
  {
33444
33697
  "name": "level",
@@ -39966,7 +40219,8 @@ const CONTRACT = {
39966
40219
  "kind": "flag",
39967
40220
  "type": "string",
39968
40221
  "flag": "style-id",
39969
- "required": true
40222
+ "required": true,
40223
+ "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."
39970
40224
  }
39971
40225
  ],
39972
40226
  "constraints": null,
@@ -39978,6 +40232,7 @@ const CONTRACT = {
39978
40232
  "additionalProperties": false,
39979
40233
  "properties": {
39980
40234
  "styleId": {
40235
+ "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.",
39981
40236
  "minLength": 1,
39982
40237
  "type": "string"
39983
40238
  },
@@ -40725,19 +40980,22 @@ const CONTRACT = {
40725
40980
  "kind": "flag",
40726
40981
  "type": "string",
40727
40982
  "flag": "block-id",
40728
- "description": "Block ID of the target paragraph."
40983
+ "description": "Block ID of the target paragraph.",
40984
+ "agentVisible": false
40729
40985
  },
40730
40986
  {
40731
40987
  "name": "start",
40732
40988
  "kind": "flag",
40733
40989
  "type": "number",
40734
- "description": "Start offset within the block (character index)."
40990
+ "description": "Start offset within the block (character index).",
40991
+ "agentVisible": false
40735
40992
  },
40736
40993
  {
40737
40994
  "name": "end",
40738
40995
  "kind": "flag",
40739
40996
  "type": "number",
40740
- "description": "End offset within the block (character index)."
40997
+ "description": "End offset within the block (character index).",
40998
+ "agentVisible": false
40741
40999
  }
40742
41000
  ],
40743
41001
  "constraints": null,
@@ -41137,19 +41395,22 @@ const CONTRACT = {
41137
41395
  "kind": "flag",
41138
41396
  "type": "string",
41139
41397
  "flag": "block-id",
41140
- "description": "Block ID of the target paragraph."
41398
+ "description": "Block ID of the target paragraph.",
41399
+ "agentVisible": false
41141
41400
  },
41142
41401
  {
41143
41402
  "name": "start",
41144
41403
  "kind": "flag",
41145
41404
  "type": "number",
41146
- "description": "Start offset within the block (character index)."
41405
+ "description": "Start offset within the block (character index).",
41406
+ "agentVisible": false
41147
41407
  },
41148
41408
  {
41149
41409
  "name": "end",
41150
41410
  "kind": "flag",
41151
41411
  "type": "number",
41152
- "description": "End offset within the block (character index)."
41412
+ "description": "End offset within the block (character index).",
41413
+ "agentVisible": false
41153
41414
  }
41154
41415
  ],
41155
41416
  "constraints": null,
@@ -41539,19 +41800,22 @@ const CONTRACT = {
41539
41800
  "kind": "flag",
41540
41801
  "type": "string",
41541
41802
  "flag": "block-id",
41542
- "description": "Block ID of the target paragraph."
41803
+ "description": "Block ID of the target paragraph.",
41804
+ "agentVisible": false
41543
41805
  },
41544
41806
  {
41545
41807
  "name": "start",
41546
41808
  "kind": "flag",
41547
41809
  "type": "number",
41548
- "description": "Start offset within the block (character index)."
41810
+ "description": "Start offset within the block (character index).",
41811
+ "agentVisible": false
41549
41812
  },
41550
41813
  {
41551
41814
  "name": "end",
41552
41815
  "kind": "flag",
41553
41816
  "type": "number",
41554
- "description": "End offset within the block (character index)."
41817
+ "description": "End offset within the block (character index).",
41818
+ "agentVisible": false
41555
41819
  }
41556
41820
  ],
41557
41821
  "constraints": null,
@@ -41955,19 +42219,22 @@ const CONTRACT = {
41955
42219
  "kind": "flag",
41956
42220
  "type": "string",
41957
42221
  "flag": "block-id",
41958
- "description": "Block ID of the target paragraph."
42222
+ "description": "Block ID of the target paragraph.",
42223
+ "agentVisible": false
41959
42224
  },
41960
42225
  {
41961
42226
  "name": "start",
41962
42227
  "kind": "flag",
41963
42228
  "type": "number",
41964
- "description": "Start offset within the block (character index)."
42229
+ "description": "Start offset within the block (character index).",
42230
+ "agentVisible": false
41965
42231
  },
41966
42232
  {
41967
42233
  "name": "end",
41968
42234
  "kind": "flag",
41969
42235
  "type": "number",
41970
- "description": "End offset within the block (character index)."
42236
+ "description": "End offset within the block (character index).",
42237
+ "agentVisible": false
41971
42238
  }
41972
42239
  ],
41973
42240
  "constraints": null,
@@ -42396,19 +42663,22 @@ const CONTRACT = {
42396
42663
  "kind": "flag",
42397
42664
  "type": "string",
42398
42665
  "flag": "block-id",
42399
- "description": "Block ID of the target paragraph."
42666
+ "description": "Block ID of the target paragraph.",
42667
+ "agentVisible": false
42400
42668
  },
42401
42669
  {
42402
42670
  "name": "start",
42403
42671
  "kind": "flag",
42404
42672
  "type": "number",
42405
- "description": "Start offset within the block (character index)."
42673
+ "description": "Start offset within the block (character index).",
42674
+ "agentVisible": false
42406
42675
  },
42407
42676
  {
42408
42677
  "name": "end",
42409
42678
  "kind": "flag",
42410
42679
  "type": "number",
42411
- "description": "End offset within the block (character index)."
42680
+ "description": "End offset within the block (character index).",
42681
+ "agentVisible": false
42412
42682
  }
42413
42683
  ],
42414
42684
  "constraints": null,
@@ -42826,19 +43096,22 @@ const CONTRACT = {
42826
43096
  "kind": "flag",
42827
43097
  "type": "string",
42828
43098
  "flag": "block-id",
42829
- "description": "Block ID of the target paragraph."
43099
+ "description": "Block ID of the target paragraph.",
43100
+ "agentVisible": false
42830
43101
  },
42831
43102
  {
42832
43103
  "name": "start",
42833
43104
  "kind": "flag",
42834
43105
  "type": "number",
42835
- "description": "Start offset within the block (character index)."
43106
+ "description": "Start offset within the block (character index).",
43107
+ "agentVisible": false
42836
43108
  },
42837
43109
  {
42838
43110
  "name": "end",
42839
43111
  "kind": "flag",
42840
43112
  "type": "number",
42841
- "description": "End offset within the block (character index)."
43113
+ "description": "End offset within the block (character index).",
43114
+ "agentVisible": false
42842
43115
  }
42843
43116
  ],
42844
43117
  "constraints": null,
@@ -43274,19 +43547,22 @@ const CONTRACT = {
43274
43547
  "kind": "flag",
43275
43548
  "type": "string",
43276
43549
  "flag": "block-id",
43277
- "description": "Block ID of the target paragraph."
43550
+ "description": "Block ID of the target paragraph.",
43551
+ "agentVisible": false
43278
43552
  },
43279
43553
  {
43280
43554
  "name": "start",
43281
43555
  "kind": "flag",
43282
43556
  "type": "number",
43283
- "description": "Start offset within the block (character index)."
43557
+ "description": "Start offset within the block (character index).",
43558
+ "agentVisible": false
43284
43559
  },
43285
43560
  {
43286
43561
  "name": "end",
43287
43562
  "kind": "flag",
43288
43563
  "type": "number",
43289
- "description": "End offset within the block (character index)."
43564
+ "description": "End offset within the block (character index).",
43565
+ "agentVisible": false
43290
43566
  }
43291
43567
  ],
43292
43568
  "constraints": null,
@@ -43683,19 +43959,22 @@ const CONTRACT = {
43683
43959
  "kind": "flag",
43684
43960
  "type": "string",
43685
43961
  "flag": "block-id",
43686
- "description": "Block ID of the target paragraph."
43962
+ "description": "Block ID of the target paragraph.",
43963
+ "agentVisible": false
43687
43964
  },
43688
43965
  {
43689
43966
  "name": "start",
43690
43967
  "kind": "flag",
43691
43968
  "type": "number",
43692
- "description": "Start offset within the block (character index)."
43969
+ "description": "Start offset within the block (character index).",
43970
+ "agentVisible": false
43693
43971
  },
43694
43972
  {
43695
43973
  "name": "end",
43696
43974
  "kind": "flag",
43697
43975
  "type": "number",
43698
- "description": "End offset within the block (character index)."
43976
+ "description": "End offset within the block (character index).",
43977
+ "agentVisible": false
43699
43978
  }
43700
43979
  ],
43701
43980
  "constraints": null,
@@ -44119,19 +44398,22 @@ const CONTRACT = {
44119
44398
  "kind": "flag",
44120
44399
  "type": "string",
44121
44400
  "flag": "block-id",
44122
- "description": "Block ID of the target paragraph."
44401
+ "description": "Block ID of the target paragraph.",
44402
+ "agentVisible": false
44123
44403
  },
44124
44404
  {
44125
44405
  "name": "start",
44126
44406
  "kind": "flag",
44127
44407
  "type": "number",
44128
- "description": "Start offset within the block (character index)."
44408
+ "description": "Start offset within the block (character index).",
44409
+ "agentVisible": false
44129
44410
  },
44130
44411
  {
44131
44412
  "name": "end",
44132
44413
  "kind": "flag",
44133
44414
  "type": "number",
44134
- "description": "End offset within the block (character index)."
44415
+ "description": "End offset within the block (character index).",
44416
+ "agentVisible": false
44135
44417
  }
44136
44418
  ],
44137
44419
  "constraints": null,
@@ -44541,19 +44823,22 @@ const CONTRACT = {
44541
44823
  "kind": "flag",
44542
44824
  "type": "string",
44543
44825
  "flag": "block-id",
44544
- "description": "Block ID of the target paragraph."
44826
+ "description": "Block ID of the target paragraph.",
44827
+ "agentVisible": false
44545
44828
  },
44546
44829
  {
44547
44830
  "name": "start",
44548
44831
  "kind": "flag",
44549
44832
  "type": "number",
44550
- "description": "Start offset within the block (character index)."
44833
+ "description": "Start offset within the block (character index).",
44834
+ "agentVisible": false
44551
44835
  },
44552
44836
  {
44553
44837
  "name": "end",
44554
44838
  "kind": "flag",
44555
44839
  "type": "number",
44556
- "description": "End offset within the block (character index)."
44840
+ "description": "End offset within the block (character index).",
44841
+ "agentVisible": false
44557
44842
  }
44558
44843
  ],
44559
44844
  "constraints": null,
@@ -45017,19 +45302,22 @@ const CONTRACT = {
45017
45302
  "kind": "flag",
45018
45303
  "type": "string",
45019
45304
  "flag": "block-id",
45020
- "description": "Block ID of the target paragraph."
45305
+ "description": "Block ID of the target paragraph.",
45306
+ "agentVisible": false
45021
45307
  },
45022
45308
  {
45023
45309
  "name": "start",
45024
45310
  "kind": "flag",
45025
45311
  "type": "number",
45026
- "description": "Start offset within the block (character index)."
45312
+ "description": "Start offset within the block (character index).",
45313
+ "agentVisible": false
45027
45314
  },
45028
45315
  {
45029
45316
  "name": "end",
45030
45317
  "kind": "flag",
45031
45318
  "type": "number",
45032
- "description": "End offset within the block (character index)."
45319
+ "description": "End offset within the block (character index).",
45320
+ "agentVisible": false
45033
45321
  }
45034
45322
  ],
45035
45323
  "constraints": null,
@@ -45438,19 +45726,22 @@ const CONTRACT = {
45438
45726
  "kind": "flag",
45439
45727
  "type": "string",
45440
45728
  "flag": "block-id",
45441
- "description": "Block ID of the target paragraph."
45729
+ "description": "Block ID of the target paragraph.",
45730
+ "agentVisible": false
45442
45731
  },
45443
45732
  {
45444
45733
  "name": "start",
45445
45734
  "kind": "flag",
45446
45735
  "type": "number",
45447
- "description": "Start offset within the block (character index)."
45736
+ "description": "Start offset within the block (character index).",
45737
+ "agentVisible": false
45448
45738
  },
45449
45739
  {
45450
45740
  "name": "end",
45451
45741
  "kind": "flag",
45452
45742
  "type": "number",
45453
- "description": "End offset within the block (character index)."
45743
+ "description": "End offset within the block (character index).",
45744
+ "agentVisible": false
45454
45745
  }
45455
45746
  ],
45456
45747
  "constraints": null,
@@ -45834,19 +46125,22 @@ const CONTRACT = {
45834
46125
  "kind": "flag",
45835
46126
  "type": "string",
45836
46127
  "flag": "block-id",
45837
- "description": "Block ID of the target paragraph."
46128
+ "description": "Block ID of the target paragraph.",
46129
+ "agentVisible": false
45838
46130
  },
45839
46131
  {
45840
46132
  "name": "start",
45841
46133
  "kind": "flag",
45842
46134
  "type": "number",
45843
- "description": "Start offset within the block (character index)."
46135
+ "description": "Start offset within the block (character index).",
46136
+ "agentVisible": false
45844
46137
  },
45845
46138
  {
45846
46139
  "name": "end",
45847
46140
  "kind": "flag",
45848
46141
  "type": "number",
45849
- "description": "End offset within the block (character index)."
46142
+ "description": "End offset within the block (character index).",
46143
+ "agentVisible": false
45850
46144
  }
45851
46145
  ],
45852
46146
  "constraints": null,
@@ -46272,19 +46566,22 @@ const CONTRACT = {
46272
46566
  "kind": "flag",
46273
46567
  "type": "string",
46274
46568
  "flag": "block-id",
46275
- "description": "Block ID of the target paragraph."
46569
+ "description": "Block ID of the target paragraph.",
46570
+ "agentVisible": false
46276
46571
  },
46277
46572
  {
46278
46573
  "name": "start",
46279
46574
  "kind": "flag",
46280
46575
  "type": "number",
46281
- "description": "Start offset within the block (character index)."
46576
+ "description": "Start offset within the block (character index).",
46577
+ "agentVisible": false
46282
46578
  },
46283
46579
  {
46284
46580
  "name": "end",
46285
46581
  "kind": "flag",
46286
46582
  "type": "number",
46287
- "description": "End offset within the block (character index)."
46583
+ "description": "End offset within the block (character index).",
46584
+ "agentVisible": false
46288
46585
  }
46289
46586
  ],
46290
46587
  "constraints": null,
@@ -46721,19 +47018,22 @@ const CONTRACT = {
46721
47018
  "kind": "flag",
46722
47019
  "type": "string",
46723
47020
  "flag": "block-id",
46724
- "description": "Block ID of the target paragraph."
47021
+ "description": "Block ID of the target paragraph.",
47022
+ "agentVisible": false
46725
47023
  },
46726
47024
  {
46727
47025
  "name": "start",
46728
47026
  "kind": "flag",
46729
47027
  "type": "number",
46730
- "description": "Start offset within the block (character index)."
47028
+ "description": "Start offset within the block (character index).",
47029
+ "agentVisible": false
46731
47030
  },
46732
47031
  {
46733
47032
  "name": "end",
46734
47033
  "kind": "flag",
46735
47034
  "type": "number",
46736
- "description": "End offset within the block (character index)."
47035
+ "description": "End offset within the block (character index).",
47036
+ "agentVisible": false
46737
47037
  }
46738
47038
  ],
46739
47039
  "constraints": null,
@@ -47139,19 +47439,22 @@ const CONTRACT = {
47139
47439
  "kind": "flag",
47140
47440
  "type": "string",
47141
47441
  "flag": "block-id",
47142
- "description": "Block ID of the target paragraph."
47442
+ "description": "Block ID of the target paragraph.",
47443
+ "agentVisible": false
47143
47444
  },
47144
47445
  {
47145
47446
  "name": "start",
47146
47447
  "kind": "flag",
47147
47448
  "type": "number",
47148
- "description": "Start offset within the block (character index)."
47449
+ "description": "Start offset within the block (character index).",
47450
+ "agentVisible": false
47149
47451
  },
47150
47452
  {
47151
47453
  "name": "end",
47152
47454
  "kind": "flag",
47153
47455
  "type": "number",
47154
- "description": "End offset within the block (character index)."
47456
+ "description": "End offset within the block (character index).",
47457
+ "agentVisible": false
47155
47458
  }
47156
47459
  ],
47157
47460
  "constraints": null,
@@ -47562,19 +47865,22 @@ const CONTRACT = {
47562
47865
  "kind": "flag",
47563
47866
  "type": "string",
47564
47867
  "flag": "block-id",
47565
- "description": "Block ID of the target paragraph."
47868
+ "description": "Block ID of the target paragraph.",
47869
+ "agentVisible": false
47566
47870
  },
47567
47871
  {
47568
47872
  "name": "start",
47569
47873
  "kind": "flag",
47570
47874
  "type": "number",
47571
- "description": "Start offset within the block (character index)."
47875
+ "description": "Start offset within the block (character index).",
47876
+ "agentVisible": false
47572
47877
  },
47573
47878
  {
47574
47879
  "name": "end",
47575
47880
  "kind": "flag",
47576
47881
  "type": "number",
47577
- "description": "End offset within the block (character index)."
47882
+ "description": "End offset within the block (character index).",
47883
+ "agentVisible": false
47578
47884
  }
47579
47885
  ],
47580
47886
  "constraints": null,
@@ -47984,19 +48290,22 @@ const CONTRACT = {
47984
48290
  "kind": "flag",
47985
48291
  "type": "string",
47986
48292
  "flag": "block-id",
47987
- "description": "Block ID of the target paragraph."
48293
+ "description": "Block ID of the target paragraph.",
48294
+ "agentVisible": false
47988
48295
  },
47989
48296
  {
47990
48297
  "name": "start",
47991
48298
  "kind": "flag",
47992
48299
  "type": "number",
47993
- "description": "Start offset within the block (character index)."
48300
+ "description": "Start offset within the block (character index).",
48301
+ "agentVisible": false
47994
48302
  },
47995
48303
  {
47996
48304
  "name": "end",
47997
48305
  "kind": "flag",
47998
48306
  "type": "number",
47999
- "description": "End offset within the block (character index)."
48307
+ "description": "End offset within the block (character index).",
48308
+ "agentVisible": false
48000
48309
  }
48001
48310
  ],
48002
48311
  "constraints": null,
@@ -48392,19 +48701,22 @@ const CONTRACT = {
48392
48701
  "kind": "flag",
48393
48702
  "type": "string",
48394
48703
  "flag": "block-id",
48395
- "description": "Block ID of the target paragraph."
48704
+ "description": "Block ID of the target paragraph.",
48705
+ "agentVisible": false
48396
48706
  },
48397
48707
  {
48398
48708
  "name": "start",
48399
48709
  "kind": "flag",
48400
48710
  "type": "number",
48401
- "description": "Start offset within the block (character index)."
48711
+ "description": "Start offset within the block (character index).",
48712
+ "agentVisible": false
48402
48713
  },
48403
48714
  {
48404
48715
  "name": "end",
48405
48716
  "kind": "flag",
48406
48717
  "type": "number",
48407
- "description": "End offset within the block (character index)."
48718
+ "description": "End offset within the block (character index).",
48719
+ "agentVisible": false
48408
48720
  }
48409
48721
  ],
48410
48722
  "constraints": null,
@@ -49370,9 +49682,9 @@ const CONTRACT = {
49370
49682
  "const": "fromParagraphs"
49371
49683
  }
49372
49684
  ],
49373
- "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."
49685
+ "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'."
49374
49686
  },
49375
- "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."
49687
+ "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'."
49376
49688
  },
49377
49689
  {
49378
49690
  "name": "at",
@@ -49475,7 +49787,7 @@ const CONTRACT = {
49475
49787
  }
49476
49788
  ]
49477
49789
  },
49478
- "description": "Required when mode is 'fromParagraphs'. The paragraph(s) to convert into list items. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
49790
+ "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>'}."
49479
49791
  },
49480
49792
  {
49481
49793
  "name": "kind",
@@ -49758,7 +50070,7 @@ const CONTRACT = {
49758
50070
  "type": "integer"
49759
50071
  },
49760
50072
  "mode": {
49761
- "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.",
50073
+ "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'.",
49762
50074
  "enum": [
49763
50075
  "empty",
49764
50076
  "fromParagraphs"
@@ -49893,7 +50205,7 @@ const CONTRACT = {
49893
50205
  },
49894
50206
  "target": {
49895
50207
  "$ref": "#/$defs/BlockAddressOrRange",
49896
- "description": "Required when mode is 'fromParagraphs'. The paragraph(s) to convert into list items. Format: {kind:'block', nodeType:'paragraph', nodeId:'<id>'}."
50208
+ "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>'}."
49897
50209
  }
49898
50210
  },
49899
50211
  "required": [
@@ -58391,19 +58703,22 @@ const CONTRACT = {
58391
58703
  "kind": "flag",
58392
58704
  "type": "string",
58393
58705
  "flag": "block-id",
58394
- "description": "Block ID of the target paragraph."
58706
+ "description": "Block ID of the target paragraph.",
58707
+ "agentVisible": false
58395
58708
  },
58396
58709
  {
58397
58710
  "name": "start",
58398
58711
  "kind": "flag",
58399
58712
  "type": "number",
58400
- "description": "Start offset within the block (character index)."
58713
+ "description": "Start offset within the block (character index).",
58714
+ "agentVisible": false
58401
58715
  },
58402
58716
  {
58403
58717
  "name": "end",
58404
58718
  "kind": "flag",
58405
58719
  "type": "number",
58406
- "description": "End offset within the block (character index)."
58720
+ "description": "End offset within the block (character index).",
58721
+ "agentVisible": false
58407
58722
  }
58408
58723
  ],
58409
58724
  "constraints": null,
@@ -58643,19 +58958,22 @@ const CONTRACT = {
58643
58958
  "kind": "flag",
58644
58959
  "type": "string",
58645
58960
  "flag": "block-id",
58646
- "description": "Block ID of the target paragraph."
58961
+ "description": "Block ID of the target paragraph.",
58962
+ "agentVisible": false
58647
58963
  },
58648
58964
  {
58649
58965
  "name": "start",
58650
58966
  "kind": "flag",
58651
58967
  "type": "number",
58652
- "description": "Start offset within the block (character index)."
58968
+ "description": "Start offset within the block (character index).",
58969
+ "agentVisible": false
58653
58970
  },
58654
58971
  {
58655
58972
  "name": "end",
58656
58973
  "kind": "flag",
58657
58974
  "type": "number",
58658
- "description": "End offset within the block (character index)."
58975
+ "description": "End offset within the block (character index).",
58976
+ "agentVisible": false
58659
58977
  }
58660
58978
  ],
58661
58979
  "constraints": null,
@@ -59855,8 +60173,11 @@ const CONTRACT = {
59855
60173
  "noteId"
59856
60174
  ]
59857
60175
  }
59858
- ]
59859
- }
60176
+ ],
60177
+ "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."
60178
+ },
60179
+ "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.",
60180
+ "agentVisible": false
59860
60181
  },
59861
60182
  {
59862
60183
  "name": "select",
@@ -61133,8 +61454,11 @@ const CONTRACT = {
61133
61454
  "noteId"
61134
61455
  ]
61135
61456
  }
61136
- ]
61137
- }
61457
+ ],
61458
+ "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."
61459
+ },
61460
+ "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.",
61461
+ "agentVisible": false
61138
61462
  },
61139
61463
  {
61140
61464
  "name": "expectedRevision",
@@ -66232,8 +66556,11 @@ const CONTRACT = {
66232
66556
  "noteId"
66233
66557
  ]
66234
66558
  }
66235
- ]
66236
- }
66559
+ ],
66560
+ "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."
66561
+ },
66562
+ "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.",
66563
+ "agentVisible": false
66237
66564
  },
66238
66565
  {
66239
66566
  "name": "atomic",
@@ -103882,8 +104209,11 @@ const CONTRACT = {
103882
104209
  "noteId"
103883
104210
  ]
103884
104211
  }
103885
- ]
103886
- }
104212
+ ],
104213
+ "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."
104214
+ },
104215
+ "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.",
104216
+ "agentVisible": false
103887
104217
  },
103888
104218
  {
103889
104219
  "name": "src",