@superdoc-dev/sdk 1.8.0-next.3 → 1.8.0-next.30

package/dist/generated/contract.cjs

@@ -2062,9 +2062,52 @@ const CONTRACT = {
                                     "type": "string",
                                     "description": "Full plain text content of the block."
                                 },
+                                "textSpans": {
+                                    "type": "array",
+                                    "description": "Block text broken into runs with tracked-change marks preserved per run. Present only when the block contains at least one tracked change. Concatenating span text yields `text`.",
+                                    "items": {
+                                        "type": "object",
+                                        "properties": {
+                                            "text": {
+                                                "type": "string",
+                                                "description": "Raw text of the run."
+                                            },
+                                            "trackedChanges": {
+                                                "type": "array",
+                                                "description": "Tracked-change marks applied to this run.",
+                                                "items": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "entityId": {
+                                                            "type": "string",
+                                                            "description": "Tracked change entity ID matching an entry in trackedChanges[]."
+                                                        },
+                                                        "type": {
+                                                            "type": "string",
+                                                            "enum": [
+                                                                "insert",
+                                                                "delete",
+                                                                "format"
+                                                            ]
+                                                        }
+                                                    },
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                        "entityId",
+                                                        "type"
+                                                    ]
+                                                }
+                                            }
+                                        },
+                                        "additionalProperties": false,
+                                        "required": [
+                                            "text"
+                                        ]
+                                    }
+                                },
                                 "headingLevel": {
                                     "type": "integer",
-                                    "description": "Heading level (1–6). Only present for headings."
+                                    "description": "Heading level (1-6). Only present for headings."
                                 },
                                 "tableContext": {
                                     "type": "object",
@@ -2167,7 +2210,7 @@ const CONTRACT = {
                             "properties": {
                                 "entityId": {
                                     "type": "string",
-                                    "description": "Tracked change entity ID — pass to scrollToElement() for navigation."
+                                    "description": "Tracked change entity ID. Pass to scrollToElement() for navigation."
                                 },
                                 "type": {
                                     "type": "string",
@@ -2175,11 +2218,37 @@ const CONTRACT = {
                                         "insert",
                                         "delete",
                                         "format"
-                                    ]
+                                    ],
+                                    "description": "Aggregate type at the entity level. In paired replacement mode, a delete+insert pair shares one entity and this collapses to 'insert'; per-half type lives on block.textSpans[].trackedChanges[]."
+                                },
+                                "blockIds": {
+                                    "type": "array",
+                                    "description": "Block IDs whose textSpans carry this change.",
+                                    "items": {
+                                        "type": "string"
+                                    }
+                                },
+                                "wordRevisionIds": {
+                                    "type": "object",
+                                    "properties": {
+                                        "insert": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:ins mark."
+                                        },
+                                        "delete": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:del mark."
+                                        },
+                                        "format": {
+                                            "type": "string",
+                                            "description": "Original OOXML w:id from a w:rPrChange mark."
+                                        }
+                                    },
+                                    "additionalProperties": false
                                 },
                                 "excerpt": {
                                     "type": "string",
-                                    "description": "Short text excerpt of the changed content."
+                                    "description": "Short text excerpt of the changed content. Omitted for paired replacements; read block.textSpans for the per-half text."
                                 },
                                 "author": {
                                     "type": "string",
@@ -51156,7 +51225,9 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "list",
+            "intentAction": "attach"
         },
         "doc.lists.detach": {
             "operationId": "doc.lists.detach",
@@ -52454,19 +52525,19 @@ const CONTRACT = {
                 ]
             }
         },
