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

package/dist/generated/contract.js

@@ -122,6 +122,9 @@ export const CONTRACT = {
                         "$ref": "#/$defs/TextSegment"
                     },
                     "minItems": 1
+                },
+                "story": {
+                    "$ref": "#/$defs/StoryLocator"
                 }
             },
             "additionalProperties": false,
@@ -3180,9 +3183,52 @@ export 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",
@@ -3285,7 +3331,7 @@ export 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",
@@ -3293,11 +3339,37 @@ export 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",
@@ -52274,7 +52346,9 @@ export const CONTRACT = {
                     "success",
                     "failure"
                 ]
-            }
+            },
+            "intentGroup": "list",
+            "intentAction": "attach"
         },
         "doc.lists.detach": {
             "operationId": "doc.lists.detach",
@@ -53572,19 +53646,19 @@ export 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",
@@ -53643,6 +53717,7 @@ export const CONTRACT = {
                     "kind": "jsonFlag",
                     "type": "json",
                     "flag": "target-json",
+                    "required": true,
                     "schema": {
                         "type": "object",
                         "properties": {
@@ -53664,23 +53739,20 @@ export 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,
@@ -53694,16 +53766,17 @@ export const CONTRACT = {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
                     },
-                    "level": {
-                        "type": "integer",
-                        "minimum": 0,
-                        "maximum": 8
+                    "direction": {
+                        "enum": [
+                            "withPrevious",
+                            "withNext"
+                        ]
                     }
                 },
                 "additionalProperties": false,
                 "required": [
                     "target",
-                    "level"
+                    "direction"
                 ]
             },
             "outputSchema": {
@@ -53714,14 +53787,22 @@ export 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"
                         ]
                     },
                     {
@@ -53736,7 +53817,7 @@ export const CONTRACT = {
                                     "code": {
                                         "enum": [
                                             "INVALID_TARGET",
-                                            "LEVEL_OUT_OF_RANGE",
+                                            "NO_ADJACENT_SEQUENCE",
                                             "NO_OP"
                                         ]
                                     },
@@ -53766,14 +53847,22 @@ export 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": {
@@ -53788,7 +53877,7 @@ export const CONTRACT = {
                             "code": {
                                 "enum": [
                                     "INVALID_TARGET",
-                                    "LEVEL_OUT_OF_RANGE",
+                                    "NO_ADJACENT_SEQUENCE",
                                     "NO_OP"
                                 ]
                             },
@@ -53811,21 +53900,21 @@ export 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",
@@ -53884,6 +53973,7 @@ export const CONTRACT = {
                     "kind": "jsonFlag",
                     "type": "json",
                     "flag": "target-json",
+                    "required": true,
                     "schema": {
                         "type": "object",
                         "properties": {
@@ -53905,27 +53995,10 @@ export 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,
@@ -53939,17 +54012,13 @@ export const CONTRACT = {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
                     },
-                    "value": {
-                        "type": [
-                            "integer",
-                            "null"
-                        ]
+                    "restartNumbering": {
+                        "type": "boolean"
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "target",
-                    "value"
+                    "target"
                 ]
             },
             "outputSchema": {
@@ -53960,14 +54029,25 @@ export 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"
                         ]
                     },
                     {
@@ -54011,14 +54091,25 @@ export 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": {
@@ -54053,18 +54144,20 @@ export 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",
@@ -54146,6 +54239,11 @@ export const CONTRACT = {
                         ]
                     }
                 },
+                {
+                    "name": "level",
+                    "kind": "flag",
+                    "type": "number"
+                },
                 {
                     "name": "input",
                     "kind": "jsonFlag",
@@ -54171,11 +54269,17 @@ export const CONTRACT = {
                 "properties": {
                     "target": {
                         "$ref": "#/$defs/ListItemAddress"
+                    },
+                    "level": {
+                        "type": "integer",
+                        "minimum": 0,
+                        "maximum": 8
                     }
                 },
                 "additionalProperties": false,
                 "required": [
-                    "target"
+                    "target",
+                    "level"
                 ]
             },
             "outputSchema": {
@@ -54208,8 +54312,8 @@ export const CONTRACT = {
                                     "code": {
                                         "enum": [
                                             "INVALID_TARGET",
-                                            "NO_COMPATIBLE_PREVIOUS",
-                                            "ALREADY_CONTINUOUS"
+                                            "LEVEL_OUT_OF_RANGE",
+                                            "NO_OP"
                                         ]
                                     },
                                     "message": {
@@ -54260,8 +54364,8 @@ export const CONTRACT = {
                             "code": {
                                 "enum": [
                                     "INVALID_TARGET",
-                                    "NO_COMPATIBLE_PREVIOUS",
-                                    "ALREADY_CONTINUOUS"
+                                    "LEVEL_OUT_OF_RANGE",
+                                    "NO_OP"
                                 ]
                             },
                             "message": {
@@ -54281,18 +54385,494 @@ export 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",
@@ -60329,37 +60909,240 @@ export 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",
@@ -60404,8 +61187,15 @@ export 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",
@@ -60611,11 +61401,14 @@ export 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",
@@ -60667,9 +61460,10 @@ export 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",
@@ -63495,6 +64289,102 @@ export 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",
@@ -80772,6 +81662,76 @@ export 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": {
@@ -81997,6 +82957,41 @@ export 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": {
@@ -90375,6 +91370,8 @@ export const CONTRACT = {
                             "lists.join",
                             "lists.canJoin",
                             "lists.separate",
+                            "lists.merge",
+                            "lists.split",
                             "lists.setLevel",
                             "lists.setValue",
                             "lists.continuePrevious",
@@ -90410,6 +91407,7 @@ export const CONTRACT = {
                             "trackChanges.decide",
                             "query.match",
                             "ranges.resolve",
+                            "selection.current",
                             "mutations.preview",
                             "mutations.apply",
                             "capabilities.get",
@@ -131717,6 +132715,170 @@ export 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,
@@ -131734,6 +132896,9 @@ export const CONTRACT = {
                     "offset": {
                         "type": "integer",
                         "minimum": 0
+                    },
+                    "in": {
+                        "$ref": "#/$defs/StoryLocator"
                     }
                 },
                 "additionalProperties": false
@@ -131786,6 +132951,162 @@ export 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": [
@@ -131815,6 +133136,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -131947,6 +133271,162 @@ export 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": [
@@ -132033,6 +133513,9 @@ export const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -132098,6 +133581,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132228,6 +133714,162 @@ export 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": [
@@ -132264,6 +133906,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132302,6 +133947,9 @@ export const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -132367,6 +134015,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132497,6 +134148,162 @@ export 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": [
@@ -132526,6 +134333,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132560,6 +134370,9 @@ export const CONTRACT = {
                                     },
                                     "name": {
                                         "type": "string"
+                                    },
+                                    "story": {
+                                        "$ref": "#/$defs/StoryLocator"
                                     }
                                 },
                                 "additionalProperties": false,
@@ -132625,6 +134438,9 @@ export const CONTRACT = {
                             },
                             "name": {
                                 "type": "string"
+                            },
+                            "story": {
+                                "$ref": "#/$defs/StoryLocator"
                             }
                         },
                         "additionalProperties": false,
@@ -132951,6 +134767,162 @@ export 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": [
@@ -134339,6 +136311,162 @@ export 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": [
@@ -137215,6 +139343,162 @@ export 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": [
@@ -139618,6 +141902,162 @@ export 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": [
@@ -140645,6 +143085,162 @@ export 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": [
@@ -145940,6 +148536,162 @@ export 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": [