-        "doc.lists.setLevel": {
-            "operationId": "doc.lists.setLevel",
+        "doc.lists.merge": {
+            "operationId": "doc.lists.merge",
             "sdkSurface": "document",
-            "command": "lists set-level",
+            "command": "lists merge",
             "commandTokens": [
                 "lists",
-                "set-level"
+                "merge"
             ],
             "category": "lists",
-            "description": "Set the absolute nesting level (0..8) of a list item.",
+            "description": "Compound: merge two adjacent list sequences into one. Reassigns numId on the absorbed sequence (no strict abstractNumId check — absorbed items adopt the absorbing definition) and deletes empty paragraphs between the two sequences. Use this instead of lists.join for the user-facing \"merge these lists\" intent.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
-            "responseEnvelopeKey": "result",
+            "responseEnvelopeKey": null,
             "params": [
                 {
                     "name": "doc",
@@ -52525,6 +52596,7 @@ const CONTRACT = {
                     "kind": "jsonFlag",
                     "type": "json",
                     "flag": "target-json",
+                    "required": true,
                     "schema": {
                         "type": "object",
                         "properties": {
@@ -52546,23 +52618,20 @@ const CONTRACT = {
                     }
                 },
                 {
-                    "name": "level",
-                    "kind": "flag",
-                    "type": "number"
-                },
-                {
-                    "name": "input",
-                    "kind": "jsonFlag",
-                    "type": "json",
-                    "flag": "input-json",
-                    "description": "Operation input as JSON object."
-                },
-                {
-                    "name": "nodeId",
+                    "name": "direction",
                     "kind": "flag",
                     "type": "string",
-                    "flag": "node-id",
-                    "description": "Node ID of the target list item."
+                    "required": true,
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "const": "withPrevious"
+                            },
+                            {
+                                "const": "withNext"
+                            }
+                        ]
+                    }
                 }
             ],
             "constraints": null,
@@ -52576,16 +52645,17 @@ const CONTRACT = {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
                     },
-                    "level": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 8
+                    "direction": {
+                        "enum": [
+                            "withPrevious",
+                            "withNext"
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "target",
-                    "level"
+                    "direction"
                 ]
             },
             "outputSchema": {
@@ -52596,14 +52666,22 @@ const CONTRACT = {
                             "success": {
                                 "const": true
                             },
-                            "item": {
-                                "$ref": "#/$defs/ListItemAddress"
+                            "listId": {
+                                "type": "string"
+                            },
+                            "absorbedCount": {
+                                "type": "integer"
+                            },
+                            "removedEmptyBlocks": {
+                                "type": "integer"
                             }
                         },
                         "additionalProperties": false,
                         "required": [
                             "success",
-                            "item"
+                            "listId",
+                            "absorbedCount",
+                            "removedEmptyBlocks"
                         ]
                     },
                     {
@@ -52618,7 +52696,7 @@ const CONTRACT = {
                                     "code": {
                                         "enum": [
                                             "INVALID_TARGET",
-                                            "LEVEL_OUT_OF_RANGE",
+                                            "NO_ADJACENT_SEQUENCE",
                                             "NO_OP"
                                         ]
                                     },
@@ -52648,14 +52726,22 @@ const CONTRACT = {
                     "success": {
                         "const": true
                     },
-                    "item": {
-                        "$ref": "#/$defs/ListItemAddress"
+                    "listId": {
+                        "type": "string"
+                    },
+                    "absorbedCount": {
+                        "type": "integer"
+                    },
+                    "removedEmptyBlocks": {
+                        "type": "integer"
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "success",
-                    "item"
+                    "listId",
+                    "absorbedCount",
+                    "removedEmptyBlocks"
                 ]
             },
             "failureSchema": {
@@ -52670,7 +52756,7 @@ const CONTRACT = {
                             "code": {
                                 "enum": [
                                     "INVALID_TARGET",
-                                    "LEVEL_OUT_OF_RANGE",
+                                    "NO_ADJACENT_SEQUENCE",
                                     "NO_OP"
                                 ]
                             },
@@ -52693,21 +52779,21 @@ const CONTRACT = {
                 ]
             },
             "intentGroup": "list",
-            "intentAction": "set_level"
+            "intentAction": "merge"
         },
-        "doc.lists.setValue": {
-            "operationId": "doc.lists.setValue",
+        "doc.lists.split": {
+            "operationId": "doc.lists.split",
             "sdkSurface": "document",
-            "command": "lists set-value",
+            "command": "lists split",
             "commandTokens": [
                 "lists",
-                "set-value"
+                "split"
             ],
             "category": "lists",
-            "description": "Set an explicit numbering value at the target item. Mid-sequence targets are atomically separated first.",
+            "description": "Compound: split a list sequence at the target item into two independent sequences. Runs lists.separate then (by default) lists.setValue(1) so the new half starts numbering fresh at 1. Pass restartNumbering:false for raw separate semantics (new half continues the previous count).",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
-            "responseEnvelopeKey": "result",
+            "responseEnvelopeKey": null,
             "params": [
                 {
                     "name": "doc",
@@ -52766,6 +52852,7 @@ const CONTRACT = {
                     "kind": "jsonFlag",
                     "type": "json",
                     "flag": "target-json",
+                    "required": true,
                     "schema": {
                         "type": "object",
                         "properties": {
@@ -52787,27 +52874,10 @@ const CONTRACT = {
                     }
                 },
                 {
-                    "name": "value",
-                    "kind": "jsonFlag",
-                    "type": "json",
-                    "flag": "value-json",
-                    "schema": {
-                        "type": "json"
-                    }
-                },
-                {
-                    "name": "input",
-                    "kind": "jsonFlag",
-                    "type": "json",
-                    "flag": "input-json",
-                    "description": "Operation input as JSON object."
-                },
-                {
-                    "name": "nodeId",
+                    "name": "restartNumbering",
                     "kind": "flag",
-                    "type": "string",
-                    "flag": "node-id",
-                    "description": "Node ID of the target list item."
+                    "type": "boolean",
+                    "flag": "restart-numbering"
                 }
             ],
             "constraints": null,
@@ -52821,17 +52891,13 @@ const CONTRACT = {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
                     },
-                    "value": {
-                        "type": [
-                            "integer",
-                            "null"
-                        ]
+                    "restartNumbering": {
+                        "type": "boolean"
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "target",
-                    "value"
+                    "target"
                 ]
             },
             "outputSchema": {
@@ -52842,14 +52908,25 @@ const CONTRACT = {
                             "success": {
                                 "const": true
                             },
-                            "item": {
-                                "$ref": "#/$defs/ListItemAddress"
+                            "listId": {
+                                "type": "string"
+                            },
+                            "numId": {
+                                "type": "integer"
+                            },
+                            "restartedAt": {
+                                "type": [
+                                    "integer",
+                                    "null"
+                                ]
                             }
                         },
                         "additionalProperties": false,
                         "required": [
                             "success",
-                            "item"
+                            "listId",
+                            "numId",
+                            "restartedAt"
                         ]
                     },
                     {
@@ -52893,14 +52970,25 @@ const CONTRACT = {
                     "success": {
                         "const": true
                     },
-                    "item": {
-                        "$ref": "#/$defs/ListItemAddress"
+                    "listId": {
+                        "type": "string"
+                    },
+                    "numId": {
+                        "type": "integer"
+                    },
+                    "restartedAt": {
+                        "type": [
+                            "integer",
+                            "null"
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "success",
-                    "item"
+                    "listId",
+                    "numId",
+                    "restartedAt"
                 ]
             },
             "failureSchema": {
@@ -52935,18 +53023,20 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "list",
+            "intentAction": "split"
         },
-        "doc.lists.continuePrevious": {
-            "operationId": "doc.lists.continuePrevious",
+        "doc.lists.setLevel": {
+            "operationId": "doc.lists.setLevel",
             "sdkSurface": "document",
-            "command": "lists continue-previous",
+            "command": "lists set-level",
             "commandTokens": [
                 "lists",
-                "continue-previous"
+                "set-level"
             ],
             "category": "lists",
-            "description": "Continue numbering from the nearest compatible previous list sequence.",
+            "description": "Set the absolute nesting level (0..8) of a list item.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -53028,6 +53118,11 @@ const CONTRACT = {
                         ]
                     }
                 },
+                {
+                    "name": "level",
+                    "kind": "flag",
+                    "type": "number"
+                },
                 {
                     "name": "input",
                     "kind": "jsonFlag",
@@ -53053,11 +53148,17 @@ const CONTRACT = {
                 "properties": {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
+                    },
+                    "level": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 8
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "target"
+                    "target",
+                    "level"
                 ]
             },
             "outputSchema": {
@@ -53090,8 +53191,8 @@ const CONTRACT = {
                                     "code": {
                                         "enum": [
                                             "INVALID_TARGET",
-                                            "NO_COMPATIBLE_PREVIOUS",
-                                            "ALREADY_CONTINUOUS"
+                                            "LEVEL_OUT_OF_RANGE",
+                                            "NO_OP"
                                         ]
                                     },
                                     "message": {
@@ -53142,8 +53243,8 @@ const CONTRACT = {
                             "code": {
                                 "enum": [
                                     "INVALID_TARGET",
-                                    "NO_COMPATIBLE_PREVIOUS",
-                                    "ALREADY_CONTINUOUS"
+                                    "LEVEL_OUT_OF_RANGE",
+                                    "NO_OP"
                                 ]
                             },
                             "message": {
@@ -53163,18 +53264,494 @@ const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "list",
+            "intentAction": "set_level"
         },
-        "doc.lists.canContinuePrevious": {
-            "operationId": "doc.lists.canContinuePrevious",
+        "doc.lists.setValue": {
+            "operationId": "doc.lists.setValue",
             "sdkSurface": "document",
-            "command": "lists can-continue-previous",
+            "command": "lists set-value",
             "commandTokens": [
                 "lists",
-                "can-continue-previous"
+                "set-value"
             ],
             "category": "lists",
-            "description": "Check whether the target sequence can continue numbering from a previous compatible sequence.",
+            "description": "Set an explicit numbering value at the target item. Mid-sequence targets are atomically separated first.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": "result",
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "block"
+                            },
+                            "nodeType": {
+                                "const": "listItem"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "nodeType",
+                            "nodeId"
+                        ]
+                    }
+                },
+                {
+                    "name": "value",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "value-json",
+                    "schema": {
+                        "type": "json"
+                    }
+                },
+                {
+                    "name": "input",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "input-json",
+                    "description": "Operation input as JSON object."
+                },
+                {
+                    "name": "nodeId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "node-id",
+                    "description": "Node ID of the target list item."
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "conditional",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "$ref": "#/$defs/ListItemAddress"
+                    },
+                    "value": {
+                        "type": [
+                            "integer",
+                            "null"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "target",
+                    "value"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "item": {
+                                "$ref": "#/$defs/ListItemAddress"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "item"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "enum": [
+                                            "INVALID_TARGET",
+                                            "NO_OP"
+                                        ]
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "item": {
+                        "$ref": "#/$defs/ListItemAddress"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "item"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "enum": [
+                                    "INVALID_TARGET",
+                                    "NO_OP"
+                                ]
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            },
+            "intentGroup": "list",
+            "intentAction": "set_value"
+        },
+        "doc.lists.continuePrevious": {
+            "operationId": "doc.lists.continuePrevious",
+            "sdkSurface": "document",
+            "command": "lists continue-previous",
+            "commandTokens": [
+                "lists",
+                "continue-previous"
+            ],
+            "category": "lists",
+            "description": "Continue numbering from the nearest compatible previous list sequence.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": "result",
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "out",
+                    "kind": "flag",
+                    "type": "string",
+                    "agentVisible": false
+                },
+                {
+                    "name": "force",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "description": "Bypass confirmation checks."
+                },
+                {
+                    "name": "expectedRevision",
+                    "kind": "flag",
+                    "type": "number",
+                    "flag": "expected-revision",
+                    "agentVisible": false
+                },
+                {
+                    "name": "changeMode",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "change-mode",
+                    "schema": {
+                        "enum": [
+                            "direct",
+                            "tracked"
+                        ]
+                    },
+                    "description": "Edit mode: \"direct\" applies changes immediately, \"tracked\" records as suggestions."
+                },
+                {
+                    "name": "dryRun",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "dry-run",
+                    "description": "Preview the result without applying changes."
+                },
+                {
+                    "name": "target",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "target-json",
+                    "schema": {
+                        "type": "object",
+                        "properties": {
+                            "kind": {
+                                "const": "block"
+                            },
+                            "nodeType": {
+                                "const": "listItem"
+                            },
+                            "nodeId": {
+                                "type": "string"
+                            }
+                        },
+                        "required": [
+                            "kind",
+                            "nodeType",
+                            "nodeId"
+                        ]
+                    }
+                },
+                {
+                    "name": "input",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "input-json",
+                    "description": "Operation input as JSON object."
+                },
+                {
+                    "name": "nodeId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "node-id",
+                    "description": "Node ID of the target list item."
+                }
+            ],
+            "constraints": null,
+            "mutates": true,
+            "idempotency": "conditional",
+            "supportsTrackedMode": false,
+            "supportsDryRun": true,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "target": {
+                        "$ref": "#/$defs/ListItemAddress"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "target"
+                ]
+            },
+            "outputSchema": {
+                "oneOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": true
+                            },
+                            "item": {
+                                "$ref": "#/$defs/ListItemAddress"
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "item"
+                        ]
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "success": {
+                                "const": false
+                            },
+                            "failure": {
+                                "type": "object",
+                                "properties": {
+                                    "code": {
+                                        "enum": [
+                                            "INVALID_TARGET",
+                                            "NO_COMPATIBLE_PREVIOUS",
+                                            "ALREADY_CONTINUOUS"
+                                        ]
+                                    },
+                                    "message": {
+                                        "type": "string"
+                                    },
+                                    "details": {}
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "code",
+                                    "message"
+                                ]
+                            }
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "success",
+                            "failure"
+                        ]
+                    }
+                ]
+            },
+            "successSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": true
+                    },
+                    "item": {
+                        "$ref": "#/$defs/ListItemAddress"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "item"
+                ]
+            },
+            "failureSchema": {
+                "type": "object",
+                "properties": {
+                    "success": {
+                        "const": false
+                    },
+                    "failure": {
+                        "type": "object",
+                        "properties": {
+                            "code": {
+                                "enum": [
+                                    "INVALID_TARGET",
+                                    "NO_COMPATIBLE_PREVIOUS",
+                                    "ALREADY_CONTINUOUS"
+                                ]
+                            },
+                            "message": {
+                                "type": "string"
+                            },
+                            "details": {}
+                        },
+                        "additionalProperties": false,
+                        "required": [
+                            "code",
+                            "message"
+                        ]
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "success",
+                    "failure"
+                ]
+            },
+            "intentGroup": "list",
+            "intentAction": "continue_previous"
+        },
+        "doc.lists.canContinuePrevious": {
+            "operationId": "doc.lists.canContinuePrevious",
+            "sdkSurface": "document",
+            "command": "lists can-continue-previous",
+            "commandTokens": [
+                "lists",
+                "can-continue-previous"
+            ],
+            "category": "lists",
+            "description": "Check whether the target sequence can continue numbering from a previous compatible sequence.",
             "requiresDocumentContext": true,
             "docRequirement": "optional",
             "responseEnvelopeKey": "result",
@@ -59211,37 +59788,240 @@ const CONTRACT = {
                     "type": "json",
                     "flag": "target-json",
                     "schema": {
-                        "type": "object",
-                        "properties": {
-                            "kind": {
-                                "const": "text"
-                            },
-                            "blockId": {
-                                "type": "string"
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "text"
+                                    },
+                                    "blockId": {
+                                        "type": "string"
+                                    },
+                                    "range": {
+                                        "type": "object",
+                                        "properties": {
+                                            "start": {
+                                                "type": "number"
+                                            },
+                                            "end": {
+                                                "type": "number"
+                                            }
+                                        },
+                                        "required": [
+                                            "start",
+                                            "end"
+                                        ]
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "blockId",
+                                    "range"
+                                ]
                             },
-                            "range": {
+                            {
                                 "type": "object",
                                 "properties": {
-                                    "start": {
-                                        "type": "number"
+                                    "kind": {
+                                        "const": "text"
                                     },
-                                    "end": {
-                                        "type": "number"
+                                    "segments": {
+                                        "type": "array",
+                                        "items": {
+                                            "type": "object",
+                                            "properties": {
+                                                "blockId": {
+                                                    "type": "string"
+                                                },
+                                                "range": {
+                                                    "type": "object",
+                                                    "properties": {
+                                                        "start": {
+                                                            "type": "number"
+                                                        },
+                                                        "end": {
+                                                            "type": "number"
+                                                        }
+                                                    },
+                                                    "required": [
+                                                        "start",
+                                                        "end"
+                                                    ]
+                                                }
+                                            },
+                                            "required": [
+                                                "blockId",
+                                                "range"
+                                            ]
+                                        }
+                                    },
+                                    "story": {
+                                        "oneOf": [
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "body"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "headerFooterSlot"
+                                                    },
+                                                    "section": {
+                                                        "type": "object",
+                                                        "properties": {
+                                                            "kind": {
+                                                                "const": "section"
+                                                            },
+                                                            "sectionId": {
+                                                                "type": "string"
+                                                            }
+                                                        },
+                                                        "required": [
+                                                            "kind",
+                                                            "sectionId"
+                                                        ]
+                                                    },
+                                                    "headerFooterKind": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "header"
+                                                            },
+                                                            {
+                                                                "const": "footer"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "variant": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "default"
+                                                            },
+                                                            {
+                                                                "const": "first"
+                                                            },
+                                                            {
+                                                                "const": "even"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "resolution": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "effective"
+                                                            },
+                                                            {
+                                                                "const": "explicit"
+                                                            }
+                                                        ]
+                                                    },
+                                                    "onWrite": {
+                                                        "oneOf": [
+                                                            {
+                                                                "const": "materializeIfInherited"
+                                                            },
+                                                            {
+                                                                "const": "editResolvedPart"
+                                                            },
+                                                            {
+                                                                "const": "error"
+                                                            }
+                                                        ]
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "section",
+                                                    "headerFooterKind",
+                                                    "variant"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "headerFooterPart"
+                                                    },
+                                                    "refId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "refId"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "footnote"
+                                                    },
+                                                    "noteId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "noteId"
+                                                ]
+                                            },
+                                            {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "story"
+                                                    },
+                                                    "storyType": {
+                                                        "const": "endnote"
+                                                    },
+                                                    "noteId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "storyType",
+                                                    "noteId"
+                                                ]
+                                            }
+                                        ],
+                                        "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."
                                     }
                                 },
                                 "required": [
-                                    "start",
-                                    "end"
+                                    "kind",
+                                    "segments"
                                 ]
                             }
-                        },
-                        "required": [
-                            "kind",
-                            "blockId",
-                            "range"
-                        ]
+                        ],
+                        "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
                     },
-                    "description": "Text range to anchor the comment: {kind:'text', blockId:'...', range:{start:N, end:N}}."
+                    "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
                 },
                 {
                     "name": "parentId",
@@ -59286,8 +60066,15 @@ const CONTRACT = {
                         "description": "Comment text content."
                     },
                     "target": {
-                        "$ref": "#/$defs/TextAddress",
-                        "description": "Text range to anchor the comment: {kind:'text', blockId:'...', range:{start:N, end:N}}."
+                        "oneOf": [
+                            {
+                                "$ref": "#/$defs/TextAddress"
+                            },
+                            {
+                                "$ref": "#/$defs/TextTarget"
+                            }
+                        ],
+                        "description": "Text range to anchor the comment. Accepts either a single-block TextAddress {kind:'text', blockId, range} or a multi-segment TextTarget {kind:'text', segments:[{blockId, range}, ...]} for selections that span blocks."
                     },
                     "parentCommentId": {
                         "type": "string",
@@ -59493,11 +60280,14 @@ const CONTRACT = {
                         "oneOf": [
                             {
                                 "const": "resolved"
+                            },
+                            {
+                                "const": "active"
                             }
                         ],
-                        "description": "Set comment status. Use 'resolved' to mark as resolved."
+                        "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                     },
-                    "description": "Set comment status. Use 'resolved' to mark as resolved."
+                    "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                 },
                 {
                     "name": "isInternal",
@@ -59549,9 +60339,10 @@ const CONTRACT = {
                     },
                     "status": {
                         "enum": [
-                            "resolved"
+                            "resolved",
+                            "active"
                         ],
-                        "description": "Set comment status. Use 'resolved' to mark as resolved."
+                        "description": "Set comment status. Use 'resolved' to resolve a comment, or 'active' to reopen a previously resolved comment (lifecycle inverse)."
                     },
                     "isInternal": {
                         "type": "boolean",
@@ -62377,6 +63168,102 @@ const CONTRACT = {
                 ]
             }
         },
+        "doc.selection.current": {
+            "operationId": "doc.selection.current",
+            "sdkSurface": "document",
+            "command": "selection current",
+            "commandTokens": [
+                "selection",
+                "current"
+            ],
+            "category": "core",
+            "description": "Read the editor's current selection as a portable SelectionInfo with a text-anchored TextTarget. Primitive for building custom comments UIs, floating toolbars, and other selection-driven components without reaching into ProseMirror internals.",
+            "requiresDocumentContext": true,
+            "docRequirement": "optional",
+            "responseEnvelopeKey": null,
+            "params": [
+                {
+                    "name": "doc",
+                    "kind": "doc",
+                    "type": "string",
+                    "description": "Document path. Optional when a session is already open."
+                },
+                {
+                    "name": "sessionId",
+                    "kind": "flag",
+                    "type": "string",
+                    "flag": "session",
+                    "description": "Session ID for multi-session workflows. Optional when only one session is open."
+                },
+                {
+                    "name": "includeText",
+                    "kind": "flag",
+                    "type": "boolean",
+                    "flag": "include-text"
+                }
+            ],
+            "constraints": null,
+            "mutates": false,
+            "idempotency": "idempotent",
+            "supportsTrackedMode": false,
+            "supportsDryRun": false,
+            "inputSchema": {
+                "type": "object",
+                "properties": {
+                    "includeText": {
+                        "type": "boolean"
+                    }
+                },
+                "additionalProperties": false
+            },
+            "outputSchema": {
+                "type": "object",
+                "properties": {
+                    "empty": {
+                        "type": "boolean"
+                    },
+                    "target": {
+                        "oneOf": [
+                            {
+                                "$ref": "#/$defs/TextTarget"
+                            },
+                            {
+                                "type": "null"
+                            }
+                        ]
+                    },
+                    "activeMarks": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "activeCommentIds": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "activeChangeIds": {
+                        "type": "array",
+                        "items": {
+                            "type": "string"
+                        }
+                    },
+                    "text": {
+                        "type": "string"
+                    }
+                },
+                "additionalProperties": false,
+                "required": [
+                    "empty",
+                    "target",
+                    "activeMarks",
+                    "activeCommentIds",
+                    "activeChangeIds"
+                ]
+            }
+        },
         "doc.mutations.preview": {
             "operationId": "doc.mutations.preview",
             "sdkSurface": "document",
@@ -79654,6 +80541,76 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
+                            "lists.merge": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
+                            "lists.split": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
                             "lists.setLevel": {
                                 "type": "object",
                                 "properties": {
@@ -80879,6 +81836,41 @@ const CONTRACT = {
                                     "dryRun"
                                 ]
                             },
+                            "selection.current": {
+                                "type": "object",
+                                "properties": {
+                                    "available": {
+                                        "type": "boolean"
+                                    },
+                                    "tracked": {
+                                        "type": "boolean"
+                                    },
+                                    "dryRun": {
+                                        "type": "boolean"
+                                    },
+                                    "reasons": {
+                                        "type": "array",
+                                        "items": {
+                                            "enum": [
+                                                "COMMAND_UNAVAILABLE",
+                                                "HELPER_UNAVAILABLE",
+                                                "OPERATION_UNAVAILABLE",
+                                                "TRACKED_MODE_UNAVAILABLE",
+                                                "DRY_RUN_UNAVAILABLE",
+                                                "NAMESPACE_UNAVAILABLE",
+                                                "STYLES_PART_MISSING",
+                                                "COLLABORATION_ACTIVE"
+                                            ]
+                                        }
+                                    }
+                                },
+                                "additionalProperties": false,
+                                "required": [
+                                    "available",
+                                    "tracked",
+                                    "dryRun"
+                                ]
+                            },
                             "mutations.preview": {
                                 "type": "object",
                                 "properties": {
@@ -89257,6 +90249,8 @@ const CONTRACT = {
                             "lists.join",
                             "lists.canJoin",
                             "lists.separate",
+                            "lists.merge",
+                            "lists.split",
                             "lists.setLevel",
                             "lists.setValue",
                             "lists.continuePrevious",
@@ -89292,6 +90286,7 @@ const CONTRACT = {
                             "trackChanges.decide",
                             "query.match",
                             "ranges.resolve",
+                            "selection.current",
                             "mutations.preview",
                             "mutations.apply",
                             "capabilities.get",
@@ -130599,6 +131594,170 @@ const CONTRACT = {
                     "name": "offset",
                     "kind": "flag",
                     "type": "number"
+                },
+                {
+                    "name": "in",
+                    "kind": "jsonFlag",
+                    "type": "json",
+                    "flag": "in-json",
+                    "schema": {
+                        "oneOf": [
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "body"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "headerFooterSlot"
+                                    },
+                                    "section": {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "section"
+                                            },
+                                            "sectionId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "sectionId"
+                                        ]
+                                    },
+                                    "headerFooterKind": {
+                                        "oneOf": [
+                                            {
+                                                "const": "header"
+                                            },
+                                            {
+                                                "const": "footer"
+                                            }
+                                        ]
+                                    },
+                                    "variant": {
+                                        "oneOf": [
+                                            {
+                                                "const": "default"
+                                            },
+                                            {
+                                                "const": "first"
+                                            },
+                                            {
+                                                "const": "even"
+                                            }
+                                        ]
+                                    },
+                                    "resolution": {
+                                        "oneOf": [
+                                            {
+                                                "const": "effective"
+                                            },
+                                            {
+                                                "const": "explicit"
+                                            }
+                                        ]
+                                    },
+                                    "onWrite": {
+                                        "oneOf": [
+                                            {
+                                                "const": "materializeIfInherited"
+                                            },
+                                            {
+                                                "const": "editResolvedPart"
+                                            },
+                                            {
+                                                "const": "error"
+                                            }
+                                        ]
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "section",
+                                    "headerFooterKind",
+                                    "variant"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "headerFooterPart"
+                                    },
+                                    "refId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "refId"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "footnote"
+                                    },
+                                    "noteId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "noteId"
+                                ]
+                            },
+                            {
+                                "type": "object",
+                                "properties": {
+                                    "kind": {
+                                        "const": "story"
+                                    },
+                                    "storyType": {
+                                        "const": "endnote"
+                                    },
+                                    "noteId": {
+                                        "type": "string"
+                                    }
+                                },
+                                "required": [
+                                    "kind",
+                                    "storyType",
+                                    "noteId"
+                                ]
+                            }
+                        ],
+                        "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."
+                    },
+                    "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.",
+                    "agentVisible": false
                 }
             ],
             "constraints": null,
@@ -130616,6 +131775,9 @@ const CONTRACT = {
                     "offset": {
                         "type": "integer",
                         "minimum": 0
+                    },
+                    "in": {
+                        "$ref": "#/$defs/StoryLocator"
                     }
                 },
                 "additionalProperties": false
@@ -130668,6 +131830,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -130697,6 +132015,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -130829,6 +132150,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -130915,6 +132392,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -130980,6 +132460,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131110,6 +132593,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -131146,6 +132785,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131184,6 +132826,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -131249,6 +132894,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131379,6 +133027,162 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -131408,6 +133212,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131442,6 +133249,9 @@ const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -131507,6 +133317,9 @@ const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131833,6 +133646,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -133221,6 +135190,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -136097,6 +138222,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -138500,6 +140781,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -139527,6 +141964,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [
@@ -144822,6 +147415,162 @@ const CONTRACT = {
                                         "range"
                                     ]
                                 }
+                            },
+                            "story": {
+                                "oneOf": [
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "body"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterSlot"
+                                            },
+                                            "section": {
+                                                "type": "object",
+                                                "properties": {
+                                                    "kind": {
+                                                        "const": "section"
+                                                    },
+                                                    "sectionId": {
+                                                        "type": "string"
+                                                    }
+                                                },
+                                                "required": [
+                                                    "kind",
+                                                    "sectionId"
+                                                ]
+                                            },
+                                            "headerFooterKind": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "header"
+                                                    },
+                                                    {
+                                                        "const": "footer"
+                                                    }
+                                                ]
+                                            },
+                                            "variant": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "default"
+                                                    },
+                                                    {
+                                                        "const": "first"
+                                                    },
+                                                    {
+                                                        "const": "even"
+                                                    }
+                                                ]
+                                            },
+                                            "resolution": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "effective"
+                                                    },
+                                                    {
+                                                        "const": "explicit"
+                                                    }
+                                                ]
+                                            },
+                                            "onWrite": {
+                                                "oneOf": [
+                                                    {
+                                                        "const": "materializeIfInherited"
+                                                    },
+                                                    {
+                                                        "const": "editResolvedPart"
+                                                    },
+                                                    {
+                                                        "const": "error"
+                                                    }
+                                                ]
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "section",
+                                            "headerFooterKind",
+                                            "variant"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "headerFooterPart"
+                                            },
+                                            "refId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "refId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "footnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    },
+                                    {
+                                        "type": "object",
+                                        "properties": {
+                                            "kind": {
+                                                "const": "story"
+                                            },
+                                            "storyType": {
+                                                "const": "endnote"
+                                            },
+                                            "noteId": {
+                                                "type": "string"
+                                            }
+                                        },
+                                        "required": [
+                                            "kind",
+                                            "storyType",
+                                            "noteId"
+                                        ]
+                                    }
+                                ],
+                                "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."
                             }
                         },
                         "required": [